@godxjp/ui 18.5.0 → 18.7.0

package/dist/props/registry.d.ts

@@ -194,10 +194,35 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "layout";
         readonly description: "CenteredShell column block alignment — start (flowing page), center (system surface)";
     };
+    readonly CenteredShellPresetProp: {
+        readonly file: "vocabulary/layout.prop.ts";
+        readonly category: "layout";
+        readonly description: "CenteredShell whole-page preset — default (untouched box) | public-landing (token-owned public landing measure, section rhythm, flat chrome and hero h1 tier)";
+    };
+    readonly TablePresetProp: {
+        readonly file: "vocabulary/data.prop.ts";
+        readonly category: "data";
+        readonly description: "Table collection preset — default | action-collection (dense approval/action queue: column-priority measures below the collapse step instead of desktop intrinsic widths)";
+    };
+    readonly TableColumnPriorityProp: {
+        readonly file: "vocabulary/data.prop.ts";
+        readonly category: "data";
+        readonly description: "Table column priority for the action-collection preset — primary | secondary | meta | actions (unset = takes the remaining space)";
+    };
+    readonly ErrorSurfaceModeProp: {
+        readonly file: "vocabulary/layout.prop.ts";
+        readonly category: "layout";
+        readonly description: "ErrorSurface shell contract — application (403/404 body inside the route's existing AppShell) vs system (500/503 owns the page via CenteredShell align=center)";
+    };
+    readonly ErrorSurfaceStatusProp: {
+        readonly file: "vocabulary/layout.prop.ts";
+        readonly category: "layout";
+        readonly description: "HTTP status an ErrorSurface presents — 403 | 404 | 500 | 503 (numeric); drives the default icon, tone and mode";
+    };
     readonly AuthShellPresetProp: {
         readonly file: "vocabulary/layout.prop.ts";
         readonly category: "layout";
-        readonly description: "AuthShell named flow measure — default | device-authorization (380px card, 5px mobile gutter) | context-selection (25rem card, edge-to-edge mobile) | account-recovery (432px SCR-008 recovery/MFA panel, 15px mobile gutter)";
+        readonly description: "AuthShell named flow geometry — default | login (stable SCR-001 identity/card/footer anchor) | device-authorization (380px card, 5px mobile gutter) | context-selection (25rem card, edge-to-edge mobile) | account-recovery (432px SCR-008 recovery/MFA panel, 15px mobile gutter)";
     };
     readonly GapProp: {
         readonly file: "vocabulary/layout.prop.ts";
@@ -234,6 +259,11 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "interaction";
         readonly description: "Corner shape default | pill | sharp — shared by Button + Badge (radius tokens)";
     };
+    readonly AvatarShapeProp: {
+        readonly file: "vocabulary/interaction.prop.ts";
+        readonly category: "interaction";
+        readonly description: "Avatar geometry circle (person, --radius-pill) | square (entity-header organization/service mark, --avatar-square-* tokens) — a rounded rect ShapeProp cannot express";
+    };
     readonly TextSizeProp: {
         readonly file: "vocabulary/interaction.prop.ts";
         readonly category: "interaction";
@@ -357,7 +387,7 @@ export declare const VOCABULARY_REGISTRY: {
     readonly ColumnDefProp: {
         readonly file: "vocabulary/data.prop.ts";
         readonly category: "data";
-        readonly description: "DataTable column definition";
+        readonly description: "DataTable column definition — key/header/render/sortable/align/width/pin/hiddenOnMobile/enableHiding/ariaLabel plus `priority` (TableColumnPriorityProp), read by DataTable preset=\"action-collection\"";
     };
     readonly SelectedIdsProp: {
         readonly file: "vocabulary/data.prop.ts";
@@ -421,13 +451,52 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly PageContainerMeasureProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly PageContainerPresetProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly PageHeaderProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["TitleProp", "SubtitleProp", "ExtraProp", "BreadcrumbProp", {
+            readonly field: "meta";
+            readonly local: true;
+            readonly reason: "Status/meta band rendered inline with the `<h1>` (a Badge tone, a record id, a timestamp). A free ReactNode slot, not a controlled value — the header never interprets what it holds.";
+        }, {
+            readonly field: "layout";
+            readonly local: true;
+            readonly reason: "Header ARRANGEMENT of the title band vs the extra slot below the 640px step (stack | responsive-inline) — the standalone spelling of PageContainer's `headerLayout`.";
+        }, {
+            readonly field: "loading";
+            readonly local: true;
+            readonly reason: "Pending state of the TITLE BAND only (skeleton title/subtitle + aria-busy), distinct from a page-wide DataState: breadcrumbs and actions come from the route and stay live while the record resolves.";
+        }];
+    };
     readonly PageContainerProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly ["TitleProp", "SubtitleProp", "ExtraProp", "FooterProp", "BreadcrumbProp", "DensityProp", "PageContainerVariantProp", {
+            readonly field: "meta";
+            readonly local: true;
+            readonly reason: "Forwarded verbatim to PageHeader's `meta` slot — see PageHeaderProp.";
+        }, {
+            readonly field: "headerLoading";
+            readonly local: true;
+            readonly reason: "Forwarded to PageHeader's `loading`. Named for the BAND it skeletonises, so it can never be read as a page-wide loading flag (that is DataState's job).";
+        }, {
             readonly field: "headerLayout";
             readonly local: true;
             readonly reason: "Header ARRANGEMENT of the title band vs the extra slot below the 640px step (stack | responsive-inline) — orthogonal to PageContainerVariantProp, which selects the page shell layout.";
+        }, {
+            readonly field: "measure";
+            readonly local: true;
+            readonly reason: "Bounded page MEASURE shared by the header and body (default | narrow | medium), backed by --page-measure-*. A third orthogonal axis: PageContainerVariantProp owns page CHROME, this owns the inline cap, so a quiet ghost page can also be measure-bounded.";
         }];
     };
     readonly FlexDirectionProp: {
@@ -464,6 +533,14 @@ export declare const COMPONENT_PROP_REGISTRY: {
             readonly field: "wrap";
             readonly local: true;
             readonly reason: "Flex-specific boolean shorthand for flex-wrap.";
+        }, "BreakpointProp", {
+            readonly field: "hideBelow";
+            readonly local: true;
+            readonly reason: "Responsive region visibility at a canonical breakpoint step — the public alternative to a page-local media query (gh#252).";
+        }, {
+            readonly field: "hideFrom";
+            readonly local: true;
+            readonly reason: "Inverse of hideBelow — keeps a compact-only region off the wide layout.";
         }];
     };
     readonly ResponsiveGridColumnsProp: {
@@ -581,10 +658,66 @@ export declare const COMPONENT_PROP_REGISTRY: {
             readonly reason: "Authoritative requesting-client context for a delegated auth flow (device grant / consent).";
         }];
     };
+    readonly AuthAccountSummaryProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["DisabledProp", "ClassNameProp"];
+        readonly local: readonly ["email", "avatarSrc", "avatarFallback", "actionLabel", "onAction"];
+    };
     readonly CenteredShellProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
-        readonly vocabulary: readonly ["ChildrenProp", "ClassNameProp", "CenteredShellWidthProp", "CenteredShellAlignProp"];
+        readonly vocabulary: readonly ["ChildrenProp", "ClassNameProp", "CenteredShellWidthProp", "CenteredShellAlignProp", "CenteredShellPresetProp"];
+    };
+    readonly ErrorSurfaceMaintenanceProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "start";
+            readonly local: true;
+            readonly reason: "ISO 8601 instant starting the maintenance window; formatted via Intl.DateTimeFormat and emitted as the <time dateTime> value.";
+        }, {
+            readonly field: "end";
+            readonly local: true;
+            readonly reason: "ISO 8601 instant ending the window; omitted for an open-ended outage.";
+        }, {
+            readonly field: "timeZone";
+            readonly local: true;
+            readonly reason: "IANA time zone id the window is presented in — explicit so SSR and client output cannot diverge.";
+        }, {
+            readonly field: "progress";
+            readonly local: true;
+            readonly reason: "Server-sent 0–100 completion of the maintenance window; deriving it from the client clock would break hydration.";
+        }];
+    };
+    readonly ErrorSurfaceProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["ErrorSurfaceModeProp", "ErrorSurfaceStatusProp", "TitleProp", "DescriptionProp", "ActionProp", "IconProp", "HeadingLevelProp", "FooterProp", "CenteredShellWidthProp", "IdProp", "ClassNameProp", {
+            readonly field: "tone";
+            readonly local: true;
+            readonly reason: "Reuses the EmptyStateToneProp union verbatim (the surface renders an EmptyState) — a status-derived default the consumer may override, not a new tone vocabulary.";
+        }, {
+            readonly field: "requestId";
+            readonly local: true;
+            readonly reason: "Support correlation id for the failure, rendered as a mono/tabular metadata row — an identifier, not a LabelProp.";
+        }, {
+            readonly field: "permission";
+            readonly local: true;
+            readonly reason: "The permission/role the viewer is missing (403). The localized label is the surface's; the value is the bare permission name.";
+        }, {
+            readonly field: "organization";
+            readonly local: true;
+            readonly reason: "The organization/tenant the failed request was scoped to — disambiguates a wrong-workspace 403 from a missing-role 403.";
+        }, {
+            readonly field: "maintenance";
+            readonly local: true;
+            readonly reason: "ErrorSurfaceMaintenanceProp timing/progress slot (ISO 8601 + IANA), formatted with Intl.DateTimeFormat.";
+        }, {
+            readonly field: "brand";
+            readonly local: true;
+            readonly reason: "system-mode brand slot above the status code (a Logo); the application shell already shows the brand.";
+        }];
     };
     readonly LegalDocumentSectionProp: {
         readonly group: "layout";
@@ -925,6 +1058,11 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-display.prop.ts";
         readonly vocabulary: readonly ["LabelProp", "ValueProp"];
     };
+    readonly AvatarProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["AvatarShapeProp", "ChildrenProp", "ClassNameProp"];
+    };
     readonly BadgeProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
@@ -933,7 +1071,25 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly DataTableProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
-        readonly vocabulary: readonly ["ColumnDefProp", "DensityProp", "SortStateProp", "SelectedIdsProp", "HandlerProp"];
+        readonly vocabulary: readonly ["ColumnDefProp", "DensityProp", "SortStateProp", "SelectedIdsProp", "HandlerProp", "TablePresetProp", "TableColumnPriorityProp", "BreakpointProp"];
+    };
+    readonly ListRowDensityProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly ListRowProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["TitleProp", "DescriptionProp", "ClassNameProp", {
+            readonly field: "density";
+            readonly local: true;
+            readonly reason: "ListRow-local density subset (default | compact) — the compact inline-actions geometry (#246). No `comfortable` step, and unrelated to PageDensityProp/TableDensityProp.";
+        }, {
+            readonly field: "overflow";
+            readonly local: true;
+            readonly reason: "Row-local overflow resolution for the title/description column (truncate | wrap, #224).";
+        }];
     };
     readonly CredentialRevealProp: {
         readonly group: "data-display";
@@ -1219,6 +1375,11 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/feedback.prop.ts";
         readonly vocabulary: readonly ["AlertVariantProp", "ToneProp", "IconProp", "OnValueChangeProp", "ClassNameProp", "ChildrenProp"];
     };
+    readonly BannerProp: {
+        readonly group: "feedback";
+        readonly file: "components/feedback.prop.ts";
+        readonly vocabulary: readonly ["ToneProp", "IconProp", "OnValueChangeProp", "ClassNameProp", "ChildrenProp"];
+    };
     readonly AlertTitleProp: {
         readonly group: "feedback";
         readonly file: "components/feedback.prop.ts";
@@ -1252,7 +1413,36 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly ToolbarProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
-        readonly vocabulary: readonly ["OnClearFiltersProp", "HasActiveFiltersProp", "StickyProp", "ClassNameProp", "ChildrenProp"];
+        readonly vocabulary: readonly ["OnClearFiltersProp", "HasActiveFiltersProp", "StickyProp", "ClassNameProp", "ChildrenProp", {
+            readonly field: "search";
+            readonly local: true;
+            readonly reason: "SLOT for the caller's own search control, positioned at the start of the row and measured by --filter-bar-search-width. Not a value/onValueChange pair: the bar owns the search's PLACE and WIDTH, never its state (gh#258).";
+        }, {
+            readonly field: "chips";
+            readonly local: true;
+            readonly reason: "APPLIED filters as removable chips — the visible record of filters already in effect, distinct from the controls that set them. A bar-specific shape (id/label/onRemove), not a shared vocabulary type (gh#258).";
+        }, {
+            readonly field: "onChipRemove";
+            readonly local: true;
+            readonly reason: "Chip-removal callback keyed by chip id. Not `onValueChange`: it reports ONE lifted filter rather than the bar's whole value, which the bar deliberately does not hold (gh#258).";
+        }, {
+            readonly field: "resultCount";
+            readonly local: true;
+            readonly reason: "Number of records the current filters resolve to, announced in a polite live region and formatted via Intl.NumberFormat + CLDR plurals. Presentational output, not a controlled value (gh#258).";
+        }, {
+            readonly field: "actions";
+            readonly local: true;
+            readonly reason: "Trailing action SLOT (export, column settings, saved views), ordered AFTER the reset control by the bar so `clear filters` never sits beside an unrelated primary action (gh#258).";
+        }];
+    };
+    readonly FilterBarChipProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["IdProp", "LabelProp", {
+            readonly field: "onRemove";
+            readonly local: true;
+            readonly reason: "Per-chip removal. Omitting it is meaningful — the chip renders with NO remove control (a filter the user may not lift), rather than a disabled button that is a dead tab stop (gh#258).";
+        }];
     };
     readonly FilterBarOverflowProp: {
         readonly group: "navigation";
@@ -1274,6 +1464,16 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/navigation.prop.ts";
         readonly vocabulary: readonly ["ValueProp", "DefaultValueProp", "SizeProp", "OnValueChangeProp", "ClassNameProp"];
     };
+    readonly InputOTPGroupProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["ClassNameProp"];
+    };
+    readonly InputOTPGroupAppearanceProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly StepItemProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";

package/dist/props/registry.js

@@ -192,10 +192,35 @@ const VOCABULARY_REGISTRY = {
     category: "layout",
     description: "CenteredShell column block alignment \u2014 start (flowing page), center (system surface)"
   },
+  CenteredShellPresetProp: {
+    file: "vocabulary/layout.prop.ts",
+    category: "layout",
+    description: "CenteredShell whole-page preset \u2014 default (untouched box) | public-landing (token-owned public landing measure, section rhythm, flat chrome and hero h1 tier)"
+  },
+  TablePresetProp: {
+    file: "vocabulary/data.prop.ts",
+    category: "data",
+    description: "Table collection preset \u2014 default | action-collection (dense approval/action queue: column-priority measures below the collapse step instead of desktop intrinsic widths)"
+  },
+  TableColumnPriorityProp: {
+    file: "vocabulary/data.prop.ts",
+    category: "data",
+    description: "Table column priority for the action-collection preset \u2014 primary | secondary | meta | actions (unset = takes the remaining space)"
+  },
+  ErrorSurfaceModeProp: {
+    file: "vocabulary/layout.prop.ts",
+    category: "layout",
+    description: "ErrorSurface shell contract \u2014 application (403/404 body inside the route's existing AppShell) vs system (500/503 owns the page via CenteredShell align=center)"
+  },
+  ErrorSurfaceStatusProp: {
+    file: "vocabulary/layout.prop.ts",
+    category: "layout",
+    description: "HTTP status an ErrorSurface presents \u2014 403 | 404 | 500 | 503 (numeric); drives the default icon, tone and mode"
+  },
   AuthShellPresetProp: {
     file: "vocabulary/layout.prop.ts",
     category: "layout",
-    description: "AuthShell named flow measure \u2014 default | device-authorization (380px card, 5px mobile gutter) | context-selection (25rem card, edge-to-edge mobile) | account-recovery (432px SCR-008 recovery/MFA panel, 15px mobile gutter)"
+    description: "AuthShell named flow geometry \u2014 default | login (stable SCR-001 identity/card/footer anchor) | device-authorization (380px card, 5px mobile gutter) | context-selection (25rem card, edge-to-edge mobile) | account-recovery (432px SCR-008 recovery/MFA panel, 15px mobile gutter)"
   },
   GapProp: {
     file: "vocabulary/layout.prop.ts",
@@ -233,6 +258,11 @@ const VOCABULARY_REGISTRY = {
     category: "interaction",
     description: "Corner shape default | pill | sharp \u2014 shared by Button + Badge (radius tokens)"
   },
+  AvatarShapeProp: {
+    file: "vocabulary/interaction.prop.ts",
+    category: "interaction",
+    description: "Avatar geometry circle (person, --radius-pill) | square (entity-header organization/service mark, --avatar-square-* tokens) \u2014 a rounded rect ShapeProp cannot express"
+  },
   TextSizeProp: {
     file: "vocabulary/interaction.prop.ts",
     category: "interaction",
@@ -358,7 +388,7 @@ const VOCABULARY_REGISTRY = {
   ColumnDefProp: {
     file: "vocabulary/data.prop.ts",
     category: "data",
-    description: "DataTable column definition"
+    description: 'DataTable column definition \u2014 key/header/render/sortable/align/width/pin/hiddenOnMobile/enableHiding/ariaLabel plus `priority` (TableColumnPriorityProp), read by DataTable preset="action-collection"'
   },
   SelectedIdsProp: {
     file: "vocabulary/data.prop.ts",
@@ -425,6 +455,41 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/layout.prop.ts",
     vocabulary: []
   },
+  PageContainerMeasureProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: []
+  },
+  PageContainerPresetProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: []
+  },
+  PageHeaderProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      "TitleProp",
+      "SubtitleProp",
+      "ExtraProp",
+      "BreadcrumbProp",
+      {
+        field: "meta",
+        local: true,
+        reason: "Status/meta band rendered inline with the `<h1>` (a Badge tone, a record id, a timestamp). A free ReactNode slot, not a controlled value \u2014 the header never interprets what it holds."
+      },
+      {
+        field: "layout",
+        local: true,
+        reason: "Header ARRANGEMENT of the title band vs the extra slot below the 640px step (stack | responsive-inline) \u2014 the standalone spelling of PageContainer's `headerLayout`."
+      },
+      {
+        field: "loading",
+        local: true,
+        reason: "Pending state of the TITLE BAND only (skeleton title/subtitle + aria-busy), distinct from a page-wide DataState: breadcrumbs and actions come from the route and stay live while the record resolves."
+      }
+    ]
+  },
   PageContainerProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -436,10 +501,25 @@ const COMPONENT_PROP_REGISTRY = {
       "BreadcrumbProp",
       "DensityProp",
       "PageContainerVariantProp",
+      {
+        field: "meta",
+        local: true,
+        reason: "Forwarded verbatim to PageHeader's `meta` slot \u2014 see PageHeaderProp."
+      },
+      {
+        field: "headerLoading",
+        local: true,
+        reason: "Forwarded to PageHeader's `loading`. Named for the BAND it skeletonises, so it can never be read as a page-wide loading flag (that is DataState's job)."
+      },
       {
         field: "headerLayout",
         local: true,
         reason: "Header ARRANGEMENT of the title band vs the extra slot below the 640px step (stack | responsive-inline) \u2014 orthogonal to PageContainerVariantProp, which selects the page shell layout."
+      },
+      {
+        field: "measure",
+        local: true,
+        reason: "Bounded page MEASURE shared by the header and body (default | narrow | medium), backed by --page-measure-*. A third orthogonal axis: PageContainerVariantProp owns page CHROME, this owns the inline cap, so a quiet ghost page can also be measure-bounded."
       }
     ]
   },
@@ -454,7 +534,18 @@ const COMPONENT_PROP_REGISTRY = {
       "GapProp",
       { field: "align", local: true, reason: "Flex-specific align-items keyword subset." },
       { field: "justify", local: true, reason: "Flex-specific justify-content keyword subset." },
-      { field: "wrap", local: true, reason: "Flex-specific boolean shorthand for flex-wrap." }
+      { field: "wrap", local: true, reason: "Flex-specific boolean shorthand for flex-wrap." },
+      "BreakpointProp",
+      {
+        field: "hideBelow",
+        local: true,
+        reason: "Responsive region visibility at a canonical breakpoint step \u2014 the public alternative to a page-local media query (gh#252)."
+      },
+      {
+        field: "hideFrom",
+        local: true,
+        reason: "Inverse of hideBelow \u2014 keeps a compact-only region off the wide layout."
+      }
     ]
   },
   ResponsiveGridColumnsProp: { group: "layout", file: "components/layout.prop.ts", vocabulary: [] },
@@ -596,6 +687,12 @@ const COMPONENT_PROP_REGISTRY = {
       }
     ]
   },
+  AuthAccountSummaryProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: ["DisabledProp", "ClassNameProp"],
+    local: ["email", "avatarSrc", "avatarFallback", "actionLabel", "onAction"]
+  },
   CenteredShellProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -603,7 +700,81 @@ const COMPONENT_PROP_REGISTRY = {
       "ChildrenProp",
       "ClassNameProp",
       "CenteredShellWidthProp",
-      "CenteredShellAlignProp"
+      "CenteredShellAlignProp",
+      "CenteredShellPresetProp"
+    ]
+  },
+  ErrorSurfaceMaintenanceProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      {
+        field: "start",
+        local: true,
+        reason: "ISO 8601 instant starting the maintenance window; formatted via Intl.DateTimeFormat and emitted as the <time dateTime> value."
+      },
+      {
+        field: "end",
+        local: true,
+        reason: "ISO 8601 instant ending the window; omitted for an open-ended outage."
+      },
+      {
+        field: "timeZone",
+        local: true,
+        reason: "IANA time zone id the window is presented in \u2014 explicit so SSR and client output cannot diverge."
+      },
+      {
+        field: "progress",
+        local: true,
+        reason: "Server-sent 0\u2013100 completion of the maintenance window; deriving it from the client clock would break hydration."
+      }
+    ]
+  },
+  ErrorSurfaceProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      "ErrorSurfaceModeProp",
+      "ErrorSurfaceStatusProp",
+      "TitleProp",
+      "DescriptionProp",
+      "ActionProp",
+      "IconProp",
+      "HeadingLevelProp",
+      "FooterProp",
+      "CenteredShellWidthProp",
+      "IdProp",
+      "ClassNameProp",
+      {
+        field: "tone",
+        local: true,
+        reason: "Reuses the EmptyStateToneProp union verbatim (the surface renders an EmptyState) \u2014 a status-derived default the consumer may override, not a new tone vocabulary."
+      },
+      {
+        field: "requestId",
+        local: true,
+        reason: "Support correlation id for the failure, rendered as a mono/tabular metadata row \u2014 an identifier, not a LabelProp."
+      },
+      {
+        field: "permission",
+        local: true,
+        reason: "The permission/role the viewer is missing (403). The localized label is the surface's; the value is the bare permission name."
+      },
+      {
+        field: "organization",
+        local: true,
+        reason: "The organization/tenant the failed request was scoped to \u2014 disambiguates a wrong-workspace 403 from a missing-role 403."
+      },
+      {
+        field: "maintenance",
+        local: true,
+        reason: "ErrorSurfaceMaintenanceProp timing/progress slot (ISO 8601 + IANA), formatted with Intl.DateTimeFormat."
+      },
+      {
+        field: "brand",
+        local: true,
+        reason: "system-mode brand slot above the status code (a Logo); the application shell already shows the brand."
+      }
     ]
   },
   LegalDocumentSectionProp: {
@@ -1048,6 +1219,11 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/data-display.prop.ts",
     vocabulary: ["LabelProp", "ValueProp"]
   },
+  AvatarProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: ["AvatarShapeProp", "ChildrenProp", "ClassNameProp"]
+  },
   BadgeProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",
@@ -1056,7 +1232,40 @@ const COMPONENT_PROP_REGISTRY = {
   DataTableProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",
-    vocabulary: ["ColumnDefProp", "DensityProp", "SortStateProp", "SelectedIdsProp", "HandlerProp"]
+    vocabulary: [
+      "ColumnDefProp",
+      "DensityProp",
+      "SortStateProp",
+      "SelectedIdsProp",
+      "HandlerProp",
+      "TablePresetProp",
+      "TableColumnPriorityProp",
+      "BreakpointProp"
+    ]
+  },
+  ListRowDensityProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: []
+  },
+  ListRowProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: [
+      "TitleProp",
+      "DescriptionProp",
+      "ClassNameProp",
+      {
+        field: "density",
+        local: true,
+        reason: "ListRow-local density subset (default | compact) \u2014 the compact inline-actions geometry (#246). No `comfortable` step, and unrelated to PageDensityProp/TableDensityProp."
+      },
+      {
+        field: "overflow",
+        local: true,
+        reason: "Row-local overflow resolution for the title/description column (truncate | wrap, #224)."
+      }
+    ]
   },
   CredentialRevealProp: {
     group: "data-display",
@@ -1309,6 +1518,13 @@ const COMPONENT_PROP_REGISTRY = {
       "ChildrenProp"
     ]
   },
+  BannerProp: {
+    group: "feedback",
+    file: "components/feedback.prop.ts",
+    // `Omit<AlertProp, "variant">` — the alias fixes the one prop it drops, so it inherits Alert's
+    // vocabulary exactly. Listing it again here is what keeps the guard honest if Alert's API moves.
+    vocabulary: ["ToneProp", "IconProp", "OnValueChangeProp", "ClassNameProp", "ChildrenProp"]
+  },
   AlertTitleProp: {
     group: "feedback",
     file: "components/feedback.prop.ts",
@@ -1339,7 +1555,45 @@ const COMPONENT_PROP_REGISTRY = {
       "HasActiveFiltersProp",
       "StickyProp",
       "ClassNameProp",
-      "ChildrenProp"
+      "ChildrenProp",
+      {
+        field: "search",
+        local: true,
+        reason: "SLOT for the caller's own search control, positioned at the start of the row and measured by --filter-bar-search-width. Not a value/onValueChange pair: the bar owns the search's PLACE and WIDTH, never its state (gh#258)."
+      },
+      {
+        field: "chips",
+        local: true,
+        reason: "APPLIED filters as removable chips \u2014 the visible record of filters already in effect, distinct from the controls that set them. A bar-specific shape (id/label/onRemove), not a shared vocabulary type (gh#258)."
+      },
+      {
+        field: "onChipRemove",
+        local: true,
+        reason: "Chip-removal callback keyed by chip id. Not `onValueChange`: it reports ONE lifted filter rather than the bar's whole value, which the bar deliberately does not hold (gh#258)."
+      },
+      {
+        field: "resultCount",
+        local: true,
+        reason: "Number of records the current filters resolve to, announced in a polite live region and formatted via Intl.NumberFormat + CLDR plurals. Presentational output, not a controlled value (gh#258)."
+      },
+      {
+        field: "actions",
+        local: true,
+        reason: "Trailing action SLOT (export, column settings, saved views), ordered AFTER the reset control by the bar so `clear filters` never sits beside an unrelated primary action (gh#258)."
+      }
+    ]
+  },
+  FilterBarChipProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: [
+      "IdProp",
+      "LabelProp",
+      {
+        field: "onRemove",
+        local: true,
+        reason: "Per-chip removal. Omitting it is meaningful \u2014 the chip renders with NO remove control (a filter the user may not lift), rather than a disabled button that is a dead tab stop (gh#258)."
+      }
     ]
   },
   FilterBarOverflowProp: {
@@ -1362,6 +1616,16 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/navigation.prop.ts",
     vocabulary: ["ValueProp", "DefaultValueProp", "SizeProp", "OnValueChangeProp", "ClassNameProp"]
   },
+  InputOTPGroupProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: ["ClassNameProp"]
+  },
+  InputOTPGroupAppearanceProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: []
+  },
   StepItemProp: {
     group: "navigation",
     file: "components/navigation.prop.ts",