@multiplatform.one/frappe-ui 7.28.0 → 7.29.0

package/types/recordShape.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A doctype as far as one of its records shows it.
+ *
+ * DocType meta is permission-gated (Guest gets 403 on getdoctype) while the
+ * records themselves are often readable. A data-aware view that cannot read
+ * meta still owes the reader the weakest honest rendering of what they may
+ * read (LC-96): the record's own fields, labelled from their keys, typed from
+ * their values and read-only. These helpers are that shape, shared by every
+ * view that falls back to it.
+ */
+import { type DocTypeField } from "@multiplatform.one/frappe";
+/** Keys every Frappe record carries that are bookkeeping, not fields of its doctype. */
+export declare const recordBookkeepingKeys: ReadonlySet<string>;
+/**
+ * A record's own field keys in the order the server sent them. Bookkeeping
+ * keys, the live collection's `$` props ($origin, $key, $collectionId) and
+ * non-scalar values (child rows, objects) are dropped.
+ */
+export declare function recordFieldKeys(record: Record<string, unknown>): string[];
+/** "base_experience" → "Base Experience", for a key no meta names. */
+export declare function recordKeyLabel(key: string): string;
+/**
+ * The record's own fields as read-only doctype fields: Int or Float for a
+ * number, Data for anything else.
+ */
+export declare function fieldsFromRecord(record: Record<string, unknown>): DocTypeField[];
+export interface RecordShapeConnection {
+    baseURL?: string;
+    auth?: unknown;
+}
+export interface RecordShape {
+    /** The sampled record's fields, once it has been read. */
+    fields: DocTypeField[] | undefined;
+    /**
+     * `idle` when not asked, `pending` while the record is read, `ready` with
+     * fields, `unreadable` when the doctype has no record the reader may see.
+     */
+    status: "idle" | "pending" | "ready" | "unreadable";
+}
+/**
+ * Reads one record of `doctype` (`fields: ["*"]`, one row) and returns its
+ * fields. Only reads while `enabled`; a view turns it on when meta is refused.
+ */
+export declare function useRecordShape(connection: RecordShapeConnection | undefined, doctype: string, enabled: boolean): RecordShape;
+//# sourceMappingURL=recordShape.d.ts.map

package/types/recordShape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordShape.d.ts","sourceRoot":"","sources":["../src/recordShape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG3F,wFAAwF;AACxF,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAcpD,CAAC;AAMH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAOzE;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,CAUhF;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACnC;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;CACrD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,qBAAqB,GAAG,SAAS,EAC7C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,GACf,WAAW,CAwCb"}

package/types/report/ReportGrid.d.ts

@@ -0,0 +1,20 @@
+import { type ReportColumnDef, type ReportGridRow, type ReportSortState, type ReportTotalsCell } from "./reportViewModel";
+export interface ReportGridProps {
+    columns: readonly ReportColumnDef[];
+    rows: readonly ReportGridRow[];
+    sort: ReportSortState;
+    onSortChange: (sort: ReportSortState) => void;
+    /** Filter-row DRAFT values by fieldname (uncommitted text). */
+    columnFilters: Readonly<Record<string, string>>;
+    onColumnFilterChange: (fieldname: string, value: string) => void;
+    /** Open the row's document form. Absent, rows are not pressable. */
+    onOpenRow?: (name: string) => void;
+    /** Open a Link cell's target document. */
+    onOpenLink?: (doctype: string, name: string) => void;
+    /** Totals over the full filtered result — rendered as a bottom row. */
+    totals: readonly ReportTotalsCell[];
+    /** Group-by column (group header rows span the grid). */
+    groupByColumn?: ReportColumnDef;
+}
+export declare function ReportGrid({ columns, rows, sort, onSortChange, columnFilters, onColumnFilterChange, onOpenRow, onOpenLink, totals, groupByColumn, }: ReportGridProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ReportGrid.d.ts.map

package/types/report/ReportGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportGrid.d.ts","sourceRoot":"","sources":["../../src/report/ReportGrid.tsx"],"names":[],"mappings":"AAuBA,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,aAAa,EAElB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAgD3B,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B,IAAI,EAAE,eAAe,CAAC;IACtB,YAAY,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAC;IAC9C,+DAA+D;IAC/D,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,uEAAuE;IACvE,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACpC,yDAAyD;IACzD,aAAa,CAAC,EAAE,eAAe,CAAC;CACjC;AAgGD,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,MAAM,EACN,aAAa,GACd,EAAE,eAAe,2CAwUjB"}

package/types/report/ReportViewToolbar.d.ts

@@ -0,0 +1,31 @@
+import type { ReportColumnDef, ReportFilters } from "./reportViewModel";
+import type { SavedReportSummary } from "./savedReports";
+export interface ReportViewToolbarProps {
+    /** Every pickable column (reportColumnsFromMeta). */
+    columns: readonly ReportColumnDef[];
+    /** Selected (visible) fieldnames, in render order. */
+    selected: readonly string[];
+    onToggleColumn: (fieldname: string) => void;
+    onResetColumns: () => void;
+    groupBy: string | null;
+    onGroupByChange: (fieldname: string | null) => void;
+    /** Base filters (?f= deep link) — chips with a clear affordance. */
+    baseFilters: ReportFilters;
+    onClearBaseFilters?: () => void;
+    /** Count of active column-row filters (chip + clear-all). */
+    columnFilterCount: number;
+    onClearColumnFilters: () => void;
+    savedReports: readonly SavedReportSummary[];
+    /** Selected saved report name (null = unsaved/new). */
+    currentReport: string | null;
+    onSelectReport: (name: string | null) => void;
+    /** Save under a (new or existing) name. Absent, the view saves nothing. */
+    onSaveReport?: (name: string) => void;
+    /** Absent, a saved report cannot be deleted from here. */
+    onDeleteReport?: (name: string) => void;
+    /** Absent, the Export button is left out (no download path here). */
+    onExport?: () => void;
+    exportDisabled?: boolean;
+}
+export declare function ReportViewToolbar({ columns, selected, onToggleColumn, onResetColumns, groupBy, onGroupByChange, baseFilters, onClearBaseFilters, columnFilterCount, onClearColumnFilters, savedReports, currentReport, onSelectReport, onSaveReport, onDeleteReport, onExport, exportDisabled, }: ReportViewToolbarProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ReportViewToolbar.d.ts.map

package/types/report/ReportViewToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReportViewToolbar.d.ts","sourceRoot":"","sources":["../../src/report/ReportViewToolbar.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,sDAAsD;IACtD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACpD,oEAAoE;IACpE,WAAW,EAAE,aAAa,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,IAAI,CAAC;IACjC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC5C,uDAAuD;IACvD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9C,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,0DAA0D;IAC1D,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,QAAQ,EACR,cAAc,EACd,cAAc,EACd,OAAO,EACP,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,cAAc,GACf,EAAE,sBAAsB,2CA8OxB"}

package/types/report/queryReport.d.ts

@@ -0,0 +1,181 @@
+export interface QueryReportColumn {
+    fieldname: string;
+    label: string;
+    /** Frappe fieldtype ("Link", "Date", "Currency", … or "" when untyped). */
+    fieldtype: string;
+    /** Link target doctype (fieldtype "Link"). */
+    options?: string;
+    /** Desk pixel width hint (server sends strings like "90"). */
+    width?: number;
+    /** Float/Currency decimal places, when the column declares them. */
+    precision?: number;
+}
+export type QueryReportRow = Record<string, unknown>;
+export type QueryReportFilters = Record<string, unknown>;
+/**
+ * One report filter's declaration — from the Report doc `filters` child
+ * table (Report Filter rows) or extracted from the desk-side script module
+ * (which spells mandatory as `reqd`; both normalize to `mandatory`).
+ */
+export interface QueryReportFilterMeta {
+    fieldname: string;
+    label?: string;
+    fieldtype?: string;
+    options?: string;
+    /** Script modules declare numeric/boolean defaults; doc rows are strings. */
+    default?: string | number;
+    mandatory?: 0 | 1;
+    /** Desk wraps this filter's value in `%…%` before the run. */
+    wildcard_filter?: 0 | 1;
+    /** Applied (defaults included) but never rendered — desk parity. */
+    hidden?: 0 | 1;
+    /**
+     * Desk `read_only` — the control renders (so the value is honest) but
+     * cannot be edited. Locked filters must not open pickers (LC-21 family:
+     * a disabled control opens nothing).
+     */
+    read_only?: 0 | 1;
+}
+/** Report doc bits the screen cares about (loose — server owns the schema). */
+export interface QueryReportMeta {
+    name: string;
+    report_name?: string;
+    ref_doctype?: string;
+    report_type?: string;
+    disabled?: 0 | 1;
+    prepared_report?: 0 | 1;
+    add_total_row?: 0 | 1;
+    filters?: QueryReportFilterMeta[];
+    [key: string]: unknown;
+}
+/** Static data for stories/tests — skips every bench RPC. */
+export interface QueryReportFixture {
+    meta?: Partial<QueryReportMeta>;
+    /** Raw column shapes (dicts or "Label:Fieldtype/Options:Width" strings). */
+    columns: unknown[];
+    /** Raw rows (dicts or positional arrays). */
+    rows: unknown[];
+    message?: string;
+    /** Desk-side script module text (get_script response) for filter extraction. */
+    script?: string;
+}
+/**
+ * A report filter as a caller or the wire declares it (Report Filter rows,
+ * a `filterFields` prop, a fixture's `filters`): flags may be 0/1 or
+ * booleans, and a script module spells mandatory `reqd`.
+ * `normalizeFilterMeta` turns it into {@link QueryReportFilterMeta}.
+ */
+export interface QueryReportFilterInput {
+    fieldname: string;
+    label?: string;
+    fieldtype?: string;
+    options?: string | string[];
+    default?: unknown;
+    mandatory?: number | boolean;
+    reqd?: number | boolean;
+    wildcard_filter?: number | boolean;
+    hidden?: number | boolean;
+    read_only?: number | boolean;
+}
+/** Raw `frappe.desk.query_report.run` response body (`message`). */
+export interface QueryReportRunMessage {
+    columns?: unknown[];
+    result?: unknown[];
+    message?: string | string[] | null;
+    chart?: unknown;
+    report_summary?: unknown;
+    add_total_row?: number | boolean;
+    skip_total_row?: number | boolean;
+    execution_time?: number;
+    status?: string | null;
+    /**
+     * Fixture extension: filter declarations. The live endpoint does not send
+     * filters with `run`; fixtures may, so a fixture-backed view gets a filter
+     * bar without a second fixture surface.
+     */
+    filters?: QueryReportFilterInput[];
+}
+/** A normalized run: what a report table renders. */
+export interface QueryReportPayload {
+    columns: QueryReportColumn[];
+    rows: QueryReportRow[];
+    /** Server-side report message (already user-facing). */
+    message?: string;
+    /** True when the last row is the server-computed total row. */
+    addTotalRow: boolean;
+    /** Fixture-provided filter declarations (see QueryReportRunMessage). */
+    filters?: QueryReportFilterInput[];
+    /** The untouched response, for chart / report_summary consumers. */
+    raw: QueryReportRunMessage;
+}
+/**
+ * The server's `frappe.scrub`: `txt.replace(" ", "_").replace("-", "_").lower()`.
+ * A label-only column gets its fieldname this way on the server
+ * (`get_column_as_dict`), and the rows are keyed by that fieldname, so the
+ * client has to produce the same string, parentheses and slashes included.
+ */
+export declare function scrubFieldname(label: string): string;
+/** Best-effort HTML → text for report cell values and server messages. */
+export declare function stripHtml(value: string): string;
+/**
+ * Normalize run() columns: v15 sends dicts, older/custom reports may send
+ * "Label:Fieldtype/Options:Width" alias strings. Fieldnames are deduped so
+ * positional rows always land somewhere addressable.
+ */
+export declare function normalizeQueryReportColumns(raw: readonly unknown[] | undefined): QueryReportColumn[];
+/** Normalize run() rows: positional arrays are zipped onto column fieldnames. */
+export declare function normalizeQueryReportRows(raw: readonly unknown[] | undefined, columns: readonly QueryReportColumn[]): QueryReportRow[];
+export declare function normalizeFilterMeta(raw: unknown): QueryReportFilterMeta[];
+export declare function isEmptyFilterValue(value: unknown): boolean;
+/** Drop empty values so a cleared control never reaches the server. */
+export declare function compactFilterValues(values: QueryReportFilters | undefined): QueryReportFilters;
+/** A run response → the columns, rows and message a report table renders. */
+export declare function normalizeQueryReportPayload(raw: QueryReportRunMessage): QueryReportPayload;
+/**
+ * Draft/applied values → the dict that round-trips through `?filters=` and
+ * `query_report.run`. Empty values drop; hidden filters keep their values
+ * so a clear-all on the visible bar does not strip seeded hidden defaults.
+ */
+export declare function compactQueryReportFilters(filterMeta: readonly QueryReportFilterMeta[], values: QueryReportFilters): QueryReportFilters;
+/** Seedable default values ("" defaults are non-values, desk parity). */
+export declare function defaultFilterValues(filterMeta: readonly QueryReportFilterMeta[]): QueryReportFilters;
+/**
+ * Filter values → the `filters` dict for frappe.desk.query_report.run.
+ * Desk parity (query_report.js get_filter_values): falsy values are OMITTED
+ * (an unchecked Check or empty input sends nothing), `wildcard_filter`
+ * values wrap in `%…%` unless the user typed their own wildcard, and
+ * numeric fieldtypes send numbers (script reports do arithmetic on them).
+ */
+export declare function buildRunFilters(filterMeta: readonly QueryReportFilterMeta[], filters: QueryReportFilters): QueryReportFilters;
+export interface ScriptFilterExtraction {
+    /** True when the module declares a `filters` key (even an empty one). */
+    declared: boolean;
+    /** Top-level entries the script declares (parseable or not). */
+    declaredCount: number;
+    /** The renderable (declarative) subset, normalized. */
+    filters: QueryReportFilterMeta[];
+}
+/**
+ * Extract the declarative filter subset from a desk report script module.
+ * Never throws; anything unparseable degrades to a smaller `filters` list
+ * (the `declaredCount` delta is the honest gap).
+ */
+export declare function extractScriptFilters(script: string | undefined): ScriptFilterExtraction;
+/**
+ * A failed report call → an Error whose message is the server's own sentence.
+ * The HTTP `status` and frappe `exc_type` ride along, so a caller can still
+ * tell a refused run (403 / PermissionError) from a broken one.
+ */
+export declare function humanizeFrappeError(err: unknown): Error;
+export type FrappeReportColumn = QueryReportColumn;
+export type FrappeReportRow = QueryReportRow;
+export type FrappeReportValues = QueryReportFilters;
+export type FrappeReportFilterDef = QueryReportFilterInput;
+export type FrappeReportRunResponse = QueryReportRunMessage;
+export type FrappeReportPayload = QueryReportPayload;
+export declare const normalizeReportPayload: typeof normalizeQueryReportPayload;
+/** One column, dict or `"Label:Fieldtype/Options:Width"`, in its normalized shape. */
+export declare function normalizeReportColumn(column: unknown): QueryReportColumn;
+/** `normalizeQueryReportRows` with FrappeReportView's argument order. */
+export declare function normalizeReportRows(columns: readonly QueryReportColumn[], result: readonly unknown[] | undefined): QueryReportRow[];
+//# sourceMappingURL=queryReport.d.ts.map

package/types/report/queryReport.d.ts.map

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

package/types/report/queryReportColumns.d.ts

@@ -0,0 +1,12 @@
+import type { DataTableColumn } from "@multiplatform.one/table";
+import { type QueryReportColumn, type QueryReportRow } from "./queryReport";
+export interface BuildQueryReportColumnsArgs {
+    columns: readonly QueryReportColumn[];
+    /** Open a Link cell's target document (doctype comes from column options). */
+    onOpenLink?: (doctype: string, name: string) => void;
+}
+/** Build DataTable columns for a query-report run result. */
+export declare function buildQueryReportColumns({ columns, onOpenLink, }: BuildQueryReportColumnsArgs): DataTableColumn<QueryReportRow>[];
+/** CSV over the full run result (Desk Export, not just the current page). */
+export declare function buildQueryReportCsv(columns: readonly QueryReportColumn[], rows: readonly QueryReportRow[]): string;
+//# sourceMappingURL=queryReportColumns.d.ts.map

package/types/report/queryReportColumns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryReportColumns.d.ts","sourceRoot":"","sources":["../../src/report/queryReportColumns.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAa,MAAM,eAAe,CAAC;AAIvF,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AA0ED,6DAA6D;AAC7D,wBAAgB,uBAAuB,CAAC,EACtC,OAAO,EACP,UAAU,GACX,EAAE,2BAA2B,GAAG,eAAe,CAAC,cAAc,CAAC,EAAE,CAWjE;AAQD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,IAAI,EAAE,SAAS,cAAc,EAAE,GAC9B,MAAM,CAKR"}

package/types/report/reportViewModel.d.ts

@@ -0,0 +1,146 @@
+import { type FilterFieldKind } from "../filterFields";
+import type { DoctypeMeta } from "../formEngine/doctypeMeta";
+import type { FrappeFieldFilter } from "../useConnectionFilters";
+type FrappeFilter = FrappeFieldFilter;
+type FrappeFilters = FrappeFieldFilter[];
+/** The report's filter tuples: `[fieldname, operator, value]`. */
+export type ReportFilters = FrappeFilters;
+/**
+ * What the report view reads off a doctype's meta. Only `fields` is
+ * required, so a source without DocType meta (the shape of a record the
+ * reader can see) stands in for it.
+ */
+export type ReportMetaSource = Pick<DoctypeMeta, "fields"> & Partial<Pick<DoctypeMeta, "title_field" | "image_field" | "sort_field" | "sort_order">>;
+export interface ReportColumnDef {
+    fieldname: string;
+    label: string;
+    fieldtype: string;
+    kind: FilterFieldKind;
+    /** Link target doctype or raw Select options string. */
+    options?: string;
+    /** Fixed column width (px) — one scrollport, so widths align all rows. */
+    width: number;
+    align: "left" | "right" | "center";
+}
+export type ReportRow = {
+    name: string;
+} & Record<string, unknown>;
+export interface ReportSortState {
+    field: string;
+    order: "asc" | "desc";
+}
+export declare const REPORT_NUMERIC_FIELDTYPES: Set<string>;
+/** Desk report page lengths. */
+export declare const REPORT_PAGE_SIZES: readonly [20, 100, 500];
+export declare const DEFAULT_REPORT_PAGE_SIZE: number;
+export declare function defaultColumnWidth(fieldtype: string): number;
+export declare function columnAlign(fieldtype: string): ReportColumnDef["align"];
+/**
+ * Every column the picker can offer: ID + meta value-type data fields (in
+ * meta order, hidden included — desk's picker offers them too) + the
+ * remaining standard doc fields.
+ */
+export declare function reportColumnsFromMeta(meta?: ReportMetaSource): ReportColumnDef[];
+/**
+ * Desk default report columns (report_view.js set_default_fields):
+ * name, a `status` docfield when the doctype has one (nearest meta-derivable
+ * stand-in for desk's computed Status indicator), title_field + image_field,
+ * fields flagged in_list_view OR in_standard_filter (value-type, not
+ * report_hide), currency-source fields referenced by flagged Currency
+ * columns, then modified (a fresh report should carry recency). Desk's
+ * listview_settings.add_fields (e.g. User's "enabled") live in desk-side JS
+ * bundles and cannot be derived from the meta channel — honest subset.
+ */
+export declare function defaultReportFieldnames(meta?: ReportMetaSource): string[];
+/** Resolve selected fieldnames against the pickable set (drops unknowns). */
+export declare function resolveSelectedColumns(all: ReportColumnDef[], fieldnames: readonly string[]): ReportColumnDef[];
+/**
+ * One filter-row input → one frappe tuple (null = no filter yet).
+ * Mapping mirrors the list filter vocabulary (filter-fields):
+ *   text / link → `like %value%` (contains; user-typed % wins)
+ *   select      → `=` on an exact option match (case-insensitive),
+ *                 else `like %value%` so partial typing still narrows
+ *   check       → yes/no/1/0/true/false → `= 1|0`
+ *   number/date → optional comparison prefix (`>`, `<`, `>=`, `<=`, `!=`,
+ *                 `=`), bare values equal-match (desk operator-hint parity)
+ */
+export declare function columnFilterTuple(column: ReportColumnDef, raw: string): FrappeFilter | null;
+/** All committed filter-row inputs → tuples (unparseable inputs skipped). */
+export declare function columnFilterTuples(columns: readonly ReportColumnDef[], filters: Readonly<Record<string, string>>): FrappeFilters;
+/**
+ * Parse the `?f=` search param: urlencoded JSON FrappeFilters. The router
+ * usually decodes the param already, so the raw value is tried first
+ * (same contract as the list screen's parser). Malformed input degrades to
+ * "no filters".
+ */
+export declare function parseReportFiltersParam(raw: unknown): FrappeFilters | undefined;
+export interface ReportViewConfig {
+    fieldnames: string[];
+    filters: FrappeFilters;
+    sort?: ReportSortState;
+    pageSize?: number;
+    groupBy?: string | null;
+    addTotals?: boolean;
+}
+interface DeskGroupBySettings {
+    group_by?: string | null;
+    aggregate_function?: string;
+    aggregate_on?: string | null;
+}
+export interface DeskReportSettings {
+    fields: Array<[string, string]>;
+    filters: Array<[string, string, string, unknown]>;
+    order_by: string;
+    add_totals_row: 0 | 1;
+    page_length: number;
+    column_widths: Record<string, number>;
+    group_by?: DeskGroupBySettings | null;
+}
+/** Parse "`tabUser`.`modified` desc" (or bare "modified desc"). */
+export declare function parseDeskOrderBy(orderBy: unknown): ReportSortState | undefined;
+export declare function toDeskReportSettings(doctype: string, config: ReportViewConfig): DeskReportSettings;
+/**
+ * Desk Report json → view config. Child-doctype fields/filters are dropped
+ * (this view renders parent fields only — honest subset), legacy plain
+ * string field entries are honored.
+ */
+export declare function fromDeskReportSettings(doctype: string, json: unknown): ReportViewConfig | undefined;
+export declare function compareCellValues(a: unknown, b: unknown): number;
+/**
+ * Deterministic client ordering of the live collection rows (live-query row
+ * order is not guaranteed): group field first (when grouping), then the
+ * sort field in its direction, name as the final tiebreak.
+ */
+export declare function orderReportRows(rows: readonly ReportRow[], sort: ReportSortState, groupBy?: string | null): ReportRow[];
+export interface ReportGroupHeader {
+    kind: "group";
+    key: string;
+    value: unknown;
+    /** Rows carrying this value across the FULL filtered result. */
+    count: number;
+}
+export interface ReportDataRow {
+    kind: "row";
+    key: string;
+    row: ReportRow;
+    /** 1-based position in the full ordered result (row-number column). */
+    index: number;
+}
+export type ReportGridRow = ReportGroupHeader | ReportDataRow;
+/**
+ * Page slice → grid rows. With grouping active, group headers are injected
+ * at value boundaries inside the page; counts cover the full ordered result
+ * so a group spanning pages reads honestly.
+ */
+export declare function buildGridRows(orderedRows: readonly ReportRow[], pageStart: number, pageSize: number, groupBy?: string | null): ReportGridRow[];
+export interface ReportTotalsCell {
+    fieldname: string;
+    fieldtype: string;
+    value: number;
+}
+/** Sums per visible numeric column over the FULL filtered result. */
+export declare function computeTotals(columns: readonly ReportColumnDef[], rows: readonly ReportRow[]): ReportTotalsCell[];
+/** CSV over the FULL filtered + ordered result (not just the page). */
+export declare function buildReportCsv(columns: readonly ReportColumnDef[], rows: readonly ReportRow[]): string;
+export {};
+//# sourceMappingURL=reportViewModel.d.ts.map

package/types/report/reportViewModel.d.ts.map

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

package/types/report/savedReports.d.ts

@@ -0,0 +1,27 @@
+import { type ReportViewConfig } from "./reportViewModel";
+import { type FrappeReportConnection } from "./useFrappeReport";
+export interface SavedReportSummary {
+    /** Report document name (usually equals the report title). */
+    name: string;
+    reportName: string;
+    json?: string;
+}
+export interface UseSavedReportsResult {
+    reports: SavedReportSummary[];
+    loading: boolean;
+    /** Load a saved report's view config (fields/filters/sort/…). */
+    load: (name: string) => Promise<ReportViewConfig | undefined>;
+    /** Create or update a Report doc; returns the server-side name. */
+    save: (name: string, config: ReportViewConfig) => Promise<string>;
+    remove: (name: string) => Promise<void>;
+    refresh: () => void;
+}
+/**
+ * Where saved reports are read and written. Omitted, the ambient
+ * FrappeProvider's connection; `fixtures` keeps them in memory.
+ */
+export interface SavedReportsConnection extends FrappeReportConnection {
+    fixtures?: unknown;
+}
+export declare function useSavedReports(doctype: string, connection?: SavedReportsConnection): UseSavedReportsResult;
+//# sourceMappingURL=savedReports.d.ts.map

package/types/report/savedReports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"savedReports.d.ts","sourceRoot":"","sources":["../../src/report/savedReports.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAc,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAC9D,mEAAmE;IACnE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAID;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,sBAAsB,GAClC,qBAAqB,CA6HvB"}

package/types/report/useFrappeReport.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The query-report transport: one `frappe.desk.query_report.run` caller per
+ * connection, debounced filter changes, the Report's DB-defined filters via
+ * `get_script`. FrappeReportView runs on it directly and the desk's
+ * `useQueryReport` runs its reports through it, so both surfaces send the
+ * same request and read the same normalized payload (MPO-15, GL-28).
+ */
+import { CallModule } from "@multiplatform.one/frappe";
+import { type QueryReportFilterInput, type QueryReportFilters, type QueryReportPayload, type QueryReportRunMessage } from "./queryReport";
+/** Fixture payload or loader — renders the report without any network. */
+export type FrappeReportFixture = QueryReportRunMessage | ((args: {
+    reportName: string;
+    filters: QueryReportFilters;
+}) => QueryReportRunMessage | Promise<QueryReportRunMessage>);
+export interface FrappeReportConnection {
+    baseURL: string;
+    auth?: {
+        useToken?: boolean;
+        token?: string | (() => string | Promise<string>);
+        type?: string;
+    };
+}
+/** The shared caller for a connection (report runs, Report doc reads, get_script). */
+export declare function reportCall(connection: FrappeReportConnection): CallModule;
+export interface UseFrappeReportOptions {
+    reportName: string;
+    /** Current filter values (already compacted values are fine too). */
+    filters?: QueryReportFilters;
+    /** Fixture payload / loader — no network is touched when set. */
+    fixture?: FrappeReportFixture;
+    /**
+     * Fetch the report's DB-defined filter definitions (`get_script`).
+     * Off when the consumer supplies `filterFields` explicitly.
+     */
+    fetchFilterDefs?: boolean;
+    /** Bypass the prepared-report cache and execute the report now. */
+    ignorePreparedReport?: boolean;
+    /** Debounce for filter-change refetches in ms (default 400). */
+    debounceMs?: number;
+    enabled?: boolean;
+}
+export interface UseFrappeReportResult {
+    payload: QueryReportPayload | undefined;
+    /** DB-defined filter defs (`get_script`); undefined while unknown. */
+    scriptFilters: QueryReportFilterInput[] | undefined;
+    /** First run in flight — nothing to show yet. */
+    isLoading: boolean;
+    /** Any run in flight (filter-change / refresh refetches included). */
+    isFetching: boolean;
+    error: Error | undefined;
+    /** Immediate re-run (skips the debounce window). */
+    refresh: () => void;
+}
+/**
+ * Run a named server-side report (`frappe.desk.query_report.run`) with the
+ * given filters. Filter-value changes are debounced; report changes and
+ * explicit `refresh()` run immediately.
+ */
+export declare function useFrappeReport(connection: FrappeReportConnection | undefined, { reportName, filters, fixture, fetchFilterDefs, ignorePreparedReport, debounceMs, enabled, }: UseFrappeReportOptions): UseFrappeReportResult;
+//# sourceMappingURL=useFrappeReport.d.ts.map

package/types/report/useFrappeReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFrappeReport.d.ts","sourceRoot":"","sources":["../../src/report/useFrappeReport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAkB,UAAU,EAA+B,MAAM,2BAA2B,CAAC;AAEpG,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AAEvB,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAC3B,qBAAqB,GACrB,CAAC,CAAC,IAAI,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,kBAAkB,CAAC;CAC7B,KAAK,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAMD,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,UAAU,EAAE,sBAAsB,GAAG,UAAU,CAezE;AAID,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,iEAAiE;IACjE,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxC,sEAAsE;IACtE,aAAa,EAAE,sBAAsB,EAAE,GAAG,SAAS,CAAC;IACpD,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,oDAAoD;IACpD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,sBAAsB,GAAG,SAAS,EAC9C,EACE,UAAU,EACV,OAAO,EACP,OAAO,EACP,eAAuB,EACvB,oBAA4B,EAC5B,UAAgC,EAChC,OAAc,GACf,EAAE,sBAAsB,GACxB,qBAAqB,CAsIvB"}

package/types/report/useQueryReport.d.ts

@@ -0,0 +1,37 @@
+import { type QueryReportColumn, type QueryReportFilterMeta, type QueryReportFilters, type QueryReportFixture, type QueryReportMeta, type QueryReportRow } from "./queryReport";
+export interface UseQueryReportOptions {
+    fixture?: QueryReportFixture;
+    /** Filter values applied before the first run (report swaps re-apply them). */
+    initialFilters?: QueryReportFilters;
+}
+export interface UseQueryReportResult {
+    meta?: QueryReportMeta;
+    columns: QueryReportColumn[];
+    rows: QueryReportRow[];
+    /** True until the first meta+script+run cycle settles. */
+    loading: boolean;
+    /** True while a (re)run is in flight. */
+    running: boolean;
+    /** The failed run's server sentence; `status` and `exc_type` ride along. */
+    error?: Error;
+    /** The server refused the run: the session may not run this report (LC-96). */
+    refused: boolean;
+    /** The report's informational `message` payload (may embed HTML). */
+    serverMessage?: string;
+    /** Server-reported run time in seconds. */
+    executionTime?: number;
+    /** Merged filter meta: script-declared filters, else doc-level rows. */
+    filterMeta: QueryReportFilterMeta[];
+    /**
+     * True when the desk script declares filters this surface could not
+     * derive (non-declarative entries) — the honest "defined in code" note.
+     */
+    scriptFilterGap: boolean;
+    /** Mandatory filters currently unfilled — the run is skipped while non-empty. */
+    missingRequired: QueryReportFilterMeta[];
+    filters: QueryReportFilters;
+    setFilters: (next: QueryReportFilters) => void;
+    reload: () => void;
+}
+export declare function useQueryReport(reportName: string, options?: UseQueryReportOptions): UseQueryReportResult;
+//# sourceMappingURL=useQueryReport.d.ts.map

package/types/report/useQueryReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryReport.d.ts","sourceRoot":"","sources":["../../src/report/useQueryReport.ts"],"names":[],"mappings":"AA0BA,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,cAAc,EASpB,MAAM,eAAe,CAAC;AAOvB,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC;;;OAGG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB,iFAAiF;IACjF,eAAe,EAAE,qBAAqB,EAAE,CAAC;IACzC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AA2BD,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAoMtB"}