react-semaphor 0.1.555 → 0.1.557

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

@@ -1,15 +1 @@
 export declare const PDF_GROUP_CONTINUATION_CLASS = "pdf-group-continuation";
-/**
- * Show a label when its canonical hierarchy prefix changes. Compare only
- * adjacent rows and never suppress across subtotal or grand-total boundaries.
- * Adapters supply canonical values, not formatted labels or serialized keys.
- */
-export declare function shouldPresentGroupedTableValue<T extends {
-    isSubtotal?: unknown;
-    isGrandTotal?: unknown;
-}>(input: {
-    row: T;
-    previousRow?: T;
-    levelIndex: number;
-    getValue: (row: T, index: number) => unknown;
-}): boolean;

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

@@ -37,11 +37,9 @@ export * from './attachment-filter-line.js';
 export { describeFilterValueInFullDetail, type FullDetailFilterValue, } from './filter-value-text.js';
 export { describeConditionInFullDetail, type FilterClauseText } from './filter-detail.js';
 export { formatCanonicalComparisonRange } from '../../lib/utils/comparison-window-caption.js';
-export * from './aggregate-table-row-presentation.js';
 export { PDF_GROUP_CONTINUATION_CLASS } from './grouped-table-presentation.js';
 export { SEMAPHOR_GENERATED_COUNT_METRIC_ID } from '../analytics-protocol/contracts.js';
 export { resolveMetricResultAlias } from '../analytics-protocol/metric-comparison.js';
 export * from './pivot-header-presentation.js';
 export * from './pivot-result-identity.js';
 export * from './pivot-result-contract-expectations.js';
-export * from './pivot-result-lifecycle.js';

package/dist/types/shared/format-utils/pdf-export-policy.d.ts

@@ -18,7 +18,7 @@ export declare const PDF_SAFETY_LIMIT_EXCEEDED: "PDF_SAFETY_LIMIT_EXCEEDED";
  * fast path, the print views and scheduled attachments (report attachment
  * delivery RA-D1).
  */
-export declare const PDF_TABLE_CARD_TYPES: readonly ["table", "detailTable", "aggregateTable", "pivotTable"];
+export declare const PDF_TABLE_CARD_TYPES: readonly ["table", "detailTable"];
 export type PdfTableCardType = (typeof PDF_TABLE_CARD_TYPES)[number];
 export declare function isPdfTableCardType(cardType: unknown): cardType is PdfTableCardType;
 /** Exact UTF-8 bytes used by the structured POST body. */

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

@@ -1,28 +1,10 @@
 import { MetricResultAliasInput } from '../analytics-protocol/index.js';
-import { PivotResultExpectedRoleFieldIds } from './pivot-result-lifecycle.js';
-type IdentifiedField = {
+type IdentifiedMetricField = {
     id?: string;
-};
-type IdentifiedMetricField = IdentifiedField & MetricResultAliasInput;
-export type PivotResultContractExpectations = {
-    expectedRoleFieldIds: PivotResultExpectedRoleFieldIds;
-    expectedMetricAliases: string[];
-};
+} & MetricResultAliasInput;
 /**
  * Returns the stable aliases required to distinguish repeated instances of
  * one metric field. Unique metric fields remain role/field scoped.
  */
 export declare function deriveMetricInstanceAliasExpectations(metrics: readonly IdentifiedMetricField[]): string[];
-/**
- * Derives the authored identity expectations stored in a canonical pivot
- * lifecycle contract. Producers and cache-compatibility consumers must use
- * this same projection so generated Count and repeated metric instances cannot
- * drift across the transport seam.
- */
-export declare function derivePivotResultContractExpectations(input: {
-    groupByFields?: readonly IdentifiedField[];
-    metricFields?: readonly IdentifiedMetricField[];
-    pivotByFields?: readonly IdentifiedField[];
-    detailFields?: readonly IdentifiedField[];
-}): PivotResultContractExpectations;
 export {};

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

@@ -12,15 +12,6 @@ export interface QueryColumnKeyMap {
     byRole: QueryColumnKeyMapByRole;
     byMetricAlias?: Record<string, QueryColumnKeyMapEntry>;
 }
-export type PivotResultColumnClassification = {
-    isSubtotal?: boolean;
-    subtotalScope?: 'base' | 'pivot-value' | 'grand-total';
-};
-export declare function isPivotSubtotalPrefix(classification: PivotResultColumnClassification | undefined): boolean;
-export declare function isPivotEmptyTupleAllowed(input: {
-    expectedPivotFieldIds: readonly string[];
-    classification?: PivotResultColumnClassification;
-}): boolean;
 export declare class PivotResultIdentityError extends Error {
     readonly deliveryBlocking = true;
     readonly code: "missing_pivot_member_identity";
@@ -30,23 +21,12 @@ export declare function requirePivotHeaderMembers(input: {
     identity: SemaphorPivotResultColumnIdentity;
     columnKey: string;
     expectedPivotFieldIds?: readonly string[];
-    allowPrefix?: boolean;
-    allowEmpty?: boolean;
 }): readonly SemaphorPivotResultMember[];
 export declare function requirePivotResultColumnIdentities(columns: readonly {
     key: string;
     pivotIdentity?: SemaphorPivotResultColumnIdentity;
 }[], options: {
     expectedPivotFieldIds: readonly string[];
-    columnClassifications?: Readonly<Record<string, PivotResultColumnClassification | undefined>>;
-    allowPrefixForColumn?: (column: {
-        key: string;
-        pivotIdentity?: SemaphorPivotResultColumnIdentity;
-    }) => boolean;
-    allowEmptyForColumn?: (column: {
-        key: string;
-        pivotIdentity?: SemaphorPivotResultColumnIdentity;
-    }) => boolean;
 }): void;
 export declare function resolveQueryColumnKeyMapEntry(columnKeyMap: QueryColumnKeyMap | undefined, fieldId: string, role: QueryColumnKeyRole): QueryColumnKeyMapEntry | undefined;
 export declare function resolveUniqueQueryColumnKeyMapEntry(columnKeyMap: QueryColumnKeyMap | undefined, fieldId: string): QueryColumnKeyMapEntry | undefined;

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

@@ -44,7 +44,6 @@ export type TableExportFormatter = {
 };
 export declare function prepareTableExport(input: {
     formatting: TableExportFormatting;
-    cardType: 'table' | 'detailTable' | 'pivotTable' | 'aggregateTable';
     /** The /api/v1/query body the rows came from (a background job's `queryPayload`). Read for the effective card config, result owner, SQL and Python flags. */
     queryPayload: Record<string, unknown>;
 }): TableExportFormatter;

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

@@ -24,8 +24,4 @@ export type TableExportResult = {
     /** Authoritative data types (SemaphorResultColumn.dataType), from the same response. Missing columns are 'unknown'. */
     resultColumns: readonly Pick<SemaphorResultColumn, 'key' | 'dataType'>[];
     columnKeyMap?: QueryColumnKeyMap;
-    /** Pivot column classifications (deprecated pivot results only). */
-    columnMetadata?: unknown;
-    /** 'not_pivot' for Table and Detail Table; the other values only for deprecated pivot results. */
-    pivotResultKind: 'not_pivot' | 'canonical' | 'legacy_raw';
 };

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.555",
+  "version": "0.1.557",
   "description": "Fully interactive and customizable dashboards for your apps.",
   "keywords": [
     "react",
@@ -127,7 +127,7 @@
     "build": "node scripts/build.mjs",
     "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
     "lint:regressions": "node scripts/lint-regressions.mjs",
-    "check:guards": "node scripts/card-config-consumers.mjs && node scripts/components-entry-imports.mjs && node scripts/types-entry-imports.mjs && node scripts/card-query-assembly-imports.mjs && node scripts/matrix-conversion-imports.mjs && node scripts/assistant-chat-imports.mjs && node scripts/filter-model-reads.mjs && node scripts/layout-engine.mjs",
+    "check:guards": "node scripts/card-config-consumers.mjs && node scripts/components-entry-imports.mjs && node scripts/types-entry-imports.mjs && node scripts/card-query-assembly-imports.mjs && node scripts/matrix-conversion-imports.mjs && node scripts/legacy-table-type-references.mjs && node scripts/assistant-chat-imports.mjs && node scripts/filter-model-reads.mjs && node scripts/layout-engine.mjs",
     "preview": "vite preview",
     "test": "vitest run",
     "test:changed": "vitest run --changed",
@@ -161,7 +161,6 @@
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@floating-ui/react-dom": "^2.1.8",
-    "@headlessui/react": "^2.2.0",
     "@lexical/history": "^0.43.0",
     "@lexical/link": "^0.43.0",
     "@lexical/list": "^0.43.0",
@@ -292,7 +291,6 @@
     "prettier-plugin-tailwindcss": "^0.6.1",
     "react": "19.3.0",
     "react-dom": "19.3.0",
-    "react-grab": "^0.1.16",
     "rollup-plugin-visualizer": "^5.12.0",
     "simple-zustand-devtools": "^1.1.0",
     "tailwindcss": "^3.4.1",

package/src/data-app-sdk/README.md

@@ -12,7 +12,6 @@ Do not inspect SDK implementation internals to discover these patterns.
 ```tsx
 import {
   SemaphorDataAppProvider,
-  SemaphorDevtools,
   semaphor,
   useClearInvalidSemaphorInputValue,
   useSemaphorInputs,
@@ -28,46 +27,24 @@ import type {
 } from "react-semaphor/data-app-sdk";
 ```
 
-## Runtime Provider And DevTools
-
-Generated local/dev apps should mount one root DevTools instance and enable the
-debug bridge only outside production embeds.
+## Runtime Provider
 
 ```tsx
 const runtimeToken = import.meta.env.VITE_SEMAPHOR_PROJECT_TOKEN;
-const enableDevtools =
-  import.meta.env.DEV ||
-  (typeof window !== "undefined" && window.location.hostname === "localhost");
 
 export function Root() {
   return (
-    <SemaphorDataAppProvider
-      token={runtimeToken}
-      debug={enableDevtools ? { exposeWindowBridge: true } : false}
-    >
+    <SemaphorDataAppProvider token={runtimeToken} debug={import.meta.env.DEV}>
       <App />
-      <SemaphorDevtools
-        initialIsOpen={false}
-        buttonPosition="bottom-right"
-        panelPosition="right"
-      />
     </SemaphorDataAppProvider>
   );
 }
 ```
 
-Add hook-level debug source hints when they are cheap and non-repetitive:
-
-```tsx
-const result = useSemaphorQuery(revenueBySegment, {
-  debug: {
-    sourceHint: {
-      file: "src/views/RevenueBySegment.tsx",
-      component: "RevenueBySegment",
-    },
-  },
-});
-```
+With `debug` on, each query asks the server for debug detail. For an
+organization user, the result's `executionResult.metadata.dataAppDebug` then
+carries the request id, duration and compiled SQL. Keep it off in production
+embeds.
 
 ## Query State
 
@@ -129,8 +106,7 @@ Important state fields:
 
 Validation failures produce a structured `SemaphorDataAppQueryError` in
 `result.error`, with `kind: "data_app_query_error"`, `validation`,
-`validationIssues`, and `executionResult` when available. DevTools traces expose
-the same execution status and structured issues.
+`validationIssues`, and `executionResult` when available.
 
 ## Source And Fields