react-semaphor 0.1.526 → 0.1.528

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.526",
+  "version": "0.1.528",
   "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"

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