@atscript/db 0.1.57 → 0.1.58

package/dist/{db-readable-CrNX04nI.d.mts → db-readable-CONS7NPu.d.mts}

@@ -213,8 +213,16 @@ interface TMetaResponse {
 }
 /** Where the action applies on the UI. */
 type TDbActionLevel = "table" | "row" | "rows";
-/** Semantic intent the UI maps to its own visual language (color, prominence). */
-type TDbActionIntent = "positive" | "negative" | "primary" | "secondary";
+/**
+ * Semantic intent the UI maps to its own visual language (color, prominence).
+ *
+ * Suggested visual prominence (most → least): `negative` > `warning` > `primary`
+ * > `positive` > `secondary`. Use `negative` for destructive ops (delete, purge),
+ * `warning` for risky-but-non-destructive ops (retry payment, force recompute,
+ * reset state), `primary` for the headline action, `positive` for benign
+ * confirmations (approve, publish), `secondary` for everything else.
+ */
+type TDbActionIntent = "positive" | "negative" | "warning" | "primary" | "secondary";
 /** How the UI client should handle the action when invoked. */
 type TDbActionProcessor = "backend" | "navigate" | "custom";
 /**
@@ -236,7 +244,43 @@ interface TDbActionInfo {
   description?: string;
   order?: number;
   default?: boolean;
-  promptText?: string;
+  /**
+   * Confirmation prompt copy. String form is shown verbatim. Tuple form is
+   * `[singular, plural]`: the UI picks `[0]` when the action will execute
+   * against a single PK (always for `'row'`-level; for `'rows'`-level when the
+   * current selection has exactly one PK) and `[1]` otherwise.
+   *
+   * Placeholder substitution is UI-resolved, not server-parsed. Conventional
+   * placeholders: `$1` for the single PK (singular form) and `$N` for the
+   * count (plural form), e.g. `['Delete order $1?', 'Delete $N orders?']`.
+   */
+  promptText?: string | [string, string];
+  /**
+   * Single-character keyboard shortcut hint. The server stores this verbatim
+   * — choice of modifier prefix (Alt+, Ctrl+, bare key) and activation scope
+   * (e.g. only when an actions dropdown is open) are UI/UX concerns. Conflict
+   * resolution between actions sharing the same key is also up to the UI;
+   * the server does no dedup.
+   */
+  shortcut?: string;
+  /**
+   * Stringified gate predicate (`fn.toString()`). Present only for `'row'`
+   * and `'rows'` level actions whose decorator declared a `disabled` function.
+   * The UI evaluates against a level-specific scope to grey-out / hide the
+   * button. The server has already enforced this predicate before the
+   * action's handler ran — the server is authoritative; this field is purely
+   * a UI hint.
+   */
+  disabled?: string;
+  /**
+   * Optional dev-supplied list of dot-notation paths over the row that the
+   * `disabled` predicate references. Plain `string[]` in v1 (a typed
+   * `PathOf<TRow>[]` upgrade is a documented follow-up). The UI unions these
+   * into `$select` across all actions on a table. When absent, the UI parses
+   * `disabled` itself. When present, the UI uses this list verbatim — the
+   * server does NOT auto-derive or merge.
+   */
+  requiredFields?: string[];
 }
 interface TDbInsertResult {
   insertedId: unknown;

package/dist/{db-readable-BCoBlULR.d.cts → db-readable-DN1CJRph.d.cts}

@@ -213,8 +213,16 @@ interface TMetaResponse {
 }
 /** Where the action applies on the UI. */
 type TDbActionLevel = "table" | "row" | "rows";
-/** Semantic intent the UI maps to its own visual language (color, prominence). */
-type TDbActionIntent = "positive" | "negative" | "primary" | "secondary";
+/**
+ * Semantic intent the UI maps to its own visual language (color, prominence).
+ *
+ * Suggested visual prominence (most → least): `negative` > `warning` > `primary`
+ * > `positive` > `secondary`. Use `negative` for destructive ops (delete, purge),
+ * `warning` for risky-but-non-destructive ops (retry payment, force recompute,
+ * reset state), `primary` for the headline action, `positive` for benign
+ * confirmations (approve, publish), `secondary` for everything else.
+ */
+type TDbActionIntent = "positive" | "negative" | "warning" | "primary" | "secondary";
 /** How the UI client should handle the action when invoked. */
 type TDbActionProcessor = "backend" | "navigate" | "custom";
 /**
@@ -236,7 +244,43 @@ interface TDbActionInfo {
   description?: string;
   order?: number;
   default?: boolean;
-  promptText?: string;
+  /**
+   * Confirmation prompt copy. String form is shown verbatim. Tuple form is
+   * `[singular, plural]`: the UI picks `[0]` when the action will execute
+   * against a single PK (always for `'row'`-level; for `'rows'`-level when the
+   * current selection has exactly one PK) and `[1]` otherwise.
+   *
+   * Placeholder substitution is UI-resolved, not server-parsed. Conventional
+   * placeholders: `$1` for the single PK (singular form) and `$N` for the
+   * count (plural form), e.g. `['Delete order $1?', 'Delete $N orders?']`.
+   */
+  promptText?: string | [string, string];
+  /**
+   * Single-character keyboard shortcut hint. The server stores this verbatim
+   * — choice of modifier prefix (Alt+, Ctrl+, bare key) and activation scope
+   * (e.g. only when an actions dropdown is open) are UI/UX concerns. Conflict
+   * resolution between actions sharing the same key is also up to the UI;
+   * the server does no dedup.
+   */
+  shortcut?: string;
+  /**
+   * Stringified gate predicate (`fn.toString()`). Present only for `'row'`
+   * and `'rows'` level actions whose decorator declared a `disabled` function.
+   * The UI evaluates against a level-specific scope to grey-out / hide the
+   * button. The server has already enforced this predicate before the
+   * action's handler ran — the server is authoritative; this field is purely
+   * a UI hint.
+   */
+  disabled?: string;
+  /**
+   * Optional dev-supplied list of dot-notation paths over the row that the
+   * `disabled` predicate references. Plain `string[]` in v1 (a typed
+   * `PathOf<TRow>[]` upgrade is a documented follow-up). The UI unions these
+   * into `$select` across all actions on a table. When absent, the UI parses
+   * `disabled` itself. When present, the UI uses this list verbatim — the
+   * server does NOT auto-derive or merge.
+   */
+  requiredFields?: string[];
 }
 interface TDbInsertResult {
   insertedId: unknown;

package/dist/{db-space-BvBklm9J.d.cts → db-space-D1dfFoKL.d.cts}

@@ -1,4 +1,4 @@
-import { H as TDbUpdateResult, K as TFkLookupResolver, L as TDbInsertManyResult, R as TDbInsertResult, ct as TableMetadata, j as TDbDeleteResult, o as BaseDbAdapter, rt as TWriteTableResolver, t as AtscriptDbReadable, tt as TTableResolver, ut as TGenericLogger, y as TCascadeResolver } from "./db-readable-BCoBlULR.cjs";
+import { H as TDbUpdateResult, K as TFkLookupResolver, L as TDbInsertManyResult, R as TDbInsertResult, ct as TableMetadata, j as TDbDeleteResult, o as BaseDbAdapter, rt as TWriteTableResolver, t as AtscriptDbReadable, tt as TTableResolver, ut as TGenericLogger, y as TCascadeResolver } from "./db-readable-DN1CJRph.cjs";
 import { FilterExpr } from "@uniqu/core";
 import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
 

package/dist/{db-space-CsgCjSMH.d.mts → db-space-DQU38dHk.d.mts}

@@ -1,4 +1,4 @@
-import { H as TDbUpdateResult, K as TFkLookupResolver, L as TDbInsertManyResult, R as TDbInsertResult, ct as TableMetadata, j as TDbDeleteResult, o as BaseDbAdapter, rt as TWriteTableResolver, t as AtscriptDbReadable, tt as TTableResolver, ut as TGenericLogger, y as TCascadeResolver } from "./db-readable-CrNX04nI.mjs";
+import { H as TDbUpdateResult, K as TFkLookupResolver, L as TDbInsertManyResult, R as TDbInsertResult, ct as TableMetadata, j as TDbDeleteResult, o as BaseDbAdapter, rt as TWriteTableResolver, t as AtscriptDbReadable, tt as TTableResolver, ut as TGenericLogger, y as TCascadeResolver } from "./db-readable-CONS7NPu.mjs";
 import { AtscriptQueryComparison, AtscriptQueryFieldRef, AtscriptQueryFieldRef as AtscriptQueryFieldRef$1, AtscriptQueryNode, AtscriptQueryNode as AtscriptQueryNode$1, AtscriptRef, FlatOf, NavPropsOf, OwnPropsOf, PrimaryKeyOf, TAtscriptAnnotatedType, TAtscriptDataType, Validator } from "@atscript/typescript/utils";
 import { FilterExpr } from "@uniqu/core";
 

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { $ as TSyncColumnResult, A as TDbDefaultValue, B as TDbRelation, C as TCrudPermissions, D as TDbActionProcessor, E as TDbActionLevel, F as TDbIndexField, G as TFieldMeta, H as TDbUpdateResult, I as TDbIndexType, J as TIdDescriptor, K as TFkLookupResolver, L as TDbInsertManyResult, M as TDbFieldMeta, N as TDbForeignKey, O as TDbCollation, P as TDbIndex, Q as TSearchIndexInfo, R as TDbInsertResult, S as TCrudOp, T as TDbActionIntent, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, X as TMetadataOverrides, Y as TMetaResponse, Z as TRelationInfo, _ as NavPropsOf, a as FieldMappingStrategy, at as Uniquery, b as TCascadeTarget, c as AggregateExpr, ct as TableMetadata, d as AggregateResult, dt as UniquSelect, et as TTableOptionDiff, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TypedWithRelation, j as TDbDeleteResult, k as TDbDefaultFn, l as AggregateFn, lt as NoopLogger, m as DbQuery, n as DbResponse, nt as TValueFormatterPair, o as BaseDbAdapter, ot as UniqueryControls, p as DbControls, q as TFkLookupTarget, r as resolveDesignType, rt as TWriteTableResolver, s as AggregateControls, st as WithRelation, t as AtscriptDbReadable, tt as TTableResolver, u as AggregateQuery, ut as TGenericLogger, v as OwnPropsOf, w as TDbActionInfo, x as TColumnDiff, y as TCascadeResolver, z as TDbReferentialAction } from "./db-readable-BCoBlULR.cjs";
+import { $ as TSyncColumnResult, A as TDbDefaultValue, B as TDbRelation, C as TCrudPermissions, D as TDbActionProcessor, E as TDbActionLevel, F as TDbIndexField, G as TFieldMeta, H as TDbUpdateResult, I as TDbIndexType, J as TIdDescriptor, K as TFkLookupResolver, L as TDbInsertManyResult, M as TDbFieldMeta, N as TDbForeignKey, O as TDbCollation, P as TDbIndex, Q as TSearchIndexInfo, R as TDbInsertResult, S as TCrudOp, T as TDbActionIntent, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, X as TMetadataOverrides, Y as TMetaResponse, Z as TRelationInfo, _ as NavPropsOf, a as FieldMappingStrategy, at as Uniquery, b as TCascadeTarget, c as AggregateExpr, ct as TableMetadata, d as AggregateResult, dt as UniquSelect, et as TTableOptionDiff, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TypedWithRelation, j as TDbDeleteResult, k as TDbDefaultFn, l as AggregateFn, lt as NoopLogger, m as DbQuery, n as DbResponse, nt as TValueFormatterPair, o as BaseDbAdapter, ot as UniqueryControls, p as DbControls, q as TFkLookupTarget, r as resolveDesignType, rt as TWriteTableResolver, s as AggregateControls, st as WithRelation, t as AtscriptDbReadable, tt as TTableResolver, u as AggregateQuery, ut as TGenericLogger, v as OwnPropsOf, w as TDbActionInfo, x as TColumnDiff, y as TCascadeResolver, z as TDbReferentialAction } from "./db-readable-DN1CJRph.cjs";
 import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-DXJ4Zw0P.cjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-BvBklm9J.cjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-D1dfFoKL.cjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DRGMCEn3.cjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-_z_A3cKa.cjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";

package/dist/index.d.mts

@@ -1,6 +1,6 @@
-import { $ as TSyncColumnResult, A as TDbDefaultValue, B as TDbRelation, C as TCrudPermissions, D as TDbActionProcessor, E as TDbActionLevel, F as TDbIndexField, G as TFieldMeta, H as TDbUpdateResult, I as TDbIndexType, J as TIdDescriptor, K as TFkLookupResolver, L as TDbInsertManyResult, M as TDbFieldMeta, N as TDbForeignKey, O as TDbCollation, P as TDbIndex, Q as TSearchIndexInfo, R as TDbInsertResult, S as TCrudOp, T as TDbActionIntent, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, X as TMetadataOverrides, Y as TMetaResponse, Z as TRelationInfo, _ as NavPropsOf, a as FieldMappingStrategy, at as Uniquery, b as TCascadeTarget, c as AggregateExpr, ct as TableMetadata, d as AggregateResult, dt as UniquSelect, et as TTableOptionDiff, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TypedWithRelation, j as TDbDeleteResult, k as TDbDefaultFn, l as AggregateFn, lt as NoopLogger, m as DbQuery, n as DbResponse, nt as TValueFormatterPair, o as BaseDbAdapter, ot as UniqueryControls, p as DbControls, q as TFkLookupTarget, r as resolveDesignType, rt as TWriteTableResolver, s as AggregateControls, st as WithRelation, t as AtscriptDbReadable, tt as TTableResolver, u as AggregateQuery, ut as TGenericLogger, v as OwnPropsOf, w as TDbActionInfo, x as TColumnDiff, y as TCascadeResolver, z as TDbReferentialAction } from "./db-readable-CrNX04nI.mjs";
+import { $ as TSyncColumnResult, A as TDbDefaultValue, B as TDbRelation, C as TCrudPermissions, D as TDbActionProcessor, E as TDbActionLevel, F as TDbIndexField, G as TFieldMeta, H as TDbUpdateResult, I as TDbIndexType, J as TIdDescriptor, K as TFkLookupResolver, L as TDbInsertManyResult, M as TDbFieldMeta, N as TDbForeignKey, O as TDbCollation, P as TDbIndex, Q as TSearchIndexInfo, R as TDbInsertResult, S as TCrudOp, T as TDbActionIntent, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, X as TMetadataOverrides, Y as TMetaResponse, Z as TRelationInfo, _ as NavPropsOf, a as FieldMappingStrategy, at as Uniquery, b as TCascadeTarget, c as AggregateExpr, ct as TableMetadata, d as AggregateResult, dt as UniquSelect, et as TTableOptionDiff, f as AtscriptDbWritable, g as FilterExpr, h as FieldOpsFor, i as DocumentFieldMapper, it as TypedWithRelation, j as TDbDeleteResult, k as TDbDefaultFn, l as AggregateFn, lt as NoopLogger, m as DbQuery, n as DbResponse, nt as TValueFormatterPair, o as BaseDbAdapter, ot as UniqueryControls, p as DbControls, q as TFkLookupTarget, r as resolveDesignType, rt as TWriteTableResolver, s as AggregateControls, st as WithRelation, t as AtscriptDbReadable, tt as TTableResolver, u as AggregateQuery, ut as TGenericLogger, v as OwnPropsOf, w as TDbActionInfo, x as TColumnDiff, y as TCascadeResolver, z as TDbReferentialAction } from "./db-readable-CONS7NPu.mjs";
 import { a as $remove, c as $upsert, d as getDbFieldOp, f as isDbFieldOp, i as $mul, l as TDbFieldOp, n as $inc, o as $replace, p as separateFieldOps, r as $insert, s as $update, t as $dec, u as TFieldOps } from "./ops-C61kelof.mjs";
-import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-CsgCjSMH.mjs";
+import { a as AtscriptQueryComparison, c as AtscriptRef, d as translateQueryTree, f as AtscriptDbTable, i as TViewColumnMapping, l as TViewJoin, m as NativeIntegrity, n as TAdapterFactory, o as AtscriptQueryFieldRef, p as IntegrityStrategy, r as AtscriptDbView, s as AtscriptQueryNode, t as DbSpace, u as TViewPlan } from "./db-space-DQU38dHk.mjs";
 import { n as createDbValidatorPlugin, t as DbValidationContext } from "./db-validator-plugin-DDvYyv5t.mjs";
 import { c as TArrayPatch, i as buildValidationContext, l as TDbPatch, n as ValidatorMode, o as forceNavNonOptional, r as buildDbValidator, s as isNavRelation, t as ValidationContext, u as getKeyProps } from "./validator-DttN2e5_.mjs";
 import { AggregateQuery as AggregateQuery$1, FilterExpr as FilterExpr$1, FilterVisitor, Uniquery as Uniquery$1, computeInsights, isPrimitive, walkFilter } from "@uniqu/core";

package/dist/rel.d.cts

@@ -1,4 +1,4 @@
-import { B as TDbRelation, N as TDbForeignKey, ct as TableMetadata, o as BaseDbAdapter, rt as TWriteTableResolver, tt as TTableResolver, ut as TGenericLogger } from "./db-readable-BCoBlULR.cjs";
+import { B as TDbRelation, N as TDbForeignKey, ct as TableMetadata, o as BaseDbAdapter, rt as TWriteTableResolver, tt as TTableResolver, ut as TGenericLogger } from "./db-readable-DN1CJRph.cjs";
 import { t as DbValidationContext } from "./db-validator-plugin-DRGMCEn3.cjs";
 import { FilterExpr, WithRelation } from "@uniqu/core";
 import { Validator } from "@atscript/typescript/utils";

package/dist/rel.d.mts

@@ -1,4 +1,4 @@
-import { B as TDbRelation, N as TDbForeignKey, ct as TableMetadata, o as BaseDbAdapter, rt as TWriteTableResolver, tt as TTableResolver, ut as TGenericLogger } from "./db-readable-CrNX04nI.mjs";
+import { B as TDbRelation, N as TDbForeignKey, ct as TableMetadata, o as BaseDbAdapter, rt as TWriteTableResolver, tt as TTableResolver, ut as TGenericLogger } from "./db-readable-CONS7NPu.mjs";
 import { t as DbValidationContext } from "./db-validator-plugin-DDvYyv5t.mjs";
 import { Validator } from "@atscript/typescript/utils";
 import { FilterExpr, WithRelation } from "@uniqu/core";

package/dist/sync.d.cts

@@ -1,5 +1,5 @@
-import { A as TDbDefaultValue, M as TDbFieldMeta, N as TDbForeignKey, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, et as TTableOptionDiff, t as AtscriptDbReadable, ut as TGenericLogger, x as TColumnDiff } from "./db-readable-BCoBlULR.cjs";
-import { r as AtscriptDbView, t as DbSpace } from "./db-space-BvBklm9J.cjs";
+import { A as TDbDefaultValue, M as TDbFieldMeta, N as TDbForeignKey, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, et as TTableOptionDiff, t as AtscriptDbReadable, ut as TGenericLogger, x as TColumnDiff } from "./db-readable-DN1CJRph.cjs";
+import { r as AtscriptDbView, t as DbSpace } from "./db-space-D1dfFoKL.cjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/dist/sync.d.mts

@@ -1,5 +1,5 @@
-import { A as TDbDefaultValue, M as TDbFieldMeta, N as TDbForeignKey, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, et as TTableOptionDiff, t as AtscriptDbReadable, ut as TGenericLogger, x as TColumnDiff } from "./db-readable-CrNX04nI.mjs";
-import { r as AtscriptDbView, t as DbSpace } from "./db-space-CsgCjSMH.mjs";
+import { A as TDbDefaultValue, M as TDbFieldMeta, N as TDbForeignKey, U as TExistingColumn, V as TDbStorageType, W as TExistingTableOption, et as TTableOptionDiff, t as AtscriptDbReadable, ut as TGenericLogger, x as TColumnDiff } from "./db-readable-CONS7NPu.mjs";
+import { r as AtscriptDbView, t as DbSpace } from "./db-space-DQU38dHk.mjs";
 import { TAtscriptAnnotatedType } from "@atscript/typescript/utils";
 
 //#region src/schema/sync-entry.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/db",
-  "version": "0.1.57",
+  "version": "0.1.58",
   "description": "Database adapter utilities for atscript.",
   "keywords": [
     "atscript",