@ai-matrx/records-ui 0.93.142 → 0.93.153

package/dist/{objectActions-BSbblgf-.d.ts → objectActions-Dgdr0E4b.d.ts}

@@ -42,12 +42,18 @@ declare function whatYouMayDoWithTable(table: Table | null | undefined, level: P
 
 /**
  * A Lucide icon NAME, kebab-case — the same currency `Table.icon` already uses.
- * Closed on purpose: each renderer maps every member to its own component, and a
+ * Closed on purpose: each renderer maps every member to its own glyph, and a
  * new member fails that renderer's typecheck until it is mapped.
  */
 type ObjectActionIcon = "folder-open" | "external-link" | "link" | "pencil" | "copy" | "folder-input" | "star" | "star-off" | "share-2" | "download" | "upload" | "columns-3" | "settings" | "history" | "blocks" | "file-text" | "calendar-clock" | "list-checks" | "bell" | "door-open" | "inbox" | "layout-dashboard" | "archive-restore" | "archive" | "link-2" | "layout-grid";
 /** The groups, in their one order. Separators fall out of group boundaries. */
 type ObjectActionGroup = "open" | "organize" | "share" | "manage" | "built-on" | "danger";
+/**
+ * THE STANDARD VERBS every object's menu shares — what the icon strip draws. One
+ * per meaning; an object maps its action onto the verb, never a second "share".
+ */
+type StandardVerbId = "open" | "open-new-tab" | "copy-link" | "rename" | "duplicate" | "move" | "favorite" | "share" | "export" | "import" | "settings" | "history" | "archive";
+declare const STANDARD_VERBS: readonly StandardVerbId[];
 interface ObjectActionGroupDef {
     id: ObjectActionGroup;
     /** Present only on a group that renders as a submenu. */
@@ -64,6 +70,10 @@ interface ObjectAction {
     label: string;
     icon: ObjectActionIcon;
     group: ObjectActionGroup;
+    /** The standard verb this action IS (a strip icon). Absent = a feature row. */
+    verb?: StandardVerbId;
+    /** A feature row's place among the rows, 1 first. Ignored when `verb` is set. */
+    rank?: number;
     /** Display-only hint ("⌘D"). */
     shortcut?: string;
     destructive?: boolean;
@@ -101,14 +111,26 @@ interface TableActionHost {
     addColumn?: Handler;
     settings?: Handler;
     history?: Handler;
+    /** Make the layout on screen the table's default. Leave out when it already is. */
+    makeDefault?: Handler;
+    /** The layout on screen, for "Make Kanban the default". */
+    layoutLabel?: string;
     /** The "Built on it" destinations, one handler for all eight. */
     openBuiltOn?: (destination: BuiltOnDestination, table: TableActionSubject) => void;
     archive?: Handler;
     /**
-     * ANOTHER LANE'S ENTRIES ("Link a record…", a hub tile's verbs). Return the
-     * same ids whatever `rights` say — express rights as `disabledReason`. Each
-     * entry lands at the END of its named group, in the order returned; `danger`
-     * is refused (Archive is always last) and so is an id already in the list.
+     * Why an action whose handler is left out is unavailable here, by action id
+     * (≤ 60 chars) — e.g. `make-default: "Already the default"`. Unnamed ids say
+     * "Not available here". Never used when rights already refuse.
+     */
+    unavailableReasons?: Readonly<Record<string, string>>;
+    /**
+     * ANOTHER LANE'S ENTRIES ("Link a record…", a hub tile's verbs, a feature's own
+     * row such as "When a row changes, run an agent…"). Return the same ids whatever
+     * `rights` say — express rights as `disabledReason`. Each entry lands at the END
+     * of its named group, in the order returned. Refused, loudly: the `danger` group
+     * (Archive is always last), a group that does not exist, and an id already in
+     * the list.
      */
     extend?: (table: TableActionSubject, rights: WhatYouMayDo) => readonly ObjectAction[];
 }
@@ -127,14 +149,15 @@ declare const ACTION_PLATFORM_TABLE_REASON = "Platform tables can't be changed h
 /** Why `rights` refuse `what`, in one short line — or null when they allow it. */
 declare function rightsReason(rights: WhatYouMayDo, what: Capability, table?: TableActionSubject): string | null;
 /**
- * THE TABLE'S ACTIONS, in the one order. Same ids, same order, for every seat
- * and every host — only `disabledReason` varies.
+ * THE TABLE'S ACTIONS, in the one order. Same ids, same order, same verbs and
+ * ranks, for every seat and every host — only `disabledReason` varies.
  */
 declare function tableActions(input: TableActionsInput): ObjectAction[];
 /**
  * Another lane's entries, placed deterministically: each at the end of its
- * group, in the order given. Loud on the two mistakes that would break the
- * invariants — a `danger` entry (Archive must stay last) and a duplicate id.
+ * group, in the order given. Loud on every mistake that would break the
+ * invariants — a `danger` entry (Archive must stay last), a group that does not
+ * exist (it would be dropped by every renderer) and a duplicate id.
  */
 declare function withExtensions(base: readonly ObjectAction[], extra: readonly ObjectAction[]): ObjectAction[];
 /** A run of actions that renders together: a plain section, or one submenu. */
@@ -162,7 +185,25 @@ type ObjectActionDropdownEntry = {
     actions: ObjectAction[];
 };
 declare function toDropdownEntries(actions: readonly ObjectAction[]): ObjectActionDropdownEntry[];
-/** The action ids a dropdown draws, in order — what G1 compares. */
+/** The actions a dropdown draws, in order — what G1 compares. */
+declare function dropdownActions(entries: readonly ObjectActionDropdownEntry[]): ObjectAction[];
+/** The action ids a dropdown draws, in order. */
 declare function dropdownActionIds(entries: readonly ObjectActionDropdownEntry[]): string[];
+/** The icon-strip menu: standard verbs as icons, then the first feature rows, then the rest. */
+interface StripAndRows {
+    /** Every action with a `verb`, in the list's order. */
+    strip: ObjectAction[];
+    /** The first `rowCount` feature actions by rank (ties keep list order). */
+    rows: ObjectAction[];
+    /** The remaining feature actions, behind "More … options", same ordering. */
+    more: ObjectAction[];
+}
+declare const STRIP_FEATURE_ROWS = 4;
+/**
+ * THE STRIP RENDERER'S SPLIT of the same list. Nothing is added or dropped: every
+ * id lands in exactly one of strip / rows / more (G1). Unranked feature actions
+ * (an extension that gave none) follow every ranked one.
+ */
+declare function toStripAndRows(actions: readonly ObjectAction[], rowCount?: number): StripAndRows;
 
-export { ACTION_CHECKING_ACCESS_REASON as A, type BuiltOnDestination as B, type Capability as C, DEFAULT_ACTION_ORIGIN as D, KERNEL_REASON as K, LEVEL_WORD as L, NOT_ANSWERED_YET as N, type ObjectAction as O, type TableActionHost as T, type WhatYouMayDo as W, ACTION_NOT_HERE_REASON as a, ACTION_NO_ACCESS_REASON as b, ACTION_PLATFORM_TABLE_REASON as c, OBJECT_ACTION_GROUPS as d, type ObjectActionDropdownEntry as e, type ObjectActionGroup as f, type ObjectActionGroupDef as g, type ObjectActionIcon as h, type ObjectActionSection as i, type TableActionSubject as j, type TableActionsInput as k, dropdownActionIds as l, groupObjectActions as m, levelNeededFor as n, tableLink as o, toDropdownEntries as p, whatYouMayDoWithTable as q, rightsReason as r, withExtensions as s, tableActions as t, whatYouMayDo as w };
+export { ACTION_CHECKING_ACCESS_REASON as A, type BuiltOnDestination as B, type Capability as C, DEFAULT_ACTION_ORIGIN as D, KERNEL_REASON as K, LEVEL_WORD as L, NOT_ANSWERED_YET as N, type ObjectAction as O, STANDARD_VERBS as S, type TableActionHost as T, type WhatYouMayDo as W, type ObjectActionIcon as a, ACTION_NOT_HERE_REASON as b, ACTION_NO_ACCESS_REASON as c, ACTION_PLATFORM_TABLE_REASON as d, OBJECT_ACTION_GROUPS as e, type ObjectActionDropdownEntry as f, type ObjectActionGroup as g, type ObjectActionGroupDef as h, type ObjectActionSection as i, STRIP_FEATURE_ROWS as j, type StandardVerbId as k, type StripAndRows as l, type TableActionSubject as m, type TableActionsInput as n, dropdownActionIds as o, dropdownActions as p, groupObjectActions as q, levelNeededFor as r, rightsReason as s, tableActions as t, tableLink as u, toDropdownEntries as v, toStripAndRows as w, whatYouMayDo as x, whatYouMayDoWithTable as y, withExtensions as z };