react-semaphor 0.1.525 → 0.1.527

package/dist/types/shared/temporal/temporal-parity-fixtures.d.ts

@@ -0,0 +1,73 @@
+import { RelativeDateFilter } from '../analytics-protocol/relative-date-filter.js';
+import { WeekStart } from '../report-runtime-context/index.js';
+import { TemporalUnit } from './calendar-periods.js';
+import { ZonedWallClockTime } from './zoned-wall-clock.js';
+/** A relative date resolved at an anchor: `[start, inclusive end]`. */
+export type TemporalParityRelativeCase = {
+    tz: string;
+    weekStart: WeekStart;
+    /** The month-aligned fiscal year's first month, when the calendar has one. */
+    fiscalStart?: number;
+    anchor: string;
+    relative: RelativeDateFilter;
+    expected: [string, string];
+    /**
+     * The browser's old result where it differed, and the rule that changed
+     * it: `fiscal_periods`, the browser ignored the fiscal calendar for
+     * quarters and years. Previews still show those as labels only (K8).
+     */
+    browser?: {
+        old: [string, string];
+        rule: 'fiscal_periods';
+    };
+};
+/** An instant moved by whole units in the timezone's wall clock. */
+export type TemporalParityShiftCase = {
+    tz: string;
+    at: string;
+    unit: TemporalUnit;
+    amount: number;
+    expected: string;
+};
+/** The period containing an instant: `[start, endExclusive]`. */
+export type TemporalParityPeriodCase = {
+    tz: string;
+    at: string;
+    unit: TemporalUnit;
+    weekStart?: WeekStart;
+    expected: [string, string];
+};
+/**
+ * A daylight-saving case (K7): the instant a wall clock names, or the period
+ * containing an instant. `before` is the old result, which depended on
+ * date-fns-tz's offset guess: a repeated hour took its second occurrence east
+ * of UTC, a skipped hour moved back, and a day starting after a skipped
+ * midnight started an hour early.
+ */
+export type TemporalParityDaylightCase = {
+    kind: 'instant';
+    tz: string;
+    wall: ZonedWallClockTime;
+    expected: string;
+    before: string;
+} | {
+    kind: 'period';
+    tz: string;
+    at: string;
+    unit: TemporalUnit;
+    expected: [string, string];
+    before: [string, string];
+};
+/**
+ * The parity grid (analytics kernel Phase 3): units, modes, the six
+ * timezones, week starts 0 to 6, fiscal start months 1 to 12 and four
+ * anchors. Both repos run it: react-semaphor against `shared/temporal`, and
+ * semaphor-app against the server functions that delegate to it. Built by a
+ * pure call, so a bundle that doesn't use it drops it.
+ */
+export declare const TEMPORAL_PARITY_FIXTURES: {
+    relative: TemporalParityRelativeCase[];
+    shifts: TemporalParityShiftCase[];
+    periods: TemporalParityPeriodCase[];
+    daylight: TemporalParityDaylightCase[];
+};

package/dist/types/shared/temporal/time-window-periods.d.ts

@@ -0,0 +1,21 @@
+import { TemporalCalendar, TemporalUnit } from './calendar-periods.js';
+/** A rolling window's length: `value` units. */
+export type TemporalSpan = {
+    unit: TemporalUnit;
+    value: number;
+};
+/**
+ * Where a window of `span` ending at `end` starts: elapsed time for seconds,
+ * minutes and hours; the same wall-clock time `value` units earlier for
+ * calendar units.
+ */
+export declare function subtractTimeSpan(end: Date, span: TemporalSpan, calendar: TemporalCalendar): Date;
+/** The `value` whole periods before the one containing `latest`. */
+export type CompletePeriodWindow = {
+    windowStart: Date;
+    /** The inclusive last instant: the millisecond before `latest`'s period. */
+    windowEnd: Date;
+    /** Whether `latest`'s own period, which is partial, was left out. */
+    excludedPartialPeriod: boolean;
+};
+export declare function completePeriodWindow(latest: Date, span: TemporalSpan, calendar: TemporalCalendar): CompletePeriodWindow;

package/dist/types/shared/temporal/zoned-wall-clock.d.ts

@@ -0,0 +1,23 @@
+export type ZonedWallClock = {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    second: number;
+};
+export declare function zonedWallClock(instant: Date, tz: string): ZonedWallClock;
+/** A wall-clock time, with optional milliseconds. */
+export type ZonedWallClockTime = ZonedWallClock & {
+    millisecond?: number;
+};
+/** The wall clock as if it were UTC, in milliseconds. */
+export declare function wallClockMilliseconds(wall: ZonedWallClockTime): number;
+/**
+ * The instant a wall-clock time names in a timezone (analytics kernel K7). A
+ * repeated hour takes its first occurrence; a skipped hour moves forward by
+ * the gap, as JavaScript's Temporal API and java.time do by default. The
+ * offsets a day either side cover any one change, and no offset reaches a
+ * day, so the answer never depends on the machine.
+ */
+export declare function zonedWallClockToInstant(wall: ZonedWallClockTime, tz: string): Date;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.525",
+  "version": "0.1.527",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -72,22 +72,6 @@
       "types": "./dist/types/data-app-sdk-validation.d.ts",
       "import": "./dist/data-app-sdk-validation/index.js"
     },
-    "./data-app-codegen": {
-      "types": "./dist/types/data-app-codegen.d.ts",
-      "import": "./dist/data-app-codegen/index.js"
-    },
-    "./data-app-codegen/node": {
-      "types": "./dist/types/data-app-codegen-node.d.ts",
-      "import": "./dist/data-app-codegen-node/index.js"
-    },
-    "./data-app-builder": {
-      "types": "./dist/types/data-app-builder.d.ts",
-      "import": "./dist/data-app-builder/index.js"
-    },
-    "./data-app-builder/browser-runtime": {
-      "types": "./dist/types/data-app-builder-browser-runtime.d.ts",
-      "import": "./dist/data-app-builder-browser-runtime/index.js"
-    },
     "./appearance": {
       "types": "./dist/types/appearance.d.ts",
       "import": "./dist/appearance/index.js"
@@ -134,6 +118,7 @@
     "check:card-config-consumers": "node scripts/card-config-consumers.mjs",
     "preview": "vite preview",
     "test": "vitest run",
+    "test:changed": "vitest run --changed",
     "test:watch": "vitest",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",

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

@@ -1,8 +1,11 @@
 # 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.
+> Frozen: no new work goes into this SDK. A replacement built on the shared
+> analytics protocol replaces it in place (semaphor-app
+> `docs/implementation-plans/analytics-mcp-and-sdk/PLAN-3-ANALYTICS-SDK.md`).
+
+Use this file as the public contract quick reference for Data App SDK code.
+Do not inspect SDK implementation internals to discover these patterns.
 
 ## Imports
 

package/dist/chunks/dashboard-date-comparison-definition-BqNhECUr.js

@@ -1,183 +0,0 @@
-import { al as _ } from "./validators-CsdOtZI6.js";
-function k(e) {
-  return `compat-filter:${e}`;
-}
-function j(e) {
-  return `compat-control:${e}`;
-}
-function z(e, n) {
-  return `compat-inline-filter:${e}:${n}`;
-}
-function M(e, n) {
-  return `compat-card-control:${e}:${n}`;
-}
-function C(e, n) {
-  const t = e.split(".").map((r) => r.trim()), i = n.split(".").map((r) => r.trim());
-  if (t.length === 0 || i.length === 0 || t.some((r) => !r) || i.some((r) => !r))
-    return !1;
-  const [s, o] = t.length <= i.length ? [t, i] : [i, t], a = o.length - s.length;
-  return s.every((r, c) => r === o[c + a]);
-}
-function N(e, n) {
-  const t = e.split("."), i = n.split("."), s = t.pop(), o = i.pop();
-  return !!(s && s === o && t.length > 0 && i.length > 0 && C(
-    t.join("."),
-    i.join(".")
-  ));
-}
-function q(e) {
-  const n = e.map((i) => i.trim()).filter(Boolean);
-  if (n.every(
-    (i, s) => n.slice(s + 1).every(
-      (o) => C(i, o)
-    )
-  ))
-    return [...n].sort(
-      (i, s) => s.split(".").length - i.split(".").length
-    )[0];
-}
-function u(e) {
-  return typeof e == "object" && e !== null && !Array.isArray(e);
-}
-function h(e) {
-  if (typeof e != "string") return "";
-  const n = e.split(".").map((t) => t.trim());
-  return n.length > 1 && n.every(Boolean) ? n.join(".") : "";
-}
-function v(e) {
-  if (typeof e != "string") return "";
-  const n = e.split(".").map((t) => t.trim());
-  return n.length > 0 && n.every(Boolean) ? n.join(".") : "";
-}
-function d(e) {
-  return typeof e == "string" ? e.trim() : "";
-}
-function D(e, n) {
-  return e.every(
-    (t, i) => e.slice(i + 1).every((s) => n(t, s))
-  );
-}
-function F(e, n) {
-  const t = d(e.id), i = d(e.name), s = d(n.entityId), o = d(n.entityName);
-  return !i || !s && !o ? !1 : (!s || s === t || s === i) && (!o || o === i);
-}
-function T(e) {
-  const n = u(e.semanticContext) ? e.semanticContext : void 0, t = u(e.fieldMeta) ? e.fieldMeta : void 0, i = d(n == null ? void 0 : n.semanticDomainId), s = Array.isArray(n == null ? void 0 : n.selectedEntities) ? n.selectedEntities.filter(
-    (y) => u(y) && y.type === "dataset"
-  ) : [];
-  if (!!!(i || s.length > 0 || (t == null ? void 0 : t.entityType) === "dataset")) return;
-  if (!i)
-    return { status: "unresolved", reason: "incomplete_source_identity" };
-  const a = d(t == null ? void 0 : t.entityId), r = d(t == null ? void 0 : t.entityName), c = !!(a || r), f = c ? s.filter(
-    (y) => F(y, {
-      entityId: a,
-      entityName: r
-    })
-  ) : s;
-  if (f.length > 1)
-    return { status: "unresolved", reason: "incomplete_source_identity" };
-  if (c && s.length > 0 && f.length === 0)
-    return { status: "unresolved", reason: "divergent_source_identity" };
-  const l = f[0], m = d(l == null ? void 0 : l.domainId), p = d(l == null ? void 0 : l.id), g = d(l == null ? void 0 : l.name);
-  if (m && m !== i)
-    return { status: "unresolved", reason: "divergent_source_identity" };
-  const I = p, b = g || r;
-  return b ? {
-    status: "resolved",
-    source: {
-      kind: "semantic",
-      domainId: i,
-      datasetName: b,
-      ...I ? { datasetId: I } : {}
-    }
-  } : { status: "unresolved", reason: "incomplete_source_identity" };
-}
-function S(e, n) {
-  const t = d(e.connectionId), i = u(e.semanticContext) ? e.semanticContext : void 0, s = d(i == null ? void 0 : i.connectionId);
-  if (t && s && t !== s)
-    return { status: "unresolved", reason: "divergent_source_identity" };
-  const o = t || s, a = u(e.fieldMeta) ? e.fieldMeta : void 0, r = n.split(".").slice(0, -1).join("."), c = v(e.qualifiedTableName), f = v(
-    a == null ? void 0 : a.qualifiedEntityName
-  ), l = [
-    c,
-    f,
-    r
-  ].filter(Boolean), m = q(l);
-  return !m && l.length > 0 ? { status: "unresolved", reason: "divergent_source_identity" } : !o || !m ? { status: "unresolved", reason: "incomplete_source_identity" } : {
-    status: "resolved",
-    source: { kind: "physical", connectionId: o, tableName: m }
-  };
-}
-function A(e, n) {
-  const t = u(e.fieldMeta) ? e.fieldMeta : void 0, i = typeof (t == null ? void 0 : t.qualifiedFieldName) == "string" ? t.qualifiedFieldName.trim() : "", s = h(
-    t == null ? void 0 : t.qualifiedFieldName
-  ), o = typeof e.column == "string" ? e.column.trim() : "", a = h(o), r = typeof e.qualifiedTableName == "string" ? e.qualifiedTableName.trim() : "", c = v(
-    e.qualifiedTableName
-  );
-  if (i && !s || n && r && !c || o.includes(".") && !a)
-    return { status: "unresolved", reason: "incomplete_field_identity" };
-  const f = a.split("."), l = a ? f[f.length - 1] : o, m = n && c && l ? `${c}.${l}` : "", p = [
-    s,
-    a,
-    m
-  ].filter(Boolean);
-  if (!D(
-    p,
-    N
-  ))
-    return { status: "unresolved", reason: "divergent_field_identity" };
-  const g = a || s || m;
-  return g ? { status: "resolved", qualifiedFieldName: g } : { status: "unresolved", reason: "incomplete_field_identity" };
-}
-function E(e) {
-  if (!u(e))
-    return { status: "ineligible", reason: "invalid_input" };
-  if (e.kind === "global-date")
-    return { status: "eligible", kind: "global_date" };
-  const n = _(e.dataType);
-  if (n !== "date" && n !== "datetime")
-    return { status: "ineligible", reason: "non_date_filter" };
-  const t = u(e.fieldMeta) ? e.fieldMeta : void 0, i = _(
-    t == null ? void 0 : t.dataType
-  );
-  if ((t == null ? void 0 : t.dataType) !== void 0 && i !== "date" && i !== "datetime")
-    return { status: "ineligible", reason: "non_date_filter" };
-  if (e.customFilterPreferences)
-    return { status: "ineligible", reason: "custom_filter" };
-  if (e.targetColumns !== void 0 && (!Array.isArray(e.targetColumns) || e.targetColumns.length > 0))
-    return { status: "ineligible", reason: "multi_target_filter" };
-  const s = T(e), o = A(e, s === void 0);
-  if (o.status === "unresolved")
-    return { status: "ineligible", reason: o.reason };
-  const a = s || S(e, o.qualifiedFieldName);
-  return a.status === "resolved" ? {
-    status: "eligible",
-    kind: "field_date",
-    qualifiedFieldName: o.qualifiedFieldName,
-    source: a.source
-  } : { status: "ineligible", reason: a.reason };
-}
-function B(e) {
-  if (!u(e) || e.kind !== "filter" || !u(e.filter))
-    return { status: "ineligible", reason: "invalid_input" };
-  const n = E(
-    e.filter
-  );
-  return n.status === "ineligible" ? n : n.kind === "field_date" && u(e.compatibility) && e.compatibility.source === "cardInlineFilter" ? { status: "ineligible", reason: "card_inline_filter" } : n;
-}
-function Q(e) {
-  return B(e).status === "eligible";
-}
-export {
-  B as a,
-  j as b,
-  z as c,
-  M as d,
-  q as e,
-  C as f,
-  k as g,
-  Q as i,
-  N as q,
-  E as r,
-  F as s
-};

package/dist/chunks/dashboard-json-QEoU-mx4.js

@@ -1,75 +0,0 @@
-import { jsxs as d, jsx as e } from "react/jsx-runtime";
-import { useMemo as p, useState as u, useRef as f, useEffect as b } from "react";
-import { X as S } from "./x-CXDkqdur.js";
-import { u as r, c as N, B as D, C as J } from "./switch-CWPcwAZ4.js";
-import "./card-config-utils-CAyjC5Tp.js";
-import "./validators-CsdOtZI6.js";
-import "./matrix-operation-contract-D32U2CSw.js";
-import "../value-format-preferences/index.js";
-import "./index-DYOaHuLS.js";
-import "./appearance-runtime-provider-B-M8gwlZ.js";
-import "./appearance-context-DEYtWinQ.js";
-import "./index-CLIro-EG.js";
-import "./field-aggregations-BQjogiI1.js";
-import "zod";
-import "./matrix-continuation-C4sRcjZU.js";
-import "./color-CJvdlFM_.js";
-import "react-dom";
-import "./index-ON7Gpvcv.js";
-function F() {
-  const a = r((o) => o.dashboard), c = r((o) => o.actions.setDashboard), m = r(
-    (o) => o.showDashboardJSON
-  ), h = r(
-    (o) => o.actions.setShowDashboardJSON
-  ), s = p(
-    () => a ? JSON.stringify(a, null, 2) : "",
-    [a]
-  ), [l, i] = u(s), t = f(s);
-  return b(() => {
-    s !== t.current && (i(s), t.current = s);
-  }, [s]), /* @__PURE__ */ d(
-    "div",
-    {
-      className: N("relative p-2", {
-        hidden: !m
-      }),
-      children: [
-        /* @__PURE__ */ d(
-          D,
-          {
-            variant: "secondary",
-            size: "sm",
-            className: "absolute right-2 top-2 z-10 h-8",
-            onClick: () => h(!1),
-            children: [
-              /* @__PURE__ */ e(S, { className: "mr-2 h-4 w-4" }),
-              "Close"
-            ]
-          }
-        ),
-        /* @__PURE__ */ e("div", { className: "h-[550px] overflow-hidden", children: /* @__PURE__ */ e(
-          J,
-          {
-            value: l,
-            onValueChange: (o) => {
-              i(o);
-              try {
-                const n = JSON.parse(o);
-                t.current = JSON.stringify(
-                  n,
-                  null,
-                  2
-                ), c(n);
-              } catch {
-              }
-            },
-            language: "json"
-          }
-        ) })
-      ]
-    }
-  );
-}
-export {
-  F as default
-};