@multiplatform.one/frappe-ui 7.6.3 → 7.7.0

package/types/dependsOn.d.ts

@@ -1,8 +1,8 @@
 /**
  * Safe evaluator for Frappe `depends_on` / `mandatory_depends_on` /
  * `read_only_depends_on` expressions — the ONE parser for every surface
- * (SchemaForm here, the backoffice form engine re-exports it from
- * `features/backoffice/form/dependsOn.ts`).
+ * (SchemaForm here, and the desk form engine next door in ./formEngine;
+ * `@multiplatform.one/backoffice` re-exports it from its old path).
  *
  * Frappe's desk evaluates these with JS `eval`; Hermes (React Native), GJS,
  * and CSP-restricted webviews cannot construct functions from strings, so

package/types/fields/CodeEditor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fields/CodeEditor/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAWL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5D,OAAO,KAAK,EAAkB,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA8BtE,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGlE;AA0CD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,IAAI,EAAE,QAAQ,EACd,UAAU,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,EAAE,EAAE,MAAM,EACV,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,QAAiB,EACjB,OAAW,EACX,OAAY,EACZ,YAAY,EAAE,SAAS,GACxB,EAAE,oBAAoB,2CAoItB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fields/CodeEditor/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAWL,KAAK,UAAU,EAChB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5D,OAAO,KAAK,EAAkB,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AA8BtE,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGlE;AA0CD,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,KAAK,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,eAAe,CAAC,EAC9B,IAAI,EACJ,IAAI,EAAE,QAAQ,EACd,UAAU,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,EAAE,EAAE,MAAM,EACV,KAAK,EACL,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,WAAW,EACX,QAAiB,EACjB,OAAW,EACX,OAAY,EACZ,YAAY,EAAE,SAAS,GACxB,EAAE,oBAAoB,2CAwItB"}

package/types/formEngine/createPrefill.d.ts

@@ -0,0 +1,19 @@
+/**
+ * One-shot create-mode prefill hand-off.
+ *
+ * Two producers, one mechanism:
+ * - Duplicate and Amend navigate to `newDocPath(doctype)` and stash the
+ *   copied values here (in-memory only — a refresh honestly falls back to
+ *   a blank form; no URL-size limits for large docs).
+ * - NewDocRouteScreen stashes parsed `?d=` URL defaults (kanban column "+",
+ *   calendar day click, connections "+") before rendering the form — those
+ *   survive refresh because the URL re-stashes them.
+ *
+ * The create-mode form (useFormEngine seeding) consumes and clears the
+ * stash on mount, merging it over meta defaults. Last stash per doctype
+ * wins, so a `?d=` navigation cannot double-apply with a stale
+ * Duplicate/Amend hand-off.
+ */
+export declare function setCreatePrefill(doctype: string, values: Record<string, unknown>): void;
+export declare function takeCreatePrefill(doctype: string): Record<string, unknown> | undefined;
+//# sourceMappingURL=createPrefill.d.ts.map

package/types/formEngine/createPrefill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPrefill.d.ts","sourceRoot":"","sources":["../../src/formEngine/createPrefill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEvF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAItF"}

package/types/formEngine/dirtyTracking.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Dirty tracking for the desk form engine (R-1 false "Not Saved" fix).
+ *
+ * The engine diffs the locally edited doc against the last server baseline.
+ * A strict `!==` diff falsely armed Save on untouched documents whenever a
+ * field's *representation* of a value differed from the wire format (mount
+ * emitters have been fixed at the field level — forms contract: initialization
+ * must not emit change events — but the engine stays defensive).
+ */
+export declare function isEmptyValue(value: unknown): boolean;
+/**
+ * Init-aware value equality. Two representation classes are folded:
+ *
+ * - empty: null / undefined / "" / [] are one empty state (a field
+ *   normalizing null → "" is not an edit)
+ * - boolean: Check wires 0/1 but a control may emit true/false
+ *
+ * Everything else stays strict equality — deliberately shallow and honest
+ * (no deep equality): desk parity means an edit reverted to a value that is
+ * merely *equivalent* (not identical) may still read dirty, while reverting
+ * to the exact original value reads clean.
+ */
+export declare function isSameValue(a: unknown, b: unknown): boolean;
+/**
+ * Names of fields whose local value differs from the baseline.
+ *
+ * - Edit mode (baseline defined): normalization-insensitive diff via
+ *   `isSameValue` — an untouched doc reads pristine even if a field
+ *   re-represented its value during initialization.
+ * - Create mode (no baseline): any non-empty value counts, defaults included —
+ *   desk parity, a new doc shows "Not Saved".
+ *
+ * `doctype` / `name` are bookkeeping, never dirty.
+ */
+export declare function computeDirtyFields(localDoc: Record<string, unknown>, baseline: Record<string, unknown> | undefined): string[];
+//# sourceMappingURL=dirtyTracking.d.ts.map

package/types/formEngine/dirtyTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dirtyTracking.d.ts","sourceRoot":"","sources":["../../src/formEngine/dirtyTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC5C,MAAM,EAAE,CASV"}

package/types/formEngine/doctypeMeta.d.ts

@@ -0,0 +1,117 @@
+/**
+ * DocType meta shapes as `frappe.desk.form.load.getdoctype` returns them.
+ *
+ * These were declared in `@multiplatform.one/backoffice`
+ * (`shared/useDoctypeMeta.ts`) while the desk form engine lived there. The
+ * engine now lives here (MPO-15), so the shapes it consumes live here too —
+ * a lower-tier package must never reach up into backoffice for a type.
+ * `useDoctypeMeta` (the loader hook, which needs the backoffice app context)
+ * stays where it is and re-exports these.
+ *
+ * Deliberately loose: the server is the source of truth, `0 | 1` flags are
+ * what the RPC actually sends, and the index signature carries the keys no
+ * surface has needed yet. `fieldtype` stays `string` here; narrowing it to
+ * the `FrappeFieldType` union is the remaining half of MPO-15's meta-model
+ * criterion and is tracked there, not silently done in a move.
+ */
+/** A single DocField row from a DocType meta (loose — server is source of truth). */
+export interface DocFieldMeta {
+    fieldname: string;
+    label?: string;
+    fieldtype: string;
+    options?: string;
+    reqd?: 0 | 1;
+    hidden?: 0 | 1;
+    read_only?: 0 | 1;
+    bold?: 0 | 1;
+    in_list_view?: 0 | 1;
+    in_standard_filter?: 0 | 1;
+    in_global_search?: 0 | 1;
+    allow_in_quick_entry?: 0 | 1;
+    allow_on_submit?: 0 | 1;
+    no_copy?: 0 | 1;
+    collapsible?: 0 | 1;
+    collapsible_depends_on?: string;
+    depends_on?: string;
+    mandatory_depends_on?: string;
+    read_only_depends_on?: string;
+    fetch_from?: string;
+    permlevel?: number;
+    length?: number;
+    default?: string;
+    description?: string;
+    precision?: string | number;
+    idx?: number;
+    [key: string]: unknown;
+}
+/** DocType Link child row (Connections tab). Probed: `group` arrives null when unset. */
+export interface DocLinkMeta {
+    name?: string;
+    link_doctype: string;
+    link_fieldname: string;
+    group?: string | null;
+    hidden?: 0 | 1;
+    is_child_table?: 0 | 1;
+    parent_doctype?: string;
+    table_fieldname?: string;
+    [key: string]: unknown;
+}
+/** Role permission row from the DocType meta. */
+export interface DocPermissionRule {
+    role?: string;
+    permlevel?: number;
+    read?: 0 | 1;
+    write?: 0 | 1;
+    create?: 0 | 1;
+    delete?: 0 | 1;
+    submit?: 0 | 1;
+    cancel?: 0 | 1;
+    amend?: 0 | 1;
+    print?: 0 | 1;
+    email?: 0 | 1;
+    share?: 0 | 1;
+    if_owner?: 0 | 1;
+    [key: string]: unknown;
+}
+/** DocType meta as returned by frappe.desk.form.load.getdoctype (loose). */
+export interface DoctypeMeta {
+    doctype?: string;
+    name: string;
+    module?: string;
+    issingle?: 0 | 1;
+    istable?: 0 | 1;
+    is_submittable?: 0 | 1;
+    is_tree?: 0 | 1;
+    /** Desk treeview_settings asset (`{doctype}_tree.js`) — gates Tree. */
+    __tree_js?: string;
+    /** Desk calendar_settings asset (`{doctype}_calendar.js`) — gates Calendar. */
+    __calendar_js?: string;
+    is_virtual?: 0 | 1;
+    editable_grid?: 0 | 1;
+    track_changes?: 0 | 1;
+    quick_entry?: 0 | 1;
+    autoname?: string;
+    naming_rule?: string;
+    allow_rename?: 0 | 1;
+    allow_copy?: 0 | 1;
+    read_only?: 0 | 1;
+    in_create?: 0 | 1;
+    hide_toolbar?: 0 | 1;
+    max_attachments?: number;
+    title_field?: string;
+    image_field?: string;
+    search_fields?: string;
+    sort_field?: string;
+    sort_order?: string;
+    icon?: string;
+    document_type?: string;
+    fields: DocFieldMeta[];
+    permissions?: DocPermissionRule[];
+    links?: DocLinkMeta[];
+    states?: Array<{
+        title?: string;
+        color?: string;
+    } & Record<string, unknown>>;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=doctypeMeta.d.ts.map

package/types/formEngine/doctypeMeta.d.ts.map

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

package/types/formEngine/fetchFrom.d.ts

@@ -0,0 +1,43 @@
+/**
+ * fetch_from client-side preview — desk parity with
+ * frappe/public/js/frappe/form/script_manager.js (`setup_add_fetch`) and
+ * controls/link.js (`validate_link_and_fetch`):
+ *
+ * - A field participates when `fetch_from` is "<link_field>.<source_field>"
+ *   AND (its fieldtype is in the scalar set desk registers, or it is
+ *   read_only / is_virtual).
+ * - When the link field changes to a value, desk calls
+ *   `frappe.client.validate_link` with the source columns and writes the
+ *   returned values onto the targets; clearing the link clears the targets.
+ * - `fetch_if_empty` targets keep a non-empty existing value (server
+ *   semantics; desk leaves such fields editable — see
+ *   `read_only_because_of_fetch_from`, base_input.js:56-66).
+ *
+ * The server remains authoritative: this is a preview so the user sees the
+ * fetched values before save.
+ */
+import type { DocFieldMeta } from "./doctypeMeta";
+export interface FetchRule {
+    /** Field to populate. */
+    target: string;
+    /** Column on the linked doc to read. */
+    source: string;
+    /** Only fill when the target is currently empty; never lock the field. */
+    fetchIfEmpty: boolean;
+}
+/** Map of link fieldname → fetch rules hanging off that link. */
+export type FetchMap = Map<string, FetchRule[]>;
+export declare function buildFetchMap(fields: DocFieldMeta[]): FetchMap;
+/**
+ * Values to patch onto the doc after the linked doc's columns arrive.
+ * `fetched` is empty when the link was cleared — desk then blanks the
+ * targets; `fetch_if_empty` targets holding a value are left alone in both
+ * directions (they belong to the user until the server reconciles).
+ */
+export declare function applyFetchedValues(rules: FetchRule[], fetched: Record<string, unknown>, currentDoc: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Desk's `read_only_because_of_fetch_from`: a fetch target without
+ * `fetch_if_empty` renders read-only while its source link holds a value.
+ */
+export declare function isFetchLocked(field: DocFieldMeta, doc: Record<string, unknown>): boolean;
+//# sourceMappingURL=fetchFrom.d.ts.map

package/types/formEngine/fetchFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchFrom.d.ts","sourceRoot":"","sources":["../../src/formEngine/fetchFrom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAuBlD,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAEhD,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAsB9D;AAMD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAKxF"}

package/types/formEngine/fieldPermissions.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Field-level permission matrix — desk parity with
+ * frappe/public/js/frappe/model/perm.js (`get_role_permissions` +
+ * `get_field_display_status`):
+ *
+ *   perm[level] = OR of meta.permissions rows whose role the session user
+ *   holds. A field at permlevel L then resolves to:
+ *     - no read at L  → hidden   ("None")
+ *     - read, no write → read-only ("Read")
+ *     - write          → editable ("Write", subject to the other rules)
+ *
+ * Levels that appear on fields but have no granting rows resolve to
+ * {read: false} — desk hides those fields (gap-filled `{}` in perm.js:153).
+ * When the caller has no role list (fixtures, roles RPC unavailable) the
+ * matrix is undefined and formLayout falls back to the conservative
+ * "permlevel > 0 → read-only" rule (never hides, never unlocks).
+ */
+import type { DocPermissionRule } from "./doctypeMeta";
+export interface LevelPerm {
+    read: boolean;
+    write: boolean;
+}
+/** Sparse array indexed by permlevel; missing entries mean "no rights". */
+export type PermLevelMatrix = LevelPerm[];
+export declare function buildPermLevelMatrix(permissions: DocPermissionRule[] | undefined, userRoles: string[] | undefined): PermLevelMatrix | undefined;
+/**
+ * Read access at a permlevel. Level 0 is implied by having the doc at all
+ * (docinfo/doc-level perms govern it — including share/if_owner grants the
+ * role matrix can't see), so only higher levels consult the matrix.
+ */
+export declare function canReadLevel(matrix: PermLevelMatrix | undefined, permlevel: number): boolean;
+/**
+ * Write access at a permlevel. Level 0 defers to the doc-level write flag
+ * (formReadOnly); higher levels require a granting role row — without a
+ * matrix the coarse fallback keeps them read-only (desk-safe direction).
+ */
+export declare function canWriteLevel(matrix: PermLevelMatrix | undefined, permlevel: number): boolean;
+//# sourceMappingURL=fieldPermissions.d.ts.map

package/types/formEngine/fieldPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldPermissions.d.ts","sourceRoot":"","sources":["../../src/formEngine/fieldPermissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG,SAAS,EAAE,CAAC;AAE1C,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,iBAAiB,EAAE,GAAG,SAAS,EAC5C,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,GAC9B,eAAe,GAAG,SAAS,CAc7B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAI5F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAI7F"}

package/types/formEngine/formActions.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Desk form RPC helpers — thin wrappers over the whitelisted methods the
+ * stock desk form view calls. Every payload here was probed against a live
+ * bench (frappe v15) before implementation:
+ *
+ *   frappe.desk.form.assign_to.add        {doctype, name, assign_to: [..], description?}
+ *   frappe.desk.form.assign_to.remove     {doctype, name, assign_to: "user"}
+ *   frappe.desk.form.utils.add_comment    {reference_doctype, reference_name, content,
+ *                                          comment_email, comment_by}
+ *   frappe.desk.doctype.tag.tag.add_tag   {tag, dt, dn}
+ *   frappe.desk.doctype.tag.tag.remove_tag{tag, dt, dn}
+ *   frappe.desk.like.toggle_like          {doctype, name, add: "Yes"|"No"}
+ *   frappe.desk.form.document_follow.follow_document / unfollow_document
+ *                                         {doctype, doc_name, user}
+ *   frappe.model.rename_doc.update_document_title
+ *                                         {doctype, docname, name, merge: 0} → new name
+ *                                         (what desk calls — syncs the title field too)
+ *   frappe.client.submit                  {doc} (full doc incl. modified — OCC enforced)
+ *   frappe.client.cancel                  {doctype, name}
+ *   frappe.client.get_count               {doctype, filters}
+ *   frappe.client.validate_link           {doctype, docname, fields: [..]} →
+ *                                         {name, <field>: value} (fetch_from preview)
+ *   frappe.core.doctype.communication.email.make
+ *                                         {doctype, name, recipients, subject, content,
+ *                                          send_email: 1}
+ *   frappe.desk.form.utils.remove_attach  {fid, dt, dn}
+ */
+import { HttpClient } from "@multiplatform.one/frappe";
+import type { FixtureProvider } from "@multiplatform.one/frappe";
+/**
+ * Connection shape shared by every form loader/action — structurally
+ * compatible with frappe-ui's FrappeConfig and the frappe package's
+ * UseFrappeCollectionConfig (function tokens included).
+ */
+export interface FrappeConnection {
+    baseURL: string;
+    socketPort?: number;
+    /** Same-origin socket override (see FrappeConfig.socketBaseURL). */
+    socketBaseURL?: string;
+    /** Frappe site name — the realtime Socket.IO namespace. */
+    siteName?: string;
+    auth?: {
+        useToken?: boolean;
+        token?: string | (() => string | Promise<string>);
+        type?: string;
+    };
+    syncOptions?: any;
+    fixtures?: FixtureProvider;
+}
+export declare function createHttpClient(connection: FrappeConnection): HttpClient;
+export declare function addAssignment(http: HttpClient, doctype: string, name: string, users: string[], description?: string): Promise<unknown>;
+export declare function removeAssignment(http: HttpClient, doctype: string, name: string, user: string): Promise<unknown>;
+export declare function addComment(http: HttpClient, args: {
+    doctype: string;
+    name: string;
+    content: string;
+    commentEmail: string;
+    commentBy?: string;
+}): Promise<unknown>;
+export declare function addTag(http: HttpClient, doctype: string, name: string, tag: string): Promise<unknown>;
+export declare function removeTag(http: HttpClient, doctype: string, name: string, tag: string): Promise<unknown>;
+export declare function toggleLike(http: HttpClient, doctype: string, name: string, add: boolean): Promise<unknown>;
+export declare function followDocument(http: HttpClient, doctype: string, name: string, user: string): Promise<unknown>;
+export declare function unfollowDocument(http: HttpClient, doctype: string, name: string, user: string): Promise<unknown>;
+/**
+ * Rename a document; resolves with the new name. Uses desk's own
+ * `update_document_title` (handles title-field sync; the bare
+ * `frappe.rename_doc` does not). Pass a `title` argument instead of `name`
+ * to retitle without renaming — not needed here yet.
+ */
+export declare function renameDoc(http: HttpClient, doctype: string, oldName: string, newName: string): Promise<string>;
+/** Submit a saved draft (docstatus 0 → 1). Requires the current full doc for OCC. */
+export declare function submitDoc(http: HttpClient, doc: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
+/** Cancel a submitted doc (docstatus 1 → 2). */
+export declare function cancelDoc(http: HttpClient, doctype: string, name: string): Promise<Record<string, unknown> | undefined>;
+/** Direct REST insert — returns the created doc (with its server-issued name). */
+export declare function insertDoc(http: HttpClient, doctype: string, values: Record<string, unknown>): Promise<Record<string, unknown>>;
+/**
+ * Validate a link value and fetch columns off the linked doc in one call —
+ * what desk's Link control uses to drive fetch_from previews. Resolves with
+ * `{name, <field>: value, ...}`; rejects when the target doc is missing.
+ */
+export declare function validateLink(http: HttpClient, doctype: string, docname: string, fields: string[]): Promise<Record<string, unknown>>;
+export declare function getCount(http: HttpClient, doctype: string, filters: Record<string, unknown>): Promise<number>;
+export declare function getLoggedUser(http: HttpClient): Promise<string>;
+export declare function removeAttachment(http: HttpClient, fileId: string, doctype: string, name: string): Promise<unknown>;
+export declare function uploadAttachment(http: HttpClient, file: File | Blob, doctype: string, name: string): Promise<unknown>;
+export declare function sendEmail(http: HttpClient, args: {
+    doctype: string;
+    name: string;
+    recipients: string;
+    subject: string;
+    content: string;
+}): Promise<unknown>;
+//# sourceMappingURL=formActions.d.ts.map

package/types/formEngine/formActions.d.ts.map

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

package/types/formEngine/formLayout.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Desk form layout engine.
+ *
+ * Splits the flat DocType field list into desk tabs (Tab Break), sections
+ * (Section Break, collapsible honored), and columns (Column Break), and
+ * maps them to the generic `FormSchema` consumed by frappe-ui's SchemaForm.
+ *
+ * Dynamic behavior is computed HERE with the safe depends_on evaluator
+ * (dependsOn.ts) — the `depends_on` string is deliberately stripped from the
+ * FieldSchema handed to SchemaForm so its string-eval-based evaluator
+ * (which cannot run on Hermes/GJS) never engages:
+ *
+ *   - depends_on            → field omitted from the built schema
+ *   - mandatory_depends_on  → `required: true` on the built FieldSchema
+ *   - read_only_depends_on  → `readOnly: true` on the built FieldSchema
+ *   - permlevel             → hidden without level read, read-only without
+ *     level write (role matrix via fieldPermissions.ts; coarse read-only
+ *     fallback when roles are unavailable)
+ *   - set_only_once         → read-only on saved docs
+ *   - fetch_from            → read-only while the source link holds a value
+ *     (unless fetch_if_empty)
+ *   - docstatus > 0         → everything read-only except allow_on_submit
+ *     fields on a submitted (1) doc
+ *   - collapsible / collapsible_depends_on / missing-mandatory → per-section
+ *     computed collapse state (desk refresh_section_collapse)
+ *
+ * Sections whose Section Break has a false depends_on hide wholesale; a
+ * section with no visible fields is dropped so SchemaForm never renders an
+ * empty card.
+ */
+import type { FormSchema } from "../schemaForm";
+import { type PermLevelMatrix } from "./fieldPermissions";
+import type { DocFieldMeta } from "./doctypeMeta";
+export interface FormTab {
+    /** Stable key (fieldname of the Tab Break or "__details") */
+    key: string;
+    label: string;
+    schema: FormSchema;
+}
+export interface BuildTabsOptions {
+    fields: DocFieldMeta[];
+    doc: Record<string, unknown>;
+    /** docstatus of the loaded doc (0 draft / 1 submitted / 2 cancelled). */
+    docstatus: number;
+    /** Meta-level read_only or missing write permission. */
+    formReadOnly: boolean;
+    /** Create mode relaxes read_only_depends_on on unsaved values. */
+    isCreate: boolean;
+    /** Default label for the implicit first tab. */
+    detailsLabel: string;
+    /**
+     * Role-derived permlevel matrix (fieldPermissions.ts). Desk semantics:
+     * fields at a level without read HIDE; read without write → read-only.
+     * Undefined (fixtures / roles unavailable) → coarse fallback: any
+     * permlevel > 0 renders read-only, never hidden.
+     */
+    permLevels?: PermLevelMatrix;
+    /** Host-hidden fields (fieldnames) — dropped before layout resolution. */
+    hiddenFields?: readonly string[];
+    /**
+     * Host-hidden sections/tabs. Matches a Section Break's or Tab Break's
+     * fieldname OR label; the whole section (or tab) is dropped.
+     */
+    hiddenSections?: readonly string[];
+}
+/**
+ * Build the desk tab list for the current doc state. Recomputed whenever
+ * the doc changes so depends_on chains re-resolve; the work is O(fields).
+ */
+export declare function buildFormTabs(options: BuildTabsOptions): FormTab[];
+/**
+ * Seed a create-mode doc from meta field defaults — desk parity with
+ * create_new.js get_default_value / set_default_values:
+ *
+ * - `Today` → today's date; `now` → time (Time) / local datetime (else)
+ * - `__user` / `user` (Link/Data only, avoiding Select option collisions)
+ *   → session user
+ * - Select fields with no default seed their first option
+ *   (create_new.js:107-114)
+ * - `:fieldname` boot sysdefaults, `frappe.*`, `user_fullname` stay unset —
+ *   server-resolved on insert (documented gap)
+ */
+export declare function buildCreateDefaults(fields: DocFieldMeta[], currentUser?: string): Record<string, unknown>;
+/**
+ * Copyable field values for Duplicate / Amend: strips standard bookkeeping
+ * fields, `no_copy` fields, layout breaks, and empty values.
+ */
+export declare function buildCopyValues(fields: DocFieldMeta[], doc: Record<string, unknown>): Record<string, unknown>;
+/** True when the doctype names docs by user prompt (show a name input). */
+export declare function isPromptNamed(autoname?: string, namingRule?: string): boolean;
+//# sourceMappingURL=formLayout.d.ts.map

package/types/formEngine/formLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formLayout.d.ts","sourceRoot":"","sources":["../../src/formEngine/formLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAE7D,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAMlD,MAAM,WAAW,OAAO;IACtB,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;CACpB;AAuDD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,YAAY,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,0EAA0E;IAC1E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAuFD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,EAAE,CAiElE;AAYD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EAAE,EACtB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqCzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,YAAY,EAAE,EACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4BzB;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAG7E"}

package/types/formEngine/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The desk form engine.
+ *
+ * Frappe's desk resolves a form from meta at render time: tabs and sections
+ * from the layout breaks, visibility and read-only from `depends_on` chains,
+ * `permlevel`, `set_only_once`, `fetch_from`, `docstatus`, and a
+ * save/submit/cancel/amend lifecycle on top. All of that used to live in
+ * `@multiplatform.one/backoffice`, so an app author who imported the
+ * EXPORTED `FrappeForm` got a strictly weaker form than the desk rendered
+ * for the same doctype (MPO-15).
+ *
+ * It lives here now. `@multiplatform.one/backoffice` re-exports every name
+ * from its previous paths, so existing imports — barrel and
+ * `@multiplatform.one/backoffice/src/form/*` deep — keep resolving.
+ */
+export type { DocFieldMeta, DocLinkMeta, DocPermissionRule, DoctypeMeta } from "./doctypeMeta";
+export { buildPermLevelMatrix, canReadLevel, canWriteLevel } from "./fieldPermissions";
+export type { LevelPerm, PermLevelMatrix } from "./fieldPermissions";
+export { applyFetchedValues, buildFetchMap, isFetchLocked } from "./fetchFrom";
+export type { FetchMap, FetchRule } from "./fetchFrom";
+export { computeDirtyFields, isEmptyValue, isSameValue } from "./dirtyTracking";
+export { setCreatePrefill, takeCreatePrefill } from "./createPrefill";
+export { buildCopyValues, buildCreateDefaults, buildFormTabs, isPromptNamed } from "./formLayout";
+export type { BuildTabsOptions, FormTab } from "./formLayout";
+export { useFormEngine } from "./useFormEngine";
+export type { FormEngine } from "./useFormEngine";
+//# sourceMappingURL=index.d.ts.map

package/types/formEngine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formEngine/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE/F,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEhF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClG,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/types/formEngine/useFormEngine.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The desk form state engine.
+ *
+ * - Edit mode: the doc lives in a name-filtered live collection
+ *   (useFrappeCollection + useLiveQuery) so realtime updates flow in; saves
+ *   write only dirty fields through the collection's optimistic update path
+ *   (live update_doc enforces If-Match OCC — a version conflict surfaces as
+ *   a save error and flips `conflict` so the UI can offer a reload).
+ * - Create mode: seeds meta defaults (+ optional Duplicate/Amend prefill)
+ *   and inserts via direct REST so the server-issued name is returned for
+ *   router.replace(formPath(...)).
+ * - Dirty tracking against the last server baseline; external updates land
+ *   on clean fields in place, dirty fields are preserved.
+ * - Submit / Cancel lifecycle for is_submittable doctypes via
+ *   frappe.client.submit / frappe.client.cancel (probed) — realtime then
+ *   refreshes the live doc; Amend is a create-mode copy with amended_from.
+ */
+import type { DoctypeMeta } from "./doctypeMeta";
+import type { FrappeConnection } from "./formActions";
+export interface FormEngine {
+    /** Current (locally edited) doc values. */
+    doc: Record<string, unknown>;
+    /** Last authoritative server snapshot (undefined in create mode). */
+    baseline: Record<string, unknown> | undefined;
+    isLoading: boolean;
+    /** Edit-mode doc missing after load settles (bad name / no permission). */
+    notFound: boolean;
+    /** The open doc was deleted on the server while open. */
+    wasDeleted: boolean;
+    isCreate: boolean;
+    isDirty: boolean;
+    dirtyFields: string[];
+    isSaving: boolean;
+    /** Per-field + `general` error messages. */
+    errors: Record<string, string>;
+    /** True after a save failed with a version conflict (OCC 409). */
+    conflict: boolean;
+    /** Logged-in user (for comments / likes / assignments). */
+    currentUser: string;
+    docstatus: number;
+    setValue: (field: string, value: unknown) => void;
+    /**
+     * Save. Create mode resolves with the server-issued doc name;
+     * edit mode resolves with the current name. Undefined = validation failed.
+     */
+    save: () => Promise<string | undefined>;
+    /** Submit lifecycle (is_submittable): docstatus 0 → 1. */
+    submit: () => Promise<boolean>;
+    /** Cancel lifecycle: docstatus 1 → 2. */
+    cancel: () => Promise<boolean>;
+    /** Delete the doc through the live collection. */
+    remove: () => Promise<boolean>;
+    /** Discard local edits / clear conflict, back to the server baseline. */
+    reload: () => void;
+    /** Client-side required validation (fires on save too). */
+    validate: () => Record<string, string>;
+}
+export declare function useFormEngine(connection: FrappeConnection | undefined, doctype: string, 
+/** Document name, or undefined for create mode. */
+name: string | undefined, meta: DoctypeMeta | undefined, translate: (key: string, options?: Record<string, unknown>) => string): FormEngine;
+//# sourceMappingURL=useFormEngine.d.ts.map

package/types/formEngine/useFormEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormEngine.d.ts","sourceRoot":"","sources":["../../src/formEngine/useFormEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAiBtD,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,2EAA2E;IAC3E,QAAQ,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAC;IAClB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,yCAAyC;IACzC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,kDAAkD;IAClD,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,yEAAyE;IACzE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAkCD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,gBAAgB,GAAG,SAAS,EACxC,OAAO,EAAE,MAAM;AACf,mDAAmD;AACnD,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,WAAW,GAAG,SAAS,EAC7B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GACpE,UAAU,CA2XZ"}

package/types/index.d.ts

@@ -24,7 +24,8 @@ export { FrappeCalendar, type FrappeCalendarProps, type CalendarViewType, type C
 export { FrappeGantt, type FrappeGanttProps } from "./FrappeGantt";
 export { resolveFrappeEventColor, frappeEventColorNames } from "./frappeEventColor";
 export { FrappeReportBuilder, type FrappeReportBuilderProps, type ReportColumn, type GroupByConfig, } from "./FrappeReportBuilder";
-export { FrappeDashboard, ChartCard, type FrappeDashboardProps, type DashboardDataSource, } from "./FrappeDashboard";
+export { FrappeDashboard, type FrappeDashboardProps, type DashboardDataSource, } from "./FrappeDashboard";
+export { ChartCard } from "./ChartCard";
 export { KPICard, calculateTrend, calculatePercentageChange, aggregateData, type DashboardWidget, type KPICardConfig, type KPICardProps, type ChartConfig, type ChartCardProps, type ChartDataPoint, type ChartType, type TrendDirection, } from "@multiplatform.one/components";
 export { FrappeKPICard, type FrappeKPICardProps, type FrappeKPIDataSource } from "./FrappeKPICard";
 export { FrappeChartCard, type FrappeChartCardProps, type FrappeChartDataSource, } from "./FrappeChartCard";
@@ -109,4 +110,6 @@ export { useFrappePagination, type UseFrappePaginationOptions, type UseFrappePag
 export { useFrappeCollection, useLiveQuery } from "@multiplatform.one/frappe";
 export type { DataTableColumn } from "@multiplatform.one/table";
 export { FrappeReportView, useFrappeReport, compactFilterValues, normalizeReportColumn, normalizeReportPayload, normalizeReportRows, reportColumnToDataTableColumn, reportFieldtypeToTableField, reportRowLabel, scrubFieldname, type FrappeReportColumn, type FrappeReportConnection, type FrappeReportFilterDef, type FrappeReportFixture, type FrappeReportPayload, type FrappeReportRow, type FrappeReportRunResponse, type FrappeReportValues, type FrappeReportViewProps, type UseFrappeReportOptions, type UseFrappeReportResult, } from "./FrappeReportView";
+export { applyFetchedValues, buildCopyValues, buildCreateDefaults, buildFetchMap, buildFormTabs, buildPermLevelMatrix, canReadLevel, canWriteLevel, computeDirtyFields, isEmptyValue, isFetchLocked, isPromptNamed, isSameValue, setCreatePrefill, takeCreatePrefill, useFormEngine, } from "./formEngine";
+export type { BuildTabsOptions, DocFieldMeta, DocLinkMeta, DocPermissionRule, DoctypeMeta, FetchMap, FetchRule, FormEngine, FormTab, LevelPerm, PermLevelMatrix, } from "./formEngine";
 //# sourceMappingURL=index.d.ts.map