@multiplatform.one/backoffice 6.4.2 → 6.6.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"dirtyTracking.d.ts","sourceRoot":"","sources":["../../src/form/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/form/docinfo.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Docinfo permission normalization.
+ *
+ * The docinfo fetch itself lives in shared/useDocinfo (one deduped
+ * get_docinfo per document shared by the sidebar / timeline / form screen);
+ * the unused local `useDocInfo` getdoc loader was pruned by the integrator.
+ *
+ * NOTE: this bench returns `permissions: {"null": 0}` for token-auth users —
+ * an upstream quirk. `normalizeDocPermissions` treats a payload without a
+ * real `read` key as unusable and callers fall back to meta role rules.
+ */
+/**
+ * Returns per-doc permission flags when the payload is usable, else
+ * undefined (fall back to meta role rules). See module note on the
+ * `{"null": 0}` quirk.
+ */
+export declare function normalizeDocPermissions(permissions: Record<string, number> | undefined): Record<string, number> | undefined;
+//# sourceMappingURL=docinfo.d.ts.map

package/types/form/docinfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docinfo.d.ts","sourceRoot":"","sources":["../../src/form/docinfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAIpC"}

package/types/form/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 "../shared/useDoctypeMeta";
+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/form/fetchFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchFrom.d.ts","sourceRoot":"","sources":["../../src/form/fetchFrom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAuB7D,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/form/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 "../shared/useDoctypeMeta";
+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/form/fieldPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldPermissions.d.ts","sourceRoot":"","sources":["../../src/form/fieldPermissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,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/form/formActions.d.ts

@@ -0,0 +1,91 @@
+/**
+ * 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;
+    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/form/formActions.d.ts.map

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

package/types/form/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 "@multiplatform.one/frappe-ui";
+import { type PermLevelMatrix } from "./fieldPermissions";
+import type { DocFieldMeta } from "../shared/useDoctypeMeta";
+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/form/formLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formLayout.d.ts","sourceRoot":"","sources":["../../src/form/formLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAe,UAAU,EAAe,MAAM,8BAA8B,CAAC;AAEzF,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAM7D,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;AAwBD;;;;;;;;;;;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/form/platformHooks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Web-guarded platform hooks for the form view. Every DOM access is behind
+ * a `typeof window/document` guard so native (Hermes) and GNOME (GJS, no
+ * DOM) builds never touch browser globals. External links ride the
+ * platform-split openUrl (web window.open / native Linking / GNOME Gio).
+ */
+import { type BackofficeNavigationBlocker } from "../config/BackofficeProvider";
+/** Cmd/Ctrl+S → save (web only; native uses the toolbar button). */
+export declare function useSaveShortcut(enabled: boolean, onSave: () => void): void;
+/**
+ * Router-level dirty guard for navigations that bypass the screen's
+ * `navigate()` wrapper: browser back/forward on web (history pop) and the
+ * native back gesture/button. The actual blocker is host-injected through
+ * `BackofficeProvider integrations.useNavigationBlocker` (the one-adapter
+ * ships `useOneNavigationBlocker`); without one, only the in-app
+ * navigate() guard applies. The injected hook must be referentially stable
+ * for the provider's lifetime (rules of hooks).
+ */
+export declare function useNavigationDirtyGuard(isDirty: boolean): BackofficeNavigationBlocker;
+/** beforeunload dirty guard (web only). */
+export declare function useBeforeUnloadGuard(isDirty: boolean): void;
+/**
+ * Open a URL externally: new browser tab on web, system browser via
+ * Linking on iOS/Android, desktop handler on GNOME (platform openUrl
+ * twins). NOTE: bench URLs (printview) open unauthenticated off-web —
+ * the system browser has no app session.
+ */
+export declare function openInNewTab(url: string): boolean;
+/** External-URL capability — platform openUrl has a twin on every target. */
+export declare function canOpenNewTab(): boolean;
+//# sourceMappingURL=platformHooks.d.ts.map

package/types/form/platformHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformHooks.d.ts","sourceRoot":"","sources":["../../src/form/platformHooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,8BAA8B,CAAC;AAEtC,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAkB1E;AAYD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,2BAA2B,CAIrF;AAED,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc3D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/types/form/sidebar-attachments.d.ts

@@ -0,0 +1,20 @@
+export interface SidebarAttachmentItem {
+    /** File doc name (remove_attach fid). */
+    id: string;
+    fileName: string;
+    /** Raw file_url from docinfo (may be relative to the bench). */
+    fileUrl: string;
+    isPrivate?: boolean;
+}
+export interface SidebarAttachmentsProps {
+    items: SidebarAttachmentItem[];
+    /** Bench base URL used to absolutize relative file_urls. */
+    baseURL?: string;
+    /** meta.max_attachments (0/undefined = unlimited). */
+    maxAttachments?: number;
+    disabled?: boolean;
+    onUpload?: (file: File) => void;
+    onRemove?: (item: SidebarAttachmentItem) => void;
+}
+export declare function SidebarAttachments({ items, baseURL, maxAttachments, disabled, onUpload, onRemove, }: SidebarAttachmentsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=sidebar-attachments.d.ts.map

package/types/form/sidebar-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-attachments.d.ts","sourceRoot":"","sources":["../../src/form/sidebar-attachments.tsx"],"names":[],"mappings":"AAgBA,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,OAAO,EACP,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,EAAE,uBAAuB,2CAiGzB"}

package/types/form/sidebar-dialogs.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Sidebar add dialogs: assign-to (user autocomplete + optional comment) and
+ * share-with (user autocomplete + can-edit toggle). User autocomplete rides
+ * the frappe-ui Link field, which searches `frappe.desk.search.search_link`
+ * (doctype=User) through the ambient FrappeProvider.
+ */
+export interface SidebarAssignDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onAssign: (user: string, description?: string) => void;
+}
+export declare function SidebarAssignDialog({ open, onOpenChange, onAssign }: SidebarAssignDialogProps): import("react/jsx-runtime").JSX.Element;
+export interface SidebarShareDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    onShare: (user: string, canWrite: boolean) => void;
+}
+export declare function SidebarShareDialog({ open, onOpenChange, onShare }: SidebarShareDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=sidebar-dialogs.d.ts.map

package/types/form/sidebar-dialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-dialogs.d.ts","sourceRoot":"","sources":["../../src/form/sidebar-dialogs.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,wBAAwB,2CA2C7F;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,uBAAuB,2CA6C1F"}

package/types/form/sidebar-people.d.ts

@@ -0,0 +1,42 @@
+/**
+ * People rows for the form sidebar (Assigned To / Shared With) and the
+ * compact avatar strip (Liked By). Unlike frappe-ui FormSidebar's built-in
+ * initials-only rows, these render the docinfo `user_info` image with an
+ * initials fallback — desk parity for user chips.
+ */
+export interface SidebarPersonItem {
+    /** Stable row id (assignment/share row name, or the user id). */
+    id: string;
+    /** User id (email) the action RPCs target. */
+    user: string;
+    /** Display name (user_info fullname, falls back to the user id). */
+    label: string;
+    /** Secondary line (assignment description, share level, …). */
+    sublabel?: string;
+    /** Avatar image URL (user_info image), absolute. */
+    image?: string;
+    /** Hide the remove affordance for this row (e.g. "Everyone" shares). */
+    removable?: boolean;
+}
+export interface SidebarPeopleListProps {
+    items: SidebarPersonItem[];
+    emptyText: string;
+    onRemove?: (item: SidebarPersonItem) => void;
+    disabled?: boolean;
+}
+export declare function SidebarPeopleList({ items, emptyText, onRemove, disabled, }: SidebarPeopleListProps): import("react/jsx-runtime").JSX.Element;
+export interface SidebarAvatarStripProps {
+    items: Array<{
+        id: string;
+        label: string;
+        image?: string;
+    }>;
+    /**
+     * Clamp to the first `max` avatars and render a "+N" bubble for the rest
+     * (header-cluster readout). Unset = render every avatar (sidebar rows).
+     */
+    max?: number;
+}
+/** Overlapping mini-avatar strip (Liked By, header cluster assignees). */
+export declare function SidebarAvatarStrip({ items, max }: SidebarAvatarStripProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=sidebar-people.d.ts.map

package/types/form/sidebar-people.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-people.d.ts","sourceRoot":"","sources":["../../src/form/sidebar-people.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,EAAE,sBAAsB,2CA+CxB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,uBAAuB,kDA0BzE"}

package/types/form/sidebar-rpc.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Sidebar mutation RPCs — thin wrappers over the whitelisted desk methods,
+ * every payload probed against the live bench (frappe v15) 2026-08-12:
+ *
+ *   frappe.desk.form.assign_to.add        {doctype, name, assign_to: ["user"], description?}
+ *                                         → message: [{owner, name}]
+ *   frappe.desk.form.assign_to.remove     {doctype, name, assign_to: "user"} → message: [...]
+ *   frappe.desk.doctype.tag.tag.add_tag   {tag, dt, dn} → message: "<tag>"
+ *   frappe.desk.doctype.tag.tag.remove_tag{tag, dt, dn} → {}
+ *   frappe.desk.doctype.tag.tag.get_tags  {doctype, txt} → message: string[]
+ *   frappe.desk.like.toggle_like          {doctype, name, add: "Yes"|"No"} → {}
+ *   frappe.share.add                      {doctype, name, user, read, write, share, notify}
+ *                                         → message: DocShare doc
+ *   frappe.share.set_permission           {doctype, name, user, permission_to: "read", value: 0}
+ *                                         removes the share (share.remove is NOT whitelisted)
+ *   frappe.desk.form.document_follow.follow_document / unfollow_document
+ *                                         {doctype, doc_name, user} (no-op when document
+ *                                         follow is disabled server-side)
+ *   upload_file (multipart via app.file()) {file, doctype, docname} → message: File doc
+ *   frappe.desk.form.utils.remove_attach  {fid, dt, dn} → {}
+ *   frappe.auth.get_logged_user           → message: "Administrator"
+ */
+import type { FrappeApp } from "@multiplatform.one/frappe";
+export declare function addAssignment(app: FrappeApp, doctype: string, name: string, users: string[], description?: string): Promise<unknown>;
+export declare function removeAssignment(app: FrappeApp, doctype: string, name: string, user: string): Promise<unknown>;
+export declare function addTag(app: FrappeApp, doctype: string, name: string, tag: string): Promise<unknown>;
+export declare function removeTag(app: FrappeApp, doctype: string, name: string, tag: string): Promise<unknown>;
+/** All existing tag names for the doctype (sidebar add-tag suggestions). */
+export declare function fetchTagSuggestions(app: FrappeApp, doctype: string): Promise<string[]>;
+export declare function toggleLike(app: FrappeApp, doctype: string, name: string, add: boolean): Promise<unknown>;
+export declare function followDocument(app: FrappeApp, doctype: string, name: string, user: string): Promise<unknown>;
+export declare function unfollowDocument(app: FrappeApp, doctype: string, name: string, user: string): Promise<unknown>;
+export declare function addShare(app: FrappeApp, doctype: string, name: string, user: string, options?: {
+    write?: boolean;
+}): Promise<unknown>;
+/** Dropping read cascades server-side and deletes the DocShare row. */
+export declare function removeShare(app: FrappeApp, doctype: string, name: string, user: string): Promise<unknown>;
+export declare function uploadAttachment(app: FrappeApp, file: File | Blob, doctype: string, name: string): Promise<unknown>;
+export declare function removeAttachment(app: FrappeApp, fileId: string, doctype: string, name: string): Promise<unknown>;
+/** Session user via frappe.auth.get_logged_user, cached per FrappeApp. */
+export declare function useCurrentUser(app: FrappeApp | undefined, override?: string): string | undefined;
+//# sourceMappingURL=sidebar-rpc.d.ts.map

package/types/form/sidebar-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-rpc.d.ts","sourceRoot":"","sources":["../../src/form/sidebar-rpc.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAW3D,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAMlB;AAMD,wBAAgB,MAAM,CACpB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAgB,SAAS,CACvB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,4EAA4E;AAC5E,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAK5F;AAMD,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAMlB;AAMD,wBAAgB,QAAQ,CACtB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAChC,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CACzB,GAAG,EAAE,SAAS,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAQlB;AAMD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,IAAI,GAAG,IAAI,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,SAAS,EACd,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,OAAO,CAAC,CAMlB;AAQD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA6BhG"}

package/types/form/sidebar-utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Pure helpers for the form sidebar: frappe timestamp parsing, relative
+ * time (byline), tag-string parsing, file-url resolution, and web-guarded
+ * platform affordances (new tab, file picker). No React, no DOM assumptions
+ * outside the explicit guards — safe on web, iOS/Android (Hermes), and GTK
+ * (GJS, no DOM). External links ride the platform-split openUrl.
+ */
+/** i18next-compatible translate signature (key, default, interpolation). */
+export type SidebarTranslate = (key: string, defaultValue: string, options?: Record<string, unknown>) => string;
+/** Parse a frappe timestamp ("2026-08-12 09:35:15.684756" or ISO). */
+export declare function parseFrappeDate(value: unknown): Date | undefined;
+/**
+ * Desk-style relative time ("just now", "5 minutes ago", "3 weeks ago").
+ * Future timestamps (clock skew) collapse to "just now".
+ */
+export declare function formatRelativeTime(value: unknown, t: SidebarTranslate, nowMs?: number): string | undefined;
+/**
+ * docinfo `tags` is a comma-joined string ("probe-two,sidebar-probe" on the
+ * live bench; older payloads may carry a leading comma or JSON "[]").
+ */
+export declare function parseTagString(tags: unknown): string[];
+/** Resolve a (possibly relative) file_url against the bench base URL. */
+export declare function toAbsoluteUrl(baseURL: string | undefined, url: string): string;
+/** External-URL capability — platform openUrl has a twin on every target. */
+export declare function canOpenUrl(): boolean;
+/** Open a URL externally (web new tab / native Linking / GNOME Gio). */
+export declare function openUrl(url: string): boolean;
+/** True when a DOM file picker is available (web). */
+export declare function canPickFile(): boolean;
+/**
+ * Web file picker via a transient `<input type="file">` (imperative — no DOM
+ * JSX so native/GTK bundles never see browser intrinsics). Resolves with the
+ * picked file, or undefined on cancel / unsupported platform.
+ */
+export declare function pickFile(accept?: string): Promise<File | undefined>;
+//# sourceMappingURL=sidebar-utils.d.ts.map

package/types/form/sidebar-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-utils.d.ts","sourceRoot":"","sources":["../../src/form/sidebar-utils.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAC7B,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,MAAM,CAAC;AAEZ,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAKhE;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,CAAC,EAAE,gBAAgB,EACnB,KAAK,SAAa,GACjB,MAAM,GAAG,SAAS,CA2CpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAoBtD;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG5C;AAED,sDAAsD;AACtD,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAmBnE"}

package/types/form/timeline-entries.d.ts

@@ -0,0 +1,93 @@
+import type { TimelineEntry } from "@multiplatform.one/components";
+/** Any docinfo row — fields are unknown and validated at map time. */
+export interface TimelineRowLike {
+    name?: unknown;
+    creation?: unknown;
+    owner?: unknown;
+    content?: unknown;
+    /** Version rows: JSON diff string */
+    data?: unknown;
+    /** Communication rows */
+    sender?: unknown;
+    sender_full_name?: unknown;
+    subject?: unknown;
+    communication_date?: unknown;
+}
+export interface TimelineUserInfoLike {
+    fullname?: unknown;
+    image?: unknown;
+    name?: unknown;
+    email?: unknown;
+}
+/** Structural docinfo shape the timeline can render. */
+export interface TimelineDocinfoLike {
+    user_info?: Record<string, TimelineUserInfoLike | undefined>;
+    comments?: readonly TimelineRowLike[];
+    versions?: readonly TimelineRowLike[];
+    communications?: readonly TimelineRowLike[];
+    automated_messages?: readonly TimelineRowLike[];
+    assignment_logs?: readonly TimelineRowLike[];
+    attachment_logs?: readonly TimelineRowLike[];
+    like_logs?: readonly TimelineRowLike[];
+    info_logs?: readonly TimelineRowLike[];
+}
+export type TimelineFeedKind = "comment" | "version" | "communication" | "automated" | "assignment" | "attachment" | "like" | "info";
+/** Desk-parity filter tabs: All / Comments / Edits. */
+export type TimelineFilterValue = "all" | "comments" | "edits";
+export interface VersionFieldChange {
+    field: string;
+    from?: string;
+    to?: string;
+}
+export interface ParsedVersionData {
+    changed: VersionFieldChange[];
+    /** Child-table fieldnames with added rows */
+    added: string[];
+    /** Child-table fieldnames with removed rows */
+    removed: string[];
+    /** Child-table fieldnames with edited rows */
+    rowChanged: string[];
+}
+export interface TimelineFeedEntry extends TimelineEntry {
+    kind: TimelineFeedKind;
+    /** Source document name (Comment name for update/delete RPCs) */
+    docname: string;
+    /** Owning user id — own-comment check for edit/delete */
+    ownerId?: string;
+    /** Resolved avatar image URL */
+    image?: string;
+    /** Original comment HTML (edit prefill) */
+    html?: string;
+    /** Communication subject line */
+    subject?: string;
+    /** Parsed version diff (undefined when data was malformed) */
+    version?: ParsedVersionData;
+    /** Epoch millis used for the newest-first sort */
+    epoch: number;
+}
+interface BuildOptions {
+    /** docinfo.user_info — resolves fullname/avatar for owners and senders */
+    userInfo?: Record<string, TimelineUserInfoLike | undefined>;
+    /** Frappe base URL for resolving relative avatar paths ("/files/…") */
+    baseURL?: string;
+}
+/**
+ * Parse a Version doc's `data` JSON string defensively — malformed or empty
+ * payloads yield undefined and render as a plain "made changes" row.
+ */
+export declare function parseVersionData(data: unknown): ParsedVersionData | undefined;
+export type TimelineTranslate = (key: string, options: {
+    defaultValue: string;
+} & Record<string, unknown>) => string;
+/**
+ * Desk-parity version sentence: single field change reads
+ * "changed value of X from a to b"; multi-field and child-table changes
+ * collapse to field lists ("changed values for X, Y" / "added rows for Z").
+ */
+export declare function versionSummary(version: ParsedVersionData, translate: TimelineTranslate): string;
+/** Merge every docinfo activity stream into one newest-first feed. */
+export declare function buildTimelineFeed(docinfo: TimelineDocinfoLike | undefined, options?: BuildOptions): TimelineFeedEntry[];
+/** Apply the All / Comments / Edits filter tabs. */
+export declare function filterTimelineFeed(entries: TimelineFeedEntry[], filter: TimelineFilterValue): TimelineFeedEntry[];
+export {};
+//# sourceMappingURL=timeline-entries.d.ts.map