@d-dash/core 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# @d-dash/core
+
+Headless runtime contracts and orchestration for d-dash.
+
+## What this package provides
+
+- Persisted dashboard schema contracts
+- Runtime-resolved execution contracts
+- Adapter interfaces (datasource, visualization, grid)
+- Registry and validation APIs
+- Dashboard runtime orchestration APIs
+
+## Install
+
+```bash
+npm install @d-dash/core
+```
+
+## Usage
+
+```ts
+import { createAdapterRegistry, createDashboardRuntime } from "@d-dash/core";
+
+const registry = createAdapterRegistry();
+const runtime = createDashboardRuntime({ registry });
+
+const validation = runtime.validateDashboard(dashboard);
+if (!validation.ok) {
+  throw new Error("Invalid dashboard");
+}
+
+const session = runtime.createSession(dashboard);
+
+const unbind = await runtime.bindLayoutResize({
+  session,
+  gridId: "gridstack",
+  gridTarget,
+  resolveTargetByWidgetId(widgetId) {
+    return widgetTargetById[widgetId];
+  },
+});
+
+// call unbind() on teardown
+```
+
+See root documentation for full integration details.

package/dist/adapters.d.ts

@@ -0,0 +1,125 @@
+import type { DDashError } from "./errors";
+import type { JsonObject } from "./json";
+import type { MetricDefinition, VisualizationKind } from "./schema";
+import type { ResolvedTimeRange, RuntimeContext } from "./runtime";
+/** Scalar value types supported in DataField arrays. */
+export type ScalarValue = string | number | boolean | null;
+/** Supported DataField value type tags. */
+export type DataFieldType = "time" | "number" | "string" | "boolean";
+/** Single typed field within a DataFrame payload. */
+export type DataField = {
+    name: string;
+    type: DataFieldType;
+    values: ScalarValue[];
+    labels?: Record<string, string>;
+};
+/** Normalized table-like data payload exchanged across runtime and adapters. */
+export type DataFrame = {
+    fields: DataField[];
+};
+/** Request envelope passed to datasource adapters for widget queries. */
+export type DatasourceQueryRequest = {
+    metric: string;
+    timeRange: ResolvedTimeRange;
+    filters?: JsonObject;
+};
+/** Successful datasource query result envelope. */
+export type DatasourceQuerySuccess = {
+    status: "success";
+    frames: DataFrame[];
+    warnings?: string[];
+};
+/** Partially successful datasource query result envelope. */
+export type DatasourceQueryPartial = {
+    status: "partial";
+    frames: DataFrame[];
+    warnings?: string[];
+    error: DDashError;
+};
+/** Failed datasource query result envelope. */
+export type DatasourceQueryError = {
+    status: "error";
+    frames: DataFrame[];
+    warnings?: string[];
+    error: DDashError;
+};
+/** Union of all datasource query result envelope variants. */
+export type DatasourceQueryResult = DatasourceQuerySuccess | DatasourceQueryPartial | DatasourceQueryError;
+/** Capability flags declared by datasource adapters. */
+export type DatasourceCapabilities = {
+    supportsStreaming?: boolean;
+    supportsAdHocFilters?: boolean;
+    supportsMetadataDiscovery?: boolean;
+};
+/** Datasource adapter public contract implemented by plugins. */
+export interface DatasourceAdapter {
+    readonly id: string;
+    readonly capabilities?: DatasourceCapabilities;
+    /** Optional metadata discovery API for known metrics. */
+    getMetrics?(): Promise<MetricDefinition[]>;
+    /** Execute a datasource query and return normalized result envelopes. */
+    query(request: DatasourceQueryRequest, context: RuntimeContext): Promise<DatasourceQueryResult>;
+}
+/** Capability flags declared by visualization adapters. */
+export type VisualizationCapabilities = {
+    supportsTimeSeries?: boolean;
+    supportsStat?: boolean;
+    supportsTable?: boolean;
+    supportsTextWidget?: boolean;
+    supportsHtmlWidget?: boolean;
+    supportsTheming?: boolean;
+    supportsResize?: boolean;
+};
+/** Render request envelope passed to visualization adapters. */
+export type VisualizationRenderRequest = {
+    kind: VisualizationKind;
+    frames: DataFrame[];
+    options?: JsonObject;
+    context: RuntimeContext;
+};
+/** Visualization adapter public contract implemented by plugins. */
+export interface VisualizationAdapter<TTarget = unknown> {
+    readonly type: VisualizationKind;
+    readonly capabilities?: VisualizationCapabilities;
+    /** Optional setup phase invoked before first render. */
+    init?(target: TTarget): Promise<void> | void;
+    /** Required render method for widget output. */
+    render(request: VisualizationRenderRequest, target: TTarget): Promise<void> | void;
+    /** Optional resize hook invoked by host/grid lifecycle. */
+    resize?(target: TTarget): Promise<void> | void;
+    /** Optional cleanup hook invoked during teardown. */
+    destroy?(target: TTarget): Promise<void> | void;
+}
+/** Capability flags declared by grid adapters. */
+export type GridCapabilities = {
+    supportsDrag?: boolean;
+    supportsResize?: boolean;
+    supportsResponsiveBreakpoints?: boolean;
+};
+/** Layout mutation payload forwarded to grid adapters. */
+export type GridLayoutChange = {
+    widgetId: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+/** Callback invoked when grid layout changes are emitted by a grid adapter. */
+export type GridLayoutChangeHandler = (changes: GridLayoutChange[]) => void;
+/** Grid adapter public contract implemented by plugins. */
+export interface GridAdapter<TTarget = unknown> {
+    readonly id: string;
+    readonly capabilities?: GridCapabilities;
+    /** Initialize grid runtime for the provided host target. */
+    init(target: TTarget): Promise<void> | void;
+    /**
+     * Optional subscription API for host/runtime orchestration.
+     * Returns an unsubscribe function.
+     */
+    subscribeLayoutChanges?(target: TTarget, handler: GridLayoutChangeHandler): (() => void) | Promise<() => void>;
+    /** Apply normalized layout changes for widgets. */
+    applyLayout(changes: GridLayoutChange[], target: TTarget): Promise<void> | void;
+    /** Release all grid resources and listeners. */
+    destroy(target: TTarget): Promise<void> | void;
+}
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

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

package/dist/adapters.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":""}

package/dist/dashboard-runtime.d.ts

@@ -0,0 +1,96 @@
+import type { DatasourceQueryResult } from "./adapters";
+import type { DDashError } from "./errors";
+import type { AdapterRegistry } from "./registry";
+import { type ResolvedTimeRange, type RuntimeContext } from "./runtime.js";
+import type { MetricDefinition, PersistedDashboard, PersistedWidget } from "./schema";
+import { type DashboardValidationOptions, type ValidationResult } from "./validation.js";
+/** Discriminated union of observable events emitted during widget execution. */
+export type RuntimeEvent = {
+    type: "widget.execute.started";
+    widgetId: string;
+    dashboardId: string;
+} | {
+    type: "widget.execute.completed";
+    widgetId: string;
+    dashboardId: string;
+    durationMs: number;
+    status: "success" | "partial" | "error";
+} | {
+    type: "widget.execute.failed";
+    widgetId: string;
+    dashboardId: string;
+    durationMs: number;
+    error: unknown;
+};
+export type RuntimeEventHandler = (event: RuntimeEvent) => void;
+/** Options for creating dashboard runtime orchestration. */
+export type DashboardRuntimeOptions = {
+    registry: AdapterRegistry;
+    now?: () => number;
+    /** Optional observer called for each widget execution lifecycle event. */
+    onEvent?: RuntimeEventHandler;
+};
+/** Execution session state derived from a validated dashboard. */
+export type DashboardSession = {
+    dashboard: PersistedDashboard;
+    dashboardTimeRange: ResolvedTimeRange;
+    widgets: PersistedWidget[];
+};
+/** Inputs for executing a single widget in a session. */
+export type ExecuteSessionWidgetInput<TTarget = unknown> = {
+    session: DashboardSession;
+    widgetId: string;
+    target: TTarget;
+    context: RuntimeContext;
+};
+/** Inputs for executing all widgets in a session. */
+export type ExecuteAllWidgetsInput<TTarget = unknown> = {
+    session: DashboardSession;
+    targetByWidgetId: Record<string, TTarget>;
+    context: RuntimeContext;
+};
+/** Widget execution result tuple for batch execution APIs. */
+export type ExecuteWidgetResult = {
+    widgetId: string;
+    result: DatasourceQueryResult;
+};
+/** Preflight result for adapter availability checks. */
+export type DashboardPreflightResult = {
+    ok: boolean;
+    missingDatasources: string[];
+    missingVisualizations: string[];
+};
+/** Inputs for applying persisted dashboard layout through a grid adapter. */
+export type ApplyDashboardLayoutInput<TTarget = unknown> = {
+    session: DashboardSession;
+    gridId: string;
+    target: TTarget;
+};
+/** Inputs for binding grid layout-change events to visualization resize hooks. */
+export type BindLayoutResizeInput<TGridTarget = unknown, TWidgetTarget = unknown> = {
+    session: DashboardSession;
+    gridId: string;
+    gridTarget: TGridTarget;
+    targetByWidgetId?: Record<string, TWidgetTarget>;
+    resolveTargetByWidgetId?: (widgetId: string) => TWidgetTarget | undefined;
+};
+/** Structured runtime error union thrown by dashboard runtime APIs. */
+export type DashboardRuntimeError = DDashError & {
+    code: "SCHEMA_INVALID" | "RUNTIME_WIDGET_NOT_FOUND" | "RUNTIME_TARGET_MISSING";
+};
+/** Public dashboard runtime API surface. */
+export type DashboardRuntime = {
+    validateDashboard(dashboard: PersistedDashboard, options?: Omit<DashboardValidationOptions, "knownDatasources" | "knownVisualizations">): ValidationResult;
+    validateDashboardWithRegistryMetrics(dashboard: PersistedDashboard, options?: Omit<DashboardValidationOptions, "knownDatasources" | "knownVisualizations" | "knownMetrics">): Promise<ValidationResult>;
+    preflightDashboard(dashboard: PersistedDashboard): DashboardPreflightResult;
+    applyDashboardLayout<TTarget = unknown>(input: ApplyDashboardLayoutInput<TTarget>): Promise<void>;
+    bindLayoutResize<TGridTarget = unknown, TWidgetTarget = unknown>(input: BindLayoutResizeInput<TGridTarget, TWidgetTarget>): Promise<() => void>;
+    createSession(dashboard: PersistedDashboard): DashboardSession;
+    createSessionWithRegistryMetrics(dashboard: PersistedDashboard, options?: Omit<DashboardValidationOptions, "knownDatasources" | "knownVisualizations" | "knownMetrics">): Promise<DashboardSession>;
+    executeWidget<TTarget = unknown>(input: ExecuteSessionWidgetInput<TTarget>): Promise<DatasourceQueryResult>;
+    executeAllWidgets<TTarget = unknown>(input: ExecuteAllWidgetsInput<TTarget>): Promise<ExecuteWidgetResult[]>;
+    discoverMetrics(datasourceId?: string): Promise<MetricDefinition[]>;
+};
+/** Creates dashboard runtime orchestrator bound to adapter registry and clock/event hooks. */
+export declare function createDashboardRuntime(options: DashboardRuntimeOptions): DashboardRuntime;
+//# sourceMappingURL=dashboard-runtime.d.ts.map

package/dist/dashboard-runtime.d.ts.map

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

package/dist/dashboard-runtime.js

@@ -0,0 +1,238 @@
+import { executeWidget as executeWidgetOperation } from "./execution.js";
+import { resolveDashboardTimeRange, } from "./runtime.js";
+import { toSchemaValidationError, validatePersistedDashboard, } from "./validation.js";
+/** Creates dashboard runtime orchestrator bound to adapter registry and clock/event hooks. */
+export function createDashboardRuntime(options) {
+    const getNow = options.now ?? Date.now;
+    return {
+        validateDashboard(dashboard, userOptions = {}) {
+            return validatePersistedDashboard(dashboard, {
+                ...userOptions,
+                knownDatasources: options.registry.listDatasourceIds(),
+                knownVisualizations: options.registry.listVisualizationKinds(),
+            });
+        },
+        async validateDashboardWithRegistryMetrics(dashboard, userOptions = {}) {
+            const knownMetrics = await this.discoverMetrics();
+            return validatePersistedDashboard(dashboard, {
+                ...userOptions,
+                knownDatasources: options.registry.listDatasourceIds(),
+                knownVisualizations: options.registry.listVisualizationKinds(),
+                knownMetrics,
+            });
+        },
+        preflightDashboard(dashboard) {
+            const registeredDatasources = new Set(options.registry.listDatasourceIds());
+            const registeredVisualizations = new Set(options.registry.listVisualizationKinds());
+            const missingDatasourceSet = new Set();
+            const missingVisualizationSet = new Set();
+            for (const widget of dashboard.widgets) {
+                if (!registeredDatasources.has(widget.datasource)) {
+                    missingDatasourceSet.add(widget.datasource);
+                }
+                if (!registeredVisualizations.has(widget.visualization.type)) {
+                    missingVisualizationSet.add(widget.visualization.type);
+                }
+            }
+            const missingDatasources = Array.from(missingDatasourceSet);
+            const missingVisualizations = Array.from(missingVisualizationSet);
+            return {
+                ok: missingDatasources.length === 0 && missingVisualizations.length === 0,
+                missingDatasources,
+                missingVisualizations,
+            };
+        },
+        async applyDashboardLayout(input) {
+            const adapter = options.registry.requireGrid(input.gridId);
+            // Build a widgetId lookup keyed by layoutId so layout items map to widget identifiers.
+            const widgetByLayoutId = new Map();
+            for (const widget of input.session.widgets) {
+                widgetByLayoutId.set(widget.layoutId, widget.id);
+            }
+            const changes = [];
+            for (const item of input.session.dashboard.layout) {
+                const widgetId = widgetByLayoutId.get(item.id);
+                if (!widgetId) {
+                    continue;
+                }
+                changes.push({
+                    widgetId,
+                    x: item.x,
+                    y: item.y,
+                    w: item.w,
+                    h: item.h,
+                });
+            }
+            await adapter.applyLayout(changes, input.target);
+        },
+        async bindLayoutResize(input) {
+            const grid = options.registry.requireGrid(input.gridId);
+            if (!grid.subscribeLayoutChanges) {
+                return () => { };
+            }
+            const resolveTargetByWidgetId = input.resolveTargetByWidgetId ??
+                ((widgetId) => input.targetByWidgetId?.[widgetId]);
+            const widgetById = new Map();
+            for (const widget of input.session.widgets) {
+                widgetById.set(widget.id, widget);
+            }
+            const unsubscribe = await grid.subscribeLayoutChanges(input.gridTarget, (changes) => {
+                // Resize each affected widget once per grid event batch.
+                const touchedWidgetIds = new Set(changes.map((change) => change.widgetId));
+                for (const widgetId of touchedWidgetIds) {
+                    const widget = widgetById.get(widgetId);
+                    if (!widget) {
+                        continue;
+                    }
+                    const target = resolveTargetByWidgetId(widget.id);
+                    if (target === undefined) {
+                        continue;
+                    }
+                    const adapter = options.registry.requireVisualization(widget.visualization.type);
+                    adapter.resize?.(target);
+                }
+            });
+            return unsubscribe;
+        },
+        createSession(dashboard) {
+            const validation = this.validateDashboard(dashboard);
+            return buildSessionFromValidatedDashboard(validation, dashboard, getNow);
+        },
+        async createSessionWithRegistryMetrics(dashboard, userOptions = {}) {
+            const validation = await this.validateDashboardWithRegistryMetrics(dashboard, userOptions);
+            return buildSessionFromValidatedDashboard(validation, dashboard, getNow);
+        },
+        async executeWidget(input) {
+            const widget = input.session.widgets.find((candidate) => candidate.id === input.widgetId);
+            if (!widget) {
+                throw new DashboardRuntimeException("RUNTIME_WIDGET_NOT_FOUND", `Widget '${input.widgetId}' not found in session.`, { widgetId: input.widgetId });
+            }
+            const dashboardId = input.session.dashboard.dashboardId;
+            const widgetId = input.widgetId;
+            const emit = options.onEvent;
+            emit?.({ type: "widget.execute.started", widgetId, dashboardId });
+            const startMs = Date.now();
+            try {
+                const result = await executeWidgetOperation({
+                    registry: options.registry,
+                    dashboardId,
+                    widget,
+                    dashboardTimeRange: input.session.dashboardTimeRange,
+                    context: input.context,
+                    target: input.target,
+                });
+                emit?.({
+                    type: "widget.execute.completed",
+                    widgetId,
+                    dashboardId,
+                    durationMs: Date.now() - startMs,
+                    status: result.status,
+                });
+                return result;
+            }
+            catch (error) {
+                emit?.({
+                    type: "widget.execute.failed",
+                    widgetId,
+                    dashboardId,
+                    durationMs: Date.now() - startMs,
+                    error,
+                });
+                throw error;
+            }
+        },
+        async executeAllWidgets(input) {
+            const results = [];
+            for (const widget of input.session.widgets) {
+                const target = input.targetByWidgetId[widget.id];
+                if (target === undefined) {
+                    throw new DashboardRuntimeException("RUNTIME_TARGET_MISSING", `Missing render target for widget '${widget.id}'.`, { widgetId: widget.id });
+                }
+                const result = await this.executeWidget({
+                    session: input.session,
+                    widgetId: widget.id,
+                    target,
+                    context: input.context,
+                });
+                results.push({
+                    widgetId: widget.id,
+                    result,
+                });
+            }
+            return results;
+        },
+        async discoverMetrics(datasourceId) {
+            if (datasourceId) {
+                const adapter = options.registry.requireDatasource(datasourceId);
+                if (!adapter.getMetrics) {
+                    return [];
+                }
+                const metrics = await adapter.getMetrics();
+                return dedupeMetrics(metrics);
+            }
+            const allMetrics = [];
+            const datasourceIds = options.registry.listDatasourceIds();
+            for (const id of datasourceIds) {
+                const adapter = options.registry.requireDatasource(id);
+                if (!adapter.getMetrics) {
+                    continue;
+                }
+                const metrics = await adapter.getMetrics();
+                for (const metric of metrics) {
+                    allMetrics.push(metric);
+                }
+            }
+            return dedupeMetrics(allMetrics);
+        },
+    };
+}
+function buildSessionFromValidatedDashboard(validation, dashboard, getNow) {
+    const schemaError = toSchemaValidationError(validation);
+    if (schemaError) {
+        throw new DashboardRuntimeException("SCHEMA_INVALID", schemaError.message, {
+            issues: validation.issues.map((issue) => ({
+                code: issue.code,
+                path: issue.path,
+                message: issue.message,
+            })),
+        });
+    }
+    if (dashboard.timeRange.type === "inherit") {
+        throw new DashboardRuntimeException("SCHEMA_INVALID", "Dashboard timeRange cannot use inherit.", {
+            path: "timeRange",
+            type: "inherit",
+        });
+    }
+    return {
+        dashboard,
+        dashboardTimeRange: resolveDashboardTimeRange(dashboard.timeRange, {
+            now: getNow(),
+        }),
+        widgets: dashboard.widgets,
+    };
+}
+class DashboardRuntimeException extends Error {
+    code;
+    details;
+    retriable = false;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "DashboardRuntimeException";
+        this.code = code;
+        this.details = details;
+    }
+}
+function dedupeMetrics(metrics) {
+    const seen = new Set();
+    const deduped = [];
+    for (const metric of metrics) {
+        const key = `${metric.datasource}::${metric.id}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        deduped.push(metric);
+    }
+    return deduped;
+}
+//# sourceMappingURL=dashboard-runtime.js.map

package/dist/dashboard-runtime.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+import type { JsonObject } from "./json";
+/** Stable machine-readable error codes used in public d-dash contracts. */
+export type DDashErrorCode = "SCHEMA_INVALID" | "SCHEMA_UNSUPPORTED_VERSION" | "RUNTIME_WIDGET_NOT_FOUND" | "RUNTIME_TARGET_MISSING" | "REGISTRY_DUPLICATE_ADAPTER" | "REGISTRY_ADAPTER_NOT_FOUND" | "TIME_RANGE_RESOLVE_FAILED" | "CAPABILITY_MISMATCH" | "DATASOURCE_HTTP_ERROR" | "DATASOURCE_PARTIAL" | "DATASOURCE_QUERY_FAILED" | "VISUALIZATION_RENDER_FAILED" | "GRID_LAYOUT_FAILED";
+/** Standard structured error envelope used across runtime and adapters. */
+export type DDashError = {
+    /** Stable machine-readable error code. */
+    code: DDashErrorCode;
+    /** Human-readable summary suitable for logs and UIs. */
+    message: string;
+    /** Optional structured diagnostics for operators and tooling. */
+    details?: JsonObject;
+    /** Optional retryability hint for callers/orchestrators. */
+    retriable?: boolean;
+};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,4BAA4B,GAC5B,0BAA0B,GAC1B,wBAAwB,GACxB,4BAA4B,GAC5B,4BAA4B,GAC5B,2BAA2B,GAC3B,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,yBAAyB,GACzB,6BAA6B,GAC7B,oBAAoB,CAAC;AAEzB,2EAA2E;AAC3E,MAAM,MAAM,UAAU,GAAG;IACvB,0CAA0C;IAC1C,IAAI,EAAE,cAAc,CAAC;IACrB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":""}

package/dist/execution.d.ts

@@ -0,0 +1,37 @@
+import type { DataFrame, DatasourceQueryResult } from "./adapters";
+import type { AdapterRegistry } from "./registry";
+import { type ResolvedTimeRange, type ResolvedWidgetExecutionRequest, type RuntimeContext } from "./runtime.js";
+import type { PersistedWidget } from "./schema";
+/** Inputs required to build a resolved widget execution request. */
+export type BuildWidgetExecutionRequestInput = {
+    dashboardId: string;
+    widget: PersistedWidget;
+    dashboardTimeRange: ResolvedTimeRange;
+    context: RuntimeContext;
+    now?: number;
+};
+/** Inputs required to execute a visualization render call. */
+export type ExecuteWidgetRenderInput<TTarget = unknown> = {
+    request: ResolvedWidgetExecutionRequest;
+    frames: DataFrame[];
+    target: TTarget;
+};
+/** Full inputs required for query + render orchestration of a widget. */
+export type ExecuteWidgetInput<TTarget = unknown> = {
+    registry: AdapterRegistry;
+    dashboardId: string;
+    widget: PersistedWidget;
+    dashboardTimeRange: ResolvedTimeRange;
+    context: RuntimeContext;
+    target: TTarget;
+    now?: number;
+};
+/** Executes datasource query for a resolved widget request. */
+export declare function executeWidgetQuery(registry: AdapterRegistry, request: ResolvedWidgetExecutionRequest): Promise<DatasourceQueryResult>;
+/** Executes visualization render for a resolved widget request and frames. */
+export declare function executeWidgetRender<TTarget = unknown>(registry: AdapterRegistry, input: ExecuteWidgetRenderInput<TTarget>): Promise<void>;
+/** Executes full widget flow: build request, query datasource, and render when data exists. */
+export declare function executeWidget<TTarget = unknown>(input: ExecuteWidgetInput<TTarget>): Promise<DatasourceQueryResult>;
+/** Builds a resolved widget execution request from persisted widget and runtime context. */
+export declare function buildWidgetExecutionRequest(input: BuildWidgetExecutionRequestInput): ResolvedWidgetExecutionRequest;
+//# sourceMappingURL=execution.d.ts.map

package/dist/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../src/execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAET,qBAAqB,EAEtB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,8BAA8B,EACnC,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,oEAAoE;AACpE,MAAM,MAAM,gCAAgC,GAAG;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,wBAAwB,CAAC,OAAO,GAAG,OAAO,IAAI;IACxD,OAAO,EAAE,8BAA8B,CAAC;IACxC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,kBAAkB,CAAC,OAAO,GAAG,OAAO,IAAI;IAClD,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,+DAA+D;AAC/D,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,qBAAqB,CAAC,CAyBhC;AAED,8EAA8E;AAC9E,wBAAsB,mBAAmB,CAAC,OAAO,GAAG,OAAO,EACzD,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,wBAAwB,CAAC,OAAO,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CAAC,OAAO,GAAG,OAAO,EACnD,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,GACjC,OAAO,CAAC,qBAAqB,CAAC,CAsBhC;AAED,4FAA4F;AAC5F,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gCAAgC,GACtC,8BAA8B,CAiBhC"}