Chio 0.2.0

Chio 0.2.0 brings maps, map services, unified styles and instrumentation to SwiftTUI applications.

• World and street maps with pan, zoom, annotations, routes and adjustable detail.
• Explicit online tiles, persistent caching and programmatic read-only tile packs.
• Forward and reverse place lookup, plus an OSRM routing adapter.
• ChioStyle with inherited colors, surfaces, spacing and native control styles.
• Default, light, btop and OpenCode presets, including configurable list-row padding.
• Measurement gauges, high-contrast target dials, segmented readouts and history charts.

SwiftTUI owns rendering, state, input, focus and scrolling. Applications retain network, timing, storage and workflow policy.

Install

Requires Swift 6.4+, macOS 15+ or Linux. This is a version-tagged source release. The current revision-pinned dependency graph requires immutable revisions:

.package(url: "https://github.com/echoz/Chio.git", revision: "69ff4471d1b238a59074489ab48bf3ffae7edeaa"),
.package(url: "https://github.com/SwiftTUI/swift-tui.git", revision: "7e62e95c913508f4fef42db36fde6fd60acb541c"),

Version requirements such as from: "0.2.0" or exact: "0.2.0" are not supported by this graph. Align any direct SwiftTUI requirement and resolve the lockfile together.

Migration

Replace ChioTheme, .chioTheme(...) and \.chioTheme with ChioStyle, .style(...) and \.chioStyle. The compatibility aliases and legacy style function-reference overloads are removed.

OpenCode adds one cell above and below Chio searchable rows. Set spacing.listRowVerticalInset to choose 0...32 cells per side. Zero preserves compact rows. Native List rows apply the token through ordinary padding.

Release record and migration details · Examples

Verification and limits

The complete local gate passes on macOS: debug and release tests, release products, terminal workflows, and real-process cache and pack checks. EngineeringRules 0.1.5 was merged before this release. Its compiler-backed Swift checks and documentation gate pass, with the existing baseline unchanged. Independent review passes. A fresh external application resolves, builds and runs against the release code. Six refreshed appearance recordings pass terminal restoration and visual checks; the assembled showcase passes browser inspection.

The complete hosted macOS and Linux gates pass for the combined candidate. Each platform passes debug/release tests, products, terminal journeys, HTTP loading and real-process storage checks. Final reconciliation changes documentation only. The earlier Linux attempt hit its overall job limit; the passing run retains all assertions and individual interaction deadlines.

The published annotated tag resolves to 69ff4471d1b238a59074489ab48bf3ffae7edeaa. A separate application resolves, builds and runs against that exact release commit and the matching SwiftTUI revision. The public showcase deployment passes; 19 deployed files match the locally inspected build byte-for-byte. There was no separate interactive browser run after deployment.

The known native collection-measurement diagnostic remains documented. This qualification does not prove large-collection performance, arbitrary terminal behavior or live provider availability.

The release pins merged SwiftTUI #57. A planned 0.2.1 dependency patch will follow a published SwiftTUI release containing that fix, after qualification.

Chio is personal software built with Codex assistance and human curation, under MIT. We cannot vouch for production stability. APIs and behavior may change.

No prebuilt binaries, fully static Linux support, provider archive downloader or live navigation are included. Map adapter checks do not establish provider uptime. Downstream applications must verify their own workflows.