react-semaphor 0.1.544 → 0.1.546

package/dist/surfboard/index.js

@@ -1,5 +1,5 @@
-import { a, R as s, D as o } from "../chunks/report-preferences-dialog-Df7VpRVW.js";
-import { C as f, E as D } from "../chunks/table-settings-CLZocegs.js";
+import { a, R as s, D as o } from "../chunks/report-preferences-dialog-4QEZWe5U.js";
+import { C as f, E as D } from "../chunks/table-settings-CunhoDUi.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/briefings/attachment-outcomes.d.ts

@@ -4,7 +4,7 @@ import { BriefingAttachmentFormat } from './index.js';
  * RA-D14). The app decides the code and writes the customer line; the run
  * card reads both back from the run.
  */
-export declare const BRIEFING_ATTACHMENT_OMISSION_CODES: readonly ["PDF_ROW_LIMIT_EXCEEDED", "PDF_SIZE_LIMIT_EXCEEDED", "TABLE_COMPLETENESS_UNVERIFIED", "CARD_QUERY_FAILED", "RENDER_NOT_READY", "RENDER_TIMED_OUT", "EXPORT_JOB_FAILED", "ATTACHMENT_UNAVAILABLE", "EXCEL_LIMIT_EXCEEDED", "EXPORT_ROW_LIMIT_EXCEEDED", "EXPORT_COUNT_UNAVAILABLE", "EXPORT_NO_ROWS"];
+export declare const BRIEFING_ATTACHMENT_OMISSION_CODES: readonly ["PDF_ROW_LIMIT_EXCEEDED", "PDF_SIZE_LIMIT_EXCEEDED", "TABLE_COMPLETENESS_UNVERIFIED", "CARD_QUERY_FAILED", "RENDER_NOT_READY", "RENDER_TIMED_OUT", "EXPORT_JOB_FAILED", "ATTACHMENT_UNAVAILABLE", "EXCEL_LIMIT_EXCEEDED", "EXPORT_ROW_LIMIT_EXCEEDED", "EXPORT_COUNT_UNAVAILABLE", "EXPORT_NO_ROWS", "IMAGE_TOO_LARGE"];
 export type BriefingAttachmentOmissionCode = (typeof BRIEFING_ATTACHMENT_OMISSION_CODES)[number];
 /** One left-out attachment, as recorded on the run and read by every channel. */
 export type BriefingOmittedAttachment = {

package/dist/types/briefings/attachments.d.ts

@@ -1,4 +1,5 @@
 import { BriefingAttachment, BriefingAttachmentFormat } from './index.js';
+import { ExportFileFormat } from '../shared/format-utils/exporters/export-file-format.js';
 import { TCard } from '../lib/types/common-types.js';
 export type BriefingCardAttachmentCapability = {
     formats: BriefingAttachmentFormat[];
@@ -11,19 +12,45 @@ export declare function getBriefingCardAttachmentCapability(card: TCard): Briefi
  * every row up to the export cap.
  */
 export declare function isBriefingTableExportCardType(cardType: string | undefined): boolean;
+/** How a run makes an attachment (PNG exports SPEC §2.7). */
+export type BriefingAttachmentProduction = 
+/** Drawn by the renderer from the print view (PDF, PNG, and CSV of a card that is not a table or Matrix). */
+{
+    kind: 'rendered';
+    format: 'pdf' | 'png' | 'csv';
+}
+/** A Matrix card's PDF, built from the Matrix capture. */
+ | {
+    kind: 'matrix_pdf';
+}
+/** A background export job: CSV and Excel of Table, Detail Table and Matrix cards. */
+ | {
+    kind: 'export_job';
+    format: ExportFileFormat;
+};
 /**
- * Attachments a background export job makes before a run is finalized
- * (Excel exports SPEC §3.4, §3.5): a card's data file (CSV or Excel) of a
- * Matrix with its capture, a Table or a Detail Table. Every other attachment
- * renders. Read by preparation, release, delivery access and the page route
- * alike, so they always agree on which attachments a job makes.
+ * How the run makes this attachment. The only place that decides it: a PNG
+ * is always rendered (a Matrix PNG too), a Matrix PDF comes from the Matrix
+ * capture, and a data file (CSV or Excel) of a Matrix with its capture, a
+ * Table or a Detail Table is a background export job (Excel exports SPEC
+ * §3.4, §3.5). Read by preparation, release, delivery access, the page route
+ * and the renderer adapter alike, so they always agree.
  */
+export declare function briefingAttachmentProduction(attachment: BriefingAttachment): BriefingAttachmentProduction;
+/** Attachments a background export job makes before a run is finalized. */
 export declare function briefingAttachmentNeedsExportJob(attachment: BriefingAttachment): boolean;
+export type BriefingAttachmentFileTraits = {
+    label: string;
+    extension: string;
+    contentType: string;
+};
+/** An attachment file's name, extension and content type: rendered files and data files have one owner each. */
+export declare function briefingAttachmentFileTraits(format: BriefingAttachmentFormat): BriefingAttachmentFileTraits;
 export declare function getBriefingCardAttachmentFormats(input: {
     cardType: string;
     allowDownload?: boolean;
 }): BriefingAttachmentFormat[];
-/** The name customers read for an attachment format: PDF, CSV or Excel. */
+/** The name customers read for an attachment format: PDF, PNG image, CSV or Excel. */
 export declare function briefingAttachmentFormatLabel(format: BriefingAttachmentFormat): string;
 export declare function getDefaultBriefingCardAttachmentFormat(input: {
     cardType: string;

package/dist/types/briefings/index.d.ts

@@ -2,11 +2,10 @@ import { NumericCanonicalFormat, NumericPresentationTarget, PresentationExecutio
 import { BriefingAppearanceSpec, BriefingFragments, BriefingThemeOverrides } from './presentation-contract.js';
 import { MatrixConfig } from '../shared/analytics-protocol/index.js';
 import { CsvEncoding } from '../shared/format-utils/exporters/csv-utils.js';
-import { ExportFileFormat } from '../shared/format-utils/exporters/export-file-format.js';
 export { captureMatrixExport, buildMatrixDeliveryEnvelope, matrixDeliveryPayloadSchema, matrixDeliveryQuerySchema, type MatrixLayoutReadResult } from '../shared/dashboard-authoring/matrix-delivery.js';
 export declare const BRIEFING_KIND: "BRIEFING";
 export { DEFAULT_BRIEFING_SCHEDULE, briefingScheduleMonths, briefingScheduleDayOccurs, briefingScheduleShortMonths, buildBriefingScheduleExpr, canonicalBriefingMonthDays, describeBriefingSchedule, isValidBriefingTimezone, nextBriefingScheduleDates, parseBriefingScheduleExpr, type BriefingScheduleFrequency, type BriefingScheduleMonthDay, type BriefingScheduleMonthInterval, type BriefingScheduleMonthlyOn, type BriefingScheduleOrdinal, type BriefingScheduleViewModel, } from './schedule.js';
-export { briefingAttachmentFormatLabel, briefingAttachmentNeedsExportJob, getBriefingCardAttachmentCapability, getBriefingCardAttachmentFormats, getDefaultBriefingCardAttachmentFormat, isBriefingTableExportCardType, type BriefingCardAttachmentCapability, } from './attachments.js';
+export { briefingAttachmentFileTraits, briefingAttachmentFormatLabel, briefingAttachmentNeedsExportJob, briefingAttachmentProduction, type BriefingAttachmentFileTraits, type BriefingAttachmentProduction, getBriefingCardAttachmentCapability, getBriefingCardAttachmentFormats, getDefaultBriefingCardAttachmentFormat, isBriefingTableExportCardType, type BriefingCardAttachmentCapability, } from './attachments.js';
 export { BRIEFING_ATTACHMENT_OMISSION_CODES, isBriefingAttachmentOmissionCode, readBriefingOmittedAttachments, type BriefingAttachmentOmissionCode, type BriefingOmittedAttachment, } from './attachment-outcomes.js';
 export { canCreateBriefingForUser, type BriefingUiUser } from './capabilities.js';
 export { getBriefingCreationIntents, type BriefingAuthorIntent, } from './creation.js';
@@ -167,8 +166,9 @@ export type BriefingContentDocument = {
     summary?: string;
     blocks: BriefingContentBlock[];
 };
-/** A rendered PDF, or a data file (CSV or Excel) made by an export. */
-export type BriefingAttachmentFormat = 'pdf' | ExportFileFormat;
+/** A rendered PDF or PNG image, or a data file (CSV or Excel, `ExportFileFormat`). */
+export declare const BRIEFING_ATTACHMENT_FORMATS: readonly ["pdf", "png", "csv", "xlsx"];
+export type BriefingAttachmentFormat = (typeof BRIEFING_ATTACHMENT_FORMATS)[number];
 export type BriefingPdfPageSize = 'letter' | 'legal' | 'a4' | 'a3' | 'tabloid';
 export type BriefingPdfOrientation = 'portrait' | 'landscape';
 export type BriefingCsvDelimiter = ',' | ';' | '\t';
@@ -222,7 +222,8 @@ export type BriefingAttachment = (BriefingAttachmentBase & {
     type: 'dashboard_sheet';
     dashboardId: string;
     sheetId: string;
-    format: 'pdf';
+    /** A sheet prints as a PDF or a PNG image of the whole sheet. */
+    format: 'pdf' | 'png';
 }) | (BriefingAttachmentBase & {
     type: 'document_sheet';
     dashboardId: string;

package/dist/types/components/index.d.ts

@@ -35,6 +35,8 @@ export { VisualEditingControls } from './editor/editor-main/visual-editing-contr
 export { AdvancedModeToggle } from './editor/editor-main/advanced-mode-toggle.js';
 export { AssistantProvider } from './assistant/assistant-provider.js';
 export { AssistantPanel, AssistantToolbarButton } from './assistant/assistant-entry-points.js';
+export { ArrangeLayoutButton } from './surfboard/arrange-layout-button.js';
+export { ScreenSizePreviewButton } from './surfboard/screen-size-preview-button.js';
 export type { AssistantPanelSurface } from './assistant/assistant-entry-points.js';
 export { useAssistant } from './assistant/use-assistant.js';
 export * from '../lib/types/common-types.js';

package/dist/types/components/surfboard/arrange-layout-button.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Arrange in the dashboard toolbar (responsive layouts RL-D13): lays the
+ * selected grid sheet out by kind on every screen size, or tidies it in its
+ * current order, with Undo on the toast (RL-INV-7). Shown while editing a
+ * grid sheet. Reads only the dashboard store, so semaphor-app mounts it in
+ * its own toolbar as well as the package's.
+ */
+export declare function ArrangeLayoutButton(): import("react").JSX.Element | null;

package/dist/types/components/surfboard/filter/types.d.ts

@@ -45,13 +45,6 @@ export type FixedDayDefaultDateFilter = {
     date: string;
 };
 export type DefaultDateFilter = RelativeDateFilter | FixedMonthDefaultDateFilter | FixedDayDefaultDateFilter;
-/**
- * Display mode for individual filters
- * - 'canvas': Filter displayed as a draggable card on the dashboard canvas
- * - 'toolbar': Filter displayed in the compact toolbar
- * - 'inherit': Use the dashboard's filterLayout.displayMode setting (default)
- */
-export type FilterDisplayMode = 'canvas' | 'toolbar' | 'inherit';
 export type FilterKind = 'field' | 'global-date';
 /**
  * Target column configuration for multi-field filters.
@@ -133,13 +126,6 @@ export type TFilter = {
      * Defaults vary by filter type (160px for dropdowns, 220px for date ranges, etc.)
      */
     toolbarWidth?: number;
-    /**
-     * Display mode for this filter
-     * - 'canvas': Always show as draggable card on canvas
-     * - 'toolbar': Always show in toolbar
-     * - 'inherit': Use dashboard's filterLayout.displayMode setting (default)
-     */
-    displayMode?: FilterDisplayMode;
 };
 export type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
 type BaseFilter = {

package/dist/types/components/surfboard/screen-size-preview-button.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Preview screen sizes without editing (responsive layouts RL-D19): opens the
+ * sheet's floating size control, look-only, at the size the grid shows now.
+ * The host places it beside the Activity bell for people who can edit the dashboard. Reads
+ * only the dashboard store, so semaphor-app mounts it in its own toolbar too.
+ */
+export declare function ScreenSizePreviewButton(): import("react").JSX.Element | null;

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-CLZocegs.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-DMHTpf7a.js";
-import { D as q } from "../chunks/token-types-DBbZVQsm.js";
-import { B as Q, a as j, p as W, r as J } from "../chunks/bookmark-state-CXw7lZ50.js";
-import { r as H, a as Z } from "../chunks/pivot-result-identity-DJhXXcns.js";
-import { D as ee } from "../chunks/report-runtime-context-Dq8XyODK.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-CunhoDUi.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-C4vetoa0.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";
 const e = [
   "concatenate",
   "conditional-category",

package/dist/types/lib/charts/table-chart-types.d.ts

@@ -0,0 +1,4 @@
+import { TChartType } from './types.js';
+/** The chart types that render as tables. No runtime imports: server-safe code reads these. */
+export declare const TABLE_CHART_TYPES: readonly ["table", "pivotTable", "aggregateTable", "matrixTable", "detailTable"];
+export declare function isTableChartType(chartType: TChartType | string | undefined | null): boolean;

package/dist/types/lib/charts/types.d.ts

@@ -7,6 +7,7 @@ import { SemaphorResultColumn } from '../../shared/analytics-protocol/index.js';
 import { PresentationExecutionSnapshot } from '../../shared/format-utils/index.js';
 import { CartesianTemporalPresentation } from '../formatters/cartesian-temporal-presentation.js';
 import { CartesianFieldRoles } from './cartesian-fields.js';
+import { TABLE_CHART_TYPES, isTableChartType } from './table-chart-types.js';
 export type ChartConfigParams = {
     card: TCard;
     data: any[];
@@ -49,8 +50,7 @@ export type BlurEffectProps = {
     blurColor?: string;
 };
 export type TChartType = 'bar' | 'horizontalBar' | 'line' | 'area' | 'stackedArea' | 'combo' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'matrixTable' | 'detailTable' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
-export declare const TABLE_CHART_TYPES: readonly ["table", "pivotTable", "aggregateTable", "matrixTable", "detailTable"];
-export declare function isTableChartType(chartType: TChartType | string | undefined | null): boolean;
+export { TABLE_CHART_TYPES, isTableChartType };
 export declare function isChartJsVisualType(chartType: TChartType | string | undefined | null): boolean;
 export declare const REGULAR_TABLE_SETTINGS_CHART_TYPES: readonly ["table", "matrixTable", "pivotTable", "aggregateTable", "detailTable"];
 export declare function supportsRegularTableSettings(chartType: TChartType | string | undefined | null): boolean;

package/dist/types/lib/dashboard-inputs/dashboard-filter-mapping-authoring.d.ts

@@ -1,7 +1,12 @@
 import { TFilter } from '../../components/surfboard/filter/types.js';
-import { DashboardInputScope, ReferencedFilterDashboardInput, TDashboard } from '../types/common-types.js';
-import { buildDashboardCardSourceIndex, DashboardFilterCardApplication, DashboardFilterOptionSource, DashboardFilterTarget, DashboardFilterTargetField } from '../../shared/dashboard-authoring/index.js';
-import { DashboardFilterOptionPolicy } from './dashboard-filter-mapping-storage-transition.js';
+import { DashboardInputScope, TCard, TDashboard } from '../types/common-types.js';
+import { DashboardFilterApplication, DashboardFilterCardApplication, DashboardFilterTarget, DashboardFilterTargetField } from '../../shared/dashboard-authoring/index.js';
+import { FilterRef, ReachedCard } from '../../shared/dashboard-authoring/filter-model/index.js';
+/**
+ * Filter mapping (one filter model M3, SPEC 4.4): the Cards tab of any filter
+ * input. `draftDashboardFilterMapping` builds the rows from the cards the
+ * input reaches and, with them, exactly what Accept would save. Pure.
+ */
 export type DashboardFilterMappingCandidateCatalog = {
     status: 'ready';
     targets: DashboardFilterTarget[];
@@ -18,7 +23,13 @@ export type DashboardFilterMappingDraftDecision = {
 export type DashboardFilterMappingDraftStatus = 'pendingSource' | 'automatic' | 'suggested' | 'needsMapping' | 'mapped' | 'notApplicable' | 'excluded' | 'invalidMapping' | 'metadataUnavailable';
 export type DashboardFilterMappingDraftRow = {
     cardId: string;
+    /** The panel reads the title and meta line from it. */
+    card: TCard;
     sheetId: string;
+    sheetKind: 'dashboard' | 'document';
+    sectionId?: string;
+    /** The section's title, for a card in a Document section. */
+    sectionTitle?: string;
     executionKind: 'config' | 'sql' | 'unconfigured';
     status: DashboardFilterMappingDraftStatus;
     candidates: DashboardFilterTarget[];
@@ -28,27 +39,28 @@ export type DashboardFilterMappingDraftRow = {
     guidanceMessage?: string;
     automaticFieldName?: string;
 };
-export type DashboardFilterMappingDraft = {
-    filterId: string;
-    existingInputId?: string;
-    outerScope: Extract<DashboardInputScope, {
-        kind: 'allSheets' | 'sheets';
-    }>;
+export type DashboardFilterMappingGroup = {
+    sheetId: string;
+    sheetTitle: string;
+    sheetKind: 'dashboard' | 'document';
     rows: DashboardFilterMappingDraftRow[];
 };
-export type DashboardFilterMappingAuthoringIssueCode = 'filterNotFound' | 'mappingNotFound' | 'globalDateUnsupported' | 'conflictingDashboardInput' | 'unsupportedOuterScope' | 'unsupportedRuntimeScope' | 'missingDecision' | 'invalidTarget' | 'metadataUnavailable';
-export type DashboardFilterMappingAuthoringIssue = {
-    code: DashboardFilterMappingAuthoringIssueCode;
+export type DashboardFilterMappingIssueCode = 'inputNotFound' | 'globalDateUnsupported' | 'unsupportedOuterScope' | 'unsupportedRuntimeScope' | 'missingDecision' | 'invalidTarget' | 'metadataUnavailable';
+export type DashboardFilterMappingIssue = {
+    code: DashboardFilterMappingIssueCode;
     message: string;
-    filterId: string;
+    ref: FilterRef;
+    /** Set once the ref resolved. */
+    inputId?: string;
     cardId?: string;
 };
-export type DashboardFilterMappingDraftResult = {
+/** What Accept would save, computed with the rows. */
+export type DashboardFilterMappingAcceptance = {
     ok: true;
-    draft: DashboardFilterMappingDraft;
+    application: DashboardFilterApplication;
 } | {
     ok: false;
-    issues: DashboardFilterMappingAuthoringIssue[];
+    issues: DashboardFilterMappingIssue[];
 };
 export type DashboardFilterMappingStatusSummary = {
     coveredCount: number;
@@ -57,65 +69,58 @@ export type DashboardFilterMappingStatusSummary = {
     invalidCount: number;
     attentionCount: number;
 };
-/**
- * One presentation-neutral projection of authoritative Cards-tab rows.
- * Consumers must not independently reinterpret draft statuses when deciding
- * whether an author needs to act.
- */
-export declare function summarizeDashboardFilterMappingRows(rows: DashboardFilterMappingDraftRow[]): DashboardFilterMappingStatusSummary;
-export type DashboardFilterMappingAcceptanceResult = {
-    ok: true;
-    draft: DashboardFilterMappingDraft;
-    input: ReferencedFilterDashboardInput;
-} | {
-    ok: false;
-    draft?: DashboardFilterMappingDraft;
-    issues: DashboardFilterMappingAuthoringIssue[];
-};
-export type DashboardFilterMappingDisableResult = {
-    ok: true;
+export type DashboardFilterMappingDraft = {
     inputId: string;
-} | {
-    ok: false;
-    issues: DashboardFilterMappingAuthoringIssue[];
+    filterId: string;
+    /** The scope the rows were computed with: the staged scope, else the saved one. Accept never changes it (S-5). */
+    scope: Exclude<DashboardInputScope, {
+        kind: 'documentSections';
+    }>;
+    /** The cards the rows were built for; the catalogs hook fetches metadata for exactly these. */
+    cards: readonly ReachedCard[];
+    /** One group per reached tab, in dashboard tab order; rows in `cards` order. */
+    groups: DashboardFilterMappingGroup[];
+    summary: DashboardFilterMappingStatusSummary;
+    acceptance: DashboardFilterMappingAcceptance;
 };
-export type DashboardFilterInputAcceptanceResult = {
+export type DashboardFilterMappingDraftResult = {
     ok: true;
-    input: ReferencedFilterDashboardInput;
-    created: boolean;
+    draft: DashboardFilterMappingDraft;
 } | {
     ok: false;
-    issues: DashboardFilterMappingAuthoringIssue[];
+    issues: DashboardFilterMappingIssue[];
 };
-export type DashboardFilterMappingAuthoringRequest = {
-    filterId: string;
+export type DashboardFilterMappingRequest = {
+    /** The filter. Chips pass `{ inputId }`, a toolbar filter's compatibility id included. */
+    ref: FilterRef;
+    /** The dashboard as saved. */
+    dashboard: TDashboard;
+    /** The definition being edited, if changed. */
+    stagedDefinition?: TFilter;
+    /** The scope being edited, if changed; otherwise the saved scope, unnarrowed (OF-D8). */
+    stagedScope?: DashboardInputScope;
     candidatesByCardId: Record<string, DashboardFilterMappingCandidateCatalog | undefined>;
     /** Grounded field that supplies the current filter value. */
     selectionField?: Pick<DashboardFilterTargetField, 'name' | 'sourceField'> & Partial<Pick<DashboardFilterTargetField, 'source'>>;
     /**
-     * Strictly proven identities eligible for Auto. Physical datasets in a
-     * semantic domain may expose both physical and semantic identities. An
-     * explicit empty array is authoritative and must not fall back to a
-     * candidate-only selectionField source.
+     * Strictly proven identities eligible for Auto. An explicit empty array is
+     * authoritative and must not fall back to a candidate-only selectionField source.
      */
     automaticSelectionSources?: DashboardFilterTargetField['source'][];
     /** Datatype of the raw selection value, which may differ from the label. */
     selectionDataType?: string;
-    /**
-     * Re-check saved targets against selectionField after the author changes
-     * the raw Option Value identity. Explicit draft decisions still win.
-     */
+    /** Re-check saved targets after the option value field changed. */
     revalidatePersistedTargets?: boolean;
     decisionsByCardId?: Record<string, DashboardFilterMappingDraftDecision | undefined>;
-    /** Staged outer sheet scope. Omit when the author did not edit Scope. */
-    outerScope?: DashboardFilterMappingDraft['outerScope'];
-    /** Test seam; production callers use opaque random UUIDs. */
+    /** Test seam for new binding ids; production uses opaque random UUIDs. */
     createId?: () => string;
 };
-export declare function buildDashboardFilterMappingOuterScope(params: {
-    filter: Pick<TFilter, 'sheetId' | 'applyToSheetIds' | 'excludeSheetIds'>;
-    dashboard: Pick<TDashboard, 'sheets'>;
-}): DashboardFilterMappingDraft['outerScope'];
+/**
+ * One presentation-neutral projection of authoritative Cards-tab rows.
+ * Consumers must not independently reinterpret draft statuses when deciding
+ * whether an author needs to act.
+ */
+export declare function summarizeDashboardFilterMappingRows(rows: DashboardFilterMappingDraftRow[]): DashboardFilterMappingStatusSummary;
 /**
  * One Cards row for a source-qualified value field that is not a toolbar
  * filter, such as a field a click carries. It is the same decision chain the
@@ -124,8 +129,11 @@ export declare function buildDashboardFilterMappingOuterScope(params: {
  * authoring surface. Equality is the only operation a click applies.
  */
 export declare function buildDashboardFilterMappingDraftRowForValueField(params: {
-    card: Parameters<typeof buildDashboardCardSourceIndex>[0];
+    card: TCard;
     sheetId: string;
+    sheetKind: 'dashboard' | 'document';
+    sectionId?: string;
+    sectionTitle?: string;
     valueField: DashboardFilterTargetField;
     catalog: DashboardFilterMappingCandidateCatalog | undefined;
     decision?: DashboardFilterMappingDraftDecision;
@@ -133,27 +141,5 @@ export declare function buildDashboardFilterMappingDraftRowForValueField(params:
     /** Bindings already accepted elsewhere for this value field, offered as inherited matches. */
     acceptedTargets?: DashboardFilterTarget[];
 }): DashboardFilterMappingDraftRow;
-/** The reference-backed Input for a dashboard filter, mapped or not. */
-export declare function findReferencedDashboardFilterInput(dashboard: Pick<TDashboard, 'inputs'>, filterId: string): ReferencedFilterDashboardInput | undefined;
-export declare function acceptDashboardFilterInputDraft(params: {
-    dashboard: Pick<TDashboard, 'filters' | 'sheets' | 'inputs'>;
-    updatedFilter: TFilter;
-    optionSource?: DashboardFilterOptionSource;
-    /** Option dependency policy to persist; omitted keeps the existing one. */
-    optionPolicy?: DashboardFilterOptionPolicy;
-    inputMetadata?: {
-        variableName?: string;
-        forceSelection?: boolean;
-    };
-    createId?: () => string;
-}): DashboardFilterInputAcceptanceResult;
-export declare function buildDashboardFilterMappingDraft(params: {
-    dashboard: Pick<TDashboard, 'filters' | 'sheets' | 'inputs'>;
-    request: DashboardFilterMappingAuthoringRequest;
-}): DashboardFilterMappingDraftResult;
-export declare function acceptDashboardFilterMappingDraft(params: {
-    dashboard: Pick<TDashboard, 'filters' | 'sheets' | 'inputs'>;
-    request: DashboardFilterMappingAuthoringRequest;
-    updatedFilter?: TFilter;
-}): DashboardFilterMappingAcceptanceResult;
-export declare function findMappedDashboardFilterInput(dashboard: Pick<TDashboard, 'inputs'>, filterId: string): ReferencedFilterDashboardInput | undefined;
+/** The one entry point of M3 (SPEC 4.4). Pure. */
+export declare function draftDashboardFilterMapping(request: DashboardFilterMappingRequest): DashboardFilterMappingDraftResult;

package/dist/types/lib/dashboard-inputs/dashboard-input-target-context.d.ts

@@ -108,12 +108,4 @@ export declare function createExplicitDashboardInputTargetContext(params: {
     controls?: DashboardInputTargetContext['controls'];
     target?: NormalizedFilterDashboardInput;
 }): DashboardInputTargetContext;
-/**
- * Applicability for option peers. A card-local or section-local target sees
- * exactly what applies to it. A sheet-level target additionally sees the
- * Inputs local to cards or sections on that sheet, the same rule the toolbar
- * uses to decide what a sheet presents, so option narrowing and presentation
- * agree on what "on this sheet" means.
- */
-export declare function doesDashboardInputApplyToTargetScope(input: Pick<NormalizedDashboardInput, 'scope' | 'compatibility'>, scope: DashboardInputTargetScope, sheetLocalCardIds: ReadonlySet<string>): boolean;
 export declare function describeInput(input: Pick<NormalizedDashboardInput, 'id' | 'label'> & Partial<Pick<NormalizedFilterDashboardInput, 'filter'>>): string;

package/dist/types/lib/dashboard-inputs/dashboard-input-values.d.ts

@@ -18,8 +18,27 @@ export declare function setDashboardInputRuntimeSlot(values: DashboardInputValue
  */
 export declare function materializeDashboardInputRuntimeSlot(input: NormalizedDashboardInput, slot: DashboardInputSlot | undefined): DashboardInputSlot | undefined;
 export declare function removeDashboardInputRuntimeSlot(values: DashboardInputValues, input: Pick<DashboardInput, 'id' | 'runtimeScope'>, target: DashboardInputRuntimeTarget): DashboardInputValues;
+/**
+ * Whether a filter input holds an active value on a tab, as its chip shows
+ * it: its slot for the tab, the saved default included. The one rule both
+ * filter bars (the toolbar and a Document's input bar) count and clear by
+ * for Clear all. It reads the slot directly, so a filter scoped to specific
+ * cards on the tab counts although it applies to no tab-level target.
+ */
+export declare function hasActiveFilterInputValueOnTab(params: {
+    dashboard: Pick<TDashboard, 'defaultInputValues' | 'defaultFilterValues'>;
+    input: NormalizedDashboardInput;
+    runtimeValues?: DashboardInputValues;
+    sheetId: string | null | undefined;
+    calendar: CalendarContext | null;
+}): boolean;
 export declare function hydrateAuthoredDashboardInputSlot(params: {
-    dashboard: Pick<TDashboard, 'defaultInputValues'>;
+    /**
+     * Saved defaults come from the filter model (SPEC 5.2), so a toolbar
+     * filter's `defaultFilterValues` entry counts. A caller with only stored
+     * slot defaults may pass just those.
+     */
+    dashboard: Pick<TDashboard, 'defaultInputValues' | 'defaultFilterValues'>;
     input: NormalizedDashboardInput;
     runtimeValues?: DashboardInputValues;
     target: DashboardInputRuntimeTarget;
@@ -46,3 +65,24 @@ export declare function createFilterDashboardInputSlot(filterValue: TFilterValue
 export declare function createControlDashboardInputSlot(value: unknown): DashboardInputSlot | undefined;
 export declare function cloneDashboardInputValues(values: DashboardInputValues | undefined): DashboardInputValues;
 export declare function compactDashboardInputValues(values: DashboardInputValues): DashboardInputValues;
+/**
+ * `over`'s slots win; a slot it does not have keeps `base`'s. A slot of `over`
+ * that holds only a comparison choice keeps `base`'s value under it, as the
+ * old filter value list and the comparison slot stayed apart. `base` itself
+ * when `over` is empty.
+ */
+export declare function overlayDashboardInputValues(base: DashboardInputValues, over: DashboardInputValues): DashboardInputValues;
+/** The values without any slot of these inputs, on every target. `values` itself when none is held. */
+export declare function removeDashboardInputSlotsById(values: DashboardInputValues, inputIds: ReadonlySet<string>): DashboardInputValues;
+/**
+ * The saved defaults the runtime reads (SPEC 5.2): the filter model's, which
+ * hold owned `defaultFilterValues` entries as slots. With no such entry they
+ * are the stored slots, read without building the model.
+ */
+export declare function savedDefaultInputValues(dashboard: Pick<TDashboard, 'defaultInputValues' | 'defaultFilterValues'>): DashboardInputValues | undefined;
+/**
+ * Every value an input holds, saved or live, removed: its shared slot and its
+ * slot on every sheet, card and Document section. Shared by the store's
+ * input removal and the dashboard reducer's `filter.remove`.
+ */
+export declare function removeDashboardInputFromValues(values: DashboardInputValues | undefined, inputId: string): DashboardInputValues;