v0.4.0

This release adds guidance for nested AppKit hosts and shared-view ownership.

Added

• Tear down owned NSHostingView instances in dismantleNSView, and separate host construction from shared-resource transfers.
• Version-limited reproducer evidence for the macOS 27.0.1 reconstruction issue.
• README and skill summaries now include the AppKit hosting guidance.

Validation

• The new example passed Swift 6 typechecking with complete strict concurrency and warnings as errors.
• Window behavior, resource transfer, focus, and accessibility were not run.

Full changes: v0.3.0...v0.4.0

v0.3.0

This release expands practical guidance for app integrations, Swift concurrency, and SwiftUI interaction and rendering. Each reference preserves its platform requirements, source evidence, and validation limits.

Added guidance

• App integrations: App Attest registration and protected requests, local Live Activity lifecycles, downloaded notification audio and AlarmKit boundaries, Assistive Access, out-of-process App Intents tests, and widget placement preferences.
• Foundation Models and Swift: reusable dynamic profile policies, local token-budget screening, throwing-task error ownership, async Result capture, immutable weak references, and explicit Sendable suppression.
• SwiftUI interaction: unsaved sheet drafts, runtime sheet transitions, selection foregrounds, multi-item drag selection and reorder order, navigation-bar minimization, and system button shapes and concentric corners.
• Charts and fixtures: aligned sunburst rings, calendar coordinates and accessibility decisions, parameterized previews, and offline partially generated content fixtures.
• Data and development workflows: SwiftData list/detail fetch decisions, Xcode build timing and compilation-cache evaluation, and archive/dSYM retention.

Updated guidance

• Extend asynchronous cleanup with version-gated cancellation shields and rendering guidance with static decorative glows and clipping boundaries.
• Add bundled-font failure diagnosis and SF Symbols catalog checks. Clarify compiler-backed macro contract tests beyond expansion snapshots.

Validation

• Checked release metadata, reference routing, relative links and anchors, Markdown fences, the release diff, and source-archive contents.
• References retain their previously recorded compiler and local-execution checks, including toolchain, deployment, isolation, and configuration requirements.
• This packaging review did not repeat Swift compilation, model requests, signed-app integrations, UI, simulator, device, synchronization, or performance checks. Consult each reference for its actual evidence and remaining limits.

Full changes: v0.2.0...v0.3.0

v0.2.0

This release expands the skill's Swift and SwiftUI guidance with 22 focused scenario references, while preserving platform requirements and validation limits beside each recommendation.

Added guidance

• Swift: protocol method selection, task naming, synchronous Mutex and Atomic state, shared in-flight loads, async and throwing getters, macro type diagnostics and inferred fields, and non-View ContentBuilder DSLs.
• SwiftUI state: observable model construction and deferred seeds, Observation assignment versus in-place mutation, and onChange capture semantics.
• Layout and rendering: container-relative sizing, geometry breakpoints, scroll anchors and position readback, nested alignment guides, geometry and compositing boundaries, and macOS toolbar appearance.
• Text, effects, and assets: semantic attributed text and Markdown, paragraph line height, symbol rendering and effects, chart dimming, map cameras and overlays, Metal shader contracts, and PDF asset scaling.

Validation

• Reviewed skill metadata, relative links and anchors, Markdown fences, and the complete release diff.
• Assembled Swift examples passed 94 typechecks across Swift 5 and Swift 6 language modes using the iOS and macOS SDKs in Xcode 27.1 / Apple Swift 6.4. Availability annotations were retained.
• Protocol-dispatch examples compiled and executed on macOS. The Metal example compiled and linked for iOS and macOS.
• This release review did not rebuild the macro plugin or repeat UI, simulator, physical-device, or older-runtime checks. Individual references describe their earlier validation conditions and remaining limits.

Full changes: v0.1.0...v0.2.0

v0.1.0

First public release of Swift Practical Patterns: focused Swift and SwiftUI guidance for AI coding agents, designed to work alongside community-maintained skills.

Included

• 11 references covering app integrations, Swift language patterns, and SwiftUI layout and presentation details.
• Task routing that loads only the relevant reference.
• Blog attribution, official source links, version requirements, and explicit verification boundaries.
• An English README with companion recommendations and an MIT license.

Install

Requires Node.js 22.20 or later. Run from your app project:

npx skills add https://github.com/YL404/Swift-Practical-Patterns --skill swift-practical-patterns

Choose your coding agent when prompted. Add --global for installation across projects.

Validation

• Skill metadata, internal links and anchors, Markdown fences, and package self-containment passed checks.
• Installed from the public GitHub repository using skills CLI 1.7.4 on Node.js 22.23.1 for Codex and Claude Code in an isolated project. All 12 installed Markdown files for each target matched the release commit.
• Existing code and behavior verification remains limited to the conditions recorded in each reference. The release installation check does not expand that scope.

Release commit: eb45b5ea319a0526c710aabdb0acafec6ba7977a.