react-semaphor 0.1.556 → 0.1.558

package/dist/surfboard/index.js

@@ -1,5 +1,5 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-D_wrbIQt.js";
-import { C as f, E as D } from "../chunks/table-settings-PpINOzw8.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-Dc-YyVwf.js";
+import { C as f, E as D } from "../chunks/table-settings-DF1gdVQR.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/data-app-sdk/contracts.d.ts

@@ -238,40 +238,13 @@ export type SemaphorDataAppDefinition = {
     queries?: Record<string, SemaphorQueryDefinition>;
     views: SemaphorDataAppViewDefinition[];
 };
-export type SemaphorDataAppDevtoolsUiConfig = {
-    buttonPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'relative';
-    initialIsOpen?: boolean;
-    panelPosition?: 'bottom' | 'right';
-};
 export type SemaphorDataAppDebugConfig = boolean | {
     enabled?: boolean;
-    exposeWindowBridge?: boolean;
-    autoRenderDevtools?: boolean | SemaphorDataAppDevtoolsUiConfig;
     requestServerDebug?: boolean;
-    maxQueries?: number;
-    maxEventsPerQuery?: number;
-};
-export type SemaphorDataAppSourceHint = {
-    file?: string;
-    line?: number;
-    column?: number;
-    exportName?: string;
-    component?: string;
-    note?: string;
-};
-export type SemaphorQueryDebugOptions = {
-    viewId?: string;
-    viewTitle?: string;
-    visualType?: string;
-    sectionTitle?: string;
-    title?: string;
-    sourceHint?: SemaphorDataAppSourceHint;
-    sourceHints?: SemaphorDataAppSourceHint[];
 };
 export type SemaphorQueryRuntimeOptions = {
     inputs?: SemaphorInputReference[];
     selections?: SemaphorSelectionReference[];
-    debug?: SemaphorQueryDebugOptions;
 };
 export type SemaphorQueryStatus = 'idle' | 'loading' | 'success' | 'error';
 export type SemaphorDataAppQueryError = Error & {
@@ -282,124 +255,6 @@ export type SemaphorDataAppQueryError = Error & {
     validation?: SemaphorAnalyticsValidationResult;
     validationIssues?: SemaphorAnalyticsValidationIssue[];
 };
-export type SemaphorDataAppTraceEvent = {
-    type: 'query_started';
-    queryId: string;
-    requestId?: string;
-    at: string;
-} | {
-    type: 'query_succeeded';
-    queryId: string;
-    requestId?: string;
-    at: string;
-    rowCount?: number;
-    durationMs?: number;
-} | {
-    type: 'query_failed';
-    queryId: string;
-    requestId?: string;
-    at: string;
-    errorMessage: string;
-} | {
-    type: 'query_ignored_stale';
-    queryId: string;
-    requestId?: string;
-    at: string;
-    reason: 'newer_inputs' | 'unmounted' | 'superseded';
-} | {
-    type: 'input_changed';
-    inputId: string;
-    at: string;
-    valuePreview?: string;
-};
-export type SemaphorDataAppTrace = {
-    traceId: string;
-    viewId?: string;
-    viewTitle?: string;
-    visualType?: string;
-    sectionTitle?: string;
-    queryId: string;
-    queryLabel?: string;
-    queryKind: SemaphorQueryDefinition['queryKind'];
-    builder: 'semaphor.metric' | 'semaphor.records' | 'semaphor.matrix' | 'semaphor.analysis' | 'semaphor.inputOptions' | 'semaphor.sql';
-    sourceRefs: SemaphorSourceRef[];
-    sourceHints?: SemaphorDataAppSourceHint[];
-    projectionFieldRefs?: SemaphorFieldRef[];
-    inputFieldRefs?: SemaphorFieldRef[];
-    fieldRefs: SemaphorFieldRef[];
-    inputsApplied: Array<{
-        inputId: string;
-        inputLabel?: string;
-        fieldRef?: SemaphorFieldRef;
-        operator?: string;
-        valuePreview?: string;
-    }>;
-    latestAttempt?: {
-        requestId?: string;
-        status: SemaphorQueryStatus;
-        durationMs?: number;
-        rowCount?: number;
-        columnCount?: number;
-        cacheStatus?: 'hit' | 'miss' | 'unknown';
-        metricCoverage?: {
-            populatedMetricKeys?: string[];
-            missingMeasures?: string[];
-        };
-        resultPreview?: SemaphorDataAppResultPreview;
-        executionResult?: SemaphorAnalyticsExecutionResult;
-        errorMessage?: string;
-    };
-    recentEvents: SemaphorDataAppTraceEvent[];
-    server?: {
-        compiledSql?: string;
-        dialect?: string;
-        sqlHash?: string;
-        executionPlanSummary?: string;
-    };
-    clientWarnings: string[];
-};
-export type SemaphorDataAppResultPreviewColumn = {
-    key: string;
-    label: string;
-};
-export type SemaphorDataAppResultPreview = {
-    title: string;
-    summary: string;
-    columns: SemaphorDataAppResultPreviewColumn[];
-    rows: Array<Record<string, unknown>>;
-    truncatedRows: boolean;
-    truncatedColumns: boolean;
-};
-export type SemaphorDataAppDevtoolsIssue = {
-    traceId: string;
-    queryId: string;
-    viewId?: string;
-    viewTitle?: string;
-    queryLabel?: string;
-    severity: 'error' | 'warning';
-    title: string;
-    message: string;
-    code?: string;
-    path?: string;
-};
-export type SemaphorDataAppDevtoolsState = {
-    enabled: boolean;
-    queries: SemaphorDataAppTrace[];
-    issues: SemaphorDataAppDevtoolsIssue[];
-    getQuery(queryId: string): SemaphorDataAppTrace | undefined;
-    getQueries(queryId: string): SemaphorDataAppTrace[];
-};
-export type SemaphorDataAppDevtoolsWindowBridge = {
-    snapshot(): SemaphorDataAppDevtoolsState;
-    getQuery(queryId: string): SemaphorDataAppTrace | undefined;
-    getQueries(queryId: string): SemaphorDataAppTrace[];
-    getIssues(): SemaphorDataAppDevtoolsIssue[];
-};
-declare global {
-    interface Window {
-        __SEMAPHOR_DEVTOOLS__?: SemaphorDataAppDevtoolsWindowBridge;
-    }
-}
 export type SemaphorQueryState = {
     status: SemaphorQueryStatus;
     executionStatus?: SemaphorAnalyticsExecutionStatus;
@@ -414,7 +269,6 @@ export type SemaphorQueryState = {
     isStale: boolean;
     isValidated: boolean;
     error: SemaphorDataAppQueryError | null;
-    trace?: SemaphorDataAppTrace;
 };
 export type SemaphorMetricPayload = {
     primaryValue: number | string | null;

package/dist/types/data-app-sdk/index.d.ts

@@ -1,6 +1,4 @@
 export { defineSemaphorDataApp, defineSemaphorInput, semaphor, } from './builders.js';
-export { SemaphorDevtools, SemaphorDevtoolsInspectButton, SemaphorViewBoundary, useSemaphorDevtools, } from './devtools.js';
-export type { SemaphorDevtoolsInspectButtonProps, SemaphorDevtoolsProps, } from './devtools.js';
 export { createSemaphorQueryExecutor } from './executor.js';
 export { semaphorMetricAggregate, semaphorMetricMeasureBindingKey, } from '../shared/analytics-protocol/index.js';
 export { isSemaphorInputValueValidForOptions, useClearInvalidSemaphorInputValue, useSemaphorInput, useSemaphorInputs, useSemaphorQuery, } from './hooks.js';

package/dist/types/index.js

@@ -1,9 +1,9 @@
-import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as c, a as E, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-PpINOzw8.js";
-import { C as y, D as g, L as h, e as x, g as M, j as O, h as V, k, d as w, b as U, i as B, c as K, n as z, f as v } from "../chunks/validators-CZo_H4E6.js";
-import { D as q } from "../chunks/token-types--0bgRCaO.js";
-import { B as P, a as Q, p as j, r as W } from "../chunks/bookmark-state-7iZErWnR.js";
-import { r as X, a as H } from "../chunks/pivot-result-identity-CWi5WrrY.js";
-import { D as $ } from "../chunks/report-runtime-context-BgM-iNWB.js";
+import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as c, a as E, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-DF1gdVQR.js";
+import { C as y, D as g, L as h, e as x, g as M, j as O, h as V, k, d as w, b as U, i as B, c as K, n as z, f as v } from "../chunks/validators-hmfNNQz8.js";
+import { D as q } from "../chunks/token-types-DFyLflLY.js";
+import { B as P, a as Q, p as j, r as W } from "../chunks/bookmark-state-PjQpxbG7.js";
+import { r as X, a as H } from "../chunks/pivot-result-identity-CrQ54Xbj.js";
+import { D as $ } from "../chunks/report-runtime-context-CohdtiMg.js";
 const e = [
   "concatenate",
   "conditional-category",

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

@@ -25,7 +25,6 @@ export type ChartConfigParams = {
     provider?: TChartProvider;
     userSettings?: object;
     preferences?: TCardPreferences;
-    topoJson?: any;
     themeStyle?: StyleProps;
     /**
      * Indicates SQL/dev mode where grouping is derived directly from raw data
@@ -49,7 +48,7 @@ export type BlurEffectProps = {
     apply: boolean;
     blurColor?: string;
 };
-export type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'matrixTable' | 'detailTable' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
+export type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'matrixTable' | 'detailTable' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
 export { TABLE_CHART_TYPES, isTableChartType };
 export declare function isChartJsVisualType(chartType: TChartType | string | undefined | null): boolean;
 export declare const REGULAR_TABLE_SETTINGS_CHART_TYPES: readonly ["table", "matrixTable", "detailTable"];

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

@@ -745,16 +745,6 @@ export type TCardPreferences = {
          */
         richContent?: TextCardRichContent;
     };
-    mapVisualOptions?: {
-        topoJsonUrl?: string;
-        objectKey?: string;
-        outlineKey?: string;
-        customTopoJsonUrl?: string;
-        projection?: string;
-        projectionScale?: number;
-        projectionOffset?: [number, number];
-        colorScale?: string;
-    };
     kpiVisualOptions?: {
         countryLogoId?: string;
         valueAlignment?: 'left' | 'center';

package/dist/types/shared/dashboard-authoring/filter-model/filter-definitions.d.ts

@@ -1,5 +1,5 @@
 import { TFilter } from '../../../components/surfboard/filter/types.js';
-import { NormalizedFilterDashboardInput, TDashboard } from '../../../lib/types/common-types.js';
+import { TDashboard } from '../../../lib/types/common-types.js';
 import { FilterInputEntry } from './read-dashboard-filter-model.js';
 /** One definition per filter input, in model order. The same array for the same dashboard object. */
 export declare function listDashboardFilterDefinitions(dashboard: TDashboard): readonly TFilter[];
@@ -11,12 +11,6 @@ export declare function getDashboardGlobalDateFilter(dashboard: TDashboard): TFi
  * own kind. None for an unknown tab.
  */
 export declare function listDashboardFilterInputsOnTab(dashboard: TDashboard, sheetId: string | null | undefined, sheetKind?: 'dashboard' | 'document'): readonly FilterInputEntry[];
-/**
- * A filter hidden from the toolbar and not attached to a visual: a toolbar
- * filter's `hide`, or an input placed `hidden` (OF-D14). The edit-mode strip
- * of hidden filters lists these.
- */
-export declare function isHiddenFilterInput(input: NormalizedFilterDashboardInput): boolean;
 /**
  * Every filter definition the stored template holds, as stored: toolbar
  * filters, stored inputs' filters and prototype Document inputs' filters,

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.556",
+  "version": "0.1.558",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -161,7 +161,6 @@
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@floating-ui/react-dom": "^2.1.8",
-    "@headlessui/react": "^2.2.0",
     "@lexical/history": "^0.43.0",
     "@lexical/link": "^0.43.0",
     "@lexical/list": "^0.43.0",
@@ -200,7 +199,6 @@
     "ai": "^7.0.137",
     "chart.js": "^4.4.1",
     "chartjs-chart-funnel": "^4.2.4",
-    "chartjs-chart-geo": "^4.3.4",
     "chartjs-chart-matrix": "^3.0.0",
     "chartjs-chart-treemap": "^3.1.0",
     "chartjs-plugin-datalabels": "^2.2.0",
@@ -292,7 +290,6 @@
     "prettier-plugin-tailwindcss": "^0.6.1",
     "react": "19.3.0",
     "react-dom": "19.3.0",
-    "react-grab": "^0.1.16",
     "rollup-plugin-visualizer": "^5.12.0",
     "simple-zustand-devtools": "^1.1.0",
     "tailwindcss": "^3.4.1",

package/src/data-app-sdk/README.md

@@ -12,7 +12,6 @@ Do not inspect SDK implementation internals to discover these patterns.
 ```tsx
 import {
   SemaphorDataAppProvider,
-  SemaphorDevtools,
   semaphor,
   useClearInvalidSemaphorInputValue,
   useSemaphorInputs,
@@ -28,46 +27,24 @@ import type {
 } from "react-semaphor/data-app-sdk";
 ```
 
-## Runtime Provider And DevTools
-
-Generated local/dev apps should mount one root DevTools instance and enable the
-debug bridge only outside production embeds.
+## Runtime Provider
 
 ```tsx
 const runtimeToken = import.meta.env.VITE_SEMAPHOR_PROJECT_TOKEN;
-const enableDevtools =
-  import.meta.env.DEV ||
-  (typeof window !== "undefined" && window.location.hostname === "localhost");
 
 export function Root() {
   return (
-    <SemaphorDataAppProvider
-      token={runtimeToken}
-      debug={enableDevtools ? { exposeWindowBridge: true } : false}
-    >
+    <SemaphorDataAppProvider token={runtimeToken} debug={import.meta.env.DEV}>
       <App />
-      <SemaphorDevtools
-        initialIsOpen={false}
-        buttonPosition="bottom-right"
-        panelPosition="right"
-      />
     </SemaphorDataAppProvider>
   );
 }
 ```
 
-Add hook-level debug source hints when they are cheap and non-repetitive:
-
-```tsx
-const result = useSemaphorQuery(revenueBySegment, {
-  debug: {
-    sourceHint: {
-      file: "src/views/RevenueBySegment.tsx",
-      component: "RevenueBySegment",
-    },
-  },
-});
-```
+With `debug` on, each query asks the server for debug detail. For an
+organization user, the result's `executionResult.metadata.dataAppDebug` then
+carries the request id, duration and compiled SQL. Keep it off in production
+embeds.
 
 ## Query State
 
@@ -129,8 +106,7 @@ Important state fields:
 
 Validation failures produce a structured `SemaphorDataAppQueryError` in
 `result.error`, with `kind: "data_app_query_error"`, `validation`,
-`validationIssues`, and `executionResult` when available. DevTools traces expose
-the same execution status and structured issues.
+`validationIssues`, and `executionResult` when available.
 
 ## Source And Fields
 

package/dist/chunks/pivot-result-contract-expectations-fKBHFPfz.js

@@ -1,56 +0,0 @@
-var c = Object.defineProperty;
-var d = (r, e, t) => e in r ? c(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var l = (r, e, t) => d(r, typeof e != "symbol" ? e + "" : e, t);
-import { G as u } from "./temporal-bucket-DzyadxVY.js";
-import "./validators-CZo_H4E6.js";
-import "./matrix-operation-contract-C1G6AJNh.js";
-import { r as v } from "./metric-comparison-BfcmwxM1.js";
-import "./analytics-base-schemas-BUFUoO6G.js";
-import "zod";
-class m extends Error {
-  constructor(t, a) {
-    super(`${t}: ${a}`);
-    l(this, "deliveryBlocking", !0);
-    this.code = t, this.name = "PivotHeaderPresentationError";
-  }
-}
-function k(r) {
-  var i;
-  const e = r.mode ?? "formatted", t = r.members.map((o) => {
-    var n;
-    if (e === "canonical" || !o.temporalBucket)
-      return o.value === null ? "" : String(o.value);
-    const s = (n = r.resolveTemporalFormat) == null ? void 0 : n.call(r, o.fieldId);
-    if (!s)
-      throw new m(
-        "missing_resolved_temporal_format",
-        `Missing resolved temporal presentation for pivot field "${o.fieldId}"`
-      );
-    return u({
-      value: o.value,
-      metadata: o.temporalBucket,
-      format: s
-    });
-  }), a = ((i = r.metricLabel) == null ? void 0 : i.trim()) || void 0;
-  return {
-    memberLabels: t,
-    ...a ? { metricLabel: a } : {},
-    flattenedLabel: [
-      ...t,
-      ...a ? [a] : []
-    ].join(" / ")
-  };
-}
-function B(r) {
-  const e = /* @__PURE__ */ new Map();
-  return r.forEach((t) => {
-    t.id && e.set(t.id, (e.get(t.id) ?? 0) + 1);
-  }), r.flatMap(
-    (t) => t.id && (e.get(t.id) ?? 0) > 1 ? [v(t)] : []
-  );
-}
-export {
-  m as P,
-  B as d,
-  k as p
-};

package/dist/chunks/raw-temporal-contract-CjHaUIsE.js

@@ -1,64 +0,0 @@
-var d = Object.defineProperty;
-var i = (a, e, t) => e in a ? d(a, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[e] = t;
-var n = (a, e, t) => i(a, typeof e != "symbol" ? e + "" : e, t);
-import { R as l } from "./analytics-base-schemas-BUFUoO6G.js";
-class r extends Error {
-  constructor(t) {
-    super(t);
-    n(this, "code");
-    this.name = "RawTemporalMetadataContractError", this.code = l.invalidMetadata;
-  }
-}
-function s(a) {
-  if (a === null || typeof a != "object" || Array.isArray(a))
-    return !1;
-  const e = Object.getPrototypeOf(a);
-  return e === null || e === Object.prototype;
-}
-function m(a) {
-  if (!s(a))
-    throw new r(
-      "Raw temporal metadata must be an object."
-    );
-  const e = Object.keys(a);
-  if (e.length !== 2 || !e.includes("kind") || !e.includes("valueKind"))
-    throw new r(
-      "Raw temporal metadata must contain only kind and valueKind."
-    );
-  if (a.kind !== "raw_temporal")
-    throw new r(
-      "Raw temporal metadata kind must be raw_temporal."
-    );
-  if (a.valueKind !== "date" && a.valueKind !== "wall_datetime" && a.valueKind !== "instant")
-    throw new r(
-      "Raw temporal valueKind must be date, wall_datetime, or instant."
-    );
-  return {
-    kind: "raw_temporal",
-    valueKind: a.valueKind
-  };
-}
-function u(a, e) {
-  if (!a.rawTemporal) {
-    if (e.metadataRequired)
-      throw new r(
-        "Activated raw temporal result is missing metadata."
-      );
-    return;
-  }
-  if (a.temporalBucket)
-    throw new r(
-      "A result column cannot carry both raw and grouped temporal metadata."
-    );
-  const t = m(a.rawTemporal), o = t.valueKind === "date" ? "date" : "datetime";
-  if (a.dataType !== o)
-    throw new r(
-      `${t.valueKind} raw temporal values require dataType ${o}.`
-    );
-  return t;
-}
-export {
-  r as R,
-  m as p,
-  u as v
-};