react-semaphor 0.1.524 → 0.1.525

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-D7GVxl4a.js";
+import { b as a, a as o } from "../chunks/index-DYOaHuLS.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-RAp0DAuw.js";
+import { R as t } from "../chunks/report-preferences-dialog-BLaFmlE2.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/briefings/index.d.ts

@@ -3,7 +3,7 @@ import { BriefingAppearanceSpec, BriefingFragments, BriefingThemeOverrides } fro
 import { MatrixConfig } from '../shared/analytics-protocol/index.js';
 export { captureMatrixExport, buildMatrixDeliveryEnvelope, matrixDeliveryPayloadSchema, matrixDeliveryQuerySchema, type MatrixLayoutReadResult } from '../shared/dashboard-authoring/matrix-delivery.js';
 export declare const BRIEFING_KIND: "BRIEFING";
-export { DEFAULT_BRIEFING_SCHEDULE, buildBriefingScheduleExpr, describeBriefingSchedule, isValidBriefingTimezone, parseBriefingScheduleExpr, type BriefingScheduleCadence, type BriefingScheduleViewModel, } from './schedule.js';
+export { DEFAULT_BRIEFING_SCHEDULE, briefingScheduleMonths, briefingScheduleDayOccurs, briefingScheduleShortMonths, buildBriefingScheduleExpr, canonicalBriefingMonthDays, describeBriefingSchedule, isValidBriefingTimezone, nextBriefingScheduleDates, parseBriefingScheduleExpr, type BriefingScheduleFrequency, type BriefingScheduleMonthDay, type BriefingScheduleMonthInterval, type BriefingScheduleMonthlyOn, type BriefingScheduleOrdinal, type BriefingScheduleViewModel, } from './schedule.js';
 export { getBriefingCardAttachmentCapability, getBriefingCardAttachmentFormats, getDefaultBriefingCardAttachmentFormat, type BriefingCardAttachmentCapability, } from './attachments.js';
 export { canCreateBriefingForUser, type BriefingUiUser } from './capabilities.js';
 export { getBriefingCreationIntents, type BriefingAuthorIntent, } from './creation.js';

package/dist/types/briefings/schedule.d.ts

@@ -1,12 +1,44 @@
-export type BriefingScheduleCadence = 'daily' | 'weekly' | 'twice_monthly' | 'monthly';
+export type BriefingScheduleFrequency = 'daily' | 'weekly' | 'monthly';
+/** 1 to 4 count from the start of the month; -1 is the last one. */
+export type BriefingScheduleOrdinal = 1 | 2 | 3 | 4 | -1;
+/** Day of the month, or the last day whatever its number. */
+export type BriefingScheduleMonthDay = number | 'last';
+/** Months between runs. Divisors of 12, so a month list states them exactly. */
+export type BriefingScheduleMonthInterval = 1 | 2 | 3 | 6 | 12;
+export type BriefingScheduleMonthlyOn = {
+    type: 'days';
+    days: BriefingScheduleMonthDay[];
+} | {
+    type: 'weekday';
+    ordinal: BriefingScheduleOrdinal;
+    weekday: number;
+};
 export type BriefingScheduleViewModel = {
-    cadence: BriefingScheduleCadence;
+    frequency: 'daily';
+    hour: number;
+    minute: number;
+    weekdaysOnly: boolean;
+} | {
+    frequency: 'weekly';
     hour: number;
     minute: number;
     weekdays: number[];
+} | {
+    frequency: 'monthly';
+    hour: number;
+    minute: number;
+    /** Every N months. */
+    interval: BriefingScheduleMonthInterval;
+    /** First month (0 = January) of the cycle; 0 when interval is 1. */
+    startMonth: number;
+    on: BriefingScheduleMonthlyOn;
 };
 export declare const DEFAULT_BRIEFING_SCHEDULE: BriefingScheduleViewModel;
 export declare function isValidBriefingTimezone(value: unknown): value is string;
+/** Ascending unique day numbers, then 'last' if present; null when invalid. */
+export declare function canonicalBriefingMonthDays(days: BriefingScheduleMonthDay[]): BriefingScheduleMonthDay[] | null;
+/** Months (0 = January) a monthly rule runs in, ascending. */
+export declare function briefingScheduleMonths(interval: BriefingScheduleMonthInterval, startMonth: number): number[];
 export declare function buildBriefingScheduleExpr(view: BriefingScheduleViewModel): string;
 export declare function parseBriefingScheduleExpr(expression: string): {
     ok: true;
@@ -16,3 +48,18 @@ export declare function parseBriefingScheduleExpr(expression: string): {
     issue: string;
 };
 export declare function describeBriefingSchedule(expression: string, timezone: string, locale?: string): string | null;
+/** Whether a day of the month ever occurs in any of these months. */
+export declare function briefingScheduleDayOccurs(day: BriefingScheduleMonthDay, months: number[]): boolean;
+/**
+ * The latest chosen day that some months lack, and those months (a 31st has
+ * no run in April). Cron skips those months rather than moving the run.
+ */
+export declare function briefingScheduleShortMonths(view: BriefingScheduleViewModel): {
+    day: number;
+    months: number[];
+} | null;
+/**
+ * The next `count` dates (YYYY-MM-DD in the schedule's timezone) a schedule
+ * runs on after `from`, or [] for an unsupported rule.
+ */
+export declare function nextBriefingScheduleDates(expression: string, timezone: string, from: Date, count: number): string[];

package/dist/types/components/briefings/briefing-author/form-primitives.d.ts

@@ -1,6 +1,6 @@
 export declare function RadioRow({ label, description, checked, onSelect, name, }: {
     label: string;
-    description: string;
+    description?: string;
     checked: boolean;
     onSelect: () => void;
     name: string;

package/dist/types/components/briefings/briefing-author/schedule-model.d.ts

@@ -1,3 +1,13 @@
-export { DEFAULT_BRIEFING_SCHEDULE as DEFAULT_SCHEDULE_VM, buildBriefingScheduleExpr as buildScheduleExpr, describeBriefingSchedule as describeScheduleExpr, parseBriefingScheduleExpr, type BriefingScheduleCadence as ScheduleRepeats, type BriefingScheduleViewModel as ScheduleViewModel, } from '../../../briefings/schedule.js';
+import { BriefingScheduleViewModel } from '../../../briefings/schedule.js';
+export { DEFAULT_BRIEFING_SCHEDULE as DEFAULT_SCHEDULE_VM, briefingScheduleDayOccurs, briefingScheduleMonths, briefingScheduleShortMonths, buildBriefingScheduleExpr as buildScheduleExpr, canonicalBriefingMonthDays, describeBriefingSchedule as describeScheduleExpr, nextBriefingScheduleDates, parseBriefingScheduleExpr, type BriefingScheduleFrequency as ScheduleFrequency, type BriefingScheduleMonthDay as ScheduleMonthDay, type BriefingScheduleMonthInterval as ScheduleMonthInterval, type BriefingScheduleOrdinal as ScheduleOrdinal, type BriefingScheduleViewModel as ScheduleViewModel, } from '../../../briefings/schedule.js';
 export declare function formatTimeLabel(hour: number, minute: number): string;
-export declare const COMMON_TIMEZONES: string[];
+/**
+ * Moves a schedule to another frequency, preserving the time and weekday
+ * choices where they carry over.
+ */
+export declare function withFrequency(view: BriefingScheduleViewModel, frequency: BriefingScheduleViewModel['frequency']): BriefingScheduleViewModel;
+export declare function currentTimezoneId(timezone: string): string;
+/** Every IANA zone the browser knows, current IDs, UTC first. */
+export declare function listTimezones(): string[];
+export declare function timezoneName(timezone: string, style: 'longGeneric' | 'shortOffset', at?: Date): string;
+export declare function timezoneMatches(timezone: string, query: string): boolean;

package/dist/types/components/sharing-and-management/hooks/use-groups.d.ts

@@ -1,5 +1,9 @@
 import { Group, GroupListResponse, GroupSearchParams, GroupWithMembers } from '../utils/group-types.js';
-export declare function useGroups(params?: GroupSearchParams): {
+/** Groups the caller may see; `keepPrevious` as in `useUnifiedUsers`. */
+export declare function useGroups(params?: GroupSearchParams, options?: {
+    enabled?: boolean;
+    keepPrevious?: boolean;
+}): {
     groups: Group[];
     total: number;
     hasMore: boolean;

package/dist/types/components/sharing-and-management/hooks/use-unified-users.d.ts

@@ -41,7 +41,15 @@ export interface UnifiedUsersResponse {
     total: number;
     userContext: UserContext;
 }
-export declare function useUnifiedUsers(params?: UserSearchParams): {
+/**
+ * Users the caller may see, searched and filtered on the server.
+ * `keepPrevious` keeps the last results on screen while a new search loads,
+ * for search-as-you-type pickers.
+ */
+export declare function useUnifiedUsers(params?: UserSearchParams, options?: {
+    enabled?: boolean;
+    keepPrevious?: boolean;
+}): {
     users: UnifiedUser[];
     userContext: UserContext | undefined;
     total: number;

package/dist/types/components/sharing-and-management/resource-share-dialog/index.d.ts

@@ -1,4 +1,4 @@
-import { MinimalResourceForSharing, ResourceType } from '../utils/types.js';
+import { ResourceType, MinimalResourceForSharing } from '../utils/types.js';
 interface ShareDialogProps {
     resource: MinimalResourceForSharing;
     resourceType: ResourceType;

package/dist/types/components/sharing-and-management/resource-share-dialog/unified/adapter.d.ts

@@ -24,10 +24,30 @@ export declare function buildTenantDirectory(input: {
     groups: Group[];
     currentUser: CurrentUser | null;
 }): Entity[];
-export declare function buildShares({ existingShares, userDirectory, groupDirectory, tenantDirectory, currentUser, }: {
+/**
+ * Directory for a tenant-created dashboard: organization users and groups,
+ * the owning tenant's users and groups, "Everyone in the organization" and
+ * "Everyone in <tenant>". Anything from another tenant is left out, even if
+ * a search returned it.
+ */
+export declare function buildTenantCreatedDirectory(input: {
+    users: UnifiedUser[];
+    groups: Group[];
+    ownerTenant: {
+        id: string;
+        name: string;
+    };
+}): Entity[];
+export declare function buildShares({ existingShares, userDirectory, groupDirectory, tenantDirectory, currentUser, ownerTenant, }: {
     existingShares: SharesResponse | undefined;
     userDirectory: UnifiedUser[];
     groupDirectory: Group[];
     tenantDirectory: ProductionTenant[];
     currentUser: CurrentUser | null;
+    /** A tenant-created dashboard's tenant: its whole-tenant grant reads as
+     *  "Everyone in <tenant>", as the picker offers it. */
+    ownerTenant?: {
+        id: string;
+        name: string;
+    };
 }): Share[];

package/dist/types/components/sharing-and-management/resource-share-dialog/unified/configs.d.ts

@@ -23,6 +23,18 @@ export type ShareShapeConfig = {
     unifiedUsersType: 'tenant' | 'organization' | 'all';
     /** which group types `useGroups` should fetch */
     groupsType: 'ORG_GROUP' | 'TENANT_GROUP' | 'all';
+    /**
+     * A dashboard created in this tenant: it can be shared only within the
+     * tenant and with the organization, so only those are loaded and offered.
+     */
+    ownerTenant?: {
+        id: string;
+        name: string;
+    };
 };
 export declare const ORG_USER_SHARE_CONFIG: ShareShapeConfig;
 export declare function buildTenantShareConfig(_currentUser: CurrentUser | null): ShareShapeConfig;
+export declare function buildTenantCreatedShareConfig(ownerTenant: {
+    id: string;
+    name: string;
+}): ShareShapeConfig;

package/dist/types/components/sharing-and-management/resource-share-dialog/unified/invite-combobox.d.ts

@@ -13,5 +13,10 @@ export type InviteComboboxProps = {
     onSubmit: () => void;
     isSubmitting?: boolean;
     viewerType: 'organization' | 'tenant' | null | undefined;
+    /** The typed text (trimmed), so the caller can search the server. */
+    onSearchChange?: (query: string) => void;
+    /** The tenant being browsed (null when none), so the caller can load
+     *  that tenant's users. */
+    onDrilledTenantChange?: (tenantId: string | null) => void;
 };
 export declare function InviteCombobox(props: InviteComboboxProps): import("react").JSX.Element;

package/dist/types/components/sharing-and-management/resource-share-dialog/unified/share-shape.d.ts

@@ -1,6 +1,13 @@
 import { MinimalResourceForSharing, ResourceType } from '../../utils/types.js';
 import { CurrentUser } from '../../hooks/use-current-user-info.js';
 import { ShareShapeConfig } from './configs.js';
+/** Pause after typing before searching the server. */
+export declare const SHARE_SEARCH_DELAY_MS = 250;
+/** Matches per search, and groups per search. */
+export declare const SHARE_SEARCH_PAGE_SIZE = 50;
+/** Users loaded when browsing one tenant: every user of the largest tenant
+ *  measured (91 on 2026-10-01) fits, with room to grow. */
+export declare const TENANT_BROWSE_PAGE_SIZE = 200;
 type ShareShapeProps = {
     open: boolean;
     resource: MinimalResourceForSharing;

package/dist/types/components/sharing-and-management/resource-share-dialog/unified/types.d.ts

@@ -11,6 +11,8 @@ export type Entity = {
      *  live in */
     tenantId?: string;
     tenantName?: string;
+    /** for a tenant: every user in it, counted on the server */
+    userCount?: number;
     /** initial used by the avatar primitive when no glyph is appropriate */
     initial: string;
 };

package/dist/types/components/sharing-and-management/utils/shares-types.d.ts

@@ -119,4 +119,12 @@ export type Shares = {
 };
 export type SharesResponse = {
     shares: Shares;
+    /**
+     * Dashboards: the tenant the dashboard was created in, or null for an
+     * organization dashboard. The share dialog takes its shape from it.
+     */
+    ownerTenant?: {
+        id: string;
+        name: string;
+    } | null;
 };

package/dist/types/components/sharing-and-management/utils/types.d.ts

@@ -17,6 +17,8 @@ export interface User {
 export interface Tenant {
     id: string;
     name: string;
+    /** Every user in the tenant, counted on the server (tenants API). */
+    userCount?: number;
 }
 export interface SelectedUser {
     id: string;

package/dist/types/components/ui/resizable.d.ts

@@ -1,6 +1,6 @@
 import * as ResizablePrimitive from "react-resizable-panels";
 declare const ResizablePanelGroup: ({ className, ...props }: React.ComponentProps<typeof ResizablePrimitive.PanelGroup>) => import("react").JSX.Element;
-declare const ResizablePanel: import('react').ForwardRefExoticComponent<Omit<import('react').HTMLAttributes<HTMLElement | HTMLObjectElement | HTMLMapElement | HTMLLabelElement | HTMLSourceElement | HTMLInputElement | HTMLTimeElement | HTMLTableElement | HTMLBodyElement | HTMLStyleElement | HTMLTitleElement | HTMLAreaElement | HTMLOutputElement | HTMLLinkElement | HTMLProgressElement | HTMLHRElement | HTMLAnchorElement | HTMLDataElement | HTMLBaseElement | HTMLCanvasElement | HTMLAudioElement | HTMLQuoteElement | HTMLBRElement | HTMLButtonElement | HTMLTableCaptionElement | HTMLTableColElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDivElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHeadElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMenuElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLParagraphElement | HTMLPictureElement | HTMLPreElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSpanElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement>, "id" | "onResize"> & {
+declare const ResizablePanel: import('react').ForwardRefExoticComponent<Omit<import('react').HTMLAttributes<HTMLElement | HTMLObjectElement | HTMLMapElement | HTMLLabelElement | HTMLSourceElement | HTMLInputElement | HTMLTimeElement | HTMLTableElement | HTMLBodyElement | HTMLStyleElement | HTMLTitleElement | HTMLAreaElement | HTMLOutputElement | HTMLLinkElement | HTMLProgressElement | HTMLHRElement | HTMLAnchorElement | HTMLDataElement | HTMLBaseElement | HTMLTableCellElement | HTMLCanvasElement | HTMLAudioElement | HTMLQuoteElement | HTMLBRElement | HTMLButtonElement | HTMLTableCaptionElement | HTMLTableColElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDivElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHeadElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMenuElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLParagraphElement | HTMLPictureElement | HTMLPreElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSpanElement | HTMLTableSectionElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement>, "id" | "onResize"> & {
     className?: string | undefined;
     collapsedSize?: number | undefined;
     collapsible?: boolean | undefined;

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;

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/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.524",
+  "version": "0.1.525",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",