docs(storefront): conform tutorial + fresh-ui/web-layer to alpha.18 feature sweep

[rickylabs]

What

Storefront tutorial D-01…D-05 conformance to the shipped alpha.18 feature sweep (#206–#231), plus accuracy reconciliation on the fresh-ui / web-layer pages that sweep touched. First slice of the docs march to 0.0.1-stable.

Docs-only. Authored via a Claude documentation workflow, applied + validated + committed on the Windows/Claude side (no framework source touched).

Storefront conformance

#	File	Change
D-01	01-scaffold.md	Aspire dashboard URL is https (×3); fileTree includes database/ + tests/.
D-02	02-catalog-service.md	Real #208 CRUD surface — createCrudContract + @database/zod + context.db; errors thrown via the contract's typed errors.NOT_FOUND (removed hand-rolled notFound import); router nests health under products (removed invented health-router import).
D-03	03-cart-contracts.md	Register in mod.ts, PascalCase CartContractV1, import from @my-shop/contracts + the ./versions/v1 subpath. Also realigned ch2's products.contract.ts exports to PascalCase (ProductsContract/ProductsContractV1) so the ch2↔ch3 imports agree.
D-04	04-checkout-saga.md, 05-shipping-webhook.md	Public netscript plugin install saga|trigger --name … --samples.

Feature-sweep reconciliation (fresh-ui / web-layer)

• capabilities/fresh-ui.md + reference/fresh-ui/index.md: DataTable→DataGrid (fresh-ui: promote a generic templated DataGrid (successor to un-templated DataTable) #209/feat(fresh-ui): promote generic templated DataGrid (successor to DataTable) (#209) #225), Icon primitive + DataGrid in root exports (fresh-ui: promote Icon as a first-class stroke-SVG primitive #211/feat(fresh-ui): promote Icon as a first-class stroke-SVG primitive (#211) #224), Dropzone/prompt-input mentions (dropzone: promote drag + clipboard-paste + multi-file ingest behavior #214/feat(fresh-ui): Dropzone drag + clipboard-paste + multi-file ingest (#214) #229, prompt-input: adopt CSS field-sizing:content auto-grow in the primitive #212/fix(fresh-ui): auto-grow prompt-input via CSS field-sizing:content (#212) #226).
• web-layer/form.md: managed <Form> forwards class + arbitrary <form> attributes (form: managed <Form> rejects class/arbitrary attrs on formProps (DX gap) #213/fix(fresh): accept class + standard <form> attrs on managed Form formProps (#213) #228).
• web-layer/query.md: useIslandMutation onMutate/onSettled (query islands: useIslandMutation missing onMutate/onSettled (no true optimistic rollback) #210/feat(fresh): add onMutate/onSettled to useIslandMutation for optimistic rollback (#210) #227).

Validation

• deno task build ✓ (308 files)
• deno task check:links ✓ (18,722 internal links across 131 pages resolve)
• deno task check:caveats ✓ (30 caveat markers resolve)
• No deno fmt run on docs/site (per docs build policy).

Scope

Refs #153 — does not close it; the full manual Run-2 walk stays for after the release cut. Remaining docs-march work is tracked in the umbrella #232 and lands as focused PRs after the next release cut.

Refs #153
Refs #232

🤖 Generated with Claude Code

[augmentcode]

🤖 Augment PR Summary

Summary: This PR updates NetScript documentation to match the shipped 0.0.1-alpha.18 “feature sweep” behavior, with a focus on the Storefront tutorial (chapters D-01…D-05) and Fresh UI / web-layer reference pages.

Changes:

• Storefront tutorial: switches Aspire dashboard links to https://localhost:18888 and refreshes the scaffold tree/checklist (adds database/ and tests/).
• Catalog service tutorial: aligns contract/handler examples with the real CRUD surface (createCrudContract, @database/zod inputs, context.db) and typed contract errors.
• Cart contracts tutorial: moves registration guidance to contracts/versions/v1/mod.ts, updates export/import casing, and adjusts the typed client example.
• Saga + trigger chapters: replaces contributor-only netscript-dev invocations with the public netscript plugin install commands.
• Fresh UI docs: reconciles terminology/exports (Icon primitive, DataGrid) and updates related capability/reference copy.
• Web-layer docs: clarifies managed <Form> attribute forwarding and expands useIslandMutation lifecycle callback documentation.

Technical Notes: Docs-only change set; includes consistency updates to match current public package exports and scaffolded code patterns.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 2 suggestions posted.

Comment augment review to trigger a new review at any time.

[augmentcode]

netscript ui:add data-grid looks like it would fail today because the Fresh UI registry manifest still defines data-table (and the CLI errors on unknown registry item names). This also conflicts with the existing netscript ui:add data-table examples elsewhere in the docs.

Severity: medium

Other Locations

• docs/site/capabilities/fresh-ui.md:101

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}

[augmentcode]

This uses ProductsContractV1/CartContractV1 as the values in v1, but the scaffolded contract templates distinguish *ContractV1 (raw contract) vs *V1 (implemented contract with .handler() / $context). If a reader copy/pastes this into a default scaffold without also renaming the exports, it’s very likely to break type-checking or lead to wiring the non-implemented contract into v1 by mistake.

Severity: low

Other Locations

• docs/site/tutorials/storefront/02-catalog-service.md:114
• docs/site/tutorials/storefront/02-catalog-service.md:129

_{🤖 Was this useful? React with 👍 or 👎, or 🚀 if it prevented an incident/outage.}