react-semaphor 0.1.381 → 0.1.383

package/dist/types/main.d.ts

@@ -4875,15 +4875,9 @@ declare type SemaphorDerivedFieldInput = {
     kind: 'field';
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
-} | {
-    kind: 'metric';
-    metric: SemaphorFieldRef;
-} | {
-    kind: 'dimension';
-    dimension: SemaphorFieldRef;
 };
 
-declare type SemaphorDerivedFieldResultRole = 'measure' | 'group' | 'date' | 'id' | 'filter';
+declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' | 'id' | 'unknown';
 
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
@@ -4907,9 +4901,10 @@ declare type SemaphorFieldRef = {
 declare type SemaphorInputBinding = {
     inputId: string;
     kind?: 'filter' | 'control';
-    controlRole?: 'grain' | 'metric' | 'dimension' | 'aggregation' | 'sqlParam';
+    controlRole?: 'grain' | 'measure' | 'dimension' | 'aggregation' | 'sqlParam';
     operator?: SemaphorInputOperator;
     field?: SemaphorFieldRef;
+    relationshipHint?: SemaphorRelationshipHint;
 };
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
@@ -4919,10 +4914,17 @@ declare type SemaphorInputOptionsIntent = {
     version?: SemaphorProtocolVersion;
     id?: string;
     label?: string;
+    inputId: string;
     source: SemaphorSourceRef;
-    field: SemaphorFieldRef;
+    labelField: SemaphorFieldRef;
+    valueField: SemaphorFieldRef;
+    searchField?: SemaphorFieldRef;
+    disambiguationFields?: SemaphorFieldRef[];
+    population?: SemaphorOptionPopulation;
+    dependencies?: SemaphorOptionDependencies;
     search?: string;
     limit?: number;
+    inputs?: SemaphorInputBinding[];
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
@@ -4984,6 +4986,7 @@ declare type SemaphorMatrixIntent = {
     values: SemaphorMatrixValueField[];
     filters?: SemaphorAnalyticsFilter[];
     inputs?: SemaphorInputBinding[];
+    relationshipHint?: SemaphorRelationshipHint;
     totals?: SemaphorMatrixTotalOptions;
     sort?: SemaphorMatrixSortRule[];
     expansion?: SemaphorMatrixExpansionOptions;
@@ -5106,8 +5109,8 @@ declare type SemaphorMetricIntent = {
     version?: SemaphorProtocolVersion;
     id?: string;
     source: SemaphorSourceRef;
-    metrics: SemaphorFieldRef[];
-    primaryMetric?: SemaphorFieldRef;
+    measures: SemaphorFieldRef[];
+    primaryMeasure?: SemaphorFieldRef;
     label?: string;
     dateField?: SemaphorFieldRef;
     timeGrain?: SemaphorTimeGrain;
@@ -5124,10 +5127,26 @@ declare type SemaphorMetricIntent = {
         direction: 'asc' | 'desc';
     };
     inputs?: SemaphorInputBinding[];
+    relationshipHint?: SemaphorRelationshipHint;
     limit?: number;
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
+declare type SemaphorOptionDependencies = {
+    mode?: 'auto' | 'independent' | 'explicit';
+    includeInputIds?: string[];
+    excludeInputIds?: string[];
+};
+
+declare type SemaphorOptionPopulation = {
+    kind: 'option_source';
+    baseSource?: never;
+} | {
+    kind: 'related_population';
+    baseSource: SemaphorSourceRef;
+    relationshipHint?: SemaphorRelationshipHint;
+};
+
 declare type SemaphorPaginationMetadata = {
     page: number;
     pageSize: number;
@@ -5170,9 +5189,14 @@ declare type SemaphorRecordsIntent = {
         direction: 'asc' | 'desc';
     };
     inputs?: SemaphorInputBinding[];
+    relationshipHint?: SemaphorRelationshipHint;
     derivedFields?: SemaphorDerivedFieldDefinition[];
 };
 
+declare type SemaphorRelationshipHint = {
+    relationshipIds?: string[];
+};
+
 declare type SemaphorRelativeTimeWindow = {
     kind?: 'relative';
     unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';

package/dist/types/shared.d.ts

@@ -1655,15 +1655,9 @@ declare type SemaphorDerivedFieldInput = {
     kind: 'field';
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
-} | {
-    kind: 'metric';
-    metric: SemaphorFieldRef;
-} | {
-    kind: 'dimension';
-    dimension: SemaphorFieldRef;
 };
 
-declare type SemaphorDerivedFieldResultRole = 'measure' | 'group' | 'date' | 'id' | 'filter';
+declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' | 'id' | 'unknown';
 
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
@@ -1687,9 +1681,10 @@ declare type SemaphorFieldRef = {
 declare type SemaphorInputBinding = {
     inputId: string;
     kind?: 'filter' | 'control';
-    controlRole?: 'grain' | 'metric' | 'dimension' | 'aggregation' | 'sqlParam';
+    controlRole?: 'grain' | 'measure' | 'dimension' | 'aggregation' | 'sqlParam';
     operator?: SemaphorInputOperator;
     field?: SemaphorFieldRef;
+    relationshipHint?: SemaphorRelationshipHint;
 };
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
@@ -1752,6 +1747,7 @@ declare type SemaphorMatrixIntent = {
     values: SemaphorMatrixValueField[];
     filters?: SemaphorAnalyticsFilter[];
     inputs?: SemaphorInputBinding[];
+    relationshipHint?: SemaphorRelationshipHint;
     totals?: SemaphorMatrixTotalOptions;
     sort?: SemaphorMatrixSortRule[];
     expansion?: SemaphorMatrixExpansionOptions;
@@ -1840,6 +1836,10 @@ declare type SemaphorMatrixValueField = {
 
 declare type SemaphorProtocolVersion = 1;
 
+declare type SemaphorRelationshipHint = {
+    relationshipIds?: string[];
+};
+
 declare type SemaphorSemanticSourceRef = Extract<SemaphorSourceRef, {
     kind: 'semantic';
 }>;

package/dist/types/surfboard.d.ts

@@ -2015,15 +2015,9 @@ declare type SemaphorDerivedFieldInput = {
     kind: 'field';
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
-} | {
-    kind: 'metric';
-    metric: SemaphorFieldRef;
-} | {
-    kind: 'dimension';
-    dimension: SemaphorFieldRef;
 };
 
-declare type SemaphorDerivedFieldResultRole = 'measure' | 'group' | 'date' | 'id' | 'filter';
+declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' | 'id' | 'unknown';
 
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
@@ -2047,9 +2041,10 @@ declare type SemaphorFieldRef = {
 declare type SemaphorInputBinding = {
     inputId: string;
     kind?: 'filter' | 'control';
-    controlRole?: 'grain' | 'metric' | 'dimension' | 'aggregation' | 'sqlParam';
+    controlRole?: 'grain' | 'measure' | 'dimension' | 'aggregation' | 'sqlParam';
     operator?: SemaphorInputOperator;
     field?: SemaphorFieldRef;
+    relationshipHint?: SemaphorRelationshipHint;
 };
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
@@ -2112,6 +2107,7 @@ declare type SemaphorMatrixIntent = {
     values: SemaphorMatrixValueField[];
     filters?: SemaphorAnalyticsFilter[];
     inputs?: SemaphorInputBinding[];
+    relationshipHint?: SemaphorRelationshipHint;
     totals?: SemaphorMatrixTotalOptions;
     sort?: SemaphorMatrixSortRule[];
     expansion?: SemaphorMatrixExpansionOptions;
@@ -2200,6 +2196,10 @@ declare type SemaphorMatrixValueField = {
 
 declare type SemaphorProtocolVersion = 1;
 
+declare type SemaphorRelationshipHint = {
+    relationshipIds?: string[];
+};
+
 declare type SemaphorSemanticSourceRef = Extract<SemaphorSourceRef, {
     kind: 'semantic';
 }>;

package/dist/types/types.d.ts

@@ -3010,15 +3010,9 @@ declare type SemaphorDerivedFieldInput = {
     kind: 'field';
     field: SemaphorFieldRef;
     aggregate?: SemaphorAggregateFunction;
-} | {
-    kind: 'metric';
-    metric: SemaphorFieldRef;
-} | {
-    kind: 'dimension';
-    dimension: SemaphorFieldRef;
 };
 
-declare type SemaphorDerivedFieldResultRole = 'measure' | 'group' | 'date' | 'id' | 'filter';
+declare type SemaphorDerivedFieldResultRole = 'measure' | 'dimension' | 'date' | 'id' | 'unknown';
 
 declare type SemaphorDialect = 'postgres' | 'mysql' | 'mssql' | 'snowflake' | 'clickhouse' | 'bigquery' | 'redshift' | 'duckdb' | 'sqlite' | 'unknown';
 
@@ -3042,9 +3036,10 @@ declare type SemaphorFieldRef = {
 declare type SemaphorInputBinding = {
     inputId: string;
     kind?: 'filter' | 'control';
-    controlRole?: 'grain' | 'metric' | 'dimension' | 'aggregation' | 'sqlParam';
+    controlRole?: 'grain' | 'measure' | 'dimension' | 'aggregation' | 'sqlParam';
     operator?: SemaphorInputOperator;
     field?: SemaphorFieldRef;
+    relationshipHint?: SemaphorRelationshipHint;
 };
 
 declare type SemaphorInputOperator = '=' | '!=' | 'in' | 'not_in' | 'contains' | 'not_contains' | 'between' | 'not_between' | '>' | '>=' | '<' | '<=';
@@ -3107,6 +3102,7 @@ declare type SemaphorMatrixIntent = {
     values: SemaphorMatrixValueField[];
     filters?: SemaphorAnalyticsFilter[];
     inputs?: SemaphorInputBinding[];
+    relationshipHint?: SemaphorRelationshipHint;
     totals?: SemaphorMatrixTotalOptions;
     sort?: SemaphorMatrixSortRule[];
     expansion?: SemaphorMatrixExpansionOptions;
@@ -3230,6 +3226,10 @@ declare type SemaphorProtocolVersion = 1;
 
 declare type SemaphorQueryPath = 'query_spec' | 'sql' | 'sql_python';
 
+declare type SemaphorRelationshipHint = {
+    relationshipIds?: string[];
+};
+
 declare type SemaphorSemanticSourceRef = Extract<SemaphorSourceRef, {
     kind: 'semantic';
 }>;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.381",
+  "version": "0.1.383",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -16,7 +16,9 @@
   "type": "module",
   "files": [
     "dist",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "DATA_APP_SDK.md",
+    "src/data-app-sdk/README.md"
   ],
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -72,6 +74,11 @@
       "import": "./dist/data-app-sdk/index.js",
       "require": "./dist/data-app-sdk/index.cjs"
     },
+    "./data-app-sdk/adapters": {
+      "types": "./dist/types/data-app-sdk-adapters.d.ts",
+      "import": "./dist/data-app-sdk-adapters/index.js",
+      "require": "./dist/data-app-sdk-adapters/index.cjs"
+    },
     "./data-app-sdk/validation": {
       "types": "./dist/types/data-app-sdk-validation.d.ts",
       "import": "./dist/data-app-sdk-validation/index.js",

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

@@ -0,0 +1,240 @@
+# Data App SDK Quick Reference
+
+Use this file as the public contract quick reference for generated Semaphor
+Data Apps. Do not inspect SDK implementation internals to discover these
+patterns.
+
+## Imports
+
+```tsx
+import {
+  SemaphorDataAppProvider,
+  semaphor,
+  useClearInvalidSemaphorInputValue,
+  useSemaphorInputs,
+  useSemaphorQuery,
+} from "react-semaphor/data-app-sdk";
+
+import type {
+  SemaphorQueryResult,
+  SemaphorRecordsField,
+  SemaphorRecordsQueryResult,
+  SemaphorSourceRef,
+} from "react-semaphor/data-app-sdk";
+```
+
+## Source And Fields
+
+```tsx
+const source = {
+  kind: "semantic",
+  domainId: "sales",
+  datasetName: "orders",
+} satisfies SemaphorSourceRef;
+
+const revenue = {
+  name: "revenue",
+  label: "Revenue",
+  role: "measure",
+  dataType: "number",
+  aggregate: "SUM",
+  source,
+} satisfies SemaphorRecordsField;
+
+const segment = {
+  name: "segment",
+  label: "Segment",
+  role: "dimension",
+  dataType: "string",
+  source,
+} satisfies SemaphorRecordsField;
+```
+
+Use `SemaphorRecordsField` for `semaphor.records(...)` fields so every selected
+field has a concrete role.
+
+## Metric
+
+```tsx
+const revenueKpi = semaphor.metric({
+  id: "revenue-kpi",
+  source,
+  measures: [revenue],
+  primaryMeasure: revenue,
+});
+
+const result = useSemaphorQuery(revenueKpi);
+```
+
+## Records
+
+```tsx
+const revenueBySegment = semaphor.records({
+  id: "revenue-by-segment",
+  source,
+  fields: [segment, revenue],
+  orderBy: { field: revenue, direction: "desc" },
+  limit: 10,
+});
+
+const result = useSemaphorQuery(revenueBySegment);
+```
+
+## Row Access
+
+Read rows with `columns[].key`; display `columns[].label`.
+
+```tsx
+function RecordsTable({ result }: { result: SemaphorRecordsQueryResult }) {
+  const records = result.records ?? [];
+  const columns = result.columns ?? [];
+
+  return (
+    <table>
+      <thead>
+        <tr>
+          {columns.map((column) => (
+            <th key={column.key}>{column.label || column.name}</th>
+          ))}
+        </tr>
+      </thead>
+      <tbody>
+        {records.map((row, rowIndex) => (
+          <tr key={rowIndex}>
+            {columns.map((column) => (
+              <td key={column.key}>{String(row[column.key] ?? "")}</td>
+            ))}
+          </tr>
+        ))}
+      </tbody>
+    </table>
+  );
+}
+```
+
+When accepting a generic `SemaphorQueryResult`, narrow before reading records:
+
+```tsx
+function queryRecords(result: SemaphorQueryResult) {
+  return "records" in result && Array.isArray(result.records)
+    ? result.records
+    : [];
+}
+```
+
+## Input Options
+
+```tsx
+const segmentFilter = semaphor.filter({
+  id: "segment",
+  label: "Segment",
+  field: segment,
+  operator: "in",
+});
+
+const segmentOptions = semaphor.inputOptions({
+  id: "segment-options",
+  inputId: "segment",
+  source,
+  labelField: segment,
+  valueField: segment,
+  dependencies: { mode: "auto" },
+  limit: 100,
+});
+
+function SegmentFilter() {
+  const [segmentHandle] = useSemaphorInputs([segmentFilter]);
+  const optionsResult = useSemaphorQuery(segmentOptions, {
+    inputs: [segmentHandle],
+  });
+
+  useClearInvalidSemaphorInputValue(segmentHandle, optionsResult);
+}
+```
+
+Pass the full `optionsResult` to `useClearInvalidSemaphorInputValue`; do not
+pass only `optionsResult.options`, because idle/loading results can also expose
+an empty options array.
+
+## Shared Inputs With Source-Specific Bindings
+
+Use `semaphor.bindInput(...)` when one visible input maps to different query
+fields.
+
+```tsx
+const dateRange = semaphor.filter({
+  id: "date_range",
+  label: "Date Range",
+  field: orderDate,
+  operator: "between",
+});
+
+function Dashboard() {
+  const [dateRangeHandle] = useSemaphorInputs([dateRange]);
+
+  const orders = useSemaphorQuery(ordersQuery, {
+    inputs: [semaphor.bindInput(dateRangeHandle, { field: orderDate })],
+  });
+  const invoices = useSemaphorQuery(invoicesQuery, {
+    inputs: [semaphor.bindInput(dateRangeHandle, { field: invoiceDate })],
+  });
+
+  const range = Array.isArray(dateRangeHandle.value)
+    ? dateRangeHandle.value
+    : [];
+  const [start, end] = range;
+}
+```
+
+Narrow `handle.value` with `Array.isArray(...)` before indexing date ranges or
+multi-select values.
+
+## Related Dimension Filters
+
+Use a related human-readable dimension as the visible filter and preserve the
+relationship hint when binding that input into each fact query.
+
+```tsx
+const materialFamilyFilter = semaphor.filter<string[]>({
+  id: "material_family",
+  label: "Material Family",
+  field: materialFamily,
+  operator: "in",
+  multi: true,
+});
+
+const materialOptions = semaphor.inputOptions({
+  id: "material-family-options",
+  inputId: "material_family",
+  source: materialSource,
+  labelField: materialFamily,
+  valueField: materialFamily,
+  limit: 100,
+});
+
+function OpsViews() {
+  const materialHandle = useSemaphorInput(materialFamilyFilter);
+  useSemaphorQuery(materialOptions);
+
+  useSemaphorQuery(purchaseQuery, {
+    inputs: [
+      semaphor.bindInput(materialHandle, {
+        field: materialFamily,
+        relationshipHint: { relationshipIds: ["purchase_material"] },
+      }),
+    ],
+  });
+
+  useSemaphorQuery(salesQuery, {
+    inputs: [
+      semaphor.bindInput(materialHandle, {
+        field: materialFamily,
+        relationshipHint: { relationshipIds: ["sales_material"] },
+      }),
+    ],
+  });
+}
+```
+
+Do not fetch broad rows and filter or join them in React to simulate
+related-dimension behavior. Let Semaphor execute the relationship-aware filter.

package/dist/chunks/calendar-preferences-dialog-iZs8XqyH.js

@@ -1 +0,0 @@
-"use strict";const e=require("react/jsx-runtime"),l=require("react"),t=require("./index-CkoRCh3g.js"),o=require("./switch-Jhyl63RF.js");require("./index-BxM99sFL.js");require("./catalog-field-grounding-8L9I0zdg.js");function G(n={}){var y,P,z,A;const{authToken:d,tokenProps:a}=t.useSemaphorContext(),x=n.enabled??!0,m=(d==null?void 0:d.accessToken)??null,f=(a==null?void 0:a.apiServiceUrl)??null,[L,C]=l.useState(!1),[j,b]=l.useState(!1),[h,g]=l.useState(!1),[N,c]=l.useState(null),[v,S]=l.useState(null),k=v||{tz:((P=(y=a==null?void 0:a.params)==null?void 0:y.calendarContext)==null?void 0:P.tz)||null,weekStart:((A=(z=a==null?void 0:a.params)==null?void 0:z.calendarContext)==null?void 0:A.weekStart)??null},p=l.useCallback(async()=>{if(!(!x||!m||!f)){C(!0),c(null);try{const i=await fetch(`${f}/v1/user-preferences/calendar`,{method:"GET",headers:{Authorization:`Bearer ${m}`}});if(!i.ok){const u=await i.json().catch(()=>({}));throw new Error(u.error||"Failed to fetch preferences")}const r=await i.json();S({tz:r.tz,weekStart:r.weekStart,source:r.source,isInherited:r.isInherited,userHasPrefs:r.userHasPrefs,inherited:r.inherited})}catch(i){const r=i instanceof Error?i.message:"Unknown error";c(r)}finally{C(!1)}}},[m,f,x]);l.useEffect(()=>{x&&p()},[x,p]);const T=l.useCallback(async i=>{if(!m||!f)return c("Not authenticated"),!1;b(!0),c(null);try{const r=await fetch(`${f}/v1/user-preferences/calendar`,{method:"PATCH",headers:{"Content-Type":"application/json",Authorization:`Bearer ${m}`},body:JSON.stringify(i)});if(!r.ok){const u=await r.json().catch(()=>({}));throw new Error(u.error||"Failed to update preferences")}return await p(),!0}catch(r){const u=r instanceof Error?r.message:"Unknown error";return c(u),!1}finally{b(!1)}},[m,f,p]),w=l.useCallback(async()=>{if(!m||!f)return c("Not authenticated"),!1;g(!0),c(null);try{const i=await fetch(`${f}/v1/user-preferences/calendar`,{method:"DELETE",headers:{Authorization:`Bearer ${m}`}});if(!i.ok){const u=await i.json().catch(()=>({}));throw new Error(u.error||"Failed to clear preferences")}const r=await i.text();if(r)try{const u=JSON.parse(r);return S({tz:u.tz,weekStart:u.weekStart,source:u.source,isInherited:u.isInherited??!0,userHasPrefs:!1,inherited:u.inherited}),!0}catch{}return await p(),!0}catch(i){const r=i instanceof Error?i.message:"Unknown error";return c(r),!1}finally{g(!1)}},[m,f,p]);return{preferences:k,isLoading:L,isSaving:j,isClearing:h,error:N,updatePreferences:T,clearPreferences:w,refetch:p}}const E=[{value:"America/New_York",label:"Eastern Time (US & Canada)"},{value:"America/Chicago",label:"Central Time (US & Canada)"},{value:"America/Denver",label:"Mountain Time (US & Canada)"},{value:"America/Los_Angeles",label:"Pacific Time (US & Canada)"},{value:"America/Phoenix",label:"Arizona"},{value:"America/Anchorage",label:"Alaska"},{value:"Pacific/Honolulu",label:"Hawaii"},{value:"Europe/London",label:"London"},{value:"Europe/Paris",label:"Paris, Berlin, Rome"},{value:"Asia/Tokyo",label:"Tokyo"},{value:"Asia/Shanghai",label:"Beijing, Shanghai"},{value:"Asia/Kolkata",label:"Mumbai, New Delhi"},{value:"Australia/Sydney",label:"Sydney"},{value:"UTC",label:"UTC"}],M=[{value:0,label:"Sunday"},{value:1,label:"Monday"},{value:6,label:"Saturday"}],H="text-[10px] font-medium uppercase tracking-[0.08em] text-muted-foreground";function W(){try{const n=Intl;if(n.supportedValuesOf)return n.supportedValuesOf("timeZone")}catch{}return E.map(n=>n.value)}function _(n){switch(n){case"tenant":return"tenant";case"organization":return"organization";case"system":return"system";default:return"default"}}function O(n){const d=E.find(a=>a.value===n);return d?d.label:n}function q(n){const d=M.find(a=>a.value===n);return d?d.label:String(n)}function V({open:n,onOpenChange:d}){var D,U,F;const{preferences:a,isLoading:x,isSaving:m,isClearing:f,updatePreferences:L,clearPreferences:C}=G({enabled:n}),j=a.tz||((D=a.inherited)==null?void 0:D.tz)||Intl.DateTimeFormat().resolvedOptions().timeZone,b=a.weekStart??((U=a.inherited)==null?void 0:U.weekStart)??1,[h,g]=l.useState(!a.userHasPrefs),[N,c]=l.useState(!1),[v,S]=l.useState(j),[k,p]=l.useState(b),[T,w]=l.useState(!1),y=l.useMemo(()=>W(),[]),P=l.useMemo(()=>y.filter(s=>!E.some(R=>R.value===s)),[y]),z=l.useMemo(()=>O(v),[v]),A=a.inherited?O(a.inherited.tz):"UTC",i=a.inherited?q(a.inherited.weekStart):"Monday",r=_((F=a.inherited)==null?void 0:F.source);l.useEffect(()=>{if(!n){c(!1);return}N||(a.userHasPrefs!==void 0&&g(!a.userHasPrefs),S(j),p(b))},[n,N,a.userHasPrefs,j,b]);const u=async()=>{if(x){t.ue.error("Preferences are still loading. Please try again.");return}h?await C()?(t.ue.success("Now using default settings. Please refresh the page to apply changes.",{duration:5e3}),d(!1)):t.ue.error("Failed to save preferences. Please try again."):await L({tz:v,weekStart:k})?(t.ue.success("Preferences saved. Please refresh the page to apply changes.",{duration:5e3}),d(!1)):t.ue.error("Failed to save preferences. Please try again.")},$=()=>{d(!1)},I=m||f,B=I||x;return e.jsx(t.Dialog,{open:n,onOpenChange:d,children:e.jsxs(t.DialogContent,{className:"rounded-control border-border/60 sm:max-w-[440px] sm:rounded-control",children:[e.jsxs(t.DialogHeader,{children:[e.jsx(t.DialogTitle,{className:"text-[15px]",children:"Calendar preferences"}),e.jsx(t.DialogDescription,{className:"text-[13px] leading-5",children:"Set your timezone and week-start for date calculations and displays."})]}),e.jsxs("div",{className:"space-y-4 py-1",children:[e.jsxs(t.RadioGroup,{value:h?"defaults":"custom",onValueChange:s=>{c(!0),g(s==="defaults")},className:"space-y-0.5",children:[e.jsxs("label",{htmlFor:"mode-defaults",className:o.cn("flex cursor-pointer items-start gap-2 rounded-control px-2 py-1.5 hover:bg-muted/50",h&&"bg-muted/50"),onClick:()=>{c(!0),g(!0)},children:[e.jsx(t.RadioGroupItem,{value:"defaults",id:"mode-defaults",className:"mt-0.5"}),e.jsxs("div",{className:"flex-1 min-w-0",children:[e.jsxs("p",{className:"text-[13px] font-medium text-foreground",children:["Use ",r," defaults"]}),e.jsxs("p",{className:"text-[12px] text-muted-foreground",children:[A,", week starts ",i]})]})]}),e.jsxs("label",{htmlFor:"mode-custom",className:o.cn("flex cursor-pointer items-start gap-2 rounded-control px-2 py-1.5 hover:bg-muted/50",!h&&"bg-muted/50"),onClick:()=>{c(!0),g(!1)},children:[e.jsx(t.RadioGroupItem,{value:"custom",id:"mode-custom",className:"mt-0.5"}),e.jsx("p",{className:"flex-1 text-[13px] font-medium text-foreground",children:"Use custom settings"})]})]}),e.jsxs("div",{className:o.cn("space-y-4 border-t border-border/60 pt-4 transition-opacity",h&&"pointer-events-none opacity-50"),children:[e.jsxs("div",{className:"space-y-1.5",children:[e.jsx(o.Label,{className:H,children:"Timezone"}),e.jsxs(o.Popover,{open:T,onOpenChange:w,modal:!0,children:[e.jsx(o.PopoverTrigger,{asChild:!0,children:e.jsxs(o.Button,{variant:"outline",size:"xs",role:"combobox","aria-expanded":T,className:"w-full justify-between text-[12px] font-normal",disabled:h,children:[e.jsx("span",{className:"truncate",children:z}),e.jsx(t.ChevronsUpDown,{className:"ml-2 h-3.5 w-3.5 shrink-0 opacity-50"})]})}),e.jsx(o.PopoverContent,{className:"z-50 w-[--radix-popover-trigger-width] p-0",align:"start",children:e.jsxs(t.Command,{className:"overflow-visible",children:[e.jsx(t.CommandInput,{placeholder:"Search timezones…"}),e.jsxs(t.CommandList,{children:[e.jsx(t.CommandEmpty,{children:"No timezone found."}),e.jsx(t.CommandGroup,{heading:"Common",children:E.map(s=>e.jsxs(t.CommandItem,{value:`${s.value} ${s.label}`,onSelect:()=>{c(!0),S(s.value),w(!1)},children:[e.jsx(o.Check,{className:o.cn("h-3.5 w-3.5",v===s.value?"opacity-100":"opacity-0")}),e.jsx("span",{className:"flex-1",children:s.label}),e.jsx("span",{className:"text-[11px] text-muted-foreground",children:s.value})]},s.value))}),e.jsx(t.CommandSeparator,{}),e.jsx(t.CommandGroup,{heading:"All timezones",children:P.map(s=>e.jsxs(t.CommandItem,{value:s,onSelect:()=>{c(!0),S(s),w(!1)},children:[e.jsx(o.Check,{className:o.cn("h-3.5 w-3.5",v===s?"opacity-100":"opacity-0")}),s]},s))})]})]})})]})]}),e.jsxs("div",{className:"space-y-1.5",children:[e.jsx(o.Label,{className:H,children:"Week starts on"}),e.jsx(t.RadioGroup,{value:String(k),onValueChange:s=>{c(!0),p(Number(s))},className:"flex gap-4",disabled:h,children:M.map(s=>e.jsxs("label",{htmlFor:`week-start-${s.value}`,className:o.cn("flex cursor-pointer items-center gap-2 text-[13px]",h&&"cursor-not-allowed"),children:[e.jsx(t.RadioGroupItem,{value:String(s.value),id:`week-start-${s.value}`,disabled:h}),s.label]},s.value))})]})]})]}),e.jsxs(t.DialogFooter,{children:[e.jsx(o.Button,{variant:"outline",size:"xs",onClick:$,disabled:I,children:"Cancel"}),e.jsx(o.Button,{size:"xs",onClick:u,disabled:B,children:I?e.jsxs(e.Fragment,{children:[e.jsx(o.LoaderCircle,{className:"h-3.5 w-3.5 animate-spin"}),"Saving…"]}):"Save"})]})]})})}exports.CalendarPreferencesDialog=V;

package/dist/chunks/catalog-field-grounding-8L9I0zdg.js

@@ -1 +0,0 @@
-"use strict";const o={answerSummary:"string",responseDetail:"responseDetail",mode:"string",comparisonType:"string",executionResult:"unknown",compiledQuery:"unknown",data:"unknown",resultSets:"record",columns:"unknownArray",records:"recordArray",rowCount:"number",rowLimitExceeded:"boolean",output:"string",querySpec:"unknown",metadata:"record",validation:"unknown",coverage:"unknown",diagnosticFeedback:"unknown",missingFields:"stringArray",warnings:"unknownArray",comparison:"unknown",population:"unknown",comparisons:"recordArray",fieldsUsed:"unknown",changes:"recordArray",largestNegativeChanges:"recordArray",largestPositiveChanges:"recordArray",drivers:"recordArray",absoluteDeltaDrivers:"recordArray",largestNegativeDrivers:"recordArray",largestPositiveDrivers:"recordArray",periodRows:"recordArray",sql:"unknown",omitted:"stringArray"},b=new Set(Object.keys(o)),S=new Set(["compact","standard","debug"]);function D(){return Object.keys(o)}function g(e){return b.has(e)}function F(e){if(!e||typeof e!="object"||Array.isArray(e))throw new Error("Semaphor analyze result must be an object.");const n=e,t=Object.keys(n).filter(r=>!g(r));if(t.length)throw new Error(`Semaphor analyze result contains unsupported top-level field(s): ${t.join(", ")}.`);for(const[r,i]of Object.entries(n)){if(i===void 0)continue;const a=o[r];if(!k(i,a))throw new Error(`Semaphor analyze result field "${r}" does not match contract kind "${a}".`)}return n}function k(e,n){switch(n){case"boolean":return typeof e=="boolean";case"number":return typeof e=="number"&&Number.isFinite(e);case"record":return A(e);case"recordArray":return Array.isArray(e)&&e.every(A);case"responseDetail":return typeof e=="string"&&S.has(e);case"string":return typeof e=="string";case"stringArray":return Array.isArray(e)&&e.every(t=>typeof t=="string");case"unknown":return!0;case"unknownArray":return Array.isArray(e)}}function A(e){return!!(e&&typeof e=="object"&&!Array.isArray(e))}function c(e){return typeof e=="string"?e.trim().toLowerCase():""}function p(e){return String(e.column_name||e.name||e.qualifiedFieldName||"")}function w(e){return Array.from(new Set([e.column_name,e.name,e.qualifiedFieldName,e.alias].filter(n=>typeof n=="string"&&n.trim().length>0).map(n=>n.trim())))}function d(e){const n=T(e);return n?n.includes("int")||n.includes("uint")||n.includes("bigint")||n.includes("smallint")||n.includes("tinyint")||n.includes("numeric")||n.includes("decimal")||n.includes("double")||n.includes("float")||n.includes("number")||n.includes("real")||n.includes("money")||n.includes("currency")||n.includes("percent")?"number":n.includes("timestamp")||n.includes("datetime")||n.startsWith("time")?"datetime":n.includes("date")?"date":n.includes("bool")?"boolean":"string":"unknown"}function T(e){let n=c(e),t="";for(;n&&n!==t;)t=n,n=f(n,"nullable"),n=f(n,"lowcardinality");return n}function f(e,n){const t=`${n}(`;return!e.startsWith(t)||!e.endsWith(")")?e:e.slice(t.length,-1).trim()}function h(e){const n=d(e);return n==="date"||n==="datetime"}function u(e){return h(e.dataType||e.data_type)}function y(e){const n=C(e);return n==="id"||n==="row_id"}function l(e){const n=C(e);return y(e)||n.endsWith("_id")||n.endsWith("_key")||n.endsWith("_number")}function C(e){return c(p(e)||e.name||e.alias).replace(/[^a-z0-9]+/g,"_").replace(/^_+|_+$/g,"")}function m(e,n={}){const t=c(e.role);return t==="metric"||t==="measure"?!n.excludeIdentifiers||!l(e):t==="groupby"||t==="dimension"||t==="date"||t==="id"?!1:d(e.dataType||e.data_type)==="number"&&(!n.excludeIdentifiers||!l(e))}function _(e){return!m(e)&&!u(e)}function E(e){const n=new Set,t=new Set,r=new Set;for(const i of e){if(y(i))continue;const a=w(i);if(a.length!==0){if(u(i)){a.forEach(s=>t.add(s));continue}if(m(i,{excludeIdentifiers:!0})){a.forEach(s=>n.add(s));continue}a.forEach(s=>r.add(s))}}return{validMetricCandidates:Array.from(n).sort(),validDateCandidates:Array.from(t).sort(),validDimensionCandidates:Array.from(r).sort()}}exports.SEMAPHOR_ANALYZE_RESULT_FIELD_CONTRACT=o;exports.buildAnalyticsCatalogFieldSummary=E;exports.getAnalyticsCatalogFieldCandidates=w;exports.getAnalyticsCatalogFieldName=p;exports.getSemaphorAnalyzeResultFieldNames=D;exports.isAnalyticsCatalogDateField=u;exports.isAnalyticsCatalogDimensionField=_;exports.isAnalyticsCatalogMetricField=m;exports.isAnalyticsDateLikeDataType=h;exports.isAnalyticsMetricIdentifierField=l;exports.isAnalyticsTechnicalIdentifierField=y;exports.isSemaphorAnalyzeResultFieldName=g;exports.normalizeAnalyticsCatalogDataType=d;exports.normalizeAnalyticsCatalogName=c;exports.parseSemaphorAnalyzeResult=F;