@dlh.io/bideux 0.1.0

package/dist/result-table-CPls-277.d.ts

@@ -0,0 +1,1885 @@
+import { Document } from 'yaml';
+import { aw as WidgetSpec$1, av as WidgetResult } from './types-CHFSsU_X.js';
+
+type Kind = "dashboard";
+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 Enabled = boolean;
+type Icon1 = string;
+type Showinembed = boolean;
+type Showinlayout = boolean;
+type Showinpreview = boolean;
+type Ttlseconds = number | null;
+type Datamodelid = string | null;
+type Background = 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 = 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 = 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[] | null;
+type Kind1 = "widget";
+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 = KpiDataSource | StaticDataSource | DemoDataSource | SqlDataSource | DatasetDataSource | QueryDataSource;
+type DataModelId = string | null;
+type Kind2 = "kpi";
+type Kpi = string;
+type Labelcolumn = string | null;
+type JsonValue = unknown;
+type Valuecolumn = string | null;
+type Columns1 = string[] | null;
+type Kind3 = "static";
+type Label = string;
+type Options = StaticOption[];
+type Rows = {
+    [k: string]: JsonValue;
+}[];
+type Columns2 = string[] | null;
+type Dataset = string | null;
+type Kind4 = "demo";
+type Rows1 = number;
+type Seed = number;
+type DataModelId1 = string | null;
+type FilterField = string | null;
+type Kind5 = "sql";
+type Query = string;
+type Columns3 = 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 = IncomingFilter[];
+type Kind6 = "dataset";
+type Metrics = string[] | null;
+type DataModelId3 = string | null;
+type Kind7 = "query";
+type Query1 = string;
+type Background2 = 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 Padding4 = 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 Kind8 = "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;
+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;
+} | string | null;
+type CustomExtensions = {
+    [k: string]: JsonValue;
+}[] | 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;
+} | string | null;
+type Enabled1 = boolean;
+type TtlSeconds = number | null;
+type TtlSeconds1 = number | null;
+type CustomExtensions1 = {
+    [k: string]: JsonValue;
+}[] | 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;
+} | string | null;
+/**
+ * Warehouse column this dimension reads. Defaults to the id.
+ */
+type Column = string | null;
+type CustomExtensions2 = {
+    [k: string]: JsonValue;
+}[] | 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;
+} | string | null;
+type CustomExtensions3 = {
+    [k: string]: JsonValue;
+}[] | 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;
+} | string | null;
+type CustomExtensions4 = {
+    [k: string]: JsonValue;
+}[] | 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;
+}[] | null;
+type Limit = number | null;
+type Metrics4 = string[] | null;
+type Model = string | null;
+type Segments = string[] | null;
+type Sort = {
+    [k: string]: JsonValue;
+}[] | 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;
+} | string | null;
+type CustomExtensions5 = {
+    [k: string]: JsonValue;
+}[] | 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 | string)[];
+type Tabs = DashboardTab[];
+type Version3 = string;
+/**
+ * Top-level dashboard manifest.
+ */
+interface DashboardSpec {
+    kind?: Kind;
+    metadata: Metadata;
+    spec: DashboardSpecInner;
+    version?: Version3;
+    [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 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 | 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;
+    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;
+    dateSpan?: Datespan;
+    gap?: Gap1;
+    maxColumnWidth?: Maxcolumnwidth;
+    minColumnWidth?: Mincolumnwidth;
+    mode?: Mode;
+    padding?: Padding1;
+    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 {
+    kind?: Kind1;
+    metadata: Metadata;
+    spec: WidgetSpecInner;
+    version?: Version2;
+    [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?: Kind2;
+    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?: Columns1;
+    default_value?: {
+        [k: string]: unknown;
+    };
+    kind?: Kind3;
+    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?: Columns2;
+    dataset?: Dataset;
+    kind?: Kind4;
+    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?: Kind5;
+    params?: Params1;
+    query: Query;
+    [k: string]: unknown;
+}
+interface Params1 {
+    [k: string]: JsonValue;
+}
+/**
+ * Reference a reusable Dataset defined in the dashboard manifest.
+ */
+interface DatasetDataSource {
+    columns?: Columns3;
+    data_model_id?: DataModelId2;
+    dataset: Dataset1;
+    dimensions?: Dimensions;
+    filters?: Filters;
+    kind?: Kind6;
+    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?: Kind7;
+    params?: Params3;
+    query: Query1;
+    [k: string]: unknown;
+}
+interface Params3 {
+    [k: string]: JsonValue;
+}
+/**
+ * Display-specific configuration.
+ */
+interface WidgetDisplay {
+    background?: Background2;
+    border?: Border1;
+    borderRadius?: Borderradius1;
+    echarts?: Echarts;
+    filter?: Filter;
+    image?: Image;
+    kpi?: Kpi1;
+    margin?: Margin;
+    markdown?: Markdown;
+    padding?: Padding4;
+    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?: Kind8;
+    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;
+}
+/**
+ * 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 {
+    echarts?: WidgetTheme | null;
+    filter?: WidgetTheme | null;
+    global?: WidgetTheme | null;
+    image?: WidgetTheme | null;
+    kpi?: WidgetTheme | null;
+    markdown?: WidgetTheme | null;
+    pivot_table?: WidgetTheme | null;
+    select?: WidgetTheme | null;
+    table?: WidgetTheme | null;
+    tabulator?: WidgetTheme | null;
+    text?: WidgetTheme | null;
+    [k: string]: unknown;
+}
+/**
+ * Reusable theme settings for a widget or a default widget group.
+ */
+interface WidgetTheme {
+    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;
+}
+/**
+ * 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;
+}
+/**
+ * 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 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>;
+type PivotExpandEntry = number | {
+    rows?: number;
+    columns?: number;
+};
+interface DashboardPivotInfo {
+    id: string;
+    name: string;
+    row_levels: number;
+    column_levels: number;
+    default_expand: number | null;
+    default_expand_columns: number | null;
+}
+interface PivotOpenLevels {
+    rows: number | null;
+    columns: number | null;
+}
+type ReadPivotOpenLevels = (widgetId: string) => PivotOpenLevels | 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;
+}
+
+/**
+ * Read and edit the semantic model as a YAML document, not as an object.
+ *
+ * The Builder is a second way to edit one text, never a second source of truth.
+ * So every edit here goes through the `yaml` Document API and touches only the
+ * keys it is responsible for: comments, key order, quoting style and anything
+ * the Builder does not understand (mesh plans, `ai_context`, custom renderers)
+ * survive an edit untouched. That is what makes the Builder | YAML toggle safe
+ * in both directions.
+ */
+
+/** A data store as the Builder presents it: no UUID typed by hand. */
+interface BuilderDataStore {
+    id: string;
+    name: string | null;
+    vendor: string | null;
+    /** Host connection identifier, written from a dropdown choice. */
+    dataModelId: string | null;
+    isDefault: boolean;
+}
+type BuilderDimensionType = "string" | "number" | "date" | "time" | "boolean";
+interface BuilderDimension {
+    id: string;
+    column: string | null;
+    type: BuilderDimensionType;
+    isTime: boolean;
+}
+interface BuilderMetric {
+    id: string;
+    label: string | null;
+    /** SQL such as `SUM(NET_SALES)`, whether typed or built from a dropdown. */
+    expression: string;
+    type: "sql" | "formula";
+}
+interface BuilderRollup {
+    source: string | null;
+    grain: string[];
+    metrics: string[];
+}
+interface BuilderDataset {
+    id: string;
+    name: string | null;
+    dataStoreId: string | null;
+    source: string | null;
+    sourceType: string | null;
+    /** The column carrying the location key, which scoping needs. */
+    filterField: string | null;
+    dimensions: BuilderDimension[];
+    metrics: BuilderMetric[];
+    rollup: BuilderRollup | null;
+    /**
+     * Keys the Builder has no editor for. Non-empty means the dataset is shown
+     * read-only rather than being silently flattened on the next edit.
+     */
+    unsupportedKeys: string[];
+}
+type BuilderCardinality = "one_to_one" | "many_to_one" | "one_to_many" | "many_to_many";
+/** A join between two datasets, as a pair of dataset ids and column pairs. */
+interface BuilderRelationship {
+    name: string;
+    from: string | null;
+    to: string | null;
+    /** Positionally matched with `toColumns`, which is how the engine reads them. */
+    fromColumns: string[];
+    toColumns: string[];
+    cardinality: BuilderCardinality | null;
+    unsupportedKeys: string[];
+}
+/** A metric declared on the model rather than inside one dataset. */
+interface BuilderModelMetric {
+    id: string;
+    label: string | null;
+    description: string | null;
+    expression: string;
+    type: "sql" | "formula";
+    format: string | null;
+    unsupportedKeys: string[];
+}
+interface ModelParseError {
+    message: string;
+    line: number;
+}
+declare const AGGREGATIONS: readonly ["SUM", "AVG", "MIN", "MAX", "COUNT"];
+type Aggregation = (typeof AGGREGATIONS)[number];
+/** Types a warehouse column maps onto, so dimensions do not need typing by hand. */
+declare function dimensionTypeFor(warehouseType: string): BuilderDimensionType;
+/** `SUM(NET_SALES)` for a dropdown choice. */
+declare function aggregationExpression(aggregation: Aggregation, column: string): string;
+/**
+ * The aggregation and column behind a metric, when it is a plain one.
+ *
+ * Anything else (a ratio, a CASE, a window) returns null, and the Builder shows
+ * the raw expression instead of pretending a dropdown describes it.
+ */
+declare function parseAggregation(expression: string): {
+    aggregation: Aggregation;
+    column: string;
+} | null;
+/** The model as an editable document, or where its syntax error is. */
+declare function parseModelDocument(specYaml: string): {
+    doc: Document | null;
+    error: ModelParseError | null;
+};
+declare function readDataStores(doc: Document): BuilderDataStore[];
+/** The keys that really do stop the Builder editing this thing safely. */
+declare function blockingKeys(keys: string[]): string[];
+/** The keys kept as they are, which the Builder only needs to mention. */
+declare function preservedKeys(keys: string[]): string[];
+declare function readDatasets(doc: Document): BuilderDataset[];
+declare function readRelationships(doc: Document): BuilderRelationship[];
+declare function readModelMetrics(doc: Document): BuilderModelMetric[];
+/** The document back as text, byte for byte apart from the edits made. */
+declare function modelText(doc: Document): string;
+/**
+ * Write a data store, creating it when the id is new.
+ *
+ * `dataModelId` comes from the connection dropdown, so the operator picks
+ * "Restaurant Ops DW" and the UUID contract in the YAML is unchanged.
+ */
+declare function upsertDataStore(specYaml: string, store: BuilderDataStore, originalId?: string): string;
+declare function removeDataStore(specYaml: string, id: string): string;
+/**
+ * Write a dataset, creating it when the id is new.
+ *
+ * Only the keys the dataset editor owns are written. A dataset carrying a mesh
+ * plan or `ai_context` keeps them, because the Builder refuses to edit such a
+ * dataset in the first place rather than dropping what it cannot show.
+ */
+declare function upsertDataset(specYaml: string, dataset: BuilderDataset, originalId?: string): string;
+declare function removeDataset(specYaml: string, id: string): string;
+/**
+ * Write a relationship, creating it when the name is new.
+ *
+ * `from_columns` and `to_columns` are written as block sequences in the order
+ * the panel shows them, because the engine pairs them positionally.
+ */
+declare function upsertRelationship(specYaml: string, relationship: BuilderRelationship, originalName?: string): string;
+declare function removeRelationship(specYaml: string, name: string): string;
+/** Write a model level metric, creating it when the id is new. */
+declare function upsertModelMetric(specYaml: string, metric: BuilderModelMetric, originalId?: string): string;
+declare function removeModelMetric(specYaml: string, id: string): string;
+/** One side of a ratio: an aggregate over a column of a named dataset. */
+interface RatioSide {
+    dataset: string;
+    aggregation: Aggregation;
+    column: string;
+}
+/**
+ * The SQL for "labor cost as a share of net sales".
+ *
+ * Columns are qualified with the dataset id, which is the alias the engine gives
+ * each dataset in the join, and the denominator is wrapped in NULLIF so a day
+ * with no sales is null rather than a division error.
+ *
+ * The result is always a share, never percentage points: `format: percent`
+ * multiplies by 100 when the number is drawn, so scaling it here as well is how
+ * a labor percent of 13.3% was printed as 1,333%.
+ */
+declare function ratioExpression(numerator: RatioSide, denominator: RatioSide): string;
+/** The two sides behind a ratio, when the expression is one this wrote. */
+declare function parseRatioExpression(expression: string): {
+    numerator: RatioSide;
+    denominator: RatioSide;
+    /** True when the expression ends in `* 100`, written before or by hand. */
+    scaledBy100: boolean;
+} | null;
+/**
+ * True when a metric would print a hundred times too large.
+ *
+ * `format: percent` turns a share into a percentage, so an expression that has
+ * already multiplied by 100 is scaled twice.
+ */
+declare function isDoubleScaledPercent(expression: string, format: string | null | undefined): boolean;
+/** The YAML for one dataset, so a panel can show the text it produces. */
+declare function datasetFragment(specYaml: string, id: string): string;
+/** The YAML for one data store, for the same reason. */
+declare function dataStoreFragment(specYaml: string, id: string): string;
+/** The YAML for one relationship, keyed by name rather than id. */
+declare function relationshipFragment(specYaml: string, name: string): string;
+/** The YAML for one model level metric. */
+declare function modelMetricFragment(specYaml: string, id: string): string;
+/** Rows the rail needs: the model's shape at a glance, without parsing twice. */
+interface ModelOutline {
+    dataStores: BuilderDataStore[];
+    datasets: BuilderDataset[];
+    relationships: BuilderRelationship[];
+    modelMetrics: BuilderModelMetric[];
+    error: ModelParseError | null;
+}
+declare function readModelOutline(specYaml: string): ModelOutline;
+
+/**
+ * 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;
+}
+/** Where a collection entry is declared, 1-based. */
+interface NodePosition {
+    line: number;
+    column: number;
+    endLine: number;
+    endColumn: number;
+}
+/**
+ * Line of every `id` (or `name`, for relationships) under each top-level
+ * collection, keyed as `datasets:daily_sales`.
+ */
+declare function indexModelYaml(specYaml: string): Map<string, NodePosition>;
+/** Syntax errors from the YAML parser itself, so a typo marks instantly. */
+declare function yamlSyntaxMarkers(specYaml: string): ModelMarker[];
+/**
+ * Markers for one validation response, placed on the declaring line.
+ *
+ * Issues are errors, data store notes are informational: a store with no
+ * `data_model_id` resolves to the organisation's default and is not a problem.
+ */
+declare function diagnosticsToMarkers(specYaml: string, diagnostics: DashboardModelDiagnostics): ModelMarker[];
+/** How many of a validation response's findings are real problems. */
+declare function countModelIssues(diagnostics: DashboardModelDiagnostics): number;
+
+/**
+ * Read and edit a widget as a YAML document, not as an object.
+ *
+ * Same contract as the semantic model Builder: the widget Builder is a second
+ * way to edit one text, never a second source of truth. Every edit goes through
+ * the `yaml` Document API and touches only the keys the Builder owns, so
+ * comments, interactions, bindings, drilldowns and every ECharts option the
+ * Builder has no control for survive an edit untouched.
+ */
+
+/** Components the Builder has a form for. Anything else stays YAML only. */
+declare const BUILDER_COMPONENTS: readonly ["echarts", "table", "tabulator", "pivot_table", "kpi"];
+type BuilderComponent = (typeof BUILDER_COMPONENTS)[number];
+/** Every component a widget can be, so the Builder can switch to any of them. */
+declare const ALL_COMPONENTS: readonly ["echarts", "table", "tabulator", "pivot_table", "kpi", "text", "markdown", "image", "filter"];
+declare function isBuilderComponent(component: string): component is BuilderComponent;
+/** Chart shapes the renderer draws from a category and a value column. */
+declare const CHART_TYPES: readonly ["line", "bar", "area", "pie", "scatter"];
+type ChartType = (typeof CHART_TYPES)[number];
+/** One named line or bar, pointing at a column the query returns. */
+interface BuilderSeries {
+    name: string | null;
+    field: string;
+}
+/** Which column each part of the widget reads. */
+interface BuilderMappings {
+    x: string | null;
+    category: string | null;
+    value: string | null;
+    series: string | null;
+    /** The column a KPI compares its number against. */
+    delta: string | null;
+}
+/** How a KPI prints the change between its number and its comparison column. */
+declare const DELTA_FORMATS: readonly ["percent", "number", "currency"];
+type DeltaFormat = (typeof DELTA_FORMATS)[number];
+/** How a number is printed on a card. */
+declare const NUMBER_FORMATS: readonly ["number", "currency", "percent"];
+type NumberFormat = (typeof NUMBER_FORMATS)[number];
+/** Which way rows are ordered before they are drawn. */
+declare const SORT_ORDERS: readonly ["none", "asc", "desc"];
+type SortOrder = (typeof SORT_ORDERS)[number];
+/**
+ * How the widget reads, as opposed to what it reads.
+ *
+ * One flat block covering every component, because an author switching a KPI
+ * to a table should not lose the wording they set. Only the keys that belong
+ * to the current component are written, so the YAML never carries a table page
+ * size on a chart.
+ */
+interface BuilderAppearance {
+    /** Single number: how the figure is printed. */
+    format: NumberFormat;
+    /** Printed before the number, for example a currency symbol. */
+    prefix: string | null;
+    /** Printed after the number, for example hrs or pp. */
+    suffix: string | null;
+    /** Shorten large numbers, so 1240000 reads 1.24M. */
+    compact: boolean;
+    /** Fixed decimal places, or null for the format's own default. */
+    decimals: number | null;
+    /** Whether the caption sits above or below the figure. */
+    labelPosition: "top" | "bottom";
+    /** Chart: whether the legend is drawn. */
+    showLegend: boolean;
+    /** Chart: lay a bar chart on its side, which suits long category names. */
+    horizontal: boolean;
+    /** Chart: sort the points along the axis before drawing them. */
+    sortOrder: SortOrder;
+    /** Table: rows per page, or null to show them all. */
+    pageSize: number | null;
+    /** Table: whether a viewer can sort by clicking a heading. */
+    sortable: boolean;
+    /** Advanced table: collect rows under a heading per value of this column. */
+    groupBy: string | null;
+}
+/** How a pivot table totals one column of figures. */
+declare const PIVOT_AGGREGATIONS: readonly ["sum", "avg", "min", "max", "count", "count_distinct"];
+type PivotAggregation = (typeof PIVOT_AGGREGATIONS)[number];
+/** Whether the rows under a group carry a line of their own. */
+declare const PIVOT_SUBTOTALS: readonly ["collapsed", "expanded", "none"];
+type PivotSubtotals = (typeof PIVOT_SUBTOTALS)[number];
+/** Which way an ordering reads. */
+declare const PIVOT_DIRECTIONS: readonly ["asc", "desc"];
+type PivotDirection = (typeof PIVOT_DIRECTIONS)[number];
+/** One figure a pivot table computes at every intersection. */
+interface BuilderPivotMeasure {
+    field: string;
+    agg: PivotAggregation;
+    /** What the column is called, or null to use the metric's own label. */
+    label: string | null;
+    format: NumberFormat | null;
+    decimals: number | null;
+}
+/**
+ * How the cross-tab is laid out.
+ *
+ * Rows and columns name dataset dimensions, measures name metrics, and the rest
+ * is how the grid reads. The engine computes it, so every one of these travels
+ * into the workbook and the deck a schedule delivers as well as the screen.
+ */
+interface BuilderPivot {
+    rows: string[];
+    columns: string[];
+    measures: BuilderPivotMeasure[];
+    /** A line per row group, totalling the columns across it. */
+    rowTotals: boolean;
+    /** A total column beside the columns a dimension generated. */
+    columnTotals: boolean;
+    /** The one line at the foot totalling everything. */
+    grandTotal: boolean;
+    subtotals: PivotSubtotals;
+    /** What an intersection with no rows behind it prints. */
+    emptyValue: string | null;
+    /** The measure whose cells are shaded, or null for no shading. */
+    heatmap: string | null;
+    /**
+     * How many row levels start open when the widget is photographed for a PNG
+     * or PDF delivery, or null to open the rows the way subtotals says. A
+     * picture only carries the rows that are open, while the workbook and the
+     * deck always carry the whole cross-tab.
+     */
+    snapshotExpand: number | null;
+    /**
+     * How many column levels start open when the widget is photographed for a
+     * PNG or PDF delivery, or null to open every column. A spanning header past
+     * this level is folded to its own total column in the picture.
+     */
+    snapshotExpandColumns: number | null;
+    /** The measure the rows are ordered by, or null to order by their labels. */
+    sortMeasure: string | null;
+    /** Which way that ordering reads, or null for biggest or A first. */
+    sortDirection: PivotDirection | null;
+    /** How many row groups are drawn before the rest becomes one line, or null. */
+    topRows: number | null;
+    /** The measure that decides the biggest rows, or null for the sort measure. */
+    topRowsMeasure: string | null;
+    /** Whether the rows left out are carried in an Other line. */
+    topRowsOther: boolean;
+    /** How many row groups are kept, or null for the engine's own cap. */
+    rowGroupLimit: number | null;
+    /** How many generated columns are kept, or null for the engine's own cap. */
+    columnLimit: number | null;
+    /**
+     * Whether a reader may rearrange this pivot with the field panel.
+     *
+     * What they arrange lives in their own browser for as long as they look at it,
+     * so this switch decides who may explore, not what anyone else sees: the saved
+     * layout is still what a link, a schedule and every export carry.
+     */
+    explore: boolean;
+}
+interface BuilderWidget {
+    id: string;
+    name: string | null;
+    component: BuilderComponent;
+    chartType: ChartType;
+    /** Percent of the comparison, or the plain difference. */
+    deltaFormat: DeltaFormat;
+    /** `dataset` is the only kind the Builder edits; the rest stay read-only. */
+    dataKind: string;
+    datasetId: string | null;
+    /** Columns asked of the dataset, which are also the keys the rows come back with. */
+    columns: string[];
+    mappings: BuilderMappings;
+    series: BuilderSeries[];
+    appearance: BuilderAppearance;
+    pivot: BuilderPivot;
+}
+interface WidgetOutline {
+    widget: BuilderWidget | null;
+    /** Id, title and component, readable even when the rest is YAML only. */
+    identity: {
+        id: string;
+        name: string | null;
+        component: string;
+    };
+    /** Why the Builder will not edit the rest of this widget, when it will not. */
+    readOnlyReason: string | null;
+    error: ModelParseError | null;
+}
+/** The widget as the Builder shows it, or why it will not show it. */
+declare function readWidgetOutline(specYaml: string): WidgetOutline;
+/**
+ * Write the widget back, keeping every key the Builder does not own.
+ *
+ * The columns list is written as it is chosen, because the keys the rows come
+ * back with are exactly those strings: that is what lets the Builder guarantee
+ * a mapping names a column the query actually returns.
+ */
+declare function writeWidget(specYaml: string, widget: BuilderWidget): string;
+/**
+ * Write only a pivot's layout - rows, columns and how each measure is combined -
+ * into the widget's YAML, keeping everything else exactly as it is.
+ *
+ * This is what "Save this layout to the widget" does: the shelves an editor
+ * arranged become the stored layout, so the dashboard, every link and every
+ * scheduled delivery draw it from now on. A measure that was already configured
+ * keeps its label, format and decimals; one the editor added starts plain.
+ * Totals, sorting, top N, heatmap, captions, interactions and comments are not
+ * the layout's to touch, so they survive byte for byte.
+ */
+declare function writePivotLayout(specYaml: string, layout: {
+    rows: string[];
+    columns: string[];
+    measures: {
+        field: string;
+        agg: PivotAggregation;
+    }[];
+}): string;
+/** `ly_net_sales` reads as `Ly net sales`, which is what a card should say. */
+declare function humanizeColumn(column: string): string;
+/**
+ * Change what the widget is, without touching anything else.
+ *
+ * Switching to a component the Builder has no form for is allowed on purpose:
+ * the author says what they want here and finishes the wording in YAML, rather
+ * than deleting the widget and starting again.
+ */
+declare function writeComponent(specYaml: string, component: string): string;
+/** Rename the widget or change the id the layout references. */
+declare function writeIdentity(specYaml: string, field: "id" | "name", value: string): string;
+/** The YAML of the whole widget, for a panel that shows the text it produces. */
+declare function widgetFragment(specYaml: string): string;
+
+/**
+ * Checks the widget Builder runs while you click, before anything is saved.
+ *
+ * The failure this exists to kill is the blank chart: rows arrive, the widget
+ * points at a column name the query never returned, and nothing draws. The
+ * Builder only offers columns the chosen dataset can answer, and these checks
+ * catch the rest: no dataset, no columns, a mapping left unset, a series naming
+ * a column that is not selected, or a column from a dataset nothing joins to.
+ */
+
+/** One column a widget may ask for, and where it comes from. */
+interface WidgetColumn {
+    /** What goes in `data.columns`, and the key the row comes back with. */
+    key: string;
+    label: string;
+    kind: "dimension" | "metric";
+    /** Dataset the column belongs to, or null for a model level metric. */
+    dataset: string | null;
+    /** True when reading it forces a join with another dataset. */
+    joined: boolean;
+}
+interface SemanticSummary {
+    datasets: BuilderDataset[];
+    relationships: BuilderRelationship[];
+    modelMetrics: BuilderModelMetric[];
+}
+/**
+ * Every column a widget on `datasetId` can ask for.
+ *
+ * The base dataset contributes its own dimensions and metrics unqualified; a
+ * dataset the relationships connect to it contributes `other.metric`, which is
+ * the literal key its rows come back with; a model level metric contributes its
+ * id, since the engine resolves it against the join.
+ */
+declare function widgetColumns(datasetId: string | null, model: SemanticSummary): WidgetColumn[];
+/** Columns that hold a number, which is what a chart can plot. */
+declare function numericColumns(columns: WidgetColumn[]): WidgetColumn[];
+/** Columns that label a point, which is what an axis or a slice reads. */
+declare function labelColumns(columns: WidgetColumn[]): WidgetColumn[];
+/** Where in the widget document a finding belongs, so YAML can underline it. */
+type WidgetAnchor = {
+    kind: "widget";
+} | {
+    kind: "id";
+} | {
+    kind: "dataset";
+} | {
+    kind: "columns";
+} | {
+    kind: "column";
+    key: string;
+} | {
+    kind: "mapping";
+    slot: keyof BuilderWidget["mappings"];
+} | {
+    kind: "series";
+    index: number;
+} | {
+    kind: "pivotRows";
+} | {
+    kind: "pivotColumns";
+} | {
+    kind: "pivotMeasures";
+} | {
+    kind: "pivotMeasure";
+    index: number;
+} | {
+    kind: "pivotHeatmap";
+} | {
+    kind: "pivotSort";
+} | {
+    kind: "pivotTopRows";
+};
+interface WidgetFinding {
+    message: string;
+    at: WidgetAnchor;
+}
+/**
+ * Everything that would make this widget render empty, with where it lives.
+ *
+ * The Builder only needs the wording, but the YAML tab needs to underline the
+ * line that causes each one, which is why the location travels with it.
+ */
+declare function widgetFindings(widget: BuilderWidget, model: SemanticSummary): WidgetFinding[];
+declare function widgetIssues(widget: BuilderWidget, model: SemanticSummary): string[];
+
+/**
+ * The widget ids a tab holds. A tab may name its widgets by id, by reference,
+ * or inline, so all three shapes collapse to ids here.
+ */
+declare function tabWidgetIds(tab: DashboardTab): string[];
+declare function dashboardTabs(dashboard: DashboardSpec): DashboardTab[];
+declare function defaultTabId(tabs: DashboardTab[]): string | undefined;
+
+interface FilterOption {
+    value: unknown;
+    label: string;
+}
+type FilterControl = "select" | "multiselect" | "radio" | "date" | "date_range" | "input";
+interface FilterModel {
+    widgetId: string;
+    label: string;
+    control: FilterControl;
+    options: FilterOption[];
+    placeholder?: string;
+    defaultValue: unknown;
+    panelled: boolean;
+    labelPosition: "top" | "bottom";
+    /** True when the widget's object header replaces the inline label. */
+    showObjectHeader: boolean;
+    radioOrientation: "horizontal" | "vertical";
+    /** Relative expressions offered as one click shortcuts on date controls. */
+    presets: string[];
+    /** Whether a date control shows the calendar trigger next to its input. */
+    showIcon: boolean;
+}
+declare function filterOptions(widget: WidgetSpec$1, result: WidgetResult): FilterOption[];
+declare function describeFilter(value: unknown, options: FilterOption[]): string;
+/** Free text a date filter accepts in place of a calendar date, e.g. `last 7 days`. */
+declare function isRelativeDateExpression(value: string): boolean;
+declare function isIsoDate(value: string): boolean;
+declare function buildFilterModel(widget: WidgetSpec$1, result?: WidgetResult): FilterModel;
+
+type LayoutKey = "lg" | "md" | "sm" | "xs" | "xxs";
+/** The widths the reader switches layouts at, matching the frozen reader. */
+declare const LAYOUT_BREAKPOINT_WIDTHS: Record<LayoutKey, number>;
+declare function layoutKeyForWidth(width: number): LayoutKey;
+declare function resolveResponsive(dashboard: DashboardSpec): Required<Record<"wide" | "desktop" | "tablet" | "mobile", BreakpointConfig>>;
+
+interface ResultTable {
+    columns: string[];
+    rows: Record<string, unknown>[];
+}
+declare function resultRows(result: WidgetResult | undefined): Record<string, unknown>[];
+declare function resultColumns(result: WidgetResult | undefined, rows: Record<string, unknown>[]): string[];
+declare function cellText(value: unknown): string;
+/**
+ * The clipboard copy the reader offers. Styled workbook exports belong to the
+ * export phase and are not reimplemented here.
+ */
+declare function formatTableCsv(table: ResultTable): string;
+
+export { PIVOT_AGGREGATIONS as $, AGGREGATIONS as A, BUILDER_COMPONENTS as B, CHART_TYPES as C, DELTA_FORMATS as D, type DashboardModelDatasetDiagnostic as E, type DashboardModelDiagnostics as F, type DashboardModelMetricDiagnostic as G, type DashboardModelRelationshipDiagnostic as H, type DashboardPivotInfo as I, type DashboardResponsiveConfig as J, type DashboardSectionConfig as K, type DashboardSpec as L, type DashboardTab as M, type DeltaFormat as N, type FilterControl as O, type FilterLayout as P, type FilterModel as Q, type FilterOption as R, LAYOUT_BREAKPOINT_WIDTHS as S, type LayoutItem as T, type LayoutKey as U, type ModelMarker as V, type ModelMarkerSeverity as W, type ModelOutline as X, type ModelParseError as Y, NUMBER_FORMATS as Z, type NumberFormat as _, ALL_COMPONENTS as a, resultRows as a$, PIVOT_DIRECTIONS as a0, PIVOT_SUBTOTALS as a1, type PivotAggregation as a2, type PivotDirection as a3, type PivotExpandEntry as a4, type PivotOpenLevels as a5, type PivotSubtotals as a6, type RatioSide as a7, type ReadPivotOpenLevels as a8, type ResizeHandle as a9, isBuilderComponent as aA, isDoubleScaledPercent as aB, isIsoDate as aC, isRelativeDateExpression as aD, labelColumns as aE, layoutKeyForWidth as aF, modelMetricFragment as aG, modelText as aH, numericColumns as aI, parseAggregation as aJ, parseModelDocument as aK, parseRatioExpression as aL, preservedKeys as aM, ratioExpression as aN, readDataStores as aO, readDatasets as aP, readModelMetrics as aQ, readModelOutline as aR, readRelationships as aS, readWidgetOutline as aT, relationshipFragment as aU, removeDataStore as aV, removeDataset as aW, removeModelMetric as aX, removeRelationship as aY, resolveResponsive as aZ, resultColumns as a_, type ResponsiveLayouts as aa, type ResultTable as ab, SORT_ORDERS as ac, type SemanticSummary as ad, type SortOrder as ae, type WidgetAnchor as af, type WidgetColumn as ag, type WidgetFinding as ah, type WidgetOutline as ai, type WidgetRef as aj, aggregationExpression as ak, blockingKeys as al, buildFilterModel as am, cellText as an, countModelIssues as ao, dashboardTabs as ap, dataStoreFragment as aq, datasetFragment as ar, defaultTabId as as, describeFilter as at, diagnosticsToMarkers as au, dimensionTypeFor as av, filterOptions as aw, formatTableCsv as ax, humanizeColumn as ay, indexModelYaml as az, type Aggregation as b, tabWidgetIds as b0, upsertDataStore as b1, upsertDataset as b2, upsertModelMetric as b3, upsertRelationship as b4, widgetColumns as b5, widgetFindings as b6, widgetFragment as b7, widgetIssues as b8, writeComponent as b9, writeIdentity as ba, writePivotLayout as bb, writeWidget as bc, yamlSyntaxMarkers as bd, type Breakpoint as c, type BreakpointConfig as d, type BuilderAppearance as e, type BuilderCardinality as f, type BuilderComponent as g, type BuilderDataStore as h, type BuilderDataset as i, type BuilderDimension as j, type BuilderDimensionType as k, type BuilderMappings as l, type BuilderMetric as m, type BuilderModelMetric as n, type BuilderPivot as o, type BuilderPivotMeasure as p, type BuilderRelationship as q, type BuilderRollup as r, type BuilderSeries as s, type BuilderWidget as t, type ChartType as u, type DashboardConfig as v, type DashboardFilterPanelConfig as w, type DashboardGridConfig as x, type DashboardModelAiGrounding as y, type DashboardModelDataStoreDiagnostic as z };