react-semaphor 0.1.551 → 0.1.553

package/dist/surfboard/index.js

@@ -1,5 +1,5 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-DAQEooIW.js";
-import { C as f, E as D } from "../chunks/table-settings-WysCBj62.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-DvabpYcC.js";
+import { C as f, E as D } from "../chunks/table-settings-CBm7G0yx.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/index.js

@@ -1,9 +1,9 @@
-import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as E, a as c, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-WysCBj62.js";
-import { C as y, D as M, L as g, P as h, e as x, g as O, j as V, h as k, k as w, d as U, b as B, i as K, c as z, n as v, f as P } from "../chunks/validators-C-aOQlTB.js";
-import { D as q } from "../chunks/token-types-BMqRmT-C.js";
-import { B as Q, a as j, p as W, r as J } from "../chunks/bookmark-state-Cu-a5ie_.js";
-import { r as H, a as Z } from "../chunks/pivot-result-identity-C-Q1j1Wb.js";
-import { D as ee } from "../chunks/report-runtime-context-hWiTCzFV.js";
+import { C as s, E as r, V as l, i as o, c as i, g as n, f as d, b as m, e as u, d as E, a as c, u as p, s as C, h as T, j as D, q as A, o as I, m as _, n as F, p as S, k as b, l as L, r as f, t as N } from "../chunks/table-settings-CBm7G0yx.js";
+import { C as y, D as M, L as g, P as h, e as x, g as O, j as V, h as k, k as w, d as U, b as B, i as K, c as z, n as v, f as P } from "../chunks/validators-BdBzm_EV.js";
+import { D as q } from "../chunks/token-types-B1p9F_wS.js";
+import { B as Q, a as j, p as W, r as J } from "../chunks/bookmark-state-aGO7_ryE.js";
+import { r as H, a as Z } from "../chunks/pivot-result-identity-dZIYsMrY.js";
+import { D as ee } from "../chunks/report-runtime-context-CKiIubIu.js";
 const e = [
   "concatenate",
   "conditional-category",

package/dist/types/lib/dashboard-inputs/prepare-loaded-dashboard.d.ts

@@ -11,5 +11,8 @@ import { TDashboard } from '../types/common-types.js';
  * and the server's saved-dashboard reader, so they all hold the same shape.
  * The same object when nothing changes. Alias-based text is bound to stable
  * input ids before the upgrade (`upgradeToStoredDashboard`, ledger P5-11).
+ * Last, every Pivot and Hierarchical card the converter can carry exactly
+ * loads as a Matrix card (pivot-aggregate-to-matrix PM-D1, PM-D3): in memory
+ * only, stored as Matrix when someone saves.
  */
 export declare function prepareLoadedDashboard<TDashboardShape extends TDashboard>(dashboard: TDashboardShape): TDashboardShape;

package/dist/types/lib/utils/card-config-utils.d.ts

@@ -0,0 +1,61 @@
+import { CardConfig, DataSource, Field, FilterGroup, JoinPlan } from '../types/explorer-types.js';
+import { TCard } from '../types/common-types.js';
+/** Matrix acquisition requires its structured definition, never an authored SQL query. */
+export declare function supportsSqlEditor(cardType: TCard['type']): boolean;
+export declare function hasEditorResultsView(cardType: TCard['type']): boolean;
+export declare function hasEditorInfoView(cardType: TCard['type']): boolean;
+/** The deprecated table types every saved card of which loads as Matrix (pivot-aggregate-to-matrix). */
+export declare const LEGACY_TABLE_CARD_TYPES: readonly ["pivotTable", "aggregateTable"];
+export type LegacyTableCardType = (typeof LEGACY_TABLE_CARD_TYPES)[number];
+export declare function isLegacyTableCard(card: Pick<TCard, 'type'>): card is Pick<TCard, 'type'> & {
+    type: LegacyTableCardType;
+};
+/**
+ * Why one data part did not carry exactly (pivot-aggregate-to-matrix PM-D12).
+ * The problem-area codes (PA-n) are the shapes a later rule will translate;
+ * display differences are never gaps (PM-D15).
+ */
+export type CardTypeChangeGapCode = 'calculated_metric_per_row' | 'calculated_metric_without_stage' | 'calculated_field_card_scope' | 'calculated_field_dashboard_scope' | 'source_field_renamed' | 'join_not_carried' | 'metric_parameters' | 'aggregate_not_supported' | 'unknown_field_property' | 'calculated_level_without_inputs' | 'field_not_resolvable' | 'filter_not_accepted' | 'control_binding' | 'no_shelf_fields' | 'matrix_definition_incomplete' | 'detail_columns' | 'matrix_field_not_on_shelves' | 'not_in_detail_table';
+export type CardTypeChangeGap = {
+    code: CardTypeChangeGapCode;
+    label: string;
+};
+export type MatrixRepresentationChange = {
+    card: Partial<TCard>;
+    /** Authored data parts the next representation does not accept, in shelf order. */
+    gaps: readonly CardTypeChangeGap[];
+};
+/**
+ * Crossing the Matrix boundary carries the card's authored definition (MS-D12):
+ * rows, pivot columns, metrics, the join and filters are read once through
+ * `getCardDefinition` and written into the next representation by each part's
+ * own writer. A data part the next representation refuses is a gap. Into
+ * Matrix, number formats carry, and from a Pivot or Hierarchical card the
+ * expansion and the visible totals too (PM-D5); every other display setting
+ * takes the Matrix defaults. SQL, Python and control bindings start fresh.
+ * Needs the loaded column catalog to complete join keys and resolve Matrix
+ * fields; without it, keys saved with their identity still carry.
+ */
+export declare function convertMatrixRepresentation(card: TCard, nextType: TCard['type'], catalog?: readonly Field[], 
+/** Mints each carried Matrix field's instance id; a replayed conversion passes stored ids (DE-D54). */
+createId?: () => string): MatrixRepresentationChange;
+/** The switch reads the catalog only when it has something to carry. */
+export declare function matrixSwitchNeedsCatalog(card: TCard, nextType: TCard['type']): boolean;
+/** Replacing the base dataset starts a new definition; metadata refresh does not. */
+export declare function withAuthoredCardDataSource(card: TCard, dataSource: DataSource): Partial<TCard>;
+export declare function getAuthoredCardJoinPlan(card: Pick<TCard, 'type' | 'config'>): JoinPlan | undefined;
+/** The normal join editor writes the canonical definition, including empty drafts. */
+export declare function withAuthoredCardJoinPlan(card: Pick<TCard, 'type' | 'config' | 'dataSource'>, joinPlan: JoinPlan | undefined): CardConfig;
+/** Authored predicates from the card's canonical representation. */
+export declare function getAuthoredCardFilters(card: Pick<TCard, 'type' | 'config'> | undefined): FilterGroup | undefined;
+export declare function withAuthoredCardFilters(card: Pick<TCard, 'type' | 'config' | 'dataSource'>, filters: FilterGroup | undefined): CardConfig;
+/**
+ * Checks if a card config object has actual configuration data
+ * An empty config object {} should be treated as no config
+ */
+export declare function hasValidCardConfig(config: CardConfig | undefined, cardType?: TCard['type']): boolean;
+type CardSetupCheckOptions = {
+    skipSetupCheck?: boolean;
+};
+export declare function isCardUnconfigured(card: Pick<TCard, 'type' | 'sql' | 'config' | 'connectionId' | 'dataSource' | 'customCardPreferences'>, options?: CardSetupCheckOptions): boolean;
+export {};

package/dist/types/lib/utils/card-type-change.d.ts

@@ -1,5 +1,7 @@
 import { TCard, TCardPreferences, TCustomCardPreferences } from '../types/common-types.js';
 import { Field } from '../types/explorer-types.js';
+import { CardTypeChangeGap } from './card-config-utils.js';
+export type { CardTypeChangeGap, CardTypeChangeGapCode } from './card-config-utils.js';
 export declare function sharedCardPreferences(preferences: TCardPreferences | undefined): TCardPreferences;
 export type CardTypeChangeOptions = {
     /** The loaded column catalog; the Matrix carry resolves fields against it. */
@@ -22,7 +24,9 @@ export type CardTypeChange = {
 } | {
     status: 'changed';
     card: TCard;
-    /** Labels of authored parts the new type could not keep. */
+    /** Authored data parts the new type could not keep, with why (pivot-aggregate-to-matrix PM-D12). */
+    gaps: readonly CardTypeChangeGap[];
+    /** The gaps' labels, in the same order, for readers that only name them. */
     leftOut: readonly string[];
     /** Chart-scoped preference keys the new type drops (DE-D43). */
     droppedPreferences: readonly (keyof TCardPreferences)[];

package/dist/types/shared/analytics-protocol/explorer-input-schemas.d.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod';
 import { Field, FilterGroup, JoinPlan } from '../../lib/types/explorer-types.js';
+/** The roles a field may carry; the Matrix carry drops any other (pivot-aggregate-to-matrix PA-19). */
+export declare const explorerFieldRoleSchema: z.ZodEnum<["groupby", "metric", "sortby", "pivotby", "detail"]>;
 export declare const explorerFieldSchema: z.ZodType<Field>;
 export declare const filterGroupSchema: z.ZodType<FilterGroup>;
 export declare const joinPlanSchema: z.ZodType<JoinPlan>;

package/dist/types/shared/assistant-protocol/answer-text.d.ts

@@ -14,6 +14,29 @@ import { AssistantPart } from './parts.js';
 export type AnswerPartKind = 'text' | 'step' | 'other';
 /** The parts that are working notes: text before the last step that comes before the answer's last text. */
 export declare function workingNotesOf<T>(parts: readonly T[], kindOf: (part: T) => AnswerPartKind): ReadonlySet<T>;
+/**
+ * Where each part kind shows in an answer (assistant joins and panel H-1): in
+ * its body, in order (the words that aren't working notes, the blocks); in its
+ * details (steps, what it used, the trace); or nowhere (the conversation's id,
+ * a proposal's operations). The transcript and the copied text both read it,
+ * and a new part kind doesn't compile until it has a place here.
+ */
+export declare const ANSWER_PART_PLACEMENT: {
+    readonly conversation: "nowhere";
+    readonly text: "body";
+    readonly stage: "details";
+    readonly using: "details";
+    readonly clarify: "body";
+    readonly artifact: "body";
+    readonly refusal: "body";
+    readonly trace: "details";
+    readonly proposal: "body";
+    readonly proposal_operations: "nowhere";
+    readonly proposal_refused: "body";
+    readonly model_change: "body";
+};
+/** Whether a part kind shows in an answer's body; a kind this build doesn't know (a newer server's) doesn't. */
+export declare function showsInAnswerBody(kind: string): boolean;
 /** A stored part's kind for `workingNotesOf`. */
 export declare function storedPartKind(part: AssistantPart): AnswerPartKind;
 /** A stored answer's text: its text parts after the last step, a paragraph each. */

package/dist/types/shared/assistant-protocol/conversation-text.d.ts

@@ -0,0 +1,29 @@
+import { AssistantConversationDetail } from './conversation.js';
+/**
+ * What the copy does with every field of a conversation and of a turn
+ * (assistant joins and panel H-1, P3-08): a field added to either type
+ * doesn't compile until it is shown or left out here on purpose.
+ */
+export declare const COPIED_CONVERSATION_FIELDS: {
+    readonly conversationId: "with tool calls";
+    readonly addedSources: "left out";
+    readonly allows: "left out";
+    readonly turns: "shown";
+};
+export declare const COPIED_TURN_FIELDS: {
+    readonly turnId: "left out";
+    readonly startedAt: "shown";
+    readonly message: "shown";
+    readonly taggedFields: "shown";
+    readonly parts: "shown";
+    readonly outcome: "shown";
+    readonly toolCalls: "with tool calls";
+    readonly model: "with tool calls";
+    readonly instructionsVersion: "with tool calls";
+};
+export declare function conversationText(detail: AssistantConversationDetail, options: {
+    assistantName: string;
+    toolCalls?: boolean;
+}): string;
+/** A tool's name without the product prefix (AJ-INV-8). */
+export declare function toolName(tool: string): string;

package/dist/types/shared/assistant-protocol/conversation.d.ts

@@ -1,5 +1,5 @@
 import { SemaphorSourceRef } from '../analytics-protocol/contracts.js';
-import { AssistantPart } from './parts.js';
+import { AssistantCallerAllows, AssistantPart } from './parts.js';
 import { AssistantCardField } from './context.js';
 /** How a stored turn ended; `running` while it is answering, `interrupted` when its process died. */
 export type TurnOutcome = 'running' | 'completed' | 'stopped' | 'failed' | 'refused' | 'interrupted';
@@ -15,12 +15,15 @@ export type AssistantConversationSummary = {
 };
 /**
  * What opening a conversation returns (Phase 3c, D3c-5): the turns as the
- * transcript shows them. Never the context, tool calls, card request,
- * executed queries or provider replay (AG-INV-5).
+ * transcript shows them. Never the context, card request, executed queries
+ * or provider replay (AG-INV-5); tool calls only when an organization user
+ * asks for them to copy (AJ-D11).
  */
 export type AssistantConversationDetail = {
     conversationId: string;
     addedSources: SemaphorSourceRef[];
+    /** What the caller may do (AJ-D14). Absent from a server before it. */
+    allows?: AssistantCallerAllows;
     turns: Array<{
         turnId: string;
         startedAt: string;
@@ -30,8 +33,26 @@ export type AssistantConversationDetail = {
         /** Shown through the one stored-part mapping the stream uses (D3c-6, `transcript.ts`). */
         parts: AssistantPart[];
         outcome: TurnOutcome;
+        /**
+         * Only when asked for and only for an organization user (AJ-D11,
+         * AJ-INV-4): each tool call's name, input, row count, time and outcome, never its
+         * result, and the model and instructions that answered.
+         */
+        toolCalls?: AssistantToolCallRecord[];
+        model?: string;
+        instructionsVersion?: string;
     }>;
 };
+/** One tool call as a stored turn keeps it: never its result (it can hold customer rows). */
+export type AssistantToolCallRecord = {
+    tool: string;
+    input: unknown;
+    ok: boolean;
+    /** How many rows a query call returned, from its own result (never the rows). */
+    rowCount?: number;
+    durationMs?: number;
+    error?: string;
+};
 export declare const ASSISTANT_LAYOUTS: readonly ["docked-right", "docked-left", "centered", "full-page"];
 /** Where the assistant opens. Token config `assistant.layout` sets the embed default (AG-D21). */
 export type AssistantLayout = (typeof ASSISTANT_LAYOUTS)[number];

package/dist/types/shared/assistant-protocol/index.d.ts

@@ -11,8 +11,10 @@ export * from './availability.js';
 export * from './parts.js';
 export * from './conversation.js';
 export * from './transcript.js';
+export * from './conversation-text.js';
 export * from './answer-text.js';
 export * from './sources.js';
 export * from './token-config.js';
 export * from './artifact.js';
 export * from './add-to-dashboard.js';
+export * from './model-change.js';

package/dist/types/shared/assistant-protocol/model-change.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Adding a relationship the assistant proposed (assistant joins and panel
+ * AJ-D17): what the apply route answers, and the panel's words for each way
+ * it can refuse. The route sends the change store's own codes; the person
+ * reads these words, never the store's messages (written for agents) and
+ * never the product's name (AJ-INV-8).
+ */
+/** `POST /api/v1/assistant/proposals/{proposalId}/apply`, answered 200: the relationship is in the domain (or already was). */
+export type AssistantModelChangeApplied = {
+    applied: true;
+    replayed: boolean;
+};
+/** The route's refusal body: a change store code and the store's message (for logs, not for the person). */
+export type AssistantModelChangeRefusal = {
+    code: string;
+    message: string;
+};
+/** The panel's words for a refusal code; any other code (a validation failure, a server error) is "couldn't be added". */
+export declare function modelChangeRefusalMessage(code: unknown): string;

package/dist/types/shared/assistant-protocol/parts.d.ts

@@ -10,10 +10,20 @@ import { CreatedEntity, DashboardOperation, OperationContext } from '../dashboar
  * Artifacts from Phase 4; proposals in Phase 7.
  */
 export declare const ASSISTANT_PARTS_VERSION: 1;
+/**
+ * What the person asking may do here, from the server's own caller (assistant
+ * joins and panel AJ-D14): whether a copy may include the tool calls
+ * (organization users). Fixed for a conversation; the browser decides nothing
+ * from the token itself.
+ */
+export type AssistantCallerAllows = {
+    toolCalls: boolean;
+};
 export type AssistantPart = {
     kind: 'conversation';
     conversationId: string;
     expiresAt: string;
+    allows?: AssistantCallerAllows;
 } | {
     kind: 'text';
     text: string;
@@ -28,7 +38,7 @@ export type AssistantPart = {
     kind: 'refusal';
     code: AssistantRefusalCode;
     message: string;
-} | AssistantTracePart | AssistantProposalPart | AssistantProposalOperationsPart;
+} | AssistantTracePart | AssistantProposalPart | AssistantProposalOperationsPart | AssistantProposalRefusedPart | AssistantModelChangePart;
 /**
  * A change the assistant made to the dashboard on screen (Phase 7, spec 8.1,
  * D7-16): what it does in plain sentences, stored with the turn. Its
@@ -61,6 +71,34 @@ export type AssistantProposalOperationsPart = {
     operations: DashboardOperation[];
     context: OperationContext;
 };
+/**
+ * A change the assistant asked for and nothing landed, for a reason the
+ * person should see (assistant joins and panel AJ-D8): today only a card
+ * whose datasets the domain doesn't relate. Stored with the turn; the model
+ * gets the refusal as before. `message` is the change problem's own
+ * sentence, safe to show an end user.
+ */
+export type AssistantProposalRefusedPart = {
+    kind: 'proposal_refused';
+    code: 'relationship_missing';
+    message: string;
+};
+/**
+ * A relationship the assistant proposes adding to a domain (assistant joins
+ * and panel AJ-D16): what it does in plain sentences, stored with the turn.
+ * The assistant never adds it; the person does, by click, through the apply
+ * route (AJ-D17, AJ-INV-6).
+ */
+export type AssistantModelChangePart = {
+    kind: 'model_change';
+    proposalId: string;
+    domainId: string;
+    /** The domain's label: "Every dashboard on the {domainLabel} domain can use it." */
+    domainLabel: string;
+    /** One per change (`relationship.add`) and its sentence, as propose returned them. */
+    changes: AssistantProposalChange[];
+    warnings: ChangeDiagnostic[];
+};
 /**
  * A question the person answers with a click, ending the answer (ledger
  * D3d-1): the model's alternatives as data, never parsed from its text. Each
@@ -76,6 +114,12 @@ export type AssistantClarifyPart = {
         label: string;
         description?: string;
     }>;
+    /**
+     * The choices can be carried out together (assistant joins and panel
+     * AJ-D20, AJ-D21): the person ticks any of them and sends them at once.
+     * Absent for one answer; a client before it shows the rows as one answer.
+     */
+    multiple?: true;
 };
 export type AssistantStagePart = {
     kind: 'stage';

package/dist/types/shared/dashboard-authoring/changes/dashboard-change.d.ts

@@ -7815,7 +7815,11 @@ export declare const MAX_PROPOSED_CHANGES = 20;
 export type ProposeChangeCaller = {
     /** Dashboard changes (card.*, filter.*). False for a tenant VIEWER: the tool isn't listed at all. */
     dashboards: boolean;
-    /** relationship.add: org interactive callers only. */
+    /**
+     * relationship.add: an org Author or higher, on any credential (assistant
+     * joins and panel AJ-D15, AJ-D19). On screen, only for the in-product
+     * assistant, whose person adds it by click (AJ-D16).
+     */
     domains: boolean;
     /** dashboard.generate: callers who may create dashboards. */
     generate: boolean;
@@ -7824,8 +7828,9 @@ export type ProposeChangeCaller = {
     /**
      * A session that changes the dashboard on the user's screen (a live token,
      * Semaphor's own assistant): it changes only the open dashboard, in place,
-     * so `saveAs`, `preview` and `domainId` are not offered and, since the schema
-     * is strict, are refused if sent (embedded live changes LC-D17).
+     * so `saveAs` and `preview` are not offered and, since the schema is
+     * strict, are refused if sent (embedded live changes LC-D17). `domainId`
+     * is offered only with `domains`, for `relationship.add` (AJ-D16).
      */
     onScreen: boolean;
 };

package/dist/types/shared/dashboard-authoring/changes/diagnostics.d.ts

@@ -4,7 +4,13 @@
  * warnings. Messages are one sentence a person can read and never name the
  * product; `fix` tells the agent what to do next.
  */
-export type ChangeProblemCode = 'invalid_change' | 'invalid_change_target' | 'copy_required' | 'not_permitted' | 'change_not_allowed_for_credential' | 'dashboard_not_found' | 'card_not_found' | 'filter_not_found' | 'sheet_not_found' | 'sheet_required' | 'sheet_not_a_grid' | 'field_not_found' | 'card_not_editable' | 'type_not_supported' | 'query_form_mismatch' | 'capability_required' | 'handle_unknown' | 'too_many_changes'
+export type ChangeProblemCode = 'invalid_change' | 'invalid_change_target' | 'copy_required' | 'not_permitted' | 'dashboard_not_found' | 'card_not_found' | 'filter_not_found' | 'sheet_not_found' | 'sheet_required' | 'sheet_not_a_grid' | 'field_not_found'
+/**
+ * The card's datasets aren't joined by the domain's relationships, so the
+ * card can't run (assistant joins and panel AJ-D4). Details name the base
+ * dataset and the ones it can't reach.
+ */
+ | 'relationship_missing' | 'card_not_editable' | 'type_not_supported' | 'query_form_mismatch' | 'capability_required' | 'handle_unknown' | 'too_many_changes'
 /** filter.update or filter.bind on a filter the outline marks read only. */
  | 'filter_not_editable'
 /** The changed dashboard fails the save's own validation (propose or apply). */

package/dist/types/shared/dashboard-authoring/document-section-cards.d.ts

@@ -44,6 +44,12 @@ export type DashboardCardLocation = {
  * then frame cards, then document section cards (every KPI card included).
  */
 export declare function listDashboardCardLocations(dashboard: Pick<TDashboard, 'sheets'>): readonly DashboardCardLocation[];
+/**
+ * The dashboard with each card mapped, in `listDashboardCardLocations` order.
+ * Returns the input object when no card changed, and likewise each sheet,
+ * frame and section, so callers can compare by reference.
+ */
+export declare function mapDashboardCards<T extends Pick<TDashboard, 'sheets'>>(dashboard: T, map: (card: TCard, location: DashboardCardLocation) => TCard): T;
 export type DocumentSectionShapeIssue = {
     /** Path relative to the section, for example `cards[2].type`. Empty for the section itself. */
     path: string;

package/dist/types/shared/dashboard-authoring/index.d.ts

@@ -9,6 +9,7 @@ export * from './temporal-bucket-authoring.js';
 export * from './canonical-result-keys.js';
 export * from './dashboard-card-source-index.js';
 export * from './document-section-cards.js';
+export * from './legacy-table-routing.js';
 export * from './dashboard-filter-mapping-types.js';
 export * from './dashboard-filter-automatic-target.js';
 export * from './dashboard-filter-sql-subscription.js';

package/dist/types/shared/dashboard-authoring/legacy-table-routing.d.ts

@@ -0,0 +1,64 @@
+import { TCard, TDashboard, TFrame } from '../../lib/types/common-types.js';
+import { CardTypeChangeGap } from '../../lib/utils/card-type-change.js';
+import { DashboardCardLocation } from './document-section-cards.js';
+export { LEGACY_TABLE_CARD_TYPES, isLegacyTableCard, type LegacyTableCardType, } from '../../lib/utils/card-config-utils.js';
+/**
+ * Load routing of Pivot and Hierarchical cards
+ * (semaphor-app docs/implementation-plans/pivot-aggregate-to-matrix). A saved
+ * `pivotTable` or `aggregateTable` card is converted in memory by the one
+ * converter and replaced only when the conversion is exact: no gap, and a
+ * ready definition (PM-D3). A Pivot that only groups rows becomes the regular
+ * Table; every other card becomes Matrix (`legacyTableRoutingTarget`).
+ * Nothing is written back; a save stores the new card like any other edit
+ * (PM-D1). This module never builds a definition itself (PM-D2).
+ */
+/** PM-D7: the namespace of the ids routing mints. Fixed forever: changing it changes every routed card. */
+export declare const LEGACY_TABLE_ROUTING_ID_NAMESPACE = "9677efdd-86ec-4afb-b9bb-5ead8b5442af";
+/**
+ * The ids a routed card's Matrix levels and measures get: the n-th call
+ * returns the UUID v5 of `${cardId}#${n}`. The same saved card therefore
+ * converts to the same Matrix definition on every load, in the browser and
+ * on the server (PM-D7).
+ */
+export declare function legacyTableRoutingIds(cardId: string): () => string;
+export type LegacyTableCardRouting = 
+/** Not a Pivot or Hierarchical card: the input object. */
+{
+    status: 'not_legacy';
+    card: TCard;
+}
+/** The converter's Matrix or Table card, same card id. */
+ | {
+    status: 'routed';
+    card: TCard;
+}
+/** The input object, kept as stored, with what blocked the conversion. */
+ | {
+    status: 'unrouted';
+    card: TCard;
+    gaps: readonly CardTypeChangeGap[];
+};
+/**
+ * PM-D3 target: a Pivot driven by its shelves (no SQL text, at least one row
+ * level or metric) with no pivot columns and no
+ * row or column totals is a flat grouped table, so it becomes the regular
+ * Table (the editor's table-kind switch keeps its config unchanged, and the
+ * query builder compiles the same SQL for both types). Every other Pivot and
+ * every Hierarchical card becomes Matrix.
+ */
+export declare function legacyTableRoutingTarget(card: TCard): 'table' | 'matrixTable';
+/** One card: route it when the conversion is exact (PM-D3). */
+export declare function routeLegacyTableCard(card: TCard): LegacyTableCardRouting;
+/** Each card of a library frame. Returns the input object when nothing routed. */
+export declare function routeLegacyTableFrame<T extends Pick<TFrame, 'cards'>>(frame: T): T;
+export type UnroutedLegacyTableCard = {
+    location: DashboardCardLocation;
+    gaps: readonly CardTypeChangeGap[];
+};
+export type LegacyTableDashboardRouting<T> = {
+    /** The input object when nothing routed. */
+    dashboard: T;
+    unrouted: readonly UnroutedLegacyTableCard[];
+};
+/** Every sheet, frame and document section card of a dashboard. */
+export declare function routeLegacyTableCards<T extends Pick<TDashboard, 'sheets'>>(dashboard: T): LegacyTableDashboardRouting<T>;

package/package.json

@@ -5,7 +5,7 @@
     "email": "support@semaphor.cloud"
   },
   "license": "MIT",
-  "version": "0.1.551",
+  "version": "0.1.553",
   "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/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/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",

package/dist/chunks/add-to-dashboard-BQRAAnc3.js

@@ -1,102 +0,0 @@
-import { A as s, h as u, m as d } from "./context-BerEBuFR.js";
-function o(e, t) {
-  return e.role === t.role && e.name === t.name && e.aggregate === t.aggregate && e.granularity === t.granularity;
-}
-function l(e) {
-  var n, a;
-  const t = (n = e.selectedCard) == null ? void 0 : n.description;
-  return (t == null ? void 0 : t.status) !== "described" || t.sql || ((a = e.editing) == null ? void 0 : a.mode) === "sql" ? [] : t.fields;
-}
-function S(e, t) {
-  if (t.length === 0) return [];
-  if (t.length > s.taggedFields)
-    return [`taggedFields: at most ${s.taggedFields}`];
-  const n = l(e);
-  return t.flatMap((a, i) => n.some((r) => o(r, a)) ? t.slice(0, i).some((r) => o(r, a)) ? [`taggedFields.${i}: tagged twice`] : [] : [`taggedFields.${i}: not a field of the card the context asks about`]);
-}
-function k(e, t) {
-  return t != null && t.length ? `Fields of the asked-about card the user tagged in this question: ${t.map(u).join("; ")}.
-
-${e}` : e;
-}
-function f(e) {
-  if (e.kind === "text") return { type: "text", text: e.text };
-  const { kind: t, ...n } = e;
-  return {
-    type: `data-${t}`,
-    ...e.kind === "stage" ? { id: e.stageId } : {},
-    data: n
-  };
-}
-function b(e, t) {
-  return e.kind !== "text" ? [f(e)] : [
-    { type: "text-start", id: t },
-    { type: "text-delta", id: t, delta: e.text },
-    { type: "text-end", id: t }
-  ];
-}
-function h(e) {
-  if (e === "failed" || e === "interrupted")
-    return { kind: "refusal", code: "model_unavailable", message: d.model_unavailable };
-  if (e === "running")
-    return { kind: "refusal", code: "turn_in_progress", message: d.turn_in_progress };
-}
-function c(e, t) {
-  let n = -1;
-  e.forEach((i, r) => {
-    t(i) === "text" && (n = r);
-  });
-  let a = -1;
-  return e.forEach((i, r) => {
-    r < n && t(i) === "step" && (a = r);
-  }), new Set(e.filter((i, r) => r < a && t(i) === "text"));
-}
-function g(e) {
-  return e.kind === "text" ? "text" : e.kind === "stage" && !e.change ? "step" : "other";
-}
-function x(e) {
-  const t = c(e, g);
-  return e.flatMap((n) => n.kind === "text" && !t.has(n) ? [n.text] : []).filter((n) => n.trim().length > 0).join(`
-
-`);
-}
-function T(e) {
-  if (e.kind === "semantic") return JSON.stringify(["semantic", e.domainId, e.datasetName]);
-  if (e.kind === "sql") return JSON.stringify(["sql", e.connectionId]);
-}
-function F(e) {
-  return e.label ?? (e.kind === "semantic" ? e.datasetName : e.kind === "physical" ? e.tableName : "SQL");
-}
-function y(e) {
-  return {
-    columns: e.columns,
-    records: e.records,
-    rowCount: e.rowCount,
-    governed: e.status.governed,
-    complete: e.status.complete,
-    truncated: e.status.truncated
-  };
-}
-const A = {
-  number: "kpi",
-  line: "line",
-  bar: "bar",
-  stackedBar: "stackedBar",
-  table: "table"
-};
-export {
-  A,
-  l as a,
-  f as b,
-  b as c,
-  h as d,
-  g as e,
-  x as f,
-  T as g,
-  F as h,
-  k as q,
-  o as s,
-  S as t,
-  y as v,
-  c as w
-};