@poodle64/ui 2026.8.14 → 2026.8.17

package/registry/component-map.json

@@ -1,11 +1,11 @@
 {
 	"meta": {
 		"package": "@poodle64/ui",
-		"version": "2026.8.14",
+		"version": "2026.8.17",
 		"generatedBy": "scripts/generate-registry.mjs",
 		"source": "scripts/situations.json + package source (DO NOT EDIT the outputs by hand)",
-		"componentCount": 54,
-		"situationCount": 14
+		"componentCount": 55,
+		"situationCount": 15
 	},
 	"situations": [
 		{
@@ -155,6 +155,76 @@
 				}
 			]
 		},
+		{
+			"key": "hand-written-form",
+			"title": "A form the app itself describes",
+			"description": "A form whose fields the app writes out itself, validated by superforms and wired for accessibility by Formsnap. These wrappers put the label/description/error rhythm and the ARIA wiring in one place; the schema-described renderer above is for the other case, where the shape arrives at runtime.",
+			"components": [
+				{
+					"name": "FormField",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "form, name, class?",
+					"insteadOf": "a <div class=\"space-y-2\"> you rebuild per field, per app"
+				},
+				{
+					"name": "FormControl",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "children, id?",
+					"insteadOf": "wiring id/aria-describedby/aria-invalid onto the input by hand"
+				},
+				{
+					"name": "FormLabel",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "class?",
+					"insteadOf": "a <Label> that does not turn destructive when its field errors"
+				},
+				{
+					"name": "FormDescription",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "class?",
+					"insteadOf": "helper text the field's aria-describedby never points at"
+				},
+				{
+					"name": "FormFieldErrors",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "class?, errorClasses?",
+					"insteadOf": "hand-rendered {#each errors} blocks, styled differently in each app"
+				},
+				{
+					"name": "FormFieldset",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "form, name, class?",
+					"insteadOf": "a bare <fieldset> with no error state"
+				},
+				{
+					"name": "FormLegend",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "class?",
+					"insteadOf": "a <legend> styled per app"
+				},
+				{
+					"name": "FormElementField",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "form, name, class?",
+					"insteadOf": "hand-indexing into an array field's errors"
+				},
+				{
+					"name": "FormButton",
+					"dir": "form",
+					"import": "@poodle64/ui/form",
+					"props": "children, variant?, size?, disabled?, class?",
+					"insteadOf": "remembering type=\"submit\" on every form's Button — it forwards every Button prop and sets the type"
+				}
+			]
+		},
 		{
 			"key": "server-described-form",
 			"title": "A form the server described",
@@ -220,7 +290,7 @@
 					"name": "PageHeader",
 					"dir": "page-header",
 					"import": "@poodle64/ui/page-header",
-					"props": "title?, eyebrow?, breadcrumbs?, subtitle?, info?, actions?",
+					"props": "title?, eyebrow?, breadcrumbs?, icon?, subtitle?, info?, meta?, actions?",
 					"insteadOf": "a hand-written <h1> and title bar (the drift gate fails this)"
 				},
 				{

package/registry/component-map.md

@@ -1,7 +1,7 @@
 # @poodle64/ui — situation → component map
 
 <!-- GENERATED by scripts/generate-registry.mjs from scripts/situations.json + package source. DO NOT EDIT. -->
-Generated from `@poodle64/ui@2026.8.14`. 54 components, 14 situations.
+Generated from `@poodle64/ui@2026.8.17`. 55 components, 15 situations.
 
 **Read this before writing a `<div>`.** Find the SITUATION you are in below, then compose the component named for it — do not hand-build it from raw `Card` or utility classes. Import is `import { Name } from '<import path>'`. Props marked `?` are optional. This map is the retrieval step the [`frontend-design` skill] makes mandatory; the [CHI 2026 study] measured composing-from-a-registry at 95% design-system compliance against 71% for writing the CSS from a prose style guide.
 
@@ -83,6 +83,22 @@ _The generic titled card every route reaches for — an optional header with ico
 | --- | --- | --- | --- |
 | `Panel` | `@poodle64/ui/panel` | `children, title?, subtitle?, icon?, action?, pad?` | raw Card + CardHeader + CardTitle assembled by hand on every route |
 
+## A form the app itself describes
+
+_A form whose fields the app writes out itself, validated by superforms and wired for accessibility by Formsnap. These wrappers put the label/description/error rhythm and the ARIA wiring in one place; the schema-described renderer above is for the other case, where the shape arrives at runtime._
+
+| Component | Import | Key props | Reach for it instead of |
+| --- | --- | --- | --- |
+| `FormField` | `@poodle64/ui/form` | `form, name, class?` | a <div class="space-y-2"> you rebuild per field, per app |
+| `FormControl` | `@poodle64/ui/form` | `children, id?` | wiring id/aria-describedby/aria-invalid onto the input by hand |
+| `FormLabel` | `@poodle64/ui/form` | `class?` | a <Label> that does not turn destructive when its field errors |
+| `FormDescription` | `@poodle64/ui/form` | `class?` | helper text the field's aria-describedby never points at |
+| `FormFieldErrors` | `@poodle64/ui/form` | `class?, errorClasses?` | hand-rendered {#each errors} blocks, styled differently in each app |
+| `FormFieldset` | `@poodle64/ui/form` | `form, name, class?` | a bare <fieldset> with no error state |
+| `FormLegend` | `@poodle64/ui/form` | `class?` | a <legend> styled per app |
+| `FormElementField` | `@poodle64/ui/form` | `form, name, class?` | hand-indexing into an array field's errors |
+| `FormButton` | `@poodle64/ui/form` | `children, variant?, size?, disabled?, class?` | remembering type="submit" on every form's Button — it forwards every Button prop and sets the type |
+
 ## A form the server described
 
 _A config object whose shape arrives at runtime as a JSON Schema plus a JSON Forms UI Schema — the renderer walks both and dispatches to this package's widgets. Anything it cannot dispatch renders flagged, never blank._
@@ -109,7 +125,7 @@ _The standing chrome — the app shell and its nav, the one page-title treatment
 | Component | Import | Key props | Reach for it instead of |
 | --- | --- | --- | --- |
 | `AppShell` | `@poodle64/ui/app-shell` | `nav, currentPath, brandTitle?, actions?, context?, children` | a bespoke nav rail + header layout per app |
-| `PageHeader` | `@poodle64/ui/page-header` | `title?, eyebrow?, breadcrumbs?, subtitle?, info?, actions?` | a hand-written <h1> and title bar (the drift gate fails this) |
+| `PageHeader` | `@poodle64/ui/page-header` | `title?, eyebrow?, breadcrumbs?, icon?, subtitle?, info?, meta?, actions?` | a hand-written <h1> and title bar (the drift gate fails this) |
 | `ContextColumn` | `@poodle64/ui/context-column` | `stats, statsTitle?, statsInfo?, detail?, ariaLabel?` | a hand-built right-hand <aside> with a stat card and a detail pane |
 
 ## A dialog or overlay