@godxjp/ui 19.1.0 → 19.2.0

package/dist/props/components/navigation.prop.d.ts

@@ -3,16 +3,15 @@ import type * as React from "react";
 import type { ActionsProp, ChildrenProp, ClassNameProp, DisabledProp, ErrorProp, HasActiveFiltersProp, IdProp, LabelProp, OnClearFiltersProp, PendingProp, PlaceholderProp, StickyProp } from "../vocabulary/index.js";
 import type { SearchSelectOptionProp } from "./data-entry.prop.js";
 /**
- * How a {@link ToolbarProp} strip resolves more filters than fit one row (#216).
  * `wrap` (default) stacks on narrow viewports then wraps onto extra rows; `scroll` keeps ONE
  * bounded row that scrolls inline, so a wide filter set never pushes the list below the fold.
  */
 export type FilterBarOverflowProp = "wrap" | "scroll";
 /**
- * Typed search slot of the FilterBar model (gh#258). Renders the canonical SearchInput as the
- * FIRST control of the strip, with a token-owned consistent width (`--filter-bar-search-width`,
- * full-width below 640px). Controlled by consumer data via the `value`/`defaultValue`/
- * `onValueChange` triad; `onSearch` mirrors SearchInput's debounced-term callback.
+ * Renders the canonical SearchInput as the FIRST control of the strip, with a token-owned
+ * consistent width (`--filter-bar-search-width`, full-width below 640px). Controlled by consumer
+ * data via the `value`/`defaultValue`/ `onValueChange` triad; `onSearch` mirrors SearchInput's
+ * debounced-term callback.
  */
 export type FilterBarSearchProp = {
     value?: string;
@@ -30,11 +29,10 @@ export type FilterBarSearchProp = {
     disabled?: DisabledProp;
 };
 /**
- * One typed filter of the FilterBar model (gh#258): a labelled, domain-neutral Select whose
- * options and selection are consumer data. `value` is the filter's stable identity (never shown);
- * the visible `label` is rendered as the control's real `<label htmlFor>` (WCAG 2.5.3 / 1.3.1).
- * Selection is controlled via `selected`/`defaultSelected`/`onSelectedChange` — the standard
- * triad, renamed so the filter's own identity `value` stays unambiguous.
+ * `value` is the filter's stable identity (never shown); the visible `label` is rendered as the
+ * control's real `<label htmlFor>` (WCAG 2.5.3 / 1.3.1). Selection is controlled via
+ * `selected`/`defaultSelected`/`onSelectedChange` — the standard triad, renamed so the filter's
+ * own identity `value` stays unambiguous.
  */
 export type FilterBarFilterProp = {
     /** Stable filter identity (drives the control id + React key). */
@@ -48,10 +46,10 @@ export type FilterBarFilterProp = {
     disabled?: DisabledProp;
 };
 /**
- * One applied-filter chip of the FilterBar model (gh#258). Chips are pure consumer data — the
- * lifecycle is: ADD by including the chip in `chips`, REMOVE via `onChipRemove(value)` (the ×
- * button), CLEAR-ALL via the bar's `onClear`. `label` should be a string when possible so the
- * remove button's accessible name can quote it; otherwise `value` is quoted instead.
+ * Chips are pure consumer data — the lifecycle is: ADD by including the chip in `chips`, REMOVE
+ * via `onChipRemove(value)` (the × button), CLEAR-ALL via the bar's `onClear`. `label` should be a
+ * string when possible so the remove button's accessible name can quote it; otherwise `value` is
+ * quoted instead.
  */
 export type FilterBarChipProp = {
     /** Stable chip identity, passed to `onChipRemove`. */
@@ -64,24 +62,21 @@ export type ToolbarProp = {
     onClear?: OnClearFiltersProp;
     hasActiveFilters?: HasActiveFiltersProp;
     /**
-     * Pin the strip to the top of its scroll container while the list scrolls beneath it
-     * (list-page filter bars, #197). Opt-in — default `false` keeps the toolbar quiet. Tune
-     * the pinned offset/background with the `--filter-bar-sticky-offset` /
-     * `--filter-bar-sticky-background` theme knobs.
+     * Opt-in — default `false` keeps the toolbar quiet. Tune the pinned offset/background with the
+     * `--filter-bar-sticky-offset` / `--filter-bar-sticky-background` theme knobs.
      */
     sticky?: StickyProp;
     /**
-     * Responsive overflow strategy (#216). Default `wrap`. Use `scroll` for list pages with many
-     * filters (long JA/EN/VI labels) where a wrapped 3-row strip would push the table off screen.
-     * Tune the scrollbar gutter with the `--filter-bar-scroll-padding-y` theme knob.
+     * Default `wrap`. Use `scroll` for list pages with many filters (long JA/EN/VI labels) where a
+     * wrapped 3-row strip would push the table off screen.
      */
     overflow?: FilterBarOverflowProp;
     /**
-     * Typed model (gh#258) — search slot. When ANY model prop (`search`/`filters`/`chips`/
-     * `onChipRemove`/`actions`/`resultCount`/`loading`/`disabled`/`error`) is present the bar renders
-     * the canonical model layout: strip (search → filters → children → reset → actions) → chips row →
-     * result-count/error line, with token-owned widths and stacking. Without any of them the bar
-     * stays the plain children-composition toolbar — existing markup is unchanged.
+     * When ANY model prop (`search`/`filters`/`chips`/
+     * `onChipRemove`/`actions`/`resultCount`/`loading`/`disabled`/`error`) is present the bar
+     * renders the canonical model layout: strip (search → filters → children → reset → actions) →
+     * chips row → result-count/error line, with token-owned widths and stacking. Without any of them
+     * the bar stays the plain children-composition toolbar — existing markup is unchanged.
      */
     search?: FilterBarSearchProp;
     /** Typed model — labelled Select filters rendered after the search slot, in array order. */
@@ -110,9 +105,9 @@ export type ToolbarProp = {
 export type ToolbarGroupProp = {
     label: LabelProp;
     /**
-     * `id` of the single control this group labels (#216). When set, the visible group label is
-     * rendered as that control's real `<label htmlFor>`, so the filter is named by the text the
-     * user sees (WCAG 2.5.3 / 1.3.1) — otherwise the control needs its own `aria-label`.
+     * When set, the visible group label is rendered as that control's real `<label htmlFor>`, so the
+     * filter is named by the text the user sees (WCAG 2.5.3 / 1.3.1) — otherwise the control needs
+     * its own `aria-label`.
      */
     controlId?: IdProp;
     className?: ClassNameProp;
@@ -120,13 +115,7 @@ export type ToolbarGroupProp = {
 };
 /** @see Pagination — offset/page-based (distinct from DataTable cursor pagination). */
 export type PaginationProp = {
-    /**
-     * Override the `<nav>` landmark's accessible name. Defaults to a localized "Pagination".
-     * Multiple Pagination instances on one page/view (e.g. two independent result lists) need a
-     * DISTINCT name each — two `<nav>` landmarks sharing one name/role fail axe's `landmark-unique`
-     * (WCAG 2.4.1 / 1.3.1). Pass something that names what is being paged, e.g. `"注文一覧の
-     * ページネーション"` vs `"請求書一覧のページネーション"`.
-     */
+    /** Override the `<nav>` landmark's accessible name. Defaults to a localized "Pagination". */
     ariaLabel?: string;
     value?: number;
     total?: number;
@@ -137,9 +126,7 @@ export type PaginationProp = {
     /**
      * Hide the whole control when there is nothing to page through — zero items OR exactly one page.
      * `true` (default) keeps table footers clean: pagination is navigation between multiple result
-     * pages, so a lone disabled `1 / 1` bar is noise. Set `false` for the explicit opt-in when a
-     * consumer still wants the bar on a single page (e.g. to keep `showTotal` visible). A control
-     * with `total === 0` is ALWAYS hidden — there is no data to navigate. (gh#153)
+     * pages, so a lone disabled `1 / 1` bar is noise.
      */
     hideOnSinglePage?: boolean;
     simple?: boolean;
@@ -173,9 +160,7 @@ export type StepsProp = {
     titlePlacement?: "horizontal" | "vertical";
     /**
      * The glyph between inline steps (`type="inline"` only). `chevron` (default, `›`) is the
-     * breadcrumb-flavoured original. `arrow` (`→`) is the canonical hosted-identity progression
-     * marker: a chevron reads as "drill into", an arrow reads as "then" — which is what a step row
-     * means. Ignored by every other `type`.
+     * breadcrumb-flavoured original.
      */
     separator?: StepsSeparatorProp;
     onValueChange?: (value: number) => void;

package/dist/props/registry.d.ts

@@ -119,6 +119,11 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "shared";
         readonly description: "Explicit layout length (number→px | CSS string) — NOT the SizeProp tier";
     };
+    readonly ControlWidthProp: {
+        readonly file: "vocabulary/shared.prop.ts";
+        readonly category: "shared";
+        readonly description: "Inline sizing of a control: full (fill the column) | auto (hug the label)";
+    };
     readonly TitleProp: {
         readonly file: "vocabulary/content.prop.ts";
         readonly category: "content";
@@ -699,6 +704,12 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly vocabulary: readonly ["DisabledProp", "ClassNameProp"];
         readonly local: readonly ["email", "avatarSrc", "avatarFallback", "actionLabel", "onAction"];
     };
+    readonly AccountChipProp: {
+        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";
@@ -994,6 +1005,16 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-entry.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly CalendarFooterProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "onClose";
+            readonly local: true;
+            readonly reason: "Fired by the Close footer action; the picker that embeds the Calendar closes its popover. Not a value change.";
+        }];
+        readonly local: readonly ["showToday", "showClose"];
+    };
     readonly DatePickerProp: {
         readonly group: "data-entry";
         readonly file: "components/data-entry.prop.ts";
@@ -1685,6 +1706,16 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-display/progress.tsx";
         readonly vocabulary: readonly ["ValueProp", "LabelProp", "ClassNameProp"];
     };
+    readonly CodeBlockProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["ChildrenProp", "SizeProp", "ClassNameProp"];
+    };
+    readonly ProseProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["SizeProp", "ClassNameProp", "ChildrenProp"];
+    };
     readonly TimelineProp: {
         readonly group: "data-display";
         readonly file: "components/data-display/timeline.tsx";

package/dist/props/registry.js

@@ -115,6 +115,11 @@ const VOCABULARY_REGISTRY = {
     category: "shared",
     description: "Explicit layout length (number\u2192px | CSS string) \u2014 NOT the SizeProp tier"
   },
+  ControlWidthProp: {
+    file: "vocabulary/shared.prop.ts",
+    category: "shared",
+    description: "Inline sizing of a control: full (fill the column) | auto (hug the label)"
+  },
   // content.prop.ts
   TitleProp: {
     file: "vocabulary/content.prop.ts",
@@ -726,6 +731,12 @@ const COMPONENT_PROP_REGISTRY = {
     vocabulary: ["DisabledProp", "ClassNameProp"],
     local: ["email", "avatarSrc", "avatarFallback", "actionLabel", "onAction"]
   },
+  AccountChipProp: {
+    group: "layout",
+    file: "components/layout.prop.ts",
+    vocabulary: ["DisabledProp", "ClassNameProp"],
+    local: ["email", "avatarSrc", "avatarFallback", "actionLabel", "onAction"]
+  },
   CenteredShellProp: {
     group: "layout",
     file: "components/layout.prop.ts",
@@ -1128,6 +1139,18 @@ const COMPONENT_PROP_REGISTRY = {
     vocabulary: ["DisabledProp"]
   },
   CalendarProp: { group: "data-entry", file: "components/data-entry.prop.ts", vocabulary: [] },
+  CalendarFooterProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: [
+      {
+        field: "onClose",
+        local: true,
+        reason: "Fired by the Close footer action; the picker that embeds the Calendar closes its popover. Not a value change."
+      }
+    ],
+    local: ["showToday", "showClose"]
+  },
   DatePickerProp: {
     group: "data-entry",
     file: "components/data-entry.prop.ts",
@@ -1867,6 +1890,16 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/data-display/progress.tsx",
     vocabulary: ["ValueProp", "LabelProp", "ClassNameProp"]
   },
+  CodeBlockProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: ["ChildrenProp", "SizeProp", "ClassNameProp"]
+  },
+  ProseProp: {
+    group: "data-display",
+    file: "components/data-display.prop.ts",
+    vocabulary: ["SizeProp", "ClassNameProp", "ChildrenProp"]
+  },
   TimelineProp: {
     group: "data-display",
     file: "components/data-display/timeline.tsx",

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

@@ -14,36 +14,23 @@ export type ColumnDefProp<T> = {
     key: string;
     header: React.ReactNode;
     /**
-     * Accessible header text for a column whose `header` is visually empty — the
-     * standard case for a row-actions or selection column. Rendered as an
-     * `sr-only` label inside the `<th>` so the column keeps a screen-reader name
-     * (e.g. "Actions" / "Select") while showing nothing on screen. Required
-     * (dev-warned) when `header` is empty; ignored when `header` has visible text.
-     * Route the string through `t()` for i18n.
+     * Accessible header text for a column whose `header` is visually empty — the standard case for a
+     * row-actions or selection column. Rendered as an `sr-only` label inside the `<th>` so the
+     * column keeps a screen-reader name (e.g.
      */
     ariaLabel?: string;
     render?: (row: T) => React.ReactNode;
     sortable?: boolean;
     /**
-     * Column width: either a utility class (`"w-[300px]"`) or a CSS length
-     * (`"300px"`, `"20%"`, `"calc(50% - 1rem)"`). Both work — a length is
-     * applied inline, anything else is treated as a class.
-     *
-     * It used to be class-only, and a length silently became a dead class name,
-     * so the column fell back to auto layout with nothing to indicate why.
+     * Column width: either a utility class (`"w-[300px]"`) or a CSS length (`"300px"`, `"20%"`,
+     * `"calc(50% - 1rem)"`). Both work — a length is applied inline, anything else is treated as a
+     * class.
      */
     width?: string;
     align?: ColumnAlignProp;
     /**
-     * Alignment of the header cell, when it differs from the body.
-     *
-     * Defaults to `align`, which is the usual case. It exists because a table
-     * can want centred headings over start-aligned text — a long subject reads
-     * from the left while its column heading sits over the column — and `align`
-     * alone cannot say that: setting it to `center` centres the rows too.
-     *
-     * Consumers were reaching for `[&_th_button]:justify-center` to get there,
-     * which is a hand-tuned override of a layout the table owns.
+     * Alignment of the header cell, when it differs from the body. Defaults to `align`, which is the
+     * usual case.
      */
     headerAlign?: ColumnAlignProp;
     hiddenOnMobile?: boolean;
@@ -54,21 +41,17 @@ export type ColumnDefProp<T> = {
      */
     enableHiding?: boolean;
     /**
-     * Pin the column to the inline-end edge so it stays visible while the rest of
-     * the table scrolls horizontally — the standard home for a row-actions column.
-     * The pinned cell keeps an opaque, hover/selection-aware background and casts a
-     * separating shadow. Pin at most one column per table.
+     * Pin the column to the inline-end edge so it stays visible while the rest of the table scrolls
+     * horizontally — the standard home for a row-actions column. The pinned cell keeps an opaque,
+     * hover/selection-aware background and casts a separating shadow.
      */
     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.
+     * 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.
      */
     priority?: TableColumnPriorityProp;
 };
@@ -95,26 +78,12 @@ 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.
- *
- * `"stacked-record-collection"` (gh#293 restore — SCR-215) is the canonical wide-record collection:
- * a table whose column count/content cannot be squeezed into any fixed-measure narrow frame at all
- * (an admin detail row with many heterogeneous fields). Below `collapseBelow` the header row hides
- * and every `<tr>` becomes a bordered key-value CARD stack — each `TableCell`'s own `label` prop
- * renders inline above its value, taking over the accessible-name role the (now hidden) `<th>`
- * association would otherwise carry. Above the step it is a byte-for-byte ordinary table.
- */
+/** Table named collection preset. `"default"` keeps the plain table (and emits no attribute). */
 export type TablePresetProp = "default" | "action-collection" | "stacked-record-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).
+ * is reserved first so it can never be pushed outside the viewport.
  */
 export type TableColumnPriorityProp = "primary" | "secondary" | "meta" | "actions";

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

@@ -1,5 +1,5 @@
 /** 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 { ClassNameProp, ChildrenProp, IdProp, OpenProp, DefaultOpenProp, OnOpenChangeProp, HandlerProp, PendingProp, RequiredProp, DisabledProp, LabelProp, HelperProp, ErrorProp, ErrorBagProp, PlaceholderProp, NameProp, ValueProp, DefaultValueProp, OnValueChangeProp, OnChangeProp, OnClickProp, AsChildProp, WidthProp, ControlWidthProp, } 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, 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";

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

@@ -4,8 +4,10 @@
  */
 /** Button visual style. */
 export type ButtonVariantProp = "default" | "destructive" | "outline" | "dashed" | "secondary" | "ghost" | "link";
-/** Corner shape — maps to the radius tokens (default = control/component radius). Shared by
- *  Button + Badge. `pill` = fully rounded (`--radius-pill`), `sharp` = square (`--radius-sharp`). */
+/**
+ * Corner shape — maps to the radius tokens (default = control/component radius). Shared by Button
+ * + Badge.
+ */
 export type ShapeProp = "default" | "pill" | "sharp";
 /**
  * Avatar geometry — WHAT the mark represents, not just its corner radius, which is why it is a
@@ -22,7 +24,7 @@ export type TextSizeProp = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 export type TextToneProp = "default" | "muted" | "primary" | "success" | "warning" | "destructive" | "info";
 /** Font weight — the reference-design canon is THREE weights only: `regular` (400 body), `medium` (500
  *  heading/label), `bold` (700 emphasis). 600/`semibold` is forbidden. */
-export type FontWeightProp = "regular" | "medium" | "bold";
+export type FontWeightProp = "regular" | "medium" | "semibold" | "bold";
 /** Heading level — drives both the `--heading-h*` size token and the semantic `<h1..h4>` element. */
 export type HeadingLevelProp = 1 | 2 | 3 | 4;
 /** Inline text alignment (logical, RTL-safe). */
@@ -71,9 +73,9 @@ export type SortStateProp = {
     direction: SortDirectionProp;
 };
 /**
- * Entrance-stagger ordinal for `Reveal` — an INDEX into the motion ladder, never a raw ms.
- * `0` = enter immediately; `1..6` each add one `--reveal-stagger-step` of delay so a column of
- * revealed rows cascades in. Reduced-motion collapses every step to 0 (content stays visible).
+ * Entrance-stagger ordinal for `Reveal` — an INDEX into the motion ladder, never a raw ms. `0` =
+ * enter immediately; `1..6` each add one `--reveal-stagger-step` of delay so a column of revealed
+ * rows cascades in.
  */
 export type RevealDelayProp = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 /**
@@ -83,11 +85,7 @@ export type RevealDelayProp = 0 | 1 | 2 | 3 | 4 | 5 | 6;
  */
 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.
+ * Whether an ambient indicator announces its label to assistive technology. Default `false` —
+ * DELIBERATELY.
  */
 export type ActivityAnnounceProp = false | "polite";

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

@@ -19,30 +19,17 @@ export type CenteredShellWidthProp = "sm" | "md" | "lg";
 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.
+ * `"application"` (403 / 404): the failure happened INSIDE the authenticated app, so the surface
+ * is the page BODY of the `AppShell` the route already renders.
  */
 export type ErrorSurfaceModeProp = "application" | "system";
 /**
  * The HTTP status an ErrorSurface presents. Deliberately closed to the five exception pages every
- * app ships (RFC 9110 §15.5.1 / §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.
- *
- * `400` (gh#301) is the malformed-request page: a route reached with parameters the server refuses
- * to interpret (a bad id, a missing launch parameter, a hand-edited query string). It is an
- * `application` failure like 403/404 — the app itself is healthy, so the shell stays and the
- * viewer navigates away from it.
+ * app ships (RFC 9110 §15.5.1 / §15.5.4 / §15.5.5 / §15.6.1 / §15.6.4); it drives the default
+ * icon, tone and the recommended `mode`.
  */
-export type ErrorSurfaceStatusProp = 400 | 403 | 404 | 500 | 503;
+/** Five curated statuses carry their own glyph and tone; any other HTTP status renders with a class-based fallback (4xx warning, 5xx destructive). */
+export type ErrorSurfaceStatusProp = 400 | 403 | 404 | 500 | 503 | (number & {});
 /**
  * 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.
@@ -54,7 +41,6 @@ export type ErrorSurfaceStatusProp = 400 | 403 | 404 | 500 | 503;
  * `"registration"` is the 360px sign-up measure — start-aligned like `"login"`, because a
  * registration card is the tallest surface in the set and a centred tall card overflows above the
  * scroll origin, and the only preset with a footer-clearance knob of its own.
- * Orthogonal to AuthShell's `variant` (which owns control density and heading size) — combine them.
  */
 export type AuthShellPresetProp = "default" | "login" | "registration" | "device-authorization" | "context-selection" | "account-recovery";
 /** Shared gap between layout children; components may document subsets. */
@@ -64,18 +50,10 @@ 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";
 /**
- * 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.
+ * `"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.
  */
 export type OrientationProp = "horizontal" | "vertical";

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

@@ -52,7 +52,8 @@ export type OnClickProp = React.MouseEventHandler<HTMLButtonElement>;
 export type AsChildProp = boolean;
 /**
  * An explicit layout dimension (NOT the `SizeProp` control-height tier). A `number` is treated as
- * px; a `string` is any CSS length (`"32rem"`, `"90vw"`, `"50%"`). Used for Sheet `width`, Form
- * `labelWidth`/`controlWidth` — values that are freeform lengths, not the xs|sm|md|lg tier.
+ * px; a `string` is any CSS length (`"32rem"`, `"90vw"`, `"50%"`).
  */
 export type WidthProp = number | string;
+/** How a control sizes on the inline axis: fill its column, or hug its label. */
+export type ControlWidthProp = "full" | "auto";

package/dist/styles/alert-layout.css

@@ -1,6 +1,4 @@
-/*
- * ALERT — inset, gaps, dismiss offset; colors via data-tone + semantic tokens.
- */
+
 
 @layer components {
   [data-slot="alert"] {
@@ -47,11 +45,6 @@
     color: hsl(var(--foreground));
   }
 
-  /* variant="banner" (the <Banner> export) — the full-bleed page/shell attention strip.
-   * ONLY geometry changes here: every tone colour rule above applies unchanged, and the
-   * strip keeps its tone-coloured hairline on the block-end edge alone. All values are
-   * --banner-* component tokens (src/tokens/components/banner.css), so a consumer never
-   * writes CSS to place a banner and a service retunes the strip once via theme. */
   [data-slot="alert"][data-variant="banner"] {
     border-radius: var(--banner-radius);
     border-block-start-width: 0;
@@ -65,7 +58,6 @@
     padding-inline-end: calc(var(--alert-space-inset) + var(--space-8));
   }
 
-  /* The banner strip reserves dismiss clearance from ITS inline inset, not the card's. */
   [data-slot="alert"][data-variant="banner"][data-dismissible] {
     padding-inline-end: calc(var(--banner-space-inset-inline) + var(--space-8));
   }
@@ -99,11 +91,6 @@
     color: hsl(var(--info));
   }
 
-  /* Body stacks text vertically (title over description). The ≥sm two-column
-   * layout exists ONLY to push an actions slot to the end — gate it on
-   * :has(alert-actions), otherwise bare AlertTitle + AlertDescription (the
-   * catalog example, AlertQueryError, the docs page) split into meaningless
-   * side-by-side columns (godxjp-ui#106). */
   [data-slot="alert-body"] {
     display: flex;
     flex: 1;
@@ -138,8 +125,6 @@
     line-height: 1;
   }
 
-  /* Title text reads the AA-strong status colour (darker than the fill) so the coloured heading
-   * clears WCAG AA on the soft alert tint; the icon keeps the brighter role colour. */
   [data-slot="alert-title"][data-tone="destructive"] {
     color: hsl(var(--text-error));
   }
@@ -178,10 +163,6 @@
     }
   }
 
-  /* 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);
@@ -200,17 +181,11 @@
     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);
@@ -243,9 +218,6 @@
     border-radius: var(--skeleton-radius);
   }
 
-  /* Drop the self-frame inside a flush CardContent so the Card supplies the single
-   * border — mirrors `.ui-data-table-surface` so the skeleton placeholder and the
-   * real DataTable it swaps for sit identically (no nested double border). */
   [data-slot="card-content"][data-flush] .ui-skeleton-table {
     border-width: 0;
     border-radius: 0;
@@ -278,7 +250,6 @@
     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);
     }
@@ -296,8 +267,6 @@
       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%;