@godxjp/ui 18.8.0 → 18.10.0

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

@@ -1,6 +1,7 @@
 /** Navigation component prop types — @see docs/COMPONENTS.md#navigation */
 import type * as React from "react";
-import type { ChildrenProp, ClassNameProp, DisabledProp, HasActiveFiltersProp, IdProp, LabelProp, OnClearFiltersProp, StickyProp } from "../vocabulary/index.js";
+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
@@ -8,61 +9,60 @@ import type { ChildrenProp, ClassNameProp, DisabledProp, HasActiveFiltersProp, I
  */
 export type FilterBarOverflowProp = "wrap" | "scroll";
 /**
- * One APPLIED filter, rendered as a removable chip under the control row (#258).
- *
- * The chip is the visible record of a filter that is already in effect — it is NOT the control that
- * sets it. `label` is caller-localized text (the bar never interprets or formats domain values);
- * omit `onRemove` for a chip the user may not lift (a scope locked by the route or by permission),
- * and the chip renders as a static token with no dead button.
+ * 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.
+ */
+export type FilterBarSearchProp = {
+    value?: string;
+    defaultValue?: string;
+    /** Fires on EVERY keystroke — required to keep a controlled `value` responsive. */
+    onValueChange?: (query: string) => void;
+    /** Fires with the DEBOUNCED term. Omit it when filtering is driven off `onValueChange`. */
+    onSearch?: (query: string) => void;
+    placeholder?: string;
+    /** Visible label above the search field. Omit for the placeholder-only compact form. */
+    label?: React.ReactNode;
+    /** Accessible name when no visible `label` is given (defaults to the localized "Search"). */
+    ariaLabel?: string;
+    id?: IdProp;
+    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.
+ */
+export type FilterBarFilterProp = {
+    /** Stable filter identity (drives the control id + React key). */
+    value: string;
+    label: LabelProp;
+    options: SearchSelectOptionProp[];
+    selected?: string;
+    defaultSelected?: string;
+    onSelectedChange?: (selected: string) => void;
+    placeholder?: PlaceholderProp;
+    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.
  */
 export type FilterBarChipProp = {
-    /** Stable identity — also the argument passed back to {@link ToolbarProp.onChipRemove}. */
-    id: string;
-    /** Already-localized chip text, e.g. "状態: 未払い". */
-    label: string;
-    /**
-     * Per-chip removal. Omit for a chip the user cannot lift; the bar then renders no remove control
-     * rather than a disabled one, so nothing focusable is dead.
-     */
-    onRemove?: () => void;
+    /** Stable chip identity, passed to `onChipRemove`. */
+    value: string;
+    label: React.ReactNode;
+    disabled?: DisabledProp;
 };
 /** @see Toolbar */
 export type ToolbarProp = {
     onClear?: OnClearFiltersProp;
     hasActiveFilters?: HasActiveFiltersProp;
-    /**
-     * The search control (#258). A slot, not a rendered input: the bar owns its MEASURE
-     * (`--filter-bar-search-width`) and its position at the START of the row, while the caller
-     * still chooses the real primitive (`SearchInput`, or a `Select showSearch` for scoped search)
-     * and owns its debounce and value. Passing the control as a child instead is what produced the
-     * inconsistent search widths the issue was filed against.
-     */
-    search?: ChildrenProp;
-    /**
-     * Applied filters as removable chips (#258). The bar owns the CHIP LIFECYCLE — chips render
-     * below the control row, each with an accessible remove control, and the row disappears entirely
-     * when the array is empty (never an empty reserved strip). It owns no state: removing a chip
-     * calls back and the caller re-renders the array.
-     */
-    chips?: readonly FilterBarChipProp[];
-    /**
-     * Called with the chip's `id` when its remove control is activated. Fires in addition to that
-     * chip's own `onRemove`, so a caller may handle removal per chip, centrally, or both.
-     */
-    onChipRemove?: (id: string) => void;
-    /**
-     * Number of records the current filters resolve to (#258). Rendered in a POLITE LIVE REGION and
-     * formatted with `Intl.NumberFormat` + CLDR plurals for the active locale — which is the point:
-     * a sighted user sees the table change, and this is what tells everyone else that filtering
-     * happened. Omit when the count is unknown or still loading.
-     */
-    resultCount?: number;
-    /**
-     * Trailing action region (#258) — export, column settings, a saved-view menu. Rendered AFTER the
-     * reset control, so "clear filters" never sits at the end of the row beside an unrelated primary
-     * action. The bar owns the ordering; the caller owns the controls.
-     */
-    actions?: ChildrenProp;
     /**
      * 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
@@ -76,8 +76,35 @@ export type ToolbarProp = {
      * Tune the scrollbar gutter with the `--filter-bar-scroll-padding-y` theme knob.
      */
     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.
+     */
+    search?: FilterBarSearchProp;
+    /** Typed model — labelled Select filters rendered after the search slot, in array order. */
+    filters?: FilterBarFilterProp[];
+    /** Typed model — applied-filter chips (consumer data; add = include, remove = `onChipRemove`). */
+    chips?: FilterBarChipProp[];
+    /** Remove ONE chip by its `value`. Required for chips to render their × remove button. */
+    onChipRemove?: (value: string) => void;
+    /** Typed model — trailing action slot (e.g. a primary "Add" Button), parked at the inline end. */
+    actions?: ActionsProp;
+    /**
+     * Typed model — localized, pluralized result count ("{count} results") announced politely via a
+     * `role="status"` line under the strip. `0` is the rendered empty state, not "hidden".
+     */
+    resultCount?: number;
+    /** Typed model — marks the strip `aria-busy` while results are being (re)fetched. */
+    loading?: PendingProp;
+    /** Typed model — disables every model-rendered control (search, filters, reset, chip removes). */
+    disabled?: DisabledProp;
+    /** Typed model — consumer error content, announced via `role="alert"` in place of the count. */
+    error?: ErrorProp;
     className?: ClassNameProp;
-    children: ChildrenProp;
+    children?: ChildrenProp;
 };
 /** @see ToolbarGroup */
 export type ToolbarGroupProp = {
@@ -144,18 +171,9 @@ export type StepsProp = {
     type?: "default" | "dot" | "inline";
     size?: "md" | "sm";
     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`.
-     */
-    separator?: StepsSeparatorProp;
     onValueChange?: (value: number) => void;
     className?: ClassNameProp;
 };
-/** @see Steps — inline separator glyph. */
-export type StepsSeparatorProp = "chevron" | "arrow";
 /** Tab pane — Ant Design `items` entry. */
 export type TabItemProp = {
     value: string;

package/dist/props/registry.d.ts

@@ -124,6 +124,11 @@ export declare const VOCABULARY_REGISTRY: {
         readonly category: "content";
         readonly description: "Secondary line under title";
     };
+    readonly StatusProp: {
+        readonly file: "vocabulary/content.prop.ts";
+        readonly category: "content";
+        readonly description: "Status/meta band beside a title (StatusBadge, meta text)";
+    };
     readonly DescriptionProp: {
         readonly file: "vocabulary/content.prop.ts";
         readonly category: "content";
@@ -222,7 +227,7 @@ export declare const VOCABULARY_REGISTRY: {
     readonly AuthShellPresetProp: {
         readonly file: "vocabulary/layout.prop.ts";
         readonly category: "layout";
-        readonly description: "AuthShell named flow geometry — default | login (stable SCR-001 identity/card/footer anchor) | device-authorization (380px card, 5px mobile gutter) | context-selection (25rem card, edge-to-edge mobile) | account-recovery (432px SCR-008 recovery/MFA panel, 15px mobile gutter)";
+        readonly description: "AuthShell named flow geometry — default | login (stable SCR-001 identity/card/footer anchor) | registration (360px SCR-002 sign-up measure, start-aligned long-form scroll, own footer clearance, 15px mobile gutter) | device-authorization (380px card, 5px mobile gutter) | context-selection (25rem card, edge-to-edge mobile) | account-recovery (432px SCR-008 recovery/MFA panel, 15px mobile gutter)";
     };
     readonly GapProp: {
         readonly file: "vocabulary/layout.prop.ts";
@@ -322,7 +327,7 @@ export declare const VOCABULARY_REGISTRY: {
     readonly AlertVariantProp: {
         readonly file: "vocabulary/interaction.prop.ts";
         readonly category: "interaction";
-        readonly description: "Inline Alert banner tone";
+        readonly description: "Alert structural axis: default inline card | banner full-bleed strip";
     };
     readonly SortDirectionProp: {
         readonly file: "vocabulary/interaction.prop.ts";
@@ -461,35 +466,10 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/layout.prop.ts";
         readonly vocabulary: readonly [];
     };
-    readonly PageHeaderProp: {
-        readonly group: "layout";
-        readonly file: "components/layout.prop.ts";
-        readonly vocabulary: readonly ["TitleProp", "SubtitleProp", "ExtraProp", "BreadcrumbProp", {
-            readonly field: "meta";
-            readonly local: true;
-            readonly reason: "Status/meta band rendered inline with the `<h1>` (a Badge tone, a record id, a timestamp). A free ReactNode slot, not a controlled value — the header never interprets what it holds.";
-        }, {
-            readonly field: "layout";
-            readonly local: true;
-            readonly reason: "Header ARRANGEMENT of the title band vs the extra slot below the 640px step (stack | responsive-inline) — the standalone spelling of PageContainer's `headerLayout`.";
-        }, {
-            readonly field: "loading";
-            readonly local: true;
-            readonly reason: "Pending state of the TITLE BAND only (skeleton title/subtitle + aria-busy), distinct from a page-wide DataState: breadcrumbs and actions come from the route and stay live while the record resolves.";
-        }];
-    };
     readonly PageContainerProp: {
         readonly group: "layout";
         readonly file: "components/layout.prop.ts";
-        readonly vocabulary: readonly ["TitleProp", "SubtitleProp", "ExtraProp", "FooterProp", "BreadcrumbProp", "DensityProp", "PageContainerVariantProp", {
-            readonly field: "meta";
-            readonly local: true;
-            readonly reason: "Forwarded verbatim to PageHeader's `meta` slot — see PageHeaderProp.";
-        }, {
-            readonly field: "headerLoading";
-            readonly local: true;
-            readonly reason: "Forwarded to PageHeader's `loading`. Named for the BAND it skeletonises, so it can never be read as a page-wide loading flag (that is DataState's job).";
-        }, {
+        readonly vocabulary: readonly ["TitleProp", "SubtitleProp", "StatusProp", "ExtraProp", "FooterProp", "BreadcrumbProp", "DensityProp", "PageContainerVariantProp", {
             readonly field: "headerLayout";
             readonly local: true;
             readonly reason: "Header ARRANGEMENT of the title band vs the extra slot below the 640px step (stack | responsive-inline) — orthogonal to PageContainerVariantProp, which selects the page shell layout.";
@@ -1063,11 +1043,6 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-display.prop.ts";
         readonly vocabulary: readonly ["AvatarShapeProp", "ChildrenProp", "ClassNameProp"];
     };
-    readonly AvatarAppearanceProp: {
-        readonly group: "data-display";
-        readonly file: "components/data-display.prop.ts";
-        readonly vocabulary: readonly [];
-    };
     readonly BadgeProp: {
         readonly group: "data-display";
         readonly file: "components/data-display.prop.ts";
@@ -1418,41 +1393,27 @@ export declare const COMPONENT_PROP_REGISTRY: {
     readonly ToolbarProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
-        readonly vocabulary: readonly ["OnClearFiltersProp", "HasActiveFiltersProp", "StickyProp", "ClassNameProp", "ChildrenProp", {
-            readonly field: "search";
-            readonly local: true;
-            readonly reason: "SLOT for the caller's own search control, positioned at the start of the row and measured by --filter-bar-search-width. Not a value/onValueChange pair: the bar owns the search's PLACE and WIDTH, never its state (gh#258).";
-        }, {
-            readonly field: "chips";
-            readonly local: true;
-            readonly reason: "APPLIED filters as removable chips — the visible record of filters already in effect, distinct from the controls that set them. A bar-specific shape (id/label/onRemove), not a shared vocabulary type (gh#258).";
-        }, {
-            readonly field: "onChipRemove";
-            readonly local: true;
-            readonly reason: "Chip-removal callback keyed by chip id. Not `onValueChange`: it reports ONE lifted filter rather than the bar's whole value, which the bar deliberately does not hold (gh#258).";
-        }, {
-            readonly field: "resultCount";
-            readonly local: true;
-            readonly reason: "Number of records the current filters resolve to, announced in a polite live region and formatted via Intl.NumberFormat + CLDR plurals. Presentational output, not a controlled value (gh#258).";
-        }, {
-            readonly field: "actions";
-            readonly local: true;
-            readonly reason: "Trailing action SLOT (export, column settings, saved views), ordered AFTER the reset control by the bar so `clear filters` never sits beside an unrelated primary action (gh#258).";
-        }];
+        readonly vocabulary: readonly ["OnClearFiltersProp", "HasActiveFiltersProp", "StickyProp", "ActionsProp", "PendingProp", "DisabledProp", "ErrorProp", "ClassNameProp", "ChildrenProp"];
     };
-    readonly FilterBarChipProp: {
+    readonly FilterBarOverflowProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
-        readonly vocabulary: readonly ["IdProp", "LabelProp", {
-            readonly field: "onRemove";
-            readonly local: true;
-            readonly reason: "Per-chip removal. Omitting it is meaningful — the chip renders with NO remove control (a filter the user may not lift), rather than a disabled button that is a dead tab stop (gh#258).";
-        }];
+        readonly vocabulary: readonly [];
     };
-    readonly FilterBarOverflowProp: {
+    readonly FilterBarSearchProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
-        readonly vocabulary: readonly [];
+        readonly vocabulary: readonly ["PlaceholderProp", "IdProp", "DisabledProp"];
+    };
+    readonly FilterBarFilterProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "PlaceholderProp", "DisabledProp"];
+    };
+    readonly FilterBarChipProp: {
+        readonly group: "navigation";
+        readonly file: "components/navigation.prop.ts";
+        readonly vocabulary: readonly ["DisabledProp"];
     };
     readonly ToolbarGroupProp: {
         readonly group: "navigation";
@@ -1479,11 +1440,6 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/data-entry.prop.ts";
         readonly vocabulary: readonly [];
     };
-    readonly InputOTPAlignProp: {
-        readonly group: "data-entry";
-        readonly file: "components/data-entry.prop.ts";
-        readonly vocabulary: readonly [];
-    };
     readonly StepItemProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
@@ -1494,11 +1450,6 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/navigation.prop.ts";
         readonly vocabulary: readonly [];
     };
-    readonly StepsSeparatorProp: {
-        readonly group: "navigation";
-        readonly file: "components/navigation.prop.ts";
-        readonly vocabulary: readonly [];
-    };
     readonly TabsProp: {
         readonly group: "navigation";
         readonly file: "components/navigation.prop.ts";
@@ -1664,6 +1615,256 @@ export declare const COMPONENT_PROP_REGISTRY: {
         readonly file: "components/layout/split-pane.tsx";
         readonly vocabulary: readonly ["ClassNameProp", "ChildrenProp"];
     };
+    readonly PermissionMatrixRoleProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["IdProp", {
+            readonly field: "name";
+            readonly local: true;
+            readonly reason: "Consumer-supplied role display name; a plain string so it can label cells for AT.";
+        }, {
+            readonly field: "description";
+            readonly local: true;
+            readonly reason: "Secondary caption under the role column header.";
+        }, {
+            readonly field: "locked";
+            readonly local: true;
+            readonly reason: "Per-role read-only flag — a locked role keeps ✓/— cells in an editable matrix.";
+        }];
+    };
+    readonly PermissionMatrixPermissionProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["IdProp", {
+            readonly field: "name";
+            readonly local: true;
+            readonly reason: "Consumer-supplied permission display name; plain string for accessible labels.";
+        }, {
+            readonly field: "description";
+            readonly local: true;
+            readonly reason: "Secondary line under the permission name.";
+        }, {
+            readonly field: "group";
+            readonly local: true;
+            readonly reason: "Optional category caption for the permission row.";
+        }];
+    };
+    readonly PermissionMatrixGrantsProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "grants";
+            readonly local: true;
+            readonly reason: "The role×permission grant relation — the grantKey Set from lib/permission-grid or a pair array normalized through the same encoding.";
+        }];
+    };
+    readonly PermissionMatrixProp: {
+        readonly group: "data-display";
+        readonly file: "components/data-display.prop.ts";
+        readonly vocabulary: readonly ["LabelProp", "HandlerProp", "ClassNameProp", "IdProp", {
+            readonly field: "roles";
+            readonly local: true;
+            readonly reason: "Consumer-supplied role columns (see PermissionMatrixRoleProp).";
+        }, {
+            readonly field: "permissions";
+            readonly local: true;
+            readonly reason: "Consumer-supplied permission rows (see PermissionMatrixPermissionProp).";
+        }, {
+            readonly field: "grants";
+            readonly local: true;
+            readonly reason: "The grant relation (see PermissionMatrixGrantsProp).";
+        }, {
+            readonly field: "onGrantChange";
+            readonly local: true;
+            readonly reason: "Cell toggle handler carrying the (roleId, permissionId, granted) triple; its presence switches the grid from read-only ✓/— to editable checkboxes.";
+        }, {
+            readonly field: "readOnly";
+            readonly local: true;
+            readonly reason: "Forces the read-only grid even when onGrantChange is present (viewer permission).";
+        }, {
+            readonly field: "compare";
+            readonly local: true;
+            readonly reason: "Two role ids compared side by side — the lib/permission-grid ComparePair.";
+        }, {
+            readonly field: "diffOnly";
+            readonly local: true;
+            readonly reason: "差分のみ filter: with compare set, keep only the rows where the two roles differ.";
+        }, {
+            readonly field: "loading";
+            readonly local: true;
+            readonly reason: "Read-lifecycle skeleton state mirroring DataTable #216 (precedence loading → denied → error → empty).";
+        }, {
+            readonly field: "empty";
+            readonly local: true;
+            readonly reason: "Custom empty content override, mirroring DataTable's empty slot.";
+        }, {
+            readonly field: "error";
+            readonly local: true;
+            readonly reason: "Read-failure state mirroring DataTable #216 (true = built-in localized message).";
+        }, {
+            readonly field: "denied";
+            readonly local: true;
+            readonly reason: "Permission-denied read state mirroring DataTable #216 — refused, not failed.";
+        }, {
+            readonly field: "onRetry";
+            readonly local: true;
+            readonly reason: "Retry affordance for the built-in error state, mirroring DataTable #216.";
+        }];
+    };
+    readonly BranchScopeModeProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "mode";
+            readonly local: true;
+            readonly reason: "Closed scope vocabulary: all branches vs an explicit subset.";
+        }];
+    };
+    readonly BranchScopeValueProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly [{
+            readonly field: "mode";
+            readonly local: true;
+            readonly reason: "The selected scope mode (see BranchScopeModeProp).";
+        }, {
+            readonly field: "branchIds";
+            readonly local: true;
+            readonly reason: "Checked branch ids, meaningful only when mode = selected.";
+        }];
+    };
+    readonly BranchScopeOptionProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["IdProp", "DisabledProp", {
+            readonly field: "name";
+            readonly local: true;
+            readonly reason: "Consumer-supplied branch display name; plain string so it is searchable.";
+        }, {
+            readonly field: "description";
+            readonly local: true;
+            readonly reason: "Secondary line under the branch name.";
+        }];
+    };
+    readonly BranchScopePickerProp: {
+        readonly group: "data-entry";
+        readonly file: "components/data-entry.prop.ts";
+        readonly vocabulary: readonly ["ValueProp", "DefaultValueProp", "OnValueChangeProp", "DisabledProp", "ErrorProp", "NameProp", "IdProp", "ClassNameProp", {
+            readonly field: "branches";
+            readonly local: true;
+            readonly reason: "Consumer-supplied selectable branches (see BranchScopeOptionProp).";
+        }, {
+            readonly field: "readOnly";
+            readonly local: true;
+            readonly reason: "Locked view: render the current scope without editable affordances.";
+        }, {
+            readonly field: "searchable";
+            readonly local: true;
+            readonly reason: "Toggle for the built-in branch SearchInput above the checkbox list.";
+        }, {
+            readonly field: "loading";
+            readonly local: true;
+            readonly reason: "Read-lifecycle skeleton state (precedence loading → denied → listError → empty).";
+        }, {
+            readonly field: "empty";
+            readonly local: true;
+            readonly reason: "Custom empty content when there are no branches.";
+        }, {
+            readonly field: "listError";
+            readonly local: true;
+            readonly reason: "Branch-collection READ failure — deliberately distinct from ErrorProp `error`, which stays field validation.";
+        }, {
+            readonly field: "denied";
+            readonly local: true;
+            readonly reason: "Permission-denied read state — the branch collection was refused, not failed.";
+        }, {
+            readonly field: "allLabel";
+            readonly local: true;
+            readonly reason: "Override for the localized all-branches radio label.";
+        }, {
+            readonly field: "selectedLabel";
+            readonly local: true;
+            readonly reason: "Override for the localized selected-branches radio label.";
+        }];
+    };
+    readonly ServiceRoleItemProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["IdProp", {
+            readonly field: "name";
+            readonly local: true;
+            readonly reason: "Consumer-supplied role display name; plain string for accessible labels.";
+        }, {
+            readonly field: "description";
+            readonly local: true;
+            readonly reason: "Secondary line under the role name in the master rail.";
+        }, {
+            readonly field: "memberCount";
+            readonly local: true;
+            readonly reason: "Member count caption, pluralized via CLDR categories.";
+        }, {
+            readonly field: "locked";
+            readonly local: true;
+            readonly reason: "System-role flag: lock badge, no delete affordance ever.";
+        }];
+    };
+    readonly ServiceRolePanelProp: {
+        readonly group: "layout";
+        readonly file: "components/layout.prop.ts";
+        readonly vocabulary: readonly ["ValueProp", "DefaultValueProp", "OnValueChangeProp", "ChildrenProp", "BreakpointProp", "IdProp", "ClassNameProp", {
+            readonly field: "roles";
+            readonly local: true;
+            readonly reason: "Consumer-supplied role collection (see ServiceRoleItemProp).";
+        }, {
+            readonly field: "onDeleteRole";
+            readonly local: true;
+            readonly reason: "Confirmed-deletion handler; its presence arms the built-in destructive AlertDialog per non-locked role.";
+        }, {
+            readonly field: "readOnly";
+            readonly local: true;
+            readonly reason: "Locked view: hides every mutating affordance.";
+        }, {
+            readonly field: "loading";
+            readonly local: true;
+            readonly reason: "Read-lifecycle skeleton state (precedence loading → denied → error → empty).";
+        }, {
+            readonly field: "empty";
+            readonly local: true;
+            readonly reason: "Custom empty content when there are no roles.";
+        }, {
+            readonly field: "error";
+            readonly local: true;
+            readonly reason: "Read-failure state (true = built-in localized message, node replaces it).";
+        }, {
+            readonly field: "denied";
+            readonly local: true;
+            readonly reason: "Permission-denied read state — refused, not failed.";
+        }, {
+            readonly field: "onRetry";
+            readonly local: true;
+            readonly reason: "Retry affordance for the built-in error state.";
+        }, {
+            readonly field: "masterLabel";
+            readonly local: true;
+            readonly reason: "Accessible name override for the roles region (localized default otherwise).";
+        }, {
+            readonly field: "detailLabel";
+            readonly local: true;
+            readonly reason: "Accessible name override for the detail region (localized default otherwise).";
+        }, {
+            readonly field: "railWidth";
+            readonly local: true;
+            readonly reason: "Forwarded MasterDetail rail geometry preset.";
+        }, {
+            readonly field: "masterViewport";
+            readonly local: true;
+            readonly reason: "Forwarded MasterDetail bounded-collection preset.";
+        }, {
+            readonly field: "collapseBelow";
+            readonly local: true;
+            readonly reason: "Forwarded MasterDetail stacking threshold override.";
+        }];
+    };
 };
 export type ComponentPropName = keyof typeof COMPONENT_PROP_REGISTRY;
 /** Forbidden duplicate concepts — use the canonical name on the left. */