[aicayzer]

Summary

The Swift SDK page shows how to read a saved view, read a layout's groups, follow a layout with a live query, and create, change and delete a view. The read-a-view guide points to those calls in place of saying the Swift SDK adopts the core's view calls later.

Links withmarfa/marfa-swift#355, which withmarfa/marfa-swift#361 closes. Merge this after that pull request.

Changes

• swift-sdk.mdx: a new "Saved views" section with reads, a live query over a layout, the table of read calls, and "Create, change and delete a view" with the version, idempotency key and refusal rules.
• read-a-view.mdx: the "Read a view in an app" section names the Swift SDK's calls beside the core's, with a Swift example, and drops the line that said the SDK adopts core APIs on its own schedule.

Testing

• pnpm test passes (39 files, 700 tests), and pnpm build, pnpm build:status and pnpm types:check pass.
• The Swift snippets in both pages were compiled with swift build in a scratch package that depends on the branch of feat(package)!: create, change and delete views marfa-swift#361, then removed. The calls they use are exercised by the live tests in feat(package)!: read views and rename a folder's search to query marfa-swift#359 and docs(api-ref): a device approval leaves the same consent a browser approval does #361.
• Names, error codes and rules were checked against the contract's "Views written through a copy" section in marfa 3d66082 and against the package source.

Notes for reviewers

• docs(swift-sdk): describe partial reads, every-type hydration and the file budget #611 also edits swift-sdk.mdx, and the blobs.get and noRoom lines this page still shows are fixed there. Whichever merges second needs a rebase; the sections do not overlap.
• The page grows by 77 lines. The section holds the Swift calls and refusals only; what a view is stays in the guide and the Catalog.

Checklist

• The title is a scoped Conventional Commit.
• New behavior has a test that was seen failing first, or no test was needed and the reason is above.
• Docs, comments and the contract still say what is true after this change.

[aicayzer]

Checks only: documents withmarfa/marfa-swift#361 (reviewed and merged). The Swift snippets were compiled against that branch in a scratch package. It overlaps #611 on swift-sdk.mdx; #611 rebases after this merges.