@godxjp/ui 18.9.0 → 18.11.0

package/dist/components/navigation/tabs.js

@@ -106,7 +106,12 @@ const TabsList = React.forwardRef(({ className, variant = "default", ...props },
         // active trigger when a resize would otherwise strand it off-strip (gh#204). Vertical
         // orientation is untouched — it already stacks in a column and is sized by its own
         // `h-*`/`w-*` overrides.
-        "group/tabs-list text-muted-foreground data-[variant=default]:bg-muted inline-flex w-fit max-w-full min-w-0 items-center justify-center rounded-lg p-1 group-data-[orientation=vertical]/tabs:flex-col data-[orientation=horizontal]:[scrollbar-width:none] data-[orientation=horizontal]:overflow-x-auto data-[orientation=horizontal]:overflow-y-hidden data-[variant=line]:gap-1 data-[variant=line]:rounded-none data-[variant=line]:bg-transparent [&[data-orientation=horizontal]::-webkit-scrollbar]:hidden",
+        // justify-center-SAFE: the strip is a centred flex box that also scrolls. Plain `center`
+        // splits the overflow across BOTH edges, and scrollLeft only ever covers the trailing one
+        // — so the leading tab sat permanently outside the scrollport (an unreachable control at
+        // 320px, WCAG 2.2 SC 2.1.1). `safe` falls back to start alignment exactly when it
+        // overflows, and still centres whenever the tabs fit.
+        "group/tabs-list text-muted-foreground data-[variant=default]:bg-muted inline-flex w-fit max-w-full min-w-0 items-center justify-center-safe rounded-lg p-1 group-data-[orientation=vertical]/tabs:flex-col data-[orientation=horizontal]:[scrollbar-width:none] data-[orientation=horizontal]:overflow-x-auto data-[orientation=horizontal]:overflow-y-hidden data-[variant=line]:gap-1 data-[variant=line]:rounded-none data-[variant=line]:bg-transparent [&[data-orientation=horizontal]::-webkit-scrollbar]:hidden",
         className
       ),
       ...props

package/dist/i18n/messages/en.json

@@ -110,6 +110,24 @@
       "previousYear": "Previous year",
       "nextYear": "Next year",
       "placeholder": "yyyy/mm"
+    },
+    "branchScope": {
+      "label": "Branch scope",
+      "all": "All branches",
+      "allDescription": "Applies to every current and future branch",
+      "selected": "Selected branches only",
+      "selectedDescription": "Applies only to the branches checked below",
+      "listLabel": "Branches",
+      "searchPlaceholder": "Search branches",
+      "selectedCount": {
+        "one": "{count} branch selected",
+        "other": "{count} branches selected"
+      },
+      "empty": "No branches to choose from",
+      "error": "Could not load branches",
+      "denied": "You do not have permission to view branches",
+      "loading": "Loading branches…",
+      "noMatches": "No branches match your search"
     }
   },
   "feedback": {
@@ -124,6 +142,9 @@
     }
   },
   "layout": {
+    "pageHeader": {
+      "loading": "Loading page…"
+    },
     "sidebar": {
       "ariaLabel": "Primary"
     },
@@ -135,9 +156,6 @@
       "openNav": "Open navigation menu",
       "navLabel": "Menu"
     },
-    "pageHeader": {
-      "loading": "Loading page…"
-    },
     "authShell": {
       "brandLabel": "Brand",
       "mainLabel": "Main content",
@@ -167,6 +185,28 @@
       "searchPlaceholder": "Search...",
       "notifications": "Notifications",
       "tweaks": "Open settings"
+    },
+    "serviceRolePanel": {
+      "rolesLabel": "Roles",
+      "detailLabel": "Role detail",
+      "locked": "Locked",
+      "memberCount": {
+        "one": "{count} member",
+        "other": "{count} members"
+      },
+      "selectRole": "Select {role}",
+      "deleteRole": "Delete {role}",
+      "deleteTitle": "Delete this role?",
+      "deleteDescription": "Deleting {role} removes its permissions from every assigned member. This cannot be undone.",
+      "deleteConfirm": "Delete role",
+      "empty": "No roles yet",
+      "emptyDescription": "Create a role to start assigning permissions.",
+      "error": "Could not load roles",
+      "errorDescription": "The data could not be fetched. Try again shortly.",
+      "denied": "You do not have permission to view roles",
+      "deniedDescription": "Ask an administrator to grant you access.",
+      "loading": "Loading roles…",
+      "noDetail": "Select a role to see its detail"
     }
   },
   "dataDisplay": {
@@ -182,6 +222,21 @@
     "listRow": {
       "unread": "Unread",
       "read": "Read"
+    },
+    "permissionMatrix": {
+      "caption": "Role and permission matrix",
+      "permissionColumn": "Permission",
+      "granted": "Granted",
+      "notGranted": "Not granted",
+      "difference": "Difference",
+      "toggle": "Grant {permission} to {role}",
+      "locked": "Locked",
+      "empty": "No permissions to show",
+      "error": "Could not load the permission matrix",
+      "errorDescription": "The data could not be fetched. Try again shortly.",
+      "denied": "You do not have permission to view this matrix",
+      "deniedDescription": "Ask an administrator to grant you access.",
+      "loading": "Loading permissions…"
     }
   },
   "ui": {
@@ -232,7 +287,7 @@
     },
     "filterBar": {
       "appliedFilters": "Applied filters",
-      "removeFilter": "Remove filter {label}",
+      "removeFilter": "Remove filter: {label}",
       "resultCount": {
         "one": "{count} result",
         "other": "{count} results"

package/dist/i18n/messages/ja.json

@@ -110,6 +110,21 @@
       "previousYear": "前年へ",
       "nextYear": "翌年へ",
       "placeholder": "yyyy/mm"
+    },
+    "branchScope": {
+      "label": "ブランチ範囲",
+      "all": "すべてのブランチ",
+      "allDescription": "現在および今後のすべてのブランチに適用",
+      "selected": "選択したブランチのみ",
+      "selectedDescription": "下で選択したブランチにのみ適用",
+      "listLabel": "ブランチ",
+      "searchPlaceholder": "ブランチを検索",
+      "selectedCount": "{count} 件選択中",
+      "empty": "選択できるブランチがありません",
+      "error": "ブランチを取得できませんでした",
+      "denied": "ブランチを表示する権限がありません",
+      "loading": "ブランチを読み込み中…",
+      "noMatches": "検索に一致するブランチがありません"
     }
   },
   "feedback": {
@@ -124,6 +139,9 @@
     }
   },
   "layout": {
+    "pageHeader": {
+      "loading": "ページを読み込んでいます…"
+    },
     "sidebar": {
       "ariaLabel": "メインナビゲーション"
     },
@@ -135,9 +153,6 @@
       "openNav": "ナビゲーションメニューを開く",
       "navLabel": "メニュー"
     },
-    "pageHeader": {
-      "loading": "ページを読み込んでいます…"
-    },
     "authShell": {
       "brandLabel": "ブランド",
       "mainLabel": "メインコンテンツ",
@@ -167,6 +182,25 @@
       "searchPlaceholder": "検索...",
       "notifications": "通知",
       "tweaks": "設定を開く"
+    },
+    "serviceRolePanel": {
+      "rolesLabel": "ロール一覧",
+      "detailLabel": "ロールの詳細",
+      "locked": "変更不可",
+      "memberCount": "{count} 名",
+      "selectRole": "{role} を選択",
+      "deleteRole": "{role} を削除",
+      "deleteTitle": "ロールを削除しますか？",
+      "deleteDescription": "{role} を削除すると、割り当てられたメンバーはこのロールの権限を失います。この操作は取り消せません。",
+      "deleteConfirm": "ロールを削除",
+      "empty": "ロールがありません",
+      "emptyDescription": "ロールを作成して権限の割り当てを始めましょう。",
+      "error": "ロールを取得できませんでした",
+      "errorDescription": "データを取得できませんでした。時間をおいて再試行してください。",
+      "denied": "ロールを表示する権限がありません",
+      "deniedDescription": "閲覧するには管理者に権限の付与を依頼してください。",
+      "loading": "ロールを読み込み中…",
+      "noDetail": "ロールを選択すると詳細が表示されます"
     }
   },
   "dataDisplay": {
@@ -182,6 +216,21 @@
     "listRow": {
       "unread": "未読",
       "read": "既読"
+    },
+    "permissionMatrix": {
+      "caption": "ロールと権限のマトリクス",
+      "permissionColumn": "権限",
+      "granted": "許可",
+      "notGranted": "不許可",
+      "difference": "差分",
+      "toggle": "{role} に {permission} を付与",
+      "locked": "変更不可",
+      "empty": "表示できる権限がありません",
+      "error": "権限マトリクスを取得できませんでした",
+      "errorDescription": "データを取得できませんでした。時間をおいて再試行してください。",
+      "denied": "このマトリクスを表示する権限がありません",
+      "deniedDescription": "閲覧するには管理者に権限の付与を依頼してください。",
+      "loading": "権限を読み込み中…"
     }
   },
   "ui": {
@@ -232,8 +281,8 @@
     },
     "filterBar": {
       "appliedFilters": "適用中のフィルター",
-      "removeFilter": "フィルター「{label}」を解除",
-      "resultCount": "{count} 件"
+      "removeFilter": "フィルターを解除: {label}",
+      "resultCount": "{count} 件の結果"
     },
     "localePicker": {
       "ariaLabel": "言語"

package/dist/i18n/messages/vi.json

@@ -110,6 +110,21 @@
       "previousYear": "Năm trước",
       "nextYear": "Năm sau",
       "placeholder": "yyyy/mm"
+    },
+    "branchScope": {
+      "label": "Phạm vi chi nhánh",
+      "all": "Tất cả chi nhánh",
+      "allDescription": "Áp dụng cho mọi chi nhánh hiện tại và sau này",
+      "selected": "Chỉ chi nhánh đã chọn",
+      "selectedDescription": "Chỉ áp dụng cho các chi nhánh được chọn bên dưới",
+      "listLabel": "Chi nhánh",
+      "searchPlaceholder": "Tìm chi nhánh",
+      "selectedCount": "Đã chọn {count} chi nhánh",
+      "empty": "Chưa có chi nhánh để chọn",
+      "error": "Không tải được danh sách chi nhánh",
+      "denied": "Bạn không có quyền xem chi nhánh",
+      "loading": "Đang tải chi nhánh…",
+      "noMatches": "Không có chi nhánh khớp với tìm kiếm"
     }
   },
   "feedback": {
@@ -124,6 +139,9 @@
     }
   },
   "layout": {
+    "pageHeader": {
+      "loading": "Đang tải trang…"
+    },
     "sidebar": {
       "ariaLabel": "Điều hướng chính"
     },
@@ -135,9 +153,6 @@
       "openNav": "Mở menu điều hướng",
       "navLabel": "Menu"
     },
-    "pageHeader": {
-      "loading": "Đang tải trang…"
-    },
     "authShell": {
       "brandLabel": "Thương hiệu",
       "mainLabel": "Nội dung chính",
@@ -167,6 +182,25 @@
       "searchPlaceholder": "Tìm kiếm...",
       "notifications": "Thông báo",
       "tweaks": "Mở tùy chỉnh"
+    },
+    "serviceRolePanel": {
+      "rolesLabel": "Danh sách vai trò",
+      "detailLabel": "Chi tiết vai trò",
+      "locked": "Đã khóa",
+      "memberCount": "{count} thành viên",
+      "selectRole": "Chọn {role}",
+      "deleteRole": "Xóa {role}",
+      "deleteTitle": "Xóa vai trò này?",
+      "deleteDescription": "Xóa {role} sẽ gỡ quyền của vai trò này khỏi mọi thành viên được gán. Không thể hoàn tác.",
+      "deleteConfirm": "Xóa vai trò",
+      "empty": "Chưa có vai trò",
+      "emptyDescription": "Tạo một vai trò để bắt đầu gán quyền.",
+      "error": "Không tải được vai trò",
+      "errorDescription": "Không lấy được dữ liệu. Vui lòng thử lại sau giây lát.",
+      "denied": "Bạn không có quyền xem vai trò",
+      "deniedDescription": "Hãy đề nghị quản trị viên cấp quyền truy cập.",
+      "loading": "Đang tải vai trò…",
+      "noDetail": "Chọn một vai trò để xem chi tiết"
     }
   },
   "dataDisplay": {
@@ -182,6 +216,21 @@
     "listRow": {
       "unread": "Chưa đọc",
       "read": "Đã đọc"
+    },
+    "permissionMatrix": {
+      "caption": "Ma trận vai trò và quyền",
+      "permissionColumn": "Quyền",
+      "granted": "Được phép",
+      "notGranted": "Không được phép",
+      "difference": "Khác biệt",
+      "toggle": "Cấp {permission} cho {role}",
+      "locked": "Đã khóa",
+      "empty": "Chưa có quyền nào để hiển thị",
+      "error": "Không tải được ma trận quyền",
+      "errorDescription": "Không lấy được dữ liệu. Vui lòng thử lại sau giây lát.",
+      "denied": "Bạn không có quyền xem ma trận này",
+      "deniedDescription": "Hãy đề nghị quản trị viên cấp quyền truy cập.",
+      "loading": "Đang tải quyền…"
     }
   },
   "ui": {
@@ -232,7 +281,7 @@
     },
     "filterBar": {
       "appliedFilters": "Bộ lọc đang áp dụng",
-      "removeFilter": "Bỏ bộ lọc {label}",
+      "removeFilter": "Bỏ bộ lọc: {label}",
       "resultCount": "{count} kết quả"
     },
     "localePicker": {

package/dist/lib/field-a11y.d.ts

@@ -39,6 +39,13 @@ export declare function mergeAriaIds(...values: Array<string | undefined>): stri
  * ```
  */
 export declare function pickFieldA11y(props: FieldA11yProps): FieldA11yProps;
+/**
+ * The inverse of {@link pickFieldA11y}: everything EXCEPT the field-a11y attributes. Use it when a
+ * component must route the contract somewhere other than the element the remaining props land on —
+ * e.g. `Select`'s compound API, where the props bag belongs to `SelectPrimitive.Root` (a
+ * context-only component that renders no DOM) while the accessible name has to reach the trigger.
+ */
+export declare function omitFieldA11y<T extends FieldA11yProps>(props: T): Omit<T, keyof FieldA11yProps>;
 /**
  * As {@link pickFieldA11y}, but resolves the accessible **name** for a control that also has an
  * intrinsic `aria-label` (e.g. SearchInput's built-in "Search"): when the FormField supplies an

package/dist/lib/field-a11y.js

@@ -19,6 +19,11 @@ function pickFieldA11y(props) {
   }
   return out;
 }
+function omitFieldA11y(props) {
+  const out = { ...props };
+  for (const key of FIELD_A11Y_KEYS) delete out[key];
+  return out;
+}
 function resolveFieldA11y(props, intrinsicAriaLabel) {
   const picked = pickFieldA11y(props);
   if (picked["aria-labelledby"]) {
@@ -38,6 +43,7 @@ function pickGroupFieldA11y(props) {
 }
 export {
   mergeAriaIds,
+  omitFieldA11y,
   pickFieldA11y,
   pickGroupFieldA11y,
   resolveFieldA11y

package/dist/lib/hooks.d.ts

@@ -28,3 +28,18 @@ export declare function useTimeoutFlag(signal: unknown, ms?: number): boolean;
 export declare function useControlledLatch(valueIsDefined: boolean): boolean;
 export declare function useMediaQuery(query: string): boolean;
 export declare function useIsMobile(): boolean;
+/**
+ * WCAG 2.1.1 — a region that scrolls must be operable by keyboard. Tabbing to a focusable child
+ * scrolls the container, so a region whose content IS focusable needs nothing; one whose content is
+ * inert (plain text) strands its overflow for anyone not using a pointer and must therefore take
+ * focus itself via `tabindex="0"`. Which case applies depends on the RENDERED size and content —
+ * the same pagination strip is fine at 1440px and unreachable at 375px, and a panel full of text
+ * only overflows once it is resized — so it is measured at runtime and kept in sync as the element
+ * resizes or its content changes.
+ *
+ * The attribute is written imperatively rather than rendered: `react-resizable-panels` applies our
+ * className to a nested div it owns, which no prop can reach.
+ *
+ * @param element the scroll container itself (state, not a ref, so the effect re-runs when it mounts)
+ */
+export declare function useScrollableRegionTabIndex(element: HTMLElement | null): void;

package/dist/lib/hooks.js

@@ -68,10 +68,47 @@ function useMediaQuery(query) {
 function useIsMobile() {
   return useMediaQuery("(max-width: 767px)");
 }
+const SCROLLABLE_REGION_FOCUSABLE_SELECTOR = 'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+function useScrollableRegionTabIndex(element) {
+  useEffect(() => {
+    if (!element) return;
+    const sync = () => {
+      const scrolls = element.scrollHeight > element.clientHeight || element.scrollWidth > element.clientWidth;
+      const hasFocusableContent = element.querySelector(SCROLLABLE_REGION_FOCUSABLE_SELECTOR) !== null;
+      if (scrolls && !hasFocusableContent) {
+        if (element.getAttribute("tabindex") !== "0") element.setAttribute("tabindex", "0");
+      } else if (element.getAttribute("tabindex") === "0") {
+        element.removeAttribute("tabindex");
+      }
+    };
+    sync();
+    const observers = [];
+    if (typeof ResizeObserver !== "undefined") {
+      const resizeObserver = new ResizeObserver(sync);
+      resizeObserver.observe(element);
+      for (const child of Array.from(element.children)) resizeObserver.observe(child);
+      observers.push(resizeObserver);
+    }
+    if (typeof MutationObserver !== "undefined") {
+      const mutationObserver = new MutationObserver(sync);
+      mutationObserver.observe(element, {
+        childList: true,
+        subtree: true,
+        attributes: true,
+        attributeFilter: ["disabled", "href", "tabindex"]
+      });
+      observers.push(mutationObserver);
+    }
+    return () => {
+      for (const observer of observers) observer.disconnect();
+    };
+  }, [element]);
+}
 export {
   useControlledLatch,
   useDebouncedValue,
   useIsMobile,
   useMediaQuery,
+  useScrollableRegionTabIndex,
   useTimeoutFlag
 };

package/dist/props/components/data-display.prop.d.ts

@@ -229,3 +229,69 @@ export type ListRowProp = {
     unread?: boolean;
     className?: ClassNameProp;
 };
+/** @see PermissionMatrix — one role COLUMN. Domain data is consumer-supplied; nothing is encoded. */
+export type PermissionMatrixRoleProp = {
+    /** Stable role id — the `roleId` half of a grant key. */
+    id: string;
+    /** Human role name (also used in accessible cell labels, so a plain string). */
+    name: string;
+    /** Short hint under the role name (e.g. member count or scope). */
+    description?: string;
+    /** A locked role renders read-only cells even when the matrix is editable. */
+    locked?: boolean;
+};
+/** @see PermissionMatrix — one permission ROW. */
+export type PermissionMatrixPermissionProp = {
+    /** Stable permission id — the `permissionId` half of a grant key. */
+    id: string;
+    /** Human permission name (also used in accessible cell labels, so a plain string). */
+    name: string;
+    /** Secondary line under the permission name. */
+    description?: string;
+    /** Optional category caption rendered with the description (e.g. 請求 / レポート). */
+    group?: string;
+};
+/**
+ * @see PermissionMatrix — the grant relation. Either the `grantKey(roleId, permissionId)` `Set`
+ * from `@godxjp/ui/lib/permission-grid` (O(1), the canonical form) or a plain pair array, which the
+ * matrix normalizes through the same `grantKey` encoding.
+ */
+export type PermissionMatrixGrantsProp = ReadonlySet<string> | readonly {
+    roleId: string;
+    permissionId: string;
+}[];
+/** @see PermissionMatrix */
+export type PermissionMatrixProp = {
+    /** Role columns, in render order. */
+    roles: readonly PermissionMatrixRoleProp[];
+    /** Permission rows, in render order. */
+    permissions: readonly PermissionMatrixPermissionProp[];
+    /** The grant relation (see {@link PermissionMatrixGrantsProp}). */
+    grants: PermissionMatrixGrantsProp;
+    /**
+     * Grant toggle handler. Its PRESENCE makes the matrix editable (checkbox cells); omitted, the
+     * matrix is the canonical read-only ✓/— grid. Locked roles and `readOnly` stay read-only
+     * regardless.
+     */
+    onGrantChange?: (roleId: string, permissionId: string, granted: boolean) => void;
+    /** Force the read-only grid even when `onGrantChange` is present (e.g. viewer permission). */
+    readOnly?: boolean;
+    /** Two role ids to compare side by side; highlights their columns and the differing rows. */
+    compare?: readonly [string, string] | null;
+    /** With `compare`, keep only the rows on which the two roles differ (差分のみ). */
+    diffOnly?: boolean;
+    /** Accessible name for the grid. Defaults to the localized caption. */
+    label?: LabelProp;
+    /** Show the loading skeleton instead of the grid. Precedence: loading → denied → error → empty. */
+    loading?: boolean;
+    /** Custom empty content when `permissions` is empty; defaults to a localized EmptyState. */
+    empty?: React.ReactNode;
+    /** Failure state (mirrors DataTable #216): `true` = built-in localized message, node = replace. */
+    error?: React.ReactNode;
+    /** Permission-denied state — refused, not failed. Takes precedence over `error`. */
+    denied?: React.ReactNode;
+    /** Retry handler for the built-in `error` state; omit to hide the retry action. */
+    onRetry?: HandlerProp;
+    className?: ClassNameProp;
+    id?: IdProp;
+};

package/dist/props/components/data-entry.prop.d.ts

@@ -517,3 +517,57 @@ export type TransferProp = FieldA11yProps & {
     selectedKeys?: [string[], string[]];
     onSelectChange?: (sourceSelectedKeys: string[], targetSelectedKeys: string[]) => void;
 };
+/** @see BranchScopePicker — scope mode: every branch, or an explicit subset. */
+export type BranchScopeModeProp = "all" | "selected";
+/**
+ * @see BranchScopePicker — the picker value. `mode: "all"` ignores `branchIds`; `mode: "selected"`
+ * carries the checked branch ids.
+ */
+export type BranchScopeValueProp = {
+    mode: BranchScopeModeProp;
+    branchIds?: readonly string[];
+};
+/** @see BranchScopePicker — one selectable branch. Domain data is consumer-supplied. */
+export type BranchScopeOptionProp = {
+    /** Stable branch id. */
+    id: string;
+    /** Human branch name (also the search haystack, so a plain string). */
+    name: string;
+    /** Secondary line under the branch name (e.g. an address or code). */
+    description?: string;
+    /** Keep the branch visible but unselectable. */
+    disabled?: boolean;
+};
+/** @see BranchScopePicker */
+export type BranchScopePickerProp = FieldA11yProps & {
+    /** The selectable branches. */
+    branches: readonly BranchScopeOptionProp[];
+    /** Controlled value. */
+    value?: BranchScopeValueProp;
+    /** Uncontrolled initial value. Default `{ mode: "all" }`. */
+    defaultValue?: BranchScopeValueProp;
+    /** Value change handler (fires for mode switches AND branch checks). */
+    onValueChange?: (value: BranchScopeValueProp) => void;
+    /** Disable the whole control. */
+    disabled?: DisabledProp;
+    /** Render the current value without any editable affordance (locked view). */
+    readOnly?: boolean;
+    /** Show a branch search input above the list once there is anything to search. Default `true`. */
+    searchable?: boolean;
+    /** Validation message under the control (wired via `aria-errormessage`/`aria-invalid`). */
+    error?: ErrorProp;
+    /** Show the loading skeleton instead of the list. Precedence: loading → denied → listError → empty. */
+    loading?: boolean;
+    /** Custom empty content when `branches` is empty; defaults to a localized message. */
+    empty?: React.ReactNode;
+    /** Branch-collection READ failure (distinct from `error`, which is field validation). */
+    listError?: React.ReactNode;
+    /** Permission-denied state — the branch read was refused. Takes precedence over `listError`. */
+    denied?: React.ReactNode;
+    /** Radio labels override (localized defaults otherwise). */
+    allLabel?: React.ReactNode;
+    selectedLabel?: React.ReactNode;
+    name?: NameProp;
+    id?: IdProp;
+    className?: ClassNameProp;
+};

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

@@ -43,9 +43,9 @@ export type AlertProp = React.HTMLAttributes<HTMLDivElement> & {
     children?: ChildrenProp;
 };
 /**
- * @see Banner — page-level Alert. `variant` is fixed to `"banner"` by the alias, so it is the one
- * prop a Banner does not take; everything else (tone, icon, onDismiss, children) is Alert's
- * contract verbatim. gh#255.
+ * @see Banner — the full-bleed attention strip (`<Alert variant="banner">` with the variant fixed).
+ * Same contract as {@link AlertProp} minus `variant`: `tone` owns colour + live-region politeness,
+ * `icon`/`icon={false}` owns the leading glyph, `onDismiss` renders the built-in dismiss button.
  */
 export type BannerProp = Omit<AlertProp, "variant">;
 /** @see AlertTitle */

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

@@ -12,8 +12,15 @@ export type TextProp = Omit<React.HTMLAttributes<HTMLElement>, "color"> & {
     /** Weight (system 2-weight: 400/500). Default `regular`. */
     weight?: FontWeightProp;
     align?: TextAlignProp;
-    /** Single-line ellipsis. */
+    /** Single-line ellipsis. Mutually exclusive with `clamp` — when both are set, `clamp` wins. */
     truncate?: boolean;
+    /**
+     * Multi-line clamp — max rendered lines (integer ≥ 1); overflow ends in an ellipsis.
+     * Token-owned line-clamp styling (never write the `line-clamp-N` utility page-side).
+     * Visual-only: the full text stays in the DOM / accessible name. Mutually exclusive with
+     * `truncate` — when both are set, `clamp` wins (dev builds warn).
+     */
+    clamp?: number;
     /** Tabular figures for aligned numbers. */
     tabular?: boolean;
     /** Monospace family (codes, ids). */