react-semaphor 0.1.526 → 0.1.528

package/dist/types/shared/analytics-protocol/time-window-schema.d.ts

@@ -0,0 +1,314 @@
+import { z } from 'zod';
+/**
+ * Zod schemas for `SemaphorTimeWindow`, built from the shared rules in
+ * `time-window.ts`. `strict: true` rejects unknown keys; otherwise they are
+ * dropped, as tool argument parsing expects.
+ */
+export declare function semaphorTimeWindowSchemas(options?: {
+    strict?: boolean;
+}): {
+    relative: z.ZodEffects<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodLiteral<"relative">>;
+        unit: z.ZodEnum<["second", "minute", "hour", "day", "week", "month", "quarter", "year"]>;
+        value: z.ZodNumber;
+        anchor: z.ZodOptional<z.ZodEnum<["now", "latest_available"]>>;
+        completeness: z.ZodOptional<z.ZodEnum<["include_partial", "complete_periods"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }>, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }> | z.ZodEffects<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodLiteral<"relative">>;
+        unit: z.ZodEnum<["second", "minute", "hour", "day", "week", "month", "quarter", "year"]>;
+        value: z.ZodNumber;
+        anchor: z.ZodOptional<z.ZodEnum<["now", "latest_available"]>>;
+        completeness: z.ZodOptional<z.ZodEnum<["include_partial", "complete_periods"]>>;
+    }, "strict", z.ZodTypeAny, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }>, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }>;
+    calendar: z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"calendar">;
+        unit: z.ZodEnum<["day", "week", "month", "quarter", "year"]>;
+        period: z.ZodEnum<["this", "previous"]>;
+        toDate: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }>, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }> | z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"calendar">;
+        unit: z.ZodEnum<["day", "week", "month", "quarter", "year"]>;
+        period: z.ZodEnum<["this", "previous"]>;
+        toDate: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }>, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }>;
+    absolute: z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"absolute">;
+        start: z.ZodString;
+        end: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }>, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }> | z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"absolute">;
+        start: z.ZodString;
+        end: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }>, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }>;
+    timeWindow: z.ZodUnion<[z.ZodEffects<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodLiteral<"relative">>;
+        unit: z.ZodEnum<["second", "minute", "hour", "day", "week", "month", "quarter", "year"]>;
+        value: z.ZodNumber;
+        anchor: z.ZodOptional<z.ZodEnum<["now", "latest_available"]>>;
+        completeness: z.ZodOptional<z.ZodEnum<["include_partial", "complete_periods"]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }>, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }> | z.ZodEffects<z.ZodObject<{
+        kind: z.ZodOptional<z.ZodLiteral<"relative">>;
+        unit: z.ZodEnum<["second", "minute", "hour", "day", "week", "month", "quarter", "year"]>;
+        value: z.ZodNumber;
+        anchor: z.ZodOptional<z.ZodEnum<["now", "latest_available"]>>;
+        completeness: z.ZodOptional<z.ZodEnum<["include_partial", "complete_periods"]>>;
+    }, "strict", z.ZodTypeAny, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }>, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }, {
+        value: number;
+        unit: "second" | "minute" | "hour" | "day" | "week" | "month" | "quarter" | "year";
+        kind?: "relative" | undefined;
+        anchor?: "now" | "latest_available" | undefined;
+        completeness?: "include_partial" | "complete_periods" | undefined;
+    }>, z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"calendar">;
+        unit: z.ZodEnum<["day", "week", "month", "quarter", "year"]>;
+        period: z.ZodEnum<["this", "previous"]>;
+        toDate: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }>, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }> | z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"calendar">;
+        unit: z.ZodEnum<["day", "week", "month", "quarter", "year"]>;
+        period: z.ZodEnum<["this", "previous"]>;
+        toDate: z.ZodOptional<z.ZodBoolean>;
+    }, "strict", z.ZodTypeAny, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }>, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }, {
+        kind: "calendar";
+        unit: "day" | "week" | "month" | "quarter" | "year";
+        period: "this" | "previous";
+        toDate?: boolean | undefined;
+    }>, z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"absolute">;
+        start: z.ZodString;
+        end: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }>, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }> | z.ZodEffects<z.ZodObject<{
+        kind: z.ZodLiteral<"absolute">;
+        start: z.ZodString;
+        end: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }>, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }, {
+        kind: "absolute";
+        start: string;
+        end: string;
+    }>]>;
+};

package/dist/types/shared/analytics-protocol/time-window.d.ts

@@ -0,0 +1,13 @@
+import { SemaphorRelativeTimeWindow, SemaphorTimeGrain } from './contracts.js';
+/** Units a calendar window ("this month", "previous quarter") can name. */
+export declare const SEMAPHOR_CALENDAR_TIME_WINDOW_UNITS: readonly ["day", "week", "month", "quarter", "year"];
+export declare const SEMAPHOR_CALENDAR_TIME_WINDOW_PERIODS: readonly ["this", "previous"];
+export declare const SEMAPHOR_TIME_WINDOW_ANCHORS: readonly ["now", "latest_available"];
+export declare const SEMAPHOR_TIME_WINDOW_COMPLETENESS: readonly ["include_partial", "complete_periods"];
+/** The largest rolling window per unit: ten years. */
+export declare const SEMAPHOR_TIME_WINDOW_MAX_VALUE: Readonly<Record<SemaphorTimeGrain, number>>;
+/**
+ * The anchor a rolling window counts back from. An omitted anchor means the
+ * latest available data; a saved card that should keep rolling states "now".
+ */
+export declare function resolveTimeWindowAnchor(timeWindow: Pick<SemaphorRelativeTimeWindow, 'anchor'>): 'now' | 'latest_available';

package/dist/types/shared/dashboard-authoring/matrix-delivery.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import { CsvEncoding } from '../format-utils/exporters/csv-utils.js';
 import { MatrixConfig, MatrixExportLayout, MatrixExportRequest, MatrixExportRow, MatrixFailure, MatrixViewState } from '../analytics-protocol/index.js';
 import { ReportRuntimeContext } from '../report-runtime-context/index.js';
 export type MatrixExportContent = 'current' | 'all' | 'flat';
@@ -306,7 +307,7 @@ export declare function captureMatrixExport(input: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -658,7 +659,7 @@ export declare function captureMatrixExport(input: {
             levelId: string;
             axis: "columns" | "rows";
             direction: "asc" | "desc";
-            nulls: "first" | "last";
+            nulls: "last" | "first";
         }[];
         rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
         filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -776,6 +777,8 @@ export declare function buildMatrixDeliveryEnvelope<TSource extends {
     reportContext: ReportRuntimeContext;
     delimiter: ',' | ';' | '\t';
     includeHeaders: boolean;
+    /** CSV only; absent lets the app resolve the dashboard's setting. */
+    csvEncoding?: CsvEncoding;
 }): TControls & {
     type: "card";
     dashboardId: string;
@@ -1090,7 +1093,7 @@ export declare function buildMatrixDeliveryEnvelope<TSource extends {
                     levelId: string;
                     axis: "columns" | "rows";
                     direction: "asc" | "desc";
-                    nulls: "first" | "last";
+                    nulls: "last" | "first";
                 }[];
                 rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
                 filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -1442,7 +1445,7 @@ export declare function buildMatrixDeliveryEnvelope<TSource extends {
                     levelId: string;
                     axis: "columns" | "rows";
                     direction: "asc" | "desc";
-                    nulls: "first" | "last";
+                    nulls: "last" | "first";
                 }[];
                 rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
                 filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -1456,6 +1459,7 @@ export declare function buildMatrixDeliveryEnvelope<TSource extends {
         includeHeaders: boolean;
         timezone: string;
         presentationExecutionSnapshot: import('../format-utils/index.js').PresentationExecutionSnapshot;
+        csvEncoding?: "utf-8-bom" | "utf-8" | undefined;
         acquisition?: "continuation" | undefined;
     };
 };

package/dist/types/shared/format-utils/exporters/csv-utils.d.ts

@@ -1,4 +1,38 @@
-import { CSVExportOptions } from '../types/index.js';
+/**
+ * The CSV file contract: the one place that decides how CSV rows become
+ * bytes. Every CSV file delivered to a person or system (browser downloads,
+ * chunked exports, Matrix exports, rendered Briefing attachments) is written
+ * through these functions. Writers decide which rows to write; this module
+ * decides the BOM, quoting and record separators. See "CSV file standard" in
+ * the format-utils README.
+ * IMPORTANT: No React or browser-specific imports allowed
+ */
+export declare const CSV_ENCODINGS: readonly ["utf-8-bom", "utf-8"];
+export type CsvEncoding = (typeof CSV_ENCODINGS)[number];
+/** Excel garbles non-ASCII text in a UTF-8 file without a BOM, so the BOM is the default. */
+export declare const DEFAULT_CSV_ENCODING: CsvEncoding;
+export declare const CSV_DELIMITERS: readonly [",", ";", "\t"];
+export type CsvDelimiter = (typeof CSV_DELIMITERS)[number];
+/** RFC 4180 record separator. Every record, including the last, ends with it. */
+export declare const CSV_RECORD_SEPARATOR = "\r\n";
+/** Content type of every delivered CSV file. */
+export declare const CSV_CONTENT_TYPE = "text/csv; charset=utf-8";
+export type CsvCell = string | number | null | undefined;
+/** Turn a raw record value into a cell: objects become JSON, not "[object Object]". */
+export declare function toCsvCell(value: unknown): CsvCell;
+export declare function parseCsvEncoding(value: unknown): CsvEncoding | undefined;
+export declare function parseCsvDelimiter(value: unknown): CsvDelimiter | undefined;
+/**
+ * The one precedence rule for a file's encoding: an explicit per-export
+ * choice, then the dashboard's setting, then the default. Boundaries reject
+ * invalid values before resolving; here they fall through.
+ */
+export declare function resolveCsvEncoding(input: {
+    requested?: unknown;
+    dashboardDefault?: unknown;
+}): CsvEncoding;
+/** What a file starts with. Only the writer of a file's first piece adds it. */
+export declare function csvFilePreamble(encoding: CsvEncoding): string;
 /** Protect explicitly textual cells before RFC escaping. Never apply this to
  * numeric operands (including exact numeric text); their sign is meaningful. */
 export declare function protectCSVText(value: string): string;
@@ -6,18 +40,15 @@ export declare function protectCSVText(value: string): string;
  * Escape a value for CSV output (RFC 4180 compliant)
  * Wraps in quotes if value contains delimiter, quotes, or newlines
  */
-export declare function escapeCSVValue(value: string | number | null | undefined, delimiter?: string): string;
-/**
- * Convert an array of values to a CSV row
- */
-export declare function arrayToCSVRow(values: (string | number | null | undefined)[], delimiter?: string): string;
-/**
- * Convert a 2D array to CSV string
- */
-export declare function arrayToCSV(rows: (string | number | null | undefined)[][], options?: Partial<CSVExportOptions>): string;
-/**
- * Convert an array of objects to CSV string
- */
-export declare function objectsToCSV(data: Record<string, unknown>[], options?: Partial<CSVExportOptions> & {
-    columns?: string[];
+export declare function escapeCSVValue(value: CsvCell, delimiter?: CsvDelimiter): string;
+/** One escaped record, ending with CSV_RECORD_SEPARATOR. */
+export declare function csvRecord(values: readonly CsvCell[], delimiter: CsvDelimiter): string;
+/** Escaped records, each ending with CSV_RECORD_SEPARATOR. */
+export declare function csvRecords(rows: readonly (readonly CsvCell[])[], delimiter: CsvDelimiter): string;
+/** A whole CSV file held in memory: preamble, optional header, then rows. */
+export declare function encodeCsvFile(input: {
+    header?: readonly CsvCell[];
+    rows: readonly (readonly CsvCell[])[];
+    delimiter: CsvDelimiter;
+    encoding: CsvEncoding;
 }): string;

package/dist/types/shared/format-utils/exporters/index.d.ts

@@ -1,3 +1,2 @@
-export { escapeCSVValue, protectCSVText, arrayToCSVRow, arrayToCSV, objectsToCSV, } from './csv-utils.js';
-export { formatTableForCSV, generateTableCSV } from './table-exporter.js';
-export { generatePivotHeaders, formatPivotDataRow, formatPivotTableForCSV, } from './pivot-exporter.js';
+export { CSV_ENCODINGS, DEFAULT_CSV_ENCODING, CSV_DELIMITERS, CSV_RECORD_SEPARATOR, CSV_CONTENT_TYPE, parseCsvEncoding, parseCsvDelimiter, resolveCsvEncoding, csvFilePreamble, toCsvCell, escapeCSVValue, protectCSVText, csvRecord, csvRecords, encodeCsvFile, } from './csv-utils.js';
+export type { CsvEncoding, CsvDelimiter, CsvCell } from './csv-utils.js';

package/dist/types/shared/format-utils/flat-table-export-totals.d.ts

@@ -1,3 +1,4 @@
+import { CsvDelimiter } from './exporters/csv-utils.js';
 import { PresentationExecutionSnapshot, PresentationScope } from './presentation-execution.js';
 export type FlatTableExportTotalsBehavior = 'sum' | 'avg' | 'count' | 'label';
 export type FlatTableExportTotalsRequest = {
@@ -21,5 +22,5 @@ export declare function buildFlatTableExportTotalsFooter(params: {
     snapshot: PresentationExecutionSnapshot;
     scope: PresentationScope;
     useFormattedValues: boolean;
-    delimiter: string;
+    delimiter: CsvDelimiter;
 }): string;

package/dist/types/shared/format-utils/matrix-export-presentation.d.ts

@@ -345,7 +345,7 @@ export declare function buildMatrixPrintTable(input: {
                 levelId: string;
                 axis: "columns" | "rows";
                 direction: "asc" | "desc";
-                nulls: "first" | "last";
+                nulls: "last" | "first";
             }[];
             rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
             filters?: import('../../components/index.js').FilterGroup | undefined;
@@ -697,7 +697,7 @@ export declare function buildMatrixPrintTable(input: {
                 levelId: string;
                 axis: "columns" | "rows";
                 direction: "asc" | "desc";
-                nulls: "first" | "last";
+                nulls: "last" | "first";
             }[];
             rankings: readonly import('../analytics-protocol/index.js').MatrixRanking[];
             filters?: import('../../components/index.js').FilterGroup | undefined;

package/dist/types/shared/format-utils/types/format-types.d.ts

@@ -189,53 +189,11 @@ export interface ExportFormattingConfig {
     /** Ordered list of columns to include */
     visibleColumns: string[];
 }
-export interface CSVExportOptions {
-    delimiter: ',' | ';' | '\t';
-    includeHeaders: boolean;
-    lineEnding: '\n' | '\r\n';
-}
 export interface GroupByField {
     name: string;
     alias: string;
     label?: string;
 }
-export interface PivotByColumn {
-    name: string;
-    alias: string;
-    label?: string;
-}
-export interface ColumnHeaderNode {
-    name: string;
-    level: number;
-    colspan: number;
-    children?: ColumnHeaderNode[];
-    columnKey?: string;
-}
-export interface PivotExportConfig {
-    groupByColumns: GroupByField[];
-    pivotByColumns: PivotByColumn[];
-    columnHeadersTree: ColumnHeaderNode[];
-    columnHeaders: string[];
-    columnSubtotalMeta?: ColumnSubtotalMeta[];
-    includeSubtotals: boolean;
-    includeGrandTotal: boolean;
-    showRowTotals: boolean;
-}
-export interface ColumnSubtotalMeta {
-    columnKey: string;
-    label: string;
-    level: number;
-}
-export interface PivotCellData {
-    value: unknown;
-    formatted?: string;
-}
-export interface PivotRowData {
-    fieldValues: string[];
-    cells: Record<string, PivotCellData>;
-    isSubtotal?: boolean;
-    isGrandTotal?: boolean;
-}
 export interface FormatOptions {
     decimalPlaces?: number;
     useSuffix?: boolean;

package/dist/types/shared/temporal/calendar-periods.d.ts

@@ -0,0 +1,56 @@
+import { CalendarContext } from '../report-runtime-context/index.js';
+import { ZonedWallClockTime } from './zoned-wall-clock.js';
+/** The units a period or a shift counts in. */
+export type TemporalUnit = 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+/**
+ * What period math reads from a calendar. The anchor ("now") is never read
+ * here: callers pass the instant they resolve against.
+ */
+export type TemporalCalendar = Pick<CalendarContext, 'tz' | 'weekStart' | 'fiscalCalendar'>;
+/** Every instant from `start` up to, not including, `endExclusive`. */
+export type TemporalPeriod = {
+    start: Date;
+    endExclusive: Date;
+};
+/** A wall-clock time with every field set. */
+export type WallClockTime = Required<ZonedWallClockTime>;
+/** Units measured as elapsed time rather than on the calendar, in milliseconds. */
+export declare const ELAPSED_UNIT_MILLISECONDS: Partial<Record<TemporalUnit, number>>;
+/** The wall clock at an instant, with its milliseconds (offsets are whole seconds). */
+export declare function wallClockAt(instant: Date, tz: string): WallClockTime;
+/** The instant a wall clock names, under the daylight-saving rule (K7). */
+export declare function instantAt(wall: ZonedWallClockTime, tz: string): Date;
+export declare function daysInMonth(year: number, month: number): number;
+/**
+ * The wall clock moved by whole units, keeping the time of day for calendar
+ * units and clamping the day for months, quarters and years (January 31 plus
+ * one month is February 28), as date-fns does.
+ */
+export declare function shiftWallClock(wall: WallClockTime, amount: number, unit: TemporalUnit): WallClockTime;
+/** The weekday of a wall date, 0 for Sunday. */
+export declare function wallWeekday(wall: Pick<WallClockTime, 'year' | 'month' | 'day'>): number;
+/**
+ * The period `offset` periods from the one containing `instant` (0 for that
+ * period, -1 for the one before). Calendar periods are found in the wall
+ * clock, so a day that starts after a skipped midnight starts when it does
+ * (K7). Seconds, minutes and hours count elapsed time from the instant's own
+ * occurrence, so a repeated hour is two periods.
+ */
+export declare function periodAt(instant: Date, unit: TemporalUnit, calendar: TemporalCalendar, offset?: number): TemporalPeriod;
+/** Where the period containing `instant` starts. */
+export declare function startOfPeriod(instant: Date, unit: TemporalUnit, calendar: TemporalCalendar): Date;
+/** The last millisecond of the period containing `instant`. */
+export declare function endOfPeriod(instant: Date, unit: TemporalUnit, calendar: TemporalCalendar): Date;
+/**
+ * The instant moved by whole units in the calendar's wall clock, keeping its
+ * time of day (see `shiftWallClock`).
+ */
+export declare function shiftInstant(instant: Date, amount: number, unit: TemporalUnit, calendar: Pick<TemporalCalendar, 'tz'>): Date;
+/** Calendar days from `start`'s date to `end`'s date in the timezone. */
+export declare function calendarDaysBetween(start: Date, end: Date, tz: string): number;
+/** `YYYY-MM-DD` of the instant's wall date in the timezone. */
+export declare function formatWallDate(instant: Date, tz: string): string;
+/** The fields of a `YYYY-MM-DD` date that names a real day, else null. */
+export declare function parseWallDate(value: string): Pick<WallClockTime, 'year' | 'month' | 'day'> | null;
+/** The day a `YYYY-MM-DD` date names in the timezone, or null when it names none. */
+export declare function wallDatePeriod(value: string, tz: string): TemporalPeriod | null;

package/dist/types/shared/temporal/index.d.ts

@@ -0,0 +1,5 @@
+export * from './zoned-wall-clock.js';
+export * from './calendar-periods.js';
+export * from './relative-date.js';
+export * from './time-window-periods.js';
+export * from './temporal-parity-fixtures.js';

package/dist/types/shared/temporal/relative-date.d.ts

@@ -0,0 +1,21 @@
+import { RelativeDateFilter } from '../analytics-protocol/relative-date-filter.js';
+import { TemporalCalendar } from './calendar-periods.js';
+/** A resolved window: `end` is the inclusive last instant. */
+export type ResolvedRelativeDate = {
+    start: Date;
+    end: Date;
+};
+/**
+ * The window a relative date names at `anchor` in the calendar:
+ * - `last` n units: the n units back to the anchor, the same wall-clock time
+ *   n units earlier (minutes and hours count elapsed time); with `complete`,
+ *   the n whole periods before the one containing the anchor;
+ * - `this`: the period containing the anchor, or up to the anchor with
+ *   `toDate`; a month `boundary` names its first or last day (months only);
+ * - `previous`: the period before;
+ * - `between` from/to: from the start of the `from` period to the end of the
+ *   `to` period, counted from the anchor's.
+ * Weeks start on the calendar's week start; quarters and years follow its
+ * fiscal calendar when it has one.
+ */
+export declare function resolveRelativeDate(relative: RelativeDateFilter, calendar: TemporalCalendar, anchor: Date): ResolvedRelativeDate;