@godxjp/ui 18.15.4 → 19.0.0

package/dist/props/registry.d.ts

@@ -229,6 +229,11 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "layout";
         readonly description: "HTTP status an ErrorSurface presents — 400 | 403 | 404 | 500 | 503 (numeric); drives the default icon, tone and mode";
     };
+    readonly OrientationProp: {
+        readonly file: "vocabulary/layout.prop.ts";
+        readonly category: "layout";
+        readonly description: "Axis of a rule / track / group — horizontal (inline axis, the default) | vertical (block axis). One shared meaning for `orientation` across Separator, Steps, RadioGroup and Toolbar.";
+    };
     readonly AuthShellPresetProp: {
         readonly file: "vocabulary/layout.prop.ts";
         readonly category: "layout";
@@ -354,6 +359,16 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "interaction";
         readonly description: "Reveal entrance-stagger ordinal (0..6) — an index into the motion ladder, never a raw ms";
     };
+    readonly ActivityVariantProp: {
+        readonly file: "vocabulary/interaction.prop.ts";
+        readonly category: "interaction";
+        readonly description: "Activity ambient mark — dots (typing) | pulse (live/recording) | bar (indeterminate sync)";
+    };
+    readonly ActivityAnnounceProp: {
+        readonly file: "vocabulary/interaction.prop.ts";
+        readonly category: "interaction";
+        readonly description: "Whether an ambient indicator announces its label — false (default, no live region) | polite";
+    };
     readonly BreadcrumbItemProp: {
         readonly file: "vocabulary/navigation.prop.ts";
         readonly category: "navigation";
@@ -397,7 +412,7 @@ export declare const VOCABULARY_REGISTRY: {
     readonly ColumnDefProp: {
         readonly file: "vocabulary/data.prop.ts";
         readonly category: "data";
-        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 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";
@@ -461,6 +476,11 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly PageContainerHeaderScaleProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly PageContainerMeasureProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
@@ -475,6 +495,10 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly ["TitleProp", "SubtitleProp", "StatusProp", "ExtraProp", "FooterProp", "BreadcrumbProp", "DensityProp", "PageContainerVariantProp", {
+            readonly field: "toolbar";
+            readonly local: true;
+            readonly reason: "FIXED chrome band between the page header and the scrolling body (filter strip, status bar, channel workflow rail). Distinct from ExtraProp (header actions, inside the title row) and FooterProp (action bar after the body): it is the only slot that stays OUT of the `fill` scroll viewport while sharing the header/body gutters and measure, so a consumer never hand-lays `position: sticky` page chrome.";
+        }, {
             readonly field: "headerLoading";
             readonly local: true;
             readonly reason: "Pending state of the TITLE BAND only (skeleton title/subtitle + aria-busy on the header). Named for the BAND it skeletonises, so it can never be read as a page-wide loading flag (that is DataState's job); breadcrumbs and `extra` come from the route and stay live while the record resolves.";
@@ -482,6 +506,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: "headerScale";
+            readonly local: true;
+            readonly reason: "What the page's top row IS — a document title or the surface's own chrome (document | chrome) — which selects the title's type step via --page-title-font-size-chrome AND opens the page flush with the frame via --page-pad-block-start-chrome (chrome sits on the edge; a document title gets the page's top margin). A fourth orthogonal axis: PageContainerVariantProp owns chrome WEIGHT (ghost drops the divider and header pad), headerLayout owns the header ARRANGEMENT, measure owns the inline cap; none of them can say that the h1 is a channel name rather than a headline.";
         }, {
             readonly field: "measure";
             readonly local: true;
@@ -617,6 +645,19 @@ export declare const COMPONENT_PROP_REGISTRY: {
             readonly reason: "Auth-specific vertical-density scope for card descendants.";
         }, "AuthShellPresetProp"];
     };
+    readonly SeparatorProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["OrientationProp", "LabelProp", "TextAlignProp", "TextToneProp", "ClassNameProp", {
+            readonly field: "labelAlign";
+            readonly local: true;
+            readonly reason: "Placement of the label ON the rule (which half is short), not the text alignment of a block — it reads the shared TextAlignProp start|center|end vocabulary so it stays logical under RTL.";
+        }, {
+            readonly field: "decorative";
+            readonly local: true;
+            readonly reason: "Radix Separator a11y fork: role=none vs a real role=separator. A `label` flips the default to false because the text is content, not decoration.";
+        }];
+    };
     readonly AuthDividerProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
@@ -772,10 +813,19 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly ["LabelProp"];
     };
+    readonly SidebarBadgeToneProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly SidebarItemProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
-        readonly vocabulary: readonly ["IdProp", "LabelProp", "DisabledProp", "ChildrenProp"];
+        readonly vocabulary: readonly ["IdProp", "LabelProp", "DisabledProp", "ChildrenProp", {
+            readonly field: "badgeTone";
+            readonly local: true;
+            readonly reason: "Emphasis of the row's count pill (neutral | destructive) — an Extract<> subset of the shared ToneProp vocabulary, not a new one. It is `badgeTone` rather than `tone` because the item ALSO has `disabled`/`active` row states: a bare `tone` on a nav row would read as the row's colour, and the axis only ever recolours the badge. Mirrors the existing `badge`/`badgeLabel` pairing on OrgSwitcherOrganization.";
+        }];
     };
     readonly SidebarRenderItemProp: {
         readonly group: "layout";
@@ -840,6 +890,15 @@ export declare const COMPONENT_PROP_REGISTRY: {
             readonly reason: "Reveal stagger ordinal — RevealDelayProp vocabulary.";
         }];
     };
+    readonly ActivityProp: {
+        readonly group: "general";
+        readonly file: "components/general.prop.ts";
+        readonly vocabulary: readonly ["ActivityVariantProp", "SizeProp", "TextToneProp", "LabelProp", "ChildrenProp", "ActivityAnnounceProp", "ClassNameProp", {
+            readonly field: "announce";
+            readonly local: true;
+            readonly reason: "Ambient live-region opt-in — ActivityAnnounceProp vocabulary; deliberately NOT a boolean so the value names the politeness level.";
+        }];
+    };
     readonly TextProp: {
         readonly group: "general";
         readonly file: "components/general.prop.ts";
@@ -858,7 +917,7 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly TextareaProp: {
         readonly group: "data-entry";
         readonly file: "components/data-entry.prop.ts";
-        readonly vocabulary: readonly ["PlaceholderProp", "DisabledProp"];
+        readonly vocabulary: readonly ["PlaceholderProp", "DisabledProp", "ValueProp", "DefaultValueProp", "OnChangeProp", "IdProp", "ClassNameProp"];
     };
     readonly NumberInputProp: {
         readonly group: "data-entry";
@@ -1065,13 +1124,18 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly AvatarProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
-        readonly vocabulary: readonly ["AvatarShapeProp", "ChildrenProp", "ClassNameProp"];
+        readonly vocabulary: readonly ["AvatarShapeProp", "LabelProp", "ChildrenProp", "ClassNameProp"];
     };
     readonly AvatarAppearanceProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly AvatarPresenceProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly BadgeProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
@@ -1110,6 +1174,36 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-display.prop.ts";
         readonly vocabulary: readonly ["ValueProp", "LabelProp", "SizeProp", "ClassNameProp", "IdProp"];
     };
+    readonly ScrollAreaAnchorProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "anchor";
+            readonly local: true;
+            readonly reason: 'Edge the scrolling viewport sticks to as content grows ("none" | "bottom"). A closed union, not a boolean pair — the third edge ("top", for an inverted feed) is a value, not another flag.';
+        }];
+    };
+    readonly ScrollAreaProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["OnValueChangeProp", {
+            readonly field: "viewportRef";
+            readonly local: true;
+            readonly reason: "Ref to the SCROLLING element (the Radix viewport), which the component's own `ref` cannot reach — the root is overflow:hidden.";
+        }, {
+            readonly field: "anchor";
+            readonly local: true;
+            readonly reason: "See ScrollAreaAnchorProp — the sticky edge vocabulary.";
+        }, {
+            readonly field: "anchorOffset";
+            readonly local: true;
+            readonly reason: 'Per-instance override of --scroll-area-anchor-offset: how close to the bottom still counts as "following".';
+        }, {
+            readonly field: "onAnchoredChange";
+            readonly local: true;
+            readonly reason: 'Pinned-state change handler (boolean), so the consumer can render its own focusable "jump to newest" affordance.';
+        }];
+    };
     readonly ChartSeriesProp: {
         readonly group: "data-display";
         readonly file: "components/charts.prop.ts";
@@ -1532,7 +1626,24 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly ToggleProp: {
         readonly group: "data-entry";
         readonly file: "components/ui/toggle.tsx";
-        readonly vocabulary: readonly ["SizeProp", "ClassNameProp"];
+        readonly vocabulary: readonly ["SizeProp", "ClassNameProp", {
+            readonly field: "count";
+            readonly local: true;
+            readonly reason: "Counter-pill vocabulary shared VERBATIM with ButtonProp (count/overflowCount/showZero) so a counted filter tab and a counted pressed chip are one vocabulary — gh#312.";
+        }, {
+            readonly field: "countLabel";
+            readonly local: true;
+            readonly reason: "Localized unit folded into the accessible name so a counted icon/emoji chip never announces as a bare number.";
+        }];
+    };
+    readonly ToggleGroupItemProp: {
+        readonly group: "data-entry";
+        readonly file: "components/ui/toggle-group.tsx";
+        readonly vocabulary: readonly ["SizeProp", "ClassNameProp", {
+            readonly field: "count";
+            readonly local: true;
+            readonly reason: "Per-item counter pill — variant/size come from group context, but the number is per-item data (gh#312).";
+        }];
     };
     readonly CommandPaletteProp: {
         readonly group: "data-entry";

package/dist/props/registry.js

@@ -227,6 +227,11 @@ const VOCABULARY_REGISTRY = {
     category: "layout",
     description: "HTTP status an ErrorSurface presents \u2014 400 | 403 | 404 | 500 | 503 (numeric); drives the default icon, tone and mode"
   },
+  OrientationProp: {
+    file: "vocabulary/layout.prop.ts",
+    category: "layout",
+    description: "Axis of a rule / track / group \u2014 horizontal (inline axis, the default) | vertical (block axis). One shared meaning for `orientation` across Separator, Steps, RadioGroup and Toolbar."
+  },
   AuthShellPresetProp: {
     file: "vocabulary/layout.prop.ts",
     category: "layout",
@@ -353,6 +358,16 @@ const VOCABULARY_REGISTRY = {
     category: "interaction",
     description: "Reveal entrance-stagger ordinal (0..6) \u2014 an index into the motion ladder, never a raw ms"
   },
+  ActivityVariantProp: {
+    file: "vocabulary/interaction.prop.ts",
+    category: "interaction",
+    description: "Activity ambient mark \u2014 dots (typing) | pulse (live/recording) | bar (indeterminate sync)"
+  },
+  ActivityAnnounceProp: {
+    file: "vocabulary/interaction.prop.ts",
+    category: "interaction",
+    description: "Whether an ambient indicator announces its label \u2014 false (default, no live region) | polite"
+  },
   // navigation.prop.ts
   BreadcrumbItemProp: {
     file: "vocabulary/navigation.prop.ts",
@@ -465,6 +480,11 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/layout.prop.ts",
     vocabulary: []
   },
+  PageContainerHeaderScaleProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: []
+  },
   PageContainerMeasureProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -487,6 +507,11 @@ const COMPONENT_PROP_REGISTRY = {
       "BreadcrumbProp",
       "DensityProp",
       "PageContainerVariantProp",
+      {
+        field: "toolbar",
+        local: true,
+        reason: "FIXED chrome band between the page header and the scrolling body (filter strip, status bar, channel workflow rail). Distinct from ExtraProp (header actions, inside the title row) and FooterProp (action bar after the body): it is the only slot that stays OUT of the `fill` scroll viewport while sharing the header/body gutters and measure, so a consumer never hand-lays `position: sticky` page chrome."
+      },
       {
         field: "headerLoading",
         local: true,
@@ -497,6 +522,11 @@ const COMPONENT_PROP_REGISTRY = {
         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: "headerScale",
+        local: true,
+        reason: "What the page's top row IS \u2014 a document title or the surface's own chrome (document | chrome) \u2014 which selects the title's type step via --page-title-font-size-chrome AND opens the page flush with the frame via --page-pad-block-start-chrome (chrome sits on the edge; a document title gets the page's top margin). A fourth orthogonal axis: PageContainerVariantProp owns chrome WEIGHT (ghost drops the divider and header pad), headerLayout owns the header ARRANGEMENT, measure owns the inline cap; none of them can say that the h1 is a channel name rather than a headline."
+      },
       {
         field: "measure",
         local: true,
@@ -624,6 +654,27 @@ const COMPONENT_PROP_REGISTRY = {
       "AuthShellPresetProp"
     ]
   },
+  SeparatorProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: [
+      "OrientationProp",
+      "LabelProp",
+      "TextAlignProp",
+      "TextToneProp",
+      "ClassNameProp",
+      {
+        field: "labelAlign",
+        local: true,
+        reason: "Placement of the label ON the rule (which half is short), not the text alignment of a block \u2014 it reads the shared TextAlignProp start|center|end vocabulary so it stays logical under RTL."
+      },
+      {
+        field: "decorative",
+        local: true,
+        reason: "Radix Separator a11y fork: role=none vs a real role=separator. A `label` flips the default to false because the text is content, not decoration."
+      }
+    ]
+  },
   AuthDividerProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -836,10 +887,25 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/layout.prop.ts",
     vocabulary: ["LabelProp"]
   },
+  SidebarBadgeToneProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: []
+  },
   SidebarItemProp: {
     group: "layout",
     file: "components/layout.prop.ts",
-    vocabulary: ["IdProp", "LabelProp", "DisabledProp", "ChildrenProp"]
+    vocabulary: [
+      "IdProp",
+      "LabelProp",
+      "DisabledProp",
+      "ChildrenProp",
+      {
+        field: "badgeTone",
+        local: true,
+        reason: "Emphasis of the row's count pill (neutral | destructive) \u2014 an Extract<> subset of the shared ToneProp vocabulary, not a new one. It is `badgeTone` rather than `tone` because the item ALSO has `disabled`/`active` row states: a bare `tone` on a nav row would read as the row's colour, and the axis only ever recolours the badge. Mirrors the existing `badge`/`badgeLabel` pairing on OrgSwitcherOrganization."
+      }
+    ]
   },
   SidebarRenderItemProp: {
     group: "layout",
@@ -920,6 +986,24 @@ const COMPONENT_PROP_REGISTRY = {
       }
     ]
   },
+  ActivityProp: {
+    group: "general",
+    file: "components/general.prop.ts",
+    vocabulary: [
+      "ActivityVariantProp",
+      "SizeProp",
+      "TextToneProp",
+      "LabelProp",
+      "ChildrenProp",
+      "ActivityAnnounceProp",
+      "ClassNameProp",
+      {
+        field: "announce",
+        local: true,
+        reason: "Ambient live-region opt-in \u2014 ActivityAnnounceProp vocabulary; deliberately NOT a boolean so the value names the politeness level."
+      }
+    ]
+  },
   TextProp: {
     group: "general",
     file: "components/general.prop.ts",
@@ -944,7 +1028,15 @@ const COMPONENT_PROP_REGISTRY = {
   TextareaProp: {
     group: "data-entry",
     file: "components/data-entry.prop.ts",
-    vocabulary: ["PlaceholderProp", "DisabledProp"]
+    vocabulary: [
+      "PlaceholderProp",
+      "DisabledProp",
+      "ValueProp",
+      "DefaultValueProp",
+      "OnChangeProp",
+      "IdProp",
+      "ClassNameProp"
+    ]
   },
   NumberInputProp: {
     group: "data-entry",
@@ -1215,13 +1307,18 @@ const COMPONENT_PROP_REGISTRY = {
   AvatarProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",
-    vocabulary: ["AvatarShapeProp", "ChildrenProp", "ClassNameProp"]
+    vocabulary: ["AvatarShapeProp", "LabelProp", "ChildrenProp", "ClassNameProp"]
   },
   AvatarAppearanceProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",
     vocabulary: []
   },
+  AvatarPresenceProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: []
+  },
   BadgeProp: {
     group: "data-display",
     file: "components/data-display.prop.ts",
@@ -1283,6 +1380,44 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/data-display.prop.ts",
     vocabulary: ["ValueProp", "LabelProp", "SizeProp", "ClassNameProp", "IdProp"]
   },
+  ScrollAreaAnchorProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: [
+      {
+        field: "anchor",
+        local: true,
+        reason: 'Edge the scrolling viewport sticks to as content grows ("none" | "bottom"). A closed union, not a boolean pair \u2014 the third edge ("top", for an inverted feed) is a value, not another flag.'
+      }
+    ]
+  },
+  ScrollAreaProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: [
+      "OnValueChangeProp",
+      {
+        field: "viewportRef",
+        local: true,
+        reason: "Ref to the SCROLLING element (the Radix viewport), which the component's own `ref` cannot reach \u2014 the root is overflow:hidden."
+      },
+      {
+        field: "anchor",
+        local: true,
+        reason: "See ScrollAreaAnchorProp \u2014 the sticky edge vocabulary."
+      },
+      {
+        field: "anchorOffset",
+        local: true,
+        reason: 'Per-instance override of --scroll-area-anchor-offset: how close to the bottom still counts as "following".'
+      },
+      {
+        field: "onAnchoredChange",
+        local: true,
+        reason: 'Pinned-state change handler (boolean), so the consumer can render its own focusable "jump to newest" affordance.'
+      }
+    ]
+  },
   ChartSeriesProp: {
     group: "data-display",
     file: "components/charts.prop.ts",
@@ -1664,7 +1799,33 @@ const COMPONENT_PROP_REGISTRY = {
   ToggleProp: {
     group: "data-entry",
     file: "components/ui/toggle.tsx",
-    vocabulary: ["SizeProp", "ClassNameProp"]
+    vocabulary: [
+      "SizeProp",
+      "ClassNameProp",
+      {
+        field: "count",
+        local: true,
+        reason: "Counter-pill vocabulary shared VERBATIM with ButtonProp (count/overflowCount/showZero) so a counted filter tab and a counted pressed chip are one vocabulary \u2014 gh#312."
+      },
+      {
+        field: "countLabel",
+        local: true,
+        reason: "Localized unit folded into the accessible name so a counted icon/emoji chip never announces as a bare number."
+      }
+    ]
+  },
+  ToggleGroupItemProp: {
+    group: "data-entry",
+    file: "components/ui/toggle-group.tsx",
+    vocabulary: [
+      "SizeProp",
+      "ClassNameProp",
+      {
+        field: "count",
+        local: true,
+        reason: "Per-item counter pill \u2014 variant/size come from group context, but the number is per-item data (gh#312)."
+      }
+    ]
   },
   CommandPaletteProp: {
     group: "data-entry",

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, ErrorBagProp, PlaceholderProp, NameProp, ValueProp, DefaultValueProp, OnValueChangeProp, OnChangeProp, OnClickProp, AsChildProp, WidthProp, } from "./shared.prop.js";
 export type { TitleProp, SubtitleProp, StatusProp, DescriptionProp, ExtraProp, FooterProp, ActionProp, IconProp, ConfirmLabelProp, CancelLabelProp, ActionsProp, EmptyMessageProp, } from "./content.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 { PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, OrientationProp, TableDensityProp, DensityProp, GapProp, } from "./layout.prop.js";
+export type { ButtonVariantProp, ButtonSizeProp, BadgeVariantProp, AppSettingPickerAppearanceProp, ShapeProp, AvatarShapeProp, TextSizeProp, TextToneProp, FontWeightProp, HeadingLevelProp, TextAlignProp, SizeProp, FormLayoutProp, DescriptionsLayoutProp, BreakpointProp, ConfirmVariantProp, ToneProp, AlertVariantProp, SortDirectionProp, ColumnAlignProp, SortStateProp, RevealDelayProp, ActivityVariantProp, ActivityAnnounceProp, } from "./interaction.prop.js";
 export type { BreadcrumbItemProp, BreadcrumbProp } from "./navigation.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

@@ -76,3 +76,18 @@ export type SortStateProp = {
  * revealed rows cascades in. Reduced-motion collapses every step to 0 (content stays visible).
  */
 export type RevealDelayProp = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Ambient-activity mark for `Activity` — the LOOP counterpart to `RevealDelayProp`'s one-shot
+ * ladder. `dots` (default) is the three-dot ellipsis convention (someone is typing); `pulse` a
+ * single breathing mark (live / recording); `bar` an indeterminate sweep (syncing).
+ */
+export type ActivityVariantProp = "dots" | "pulse" | "bar";
+/**
+ * Whether an ambient indicator announces its label to assistive technology.
+ *
+ * Default `false` — DELIBERATELY. An ambient affordance flickers on and off with every socket
+ * event; a live region there re-announces continuously and makes the surface unusable with a
+ * screen reader (`Skeleton`'s unconditional `aria-live="polite"` is the anti-pattern this default
+ * exists to avoid). `"polite"` opts in for the rare case where the change genuinely must be heard.
+ */
+export type ActivityAnnounceProp = false | "polite";

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

@@ -71,3 +71,11 @@ export type TableDensityProp = Exclude<DensityProp, "default">;
  * each of which fails the Framework-Component Test) needs no page-local CSS.
  */
 export type CenteredShellPresetProp = "default" | "public-landing";
+/**
+ * Axis of a rule / track / group — the shared inline↔block vocabulary (gh#308).
+ * `"horizontal"` (the default everywhere) runs along the INLINE axis, `"vertical"` along the
+ * BLOCK axis, so both flip correctly under `dir="rtl"` with no per-component rule. Promoted out
+ * of the inline `"horizontal" | "vertical"` unions each component file used to spell for itself,
+ * so `orientation` means one thing across Separator, Steps, RadioGroup and Toolbar.
+ */
+export type OrientationProp = "horizontal" | "vertical";

package/dist/styles/alert-layout.css

@@ -71,8 +71,8 @@
   }
 
   [data-slot="alert-icon"] {
-    width: 1.25rem;
-    height: 1.25rem;
+    width: var(--alert-icon-size);
+    height: var(--alert-icon-size);
     flex-shrink: 0;
     margin-top: 0.125rem;
   }
@@ -178,12 +178,42 @@
     }
   }
 
+  /* Dismiss ✕ — BOTH halves of the affordance now live here. The rest opacity was a hard 0.7 in
+   * this file while its `:hover` companion sat on the component as `hover:opacity-100`, so the
+   * quiet-at-rest chrome (rule #44) was split across two files and a theme could reach neither.
+   * The hover rule is load-bearing: without it the ✕ stays at the rest alpha forever. */
   [data-slot="alert-dismiss"] {
     position: absolute;
     top: var(--alert-dismiss-space-offset);
     inset-inline-end: var(--alert-dismiss-space-offset);
     border-radius: var(--radius-sm);
-    opacity: 0.7;
+    opacity: var(--alert-dismiss-rest-alpha);
+    transition: opacity var(--duration-fast) ease;
+  }
+
+  [data-slot="alert-dismiss"]:hover {
+    opacity: 1;
+  }
+
+  .ui-alert-dismiss-icon {
+    inline-size: var(--alert-dismiss-icon-size);
+    block-size: var(--alert-dismiss-icon-size);
+  }
+
+  /* AlertContent fills the body column but stays shrinkable, so a long unbroken token truncates
+   * instead of widening the alert. Was `min-w-0 flex-1` on the component. */
+  [data-slot="alert-content"] {
+    min-inline-size: 0;
+    flex: 1 1 0%;
+  }
+
+  /* TOAST (Sonner) — the status glyph handed to sonner through its all-or-nothing `icons` config
+   * prop. Sonner sizes the `[data-icon]` WRAPPER to a fixed 16px box and only sets `flex-shrink`
+   * + margins on the svg inside it, so the glyph's own size is ours to own; the token is what
+   * lets a consumer retune it without re-declaring all five icons. */
+  .ui-toast-icon {
+    inline-size: var(--toast-icon-size);
+    block-size: var(--toast-icon-size);
   }
 
   .ui-skeleton-block {
@@ -247,6 +277,42 @@
     border: 1px solid hsl(var(--border));
     border-radius: var(--skeleton-radius);
     padding: var(--skeleton-card-inset);
+
+    /* Skeleton bars, named for what they stand in for rather than their size (#319). */
+    .ui-skeleton-line {
+      block-size: var(--skeleton-block-height);
+    }
+
+    .ui-skeleton-caption {
+      block-size: var(--skeleton-caption-height);
+    }
+
+    .ui-skeleton-title {
+      block-size: var(--skeleton-title-height);
+    }
+
+    .ui-skeleton-detail-label {
+      block-size: var(--skeleton-caption-height);
+      inline-size: var(--skeleton-label-width);
+    }
+
+    /* Fills its grid track but stops at a readable measure — both are load-bearing: without the
+   * fill it would size to content, without the cap it would run the full track. */
+    .ui-skeleton-detail-value {
+      block-size: var(--skeleton-block-height);
+      inline-size: 100%;
+      max-inline-size: var(--skeleton-detail-value-max-width);
+    }
+
+    .ui-skeleton-stat-value {
+      block-size: var(--control-height);
+      inline-size: var(--skeleton-stat-value-width);
+    }
+
+    .ui-skeleton-stat-caption {
+      block-size: var(--skeleton-caption-height);
+      inline-size: var(--skeleton-stat-caption-width);
+    }
   }
 
   @keyframes pulse {

package/dist/styles/badge-layout.css

@@ -40,8 +40,8 @@
   }
 
   [data-slot="badge-icon"] {
-    width: 0.75rem;
-    height: 0.75rem;
+    width: var(--badge-icon-size);
+    height: var(--badge-icon-size);
     flex-shrink: 0;
   }
 }

package/dist/styles/base.css

@@ -108,6 +108,12 @@
  * is never emitted). In-repo the glob scans src; published, it scans dist. */
 @source "../**/*.{tsx,ts,js}";
 @import "../tokens/base.css";
+/* The focus ring is FOUNDATION, not a component layer: every focusable control in
+ * every layer reads the same four tokens from ONE rule (styles/focus-ring.css).
+ * Imported here — not left to index.css — so a consumer that tree-shakes down to
+ * `styles/base` + two layout files still gets keyboard-focus affordance (WCAG
+ * 2.4.7); shipping it as an optional layer would make a11y opt-in by accident. */
+@import "./focus-ring.css";
 @import "./density.css";
 
 /* `inline` (NOT a bare @theme): Tailwind inlines each expression — e.g. `hsl(var(--primary))` —