@atscript/vue-table 0.1.143 → 0.1.145

package/dist/{types-D4dK49sA.d.cts → types-D1NxhrpW.d.cts}

@@ -5,6 +5,13 @@ import { FilterExpr, Uniquery } from "@uniqu/core";
 import { AsPresetEntryRow, AspectMask, ColumnWidthsMap, ConfigTab, DroppedFields, FieldFilters, PresetAspect, PresetCapabilities, PresetSnapshot, SelectionMode, SystemPreset, SystemPresetInput, TableStateMethods } from "@atscript/ui-table";
 
 //#region src/composables/state/intent-scope.d.ts
+/**
+ * Per-action verdict of a gate: `true` keeps the action as is, `false` drops
+ * it (hidden), a non-empty string keeps it DISABLED with that string as the
+ * reason (`""` counts as `true`).
+ */
+type ActionVerdict = boolean | string;
+type ActionGate = (a: TVueTableActionInfo) => ActionVerdict;
 interface ActionBuckets {
   default: TVueTableActionInfo | undefined;
   others: TVueTableActionInfo[];
@@ -29,25 +36,39 @@ declare function extractIdentifier(source: unknown, preferredId: readonly string
 /**
  * A {@link RowActionsConfig} compiled into the two passes a surface runs per
  * row. Built once per config change (not once per row per render), so the
- * `include` / `exclude` sets and the override lookups exist once.
+ * `include` / `exclude` sets, the override lookups and the app-owned action
+ * descriptors exist once. Surfaces call {@link resolveRowActions}, not this.
  */
 interface RowActionsPolicy {
   /**
-   * Narrow + relabel already backend-gated buckets. Callers run
-   * `applyRowGate` FIRST — that order is the whole safety story: `include`
-   * can only narrow what the server allowed for the row, and `overrides`
+   * Gate + narrow + relabel in ONE pass: the row's server verdict
+   * (`rowGate`, from `rowActionGate`) first, then `include` / `exclude`, then
+   * `overrides`. That order is the whole safety story: `include` can only
+   * narrow what the server allowed for the row, and `overrides`
    * (presentation only) cannot resurrect an action the server gated away.
-   * Returns the input reference when the policy touches nothing.
+   * Returns the input reference when nothing changes.
    */
-  apply: (buckets: ActionBuckets) => ActionBuckets;
+  apply: (buckets: ActionBuckets, rowGate?: ActionGate | null) => ActionBuckets;
   /**
    * The app-owned actions for `row`. `include` lists SERVER action names —
    * being listed in `extra` IS an app action's opt-in — so only `exclude` and
-   * the action's own `enabled(row)` apply here. Pass no row to skip the
+   * the action's own `enabled(row)` apply here: `false` hides it, a non-empty
+   * string keeps it disabled with that reason. Pass no row to skip the
    * per-row gate (a surface with no row in hand).
    */
   extra: (row?: Record<string, unknown>) => TVueTableActionInfo[];
 }
+/**
+ * The row actions a surface renders for `row` — the one shared per-row
+ * pipeline behind `<AsRowActions>`, the `<AsTableActions>` row level and the
+ * Enter / double-click main-action fallback: the row's server gate
+ * (`$actions` / `$disabledReasons`) and the root's `:row-actions` policy in a
+ * single pass, plus the policy's app-owned `extra` actions. Pass
+ * `withRows: false` to leave out the rows-level bucket.
+ */
+declare function resolveRowActions(state: ReactiveTableState, row: Record<string, unknown> | undefined, opts?: {
+  withRows?: boolean;
+}): ResolvedRowActions;
 //#endregion
 //#region src/types.d.ts
 /** UI-side sentinel for the synthesised row-delete processor. */
@@ -63,6 +84,17 @@ type RowActionsColumnPlacement = "first" | "last" | "merge-select";
  */
 type TVueTableActionInfo = Omit<TDbActionInfo, "processor"> & {
   processor: TDbActionProcessor | typeof REMOVE_PROCESSOR;
+  /**
+   * Set when the action is shown DISABLED for the targeted row(s): the
+   * reason the server's `disabled` predicate returned (row
+   * `$disabledReasons`), or a client-only action's `enabled(row)` string.
+   * Built-in surfaces render it greyed with `aria-disabled` and the reason,
+   * and never trigger it; a custom `button` / `menu-item` slot should render
+   * the reason too. Not to be confused with `TDbActionInfo.disabled` — the
+   * server predicate's source. Only on the gated copies a surface renders,
+   * never on `state.actions.*`. Since 0.1.144.
+   */
+  disabledReason?: string;
 };
 /** Per-call options for `state.actions.invoke`. */
 interface InvokeOpts {
@@ -104,8 +136,12 @@ interface LocalRowAction {
   href?: (row: Record<string, unknown>) => string;
   /** Local handler. Awaited; a rejection settles the action as an error result. */
   onInvoke?: (row: Record<string, unknown>, pk?: Record<string, unknown>) => void | Promise<void>;
-  /** Per-row gate. Returning `false` hides the action for that row. */
-  enabled?: (row: Record<string, unknown>) => boolean;
+  /**
+   * Per-row gate. `false` hides the action for that row; a non-empty string
+   * shows it disabled with that string as the reason (since 0.1.144).
+   * Anything else — `true`, `""` — enables it.
+   */
+  enabled?: (row: Record<string, unknown>) => boolean | string;
 }
 /**
  * Per-screen presentation policy for the row-actions cell. Narrows and
@@ -126,6 +162,23 @@ interface RowActionsConfig {
   /** App-owned actions appended after the server ones. */
   extra?: LocalRowAction[];
 }
+/**
+ * The row actions a surface renders for one row — see `resolveRowActions`.
+ * The server-declared buckets come back gated and policy-applied (hidden
+ * actions dropped, disabled ones as copies carrying `disabledReason`,
+ * `overrides` applied); `extra` holds the policy's app-owned actions. Since
+ * 0.1.144.
+ */
+interface ResolvedRowActions {
+  /** `state.actions.default.row`, if it survived the row's gate and the policy. */
+  default: TVueTableActionInfo | undefined;
+  /** `state.actions.others.row` (row-level, minus the default). */
+  others: TVueTableActionInfo[];
+  /** `state.actions.rows` — empty when resolved with `withRows: false`. */
+  rows: TVueTableActionInfo[];
+  /** `RowActionsConfig.extra`, gated by each one's `enabled(row)`. */
+  extra: TVueTableActionInfo[];
+}
 /** Discriminated result returned by `state.actions.invoke`. Never throws. */
 type ActionResult = {
   ok: true;
@@ -547,6 +600,26 @@ interface ReactiveTableState extends TableStateMethods {
   selectedCount: ComputedRef<number>;
   /** Extract unique value from a row for selection tracking. */
   rowValueFn: (row: Record<string, unknown>) => unknown;
+  /**
+   * Every loaded row (`windowCache`) keyed by its `rowValueFn` value.
+   * Computed lazily and memoised per cache instance, so resolving scalar
+   * selections costs one map build per fetch, not one per read. Since
+   * 0.1.144.
+   */
+  rowByValue: ComputedRef<ReadonlyMap<unknown, Record<string, unknown>>>;
+  /**
+   * The row behind a selection value: an object value IS the row; a scalar
+   * (a `rowValueFn` returning the PK) is looked up in {@link rowByValue} —
+   * `undefined` when that row is not loaded. Since 0.1.144.
+   */
+  rowOf: (value: unknown) => Record<string, unknown> | undefined;
+  /**
+   * The loaded rows of the current selection, in selection order — selected
+   * values whose row is not loaded are left out. The toolbar's bulk action
+   * gate reads the rows' `$actions` / `$disabledReasons` from here. Since
+   * 0.1.144.
+   */
+  selectedRowObjects: ComputedRef<Record<string, unknown>[]>;
   /**
    * Map a navigate action's interpolated href before it is used as an
    * anchor's `href` attribute or a mod/middle-click `window.open` target —
@@ -575,7 +648,9 @@ interface ReactiveTableState extends TableStateMethods {
    * `<AsTable>` / `<AsWindowTable>` flip this on whenever their
    * `:row-actions-column` prop is non-`false` AND the table has at least one
    * row/rows-level action. When on, `buildTableQuery` requests per-row
-   * `$actions: string[]` so the dropdown can hide server-disabled actions.
+   * `$actions: string[]` (plus `$disabledReasons` from servers that give
+   * reasons) so the action surfaces hide server-disabled actions — or show
+   * them disabled with the reason, when the server gave one.
    */
   includeActions: Ref<boolean>;
   /**
@@ -937,4 +1012,4 @@ interface PresetSurface {
   lastError: Ref<Error | null>;
 }
 //#endregion
-export { extractIdentifier as A, SelectAllState as C, TVueTableActionInfo as D, TAsTableControls as E, TableActionsState as O, RowSelectableVerdict as S, TAsCellTypeComponents as T, RowAttrsHook as _, ConfirmOptions as a, RowHookContext as b, InvokeOpts as c, NavKeyOptions as d, PresetConfig as f, RowActionsConfig as g, RowActionsColumnPlacement as h, ConfigTab as i, TableNavBridge as k, LocalRowAction as l, ReactiveTableState as m, ApplyUrlQueryOptions as n, DroppedFieldsReport as o, QueryErrorKind as p, ColumnMenuConfig as r, EnterAction as s, ActionResult as t, MainActionRequest as u, RowClassHook as v, SelectOn as w, RowSelectableHook as x, RowDeleteOpt as y };
+export { TableNavBridge as A, RowSelectableVerdict as C, TAsTableControls as D, TAsCellTypeComponents as E, extractIdentifier as M, TVueTableActionInfo as O, RowSelectableHook as S, SelectOn as T, RowActionsConfig as _, ConfirmOptions as a, RowDeleteOpt as b, InvokeOpts as c, NavKeyOptions as d, PresetConfig as f, RowActionsColumnPlacement as g, ResolvedRowActions as h, ConfigTab as i, resolveRowActions as j, TableActionsState as k, LocalRowAction as l, ReactiveTableState as m, ApplyUrlQueryOptions as n, DroppedFieldsReport as o, QueryErrorKind as p, ColumnMenuConfig as r, EnterAction as s, ActionResult as t, MainActionRequest as u, RowAttrsHook as v, SelectAllState as w, RowHookContext as x, RowClassHook as y };

package/dist/{use-table-DlqGHjPh.mjs → use-table-BTsNGBVx.mjs}

@@ -1,4 +1,4 @@
-import { l as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-Cq-3tbVr.mjs";
+import { l as DEFAULT_AVAILABLE_ASPECTS, n as createTableState, r as provideTableContext } from "./use-table-state-DuY-Mf8e.mjs";
 import { n as useTableSelection } from "./use-table-selection-ULbKT2xW.mjs";
 import { createTableDef, getMetaEntry, resetMetaCache } from "@atscript/ui";
 import { computed, inject, isRef, ref, shallowRef, toValue, watch } from "vue";

package/dist/{use-table-yZNJTfRq.cjs → use-table-W0KmaJ6L.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-BiklfjP0.cjs");
+const require_use_table_state = require("./use-table-state-Ddr2UZzB.cjs");
 const require_use_table_selection = require("./use-table-selection-DtCV3rhu.cjs");
 let _atscript_ui = require("@atscript/ui");
 let vue = require("vue");

package/dist/{use-table-column-handlers-0myVzrZR.mjs → use-table-column-handlers-BitvioH4.mjs}

@@ -1,4 +1,4 @@
-import { A as ROW_ACTIONS_PATH, j as ROW_ACTIONS_TYPE } from "./use-table-state-Cq-3tbVr.mjs";
+import { F as ROW_ACTIONS_TYPE, P as ROW_ACTIONS_PATH } from "./use-table-state-DuY-Mf8e.mjs";
 import { computed, watch } from "vue";
 import { reorderColumnNames } from "@atscript/ui-table";
 //#region src/composables/use-row-actions-column.ts

package/dist/{use-table-column-handlers-BHMCo_HR.cjs → use-table-column-handlers-DksXpbON.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-BiklfjP0.cjs");
+const require_use_table_state = require("./use-table-state-Ddr2UZzB.cjs");
 let vue = require("vue");
 let _atscript_ui_table = require("@atscript/ui-table");
 //#region src/composables/use-row-actions-column.ts

package/dist/{use-table-component-IziAm0vk.cjs → use-table-component-BvAC82_c.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-BiklfjP0.cjs");
+const require_use_table_state = require("./use-table-state-Ddr2UZzB.cjs");
 //#region src/composables/use-table-component.ts
 /**
 * Resolve a single skin-slot component from the injected `controls` map,

package/dist/{use-table-component-TLwFq4rx.mjs → use-table-component-DRMXTk9M.mjs}

@@ -1,4 +1,4 @@
-import { o as useTableContextOptional } from "./use-table-state-Cq-3tbVr.mjs";
+import { o as useTableContextOptional } from "./use-table-state-DuY-Mf8e.mjs";
 //#region src/composables/use-table-component.ts
 /**
 * Resolve a single skin-slot component from the injected `controls` map,

package/dist/{use-table-nav-bridge-CkQqimdS.mjs → use-table-nav-bridge-Bw0NFDSf.mjs}

@@ -1,4 +1,4 @@
-import { o as useTableContextOptional } from "./use-table-state-Cq-3tbVr.mjs";
+import { o as useTableContextOptional } from "./use-table-state-DuY-Mf8e.mjs";
 //#region src/composables/use-table-nav-bridge.ts
 function isPassthroughKey(event) {
 	const key = event.key;

package/dist/{use-table-nav-bridge-QU4jKhqx.cjs → use-table-nav-bridge-CPI1tql6.cjs}

@@ -1,4 +1,4 @@
-const require_use_table_state = require("./use-table-state-BiklfjP0.cjs");
+const require_use_table_state = require("./use-table-state-Ddr2UZzB.cjs");
 //#region src/composables/use-table-nav-bridge.ts
 function isPassthroughKey(event) {
 	const key = event.key;