react-semaphor 0.1.512 → 0.1.513

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-CdlFHeq9.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-DserKhuQ.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-CrxlydOT.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-CaefWf8W.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

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

package/dist/types/components/calculated-fields/field-picker-panel.d.ts

@@ -4,7 +4,7 @@ import { AvailableFieldGroup, AvailableField } from '../../lib/hooks/calculated-
  * `useAvailableFields` decides compatibility and grouping (it knows about
  * the calculated-fields group and aggregate rules); this panel only renders.
  */
-export declare function FieldPickerPanel({ groups, searchTerm, onSearchTermChange, onFieldClick, selectedFieldIds, unavailableFieldReasons, disabled, }: {
+export declare function FieldPickerPanel({ groups, searchTerm, onSearchTermChange, onFieldClick, selectedFieldIds, unavailableFieldReasons, disabled, listLabel, autoFocusSearch, selectFirstOnEnter, }: {
     groups: AvailableFieldGroup[];
     searchTerm: string;
     onSearchTermChange: (value: string) => void;
@@ -13,4 +13,8 @@ export declare function FieldPickerPanel({ groups, searchTerm, onSearchTermChang
     /** Fields blocked for the current chart, by id, with the reason. */
     unavailableFieldReasons?: Record<string, string>;
     disabled?: boolean;
+    listLabel?: string;
+    autoFocusSearch?: boolean;
+    /** Enter in the search box picks the first enabled match. */
+    selectFirstOnEnter?: boolean;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/calculated-fields/placeholder-field-picker.d.ts

@@ -0,0 +1,30 @@
+import { RefObject } from 'react';
+import { AvailableField, AvailableFieldGroup } from '../../lib/hooks/calculated-fields/use-available-fields.js';
+type Measurable = {
+    getBoundingClientRect: () => DOMRect;
+};
+export type PlaceholderFieldPickerProps = {
+    /** Token being replaced (text between the braces); null when closed. */
+    token: string | null;
+    /** Unbound tokens left in the formula, including this one. */
+    remaining: number;
+    /** Measures the chip the picker hangs from. */
+    anchorRef: RefObject<Measurable>;
+    groups: AvailableFieldGroup[];
+    unavailableFieldReasons?: Record<string, string>;
+    onPick: (field: AvailableField) => void;
+    /** Esc: close and keep the token selected so typing replaces it. */
+    onEscape: () => void;
+    /** Click outside: close and leave focus where the click put it. */
+    onDismiss: () => void;
+    onCloseAutoFocus: (event: Event) => void;
+};
+/**
+ * Field picker anchored under a dashed chip in the formula box. Opens
+ * when the author clicks a chip, presses Tab in the formula, or inserts
+ * a template. Picking replaces the whole token; the editor then moves to
+ * the next chip. Reuses `FieldPickerPanel`, so compatibility and the
+ * "Not in this visual" hints match Insert field.
+ */
+export declare function PlaceholderFieldPicker({ token, remaining, anchorRef, groups, unavailableFieldReasons, onPick, onEscape, onDismiss, onCloseAutoFocus, }: PlaceholderFieldPickerProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/components/calculated-fields/templates-menu.d.ts

@@ -1,5 +1,11 @@
+import { CalculatedFieldType } from '../../lib/types/calculated-field-editor-types.js';
+import { CalculatedFieldTemplateDefaults, ResolvedCalculatedFieldTemplate } from '../../lib/types/calculated-field-template-types.js';
 export type TemplatesMenuProps = {
+    fieldType: CalculatedFieldType;
     onInsert: (snippet: string) => void;
+    onInsertRowTemplate: (template: ResolvedCalculatedFieldTemplate) => void;
+    rowTemplates?: CalculatedFieldTemplateDefaults;
+    rowTemplatesLoading?: boolean;
     disabled?: boolean;
 };
 /**
@@ -8,7 +14,7 @@ export type TemplatesMenuProps = {
  * the formula editor at the cursor; the user replaces `{a}` / `{b}`
  * placeholders with real fields after.
  *
- * Metric-only — caller decides whether to render this. Calculated
- * Columns are row-level and do not have aggregate templates.
+ * Aggregate templates insert their portable formula directly. Row templates
+ * synchronously insert defaults already loaded for the active connection.
  */
-export declare function TemplatesMenu({ onInsert, disabled }: TemplatesMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function TemplatesMenu({ fieldType, onInsert, onInsertRowTemplate, rowTemplates, rowTemplatesLoading, disabled, }: TemplatesMenuProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/explorer/fields/field-option-list.d.ts

@@ -35,6 +35,8 @@ export type FieldOptionListProps<TField extends Field = Field> = {
     /** Classes for the scrolling list container (height belongs here). */
     listClassName?: string;
     autoFocusSearch?: boolean;
+    /** Enter in the search box picks the first enabled match. */
+    selectFirstOnEnter?: boolean;
     emptyMessage?: string;
 };
 /**
@@ -49,4 +51,4 @@ export type FieldOptionListProps<TField extends Field = Field> = {
  *
  * Hosts own the trigger, what a selection means, and where it lives.
  */
-export declare function FieldOptionList<TField extends Field = Field>({ fields, selectedIds, onSelect, selectionMode, query: controlledQuery, onQueryChange, searchPlaceholder, listLabel, getGroup, sorted, isDisabled, isCalculated, renderTrailing, toolbar, density, listClassName, autoFocusSearch, emptyMessage, }: FieldOptionListProps<TField>): import("react/jsx-runtime").JSX.Element;
+export declare function FieldOptionList<TField extends Field = Field>({ fields, selectedIds, onSelect, selectionMode, query: controlledQuery, onQueryChange, searchPlaceholder, listLabel, getGroup, sorted, isDisabled, isCalculated, renderTrailing, toolbar, density, listClassName, autoFocusSearch, selectFirstOnEnter, emptyMessage, }: FieldOptionListProps<TField>): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/semaphor/code-editor.d.ts

@@ -1,6 +1,16 @@
 import { ElementRef, KeyboardEventHandler } from 'react';
 import { default as Editor } from 'react-simple-code-editor';
 export type CodeEditorLanguage = 'yaml' | 'json' | 'sql' | 'sql-jinja' | 'python' | 'javascript';
+/**
+ * A character range drawn as a chip behind the text. `field` is a quiet
+ * solid tint; `pending` is a dashed outline that can be hovered and
+ * clicked (see `onChipClick`).
+ */
+export type CodeEditorChip = {
+    start: number;
+    end: number;
+    tone: 'field' | 'pending';
+};
 export type CodeEditorProps = {
     value: string;
     onValueChange?: (value: string) => void;
@@ -66,6 +76,21 @@ export type CodeEditorProps = {
      * global shortcuts on its own.
      */
     onKeyDown?: KeyboardEventHandler<HTMLTextAreaElement & HTMLDivElement>;
+    /**
+     * Opt-in chips drawn behind the text (non-overlapping ranges into
+     * `value`). Chips use background and outline only, so they never
+     * change character metrics and the caret stays on the text.
+     */
+    chips?: ReadonlyArray<CodeEditorChip>;
+    /** Index into `chips` rendered in the active state. */
+    activeChipIndex?: number | null;
+    /**
+     * Called with the index into `chips` when a `pending` chip is clicked.
+     * Clicks land on the textarea, so hits are resolved by measuring the
+     * chip layer. Not called when `readOnly`, or for drag selections that
+     * reach outside the chip.
+     */
+    onChipClick?: (index: number) => void;
     className?: string;
 };
 type SimpleCodeEditorHandle = ElementRef<typeof Editor>;
@@ -81,6 +106,9 @@ export type CodeEditorHandle = {
     captureSession: () => CodeEditorSessionSnapshot | null;
     restoreSession: (snapshot: CodeEditorSessionSnapshot) => void;
     focus: () => void;
+    /** Viewport rect of chip `index` (its last line when it wraps), for
+     * anchoring a popover to it. */
+    getChipRect: (index: number) => DOMRect | null;
 };
 export declare const CodeEditor: import('react').ForwardRefExoticComponent<CodeEditorProps & import('react').RefAttributes<CodeEditorHandle>>;
 export {};

package/dist/types/components/surfboard/filter/use-dashboard-filter-mapping-popover.d.ts

@@ -54,7 +54,6 @@ export declare function useDashboardFilterMappingPopover(params: {
         aiScopeTables?: import('../index.js').AIScopeTable[];
         globalStyle?: import('../index.js').TStyle;
         globalCacheConfig?: import('../index.js').CacheConfig;
-        emailSettings?: import('../index.js').EmailSettings;
         defaultFilterValues?: import('./types.js').TFilterValue[];
         controls?: import('../index.js').ControlDefinition[];
         defaultControlValues?: Record<string, unknown>;

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../chunks/common-types-nBuCd3u2.cjs"),e=require("../chunks/validators-DVYAnnX0.cjs"),t=require("../chunks/field-dependencies-DIab72rQ.cjs"),r=require("../chunks/token-types-Ahh5u4iT.cjs"),a=require("../chunks/pivot-result-identity-uTiylUNr.cjs"),i=require("../chunks/report-runtime-context-DzvHBPxl.cjs");exports.CONTROL_CARD_DEFAULT_VALUE=l.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=l.EMPTY_SELECTION;exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getCalculatedFieldComputeStage=e.getCalculatedFieldComputeStage;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.inspectCalculatedField=e.inspectCalculatedField;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedMetric=e.isCalculatedMetric;exports.isDerivedField=e.isDerivedField;exports.normalizeCalculatedFieldRepresentation=e.normalizeCalculatedFieldRepresentation;exports.shouldDropInheritedCalculationAggregate=e.shouldDropInheritedCalculationAggregate;exports.collectDatasetNamesFromExplorerField=t.collectDatasetNamesFromExplorerField;exports.collectDatasetNamesFromFilterGroup=t.collectDatasetNamesFromFilterGroup;exports.collectExecutionDatasetNamesFromExplorerField=t.collectExecutionDatasetNamesFromExplorerField;exports.collectPreferredDatasetNamesFromExplorerField=t.collectPreferredDatasetNamesFromExplorerField;exports.collectQualifiedDatasetNamesFromExplorerField=t.collectQualifiedDatasetNamesFromExplorerField;exports.datasetRefFromSource=t.datasetRefFromSource;exports.dependencyDisplayIdentity=t.dependencyDisplayIdentity;exports.humanizeDatasetName=t.humanizeDatasetName;exports.resolveFieldDatasetDependencies=t.resolveFieldDatasetDependencies;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=r.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=a.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=a.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=i.DEFAULT_CALENDAR_CONTEXT;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../chunks/common-types-nBuCd3u2.cjs"),e=require("../chunks/validators-DVYAnnX0.cjs"),t=require("../chunks/field-dependencies-DIab72rQ.cjs"),r=require("../chunks/token-types-Ahh5u4iT.cjs"),l=require("../chunks/pivot-result-identity-uTiylUNr.cjs"),i=require("../chunks/report-runtime-context-DzvHBPxl.cjs"),o=["concatenate","conditional-category","date-part","date-difference","null-to-zero","safe-ratio"];exports.CONTROL_CARD_DEFAULT_VALUE=a.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=a.EMPTY_SELECTION;exports.CALCULATED_FIELD_ENTITY_MARKER=e.CALCULATED_FIELD_ENTITY_MARKER;exports.DATE_FORMAT_VALUES=e.DATE_FORMAT_VALUES;exports.LEGACY_CALCULATED_FIELD_ENTITY_MARKER=e.LEGACY_CALCULATED_FIELD_ENTITY_MARKER;exports.PivotMarkerEnum=e.PivotMarkerEnum;exports.getCalculatedFieldComputeStage=e.getCalculatedFieldComputeStage;exports.getFieldRuntimeColumnName=e.getFieldRuntimeColumnName;exports.hasCalculatedFieldMarker=e.hasCalculatedFieldMarker;exports.hasCalculatedFormulaInputs=e.hasCalculatedFormulaInputs;exports.hasSyntheticCalculatedFieldOwner=e.hasSyntheticCalculatedFieldOwner;exports.inspectCalculatedField=e.inspectCalculatedField;exports.isCalculatedDimension=e.isCalculatedDimension;exports.isCalculatedMetric=e.isCalculatedMetric;exports.isDerivedField=e.isDerivedField;exports.normalizeCalculatedFieldRepresentation=e.normalizeCalculatedFieldRepresentation;exports.shouldDropInheritedCalculationAggregate=e.shouldDropInheritedCalculationAggregate;exports.collectDatasetNamesFromExplorerField=t.collectDatasetNamesFromExplorerField;exports.collectDatasetNamesFromFilterGroup=t.collectDatasetNamesFromFilterGroup;exports.collectExecutionDatasetNamesFromExplorerField=t.collectExecutionDatasetNamesFromExplorerField;exports.collectPreferredDatasetNamesFromExplorerField=t.collectPreferredDatasetNamesFromExplorerField;exports.collectQualifiedDatasetNamesFromExplorerField=t.collectQualifiedDatasetNamesFromExplorerField;exports.datasetRefFromSource=t.datasetRefFromSource;exports.dependencyDisplayIdentity=t.dependencyDisplayIdentity;exports.humanizeDatasetName=t.humanizeDatasetName;exports.resolveFieldDatasetDependencies=t.resolveFieldDatasetDependencies;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=r.DEFAULT_SEMANTIC_DOMAIN_ACCESS;exports.resolveQueryColumnKeyMapEntry=l.resolveQueryColumnKeyMapEntry;exports.resolveUniqueQueryColumnKeyMapEntry=l.resolveUniqueQueryColumnKeyMapEntry;exports.DEFAULT_CALENDAR_CONTEXT=i.DEFAULT_CALENDAR_CONTEXT;exports.CALCULATED_FIELD_TEMPLATE_IDS=o;

package/dist/types/index.js

@@ -1,38 +1,47 @@
-import { C as s, E as t } from "../chunks/common-types-C6cAQgyh.js";
-import { C as r, D as o, L as i, P as d, d as E, g as m, e as c, h as C, f as n, c as u, a as D, i as F, b as p, n as A, s as _ } from "../chunks/validators-BDYzZFgs.js";
-import { c as L, g as N, f, b as x, e as M, d as R, a as y, h as I, r as h } from "../chunks/field-dependencies-Cl97kkHy.js";
-import { D as S } from "../chunks/token-types-CPde8_LG.js";
-import { r as O, a as v } from "../chunks/pivot-result-identity-BSudrDLN.js";
-import { D as P } from "../chunks/report-runtime-context-DWvUf1HT.js";
+import { C as s, E as l } from "../chunks/common-types-C6cAQgyh.js";
+import { C as o, D as i, L as d, P as E, f as c, g as n, k as C, j as m, l as D, e as u, c as F, b as A, d as p, n as _, h as L } from "../chunks/validators-CkHsAvwB.js";
+import { c as N, g as f, f as x, b as I, e as M, d as y, a as R, h as g, r as h } from "../chunks/field-dependencies-DXW4jtvJ.js";
+import { D as U } from "../chunks/token-types-Dl0hcKBX.js";
+import { r as v, a as P } from "../chunks/pivot-result-identity-8M-bZrw9.js";
+import { D as Y } from "../chunks/report-runtime-context-Cs65Mrxj.js";
+const e = [
+  "concatenate",
+  "conditional-category",
+  "date-part",
+  "date-difference",
+  "null-to-zero",
+  "safe-ratio"
+];
 export {
-  r as CALCULATED_FIELD_ENTITY_MARKER,
+  o as CALCULATED_FIELD_ENTITY_MARKER,
+  e as CALCULATED_FIELD_TEMPLATE_IDS,
   s as CONTROL_CARD_DEFAULT_VALUE,
-  o as DATE_FORMAT_VALUES,
-  P as DEFAULT_CALENDAR_CONTEXT,
-  S as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
-  t as EMPTY_SELECTION,
-  i as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
-  d as PivotMarkerEnum,
-  L as collectDatasetNamesFromExplorerField,
-  N as collectDatasetNamesFromFilterGroup,
-  f as collectExecutionDatasetNamesFromExplorerField,
-  x as collectPreferredDatasetNamesFromExplorerField,
+  i as DATE_FORMAT_VALUES,
+  Y as DEFAULT_CALENDAR_CONTEXT,
+  U as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
+  l as EMPTY_SELECTION,
+  d as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
+  E as PivotMarkerEnum,
+  N as collectDatasetNamesFromExplorerField,
+  f as collectDatasetNamesFromFilterGroup,
+  x as collectExecutionDatasetNamesFromExplorerField,
+  I as collectPreferredDatasetNamesFromExplorerField,
   M as collectQualifiedDatasetNamesFromExplorerField,
-  R as datasetRefFromSource,
-  y as dependencyDisplayIdentity,
-  E as getCalculatedFieldComputeStage,
-  m as getFieldRuntimeColumnName,
-  c as hasCalculatedFieldMarker,
-  C as hasCalculatedFormulaInputs,
-  n as hasSyntheticCalculatedFieldOwner,
-  I as humanizeDatasetName,
+  y as datasetRefFromSource,
+  R as dependencyDisplayIdentity,
+  c as getCalculatedFieldComputeStage,
+  n as getFieldRuntimeColumnName,
+  C as hasCalculatedFieldMarker,
+  m as hasCalculatedFormulaInputs,
+  D as hasSyntheticCalculatedFieldOwner,
+  g as humanizeDatasetName,
   u as inspectCalculatedField,
-  D as isCalculatedDimension,
-  F as isCalculatedMetric,
+  F as isCalculatedDimension,
+  A as isCalculatedMetric,
   p as isDerivedField,
-  A as normalizeCalculatedFieldRepresentation,
+  _ as normalizeCalculatedFieldRepresentation,
   h as resolveFieldDatasetDependencies,
-  O as resolveQueryColumnKeyMapEntry,
-  v as resolveUniqueQueryColumnKeyMapEntry,
-  _ as shouldDropInheritedCalculationAggregate
+  v as resolveQueryColumnKeyMapEntry,
+  P as resolveUniqueQueryColumnKeyMapEntry,
+  L as shouldDropInheritedCalculationAggregate
 };

package/dist/types/lib/hooks/calculated-fields/use-calculated-field-templates.d.ts

@@ -0,0 +1,9 @@
+export declare function useCalculatedFieldTemplates({ endpoint, connectionId, enabled, }: {
+    endpoint: string | null;
+    connectionId?: string;
+    enabled?: boolean;
+}): {
+    templates: import('../../types/calculated-field-template-types.js').CalculatedFieldTemplateDefaults | undefined;
+    isLoading: boolean;
+    error: string | null;
+};

package/dist/types/lib/hooks/calculated-fields/use-formula-placeholders.d.ts

@@ -0,0 +1,54 @@
+import { KeyboardEvent, RefObject } from 'react';
+import { CodeEditorChip, CodeEditorHandle } from '../../../components/semaphor/code-editor.js';
+import { AvailableField } from './use-available-fields.js';
+type Range = {
+    start: number;
+    end: number;
+};
+/**
+ * Clickable placeholders in the calculated-field formula box.
+ *
+ * Every `{token}` renders as a chip. Tokens that bind to exactly one field
+ * (the rule validation uses) are quiet `field` chips; the rest are dashed
+ * `pending` chips: template slots like `{a}`, typos, stale or ambiguous
+ * references. A pending chip opens a field picker when it is clicked, when
+ * the author presses Tab in the formula, or right after a template is
+ * inserted. Picking replaces the whole token and moves to the next pending
+ * chip.
+ *
+ * Reference: semaphor-app/src/app/design/calculated-field-placeholders/page.tsx
+ */
+export declare function useFormulaPlaceholders({ expression, onExpressionChange, tokenCandidates, textareaId, editorRef, interactive, }: {
+    expression: string;
+    onExpressionChange: (next: string) => void;
+    /** Same candidates validation resolves against. */
+    tokenCandidates: Map<string, AvailableField[]>;
+    textareaId: string;
+    editorRef: RefObject<CodeEditorHandle | null>;
+    /** False when read-only or while the formula box is hidden. */
+    interactive: boolean;
+}): {
+    chips: CodeEditorChip[];
+    activeChipIndex: number | null;
+    onChipClick: (chipIndex: number) => void;
+    onEditorKeyDown: (event: KeyboardEvent<HTMLTextAreaElement & HTMLDivElement>) => void;
+    /** Call after inserting text at `range` (offsets in the new value). */
+    openFirstIn: import('react').Dispatch<import('react').SetStateAction<Range | null>>;
+    reset: () => void;
+    summary: {
+        placeholders: number;
+        unresolved: number;
+    };
+    picker: {
+        token: string | null;
+        remaining: number;
+        anchorRef: RefObject<{
+            getBoundingClientRect: () => DOMRect;
+        }>;
+        onPick: (field: AvailableField) => void;
+        onEscape: () => void;
+        onDismiss: () => void;
+        onCloseAutoFocus: (event: Event) => void;
+    };
+};
+export {};

package/dist/types/lib/stores/dashboard-store.d.ts

@@ -1,4 +1,4 @@
-import { AuthToken, TBaseQuery, Breakpoint, ControlDefinition, CustomCard, StyleProps, TCard, TDashboard, TEvent, TFrame, TSheet, TStyle, AIScopeTable, TLens, CacheConfig, EmailSettings, FilterLayoutSettings, DocumentDefinition, DashboardInput, DashboardInputSlot, DashboardInputValues, DashboardLifecycleEvent } from '../types/common-types.js';
+import { AuthToken, TBaseQuery, Breakpoint, ControlDefinition, CustomCard, StyleProps, TCard, TDashboard, TEvent, TFrame, TSheet, TStyle, AIScopeTable, TLens, CacheConfig, FilterLayoutSettings, DocumentDefinition, DashboardInput, DashboardInputSlot, DashboardInputValues, DashboardLifecycleEvent } from '../types/common-types.js';
 import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
 import { TransientInputContext } from '../dashboard-inputs/transient-input-context.js';
 import { default as ReactGridLayout } from 'react-grid-layout';
@@ -184,7 +184,6 @@ type Actions = {
     setDashboardControlsModel: (controls: ControlDefinition[], defaultValues?: Record<string, unknown>, options?: DashboardControlsModelOptions) => void;
     updateDashboardControl: (controlId: string, updates: Partial<ControlDefinition>) => void;
     reorderDashboardControls: (orderedControlIds: string[]) => void;
-    updateEmailSettings: (emailSettings: EmailSettings) => void;
     setIsDownloadingPdf: (isDownloadingPdf: boolean) => void;
     setLenses: (lenses: TLens[]) => void;
     setSelectedLensId: (lensId: string) => void;

package/dist/types/lib/types/calculated-field-template-types.d.ts

@@ -0,0 +1,13 @@
+export declare const CALCULATED_FIELD_TEMPLATE_IDS: readonly ["concatenate", "conditional-category", "date-part", "date-difference", "null-to-zero", "safe-ratio"];
+export type CalculatedFieldTemplateId = (typeof CALCULATED_FIELD_TEMPLATE_IDS)[number];
+export type ResolvedCalculatedFieldTemplate = {
+    expression: string;
+    outputType: 'number' | 'string';
+};
+export type CalculatedFieldTemplateDefaults = Record<CalculatedFieldTemplateId, ResolvedCalculatedFieldTemplate>;
+export type CalculatedFieldTemplateDefaultsRequest = {
+    connectionId: string;
+};
+export type CalculatedFieldTemplateDefaultsResponse = {
+    templates: CalculatedFieldTemplateDefaults;
+};

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

@@ -1568,12 +1568,6 @@ export type CacheConfig = {
     ttl: string;
     status: 'on' | 'on-refresh' | 'off';
 };
-export type EmailSettings = {
-    companyName: string;
-    dashboardUrl: string;
-    supportEmail: string;
-    senderTitle: string;
-};
 export type TDashboard = {
     id: string;
     title?: string;
@@ -1597,7 +1591,6 @@ export type TDashboard = {
     aiScopeTables?: AIScopeTable[];
     globalStyle?: TStyle;
     globalCacheConfig?: CacheConfig;
-    emailSettings?: EmailSettings;
     defaultFilterValues?: TFilterValue[];
     controls?: ControlDefinition[];
     defaultControlValues?: Record<string, unknown>;

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

@@ -1,5 +1,6 @@
 export * from './common-types.js';
 export * from './explorer-types.js';
+export * from './calculated-field-template-types.js';
 export * from '../utils/field-dependencies.js';
 export * from './token-types.js';
 export * from './briefing-types.js';

package/dist/types/lib/utils/calculated-field-row-templates.d.ts

@@ -0,0 +1,13 @@
+import { CalculatedFieldTemplateId } from '../types/calculated-field-template-types.js';
+export type RowFormulaTemplateDefinition = {
+    id: CalculatedFieldTemplateId;
+    label: string;
+    symbol: string;
+    preview: string;
+    hint: string;
+};
+/**
+ * Dialect-neutral catalog for row-level authoring shortcuts. The Semaphor App
+ * resolver owns executable SQL for each connection dialect.
+ */
+export declare const ROW_FORMULA_TEMPLATES: RowFormulaTemplateDefinition[];

package/dist/types/lib/utils/calculated-field-token-utils.d.ts

@@ -3,6 +3,29 @@ export declare function normalizeToken(token: string): string;
 export declare function extractExpressionTokens(expression: string): string[];
 export declare function getUniqueTokens(tokens: string[]): string[];
 export declare function buildTokenCandidates(fields: AvailableField[]): Map<string, AvailableField[]>;
+export type ExpressionTokenRange = {
+    /** Text between the braces, as typed. */
+    token: string;
+    /** Offset of `{`. */
+    start: number;
+    /** Offset just past `}`. */
+    end: number;
+};
+/** Every `{token}` in the expression with its offsets. Same grammar as
+ * `extractExpressionTokens`, so it agrees with validation. */
+export declare function findExpressionTokenRanges(expression: string): ExpressionTokenRange[];
+/** Template slots are single lowercase letters: `{a}`, `{b}`. */
+export declare function isTemplatePlaceholderToken(token: string): boolean;
+/** A token binds only when exactly one field claims it, the same rule
+ * `resolveExpressionTokens` uses before validation. */
+export declare function isResolvedToken(token: string, candidates: Map<string, AvailableField[]>): boolean;
+/**
+ * Tokens that do not bind to a field, in the order the author should fill
+ * them: template placeholders by letter (`{a}` before `{b}`, even when the
+ * dialect SQL mentions `{b}` first), then any other unbound token (typo,
+ * stale or ambiguous reference) by position.
+ */
+export declare function findPendingTokenRanges(ranges: ExpressionTokenRange[], candidates: Map<string, AvailableField[]>): ExpressionTokenRange[];
 export declare function resolveExpressionTokens(expression: string, fields: AvailableField[]): {
     orderedTokens: string[];
     orderedFields: (AvailableField | null)[];

package/package.json

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