react-semaphor 0.1.555 → 0.1.556

package/dist/types/components/visual/pivot-table/types.d.ts

@@ -1,80 +0,0 @@
-import { AggregateFunction, GroupByField, QueryColumnKeyMap } from '../../../lib/types/explorer-types.js';
-import { ComparisonMetadataMap } from '../../../lib/types/query-types.js';
-import { SemaphorResultColumn } from '../../../shared/analytics-protocol/index.js';
-import { CanonicalPivotResultContract, CanonicalPivotResultState } from '../../../shared/format-utils/index.js';
-import { TemporalResultOwner } from '../../../shared/dashboard-authoring/index.js';
-export type { AggregateFunction } from '../../../lib/types/explorer-types.js';
-export declare enum PivotMarkerEnum {
-    SUBTOTAL = "__SUBTOTAL__",
-    TOTAL = "__TOTAL__"
-}
-export interface ColumnAggregate {
-    function: AggregateFunction;
-    pivotLevel: string | 'ALL';
-}
-export interface RowAggregate {
-    function: AggregateFunction;
-    groupLevel?: string;
-}
-export interface PivotCardConfig {
-    columnAggregates?: ColumnAggregate[];
-    rowAggregates?: RowAggregate[];
-}
-export interface PivotRowMetadata {
-    isSubtotal?: boolean;
-    isGrandTotal?: boolean;
-    subtotalLevel?: string | 'grandTotal';
-    aggregate?: AggregateFunction;
-    subtotalContext?: {
-        fieldAlias: string;
-        value: string;
-        groupByValues: Record<string, any>;
-    };
-}
-export interface ColumnSubtotalMeta {
-    columnName: string;
-    isSubtotal: boolean;
-    subtotalLevel: string;
-    aggregate: AggregateFunction;
-    pivotFieldId?: string | 'ALL';
-    pivotFieldIds?: string[];
-    pivotPath?: (string | null)[];
-    subtotalScope?: 'pivot-value' | 'grand-total';
-}
-export interface PivotColumnSchema {
-    alias: string;
-    metricAlias?: string;
-    metricId: string;
-    metricName: string;
-    metricLabel: string;
-    pivotValues: (string | null)[];
-    pivotFieldIds?: string[];
-    pivotFields: string[];
-    displayLabel?: string;
-    isPivotColumn?: boolean;
-    isMetricColumn?: boolean;
-}
-export interface ColumnMetadata {
-    metricAlias: string;
-    metricId: string;
-    pivotValues: (string | null)[];
-    pivotFieldIds?: string[];
-    isSubtotal: boolean;
-    aggregateFunction?: string;
-    subtotalScope?: 'base' | 'pivot-value' | 'grand-total';
-}
-export interface PivotTableResponse {
-    records: (Record<string, any> & PivotRowMetadata)[];
-    resultOwner?: TemporalResultOwner;
-    pivotResultState?: CanonicalPivotResultState;
-    pivotResultContract?: CanonicalPivotResultContract;
-    pivotSchema: PivotColumnSchema[];
-    subtotalColumns: string[];
-    columnSubtotalMeta?: ColumnSubtotalMeta[];
-    groupByColumns?: GroupByField[];
-    columnMetadata?: Record<string, ColumnMetadata>;
-    comparisonMetadata?: ComparisonMetadataMap;
-    columns?: SemaphorResultColumn[];
-    columnKeyMap?: QueryColumnKeyMap;
-}
-export type PivotTableData = (Record<string, any> & PivotRowMetadata)[];

package/dist/types/shared/format-utils/aggregate-table-row-presentation.d.ts

@@ -1,85 +0,0 @@
-/**
- * React-free aggregate-table row presentation policy shared by browser and
- * delivery adapters. Canonical tuple values and row metadata remain identity;
- * this module owns authoritative group keys and group-cell placement.
- */
-export { PDF_GROUP_CONTINUATION_CLASS as AGGREGATE_PDF_CONTINUATION_CLASS, } from './grouped-table-presentation.js';
-export interface AggregateSubtotalLabelInput {
-    aggregateFunction: string;
-    customLabel?: string;
-    levelValue: unknown;
-    formatValue?: (value: unknown) => string;
-}
-export declare const AGGREGATE_TOTAL_MEMBER_MARKER: "__TOTAL__";
-export interface AggregateTablePresentationContext {
-    groupColumnKeys: string[];
-    rowAggregates: Array<{
-        function: string;
-        groupLevel: string;
-        label?: string;
-    }>;
-}
-export type AggregateGroupCellPlacement = 'value' | 'label' | 'empty';
-export interface AggregateGroupCellPresentation<T = string> {
-    columnKey: string;
-    text: T | string;
-    placement: AggregateGroupCellPlacement;
-    colSpan: number;
-}
-export interface AggregateGroupRowPresentation<T = string> {
-    kind: 'data' | 'subtotal' | 'grand-total';
-    cells: AggregateGroupCellPresentation<T>[];
-}
-export interface AggregateTablePresentationColumnKeyMap {
-    byRole: Readonly<{
-        groupby?: Readonly<Record<string, {
-            rawKey: string;
-            outputKey?: string;
-        }>>;
-    }>;
-}
-export declare function isAggregateTotalMemberMarker(value: unknown): value is typeof AGGREGATE_TOTAL_MEMBER_MARKER;
-/**
- * Resolves saved field identity into the physical result keys used by rows.
- * Missing groupByColumns is a valid metric-only aggregate-table shape.
- */
-export declare function resolveAggregateTablePresentationContext(input: {
-    groupByColumns?: readonly unknown[];
-    rowAggregates?: readonly unknown[];
-    columnKeyMap?: AggregateTablePresentationColumnKeyMap;
-}): AggregateTablePresentationContext;
-export declare function formatAggregateSubtotalLabel(input: AggregateSubtotalLabelInput): string;
-export declare function formatAggregateGrandTotalLabel(aggregateFunction: string, customLabel?: string): string;
-/**
- * Returns whether an aggregate group value starts a new visible group at its
- * hierarchy level. A nested value repeats only when its complete parent prefix
- * also repeats. Subtotals and grand totals are presentation boundaries.
- */
-export declare function shouldPresentAggregateGroupValue(input: {
-    row: Record<string, unknown>;
-    previousRow?: Record<string, unknown>;
-    context: AggregateTablePresentationContext;
-    columnKey: string;
-}): boolean;
-/**
- * Formats one physical aggregate group cell. Row metadata alone determines
- * subtotal/grand-total ownership; null is always passed to the value formatter
- * as a genuine blank member.
- */
-export declare function presentAggregateGroupRow<T = string>(input: {
-    row: Record<string, unknown>;
-    context: AggregateTablePresentationContext;
-    formatValue: (value: unknown, columnKey: string) => T;
-    formatLabelValue?: (value: unknown, columnKey: string) => string;
-}): AggregateGroupRowPresentation<T>;
-export declare function formatAggregateGroupCell(input: {
-    row: Record<string, unknown>;
-    context: AggregateTablePresentationContext;
-    columnKey: string;
-    formatValue: (value: unknown, columnKey: string) => string;
-}): string;
-export declare function formatAggregateGroupRow(input: {
-    row: Record<string, unknown>;
-    context: AggregateTablePresentationContext;
-    formatValue: (value: unknown, columnKey: string) => string;
-}): string[];

package/dist/types/shared/format-utils/pivot-result-lifecycle.d.ts

@@ -1,55 +0,0 @@
-import { SemaphorResultColumn } from '../analytics-protocol/contracts.js';
-import { PivotResultColumnClassification, QueryColumnKeyMap, QueryColumnKeyRole } from './pivot-result-identity.js';
-export type CanonicalPivotResultState = 'loaded_empty' | 'loaded_valid';
-type CanonicalPivotResultBase = {
-    columns: SemaphorResultColumn[];
-    columnKeyMap: QueryColumnKeyMap;
-    pivotResultContract: CanonicalPivotResultContract;
-};
-export type LoadedEmptyPivotResult = CanonicalPivotResultBase & {
-    pivotResultState: 'loaded_empty';
-    records: [];
-};
-export type LoadedValidPivotResult = CanonicalPivotResultBase & {
-    pivotResultState: 'loaded_valid';
-    records: [Record<string, unknown>, ...Record<string, unknown>[]];
-};
-export type CanonicalPivotResultTransport = LoadedEmptyPivotResult | LoadedValidPivotResult;
-export declare class PivotResultLifecycleError extends Error {
-    readonly cause?: unknown | undefined;
-    readonly code: "invalid_pivot_result_lifecycle";
-    readonly deliveryBlocking = true;
-    constructor(message: string, cause?: unknown | undefined);
-}
-type PivotResultLifecycleInput = {
-    pivotResultState?: unknown;
-    pivotResultContract?: unknown;
-    records?: unknown;
-    columns?: unknown;
-    columnKeyMap?: unknown;
-};
-export type PivotResultExpectedRoleFieldIds = Readonly<Partial<Record<QueryColumnKeyRole, readonly string[]>>>;
-export type PivotResultColumnKind = 'row' | 'pivot_metric' | 'value';
-export type CanonicalPivotResultContract = {
-    version: 1;
-    expectedRoleFieldIds: PivotResultExpectedRoleFieldIds;
-    expectedMetricAliases: readonly string[];
-    columnKinds: Readonly<Record<string, PivotResultColumnKind>>;
-    columnClassifications: Readonly<Record<string, PivotResultColumnClassification | undefined>>;
-};
-/**
- * Parses the canonical pivot wire shape once. Downstream presentation and
- * delivery consumers receive this discriminated result and do not infer
- * lifecycle or repeat physical-member validation.
- */
-export declare function parseCanonicalPivotResultTransport(input: PivotResultLifecycleInput): CanonicalPivotResultTransport;
-export declare function createCanonicalPivotResultTransport(input: {
-    records: Record<string, unknown>[];
-    columns: SemaphorResultColumn[];
-    columnKeyMap: QueryColumnKeyMap;
-    expectedRoleFieldIds: PivotResultExpectedRoleFieldIds;
-    expectedMetricAliases?: readonly string[];
-    physicalPivotColumnKeys: readonly string[];
-    columnMetadata?: Readonly<Record<string, PivotResultColumnClassification | undefined>>;
-}): CanonicalPivotResultTransport;
-export {};