@ai-matrx/records 0.92.1 → 0.93.0

package/dist/{types-BvL_oKFl.d.ts → types-BauAeFW8.d.ts}

@@ -1,5 +1,5 @@
-import { g as TableType, h as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, i as FieldSensitivity, j as ContextPolicy, b as RelationFlavor, d as RelationCardinality, O as OnDelete } from './record-BwCf9wKW.js';
-import { F as FieldTypeWord, a as FieldRule } from './field-enufS5ry.js';
+import { T as TableType, b as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, c as FieldSensitivity, d as ContextPolicy, e as RelationFlavor, f as RelationCardinality, O as OnDelete } from './record-DmmeuUrC.js';
+import { F as FieldTypeWord, a as FieldRule } from './field-B-WaVZnS.js';
 
 /**
  * Who the data belongs to. A test organization is created under this name — the

package/dist/{types-DAFP6XFe.d.cts → types-CBmUdBT0.d.cts}

@@ -1,5 +1,5 @@
-import { g as TableType, h as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, i as FieldSensitivity, j as ContextPolicy, b as RelationFlavor, d as RelationCardinality, O as OnDelete } from './record-BwCf9wKW.cjs';
-import { F as FieldTypeWord, a as FieldRule } from './field-CCY1rG9l.cjs';
+import { T as TableType, b as TableDisplay, S as StorageMode, F as FieldSource, C as ComputeOn, c as FieldSensitivity, d as ContextPolicy, e as RelationFlavor, f as RelationCardinality, O as OnDelete } from './record-DmmeuUrC.cjs';
+import { F as FieldTypeWord, a as FieldRule } from './field-6rwt4ejZ.cjs';
 
 /**
  * Who the data belongs to. A test organization is created under this name — the

package/dist/{types-BKYEeFt4.d.cts → types-Dek9owBe.d.cts}

@@ -1,5 +1,5 @@
-import { E as EntityRefWithWords } from './relation-8vAWCa67.cjs';
-import { U as Uuid, R as RecordsResult } from './record-BwCf9wKW.cjs';
+import { E as EntityRefWithWords } from './relation-qrb2NbHf.cjs';
+import { U as Uuid, R as RecordsResult } from './record-DmmeuUrC.cjs';
 
 /** §0. A link to any thing: `{token, id, label}`. A custom row's token is `record`. Every link reads as `EntityRef[]`. */
 type EntityRef = EntityRefWithWords;

package/dist/{types-D8qdG3Lg.d.cts → types-DsgXrESm.d.cts}

@@ -1,5 +1,5 @@
-import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-CdoI-UaB.cjs';
-import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-DAFP6XFe.cjs';
+import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-Drbxn-9Z.cjs';
+import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-CBmUdBT0.cjs';
 
 declare const TABLE_KERNEL_ID = "11111111-0000-4000-8000-000000000001";
 type ConfidentialLevel = "viewer" | "commenter" | "editor";

package/dist/{types-cpKY7Pjb.d.ts → types-HVgWcZDY.d.ts}

@@ -1,5 +1,5 @@
-import { E as EntityRefWithWords } from './relation-eLMgv_dV.js';
-import { U as Uuid, R as RecordsResult } from './record-BwCf9wKW.js';
+import { E as EntityRefWithWords } from './relation-Op1M67le.js';
+import { U as Uuid, R as RecordsResult } from './record-DmmeuUrC.js';
 
 /** §0. A link to any thing: `{token, id, label}`. A custom row's token is `record`. Every link reads as `EntityRef[]`. */
 type EntityRef = EntityRefWithWords;

package/dist/{types-DYzXhD7j.d.ts → types-hrw-Eff1.d.ts}

@@ -1,5 +1,5 @@
-import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-BynsG1K6.js';
-import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-BvL_oKFl.js';
+import { A as AggregateOperation, a as AggregateFilter, D as DashboardBlockKind, b as AggregateMeasure, c as AggregateBucket, S as SubscriptionCadence } from './subscription-hdTaRrfK.js';
+import { U as UseCase, a as UseCaseTable, b as UseCaseField, c as UseCaseRow, d as UseCaseForm, e as UseCaseFormField, f as UseCaseNotificationTrigger, N as NotificationChannel, g as UseCaseProvenance } from './types-BauAeFW8.js';
 
 declare const TABLE_KERNEL_ID = "11111111-0000-4000-8000-000000000001";
 type ConfidentialLevel = "viewer" | "commenter" | "editor";

package/dist/use-cases/index.d.cts

@@ -1,8 +1,8 @@
-import { U as UseCase, h as UseCaseSummary } from '../types-DAFP6XFe.cjs';
-export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-DAFP6XFe.cjs';
-export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-DfNMxjmU.cjs';
-import '../record-BwCf9wKW.cjs';
-import '../field-CCY1rG9l.cjs';
+import { U as UseCase, h as UseCaseSummary } from '../types-CBmUdBT0.cjs';
+export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-CBmUdBT0.cjs';
+export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-B_iUeyh2.cjs';
+import '../record-DmmeuUrC.cjs';
+import '../field-6rwt4ejZ.cjs';
 
 /** One banned pattern, with the reason and what to do instead. */
 interface PlaceholderPattern {

package/dist/use-cases/index.d.ts

@@ -1,8 +1,8 @@
-import { U as UseCase, h as UseCaseSummary } from '../types-BvL_oKFl.js';
-export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-BvL_oKFl.js';
-export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-DbvAParj.js';
-import '../record-BwCf9wKW.js';
-import '../field-enufS5ry.js';
+import { U as UseCase, h as UseCaseSummary } from '../types-BauAeFW8.js';
+export { B as BusinessIdentity, F as FormAudience, N as NotificationChannel, P as PostalAddress, i as UseCaseDashboardQuestion, j as UseCaseDocumentTemplate, b as UseCaseField, d as UseCaseForm, e as UseCaseFormField, k as UseCaseMergeField, l as UseCaseNotificationRule, f as UseCaseNotificationTrigger, m as UseCasePipeline, n as UseCasePipelineStage, g as UseCaseProvenance, o as UseCaseRelationship, c as UseCaseRow, a as UseCaseTable } from '../types-BauAeFW8.js';
+export { M as MIN_ROWS_IN_PRIMARY_TABLE, R as RESOLVABLE_FIELD_TYPE_WORDS, U as UseCaseProblem, a as UseCaseVerdict, b as assertUseCase, v as validateUseCase } from '../validate-w-HGGTf-.js';
+import '../record-DmmeuUrC.js';
+import '../field-B-WaVZnS.js';
 
 /** One banned pattern, with the reason and what to do instead. */
 interface PlaceholderPattern {

package/dist/{validate-DfNMxjmU.d.cts → validate-B_iUeyh2.d.cts}

@@ -1,4 +1,4 @@
-import { U as UseCase } from './types-DAFP6XFe.cjs';
+import { U as UseCase } from './types-CBmUdBT0.cjs';
 
 /**
  * Every word a `parityType` may be: the parity types, every kind the declaration door

package/dist/{validate-DbvAParj.d.ts → validate-w-HGGTf-.d.ts}

@@ -1,4 +1,4 @@
-import { U as UseCase } from './types-BvL_oKFl.js';
+import { U as UseCase } from './types-BauAeFW8.js';
 
 /**
  * Every word a `parityType` may be: the parity types, every kind the declaration door

package/dist/views/index.cjs

@@ -0,0 +1,438 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/views/index.ts
+var views_exports = {};
+__export(views_exports, {
+  LAYOUT_FIELD_KIND: () => LAYOUT_FIELD_KIND,
+  LAYOUT_LABEL: () => LAYOUT_LABEL,
+  PAGE_VIEWS: () => PAGE_VIEWS,
+  PAGE_VIEW_LABEL: () => PAGE_VIEW_LABEL,
+  STORE_KEEPS_TIMELINE: () => STORE_KEEPS_TIMELINE,
+  STORE_KEPT_LAYOUTS: () => STORE_KEPT_LAYOUTS,
+  VIEW_KEYS: () => VIEW_KEYS,
+  VIEW_LAYOUTS: () => VIEW_LAYOUTS,
+  VIEW_NEEDS: () => VIEW_NEEDS,
+  declareView: () => declareView,
+  defaultViewOf: () => defaultViewOf,
+  designateView: () => designateView,
+  freeColumnName: () => freeColumnName,
+  makeDefaultLabel: () => makeDefaultLabel,
+  pageViewFromParam: () => pageViewFromParam,
+  plainPresentation: () => plainPresentation,
+  saveViewPatch: () => saveViewPatch,
+  storeKeepsLayout: () => storeKeepsLayout,
+  unknownViewLine: () => unknownViewLine,
+  viewDocument: () => viewDocument,
+  viewFromRow: () => viewFromRow,
+  viewKeysFor: () => viewKeysFor,
+  viewOrderOf: () => viewOrderOf,
+  viewPatchDocument: () => viewPatchDocument,
+  viewPatchFor: () => viewPatchFor,
+  viewSettings: () => viewSettings,
+  viewSettingsFor: () => viewSettingsFor,
+  viewSettingsPatch: () => viewSettingsPatch,
+  wordsList: () => wordsList
+});
+module.exports = __toCommonJS(views_exports);
+
+// src/views/keys.ts
+var plainPresentation = {
+  parse: (raw) => raw && typeof raw === "object" && !Array.isArray(raw) ? { ...raw } : {},
+  isEmpty: (presentation) => Object.keys(presentation).length === 0,
+  toDocument: (presentation) => ({ ...presentation })
+};
+function plainCodec() {
+  return plainPresentation;
+}
+var STORE_KEEPS_TIMELINE = true;
+var ALL = ["grid", "kanban", "calendar", "gallery", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list"];
+var HIDES = ["grid", "gallery", "kanban", "calendar", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list"];
+var GRIDS = ["grid"];
+var VIEW_KEYS = [
+  { path: "layout", shape: "kind", layouts: ALL, writer: "caller" },
+  { path: "filters", shape: "filter", layouts: ALL, writer: "caller" },
+  { path: "where", shape: "rule", layouts: ALL, writer: "caller" },
+  { path: "group_field", shape: "field", layouts: ["kanban", ...STORE_KEEPS_TIMELINE ? ["timeline"] : []], writer: "caller" },
+  { path: "swimlane_field", shape: "field:lane", layouts: ["kanban"], writer: "caller" },
+  { path: "collapsed_columns", shape: "values", layouts: ["kanban"], writer: "caller" },
+  { path: "measure", shape: "field:number", layouts: ["kanban"], writer: "caller" },
+  { path: "date_field", shape: "field:date", layouts: ["calendar"], writer: "caller" },
+  ...STORE_KEEPS_TIMELINE ? [
+    { path: "start_field", shape: "field:date", layouts: ["timeline"], writer: "caller" },
+    { path: "end_field", shape: "field:date", layouts: ["calendar", "timeline"], writer: "caller" }
+  ] : [],
+  { path: "image_field", shape: "field", layouts: ["gallery"], writer: "caller" },
+  { path: "sorts", shape: "sorts", layouts: ALL, writer: "caller" },
+  { path: "rule_id", shape: "uuid", layouts: ALL, writer: "caller" },
+  { path: "is_default", shape: "boolean", layouts: ALL, writer: "caller" },
+  { path: "presentation", shape: "presentation", layouts: ALL, writer: "caller" },
+  { path: "presentation.style", shape: "style", layouts: ALL, writer: "caller" },
+  { path: "presentation.formats", shape: "object", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.frozen", shape: "fields", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.grouping", shape: "grouping", layouts: ["grid", "gallery", "list"], writer: "caller" },
+  { path: "presentation.widths", shape: "widths", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.rowHeight", shape: "row_height", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.hiddenFields", shape: "fields", layouts: HIDES, writer: "caller" },
+  { path: "presentation.cardHidden", shape: "fields", layouts: ["kanban", "calendar", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list", "gallery"], writer: "caller" },
+  { path: "presentation.columnOrder", shape: "fields", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.gallerySize", shape: "gallery_size", layouts: ["gallery"], writer: "caller" },
+  { path: "presentation.wrap", shape: "boolean", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.wrapColumns", shape: "fields", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.fit", shape: "fit", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.freezeFirst", shape: "boolean", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.footer", shape: "footer", layouts: GRIDS, writer: "caller" },
+  { path: "presentation.summaries", shape: "summaries", layouts: GRIDS, writer: "caller" },
+  { path: "grid", shape: "grid", layouts: GRIDS, writer: "caller" },
+  { path: "hidden_fields", shape: "input", layouts: HIDES, writer: "input" },
+  { path: "table_id", shape: "server", layouts: ALL, writer: "server" },
+  { path: "order", shape: "server", layouts: GRIDS, writer: "server" },
+  { path: "moved_from", shape: "server", layouts: ALL, writer: "server" }
+];
+var STORE_KEPT_LAYOUTS = ["grid", "kanban", "calendar", "gallery", ...STORE_KEEPS_TIMELINE ? ["timeline"] : [], "list"];
+function storeKeepsLayout(layout) {
+  return STORE_KEPT_LAYOUTS.includes(layout);
+}
+function viewKeysFor(layout) {
+  return VIEW_KEYS.filter((k) => k.layouts.includes(layout)).map((k) => k.path);
+}
+var KINDS = STORE_KEPT_LAYOUTS;
+function viewSettings(definition, rowFilters, codec = plainCodec()) {
+  const data = definition ?? {};
+  const text = (key) => {
+    const v = data[key];
+    return typeof v === "string" && v !== "" ? v : null;
+  };
+  const layout = String(data["layout"] ?? "grid");
+  const flat = rowFilters ?? (isObject(data["filters"]) ? data["filters"] : null);
+  const moved = data["moved_from"];
+  return {
+    layout: KINDS.includes(layout) ? layout : "grid",
+    filters: flat && Object.keys(flat).length > 0 ? flat : null,
+    where: isRule(data["where"]) ? data["where"] : null,
+    groupField: text("group_field"),
+    swimlaneField: text("swimlane_field"),
+    collapsedColumns: Array.isArray(data["collapsed_columns"]) ? data["collapsed_columns"].filter((v) => ["string", "number", "boolean"].includes(typeof v)).map(String) : [],
+    measure: text("measure"),
+    dateField: text("date_field"),
+    startField: text("start_field"),
+    endField: text("end_field"),
+    imageField: text("image_field"),
+    sorts: parseSorts(data["sorts"]),
+    ruleId: text("rule_id"),
+    isDefault: data["is_default"] === true || data["is_default"] === "true",
+    presentation: codec.parse(data["presentation"]),
+    movedFrom: isObject(moved) ? moved : null
+  };
+}
+function viewSettingsFor(settings, layout) {
+  const reads = new Set(viewKeysFor(layout));
+  const out = { layout: settings.layout };
+  const take = (key, path) => {
+    if (reads.has(path)) out[key] = settings[key];
+  };
+  take("filters", "filters");
+  take("where", "where");
+  take("groupField", "group_field");
+  take("swimlaneField", "swimlane_field");
+  take("collapsedColumns", "collapsed_columns");
+  take("measure", "measure");
+  take("dateField", "date_field");
+  take("startField", "start_field");
+  take("endField", "end_field");
+  take("imageField", "image_field");
+  take("sorts", "sorts");
+  take("ruleId", "rule_id");
+  take("isDefault", "is_default");
+  const p = settings.presentation;
+  const look = {};
+  for (const [key, value] of Object.entries(p)) {
+    if (reads.has(`presentation.${key}`)) look[key] = value;
+  }
+  out.presentation = look;
+  return out;
+}
+function viewSettingsPatch(patch, codec = plainCodec()) {
+  const out = {};
+  const field = (key, path) => {
+    if (patch[key] !== void 0) out[path] = patch[key] || null;
+  };
+  if (patch.layout !== void 0 && storeKeepsLayout(patch.layout)) out["layout"] = patch.layout;
+  field("groupField", "group_field");
+  field("swimlaneField", "swimlane_field");
+  field("measure", "measure");
+  field("dateField", "date_field");
+  if (STORE_KEEPS_TIMELINE) {
+    field("startField", "start_field");
+    field("endField", "end_field");
+  }
+  field("imageField", "image_field");
+  field("ruleId", "rule_id");
+  if (patch.collapsedColumns !== void 0) out["collapsed_columns"] = patch.collapsedColumns ?? [];
+  if (patch.sorts !== void 0) out["sorts"] = patch.sorts ?? [];
+  if (patch.where !== void 0) out["where"] = patch.where ?? null;
+  if (patch.isDefault !== void 0) out["is_default"] = patch.isDefault === true;
+  if (patch.presentation !== void 0) {
+    out["presentation"] = !patch.presentation || codec.isEmpty(patch.presentation) ? null : codec.toDocument(patch.presentation);
+  }
+  return out;
+}
+function isObject(raw) {
+  return Boolean(raw) && typeof raw === "object" && !Array.isArray(raw);
+}
+function isRule(raw) {
+  if (!isObject(raw)) return false;
+  const node = raw;
+  return typeof node.op === "string" && Array.isArray(node.args);
+}
+function parseSorts(raw) {
+  let list = raw;
+  if (typeof raw === "string") {
+    try {
+      list = raw.trim() === "" ? [] : JSON.parse(raw);
+    } catch {
+      return [];
+    }
+  }
+  if (!Array.isArray(list)) return [];
+  return list.filter((s) => isObject(s) && typeof s.field === "string").map((s) => ({ field: s.field, direction: s.direction === "desc" ? "desc" : "asc" }));
+}
+
+// src/views/views.ts
+function plainCodec2() {
+  return plainPresentation;
+}
+var VIEW_LAYOUTS = ["grid", "kanban", "calendar", "gallery", "timeline", "list"];
+var LAYOUT_LABEL = {
+  grid: "Grid",
+  kanban: "Kanban",
+  calendar: "Calendar",
+  gallery: "Gallery",
+  timeline: "Timeline",
+  list: "List"
+};
+function wordsList(words) {
+  const clean = words.map((w) => w.trim()).filter((w) => w !== "");
+  if (clean.length <= 1) return clean.join("");
+  return `${clean.slice(0, -1).join(", ")} and ${clean[clean.length - 1]}`;
+}
+var VIEW_NEEDS = {
+  grid: null,
+  // A list reads nothing a table can lack: rows, titled, grouped only when the person chooses.
+  list: null,
+  kanban: {
+    kind: "choice",
+    viewKey: "groupField",
+    blocking: true,
+    starter: { label: "Status", type: "select", options: ["To do", "In progress", "Done"] },
+    pick: "Pick the choice column the board's columns come from.",
+    missing: "This table has no choice column to make the board's columns from.",
+    does: (label) => `Make it work adds a ${label} column with the choices below and groups the board by it.`,
+    ask: (label, options) => `Add a choice column called ${label} to this table${options.length > 0 ? ` with the choices ${wordsList(options)}` : ""}, then group the Kanban board by it.`
+  },
+  calendar: {
+    kind: "date",
+    viewKey: "dateField",
+    blocking: true,
+    starter: { label: "Date", type: "datetime" },
+    pick: "Pick the date column the calendar places records by.",
+    missing: "This table has no date column to place records on.",
+    does: (label) => `Make it work adds a ${label} column and lays the calendar out by it.`,
+    ask: (label) => `Add a date column called ${label} to this table, then lay the Calendar out by it.`
+  },
+  gallery: {
+    kind: "file",
+    viewKey: "imageField",
+    blocking: false,
+    starter: { label: "Photo", type: "attachment" },
+    pick: "Pick the file column each card shows as its picture.",
+    missing: "The cards have no picture because this table has no file column.",
+    does: (label) => `Make it work adds a ${label} column and shows it on each card.`,
+    ask: (label) => `Add a file column called ${label} to this table, then show it as the picture on each Gallery card.`
+  },
+  timeline: {
+    kind: "date",
+    viewKey: "dateField",
+    blocking: true,
+    starter: { label: "Start", type: "datetime" },
+    pick: "Pick the date column each bar starts on.",
+    missing: "This table has no date column to place records on.",
+    does: (label) => `Make it work adds a ${label} column and lays the timeline out by it.`,
+    ask: (label) => `Add a date column called ${label} to this table, then lay the Timeline out by it.`
+  }
+};
+function freeColumnName(wanted, taken) {
+  const held = new Set(taken.map((t) => t.trim().toLowerCase()));
+  const base = wanted.trim() === "" ? "Column" : wanted.trim();
+  if (!held.has(base.toLowerCase())) return base;
+  for (let n = 2; n < 100; n += 1) {
+    const next = `${base} ${n}`;
+    if (!held.has(next.toLowerCase())) return next;
+  }
+  return base;
+}
+function viewOrderOf(definition) {
+  const raw = definition?.["order"];
+  return raw === "manual" ? "manual" : raw === "sorted" ? "sorted" : null;
+}
+function defaultViewOf(views) {
+  return views.find((v) => v.isDefault);
+}
+var LAYOUT_FIELD_KIND = {
+  grid: null,
+  kanban: "choice",
+  calendar: "date",
+  gallery: "file",
+  timeline: "date",
+  list: null
+};
+var PAGE_VIEWS = [...VIEW_LAYOUTS, "dashboards", "archived"];
+var PAGE_VIEW_LABEL = {
+  ...LAYOUT_LABEL,
+  dashboards: "Dashboards",
+  archived: "Archived"
+};
+var PAGE_VIEW_SPELLINGS = {
+  grid: "grid",
+  table: "grid",
+  rows: "grid",
+  list: "list",
+  kanban: "kanban",
+  board: "kanban",
+  pipeline: "kanban",
+  calendar: "calendar",
+  month: "calendar",
+  schedule: "calendar",
+  gallery: "gallery",
+  cards: "gallery",
+  timeline: "timeline",
+  gantt: "timeline",
+  dashboards: "dashboards",
+  dashboard: "dashboards",
+  charts: "dashboards",
+  archived: "archived",
+  archive: "archived",
+  // The grid's row action says "Delete" and the store soft-deletes, so the word
+  // a person types is as likely to be the one the button used as the one this
+  // view is called. Both land in the same place; neither dies.
+  deleted: "archived",
+  trash: "archived",
+  removed: "archived"
+};
+function pageViewFromParam(raw) {
+  if (typeof raw !== "string") return null;
+  const token = raw.trim().toLowerCase();
+  if (token === "") return null;
+  return PAGE_VIEW_SPELLINGS[token] ?? null;
+}
+function unknownViewLine(raw) {
+  return `The link asked for a view called \u201C${raw}\u201D, which this table has no view for, so you are looking at ${PAGE_VIEW_LABEL.grid}. The views this table has are ${PAGE_VIEWS.map((v) => PAGE_VIEW_LABEL[v]).join(", ")} \u2014 pick one above and the address follows it.`;
+}
+function viewDocument(spec, codec = plainCodec2()) {
+  const out = {
+    // A layout the store does not keep yet is not sent: the view is saved as a grid (`STORE_KEPT_LAYOUTS`).
+    layout: storeKeepsLayout(spec.layout) ? spec.layout : "grid",
+    sorts: spec.sorts ?? [],
+    is_default: spec.isDefault === true
+  };
+  if (spec.groupField) out["group_field"] = spec.groupField;
+  if (spec.swimlaneField) out["swimlane_field"] = spec.swimlaneField;
+  if (spec.collapsedColumns && spec.collapsedColumns.length > 0) out["collapsed_columns"] = spec.collapsedColumns;
+  if (spec.measure) out["measure"] = spec.measure;
+  if (spec.dateField) out["date_field"] = spec.dateField;
+  if (STORE_KEEPS_TIMELINE && spec.startField) out["start_field"] = spec.startField;
+  if (STORE_KEEPS_TIMELINE && spec.endField) out["end_field"] = spec.endField;
+  if (spec.imageField) out["image_field"] = spec.imageField;
+  if (spec.ruleId) out["rule_id"] = spec.ruleId;
+  if (spec.where) out["where"] = spec.where;
+  if (spec.presentation && !codec.isEmpty(spec.presentation)) {
+    out["presentation"] = codec.toDocument(spec.presentation);
+  }
+  return out;
+}
+function viewFromRow(row, codec = plainCodec2()) {
+  const data = row.definition ?? {};
+  const k = viewSettings(data, row.filters && Object.keys(row.filters).length > 0 ? row.filters : null, codec);
+  const tableFromDefinition = typeof data["table_id"] === "string" && data["table_id"] !== "" ? data["table_id"] : null;
+  return {
+    id: row.view_id,
+    name: row.name || "Untitled view",
+    subject: row.table_id ?? tableFromDefinition ?? "",
+    layout: k.layout,
+    groupField: k.groupField,
+    swimlaneField: k.swimlaneField,
+    collapsedColumns: k.collapsedColumns,
+    measure: k.measure,
+    dateField: k.dateField,
+    startField: k.startField,
+    endField: k.endField,
+    imageField: k.imageField,
+    sorts: k.sorts,
+    order: viewOrderOf(data),
+    ruleId: k.ruleId,
+    ...k.filters ? { filters: k.filters } : {},
+    where: k.where,
+    // The older table's own default view, carried in by the mover, IS this table's default —
+    // the mover wrote the row's column, which `custom.views` does not return. Read as anything
+    // else, the page would seed a second "All records" beside it and open on that.
+    isDefault: k.isDefault || k.movedFrom?.["kind"] === "default_view",
+    presentation: k.presentation,
+    movedFrom: k.movedFrom
+  };
+}
+async function declareView(client, spec, codec = plainCodec2()) {
+  return client.viewDeclare({
+    table_id: spec.subject,
+    spec: {
+      name: spec.name,
+      ...spec.filters ? { filters: spec.filters } : {},
+      definition: viewDocument(spec, codec)
+    }
+  });
+}
+async function saveViewPatch(client, tableId, viewId, patch, codec = plainCodec2()) {
+  const definition = viewPatchDocument(patch, codec);
+  const renamed = patch.name !== void 0 && patch.name.trim() !== "";
+  const refiltered = patch.filters !== void 0;
+  return client.viewDeclare({
+    table_id: tableId,
+    spec: {
+      view_id: viewId,
+      ...renamed ? { name: patch.name.trim() } : {},
+      ...refiltered ? { filters: patch.filters ?? null } : {},
+      definition
+    }
+  });
+}
+function viewPatchDocument(patch, codec = plainCodec2()) {
+  const { name: _name, subject: _subject, filters: _filters, ...keys } = patch;
+  return viewSettingsPatch(keys, codec);
+}
+function viewPatchFor(view, patch) {
+  if (!view.isDefault) return patch;
+  const { layout: _layout, isDefault: _isDefault, ...kept } = patch;
+  return kept;
+}
+function makeDefaultLabel(layoutLabel) {
+  return `Make ${layoutLabel} the default`;
+}
+async function designateView(client, tableId, viewId, layout) {
+  return client.viewDesignate({ table_id: tableId, view_id: viewId, layout });
+}
+//# sourceMappingURL=index.cjs.map