@godxjp/ui 18.5.0 → 18.6.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,6 +451,16 @@ 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 PageContainerProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
@@ -428,6 +468,10 @@ export declare const COMPONENT_PROP_REGISTRY: {
             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 +508,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 +633,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 +1033,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 +1046,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";
@@ -1274,6 +1405,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,16 @@ 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: []
+  },
   PageContainerProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -440,6 +480,11 @@ const COMPONENT_PROP_REGISTRY = {
         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 +499,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 +652,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 +665,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 +1184,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 +1197,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",
@@ -1362,6 +1536,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",

package/dist/props/vocabulary/data.prop.d.ts

@@ -40,6 +40,17 @@ export type ColumnDefProp<T> = {
      * separating shadow. Pin at most one column per table.
      */
     pin?: "end";
+    /**
+     * Relative importance of the column, read ONLY by `DataTable preset="action-collection"`
+     * (gh#253). It is the SAME contract the `Table` primitive exposes on `TableHead`/`TableCell`:
+     * DataTable stamps it onto both cells of the column for you, so the preset can swap the desktop
+     * intrinsic widths for the token-owned priority measures (`--table-action-collection-*`) instead
+     * of scrolling a five-column approval queue sideways at 390px. Leave the free-text column
+     * unmarked — it takes the remaining space. Emitted as `data-priority` only when set, so an
+     * ordinary column gains no attribute. Prefer this over `width` under the preset: an explicit
+     * `width` utility wins the cascade and defeats the priority measure.
+     */
+    priority?: TableColumnPriorityProp;
 };
 /** Set of selected row IDs. */
 export type SelectedIdsProp = Set<string>;
@@ -64,3 +75,19 @@ export type HasActiveFiltersProp = boolean;
  * offset/background are tuned via the `--filter-bar-sticky-*` theme knobs.
  */
 export type StickyProp = boolean;
+/**
+ * Table named collection preset. `"default"` keeps the plain table (and emits no attribute).
+ * `"action-collection"` is the canonical dense approval / action queue: below `collapseBelow`
+ * the desktop intrinsic column widths are replaced by token-owned column-PRIORITY measures under
+ * `table-layout: fixed` and cells wrap, so every column — including the row actions — stays inside
+ * the initial narrow frame. The real `<table>` semantics are never rewritten.
+ */
+export type TablePresetProp = "default" | "action-collection";
+/**
+ * Relative importance of a table column, used by `preset="action-collection"` to allocate the
+ * narrow-frame measure. `"primary"` is the row's subject, `"secondary"` its object/target,
+ * `"meta"` a low-priority stamp (dates, ids), `"actions"` the row-action affordance whose measure
+ * is reserved first so it can never be pushed outside the viewport. A column with no priority
+ * takes the remaining space (the free-text column).
+ */
+export type TableColumnPriorityProp = "primary" | "secondary" | "meta" | "actions";

package/dist/props/vocabulary/index.d.ts

@@ -1,7 +1,7 @@
 /** Barrel — all vocabulary prop types. */
 export type { ClassNameProp, ChildrenProp, IdProp, OpenProp, DefaultOpenProp, OnOpenChangeProp, HandlerProp, PendingProp, RequiredProp, DisabledProp, LabelProp, HelperProp, ErrorProp, PlaceholderProp, NameProp, ValueProp, DefaultValueProp, OnValueChangeProp, OnChangeProp, OnClickProp, AsChildProp, WidthProp, } from "./shared.prop.js";
 export type { TitleProp, SubtitleProp, DescriptionProp, ExtraProp, FooterProp, ActionProp, IconProp, ConfirmLabelProp, CancelLabelProp, ActionsProp, EmptyMessageProp, } from "./content.prop.js";
-export type { PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, AuthShellPresetProp, TableDensityProp, DensityProp, GapProp, } from "./layout.prop.js";
-export type { ButtonVariantProp, ButtonSizeProp, BadgeVariantProp, AppSettingPickerAppearanceProp, ShapeProp, TextSizeProp, TextToneProp, FontWeightProp, HeadingLevelProp, TextAlignProp, SizeProp, FormLayoutProp, BreakpointProp, ConfirmVariantProp, ToneProp, AlertVariantProp, SortDirectionProp, ColumnAlignProp, SortStateProp, RevealDelayProp, } from "./interaction.prop.js";
+export type { PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, TableDensityProp, DensityProp, GapProp, } from "./layout.prop.js";
+export type { ButtonVariantProp, ButtonSizeProp, BadgeVariantProp, AppSettingPickerAppearanceProp, ShapeProp, AvatarShapeProp, TextSizeProp, TextToneProp, FontWeightProp, HeadingLevelProp, TextAlignProp, SizeProp, FormLayoutProp, BreakpointProp, ConfirmVariantProp, ToneProp, AlertVariantProp, SortDirectionProp, ColumnAlignProp, SortStateProp, RevealDelayProp, } from "./interaction.prop.js";
 export type { BreadcrumbItemProp, BreadcrumbProp } from "./navigation.prop.js";
-export type { GetRowIdProp, OnRowClickProp, ColumnDefProp, SelectedIdsProp, OnSelectChangeProp, OnTableDensityChangeProp, OnSortChangeProp, OnSearchChangeProp, OnClearFiltersProp, HasActiveFiltersProp, StickyProp, } from "./data.prop.js";
+export type { GetRowIdProp, OnRowClickProp, ColumnDefProp, TablePresetProp, TableColumnPriorityProp, SelectedIdsProp, OnSelectChangeProp, OnTableDensityChangeProp, OnSortChangeProp, OnSearchChangeProp, OnClearFiltersProp, HasActiveFiltersProp, StickyProp, } from "./data.prop.js";

package/dist/props/vocabulary/interaction.prop.d.ts

@@ -7,6 +7,15 @@ export type ButtonVariantProp = "default" | "destructive" | "outline" | "dashed"
 /** Corner shape — maps to the radius tokens (default = control/component radius). Shared by
  *  Button + Badge. `pill` = fully rounded (`--radius-pill`), `sharp` = square (`--radius-sharp`). */
 export type ShapeProp = "default" | "pill" | "sharp";
+/**
+ * Avatar geometry — WHAT the mark represents, not just its corner radius, which is why it is a
+ * separate vocabulary from the control `ShapeProp` (`default | pill | sharp`): an entity mark is a
+ * ROUNDED rect, a value `ShapeProp` cannot express (its `sharp` = `--radius-sharp` = 0).
+ * - `circle` (default) — a person: the fully-round `--radius-pill` identity avatar.
+ * - `square` — an organization / service entity mark for an entity header: the compact rounded
+ *   square on the brand surface (`--avatar-square-*` tokens).
+ */
+export type AvatarShapeProp = "circle" | "square";
 /** Text size — steps of the golden-ratio type scale (NEVER an arbitrary px). `sm` = base. */
 export type TextSizeProp = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 /** Text colour intent — maps to semantic foreground tokens (no raw palette). */

package/dist/props/vocabulary/layout.prop.d.ts

@@ -17,18 +17,49 @@ export type CenteredShellWidthProp = "sm" | "md" | "lg";
  * maintenance notice) — the geometry stays package-owned, so no consumer `min-h-dvh` / flex CSS.
  */
 export type CenteredShellAlignProp = "start" | "center";
+/**
+ * ErrorSurface shell contract — WHERE the exception surface lives, not how it looks.
+ *
+ * `"application"` (403 / 404): the failure happened INSIDE the authenticated app, so the surface is
+ * the page BODY of the `AppShell` the route already renders. It never reconstructs nav chrome — a
+ * component cannot manufacture the sidebar/topbar/user menu, which are consumer-owned; it renders
+ * as `AppShell`'s children (usually inside a `PageContainer`) so the shell is PRESERVED and the
+ * user is never stranded chrome-less.
+ *
+ * `"system"` (500 / 503): the app itself failed — session and nav data may be gone — so the surface
+ * owns the whole page and renders package-owned viewport-centred geometry
+ * (`CenteredShell align="center"`), with no consumer `min-h-dvh` / flex CSS at 1440 / 1024 / 390.
+ */
+export type ErrorSurfaceModeProp = "application" | "system";
+/**
+ * The HTTP status an ErrorSurface presents. Deliberately closed to the four exception pages every
+ * app ships (RFC 9110 §15.5.4 / §15.5.5 / §15.6.1 / §15.6.4); it drives the default icon, tone and
+ * the recommended `mode`. A number, never a string — it is the numeric status, and it is rendered
+ * with tabular figures.
+ */
+export type ErrorSurfaceStatusProp = 403 | 404 | 500 | 503;
 /**
  * AuthShell named flow preset — the page MEASURE contract for a canonical hosted-identity flow
  * (card max-width plus the desktop and mobile page gutters), owned by component tokens.
- * `"default"` keeps the shell's own measure; `"device-authorization"` is the 380px device-grant
- * measure with a 5px mobile inline gutter; `"context-selection"` is the 25rem organisation/context
- * picker measure that goes edge-to-edge on mobile; `"account-recovery"` is the 432px SCR-008
- * measure shared by the password-recovery and sign-in MFA challenge panels (15px mobile inline
- * gutter). Orthogonal to AuthShell's `variant` (which owns control density and heading size) —
- * combine them.
+ * `"default"` keeps the shell's own measure; `"login"` owns SCR-001's stable card anchor for
+ * standalone and requester flows; `"device-authorization"` is the 380px device-grant measure with
+ * a 5px mobile inline gutter; `"context-selection"` is the 25rem organisation/context picker
+ * measure that goes edge-to-edge on mobile; `"account-recovery"` is the 432px SCR-008 measure
+ * shared by the password-recovery and sign-in MFA challenge panels (15px mobile inline gutter).
+ * Orthogonal to AuthShell's `variant` (which owns control density and heading size) — combine them.
  */
-export type AuthShellPresetProp = "default" | "device-authorization" | "context-selection" | "account-recovery";
+export type AuthShellPresetProp = "default" | "login" | "device-authorization" | "context-selection" | "account-recovery";
 /** Shared gap between layout children; components may document subsets. */
 export type GapProp = "xs" | "sm" | "md" | "lg" | "xl";
 /** DataTable row density subset. */
 export type TableDensityProp = Exclude<DensityProp, "default">;
+/**
+ * CenteredShell named page preset — the token-owned SHELL geometry of a whole page shape.
+ * `"default"` keeps the shell's own box (and emits no attribute at all, so it can match no rule).
+ * `"public-landing"` is the PUBLIC marketing / product landing contract: one content measure
+ * shared by the header bar, the centred column and the footer, the section rhythm between page
+ * sections, the flat (elevation-free) public-surface chrome and the hero heading tier — all owned
+ * by `--centered-shell-landing-*` knobs so the landing COMPOSITION (hero, nav, sections, footer —
+ * each of which fails the Framework-Component Test) needs no page-local CSS.
+ */
+export type CenteredShellPresetProp = "default" | "public-landing";

package/dist/styles/control.css

@@ -745,6 +745,34 @@
   border-start-end-radius: var(--radius-md);
   border-end-end-radius: var(--radius-md);
 }
+.ui-otp-group[data-appearance="grouped"] {
+  overflow: hidden;
+  border: 1px solid hsl(var(--border));
+  border-radius: var(--radius-md);
+  background: hsl(var(--background));
+}
+.ui-otp-group[data-appearance="grouped"] .ui-otp-slot {
+  border: 0;
+  border-radius: 0;
+  background: transparent;
+}
+.ui-otp-group[data-appearance="grouped"] .ui-otp-slot[data-active="true"] {
+  box-shadow: none;
+}
+.ui-otp-group[data-appearance="grouped"]:has(.ui-otp-slot[data-active="true"]) {
+  border-color: hsl(var(--focus-ring-color, var(--ring)));
+  box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color, var(--ring)));
+}
+.ui-otp-container:has(.ui-otp-input[aria-invalid="true"]) .ui-otp-group[data-appearance="grouped"] {
+  border-color: hsl(var(--destructive));
+}
+.ui-otp-container:has(.ui-otp-input[aria-invalid="true"])
+  .ui-otp-group[data-appearance="grouped"]:has(.ui-otp-slot[data-active="true"]) {
+  box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--destructive));
+}
+.ui-otp-container:has(.ui-otp-input:disabled) .ui-otp-group[data-appearance="grouped"] {
+  background: hsl(var(--muted));
+}
 .ui-otp-slot[data-active="true"] {
   z-index: 1;
   box-shadow: 0 0 0 var(--focus-ring-width) hsl(var(--focus-ring-color, var(--ring)));