@godxjp/ui 21.0.0 → 23.0.0

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

@@ -1,10 +1,10 @@
 export type { AppLauncherApp, AppLauncherGroup, AppLauncherLabels, AppLauncherProp, AppShellProp, AuthFooterProp, AuthIdentityProp, OrgSwitcherLabels, OrgSwitcherOrganization, OrgSwitcherProp, PageContainerProp, PageInsetProp, SidebarItemProp, SidebarProductProp, SidebarProp, SidebarSectionProp, TopbarProp, } from "./layout.prop.js";
 export type { ButtonProp } from "./general.prop.js";
-export type { InputProp, TextareaProp, FormFieldProp, SearchInputProp, CheckboxProp, CheckboxGroupProp, ChoiceOptionProp, RadioProp, RadioGroupProp, SwitchProp, SliderProp, CalendarProp, DatePickerProp, DateRangePickerProp, TimePickerProp, ColorPickerProp, UploadProp, UploadFileItemProp, UploadVariantProp, TreeOptionProp, TreeFieldNamesProp, CascaderProp, TreeSelectProp, ShowCheckedStrategyProp, TransferProp, TransferItemProp, } from "./data-entry.prop.js";
+export type { InputProp, TextareaProp, FormFieldProp, SearchInputProp, CheckboxProp, CheckboxGroupProp, ChoiceOptionProp, RadioProp, RadioGroupProp, SwitchProp, SliderProp, CalendarProp, DatePickerProp, TimePickerProp, ColorPickerProp, UploadProp, UploadFileItemProp, UploadVariantProp, TreeOptionProp, TreeFieldNamesProp, CascaderProp, TreeSelectProp, ShowCheckedStrategyProp, TransferProp, TransferItemProp, } from "./data-entry.prop.js";
 export type { AvatarProp, EmptyStateProp, DescriptionsProp, DescriptionsItemProp, BadgeProp, DataTableProp, QrCodeProp, } from "./data-display.prop.js";
 export type { ChartDatum, ChartSeriesProp, LineChartProp, BarChartProp, AreaChartProp, PieChartProp, } from "./charts.prop.js";
 export type { AlertQueryErrorProp, AlertProp, AlertTitleProp, AlertContentProp, AlertDescriptionProp, AlertActionsProp, SheetResponsiveProp, SkeletonRowsProp, } from "./feedback.prop.js";
 export type { DataStateProp, InfiniteQueryStateProp, InfiniteQueryHelpers, PrefetchLinkProp, } from "./query.prop.js";
-export type { DropdownMenuPlacementProp, PaginationProp, PaginationSizeProp, PaginationAlignProp, StepsProp, StepItemProp, StepStatusProp, StepsTypeProp, TabsProp, TabItemProp, TabsVariantProp, TabsPlacementProp, TabsExtraProp, TabsOnEditProp, } from "./navigation.prop.js";
+export type { DropdownMenuPlacementProp, DropdownMenuTriggerActionProp, PaginationProp, PaginationSizeProp, PaginationAlignProp, StepsProp, StepItemProp, StepStatusProp, StepsTypeProp, TabsProp, TabItemProp, TabsVariantProp, TabsPlacementProp, TabsExtraProp, TabsOnEditProp, } from "./navigation.prop.js";
 export type { AppProviderProp, AppContextValue, AppSettingKind, AppSettingPickerProp, AppSettingToggleKind, AppSettingToggleProp, } from "./app.prop.js";
 export type { ZodSchemaProp, UseZodFormOptionsProp, UseZodFormReturnProp, FormRootProp, FormFieldControlProp, FieldErrorMessageProp, } from "./form.prop.js";

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

@@ -1,7 +1,7 @@
 /** Layout component prop types — @see docs/COMPONENTS.md#layout */
 import type * as React from "react";
 import type { ComponentType, ReactNode, SVGProps } from "react";
-import type { BreadcrumbProp, TitleProp, SubtitleProp, StatusProp, ExtraProp, FooterProp, PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, MobileShellHeightProp, OrientationProp, TextAlignProp, TextToneProp, BreakpointProp, GapProp, PadProp, PadRawProp, ClassNameProp, ChildrenProp, IdProp, DisabledProp, DescriptionProp, ActionProp, IconProp, HeadingLevelProp, ToneProp, WidthProp } from "../vocabulary/index.js";
+import type { BreadcrumbProp, TitleProp, SubtitleProp, StatusProp, ExtraProp, FooterProp, PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, MobileShellHeightProp, MobileShellWidthProp, OrientationProp, TextAlignProp, TextToneProp, BreakpointProp, GapProp, PadProp, PadRawProp, ClassNameProp, ChildrenProp, IdProp, DisabledProp, DescriptionProp, ActionProp, IconProp, HeadingLevelProp, ToneProp, WidthProp } from "../vocabulary/index.js";
 import type { EmptyStateToneProp } from "./data-display.prop.js";
 /**
  * Arrangement of the page header's title band and its `extra` slot below the 640px step.
@@ -505,6 +505,17 @@ export type MobileShellProp = {
      * device-frame preview, a phone view embedded in a wider page).
      */
     height?: MobileShellHeightProp;
+    /**
+     * How wide the shell is allowed to get. `"fill"` (default) takes the whole inline size it is
+     * given — a real handheld, where that IS the phone. `"phone"` caps it at
+     * `--mobile-shell-max-inline-size` and centres the column, for the case `height="fill"` already
+     * names on the other axis: a handheld screen rendered on a viewport wider than a handheld.
+     *
+     * Measured at a 1280px viewport before this axis existed: `max-inline-size: none`, shell 1232px
+     * wide, a four-destination tab bar spread across the whole screen. `height` had two named values
+     * for exactly these two contexts and `width` had none — the asymmetry was the bug.
+     */
+    width?: MobileShellWidthProp;
     className?: ClassNameProp;
 };
 /**

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

@@ -172,6 +172,23 @@ export type PaginationAlignProp = "start" | "center" | "end";
  * inline-side ones (antd `left*` / `right*`) stay on Radix's own physical `side`.
  */
 export type DropdownMenuPlacementProp = "top" | "topStart" | "topEnd" | "bottom" | "bottomStart" | "bottomEnd";
+/**
+ * @see DropdownMenu — Ant Design `trigger`: the gestures that open the menu, as an array because
+ * more than one may be live at once (`['click', 'contextMenu']` is a row that opens from its kebab
+ * AND from a right click anywhere on it).
+ *
+ * Default `['click']`, NOT antd's `['hover']`: a menu button that opens on hover is a pointer-only
+ * affordance by default, and every consumer of this library today opens on click.
+ *
+ * `contextMenu` opens at the pointer and suppresses the browser's own menu. It is what replaced the
+ * deleted `ContextMenu` component (v23) — antd has no such component either, and expresses the
+ * whole idea as this value.
+ *
+ * Whatever the array says, the KEYBOARD opener stays wired: Enter / Space / ArrowDown on the
+ * trigger for `click` and `hover`, and Shift+F10 / the ContextMenu key for `contextMenu`. A gesture
+ * list can therefore never produce a menu that only a mouse can reach (WCAG 2.1.1).
+ */
+export type DropdownMenuTriggerActionProp = "click" | "hover" | "contextMenu";
 export type StepStatusProp = "wait" | "process" | "finish" | "error";
 /** @see StepItem */
 export type StepItemProp = {
@@ -190,7 +207,19 @@ export type StepItemProp = {
  */
 export type StepsTypeProp = "default" | "dot" | "inline" | "navigation";
 /** @see Steps */
-export type StepsProp = {
+/**
+ * The rest of a native `<ol>`'s attributes ride through to the list element.
+ *
+ * Not a convenience: without them a consumer had no supported handle on the rendered list at all,
+ * so its browser test bound to `.ui-steps-list > li[data-status]` — an INTERNAL class and an
+ * internal data attribute, both of which this package is free to rename. A `data-testid` or an
+ * `id` on the component is what that test wanted, and every sibling primitive already forwards
+ * them.
+ *
+ * `aria-label` is the one exception: the list names itself from the locale, and a caller-supplied
+ * name wins — the same contract Progress and Toolbar follow.
+ */
+export type StepsProp = Omit<React.OlHTMLAttributes<HTMLOListElement>, "onChange" | "defaultValue" | "children" | "type"> & {
     items?: StepItemProp[];
     value?: number;
     defaultValue?: number;
@@ -235,6 +264,17 @@ export type TabItemProp = {
     closable?: boolean;
     /** Ant Design `Tab.closeIcon` — replaces the default × on this item's remove button. */
     closeIcon?: React.ReactNode;
+    /**
+     * Ant Design `Tab.forceRender`. Mounts THIS panel up front and keeps it mounted while another
+     * tab is selected, without turning that on for the whole strip the way `destroyOnHidden={false}`
+     * does — so the one panel holding a live chart, a scroll position or an unsent draft survives a
+     * tab switch while the rest are still destroyed.
+     *
+     * antd 5.25 also grew a per-item `destroyOnHidden`. It is NOT offered here: on this component
+     * "kept mounted" is a single state, so an item-level `destroyOnHidden: false` would be a second
+     * prop spelling exactly what `forceRender: true` already says (cardinal rule #32).
+     */
+    forceRender?: boolean;
 };
 /**
  * @see Tabs — trigger-strip appearance. This is Ant Design's `type` spelled in the library's own
@@ -264,6 +304,32 @@ export type TabsExtraProp = React.ReactNode | {
  * commas, and an inline `(target, action) => void` leaks its second PARAMETER as a phantom prop.
  */
 export type TabsOnEditProp = (target: string | React.MouseEvent<HTMLButtonElement>, action: "add" | "remove") => void;
+/**
+ * @see Tabs — what the trigger strip does when there are more tabs than fit its container.
+ *
+ * This is Ant Design's `more`, mapped onto the `overflow` vocabulary this package already uses
+ * for the same question (`FilterBarOverflowProp` on Toolbar) rather than re-spelled: antd names
+ * the AFFORDANCE it happens to draw, this library names the BEHAVIOUR and owns the affordance.
+ *
+ * `scroll` (the default, and what every strip does today) keeps one bounded row that scrolls its
+ * own inline overflow, with `TabsList` re-pinning the active — or, under manual activation, the
+ * focused — trigger. `menu` keeps all of that AND puts a real button beside the strip listing the
+ * tabs currently outside the scrollport.
+ *
+ * WHERE THIS DELIBERATELY DIVERGES FROM ANTD, and why: antd REMOVES the overflowing tabs from the
+ * bar and re-homes them in the dropdown. The WAI-ARIA APG tab pattern requires the tablist to own
+ * every tab, and a tab hidden with `display: none` cannot take roving focus — so removing them
+ * would make the keyboard route to those tabs disappear along with the pixels. Here the strip
+ * still holds and still scrolls to every tab; the menu is an ADDITIONAL pointer route to the ones
+ * a mouse user cannot currently see. The APG wins; the affordance is kept.
+ */
+export type TabsOverflowProp = "scroll" | "menu";
+/**
+ * @see Tabs — Ant Design `onTabClick`. A NAMED alias rather than an inline signature for the same
+ * reason as `TabsOnEditProp`: the catalog-sync guard splits an object type on top-level commas,
+ * so an inline `(value, event) => void` leaks its second PARAMETER as a phantom prop.
+ */
+export type TabsOnTabClickProp = (value: string, event: React.MouseEvent<HTMLButtonElement>) => void;
 /** @see Tabs — high-level tabs with optional `items` array. */
 export type TabsProp = {
     items?: TabItemProp[];
@@ -292,6 +358,32 @@ export type TabsProp = {
     addIcon?: React.ReactNode;
     /** Ant Design `hideAdd` — keep `editable-card`'s remove buttons but drop the add button. */
     hideAdd?: boolean;
+    /**
+     * Ant Design `removeIcon` — the strip-wide default glyph on `editable-card`'s remove shortcut.
+     * A `TabItemProp.closeIcon` on one item still wins over it, which is antd's own precedence.
+     */
+    closeIcon?: React.ReactNode;
+    /**
+     * Ant Design `more`. Default `scroll` — the behaviour every strip has today, unchanged.
+     * @see TabsOverflowProp for what `menu` adds and where it parts company with antd.
+     *
+     * The default is deliberately NOT `menu`: switching it would change the rendered bar for every
+     * existing consumer at once, and which of the two a dense strip wants is a service decision, not
+     * a library one.
+     */
+    overflow?: TabsOverflowProp;
+    /**
+     * Ant Design `onTabClick`. Fires on EVERY pointer activation of a trigger — including a click on
+     * the tab that is already selected, where `onValueChange` is silent by design. That is the whole
+     * reason it is a separate prop and not a re-spelling of `onValueChange` (cardinal rule #32):
+     * "the user asked for this tab again" (re-fetch, close a drawer, scroll a panel back to the top)
+     * is a different event from "the selection changed".
+     *
+     * Keyboard activation is NOT routed here, and that is the APG winning over antd: under
+     * `activationMode="manual"` the arrow keys move focus without activating, so a key-driven
+     * "click" would be a fiction. Use `onValueChange` for selection, whatever moved it.
+     */
+    onTabClick?: TabsOnTabClickProp;
     className?: ClassNameProp;
     listClassName?: ClassNameProp;
     contentClassName?: ClassNameProp;

package/dist/props/registry.d.ts

@@ -244,6 +244,11 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "layout";
         readonly description: "MobileShell block-size contract — viewport (100dvh root, the real app) | fill (fills a bounded parent, e.g. a device-frame preview)";
     };
+    readonly MobileShellWidthProp: {
+        readonly file: "vocabulary/layout.prop.ts";
+        readonly category: "layout";
+        readonly description: "MobileShell inline-size contract — fill (takes the whole inline size, the default) | phone (caps at the handheld measure and centres, for a handheld screen on a wider viewport)";
+    };
     readonly CenteredShellPresetProp: {
         readonly file: "vocabulary/layout.prop.ts";
         readonly category: "layout";
@@ -841,7 +846,7 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly MobileShellProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
-        readonly vocabulary: readonly ["ChildrenProp", "ClassNameProp", "ActionProp", "MobileShellHeightProp", {
+        readonly vocabulary: readonly ["ChildrenProp", "ClassNameProp", "ActionProp", "MobileShellHeightProp", "MobileShellWidthProp", {
             readonly field: "header";
             readonly local: true;
             readonly reason: "MobileShell app-bar band — the screen title row; it absorbs the top safe-area inset when no statusBar precedes it.";
@@ -1254,6 +1259,16 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-entry.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly SliderMarkProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [];
+    };
+    readonly SliderRangeConfigProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly ControlCountProp: {
         readonly group: "data-entry";
         readonly file: "components/data-entry.prop.ts";
@@ -1304,21 +1319,6 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-entry.prop.ts";
         readonly vocabulary: readonly ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"];
     };
-    readonly MonthPickerProp: {
-        readonly group: "data-entry";
-        readonly file: "components/data-entry.prop.ts";
-        readonly vocabulary: readonly ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"];
-    };
-    readonly MonthRangePickerProp: {
-        readonly group: "data-entry";
-        readonly file: "components/data-entry.prop.ts";
-        readonly vocabulary: readonly ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"];
-    };
-    readonly DateRangePickerProp: {
-        readonly group: "data-entry";
-        readonly file: "components/data-entry.prop.ts";
-        readonly vocabulary: readonly ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"];
-    };
     readonly CalendarCellRenderProp: {
         readonly group: "data-entry";
         readonly file: "components/data-entry.prop.ts";
@@ -1363,6 +1363,54 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly vocabulary: readonly ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "EmptyMessageProp", "DisabledProp", "NameProp", "IdProp", "ClassNameProp", "OpenProp", "OnOpenChangeProp", "SizeProp", "DefaultOpenProp", "ControlStatusProp", "ControlVariantProp", "AllowClearProp", "NotFoundContentProp", "PopupMatchWidthProp", "PendingProp"];
         readonly note: "Internal — the searchable engine behind `<Select options showSearch>` (not public API); use Select.";
     };
+    readonly SelectFieldNamesProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "ValueProp", "DisabledProp"];
+        readonly note: "antd `fieldNames` for `<Select options>` — the spelling Cascader and TreeSelect already take.";
+    };
+    readonly SelectOptionGroupProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "DisabledProp"];
+        readonly note: "antd's nested option GROUP (`{ label, options }`); flattens to the `group` a flat row carries.";
+    };
+    readonly SelectOptionInputProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [];
+        readonly note: "What `<Select options>` accepts: a row, a group, or a foreign row read through `fieldNames`.";
+    };
+    readonly SelectLabeledValueProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["ValueProp", "LabelProp"];
+        readonly note: "antd `labelInValue` — the value carries its own label for a screen with no option list yet.";
+    };
+    readonly SelectPlacementProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [];
+        readonly note: "antd `placement` on the LOGICAL inline axis, as DropdownMenuPlacementProp already spells it.";
+    };
+    readonly SelectShowSearchProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["OnSearchChangeProp"];
+        readonly note: "antd `showSearch`'s object form. `filterOption(input, option)` here takes antd's argument order.";
+    };
+    readonly SelectLabelInValueSingleProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["ValueProp", "DefaultValueProp", "OnValueChangeProp"];
+        readonly note: "Internal — the `labelInValue` single shape of `<Select options>`; use Select.";
+    };
+    readonly SelectLabelInValueMultipleProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["ValueProp", "DefaultValueProp", "OnValueChangeProp", "MaxTagCountProp", "MaxTagPlaceholderProp"];
+        readonly note: "Internal — the `labelInValue` multiple/tags shape of `<Select options>`; use Select.";
+    };
     readonly SelectDataProp: {
         readonly group: "data-entry";
         readonly file: "components/data-entry.prop.ts";
@@ -1932,6 +1980,11 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/navigation.prop.ts";
         readonly vocabulary: readonly [];
     };
+    readonly DropdownMenuTriggerActionProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly PaginationAlignProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
@@ -2012,6 +2065,16 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/navigation.prop.ts";
         readonly vocabulary: readonly ["HandlerProp"];
     };
+    readonly TabsOnTabClickProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["HandlerProp"];
+    };
+    readonly TabsOverflowProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly [];
+    };
     readonly TabItemProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";

package/dist/props/registry.js

@@ -242,6 +242,11 @@ const VOCABULARY_REGISTRY = {
     category: "layout",
     description: "MobileShell block-size contract \u2014 viewport (100dvh root, the real app) | fill (fills a bounded parent, e.g. a device-frame preview)"
   },
+  MobileShellWidthProp: {
+    file: "vocabulary/layout.prop.ts",
+    category: "layout",
+    description: "MobileShell inline-size contract \u2014 fill (takes the whole inline size, the default) | phone (caps at the handheld measure and centres, for a handheld screen on a wider viewport)"
+  },
   CenteredShellPresetProp: {
     file: "vocabulary/layout.prop.ts",
     category: "layout",
@@ -861,6 +866,7 @@ const COMPONENT_PROP_REGISTRY = {
       "ClassNameProp",
       "ActionProp",
       "MobileShellHeightProp",
+      "MobileShellWidthProp",
       {
         field: "header",
         local: true,
@@ -1414,6 +1420,16 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/data-entry.prop.ts",
     vocabulary: []
   },
+  SliderMarkProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: []
+  },
+  SliderRangeConfigProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: []
+  },
   ControlCountProp: {
     group: "data-entry",
     file: "components/data-entry.prop.ts",
@@ -1472,21 +1488,6 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/data-entry.prop.ts",
     vocabulary: ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"]
   },
-  MonthPickerProp: {
-    group: "data-entry",
-    file: "components/data-entry.prop.ts",
-    vocabulary: ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"]
-  },
-  MonthRangePickerProp: {
-    group: "data-entry",
-    file: "components/data-entry.prop.ts",
-    vocabulary: ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"]
-  },
-  DateRangePickerProp: {
-    group: "data-entry",
-    file: "components/data-entry.prop.ts",
-    vocabulary: ["ValueProp", "OnValueChangeProp", "PlaceholderProp", "DisabledProp", "IdProp"]
-  },
   CalendarCellRenderProp: {
     group: "data-entry",
     file: "components/data-entry.prop.ts",
@@ -1573,6 +1574,60 @@ const COMPONENT_PROP_REGISTRY = {
     ],
     note: "Internal \u2014 the searchable engine behind `<Select options showSearch>` (not public API); use Select."
   },
+  SelectFieldNamesProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: ["LabelProp", "ValueProp", "DisabledProp"],
+    note: "antd `fieldNames` for `<Select options>` \u2014 the spelling Cascader and TreeSelect already take."
+  },
+  SelectOptionGroupProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: ["LabelProp", "DisabledProp"],
+    note: "antd's nested option GROUP (`{ label, options }`); flattens to the `group` a flat row carries."
+  },
+  SelectOptionInputProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: [],
+    note: "What `<Select options>` accepts: a row, a group, or a foreign row read through `fieldNames`."
+  },
+  SelectLabeledValueProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: ["ValueProp", "LabelProp"],
+    note: "antd `labelInValue` \u2014 the value carries its own label for a screen with no option list yet."
+  },
+  SelectPlacementProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: [],
+    note: "antd `placement` on the LOGICAL inline axis, as DropdownMenuPlacementProp already spells it."
+  },
+  SelectShowSearchProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: ["OnSearchChangeProp"],
+    note: "antd `showSearch`'s object form. `filterOption(input, option)` here takes antd's argument order."
+  },
+  SelectLabelInValueSingleProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: ["ValueProp", "DefaultValueProp", "OnValueChangeProp"],
+    note: "Internal \u2014 the `labelInValue` single shape of `<Select options>`; use Select."
+  },
+  SelectLabelInValueMultipleProp: {
+    group: "data-entry",
+    file: "components/data-entry.prop.ts",
+    vocabulary: [
+      "ValueProp",
+      "DefaultValueProp",
+      "OnValueChangeProp",
+      "MaxTagCountProp",
+      "MaxTagPlaceholderProp"
+    ],
+    note: "Internal \u2014 the `labelInValue` multiple/tags shape of `<Select options>`; use Select."
+  },
   SelectDataProp: {
     group: "data-entry",
     file: "components/data-entry.prop.ts",
@@ -2233,6 +2288,11 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/navigation.prop.ts",
     vocabulary: []
   },
+  DropdownMenuTriggerActionProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: []
+  },
   PaginationAlignProp: {
     group: "navigation",
     file: "components/navigation.prop.ts",
@@ -2316,6 +2376,16 @@ const COMPONENT_PROP_REGISTRY = {
     file: "components/navigation.prop.ts",
     vocabulary: ["HandlerProp"]
   },
+  TabsOnTabClickProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: ["HandlerProp"]
+  },
+  TabsOverflowProp: {
+    group: "navigation",
+    file: "components/navigation.prop.ts",
+    vocabulary: []
+  },
   TabItemProp: {
     group: "navigation",
     file: "components/navigation.prop.ts",

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

@@ -100,6 +100,18 @@ export type SelectedIdsProp = Set<string>;
 export type OnSelectChangeProp = (next: Set<string>) => void;
 /** Table density change callback. */
 export type OnTableDensityChangeProp = (density: TableDensityProp) => void;
+/**
+ * A row's STATE, drawn as a leading-edge rail plus a wash — the same six tones, with the same
+ * names and the same meanings, that `Card accent` already carries. A row that needs attention and
+ * a card that needs attention should not be two vocabularies.
+ *
+ * It is a state, never a category: colour is not the only signal a row may carry (WCAG 1.4.1), so
+ * the reason still belongs in a cell — a Badge, a status column, an icon with a label. The rail
+ * is what makes that cell findable in a long table, not a replacement for it.
+ */
+export type TableRowToneProp = "primary" | "success" | "warning" | "info" | "attention" | "destructive";
+/** Per-row tone resolver — return `undefined` for a row in the ordinary state. */
+export type RowToneProp<T> = (row: T) => TableRowToneProp | undefined;
 /** Sort change callback — undefined clears sort. */
 export type OnSortChangeProp = (sort: {
     key: string;

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, FlushProp, WidthProp, ControlWidthProp, AllowClearProp, MaxTagCountProp, MaxTagPlaceholderProp, NotFoundContentProp, PopupMatchWidthProp, } 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, MobileShellHeightProp, OrientationProp, TableDensityProp, DensityProp, GapNameProp, PadProp, PadRawProp, PadSides, GapProp, GapStepProp, } from "./layout.prop.js";
+export type { PageDensityProp, PageContainerVariantProp, CenteredShellWidthProp, CenteredShellAlignProp, CenteredShellPresetProp, ErrorSurfaceModeProp, ErrorSurfaceStatusProp, AuthShellPresetProp, MobileShellHeightProp, MobileShellWidthProp, OrientationProp, TableDensityProp, DensityProp, GapNameProp, PadProp, PadRawProp, PadSides, GapProp, GapStepProp, } from "./layout.prop.js";
 export type { ButtonVariantProp, ButtonSizeProp, BadgeVariantProp, AppSettingPickerAppearanceProp, AppSettingToggleAppearanceProp, ShapeProp, AvatarShapeProp, TextSizeProp, TextToneProp, FontWeightProp, HeadingLevelProp, TextAlignProp, TextWhitespaceProp, SizeProp, ControlStatusProp, ControlVariantProp, FormLayoutProp, DescriptionsLayoutProp, BreakpointProp, ConfirmVariantProp, ToneProp, AlertVariantProp, SortDirectionProp, ColumnAlignProp, SortStateProp, RevealDelayProp, ActivityVariantProp, ActivityAnnounceProp, } from "./interaction.prop.js";
 export type { BreadcrumbItemProp, BreadcrumbProp, BreadcrumbItemMenuProp, BreadcrumbItemMenuEntryProp, BreadcrumbSeparatorProp, BreadcrumbItemRenderProp, } from "./navigation.prop.js";
-export type { GetRowIdProp, OnRowClickProp, ColumnDefProp, TablePresetProp, TableColumnPriorityProp, TableCellIndentProp, SelectedIdsProp, OnSelectChangeProp, OnTableDensityChangeProp, OnSortChangeProp, OnSearchChangeProp, OnClearFiltersProp, HasActiveFiltersProp, StickyProp, ColumnFixedProp, ColumnFilterValueProp, ColumnFilterItemProp, ColumnFilterStateProp, OnColumnFilterChangeProp, ColumnCompareProp, ColumnSorterProp, TableSelectionItemProp, TableRowSelectionProp, TableExpandableProp, TableSummaryProp, TableScrollProp, TableStickyProp, OnRowProp, TablePaginationProp, DescriptionsColumnProp, DescriptionsSpanProp, DescriptionsItemsProp, } from "./data.prop.js";
+export type { GetRowIdProp, OnRowClickProp, ColumnDefProp, TablePresetProp, TableColumnPriorityProp, TableCellIndentProp, SelectedIdsProp, OnSelectChangeProp, OnTableDensityChangeProp, TableRowToneProp, RowToneProp, OnSortChangeProp, OnSearchChangeProp, OnClearFiltersProp, HasActiveFiltersProp, StickyProp, ColumnFixedProp, ColumnFilterValueProp, ColumnFilterItemProp, ColumnFilterStateProp, OnColumnFilterChangeProp, ColumnCompareProp, ColumnSorterProp, TableSelectionItemProp, TableRowSelectionProp, TableExpandableProp, TableSummaryProp, TableScrollProp, TableStickyProp, OnRowProp, TablePaginationProp, DescriptionsColumnProp, DescriptionsSpanProp, DescriptionsItemsProp, } from "./data.prop.js";

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

@@ -26,6 +26,17 @@ export type CenteredShellAlignProp = "start" | "center";
  * where a viewport-tall root would overflow its frame. Nothing else differs between the two.
  */
 export type MobileShellHeightProp = "viewport" | "fill";
+/**
+ * MobileShell inline-size contract — the axis `height` had and `width` did not.
+ * `"fill"` (default, and what the shell has always done) takes the whole inline size it is given.
+ * `"phone"` caps it at the handheld measure (`--mobile-shell-max-inline-size`) and centres the
+ * column, for the case the shell's own docstring already names on the block axis: a handheld
+ * screen rendered on a viewport wider than a handheld — a device-frame preview, a desktop browser
+ * opening a mobile route, a phone view embedded in a wider page. Measured at a 1280px viewport
+ * before this existed: the shell drew 1232px wide with `max-inline-size: none`, so a 44px tab bar
+ * spread its four destinations across a metre of screen.
+ */
+export type MobileShellWidthProp = "fill" | "phone";
 /**
  * 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

package/dist/styles/badge-layout.css

@@ -26,6 +26,10 @@
     }
   }
 
+  [data-slot="badge"][data-tabular] {
+    font-variant-numeric: tabular-nums;
+  }
+
   [data-slot="badge"][data-tinted] {
 
     background-color: color-mix(

package/dist/styles/card-layout.css

@@ -44,27 +44,27 @@
   }
 
   [data-slot="card"][data-accent="primary"] {
-    --card-accent-color: hsl(var(--primary));
+    --card-accent-color: hsl(var(--mark-primary));
   }
 
   [data-slot="card"][data-accent="success"] {
-    --card-accent-color: hsl(var(--success));
+    --card-accent-color: hsl(var(--mark-success));
   }
 
   [data-slot="card"][data-accent="warning"] {
-    --card-accent-color: hsl(var(--warning));
+    --card-accent-color: hsl(var(--mark-warning));
   }
 
   [data-slot="card"][data-accent="info"] {
-    --card-accent-color: hsl(var(--info));
+    --card-accent-color: hsl(var(--mark-info));
   }
 
   [data-slot="card"][data-accent="attention"] {
-    --card-accent-color: hsl(var(--attention));
+    --card-accent-color: hsl(var(--mark-attention));
   }
 
   [data-slot="card"][data-accent="destructive"] {
-    --card-accent-color: hsl(var(--destructive));
+    --card-accent-color: hsl(var(--mark-destructive));
   }
 
   [data-slot="card"][data-accent] {