react-semaphor 0.1.423 → 0.1.425

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

@@ -26,6 +26,10 @@ export declare function arrayToCSV(rows: (string | number | null | undefined)[][
  */
 export declare function arrayToCSVRow(values: (string | number | null | undefined)[], delimiter?: string): string;
 
+export declare type CanonicalDurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+
+export declare type CanonicalFormatSpec = NumericCanonicalFormat | DateCanonicalFormat | DurationCanonicalFormat | StringCanonicalFormat;
+
 export declare interface ColorRange {
     min: number;
     max: number;
@@ -90,6 +94,17 @@ export declare interface CSVExportOptions {
     lineEnding: '\n' | '\r\n';
 }
 
+export declare type DateCanonicalFormat = {
+    type: 'date';
+    locale?: string;
+    pattern?: string;
+    relative?: boolean;
+    timezone?: string;
+    sourceTimezone?: string;
+    prefix?: string;
+    suffix?: string;
+};
+
 export declare interface DateFormatOptions {
     /** date-fns format pattern (e.g., "MM/dd/yyyy") */
     format: string;
@@ -107,6 +122,18 @@ export declare interface DateFormatOptions {
     locale?: string;
 }
 
+export declare type DurationCanonicalFormat = {
+    type: 'duration';
+    inputUnit?: CanonicalDurationUnit;
+    outputStyle?: 'compact' | 'digital' | 'long';
+    largestUnit?: CanonicalDurationUnit;
+    smallestUnit?: CanonicalDurationUnit;
+    maxUnits?: number;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+};
+
 export declare type DurationDisplayStyle = 'compact' | 'digital' | 'long';
 
 export declare interface DurationFormatOptions {
@@ -128,7 +155,7 @@ export declare interface DurationFormatOptions {
     negativeInParentheses?: boolean;
 }
 
-export declare type DurationUnit = 'millisecond' | 'second' | 'minute' | 'hour' | 'day';
+export declare type DurationUnit = CanonicalDurationUnit;
 
 /**
  * Escape a value for CSV output (RFC 4180 compliant)
@@ -206,6 +233,15 @@ export declare const formatDate: (dateString: string | null | undefined, formatP
 
 export declare function formatDuration(value: number | string | null | undefined, options?: DurationFormatOptions): string;
 
+export declare function formatMetricComparison(evaluation: MetricComparisonEvaluation, options: FormatMetricComparisonOptions): FormattedMetricComparison;
+
+export declare type FormatMetricComparisonOptions = {
+    displayMode: MetricComparisonDisplayMode;
+    metricFormat?: CanonicalFormatSpec;
+    locale?: string;
+    precision?: number;
+};
+
 /**
  * Format a number with locale-aware formatting
  */
@@ -286,6 +322,20 @@ export declare function formatScientific(value: number | null | undefined, optio
  */
 export declare function formatTableForCSV(data: Record<string, unknown>[], config: ExportFormattingConfig): string[];
 
+export declare type FormattedMetricComparison = {
+    mode: MetricComparisonDisplayMode;
+    current: FormattedMetricComparisonPart;
+    comparison: FormattedMetricComparisonPart;
+    difference?: FormattedMetricComparisonPart;
+    percentChange?: FormattedMetricComparisonPart;
+    ratio?: FormattedMetricComparisonPart;
+};
+
+export declare type FormattedMetricComparisonPart = {
+    value: number | null;
+    text: string | null;
+};
+
 /**
  * Generate headers for aggregate table export
  */
@@ -317,15 +367,23 @@ export declare interface GroupByField {
     label?: string;
 }
 
-/**
- * Shared format types for export system
- * IMPORTANT: No React imports allowed in this file
- *
- * These types are used by:
- * - react-semaphor (browser) for client-side exports
- * - semaphor-app (Next.js) for API routes
- * - Lambda (Node.js) for async export processing
- */
+declare type MetricComparisonDirection = 'increase' | 'decrease' | 'no_change' | 'unknown';
+
+export declare type MetricComparisonDisplayMode = 'difference' | 'percent_change' | 'both' | 'ratio';
+
+declare type MetricComparisonEvaluation = {
+    status: 'available' | 'insufficient_history';
+    currentValue: number | null;
+    comparisonValue: number | null;
+    delta: number | null;
+    percentChange: number | null;
+    ratio: number | null;
+    direction: MetricComparisonDirection;
+    sentiment: MetricComparisonSentiment;
+};
+
+declare type MetricComparisonSentiment = 'favorable' | 'unfavorable' | 'neutral';
+
 export declare interface NumberFormatOptions {
     style: 'decimal' | 'currency' | 'percent' | 'scientific';
     locale?: string;
@@ -346,6 +404,30 @@ export declare interface NumberFormatOptions {
     useSuffix?: boolean;
 }
 
+/**
+ * Shared format types for export system
+ * IMPORTANT: No React imports allowed in this file
+ *
+ * These types are used by:
+ * - react-semaphor (browser) for client-side exports
+ * - semaphor-app (Next.js) for API routes
+ * - Lambda (Node.js) for async export processing
+ */
+export declare type NumericCanonicalFormat = {
+    type: 'number' | 'currency' | 'percent' | 'scientific';
+    locale?: string;
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    prefix?: string;
+    suffix?: string;
+    negativeStyle?: 'minus' | 'parentheses';
+    compact?: boolean;
+    scale?: number;
+    currency?: string;
+    percentValueMode?: 'fraction' | 'whole';
+};
+
 /**
  * Convert an array of objects to CSV string
  */
@@ -425,4 +507,10 @@ export declare interface RowAggregate {
     label?: string;
 }
 
+export declare type StringCanonicalFormat = {
+    type: 'string';
+    prefix?: string;
+    suffix?: string;
+};
+
 export { }

package/dist/types/index.js

@@ -1,4 +1,4 @@
-import { a as C, C as l, D as t, E as A, P as T, g as _, d as i, h as o, b as r, c as D, i as L } from "../chunks/common-types-4bjoIgvm.js";
+import { a as C, C as l, D as t, E as A, P as T, g as _, h as i, b as o, i as r, c as D, d as L } from "../chunks/common-types-ClkOI-3O.js";
 const a = {
   mode: "all"
 }, e = {