@homepages/template-kit 0.4.0 → 0.5.0

package/docs/recipes/fixture-states.md

@@ -1,68 +0,0 @@
----
-purpose: Preview a section's structural edge cases.
-status: living
-related: [../schema-system.md, ../dev.md]
-updated: 2026-07-15
----
-# Preview a section's structural edge cases
-
-## Goal
-
-Preview a section's structural edge cases.
-
-## The delta
-
-Add entries under `states` in `fixtures.ts` — each one overrides part of
-`base`, the same pattern the starter's `left` and `long-blurb` states use.
-A `states` entry is for a DESIGNED scenario, not raw coverage: nullability
-and empty-slot coverage (every optional slot rendered empty) is derived
-automatically from `schema.ts`, so a fixture state is for a case the
-section renders *differently* — a content-length branch, an option branch,
-or several overrides combined.
-
-```ts
-// fixtures.ts — a content-length case and an option-branch case
-const fixtures: FixtureModule = {
-  base: {
-    slots: {
-      headline: "101 Queensway, Jamaica Plain, MA 02130",
-      summary: "A bright corner home moments from the Emerald Necklace.",
-    },
-    options: { align: "center" },
-  },
-  states: {
-    // Content-length branch: exercises a long value's wrap/expand behavior.
-    "long-summary": {
-      slots: {
-        summary:
-          "A bright corner home moments from the Emerald Necklace, with a " +
-          "chef's kitchen, three sun-filled bedrooms, off-street parking, and " +
-          "a landscaped yard that backs onto a quiet dead-end street.",
-      },
-    },
-    // Option branch: exercises the layout under the other enum value.
-    left: { options: { align: "left" } },
-  },
-};
-```
-
-Each `states` key names a scenario; its value overrides `slots` and/or
-`options` on top of `base` — omit either key to inherit `base`'s value
-unchanged. Each state is a selectable fixture in the dev preview, so every one
-you add is there to render and review alongside `base`.
-
-## Commands
-
-None — this is a pure content edit. No CLI command beyond the author loop below.
-
-## Verify
-
-Verify with [the author loop](../quickstart.md#the-author-loop).
-
-## See also
-
-- [The schema system](../schema-system.md#fixturests--content-for-local-preview) —
-  the `fixtures.ts` contract: `base`, `states`, and the golden-property
-  fixture exports.
-- [`template-kit dev`](../dev.md) — the preview server that renders each
-  fixture state across the breakpoint ladder.