@chengxianglibra/dsh-data-analysis 0.1.1 → 0.1.2

package/lib/types/client/credentials/styles.d.ts

@@ -0,0 +1 @@
+export declare const credentialStyles = "\n.mc-input-heading{display:flex;align-items:baseline;flex-wrap:wrap;gap:4px 12px;min-width:0}.mc-input-name{font-weight:500;color:var(--mc-text);overflow-wrap:anywhere}.mc-input-description{flex:1 1 200px;min-width:0;font-size:11px;line-height:1.6;color:var(--mc-muted);overflow-wrap:anywhere}\n.mc-dialog{--mc-bg:var(--dsw-alias-surface-primary,#fff);--mc-soft:var(--dsw-alias-interactive-bg-hover,#f5f7f9);--mc-text:var(--dsw-alias-label-primary,#182a33);--mc-muted:var(--dsw-alias-label-secondary,#627580);--mc-border:var(--dsw-alias-border-l2,#dce4e8);--mc-accent:#087b70;--mc-tint:#eaf6f2;--mc-danger:#b04436;--mc-warning:#886217;color:var(--mc-text);background:var(--mc-bg);border:1px solid var(--mc-border);border-radius:16px;width:calc(100vw - 48px);max-width:1060px;height:min(760px,calc(100dvh - 64px));max-height:calc(100dvh - 32px);padding:0;box-shadow:0 28px 100px #0003;pointer-events:auto;font:14px/1.55 system-ui,sans-serif;overflow:hidden}\n.mc-dialog::backdrop{background:#102a3a66;backdrop-filter:blur(4px)}\n.mc-dialog *{box-sizing:border-box}.mc-shell{height:100%;display:flex;flex-direction:column}.mc-dialog button,.mc-dialog input,.mc-dialog select{font:inherit;color:inherit}.mc-dialog button{cursor:pointer;border:1px solid var(--mc-border);border-radius:8px;padding:7px 12px;background:var(--mc-bg);line-height:1.5}.mc-dialog button:hover{background:var(--mc-soft)}.mc-dialog button:disabled{cursor:default;opacity:.5}.mc-dialog :focus-visible{outline:2px solid var(--mc-accent);outline-offset:3px}.mc-dialog select,.mc-dialog input{border:1px solid var(--mc-border);border-radius:8px;background:var(--mc-bg);padding:9px 10px;max-width:100%;min-width:0}.mc-dialog select{width:100%}.mc-dialog button.mc-primary{color:#fff;background:var(--mc-accent);border-color:var(--mc-accent)}.mc-dialog button.mc-primary:hover{filter:brightness(.93)}.mc-dialog button.mc-danger{color:var(--mc-danger)}.mc-dialog button.mc-quiet{border-color:transparent;background:transparent;color:var(--mc-muted)}.mc-dialog button.mc-quiet:hover{background:var(--mc-soft)}\n.mc-header{display:flex;align-items:center;gap:14px;padding:22px 26px;border-bottom:1px solid var(--mc-border);flex:none}.mc-header-mark{display:grid;place-items:center;width:42px;height:42px;border:1px solid var(--mc-border);border-radius:12px;background:var(--mc-soft);color:var(--mc-accent);flex:none}.mc-header-copy{flex:1;min-width:0}.mc-header h2{font-size:20px;line-height:1.4;margin:0 0 4px;font-weight:650}.mc-header p{margin:0;font-size:12px;color:var(--mc-muted)}.mc-dialog .mc-close{display:grid;place-items:center;padding:8px;border:0;background:transparent;color:var(--mc-muted)}\n.mc-columns{display:grid;grid-template-columns:244px minmax(0,1fr);flex:1;min-height:0}.mc-nav{display:flex;flex-direction:column;gap:24px;padding:22px 16px;background:var(--mc-soft);border-right:1px solid var(--mc-border);overflow:auto}.mc-workspace-label{display:block;font-size:12px;font-weight:600;color:var(--mc-muted);margin-bottom:8px}.mc-nav-heading{display:flex;align-items:center;justify-content:space-between;margin:0 0 10px;padding:0 4px;font-size:12px;color:var(--mc-muted)}.mc-nav-heading h3{font-size:inherit;font-weight:600;margin:0}.mc-nav-heading button{padding:4px}.mc-datasources{list-style:none;padding:0;margin:0;display:grid;gap:6px}.mc-dialog .mc-datasource{display:flex;align-items:start;gap:10px;width:100%;padding:12px 10px;border:1px solid transparent;background:transparent;text-align:left}.mc-dialog .mc-datasource[aria-pressed=true]{border-color:var(--mc-border);background:var(--mc-bg);box-shadow:0 2px 5px #102a3a05}.mc-datasource>svg{margin-top:2px;flex:none;color:var(--mc-muted)}.mc-datasource[aria-pressed=true]>svg{color:var(--mc-accent)}.mc-datasource-copy{min-width:0;display:grid;gap:4px}.mc-datasource-name{font-size:13px;font-weight:600;overflow-wrap:anywhere}.mc-datasource-status{font-size:11px;color:var(--mc-muted);display:flex;align-items:center;gap:5px}.mc-dot{width:6px;height:6px;background:var(--mc-muted);border-radius:50%;flex:none}.mc-dot[data-ready=true]{background:var(--mc-accent)}.mc-dot[data-ready=false]{background:#c58a26}\n.mc-main{min-width:0;overflow:auto;display:flex;flex-direction:column}.mc-form{display:flex;flex-direction:column;flex:1;min-width:0}.mc-form-body{padding:26px 30px;flex:1}.mc-detail-heading{display:flex;align-items:start;justify-content:space-between;gap:12px;flex-wrap:wrap;margin-bottom:22px}.mc-eyebrow{font-size:11px;color:var(--mc-muted);margin:0 0 5px}.mc-detail-heading h3{font-size:22px;font-weight:650;line-height:1.4;margin:0;overflow-wrap:anywhere}.mc-badge{display:inline-flex;align-items:center;gap:5px;border:1px solid var(--mc-border);border-radius:6px;padding:3px 7px;font-size:11px;white-space:nowrap;color:var(--mc-muted)}.mc-badge[data-ready=true]{color:var(--mc-accent);background:var(--mc-tint);border-color:transparent}.mc-badge[data-ready=false]{color:var(--mc-warning)}\n.mc-section-heading{font-size:13px;font-weight:600;margin:0 0 12px}.mc-properties{margin:0 0 24px;min-width:0}.mc-property-list{margin:0;border:1px solid var(--mc-border);border-radius:12px;overflow:hidden}.mc-property{display:grid;grid-template-columns:minmax(0,140px) minmax(0,1fr);gap:16px;padding:12px 18px;align-items:start}.mc-property+.mc-property{border-top:1px solid var(--mc-border)}.mc-property dt{font-size:12px;color:var(--mc-muted);overflow-wrap:anywhere}.mc-property dd{margin:0;min-width:0;font-size:12px;white-space:pre-wrap;overflow-wrap:anywhere}.mc-property pre{font:12px/1.6 ui-monospace,monospace;white-space:pre-wrap;overflow-wrap:anywhere;margin:0}.mc-property-json{max-height:240px;overflow:auto}\n.mc-fields{border:1px solid var(--mc-border);border-radius:12px;overflow:hidden;margin:0 0 14px}.mc-field{min-width:0;border:0;padding:18px;margin:0}.mc-field+.mc-field{border-top:1px solid var(--mc-border)}.mc-field-header{display:flex;align-items:start;gap:12px;justify-content:space-between}.mc-field-title{min-width:0}.mc-field-title h4{font-size:13px;margin:0 0 4px;font-weight:600;overflow-wrap:anywhere}.mc-field-title p{margin:0;font-size:11px;color:var(--mc-muted);overflow-wrap:anywhere}.mc-field-actions{display:flex;align-items:center;gap:6px;flex-wrap:wrap;flex:none}.mc-dialog .mc-field-actions button{font-size:12px;padding:5px 9px}.mc-secret-input{display:grid;gap:7px;margin-top:14px;font-size:12px;color:var(--mc-muted)}.mc-secret-input input{width:100%;color:var(--mc-text)}.mc-field-note{font-size:11px;color:var(--mc-muted);margin:10px 0 0;overflow-wrap:anywhere}.mc-confirm{margin-top:12px;padding:12px;border:1px solid var(--mc-border);border-radius:8px;background:var(--mc-soft);display:flex;align-items:center;flex-wrap:wrap;gap:8px;font-size:12px}.mc-confirm p{flex-basis:100%;margin:0}.mc-note{font-size:12px;color:var(--mc-muted);margin:12px 0;overflow-wrap:anywhere}\n.mc-test{margin-top:24px;padding-top:20px;border-top:1px solid var(--mc-border)}.mc-test-heading{display:flex;align-items:center;justify-content:space-between;gap:8px;margin-bottom:12px}.mc-test-heading h4{margin:0;font-size:13px}.mc-test-heading time{font-size:11px;color:var(--mc-muted)}.mc-result{border-radius:9px;padding:12px 14px;background:var(--mc-tint);color:var(--mc-accent);font-size:12px}.mc-result[data-tone=error]{background:var(--mc-soft);color:var(--mc-danger)}.mc-result[data-tone=stale]{background:var(--mc-soft);color:var(--mc-muted)}.mc-result-title{display:flex;align-items:center;gap:7px;font-weight:600;font-size:13px}.mc-result p{margin:6px 0 0}.mc-result details{margin-top:9px}.mc-result summary{cursor:pointer}.mc-result pre{white-space:pre-wrap;overflow-wrap:anywhere;max-height:180px;overflow:auto;font:12px/1.6 ui-monospace,monospace}.mc-empty-test{font-size:12px;color:var(--mc-muted);margin:0}\n.mc-form-footer{padding:16px 30px;border-top:1px solid var(--mc-border);background:var(--mc-bg);position:sticky;bottom:0;display:flex;align-items:center;flex-wrap:wrap;gap:8px}.mc-form-footer button{font-size:13px}.mc-form-footer .mc-cancel{margin-left:auto}.mc-alert{margin:16px 30px 0;padding:12px 14px;border-radius:8px;font-size:12px;background:var(--mc-soft);color:var(--mc-danger);white-space:pre-wrap;overflow-wrap:anywhere}.mc-request-status{margin:0 0 18px;padding:12px 14px;border-radius:9px;background:var(--mc-soft);font-size:12px}.mc-request-status p{margin:4px 0 0;color:var(--mc-muted)}.mc-requests{padding:12px 20px;border-bottom:1px solid var(--mc-border);display:flex;align-items:center;gap:8px;flex-wrap:wrap;font-size:12px}.mc-requests button{font-size:12px}.mc-pending-entry{font:inherit;font-size:12px;cursor:pointer;border:1px solid currentColor;border-radius:7px;padding:5px 9px;background:transparent;color:inherit}\n.mc-activity{padding:14px 30px;background:var(--mc-soft);border-top:1px solid var(--mc-border)}.mc-activity-heading{font-size:12px;color:var(--mc-muted);margin:0 0 8px}.mc-activity-list{display:flex;gap:6px;flex-wrap:wrap}.mc-activity-list button{font-size:12px}.mc-activity-list button[aria-pressed=true]{border-color:var(--mc-accent);color:var(--mc-accent)}.mc-progress{font-size:12px;margin-top:10px;display:flex;align-items:center;gap:10px;flex-wrap:wrap}.mc-progress p{margin:0}.mc-progress button{font-size:12px;margin-left:auto}.mc-operation-note{font-size:12px;margin-top:12px;color:var(--mc-muted)}.mc-operation-note p{margin:6px 0}.mc-operation-note[data-error=true]{color:var(--mc-danger)}.mc-empty{padding:64px 28px;text-align:center;color:var(--mc-muted);margin:auto}.mc-empty>svg{margin-bottom:10px;opacity:.65}.mc-empty h3{font-size:15px;color:var(--mc-text);margin:0 0 8px}.mc-empty p{font-size:12px;margin:0}.mc-loading{padding:18px 30px;font-size:12px;color:var(--mc-muted)}\n@media(prefers-color-scheme:dark){.mc-dialog{--mc-bg:var(--dsw-alias-surface-primary,#182127);--mc-soft:var(--dsw-alias-interactive-bg-hover,#202d34);--mc-text:var(--dsw-alias-label-primary,#e4edf1);--mc-muted:var(--dsw-alias-label-secondary,#9baeb9);--mc-border:var(--dsw-alias-border-l2,#35464f);--mc-accent:#39b8a8;--mc-tint:#153d39;--mc-danger:#ef998b;--mc-warning:#d6b778}.mc-dialog button.mc-primary{color:#102a29}}\n@media(max-width:700px){.mc-property{grid-template-columns:minmax(0,1fr);gap:5px;padding:12px 14px}}\n@media(max-width:700px){.mc-dialog{width:calc(100vw - 16px);height:calc(100dvh - 16px);max-height:calc(100dvh - 16px);border-radius:12px}.mc-header{padding:16px;gap:10px}.mc-header-mark{display:none}.mc-header h2{font-size:18px}.mc-columns{display:flex;flex-direction:column;overflow:auto}.mc-nav{flex:none;padding:14px 16px;gap:14px;overflow:visible;border-right:0;border-bottom:1px solid var(--mc-border)}.mc-workspace-label{font-size:11px;margin-bottom:5px}.mc-nav select{padding:7px 10px}.mc-nav-heading{margin-bottom:5px}.mc-datasources{display:flex;overflow-x:auto;padding:2px;gap:6px}.mc-datasources li{flex:0 0 auto;max-width:240px}.mc-dialog .mc-datasource{padding:9px 10px}.mc-datasource-name{font-size:12px}.mc-main{overflow:visible;flex:1;flex-shrink:0}.mc-form-body{padding:22px 18px}.mc-detail-heading h3{font-size:20px}.mc-field{padding:14px}.mc-field-header{flex-wrap:wrap;gap:10px}.mc-field-actions{margin-left:auto}.mc-form-footer{padding:14px 18px;position:static}.mc-form-footer .mc-cancel{margin-left:0}.mc-alert{margin:14px 18px 0}.mc-activity{padding:14px 18px}.mc-test-heading{align-items:start;flex-wrap:wrap}.mc-close{align-self:start}.mc-empty{padding:32px 18px}.mc-requests{padding:12px 16px}}\n";

package/lib/types/client/presentation/ask-dsh.d.ts

@@ -0,0 +1,9 @@
+import type { ISessions, IWorkspaces } from '@deepseek-ai/dsh-client-runtime/client';
+import type { IConversation } from '@deepseek-ai/dsh-client-ui-conversation/client';
+export interface AskDshHost {
+    sessions: Pick<ISessions, 'list' | 'scope'>;
+    workspaces: Pick<IWorkspaces, 'list'>;
+    conversation: Pick<IConversation, 'input'>;
+}
+/** Append through the Host's public draft path; never submit or serialize references. */
+export declare function appendPresentationContext(host: AskDshHost, sessionId: string, workspaceId: string, context: string): void;

package/lib/types/client/presentation/chart-explorer.d.ts

@@ -0,0 +1,12 @@
+import type { TypedDataset } from '../../presentation/contracts/types.ts';
+import { type ChartExploration } from './chart-view.ts';
+import { type ChartBlock } from './model.ts';
+/** Native fields keep this page-local editor keyboard accessible without hiding the live chart. */
+export declare function ChartExplorer({ block, data, state, onChange, onClose, restoreFocusTo, }: {
+    block: ChartBlock;
+    data: TypedDataset;
+    state: ChartExploration;
+    onChange: (state: ChartExploration) => void;
+    onClose: () => void;
+    restoreFocusTo?: HTMLElement;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/chart-geometry.d.ts

@@ -0,0 +1,30 @@
+import type { ChartView } from '../../presentation/contracts/charts.ts';
+import type { TypedDataset } from '../../presentation/contracts/types.ts';
+export declare const CHART_COLORS: string[];
+/** Coordinate conversion only. The immutable source cell remains the tooltip authority. */
+export declare function chartCoordinate(data: TypedDataset, view: ChartView, rowIndex: number, field: string): number | null;
+export declare function seriesAppearance(view: ChartView, field: string, index: number): {
+    color: string;
+    lineStyle: "solid" | "dashed" | "dotted";
+    dash: string | undefined;
+};
+/** Stack offsets are drawing geometry, never a derived dataset or a normalization. */
+export declare function stackCoordinates(values: readonly (number | null)[]): ([number, number] | null)[];
+/** Includes zero; a zero-only or empty scale still has a nonzero drawing extent. */
+export declare function drawingDomain(values: readonly (number | null)[]): [number, number];
+/** Keep Recharts/d3 internal subtraction and interpolation in a finite numeric range. */
+export declare function numericDrawingAxis(values: readonly (number | null)[]): {
+    divisor: number;
+    domain: [number, number];
+};
+/** Dividing first avoids overflow for valid finite domains spanning -1e308 to 1e308. */
+export declare function drawingScale(domain: readonly [number, number], from: number, to: number): (value: number) => number;
+export declare function domainTicks(domain: readonly [number, number]): number[];
+/** Angles stay bound to the full authored snapshot, including omitted/filtered slices. */
+export declare function shareIntervals(shares: readonly (number | null)[]): ({
+    start: number;
+    end: number;
+} | null)[];
+export declare function donutPath(start: number, end: number, cx: number, cy: number, radius?: number): string;
+export declare function showValueLabels(view: ChartView, count: number): boolean;
+export declare function pointIsDrawable(value: unknown, cx: number | undefined, cy: number | undefined): boolean;

package/lib/types/client/presentation/chart-renderer.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentDataset } from '../../presentation/contracts/types.ts';
+import { type ChartBlock, type ReaderMode } from './model.ts';
+export declare function ChartRenderer({ dataset, block, mode, hidden: controlledHidden, onHiddenChange, rowIndices, }: {
+    dataset: DocumentDataset;
+    block: ChartBlock;
+    mode: ReaderMode;
+    hidden?: readonly string[];
+    onHiddenChange?: (hidden: string[]) => void;
+    rowIndices?: readonly number[];
+}): import("react").JSX.Element;

package/lib/types/client/presentation/chart-specials.d.ts

@@ -0,0 +1,10 @@
+import type { DocumentDataset } from '../../presentation/contracts/types.ts';
+import { type ChartBlock } from './model.ts';
+export declare const SPECIAL_CHARTS: Set<string>;
+export declare function SpecialChart({ dataset, block, rowIndices, visible, title, }: {
+    dataset: DocumentDataset;
+    block: ChartBlock;
+    rowIndices: readonly number[];
+    visible: ReadonlySet<string>;
+    title: string;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/chart-styles.d.ts

@@ -0,0 +1 @@
+export declare const CHART_STYLES = "\n.pr-special-frame { position:relative; min-width:0; margin:0 }\n.pr-special-scroll { overflow-x:auto; padding-bottom:4px; max-width:100% }\n.pr-special-chart { display:block; color:var(--pr-text); overflow:visible; font-size:12px; font-variant-numeric:tabular-nums }\n.pr-special-chart text { fill:var(--pr-text) }\n.pr-special-chart .pr-axis-tick { fill:var(--pr-chart-muted) }\n.pr-special-chart [data-chart-mark]:focus { outline:2px solid var(--pr-accent); outline-offset:3px }\n.pr-special-tooltip { position:absolute; top:0; left:0; z-index:2; max-width:100%; pointer-events:none }\n.pr-chart-sparkline { height:128px }\n.pr-chart-role { color:var(--pr-muted); font-size:11px }\n.pr-chart-label { fill:var(--pr-text); font-size:11px }\n.pr-special-chart .pr-chart-label { paint-order:stroke; stroke:var(--pr-bg); stroke-width:3px; stroke-linejoin:round }\n.pr-color-key { display:flex; gap:12px; flex-wrap:wrap; font-size:12px; color:var(--pr-muted); margin:8px 0 }\n.pr-color-key span { display:inline-flex; align-items:center; gap:5px }\n";

package/lib/types/client/presentation/chart-tooltip.d.ts

@@ -0,0 +1,13 @@
+import type { DocumentDataset } from '../../presentation/contracts/types.ts';
+import { type ChartBlock } from './model.ts';
+export declare function exactChartDescription(dataset: DocumentDataset, block: ChartBlock, rowIndex: number, visible?: ReadonlySet<string>): {
+    id: string;
+    label: string;
+    value: string;
+}[];
+export declare function ExactTooltip({ dataset, block, rowIndex, visible, }: {
+    dataset: DocumentDataset;
+    block: ChartBlock;
+    rowIndex: number;
+    visible?: ReadonlySet<string>;
+}): import("react").JSX.Element | null;

package/lib/types/client/presentation/chart-view.d.ts

@@ -0,0 +1,23 @@
+import { type ChartOptions, type ChartView } from '../../presentation/contracts/charts.ts';
+import type { TypedDataset } from '../../presentation/contracts/types.ts';
+import type { ChartBlock } from './model.ts';
+/** Page-local state only: the authored block and snapshot are never modified. */
+export interface ChartExploration {
+    view: ChartView;
+    hidden: string[];
+    preparedViewId?: string;
+}
+export declare function savedChartView(block: ChartBlock & {
+    label?: string;
+}): ChartView;
+export declare function initialChartExploration(block: ChartBlock): ChartExploration;
+export declare function exploredChartBlock(block: ChartBlock, state?: ChartExploration): ChartBlock;
+export declare function chartViewError(view: ChartView, dataset: TypedDataset): string | undefined;
+/** Reference lines were authored for the original fields; new bindings need new declarations. */
+export declare function withChartX(view: ChartView, x: string): ChartView;
+export declare function withChartSeries(view: ChartView, y: string[]): ChartView;
+type SeriesStyle = NonNullable<ChartOptions['series']>[string];
+/** Clearing a selector removes its declaration, including for prototype-named column IDs. */
+export declare function withChartSeriesStyle<Key extends keyof SeriesStyle>(view: ChartView, field: string, key: Key, value: SeriesStyle[Key]): ChartView;
+export declare function changeChartView(state: ChartExploration, view: ChartView, preparedViewId?: string | undefined): ChartExploration;
+export {};

package/lib/types/client/presentation/copy-context.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from 'react';
+export declare function CopyContext({ text, children, }: {
+    text: string;
+    children: (copy: (restoreFocusTo: HTMLElement) => void) => ReactNode;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/delivery-model.d.ts

@@ -0,0 +1,54 @@
+import { type PresentationEdits } from '../../presentation/contracts/editing.ts';
+import { type PresentationDocument, type PresentationReceipt } from '../../presentation/contracts/index.ts';
+import { type PresentationDelivery } from '../../presentation/receipt.ts';
+export interface PresentationRpc {
+    call(channel: string, endpoint: string, payload: unknown, signal: AbortSignal): Promise<unknown>;
+}
+export type PresentationAsset = 'presentation.json' | 'index.html';
+export interface PresentationDeliveryState {
+    readonly receipts: Readonly<Record<string, PresentationReceipt>>;
+    readonly resolvedReceipt?: PresentationReceipt;
+    readonly editing?: {
+        edits: PresentationEdits;
+        undo: PresentationEdits[];
+        redo: PresentationEdits[];
+    };
+    readonly saving?: boolean;
+    readonly editError?: string;
+    readonly open: boolean;
+    readonly delivery?: PresentationDelivery;
+    readonly loading: boolean;
+    readonly downloading: boolean;
+    readonly document?: PresentationDocument;
+    readonly error?: string;
+    readonly downloadError?: string;
+    readonly notice?: string;
+}
+export type SavePresentationHtml = (bytes: Uint8Array, filename: string) => void;
+/** Download verified bytes as an attachment; never insert generated HTML in the Host DOM. */
+export declare function savePresentationHtml(bytes: Uint8Array, filename: string): void;
+/** Check the exact receipt-bound bytes before either parsing JSON or downloading HTML. */
+export declare function verifyPresentationAsset(value: unknown, receipt: PresentationReceipt, asset: PresentationAsset): Promise<Uint8Array>;
+export declare const reportKey: (receipt: PresentationReceipt) => string;
+/** Host file actions and editor state; never an Agent or data-source execution path. */
+export declare class PresentationDeliveryModel {
+    #private;
+    constructor(rpc: PresentationRpc, save?: SavePresentationHtml);
+    getSnapshot: () => PresentationDeliveryState;
+    subscribe: (listener: () => void) => () => void;
+    preview(delivery: PresentationDelivery, sessionId: string, workspaceId: string): Promise<void>;
+    show(delivery: PresentationDelivery, sessionId: string, workspaceId: string): Promise<void>;
+    get dirty(): boolean;
+    beginEdit(): void;
+    changeEdits(edits: PresentationEdits): void;
+    undoEdit(): void;
+    redoEdit(): void;
+    cancelEdit(): void;
+    saveEdit(): Promise<void>;
+    download(delivery: PresentationDelivery, sessionId: string, workspaceId: string, displayed?: boolean): Promise<void>;
+    contextChanged(sessionId: string, workspaceId: string): void;
+    unavailable(message?: string): void;
+    close(): void;
+    resetConnection(): void;
+    dispose(): void;
+}

package/lib/types/client/presentation/delivery.d.ts

@@ -0,0 +1,77 @@
+import type { ChatConversationViewNode, ConversationNodeContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type PresentationDelivery } from '../../presentation/receipt.ts';
+export declare const PRESENTATION_TURN_DATA_KEY = "marivo-presentation-delivery";
+export interface PresentationTurnDelivery {
+    readonly seq: number;
+    readonly delivery: PresentationDelivery;
+}
+export interface PresentationTurnData {
+    readonly deliveries: readonly PresentationTurnDelivery[];
+}
+interface PresentationTurnState extends PresentationTurnData {
+    readonly turn: number;
+    readonly calls: ReadonlyMap<string, string>;
+}
+declare module '@deepseek-ai/dsh-client-runtime/client' {
+    interface ConversationTurnDataMap {
+        'marivo-presentation-delivery': PresentationTurnData;
+    }
+}
+declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
+    interface ChatNodeDataMap {
+        'marivo-presentation-delivery': PresentationTurnData;
+    }
+}
+export declare function presentationDeliveryIdentity(delivery: PresentationDelivery): string;
+/** Code Mode carries the same envelope as Native metadata, inside one durable block. */
+export declare function parsePresentationDurableContent(value: unknown): PresentationDelivery | null;
+/** Calls are collected only from this Harness-owned Turn, including the Code root call. */
+export declare function presentationDeliveryFromEvent(value: unknown, calls: ReadonlyMap<string, string>, turn: number): PresentationTurnDelivery | null;
+export declare const marivoPresentationDeliveryDefinition: {
+    kind: string;
+    target: string;
+    match(value: unknown): {
+        id: string;
+        role: "start" | "update";
+    } | null;
+    start(_context: unknown, match: {
+        event: any;
+    }): PresentationTurnState;
+    update(context: {
+        state: PresentationTurnState;
+    }, match: {
+        event: any;
+    }): PresentationTurnState;
+    buildLocationData(context: {
+        state?: PresentationTurnState;
+    }, scope: string): {
+        kind: "turn";
+        turn: number;
+        key: "marivo-presentation-delivery";
+        value: Readonly<{
+            deliveries: readonly PresentationTurnDelivery[];
+        }>;
+    } | null;
+    buildViewNode(context: ConversationNodeContext<PresentationTurnState>): {
+        key: string;
+        id: string;
+        kind: string;
+        target: "chat";
+        anchorSeq: number;
+        location: {
+            readonly kind: "turn";
+            readonly turn: import("@deepseek-ai/dsh-client-runtime/client").TurnLocation;
+        } | {
+            readonly kind: "step";
+            readonly turn: import("@deepseek-ai/dsh-client-runtime/client").TurnLocation;
+            readonly step: import("@deepseek-ai/dsh-client-runtime/client").StepLocation;
+        };
+        visibility: "visible";
+        data: Readonly<{
+            deliveries: readonly PresentationTurnDelivery[];
+        }>;
+    } | null;
+};
+/** Session identity comes from the Host's keyed Chat slot, never from an event field. */
+export declare function presentationsForNode(node: ChatConversationViewNode, sessionId: string): PresentationDelivery[];
+export {};

package/lib/types/client/presentation/editor-controls.d.ts

@@ -0,0 +1,12 @@
+import type { PresentationEdits } from '../../presentation/contracts/editing.ts';
+import type { PresentationBlock, PresentationDocument } from '../../presentation/contracts/types.ts';
+export interface ReaderEditing {
+    edits: PresentationEdits;
+    onChange: (edits: PresentationEdits) => void;
+    disabled?: boolean;
+}
+export declare function CellEditor({ block, document, editing, }: {
+    block: PresentationBlock;
+    document: PresentationDocument;
+    editing: ReaderEditing;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/global-filters.d.ts

@@ -0,0 +1,6 @@
+import type { PresentationInteraction } from '../../presentation/contracts/types.ts';
+export declare function GlobalFilterControls({ interaction, selection, onChange, }: {
+    interaction: PresentationInteraction;
+    selection: Record<string, string>;
+    onChange: (selection: Record<string, string>) => void;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/host-entry.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from 'react';
+import type { PresentationDocument } from '../../presentation/contracts/types.ts';
+import type { ReaderEditing } from './editor-controls.tsx';
+import type { OpenSemanticRef } from './source-facts.ts';
+/** Host integrations supply only outer actions; document interpretation stays shared. */
+export declare function HostPresentationReader({ document, actions, editing, onOpenSemanticRef, onAskDsh, }: {
+    document: PresentationDocument;
+    editing?: ReaderEditing;
+    actions?: ReactNode;
+    onOpenSemanticRef?: OpenSemanticRef;
+    onAskDsh?: (context: string) => void;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/icons.d.ts

@@ -0,0 +1,4 @@
+import type { SVGProps } from 'react';
+export declare function CopyIcon(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;
+export declare function MoreIcon(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;
+export declare function CloseIcon(props: SVGProps<SVGSVGElement>): import("react").JSX.Element;

package/lib/types/client/presentation/install.d.ts

@@ -0,0 +1,15 @@
+export declare function PresentationCards({ matched, sessionId, workspaces, model }: {
+    matched: any;
+    sessionId: any;
+    workspaces: any;
+    model: any;
+}): import("react").JSX.Element | null;
+export declare function PresentationOverlay({ model, sessionId, workspaceId, workspaceUnavailable, openSemanticObject, onAskDsh, }: {
+    model: any;
+    sessionId: any;
+    workspaceId: any;
+    workspaceUnavailable?: boolean | undefined;
+    openSemanticObject: any;
+    onAskDsh: any;
+}): import("react").JSX.Element | null;
+export declare function installPresentation(ctx: any, rpc: any, openSemanticObject: any): void;

package/lib/types/client/presentation/markdown.d.ts

@@ -0,0 +1,5 @@
+export declare function safeMarkdownHref(value: string): string | undefined;
+export declare function Markdown({ text, depth }: {
+    text: string;
+    depth?: number;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/model.d.ts

@@ -0,0 +1,62 @@
+import { type ChartView } from '../../presentation/contracts/charts.ts';
+import type { Cell, DatasetColumn, DocumentDataset, PresentationBlock, PresentationDocument, SourceSnapshot, TypedDataset } from '../../presentation/contracts/types.ts';
+import type { ChartExploration } from './chart-view.ts';
+export type ReaderMode = 'interactive' | 'static';
+export type ChartBlock = Extract<PresentationBlock, {
+    kind: 'chart';
+}>;
+export type MetricBlock = Extract<PresentationBlock, {
+    kind: 'metric';
+}>;
+export declare const TABLE_PAGE_SIZE = 20;
+export declare function cellText(value: Cell, column: DatasetColumn): string;
+export declare function valueWithUnit(value: Cell, column: DatasetColumn): string;
+/** Add grouping separators only; never round, rescale, or convert exact decimal text. */
+export declare function metricText(value: Cell, column: DatasetColumn): string;
+/** A stable explicit timezone keeps portable and Host metadata equally readable. */
+export declare function snapshotDate(value: string): string;
+export declare function columnLabel(column: DatasetColumn): string;
+/** Axis labels are compact coordinates; tooltips and tables retain exact source text. */
+export declare function formatAxisTick(value: number): string;
+export declare function formatCategoryTick(value: string): string;
+export declare function datasetById(document: PresentationDocument, id: string): DocumentDataset;
+export declare function columnIndex(dataset: TypedDataset, id: string): number;
+export declare function selectMetric(dataset: TypedDataset, block: MetricBlock, rowIndices?: readonly number[]): {
+    column: DatasetColumn;
+    value: string | number | boolean;
+    comparisons: {
+        label: string;
+        reference: {
+            value: string | number | boolean;
+            sign: number | undefined;
+            text: string;
+        } | undefined;
+        delta: {
+            value: string | number | boolean;
+            sign: number | undefined;
+            text: string;
+        } | undefined;
+        relative: {
+            value: string | number | boolean;
+            sign: number | undefined;
+            text: string;
+        } | undefined;
+        sign: number | undefined;
+        tone: string;
+    }[];
+};
+export declare function compareDecimalText(first: string, second: string): number;
+export declare function sortedRowIndices(dataset: TypedDataset, sort?: {
+    columnId: string;
+    direction: 'ascending' | 'descending';
+}): number[];
+export declare function datasetScope(dataset: TypedDataset): string;
+export interface ChartRow {
+    rowIndex: number;
+    xLabel: string;
+    [key: string]: number | string | null;
+}
+export declare function chartRows(dataset: TypedDataset, block: ChartView, rowIndices?: readonly number[]): ChartRow[];
+export declare function chartTitle(dataset: TypedDataset, block: ChartView): string;
+export declare function selectedSources(document: PresentationDocument, ids: string[]): SourceSnapshot[];
+export declare function followUpContext(document: PresentationDocument, savedBlock: PresentationBlock, exploration?: ChartExploration, selection?: Record<string, string>): string;

package/lib/types/client/presentation/reader.d.ts

@@ -0,0 +1,11 @@
+import type { PresentationDocument } from '../../presentation/contracts/types.ts';
+import { type ReaderEditing } from './editor-controls.tsx';
+import { type ReaderMode } from './model.ts';
+import type { OpenSemanticRef } from './source-facts.ts';
+export declare function PresentationReader({ document, mode, editing, onOpenSemanticRef, onAskDsh, }: {
+    document: PresentationDocument;
+    mode?: ReaderMode;
+    editing?: ReaderEditing;
+    onOpenSemanticRef?: OpenSemanticRef;
+    onAskDsh?: (context: string) => void;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/source-code-model.d.ts

@@ -0,0 +1,16 @@
+import type { PresentationBlock, PresentationDocument } from '../../presentation/contracts/types.ts';
+export type SourceTab = 'overview' | 'preview' | 'code';
+export declare function sourceTabs(hasDataset: boolean): SourceTab[];
+export declare function sourceTabForKey(tabs: readonly SourceTab[], current: SourceTab, key: string): SourceTab | undefined;
+interface CodeEntry {
+    key: string;
+    language: 'python' | 'sql';
+    text: string;
+    authorAssociated: boolean;
+}
+/** Read only the selected cell binding; prepared views are separate, unselected bindings. */
+export declare function sourceCodeFacts(document: PresentationDocument, block?: PresentationBlock): {
+    entries: CodeEntry[];
+    notices: string[];
+};
+export {};

package/lib/types/client/presentation/source-code.d.ts

@@ -0,0 +1,11 @@
+import type { PresentationBlock, PresentationDocument } from '../../presentation/contracts/types.ts';
+export declare function SourceCode({ document, block, interactive, }: {
+    document: PresentationDocument;
+    block?: PresentationBlock;
+    interactive?: boolean;
+}): import("react").JSX.Element;
+/** Native disclosures remain usable in saved HTML with JavaScript disabled. */
+export declare function SourceCodeSummary({ document, block, }: {
+    document: PresentationDocument;
+    block?: PresentationBlock;
+}): import("react").JSX.Element | import("react").JSX.Element[];

package/lib/types/client/presentation/source-dialog.d.ts

@@ -0,0 +1,13 @@
+import type { PresentationBlock, PresentationDocument } from '../../presentation/contracts/types.ts';
+import type { OpenSemanticRef } from './source-facts.ts';
+export declare function SourceDialog({ document, block, onClose, restoreFocusTo, rowIndices, filterKey, filterSummary, explored, onOpenSemanticRef, }: {
+    document: PresentationDocument;
+    block: PresentationBlock;
+    onClose: () => void;
+    restoreFocusTo?: HTMLElement | null;
+    rowIndices?: readonly number[];
+    filterKey?: string;
+    filterSummary?: string;
+    explored?: boolean;
+    onOpenSemanticRef?: OpenSemanticRef;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/source-facts.d.ts

@@ -0,0 +1,20 @@
+import type { SourceSnapshot } from '../../presentation/contracts/types.ts';
+import { type SemanticRef } from '../../semantic-reference/contracts.ts';
+export type OpenSemanticRef = (ref: SemanticRef) => void;
+export declare function sourceSemanticRef(kind: string, path: string): SemanticRef | undefined;
+interface SemanticGroup {
+    kind: string;
+    paths: string[];
+}
+/** Read only the fields already projected into the saved source snapshot. */
+export declare function sourceOverviewFacts(source: SourceSnapshot): {
+    createdAt: string | undefined;
+    semanticGroups: SemanticGroup[];
+    issues: {
+        kind: string;
+        severity?: string;
+    }[];
+    notices: string[];
+};
+export declare function semanticKindLabel(kind: string): string;
+export {};

package/lib/types/client/presentation/source-format.d.ts

@@ -0,0 +1,5 @@
+/** Presentation-only formatting; never execute code or change the saved snapshot. */
+export declare function formatSource(text: string, language: 'python' | 'sql'): {
+    text: string;
+    formatted: boolean;
+};

package/lib/types/client/presentation/source-highlight.d.ts

@@ -0,0 +1,7 @@
+export interface SourceToken {
+    text: string;
+    offset: number;
+    color?: string;
+}
+/** Local, synchronous highlighting also works in the scripts-disabled HTML fallback. */
+export declare function highlightSource(text: string, language: 'python' | 'sql'): SourceToken[];

package/lib/types/client/presentation/sources.d.ts

@@ -0,0 +1,13 @@
+import type { PresentationBlock, PresentationDocument, SourceSnapshot } from '../../presentation/contracts/types.ts';
+import { type OpenSemanticRef } from './source-facts.ts';
+export declare function blockSources(document: PresentationDocument, block?: PresentationBlock): SourceSnapshot[];
+export declare function SourceOverview({ document, block, onOpenSemanticRef, }: {
+    document: PresentationDocument;
+    block?: PresentationBlock;
+    onOpenSemanticRef?: OpenSemanticRef;
+}): import("react").JSX.Element;
+/** Compact native disclosure for reading the saved report without JavaScript. */
+export declare function SourceSummary({ document, block, }: {
+    document: PresentationDocument;
+    block?: PresentationBlock;
+}): import("react").JSX.Element | null;

package/lib/types/client/presentation/styles.d.ts

@@ -0,0 +1 @@
+export declare const PRESENTATION_STYLES = "\n.pr-reader {\n  --pr-bg:#fff; --pr-soft:#f7f7f8; --pr-text:#242424; --pr-muted:#666;\n  --pr-code-keyword:#8a3294; --pr-code-string:#216b43; --pr-code-number:#995119; --pr-code-function:#285d9e;\n  --pr-border:#e5e5e7; --pr-accent:#3567b7; --pr-warning:#805b20;\n  --pr-chart-1:#286dee; --pr-chart-2:#ba7039; --pr-chart-3:#548878;\n  --pr-chart-muted:#96969b; --pr-chart-grid:rgba(13,13,13,.06); --pr-chart-hover:rgba(13,13,13,.03); --pr-chart-4:#8d6cb0; --pr-chart-5:#b46379; --pr-chart-6:#727c38;\n  box-sizing:border-box; margin:0 auto; padding:48px clamp(20px,4%,64px); width:100%; max-width:none; min-width:0;\n  color:var(--pr-text); background:var(--pr-bg); font:16px/1.65 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif;\n  overflow-wrap:anywhere; color-scheme:light;\n}\n.pr-reader * { box-sizing:border-box }\n.pr-reader h1,.pr-reader h2,.pr-reader h3,.pr-reader h4 { line-height:1.4; font-weight:600; text-wrap:balance }\n.pr-reader h1 { font-size:30px; margin:0 0 12px; letter-spacing:-.025em }\n.pr-reader h2 { font-size:21px; margin:0 0 16px }\n.pr-reader h3 { font-size:17px; margin:0 0 12px }\n.pr-reader p { margin:10px 0 }\n.pr-reader button,.pr-reader select,.pr-reader textarea { font:inherit; color:inherit }\n.pr-reader button,.pr-reader select { border:1px solid var(--pr-border); border-radius:8px; background:var(--pr-bg); padding:6px 10px; max-width:100% }\n.pr-reader button { cursor:pointer }\n.pr-reader button:hover { background:var(--pr-soft) }\n.pr-reader button:disabled { opacity:.45; cursor:default }\n.pr-reader :focus-visible { outline:3px solid var(--pr-accent); outline-offset:3px }\n.pr-reader a { color:var(--pr-accent); text-decoration:underline; text-underline-offset:3px }\n.pr-reader summary { cursor:pointer; color:var(--pr-muted); padding:8px 0; font-size:13px }\n.pr-reader summary:hover { color:var(--pr-text) }\n.pr-reader details[open]>summary { margin-bottom:8px }\n.pr-muted { color:var(--pr-muted); font-size:13px }\n.pr-header { padding-bottom:28px; margin-bottom:32px; border-bottom:1px solid var(--pr-border) }\n.pr-blocks { display:flex; flex-direction:column; gap:32px }\n.pr-block { min-width:0; position:relative }\n.pr-block-markdown { padding:0; width:100% }\n.pr-block-chart { padding:0; border:0; border-radius:0 }\n.pr-block-chart>h2 { font-size:17px }\n.pr-chart-row { display:flex; flex-direction:column; gap:32px; min-width:0 }\n.pr-chart-row>.pr-block-chart { width:100% }\n.pr-reader[data-mode=interactive] .pr-chart-row { flex-direction:row; flex-wrap:wrap; align-items:flex-start }\n.pr-reader[data-mode=interactive] .pr-chart-row>.pr-block-chart { flex:1 1 calc((100% - 32px)/2); min-width:min(100%,560px); max-width:100% }\n.pr-reader[data-mode=interactive] .pr-chart-row>.pr-block-chart[data-chart-layout=wide] { min-width:min(100%,720px) }\n.pr-metric-group { display:flex; flex-wrap:wrap; gap:16px; min-width:0 }\n.pr-metric-group>.pr-block-metric { flex:1 1 240px; min-width:min(100%,240px); max-width:min(100%,480px) }\n.pr-block-metric { border:1px solid var(--pr-border); border-radius:14px; padding:20px; display:flex; flex-direction:column; gap:4px }\n.pr-block-metric h2 { font-size:13px; font-weight:500; color:var(--pr-muted); margin:0 }\n.pr-metric-value { font-size:clamp(24px,3vw,32px); font-variant-numeric:tabular-nums; font-weight:600; line-height:1.35; letter-spacing:-.025em }\n.pr-metric-value { white-space:nowrap; overflow-x:auto; max-width:100% }\n.pr-metric-comparisons { display:grid; gap:12px; margin-top:auto; padding-top:12px }\n.pr-metric-comparison { display:flex; flex-wrap:wrap; gap:4px 10px; border-top:1px solid var(--pr-border); padding-top:10px; font-size:13px; font-variant-numeric:tabular-nums }\n.pr-metric-comparison>.pr-muted { flex-basis:100% }\n.pr-metric-change { display:flex; flex-wrap:wrap; gap:4px 8px }\n.pr-metric-change-positive { color:#167044 }\n.pr-metric-change-negative { color:#b42318 }\n.pr-metric-change-neutral { color:var(--pr-muted) }\n.pr-notice { color:var(--pr-warning); font-size:13px; border-left:2px solid currentColor; padding-left:12px }\n.pr-empty { padding:24px; text-align:center; color:var(--pr-muted); background:var(--pr-soft); border-radius:8px }\n.pr-markdown p { white-space:pre-wrap }\n.pr-markdown pre { max-width:100%; overflow:auto; background:var(--pr-soft); padding:16px; border-radius:8px; font:13px/1.65 ui-monospace,monospace }\n.pr-markdown code { font-family:ui-monospace,monospace; font-size:.9em; background:var(--pr-soft); padding:2px 4px; border-radius:3px }\n.pr-markdown pre code { padding:0 }\n.pr-markdown blockquote { border-left:3px solid var(--pr-border); padding-left:18px; margin:16px 0; color:var(--pr-muted) }\n.pr-markdown hr { border:0; border-top:1px solid var(--pr-border); margin:24px 0 }\n.pr-markdown ul,.pr-markdown ol { padding-left:24px }\n.pr-markdown li+li { margin-top:6px }\n.pr-table-scroll { max-width:100%; overflow:auto }\n.pr-table table { border-collapse:collapse; min-width:100%; font-size:13px }\n.pr-table caption { text-align:left; font-size:12px; color:var(--pr-muted); padding:8px 12px }\n.pr-table th,.pr-table td { padding:12px; text-align:left; border-bottom:1px solid var(--pr-border); vertical-align:top; white-space:pre-wrap; overflow-wrap:anywhere; min-width:90px; max-width:400px }\n.pr-table th { font-weight:500; color:var(--pr-muted) }\n.pr-table th button { position:relative; font-weight:500; padding:0; text-align:inherit; border:0; background:transparent; border-radius:0 }\n.pr-table th.pr-numeric { text-align:right }\n.pr-sort-indicator { position:absolute; left:calc(100% + 3px); top:0; font-size:11px; line-height:inherit }\n.pr-table tbody tr:hover { background:var(--pr-soft) }\n.pr-table td.pr-numeric { text-align:right; font-variant-numeric:tabular-nums; white-space:nowrap }\n.pr-table td[data-cell-null=true] { color:var(--pr-muted) }\n.pr-pagination { display:flex; gap:12px; align-items:center; justify-content:flex-end; flex-wrap:wrap; margin-top:12px; font-size:12px }\n.pr-diagnostics { margin:0 0 28px; padding:16px; background:var(--pr-soft); border-radius:10px; font-size:13px }\n.pr-diagnostics h2 { font-size:14px; margin:0 }\n.pr-diagnostics ul { padding-left:20px }\n.pr-legend { display:flex; flex-wrap:wrap; gap:8px 16px; margin:8px 0 0; justify-content:center }\n.pr-legend button { display:flex; align-items:center; gap:7px; font-size:12px; border:0; padding:4px 0; background:transparent }\n.pr-legend button[aria-pressed=false] { opacity:.5; text-decoration:line-through }\n.pr-swatch { display:inline-block; width:9px; height:9px; border-radius:50%; flex-shrink:0 }\n.pr-chart { margin:0; width:100%; min-width:0; height:320px }\n.pr-chart svg { overflow:visible }\n.pr-chart-group+.pr-chart-group { margin-top:24px }\n.pr-chart .recharts-cartesian-axis-tick-value { font-variant-numeric:tabular-nums }\n.pr-tooltip { padding:10px 13px; border:1px solid var(--pr-border); border-radius:10px; background:var(--pr-bg); color:var(--pr-text); font-size:12px; box-shadow:0 4px 18px #0001; max-width:min(420px,80vw) }\n.pr-tooltip dl { margin:5px 0 0 }\n.pr-tooltip dl>div { display:flex; flex-wrap:wrap; justify-content:space-between; gap:6px 20px }\n.pr-tooltip dt { color:var(--pr-muted) }\n.pr-tooltip dd { margin:0; font-variant-numeric:tabular-nums; overflow-wrap:anywhere }\n\n.pr-cell-toolbar { position:absolute; top:0; right:0; display:flex; align-items:center; gap:4px; z-index:2 }\n.pr-block-metric>.pr-cell-toolbar { top:12px; right:12px }\n.pr-block-metric>h2,.pr-block-chart>h2 { padding-right:32px }\n.pr-block-markdown .pr-markdown>:first-child { padding-right:40px }\n.pr-reader[data-mode=interactive] .pr-block-table { padding-top:30px }\n.pr-block-source>h2 { padding-right:40px }\n.pr-reader .pr-icon-button { display:inline-flex; align-items:center; justify-content:center; width:28px; height:28px; padding:5px; border:0; background:transparent; color:var(--pr-muted); border-radius:6px; flex-shrink:0 }\n.pr-reader .pr-icon-button:hover { background:var(--pr-soft); color:var(--pr-text) }\n.pr-icon-button svg { width:18px; height:18px; display:block }\n.pr-copy,.pr-cell-menu { position:relative; display:inline-flex; align-items:center }\n.pr-copy-status { position:absolute; right:0; top:calc(100% + 4px); white-space:nowrap; font-size:12px; background:var(--pr-bg); color:var(--pr-text); border-radius:5px }\n.pr-copy-status:not(:empty) { padding:4px 8px; border:1px solid var(--pr-border); box-shadow:0 2px 8px #0001 }\n.pr-cell-menu-popup { position:absolute; right:0; top:calc(100% + 4px); min-width:136px; padding:4px; background:var(--pr-bg); border:1px solid var(--pr-border); border-radius:10px; box-shadow:0 6px 24px #0002; z-index:3 }\n.pr-cell-menu-popup>button { display:block; width:100%; border:0; border-radius:6px; text-align:left; font-size:13px; padding:8px 12px; white-space:nowrap }\n.pr-cell-menu-popup>button[aria-disabled=true] { color:var(--pr-muted); cursor:not-allowed }\n.pr-cell-menu-popup>button small { display:block; font-size:12px; font-weight:normal }\n.pr-source-dialog,.pr-dialog { color:var(--pr-text); background:var(--pr-bg); border:1px solid var(--pr-border); border-radius:24px; width:min(800px,calc(100vw - 48px)); max-width:none; max-height:min(760px,calc(100dvh - 48px)); margin:auto; padding:0; box-shadow:0 18px 70px #0003; font:14px/1.6 system-ui,-apple-system,BlinkMacSystemFont,\"Segoe UI\",sans-serif; overflow:hidden }\n.pr-source-dialog[open],.pr-dialog[open] { display:flex; flex-direction:column }\n.pr-source-dialog-shell { display:flex; flex-direction:column; min-height:0; width:100% }\n.pr-reader .pr-source-dialog-context { font-size:13px; color:var(--pr-muted); margin:4px 0 0 }\n.pr-source-dialog::backdrop,.pr-dialog::backdrop { background:#0005 }\n.pr-source-dialog-header,.pr-dialog-header { display:flex; justify-content:space-between; align-items:center; gap:16px; padding:20px 24px 4px; flex-shrink:0 }\n.pr-source-dialog .pr-source-dialog-title,.pr-dialog-header h2 { font-size:24px; font-weight:500; margin:0 }\n.pr-reader .pr-source-dialog-close { width:32px; height:32px; border:0; padding:6px; background:transparent; color:var(--pr-muted); flex-shrink:0 }\n.pr-source-dialog-close svg { width:18px; height:18px }\n.pr-source-tabs { display:flex; gap:28px; padding:0 24px; border-bottom:1px solid var(--pr-border); flex-shrink:0 }\n.pr-reader .pr-source-tab { padding:14px 0; border:0; border-bottom:2px solid transparent; border-radius:0; background:transparent; color:var(--pr-muted); font-size:14px }\n.pr-reader .pr-source-tab[aria-selected=true] { color:var(--pr-text); border-bottom-color:var(--pr-text) }\n.pr-source-dialog-body { padding:20px 24px 24px; overflow:auto; min-height:0; overscroll-behavior:contain }\n.pr-source-overview { font-size:14px; min-width:0 }\n.pr-source-overview-grid { display:grid; grid-template-columns:repeat(3,minmax(0,1fr)); gap:20px 24px; margin:0 0 24px }\n.pr-source-overview-grid>div { min-width:0 }\n.pr-source-overview-grid dt { color:var(--pr-muted); font-size:13px; margin:0 0 4px }\n.pr-source-overview-label { color:var(--pr-muted); font-size:13px; font-weight:400; margin:0 0 4px }\n.pr-source-overview dd { margin:0; overflow-wrap:anywhere }\n.pr-source-fields { display:flex; flex-wrap:wrap; gap:4px 10px; list-style:none; padding:0; margin:0 }\n.pr-source-list { display:flex; flex-direction:column; gap:24px }\n.pr-source-card { min-width:0 }\n.pr-source-card+.pr-source-card { border-top:1px solid var(--pr-border); padding-top:20px }\n.pr-source-card h3 { font-size:14px; margin:0 0 12px; font-weight:500 }\n.pr-source-semantic-group { margin-top:16px }\n.pr-source-semantic-list { display:flex; flex-wrap:wrap; gap:6px; list-style:none; padding:0; margin:4px 0 16px }\n.pr-source-semantic-list>li { border:1px solid var(--pr-border); border-radius:14px; padding:2px 8px; overflow-wrap:anywhere; max-width:100%; font-size:13px }\n.pr-reader .pr-semantic-link { font:inherit; color:var(--pr-accent); background:none; border:0; padding:0; cursor:pointer; text-align:left; overflow-wrap:anywhere; text-decoration:underline; text-underline-offset:3px }\n.pr-reader .pr-semantic-link:focus-visible { outline:2px solid var(--pr-accent); outline-offset:3px; border-radius:3px }\n.pr-source-issues { margin:12px 0 0; color:var(--pr-warning); font-size:13px }\n.pr-source-summary { margin-top:32px; padding-top:16px; border-top:1px solid var(--pr-border) }\n.pr-source-summary>summary { font-size:14px }\n.pr-source-code { display:flex; flex-direction:column; gap:20px; min-width:0 }\n.pr-source-code-snippet { min-width:0 }\n.pr-source-code-header { display:flex; flex-wrap:wrap; justify-content:space-between; align-items:center; gap:8px; margin-bottom:8px }\n.pr-source-code-header h3 { margin:0; font-size:14px; font-weight:500 }\n.pr-source-code-copy { display:flex; flex-wrap:wrap; align-items:center; gap:8px; font-size:12px; color:var(--pr-muted) }\n.pr-reader .pr-source-code-note { margin:0 0 8px; font-size:12px; color:var(--pr-muted) }\n.pr-source-code-copy button { font-size:12px }\n.pr-source-code pre { margin:0; padding:14px 16px; border:1px solid var(--pr-border); border-radius:10px; background:var(--pr-soft); max-height:420px; overflow:auto; white-space:pre; tab-size:4; user-select:text; font:12px/1.7 ui-monospace,SFMono-Regular,Consolas,monospace }\n.pr-source-code-summary { margin-top:20px }\n.pr-source-code-summary>summary { margin-bottom:12px; font-size:14px }\n.pr-copy-dialog { max-width:640px; padding-bottom:24px; overflow:auto }\n.pr-copy-dialog>p,.pr-copy-dialog>label { margin:16px 24px }\n.pr-copy-dialog textarea { display:block; width:calc(100% - 48px); min-height:220px; max-height:50vh; margin:16px 24px 0; padding:12px; background:var(--pr-soft); color:var(--pr-text); border:1px solid var(--pr-border); border-radius:8px; font:13px/1.65 ui-monospace,monospace; resize:vertical }\n\n.pr-chart-explorer { margin:18px 0; padding:20px; border:1px solid var(--pr-border); border-radius:12px; background:var(--pr-soft); font-size:13px; min-width:0 }\n.pr-explorer-header { display:flex; justify-content:space-between; gap:12px; align-items:flex-start }\n.pr-explorer-header h3 { margin:0 }\n.pr-explorer-grid { display:grid; grid-template-columns:repeat(auto-fit,minmax(min(100%,200px),1fr)); gap:14px; margin:14px 0 }\n.pr-explorer-grid>label { display:flex; flex-direction:column; gap:6px; min-width:0 }\n.pr-explorer-grid select { width:100%; min-width:0 }\n.pr-explorer-fields { border:0; border-top:1px solid var(--pr-border); padding:12px 0 0; margin:16px 0 0; min-width:0 }\n.pr-explorer-fields legend { font-weight:600; padding:0 8px 0 0 }\n.pr-explorer-series { display:flex; align-items:center; flex-wrap:wrap; gap:10px; margin:8px 0 }\n.pr-explorer-series label { display:flex; align-items:center; gap:6px }\n.pr-explorer-series input { accent-color:var(--pr-accent); min-width:16px; min-height:16px }\n.pr-explorer-visible { color:var(--pr-muted) }\n.pr-explorer-footer { margin-top:16px; display:flex; justify-content:flex-end }\n.pr-host-print { display:none }\n\n.pr-host { min-width:0 }\n.pr-host-actions { display:flex; gap:10px; justify-content:flex-end; padding:12px }\nbody[data-presentation-portable] { margin:0; background:#fff }\nhtml[data-presentation-ready=true] body[data-presentation-portable] #presentation-fallback { display:none }\n@media(prefers-color-scheme:dark) {\n  body[data-presentation-portable] { background:#1c1c1f }\n  .pr-reader { --pr-code-keyword:#d9a0e5; --pr-code-string:#99cda7; --pr-code-number:#ebbb8a; --pr-code-function:#9bbef3; --pr-bg:#1c1c1f; --pr-soft:#262629; --pr-text:#ededed; --pr-muted:#aaa; --pr-border:#39393e; --pr-accent:#91b7f3; --pr-warning:#e3bb70; --pr-chart-1:#8cb0ed; --pr-chart-2:#dbab7f; --pr-chart-3:#8ec0a9; --pr-chart-muted:#a0a0a6; --pr-chart-grid:rgba(255,255,255,.08); --pr-chart-hover:rgba(255,255,255,.04); --pr-chart-4:#b7a0d6; --pr-chart-5:#d99bb0; --pr-chart-6:#b8be86; color-scheme:dark }\n}\n.dark .pr-reader,[data-theme=dark] .pr-reader { --pr-code-keyword:#d9a0e5; --pr-code-string:#99cda7; --pr-code-number:#ebbb8a; --pr-code-function:#9bbef3; --pr-bg:#1c1c1f; --pr-soft:#262629; --pr-text:#ededed; --pr-muted:#aaa; --pr-border:#39393e; --pr-accent:#91b7f3; --pr-warning:#e3bb70; --pr-chart-1:#8cb0ed; --pr-chart-2:#dbab7f; --pr-chart-3:#8ec0a9; --pr-chart-muted:#a0a0a6; --pr-chart-grid:rgba(255,255,255,.08); --pr-chart-hover:rgba(255,255,255,.04); --pr-chart-4:#b7a0d6; --pr-chart-5:#d99bb0; --pr-chart-6:#b8be86; color-scheme:dark }\n.light .pr-reader,[data-theme=light] .pr-reader { --pr-bg:#fff; --pr-soft:#f7f7f8; --pr-text:#242424; --pr-muted:#666; --pr-border:#e5e5e7; --pr-accent:#3567b7; --pr-warning:#805b20; --pr-chart-1:#286dee; --pr-chart-2:#ba7039; --pr-chart-3:#548878; --pr-chart-muted:#96969b; --pr-chart-grid:rgba(13,13,13,.06); --pr-chart-hover:rgba(13,13,13,.03); --pr-chart-4:#8d6cb0; --pr-chart-5:#b46379; --pr-chart-6:#727c38; color-scheme:light }\n@media(max-width:640px) {\n  .pr-reader { padding:28px 20px; font-size:15px }\n  .pr-reader h1 { font-size:26px }\n  .pr-block-markdown h2 { font-size:20px }\n  .pr-blocks { gap:26px }\n  .pr-source-dialog,.pr-dialog { width:calc(100vw - 24px); max-height:calc(100dvh - 24px); border-radius:18px }\n  .pr-source-dialog-header,.pr-dialog-header { padding:16px 18px 4px }\n  .pr-source-tabs { padding:0 18px }\n  .pr-source-dialog-body { padding:18px }\n  .pr-source-overview-grid { grid-template-columns:1fr; gap:16px }\n  .pr-metric-group { gap:12px }\n  .pr-block-metric { padding:16px }\n  .pr-metric-value { font-size:25px }\n  .pr-pagination { justify-content:space-between; gap:8px }\n  .pr-tooltip { max-width:80vw }\n}\n@media(pointer:coarse) { .pr-reader summary,.pr-reader button { min-height:44px } .pr-reader .pr-icon-button { width:36px } .pr-block-metric>h2,.pr-block-chart>h2 { padding-right:44px } .pr-reader select,.pr-reader textarea { font-size:16px } }\n@media print {\n  .pr-host-live { display:none!important }\n  .pr-host-print { display:block!important }\n  html[data-presentation-ready=true] body[data-presentation-portable] #presentation-fallback,body[data-presentation-portable] #presentation-fallback { display:block!important }\n  body[data-presentation-portable] #reader,.pr-interactive { display:none!important }\n  .pr-reader { --pr-bg:#fff; --pr-soft:#fff; --pr-text:#111; --pr-muted:#444; --pr-border:#bbb; --pr-accent:#222; --pr-warning:#333; max-width:none; padding:0; font-size:10pt; color-scheme:light }\n  .pr-blocks { display:block }\n  .pr-block { border:0; padding:12px 0; border-radius:0 }\n  .pr-block-markdown { max-width:none }\n  .pr-block-metric>h2,.pr-block-chart>h2,.pr-block-markdown .pr-markdown>:first-child { padding-right:0 }\n  .pr-source-summary::details-content { content-visibility:visible }\n  .pr-source-summary>* { display:block }\n  .pr-source-code-summary { display:none!important }\n  .pr-source-dialog,.pr-dialog { display:none!important }\n  .pr-metric-group { display:grid; grid-template-columns:repeat(3,minmax(0,1fr)) }\n  .pr-metric-group>.pr-block-metric { min-width:0; max-width:none }\n  .pr-reader[data-mode] .pr-chart-row { display:block }\n  .pr-reader[data-mode] .pr-chart-row>.pr-block-chart { min-width:0; max-width:none }\n  .pr-header { break-after:avoid }\n  .pr-reader h1,.pr-reader h2,.pr-reader h3 { break-after:avoid }\n  .pr-table-scroll { overflow:visible }\n  .pr-table table { table-layout:fixed; width:100%; font-size:8pt }\n  .pr-table caption { padding-left:5px; padding-right:5px }\n  .pr-table th,.pr-table td { min-width:0; padding:5px; white-space:pre-wrap!important; overflow-wrap:anywhere }\n  .pr-table tr { break-inside:avoid }\n  .pr-table thead { display:table-header-group }\n  .pr-reader pre { white-space:pre-wrap }\n}\n.pr-region-label{color:var(--pr-muted);font-size:12px;letter-spacing:.02em;margin:0!important}\n.pr-interaction-region{min-width:0}\n.pr-region-divider{border:0;border-top:1px solid var(--pr-border);margin:0;width:100%}\n@media print{.pr-region-divider{margin:20px 0}}\n.pr-interaction-header{margin-bottom:28px}.pr-interaction-header h2{margin-bottom:4px}.pr-interaction-header>.pr-muted{margin:4px 0 16px}\n.pr-filter-toolbar{border:0;padding:0;margin:0;min-width:0;display:flex;flex-wrap:wrap;gap:8px;align-items:center;position:relative;z-index:5}\n.pr-filter-menu{position:relative;min-width:0;max-width:100%}\n.pr-reader .pr-filter-trigger{display:flex;align-items:center;gap:8px;border-radius:999px;padding:5px 12px;min-height:34px;font-size:14px;line-height:22px;max-width:100%}\n.pr-filter-label{color:var(--pr-muted);flex-shrink:0}.pr-filter-value{white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:200px}\n.pr-filter-popup{position:absolute;top:calc(100% + 6px);left:0;width:260px;max-width:calc(100vw - 80px);padding:8px;border:1px solid var(--pr-border);border-radius:12px;background:var(--pr-bg);box-shadow:0 8px 24px #0002;z-index:10;animation:pr-filter-in .12s ease-out}\n.pr-filter-popup input{width:100%;min-width:0;padding:8px 10px;border:1px solid var(--pr-border);border-radius:7px;background:var(--pr-bg);color:var(--pr-text);font:inherit;font-size:14px;margin-bottom:6px}\n.pr-filter-options{max-height:260px;overflow-y:auto}.pr-reader .pr-filter-options button{display:flex;justify-content:space-between;align-items:center;gap:12px;text-align:left;width:100%;border:0;border-radius:6px;padding:8px 10px;font-size:14px}\n.pr-filter-options button[aria-checked=true]{background:var(--pr-soft);font-weight:600}\n.pr-reader .pr-filter-reset{border:0;background:transparent;font-size:13px;color:var(--pr-muted)}\n.pr-reader .pr-filter-status{font-size:12px;color:var(--pr-muted);margin:12px 0 0}\n@keyframes pr-filter-in{from{opacity:0;transform:translateY(-3px)}to{opacity:1;transform:translateY(0)}}\n@media(prefers-reduced-motion:reduce){.pr-filter-popup{animation:none}}\n@media(max-width:600px){.pr-filter-menu{width:100%}.pr-reader .pr-filter-trigger{width:100%;justify-content:space-between}.pr-filter-popup{width:100%;max-width:100%}}\n\n.pr-special-frame { position:relative; min-width:0; margin:0 }\n.pr-special-scroll { overflow-x:auto; padding-bottom:4px; max-width:100% }\n.pr-special-chart { display:block; color:var(--pr-text); overflow:visible; font-size:12px; font-variant-numeric:tabular-nums }\n.pr-special-chart text { fill:var(--pr-text) }\n.pr-special-chart .pr-axis-tick { fill:var(--pr-chart-muted) }\n.pr-special-chart [data-chart-mark]:focus { outline:2px solid var(--pr-accent); outline-offset:3px }\n.pr-special-tooltip { position:absolute; top:0; left:0; z-index:2; max-width:100%; pointer-events:none }\n.pr-chart-sparkline { height:128px }\n.pr-chart-role { color:var(--pr-muted); font-size:11px }\n.pr-chart-label { fill:var(--pr-text); font-size:11px }\n.pr-special-chart .pr-chart-label { paint-order:stroke; stroke:var(--pr-bg); stroke-width:3px; stroke-linejoin:round }\n.pr-color-key { display:flex; gap:12px; flex-wrap:wrap; font-size:12px; color:var(--pr-muted); margin:8px 0 }\n.pr-color-key span { display:inline-flex; align-items:center; gap:5px }\n\n\n.pr-cell-editor{border:1px solid var(--pr-border);border-radius:8px;padding:12px;margin:8px 0 16px;min-width:0;background:var(--pr-soft)}\n.pr-editor-actions{display:flex;gap:8px;flex-wrap:wrap;margin-bottom:10px}.pr-cell-editor label{display:block}.pr-cell-editor textarea{display:block;width:100%;min-height:120px;resize:vertical}.pr-cell-editor input:not([type=checkbox]),.pr-report-title-editor input{display:block;width:100%;min-width:0}.pr-cell-editor button{margin:4px;padding:5px 9px}.pr-cell-editor .pr-editor-column{display:inline-flex;align-items:center;gap:6px;margin:4px 12px 4px 0}\n.pr-report-title-editor{display:block;font-weight:600}.pr-report-title-editor input{font:inherit;font-size:24px;padding:8px}\n.pr-cell-editor input,.pr-cell-editor textarea,.pr-report-title-editor input{font-family:inherit;color:var(--pr-text);background:var(--pr-bg);border:1px solid var(--pr-border);border-radius:5px;padding:6px;box-sizing:border-box}\n";

package/lib/types/client/presentation/table.d.ts

@@ -0,0 +1,12 @@
+import type { TypedDataset } from '../../presentation/contracts/types.ts';
+import { type ReaderMode } from './model.ts';
+export declare function DatasetTable({ data, columns, mode, caption, showScope, showSelectionCount, rowIndices, filterKey, }: {
+    data: TypedDataset;
+    columns?: string[];
+    mode: ReaderMode;
+    caption: string;
+    showScope?: boolean;
+    showSelectionCount?: boolean;
+    rowIndices?: readonly number[];
+    filterKey?: string;
+}): import("react").JSX.Element;

package/lib/types/client/presentation/use-element-width.d.ts

@@ -0,0 +1,5 @@
+/** Measure the containing block, retaining its last usable width while it is hidden. */
+export declare function useElementWidth(minimum: number, initial: number): {
+    ref: import("react").RefObject<HTMLDivElement>;
+    width: number;
+};

package/lib/types/client/workspace-header-action.d.ts

@@ -0,0 +1,7 @@
+export declare function WorkspaceHeaderAction({ label, icon, disabled, title, onClick, }: {
+    label: string;
+    icon: 'semantic' | 'credentials';
+    disabled: boolean;
+    title?: string;
+    onClick: () => void;
+}): import("react").JSX.Element;