@dlh.io/bideux 0.1.0

package/dist/element/element.d.ts

@@ -0,0 +1,3044 @@
+import { ComponentType, ReactNode, CSSProperties } from 'react';
+
+type Kind$1 = "dashboard";
+type Author$1 = string | null;
+type Description$1 = string;
+type Backgroundcolor$1 = string | null;
+type Border$1 = string | boolean | null;
+type Borderradius$1 = string | number | null;
+type Color$1 = string | null;
+type Fontsize$1 = string | number | null;
+type Fontweight$1 = string | number | null;
+type Padding$1 = string | number | null;
+type Textalign$1 = ("left" | "center" | "right" | "justify") | null;
+type Title$1 = string | LabelBlock$1 | null;
+type Icon$1 = string | null;
+type Position$1 = ("top" | "bottom" | "left" | "right") | null;
+type Text$1 = string | null;
+type Tooltip$1 = string | null;
+type Verticalalign$1 = ("top" | "middle" | "bottom") | null;
+type Visible$1 = boolean | null;
+type Id$1 = string;
+type Name$1 = string;
+type AllowEmbed$1 = boolean;
+type Owner$1 = string | null;
+type Public$1 = boolean;
+type Roles$1 = string[];
+type Scope$1 = "org" | "project" | "dashboard" | "widget";
+type Status$1 = "draft" | "published" | "archived";
+type Tags$1 = string[];
+type Version$1 = string;
+type Tags1$1 = string[];
+type Version1$1 = string;
+type Enabled = boolean;
+type Icon1 = string;
+type Showinembed = boolean;
+type Showinlayout = boolean;
+type Showinpreview = boolean;
+type Ttlseconds = number | null;
+type Datamodelid = string | null;
+type Background$1 = string | null;
+type Collapsible = boolean | null;
+type Defaultcollapsed = boolean | null;
+type Disablecollapse = boolean | null;
+type Gap = string | number | null;
+type Buttonspan = number | null;
+type Columns$1 = number | null;
+type Datespan = number | null;
+type Gap1 = string | number | null;
+type Maxcolumnwidth = number | null;
+type Mincolumnwidth = number | null;
+type Mode = "auto" | "grid" | "flex";
+type Padding1$1 = string | number | null;
+type Radiospan = number | null;
+type Selectspan = number | null;
+type Padding2 = string | number | null;
+type Position1 = "top" | "left";
+type Width = string | number | null;
+type Background1 = string | null;
+type Height = string | number | null;
+type Padding3 = string | number | null;
+type Textalign1 = ("left" | "center" | "right" | "justify") | null;
+type Verticalalign1 = ("top" | "middle" | "bottom") | null;
+type Visible1 = boolean | null;
+type Widgets = WidgetSpec$1[] | null;
+type Kind1$1 = "widget";
+type Field$1 = string;
+type Operator$1 = "eq" | "in" | "gt" | "lt" | "gte" | "lte" | "contains" | "date" | "between";
+type Param$1 = string | null;
+type Target$1 = string;
+type Bindings$1 = FilterBinding$1[];
+type Component$1 = "echarts" | "kpi" | "filter" | "select" | "table" | "tabulator" | "pivot_table" | "text" | "image" | "markdown";
+type Data$1 = KpiDataSource$1 | StaticDataSource$1 | DemoDataSource$1 | SqlDataSource$1 | DatasetDataSource$1 | QueryDataSource$1;
+type DataModelId$1 = string | null;
+type Kind2$1 = "kpi";
+type Kpi$1 = string;
+type Labelcolumn$1 = string | null;
+type JsonValue$1 = unknown;
+type Valuecolumn$1 = string | null;
+type Columns1$1 = string[] | null;
+type Kind3$1 = "static";
+type Label$1 = string;
+type Options$1 = StaticOption$1[];
+type Rows$1 = {
+    [k: string]: JsonValue$1;
+}[];
+type Columns2$1 = string[] | null;
+type Dataset$1 = string | null;
+type Kind4$1 = "demo";
+type Rows1$1 = number;
+type Seed$1 = number;
+type DataModelId1$1 = string | null;
+type FilterField$1 = string | null;
+type Kind5$1 = "sql";
+type Query$1 = string;
+type Columns3 = string[] | null;
+type DataModelId2$1 = string | null;
+type Dataset1$1 = string;
+type Dimensions$1 = string[] | null;
+type Field1$1 = string;
+type FilterId$1 = string;
+type Operator1$1 = "eq" | "in" | "gt" | "lt" | "gte" | "lte" | "contains" | "date" | "between";
+type Param1$1 = string | null;
+type Filters$2 = IncomingFilter$1[];
+type Kind6$1 = "dataset";
+type Metrics$1 = string[] | null;
+type DataModelId3$1 = string | null;
+type Kind7$1 = "query";
+type Query1$1 = string;
+type Background2 = string | null;
+type Border1$1 = string | boolean | null;
+type Borderradius1$1 = string | number | null;
+type Echarts$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Filter$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Image$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Kpi1$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Margin$1 = string | number | null;
+type Markdown$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Padding4 = string | number | null;
+type PivotTable$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Select$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Shadow$1 = string | boolean | null;
+type Table$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Tabulator$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Text1$1 = {
+    [k: string]: JsonValue$1;
+} | null;
+type Filters1$1 = IncomingFilter$1[];
+type Id1$1 = string;
+type Label1$1 = string | null;
+type OpenIn$1 = "modal" | "same" | "new" | "detail";
+type PassFilters$1 = boolean;
+type PassSelection$1 = boolean;
+type Target1$1 = string;
+type TargetType$1 = "dashboard" | "url" | "filter" | "dimension";
+type Type$1 = "drilldown" | "set_filter" | "navigate";
+type Field2$1 = string | null;
+type Kind8 = "event" | "filter" | "literal";
+type Target2$1 = string;
+type TargetType1$1 = "filter" | "dimension";
+type VariableMappings$1 = InteractionVariableMapping$1[];
+type Interactions$1 = WidgetInteraction$1[];
+type H$1 = number;
+type Isbounded$1 = boolean | null;
+type Isdraggable$1 = boolean | null;
+type Isresizable$1 = boolean | null;
+type Maxh$1 = number | null;
+type Maxw$1 = number | null;
+type Minh$1 = number | null;
+type Minw$1 = number | null;
+type Resizehandles$1 = string[] | null;
+type H1$1 = number;
+type Isbounded1$1 = boolean | null;
+type Isdraggable1$1 = boolean | null;
+type Isresizable1$1 = boolean | null;
+type Maxh1$1 = number | null;
+type Maxw1$1 = number | null;
+type Minh1$1 = number | null;
+type Minw1$1 = number | null;
+type Resizehandles1$1 = string[] | null;
+type W$1 = number;
+type X$1 = number;
+type Y$1 = number;
+type Unplaced$1 = boolean | null;
+type W1$1 = number;
+type X1$1 = number;
+type Y1$1 = number;
+type Category$1 = string | null;
+type Date$1 = string | null;
+type Delta$1 = string | null;
+type Label2$1 = string | null;
+type Series$1 = string | null;
+type SeriesName$1 = string | null;
+type Value$1 = string | null;
+type X2$1 = string | null;
+type Y2$1 = string | null;
+type Version2$1 = string;
+type Allowoverlap = boolean | null;
+type Compacttype = ("vertical" | "horizontal") | null;
+type Containerpadding = number[] | null;
+type Draggablecancel = string | null;
+type Draggablehandle = string | null;
+type Isbounded2 = boolean | null;
+type Maxlayoutwidth = ("mobile" | "tablet" | "desktop" | "wide") | null;
+type Maxrows = number | null;
+type Preventcollision = boolean | null;
+type Resizehandles2 = string[] | null;
+type Snap = boolean | null;
+type Squarecells = boolean | null;
+type Backgroundcolor1 = string | null;
+type Fitmode = "fit_to_width" | "fit_to_page";
+type Orientation = "auto" | "portrait" | "landscape";
+type Pagesize = "a4" | "letter";
+type Scale = "contain" | "cover";
+type Background3 = string | null;
+type Border2 = string | boolean | null;
+type Borderradius2 = string | number | null;
+type Margin1 = string | number | null;
+type Padding5 = string | number | null;
+type Shadow1 = string | boolean | null;
+type AiContext = {
+    [k: string]: JsonValue$1;
+} | string | null;
+type CustomExtensions = {
+    [k: string]: JsonValue$1;
+}[] | null;
+/**
+ * Host data-store identifier holding credentials, database, and schema. Omit to use the host's default active store.
+ */
+type DataModelId4 = string | null;
+/**
+ * Store used by datasets that do not name one.
+ */
+type Default = boolean;
+type Description1 = string | null;
+/**
+ * Id datasets use to point at this store, for example ops_dw.
+ */
+type Id2 = string;
+type Name1 = string | null;
+/**
+ * Warehouse vendor, for example snowflake, databricks or postgres.
+ */
+type Vendor = string | null;
+type DataStores = DataStore[];
+type AiContext1 = {
+    [k: string]: JsonValue$1;
+} | string | null;
+type Enabled1 = boolean;
+type TtlSeconds = number | null;
+type TtlSeconds1 = number | null;
+type CustomExtensions1 = {
+    [k: string]: JsonValue$1;
+}[] | null;
+/**
+ * Id of the data store in this model's data_stores list. Omit to use the model's default store.
+ */
+type DataStoreId = string | null;
+type DataStoreIds = string[] | null;
+type DataModelId5 = string | null;
+/**
+ * Id of the data store in this model's data_stores list. Omit to use the model's default store.
+ */
+type DataStoreId1 = string | null;
+type DataStoreIds1 = string[] | null;
+type Description2 = string | null;
+type AiContext2 = {
+    [k: string]: JsonValue$1;
+} | string | null;
+/**
+ * Warehouse column this dimension reads. Defaults to the id.
+ */
+type Column = string | null;
+type CustomExtensions2 = {
+    [k: string]: JsonValue$1;
+}[] | null;
+type Description3 = string | null;
+/**
+ * SQL expression to use instead of a plain column.
+ */
+type Expression = string | Expression1 | null;
+type Default1 = string | null;
+type Dialect = string;
+type Expression2 = string;
+type Dialects = ExpressionDialect[];
+type Format = string | null;
+type Group = string | null;
+type Hidden = boolean | null;
+/**
+ * Id widgets use to group or filter by, for example business_date.
+ */
+type Id3 = string;
+type IsTime = boolean | null;
+type Label3 = string | null;
+type Name2 = string | null;
+type Type1 = "string" | "number" | "date" | "time" | "boolean";
+/**
+ * Columns widgets can group or filter by.
+ */
+type Dimensions1 = Dimension[];
+/**
+ * Columns widgets can group or filter by.
+ */
+type Dimensions2 = Dimension[];
+/**
+ * Column carrying the location key. Without it a location-scoped user cannot query this dataset.
+ */
+type FilterField1 = string | null;
+type FilterParam = string;
+/**
+ * Table or view the rows come from, for example {mart_schema}.RPT_DAILY_SALES_SUMMARY.
+ */
+type From = string | null;
+type GroupBy = string[] | null;
+/**
+ * Id widgets use to ask for this dataset, for example daily_sales.
+ */
+type Id4 = string;
+type Kpi2 = string | null;
+type Enabled2 = boolean;
+type Grain = string[];
+type Metrics1 = string[];
+type Source = string | null;
+type Join = "left" | "inner";
+type JoinColumns = string[];
+type MaxRows = number;
+/**
+ * @maxItems 3
+ */
+type Parts = [] | [MeshPart] | [MeshPart, MeshPart] | [MeshPart, MeshPart, MeshPart];
+type Dataset3 = string;
+type AiContext3 = {
+    [k: string]: JsonValue$1;
+} | string | null;
+type CustomExtensions3 = {
+    [k: string]: JsonValue$1;
+}[] | null;
+type Dependencies = string[] | null;
+type Description4 = string | null;
+/**
+ * SQL aggregate such as SUM(NET_SALES), or an expression over other metrics such as labor_cost / net_sales.
+ */
+type Expression3 = string | Expression1;
+type Filter1 = string | null;
+type Format1 = string | null;
+type Group1 = string | null;
+type Hidden1 = boolean | null;
+/**
+ * Id widgets use to ask for this metric, for example net_sales.
+ */
+type Id5 = string;
+type Label4 = string | null;
+type Name3 = string | null;
+/**
+ * sql sends the expression to the warehouse; formula computes it from other metrics after the query.
+ */
+type Type2 = "sql" | "formula";
+/**
+ * Aggregations valid on this dataset's source.
+ */
+type Metrics2 = Metric[];
+/**
+ * Label shown to users. Defaults to the id.
+ */
+type Name4 = string | null;
+type PrimaryKey = string[] | null;
+/**
+ * SQL to run when source_type is query.
+ */
+type Query2 = string | null;
+type AiContext4 = {
+    [k: string]: JsonValue$1;
+} | string | null;
+type CustomExtensions4 = {
+    [k: string]: JsonValue$1;
+}[] | null;
+/**
+ * Id of the dataset on the left of the join.
+ */
+type From1 = string;
+/**
+ * Join columns on the from dataset.
+ */
+type FromColumns = string[];
+/**
+ * Name of the join, for example sales_to_labor.
+ */
+type Name5 = string;
+/**
+ * Cardinality. one_to_many and many_to_many can fan out and double-count.
+ */
+type Relationship1 = ("one_to_one" | "many_to_one" | "one_to_many" | "many_to_many") | null;
+/**
+ * Id of the dataset on the right of the join.
+ */
+type To = string;
+/**
+ * Join columns on the to dataset, positionally matched to from_columns.
+ */
+type ToColumns = string[];
+type Relationships = Relationship[];
+/**
+ * Table or view the rows come from, for example {mart_schema}.RPT_DAILY_SALES_SUMMARY.
+ */
+type From2 = string | null;
+/**
+ * table or view reads source; query runs the query field; mesh combines datasets from different data stores.
+ */
+type SourceType = ("table" | "view" | "query" | "mesh") | null;
+type UniqueKeys = string[][] | null;
+type Datasets = Dataset2[];
+type Metrics3 = Metric[];
+type ModelRefs = string[];
+type Queries = {
+    [k: string]: NamedQuery;
+} | null;
+type DataModelId6 = string | null;
+type Dimensions3 = string[] | null;
+type File = string | null;
+type FilterField2 = string | null;
+type Filters2 = {
+    [k: string]: JsonValue$1;
+}[] | null;
+type Limit = number | null;
+type Metrics4 = string[] | null;
+type Model = string | null;
+type Segments = string[] | null;
+type Sort = {
+    [k: string]: JsonValue$1;
+}[] | null;
+type Sql = string | null;
+type Relationships1 = Relationship[];
+type Cols = number;
+type Containerpadding1 = number[] | null;
+type Margin2 = number[];
+type RowHeight = number;
+type SemanticModelRef = string | null;
+type SemanticModel = SemanticModel1[] | null;
+/**
+ * Business context available to host authoring tools, including synonyms.
+ */
+type AiContext5 = {
+    [k: string]: JsonValue$1;
+} | string | null;
+type CustomExtensions5 = {
+    [k: string]: JsonValue$1;
+}[] | null;
+/**
+ * Warehouse connections datasets may read from.
+ *
+ * @maxItems 3
+ */
+type DataStores1 = [] | [DataStore] | [DataStore, DataStore] | [DataStore, DataStore, DataStore];
+/**
+ * Reusable sources of rows widgets can ask for.
+ */
+type Datasets1 = Dataset2[];
+type Description5 = string | null;
+type Kind9 = "semantic_model";
+/**
+ * Metrics usable across datasets, including formulas spanning a join.
+ */
+type Metrics5 = Metric[];
+/**
+ * Model name. Dashboards reference the tenant model as default.
+ */
+type Name6 = string;
+/**
+ * Joins between datasets, so one widget can mix their fields.
+ */
+type Relationships2 = Relationship[];
+type SemanticModelRef1 = string | null;
+type SemanticModel2 = SemanticModel1[] | null;
+type Default2 = boolean;
+type Id6 = string;
+type Label5 = string;
+type Ref = string;
+type Widgets1 = (WidgetRef | WidgetSpec$1 | string)[];
+type Tabs = DashboardTab[];
+type Version3 = string;
+/**
+ * Top-level dashboard manifest.
+ */
+interface DashboardSpec {
+    kind?: Kind$1;
+    metadata: Metadata$1;
+    spec: DashboardSpecInner;
+    version?: Version3;
+    [k: string]: unknown;
+}
+/**
+ * Common metadata for dashboards and widgets.
+ */
+interface Metadata$1 {
+    author?: Author$1;
+    description?: Description$1;
+    header?: WidgetHeader$1 | null;
+    id: Id$1;
+    name: Name$1;
+    platform?: PlatformAttributes$1;
+    tags?: Tags1$1;
+    version?: Version1$1;
+    [k: string]: unknown;
+}
+/**
+ * Object-level header/title configuration for any widget.
+ */
+interface WidgetHeader$1 {
+    backgroundColor?: Backgroundcolor$1;
+    border?: Border$1;
+    borderRadius?: Borderradius$1;
+    color?: Color$1;
+    fontSize?: Fontsize$1;
+    fontWeight?: Fontweight$1;
+    padding?: Padding$1;
+    textAlign?: Textalign$1;
+    title?: Title$1;
+    verticalAlign?: Verticalalign$1;
+    visible?: Visible$1;
+    [k: string]: unknown;
+}
+/**
+ * A rich label with optional tooltip and icon.
+ */
+interface LabelBlock$1 {
+    icon?: Icon$1;
+    position?: Position$1;
+    text?: Text$1;
+    tooltip?: Tooltip$1;
+    [k: string]: unknown;
+}
+/**
+ * Cross-cutting platform attributes attached to every dashboard object.
+ *
+ * These attributes control the relationship of the object to the platform,
+ * the dashboard, the user, and security. They are intentionally generic so
+ * the spec can grow into the larger enterprise BI project.
+ */
+interface PlatformAttributes$1 {
+    allow_embed?: AllowEmbed$1;
+    owner?: Owner$1;
+    public?: Public$1;
+    roles?: Roles$1;
+    scope?: Scope$1;
+    status?: Status$1;
+    tags?: Tags$1;
+    version?: Version$1;
+    [k: string]: unknown;
+}
+/**
+ * Inner spec body of a dashboard.
+ */
+interface DashboardSpecInner {
+    config?: DashboardConfig | null;
+    data_stores?: DataStores;
+    datasets?: Datasets;
+    metrics?: Metrics3;
+    model_refs?: ModelRefs;
+    queries?: Queries;
+    relationships?: Relationships1;
+    responsive?: DashboardResponsiveConfig;
+    semanticModelRef?: SemanticModelRef;
+    semantic_model?: SemanticModel;
+    semantic_model_ref?: SemanticModelRef1;
+    semantic_models?: SemanticModel2;
+    tabs?: Tabs;
+    [k: string]: unknown;
+}
+/**
+ * Dashboard-level configuration overrides.
+ */
+interface DashboardConfig {
+    cache?: DashboardCacheConfig | null;
+    dataModelId?: Datamodelid;
+    filterPanel?: DashboardFilterPanelConfig | null;
+    footer?: DashboardSectionConfig | null;
+    grid?: DashboardGridConfig | null;
+    header?: DashboardSectionConfig | null;
+    print?: DashboardPrintConfig | null;
+    widgetDefaults?: WidgetDefaults$1 | null;
+    [k: string]: unknown;
+}
+/**
+ * Dashboard-level cache configuration.
+ */
+interface DashboardCacheConfig {
+    enabled?: Enabled;
+    icon?: Icon1;
+    showInEmbed?: Showinembed;
+    showInLayout?: Showinlayout;
+    showInPreview?: Showinpreview;
+    ttlSeconds?: Ttlseconds;
+    [k: string]: unknown;
+}
+/**
+ * Configuration for the dashboard filter panel.
+ */
+interface DashboardFilterPanelConfig {
+    background?: Background$1;
+    collapsible?: Collapsible;
+    defaultCollapsed?: Defaultcollapsed;
+    disableCollapse?: Disablecollapse;
+    gap?: Gap;
+    layout?: FilterLayout | null;
+    padding?: Padding2;
+    position?: Position1;
+    width?: Width;
+    [k: string]: unknown;
+}
+/**
+ * Algorithmic or manual layout for the filter panel.
+ */
+interface FilterLayout {
+    buttonSpan?: Buttonspan;
+    columns?: Columns$1;
+    dateSpan?: Datespan;
+    gap?: Gap1;
+    maxColumnWidth?: Maxcolumnwidth;
+    minColumnWidth?: Mincolumnwidth;
+    mode?: Mode;
+    padding?: Padding1$1;
+    radioSpan?: Radiospan;
+    selectSpan?: Selectspan;
+    [k: string]: unknown;
+}
+/**
+ * Configuration for header/footer sections.
+ */
+interface DashboardSectionConfig {
+    background?: Background1;
+    height?: Height;
+    padding?: Padding3;
+    textAlign?: Textalign1;
+    verticalAlign?: Verticalalign1;
+    visible?: Visible1;
+    widgets?: Widgets;
+    [k: string]: unknown;
+}
+/**
+ * Specification for a single widget/object.
+ */
+interface WidgetSpec$1 {
+    kind?: Kind1$1;
+    metadata: Metadata$1;
+    spec: WidgetSpecInner$1;
+    version?: Version2$1;
+    [k: string]: unknown;
+}
+/**
+ * Inner spec body of a widget.
+ */
+interface WidgetSpecInner$1 {
+    bindings?: Bindings$1;
+    component?: Component$1;
+    data?: Data$1;
+    display?: WidgetDisplay$1;
+    filters?: Filters1$1;
+    interactions?: Interactions$1;
+    layout?: WidgetLayout$1;
+    mappings?: FieldMapping$1;
+    [k: string]: unknown;
+}
+/**
+ * How a filter widget is wired to a target widget.
+ */
+interface FilterBinding$1 {
+    field: Field$1;
+    operator?: Operator$1;
+    param?: Param$1;
+    target?: Target$1;
+    [k: string]: unknown;
+}
+/**
+ * Run a KPI from the catalog.
+ */
+interface KpiDataSource$1 {
+    data_model_id?: DataModelId$1;
+    kind?: Kind2$1;
+    kpi: Kpi$1;
+    labelColumn?: Labelcolumn$1;
+    params?: Params$1;
+    valueColumn?: Valuecolumn$1;
+    [k: string]: unknown;
+}
+interface Params$1 {
+    [k: string]: JsonValue$1;
+}
+/**
+ * Static data supplied inline in the spec.
+ */
+interface StaticDataSource$1 {
+    columns?: Columns1$1;
+    default_value?: {
+        [k: string]: unknown;
+    };
+    kind?: Kind3$1;
+    options?: Options$1;
+    rows?: Rows$1;
+    [k: string]: unknown;
+}
+/**
+ * A single option for a static select or filter.
+ */
+interface StaticOption$1 {
+    label: Label$1;
+    value: JsonValue$1;
+    [k: string]: unknown;
+}
+/**
+ * Deterministic generated data for testing and previews.
+ */
+interface DemoDataSource$1 {
+    columns?: Columns2$1;
+    dataset?: Dataset$1;
+    kind?: Kind4$1;
+    rows?: Rows1$1;
+    seed?: Seed$1;
+    [k: string]: unknown;
+}
+/**
+ * Run an arbitrary SQL query against the configured data store.
+ */
+interface SqlDataSource$1 {
+    data_model_id?: DataModelId1$1;
+    filter_field?: FilterField$1;
+    kind?: Kind5$1;
+    params?: Params1$1;
+    query: Query$1;
+    [k: string]: unknown;
+}
+interface Params1$1 {
+    [k: string]: JsonValue$1;
+}
+/**
+ * Reference a reusable Dataset defined in the dashboard manifest.
+ */
+interface DatasetDataSource$1 {
+    columns?: Columns3;
+    data_model_id?: DataModelId2$1;
+    dataset: Dataset1$1;
+    dimensions?: Dimensions$1;
+    filters?: Filters$2;
+    kind?: Kind6$1;
+    metrics?: Metrics$1;
+    params?: Params2$1;
+    [k: string]: unknown;
+}
+/**
+ * How a target widget or dataset applies a filter broadcast from the dashboard.
+ */
+interface IncomingFilter$1 {
+    field: Field1$1;
+    filter_id: FilterId$1;
+    operator?: Operator1$1;
+    param?: Param1$1;
+    [k: string]: unknown;
+}
+interface Params2$1 {
+    [k: string]: JsonValue$1;
+}
+/**
+ * Reference a named query defined in the dashboard manifest.
+ */
+interface QueryDataSource$1 {
+    data_model_id?: DataModelId3$1;
+    kind?: Kind7$1;
+    params?: Params3$1;
+    query: Query1$1;
+    [k: string]: unknown;
+}
+interface Params3$1 {
+    [k: string]: JsonValue$1;
+}
+/**
+ * Display-specific configuration.
+ */
+interface WidgetDisplay$1 {
+    background?: Background2;
+    border?: Border1$1;
+    borderRadius?: Borderradius1$1;
+    echarts?: Echarts$1;
+    filter?: Filter$1;
+    image?: Image$1;
+    kpi?: Kpi1$1;
+    margin?: Margin$1;
+    markdown?: Markdown$1;
+    padding?: Padding4;
+    pivot_table?: PivotTable$1;
+    select?: Select$1;
+    shadow?: Shadow$1;
+    table?: Table$1;
+    tabulator?: Tabulator$1;
+    text?: Text1$1;
+    [k: string]: unknown;
+}
+/**
+ * A user-driven interaction on a widget.
+ */
+interface WidgetInteraction$1 {
+    id: Id1$1;
+    label?: Label1$1;
+    open_in?: OpenIn$1;
+    pass_filters?: PassFilters$1;
+    pass_selection?: PassSelection$1;
+    target: Target1$1;
+    target_type?: TargetType$1;
+    type: Type$1;
+    variable_mappings?: VariableMappings$1;
+    [k: string]: unknown;
+}
+/**
+ * Map a source value (event, filter, or literal) to a target filter/variable.
+ */
+interface InteractionVariableMapping$1 {
+    source?: InteractionVariableSource$1;
+    target: Target2$1;
+    target_type?: TargetType1$1;
+    [k: string]: unknown;
+}
+/**
+ * Source of a value for an interaction variable mapping.
+ */
+interface InteractionVariableSource$1 {
+    field?: Field2$1;
+    kind?: Kind8;
+    value?: unknown;
+    [k: string]: unknown;
+}
+/**
+ * Layout configuration for a widget.
+ */
+interface WidgetLayout$1 {
+    h?: H$1;
+    isBounded?: Isbounded$1;
+    isDraggable?: Isdraggable$1;
+    isResizable?: Isresizable$1;
+    maxH?: Maxh$1;
+    maxW?: Maxw$1;
+    minH?: Minh$1;
+    minW?: Minw$1;
+    resizeHandles?: Resizehandles$1;
+    responsive?: ResponsiveLayout$1;
+    unplaced?: Unplaced$1;
+    w?: W1$1;
+    x?: X1$1;
+    y?: Y1$1;
+    [k: string]: unknown;
+}
+/**
+ * Responsive overrides for a layout item.
+ */
+interface ResponsiveLayout$1 {
+    desktop?: LayoutItem$2 | null;
+    mobile?: LayoutItem$2 | null;
+    tablet?: LayoutItem$2 | null;
+    wide?: LayoutItem$2 | null;
+    [k: string]: unknown;
+}
+/**
+ * A single position/size entry in a responsive grid.
+ */
+interface LayoutItem$2 {
+    h?: H1$1;
+    isBounded?: Isbounded1$1;
+    isDraggable?: Isdraggable1$1;
+    isResizable?: Isresizable1$1;
+    maxH?: Maxh1$1;
+    maxW?: Maxw1$1;
+    minH?: Minh1$1;
+    minW?: Minw1$1;
+    resizeHandles?: Resizehandles1$1;
+    w?: W$1;
+    x?: X$1;
+    y?: Y$1;
+    [k: string]: unknown;
+}
+/**
+ * Map widget fields to columns in the data source.
+ */
+interface FieldMapping$1 {
+    category?: Category$1;
+    date?: Date$1;
+    delta?: Delta$1;
+    label?: Label2$1;
+    series?: Series$1;
+    series_name?: SeriesName$1;
+    value?: Value$1;
+    x?: X2$1;
+    y?: Y2$1;
+    [k: string]: unknown;
+}
+/**
+ * Core react-grid-layout behavior for the dashboard.
+ */
+interface DashboardGridConfig {
+    allowOverlap?: Allowoverlap;
+    compactType?: Compacttype;
+    containerPadding?: Containerpadding;
+    draggableCancel?: Draggablecancel;
+    draggableHandle?: Draggablehandle;
+    isBounded?: Isbounded2;
+    maxLayoutWidth?: Maxlayoutwidth;
+    maxRows?: Maxrows;
+    preventCollision?: Preventcollision;
+    resizeHandles?: Resizehandles2;
+    snap?: Snap;
+    squareCells?: Squarecells;
+    [k: string]: unknown;
+}
+/**
+ * Print/export settings for the dashboard.
+ */
+interface DashboardPrintConfig {
+    backgroundColor?: Backgroundcolor1;
+    fitMode?: Fitmode;
+    orientation?: Orientation;
+    pageSize?: Pagesize;
+    scale?: Scale;
+    [k: string]: unknown;
+}
+/**
+ * Dashboard-level defaults for widget appearance.
+ */
+interface WidgetDefaults$1 {
+    echarts?: WidgetTheme$1 | null;
+    filter?: WidgetTheme$1 | null;
+    global?: WidgetTheme$1 | null;
+    image?: WidgetTheme$1 | null;
+    kpi?: WidgetTheme$1 | null;
+    markdown?: WidgetTheme$1 | null;
+    pivot_table?: WidgetTheme$1 | null;
+    select?: WidgetTheme$1 | null;
+    table?: WidgetTheme$1 | null;
+    tabulator?: WidgetTheme$1 | null;
+    text?: WidgetTheme$1 | null;
+    [k: string]: unknown;
+}
+/**
+ * Reusable theme settings for a widget or a default widget group.
+ */
+interface WidgetTheme$1 {
+    background?: Background3;
+    border?: Border2;
+    borderRadius?: Borderradius2;
+    margin?: Margin1;
+    padding?: Padding5;
+    shadow?: Shadow1;
+    [k: string]: unknown;
+}
+/**
+ * A data-store (warehouse) connection referenced by datasets.
+ */
+interface DataStore {
+    ai_context?: AiContext;
+    custom_extensions?: CustomExtensions;
+    data_model_id?: DataModelId4;
+    default?: Default;
+    description?: Description1;
+    id: Id2;
+    name?: Name1;
+    vendor?: Vendor;
+    [k: string]: unknown;
+}
+/**
+ * A reusable semantic dataset: schema/table, dimensions, and metrics.
+ */
+interface Dataset2 {
+    ai_context?: AiContext1;
+    cache?: DatasetCacheConfig | null;
+    custom_extensions?: CustomExtensions1;
+    dataStoreId?: DataStoreId;
+    dataStoreIds?: DataStoreIds;
+    data_model_id?: DataModelId5;
+    data_store_id?: DataStoreId1;
+    data_store_ids?: DataStoreIds1;
+    description?: Description2;
+    dimensions?: Dimensions1;
+    fields?: Dimensions2;
+    filter_field?: FilterField1;
+    filter_param?: FilterParam;
+    from?: From;
+    group_by?: GroupBy;
+    id: Id4;
+    kpi?: Kpi2;
+    materialization?: DatasetMaterialization | null;
+    mesh?: MeshPlan | null;
+    metrics?: Metrics2;
+    name?: Name4;
+    params?: Params4;
+    primary_key?: PrimaryKey;
+    query?: Query2;
+    relationships?: Relationships;
+    source?: From2;
+    source_type?: SourceType;
+    unique_keys?: UniqueKeys;
+    [k: string]: unknown;
+}
+/**
+ * How long a dataset's warehouse results may be reused.
+ */
+interface DatasetCacheConfig {
+    enabled?: Enabled1;
+    ttlSeconds?: TtlSeconds;
+    ttl_seconds?: TtlSeconds1;
+    [k: string]: unknown;
+}
+/**
+ * A dimension (attribute) inside a Dataset.
+ */
+interface Dimension {
+    ai_context?: AiContext2;
+    column?: Column;
+    custom_extensions?: CustomExtensions2;
+    description?: Description3;
+    expression?: Expression;
+    format?: Format;
+    group?: Group;
+    hidden?: Hidden;
+    id: Id3;
+    is_time?: IsTime;
+    label?: Label3;
+    name?: Name2;
+    type?: Type1;
+    [k: string]: unknown;
+}
+/**
+ * OSI-style multi-dialect expression block.
+ *
+ * ``dialects`` lists SQL or expression variants per warehouse. ``default`` is
+ * available for row-level formulas or fallback SQL.
+ */
+interface Expression1 {
+    default?: Default1;
+    dialects?: Dialects;
+    [k: string]: unknown;
+}
+/**
+ * A single dialect expression for a field or metric.
+ */
+interface ExpressionDialect {
+    dialect: Dialect;
+    expression: Expression2;
+    [k: string]: unknown;
+}
+/**
+ * A pre-aggregated rollup the engine may read instead of the base source.
+ *
+ * ``grain`` lists the dimensions the rollup is aggregated to and ``metrics``
+ * the measures it carries. A widget selection covered by both is answered from
+ * ``source``; anything wider falls back to the dataset's own source, so the
+ * rollup is an optimisation and never changes what a widget can ask for.
+ */
+interface DatasetMaterialization {
+    enabled?: Enabled2;
+    grain?: Grain;
+    metrics?: Metrics1;
+    source?: Source;
+    [k: string]: unknown;
+}
+/**
+ * How a mesh dataset stitches datasets from different data stores together.
+ */
+interface MeshPlan {
+    join?: Join;
+    join_columns?: JoinColumns;
+    max_rows?: MaxRows;
+    parts?: Parts;
+    [k: string]: unknown;
+}
+/**
+ * One dataset taking part in a mesh dataset.
+ */
+interface MeshPart {
+    dataset: Dataset3;
+    [k: string]: unknown;
+}
+/**
+ * A calculated field or metric inside a Dataset.
+ */
+interface Metric {
+    ai_context?: AiContext3;
+    custom_extensions?: CustomExtensions3;
+    dependencies?: Dependencies;
+    description?: Description4;
+    expression: Expression3;
+    filter?: Filter1;
+    format?: Format1;
+    group?: Group1;
+    hidden?: Hidden1;
+    id: Id5;
+    label?: Label4;
+    name?: Name3;
+    type?: Type2;
+    [k: string]: unknown;
+}
+interface Params4 {
+    [k: string]: JsonValue$1;
+}
+/**
+ * A relationship between two datasets (OSI-style join).
+ */
+interface Relationship {
+    ai_context?: AiContext4;
+    custom_extensions?: CustomExtensions4;
+    from: From1;
+    from_columns?: FromColumns;
+    name: Name5;
+    relationship?: Relationship1;
+    to: To;
+    to_columns?: ToColumns;
+    [k: string]: unknown;
+}
+/**
+ * A reusable named query referenced by widgets.
+ */
+interface NamedQuery {
+    data_model_id?: DataModelId6;
+    dimensions?: Dimensions3;
+    file?: File;
+    filter_field?: FilterField2;
+    filters?: Filters2;
+    limit?: Limit;
+    metrics?: Metrics4;
+    model?: Model;
+    params?: Params5;
+    segments?: Segments;
+    sort?: Sort;
+    sql?: Sql;
+    [k: string]: unknown;
+}
+interface Params5 {
+    [k: string]: JsonValue$1;
+}
+/**
+ * Top-level responsive grid configuration.
+ */
+interface DashboardResponsiveConfig {
+    desktop?: BreakpointConfig;
+    mobile?: BreakpointConfig;
+    tablet?: BreakpointConfig;
+    wide?: BreakpointConfig;
+    [k: string]: unknown;
+}
+/**
+ * Responsive breakpoint configuration for the dashboard grid.
+ */
+interface BreakpointConfig {
+    cols?: Cols;
+    containerPadding?: Containerpadding1;
+    margin?: Margin2;
+    row_height?: RowHeight;
+    [k: string]: unknown;
+}
+/**
+ * An OSI semantic model block (data stores, datasets, relationships, metrics).
+ */
+interface SemanticModel1 {
+    ai_context?: AiContext5;
+    custom_extensions?: CustomExtensions5;
+    data_stores?: DataStores1;
+    datasets?: Datasets1;
+    description?: Description5;
+    kind?: Kind9;
+    metrics?: Metrics5;
+    name: Name6;
+    relationships?: Relationships2;
+    [k: string]: unknown;
+}
+/**
+ * A tab/page inside a dashboard.
+ */
+interface DashboardTab {
+    default?: Default2;
+    id: Id6;
+    label: Label5;
+    widgets?: Widgets1;
+    [k: string]: unknown;
+}
+/**
+ * A reference to a separate widget YAML file.
+ */
+interface WidgetRef {
+    ref: Ref;
+    [k: string]: unknown;
+}
+
+type Kind = "widget";
+type Author = string | null;
+type Description = string;
+type Backgroundcolor = string | null;
+type Border = string | boolean | null;
+type Borderradius = string | number | null;
+type Color = string | null;
+type Fontsize = string | number | null;
+type Fontweight = string | number | null;
+type Padding = string | number | null;
+type Textalign = ("left" | "center" | "right" | "justify") | null;
+type Title = string | LabelBlock | null;
+type Icon = string | null;
+type Position = ("top" | "bottom" | "left" | "right") | null;
+type Text = string | null;
+type Tooltip = string | null;
+type Verticalalign = ("top" | "middle" | "bottom") | null;
+type Visible = boolean | null;
+type Id = string;
+type Name = string;
+type AllowEmbed = boolean;
+type Owner = string | null;
+type Public = boolean;
+type Roles = string[];
+type Scope = "org" | "project" | "dashboard" | "widget";
+type Status = "draft" | "published" | "archived";
+type Tags = string[];
+type Version = string;
+type Tags1 = string[];
+type Version1 = string;
+type Field = string;
+type Operator = "eq" | "in" | "gt" | "lt" | "gte" | "lte" | "contains" | "date" | "between";
+type Param = string | null;
+type Target = string;
+type Bindings = FilterBinding[];
+type Component = "echarts" | "kpi" | "filter" | "select" | "table" | "tabulator" | "pivot_table" | "text" | "image" | "markdown";
+type Data = Data1 | null;
+type Data1 = KpiDataSource | StaticDataSource | DemoDataSource | SqlDataSource | DatasetDataSource | QueryDataSource;
+type DataModelId = string | null;
+type Kind1 = "kpi";
+type Kpi = string;
+type Labelcolumn = string | null;
+type JsonValue = unknown;
+type Valuecolumn = string | null;
+type Columns = string[] | null;
+type Kind2 = "static";
+type Label = string;
+type Options = StaticOption[];
+type Rows = {
+    [k: string]: JsonValue;
+}[];
+type Columns1 = string[] | null;
+type Dataset = string | null;
+type Kind3 = "demo";
+type Rows1 = number;
+type Seed = number;
+type DataModelId1 = string | null;
+type FilterField = string | null;
+type Kind4 = "sql";
+type Query = string;
+type Columns2 = string[] | null;
+type DataModelId2 = string | null;
+type Dataset1 = string;
+type Dimensions = string[] | null;
+type Field1 = string;
+type FilterId = string;
+type Operator1 = "eq" | "in" | "gt" | "lt" | "gte" | "lte" | "contains" | "date" | "between";
+type Param1 = string | null;
+type Filters$1 = IncomingFilter[];
+type Kind5 = "dataset";
+type Metrics = string[] | null;
+type DataModelId3 = string | null;
+type Kind6 = "query";
+type Query1 = string;
+type Background = string | null;
+type Border1 = string | boolean | null;
+type Borderradius1 = string | number | null;
+type Echarts = {
+    [k: string]: JsonValue;
+} | null;
+type Filter = {
+    [k: string]: JsonValue;
+} | null;
+type Image = {
+    [k: string]: JsonValue;
+} | null;
+type Kpi1 = {
+    [k: string]: JsonValue;
+} | null;
+type Margin = string | number | null;
+type Markdown = {
+    [k: string]: JsonValue;
+} | null;
+type Padding1 = string | number | null;
+type PivotTable = {
+    [k: string]: JsonValue;
+} | null;
+type Select = {
+    [k: string]: JsonValue;
+} | null;
+type Shadow = string | boolean | null;
+type Table = {
+    [k: string]: JsonValue;
+} | null;
+type Tabulator = {
+    [k: string]: JsonValue;
+} | null;
+type Text1 = {
+    [k: string]: JsonValue;
+} | null;
+type Filters1 = IncomingFilter[];
+type Id1 = string;
+type Label1 = string | null;
+type OpenIn = "modal" | "same" | "new" | "detail";
+type PassFilters = boolean;
+type PassSelection = boolean;
+type Target1 = string;
+type TargetType = "dashboard" | "url" | "filter" | "dimension";
+type Type = "drilldown" | "set_filter" | "navigate";
+type Field2 = string | null;
+type Kind7 = "event" | "filter" | "literal";
+type Target2 = string;
+type TargetType1 = "filter" | "dimension";
+type VariableMappings = InteractionVariableMapping[];
+type Interactions = WidgetInteraction[];
+type H = number;
+type Isbounded = boolean | null;
+type Isdraggable = boolean | null;
+type Isresizable = boolean | null;
+type Maxh = number | null;
+type Maxw = number | null;
+type Minh = number | null;
+type Minw = number | null;
+type Resizehandles = string[] | null;
+type H1 = number;
+type Isbounded1 = boolean | null;
+type Isdraggable1 = boolean | null;
+type Isresizable1 = boolean | null;
+type Maxh1 = number | null;
+type Maxw1 = number | null;
+type Minh1 = number | null;
+type Minw1 = number | null;
+type Resizehandles1 = string[] | null;
+type W = number;
+type X = number;
+type Y = number;
+type Unplaced = boolean | null;
+type W1 = number;
+type X1 = number;
+type Y1 = number;
+type Category = string | null;
+type Date = string | null;
+type Delta = string | null;
+type Label2 = string | null;
+type Series = string | null;
+type SeriesName = string | null;
+type Value = string | null;
+type X2 = string | null;
+type Y2 = string | null;
+type Version2 = string;
+/**
+ * Specification for a single widget/object.
+ */
+interface WidgetSpec {
+    kind?: Kind;
+    metadata: Metadata;
+    spec: WidgetSpecInner;
+    version?: Version2;
+    [k: string]: unknown;
+}
+/**
+ * Common metadata for dashboards and widgets.
+ */
+interface Metadata {
+    author?: Author;
+    description?: Description;
+    header?: WidgetHeader | null;
+    id: Id;
+    name: Name;
+    platform?: PlatformAttributes;
+    tags?: Tags1;
+    version?: Version1;
+    [k: string]: unknown;
+}
+/**
+ * Object-level header/title configuration for any widget.
+ */
+interface WidgetHeader {
+    backgroundColor?: Backgroundcolor;
+    border?: Border;
+    borderRadius?: Borderradius;
+    color?: Color;
+    fontSize?: Fontsize;
+    fontWeight?: Fontweight;
+    padding?: Padding;
+    textAlign?: Textalign;
+    title?: Title;
+    verticalAlign?: Verticalalign;
+    visible?: Visible;
+    [k: string]: unknown;
+}
+/**
+ * A rich label with optional tooltip and icon.
+ */
+interface LabelBlock {
+    icon?: Icon;
+    position?: Position;
+    text?: Text;
+    tooltip?: Tooltip;
+    [k: string]: unknown;
+}
+/**
+ * Cross-cutting platform attributes attached to every dashboard object.
+ *
+ * These attributes control the relationship of the object to the platform,
+ * the dashboard, the user, and security. They are intentionally generic so
+ * the spec can grow into the larger enterprise BI project.
+ */
+interface PlatformAttributes {
+    allow_embed?: AllowEmbed;
+    owner?: Owner;
+    public?: Public;
+    roles?: Roles;
+    scope?: Scope;
+    status?: Status;
+    tags?: Tags;
+    version?: Version;
+    [k: string]: unknown;
+}
+/**
+ * Inner spec body of a widget.
+ */
+interface WidgetSpecInner {
+    bindings?: Bindings;
+    component?: Component;
+    data?: Data;
+    display?: WidgetDisplay;
+    filters?: Filters1;
+    interactions?: Interactions;
+    layout?: WidgetLayout;
+    mappings?: FieldMapping;
+    [k: string]: unknown;
+}
+/**
+ * How a filter widget is wired to a target widget.
+ */
+interface FilterBinding {
+    field: Field;
+    operator?: Operator;
+    param?: Param;
+    target?: Target;
+    [k: string]: unknown;
+}
+/**
+ * Run a KPI from the catalog.
+ */
+interface KpiDataSource {
+    data_model_id?: DataModelId;
+    kind?: Kind1;
+    kpi: Kpi;
+    labelColumn?: Labelcolumn;
+    params?: Params;
+    valueColumn?: Valuecolumn;
+    [k: string]: unknown;
+}
+interface Params {
+    [k: string]: JsonValue;
+}
+/**
+ * Static data supplied inline in the spec.
+ */
+interface StaticDataSource {
+    columns?: Columns;
+    default_value?: {
+        [k: string]: unknown;
+    };
+    kind?: Kind2;
+    options?: Options;
+    rows?: Rows;
+    [k: string]: unknown;
+}
+/**
+ * A single option for a static select or filter.
+ */
+interface StaticOption {
+    label: Label;
+    value: JsonValue;
+    [k: string]: unknown;
+}
+/**
+ * Deterministic generated data for testing and previews.
+ */
+interface DemoDataSource {
+    columns?: Columns1;
+    dataset?: Dataset;
+    kind?: Kind3;
+    rows?: Rows1;
+    seed?: Seed;
+    [k: string]: unknown;
+}
+/**
+ * Run an arbitrary SQL query against the configured data store.
+ */
+interface SqlDataSource {
+    data_model_id?: DataModelId1;
+    filter_field?: FilterField;
+    kind?: Kind4;
+    params?: Params1;
+    query: Query;
+    [k: string]: unknown;
+}
+interface Params1 {
+    [k: string]: JsonValue;
+}
+/**
+ * Reference a reusable Dataset defined in the dashboard manifest.
+ */
+interface DatasetDataSource {
+    columns?: Columns2;
+    data_model_id?: DataModelId2;
+    dataset: Dataset1;
+    dimensions?: Dimensions;
+    filters?: Filters$1;
+    kind?: Kind5;
+    metrics?: Metrics;
+    params?: Params2;
+    [k: string]: unknown;
+}
+/**
+ * How a target widget or dataset applies a filter broadcast from the dashboard.
+ */
+interface IncomingFilter {
+    field: Field1;
+    filter_id: FilterId;
+    operator?: Operator1;
+    param?: Param1;
+    [k: string]: unknown;
+}
+interface Params2 {
+    [k: string]: JsonValue;
+}
+/**
+ * Reference a named query defined in the dashboard manifest.
+ */
+interface QueryDataSource {
+    data_model_id?: DataModelId3;
+    kind?: Kind6;
+    params?: Params3;
+    query: Query1;
+    [k: string]: unknown;
+}
+interface Params3 {
+    [k: string]: JsonValue;
+}
+/**
+ * Display-specific configuration.
+ */
+interface WidgetDisplay {
+    background?: Background;
+    border?: Border1;
+    borderRadius?: Borderradius1;
+    echarts?: Echarts;
+    filter?: Filter;
+    image?: Image;
+    kpi?: Kpi1;
+    margin?: Margin;
+    markdown?: Markdown;
+    padding?: Padding1;
+    pivot_table?: PivotTable;
+    select?: Select;
+    shadow?: Shadow;
+    table?: Table;
+    tabulator?: Tabulator;
+    text?: Text1;
+    [k: string]: unknown;
+}
+/**
+ * A user-driven interaction on a widget.
+ */
+interface WidgetInteraction {
+    id: Id1;
+    label?: Label1;
+    open_in?: OpenIn;
+    pass_filters?: PassFilters;
+    pass_selection?: PassSelection;
+    target: Target1;
+    target_type?: TargetType;
+    type: Type;
+    variable_mappings?: VariableMappings;
+    [k: string]: unknown;
+}
+/**
+ * Map a source value (event, filter, or literal) to a target filter/variable.
+ */
+interface InteractionVariableMapping {
+    source?: InteractionVariableSource;
+    target: Target2;
+    target_type?: TargetType1;
+    [k: string]: unknown;
+}
+/**
+ * Source of a value for an interaction variable mapping.
+ */
+interface InteractionVariableSource {
+    field?: Field2;
+    kind?: Kind7;
+    value?: unknown;
+    [k: string]: unknown;
+}
+/**
+ * Layout configuration for a widget.
+ */
+interface WidgetLayout {
+    h?: H;
+    isBounded?: Isbounded;
+    isDraggable?: Isdraggable;
+    isResizable?: Isresizable;
+    maxH?: Maxh;
+    maxW?: Maxw;
+    minH?: Minh;
+    minW?: Minw;
+    resizeHandles?: Resizehandles;
+    responsive?: ResponsiveLayout;
+    unplaced?: Unplaced;
+    w?: W1;
+    x?: X1;
+    y?: Y1;
+    [k: string]: unknown;
+}
+/**
+ * Responsive overrides for a layout item.
+ */
+interface ResponsiveLayout {
+    desktop?: LayoutItem$1 | null;
+    mobile?: LayoutItem$1 | null;
+    tablet?: LayoutItem$1 | null;
+    wide?: LayoutItem$1 | null;
+    [k: string]: unknown;
+}
+/**
+ * A single position/size entry in a responsive grid.
+ */
+interface LayoutItem$1 {
+    h?: H1;
+    isBounded?: Isbounded1;
+    isDraggable?: Isdraggable1;
+    isResizable?: Isresizable1;
+    maxH?: Maxh1;
+    maxW?: Maxw1;
+    minH?: Minh1;
+    minW?: Minw1;
+    resizeHandles?: Resizehandles1;
+    w?: W;
+    x?: X;
+    y?: Y;
+    [k: string]: unknown;
+}
+/**
+ * Map widget fields to columns in the data source.
+ */
+interface FieldMapping {
+    category?: Category;
+    date?: Date;
+    delta?: Delta;
+    label?: Label2;
+    series?: Series;
+    series_name?: SeriesName;
+    value?: Value;
+    x?: X2;
+    y?: Y2;
+    [k: string]: unknown;
+}
+
+type Breakpoint = "mobile" | "tablet" | "desktop" | "wide";
+type ResizeHandle = "s" | "w" | "e" | "n" | "sw" | "nw" | "se" | "ne";
+interface LayoutItem {
+    i: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    minW?: number;
+    maxW?: number;
+    minH?: number;
+    maxH?: number;
+    isBounded?: boolean;
+    isDraggable?: boolean;
+    isResizable?: boolean;
+    resizeHandles?: ResizeHandle[];
+}
+type ResponsiveLayouts = Record<string, LayoutItem[] | null | undefined>;
+interface DashboardModelMetricDiagnostic {
+    metric: Record<string, unknown>;
+    dialect: string;
+    resolved_expression: string;
+    dependencies: string[];
+    dataset_ids?: string[];
+    sample_query: string | null;
+    issues: string[];
+}
+interface DashboardModelDataStoreDiagnostic {
+    id: string;
+    name: string | null;
+    vendor: string | null;
+    data_model_id: string | null;
+    default: boolean;
+    dialect: string;
+    dataset_ids: string[];
+    issues: string[];
+    notes?: string[];
+}
+interface DashboardModelDatasetDiagnostic {
+    id: string;
+    name: string | null;
+    data_store_id: string | null;
+    resolved_data_store_id: string | null;
+    data_model_id: string | null;
+    source_type: string | null;
+    source: string | null;
+    dialect: string;
+    dimension_ids: string[];
+    metric_ids: string[];
+    filter_field: string | null;
+    sample_sql: string | null;
+    issues: string[];
+}
+interface DashboardModelRelationshipDiagnostic {
+    name: string;
+    from: string;
+    to: string;
+    from_columns: string[];
+    to_columns: string[];
+    relationship: string | null;
+    issues: string[];
+}
+interface DashboardModelAiGrounding {
+    dataset_count: number;
+    metric_count: number;
+    preview: string;
+}
+interface DashboardModelDiagnostics {
+    model: {
+        name: string;
+        description: string | null;
+        dialect: string;
+        issues: string[];
+    };
+    data_stores: DashboardModelDataStoreDiagnostic[];
+    datasets: DashboardModelDatasetDiagnostic[];
+    relationships: DashboardModelRelationshipDiagnostic[];
+    metrics: DashboardModelMetricDiagnostic[];
+    /** Present only where the host grounds an assistant on the model. */
+    ai_grounding?: DashboardModelAiGrounding;
+}
+
+interface WidgetInteractionContext {
+    widgetId: string;
+    data?: Record<string, unknown>;
+    value?: unknown;
+}
+
+/**
+ * Put semantic model problems on the line that causes them.
+ *
+ * Diagnostics come back keyed by object id ("dataset daily_sales: ..."), which
+ * leaves the reader to find `daily_sales` in a few hundred lines of YAML by eye.
+ * These helpers locate the node that declares each id and turn the issues into
+ * editor markers, so a problem is underlined where it lives.
+ */
+
+type ModelMarkerSeverity = "error" | "warning" | "info";
+interface ModelMarker {
+    /** 1-based, as common code editors count. */
+    startLineNumber: number;
+    startColumn: number;
+    endLineNumber: number;
+    endColumn: number;
+    message: string;
+    severity: ModelMarkerSeverity;
+}
+
+type ChartOption = Record<string, unknown>;
+type DataRow = Record<string, unknown>;
+type WidgetResult = Record<string, unknown>;
+type WidgetComponent = "echarts" | "kpi" | "filter" | "select" | "table" | "tabulator" | "pivot_table" | "text" | "image" | "markdown";
+interface RendererLabel {
+    text?: string;
+    position: "top" | "bottom";
+    tooltip?: string;
+    tooltipIcon?: "info" | "check" | "help" | "warning";
+}
+interface WidgetTheme {
+    padding?: string | number;
+    margin?: string | number;
+    borderRadius?: string | number;
+    background?: string;
+    border?: string | boolean;
+    shadow?: string | boolean;
+}
+type WidgetDefaults = Partial<Record<WidgetComponent | "global", WidgetTheme>>;
+interface RendererFrame {
+    widgetId: string;
+    component: string;
+    theme: WidgetTheme;
+    showObjectHeader: boolean;
+    label?: RendererLabel;
+    interactive: boolean;
+}
+interface KpiDeltaModel {
+    value: number;
+    formattedValue: string;
+    tone: "up" | "down" | "flat";
+    icon: "up" | "down" | "neutral" | "none";
+    comparedWith?: string;
+    tooltip?: string;
+    tooltipIcon?: "info" | "check" | "help" | "warning";
+    color?: string;
+    reference?: {
+        value: number;
+        formattedValue: string;
+    };
+}
+interface KpiValueFormat {
+    format: string;
+    prefix: string;
+    suffix: string;
+    compact: boolean;
+    decimals?: number;
+}
+interface KpiRendererModel {
+    kind: "kpi";
+    frame: RendererFrame;
+    value: number;
+    formattedValue: string;
+    settledValue: string;
+    /** How the value was formatted, so a host can format intermediate values the same way. */
+    valueFormat: KpiValueFormat;
+    delta?: KpiDeltaModel;
+    note?: string;
+}
+interface ChartRendererModel {
+    kind: "chart";
+    frame: RendererFrame;
+    option: ChartOption;
+    axisKey: string;
+    structureKey: string;
+    loading: boolean;
+}
+interface TextRendererStyle {
+    textAlign: "left" | "center" | "right" | "justify";
+    verticalAlign: "top" | "middle" | "bottom";
+    fontSize?: string | number;
+    fontWeight?: string | number;
+    color?: string;
+    lineHeight?: string | number;
+    letterSpacing?: string | number;
+    whiteSpace?: "normal" | "nowrap" | "pre" | "pre-wrap" | "pre-line";
+    truncate: boolean;
+    custom: Record<string, string | number>;
+}
+interface TextRendererModel {
+    kind: "text";
+    frame: RendererFrame;
+    content: string;
+    contentFormat: "text" | "markdown";
+    style: TextRendererStyle;
+}
+interface MarkdownRendererModel {
+    kind: "markdown";
+    frame: RendererFrame;
+    content: string;
+}
+interface ImageRendererModel {
+    kind: "image";
+    frame: RendererFrame;
+    source: string | null;
+    alt: string;
+    objectFit: "cover" | "contain";
+}
+type SortDirection = "asc" | "desc";
+interface TableSortState {
+    column: string;
+    direction: SortDirection;
+}
+interface TableExportModel {
+    csv: boolean;
+    excel: boolean;
+    filename: string;
+}
+interface TableColumnModel {
+    field: string;
+    title: string;
+    sortable: boolean;
+    sortDirection: SortDirection | null;
+}
+interface TableCellModel {
+    field: string;
+    value: unknown;
+    text: string;
+}
+interface TableRowModel {
+    key: number;
+    data: DataRow;
+    cells: TableCellModel[];
+}
+interface TableRendererModel {
+    kind: "table";
+    frame: RendererFrame;
+    columns: TableColumnModel[];
+    rows: TableRowModel[];
+    allRows: DataRow[];
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    totalRows: number;
+    sort: TableSortState | null;
+    exports: TableExportModel;
+}
+type GridColumnFormatterModel = {
+    kind: "percent";
+    precision: number;
+    params: Record<string, unknown>;
+} | {
+    kind: "named";
+    name: string;
+    params: Record<string, unknown>;
+};
+interface GridColumnModel {
+    field: string;
+    title: string;
+    frozen: boolean;
+    headerSort: boolean;
+    formatter?: GridColumnFormatterModel;
+    width?: number | string;
+    headerTooltip?: string;
+    sorter?: string;
+}
+interface GridOptionsModel {
+    layout: "fitColumns" | "fitData" | "fitDataFill";
+    pagination: boolean;
+    pageSize?: number;
+    groupBy?: string;
+    groupStartOpen: boolean;
+    sortable: boolean;
+}
+interface TabulatorRendererModel {
+    kind: "tabulator";
+    frame: RendererFrame;
+    columns: GridColumnModel[];
+    rows: DataRow[];
+    options: GridOptionsModel;
+    exports: TableExportModel;
+}
+type PivotAggregation = "sum" | "avg" | "min" | "max" | "count" | "count_distinct";
+interface PivotFieldPayload {
+    key: string;
+    label: string;
+}
+interface PivotMeasurePayload {
+    key: string;
+    label: string;
+    agg: PivotAggregation;
+    format: "number" | "currency" | "percent" | null;
+    decimals: number | null;
+}
+interface PivotColumnNode {
+    key: string;
+    label: string;
+    column: string | null;
+    measure: string | null;
+    is_total: boolean;
+    is_group_total: boolean;
+    children: PivotColumnNode[];
+}
+type PivotRowKind = "group" | "leaf" | "other" | "grand_total";
+type PivotDirection = "asc" | "desc";
+interface PivotRowPayload {
+    key: string;
+    label: string;
+    path: string[];
+    depth: number;
+    kind: PivotRowKind;
+    cells: Record<string, number | null>;
+}
+interface PivotTablePayload {
+    row_fields: PivotFieldPayload[];
+    column_fields: PivotFieldPayload[];
+    measures: PivotMeasurePayload[];
+    column_tree: PivotColumnNode[];
+    column_keys: string[];
+    column_labels: Record<string, string>;
+    rows: PivotRowPayload[];
+    total_row: PivotRowPayload | null;
+    value_range: Record<string, {
+        min: number;
+        max: number;
+    }>;
+    empty_value: string;
+    subtotals: "expanded" | "collapsed" | "none";
+    heatmap_measure: string | null;
+    snapshot_expand: number | null;
+    snapshot_expand_columns?: number | null;
+    sort: {
+        column: string | null;
+        measure: string | null;
+        direction: PivotDirection;
+    };
+    truncated: {
+        row_groups: number;
+        row_groups_total: number;
+        rolled_up: number;
+        columns: number;
+        columns_total: number;
+    };
+    fields: {
+        dimensions: PivotFieldPayload[];
+        measures: PivotFieldPayload[];
+    };
+    explore: boolean;
+    explored: boolean;
+    source?: {
+        records: (string | number | null)[][];
+    };
+}
+interface PivotDetailColumn {
+    key: string;
+    label: string;
+}
+interface PivotDetailResult {
+    component: "pivot_detail";
+    columns: PivotDetailColumn[];
+    rows: DataRow[];
+    row_count: number;
+    truncated: boolean;
+}
+declare const PIVOT_META_PROP = "__pivotMeta";
+interface PivotGridRowMeta {
+    key: string;
+    label: string;
+    path: string[];
+    depth: number;
+    kind: PivotRowKind;
+}
+interface PivotGridRow {
+    [PIVOT_META_PROP]: PivotGridRowMeta;
+    [prop: string]: string | number | null | PivotGridRowMeta;
+}
+interface PivotGridColumn {
+    prop: string;
+    name: string;
+    columnKey: string | null;
+    measure: string | null;
+    isTotal: boolean;
+    isRowField: boolean;
+    pinStart: boolean;
+}
+interface PivotGridColumnGroup {
+    name: string;
+    key: string;
+    foldable: boolean;
+    folded: boolean;
+    leafCount: number;
+    children: PivotGridColumnDefinition[];
+}
+type PivotGridColumnDefinition = PivotGridColumn | PivotGridColumnGroup;
+interface PivotSortState {
+    column: string;
+    direction: PivotDirection;
+}
+type PivotFilterOp = "gte" | "gt" | "eq" | "lte" | "lt";
+interface PivotColumnFilter {
+    op: PivotFilterOp;
+    value: number;
+}
+interface PivotViewState {
+    collapsed: ReadonlySet<string>;
+    collapsedColumns: ReadonlySet<string>;
+    search: string;
+    filters: Readonly<Record<string, PivotColumnFilter>>;
+    sort: PivotSortState | null;
+}
+interface PivotOpenLevels {
+    rows: number | null;
+    columns: number | null;
+}
+interface PivotControlsModel {
+    searchPlaceholder: string;
+    expandable: boolean;
+    groupCount: number;
+    filterCount: number;
+    reordered: boolean;
+    canFilter: true;
+    canRearrange: false;
+    embedded: boolean;
+}
+interface MissingPivotRendererModel {
+    kind: "pivot";
+    status: "missing";
+    frame: RendererFrame;
+    message: "This widget did not return a pivot table.";
+}
+interface ReadyPivotRendererModel {
+    kind: "pivot";
+    status: "ready";
+    frame: RendererFrame;
+    payload: PivotTablePayload;
+    view: PivotViewState;
+    columns: PivotGridColumnDefinition[];
+    rows: PivotGridRow[];
+    totalRow: PivotGridRow | null;
+    valueColumns: PivotFieldPayload[];
+    columnGroups: PivotFieldPayload[];
+    truncation: string | null;
+    controls: PivotControlsModel;
+    exports: TableExportModel;
+    openLevels: PivotOpenLevels;
+}
+type PivotRendererModel = MissingPivotRendererModel | ReadyPivotRendererModel;
+interface UnknownRendererModel {
+    kind: "unknown";
+    frame: RendererFrame;
+    message: "Unknown widget type";
+}
+interface ExtensionRendererModel {
+    kind: "extension";
+    frame: RendererFrame;
+    name: string;
+    content: unknown;
+}
+type BasicRendererModel = KpiRendererModel | ChartRendererModel | TableRendererModel | TabulatorRendererModel | PivotRendererModel | TextRendererModel | MarkdownRendererModel | ImageRendererModel | UnknownRendererModel | ExtensionRendererModel;
+interface RendererContext {
+    filters?: Record<string, unknown>;
+    filterLabels?: Record<string, string>;
+    widgetDefaults?: WidgetDefaults;
+    reducedMotion?: boolean;
+    answeredOnce?: boolean;
+    loading?: boolean;
+    retryable?: boolean;
+    registry?: RendererRegistry;
+    tableSort?: TableSortState | null;
+    tablePage?: number;
+    pivotView?: PivotViewState;
+    capture?: boolean;
+    embedded?: boolean;
+    /**
+     * True when a host frame already draws the card around the renderer, so the
+     * renderer keeps only its inner padding and draws no border, shadow, radius
+     * or background of its own.
+     */
+    framed?: boolean;
+    /**
+     * False when no host exporter can write Excel files, so renderers hide
+     * their Excel button and keep CSV.
+     */
+    excelExport?: boolean;
+}
+interface RendererExtensionInput {
+    widget: WidgetSpec;
+    result: WidgetResult;
+    frame: RendererFrame;
+    context: RendererContext;
+}
+type RendererExtension = (input: RendererExtensionInput) => unknown;
+interface RendererRegistry {
+    register(name: string, renderer: RendererExtension): void;
+    unregister(name: string): void;
+    get(name: string): RendererExtension | undefined;
+}
+
+/**
+ * The authoring side of the transport seam.
+ *
+ * Same rule as the reader: no fetch, no URL and no host client is written
+ * inside the package, and every call carries the scope it acts on rather than
+ * reading one from an ambient session. Nothing here returns a host database
+ * model: a widget arrives as its YAML text and a preview as plain rows.
+ */
+interface WidgetDocumentRequest {
+    dashboardId: string;
+    widgetId: string;
+    signal?: AbortSignal;
+}
+interface WidgetDocument {
+    widgetId: string;
+    specYaml: string;
+}
+interface WidgetSaveRequest {
+    dashboardId: string;
+    widgetId: string;
+    specYaml: string;
+}
+interface WidgetCreateRequest {
+    dashboardId: string;
+    specYaml: string;
+}
+interface WidgetDeleteRequest {
+    dashboardId: string;
+    widgetId: string;
+}
+interface DashboardDocumentRequest {
+    dashboardId: string;
+    signal?: AbortSignal;
+}
+/** The dashboard document as YAML text, which is all the YAML editor needs. */
+interface DashboardDocument {
+    dashboardId: string;
+    specYaml: string;
+    /** The version stamp the host uses for optimistic concurrency, if it has one. */
+    updatedAt?: string;
+}
+interface DashboardDocumentSaveRequest {
+    dashboardId: string;
+    specYaml: string;
+    expectedUpdatedAt?: string;
+}
+/** Name and description edits made inline on the page header. */
+interface DashboardMetadataSaveRequest {
+    dashboardId: string;
+    name?: string;
+    description?: string;
+}
+interface DashboardCopyRequest {
+    dashboardId: string;
+    name?: string;
+}
+interface DashboardCopyResponse {
+    /** How the host addresses the copy, so the page can navigate to it. */
+    dashboardId: string;
+}
+interface WidgetInventoryRequest {
+    dashboardId: string;
+    signal?: AbortSignal;
+}
+interface WidgetInventoryResponse {
+    widgets: Record<string, WidgetSpec>;
+    /** Widgets belonging to the dashboard that no tab places on its grid. */
+    unplacedWidgetIds: string[];
+}
+interface WidgetDiagnosticsRequest {
+    dashboardId: string;
+    widgetId: string;
+    filters?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+/** One query a widget ran, as the engine reports it. */
+interface WidgetQueryDiagnostic {
+    kind: string;
+    sql: string;
+    params: Record<string, unknown>;
+    dataStoreId: string | null;
+    filterField: string | null;
+    /** The scope the query was narrowed to, or null when it was not narrowed. */
+    effectiveLocations: string[] | null;
+    note?: string;
+    returnedColumns?: string[];
+    rowCount?: number;
+    cache?: string;
+    cacheTtlSeconds?: number;
+}
+interface WidgetMappingDiagnostic {
+    rowCount: number;
+    availableColumns: string[];
+    mappedFields: Record<string, string>;
+    issues: string[];
+}
+interface WidgetDiagnosticsResponse {
+    widgetId: string;
+    component: string;
+    queries: WidgetQueryDiagnostic[];
+    mapping?: WidgetMappingDiagnostic;
+    notes?: string[];
+    error?: string;
+}
+interface ModelLoadRequest {
+    signal?: AbortSignal;
+}
+interface ModelDocument {
+    specYaml: string;
+    version: number | null;
+    /** False when the caller may read the model but not write it. */
+    editable: boolean;
+}
+interface ModelSaveRequest {
+    specYaml: string;
+    note?: string;
+}
+interface ModelValidateRequest {
+    specYaml: string;
+    signal?: AbortSignal;
+}
+interface ModelVersionSummary {
+    version: number;
+    createdAt: string;
+    sizeBytes: number;
+    datasetCount: number;
+    note: string | null;
+    /** True when this version is exactly what the model says now. */
+    isCurrent: boolean;
+}
+interface ModelVersionRequest {
+    version: number;
+    signal?: AbortSignal;
+}
+interface ModelVersionRestoreRequest {
+    version: number;
+    note?: string;
+}
+/** A warehouse connection the host offers, named without exposing its record. */
+interface DataModelConnection {
+    id: string;
+    label: string;
+    vendor: string | null;
+}
+interface WarehouseColumn {
+    name: string;
+    dataType: string;
+}
+interface WarehouseTable {
+    schemaName: string;
+    tableName: string;
+    tableType: string;
+    columns: WarehouseColumn[];
+}
+interface WarehouseSchemaRequest {
+    connectionId: string | null;
+    signal?: AbortSignal;
+}
+interface DatasetPreviewRequest {
+    /** The model text as it stands in the editor, saved or not. */
+    specYaml: string;
+    datasetId: string;
+    limit: number;
+    columns?: string[];
+    signal?: AbortSignal;
+}
+interface DatasetPreviewResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    /** The scope the preview ran under, or null when it was not narrowed. */
+    effectiveLocations: string[] | null;
+    sql: string | null;
+}
+/** A change an assistant proposes, which an author reads before applying it. */
+interface AuthoringProposal {
+    id: string;
+    summary: string;
+    specYaml: string;
+}
+interface ProposalRequest {
+    dashboardId: string;
+    widgetId: string | null;
+    instruction: string;
+    specYaml: string;
+    signal?: AbortSignal;
+}
+interface ProposalOutcomeRequest {
+    proposalId: string;
+    applied: boolean;
+}
+interface LayoutWidgetRequest {
+    dashboardId: string;
+    widgetId: string;
+}
+interface AuthoringTransport {
+    loadWidgetDocument: (request: WidgetDocumentRequest) => Promise<WidgetDocument>;
+    saveWidget: (request: WidgetSaveRequest) => Promise<void>;
+    createWidget: (request: WidgetCreateRequest) => Promise<WidgetDocument>;
+    deleteWidget: (request: WidgetDeleteRequest) => Promise<void>;
+    listWidgets: (request: WidgetInventoryRequest) => Promise<WidgetInventoryResponse>;
+    diagnoseWidget: (request: WidgetDiagnosticsRequest) => Promise<WidgetDiagnosticsResponse>;
+    loadModel: (request: ModelLoadRequest) => Promise<ModelDocument>;
+    saveModel: (request: ModelSaveRequest) => Promise<ModelDocument>;
+    validateModel: (request: ModelValidateRequest) => Promise<DashboardModelDiagnostics>;
+    listModelVersions: (request: {
+        signal?: AbortSignal;
+    }) => Promise<ModelVersionSummary[]>;
+    loadModelVersion: (request: ModelVersionRequest) => Promise<ModelDocument>;
+    restoreModelVersion: (request: ModelVersionRestoreRequest) => Promise<ModelDocument>;
+    listConnections: (request: {
+        signal?: AbortSignal;
+    }) => Promise<DataModelConnection[]>;
+    listWarehouseTables: (request: WarehouseSchemaRequest) => Promise<WarehouseTable[]>;
+    previewDataset: (request: DatasetPreviewRequest) => Promise<DatasetPreviewResult>;
+    /** Places an existing widget on the dashboard grid. */
+    addWidgetToLayout: (request: LayoutWidgetRequest) => Promise<void>;
+    /** Takes a widget off the grid without deleting the widget itself. */
+    removeWidgetFromLayout: (request: LayoutWidgetRequest) => Promise<void>;
+    /** Optional: the dashboard document itself, for the dashboard YAML editor. */
+    loadDashboardDocument?: (request: DashboardDocumentRequest) => Promise<DashboardDocument>;
+    saveDashboardDocument?: (request: DashboardDocumentSaveRequest) => Promise<DashboardDocument>;
+    /** Optional: inline rename and description edits on the page header. */
+    saveDashboardMetadata?: (request: DashboardMetadataSaveRequest) => Promise<void>;
+    /** Optional: Make a copy. */
+    copyDashboard?: (request: DashboardCopyRequest) => Promise<DashboardCopyResponse>;
+    /** Optional: an assistant that writes a document from a sentence. */
+    proposeDocument?: (request: ProposalRequest) => Promise<AuthoringProposal>;
+    /** Optional: tells the host whether a proposal was kept. */
+    recordProposalOutcome?: (request: ProposalOutcomeRequest) => Promise<void>;
+}
+interface CodeEditorProps {
+    value: string;
+    onChange: (value: string) => void;
+    language: "yaml";
+    readOnly?: boolean | undefined;
+    markers?: ModelMarker[] | undefined;
+    ariaLabel?: string | undefined;
+    className?: string | undefined;
+}
+/**
+ * The editor seam. A host passes Monaco, CodeMirror or anything else, and the
+ * package falls back to a plain textarea, so no editor is bundled here.
+ */
+type CodeEditor = ComponentType<CodeEditorProps>;
+
+/**
+ * Every glyph the reader and builder draw. `defaultIcons` covers them all with
+ * inline SVG; a host maps any subset onto its own icon library and the rest
+ * fall back to the built-in glyphs.
+ */
+type IconName = "activity" | "alert" | "arrowDown" | "arrowLeft" | "arrowUp" | "arrowUpDown" | "building" | "calendar" | "check" | "chevronDown" | "chevronLeft" | "chevronRight" | "close" | "code" | "copy" | "download" | "expand" | "eye" | "filter" | "grip" | "help" | "info" | "layers" | "loader" | "lock" | "minus" | "more" | "plus" | "refresh" | "save" | "search" | "settings" | "share" | "sliders" | "sparkles" | "spreadsheet" | "trash" | "trendDown" | "trendFlat" | "trendUp" | "undo" | "users";
+interface IconProps {
+    className?: string | undefined;
+    title?: string | undefined;
+}
+type IconSet = Record<IconName, ComponentType<IconProps>>;
+interface UiButtonProps {
+    children?: ReactNode;
+    className?: string | undefined;
+    disabled?: boolean | undefined;
+    onClick?: (() => void) | undefined;
+    title?: string | undefined;
+    ariaLabel?: string | undefined;
+    variant?: "primary" | "secondary" | "ghost" | "link" | undefined;
+    size?: "sm" | "md" | undefined;
+    type?: "button" | "submit" | undefined;
+}
+interface UiTooltipProps {
+    label: ReactNode;
+    children: ReactNode;
+    side?: "top" | "bottom" | "left" | "right" | undefined;
+}
+interface UiPopoverProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    trigger: ReactNode;
+    children: ReactNode;
+    align?: "start" | "center" | "end" | undefined;
+    className?: string | undefined;
+}
+interface UiModalProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: ReactNode;
+    description?: ReactNode;
+    /** Replaces the plain title row, for a modal that carries its own navigation. */
+    header?: ReactNode;
+    footer?: ReactNode;
+    children: ReactNode;
+    size?: "md" | "lg" | "xl" | undefined;
+}
+interface UiSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean | undefined;
+}
+interface UiSelectProps {
+    value: string;
+    options: UiSelectOption[];
+    onChange: (value: string) => void;
+    placeholder?: string | undefined;
+    disabled?: boolean | undefined;
+    ariaLabel?: string | undefined;
+    className?: string | undefined;
+}
+interface UiTextInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string | undefined;
+    disabled?: boolean | undefined;
+    ariaLabel?: string | undefined;
+    className?: string | undefined;
+    type?: "text" | "number" | "date" | "search" | undefined;
+    onCommit?: (() => void) | undefined;
+}
+interface UiCheckboxProps {
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+    label: ReactNode;
+    disabled?: boolean | undefined;
+    className?: string | undefined;
+}
+interface UiBadgeProps {
+    children: ReactNode;
+    tone?: "neutral" | "info" | "success" | "warning" | "danger" | undefined;
+    className?: string | undefined;
+    title?: string | undefined;
+}
+interface UiSkeletonProps {
+    className?: string | undefined;
+    style?: CSSProperties | undefined;
+}
+interface UiMenuItem {
+    id: string;
+    label: string;
+    icon?: IconName | undefined;
+    disabled?: boolean | undefined;
+    onSelect: () => void;
+}
+interface UiMenuProps {
+    items: UiMenuItem[];
+    trigger: ReactNode;
+    ariaLabel?: string | undefined;
+}
+/**
+ * The design system seam. A host passes its own primitives, so the reader runs
+ * unchanged on shadcn, on Material, or on the plain elements the reference host
+ * uses to prove the package carries no design system of its own.
+ */
+interface UiKit {
+    Badge: ComponentType<UiBadgeProps>;
+    Button: ComponentType<UiButtonProps>;
+    Checkbox: ComponentType<UiCheckboxProps>;
+    Menu: ComponentType<UiMenuProps>;
+    Modal: ComponentType<UiModalProps>;
+    Popover: ComponentType<UiPopoverProps>;
+    Select: ComponentType<UiSelectProps>;
+    Skeleton: ComponentType<UiSkeletonProps>;
+    TextInput: ComponentType<UiTextInputProps>;
+    Tooltip: ComponentType<UiTooltipProps>;
+}
+interface AssetResolver {
+    /** Turns a stored image reference into something an img tag can load. */
+    resolve: (reference: string) => string;
+}
+interface HostLinkProps {
+    href: string;
+    children: ReactNode;
+    className?: string | undefined;
+    target?: "_blank" | "_self" | undefined;
+    onNavigate?: (() => void) | undefined;
+}
+interface HostLinks {
+    Link: ComponentType<HostLinkProps>;
+    /** The route the reader currently sits on, when the host tracks one. */
+    currentHref?: string | undefined;
+    navigate?: (href: string, options?: {
+        newTab?: boolean;
+        params?: Record<string, unknown>;
+    }) => void;
+}
+interface Notice {
+    tone: "info" | "success" | "warning" | "error";
+    message: string;
+    detail?: string;
+}
+type NoticeSink = (notice: Notice) => void;
+interface DashboardRunRequest {
+    dashboardId: string;
+    filters?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+interface DashboardRunResponse {
+    results: Record<string, WidgetResult>;
+    /** Present when the caller did not already hold the specs, as a drill does. */
+    dashboard: DashboardSpec;
+    widgets: Record<string, WidgetSpec>;
+    name?: string;
+    errors?: Record<string, string>;
+}
+interface WidgetRunRequest {
+    dashboardId: string;
+    widgetId: string;
+    filters?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+interface WidgetDetailRequest extends WidgetRunRequest {
+    /** The clicked cell, named by the labels the pivot printed. */
+    cell: Record<string, string>;
+    label?: string;
+    limit?: number;
+}
+interface DrillRunRequest {
+    dashboardId: string;
+    widgetId: string;
+    interaction: WidgetInteraction;
+    context: WidgetInteractionContext;
+    filters?: Record<string, unknown>;
+    signal?: AbortSignal;
+}
+interface DrillRunResponse {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    truncated?: boolean;
+}
+interface LayoutSaveRequest {
+    dashboardId: string;
+    /** Positions per breakpoint key (`lg`, `md`, `sm`, `xs`, `xxs`). */
+    layouts: ResponsiveLayouts;
+    /** Row height and column overrides per breakpoint, when the author changed them. */
+    gridOverrides?: Partial<Record<Breakpoint, {
+        rowHeight?: number;
+        cols?: number;
+    }>>;
+    /** Widgets kept off the grid without being deleted. */
+    unplacedWidgetIds?: string[];
+    /** The row limit after any Add rows the author clicked. */
+    maxRows?: number;
+    /** A breakpoint name that caps the dashboard width, or `null` to lift the cap. */
+    maxLayoutWidth?: string | null;
+    /** Dashboard level grid behaviour the author toggled in the Grid popover. */
+    grid?: {
+        isBounded?: boolean;
+        preventCollision?: boolean;
+    };
+    /** The data store widgets query by default, or `null` for the host default. */
+    dataModelId?: string | null;
+    /**
+     * The dashboard's `updatedAt` when editing began. A host that supports
+     * optimistic concurrency rejects the save with `LayoutConflictError` when a
+     * newer version exists.
+     */
+    expectedUpdatedAt?: string;
+    signal?: AbortSignal;
+}
+interface LayoutSaveResponse {
+    /** The dashboard's version stamp after the save, for the next request. */
+    updatedAt?: string;
+}
+/**
+ * The only way the reader reaches a server. No fetch, no server action and no
+ * URL is written inside the package.
+ */
+interface DashboardTransport {
+    runDashboard: (request: DashboardRunRequest) => Promise<DashboardRunResponse>;
+    runWidget: (request: WidgetRunRequest) => Promise<WidgetResult>;
+    runWidgetDetail?: (request: WidgetDetailRequest) => Promise<PivotDetailResult>;
+    runDrill?: (request: DrillRunRequest) => Promise<DrillRunResponse>;
+    saveLayout?: (request: LayoutSaveRequest) => Promise<LayoutSaveResponse | void>;
+}
+/**
+ * Structural copy of the lifecycle the browser renderer packages return. It is
+ * declared here rather than imported so the React package keeps its dependency
+ * on the concrete renderers optional and host owned.
+ */
+interface ReaderRenderer {
+    update: (input: RendererMountInput) => void;
+    resize: () => void;
+    destroy: () => void;
+}
+interface RendererMountCallbacks {
+    onInteraction?: (interaction: WidgetInteraction, context: WidgetInteractionContext) => void;
+    onRetry?: () => void;
+    onFilterChange?: (widgetId: string, value: unknown) => void;
+    onFilterLabelChange?: (widgetId: string, label: string) => void;
+    onError?: (error: Error) => void;
+    onPivotDetail?: (payload: PivotDetailPayload) => void;
+    onPivotView?: (widgetId: string, view: Record<string, unknown>) => void;
+    onExport?: (request: RendererExportRequest$1) => void | Promise<void>;
+}
+/** A CSV or Excel export a concrete renderer's toolbar asked the reader for. */
+interface RendererExportRequest$1 {
+    widgetId: string;
+    format: "csv" | "excel";
+    filename: string;
+}
+/**
+ * A pivot cell a reader asked to see behind, exactly as the concrete pivot
+ * renderer raises it: the cell is named by the dimension labels the pivot
+ * printed, because the labels are all the browser holds.
+ */
+interface PivotDetailPayload {
+    widgetId: string;
+    /** The clicked cell in words, which titles the detail modal. */
+    label: string;
+    filters: Record<string, string>;
+}
+interface RendererMountInput {
+    element: HTMLElement;
+    widget: WidgetSpec;
+    result?: WidgetResult;
+    context?: RendererContext;
+    filterValue?: unknown;
+    callbacks?: RendererMountCallbacks;
+    theme?: Record<string, unknown>;
+}
+type RendererFactory = (input: RendererMountInput) => ReaderRenderer | Promise<ReaderRenderer>;
+/**
+ * Renderer factories keyed by widget component. Hosts wire the phase 8 packages
+ * here: createEChartsRenderer for charts, createTabulatorRenderer for grids,
+ * createRevoGridRenderer for pivots, createNativeWidgetRenderer for the rest.
+ */
+type RendererFactories = Partial<Record<string, RendererFactory>> & {
+    default?: RendererFactory;
+};
+
+/**
+ * The dashboard management seam: listing, creating, describing, sharing and
+ * exporting dashboards. The reader and builder never touch it; the ready-made
+ * list page, workspace toolbar, share dialog and export menu do.
+ *
+ * Who may see what is the host's decision, made on the server. This port only
+ * carries the answer: a `DashboardSummary` already says what the caller may do
+ * with it, and the share dialog offers whatever principals `searchPrincipals`
+ * returns, or a typed identifier when the host offers no lookup.
+ */
+/** Who the dashboard is visible to. Hosts may add their own values. */
+type DashboardVisibility = "personal" | "shared" | "org" | string;
+interface DashboardSummary {
+    dashboardId: string;
+    name: string;
+    description: string | null;
+    visibility: DashboardVisibility;
+    /** The owner as the host names them, for the list cards. */
+    ownerName: string | null;
+    /** The caller's permission as the host names it, for example `owner`, `edit`, `view`. */
+    permission: string;
+    canRead: boolean;
+    canWrite: boolean;
+    isOwner: boolean;
+    sharedWithCount: number;
+    updatedAt: string | null;
+}
+interface DashboardShare {
+    principalId: string;
+    permission: string;
+    displayName: string | null;
+}
+interface DashboardDetail extends DashboardSummary {
+    /** Empty unless the caller is the owner. */
+    shares: DashboardShare[];
+    /** Whether the caller may publish this dashboard to the organisation. */
+    canPublish: boolean;
+}
+/** Someone or something a dashboard may be shared with. */
+interface Principal {
+    principalId: string;
+    displayName: string;
+    /** A qualifier for the picker, for example a role or team name. */
+    detail?: string | undefined;
+}
+interface ShareGrant {
+    principalId: string;
+    permission: string;
+}
+interface ReportFormat {
+    format: string;
+    label: string;
+    mimeType: string;
+}
+interface DownloadedReport {
+    filename: string;
+    format: string;
+    mimeType: string;
+    blob: Blob;
+}
+interface DashboardManagementTransport {
+    listDashboards: (input: {
+        signal?: AbortSignal | undefined;
+    }) => Promise<DashboardSummary[]>;
+    loadDashboard: (input: {
+        dashboardId: string;
+        signal?: AbortSignal | undefined;
+    }) => Promise<DashboardDetail>;
+    /** Absent when the caller may not create dashboards; the list hides the button. */
+    createDashboard?: (input: {
+        name: string;
+        description: string | null;
+        /** A preferred identifier; the host may grant another and return it. */
+        dashboardId?: string | undefined;
+        specYaml?: string | undefined;
+        visibility?: DashboardVisibility | undefined;
+    }) => Promise<DashboardSummary>;
+    deleteDashboard?: (input: {
+        dashboardId: string;
+    }) => Promise<void>;
+    replaceShares?: (input: {
+        dashboardId: string;
+        grants: ShareGrant[];
+    }) => Promise<DashboardDetail>;
+    revokeShare?: (input: {
+        dashboardId: string;
+        principalId: string;
+    }) => Promise<DashboardDetail>;
+    setVisibility?: (input: {
+        dashboardId: string;
+        visibility: DashboardVisibility;
+    }) => Promise<DashboardDetail>;
+    /** People and roles a dashboard may be shared with; without it the share dialog takes a typed identifier. */
+    searchPrincipals?: (input: {
+        query: string;
+        signal?: AbortSignal | undefined;
+    }) => Promise<Principal[]>;
+    /** The export menu appears only when both report methods exist. */
+    listReportFormats?: (input: {
+        signal?: AbortSignal | undefined;
+    }) => Promise<ReportFormat[]>;
+    downloadReport?: (input: {
+        dashboardId: string;
+        format: string;
+        filters: Record<string, unknown>;
+    }) => Promise<DownloadedReport>;
+}
+
+type AssistantIntent = "create" | "edit";
+interface DashboardWorkspaceProps {
+    dashboardId: string;
+    /** The reader's data client. */
+    transport: DashboardTransport;
+    /** Without it the page is read only: no edit mode, editors or inventory. */
+    authoringTransport?: AuthoringTransport | undefined;
+    /** Detail, sharing and exports. */
+    management: DashboardManagementTransport;
+    ui?: Partial<UiKit> | undefined;
+    icons?: Partial<IconSet> | undefined;
+    renderers?: RendererFactories | undefined;
+    links?: HostLinks | undefined;
+    assets?: AssetResolver | undefined;
+    editor?: CodeEditor | undefined;
+    /** Shows the Semantic model button in edit mode. */
+    canEditModel?: boolean | undefined;
+    /** Opens in edit mode when the caller may write, for a freshly created dashboard. */
+    startInEditMode?: boolean | undefined;
+    filters?: Record<string, unknown> | undefined;
+    onFiltersChange?: ((filters: Record<string, unknown>) => void) | undefined;
+    /** Where unsaved drafts survive a reload; defaults to localStorage, null keeps them in memory. */
+    storage?: Pick<Storage, "getItem" | "setItem" | "removeItem"> | null | undefined;
+    /** The Dashboards button; hidden when the host gives no way back. */
+    onBack?: (() => void) | undefined;
+    /** Runs after Make a copy with the new identifier. */
+    onOpenDashboard?: ((dashboardId: string) => void) | undefined;
+    /** Create with AI and Edit with AI; hidden when the host has no assistant. */
+    onAssistant?: ((intent: AssistantIntent, dashboardId: string) => void) | undefined;
+    /** Notices also reach the host, for its own toasts or logs. */
+    onNotice?: NoticeSink | undefined;
+    /** Host buttons placed at the end of the toolbar, a Schedule button for example. */
+    toolbarExtra?: ReactNode;
+    className?: string | undefined;
+}
+
+interface DashboardShelf {
+    /** Whether a dashboard sits on this shelf; the first shelf that holds it wins. */
+    holds: (item: DashboardSummary) => boolean;
+    title: string;
+    blurb?: string | undefined;
+}
+interface DashboardListProps {
+    management: DashboardManagementTransport;
+    /** Opens a dashboard; `editing` is set for a dashboard just created. */
+    onOpen: (dashboardId: string, options: {
+        editing: boolean;
+    }) => void;
+    ui?: Partial<UiKit> | undefined;
+    icons?: Partial<IconSet> | undefined;
+    shelves?: readonly DashboardShelf[] | undefined;
+    title?: string | undefined;
+    description?: string | undefined;
+    /** Extra header actions beside New dashboard. */
+    actions?: ReactNode;
+    /** The visibility a new dashboard starts with. */
+    newVisibility?: string | undefined;
+    className?: string | undefined;
+}
+
+interface BrowserRenderer<TInput> {
+    update(input: TInput): void;
+    resize(): void;
+    destroy(): void;
+}
+interface RendererThemeTokens {
+    foreground: string;
+    mutedForeground: string;
+    border: string;
+    surface: string;
+    surfaceForeground: string;
+    primary: string;
+    secondary: string;
+    danger: string;
+    fontFamily: string;
+    seriesColors: string[];
+    heatmapColors: string[];
+}
+interface RendererExtensionMount {
+    element: HTMLElement;
+    model: Extract<BasicRendererModel, {
+        kind: "extension";
+    }>;
+}
+interface RendererExportRequest {
+    widgetId: string;
+    format: "csv" | "excel";
+    filename: string;
+}
+interface RendererPivotDetailRequest {
+    widgetId: string;
+    filters: Record<string, string>;
+    label: string;
+}
+interface RendererHostCallbacks {
+    onInteraction?: (interaction: WidgetInteraction, context: WidgetInteractionContext) => void;
+    onFilterChange?: (widgetId: string, value: unknown) => void;
+    onFilterLabelChange?: (widgetId: string, label: string) => void;
+    onExport?: (request: RendererExportRequest) => void | Promise<void>;
+    onPivotViewChange?: (widgetId: string, view: PivotViewState) => void;
+    onPivotDetail?: (request: RendererPivotDetailRequest) => void | Promise<void>;
+    onRetry?: () => void;
+    onError?: (error: Error) => void;
+    renderExtension?: (input: RendererExtensionMount) => BrowserRenderer<RendererExtensionMount> | void;
+}
+interface NativeWidgetRenderInput {
+    element: HTMLElement;
+    widget: WidgetSpec;
+    result?: WidgetResult;
+    context?: RendererContext;
+    filterValue?: unknown;
+    callbacks?: RendererHostCallbacks;
+    theme?: Partial<RendererThemeTokens>;
+}
+/**
+ * One widget renderer, whatever library draws it. A shell mounts a widget by
+ * asking a factory for this handle, then updates it as results and filters
+ * change, and destroys it on unmount.
+ */
+type WidgetRendererHandle = BrowserRenderer<NativeWidgetRenderInput>;
+type WidgetRendererFactory = (input: NativeWidgetRenderInput) => WidgetRendererHandle | Promise<WidgetRendererHandle>;
+/**
+ * Factories keyed by widget component, with a fallback for every component the
+ * host did not name. A host wires the concrete renderer packages here, so no
+ * shell carries a charting or grid dependency of its own.
+ */
+type WidgetRendererFactories = Partial<Record<string, WidgetRendererFactory>> & {
+    default?: WidgetRendererFactory;
+};
+
+/**
+ * A theme is either fixed tokens or a function of the mount element, which is
+ * how a host reads its CSS custom properties live so dark mode and brand
+ * changes reach the charts and grids.
+ */
+type RendererThemeSource = Partial<RendererThemeTokens> | ((element: HTMLElement) => Partial<RendererThemeTokens>);
+interface DefaultRenderersOptions {
+    readonly theme?: RendererThemeSource;
+    /** Extra or replacement factories, merged over the defaults by component name. */
+    readonly overrides?: WidgetRendererFactories;
+}
+
+interface HttpTransportOptions {
+    /** The dashboards prefix, for example `/api/custom-dashboards`. */
+    readonly baseUrl: string;
+    /** The authoring prefix; defaults to `${baseUrl}/authoring`. */
+    readonly authoringUrl?: string;
+    /** Defaults to the global `fetch`. */
+    readonly fetch?: typeof fetch;
+    /**
+     * Last word on every request: add an Authorization header, a tenant query
+     * parameter, credentials, whatever the host's API expects.
+     */
+    readonly prepare?: (url: string, init: RequestInit) => RequestInit | void;
+    /** Extra query parameters appended to every URL, for example `{ person }`. */
+    readonly query?: Readonly<Record<string, string>>;
+}
+interface HttpManagementOptions extends HttpTransportOptions {
+    /** The reports prefix; defaults to `${baseUrl}/reports`. */
+    readonly reportsUrl?: string;
+    /** Route groups the host serves; the matching optional methods are omitted otherwise. */
+    readonly features?: {
+        /** `DELETE {baseUrl}/{id}`. */
+        readonly delete?: boolean;
+        /** `GET {baseUrl}/principals?q=`. */
+        readonly principals?: boolean;
+        /** `GET {reportsUrl}/formats` and `POST {reportsUrl}/{id}/{format}`. */
+        readonly reports?: boolean;
+    };
+}
+
+/** How the component reaches the host's API when no transport is given. */
+interface BideuxHttpOptions extends HttpManagementOptions {
+    /** Set to false for a read only page that never builds an authoring transport. */
+    readonly authoring?: boolean;
+}
+type WorkspaceRest = Omit<DashboardWorkspaceProps, "transport" | "authoringTransport" | "management" | "renderers">;
+interface BideuxDashboardProps extends WorkspaceRest {
+    /** The dashboards prefix, for example `/api/custom-dashboards`; the transports are built from it. */
+    baseUrl?: string | undefined;
+    /** Everything about the HTTP client: fetch, prepare, query, reports URL, features. */
+    http?: Omit<BideuxHttpOptions, "baseUrl"> | undefined;
+    /** Custom clients; each one given replaces the HTTP one for that role. */
+    transport?: DashboardTransport | undefined;
+    authoringTransport?: AuthoringTransport | undefined;
+    management?: DashboardManagementTransport | undefined;
+    /** Widget renderers; defaults to ECharts, Tabulator, RevoGrid and the DOM renderer. */
+    renderers?: DashboardWorkspaceProps["renderers"];
+    /** Theme and overrides for the default renderers when `renderers` is not given. */
+    rendererOptions?: DefaultRenderersOptions | undefined;
+}
+interface BideuxDashboardListProps extends Omit<DashboardListProps, "management"> {
+    baseUrl?: string | undefined;
+    http?: Omit<HttpManagementOptions, "baseUrl"> | undefined;
+    management?: DashboardManagementTransport | undefined;
+}
+
+type Filters = Record<string, unknown>;
+type Prepare = NonNullable<BideuxHttpOptions["prepare"]>;
+/** Shared by both elements: a React root, attribute reads and re-render on change. */
+declare abstract class BideuxElement extends HTMLElement {
+    #private;
+    /** Last word on every request; set as a property, or use `bearer-token`. */
+    prepare: Prepare | undefined;
+    /** Replaces the global fetch. */
+    fetch: typeof globalThis.fetch | undefined;
+    /** Host UI controls and icons; a partial set merges with the built-in ones. */
+    ui: Partial<UiKit> | undefined;
+    icons: Partial<IconSet> | undefined;
+    /** A custom management client; wins over `base-url`. */
+    management: DashboardManagementTransport | undefined;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(): void;
+    /** Re-render after a property change; attribute changes call it for you. */
+    requestRender(): void;
+    protected emit<T>(type: string, detail: T): void;
+    protected text(name: string): string | undefined;
+    protected flag(name: string): boolean;
+    protected http(): Omit<HttpManagementOptions, "baseUrl">;
+    protected abstract render(): ReactNode;
+}
+declare class BideuxDashboardElement extends BideuxElement {
+    #private;
+    static get observedAttributes(): readonly string[];
+    /** Custom clients; each one given replaces the HTTP one built from `base-url`. */
+    transport: DashboardTransport | undefined;
+    authoringTransport: AuthoringTransport | undefined;
+    rendererOptions: DefaultRenderersOptions | undefined;
+    renderers: BideuxDashboardProps["renderers"];
+    links: BideuxDashboardProps["links"];
+    assets: BideuxDashboardProps["assets"];
+    editor: BideuxDashboardProps["editor"];
+    storage: BideuxDashboardProps["storage"];
+    /** The applied filters; setting it re-renders, the `filters` attribute is the JSON form. */
+    get filters(): Filters | undefined;
+    set filters(value: Filters | undefined);
+    protected render(): ReactNode;
+}
+declare class BideuxDashboardListElement extends BideuxElement {
+    static get observedAttributes(): readonly string[];
+    shelves: BideuxDashboardListProps["shelves"];
+    protected render(): ReactNode;
+}
+/** Registers both tags once; importing this module calls it in a browser. */
+declare function defineBideuxElements(names?: {
+    dashboard?: string;
+    list?: string;
+}): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        "bideux-dashboard": BideuxDashboardElement;
+        "bideux-dashboard-list": BideuxDashboardListElement;
+    }
+}
+
+export { BideuxDashboardElement, BideuxDashboardListElement, defineBideuxElements };