@multiplatform.one/frappe-ui 7.22.0 → 7.23.1

package/src/list/listFormat.spec.ts

@@ -0,0 +1,151 @@
+/**
+ * listFormat — frappe datetime parsing and desk-style list-cell display
+ * helpers. Time-ago fixtures anchor `now` to the parsed date itself so the
+ * assertions are timezone-independent.
+ */
+import { describe, expect, it } from "vitest";
+import {
+  formatDateCell,
+  formatTimeAgo,
+  parseFrappeDate,
+  parseTagsField,
+  parseUserListField,
+  stripHtmlPreview,
+} from "./listFormat";
+
+describe("parseFrappeDate", () => {
+  it("parses frappe datetime strings (space-separated, microseconds)", () => {
+    const date = parseFrappeDate("2026-08-12 08:50:24.691936");
+    expect(date).toBeInstanceOf(Date);
+    expect(date?.getFullYear()).toBe(2026);
+    expect(date?.getMonth()).toBe(7); // August
+    expect(date?.getDate()).toBe(12);
+    expect(date?.getHours()).toBe(8);
+    expect(date?.getMinutes()).toBe(50);
+    expect(date?.getSeconds()).toBe(24);
+  });
+
+  it("parses plain dates", () => {
+    const date = parseFrappeDate("2026-08-12");
+    expect(date).toBeInstanceOf(Date);
+    expect(Number.isNaN(date?.getTime())).toBe(false);
+  });
+
+  it("returns undefined for invalid input", () => {
+    expect(parseFrappeDate("not a date")).toBeUndefined();
+    expect(parseFrappeDate("")).toBeUndefined();
+  });
+});
+
+describe("formatDateCell (LC-12 compact-absolute display register)", () => {
+  // Anchor `now` inside the stamp's year so current-year elision is stable.
+  const now = parseFrappeDate("2026-01-01 00:00:00") as Date;
+
+  it("renders the house compact-absolute register, never raw ISO", () => {
+    expect(formatDateCell("2026-08-12 08:50:24", now)).toBe("Aug 12");
+    expect(formatDateCell("2026-08-12 08:50:24.691936", now)).toBe("Aug 12");
+    expect(formatDateCell("2026-08-12", now)).toBe("Aug 12");
+  });
+
+  it("keeps the year when not current (display register year:auto)", () => {
+    expect(formatDateCell("2025-07-01", now)).toBe("Jul 1, 2025");
+  });
+
+  it("passes unparseable input through unchanged (honest passthrough)", () => {
+    expect(formatDateCell("garbage", now)).toBe("garbage");
+  });
+});
+
+describe("formatTimeAgo (LC-12 relative register)", () => {
+  const stamp = "2026-08-12 08:00:00";
+  const base = parseFrappeDate(stamp) as Date;
+  const after = (ms: number) => new Date(base.getTime() + ms);
+  const MINUTE = 60_000;
+  const HOUR = 60 * MINUTE;
+  const DAY = 24 * HOUR;
+
+  it("speaks the house relative register — one voice, unambiguous units", () => {
+    expect(formatTimeAgo(stamp, after(0))).toBe("just now");
+    expect(formatTimeAgo(stamp, after(59_000))).toBe("just now");
+    expect(formatTimeAgo(stamp, after(MINUTE))).toBe("1m ago");
+    expect(formatTimeAgo(stamp, after(59 * MINUTE))).toBe("59m ago");
+    expect(formatTimeAgo(stamp, after(HOUR))).toBe("1h ago");
+    expect(formatTimeAgo(stamp, after(23 * HOUR + 59 * MINUTE))).toBe("23h ago");
+    expect(formatTimeAgo(stamp, after(DAY))).toBe("1 day ago");
+    expect(formatTimeAgo(stamp, after(29 * DAY))).toBe("29 days ago");
+  });
+
+  it("months use 'mo', never an ambiguous capital M", () => {
+    expect(formatTimeAgo(stamp, after(31 * DAY))).toBe("1mo ago");
+    expect(formatTimeAgo(stamp, after(330 * DAY))).toBe("11mo ago");
+  });
+
+  it("shows years beyond ~12 months", () => {
+    expect(formatTimeAgo(stamp, after(366 * DAY))).toBe("1y ago");
+    expect(formatTimeAgo(stamp, after(2 * 366 * DAY))).toBe("2y ago");
+  });
+
+  it("returns the raw value when unparseable", () => {
+    expect(formatTimeAgo("garbage", new Date())).toBe("garbage");
+  });
+
+  it("treats future timestamps as just now (clamped, never negative)", () => {
+    expect(formatTimeAgo(stamp, after(-5 * HOUR))).toBe("just now");
+  });
+});
+
+describe("parseUserListField (_assign / _liked_by JSON-array-string columns)", () => {
+  it("parses the bench shape: a JSON array string", () => {
+    expect(parseUserListField('["admin@example.com", "test@example.com"]')).toEqual([
+      "admin@example.com",
+      "test@example.com",
+    ]);
+  });
+
+  it("passes real arrays through, stringifying members", () => {
+    expect(parseUserListField(["a@b.c", 42])).toEqual(["a@b.c", "42"]);
+  });
+
+  it("returns [] for empty, malformed, or non-array JSON", () => {
+    expect(parseUserListField("")).toEqual([]);
+    expect(parseUserListField(null)).toEqual([]);
+    expect(parseUserListField(undefined)).toEqual([]);
+    expect(parseUserListField("not json")).toEqual([]);
+    expect(parseUserListField('{"a":1}')).toEqual([]);
+    expect(parseUserListField(42)).toEqual([]);
+  });
+});
+
+describe("stripHtmlPreview (rich-text cell previews, desk strip_html parity)", () => {
+  it("strips Text Editor markup down to its text", () => {
+    expect(stripHtmlPreview('<div class="ql-editor read-mode"><p>Call the vendor</p></div>')).toBe(
+      "Call the vendor",
+    );
+  });
+
+  it("collapses tags and entities into single spaces", () => {
+    expect(stripHtmlPreview("<p>a</p><p>b&nbsp;c</p>")).toBe("a b c");
+    expect(stripHtmlPreview("x &amp; y &lt;z&gt;")).toBe("x & y <z>");
+  });
+
+  it("passes plain text through untouched (fast path)", () => {
+    expect(stripHtmlPreview("plain description")).toBe("plain description");
+  });
+});
+
+describe("parseTagsField (_user_tags comma-joined column)", () => {
+  it("parses the bench shape: leading-comma joined tags", () => {
+    expect(parseTagsField(",Urgent,Follow Up")).toEqual(["Urgent", "Follow Up"]);
+  });
+
+  it("trims whitespace and drops empty segments", () => {
+    expect(parseTagsField(" ,  a , ,b, ")).toEqual(["a", "b"]);
+  });
+
+  it("returns [] for empty or non-string values", () => {
+    expect(parseTagsField("")).toEqual([]);
+    expect(parseTagsField(null)).toEqual([]);
+    expect(parseTagsField(undefined)).toEqual([]);
+    expect(parseTagsField(["a"])).toEqual([]);
+  });
+});

package/src/list/listFormat.ts

@@ -0,0 +1,80 @@
+// Cross-platform display helpers for list cells — frappe datetimes like
+// "2026-08-12 08:50:24.691936". Formatting routes through the house date
+// channel (LC-12 DATA-REGISTER-CHANNEL): one formatter owns each register,
+// this module only parses the frappe wire format and picks the register.
+import { formatAbsoluteDate, formatRelativeTimestamp } from "@multiplatform.one/theme";
+
+/** Parse a frappe date/datetime string into a Date (undefined when invalid). */
+export function parseFrappeDate(value: string): Date | undefined {
+  // "YYYY-MM-DD HH:mm:ss.SSSSSS" → ISO-ish so JSC/Hermes parse it too.
+  const isoish = value.includes(" ") ? value.replace(" ", "T") : value;
+  const date = new Date(isoish);
+  return Number.isNaN(date.getTime()) ? undefined : date;
+}
+
+/**
+ * Table date cell — the house compact-absolute display register
+ * ("Aug 12" / "Jul 1, 2025", current year elided). Raw ISO wire format
+ * never reaches the cell (LC-12); unparseable input passes through.
+ * The STRING (not a parsed Date) rides into the channel so its date-only
+ * UTC branch engages — a parsed "YYYY-MM-DD" would shift a day in
+ * negative-offset timezones.
+ */
+export function formatDateCell(value: string, now?: Date): string {
+  if (!parseFrappeDate(value)) return value;
+  const isoish = value.includes(" ") ? value.replace(" ", "T") : value;
+  return formatAbsoluteDate(isoish, now ? { now } : undefined);
+}
+
+/**
+ * Recency column ("Last Updated On") — the house relative register
+ * ("just now", "5m ago", "2h ago", "2mo ago"). One voice, unambiguous
+ * units (LC-12); unparseable input passes through.
+ */
+export function formatTimeAgo(value: string, now: Date = new Date()): string {
+  const date = parseFrappeDate(value);
+  if (!date) return value;
+  return formatRelativeTimestamp(date, now.getTime());
+}
+
+/**
+ * Plain-text preview of rich/HTML field content for list cells (desk
+ * `strip_html` parity): tags dropped, entities collapsed, whitespace
+ * normalized. A Text Editor value like `<div class="ql-editor"><p>Call the
+ * vendor</p></div>` renders as "Call the vendor" — markup never paints in
+ * a one-line cell (LC-06/LC-10 containment; cell-containment rule candidate).
+ */
+export function stripHtmlPreview(value: string): string {
+  if (!value.includes("<") && !value.includes("&")) return value;
+  return value
+    .replace(/<[^>]*>/g, " ")
+    .replace(/&nbsp;/gi, " ")
+    .replace(/&amp;/gi, "&")
+    .replace(/&lt;/gi, "<")
+    .replace(/&gt;/gi, ">")
+    .replace(/&#39;|&apos;/gi, "'")
+    .replace(/&quot;/gi, '"')
+    .replace(/\s+/g, " ")
+    .trim();
+}
+
+/** Parse frappe's `_assign` / `_liked_by` JSON-array-string columns. */
+export function parseUserListField(value: unknown): string[] {
+  if (Array.isArray(value)) return value.map(String);
+  if (typeof value !== "string" || !value) return [];
+  try {
+    const parsed = JSON.parse(value);
+    return Array.isArray(parsed) ? parsed.map(String) : [];
+  } catch {
+    return [];
+  }
+}
+
+/** Parse frappe's `_user_tags` comma-joined column (",a,b" → ["a","b"]). */
+export function parseTagsField(value: unknown): string[] {
+  if (typeof value !== "string") return [];
+  return value
+    .split(",")
+    .map((tag) => tag.trim())
+    .filter(Boolean);
+}

package/src/list/seam.spec.ts

@@ -0,0 +1,116 @@
+/**
+ * MPO-15 — the desk list seam, from this side.
+ *
+ * The list column builder and the filterable-field vocabulary used to live
+ * in `@multiplatform.one/backoffice`, one tier above this package, so
+ * FrappeTable could not default its columns from meta and the two list
+ * stacks kept two filter-field tables. Both live here now, and three things
+ * have to stay true for that to mean anything:
+ *
+ *  1. The package barrel hands every name out.
+ *  2. The list modules reach nothing above them: no backoffice import, and
+ *     no bounce back through this package's own barrel.
+ *  3. One filterable-field vocabulary: only `filterFields.ts` declares which
+ *     fieldtypes filter and which standard doc fields every doctype has.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+
+const listDir = path.resolve(__dirname);
+const srcDir = path.resolve(__dirname, "..");
+const publicDir = path.resolve(srcDir, "../..");
+
+function sourceFiles(dir: string): string[] {
+  const out: string[] = [];
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      out.push(...sourceFiles(full));
+      continue;
+    }
+    if (!/\.(ts|tsx)$/.test(entry.name)) continue;
+    if (/\.(spec|stories)\./.test(entry.name)) continue;
+    out.push(full);
+  }
+  return out;
+}
+
+const LIST_NAMES = [
+  "buildListColumns",
+  "BuildListColumnsArgs",
+  "ListDoc",
+  "ListRow",
+  "listDocumentColumnIds",
+  "listFieldsToFetch",
+  "listViewFields",
+  "formatDateCell",
+  "formatTimeAgo",
+  "parseFrappeDate",
+  "parseTagsField",
+  "parseUserListField",
+  "stripHtmlPreview",
+  "statusPillColors",
+  "StatusPillColors",
+];
+
+const VOCABULARY_NAMES = [
+  "defaultOperatorForKind",
+  "DESK_OPERATOR_LABELS",
+  "docFieldsToFilterFields",
+  "draftToTuple",
+  "fieldKind",
+  "fieldLabelFor",
+  "filterableFieldsFromMeta",
+  "filterTupleLabel",
+  "operatorsForKind",
+  "quickFilterValue",
+  "selectOptionsFromField",
+  "setFieldFilter",
+  "standardDocFilterFields",
+  "standardFiltersFromMeta",
+  "tupleToDraft",
+  "DeskOperator",
+  "FilterFieldDescriptor",
+  "FilterFieldKind",
+  "FilterRowDraft",
+];
+
+describe("desk list seam (MPO-15)", () => {
+  it("hands the list and the vocabulary out of the package barrel", () => {
+    const barrel = fs.readFileSync(path.resolve(srcDir, "index.ts"), "utf-8");
+    const block = barrel.slice(barrel.indexOf("Desk List (MPO-15)"));
+    expect(block, "the barrel must carry a desk list block").toContain('from "./list/listColumns"');
+    for (const name of [...LIST_NAMES, ...VOCABULARY_NAMES]) {
+      expect(block, `the barrel must re-export "${name}"`).toMatch(new RegExp(`\\b${name}\\b`));
+    }
+  });
+
+  it("keeps the list modules off backoffice and off their own barrel", () => {
+    for (const file of sourceFiles(listDir)) {
+      const source = fs.readFileSync(file, "utf-8");
+      expect(source, file).not.toMatch(/from ["']@multiplatform\.one\/backoffice/);
+      expect(source, file).not.toMatch(/from ["']@multiplatform\.one\/frappe-ui/);
+      expect(source, file).not.toMatch(/from ["']\.\.\/index["']/);
+    }
+  });
+
+  it("declares the filterable-field table once, across both list stacks", () => {
+    const declares =
+      /NON_FILTERABLE_FIELDTYPES\s*=|STANDARD_DOC_FIELDS\s*[:=]|function standardDocFilterFields/;
+    const owners = [
+      ...sourceFiles(srcDir),
+      ...sourceFiles(path.resolve(publicDir, "backoffice/src")),
+    ]
+      .filter((file) => declares.test(fs.readFileSync(file, "utf-8")))
+      .map((file) => path.relative(publicDir, file));
+    expect(owners).toEqual(["frappe-ui/src/filterFields.ts"]);
+  });
+
+  it("derives FrappeTable's default columns through the one column builder", () => {
+    const table = fs.readFileSync(path.resolve(srcDir, "FrappeTable.tsx"), "utf-8");
+    expect(table).toMatch(/columns\?: DataTableColumn/);
+    expect(table).toContain('from "./list/listColumns"');
+    expect(table).toMatch(/buildListColumns\(/);
+  });
+});

package/src/list/statusColors.spec.ts

@@ -0,0 +1,100 @@
+/**
+ * statusColors — desk indicator-color parity for the list status pill.
+ * Workflow `states` from the doctype meta must win over the heuristic
+ * word map; everything unknown lands on gray.
+ */
+import { describe, expect, it } from "vitest";
+import type { DoctypeMeta } from "../formEngine/doctypeMeta";
+import { statusPillColors } from "./statusColors";
+
+function makeMeta(states: Array<{ title?: string; color?: string }>): DoctypeMeta {
+  return { name: "ToDo", fields: [], states } as DoctypeMeta;
+}
+
+describe("statusPillColors heuristics (no meta)", () => {
+  it("maps done/healthy words to green", () => {
+    for (const status of ["Closed", "Completed", "Approved", "Paid", "Active", "Delivered"]) {
+      expect(statusPillColors(status)).toEqual({ background: "$green3", text: "$green11" });
+    }
+  });
+
+  it("maps in-flight words to orange", () => {
+    for (const status of ["Open", "Pending", "In Progress", "Overdue", "Medium"]) {
+      expect(statusPillColors(status)).toEqual({ background: "$orange3", text: "$orange11" });
+    }
+  });
+
+  it("maps informational words to blue", () => {
+    for (const status of ["Submitted", "Running", "New", "In Review", "Low"]) {
+      expect(statusPillColors(status)).toEqual({ background: "$blue3", text: "$blue11" });
+    }
+  });
+
+  it("maps failed/stopped words to red", () => {
+    for (const status of ["Cancelled", "Canceled", "Failed", "Rejected", "Urgent", "High"]) {
+      expect(statusPillColors(status)).toEqual({ background: "$red3", text: "$red11" });
+    }
+  });
+
+  it("maps draft and unknown values to gray", () => {
+    expect(statusPillColors("Draft")).toEqual({ background: "$gray3", text: "$gray11" });
+    expect(statusPillColors("Something Custom")).toEqual({
+      background: "$gray3",
+      text: "$gray11",
+    });
+    expect(statusPillColors("")).toEqual({ background: "$gray3", text: "$gray11" });
+  });
+
+  it("normalizes case and whitespace", () => {
+    expect(statusPillColors(" OPEN ")).toEqual({ background: "$orange3", text: "$orange11" });
+    expect(statusPillColors("paid")).toEqual({ background: "$green3", text: "$green11" });
+  });
+});
+
+describe("statusPillColors with workflow states", () => {
+  it("prefers the workflow state color over the word heuristic", () => {
+    // Heuristic would say orange for "Open"; the workflow says Red.
+    const meta = makeMeta([{ title: "Open", color: "Red" }]);
+    expect(statusPillColors("Open", meta)).toEqual({ background: "$red3", text: "$red11" });
+  });
+
+  it("matches state titles case-insensitively and trims", () => {
+    const meta = makeMeta([{ title: "  open ", color: "Green" }]);
+    expect(statusPillColors("Open", meta)).toEqual({ background: "$green3", text: "$green11" });
+  });
+
+  it("maps desk color aliases onto ramp families", () => {
+    const cases: Array<[string, string]> = [
+      ["Light-Blue", "blue"],
+      ["cyan", "blue"],
+      ["Amber", "yellow"],
+      ["Grey", "gray"],
+      ["darkgrey", "gray"],
+      ["Purple", "purple"],
+      ["Pink", "pink"],
+    ];
+    for (const [deskColor, ramp] of cases) {
+      const meta = makeMeta([{ title: "Custom", color: deskColor }]);
+      expect(statusPillColors("Custom", meta)).toEqual({
+        background: `$${ramp}3`,
+        text: `$${ramp}11`,
+      });
+    }
+  });
+
+  it("falls back to the heuristic for unknown desk colors", () => {
+    const meta = makeMeta([{ title: "Open", color: "Teal" }]);
+    expect(statusPillColors("Open", meta)).toEqual({ background: "$orange3", text: "$orange11" });
+  });
+
+  it("falls back to the heuristic when the state has no color or no match", () => {
+    expect(statusPillColors("Open", makeMeta([{ title: "Open" }]))).toEqual({
+      background: "$orange3",
+      text: "$orange11",
+    });
+    expect(statusPillColors("Closed", makeMeta([{ title: "Open", color: "Red" }]))).toEqual({
+      background: "$green3",
+      text: "$green11",
+    });
+  });
+});

package/src/list/statusColors.ts

@@ -0,0 +1,94 @@
+// Desk indicator-color parity: map a status value to theme color tokens for
+// the list-view status pill. Doctype workflow `states` (which carry desk
+// color names) win over the heuristic word map.
+import type { DoctypeMeta } from "../formEngine/doctypeMeta";
+
+export interface StatusPillColors {
+  /** Pill surface (step-3 ramp). */
+  background: string;
+  /** Pill text (step-11 ramp — AA on the step-3 surface). */
+  text: string;
+}
+
+/** Desk indicator color name → tamagui ramp family. */
+const DESK_COLOR_TO_RAMP: Record<string, string> = {
+  red: "red",
+  green: "green",
+  blue: "blue",
+  orange: "orange",
+  yellow: "yellow",
+  amber: "yellow",
+  gray: "gray",
+  grey: "gray",
+  darkgrey: "gray",
+  "light-blue": "blue",
+  purple: "purple",
+  pink: "pink",
+  cyan: "blue",
+};
+
+/** Desk's common listview indicator heuristics (frappe list_view indicators). */
+const STATUS_WORD_TO_RAMP: Record<string, string> = {
+  // green — done / healthy
+  closed: "green",
+  completed: "green",
+  complete: "green",
+  finished: "green",
+  active: "green",
+  enabled: "green",
+  approved: "green",
+  paid: "green",
+  success: "green",
+  resolved: "green",
+  delivered: "green",
+  received: "green",
+  // orange — needs attention / in flight
+  open: "orange",
+  pending: "orange",
+  "in progress": "orange",
+  "to deliver": "orange",
+  "to bill": "orange",
+  overdue: "orange",
+  medium: "orange",
+  // blue — submitted / informational
+  submitted: "blue",
+  running: "blue",
+  new: "blue",
+  "in review": "blue",
+  low: "blue",
+  // red — failed / stopped
+  cancelled: "red",
+  canceled: "red",
+  disabled: "red",
+  failed: "red",
+  rejected: "red",
+  error: "red",
+  expired: "red",
+  inactive: "red",
+  unpaid: "red",
+  lost: "red",
+  high: "red",
+  urgent: "red",
+  // gray — inert
+  draft: "gray",
+};
+
+function rampToPill(ramp: string): StatusPillColors {
+  return { background: `$${ramp}3`, text: `$${ramp}11` };
+}
+
+/**
+ * Resolve the pill colors for a status value. Workflow states from the
+ * doctype meta (desk color names) take precedence; otherwise a heuristic
+ * word map mirrors stock desk indicators; unknown values fall back to gray.
+ */
+export function statusPillColors(status: string, meta?: DoctypeMeta): StatusPillColors {
+  const normalized = status.trim().toLowerCase();
+  const state = meta?.states?.find((s) => (s.title ?? "").trim().toLowerCase() === normalized);
+  if (state?.color) {
+    const ramp = DESK_COLOR_TO_RAMP[state.color.trim().toLowerCase()];
+    if (ramp) return rampToPill(ramp);
+  }
+  const ramp = STATUS_WORD_TO_RAMP[normalized];
+  return rampToPill(ramp ?? "gray");
+}

package/src/useFrappeAggregate.ts

@@ -99,7 +99,7 @@ const DEFAULT_DEBOUNCE_MS = 300;
 const dbCache = new Map<string, DbModule>();
 
 function getDb(baseURL: string, auth: FrappeAggregateConnection["auth"]): DbModule {
-  const key = `${baseURL}:${auth?.token ?? ""}:${auth?.type ?? ""}`;
+  const key = `${baseURL}:${auth?.useToken ? "t" : ""}:${auth?.token ?? ""}:${auth?.type ?? ""}`;
   let db = dbCache.get(key);
   if (!db) {
     const authConfig: AuthConfig | undefined = auth

package/types/FrappeForm.d.ts

@@ -81,9 +81,18 @@ export interface FrappeFormProps<TDoc extends {
     onSave?: (doc: Partial<TDoc>) => void;
     onCancel?: () => void;
     onDelete?: (doc: Partial<TDoc>) => void;
+    /**
+     * Opens the amended draft of a cancelled document (desk Amend). The draft
+     * carries `amended_from` and is also handed to the doctype's next
+     * create-mode FrappeForm, so navigating to one is enough. Absent, a
+     * cancelled document offers no Amend.
+     */
+    onAmend?: (draft: Partial<TDoc>) => void;
     /**
      * Given, the form is a read-only view of the record: its toolbar offers
-     * Edit (this callback) and Delete instead of Save and Cancel.
+     * Edit (this callback) instead of Save and Cancel, beside Delete and the
+     * document's Submit, Cancel or Amend. A document with nothing left to
+     * edit (cancelled, or submitted without allow_on_submit fields) shows no Edit.
      */
     onEdit?: () => void;
     /**
@@ -91,8 +100,9 @@ export interface FrappeFormProps<TDoc extends {
      * the doctype's record page: it reads the record from the path through
      * the FrappeProvider's navigation (`route/new` creates, `route/<name>`
      * views, `route/<name>/edit` edits), carries the detail page template,
-     * and after a save, cancel, edit or delete moves to the matching page.
-     * Callbacks given alongside it replace those moves.
+     * and after a save, cancel, edit or delete moves to the matching page;
+     * Amend opens the amended draft on `route/new`. Callbacks given alongside
+     * it replace those moves.
      */
     route?: string;
     showToolbar?: boolean;

package/types/FrappeForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FrappeForm.d.ts","sourceRoot":"","sources":["../src/FrappeForm.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"FrappeForm.d.ts","sourceRoot":"","sources":["../src/FrappeForm.tsx"],"names":[],"mappings":"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"}

package/types/FrappeFormActions.d.ts

@@ -0,0 +1,36 @@
+import type { DocAction, DocStatusIndicator } from "./formEngine/docLifecycle";
+export interface FrappeFormActionsProps {
+    /** Desk's state pill: Not Saved, Draft, Submitted or Cancelled. */
+    indicator?: DocStatusIndicator;
+    /** The one lifecycle action the document's state offers (resolveDocAction). */
+    action?: DocAction;
+    /** A save or a docstatus transition is in flight. */
+    busy: boolean;
+    /** The form is read-only: actions render, disabled with the reason. */
+    disabled: boolean;
+    onSave: () => void;
+    onSubmit: () => void;
+    /** Cancels the submitted document (docstatus 1 → 2). */
+    onCancelDocument: () => void;
+    /** Absent, a cancelled document offers no Amend: the host has nowhere to open the draft. */
+    onAmend?: () => void;
+    /** The live amendment of this cancelled document; Amend stays disabled while it exists. */
+    amendedAs?: string;
+    onDelete?: () => void;
+    /**
+     * Given, the form is a read-only view and this opens its editor. The
+     * caller leaves it out when the document has nothing left to edit.
+     */
+    onEdit?: () => void;
+    /** The host's leave action (discards unsaved edits first). */
+    onClose?: () => void;
+    closeDisabled?: boolean;
+}
+/**
+ * FrappeForm's action bar with desk's docstatus lifecycle: one primary
+ * action at a time (Save, Submit, Update or Amend), Cancel Document as the
+ * secondary destructive action on a submitted document, and the state pill.
+ * A read-only view trades Save and the leave button for Edit.
+ */
+export declare function FrappeFormActions({ indicator, action, busy, disabled, onSave, onSubmit, onCancelDocument, onAmend, amendedAs, onDelete, onEdit, onClose, closeDisabled, }: FrappeFormActionsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FrappeFormActions.d.ts.map

package/types/FrappeFormActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrappeFormActions.d.ts","sourceRoot":"","sources":["../src/FrappeFormActions.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAS/E,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,SAAS,EACT,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,aAAa,GACd,EAAE,sBAAsB,2CAgJxB"}