@ai-matrx/records-ui 0.101.21 → 0.101.23

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, KeyboardEvent, ReactElement, ComponentType, RefObject, SVGAttributes } from 'react';
 import * as _ai_matrx_records from '@ai-matrx/records';
-import { RecordScopeContext, EnrichCell, RecordsError, Field, TableDecorations, Uuid as Uuid$1, RowAction, RecordDocument, Table, ReadRow, StoreFilter, RecordRead, PermissionLevel, AggregateFilter, RelationDisplay, WriteConflict, RecordsErrorCode, RecordFilter, RuleExpression, RecordsResult, SavedViewRow, ImportRun, DeclarableFieldKind, NewerFieldKind, ParityFieldType, NewFieldDeclaration, ChoiceRehome, FieldOptionEdit, StoredRecord, ChoiceNudge, HiddenFieldNotice, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkApprovalState, WorkInboxKind, FieldKind, ArchiveLane, ArchivedRow, WorkInboxView, WorkInboxItem, PortalAccent, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, PublicPicture, PortalStyle, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, TableDuplicated, HistoryActor, FieldHistoryEntry, DrillDefinition, DrillSource, TableDuplicateProgress, TableArchiveProgress } from '@ai-matrx/records';
+import { RecordScopeContext, EnrichCell, RecordsError, Field, TableDecorations, Uuid as Uuid$1, RowAction, RecordDocument, Table, ReadRow, StoreFilter, RecordRead, PermissionLevel, AggregateFilter, RelationDisplay, WriteConflict, RecordsErrorCode, RecordFilter, RuleExpression, RecordsResult, SavedViewRow, ImportRun, DeclarableFieldKind, NewerFieldKind, ParityFieldType, NewFieldDeclaration, ChoiceRehome, FieldOptionEdit, StoredRecord, ChoiceNudge, HiddenFieldNotice, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkApprovalState, WorkInboxKind, FieldKind, ArchiveLane, ArchivedRow, WorkInboxView, WorkInboxItem, PortalAccent, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, PublicPicture, PortalStyle, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, AggregateGroupValue, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, TableDuplicated, HistoryActor, FieldHistoryEntry, DrillDefinition, DrillSource, TableDuplicateProgress, TableArchiveProgress } from '@ai-matrx/records';
 import { ReversibleAnnouncement } from '@ai-matrx/kit/reversible';
 import { W as WhatYouMayDo, T as TableActionHost, O as ObjectAction, a as ObjectActionIcon } from './objectActions-XkhxU-DP.cjs';
 export { A as ACTION_CHECKING_ACCESS_REASON, b as ACTION_NOT_HERE_REASON, c as ACTION_NO_ACCESS_REASON, d as ACTION_PLATFORM_TABLE_REASON, B as BuiltOnDestination, C as Capability, D as DEFAULT_ACTION_ORIGIN, K as KERNEL_REASON, L as LEVEL_WORD, N as NOT_ANSWERED_YET, e as OBJECT_ACTION_GROUPS, f as ObjectActionDropdownEntry, g as ObjectActionGroup, h as ObjectActionGroupDef, i as ObjectActionSection, S as STANDARD_VERBS, j as STRIP_FEATURE_ROWS, k as StandardVerbId, l as StripAndRows, m as TableActionSubject, n as TableActionsInput, o as dropdownActionIds, p as dropdownActions, q as groupObjectActions, r as levelNeededFor, s as rightsReason, t as tableActions, u as tableLink, v as toDropdownEntries, w as toStripAndRows, x as whatYouMayDo, y as whatYouMayDoWithTable, z as withExtensions } from './objectActions-XkhxU-DP.cjs';
@@ -4956,7 +4956,7 @@ declare const SERIES_COLORS: readonly ["hsl(var(--primary))", "hsl(var(--info))"
  */
 type GroupNamer = (key: string, value: string) => string | null | undefined;
 /** The label one aggregate row carries — its groups, joined the way a person reads them. */
-declare function groupLabel(groups: Record<string, string | null>, named?: GroupNamer): string;
+declare function groupLabel(groups: Record<string, AggregateGroupValue>, named?: GroupNamer): string;
 
 /** The same shape `components/ui/chart.tsx` takes: one entry per series key. */
 type ChartConfig = Record<string, {
@@ -6346,14 +6346,30 @@ interface EntitySourceState {
     total: number;
     loading: boolean;
     error: string | null;
+    /**
+     * The door adds rows here: the token's API facts say `create_via: "insert"` (task, project) —
+     * `drill_describe(...).api.create_via` — and the row's name column is one it writes.
+     */
+    creatable: boolean;
     /** Change one column of one row by its words (a choice by its name); re-reads on success. */
     write: (rowId: string, apiName: string, value: unknown) => Promise<string | null>;
+    /**
+     * Add one row through the same write door (`custom.entity_row_write` with no record id, as the
+     * person, into the client's organization); re-reads on success. Its id, or the door's refusal.
+     */
+    create: (columns: Record<string, unknown>) => Promise<{
+        id: string;
+    } | {
+        refused: string;
+    }>;
     reload: () => void;
 }
 /** A standard source's presented columns and one page of its rows, read as the person. */
 declare function useEntitySource(token: string, options?: {
     limit?: number;
 }): EntitySourceState;
+/** The column that names a row: the door's first of name / display_name / title / subject, else its first text column. */
+declare function entityNameColumn(columns: readonly EntityColumn[]): EntityColumn | null;
 /** The columns of the one table, from the door's presented columns. */
 declare function entityTableColumns(columns: readonly EntityColumn[]): MatrxColumnDef$1<EntityRow>[];
 /** A standard source in the one table. */
@@ -6368,8 +6384,8 @@ type EntitySource = {
     kind: "entity";
     token: string;
 };
-/** The column that names a row: the door's first of name / display_name / title, else its first text column. */
-declare function entityTitleColumn(columns: readonly EntityColumn[]): EntityColumn | null;
+/** The column that names a row (the door's first of name / display_name / title / subject, else its first text column). */
+declare const entityTitleColumn: typeof entityNameColumn;
 /** The choice columns a board can be grouped by (a deal's Stage, a task's Status). */
 declare function entityChoiceColumns(columns: readonly EntityColumn[]): EntityColumn[];
 interface EntityBoardProps {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode, KeyboardEvent, ReactElement, ComponentType, RefObject, SVGAttributes } from 'react';
 import * as _ai_matrx_records from '@ai-matrx/records';
-import { RecordScopeContext, EnrichCell, RecordsError, Field, TableDecorations, Uuid as Uuid$1, RowAction, RecordDocument, Table, ReadRow, StoreFilter, RecordRead, PermissionLevel, AggregateFilter, RelationDisplay, WriteConflict, RecordsErrorCode, RecordFilter, RuleExpression, RecordsResult, SavedViewRow, ImportRun, DeclarableFieldKind, NewerFieldKind, ParityFieldType, NewFieldDeclaration, ChoiceRehome, FieldOptionEdit, StoredRecord, ChoiceNudge, HiddenFieldNotice, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkApprovalState, WorkInboxKind, FieldKind, ArchiveLane, ArchivedRow, WorkInboxView, WorkInboxItem, PortalAccent, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, PublicPicture, PortalStyle, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, TableDuplicated, HistoryActor, FieldHistoryEntry, DrillDefinition, DrillSource, TableDuplicateProgress, TableArchiveProgress } from '@ai-matrx/records';
+import { RecordScopeContext, EnrichCell, RecordsError, Field, TableDecorations, Uuid as Uuid$1, RowAction, RecordDocument, Table, ReadRow, StoreFilter, RecordRead, PermissionLevel, AggregateFilter, RelationDisplay, WriteConflict, RecordsErrorCode, RecordFilter, RuleExpression, RecordsResult, SavedViewRow, ImportRun, DeclarableFieldKind, NewerFieldKind, ParityFieldType, NewFieldDeclaration, ChoiceRehome, FieldOptionEdit, StoredRecord, ChoiceNudge, HiddenFieldNotice, ValueEnvelope, ChecklistRequirementKind, ContextPolicy, WorkDueState, FieldSensitivity, StageRuleOnFail, SubscriptionCadence, WorkApprovalState, WorkInboxKind, FieldKind, ArchiveLane, ArchivedRow, WorkInboxView, WorkInboxItem, PortalAccent, FormSummary, PortalCard, PortalPrincipal, PortalPreviewRow, PublicPicture, PortalStyle, MySubscription, DashboardBlockKind, AggregateBucket, AggregateMeasure, AggregateCompare, DashboardTarget, DashboardBlock, DashboardSummary, AggregateGroupValue, DocTemplateRow, DocRenderRow, QuietHours, DashboardBlockResult, ChecklistRunStep, BookingSummary, CaptureSheetFace, CaptureField, AnonTokenBinding, RecordsConfig, RecordsActor, RecordsDataSource, TableDuplicated, HistoryActor, FieldHistoryEntry, DrillDefinition, DrillSource, TableDuplicateProgress, TableArchiveProgress } from '@ai-matrx/records';
 import { ReversibleAnnouncement } from '@ai-matrx/kit/reversible';
 import { W as WhatYouMayDo, T as TableActionHost, O as ObjectAction, a as ObjectActionIcon } from './objectActions-XkhxU-DP.js';
 export { A as ACTION_CHECKING_ACCESS_REASON, b as ACTION_NOT_HERE_REASON, c as ACTION_NO_ACCESS_REASON, d as ACTION_PLATFORM_TABLE_REASON, B as BuiltOnDestination, C as Capability, D as DEFAULT_ACTION_ORIGIN, K as KERNEL_REASON, L as LEVEL_WORD, N as NOT_ANSWERED_YET, e as OBJECT_ACTION_GROUPS, f as ObjectActionDropdownEntry, g as ObjectActionGroup, h as ObjectActionGroupDef, i as ObjectActionSection, S as STANDARD_VERBS, j as STRIP_FEATURE_ROWS, k as StandardVerbId, l as StripAndRows, m as TableActionSubject, n as TableActionsInput, o as dropdownActionIds, p as dropdownActions, q as groupObjectActions, r as levelNeededFor, s as rightsReason, t as tableActions, u as tableLink, v as toDropdownEntries, w as toStripAndRows, x as whatYouMayDo, y as whatYouMayDoWithTable, z as withExtensions } from './objectActions-XkhxU-DP.js';
@@ -4956,7 +4956,7 @@ declare const SERIES_COLORS: readonly ["hsl(var(--primary))", "hsl(var(--info))"
  */
 type GroupNamer = (key: string, value: string) => string | null | undefined;
 /** The label one aggregate row carries — its groups, joined the way a person reads them. */
-declare function groupLabel(groups: Record<string, string | null>, named?: GroupNamer): string;
+declare function groupLabel(groups: Record<string, AggregateGroupValue>, named?: GroupNamer): string;
 
 /** The same shape `components/ui/chart.tsx` takes: one entry per series key. */
 type ChartConfig = Record<string, {
@@ -6346,14 +6346,30 @@ interface EntitySourceState {
     total: number;
     loading: boolean;
     error: string | null;
+    /**
+     * The door adds rows here: the token's API facts say `create_via: "insert"` (task, project) —
+     * `drill_describe(...).api.create_via` — and the row's name column is one it writes.
+     */
+    creatable: boolean;
     /** Change one column of one row by its words (a choice by its name); re-reads on success. */
     write: (rowId: string, apiName: string, value: unknown) => Promise<string | null>;
+    /**
+     * Add one row through the same write door (`custom.entity_row_write` with no record id, as the
+     * person, into the client's organization); re-reads on success. Its id, or the door's refusal.
+     */
+    create: (columns: Record<string, unknown>) => Promise<{
+        id: string;
+    } | {
+        refused: string;
+    }>;
     reload: () => void;
 }
 /** A standard source's presented columns and one page of its rows, read as the person. */
 declare function useEntitySource(token: string, options?: {
     limit?: number;
 }): EntitySourceState;
+/** The column that names a row: the door's first of name / display_name / title / subject, else its first text column. */
+declare function entityNameColumn(columns: readonly EntityColumn[]): EntityColumn | null;
 /** The columns of the one table, from the door's presented columns. */
 declare function entityTableColumns(columns: readonly EntityColumn[]): MatrxColumnDef$1<EntityRow>[];
 /** A standard source in the one table. */
@@ -6368,8 +6384,8 @@ type EntitySource = {
     kind: "entity";
     token: string;
 };
-/** The column that names a row: the door's first of name / display_name / title, else its first text column. */
-declare function entityTitleColumn(columns: readonly EntityColumn[]): EntityColumn | null;
+/** The column that names a row (the door's first of name / display_name / title / subject, else its first text column). */
+declare const entityTitleColumn: typeof entityNameColumn;
 /** The choice columns a board can be grouped by (a deal's Stage, a task's Status). */
 declare function entityChoiceColumns(columns: readonly EntityColumn[]): EntityColumn[];
 interface EntityBoardProps {

package/dist/index.js

@@ -12522,6 +12522,9 @@ function storedValueAgrees(field2, stored, written, options) {
   }
   return JSON.stringify(stored) === JSON.stringify(written);
 }
+function refusalsBeyondTheHeader(refusals, headerRowId) {
+  return headerRowId === void 0 ? [...refusals] : refusals.filter((r) => r.rowId !== headerRowId);
+}
 function columnsTheGridTurnedAway(turnedAway, columnKeys, columnName, already) {
   const said = /* @__PURE__ */ new Map();
   for (const refused of turnedAway) {
@@ -14452,7 +14455,8 @@ function useDrillAnswers(args) {
               const groups = {};
               for (const ref of request.by) {
                 const k = ref === time && t ? t.key : ref;
-                groups[ref] = row.groups[k] ?? null;
+                const g = row.groups[k];
+                groups[ref] = g === null || g === void 0 ? null : String(g);
               }
               return {
                 groups,
@@ -21479,7 +21483,12 @@ function GridBody({
         ...headed ? { header: { unmatched: headed.unmatched } } : {}
       });
       built.refusals.push(
-        ...columnsTheGridTurnedAway(sheetPlan.refusals, columnKeys, (id) => columnLabel(fieldList, id), built.refusals)
+        ...columnsTheGridTurnedAway(
+          refusalsBeyondTheHeader(sheetPlan.refusals, headed ? touched[0] : void 0),
+          columnKeys,
+          (id) => columnLabel(fieldList, id),
+          built.refusals
+        )
       );
       if (merged && built.cells > 0 && built.creates === 0 && built.refusals.length === 0 && built.pastRightEdge === 0 && (built.header?.unmatched.length ?? 0) === 0 && built.unmatchedOptions.length === 0) {
         const outcome = await pasteAtOnce.current(built);
@@ -22985,7 +22994,8 @@ function useEntitySource(token, options = {}) {
     rows: [],
     total: 0,
     loading: true,
-    error: null
+    error: null,
+    creatable: false
   });
   useEffect48(() => {
     let cancelled = false;
@@ -23004,7 +23014,8 @@ function useEntitySource(token, options = {}) {
           rows: page.data.rows ?? [],
           total: Number(page.data.total ?? 0),
           loading: false,
-          error: null
+          error: null,
+          creatable: api?.create_via === "insert" && !!entityNameColumn(api?.columns ?? [])?.writable
         });
       },
       (thrown) => {
@@ -23031,7 +23042,24 @@ function useEntitySource(token, options = {}) {
     },
     [client, token, state.rows]
   );
-  return { ...state, write, reload };
+  const create = useCallback26(
+    async (columns) => {
+      const done = await client.entityRowWrite({ token, record_id: null, columns });
+      if (!done.ok) return { refused: refusalSentence(done.error) || "That row was not added." };
+      setTick((t) => t + 1);
+      return { id: String(done.data.id) };
+    },
+    [client, token]
+  );
+  return { ...state, write, create, reload };
+}
+var NAME_KEYS = ["name", "display_name", "title", "subject"];
+function entityNameColumn(columns) {
+  for (const key of NAME_KEYS) {
+    const hit = columns.find((c) => c.api_name === key);
+    if (hit) return hit;
+  }
+  return columns.find((c) => c.type === "text" && !c.lookup) ?? columns[0] ?? null;
 }
 function entityTableColumns(columns) {
   return columns.map((c) => ({
@@ -39282,8 +39310,9 @@ function linkIdsOf(value) {
   return t ? [t] : [];
 }
 function groupLabel(groups, named) {
-  const parts = Object.entries(groups).map(([key, v]) => {
-    if (v === null || v === "") return "\u2014";
+  const parts = Object.entries(groups).map(([key, raw]) => {
+    if (raw === null || raw === void 0 || raw === "") return "\u2014";
+    const v = String(raw);
     const name = named?.(key, v);
     if (name !== void 0) return name ?? "\u2014";
     const grain = BUCKET_SUFFIX.exec(key)?.[1];
@@ -41807,7 +41836,8 @@ function rowsOf2(rows, groupKey, keys) {
     }
     const withheld = {};
     for (const [name, notice] of Object.entries(r.withheld ?? {})) if (keys.includes(name)) withheld[name] = notice;
-    return { group: groupKey ? (r.groups ?? {})[groupKey] ?? null : null, values, withheld, n: Number(r.row_count ?? 0) };
+    const g = groupKey ? (r.groups ?? {})[groupKey] : null;
+    return { group: g === null || g === void 0 ? null : String(g), values, withheld, n: Number(r.row_count ?? 0) };
   });
 }
 function sortAndCut(rows, spec, keys) {
@@ -46911,17 +46941,10 @@ function TablePage({
 
 // src/entityViews.tsx
 import { useEffect as useEffect110, useMemo as useMemo75, useState as useState132 } from "react";
-import { Button as Button106, ErrorBox as ErrorBox9, cn as cn93 } from "@ai-matrx/design-system";
+import { Button as Button106, ErrorBox as ErrorBox9, Input as Input12, cn as cn93 } from "@ai-matrx/design-system";
 import { useRecordsClient as useRecordsClient96 } from "@ai-matrx/records/react";
 import { Fragment as Fragment62, jsx as jsx153, jsxs as jsxs141 } from "react/jsx-runtime";
-var TITLE_KEYS = ["name", "display_name", "title", "subject"];
-function entityTitleColumn(columns) {
-  for (const key of TITLE_KEYS) {
-    const hit = columns.find((c) => c.api_name === key);
-    if (hit) return hit;
-  }
-  return columns.find((c) => c.type === "text" && !c.lookup) ?? columns[0] ?? null;
-}
+var entityTitleColumn = entityNameColumn;
 function entityChoiceColumns(columns) {
   return columns.filter((c) => c.type === "choice" && Array.isArray(c.choices) && c.choices.length > 0);
 }
@@ -47076,6 +47099,21 @@ function EntityTablePage({
     onLayoutChange?.(next);
   };
   const boardable = entityChoiceColumns(entity.columns).length > 0;
+  const nameColumn = entityNameColumn(entity.columns);
+  const [naming, setNaming] = useState132(null);
+  const [adding, setAdding] = useState132(false);
+  const [addRefused, setAddRefused] = useState132(null);
+  const add = async () => {
+    const name = (naming ?? "").trim();
+    if (!name || !nameColumn || adding) return;
+    setAdding(true);
+    setAddRefused(null);
+    const made = await entity.create({ [nameColumn.api_name]: name });
+    setAdding(false);
+    if ("refused" in made) return setAddRefused(made.refused);
+    setNaming(null);
+    onOpenRecord?.(made.id);
+  };
   const [question, setQuestion] = useState132(() => questionFromGrouping(void 0));
   const { config: drill } = useDrill({
     source,
@@ -47086,7 +47124,7 @@ function EntityTablePage({
     enabled: layout === "grid"
   });
   return /* @__PURE__ */ jsxs141("div", { className: cn93("flex min-w-0 flex-col gap-2", className), "data-records-entity-page": source.token, children: [
-    presentation === "page" || boardable ? /* @__PURE__ */ jsxs141("div", { className: "flex min-w-0 items-center gap-2", children: [
+    presentation === "page" || boardable || entity.creatable ? /* @__PURE__ */ jsxs141("div", { className: "flex min-w-0 items-center gap-2", children: [
       presentation === "page" ? /* @__PURE__ */ jsx153("h2", { className: "truncate text-base font-semibold", children: entity.label ?? (entity.loading ? "Loading\u2026" : "Table") }) : null,
       presentation === "page" ? /* @__PURE__ */ jsx153("span", { className: "text-xs tabular-nums text-muted-foreground", children: entity.loading ? "" : entity.total.toLocaleString() }) : null,
       /* @__PURE__ */ jsxs141("span", { className: "ml-auto flex items-center gap-1", children: [
@@ -47094,9 +47132,41 @@ function EntityTablePage({
           /* @__PURE__ */ jsx153(Button106, { size: "sm", variant: layout === "grid" ? "secondary" : "ghost", "aria-pressed": layout === "grid", onClick: () => choose("grid"), children: "Table" }),
           /* @__PURE__ */ jsx153(Button106, { size: "sm", variant: layout === "board" ? "secondary" : "ghost", "aria-pressed": layout === "board", onClick: () => choose("board"), children: "Board" })
         ] }) : null,
+        entity.creatable && naming === null ? /* @__PURE__ */ jsx153(Button106, { size: "sm", variant: "ghost", onClick: () => {
+          setAddRefused(null);
+          setNaming("");
+        }, children: "New page" }) : null,
+        entity.creatable && naming !== null ? /* @__PURE__ */ jsx153(
+          Input12,
+          {
+            autoFocus: true,
+            "data-records-entity-new": source.token,
+            "aria-label": nameColumn?.name ?? "Name",
+            placeholder: nameColumn?.name ?? "Name",
+            value: naming,
+            disabled: adding,
+            className: "h-7 w-56 text-xs",
+            onChange: (e) => setNaming(e.target.value),
+            onKeyDown: (e) => {
+              if (e.key === "Enter") {
+                e.preventDefault();
+                void add();
+              }
+              if (e.key === "Escape") {
+                e.preventDefault();
+                setNaming(null);
+                setAddRefused(null);
+              }
+            },
+            onBlur: () => {
+              if (!adding && !(naming ?? "").trim()) setNaming(null);
+            }
+          }
+        ) : null,
         actions
       ] })
     ] }) : null,
+    addRefused ? /* @__PURE__ */ jsx153(ErrorBox9, { className: "rounded border border-destructive/40 px-1.5 py-1 text-xs text-destructive", message: addRefused, operation: "Add a row", origin: "records-ui/entityViews" }) : null,
     entity.error ? /* @__PURE__ */ jsx153("p", { className: "px-1 py-3 text-xs text-muted-foreground", children: `This table could not be read: ${entity.error}` }) : layout === "board" && boardable ? /* @__PURE__ */ jsx153(EntityBoard, { entity, groupBy, onOpenRecord }) : /* @__PURE__ */ jsx153(EntityGrid, { entity, pageSize, ...drill ? { drill } : {} })
   ] });
 }