@multiplatform.one/backoffice 6.4.0 → 6.4.2

package/src/workspace/types.ts

@@ -0,0 +1,135 @@
+/**
+ * Frappe Workspace doc shapes — verified against a real bench
+ * (`GET /api/resource/Workspace/<name>`; see WorkspaceScreen for the
+ * rendering contract). `content` is an editorjs-style JSON string of
+ * blocks; the child tables hold the referenced widget definitions.
+ */
+
+/** One row of the `shortcuts` child table (doctype "Workspace Shortcut"). */
+export interface WorkspaceShortcutRow {
+  name: string;
+  /** "DocType" | "Report" | "Page" | "Dashboard" | "URL" */
+  type: string;
+  link_to?: string;
+  /** URL shortcuts put the target here. */
+  url?: string;
+  label: string;
+  /** Optional list-view variant, e.g. "List" | "Tree" | "Report Builder". */
+  doc_view?: string;
+  /** Frappe color name for the count pill, e.g. "Grey", "Blue". */
+  color?: string;
+  /** JSON filters for the live count, e.g. `{"status":"Open"}`. */
+  stats_filter?: string;
+  /** Count display template, `{}` is the count, e.g. `"{} Open"`. */
+  format?: string;
+}
+
+/** One row of the `links` child table (doctype "Workspace Link"). */
+export interface WorkspaceLinkRow {
+  name: string;
+  /** "Card Break" starts a link group; "Link" is a member of the group. */
+  type: "Card Break" | "Link" | string;
+  label: string;
+  /** "DocType" | "Report" | "Page" — only on type "Link". */
+  link_type?: string;
+  link_to?: string;
+  hidden?: number;
+  onboard?: number;
+  is_query_report?: number;
+  /** On Card Break rows: number of links desk shows before "+ N more". */
+  link_count?: number;
+  dependencies?: string;
+}
+
+/** One row of the `charts` child table (doctype "Workspace Chart"). */
+export interface WorkspaceChartRow {
+  name: string;
+  /** Dashboard Chart doc name. */
+  chart_name: string;
+  label?: string;
+}
+
+/** One row of the `number_cards` child table (doctype "Workspace Number Card"). */
+export interface WorkspaceNumberCardRow {
+  name: string;
+  /** Number Card doc name. */
+  number_card_name: string;
+  label?: string;
+}
+
+/** One row of the `quick_lists` child table (doctype "Workspace Quick List"). */
+export interface WorkspaceQuickListRow {
+  name: string;
+  document_type: string;
+  label?: string;
+  /** JSON filters, e.g. `{"status":["=","Open"]}`. */
+  quick_list_filter?: string;
+}
+
+/** The Workspace document (fields the workspace page renders). */
+export interface WorkspaceDoc {
+  name: string;
+  doctype: string;
+  title?: string;
+  label?: string;
+  icon?: string;
+  module?: string;
+  public?: number;
+  is_hidden?: number;
+  /** JSON string of editorjs-style blocks. */
+  content?: string;
+  shortcuts?: WorkspaceShortcutRow[];
+  links?: WorkspaceLinkRow[];
+  charts?: WorkspaceChartRow[];
+  number_cards?: WorkspaceNumberCardRow[];
+  quick_lists?: WorkspaceQuickListRow[];
+  [key: string]: unknown;
+}
+
+// ---------------------------------------------------------------------------
+// Parsed `content` blocks
+// ---------------------------------------------------------------------------
+
+export type WorkspaceBlockType =
+  | "header"
+  | "paragraph"
+  | "shortcut"
+  | "card"
+  | "chart"
+  | "number_card"
+  | "quick_list"
+  | "spacer"
+  | "onboarding"
+  | (string & {});
+
+export interface WorkspaceBlock {
+  id: string;
+  type: WorkspaceBlockType;
+  data: {
+    /** header / paragraph: HTML-ish rich text. */
+    text?: string;
+    /** shortcut: matches `shortcuts[].label`. */
+    shortcut_name?: string;
+    /** card: matches a Card Break `links[].label`. */
+    card_name?: string;
+    /** chart: matches `charts[].chart_name`. */
+    chart_name?: string;
+    /** number_card: matches `number_cards[].number_card_name`. */
+    number_card_name?: string;
+    /** quick_list: matches `quick_lists[].document_type`. */
+    quick_list_name?: string;
+    /** 12-column grid span (3 = shortcut pill, 4 = card, 12 = full row). */
+    col?: number;
+    [key: string]: unknown;
+  };
+}
+
+/** A Card Break row grouped together with its following Link rows. */
+export interface WorkspaceLinkGroup {
+  label: string;
+  breakRow: WorkspaceLinkRow;
+  links: WorkspaceLinkRow[];
+}
+
+/** Frappe filter triple, ready for the frappe client (`[field, op, value]`). */
+export type FrappeFilterTuple = [string, string, unknown];

package/src/workspace/useDashboardChart.ts

@@ -0,0 +1,115 @@
+/**
+ * Dashboard Chart data for workspace chart blocks.
+ *
+ * Desk fetches chart data through the whitelisted RPC
+ * `frappe.desk.doctype.dashboard_chart.dashboard_chart.get` (POST with
+ * `chart_name`), which returns `{message: {labels: string[], datasets:
+ * [{name, values: number[]}]}}` — verified against the control bench.
+ * The chart *type* (Line/Bar/Pie/…) lives on the Dashboard Chart doc,
+ * which the block reads separately via `useFrappeDoc`.
+ *
+ * Fixture mode has no RPC surface — the hook reports `unsupported` and
+ * the block renders an informational card instead (documented gap).
+ */
+import { CallModule, HttpClient, type AuthConfig } from "@multiplatform.one/frappe";
+import { useFrappeConfig, type FrappeConfig } from "@multiplatform.one/frappe-ui";
+import { useCallback, useEffect, useRef, useState } from "react";
+
+export interface DashboardChartSeries {
+  labels: string[];
+  datasets: Array<{ name?: string; values: number[] }>;
+}
+
+export interface DashboardChartDoc {
+  name: string;
+  doctype: string;
+  chart_name?: string;
+  /** Render style: "Line" | "Bar" | "Percentage" | "Pie" | "Donut" | "Heatmap" */
+  type?: string;
+  /** Data source kind: "Count" | "Sum" | "Average" | "Group By" | "Report" | "Custom" */
+  chart_type?: string;
+  document_type?: string;
+  [key: string]: unknown;
+}
+
+export interface UseDashboardChartDataResult {
+  series: DashboardChartSeries | undefined;
+  isLoading: boolean;
+  error: Error | undefined;
+  /** Fixture mode (stories/tests) — no RPC available for chart data. */
+  unsupported: boolean;
+  refresh: () => void;
+}
+
+const callCache = new Map<string, CallModule>();
+
+function getCall(config: FrappeConfig): CallModule {
+  const key = `${config.baseURL}:${config.auth?.token ?? ""}:${config.auth?.type ?? ""}`;
+  let call = callCache.get(key);
+  if (!call) {
+    const authConfig: AuthConfig | undefined = config.auth
+      ? {
+          useToken: config.auth.useToken,
+          token: config.auth.token,
+          type: config.auth.type as AuthConfig["type"],
+        }
+      : undefined;
+    call = new CallModule(new HttpClient(config.baseURL, authConfig));
+    callCache.set(key, call);
+  }
+  return call;
+}
+
+const CHART_GET_METHOD = "frappe.desk.doctype.dashboard_chart.dashboard_chart.get";
+
+/** Fetch a Dashboard Chart's series via the desk RPC (live mode only). */
+export function useDashboardChartData(chartName: string | undefined): UseDashboardChartDataResult {
+  const config = useFrappeConfig();
+  const [series, setSeries] = useState<DashboardChartSeries | undefined>(undefined);
+  const [isLoading, setIsLoading] = useState(!!chartName && !config?.fixtures);
+  const [error, setError] = useState<Error | undefined>(undefined);
+  const fetchSeq = useRef(0);
+
+  const configRef = useRef(config);
+  configRef.current = config;
+
+  const unsupported = !!config?.fixtures;
+
+  const runFetch = useCallback(async (name: string) => {
+    const conn = configRef.current;
+    if (conn?.fixtures) return;
+    const seq = ++fetchSeq.current;
+    setIsLoading(true);
+    setError(undefined);
+    try {
+      if (!conn?.baseURL) {
+        throw new Error("useDashboardChartData requires a FrappeProvider with baseURL");
+      }
+      const res = await getCall(conn).post<{ message: DashboardChartSeries }>(CHART_GET_METHOD, {
+        chart_name: name,
+        refresh: 1,
+      });
+      if (seq !== fetchSeq.current) return;
+      setSeries(res.payload.message);
+    } catch (err) {
+      if (seq !== fetchSeq.current) return;
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      if (seq === fetchSeq.current) setIsLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (!chartName || unsupported) {
+      setIsLoading(false);
+      return;
+    }
+    void runFetch(chartName);
+  }, [chartName, unsupported, runFetch, config?.baseURL]);
+
+  const refresh = useCallback(() => {
+    if (chartName) void runFetch(chartName);
+  }, [chartName, runFetch]);
+
+  return { series, isLoading, error, unsupported, refresh };
+}

package/src/workspace/useWorkspaceDoc.ts

@@ -0,0 +1,111 @@
+/**
+ * Single-doc fetch for the workspace page.
+ *
+ * A Workspace doc is read-mostly chrome (its child tables define the page
+ * layout), so a plain REST `getDoc` through the frappe client is a better
+ * fit than spinning up a live collection for one document. Honors the
+ * FrappeProvider's fixture provider so stories/tests run offline.
+ */
+import { DbModule, HttpClient, type AuthConfig } from "@multiplatform.one/frappe";
+import { useFrappeConfig, type FrappeConfig } from "@multiplatform.one/frappe-ui";
+import { useCallback, useEffect, useRef, useState } from "react";
+import type { WorkspaceDoc } from "./types";
+
+// One REST client per connection — screens sharing a bench share it.
+const dbCache = new Map<string, DbModule>();
+
+function getDb(config: FrappeConfig): DbModule {
+  const key = `${config.baseURL}:${config.auth?.token ?? ""}:${config.auth?.type ?? ""}`;
+  let db = dbCache.get(key);
+  if (!db) {
+    const authConfig: AuthConfig | undefined = config.auth
+      ? {
+          useToken: config.auth.useToken,
+          token: config.auth.token,
+          type: config.auth.type as AuthConfig["type"],
+        }
+      : undefined;
+    db = new DbModule(new HttpClient(config.baseURL, authConfig));
+    dbCache.set(key, db);
+  }
+  return db;
+}
+
+export interface UseFrappeDocResult<TDoc> {
+  doc: TDoc | undefined;
+  /** First load in flight — render a skeleton. */
+  isLoading: boolean;
+  error: Error | undefined;
+  /** True when the server rejected the read (HTTP 403). */
+  isPermissionError: boolean;
+  refresh: () => void;
+}
+
+/** Fetch one document via REST (or the provider's fixtures when present). */
+export function useFrappeDoc<TDoc extends { name: string; doctype: string }>(
+  doctype: string,
+  name: string | undefined,
+): UseFrappeDocResult<TDoc> {
+  const config = useFrappeConfig();
+  const [doc, setDoc] = useState<TDoc | undefined>(undefined);
+  const [isLoading, setIsLoading] = useState(!!name);
+  const [error, setError] = useState<Error | undefined>(undefined);
+  const fetchSeq = useRef(0);
+
+  const configRef = useRef(config);
+  configRef.current = config;
+
+  const runFetch = useCallback(
+    async (docName: string) => {
+      const conn = configRef.current;
+      const seq = ++fetchSeq.current;
+      setIsLoading(true);
+      setError(undefined);
+      try {
+        let result: TDoc | undefined;
+        if (conn?.fixtures) {
+          const fixtureDoc = await conn.fixtures.getDoc(doctype, docName);
+          if (!fixtureDoc) throw new Error(`${doctype} ${docName} not found`);
+          result = fixtureDoc as unknown as TDoc;
+        } else if (conn?.baseURL) {
+          result = (await getDb(conn).getDoc(doctype, docName)) as unknown as TDoc;
+        } else {
+          throw new Error("useFrappeDoc requires a FrappeProvider with baseURL or fixtures");
+        }
+        if (seq !== fetchSeq.current) return;
+        setDoc(result);
+      } catch (err) {
+        if (seq !== fetchSeq.current) return;
+        setDoc(undefined);
+        setError(err instanceof Error ? err : new Error(String(err)));
+      } finally {
+        if (seq === fetchSeq.current) setIsLoading(false);
+      }
+      // doctype is stable per hook usage; config flows through configRef.
+      // eslint-disable-next-line react-hooks/exhaustive-deps
+    },
+    [doctype],
+  );
+
+  useEffect(() => {
+    if (!name) {
+      setDoc(undefined);
+      setIsLoading(false);
+      return;
+    }
+    void runFetch(name);
+  }, [name, runFetch, config?.baseURL, config?.fixtures]);
+
+  const refresh = useCallback(() => {
+    if (name) void runFetch(name);
+  }, [name, runFetch]);
+
+  const isPermissionError = (error as { status?: number } | undefined)?.status === 403;
+
+  return { doc, isLoading, error, isPermissionError, refresh };
+}
+
+/** Fetch a Workspace doc by proper-cased name (e.g. "Home", "Users"). */
+export function useWorkspaceDoc(workspace: string): UseFrappeDocResult<WorkspaceDoc> {
+  return useFrappeDoc<WorkspaceDoc>("Workspace", workspace);
+}

package/types/chrome/CommandPalette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../src/chrome/CommandPalette.tsx"],"names":[],"mappings":"AAwDA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,mBAAmB,2CAyPzE"}
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../src/chrome/CommandPalette.tsx"],"names":[],"mappings":"AAwDA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,mBAAmB,2CA6QzE"}

package/types/i18n/en.d.ts

@@ -61,6 +61,25 @@ export declare const en: {
         readonly exitToSite: "← multiplatform.one";
         readonly logOut: "Log Out";
     };
+    readonly loading: "Loading";
+    readonly workspaceCardEmpty: "No links in this section";
+    readonly workspaceShortcutUnavailable: "Not available";
+    readonly workspaceQuickListViewAll: "View All";
+    readonly workspaceNumberCardError: "Couldn't load number card";
+    readonly workspaceNumberCardUnsupported: "This card type is only available in desk";
+    readonly workspaceChartFixture: "Chart data is only available on a live bench";
+    readonly workspaceChartError: "Couldn't load chart {{title}}";
+    readonly workspaceBrowseAll: "Browse all";
+    readonly workspaceBrowseAllCount_one: "{{count}} link";
+    readonly workspaceBrowseAllCount_other: "{{count}} links";
+    readonly workspaceFilterLinks: "Filter links...";
+    readonly workspaceFilterNoMatch: "No links match \"{{query}}\"";
+    readonly workspaceRecents: "Continue where you left off";
+    readonly workspacePermissionError: "You do not have permission to view {{workspace}}";
+    readonly workspaceError: "Couldn't load workspace {{workspace}}";
+    readonly workspaceEmpty: "This workspace is empty";
+    readonly workspaceEmptyDescription: "No blocks have been added to {{workspace}} yet";
+    readonly workspaceShortcuts: "Shortcuts";
     readonly help: {
         readonly label: "Help";
         readonly documentation: "Documentation";

package/types/i18n/en.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/i18n/en.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0EL,CAAC"}
+{"version":3,"file":"en.d.ts","sourceRoot":"","sources":["../../src/i18n/en.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+FL,CAAC"}

package/types/index.d.ts

@@ -52,4 +52,38 @@ export type { SessionUserInfo } from "./chrome/user-session";
 export { useBackofficeShortcuts } from "./chrome/shortcuts";
 export type { BackofficeShortcutHandlers } from "./chrome/shortcuts";
 export { useFrappeApp } from "./shared/useFrappeApp";
+export type { FrappeFilter, FrappeFilters, SlugTarget } from "./shared/types";
+export { useDoctypeMeta } from "./shared/useDoctypeMeta";
+export type { DocFieldMeta, DocLinkMeta, DocPermissionRule, DoctypeMeta, DoctypeMetaBundle, } from "./shared/useDoctypeMeta";
+export { invalidateDocinfo, useDocinfo } from "./shared/useDocinfo";
+export type { DocInfo, DocInfoComment } from "./shared/useDocinfo";
+export { useSlugTarget } from "./shared/useSlugTarget";
+export { useUserRoles } from "./shared/useUserRoles";
+export { useRecentVisit } from "./shared/useRecentVisit";
+export type { RecentVisit } from "./shared/useRecentVisit";
+export { useSessionUserId } from "./shared/useSessionUserId";
+export type { FrappeFilterTuple, WorkspaceBlock, WorkspaceBlockType, WorkspaceChartRow, WorkspaceLinkGroup, WorkspaceLinkRow, WorkspaceNumberCardRow, WorkspaceDoc as WorkspacePageDoc, WorkspaceQuickListRow, WorkspaceShortcutRow, } from "./workspace/types";
+export { composeWorkspaceBlocks, findLinkGroup, findShortcut, groupLinks, headerLevel, parseFrappeFilters, parseWorkspaceContent, stripHtml, } from "./workspace/parseContent";
+export type { WorkspaceComposition } from "./workspace/parseContent";
+export { useFrappeDoc, useWorkspaceDoc } from "./workspace/useWorkspaceDoc";
+export type { UseFrappeDocResult } from "./workspace/useWorkspaceDoc";
+export { useDashboardChartData } from "./workspace/useDashboardChart";
+export type { DashboardChartDoc, DashboardChartSeries, UseDashboardChartDataResult, } from "./workspace/useDashboardChart";
+export { WorkspaceGrid } from "./workspace/WorkspaceGrid";
+export type { WorkspaceGridItem, WorkspaceGridProps } from "./workspace/WorkspaceGrid";
+export { WorkspaceLinkCard, resolveLinkTarget } from "./workspace/WorkspaceLinkCard";
+export type { WorkspaceLinkCardProps } from "./workspace/WorkspaceLinkCard";
+export { WorkspaceShortcut, resolveShortcutTarget } from "./workspace/WorkspaceShortcut";
+export type { WorkspaceShortcutProps } from "./workspace/WorkspaceShortcut";
+export { WorkspaceQuickList } from "./workspace/WorkspaceQuickList";
+export type { WorkspaceQuickListProps } from "./workspace/WorkspaceQuickList";
+export { WorkspaceNumberCard } from "./workspace/WorkspaceNumberCard";
+export type { NumberCardDoc, WorkspaceNumberCardProps } from "./workspace/WorkspaceNumberCard";
+export { WorkspaceChartBlock } from "./workspace/WorkspaceChartBlock";
+export type { WorkspaceChartBlockProps } from "./workspace/WorkspaceChartBlock";
+export { WorkspaceLinkDirectory, filterLinkGroup } from "./workspace/WorkspaceLinkDirectory";
+export type { WorkspaceLinkDirectoryItem, WorkspaceLinkDirectoryProps, } from "./workspace/WorkspaceLinkDirectory";
+export { WorkspaceRecents } from "./workspace/WorkspaceRecents";
+export { WorkspaceScreen } from "./workspace/WorkspaceScreen";
+export type { WorkspaceBlockKind, WorkspaceScreenProps } from "./workspace/WorkspaceScreen";
 //# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

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

package/types/shared/types.d.ts

@@ -0,0 +1,21 @@
+/** Shared backoffice types — contracts between the backoffice surfaces. */
+/** Result of resolving a URL slug to a navigable target. */
+export type SlugTarget = {
+    status: "loading";
+} | {
+    status: "resolved";
+    kind: "workspace";
+    workspace: string;
+} | {
+    status: "resolved";
+    kind: "doctype";
+    doctype: string;
+} | {
+    status: "not-found";
+    slug: string;
+};
+/** A frappe filter tuple: [fieldname, operator, value]. */
+export type FrappeFilter = [string, string, unknown];
+/** Filters exchanged between the list surface components. */
+export type FrappeFilters = FrappeFilter[];
+//# sourceMappingURL=types.d.ts.map

package/types/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAErD,6DAA6D;AAC7D,MAAM,MAAM,aAAa,GAAG,YAAY,EAAE,CAAC"}

package/types/shared/useDocinfo.d.ts

@@ -0,0 +1,61 @@
+export interface DocInfoComment {
+    name: string;
+    comment_type?: string;
+    content?: string;
+    owner?: string;
+    creation?: string;
+    [key: string]: unknown;
+}
+export interface DocInfo {
+    doctype?: string;
+    name?: string;
+    user_info?: Record<string, {
+        fullname?: string;
+        image?: string;
+        name?: string;
+    } & Record<string, unknown>>;
+    comments?: DocInfoComment[];
+    communications?: Array<Record<string, unknown>>;
+    automated_messages?: Array<Record<string, unknown>>;
+    versions?: Array<Record<string, unknown>>;
+    assignments?: Array<{
+        name?: string;
+        owner?: string;
+        description?: string;
+    } & Record<string, unknown>>;
+    assignment_logs?: Array<Record<string, unknown>>;
+    attachments?: Array<{
+        name?: string;
+        file_name?: string;
+        file_url?: string;
+        is_private?: 0 | 1;
+    } & Record<string, unknown>>;
+    attachment_logs?: Array<Record<string, unknown>>;
+    info_logs?: Array<Record<string, unknown>>;
+    like_logs?: Array<Record<string, unknown>>;
+    workflow_logs?: Array<Record<string, unknown>>;
+    shared?: Array<Record<string, unknown>>;
+    permissions?: Record<string, unknown>;
+    views?: Array<Record<string, unknown>>;
+    additional_timeline_content?: Array<Record<string, unknown>>;
+    milestones?: Array<Record<string, unknown>>;
+    is_document_followed?: number;
+    /** JSON string of tag list, e.g. "[]" or comma string — parse defensively */
+    tags?: string;
+    document_email?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Shared, deduped fetch of frappe's docinfo for a document. Multiple panels
+ * (sidebar, timeline, connections) share one fetch; `reload()` from any of
+ * them refreshes all subscribers.
+ */
+export declare function useDocinfo(doctype?: string, name?: string): {
+    docinfo?: DocInfo;
+    loading: boolean;
+    error?: Error;
+    reload: () => void;
+};
+/** Invalidate the docinfo cache for a document (after mutations). */
+export declare function invalidateDocinfo(doctype: string, name: string): void;
+//# sourceMappingURL=useDocinfo.d.ts.map

package/types/shared/useDocinfo.d.ts.map

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

package/types/shared/useDoctypeMeta.d.ts

@@ -0,0 +1,118 @@
+/** 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;
+    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;
+}
+export interface DoctypeMetaBundle {
+    /** Parent doctype meta (docs[0]) */
+    meta: DoctypeMeta;
+    /** Child table doctype metas keyed by doctype name (docs[1..]) */
+    childMetas: Record<string, DoctypeMeta>;
+    /** Parsed user_settings (list view settings etc.), when present */
+    userSettings?: Record<string, unknown>;
+}
+/**
+ * Load (and cache, module-wide) the meta bundle for a doctype via
+ * `frappe.desk.form.load.getdoctype` — or, when the ambient FrappeProvider
+ * carries a fixture provider, from its "DocType" collection. All backoffice
+ * surfaces share this cache, so meta is fetched once per doctype per session.
+ */
+export declare function useDoctypeMeta(doctype?: string): {
+    bundle?: DoctypeMetaBundle;
+    meta?: DoctypeMeta;
+    loading: boolean;
+    error?: Error;
+    reload: () => void;
+};
+//# sourceMappingURL=useDoctypeMeta.d.ts.map