react-semaphor 0.1.523 → 0.1.525

package/dist/types/components/visual/settings/display-labels.d.ts

@@ -1 +1,2 @@
-export declare function DisplayLabels(): import("react/jsx-runtime").JSX.Element;
+import * as React from 'react';
+export declare function DisplayLabels(): React.JSX.Element;

package/dist/types/components/visual/settings/filter-on-click-columns.d.ts

@@ -1 +1 @@
-export declare function FilterOnClickColumns(): import("react/jsx-runtime").JSX.Element;
+export declare function FilterOnClickColumns(): import("react").JSX.Element;

package/dist/types/components/visual/settings/frame-filters.d.ts

@@ -1,6 +1,7 @@
 import { Field } from '../../../lib/types/explorer-types.js';
-export default function FrameFilters(): import("react/jsx-runtime").JSX.Element;
+import * as React from 'react';
+export default function FrameFilters(): React.JSX.Element;
 export declare function FilterColumnsCombobox({ columns, onSelect, }: {
     columns: Field[];
     onSelect: (value: Field) => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;

package/dist/types/components/visual/settings/inline-filters-settings.d.ts

@@ -1,3 +1,4 @@
+import { default as React } from 'react';
 interface InlineFiltersSettingsProps {
     className?: string;
     triggerVariant?: 'icon' | 'menu';
@@ -7,5 +8,5 @@ interface InlineFiltersSettingsProps {
  * Popover component for configuring inline filters on a card.
  * Displays as an icon button in the toolbar, with added filters shown as badges.
  */
-export declare function InlineFiltersSettings({ className, triggerVariant, label, }: InlineFiltersSettingsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function InlineFiltersSettings({ className, triggerVariant, label, }: InlineFiltersSettingsProps): React.JSX.Element | null;
 export {};

package/dist/types/components/visual/settings/kpi-settings.d.ts

@@ -1 +1 @@
-export default function KPISettings(): import("react/jsx-runtime").JSX.Element;
+export default function KPISettings(): import("react").JSX.Element;

package/dist/types/components/visual/settings/map-chart-settings.d.ts

@@ -1 +1 @@
-export default function MapChartSettings(): import("react/jsx-runtime").JSX.Element;
+export default function MapChartSettings(): import("react").JSX.Element;

package/dist/types/components/visual/settings/scale-options.d.ts

@@ -1 +1 @@
-export default function ScaleOptions(): import("react/jsx-runtime").JSX.Element;
+export default function ScaleOptions(): import("react").JSX.Element;

package/dist/types/components/visual/settings/table-column-visibility-settings.d.ts

@@ -12,5 +12,5 @@ type TableColumnVisibilitySettingsProps = {
     helperText?: string;
     className?: string;
 };
-export declare function TableColumnVisibilitySettings({ columns, columnVisibility, onColumnVisibilityChange, onShowAllColumns, emptyMessage, helperText, className, }: TableColumnVisibilitySettingsProps): import("react/jsx-runtime").JSX.Element;
+export declare function TableColumnVisibilitySettings({ columns, columnVisibility, onColumnVisibilityChange, onShowAllColumns, emptyMessage, helperText, className, }: TableColumnVisibilitySettingsProps): import("react").JSX.Element;
 export {};

package/dist/types/components/visual/settings/table-presentation-settings.d.ts

@@ -31,7 +31,7 @@ type TablePresentationSettingsProps = {
     onReset?: () => void;
     className?: string;
 };
-export declare function TablePresentationSettings({ style, onDensityChange, densityOptions, onStyleChange, totals, showFullStyle, showBorderStyle, extraSection, totalsDefaults, totalsBorderStyleOptions, onReset, className, }: TablePresentationSettingsProps): import("react/jsx-runtime").JSX.Element;
+export declare function TablePresentationSettings({ style, onDensityChange, densityOptions, onStyleChange, totals, showFullStyle, showBorderStyle, extraSection, totalsDefaults, totalsBorderStyleOptions, onReset, className, }: TablePresentationSettingsProps): import("react").JSX.Element;
 export declare function TableSettingsSection({ label, action, children, }: {
     label: string;
     /** Optional right-aligned slot in the section header — use for a master
@@ -39,15 +39,15 @@ export declare function TableSettingsSection({ label, action, children, }: {
      * styling rows below should only render when the master is on. */
     action?: ReactNode;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function TableSettingsRow({ label, htmlFor, children, }: {
     label: string;
     htmlFor?: string;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function TableSettingsSwitchRow({ label, checked, onCheckedChange, }: {
     label: string;
     checked: boolean;
     onCheckedChange: (checked: boolean) => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export {};

package/dist/types/components/visual/settings/table-visual-settings.d.ts

@@ -5,4 +5,4 @@ export default function TableVisualSettings({ cardType, queryResultColumns, focu
     queryResultColumns?: string[];
     focusSection?: TableVisualSettingsFocus | null;
     focusRequestId?: number;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

package/dist/types/components/visual/settings/text-settings.d.ts

@@ -1 +1 @@
-export default function TextSettings(): import("react/jsx-runtime").JSX.Element;
+export default function TextSettings(): import("react").JSX.Element;

package/dist/types/components/visual/settings/text-type-radio.d.ts

@@ -1 +1,2 @@
-export default function TextTypeRadio(): import("react/jsx-runtime").JSX.Element;
+import { default as React } from 'react';
+export default function TextTypeRadio(): React.JSX.Element;

package/dist/types/components/visual/visual-error-state.d.ts

@@ -9,5 +9,5 @@ type VisualErrorStateProps = {
     role?: 'alert' | 'status';
     title?: string;
 };
-export declare function VisualErrorState({ action, className, description, density, role, title, }: VisualErrorStateProps): import("react/jsx-runtime").JSX.Element;
+export declare function VisualErrorState({ action, className, description, density, role, title, }: VisualErrorStateProps): import("react").JSX.Element;
 export {};

package/dist/types/components/visual/visual.d.ts

@@ -4,4 +4,4 @@ export type VisualProps = DashboardProps & {
     dashboardId: string;
     displayPreferences?: VisualDisplayPreferences;
 };
-export declare function Visual(props: VisualProps): import("react/jsx-runtime").JSX.Element;
+export declare function Visual(props: VisualProps): import("react").JSX.Element;

package/dist/types/dashboard-assistant/index.d.ts

@@ -1,12 +1,12 @@
 import { SemaphorAnalyticsExecutionResult, SemaphorAnalyticsIntent, SemaphorResultColumn } from '../shared/analytics-protocol/index.js';
 import { TChartType } from '../lib/charts/types.js';
-import { DataSource, CardConfig, TDynamicCardPreferences, TDynamicVisualFallback, TDynamicVisualIntent, TVisualizationMode, QueryColumnKeyMap } from '../lib/types/index.js';
+import { DataSource, CardConfig, QueryColumnKeyMap } from '../lib/types/index.js';
 import { TemporalResultOwner } from '../shared/dashboard-authoring/index.js';
 import { CanonicalPivotResultTransport } from '../shared/format-utils/index.js';
 export type DashboardAssistantOperationKind = 'answer' | 'preview_visual' | 'explain_card' | 'add_visual';
 export type DashboardAssistantInspectMode = 'dashboard_summary' | 'card_context' | 'artifact_context';
-export type DashboardAssistantVisualToolName = 'runDashboardAnalysis' | 'runAdvancedAnalysis' | 'renderDynamicVisual';
-export declare const DASHBOARD_ASSISTANT_VISUAL_TOOL_PART_TYPES: readonly ["tool-runDashboardAnalysis", "tool-runAdvancedAnalysis", "tool-renderDynamicVisual"];
+export type DashboardAssistantVisualToolName = 'runDashboardAnalysis' | 'runAdvancedAnalysis';
+export declare const DASHBOARD_ASSISTANT_VISUAL_TOOL_PART_TYPES: readonly ["tool-runDashboardAnalysis", "tool-runAdvancedAnalysis"];
 export type DashboardAssistantVisualToolPartType = (typeof DASHBOARD_ASSISTANT_VISUAL_TOOL_PART_TYPES)[number];
 export declare function isDashboardAssistantVisualToolPartType(value: string): value is DashboardAssistantVisualToolPartType;
 export type DashboardAssistantTurnContext = {
@@ -41,29 +41,9 @@ export type DashboardAssistantAddToDashboardPayload = {
         pluginChartType: string;
         settings?: Record<string, unknown>;
     };
-    visualizationMode?: TVisualizationMode;
-    dynamicCardPreferences?: TDynamicCardPreferences;
-};
-export type DashboardAssistantDynamicVisualArtifact = {
-    renderer: 'dynamic-visual';
-    status: 'generated' | 'fallback' | 'failed';
-    artifactId: string;
-    parentArtifactId?: string;
-    title: string;
-    rendererCode?: string;
-    question: string;
-    provenance: 'query_spec' | 'sql' | 'sql+python';
-    visualIntent?: TDynamicVisualIntent;
-    assistantNote?: string;
-    fallback: TDynamicVisualFallback;
-    error?: {
-        stage: string;
-        message: string;
-        details?: string[];
-    };
 };
 export type DashboardAssistantArtifact = {
-    kind: 'analysis' | 'dynamic_visual' | 'clarification';
+    kind: 'analysis' | 'clarification';
     status: 'ready' | 'partial' | 'failed';
     resultOwner?: TemporalResultOwner;
     pivotResult?: CanonicalPivotResultTransport;
@@ -79,7 +59,6 @@ export type DashboardAssistantArtifact = {
     dataSource?: DataSource;
     suppressVisualRender?: boolean;
     executionResult?: SemaphorAnalyticsExecutionResult;
-    dynamicVisual?: DashboardAssistantDynamicVisualArtifact;
     addToDashboard?: DashboardAssistantAddToDashboardPayload;
     warnings?: string[];
     diagnostics?: Record<string, unknown>;

package/dist/types/data-app-builder/data-app-builder.d.ts

@@ -11,4 +11,4 @@ declare global {
     }
 }
 export type { ApiStatus, BridgeCommandResult, BridgeReadFilesResult, BridgeResult, BridgeWorkspaceContextResult, BuilderTurn, BuilderTurnMode, BuilderTurnResult, DataAppBuilderAdapters, DataAppBuilderArtifact, DataAppBuilderDatasetInspectorArtifact, DataAppBuilderLoadedApp, DataAppBuilderLoadedVersion, DataAppBuilderPublishBuildResult, DataAppBuilderPublishProgress, DataAppBuilderPublishRequest, DataAppBuilderPublishResult, DataAppBuilderProps, DataAppBuilderSaveDraftRequest, DataAppBuilderSaveDraftResult, DataAppBuilderTurnProgress, DataAppBuilderTurnRequest, DataAppIntentInput, DataAppIntentInteraction, DataAppIntentLayout, DataAppIntentManifest, DataAppIntentSource, DataAppIntentView, DataAppIntentViewKind, DataAppManifest, DataAppOperationPlan, DataAppOperationTarget, DataAppOperationType, DataAppSourceRevision, DataAppSourceSnapshot, GeneratedRevision, ReasoningEffort, WorkspaceContext, } from './types.js';
-export declare function DataAppBuilder({ projectId, projectName, dataAppId, apiServiceUrl, adapters, }: DataAppBuilderProps): import("react/jsx-runtime").JSX.Element;
+export declare function DataAppBuilder({ projectId, projectName, dataAppId, apiServiceUrl, adapters, }: DataAppBuilderProps): ReactRuntime.JSX.Element;

package/dist/types/data-app-sdk/devtools/index.d.ts

@@ -36,7 +36,7 @@ export type SemaphorDevtoolsInspectButtonProps = {
 export declare function SemaphorDataAppDevtoolsProvider({ debug, children, }: {
     debug?: SemaphorDataAppDebugConfig;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;
 export declare function SemaphorViewBoundary({ id, title, children, }: {
     id: string;
     title?: string;

package/dist/types/data-app-sdk/provider.d.ts

@@ -5,4 +5,4 @@ export type SemaphorDataAppProviderProps = SemaphorQueryExecutorContext & {
     debug?: SemaphorDataAppDebugConfig;
     children: ReactNode;
 };
-export declare function SemaphorDataAppProvider({ token, apiBaseUrl, executor, debug, children, }: SemaphorDataAppProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function SemaphorDataAppProvider({ token, apiBaseUrl, executor, debug, children, }: SemaphorDataAppProviderProps): import("react").JSX.Element;

package/dist/types/lib/charts/area-chart.d.ts

@@ -2,4 +2,4 @@ import { ChartConfigParams, TChartConfiguration } from './types.js';
 /**
  * Create an area chart configuration
  */
-export declare function createAreaChart({ card, data, cfg, customCfg, preferences, cardType, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;
+export declare function createAreaChart({ card, data: rawData, cfg, customCfg, preferences, cardType, columnKeyMap, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;

package/dist/types/lib/charts/bar-chart.d.ts

@@ -2,4 +2,4 @@ import { ChartConfigParams, TChartConfiguration } from './types.js';
 /**
  * Create a bar chart configuration
  */
-export declare function createBarChart({ card, data: rawData, cfg, customCfg, preferences, cardType, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;
+export declare function createBarChart({ card, data: rawData, cfg, customCfg, preferences, cardType, columnKeyMap, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;

package/dist/types/lib/charts/cartesian-data.d.ts

@@ -0,0 +1,72 @@
+import { TCard, TCardPreferences } from '../types/common-types.js';
+import { QueryColumnKeyMap } from '../types/explorer-types.js';
+import { ComparisonMetadataMap } from '../types/query-types.js';
+import { CartesianTemporalPresentation, CartesianTemporalSeriesValue } from '../formatters/cartesian-temporal-presentation.js';
+import { ChartOptions, Plugin } from 'chart.js';
+import { CategoryGroupAxisSide, CategoryGroupRun } from './shared/category-group-axis-plugin.js';
+export type PreparedCartesianChartData = {
+    /** Ordered records, locally pivoted when `seriesKey` is set. */
+    records: Record<string, any>[];
+    axisKeys: string[];
+    /** Grouped field whose values became dataset labels through a local pivot. */
+    seriesKey?: string;
+    /** Original series values keyed by their pivoted dataset label. */
+    seriesValues?: ReadonlyMap<string, CartesianTemporalSeriesValue>;
+    /** Keys rendered as datasets, in display order. */
+    valueKeys: string[];
+    /** True when each value column is one Pivot member returned by the server. */
+    hasServerPivotedSeries: boolean;
+    labels: unknown[];
+    isComparison: boolean;
+};
+export declare function prepareCartesianChartData(input: {
+    card: TCard;
+    cardType: string;
+    records: Record<string, any>[];
+    columnKeyMap?: QueryColumnKeyMap;
+    comparisonMetadata?: ComparisonMetadataMap;
+    temporalPresentation?: CartesianTemporalPresentation;
+    sortChart?: 'asc' | 'desc' | 'none';
+}): PreparedCartesianChartData;
+/**
+ * The builder owns the identity of what it draws. Every dataset carries the
+ * drawn outer-level axis values, the full category path when the axis has two
+ * or more levels, and, when it is one series member, the canonical series
+ * value, regardless of temporal presentation. Consumers such
+ * as click context read this identity instead of recovering it from raw query
+ * records by position, which breaks whenever records are pivoted, grouped or
+ * sorted, or datasets are added or removed. Identity attached earlier (temporal
+ * or wide-pivot result identity) is kept as is.
+ */
+export declare function attachRenderedIdentity<T extends object>(datasets: readonly T[], prepared: Pick<PreparedCartesianChartData, 'records' | 'axisKeys' | 'seriesKey' | 'seriesValues' | 'hasServerPivotedSeries'>): T[];
+export type NestedCategoryAxis = {
+    axisId: 'x' | 'y';
+    side: CategoryGroupAxisSide;
+    innerLabels: string[];
+    runs: CategoryGroupRun[];
+};
+/**
+ * The nested axis applies to two-level paths (D8). Whether the category scale
+ * ends up on its default side, visible and labeled is decided at render time
+ * from the resolved scale (see category-group-axis-plugin), so custom chart
+ * options are covered too.
+ */
+export declare function resolveNestedCategoryAxis(input: {
+    prepared: Pick<PreparedCartesianChartData, 'records' | 'axisKeys'>;
+    cardType: string;
+    preferences?: TCardPreferences;
+    temporalPresentation?: CartesianTemporalPresentation;
+}): NestedCategoryAxis | undefined;
+/**
+ * Add the nested category axis to final options when it applies. Returns the
+ * chart's plugins with the nested axis plugin appended, or the plugins as
+ * given.
+ */
+export declare function withNestedCategoryAxis<P>(input: {
+    prepared: Pick<PreparedCartesianChartData, 'records' | 'axisKeys'>;
+    cardType: string;
+    preferences?: TCardPreferences;
+    temporalPresentation?: CartesianTemporalPresentation;
+    options: ChartOptions;
+    plugins: P[] | undefined;
+}): Array<P | Plugin> | undefined;

package/dist/types/lib/charts/cartesian-fields.d.ts

@@ -0,0 +1,60 @@
+import { TCard } from '../types/common-types.js';
+import { CardConfig, Field, QueryColumnKeyMap } from '../types/explorer-types.js';
+import { CartesianTemporalPresentation } from '../formatters/cartesian-temporal-presentation.js';
+export declare const CARTESIAN_AXIS_PATH_SEPARATOR = " \u00B7 ";
+export type CartesianFieldRoles = {
+    /** Result keys for the category path, outer to inner. */
+    axisKeys: string[];
+    /** Result key whose values become series through a local pivot. */
+    seriesKey?: string;
+    /** Result keys plotted as values, in display order. */
+    valueKeys: string[];
+};
+export declare function usesCartesianFieldRoles(cardType?: string): boolean;
+/**
+ * The saved Sort setting applies only where the editor offers it, so a value
+ * left over from switching chart type has no effect.
+ */
+export declare function supportsChartSort(cardType?: string): boolean;
+export declare function isStackedCartesianChartType(cardType?: string): boolean;
+/**
+ * Legacy stacked shape: exactly two Rows fields and an empty Pivot zone render
+ * the second Rows field as the series. Saved dashboards depend on this, so it
+ * is kept for that exact shape only and never extended to more Rows fields.
+ */
+export declare function resolveLegacySeriesGroupField(cardConfig: CardConfig | undefined): Field | undefined;
+/**
+ * Resolve cartesian roles for a chart.
+ *
+ * `keys` are the result keys in display order (comparison internals removed,
+ * temporal axis first), as builders already compute them.
+ */
+export declare function resolveCartesianFieldRoles(input: {
+    card: TCard;
+    cardType: string;
+    keys: readonly string[];
+    columnKeyMap?: QueryColumnKeyMap;
+    isComparison: boolean;
+}): CartesianFieldRoles;
+/**
+ * Order records so bars sharing an outer axis value are contiguous, keeping
+ * first-appearance order of groups and query order within a group. With a sort
+ * direction, groups are ordered by group total and records within each group
+ * by record total. Single-level charts without a sort keep their order.
+ */
+export declare function orderCartesianRecordsByAxisPath<T extends Record<string, unknown>>(input: {
+    records: readonly T[];
+    axisKeys: readonly string[];
+    valueKeys: readonly string[];
+    sortChart?: 'asc' | 'desc' | 'none';
+}): T[];
+/**
+ * One level of a multi-level path. Only null, undefined and empty text are
+ * missing, so `0` and `false` stay distinct categories.
+ */
+export declare function formatAxisPathLevel(value: unknown, columnKey: string, temporalPresentation?: CartesianTemporalPresentation): string;
+/**
+ * Axis labels for the category path. One-level paths match `getXaxisLabels`;
+ * deeper paths join each formatted level with ` · `.
+ */
+export declare function formatCartesianAxisPathLabels(records: readonly Record<string, unknown>[], axisKeys: readonly string[], temporalPresentation?: CartesianTemporalPresentation): unknown[];

package/dist/types/lib/charts/chart-utils.d.ts

@@ -114,6 +114,7 @@ export declare function getDefaultDatasets(metricKeys: string[], data: any[], pr
     semaphorComparisonSeries?: boolean | undefined;
     label: string;
     data: any[];
+    semaphorResultColumnKey: string;
 } | {
     stack?: string | undefined;
     backgroundColor: string | ((ctx: any) => string);
@@ -162,6 +163,7 @@ export declare function getDefaultDatasets(metricKeys: string[], data: any[], pr
     semaphorComparisonSeries?: boolean | undefined;
     label: string;
     data: any[];
+    semaphorResultColumnKey: string;
 } | {
     stack?: string | undefined;
     backgroundColor: string | ((ctx: any) => string);
@@ -209,6 +211,7 @@ export declare function getDefaultDatasets(metricKeys: string[], data: any[], pr
     semaphorComparisonSeries?: boolean | undefined;
     label: string;
     data: any[];
+    semaphorResultColumnKey: string;
 }) & import('../formatters/cartesian-temporal-presentation.js').CartesianTemporalDatasetIdentity)[];
 export declare function getDatasetlabelColor(align: string | undefined, backgroundColor: string): (context: any) => string;
 /**

package/dist/types/lib/charts/combo-chart.d.ts

@@ -2,4 +2,4 @@ import { ChartConfigParams, TChartConfiguration } from './types.js';
 /**
  * Create a combo chart configuration
  */
-export declare function createComboChart({ card, data, cfg, customCfg, preferences, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;
+export declare function createComboChart({ card, data: rawData, cfg, customCfg, preferences, columnKeyMap, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;

package/dist/types/lib/charts/create-chart.d.ts

@@ -12,7 +12,7 @@ import { CoreChartOptions } from 'chart.js';
  * For stacked charts: Colors are applied to pivot values (dataset labels)
  * For regular charts: Colors are applied to category values (individual bars)
  */
-export declare function createStandardChart({ data, cfg, customCfg, preferences, cardType, card, comparisonMetadata, numericPresentation, temporalPresentation, datasetAxisColumnKey, datasetSeriesColumnKey, datasetSeriesValues, }: ChartConfigParams): TChartConfiguration;
+export declare function createStandardChart({ data, cfg, customCfg, preferences, cardType, card, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;
 export declare function getNumberAxis(cardPreferences: TCardPreferences | undefined, cfg: TChartConfiguration | undefined): "x" | "y";
 export declare function getCategoryAxis(cardPreferences: TCardPreferences | undefined): "x" | "y";
 export declare function getFmtNumberOptions(cfg: TChartConfiguration | undefined, preferences: TCardPreferences | undefined): any;

package/dist/types/lib/charts/line-chart.d.ts

@@ -2,4 +2,4 @@ import { ChartConfigParams, TChartConfiguration } from './types.js';
 /**
  * Create a line chart configuration
  */
-export declare function createLineChart({ card, data, cfg, customCfg, preferences, cardType, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;
+export declare function createLineChart({ card, data: rawData, cfg, customCfg, preferences, cardType, columnKeyMap, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;

package/dist/types/lib/charts/shared/category-group-axis-plugin.d.ts

@@ -0,0 +1,23 @@
+import { ChartOptions, Plugin } from 'chart.js';
+export type CategoryGroupRun = {
+    label: string;
+    /** First category index in the run. */
+    start: number;
+    /** Last category index in the run (inclusive). */
+    end: number;
+};
+export type CategoryGroupAxisSide = 'left' | 'bottom';
+/** Contiguous runs of equal outer values. */
+export declare function computeCategoryGroupRuns(outerValues: readonly unknown[], outerLabels: readonly string[]): CategoryGroupRun[];
+/**
+ * Apply the nested axis to final chart options: inner tick labels, a reserved
+ * band on the category scale, and the drawing plugin. Returns the plugin to
+ * add to the chart's plugins.
+ */
+export declare function applyCategoryGroupAxis(input: {
+    options: ChartOptions;
+    axisId: 'x' | 'y';
+    side: CategoryGroupAxisSide;
+    innerLabels: readonly string[];
+    runs: readonly CategoryGroupRun[];
+}): Plugin;

package/dist/types/lib/charts/stacked-line-chart.d.ts

@@ -0,0 +1,2 @@
+import { ChartConfigParams, TChartConfiguration } from './types.js';
+export declare function createStackedLineChart({ card, data: rawData, cfg, customCfg, preferences, columnKeyMap, comparisonMetadata, numericPresentation, temporalPresentation, }: ChartConfigParams): TChartConfiguration;

package/dist/types/lib/charts/types.d.ts

@@ -5,7 +5,7 @@ import { ChartNumericPresentationContext } from '../formatters/chart-numeric-pre
 import { QueryColumnKeyMap } from '../types/explorer-types.js';
 import { SemaphorResultColumn } from '../../shared/analytics-protocol/index.js';
 import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
-import { CartesianTemporalPresentation, CartesianTemporalSeriesValue } from '../formatters/cartesian-temporal-presentation.js';
+import { CartesianTemporalPresentation } from '../formatters/cartesian-temporal-presentation.js';
 export type ChartConfigParams = {
     card: TCard;
     data: any[];
@@ -13,12 +13,6 @@ export type ChartConfigParams = {
     resultColumns?: readonly SemaphorResultColumn[];
     columnKeyMap?: QueryColumnKeyMap;
     temporalPresentation?: CartesianTemporalPresentation;
-    /** Exact category key retained by a local tall-to-wide pivot. */
-    datasetAxisColumnKey?: string;
-    /** Exact grouped field whose canonical values became dataset labels. */
-    datasetSeriesColumnKey?: string;
-    /** Original scalar values keyed by their pivoted dataset label. */
-    datasetSeriesValues?: ReadonlyMap<string, CartesianTemporalSeriesValue>;
     presentationExecutionSnapshot?: PresentationExecutionSnapshot | null;
     dashboardId?: string;
     presentationAttachmentIndex?: number;
@@ -47,7 +41,7 @@ export type BlurEffectProps = {
     apply: boolean;
     blurColor?: string;
 };
-export type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'matrixTable' | 'detailTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
+export type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'matrixTable' | 'detailTable' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
 export declare const TABLE_CHART_TYPES: readonly ["table", "pivotTable", "aggregateTable", "matrixTable", "detailTable"];
 export declare function isTableChartType(chartType: TChartType | string | undefined | null): boolean;
 export declare function isChartJsVisualType(chartType: TChartType | string | undefined | null): boolean;

package/dist/types/lib/contexts/interactions-popover-context.d.ts

@@ -11,4 +11,4 @@ export { InteractionsPopoverContext };
 type InteractionsPopoverProviderProps = {
     children: ReactNode;
 };
-export declare function InteractionsPopoverProvider({ children, }: InteractionsPopoverProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function InteractionsPopoverProvider({ children, }: InteractionsPopoverProviderProps): import("react").JSX.Element;

package/dist/types/lib/formatters/cartesian-temporal-presentation.d.ts

@@ -6,7 +6,7 @@ import { GroupedTemporalPresentation, GroupedTemporalViewerPreferences } from '.
 export type CartesianTemporalPresentation = GroupedTemporalPresentation & {
     /** Exact output key for the first grouped field. */
     axisColumnKey?: string;
-    /** Exact output key for the second grouped field when it becomes a series. */
+    /** Exact output key for the grouped field rendered as the series (legacy two-Rows shape). */
     seriesColumnKey?: string;
     /** Physical wide-pivot columns keyed by their exact result accessor. */
     pivotSeriesByColumnKey: ReadonlyMap<string, SemaphorPivotResultColumnIdentity>;
@@ -15,6 +15,11 @@ export type CartesianTemporalSeriesValue = string | number | null;
 export type CartesianTemporalDatasetIdentity = {
     /** Canonical category values aligned with the rendered dataset's points. */
     semaphorCanonicalAxisValues?: readonly unknown[];
+    /**
+     * Canonical category path per point, outer to inner, aligned with the Rows
+     * fields that form the axis. Present only for paths of two or more levels.
+     */
+    semaphorAxisPath?: readonly (readonly unknown[])[];
     /** Canonical grouped-series value behind a presentation-only legend label. */
     semaphorCanonicalSeriesKey?: unknown;
     /** Exact physical result accessor used to build this dataset. */

package/dist/types/lib/hooks/ai/use-dashboard-assistant.d.ts

@@ -1,8 +1,5 @@
 import { UIMessage } from 'ai';
-type DynamicVisualMode = 'auto' | 'force' | 'off';
-export declare function useDashboardAssistant({ dynamicVisualMode, }?: {
-    dynamicVisualMode?: DynamicVisualMode;
-}): {
+export declare function useDashboardAssistant(): {
     sendMessage: (message?: (Omit<UIMessage<unknown, import('ai').UIDataTypes, import('ai').UITools>, "id" | "role"> & {
         id?: string | undefined;
         role?: "system" | "user" | "assistant" | undefined;
@@ -33,4 +30,3 @@ export declare function useDashboardAssistant({ dynamicVisualMode, }?: {
     errorMessage: string;
     clearError: () => void;
 };
-export {};

package/dist/types/lib/hooks/semaphor-ready-indicator.d.ts

@@ -13,5 +13,5 @@ type SemaphorReadyIndicatorProps = {
  *
  * The element is visually hidden (sr-only pattern) so it doesn't affect layouts.
  */
-export declare function SemaphorReadyIndicator({ delayMs, quietMs, componentType, componentId, }: SemaphorReadyIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function SemaphorReadyIndicator({ delayMs, quietMs, componentType, componentId, }: SemaphorReadyIndicatorProps): import("react").JSX.Element;
 export {};

package/dist/types/lib/hooks/use-card-render-context.d.ts

@@ -0,0 +1,14 @@
+import { PivotTableResponse } from '../../components/visual/pivot-table/types.js';
+import { QueryExecutionResponse } from '../types/explorer-types.js';
+import { TCard } from '../types/common-types.js';
+type CardRenderQueryData = (QueryExecutionResponse & Pick<Partial<PivotTableResponse>, 'groupByColumns'>) | null | undefined;
+/**
+ * Pairs a card with the config that produced its current result, so table
+ * and pivot renderers never read retained rows against stale drill state.
+ */
+export declare function useCardRenderContext(card: TCard, effectiveCardConfig: TCard['config'] | undefined, queryData: CardRenderQueryData): {
+    renderCard: TCard;
+    tableRecords: any[];
+    pivotTableConfig: import('../../components/visual/pivot-table/pivot-table.js').PivotTableConfig | null;
+};
+export {};

package/dist/types/lib/hooks/use-dashboard-query.d.ts

@@ -2,10 +2,6 @@ export declare function useDashboardQuery(): {
     data: {
         initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
         dashboard: import('../types/index.js').TDashboard;
-        lenses: import('../types/index.js').TLens[];
-        filterValues?: import('../types/index.js').TFilterValue[] | null;
-        inputValues?: import('../types/index.js').LensInputValuesSnapshot | null;
-        defaultLensId?: string;
         assistantProfileId?: string;
         semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
         organizationAppearance?: import('../types/index.js').AppearanceSpec | null;
@@ -16,10 +12,6 @@ export declare function useDashboardQuery(): {
     refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<{
         initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
         dashboard: import('../types/index.js').TDashboard;
-        lenses: import('../types/index.js').TLens[];
-        filterValues?: import('../types/index.js').TFilterValue[] | null;
-        inputValues?: import('../types/index.js').LensInputValuesSnapshot | null;
-        defaultLensId?: string;
         assistantProfileId?: string;
         semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
         organizationAppearance?: import('../types/index.js').AppearanceSpec | null;

package/dist/types/lib/hooks/use-dashboard.d.ts

@@ -37,10 +37,6 @@ export declare function useDashboard({ customStyle, currentTheme, onSave, onEven
     refetch: (options?: import('@tanstack/query-core').RefetchOptions) => Promise<import('@tanstack/query-core').QueryObserverResult<{
         initialReportContext: import('../../shared/report-runtime-context/index.js').ReportRuntimeContext;
         dashboard: TDashboard;
-        lenses: import('../../components/index.js').TLens[];
-        filterValues?: TFilterValue[] | null;
-        inputValues?: import('../../components/index.js').LensInputValuesSnapshot | null;
-        defaultLensId?: string;
         assistantProfileId?: string;
         semanticExecutionPayload: import('../types/semantic-runtime-types.js').SemanticExecutionPayload;
         organizationAppearance?: import('../../components/index.js').AppearanceSpec | null;

package/dist/types/lib/matrix-table/matrix-execution-provider.d.ts

@@ -4,4 +4,4 @@ import { MatrixExecutionEnvironment } from './matrix-execution-context.js';
 export declare function MatrixExecutionProvider({ value, children, }: {
     value: MatrixExecutionEnvironment;
     children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
+}): import("react").JSX.Element;

package/dist/types/lib/print/print-inputs.d.ts

@@ -35,7 +35,7 @@ export type PrintInputResolution =
     snapshot: DashboardInputExecutionSnapshot;
     source: 'capture' | 'legacy_snapshot';
 }
-/** Replay nothing: the existing no-snapshot path (dashboard defaults, Lens values), as today. */
+/** Replay nothing: the existing no-snapshot path (dashboard defaults), as today. */
  | {
     status: 'no_replay';
 }

package/dist/types/lib/query-context/build-dashboard-card-query-contract.d.ts

@@ -48,7 +48,6 @@ export type DashboardCardQueryContractResult = DashboardCardQueryContract | {
 /** Test/invariant helper for fixtures that cannot contain mapped inputs. */
 export declare function requireReadyDashboardCardQueryContract(result: DashboardCardQueryContractResult): DashboardCardQueryContract;
 export type DashboardCardQueryExecutionOptions = {
-    selectedLensId?: string;
     resolvedPrimaryDateField?: ResolvedPrimaryDateField;
     calendarContext: CalendarContext;
     allowGlobalDateMinutePrecision?: boolean;

package/dist/types/lib/query-context/dashboard-card-query-key.d.ts

@@ -6,7 +6,6 @@ import { CalendarContext } from '../../shared/report-runtime-context/index.js';
 export declare const isPaginatedCardType: (card: TCard) => boolean;
 export type CreateDashboardCardQueryKeyOptions = {
     finalFiltersKey: string;
-    selectedLensId?: string;
     cardFilterValues: unknown;
     controlValues?: Record<string, unknown>;
     controlDefinitions?: ControlDefinition[];