@iota-uz/sdk 0.4.44 → 0.5.1

package/dist/lens/runtime/drill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drill.d.ts","sourceRoot":"","sources":["../../src/runtime/drill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAChG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAErE;AASD,UAAU,iBAAiB;IACzB,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,QAAQ,CAAA;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAyB3G;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAE5F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAMpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,CAajH;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAMzG;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,KAAK,GAAG,SAAS,CAQvG;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAI5F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAO9G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAQnG;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,iBAAiB,CAmB9G;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,iBAAiB,CAOtF"}

package/dist/lens/runtime/drillPrefetch.d.ts

@@ -0,0 +1,22 @@
+import type { DashboardDocument, Frame, NodePath } from "../contract";
+import type { QueryClient } from "./query";
+interface IdleDrillPrefetchRoot {
+    panelId: string;
+    path: NodePath;
+    perspective: string;
+}
+export declare function idleDrillPrefetchRoots(document: DashboardDocument): Array<IdleDrillPrefetchRoot>;
+interface IdleDrillPrefetchOptions {
+    document: DashboardDocument;
+    queryClient: QueryClient;
+    signal: AbortSignal;
+    onChildren: (path: NodePath, frame: Frame) => void;
+}
+/**
+ * Warm bounded first-level drill states after the useful root row is ready.
+ * This module is loaded dynamically so speculative traversal never delays the
+ * initial dashboard bundle or its critical panel requests.
+ */
+export declare function prefetchIdleDrillStates({ document, queryClient, signal, onChildren, }: IdleDrillPrefetchOptions): Promise<void>;
+export {};
+//# sourceMappingURL=drillPrefetch.d.ts.map

package/dist/lens/runtime/drillPrefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drillPrefetch.d.ts","sourceRoot":"","sources":["../../src/runtime/drillPrefetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,UAAU,qBAAqB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,GAC1B,KAAK,CAAC,qBAAqB,CAAC,CA6B9B;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpD;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,EAC5C,QAAQ,EACR,WAAW,EACX,MAAM,EACN,UAAU,GACX,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C1C"}

package/dist/lens/runtime/export.d.ts

@@ -0,0 +1,21 @@
+export declare class ExportError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare class ExportSnapshotGoneError extends ExportError {
+    constructor(message?: string);
+}
+export interface ExportWorkbookRequest {
+    endpoint: string;
+    snapshotId: string;
+    panelId?: string;
+    csrf?: string;
+    fetcher?: typeof fetch;
+}
+export interface ExportWorkbook {
+    blob: Blob;
+    filename: string;
+}
+export declare function exportWorkbook(request: ExportWorkbookRequest): Promise<ExportWorkbook>;
+export declare function downloadWorkbook(workbook: ExportWorkbook): void;
+//# sourceMappingURL=export.d.ts.map

package/dist/lens/runtime/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/runtime/export.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAY,SAAQ,KAAK;IACP,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAxC,OAAO,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM;CAIrD;AAED,qBAAa,uBAAwB,SAAQ,WAAW;gBAC1C,OAAO,SAAmC;CAIvD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;CACjB;AA2BD,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB5F;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAU/D"}

package/dist/lens/runtime/filters.d.ts

@@ -0,0 +1,51 @@
+import type { Action, CompareValue, DashboardDocument, Filter, PeriodFilter, PeriodValue, SegmentedFilter } from '../contract';
+/**
+ * Filter values are URL state: a map from a declared parameter name to the
+ * string the document endpoint receives. An empty string is meaningful — it
+ * is the present-but-empty "all time" form — which is why absence and ''
+ * are distinct.
+ *
+ * The runtime can only ever request values this module has validated against
+ * the document's own declaration (wire dates, allowEmpty), so the document
+ * endpoint — which normalizes and derives the snapshot key server-side —
+ * remains the only authority over what a filter combination means.
+ */
+export type FilterValues = Record<string, string | Array<string>>;
+export declare const cubeFilterParam = "_f";
+export declare const cubeGroupByParam = "_groupby";
+export declare function declaredFilters(document: DashboardDocument): Array<Filter>;
+export declare function filterParamNames(document: DashboardDocument): Array<string>;
+/**
+ * The declared filter values present on a URL. A boundary that fails
+ * declaration-level validation drops its whole filter back to the document's
+ * server-normalized default rather than sending garbage to the endpoint.
+ */
+export declare function readFilterValues(document: DashboardDocument, url: URL): FilterValues;
+/** Rewrites the declared filter parameters on a URL, leaving all others. */
+export declare function writeFilterValues(url: URL, document: DashboardDocument, values: FilterValues): URL;
+export declare function sameFilterValues(left: FilterValues, right: FilterValues): boolean;
+/**
+ * The selection a period control renders: the URL's validated value when one
+ * is present, otherwise the server-normalized value the document declared.
+ */
+export declare function currentPeriodValue(period: PeriodFilter, values: FilterValues): PeriodValue;
+export declare function periodValues(period: PeriodFilter, value: PeriodValue): FilterValues;
+/**
+ * The selection a segmented control renders: the URL's validated value when
+ * one is present, otherwise the server-normalized value the document declared.
+ * Exactly the fallback `currentPeriodValue` applies, for the same reason — the
+ * document, not the browser, is the authority on what is currently displayed.
+ */
+export declare function currentSegmentedValue(segmented: SegmentedFilter, values: FilterValues): string;
+export declare function segmentedValues(segmented: SegmentedFilter, value: string): FilterValues;
+/**
+ * The document src with filter parameters applied: every parameter the
+ * runtime has ever driven is removed, then the current values are set. The
+ * host page's own src params survive untouched, so a src that already carries
+ * the initial filter (as EAI's does) stays authoritative until the user acts.
+ */
+export declare function srcWithFilterParams(src: string, drivenParams: Iterable<string>, values: FilterValues | undefined): string;
+export declare function compareValues(filter: NonNullable<Filter['compare']>, value: CompareValue): FilterValues;
+export declare function periodTransitionValues(document: DashboardDocument, filter: Filter, value: PeriodValue, current: FilterValues): FilterValues;
+export declare function filterActionURL(action: Action, fields: Readonly<Record<string, unknown>>, current: URL): URL | undefined;
+//# sourceMappingURL=filters.d.ts.map

package/dist/lens/runtime/filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/runtime/filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAI9H;;;;;;;;;;GAUG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AAEjE,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C,wBAAgB,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,CAO1E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,CAW3E;AAWD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,GAAG,YAAY,CAmDpF;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,YAAY,GAAG,GAAG,CASlG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAUjF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAM1F;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,YAAY,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,CAI9F;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAEvF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAUzH;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAOvG;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,YAAY,GACpB,YAAY,CAWd;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,GAAG,SAAS,CAwBxH"}

package/dist/lens/runtime/focusTrap.d.ts

@@ -0,0 +1,4 @@
+import { type RefObject } from 'react';
+/** Keeps keyboard focus within an open dialog and restores its trigger. */
+export declare function useFocusTrap(dialog: RefObject<HTMLElement>, active: boolean, onEscape: () => void, initialFocus?: RefObject<HTMLElement>, restoreFocus?: RefObject<HTMLElement>): void;
+//# sourceMappingURL=focusTrap.d.ts.map

package/dist/lens/runtime/focusTrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.d.ts","sourceRoot":"","sources":["../../src/runtime/focusTrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAOjD,2EAA2E;AAC3E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,CAAC,WAAW,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,MAAM,IAAI,EACpB,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,EACrC,YAAY,CAAC,EAAE,SAAS,CAAC,WAAW,CAAC,QAsCtC"}

package/dist/lens/runtime/format.d.ts

@@ -0,0 +1,81 @@
+import type { FieldFormat } from '../contract';
+/**
+ * The typographic minus (U+2212). Every numeral this runtime writes carries it,
+ * so a negative figure reads the same whether Intl produced the sign (en-US
+ * emits an ASCII hyphen, ru-RU already emits U+2212), a panel prepended it
+ * (`metricViews`, `CascadePanel`), or the sheet drew it into a formula. A
+ * hyphen is also narrower than the `+` it has to line up with under
+ * `tabular-nums`, which shows up as a wobbling sign column in a table of deltas.
+ */
+export declare const minusSign = "\u2212";
+/** Joins a formatted numeral to its unit so the pair cannot break across lines. */
+export declare function joinUnit(text: string, unit: string | undefined): string;
+/**
+ * The single writer for a formatted numeral: it joins Intl's parts, pins the
+ * decimal separator when the document asked for one, and normalizes the sign.
+ *
+ * Compact magnitudes come from the locale's own CLDR data (ru → «млрд», uz →
+ * «mlrd», en → «B»), never from a hardcoded suffix table. Only the decimal
+ * separator can be pinned: `decimalSeparator` exists because the server
+ * formatter prints the mantissa with `%.*f`, so a document
+ * that must match it byte for byte asks for ".".
+ *
+ * The sign is deliberately outside that byte-for-byte deal: a separator is
+ * notation the producer chose, a minus is typography this runtime owns, and two
+ * glyphs for one operator on one dashboard is the defect being fixed.
+ */
+export declare function writeNumberParts(parts: Intl.NumberFormatPart[], separator: string | undefined): string;
+export declare function formatAxis(value: unknown, field: FieldFormat | undefined, locale: string): string;
+/**
+ * The unit `formatAxis` took off the ticks, so an axis can state it once.
+ *
+ * Dropping the currency from every gridline was right — eight repetitions of
+ * «млрд UZS» is a column of noise — but the other half of that decision was
+ * never built: the ticks lost the unit and nothing gained it, so «35 млн» sat
+ * on a revenue axis with the currency findable only by hovering a mark. The
+ * axis name is where a unit belongs; this is what goes in it.
+ *
+ * A percentage is excluded: the glyph is already on every tick, is one
+ * character wide, and reads as part of the number rather than as a unit.
+ */
+export declare function axisUnit(field: FieldFormat | undefined): string;
+/**
+ * The full-precision companion to a compact field: «106.03 млрд UZS» carries
+ * «106 034 767 694 UZS» in its tooltip. Returns undefined when the field is
+ * not compact (nothing was abbreviated away) or the value is not numeric.
+ */
+export declare function formatFieldValueExact(value: unknown, field: FieldFormat | undefined, locale: string): string | undefined;
+/**
+ * The clipboard companion to every formatted figure: the same quantity with
+ * nothing done to it a spreadsheet would have to undo — no thousands
+ * separators, no unit, no compact abbreviation, a dot decimal.
+ *
+ * It is scaled the way the display is. A money field in minor units draws
+ * «41,20 млрд UZS» from 4 120 000 000 000 tiyin, and a reader who copies that
+ * figure means the som they can see, not the tiyin behind it. Undefined when
+ * there is no number to copy.
+ */
+export declare function rawValueText(value: unknown, field?: FieldFormat): string | undefined;
+/**
+ * Delta chips clamp beyond ±999.9%: «+13 417.3%» is noise, «>999%» is honest.
+ * Returns undefined inside the displayable range. Mirrors the server's
+ * trendPercentText clamp.
+ */
+export declare function clampedDeltaPercent(value: number, locale?: string): string | undefined;
+export declare function formatFieldValue(value: unknown, field: FieldFormat | undefined, locale: string): string;
+/**
+ * The one magnitude a group of compact values should share.
+ *
+ * The largest value sets the notation — that is the number the group is read
+ * against. But a magnitude that rounds a real value down to «0.00» prints a
+ * lie next to the real zeros, so when the smallest non-zero member cannot
+ * survive the largest member's magnitude, the group steps down to the
+ * smaller one. One notation either way; nothing that exists reads as nothing.
+ *
+ * Returns undefined when there is nothing to share a magnitude across — an
+ * empty group, or one that is entirely zero.
+ */
+export declare function compactReference(values: Iterable<number>, field: FieldFormat | undefined): number | undefined;
+/** Format a compact tooltip group at one shared magnitude. */
+export declare function formatFieldValueAtReference(value: unknown, reference: number, field: FieldFormat | undefined, locale: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/lens/runtime/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/runtime/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAuB9C;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,WAAM,CAAA;AAc5B,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGvE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUtG;AA2FD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYjG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASxH;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAO,GAAG,MAAM,GAAG,SAAS,CAOpF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAqBvG;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAoB7G;AAED,8DAA8D;AAC9D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BrI"}

package/dist/lens/runtime/idlePrefetch.d.ts

@@ -0,0 +1,35 @@
+export interface IdlePrefetchQueueOptions {
+    /** Total distinct candidates admitted for one snapshot. */
+    capacity?: number;
+    /** Small grace period that lets visible work and user input go first. */
+    delayMs?: number;
+    /**
+     * Grace period for a transient zero-consumer state during a React commit.
+     * A real snapshot reset still cancels synchronously through reset().
+     */
+    detachGraceMs?: number;
+}
+/**
+ * One-slot, bounded speculative queue shared by every panel in a runtime.
+ * Registration order is DOM/layout reveal order. A concrete target is
+ * deduplicated across panels, and reset() is the snapshot cancellation gate.
+ */
+export declare class IdlePrefetchQueue {
+    private readonly capacity;
+    private readonly delayMs;
+    private readonly detachGraceMs;
+    private readonly tasks;
+    private readonly completed;
+    private pending;
+    private active?;
+    private timer?;
+    private scheduled?;
+    private paused;
+    constructor(options?: IdlePrefetchQueueOptions);
+    register(key: string, run: (signal: AbortSignal) => Promise<void>): () => void;
+    setPaused(paused: boolean): void;
+    reset(): void;
+    private detach;
+    private pump;
+}
+//# sourceMappingURL=idlePrefetch.d.ts.map

package/dist/lens/runtime/idlePrefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idlePrefetch.d.ts","sourceRoot":"","sources":["../../src/runtime/idlePrefetch.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAUD;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,MAAM,CAAC,CAAyD;IACxE,OAAO,CAAC,KAAK,CAAC,CAA+B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAQ;gBAEV,OAAO,GAAE,wBAA6B;IAMlD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI;IAsB9E,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAiBhC,KAAK,IAAI,IAAI;IAiBb,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,IAAI;CAuCb"}

package/dist/lens/runtime/index.d.ts

@@ -0,0 +1,15 @@
+export * from './navigate';
+export * from './document';
+export * from './drawer';
+export * from './drill';
+export * from './export';
+export * from './filters';
+export * from './format';
+export * from './navigation';
+export * from './provider';
+export * from './panelImage';
+export * from './query';
+export * from './recovery';
+export * from './theme';
+export * from './url';
+//# sourceMappingURL=index.d.ts.map

package/dist/lens/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,OAAO,CAAA"}

package/dist/lens/runtime/navigate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Full-page navigation seam. Panel-level actions are plain document
+ * navigations; routing them through one function keeps the host page able to
+ * intercept them and makes the behaviour testable.
+ *
+ * A target inside the current document is the exception: a summary card whose
+ * subject is expanded by a section further down the page links to that section,
+ * and reloading the page to reach a heading it is already showing would be
+ * absurd. Those scroll instead.
+ */
+export declare function navigateTo(url: string): void;
+//# sourceMappingURL=navigate.d.ts.map

package/dist/lens/runtime/navigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/runtime/navigate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAO5C"}

package/dist/lens/runtime/navigation.d.ts

@@ -0,0 +1,77 @@
+import type { NodeKey, NodePath } from '../contract';
+export interface NavigationView {
+    panelId?: string;
+    path: NodePath;
+    perspectiveId?: string;
+    revision?: number;
+    drawer?: DrawerNavigationView;
+}
+export interface DrawerNavigationView {
+    src: string;
+    panelId?: string;
+    path: NodePath;
+    perspectiveId?: string;
+}
+export interface NavigationState extends NavigationView {
+    history: Array<NavigationView>;
+}
+export type NavigationAction = {
+    type: 'drillInto';
+    nodeKey: NodeKey;
+    panelId?: string;
+    path?: NodePath;
+} | {
+    type: 'back';
+} | {
+    type: 'jumpTo';
+    breadcrumbIndex: number;
+}
+/**
+ * `enterKey` folds "enter this segment, then show it as X" into one step.
+ * Picking a view for a segment is one user action, and charging it two
+ * transitions puts a level nobody asked to stand on between the chart and
+ * the answer — the level it enters is a fork whose only content is that
+ * same choice.
+ */
+ | {
+    type: 'switchPerspective';
+    perspectiveId: string;
+    path?: NodePath;
+    replace?: boolean;
+    enterKey?: NodeKey;
+    panelId?: string;
+} | {
+    type: 'reset';
+} | {
+    type: 'openDrawer';
+    src: string;
+    view?: Omit<DrawerNavigationView, 'src'>;
+} | {
+    type: 'replaceDrawer';
+    src: string;
+    view?: Omit<DrawerNavigationView, 'src'>;
+} | {
+    type: 'updateDrawer';
+    view: Omit<DrawerNavigationView, 'src'>;
+} | {
+    type: 'closeDrawer';
+} | {
+    type: 'restore';
+    view: NavigationView;
+    history?: Array<NavigationView>;
+};
+export declare function createNavigationState(view?: Partial<NavigationView>): NavigationState;
+export declare function navigationReducer(state: NavigationState, action: NavigationAction): NavigationState;
+export declare const navigationActions: {
+    drillInto: (nodeKey: NodeKey, panelId?: string, path?: NodePath) => NavigationAction;
+    back: () => NavigationAction;
+    jumpTo: (breadcrumbIndex: number) => NavigationAction;
+    switchPerspective: (perspectiveId: string, path?: NodePath, replace?: boolean, enterKey?: NodeKey, panelId?: string) => NavigationAction;
+    reset: () => NavigationAction;
+    openDrawer: (src: string, view?: Omit<DrawerNavigationView, "src">) => NavigationAction;
+    replaceDrawer: (src: string, view?: Omit<DrawerNavigationView, "src">) => NavigationAction;
+    updateDrawer: (view: Omit<DrawerNavigationView, "src">) => NavigationAction;
+    closeDrawer: () => NavigationAction;
+    restore: (view: NavigationView, history?: Array<NavigationView>) => NavigationAction;
+};
+//# sourceMappingURL=navigation.d.ts.map

package/dist/lens/runtime/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/runtime/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEpD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,QAAQ,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,oBAAoB,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,QAAQ,CAAA;IACd,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;CAC/B;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;CAAE,GAC1E;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE;AAC7C;;;;;;GAMG;GACD;IACA,IAAI,EAAE,mBAAmB,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,QAAQ,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GACC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAA;CAAE,GAC7E;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,CAAA;CAAE,CAAA;AAiD9E,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,eAAe,CASzF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,gBAAgB,GAAG,eAAe,CA8DnG;AAED,eAAO,MAAM,iBAAiB;yBACP,OAAO,YAAY,MAAM,SAAS,QAAQ,KAAG,gBAAgB;gBACxE,gBAAgB;8BACA,MAAM,KAAG,gBAAgB;uCAElC,MAAM,SACd,QAAQ,YACL,OAAO,aACN,OAAO,YACR,MAAM,KACf,gBAAgB;iBACR,gBAAgB;sBACT,MAAM,SAAS,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,KAAG,gBAAgB;yBAChE,MAAM,SAAS,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,KAAG,gBAAgB;yBACnE,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,KAAG,gBAAgB;uBACxD,gBAAgB;oBACjB,cAAc,YAAY,KAAK,CAAC,cAAc,CAAC,KAAG,gBAAgB;CACnF,CAAA"}

package/dist/lens/runtime/overlayContainer.d.ts

@@ -0,0 +1,24 @@
+import { type RefObject } from 'react';
+/**
+ * How long a hover-opened overlay survives the pointer leaving its trigger.
+ *
+ * Every one of these lives in a body portal with a deliberate visual gap from
+ * the thing that opened it, and the pointer has to cross that gap to reach the
+ * card's own buttons and its selectable text. Close on the trigger's bare
+ * `mouseleave` and the portal unmounts mid-travel, which reads as a flicker.
+ *
+ * It sits here because the gap is a property of portalling to the body, not of
+ * any one tip: it was written twice, at 120ms and at 140ms, with the same
+ * reasoning stated both times. The longer of the two is the one kept — the cost
+ * of overshooting is a tip that lingers imperceptibly, and of undershooting, the
+ * bug.
+ */
+export declare const hoverBridgeDelay = 140;
+interface OverlayThemeFallback {
+    dark?: boolean;
+    theme?: string;
+}
+/** Creates one body-level Lens root and copies the source dashboard theme. */
+export declare function useOverlayContainer(active: boolean, source: RefObject<Element | null>, extraClass?: string, fallback?: OverlayThemeFallback): HTMLElement | undefined;
+export {};
+//# sourceMappingURL=overlayContainer.d.ts.map

package/dist/lens/runtime/overlayContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlayContainer.d.ts","sourceRoot":"","sources":["../../src/runtime/overlayContainer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAE3D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EACjC,UAAU,SAAK,EACf,QAAQ,GAAE,oBAAyB,GAClC,WAAW,GAAG,SAAS,CAkBzB"}

package/dist/lens/runtime/panel.d.ts

@@ -0,0 +1,47 @@
+import { type PanelBatchResult, type PanelRequest } from '../contract';
+export interface PanelClientOptions {
+    csrf?: string;
+    fetcher?: typeof fetch;
+    /** Marks this client as speculative work in the shared snapshot scheduler. */
+    prefetch?: boolean;
+}
+export interface PanelLoadOptions {
+    signal?: AbortSignal;
+    /** Called as each NDJSON batch member arrives, before slower siblings finish. */
+    onResult?: (panelId: string, result: PanelBatchResult) => void;
+}
+type SnapshotPanelRequest = PanelRequest & {
+    snapshotId: string;
+};
+type PanelLoadResult = PanelBatchResult & {
+    frames: NonNullable<PanelBatchResult['frames']>;
+};
+/**
+ * A small per-dashboard client for independently materialised panel frames.
+ * The server owns the bounded durable cache; this map only deduplicates browser
+ * requests and is discarded with the runtime provider.
+ */
+export declare class PanelClient {
+    private readonly endpoint;
+    private readonly options;
+    private readonly inFlight;
+    private readonly controllers;
+    constructor(endpoint: string, options?: PanelClientOptions);
+    /**
+     * Whether a rejection is "the request was cancelled" rather than "the request
+     * failed". A cancelled panel has nothing to report: its caller moved on, and
+     * showing the user an error for work nobody is waiting for reads as a broken
+     * panel beside working ones.
+     *
+     * `fetch` rejects an aborted request with a DOMException named AbortError;
+     * an abort with an explicit reason rejects with that reason instead.
+     */
+    static isAbort(cause: unknown): boolean;
+    load(input: SnapshotPanelRequest, options?: PanelLoadOptions): Promise<PanelLoadResult>;
+    loadBatch(inputs: SnapshotPanelRequest[], options?: PanelLoadOptions): Promise<Record<string, PanelBatchResult>>;
+    dispose(): void;
+    private fetch;
+    private fetchBatch;
+}
+export {};
+//# sourceMappingURL=panel.d.ts.map

package/dist/lens/runtime/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/runtime/panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAElB,MAAM,aAAa,CAAA;AAGpB,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;CAC/D;AAED,KAAK,oBAAoB,GAAG,YAAY,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AACjE,KAAK,eAAe,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;CAAE,CAAA;AAS7F;;;;GAIG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAGtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB;IAGnD;;;;;;;;OAQG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAKvC,IAAI,CAAC,KAAK,EAAE,oBAAoB,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoBrF,SAAS,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAoB1H,OAAO,IAAI,IAAI;YAMD,KAAK;YAYL,UAAU;CA0EzB"}

package/dist/lens/runtime/panelImage.d.ts

@@ -0,0 +1,28 @@
+export type PanelImageFormat = 'png' | 'svg';
+export declare function panelSVG(panelId: string): {
+    background: string;
+    blob: Blob;
+    width: number;
+    height: number;
+};
+/**
+ * What the file is a picture of: the dashboard, the panel, and the period.
+ *
+ * `доход.png` names one of ten panels and none of the state that produced it,
+ * so two exports of two periods overwrite each other in the download folder and
+ * neither can be told apart afterwards. The rendered image already carries the
+ * dashboard's scope line (`.lens-panel-export-scope`); the name now carries the
+ * same facts.
+ */
+export declare function panelImageFilename(panelTitle: string, format: PanelImageFormat, scope?: {
+    dashboard?: string;
+    start?: string;
+    end?: string;
+}): string;
+export interface PanelImageScope {
+    dashboard?: string;
+    start?: string;
+    end?: string;
+}
+export declare function downloadPanelImage(panelId: string, title: string, format: PanelImageFormat, scope?: PanelImageScope): Promise<void>;
+//# sourceMappingURL=panelImage.d.ts.map

package/dist/lens/runtime/panelImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelImage.d.ts","sourceRoot":"","sources":["../../src/runtime/panelImage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,CAAA;AA8C5C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoD3G;AA0BD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,MAAM,CAMR;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,eAAe,GAChF,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/lens/runtime/prefetch.d.ts

@@ -0,0 +1,48 @@
+import type { DashboardDocument } from '../contract';
+export interface DocumentCacheOptions {
+    /** Maximum resolved documents kept before the oldest is evicted. */
+    capacity?: number;
+    fetcher?: typeof fetch;
+    csrf?: string;
+}
+/**
+ * A tiny in-memory cache of drill-drawer documents, keyed by URL.
+ *
+ * The drawer used to fetch its document only on click. Prefetch warms the same
+ * URL on hover/focus intent so the drawer opens against a document that is
+ * already in hand. The cache never revalidates, a hit is authoritative, and a
+ * failed prefetch leaves no entry. An interactive activation may overlap one
+ * intent transport request so the shared server job can be promoted; it does
+ * not duplicate datasource execution.
+ */
+export declare class DocumentCache {
+    private readonly capacity;
+    private readonly entries;
+    private readonly inflight;
+    private fetcher?;
+    private csrf?;
+    constructor(options?: DocumentCacheOptions);
+    /** Update the credentials used by later prefetches without dropping entries. */
+    configure(options: {
+        fetcher?: typeof fetch;
+        csrf?: string;
+    }): void;
+    /** The cached document for a URL, or undefined on a miss. */
+    get(url: string): DashboardDocument | undefined;
+    /**
+     * Load a document through the shared cache/singleflight path.
+     *
+     * Unlike prefetch(), failures stay visible to the interactive caller. If a
+     * speculative request is already running, opening the drawer promotes the
+     * same server calculation through a separate activation request.
+     */
+    load(url: string): Promise<DashboardDocument>;
+    /**
+     * Warm a URL. Resolves once the fetch settles; a failure resolves (never
+     * rejects) so a prefetch can never surface an error to the caller. A URL that
+     * is already cached or already in flight is not fetched again.
+     */
+    prefetch(url: string, signal?: AbortSignal): Promise<void>;
+    private store;
+}
+//# sourceMappingURL=prefetch.d.ts.map

package/dist/lens/runtime/prefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../../src/runtime/prefetch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmF;IAC5G,OAAO,CAAC,OAAO,CAAC,CAAc;IAC9B,OAAO,CAAC,IAAI,CAAC,CAAQ;gBAET,OAAO,GAAE,oBAAyB;IAM9C,gFAAgF;IAChF,SAAS,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKnE,6DAA6D;IAC7D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoB7C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB1D,OAAO,CAAC,KAAK;CAUd"}

package/dist/lens/runtime/prefetchPanels.d.ts

@@ -0,0 +1,17 @@
+import type { DashboardDocument } from '../contract';
+interface PrefetchDocumentPanelsOptions {
+    csrf?: string;
+    fetcher?: typeof fetch;
+    signal?: AbortSignal;
+}
+/**
+ * Carry useful child data all the way into the browser cache. Warming just the
+ * first content row gives the user immediate figures while preserving a
+ * bounded one-surface budget; lower rows remain progressive after open.
+ *
+ * This module is loaded only after a speculative document has arrived. It must
+ * stay outside the critical root bundle: child warm-up cannot tax first paint.
+ */
+export declare function prefetchDocumentFirstRow(document: DashboardDocument, options: PrefetchDocumentPanelsOptions): Promise<DashboardDocument>;
+export {};
+//# sourceMappingURL=prefetchPanels.d.ts.map

package/dist/lens/runtime/prefetchPanels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetchPanels.d.ts","sourceRoot":"","sources":["../../src/runtime/prefetchPanels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD,UAAU,6BAA6B;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAiC5B"}

package/dist/lens/runtime/print.d.ts

@@ -0,0 +1,50 @@
+import type { DashboardDocument, Frame, Level, NodePath, Panel, Perspective, QueryRequest, QueryResponse } from '../contract';
+export interface PrintSection {
+    id: string;
+    document: DashboardDocument;
+    panel: Panel;
+    level: Level;
+    frame?: Frame;
+    path: NodePath;
+    breadcrumb: Array<string>;
+    perspective?: Perspective;
+    depth: number;
+    root: boolean;
+    /**
+     * The panel whose drawer this section was reached through. A breakdown a
+     * reader opens by clicking a KPI belongs to that KPI, not to a loose "other
+     * readings" pile at the end of the report.
+     */
+    owner?: string;
+    /**
+     * The drawer document this section was read from. Two panels may open the
+     * same drawer; the traversal fetches it once and this is how the second
+     * panel's copy is made.
+     */
+    origin?: string;
+    /**
+     * The level answered with a first page and declared more behind it. Printing
+     * asks for one page per level, so a long table would otherwise end on paper
+     * exactly where the page ended — looking complete. The report says so.
+     */
+    hasMore?: boolean;
+}
+export interface PrintReport {
+    document: DashboardDocument;
+    sections: Array<PrintSection>;
+    warnings: Array<string>;
+    truncated: boolean;
+}
+export type PrintQuery = (request: QueryRequest, document?: DashboardDocument) => Promise<QueryResponse>;
+export type PrintDocumentLoader = (src: string) => Promise<DashboardDocument>;
+/**
+ * Materializes the dashboard's drill graph into a linear print report.
+ *
+ * The interactive runtime resolves one path at a time. Printing needs the
+ * inverse: every branch must exist at once, including dynamic children only
+ * known after their parent frame is queried. The walker uses the canonical
+ * query contract and merges child descriptors into an isolated document copy,
+ * leaving the live dashboard and its URL navigation untouched.
+ */
+export declare function buildPrintReport(source: DashboardDocument, query?: PrintQuery, maxSections?: number, loadDocument?: PrintDocumentLoader, location?: URL, signal?: AbortSignal): Promise<PrintReport>;
+//# sourceMappingURL=print.d.ts.map

package/dist/lens/runtime/print.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print.d.ts","sourceRoot":"","sources":["../../src/runtime/print.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,iBAAiB,EACjB,KAAK,EACL,KAAK,EACL,QAAQ,EACR,KAAK,EACL,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,aAAa,CAAA;AAepB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACzB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,QAAQ,EAAE,KAAK,CAAC,YAAY,CAAC,CAAA;IAC7B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACvB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,YAAY,EACrB,QAAQ,CAAC,EAAE,iBAAiB,KACzB,OAAO,CAAC,aAAa,CAAC,CAAA;AAE3B,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;AA6D7E;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,iBAAiB,EACzB,KAAK,CAAC,EAAE,UAAU,EAClB,WAAW,SAAQ,EACnB,YAAY,CAAC,EAAE,mBAAmB,EAClC,QAAQ,MAIP,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CA2QtB"}