react-semaphor 0.1.506 → 0.1.508

package/dist/types/lib/types/interaction-types.d.ts

@@ -26,7 +26,7 @@ export interface InteractionTrigger {
      */
     field: Field;
 }
-export type DrillMode = 'drillDown' | 'dynamicDrill' | 'drillThrough' | 'drillToDetail' | 'drillToURL' | 'inlineDrill';
+export type DrillMode = 'drillDown' | 'dynamicDrill' | 'drillThrough' | 'drillToDetail' | 'drillToURL';
 export interface DrillHierarchy {
     id: string;
     label?: string;
@@ -150,41 +150,6 @@ export interface DrillToURLInteraction {
      */
     label?: string;
 }
-export interface InlineDrillInteraction {
-    mode: 'inlineDrill';
-    /**
-     * What element must be clicked to trigger this inline drill.
-     * @migration Optional during migration. Will be required in V2.
-     */
-    trigger?: InteractionTrigger;
-    filterFields: Field[];
-    /**
-     * When to fetch the detailed data
-     * @default 'lazy'
-     */
-    fetchMode?: 'lazy' | 'preloaded';
-    /**
-     * Maximum number of records to show (0 for unlimited)
-     * @default 100
-     */
-    inlineLimit?: number;
-    /**
-     * How to display the detailed records
-     * @default 'table'
-     */
-    displayMode?: 'table' | 'list' | 'cards';
-    /**
-     * Whether to show records in a modal overlay
-     * @default false
-     */
-    showInModal?: boolean;
-    /**
-     * Whether to allow exporting the detailed records
-     * @default true
-     */
-    allowExport?: boolean;
-    label?: string;
-}
 export interface DrillUpInteraction {
     mode: 'drillUp';
     /**
@@ -224,7 +189,7 @@ export interface DynamicDrillInteraction {
      */
     drillField?: Field;
 }
-export type DrillInteraction = DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction | InlineDrillInteraction;
+export type DrillInteraction = DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction;
 export interface TimeDrillStep {
     granularity: TimeGranularity;
     next?: TimeGranularity;
@@ -236,10 +201,6 @@ export interface TimeComparison {
     offset: number;
     granularity: TimeGranularity;
 }
-export interface DrillState {
-    hierarchyId?: string;
-    steps: DrillBreadcrumb[];
-}
 export interface ClickFilterInteraction {
     mode: 'clickFilter';
     /**
@@ -255,10 +216,6 @@ export interface ClickFilterInteraction {
      * e.g., [region, ship_mode] from a stacked bar chart
      */
     filterFields: Field[];
-    /**
-     * Should this card visually highlight when clicked?
-     */
-    highlightSelf?: boolean;
     /**
      * Cards this filter applies to (inclusive).
      * If omitted and `excludeCardIds` is also omitted → applies to all cards except self.
@@ -295,39 +252,17 @@ export interface ClickedMetricValue {
     value?: number;
     formattedValue?: string;
 }
-export type InteractionEvent = DrillDownEvent | DynamicDrillEvent | DrillToURLEvent | DrillThroughEvent | DrillToDetailEvent | InlineDrillEvent | ClickFilterEvent;
-export interface BaseInteractionEvent {
+export interface BaseOneOffDrillEvent {
     sourceCardId: string;
     filterGroups: ClickFilterConditionGroup[];
     metric?: ClickedMetricValue;
 }
-export interface DrillDownEvent extends BaseInteractionEvent {
-    interactionMode: 'drillDown';
-    hierarchyId: string;
-    filterGroups: ClickFilterConditionGroup[];
-    metric?: ClickedMetricValue;
-    toField: Field;
-    granularity?: TimeGranularity;
-    timeComparison?: TimeComparison;
-}
-export interface DynamicDrillEvent extends BaseInteractionEvent {
-    interactionMode: 'dynamicDrill';
-    filterGroups: ClickFilterConditionGroup[];
-    metric?: ClickedMetricValue;
-    toField: Field;
-    granularity?: TimeGranularity;
-    timeComparison?: TimeComparison;
-}
-export interface DrillToURLEvent extends BaseInteractionEvent {
-    interactionMode: 'drillToURL';
-    url: string;
-}
-export interface DrillThroughEvent extends BaseInteractionEvent {
+export interface DrillThroughEvent extends BaseOneOffDrillEvent {
     interactionMode: 'drillThrough';
     targetDashboardId: string;
     contextMode?: 'interactionFilters' | 'full' | 'none';
 }
-export interface DrillToDetailEvent extends BaseInteractionEvent {
+export interface DrillToDetailEvent extends BaseOneOffDrillEvent {
     interactionMode: 'drillToDetail';
     detailFields: Field[];
     sortBy?: SortByField[];
@@ -337,79 +272,11 @@ export interface DrillToDetailEvent extends BaseInteractionEvent {
     contextMode?: 'interactionFilters' | 'full' | 'none';
     displayMode?: 'modal' | 'replace-card';
 }
-export interface ClickFilterEvent extends BaseInteractionEvent {
-    interactionMode: 'clickFilter';
-    applyToCardIds?: string[];
-    excludeCardIds?: string[];
-    /**
-     * Whether the source card should receive its own filter.
-     * When true, the source card will be filtered (not just blurred).
-     * Used when user selects from multiple interactions popup.
-     * @default false
-     */
-    filterSourceCard?: boolean;
-}
-export interface InlineDrillEvent extends BaseInteractionEvent {
-    interactionMode: 'inlineDrill';
-    fetchMode?: 'lazy' | 'preloaded';
-    inlineLimit?: number;
-}
-export interface InteractionState {
-    /**
-     * If user is in a drill hierarchy (static or dynamic), this tracks which one.
-     * Undefined if not currently in a drill path.
-     */
-    hierarchyId?: string;
-    /**
-     * Breadcrumb trail representing the user's drill path.
-     * Empty if no drill-down steps have occurred.
-     */
-    breadcrumbs: DrillBreadcrumb[];
-    /**
-     * All click filters applied from this card
-     */
-    appliedClickFilters?: ClickFilterEvent[];
-    /**
-     * (Optional) Track last one-off interaction (e.g., drillToDetail, drillToURL).
-     * Useful for things like modals or redirection handling.
-     */
-    lastInteractionEvent?: InteractionEvent;
-    /**
-     * Context mode for drill-to-insight filtering.
-     * Controls whether dashboard filters are applied alongside interaction filters.
-     *
-     * - 'interactionFilters': Only filters from the interaction event (no dashboard filters)
-     * - 'full': Dashboard filters + interaction filters
-     * - 'none': No filters applied
-     *
-     * Undefined for regular cards (not insights).
-     */
-    contextMode?: 'interactionFilters' | 'full' | 'none';
-    /**
-     * Source dashboard ID for drill-through navigation.
-     * Used for "Back" button navigation.
-     * Only set for global drill context (interactionStates['__DRILL_CONTEXT__']).
-     */
-    sourceDashboardId?: string;
-    /**
-     * Source dashboard title for drill-through navigation.
-     * Used for "Back to [X]" UI display.
-     * Only set for global drill context (interactionStates['__DRILL_CONTEXT__']).
-     */
-    sourceDashboardTitle?: string;
-    /**
-     * Target dashboard ID for drill-through navigation.
-     * Filters only apply when current dashboard matches this ID.
-     * Prevents filters from applying to source dashboard during navigation.
-     * Only set for global drill context (interactionStates['__DRILL_CONTEXT__']).
-     */
-    targetDashboardId?: string;
-}
 /**
  * Unified Interaction type (V2)
  * Combines all interaction types into a single union for the new interactions array.
  */
-export type Interaction = ClickFilterInteraction | DrillDownInteraction | DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction | InlineDrillInteraction | DrillUpInteraction | DynamicDrillInteraction;
+export type Interaction = ClickFilterInteraction | DrillDownInteraction | DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction | DrillUpInteraction | DynamicDrillInteraction;
 export type PersistedInteraction = Interaction & {
     id?: string;
 };
@@ -422,62 +289,3 @@ export interface CardInteractionConfig {
     allowedDrillTargets?: Field[];
     drillHierarchies?: DrillHierarchy[];
 }
-export interface DrillBreadcrumb {
-    /**
-     * The user clicked one or more segments. Each group of filters represents
-     * a single segment (i.e., a single click interaction).
-     *
-     * - Filters within a group are AND-ed (e.g., state = 'NY' AND ship_mode = 'Standard').
-     * - Across groups, they are OR-ed (e.g., ... OR state = 'CA' AND ship_mode = 'First Class').
-     */
-    sourceFilterGroups: ClickFilterConditionGroup[];
-    /**
-     * The next (group by) field the user is drilling into (e.g., 'city' after 'state').
-     */
-    toField?: Field;
-    /**
-     * Optional: If the drill target is a time field, this describes the granularity (e.g., month, year).
-     */
-    granularity?: TimeGranularity;
-    /**
-     * Optional: Indicates whether the drill is for time comparison (e.g., YoY).
-     */
-    timeComparison?: TimeComparison;
-    /**
-     * Optional: The metric the user clicked (e.g., '123 Orders'), used for display only.
-     */
-    metric?: ClickedMetricValue;
-}
-export interface DrillState {
-    /**
-     * Which hierarchy (e.g. 'geo', 'product') is currently active
-     * Omitted for single-step interactions (like drill-through)
-     */
-    hierarchyId?: string;
-    /**
-     * Steps taken in a drill-down path
-     */
-    breadcrumbs: DrillBreadcrumb[];
-}
-export interface DrillStore {
-    /**
-     * Per-card drill state
-     */
-    drillStates: Record<string, DrillState>;
-    /**
-     * Update current drill state for a given card
-     */
-    setDrillState: (cardId: string, state: DrillState) => void;
-    /**
-     * Reset drill state for a given card (e.g. user clicks "reset")
-     */
-    resetDrillState: (cardId: string) => void;
-    /**
-     * Push a new breadcrumb (i.e. drill forward one step)
-     */
-    addDrillStep: (cardId: string, step: DrillBreadcrumb) => void;
-    /**
-     * Go back one step (breadcrumb pop)
-     */
-    popDrillStep: (cardId: string) => void;
-}

package/dist/types/lib/utils/calculate-context-aware-filters.d.ts

@@ -1,10 +1,15 @@
 import { TCard } from '../types/common-types.js';
 import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
-export type ContextMode = 'interactionFilters' | 'full' | 'none' | undefined;
+import { InteractionContextMode, TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
+export type ContextMode = InteractionContextMode | undefined;
 export type CalculateContextAwareFiltersParams = {
     card: TCard;
-    interactionStates: Record<string, any> | undefined;
-    currentDashboardId: string | undefined;
+    /**
+     * The carried contexts this card resolves under: the top navigation entry's
+     * on its destination dashboard, or an insight's own runtime. Required so
+     * that every caller decides.
+     */
+    transientContexts: readonly TransientInputContext[] | undefined;
     filters: TFilter[] | undefined;
     filterValues: TFilterValue[] | undefined;
     selectedSheetId: string | null | undefined;
@@ -16,22 +21,26 @@ export type CalculateContextAwareFiltersResult = {
     contextMode: ContextMode;
 };
 export type ContextAwareFilterPolicy = Pick<CalculateContextAwareFiltersResult, 'shouldApplyDashboardFilters' | 'contextMode'>;
-export declare function resolveContextAwareFilterPolicy({ card, interactionStates, currentDashboardId, }: Pick<CalculateContextAwareFiltersParams, 'card' | 'interactionStates' | 'currentDashboardId'>): ContextAwareFilterPolicy;
+/**
+ * Whether the dashboard's own toolbar filters apply next to what was carried.
+ *
+ * | Mode                 | Own toolbar filters apply |
+ * |----------------------|---------------------------|
+ * | none carried         | yes                       |
+ * | `full`               | yes                       |
+ * | `interactionFilters` | no                        |
+ * | `none`               | no                        |
+ */
+export declare function resolveContextAwareFilterPolicy(transientContexts: readonly TransientInputContext[] | undefined): ContextAwareFilterPolicy;
 /**
  * Calculates context-aware filters for a card, taking into account:
- * - Global drill-through context modes
- * - Card-specific context modes (insight cards)
+ * - The context mode of the carried contexts the card resolves under
  * - Sheet and card-level filter scoping
  *
  * This is a pure function (not a React hook) that can be used in any context,
  * including inside loops, conditionals, and useMemo.
  *
- * Context mode precedence:
- * 1. Global drill context mode (when on target dashboard) - highest priority
- * 2. Card-specific context mode (for insight cards)
- * 3. No context mode (default 'full' behavior)
- *
  * @param params - Object containing all required parameters
  * @returns Object containing filter information and context mode
  */
-export declare function calculateContextAwareFilters({ card, interactionStates, currentDashboardId, filters, filterValues, selectedSheetId, }: CalculateContextAwareFiltersParams): CalculateContextAwareFiltersResult;
+export declare function calculateContextAwareFilters({ card, transientContexts, filters, filterValues, selectedSheetId, }: CalculateContextAwareFiltersParams): CalculateContextAwareFiltersResult;

package/dist/types/lib/utils/card-utils.d.ts

@@ -4,6 +4,17 @@ export type DashboardCardEntry = {
     sheet: TSheet;
 };
 export declare function getDashboardCardEntries(dashboard: Pick<TDashboard, 'sheets'>): DashboardCardEntry[];
+export type DashboardCardLocation = DashboardCardEntry & {
+    /** Set when the card is the visual of a document section. */
+    sectionId?: string;
+};
+/**
+ * Every card a dashboard hosts, with where it sits: sheet cards, frame cards,
+ * and the table or chart of a document section. Use this, not
+ * `getDashboardCardEntries`, when a card may be reached by a scope that names
+ * document sections.
+ */
+export declare function getDashboardCardLocations(dashboard: Pick<TDashboard, 'sheets'>): DashboardCardLocation[];
 export declare function getDashboardCards(dashboard: Pick<TDashboard, 'sheets'>): TCard[];
 /**
  * Check if a card ID is unique across the entire dashboard

package/dist/types/lib/utils/date-hierarchy-utils.d.ts

@@ -70,4 +70,6 @@ export declare function getNextDateHierarchyStep(hierarchy: DrillHierarchy, curr
  * @param breadcrumbs - Optional breadcrumb trail from drill interactions
  * @returns Current granularity level or undefined if not found
  */
-export declare function getCurrentDateGranularity(hierarchy: DrillHierarchy, card: TCard, breadcrumbs?: any[]): TimeGranularity | undefined;
+export declare function getCurrentDateGranularity(hierarchy: DrillHierarchy, card: TCard, breadcrumbs?: readonly {
+    granularity?: TimeGranularity;
+}[]): TimeGranularity | undefined;

package/dist/types/lib/utils/drag-and-drop-utils.d.ts

@@ -4,5 +4,5 @@ import { ShelfDefinitionCard } from './card-definition.js';
 export declare function getFieldId(containerId: ContainerId, field: Field): string;
 export declare function getAggregationLabel(columnName: string, aggregation: AggregateFunction): string;
 export declare function getSmartContainerForField(field: Field, existingFields: Field[], chartType?: TCard['type']): ContainerId | null;
-export declare function getNewField(activeField: Field, overContainer: ContainerId, existingFields?: Field[]): MetricField | GroupByField | PivotByField | SortByField | DetailField | null;
+export declare function getNewField(activeField: Field, overContainer: ContainerId, existingFields?: Field[]): GroupByField | MetricField | PivotByField | DetailField | SortByField | null;
 export declare function isCardConfigPresent(card: ShelfDefinitionCard): boolean;

package/dist/types/lib/utils/interaction-icons.d.ts

@@ -1,5 +1,5 @@
 import { LucideIcon } from 'lucide-react';
-export type InteractionMode = 'clickFilter' | 'drillToDetail' | 'drillThrough' | 'drillToURL' | 'drillDown' | 'drillUp' | 'dynamicDrill' | 'inlineDrill';
+export type InteractionMode = 'clickFilter' | 'drillToDetail' | 'drillThrough' | 'drillToURL' | 'drillDown' | 'drillUp' | 'dynamicDrill';
 /**
  * Get icon component for interaction mode
  */

package/dist/types/shared/analytics-protocol/execution-input-schemas.d.ts

@@ -373,7 +373,7 @@ export declare const configFieldRefSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     name: string;
     label?: string | undefined;
-    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
     source?: {
         kind: "semantic";
@@ -396,7 +396,7 @@ export declare const configFieldRefSchema: z.ZodObject<{
 }, {
     name: string;
     label?: string | undefined;
-    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
     source?: {
         kind: "semantic";
@@ -626,7 +626,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         }, "strict", z.ZodTypeAny, {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -649,7 +649,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         }, {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -676,7 +676,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -703,7 +703,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -731,7 +731,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
     label: string;
     name: string;
     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
     computeStage: "aggregate" | "row";
     expression: string;
     inputs: Record<string, {
@@ -739,7 +739,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -809,7 +809,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
     label: string;
     name: string;
     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
     computeStage: "aggregate" | "row";
     expression: string;
     inputs: Record<string, {
@@ -817,7 +817,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -887,7 +887,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
     label: string;
     name: string;
     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
     computeStage: "aggregate" | "row";
     expression: string;
     inputs: Record<string, {
@@ -895,7 +895,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -965,7 +965,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
     label: string;
     name: string;
     dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-    resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+    resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
     computeStage: "aggregate" | "row";
     expression: string;
     inputs: Record<string, {
@@ -973,7 +973,7 @@ export declare const configDerivedFieldSchema: z.ZodEffects<z.ZodObject<{
         field: {
             name: string;
             label?: string | undefined;
-            role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+            role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
             dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
             source?: {
                 kind: "semantic";
@@ -1307,7 +1307,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             }, "strict", z.ZodTypeAny, {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1330,7 +1330,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             }, {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1357,7 +1357,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1384,7 +1384,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1412,7 +1412,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -1420,7 +1420,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1490,7 +1490,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -1498,7 +1498,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1568,7 +1568,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -1576,7 +1576,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1646,7 +1646,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -1654,7 +1654,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1723,7 +1723,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     name: string;
     label?: string | undefined;
-    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
     source?: {
         kind: "semantic";
@@ -1748,7 +1748,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -1756,7 +1756,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";
@@ -1825,7 +1825,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
 }, {
     name: string;
     label?: string | undefined;
-    role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+    role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
     dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
     source?: {
         kind: "semantic";
@@ -1850,7 +1850,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
         label: string;
         name: string;
         dataType: "string" | "number" | "boolean" | "unknown" | "date" | "datetime";
-        resultRole: "id" | "unknown" | "dimension" | "measure" | "date";
+        resultRole: "unknown" | "dimension" | "measure" | "date" | "id";
         computeStage: "aggregate" | "row";
         expression: string;
         inputs: Record<string, {
@@ -1858,7 +1858,7 @@ export declare const configExecutionFieldSchema: z.ZodObject<{
             field: {
                 name: string;
                 label?: string | undefined;
-                role?: "id" | "unknown" | "dimension" | "measure" | "date" | undefined;
+                role?: "unknown" | "dimension" | "measure" | "date" | "id" | undefined;
                 dataType?: "string" | "number" | "boolean" | "unknown" | "date" | "datetime" | undefined;
                 source?: {
                     kind: "semantic";