@godxjp/ui 19.1.0 → 19.2.0

package/dist/components/data-display/data-table.d.ts

@@ -3,10 +3,9 @@ import { flexRender, type ColumnVisibilityState, type OnChangeFn, type Paginatio
 import type { BreakpointProp, ColumnDefProp, DensityProp, SortStateProp, TablePresetProp } from "../../props/vocabulary/index.js";
 export type Density = DensityProp;
 /**
- * Lean column definition — the simple, common-case column API. `render` shapes
- * a cell; `sortable` opts the column into the sort cycle; `align` / `width` /
- * `pin` / `hiddenOnMobile` / `priority` tune layout; `enableHiding` (default true)
- * lists the column in DataTable.ViewOptions. Adapted to a TanStack column internally.
+ * Lean column definition — the simple, common-case column API. `render` shapes a cell; `sortable`
+ * opts the column into the sort cycle; `align` / `width` / `pin` / `hiddenOnMobile` / `priority`
+ * tune layout; `enableHiding` (default true) lists the column in DataTable.ViewOptions.
  */
 export type ColumnDef<T> = ColumnDefProp<T>;
 interface DataTableProps<T> {
@@ -35,13 +34,8 @@ interface DataTableProps<T> {
     columnVisibility?: ColumnVisibilityState;
     onColumnVisibilityChange?: OnChangeFn<ColumnVisibilityState>;
     /**
-     * Manual (server) flags. Default `false` so the simple `data`+`columns` case
-     * sorts / filters in-browser with no extra wiring. Client pagination slices
-     * rows ONLY when engaged — a numbered `<DataTable.Pagination>` child is
-     * composed, or `pagination`/`onPaginationChange` is supplied; a plain table
-     * with neither renders every row (no silent 10-row cap, gh#270). Set the
-     * relevant flag `true` and drive the matching state from your query for
-     * server-side sort / filter / pagination.
+     * Manual (server) flags. Default `false` so the simple `data`+`columns` case sorts / filters
+     * in-browser with no extra wiring.
      */
     manualSorting?: boolean;
     manualFiltering?: boolean;
@@ -51,16 +45,14 @@ interface DataTableProps<T> {
     /** Custom empty content when `data` is empty; defaults to a built-in EmptyState. */
     empty?: React.ReactNode;
     /**
-     * Failure state (#216). `true` renders the built-in localized error message; any other node
-     * REPLACES it (e.g. an `Alert` carrying an error code + request id). Pass `undefined`/`false`
-     * when the read succeeded. Never pass a raw `Error` object — it is not renderable.
-     * Announced via `role="alert"`; precedence is loading → denied → error → empty → rows.
+     * `true` renders the built-in localized error message; any other node REPLACES it (e.g. an
+     * `Alert` carrying an error code + request id). Pass `undefined`/`false` when the read
+     * succeeded.
      */
     error?: React.ReactNode;
     /**
-     * Permission-denied state (#216) — the read was refused, not failed. `true` renders the
-     * built-in localized "no access" message; any other node replaces it. Distinct from `error`
-     * so a 403 never offers a pointless retry.
+     * `true` renders the built-in localized "no access" message; any other node replaces it.
+     * Distinct from `error` so a 403 never offers a pointless retry.
      */
     denied?: React.ReactNode;
     /** Retry handler for the built-in `error` state; omit to hide the retry action. */
@@ -72,30 +64,16 @@ interface DataTableProps<T> {
     /** Pin the header to the top while the body scrolls. Default true. */
     stickyHeader?: boolean;
     /**
-     * Named collection contract (gh#253) — the SAME preset the `Table` primitive owns, forwarded to
-     * the table DataTable renders, so a TanStack-driven queue gets the identical responsive contract.
      * `"default"` (the default) emits no attribute and matches no selector: an existing DataTable is
-     * byte-identical. `"action-collection"` is the canonical dense approval / action queue: below
-     * `collapseBelow` the desktop intrinsic column widths give way to the token-owned column-PRIORITY
-     * measures (`--table-action-collection-*`) under `table-layout: fixed`, cells wrap, and the
-     * bordered surface drops its `--table-surface-min-inline-size` floor — so requester · target ·
-     * reason · requested date · row actions all stay inside a 390px frame with no horizontal scroll.
-     * Mark each column with `priority` on its `ColumnDef`; DataTable stamps it on the `<th>` AND the
-     * `<td>` for you. The table stays a REAL table: no `display` change, no role rewriting, no card
-     * swap, so header association, `aria-sort` and screen-reader navigation are identical at 1440.
+     * byte-identical. Mark each column with `priority` on its `ColumnDef`; DataTable stamps it on
+     * the `<th>` AND the `<td>` for you.
      */
     preset?: TablePresetProp;
-    /**
-     * Step at which `preset="action-collection"` switches to the compact priority measures, measured
-     * against the TABLE's own container (a container query), not the viewport — a table inside a
-     * master rail collapses before the page does. Default `"sm"`. Ignored while `preset` is
-     * `"default"`.
-     */
+    /** Default `"sm"`. Ignored while `preset` is `"default"`. */
     collapseBelow?: BreakpointProp;
     /**
-     * Per-row className for state-based row tinting (e.g. flag an invalid or
-     * empty record). Returned classes are appended last, so they win over the
-     * built-in hover/selected fills. Return `undefined` to leave a row unstyled.
+     * Per-row className for state-based row tinting (e.g. flag an invalid or empty record). Returned
+     * classes are appended last, so they win over the built-in hover/selected fills.
      */
     rowClassName?: (row: T) => string | undefined;
     className?: string;

package/dist/components/data-display/data-table.js

@@ -212,7 +212,6 @@ function DataTable({
     getRowId,
     manualSorting,
     manualFiltering,
-    // v8 disengaged pagination by withholding the row model; v9 has one static feature set, so
     // "no pager on this table" is expressed the same way as "the server paginates" — leave the
     // rows unsliced. Page count still derives from `rowCount`/the pre-paginated model either way.
     manualPagination: manualPagination || !paginationEngaged,
@@ -610,7 +609,6 @@ DataTable.Content = function DataTableContent() {
                 ))
               ] }, `skeleton-${i}`))
             ) : isDenied ? (
-              // DENIED (#216): the read was REFUSED, not failed — no retry is offered, because
               // repeating a 403 cannot succeed. `warning` (not destructive) keeps it a policy
               // statement rather than a system fault. Announced politely: a permission boundary
               // is expected information, not an interruption.
@@ -633,7 +631,7 @@ DataTable.Content = function DataTableContent() {
                 }
               ) })
             ) : isError ? (
-              // ERROR (#216): a failed read. Announced assertively (`role="alert"`) because the
+              // Announced assertively (`role="alert"`) because the
               // user's request did not complete — unlike empty/denied, which are states of the data
               // itself. The role sits on an inner wrapper, never on the <td>: overriding a cell's
               // role would strip it out of the table's grid semantics for AT.

package/dist/components/data-display/descriptions.d.ts

@@ -6,12 +6,8 @@ export interface DescriptionsProps {
     /** Label placement within each item. Default `vertical` (label over value). */
     layout?: DescriptionsLayoutProp;
     /**
-     * Text alignment of each item's label within its label column — the SAME contract `Form`
-     * exposes (gh#294), so a `Descriptions` composed beside a `Form`/`FormField` (a read-only
-     * name/email block above an editable role field, for example) can be told to match it. Applies
-     * only in `layout="horizontal"` — a vertical label sits above the value and end-aligning it
-     * there would read as a mistake, exactly like `Form`'s own contract. Default `"start"`, matching
-     * this component's historical unconditional start-align — no existing consumer's render changes.
+     * Applies only in `layout="horizontal"` — a vertical label sits above the value and end-aligning
+     * it there would read as a mistake, exactly like `Form`'s own contract.
      */
     labelAlign?: "start" | "end";
     className?: string;

package/dist/components/data-display/descriptions.js

@@ -47,7 +47,6 @@ Descriptions.Item = function DescriptionsItem({
         layout === "horizontal" ? (
           // Label beside value — a token-aligned label column so the values line up. The
           // `--descriptions-label-width` / `--descriptions-label-gap` knobs align labels and set
-          // the label→value gap (rule #44/#45); a service that narrows the column usually wants
           // to close the gap in the same step.
           "grid grid-cols-[var(--descriptions-label-width)_minmax(0,1fr)] items-baseline gap-x-[var(--descriptions-label-gap)]"
         ) : (
@@ -67,7 +66,6 @@ Descriptions.Item = function DescriptionsItem({
             className: cn(
               "text-muted-foreground text-xs",
               // `end`-align only ever applies in horizontal layout — same guard `Form` uses, so a
-              // vertical label (already above its value) never mistakenly end-aligns (gh#294).
               endAlignedLabel && "text-end"
             ),
             children: label

package/dist/components/data-display/index.d.ts

@@ -19,6 +19,10 @@ export type { ColumnDef, Density as TableDensity } from "./data-table.js";
 export type { SortStateProp } from "../../props/vocabulary/index.js";
 export { EmptyState } from "./empty-state.js";
 export { Progress } from "./progress.js";
+export { CodeBlock } from "./code-block.js";
+export type { CodeBlockProp, CodeBlockProps } from "./code-block.js";
+export { Prose } from "./prose.js";
+export type { ProseProp, ProseProps } from "./prose.js";
 export type { ProgressProps, ProgressTone } from "./progress.js";
 export { TreeList } from "./tree-list.js";
 export type { TreeListItem, TreeListProps } from "./tree-list.js";

package/dist/components/data-display/index.js

@@ -25,6 +25,8 @@ import { Descriptions } from "./descriptions.js";
 import { DataTable, flexRender } from "./data-table.js";
 import { EmptyState } from "./empty-state.js";
 import { Progress } from "./progress.js";
+import { CodeBlock } from "./code-block.js";
+import { Prose } from "./prose.js";
 import { TreeList } from "./tree-list.js";
 import { Timeline } from "./timeline.js";
 import {
@@ -74,6 +76,7 @@ export {
   CarouselItem,
   CarouselNext,
   CarouselPrevious,
+  CodeBlock,
   Collapsible,
   CollapsibleContent,
   CollapsibleTrigger,
@@ -94,6 +97,7 @@ export {
   PopoverTitle,
   PopoverTrigger,
   Progress,
+  Prose,
   QrCode,
   ScrollArea,
   ScrollBar,

package/dist/components/data-display/list-row.d.ts

@@ -9,22 +9,8 @@ export type ListRowDensity = ListRowDensityProp;
 /**
  * ListRow — a single-line entity row (indicator · leading · title/description · trailing) for
  * SHORT lists inside a Card: active sessions, API tokens, linked accounts, passkeys, MFA factors,
- * invitations, notifications.
- * Use it INSTEAD of a hand-rolled `<div className="flex items-center justify-between border-b …">`.
- * DataTable is too heavy for a 2–4 item list, and nesting a Card per row would be card-in-card —
- * ListRow is the in-between surface. Drop rows into a `<Card><CardContent flush>…` and they stack
- * with a quiet divider; the trailing slot holds the row's action (Button / DropdownMenu / Switch).
- *
- * Overflow (#224): the content column always shrinks below its intrinsic width
- * (`min-inline-size: min(--list-row-body-min-width, 100%)`) and the trailing actions wrap onto
- * their own line at narrow container widths — a long title plus two Buttons never widens the page
- * root. `overflow` picks how the long content resolves: `truncate` (default, one line + ellipsis)
- * or `wrap` (multi-line, `overflow-wrap: anywhere`).
- *
- * Density (#246): `density="compact"` is the compact inline-actions geometry — tighter block
- * padding/gap and a LOWER body threshold (`--list-row-compact-*`), so an avatar, the title and one
- * or two small trailing Buttons stay on one line inside a ~326px card column at 390px. It only
- * lowers thresholds, so the #224 wrap contract still holds.
+ * invitations, notifications. Use it INSTEAD of a hand-rolled `<div className="flex items-center
+ * justify-between border-b …">`.
  */
 export interface ListRowProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
     /** Render element — `div` (default) or `li` when the parent is a `<ul>`/`<ol>`. */
@@ -44,12 +30,7 @@ export interface ListRowProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
      * with an ellipsis) or `wrap` (multi-line; long unbroken tokens break so the row never widens).
      */
     overflow?: "truncate" | "wrap";
-    /**
-     * Row geometry — `default` (roomy entity row) or `compact` (#246): tighter block padding and
-     * column gap plus a lower body threshold, so a leading Avatar, the title/description and one or
-     * two small trailing Buttons stay INLINE inside a narrow card (≈326px content) at 390px, and a
-     * history Badge + date stays on the title's line. Retune per theme with `--list-row-compact-*`.
-     */
+    /** Retune per theme with `--list-row-compact-*`. */
     density?: ListRowDensity;
     /**
      * Read/unread state — renders the indicator dot (with localized `sr-only` text, never colour

package/dist/components/data-display/permission-matrix.d.ts

@@ -2,25 +2,12 @@ import * as React from "react";
 import type { PermissionMatrixProp } from "../../props/components/data-display.prop.js";
 export type { PermissionMatrixGrantsProp, PermissionMatrixPermissionProp, PermissionMatrixProp, PermissionMatrixProp as PermissionMatrixProps, PermissionMatrixRoleProp, } from "../../props/components/data-display.prop.js";
 /**
- * PermissionMatrix — the canonical role × permission grid (gh#257 / DXS platform#311).
- *
- * Formalizes the `docs/showcase/permission-matrix` composition as a PACKAGE-OWNED export, for the
- * same reason `ErrorSurface` became one (gh#251): a consumer cannot import a docs page, and every
- * RBAC admin was about to re-derive the same sticky-column grid, ✓/— cell semantics and lifecycle
- * states. The matrix stays THIN: all data logic lives in the already-tested
- * `@godxjp/ui/lib/permission-grid` helpers, the table is the real Table family, and the states are
- * the DataTable #216 vocabulary (`loading` → `denied` → `error` → `empty`, same precedence).
- *
- * - **Read-only by default.** Without `onGrantChange` (or with `readOnly`) cells are shape-encoded
- *   ✓/— (icon + `sr-only` text, never colour alone). With `onGrantChange` the cells become real
- *   `Checkbox` controls — except for roles marked `locked`, which keep the read-only cell and a
- *   lock badge.
- * - **Compare mode** (`compare` + `diffOnly`) reuses `lib/permission-grid` verbatim: compared
- *   columns are tinted, differing rows carry a localized 差分 badge.
- * - **Domain-neutral**: roles, permissions and grants all arrive via props; nothing about the
- *   consuming platform is encoded.
- * - **Responsive**: the grid scrolls horizontally inside its own container below its natural
- *   measure (390px shows the sticky permission column + scrollable role columns); 1024/1440 render
- *   the full grid.
+ * With `onGrantChange` the cells become real `Checkbox` controls — except for roles marked
+ * `locked`, which keep the read-only cell and a lock badge. - **Compare mode** (`compare` +
+ * `diffOnly`) reuses `lib/permission-grid` verbatim: compared columns are tinted, differing rows
+ * carry a localized 差分 badge. - **Domain-neutral**: roles, permissions and grants all arrive via
+ * props; nothing about the consuming platform is encoded. - **Responsive**: the grid scrolls
+ * horizontally inside its own container below its natural measure (390px shows the sticky
+ * permission column + scrollable role columns); 1024/1440 render the full grid.
  */
 export declare const PermissionMatrix: React.ForwardRefExoticComponent<PermissionMatrixProp & React.RefAttributes<HTMLDivElement>>;

package/dist/components/data-display/progress.d.ts

@@ -8,7 +8,7 @@ export type ProgressProps = {
      * Allow `value` to exceed 100 and render an OVER-CAPACITY fill: the bar caps at 100% width but
      * gets a diagonal striped overlay + destructive tone, so an over-limit meter (e.g. 252% of a
      * booked weight) is unmistakably different from a full (100%) one. `aria-valuetext` reports the
-     * real ratio. Off by default — `value` clamps to 100 as before.
+     * real ratio.
      */
     over?: boolean;
 };

package/dist/components/data-display/prose.d.ts

@@ -0,0 +1,4 @@
+import * as React from "react";
+import type { ProseProp } from "../../props/components/data-display.prop.js";
+export type { ProseProp, ProseProp as ProseProps };
+export declare const Prose: React.ForwardRefExoticComponent<ProseProp & Omit<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, keyof ProseProp> & React.RefAttributes<HTMLDivElement>>;

package/dist/components/data-display/prose.js

@@ -0,0 +1,20 @@
+import { jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { cn } from "../../lib/utils.js";
+const Prose = React.forwardRef(function Prose2({ size = "md", imageSize = "fit", className, children, ...rest }, ref) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref,
+      "data-slot": "prose",
+      "data-size": size === "md" ? void 0 : size,
+      "data-image-size": imageSize === "fit" ? void 0 : imageSize,
+      className: cn("ui-prose", className),
+      ...rest,
+      children
+    }
+  );
+});
+export {
+  Prose
+};

package/dist/components/data-display/service-launcher-card.d.ts

@@ -14,16 +14,9 @@ export interface ServiceLauncherCardProps extends Omit<React.HTMLAttributes<HTML
     disabledReason?: React.ReactNode;
 }
 /**
- * Token-owned launcher surface for an organization-scoped downstream service.
- *
- * Consumers supply real status, metadata and actions; access is NEVER inferred — the component
- * derives no entitlement, no launch URL and no disabled state of its own. `statusLabel`/
- * `statusTone` are rendered verbatim, and the action's `disabled` state is the consumer's Button
- * prop. The only thing derived from a prop is presentational: supplying `disabledReason` marks
- * the tile `data-unavailable` so the token layer can drop the medallion's brand wash.
- *
- * Layout is NOT owned here: place tiles in `ResponsiveGrid columns={{ sm: 1, md: 2, lg: 3 }}` for
- * the canonical 3 → 2 → 1 launcher grid (the grid queries its own container, never the viewport).
+ * Token-owned launcher surface for an organization-scoped downstream service. Consumers supply
+ * real status, metadata and actions; access is NEVER inferred — the component derives no
+ * entitlement, no launch URL and no disabled state of its own.
  */
 export declare const ServiceLauncherCard: React.ForwardRefExoticComponent<ServiceLauncherCardProps & React.RefAttributes<HTMLDivElement>>;
 export interface ServiceCatalogCtaProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {

package/dist/components/data-display/table.d.ts

@@ -2,100 +2,44 @@ import * as React from "react";
 import type { BreakpointProp, TableColumnPriorityProp, TablePresetProp } from "../../props/vocabulary/index.js";
 export type TableProps = React.HTMLAttributes<HTMLTableElement> & {
     /**
-     * Whether the Table owns its own horizontal-scroll region (default `true`). When `true` a
-     * table wider than its container scrolls inside a keyboard-reachable wrapper (WCAG 2.1.1 / axe
-     * `scrollable-region-focusable`). Set `false` when an ancestor already provides the scroll
-     * region (e.g. `DataTable`, whose `.ui-data-table-scroll` owns the overflow + tab stop) — this
-     * avoids a redundant NESTED scroll container and a duplicate keyboard focus stop for one table.
+     * Whether the Table owns its own horizontal-scroll region (default `true`). When `true` a table
+     * wider than its container scrolls inside a keyboard-reachable wrapper (WCAG 2.1.1 / axe
+     * `scrollable-region-focusable`).
      */
     scrollable?: boolean;
     /**
-     * Draw the full cell grid (gh#274): a 1px outer frame plus vertical rules between columns
-     * (horizontal row rules already come from TableRow). Reach for this whenever the table
-     * carries rowSpan/colSpan merged cells — without column rules the merge relationships are
-     * unreadable. Colour comes from the `--table-border-color` token (default `--border`).
-     * Default `false` emits nothing, keeping the plain table byte-identical.
+     * Reach for this whenever the table carries rowSpan/colSpan merged cells — without column rules
+     * the merge relationships are unreadable. Colour comes from the `--table-border-color` token
+     * (default `--border`).
      */
     bordered?: boolean;
     /**
      * Named collection contract. `"default"` (the default) emits no attribute and keeps the plain
-     * table exactly as it is. `"action-collection"` is the canonical dense approval / action queue
-     * (gh#253): below `collapseBelow`, the desktop intrinsic column widths — the thing that pushes
-     * the last columns outside a 390px viewport — are replaced by the token-owned column PRIORITY
-     * measures (`--table-action-collection-*`) under `table-layout: fixed`, and cells wrap instead
-     * of forcing a horizontal scroll. Mark each column with `priority` on its `TableHead`/`TableCell`.
-     * The table keeps its real semantics: no `display` change, no role rewriting, no card swap, so
-     * header association, `aria-sort` and screen-reader table navigation are identical at every width.
-     *
-     * Column-count ceiling (gh#262): the wrap-instead-of-scroll contract holds up to SIX columns.
-     * From seven, the priority shares cannot fit a phone frame, so below the step each column takes
-     * its rem floor (`--table-action-collection-*-width-floor`, ~5 CJK glyphs per line) and the
-     * table intentionally scrolls inside this wrapper — SC 1.4.10 permits one-dimensional scrolling
-     * of a data table; compressing further would shred CJK headers one character per line.
-     *
-     * `"stacked-record-collection"` (gh#293 restore — SCR-215) is for a wide, heterogeneous record
-     * table that CANNOT be squeezed into any fixed narrow-frame measure — an admin detail row with
-     * many disparate fields, not a dense queue. Below `collapseBelow` the `<thead>` hides and every
-     * `<tr>` becomes a bordered key-value card: each `TableCell`'s own `label` prop (its column's
-     * header text, repeated per cell since `<thead>` is gone) renders inline above the value. Above
-     * the step it renders as a byte-for-byte ordinary table — mark `label` on every `TableCell`.
+     * table exactly as it is.
      */
     preset?: TablePresetProp;
-    /**
-     * Step at which `preset="action-collection"`/`"stacked-record-collection"` switch away from the
-     * ordinary table, measured against the TABLE's own container (not the viewport), so a table
-     * inside a rail collapses before the page does. Defaults to `"sm"` (40rem). Ignored while
-     * `preset` is `"default"`.
-     */
+    /** Defaults to `"sm"` (40rem). Ignored while `preset` is `"default"`. */
     collapseBelow?: BreakpointProp;
 };
 export declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & {
     /**
-     * Whether the Table owns its own horizontal-scroll region (default `true`). When `true` a
-     * table wider than its container scrolls inside a keyboard-reachable wrapper (WCAG 2.1.1 / axe
-     * `scrollable-region-focusable`). Set `false` when an ancestor already provides the scroll
-     * region (e.g. `DataTable`, whose `.ui-data-table-scroll` owns the overflow + tab stop) — this
-     * avoids a redundant NESTED scroll container and a duplicate keyboard focus stop for one table.
+     * Whether the Table owns its own horizontal-scroll region (default `true`). When `true` a table
+     * wider than its container scrolls inside a keyboard-reachable wrapper (WCAG 2.1.1 / axe
+     * `scrollable-region-focusable`).
      */
     scrollable?: boolean;
     /**
-     * Draw the full cell grid (gh#274): a 1px outer frame plus vertical rules between columns
-     * (horizontal row rules already come from TableRow). Reach for this whenever the table
-     * carries rowSpan/colSpan merged cells — without column rules the merge relationships are
-     * unreadable. Colour comes from the `--table-border-color` token (default `--border`).
-     * Default `false` emits nothing, keeping the plain table byte-identical.
+     * Reach for this whenever the table carries rowSpan/colSpan merged cells — without column rules
+     * the merge relationships are unreadable. Colour comes from the `--table-border-color` token
+     * (default `--border`).
      */
     bordered?: boolean;
     /**
      * Named collection contract. `"default"` (the default) emits no attribute and keeps the plain
-     * table exactly as it is. `"action-collection"` is the canonical dense approval / action queue
-     * (gh#253): below `collapseBelow`, the desktop intrinsic column widths — the thing that pushes
-     * the last columns outside a 390px viewport — are replaced by the token-owned column PRIORITY
-     * measures (`--table-action-collection-*`) under `table-layout: fixed`, and cells wrap instead
-     * of forcing a horizontal scroll. Mark each column with `priority` on its `TableHead`/`TableCell`.
-     * The table keeps its real semantics: no `display` change, no role rewriting, no card swap, so
-     * header association, `aria-sort` and screen-reader table navigation are identical at every width.
-     *
-     * Column-count ceiling (gh#262): the wrap-instead-of-scroll contract holds up to SIX columns.
-     * From seven, the priority shares cannot fit a phone frame, so below the step each column takes
-     * its rem floor (`--table-action-collection-*-width-floor`, ~5 CJK glyphs per line) and the
-     * table intentionally scrolls inside this wrapper — SC 1.4.10 permits one-dimensional scrolling
-     * of a data table; compressing further would shred CJK headers one character per line.
-     *
-     * `"stacked-record-collection"` (gh#293 restore — SCR-215) is for a wide, heterogeneous record
-     * table that CANNOT be squeezed into any fixed narrow-frame measure — an admin detail row with
-     * many disparate fields, not a dense queue. Below `collapseBelow` the `<thead>` hides and every
-     * `<tr>` becomes a bordered key-value card: each `TableCell`'s own `label` prop (its column's
-     * header text, repeated per cell since `<thead>` is gone) renders inline above the value. Above
-     * the step it renders as a byte-for-byte ordinary table — mark `label` on every `TableCell`.
+     * table exactly as it is.
      */
     preset?: TablePresetProp;
-    /**
-     * Step at which `preset="action-collection"`/`"stacked-record-collection"` switch away from the
-     * ordinary table, measured against the TABLE's own container (not the viewport), so a table
-     * inside a rail collapses before the page does. Defaults to `"sm"` (40rem). Ignored while
-     * `preset` is `"default"`.
-     */
+    /** Defaults to `"sm"` (40rem). Ignored while `preset` is `"default"`. */
     collapseBelow?: BreakpointProp;
 } & React.RefAttributes<HTMLTableElement>>;
 export declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
@@ -104,19 +48,15 @@ export declare const TableRow: React.ForwardRefExoticComponent<React.HTMLAttribu
 /**
  * Column priority carried by BOTH the header cell and the body cells of a column. Read only by
  * `Table preset="action-collection"` below its collapse step, where it selects the column's
- * token-owned measure; unset columns take the remaining space. Emitted as `data-priority` only
- * when supplied, so an ordinary table gains no attribute.
+ * token-owned measure; unset columns take the remaining space.
  */
 type TableCellPriority = {
     priority?: TableColumnPriorityProp;
 };
 /**
- * A `TableCell`'s own column label, read only by `Table preset="stacked-record-collection"`
- * below its collapse step — where the real `<thead>` hides and this renders inline above the
- * cell's value inside the stacked card, standing in for the header association that is no longer
- * visually present. Rendered into the DOM unconditionally (so it exists for the preset's CSS to
- * reveal) but visually hidden above the collapse step, where the real `<th>` already carries the
- * label — an ordinary table with no `label` prop supplied gains no extra markup.
+ * Rendered into the DOM unconditionally (so it exists for the preset's CSS to reveal) but visually
+ * hidden above the collapse step, where the real `<th>` already carries the label — an ordinary
+ * table with no `label` prop supplied gains no extra markup.
  */
 type TableCellLabel = {
     label?: React.ReactNode;

package/dist/components/data-display/table.js

@@ -16,7 +16,6 @@ const Table = React.forwardRef(
     // scrollable-region-focusable). No landmark role — avoids landmark-unique collisions.
     // When `scrollable` is false an ancestor owns the scroll region, so this is a bare
     // positioning box (no `overflow`, no tab stop) to avoid a redundant nested scroller.
-    // The preset adds ONE class (the container the collapse step is measured against) and the
     // step attribute; with `preset="default"` neither is emitted, so the box is byte-identical.
     /* @__PURE__ */ jsx(
       "div",
@@ -49,7 +48,6 @@ const TableBody = React.forwardRef(({ className, ...props }, ref) => (
   // "The last row draws no rule" is an idiom, not a service-tunable constant, so it is a CSS
   // rule (`[data-slot="table-body"] .ui-table-row:last-child`) rather than a utility. That only
   // works because TableRow's own bottom rule moved to `.ui-table-row` in the same layer: while
-  // the row carried a `border-b` UTILITY, no `components` rule could ever zero it (gh#412).
   /* @__PURE__ */ jsx("tbody", { ref, "data-slot": "table-body", className: cn(className), ...props })
 ));
 TableBody.displayName = "TableBody";
@@ -60,7 +58,6 @@ const TableRow = React.forwardRef(({ className, ...props }, ref) => /* @__PURE__
     className: cn(
       // The row rule itself is `.ui-table-row` in table-layout.css (--table-row-border-width),
       // NOT a `border-b` utility — a utility sits in `@layer utilities` and would outrank the
-      // `components` rule that has to zero it on the last row (gh#319).
       "ui-table-row hover:bg-accent/70 data-[state=selected]:bg-primary/[0.06] transition-colors",
       className
     ),

package/dist/components/data-display/timeline.d.ts

@@ -9,7 +9,7 @@ export type TimelineItem = {
     note?: ReactNode;
     /** Shorthand for `status: "current"`. `status` wins when both are set. */
     current?: boolean;
-    /** Explicit 3-state. Resolves as `status ?? (current ? "current" : <legacy>)`. */
+    /** Explicit 3-state. Resolves as `status ?? */
     status?: TimelineStatus;
     /** Per-item glyph override; wins over the variant/status auto-glyph. */
     icon?: LucideIcon;
@@ -17,10 +17,8 @@ export type TimelineItem = {
 export type TimelineProps = {
     items: TimelineItem[];
     /**
-     * Rail glyph strategy. `icon` (default) keeps the legacy look (Plane for the
-     * current step, CheckCircle2 otherwise). `ordinal` numbers every step
-     * (1,2,3…) and lets status drive colour only. `status` picks the glyph by
-     * status: done → check, current → filled dot, pending → the step number.
+     * Rail glyph strategy. `icon` (default) keeps the legacy look (Plane for the current step,
+     * CheckCircle2 otherwise).
      */
     variant?: TimelineVariant;
 };

package/dist/components/data-entry/branch-scope-picker.d.ts

@@ -2,25 +2,8 @@ import * as React from "react";
 import type { BranchScopeValueProp } from "../../props/components/data-entry.prop.js";
 export type { BranchScopeModeProp, BranchScopeOptionProp, BranchScopePickerProp, BranchScopePickerProp as BranchScopePickerProps, BranchScopeValueProp, } from "../../props/components/data-entry.prop.js";
 /**
- * BranchScopePicker — the canonical "all branches vs an explicit subset" scope control
- * (gh#257 / DXS platform#311).
- *
- * A THIN formalized composition (the gh#251 lesson: a consumer cannot import a docs page): the
- * mode switch is the real `RadioGroup`, the subset is the real `CheckboxGroup`, search is the real
- * `SearchInput` — so keyboard behaviour (roving radios, Space on checkboxes) and the field-a11y
- * contract (`aria-labelledby`/`aria-errormessage` via `FormField`) come from the primitives, not
- * from new machinery. Domain data (the branches) is 100% consumer-supplied.
- *
- * - **Value** is a single controlled/uncontrolled object `{ mode, branchIds }`, so a form treats
- *   scope as ONE field. Switching back to `all` PRESERVES `branchIds` — an accidental mode flip
- *   must not destroy a curated subset.
- * - **Validation** (`error`) renders the message and wires `aria-invalid`/`aria-errormessage` onto
- *   the radiogroup widget; collection READ failures are `listError`/`denied`, mirroring the
- *   DataTable #216 vocabulary (precedence `loading` → `denied` → `listError` → `empty`).
- * - **`readOnly`** renders the current scope as a static summary (mode + branch badges) with no
- *   editable affordance; `disabled` keeps the controls visible but inert.
- * - **Responsive**: a single-column stack; the branch list scrolls inside its own bounded box, so
- *   the control keeps one measure at 1440/1024/390.
+ * Domain data (the branches) is 100% consumer-supplied. - **Value** is a single
+ * controlled/uncontrolled object `{ mode, branchIds }`, so a form treats scope as ONE field.
  */
 export declare const BranchScopePicker: React.ForwardRefExoticComponent<import("../../lib/field-a11y.js").FieldA11yProps & {
     branches: readonly import("./branch-scope-picker.js").BranchScopeOptionProp[];

package/dist/components/data-entry/branch-scope-picker.js

@@ -162,7 +162,6 @@ const BranchScopePicker = React.forwardRef(
             // `disabled`) — WCAG 2.1.1 / axe `scrollable-region-focusable`; same contract as
             // MasterDetail's bounded master region. It is an ordinary tab stop (no trap), and
             // it carries the group's accessible name so the stop is announced meaningfully —
-            // the inner CheckboxGroup deliberately no longer duplicates that label.
             /* @__PURE__ */ jsx(
               "div",
               {

package/dist/components/data-entry/calendar.d.ts

@@ -1,3 +1,4 @@
+import * as React from "react";
 import type { CalendarProp } from "../../props/components/data-entry.prop.js";
-export type { CalendarProp, CalendarProp as CalendarProps, } from "../../props/components/data-entry.prop.js";
-export declare function Calendar({ className, classNames, showOutsideDays, "aria-label": ariaLabel, labels, ...props }: CalendarProp): import("react").JSX.Element;
+export type { CalendarProp, CalendarProp as CalendarProps, CalendarFooterProp, } from "../../props/components/data-entry.prop.js";
+export declare function Calendar({ className, classNames, showOutsideDays, "aria-label": ariaLabel, labels, showToday, showClose, onClose, footer, month: monthProp, onMonthChange, ...props }: CalendarProp): React.JSX.Element;