react-semaphor 0.1.526 → 0.1.528

package/dist/types/data-app-codegen/validation.d.ts

@@ -1,8 +0,0 @@
-import { SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION, SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION, validateSemaphorDataAppCodegenSummary } from '../shared/analytics-protocol/data-app-codegen-summary.js';
-export { SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION, SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION, validateSemaphorDataAppCodegenSummary, };
-export declare const CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
-export declare const CODEGEN_SUMMARY_VALIDATOR_VERSION: "semaphor-data-app-codegen-summary-validator/v2";
-export declare const GENERATED_CONTRACT_SCHEMA_VERSION = "semaphor-generated-data-app-contract/v1";
-export declare const CONTRACT_MANIFEST_SCHEMA_VERSION = "semaphor-generated-data-app-contract-manifest/v1";
-export declare function validateCodegenSummary(value: unknown): string[];
-export declare function assertValidCodegenSummary(value: unknown): void;

package/dist/types/data-app-codegen-node.d.ts

@@ -1,2 +0,0 @@
-export * from './data-app-codegen/node.js'
-export {}

package/dist/types/data-app-codegen.d.ts

@@ -1,2 +0,0 @@
-export * from './data-app-codegen/index.js'
-export {}

package/dist/types/shared/analytics-protocol/data-app-codegen-summary.d.ts

@@ -1,418 +0,0 @@
-import { MatrixSpec } from './matrix-definition-contract.js';
-import { MatrixWindowRequest } from './matrix-window-contract.js';
-import { SemaphorAnalyticsFilter, SemaphorFieldRef, SemaphorInputOptionsIntent, SemaphorMetricIntent, SemaphorPaginationRequest, SemaphorRelationshipHint, SemaphorSourceRef, SemaphorSqlIntent, SemaphorTimeGrain, SemaphorTimeWindow } from './contracts.js';
-export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION: "semaphor-data-app-codegen-summary/v1";
-export declare const SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION: "semaphor-data-app-codegen-summary-validator/v2";
-export type SemaphorDataAppCodegenSummarySchemaVersion = typeof SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_SCHEMA_VERSION;
-export type SemaphorDataAppCodegenSummaryValidatorVersion = typeof SEMAPHOR_DATA_APP_CODEGEN_SUMMARY_VALIDATOR_VERSION;
-export type SemaphorDataAppCodegenQueryKind = 'metric' | 'records' | 'matrix' | 'analysis' | 'sql_fallback';
-export type SemaphorDataAppCodegenSdkBuilder = 'semaphor.metric' | 'semaphor.records' | 'semaphor.matrix' | 'semaphor.analysis' | 'semaphor.sql';
-export type SemaphorDataAppCodegenFieldRef = SemaphorFieldRef & {
-    sourceKey?: string;
-};
-export type SemaphorDataAppCodegenSourceBearingFieldRef = SemaphorDataAppCodegenFieldRef & ({
-    sourceKey: string;
-} | {
-    source: SemaphorSourceRef;
-});
-export type SemaphorDataAppCodegenAnalyticsFilter = SemaphorAnalyticsFilter & {
-    field: SemaphorDataAppCodegenFieldRef;
-};
-export type SemaphorDataAppCodegenRecordsServerTotalsRequest = {
-    mode: 'server';
-    measures: SemaphorDataAppCodegenSourceBearingFieldRef[];
-};
-export type SemaphorDataAppCodegenSource = SemaphorSourceRef & {
-    sourceKey?: string;
-    datasetRole?: string;
-    relationshipCount?: number;
-    datasetShape?: 'event' | 'daily_snapshot' | 'latest_snapshot' | 'entity_state' | 'dimension' | 'bridge' | 'unknown';
-    dateSemantics?: {
-        primaryDateField?: SemaphorDataAppCodegenFieldRef;
-        primaryDateFieldSource?: 'authored' | 'single_candidate' | 'missing' | 'ambiguous' | 'authored_missing';
-        defaultTimeGrain?: SemaphorMetricIntent['timeGrain'];
-        defaultTimeWindow?: SemaphorMetricIntent['timeWindow'];
-        snapshot?: {
-            kind?: 'not_snapshot' | 'daily_snapshot' | 'latest_snapshot';
-            selector?: 'not_needed' | 'latest_available';
-            selectorSupported?: boolean;
-            dateField?: SemaphorDataAppCodegenFieldRef;
-            unsupportedReason?: string;
-        };
-    };
-};
-export type SemaphorDataAppRelationshipCandidateField = Pick<SemaphorDataAppCodegenFieldRef, 'name' | 'label' | 'role' | 'dataType'>;
-export type SemaphorDataAppRelationshipCandidateSource = {
-    kind: 'semantic';
-    domainId: string;
-    datasetName: string;
-    datasetId?: string;
-    label?: string;
-    sourceKey?: string;
-};
-export type SemaphorDataAppRelationshipCandidate = {
-    source: SemaphorDataAppRelationshipCandidateSource;
-    sourceFields: SemaphorDataAppRelationshipCandidateField[];
-    target: SemaphorDataAppRelationshipCandidateSource;
-    targetFields: SemaphorDataAppRelationshipCandidateField[];
-};
-export type SemaphorDataAppRawIdentifierFilterDiagnostic = {
-    kind: 'raw_identifier_filter_options';
-    inputId: string;
-    inputLabel: string;
-    optionSource: SemaphorDataAppRelationshipCandidateSource;
-    optionField: SemaphorDataAppRelationshipCandidateField;
-    missingEvidence: Array<'display_field' | 'relationship_display_path'>;
-};
-export type SemaphorDataAppCodegenMetricIntent = {
-    source: SemaphorDataAppCodegenSource;
-    id?: string;
-    label?: string;
-    measures: SemaphorDataAppCodegenFieldRef[];
-    primaryMeasure?: SemaphorDataAppCodegenFieldRef;
-    dateField?: SemaphorDataAppCodegenFieldRef;
-    timeGrain?: SemaphorTimeGrain;
-    dimensions?: SemaphorDataAppCodegenFieldRef[];
-    comparison?: SemaphorMetricIntent['comparison'];
-    orderBy?: {
-        field: SemaphorDataAppCodegenFieldRef;
-        direction: 'asc' | 'desc';
-    };
-    filters?: SemaphorDataAppCodegenAnalyticsFilter[];
-    relationshipHint?: SemaphorRelationshipHint;
-    limit?: number;
-    derivedFields?: SemaphorMetricIntent['derivedFields'];
-};
-export type SemaphorDataAppCodegenAnalysisIntent = SemaphorDataAppCodegenMetricIntent & {
-    analysis?: SemaphorMetricIntent['analysis'];
-    timeWindow?: SemaphorTimeWindow;
-    filters?: SemaphorDataAppCodegenAnalyticsFilter[];
-    driverMode?: 'absolute_delta' | 'largest_negative' | 'largest_positive' | 'positive_and_negative' | 'all';
-    includePopulation?: boolean;
-    calendarContext?: {
-        tz?: string;
-        weekStart?: number;
-        anchor?: 'now' | {
-            iso: string;
-        };
-    };
-};
-export type SemaphorDataAppCodegenRecordsIntent = {
-    source: SemaphorDataAppCodegenSource;
-    id?: string;
-    label?: string;
-    fields: SemaphorDataAppCodegenFieldRef[];
-    dateField?: SemaphorDataAppCodegenFieldRef;
-    timeGrain?: SemaphorTimeGrain;
-    timeWindow?: SemaphorTimeWindow;
-    filters?: SemaphorDataAppCodegenAnalyticsFilter[];
-    orderBy?: {
-        field: SemaphorDataAppCodegenFieldRef;
-        direction: 'asc' | 'desc';
-    };
-    relationshipHint?: SemaphorRelationshipHint;
-    limit?: number;
-    pagination?: SemaphorPaginationRequest;
-    totals?: SemaphorDataAppCodegenRecordsServerTotalsRequest;
-    derivedFields?: SemaphorMetricIntent['derivedFields'];
-};
-export type SemaphorDataAppCodegenInputOptionsIntent = Omit<SemaphorInputOptionsIntent, 'kind' | 'source' | 'labelField' | 'valueField' | 'searchField' | 'disambiguationFields'> & {
-    source: SemaphorDataAppCodegenSource;
-    labelField: SemaphorDataAppCodegenFieldRef;
-    valueField: SemaphorDataAppCodegenFieldRef;
-    searchField?: SemaphorDataAppCodegenFieldRef;
-    disambiguationFields?: SemaphorDataAppCodegenFieldRef[];
-};
-export type SemaphorDataAppCodegenMatrixIntent = MatrixSpec & {
-    id?: string;
-    label?: string;
-    matrixWindowRequest: MatrixWindowRequest;
-};
-export type SemaphorDataAppCodegenSqlIntent = Omit<SemaphorSqlIntent, 'kind' | 'fields'> & {
-    fields?: SemaphorDataAppCodegenFieldRef[];
-};
-export type SemaphorDataAppCodegenSdkSpec = {
-    builder: 'semaphor.metric';
-    spec: SemaphorDataAppCodegenMetricIntent;
-} | {
-    builder: 'semaphor.records';
-    spec: SemaphorDataAppCodegenRecordsIntent;
-} | {
-    builder: 'semaphor.matrix';
-    spec: SemaphorDataAppCodegenMatrixIntent;
-} | {
-    builder: 'semaphor.analysis';
-    spec: SemaphorDataAppCodegenAnalysisIntent;
-} | {
-    builder: 'semaphor.sql';
-    spec: SemaphorDataAppCodegenSqlIntent;
-    fallbackReason?: SemaphorDataAppCodegenFallbackReason;
-};
-export type SemaphorDataAppCodegenInputOptionQuery = {
-    id?: string;
-    builder: 'semaphor.inputOptions';
-    source?: Extract<SemaphorSourceRef, {
-        kind: 'semantic' | 'physical';
-    }>;
-    sourceKey?: string;
-    valueFieldRef: SemaphorDataAppCodegenFieldRef;
-    labelFieldRef: SemaphorDataAppCodegenFieldRef;
-    filterFieldRef?: SemaphorDataAppCodegenFieldRef;
-    population?: SemaphorInputOptionsIntent['population'];
-    dependencies?: SemaphorInputOptionsIntent['dependencies'];
-    limit?: number;
-    spec?: SemaphorDataAppCodegenInputOptionsIntent;
-};
-export type SemaphorDataAppCodegenInputBinding = {
-    appliesToViewIds: string[];
-    fieldRef: SemaphorDataAppCodegenFieldRef;
-    relationshipHint?: SemaphorRelationshipHint;
-    relationshipsUsed?: SemaphorDataAppCodegenRelationshipUse[];
-};
-export type SemaphorDataAppCodegenInput = {
-    id: string;
-    label?: string;
-    type?: string;
-    serverSide?: boolean;
-    fieldRef?: SemaphorDataAppCodegenFieldRef;
-    optionQuery?: SemaphorDataAppCodegenInputOptionQuery;
-    bindings?: SemaphorDataAppCodegenInputBinding[];
-    appliesToViewIds: string[];
-    relationshipHint?: SemaphorRelationshipHint;
-    relationshipsUsed?: SemaphorDataAppCodegenRelationshipUse[];
-};
-export type SemaphorDataAppCodegenSourcePresentation = {
-    sourceKeys?: string[];
-    sourceLabels?: string[];
-};
-export type SemaphorDataAppCodegenVisualSpec = {
-    visualType: 'kpi' | 'line_chart' | 'bar_chart' | 'stacked_bar_chart' | 'pie_chart' | 'donut_chart' | 'area_chart' | 'table' | 'matrix' | 'narrative' | 'text_block' | 'custom';
-    title?: string;
-    subtitle?: string;
-    encoding?: {
-        x?: string;
-        y?: string;
-        color?: string;
-        size?: string;
-        columns?: string[];
-        value?: string;
-    };
-    text?: {
-        body?: string;
-        variant?: 'plain' | 'parameterized';
-    };
-    sort?: {
-        field?: string;
-        direction?: 'asc' | 'desc';
-        execution?: 'server' | 'client_for_bounded_rows';
-    };
-    limit?: number;
-    interactions?: string[];
-    states?: string[];
-    tableBehavior?: SemaphorDataAppCodegenTableBehavior;
-};
-export type SemaphorDataAppCodegenTableBehavior = {
-    tableMode: 'bounded' | 'server_paginated' | 'server_windowed';
-    height: {
-        maxPx: number;
-        scroll: 'vertical' | 'both';
-        stickyHeader: boolean;
-    };
-    pagination: {
-        mode: 'none' | 'server' | 'client_for_bounded_rows';
-        pageSize?: number;
-        readsFrom?: 'result.pagination';
-    };
-    sorting: {
-        mode: 'server' | 'client_for_bounded_rows';
-        defaultField?: string;
-        defaultDirection?: 'asc' | 'desc';
-        resetPageOnChange?: boolean;
-    };
-    totals: {
-        mode: 'none';
-    } | SemaphorDataAppCodegenRecordsServerTotalsRequest | {
-        mode: 'local';
-        label: 'Displayed rows' | 'Current page';
-    };
-    serverSideRequired: boolean;
-};
-export type SemaphorDataAppCodegenFallbackReason = {
-    code?: string;
-    message?: string;
-    governedAlternativesTried?: string[];
-    requiredModelingFix?: string;
-    acceptedByUser?: boolean;
-};
-export type SemaphorDataAppCodegenRelationshipUse = {
-    id?: string;
-    fromSourceKey?: string;
-    toSourceKey?: string;
-    fields?: SemaphorDataAppCodegenFieldRef[];
-};
-export type SemaphorDataAppCodegenComputation = {
-    kind: 'server_query';
-    queryKind: SemaphorDataAppCodegenQueryKind;
-    queryOwnership?: 'view_owned' | 'shared_query';
-    sourceKeys?: string[];
-    fieldNames?: string[];
-    inputIds?: string[];
-    tableExecution?: {
-        mode?: 'bounded' | 'server_paginated' | 'server_windowed';
-        initialLimit?: number;
-        sort?: 'server' | 'client_for_bounded_rows';
-        pagination?: 'offset' | 'cursor' | 'window' | 'not_needed';
-    };
-    reason?: string;
-} | {
-    kind: 'derived';
-    upstreamViewId: string;
-    derivation: string;
-    caveat?: string;
-} | {
-    kind: 'presentation_only';
-    reason?: string;
-} | {
-    kind: 'unsupported';
-    reason: string;
-    suggestedModelingFix: string;
-};
-export type SemaphorDataAppCodegenExecutableView = {
-    id: string;
-    title?: string;
-    purpose?: string;
-    sourcePresentation?: SemaphorDataAppCodegenSourcePresentation;
-    visual?: string;
-    visualSpec?: SemaphorDataAppCodegenVisualSpec;
-    queryKind: SemaphorDataAppCodegenQueryKind;
-    sdkBuilder?: SemaphorDataAppCodegenSdkBuilder;
-    sdkSpec: SemaphorDataAppCodegenSdkSpec;
-    fields: SemaphorDataAppCodegenFieldRef[];
-    metricBindingKeys?: string[];
-    computation?: SemaphorDataAppCodegenComputation;
-    uxExpectations?: string[];
-    validation?: SemaphorDataAppCodegenViewValidation;
-};
-export type SemaphorDataAppCodegenPresentationView = {
-    id: string;
-    title?: string;
-    purpose?: string;
-    sourcePresentation?: SemaphorDataAppCodegenSourcePresentation;
-    visual?: 'text_block' | 'narrative' | string;
-    visualSpec?: SemaphorDataAppCodegenVisualSpec;
-    queryKind?: never;
-    sdkBuilder?: never;
-    sdkSpec?: never;
-    fields?: SemaphorDataAppCodegenFieldRef[];
-    computation: Extract<SemaphorDataAppCodegenComputation, {
-        kind: 'presentation_only' | 'unsupported' | 'derived';
-    }>;
-    uxExpectations?: string[];
-    validation?: SemaphorDataAppCodegenViewValidation;
-};
-export type SemaphorDataAppCodegenViewValidation = {
-    status?: 'ready' | 'partial' | 'blocked' | 'unsupported';
-    evidence?: string[];
-    warnings?: string[];
-};
-export type SemaphorDataAppCodegenView = SemaphorDataAppCodegenExecutableView | SemaphorDataAppCodegenPresentationView;
-export type SemaphorDataAppUnsupportedInsight = {
-    title: string;
-    requestedQuestion: string;
-    reason: 'missing_measure' | 'missing_dimension' | 'missing_date' | 'missing_relationship' | 'missing_semantic_role' | 'missing_current_app_state' | 'raw_identifier_filter_options' | 'unsupported_change_intent' | 'ambiguous_field_grounding' | 'bounded_intent_unavailable' | 'invalid_bounded_intent_output' | 'latest_snapshot_selector_not_modeled' | 'unsupported_grain' | 'requires_sql_escape_hatch' | 'unsupported_sdk_capability';
-    suggestedModelingFix: string;
-    diagnostic?: SemaphorDataAppRawIdentifierFilterDiagnostic;
-    relationshipCandidate?: SemaphorDataAppRelationshipCandidate;
-    nextRepairAction?: {
-        tool: 'semaphor_propose_semantic_model_change';
-        reason: 'missing_relationship';
-    };
-};
-export type SemaphorDataAppFilterContractBinding = {
-    viewId: string;
-    fieldRef: SemaphorDataAppCodegenFieldRef;
-    relationshipHint?: SemaphorRelationshipHint;
-    relationshipsUsed?: SemaphorDataAppCodegenRelationshipUse[];
-};
-export type SemaphorDataAppFilterContract = {
-    inputId: string;
-    label?: string;
-    type?: string;
-    serverSide?: boolean;
-    fieldRef?: SemaphorDataAppCodegenFieldRef;
-    optionQuery?: SemaphorDataAppCodegenInputOptionQuery;
-    bindings: SemaphorDataAppFilterContractBinding[];
-    appliesToViewIds: string[];
-    notAppliedToViewIds: string[];
-};
-export type SemaphorDataAppImplementationChecklist = {
-    schemaVersion?: string;
-    requiredDevtools: {
-        mountRootDevtools: boolean;
-        providerDebugBridge?: string;
-        panelPosition?: string;
-        forbidden?: string[];
-    };
-    requiredInputOptions: SemaphorDataAppRequiredInputOption[];
-    filterScopeByInput: SemaphorDataAppFilterScope[];
-    bindingsByView: Record<string, SemaphorDataAppChecklistBinding[]>;
-    validationCommands: string[];
-    browserSmokeChecks: string[];
-};
-export type SemaphorDataAppRequiredInputOption = {
-    inputId?: string;
-    label?: string;
-    builder?: 'semaphor.inputOptions';
-    appliesToViewIds?: string[];
-    optionSourceKey?: string;
-    visibleLabelField?: SemaphorDataAppCodegenFieldRef;
-    optionValueField?: SemaphorDataAppCodegenFieldRef;
-    runtimeFilterField?: SemaphorDataAppCodegenFieldRef;
-    population?: SemaphorInputOptionsIntent['population'];
-    dependencies?: SemaphorInputOptionsIntent['dependencies'];
-};
-export type SemaphorDataAppFilterScope = {
-    inputId?: string;
-    label?: string;
-    type?: string;
-    scope?: 'dashboard' | 'section' | 'card';
-    appliesToViewIds?: string[];
-    notAppliedToViewIds?: string[];
-    cardAffordanceRequired?: boolean;
-};
-export type SemaphorDataAppChecklistBinding = {
-    inputId?: string;
-    inputLabel?: string;
-    fieldRef?: SemaphorDataAppCodegenFieldRef;
-    optionValueField?: SemaphorDataAppCodegenFieldRef;
-    optionLabelField?: SemaphorDataAppCodegenFieldRef;
-    relationshipHint?: SemaphorRelationshipHint;
-    relationshipsUsed?: SemaphorDataAppCodegenRelationshipUse[];
-};
-export type SemaphorDataAppCodegenSummary = {
-    schemaVersion: SemaphorDataAppCodegenSummarySchemaVersion;
-    title: string;
-    purpose?: string;
-    userGoal?: string;
-    nextStep?: string;
-    sources: SemaphorDataAppCodegenSource[];
-    inputs: SemaphorDataAppCodegenInput[];
-    views: SemaphorDataAppCodegenView[];
-    filterContracts: SemaphorDataAppFilterContract[];
-    implementationChecklist: SemaphorDataAppImplementationChecklist;
-    nextRequiredTool?: {
-        name: string;
-        reason?: string;
-    };
-    unsupportedInsights?: SemaphorDataAppUnsupportedInsight[];
-    assumptions?: string[];
-    validation?: {
-        status?: 'ready' | 'partial' | 'blocked';
-        warnings?: string[];
-    };
-};
-export declare function isSemaphorDataAppCodegenSummary(value: unknown): value is SemaphorDataAppCodegenSummary;
-export declare function validateSemaphorDataAppCodegenSummary(value: unknown): {
-    ok: boolean;
-    issues: string[];
-};

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

@@ -1,13 +0,0 @@
-import { PivotExportConfig, PivotRowData, ExportFormattingConfig } from '../types/index.js';
-/**
- * Generate multi-level headers for pivot table
- */
-export declare function generatePivotHeaders(config: PivotExportConfig): string[][];
-/**
- * Format a pivot table data row for CSV export
- */
-export declare function formatPivotDataRow(row: PivotRowData, pivotConfig: PivotExportConfig, formattingConfig: ExportFormattingConfig): string[];
-/**
- * Format pivot table data for CSV export
- */
-export declare function formatPivotTableForCSV(data: PivotRowData[], pivotConfig: PivotExportConfig, formattingConfig: ExportFormattingConfig): string[];

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

@@ -1,10 +0,0 @@
-import { ExportFormattingConfig } from '../types/index.js';
-/**
- * Format table data for CSV export
- * Returns array of CSV rows (strings)
- */
-export declare function formatTableForCSV(data: Record<string, unknown>[], config: ExportFormattingConfig): string[];
-/**
- * Generate complete CSV content for a table
- */
-export declare function generateTableCSV(data: Record<string, unknown>[], config: ExportFormattingConfig, lineEnding?: '\n' | '\r\n'): string;