react-semaphor 0.1.302 → 0.1.304

package/dist/types/shared.d.ts

@@ -326,6 +326,11 @@ declare type ControlBinding = {
     mapping: Record<string, string>;
 };
 
+declare type ControlDashboardInput = DashboardInputBase & {
+    kind: 'control';
+    control: ControlDefinition;
+};
+
 declare type ControlDefinition = {
     id: string;
     label: string;
@@ -382,6 +387,109 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
+
+declare type DashboardInputBase = {
+    id: string;
+    label: string;
+    variableName: string;
+    description?: string;
+    requiredAtExecution?: boolean;
+    scope: DashboardInputScope;
+    runtimeScope: DashboardInputRuntimeScope;
+    presentation?: DashboardInputPresentation;
+    exports?: DashboardInputExportKey[];
+    compatibility?: DashboardInputCompatibilityMetadata;
+};
+
+declare type DashboardInputCompatibilityMetadata = {
+    source: 'dashboardFilter';
+    filterId: string;
+} | {
+    source: 'dashboardControl';
+    controlId: string;
+} | {
+    source: 'cardInlineFilter';
+    cardId: string;
+    filterId: string;
+} | {
+    source: 'cardControl';
+    cardId: string;
+    controlId: string;
+} | {
+    source: 'documentInput';
+    sheetId: string;
+    inputId: string;
+};
+
+declare type DashboardInputExportKey = 'label' | 'value' | 'start' | 'end' | 'range';
+
+declare type DashboardInputPresentation = {
+    placement?: 'toolbar' | 'card_header' | 'advanced' | 'hidden';
+    widthPx?: number;
+    order?: number;
+};
+
+declare type DashboardInputRuntimeScope = 'shared' | 'perSheet' | 'perCard' | 'perDocumentSection';
+
+declare type DashboardInputScope = {
+    kind: 'allSheets';
+    sheetKinds?: Array<'dashboard' | 'document'>;
+} | {
+    kind: 'sheets';
+    sheetIds: string[];
+} | {
+    kind: 'cards';
+    cardIds: string[];
+} | {
+    kind: 'documentSections';
+    sheetId: string;
+    sectionIds: string[];
+};
+
+declare type DashboardInputSlot = {
+    status: 'set';
+    value: DashboardInputValue;
+} | {
+    status: 'cleared';
+};
+
+declare type DashboardInputTextContent = Array<{
+    type: 'text';
+    value: string;
+} | {
+    type: 'variable';
+    ref: DashboardInputVariableRef;
+}>;
+
+declare type DashboardInputValue = {
+    kind: 'filter';
+    filterValue: TFilterValue;
+} | {
+    kind: 'control';
+    value: unknown;
+};
+
+declare type DashboardInputValues = {
+    shared?: Record<string, DashboardInputSlot>;
+    bySheetId?: Record<string, Record<string, DashboardInputSlot>>;
+    byCardId?: Record<string, Record<string, DashboardInputSlot>>;
+    byDocumentSectionId?: Record<string, Record<string, DashboardInputSlot>>;
+};
+
+declare type DashboardInputVariableRef = {
+    source: 'dashboardInput';
+    inputId: string;
+    export: DashboardInputExportKey;
+} | {
+    source: 'dashboardInputAlias';
+    variableName: string;
+    export?: DashboardInputExportKey;
+} | {
+    source: 'documentMeta';
+    key: 'generatedAt' | 'pageNumber' | 'pageCount';
+};
+
 declare interface DatabaseEntityReference {
     connectionId: string;
     connectionType: ConnectionType;
@@ -920,6 +1028,11 @@ declare interface FilterCondition {
     value: FilterValue;
 }
 
+declare type FilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -1683,6 +1796,7 @@ declare type TCardPreferences = {
     customVisualCode?: string;
     textVisualOptions?: {
         isDynamicText?: boolean;
+        content?: DashboardInputTextContent;
     };
     mapVisualOptions?: {
         topoJsonUrl?: string;
@@ -1846,6 +1960,8 @@ declare type TDashboard = {
     defaultFilterValues?: TFilterValue[];
     controls?: ControlDefinition[];
     defaultControlValues?: Record<string, unknown>;
+    inputs?: DashboardInput[];
+    defaultInputValues?: DashboardInputValues;
     filterLayout?: FilterLayoutSettings;
 };
 
@@ -1950,6 +2066,8 @@ declare type TFilter = {
     location?: FilterLocation;
     hide?: boolean;
     id: string;
+    /** Alias exposed to document/text variables, for example {{region}}. */
+    variableName?: string;
     connectionId: string;
     title: string;
     column: string;
@@ -2081,6 +2199,8 @@ declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year' | '
  */
 declare type TInlineFilter = {
     id: string;
+    /** Alias exposed to document/text variables, for example {{region}}. */
+    variableName?: string;
     column: string;
     title: string;
     dataType: string;

package/dist/types/surfboard.d.ts

@@ -434,6 +434,11 @@ export declare type ControlBinding = {
     mapping: Record<string, string>;
 };
 
+export declare type ControlDashboardInput = DashboardInputBase & {
+    kind: 'control';
+    control: ControlDefinition;
+};
+
 export declare type ControlDefinition = {
     id: string;
     label: string;
@@ -494,6 +499,118 @@ export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
 
+export declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
+
+export declare type DashboardInputBase = {
+    id: string;
+    label: string;
+    variableName: string;
+    description?: string;
+    requiredAtExecution?: boolean;
+    scope: DashboardInputScope;
+    runtimeScope: DashboardInputRuntimeScope;
+    presentation?: DashboardInputPresentation;
+    exports?: DashboardInputExportKey[];
+    compatibility?: DashboardInputCompatibilityMetadata;
+};
+
+export declare type DashboardInputCompatibilityMetadata = {
+    source: 'dashboardFilter';
+    filterId: string;
+} | {
+    source: 'dashboardControl';
+    controlId: string;
+} | {
+    source: 'cardInlineFilter';
+    cardId: string;
+    filterId: string;
+} | {
+    source: 'cardControl';
+    cardId: string;
+    controlId: string;
+} | {
+    source: 'documentInput';
+    sheetId: string;
+    inputId: string;
+};
+
+export declare type DashboardInputExecutionSnapshot = {
+    sheetId?: string;
+    cardId?: string;
+    mode: 'dashboard' | 'document' | 'visual';
+    dashboardInputValues: DashboardInputValues;
+    generatedAt?: string;
+    timezone?: string;
+};
+
+export declare type DashboardInputExportKey = 'label' | 'value' | 'start' | 'end' | 'range';
+
+export declare type DashboardInputPresentation = {
+    placement?: 'toolbar' | 'card_header' | 'advanced' | 'hidden';
+    widthPx?: number;
+    order?: number;
+};
+
+export declare type DashboardInputRuntimeScope = 'shared' | 'perSheet' | 'perCard' | 'perDocumentSection';
+
+export declare type DashboardInputScope = {
+    kind: 'allSheets';
+    sheetKinds?: Array<'dashboard' | 'document'>;
+} | {
+    kind: 'sheets';
+    sheetIds: string[];
+} | {
+    kind: 'cards';
+    cardIds: string[];
+} | {
+    kind: 'documentSections';
+    sheetId: string;
+    sectionIds: string[];
+};
+
+export declare type DashboardInputSlot = {
+    status: 'set';
+    value: DashboardInputValue;
+} | {
+    status: 'cleared';
+};
+
+export declare type DashboardInputTextContent = Array<{
+    type: 'text';
+    value: string;
+} | {
+    type: 'variable';
+    ref: DashboardInputVariableRef;
+}>;
+
+export declare type DashboardInputValue = {
+    kind: 'filter';
+    filterValue: TFilterValue;
+} | {
+    kind: 'control';
+    value: unknown;
+};
+
+export declare type DashboardInputValues = {
+    shared?: Record<string, DashboardInputSlot>;
+    bySheetId?: Record<string, Record<string, DashboardInputSlot>>;
+    byCardId?: Record<string, Record<string, DashboardInputSlot>>;
+    byDocumentSectionId?: Record<string, Record<string, DashboardInputSlot>>;
+};
+
+export declare type DashboardInputVariableRef = {
+    source: 'dashboardInput';
+    inputId: string;
+    export: DashboardInputExportKey;
+} | {
+    source: 'dashboardInputAlias';
+    variableName: string;
+    export?: DashboardInputExportKey;
+} | {
+    source: 'documentMeta';
+    key: 'generatedAt' | 'pageNumber' | 'pageCount';
+};
+
 declare type DashboardPlusProps = {
     showControls?: boolean;
     showFooter?: boolean;
@@ -554,8 +671,17 @@ export declare type DashboardProps = {
      * Document-local runtime values for print/render entry points. Values are
      * keyed by document input id and are intentionally separate from dashboard
      * filters/controls.
+     *
+     * @deprecated Use dashboardInputExecutionSnapshot for document print/export
+     * entry points backed by DashboardInput.
      */
     documentInputValues?: DocumentInputRuntimeValues;
+    /**
+     * Authoritative dashboard input runtime snapshot for print/render entry
+     * points. Document print/export should use this for DashboardInput-backed
+     * inputs instead of documentInputValues.
+     */
+    dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
     /**
      * Render target for print entry points. Generic dashboard PDF exports also
      * use cardDisplay.mode="print"; document-specific print handling must only
@@ -1162,6 +1288,11 @@ declare interface FilterCondition {
     value: FilterValue;
 }
 
+export declare type FilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -1640,6 +1771,36 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+export declare type ResolvedDashboardInput = {
+    id: string;
+    kind: 'filter' | 'control';
+    label: string;
+    variableName: string;
+    requiredAtExecution: boolean;
+    slot?: DashboardInputSlot;
+    rawValue?: unknown;
+    displayValue: string;
+    exports: Partial<Record<DashboardInputExportKey, string | number | boolean | null>>;
+    filter?: TFilter;
+    filterValue?: TFilterValue;
+    control?: ControlDefinition;
+    controlValue?: unknown;
+    missingRequiredValue?: boolean;
+};
+
+export declare type ResolvedDashboardInputContext = {
+    inputs: DashboardInput[];
+    resolvedInputs: ResolvedDashboardInput[];
+    activeFilters: TFilterValue[];
+    controlDefinitions: ControlDefinition[];
+    cardControlDefinitions: ControlDefinition[];
+    controlBindings: ControlBinding[];
+    controlValues: Record<string, unknown>;
+    variablesByName: Record<string, ResolvedDashboardInput>;
+    variablesById: Record<string, ResolvedDashboardInput>;
+    missingRequiredInputs: ResolvedDashboardInput[];
+};
+
 export declare type ResolvedDocumentInput = {
     inputId: string;
     variableName: string;
@@ -2060,6 +2221,7 @@ export declare type TCardPreferences = {
     customVisualCode?: string;
     textVisualOptions?: {
         isDynamicText?: boolean;
+        content?: DashboardInputTextContent;
     };
     mapVisualOptions?: {
         topoJsonUrl?: string;
@@ -2223,6 +2385,8 @@ export declare type TDashboard = {
     defaultFilterValues?: TFilterValue[];
     controls?: ControlDefinition[];
     defaultControlValues?: Record<string, unknown>;
+    inputs?: DashboardInput[];
+    defaultInputValues?: DashboardInputValues;
     filterLayout?: FilterLayoutSettings;
 };
 
@@ -2354,6 +2518,8 @@ declare type TFilter = {
     location?: FilterLocation;
     hide?: boolean;
     id: string;
+    /** Alias exposed to document/text variables, for example {{region}}. */
+    variableName?: string;
     connectionId: string;
     title: string;
     column: string;
@@ -2487,6 +2653,8 @@ declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year' | '
  */
 export declare type TInlineFilter = {
     id: string;
+    /** Alias exposed to document/text variables, for example {{region}}. */
+    variableName?: string;
     column: string;
     title: string;
     dataType: string;

package/dist/types/types.d.ts

@@ -671,6 +671,11 @@ export declare type ControlBinding = {
     mapping: Record<string, string>;
 };
 
+export declare type ControlDashboardInput = DashboardInputBase & {
+    kind: 'control';
+    control: ControlDefinition;
+};
+
 export declare type ControlDefinition = {
     id: string;
     label: string;
@@ -751,6 +756,118 @@ export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
 
+export declare type DashboardInput = FilterDashboardInput | ControlDashboardInput;
+
+export declare type DashboardInputBase = {
+    id: string;
+    label: string;
+    variableName: string;
+    description?: string;
+    requiredAtExecution?: boolean;
+    scope: DashboardInputScope;
+    runtimeScope: DashboardInputRuntimeScope;
+    presentation?: DashboardInputPresentation;
+    exports?: DashboardInputExportKey[];
+    compatibility?: DashboardInputCompatibilityMetadata;
+};
+
+export declare type DashboardInputCompatibilityMetadata = {
+    source: 'dashboardFilter';
+    filterId: string;
+} | {
+    source: 'dashboardControl';
+    controlId: string;
+} | {
+    source: 'cardInlineFilter';
+    cardId: string;
+    filterId: string;
+} | {
+    source: 'cardControl';
+    cardId: string;
+    controlId: string;
+} | {
+    source: 'documentInput';
+    sheetId: string;
+    inputId: string;
+};
+
+export declare type DashboardInputExecutionSnapshot = {
+    sheetId?: string;
+    cardId?: string;
+    mode: 'dashboard' | 'document' | 'visual';
+    dashboardInputValues: DashboardInputValues;
+    generatedAt?: string;
+    timezone?: string;
+};
+
+export declare type DashboardInputExportKey = 'label' | 'value' | 'start' | 'end' | 'range';
+
+export declare type DashboardInputPresentation = {
+    placement?: 'toolbar' | 'card_header' | 'advanced' | 'hidden';
+    widthPx?: number;
+    order?: number;
+};
+
+export declare type DashboardInputRuntimeScope = 'shared' | 'perSheet' | 'perCard' | 'perDocumentSection';
+
+export declare type DashboardInputScope = {
+    kind: 'allSheets';
+    sheetKinds?: Array<'dashboard' | 'document'>;
+} | {
+    kind: 'sheets';
+    sheetIds: string[];
+} | {
+    kind: 'cards';
+    cardIds: string[];
+} | {
+    kind: 'documentSections';
+    sheetId: string;
+    sectionIds: string[];
+};
+
+export declare type DashboardInputSlot = {
+    status: 'set';
+    value: DashboardInputValue;
+} | {
+    status: 'cleared';
+};
+
+export declare type DashboardInputTextContent = Array<{
+    type: 'text';
+    value: string;
+} | {
+    type: 'variable';
+    ref: DashboardInputVariableRef;
+}>;
+
+export declare type DashboardInputValue = {
+    kind: 'filter';
+    filterValue: TFilterValue;
+} | {
+    kind: 'control';
+    value: unknown;
+};
+
+export declare type DashboardInputValues = {
+    shared?: Record<string, DashboardInputSlot>;
+    bySheetId?: Record<string, Record<string, DashboardInputSlot>>;
+    byCardId?: Record<string, Record<string, DashboardInputSlot>>;
+    byDocumentSectionId?: Record<string, Record<string, DashboardInputSlot>>;
+};
+
+export declare type DashboardInputVariableRef = {
+    source: 'dashboardInput';
+    inputId: string;
+    export: DashboardInputExportKey;
+} | {
+    source: 'dashboardInputAlias';
+    variableName: string;
+    export?: DashboardInputExportKey;
+} | {
+    source: 'documentMeta';
+    key: 'generatedAt' | 'pageNumber' | 'pageCount';
+};
+
 /**
  * Unified dashboard preferences for both card display and UI modes
  */
@@ -806,8 +923,17 @@ export declare type DashboardProps = {
      * Document-local runtime values for print/render entry points. Values are
      * keyed by document input id and are intentionally separate from dashboard
      * filters/controls.
+     *
+     * @deprecated Use dashboardInputExecutionSnapshot for document print/export
+     * entry points backed by DashboardInput.
      */
     documentInputValues?: DocumentInputRuntimeValues;
+    /**
+     * Authoritative dashboard input runtime snapshot for print/render entry
+     * points. Document print/export should use this for DashboardInput-backed
+     * inputs instead of documentInputValues.
+     */
+    dashboardInputExecutionSnapshot?: DashboardInputExecutionSnapshot;
     /**
      * Render target for print entry points. Generic dashboard PDF exports also
      * use cardDisplay.mode="print"; document-specific print handling must only
@@ -1431,6 +1557,11 @@ declare interface FilterCondition {
     value: FilterValue;
 }
 
+export declare type FilterDashboardInput = DashboardInputBase & {
+    kind: 'filter';
+    filter: TFilter;
+};
+
 /**
  * Display mode for individual filters
  * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
@@ -1926,6 +2057,36 @@ declare type RelativeDateFilter = {
     to: number;
 };
 
+export declare type ResolvedDashboardInput = {
+    id: string;
+    kind: 'filter' | 'control';
+    label: string;
+    variableName: string;
+    requiredAtExecution: boolean;
+    slot?: DashboardInputSlot;
+    rawValue?: unknown;
+    displayValue: string;
+    exports: Partial<Record<DashboardInputExportKey, string | number | boolean | null>>;
+    filter?: TFilter;
+    filterValue?: TFilterValue;
+    control?: ControlDefinition;
+    controlValue?: unknown;
+    missingRequiredValue?: boolean;
+};
+
+export declare type ResolvedDashboardInputContext = {
+    inputs: DashboardInput[];
+    resolvedInputs: ResolvedDashboardInput[];
+    activeFilters: TFilterValue[];
+    controlDefinitions: ControlDefinition[];
+    cardControlDefinitions: ControlDefinition[];
+    controlBindings: ControlBinding[];
+    controlValues: Record<string, unknown>;
+    variablesByName: Record<string, ResolvedDashboardInput>;
+    variablesById: Record<string, ResolvedDashboardInput>;
+    missingRequiredInputs: ResolvedDashboardInput[];
+};
+
 export declare type ResolvedDocumentInput = {
     inputId: string;
     variableName: string;
@@ -2388,6 +2549,7 @@ export declare type TCardPreferences = {
     customVisualCode?: string;
     textVisualOptions?: {
         isDynamicText?: boolean;
+        content?: DashboardInputTextContent;
     };
     mapVisualOptions?: {
         topoJsonUrl?: string;
@@ -2551,6 +2713,8 @@ export declare type TDashboard = {
     defaultFilterValues?: TFilterValue[];
     controls?: ControlDefinition[];
     defaultControlValues?: Record<string, unknown>;
+    inputs?: DashboardInput[];
+    defaultInputValues?: DashboardInputValues;
     filterLayout?: FilterLayoutSettings;
 };
 
@@ -2682,6 +2846,8 @@ declare type TFilter = {
     location?: FilterLocation;
     hide?: boolean;
     id: string;
+    /** Alias exposed to document/text variables, for example {{region}}. */
+    variableName?: string;
     connectionId: string;
     title: string;
     column: string;
@@ -2815,6 +2981,8 @@ declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year' | '
  */
 export declare type TInlineFilter = {
     id: string;
+    /** Alias exposed to document/text variables, for example {{region}}. */
+    variableName?: string;
     column: string;
     title: string;
     dataType: string;

package/package.json

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

package/dist/chunks/braces-CpOcaBNm.js

@@ -1,6 +0,0 @@
-"use strict";const e=require("./switch-AmoR1YIA.js");/**
- * @license lucide-react v0.453.0 - ISC
- *
- * This source code is licensed under the ISC license.
- * See the LICENSE file in the root directory of this source tree.
- */const a=e.createLucideIcon("Braces",[["path",{d:"M8 3H7a2 2 0 0 0-2 2v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5c0 1.1.9 2 2 2h1",key:"ezmyqa"}],["path",{d:"M16 21h1a2 2 0 0 0 2-2v-5c0-1.1.9-2 2-2a2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1",key:"e1hn23"}]]);exports.Braces=a;

package/dist/chunks/braces-TYclg8Hl.js

@@ -1,23 +0,0 @@
-import { c as a } from "./switch-CZtMtqEj.js";
-/**
- * @license lucide-react v0.453.0 - ISC
- *
- * This source code is licensed under the ISC license.
- * See the LICENSE file in the root directory of this source tree.
- */
-const c = a("Braces", [
-  [
-    "path",
-    { d: "M8 3H7a2 2 0 0 0-2 2v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5c0 1.1.9 2 2 2h1", key: "ezmyqa" }
-  ],
-  [
-    "path",
-    {
-      d: "M16 21h1a2 2 0 0 0 2-2v-5c0-1.1.9-2 2-2a2 2 0 0 1-2-2V5a2 2 0 0 0-2-2h-1",
-      key: "e1hn23"
-    }
-  ]
-]);
-export {
-  c as B
-};