react-semaphor 0.1.512 → 0.1.514

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-DrOFJOCq.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-DcLkVqni.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-nhUr9xBz.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-B2fzQH1T.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,14 +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;
 };
-/**
- * Variant B "Templates" menu — replaces the legacy OperationSelector +
- * A/B input shelf. Selecting a template inserts the formula text into
- * 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.
- */
-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"),o=require("../chunks/report-runtime-context-DzvHBPxl.cjs"),i=["concatenate","conditional-category","date-part","date-difference","null-to-zero","safe-ratio","nested-conditional","membership-test","uppercase","lowercase","trim-whitespace","replace-text","first-characters","character-count","starts-with","number-to-text","start-of-month","start-of-quarter","start-of-year","year-number","add-days","round-number","round-down","round-up","absolute-value","cap-maximum","floor-minimum","fill-blanks","null-if-zero","is-blank"];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=o.DEFAULT_CALENDAR_CONTEXT;exports.CALCULATED_FIELD_TEMPLATE_IDS=i;

package/dist/types/index.js

@@ -1,37 +1,70 @@
-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 r, E as s } from "../chunks/common-types-C6cAQgyh.js";
+import { C as o, D as i, L as n, P as c, f as d, g as m, k as u, j as E, l as p, e as C, c as D, b as F, d as A, n as f, h as _ } from "../chunks/validators-CkHsAvwB.js";
+import { c as T, g as h, f as x, b as N, e as y, d as I, a as M, h as R, r as b } from "../chunks/field-dependencies-DXW4jtvJ.js";
+import { D as S } from "../chunks/token-types-Dl0hcKBX.js";
+import { r as O, a as v } from "../chunks/pivot-result-identity-8M-bZrw9.js";
+import { D as w } from "../chunks/report-runtime-context-Cs65Mrxj.js";
+const e = [
+  "concatenate",
+  "conditional-category",
+  "date-part",
+  "date-difference",
+  "null-to-zero",
+  "safe-ratio",
+  "nested-conditional",
+  "membership-test",
+  "uppercase",
+  "lowercase",
+  "trim-whitespace",
+  "replace-text",
+  "first-characters",
+  "character-count",
+  "starts-with",
+  "number-to-text",
+  "start-of-month",
+  "start-of-quarter",
+  "start-of-year",
+  "year-number",
+  "add-days",
+  "round-number",
+  "round-down",
+  "round-up",
+  "absolute-value",
+  "cap-maximum",
+  "floor-minimum",
+  "fill-blanks",
+  "null-if-zero",
+  "is-blank"
+];
 export {
-  r as CALCULATED_FIELD_ENTITY_MARKER,
-  s as CONTROL_CARD_DEFAULT_VALUE,
-  o as DATE_FORMAT_VALUES,
-  P as DEFAULT_CALENDAR_CONTEXT,
+  o as CALCULATED_FIELD_ENTITY_MARKER,
+  e as CALCULATED_FIELD_TEMPLATE_IDS,
+  r as CONTROL_CARD_DEFAULT_VALUE,
+  i as DATE_FORMAT_VALUES,
+  w 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,
-  M as collectQualifiedDatasetNamesFromExplorerField,
-  R as datasetRefFromSource,
-  y as dependencyDisplayIdentity,
-  E as getCalculatedFieldComputeStage,
+  s as EMPTY_SELECTION,
+  n as LEGACY_CALCULATED_FIELD_ENTITY_MARKER,
+  c as PivotMarkerEnum,
+  T as collectDatasetNamesFromExplorerField,
+  h as collectDatasetNamesFromFilterGroup,
+  x as collectExecutionDatasetNamesFromExplorerField,
+  N as collectPreferredDatasetNamesFromExplorerField,
+  y as collectQualifiedDatasetNamesFromExplorerField,
+  I as datasetRefFromSource,
+  M as dependencyDisplayIdentity,
+  d as getCalculatedFieldComputeStage,
   m as getFieldRuntimeColumnName,
-  c as hasCalculatedFieldMarker,
-  C as hasCalculatedFormulaInputs,
-  n as hasSyntheticCalculatedFieldOwner,
-  I as humanizeDatasetName,
-  u as inspectCalculatedField,
+  u as hasCalculatedFieldMarker,
+  E as hasCalculatedFormulaInputs,
+  p as hasSyntheticCalculatedFieldOwner,
+  R as humanizeDatasetName,
+  C as inspectCalculatedField,
   D as isCalculatedDimension,
   F as isCalculatedMetric,
-  p as isDerivedField,
-  A as normalizeCalculatedFieldRepresentation,
-  h as resolveFieldDatasetDependencies,
+  A as isDerivedField,
+  f as normalizeCalculatedFieldRepresentation,
+  b as resolveFieldDatasetDependencies,
   O as resolveQueryColumnKeyMapEntry,
   v as resolveUniqueQueryColumnKeyMapEntry,
   _ 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,14 @@
+import { DataType } from './explorer-types.js';
+export declare const CALCULATED_FIELD_TEMPLATE_IDS: readonly ["concatenate", "conditional-category", "date-part", "date-difference", "null-to-zero", "safe-ratio", "nested-conditional", "membership-test", "uppercase", "lowercase", "trim-whitespace", "replace-text", "first-characters", "character-count", "starts-with", "number-to-text", "start-of-month", "start-of-quarter", "start-of-year", "year-number", "add-days", "round-number", "round-down", "round-up", "absolute-value", "cap-maximum", "floor-minimum", "fill-blanks", "null-if-zero", "is-blank"];
+export type CalculatedFieldTemplateId = (typeof CALCULATED_FIELD_TEMPLATE_IDS)[number];
+export type ResolvedCalculatedFieldTemplate = {
+    expression: string;
+    outputType: Extract<DataType, 'string' | 'number' | 'date' | 'boolean'>;
+};
+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,15 @@
+import { CalculatedFieldTemplateId } from '../types/calculated-field-template-types.js';
+export declare const ROW_TEMPLATE_CATEGORIES: readonly ["Logic", "Text", "Dates", "Numbers", "Empty values"];
+export type RowTemplateCategory = (typeof ROW_TEMPLATE_CATEGORIES)[number];
+export type RowFormulaTemplateDefinition = {
+    id: CalculatedFieldTemplateId;
+    label: string;
+    symbol: string;
+    preview: string;
+    hint: string;
+    category: RowTemplateCategory;
+    keywords: string[];
+    common?: boolean;
+};
+/** Dialect-neutral searchable metadata. Executable SQL remains app-owned. */
+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.514",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",