react-semaphor 0.1.506 → 0.1.508

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-DSa6RSdg.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-7Vsc_fsG.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../chunks/index-BaIrLSBb.cjs"),r=require("../chunks/common-types-nBuCd3u2.cjs"),o=require("../chunks/report-preferences-dialog-C9rpWgQZ.cjs");exports.DisplayFormatPreferencesFields=e.DisplayFormatPreferencesFields;exports.Surfboard=e.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=r.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=r.EMPTY_SELECTION;exports.ReportPreferencesDialog=o.ReportPreferencesDialog;

package/dist/surfboard/index.js

@@ -1,6 +1,6 @@
-import { b as a, a as o } from "../chunks/index-De2QNsqV.js";
+import { b as a, a as o } from "../chunks/index-ByiS9sB4.js";
 import { C as f, E } from "../chunks/common-types-C6cAQgyh.js";
-import { R as t } from "../chunks/report-preferences-dialog-xADifRXs.js";
+import { R as t } from "../chunks/report-preferences-dialog-BbkXcnnn.js";
 export {
   f as CONTROL_CARD_DEFAULT_VALUE,
   a as DisplayFormatPreferencesFields,

package/dist/types/brand-studio/brand-studio-draft.d.ts

@@ -42,7 +42,7 @@ type RequiredTableAppearance = {
     density: AppearanceDensity;
     container: NonNullable<AppearanceTable['container']>;
     header: Required<NonNullable<AppearanceTable['header']>>;
-    row: Required<NonNullable<AppearanceTable['row']>>;
+    row: Required<Omit<NonNullable<AppearanceTable['row']>, 'selectedBackground'>>;
     cell: Required<NonNullable<AppearanceTable['cell']>>;
     subtotal: Required<NonNullable<AppearanceTable['subtotal']>>;
     grandTotal: Required<NonNullable<AppearanceTable['grandTotal']>>;
@@ -67,6 +67,8 @@ type PresetScheme = {
     primaryForeground: string;
     accent: string;
     accentForeground: string;
+    /** What a viewer selected to filter by. A colored preset uses its primary. */
+    selection: string;
     card: string;
     cardForeground: string;
     chartPalette: string[];

package/dist/types/components/dashboard/card-selection-pill.d.ts

@@ -0,0 +1,5 @@
+import { TCard } from '../../lib/types/common-types.js';
+/** On the source card while it holds a selection: what the click is doing, and a way out. */
+export declare function CardSelectionPill({ card }: {
+    card: TCard;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/dashboard/dashboard-container.d.ts

@@ -5,5 +5,5 @@ type ContainerProps = DashboardProps & HTMLAttributes<HTMLDivElement> & {
     cardId?: string;
     dashboardId?: string;
 };
-export declare function Container({ className, customStyle, onSave, onEvent, onDashboardLifecycleEvent, LoadingComponent, ErrorComponent, onChartElementClicked, id, authToken, currentTheme, appearance: _appearance, version, customCards, showAssistant, defaultFilterValues, defaultControlValues, controlContractOverrides, documentInputValues: _documentInputValues, dashboardInputExecutionSnapshot, interactionExecutionSnapshot, presentationExecutionSnapshot, renderMode: _renderMode, onFilterValuesChange, selectedSheetId, eventHandlers, type, cardId, dashboardId, style, ...props }: ContainerProps): import("react/jsx-runtime").JSX.Element;
+export declare function Container({ className, customStyle, onSave, onEvent, onDashboardLifecycleEvent, LoadingComponent, ErrorComponent, onChartElementClicked, id, authToken, currentTheme, appearance: _appearance, version, customCards, showAssistant, defaultFilterValues, defaultControlValues, controlContractOverrides, documentInputValues: _documentInputValues, dashboardInputExecutionSnapshot, presentationExecutionSnapshot, renderMode: _renderMode, onFilterValuesChange, selectedSheetId, eventHandlers, type, cardId, dashboardId, style, ...props }: ContainerProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/dashboard/drill-breadcrumb.d.ts

@@ -2,5 +2,6 @@ interface DrillBreadcrumbProps {
     cardId: string;
     className?: string;
 }
+/** The card's drill path, from card view state. Each crumb drills back up to its level. */
 export declare function DrillBreadcrumb({ cardId, className }: DrillBreadcrumbProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/types/components/dashboard/drill-navigation-controls.d.ts

@@ -4,10 +4,10 @@
  * Floating UI controls for drill-through navigation.
  * Displays:
  * - Back button to return to previous dashboard
- * - Drill context badges showing active filters
- * - Clear button to remove drill context
+ * - Badges showing the click the viewer drilled through on
+ * - Clear button to remove the carried context
  *
- * Only visible when drill context exists (user has drilled through).
+ * Only visible on a dashboard the viewer drilled through to.
  * Draggable to allow repositioning if blocking view.
  */
 export declare function DrillNavigationControls(): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/interactions/applied-filters-display.d.ts

@@ -1,6 +1,11 @@
 import { ClickFilterCondition } from '../../lib/types/interaction-types.js';
 import { TFilterValue, TFilter } from '../surfboard/filter/types.js';
+import { CarriedContextItem } from '../../lib/dashboard-navigation/describe-carried-context.js';
 interface AppliedFiltersDisplayProps {
+    /**
+     * Already described lines, for a carried context. Used instead of `filters`.
+     */
+    items?: CarriedContextItem[];
     /**
      * Filters applied to the insight
      * Can be either ClickFilterCondition (interaction filters) or TFilterValue (dashboard filters)
@@ -31,5 +36,5 @@ interface AppliedFiltersDisplayProps {
      */
     icon?: React.ReactNode;
 }
-export declare function AppliedFiltersDisplay({ filters, filterDefinitions, contextMode, className, showLabel, labelText, icon, }: AppliedFiltersDisplayProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function AppliedFiltersDisplay({ items, filters, filterDefinitions, contextMode, className, showLabel, labelText, icon, }: AppliedFiltersDisplayProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/types/components/interactions/click-to-filter-review-dialog.d.ts

@@ -0,0 +1,21 @@
+import { DashboardFilterMappingFieldLabels } from '../../lib/dashboard-inputs/dashboard-filter-mapping-candidate-metadata.js';
+import { ClickToFilterMappingDraft } from '../../lib/dashboard-inputs/click-to-filter-mapping-draft.js';
+import { ClickToFilterSettings, NormalizedFilterDashboardInput } from '../../lib/types/common-types.js';
+/**
+ * Which cards a click reaches and which field each clicked field lands on.
+ * Rows are the toolbar filter's `MappingRow`, so the field picker, search,
+ * grouping by source and field labels are the same components. Done applies
+ * the draft to the panel's settings; the popover's Save persists them.
+ */
+export declare function ClickToFilterReviewDialog({ open, onOpenChange, sourceTitle, draft, settings, onSettingsChange, fieldLabels, filterInputs, isLoading, onRetry, }: {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    sourceTitle: string;
+    draft: ClickToFilterMappingDraft | undefined;
+    settings: ClickToFilterSettings;
+    onSettingsChange: (settings: ClickToFilterSettings) => void;
+    fieldLabels?: DashboardFilterMappingFieldLabels;
+    filterInputs: NormalizedFilterDashboardInput[];
+    isLoading: boolean;
+    onRetry: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/dashboard-drill-host.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DashboardDrillHost Component
+ *
+ * A logic-only observer mounted once at the dashboard root. It owns the two
+ * side effects a drill has outside its card:
+ *
+ * - Drill through. A pending drill-through waits here for its destination to
+ *   load, then becomes a navigation entry. This is also the one place where
+ *   dashboard selection follows `navigationTarget`, forward and back.
+ * - Drill to insight in a modal. The open request lives in the dashboard
+ *   store; this renders it.
+ */
+export declare function DashboardDrillHost(): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/filter-badge-tooltip.d.ts

@@ -1,13 +1,13 @@
-import { ClickFilterCondition } from '../../lib/types/interaction-types.js';
+import { CarriedContextItem } from '../../lib/dashboard-navigation/describe-carried-context.js';
 interface FilterBadgeTooltipProps {
     /**
-     * Filters applied to the insight
+     * What the insight was opened with: the click and any carried filters
      */
-    filters?: ClickFilterCondition[];
+    items?: CarriedContextItem[];
     /**
      * Context mode indicating how filters were passed
      */
     contextMode?: 'filters' | 'full' | 'none' | 'interactionFilters';
 }
-export declare function FilterBadgeTooltip({ filters, contextMode, }: FilterBadgeTooltipProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function FilterBadgeTooltip({ items: filters, contextMode, }: FilterBadgeTooltipProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/types/components/interactions/insight-modal.d.ts

@@ -1,5 +1,4 @@
-import { ClickFilterCondition } from '../../lib/types/interaction-types.js';
-import { TFilter, TFilterValue } from '../surfboard/filter/types.js';
+import { TransientInputContext } from '../../lib/dashboard-inputs/transient-input-context.js';
 interface InsightModalProps {
     /**
      * Whether the modal is open
@@ -14,18 +13,9 @@ interface InsightModalProps {
      */
     insightId: string;
     /**
-     * Filters to apply to the insight
-     * Can be either ClickFilterCondition (interaction filters) or TFilterValue (dashboard filters)
+     * The insight request's runtime; absent while no insight is open
      */
-    filters?: (ClickFilterCondition | TFilterValue)[];
-    /**
-     * Filter definitions for looking up titles
-     */
-    filterDefinitions?: TFilter[];
-    /**
-     * How context was passed to the insight
-     */
-    contextMode?: 'interactionFilters' | 'full' | 'none';
+    runtime?: TransientInputContext;
     /**
      * Title of the insight card (displayed in modal header)
      */
@@ -35,5 +25,5 @@ interface InsightModalProps {
      */
     cardDescription?: string;
 }
-export declare function InsightModal({ open, onOpenChange, insightId, filters, filterDefinitions, contextMode, cardTitle, cardDescription, }: InsightModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function InsightModal({ open, onOpenChange, insightId, runtime, cardTitle, cardDescription, }: InsightModalProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/interactions/insight-viewer.d.ts

@@ -1,28 +1,16 @@
-/**
- * InsightViewer Component
- *
- * Renders a saved insight/visual by ID.
- * Used in both modal and replace-card display modes.
- *
- * Features:
- * - Fetches visual data by ID
- * - Extracts and renders the card from the frame
- * - Applies context filters based on contextMode
- * - Loading and error states
- */
+import { TransientInputContext } from '../../lib/dashboard-inputs/transient-input-context.js';
 interface InsightViewerProps {
     /**
      * ID of the insight/visual to display
      */
     insightId: string;
     /**
-     * Filters to apply to the insight
+     * The insight request's runtime: the click it was opened with, and under
+     * `full` what the dashboard itself had received. It is the only carried
+     * context the insight's card resolves under, and its context mode decides
+     * whether the dashboard's own toolbar filters apply.
      */
-    filters?: any[];
-    /**
-     * How context was passed to the insight
-     */
-    contextMode?: 'interactionFilters' | 'full' | 'none';
+    runtime: TransientInputContext;
 }
-export declare function InsightViewer({ insightId, filters, contextMode, }: InsightViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare function InsightViewer({ insightId, runtime }: InsightViewerProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/components/interactions/interactions-sheet.d.ts

@@ -0,0 +1,6 @@
+/**
+ * What a click on a card does, authored in one side sheet: the filter, every
+ * drill action, and whether the card listens to the others. Everything edits a
+ * local draft that Save writes at once.
+ */
+export declare function InteractionsSheet(): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/interactions/panels/click-to-filter-panel.d.ts

@@ -0,0 +1,20 @@
+import { ClickToFilterDimension } from '../../../lib/dashboard-inputs/click-to-filter-emitted-fields.js';
+import { ClickToFilterMappingDraft } from '../../../lib/dashboard-inputs/click-to-filter-mapping-draft.js';
+import { ClickToFilterSettings, TCard } from '../../../lib/types/common-types.js';
+/**
+ * Everything about click to filter, one step in from the sheet's list: the
+ * switch, what a click carries, which cards it reaches, and multiple
+ * selection. It edits a draft; the sheet saves it with everything else.
+ */
+export declare function ClickToFilterPanel({ card, settings, onSettingsChange, dimensions, draft, isLoadingDraft, onReviewCards, isLinked, }: {
+    card: Pick<TCard, 'type' | 'title'>;
+    settings: ClickToFilterSettings;
+    onSettingsChange: (settings: ClickToFilterSettings) => void;
+    /** The card's groundable dimension fields, for the chosen-columns checklist. */
+    dimensions: ClickToFilterDimension[];
+    draft: ClickToFilterMappingDraft | undefined;
+    isLoadingDraft: boolean;
+    onReviewCards: () => void;
+    /** A linked library visual: behavior saves to the library, card targeting to this dashboard. */
+    isLinked?: boolean;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/reusable/interaction-selection-popover.d.ts

@@ -8,7 +8,7 @@ import { TCard } from '../../../lib/types/index.js';
  *
  * Features:
  * - Shows interaction label, icon, and target information
- * - Positioned at click location (from anchorPosition)
+ * - Positioned at the supplied click coordinates
  * - Displays selected element context
  * - Handles interaction selection and event application
  *
@@ -95,7 +95,7 @@ interface InteractionSelectionPopoverProps {
      */
     drillHierarchies?: DrillHierarchy[];
     /**
-     * Card ID for accessing current drill depth from interaction store
+     * Card ID for reading the current drill depth from card view state
      */
     cardId?: string;
     /**

package/dist/types/components/interactions/sheet/action-editor.d.ts

@@ -0,0 +1,17 @@
+import { DrillHierarchy, Interaction } from '../../../lib/types/interaction-types.js';
+import { Field } from '../../../lib/types/explorer-types.js';
+import { TCard } from '../../../lib/types/common-types.js';
+/** One action, one step in from the list. Edits the sheet's draft in place. */
+export declare function ActionEditor({ interaction, isNew, metrics, attributes, availableFields, card, onUpdateHierarchies, onUpdate, onRemove, onDone, }: {
+    interaction: Interaction;
+    /** Added in this visit and not yet confirmed with Done. */
+    isNew: boolean;
+    metrics: Field[];
+    attributes: Field[];
+    availableFields: Field[];
+    card: TCard;
+    onUpdateHierarchies: (hierarchies: DrillHierarchy[]) => void;
+    onUpdate: (interaction: Interaction) => void;
+    onRemove: () => void;
+    onDone: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/sheet/action-meta.d.ts

@@ -0,0 +1,45 @@
+import { DrillThroughInteraction, DrillToDetailInteraction, Interaction, InteractionTrigger } from '../../../lib/types/interaction-types.js';
+import { Field } from '../../../lib/types/explorer-types.js';
+import { TCard } from '../../../lib/types/common-types.js';
+export declare const TABLE_TYPES: ReadonlyArray<TCard['type']>;
+/** What a viewer clicks on this kind of card, with its article: "a row", "a mark". */
+export declare function clickUnit(type: TCard['type']): string;
+/** "Applies to 1 of 2 cards on this sheet". A click reaches its own sheet only. */
+export declare function reachSentence(draft: {
+    cards: readonly unknown[];
+    counts: {
+        covered: number;
+        toReview: number;
+    };
+}): string;
+/** The actions an author can add. Click to filter is a card setting, not one of these. */
+export type ActionMode = 'drillDown' | 'dynamicDrill' | 'drillThrough' | 'drillToDetail' | 'drillToURL';
+export declare const ACTION_META: Record<ActionMode, {
+    name: string;
+    line: string;
+    term: string;
+    group: 'stay' | 'go';
+}>;
+export declare const ACTION_GROUPS: Array<{
+    id: 'stay' | 'go';
+    title: string;
+}>;
+/** A matrix offers drills from its context menu, which only opens an insight. */
+export declare function allowedActionModes(cardType: TCard['type']): ActionMode[];
+export declare function isActionMode(mode: Interaction['mode']): mode is ActionMode;
+/**
+ * The field a new action listens on. A metric carries every dimension of the
+ * clicked value, which suits going somewhere; an in-place drill follows one
+ * dimension.
+ */
+export declare function defaultTrigger(mode: ActionMode, metrics: Field[], attributes: Field[]): InteractionTrigger | undefined;
+export declare function createAction(mode: ActionMode, id: string, trigger: InteractionTrigger | undefined): Interaction & {
+    id: string;
+};
+/** What the author still has to fill in, or undefined when the action can run. */
+export declare function actionGap(interaction: Interaction): string | undefined;
+/** The name a viewer sees in the menu, which is also the row title here. */
+export declare function actionTitle(interaction: Interaction): string;
+/** Drill-through and insight default differently at runtime (`run-one-off-drill.ts`). */
+export declare function effectiveContextMode(interaction: DrillThroughInteraction | DrillToDetailInteraction): 'interactionFilters' | 'full' | 'none';
+export declare function actionSummary(interaction: Interaction, card: Pick<TCard, 'interactionConfig'>): string;

package/dist/types/components/interactions/sheet/action-picker.d.ts

@@ -0,0 +1,7 @@
+import { ActionMode } from './action-meta.js';
+/** Pick what the click should do first; the editor asks for the rest. */
+export declare function ActionPicker({ allowedModes, onPick, onBack, }: {
+    allowedModes: ActionMode[];
+    onPick: (mode: ActionMode) => void;
+    onBack: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/sheet/click-outcome-preview.d.ts

@@ -0,0 +1,10 @@
+import { ClickOutcome } from '../../../lib/interactions/click-outcome.js';
+/**
+ * The sentence the sheet exists to answer: what does a click on this card do.
+ * It reads the draft, so it changes as the author edits.
+ */
+export declare function ClickOutcomePreview({ outcome, clickUnit, }: {
+    outcome: ClickOutcome;
+    /** "a row", "a mark", … */
+    clickUnit: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/sheet/interactions-home.d.ts

@@ -0,0 +1,28 @@
+import { ClickOutcome } from '../../../lib/interactions/click-outcome.js';
+import { ClickToFilterMappingDraft } from '../../../lib/dashboard-inputs/click-to-filter-mapping-draft.js';
+import { Interaction } from '../../../lib/types/interaction-types.js';
+import { TCard } from '../../../lib/types/common-types.js';
+/**
+ * The sheet's first view. One question at the top, then the two things an
+ * author decides: what a click on this card does, and whether the card listens
+ * to clicks on the others.
+ */
+export declare function InteractionsHome({ card, clickUnit, outcome, canFilter, filterEnabled, onFilterEnabledChange, hasFullFilterAuthoring, draft, isLoadingDraft, interactions, canAddAction, onOpenFilter, onOpenAction, onAddAction, respondsToSelections, onRespondsToSelectionsChange, }: {
+    card: Pick<TCard, 'interactionConfig'>;
+    clickUnit: string;
+    outcome: ClickOutcome;
+    /** False when the card has no field a click can filter by. */
+    canFilter: boolean;
+    filterEnabled: boolean;
+    onFilterEnabledChange: (enabled: boolean) => void;
+    hasFullFilterAuthoring: boolean;
+    draft: ClickToFilterMappingDraft | undefined;
+    isLoadingDraft: boolean;
+    interactions: Interaction[];
+    canAddAction: boolean;
+    onOpenFilter: () => void;
+    onOpenAction: (index: number) => void;
+    onAddAction: () => void;
+    respondsToSelections: boolean;
+    onRespondsToSelectionsChange: (responds: boolean) => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/interactions/sheet/sheet-parts.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+/** Caption above a group (design/TOKENS.md `text-caption`). */
+export declare const SECTION_LABEL_CLASS = "text-[10px] font-medium uppercase tracking-[0.08em] text-muted-foreground";
+/**
+ * A box as tall as a row's title line. Icons, switches and chevrons sit in one
+ * so they center on the title, not between the title and the hint under it.
+ */
+export declare function TitleLine({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare const ROW_TITLE_CLASS = "text-[13px] font-medium leading-[18px] text-foreground";
+export declare const ROW_HINT_CLASS = "mt-0.5 text-[12px] leading-[1.45] text-muted-foreground";
+/** One setting with its switch on the right. Every switch in the sheet uses this. */
+export declare function SwitchRow({ title, hint, checked, onCheckedChange, disabled, className, }: {
+    title: string;
+    hint?: ReactNode;
+    checked: boolean;
+    onCheckedChange: (checked: boolean) => void;
+    disabled?: boolean;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** Header of a view one step in: a way back, and where you are. */
+export declare function SubHeader({ title, onBack }: {
+    title: string;
+    onBack: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+/** A short list of exclusive choices, each with a line of explanation. */
+export declare function RadioCards<T extends string>({ label, value, onChange, options, }: {
+    label: string;
+    value: T;
+    onChange: (value: T) => void;
+    options: ReadonlyArray<{
+        value: T;
+        title: string;
+        line: string;
+    }>;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/surfboard/filter/dashboard-filter-mapping-panel.d.ts

@@ -1,6 +1,33 @@
 import { TDashboard } from '../../../lib/types/common-types.js';
-import { DashboardFilterMappingDraftDecision, DashboardFilterMappingDraftResult } from '../../../lib/dashboard-inputs/dashboard-filter-mapping-authoring.js';
+import { DashboardFilterMappingDraftDecision, DashboardFilterMappingDraftResult, DashboardFilterMappingDraftRow } from '../../../lib/dashboard-inputs/dashboard-filter-mapping-authoring.js';
+import { DashboardFilterTarget } from '../../../shared/dashboard-authoring/index.js';
 import { DashboardFilterMappingFieldLabels } from '../../../lib/dashboard-inputs/dashboard-filter-mapping-candidate-metadata.js';
+import * as React from 'react';
+/** Searchable candidate menu: search input past the dense threshold, fields
+ * grouped by source with counts, "Don't apply this filter" pinned at the
+ * bottom. No ranked or suggested section — suggestion happens once, at the
+ * binding level; the menu stays a plain list. */
+export declare function CandidateMenuContent({ row, fieldLabels, onPickTarget, onExclude, excludeLabel, }: {
+    /** What choosing "don't apply" means on the calling surface. */
+    excludeLabel?: string;
+    row: DashboardFilterMappingDraftRow;
+    fieldLabels?: DashboardFilterMappingFieldLabels;
+    onPickTarget: (target: DashboardFilterTarget) => void;
+    onExclude: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function MappingRow({ mode, row, cardTitle, cardMeta, fieldLabels, onDecision, onRetry, excludeLabel, trailing, }: {
+    /** Passed to the field menu; defaults to the toolbar filter's wording. */
+    excludeLabel?: string;
+    /** An extra control after the field picker, such as a one-click Accept. */
+    trailing?: React.ReactNode;
+    mode: 'popover' | 'table';
+    row: DashboardFilterMappingDraftRow;
+    cardTitle: string;
+    cardMeta?: string;
+    fieldLabels?: DashboardFilterMappingFieldLabels;
+    onDecision: (decision: DashboardFilterMappingDraftDecision) => void;
+    onRetry: () => void;
+}): import("react/jsx-runtime").JSX.Element;
 export declare function DashboardFilterMappingPanel({ dashboard, filterTitle, isLoading, draftResult, fieldLabels, onDecision, onRetry, }: {
     dashboard: Pick<TDashboard, 'sheets'>;
     filterTitle?: string;

package/dist/types/components/surfboard/filter/selection-chip.d.ts

@@ -0,0 +1,11 @@
+import { SelectionTuple } from '../../../shared/analytics-protocol/selection-contract.js';
+/**
+ * One source card's click selection in the filter bar. The chip is the record
+ * of the click: it names what was clicked and where, and removes it.
+ */
+export declare function SelectionChip({ tuples, sourceTitle, targetCount, onRemove, }: {
+    tuples: SelectionTuple[];
+    sourceTitle: string;
+    targetCount: number;
+    onRemove: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/types/components/surfboard/filter/selection-filter-section.d.ts

@@ -0,0 +1,4 @@
+/** Selections that narrow this card, per source card, with what applied and what was dropped. */
+export default function SelectionFilterSection({ cardId }: {
+    cardId?: string;
+}): import("react/jsx-runtime").JSX.Element | null;

package/dist/types/components/surfboard/filter/use-dashboard-filter-mapping-popover.d.ts

@@ -36,6 +36,9 @@ export declare function useDashboardFilterMappingPopover(params: {
         filters: TFilter[];
         id: string;
         title?: string;
+        interactionDefaults?: {
+            clickToFilter: "on" | "off";
+        };
         aiContext?: import('../../../lib/types/assistant-types.js').DashboardAIContext;
         summary?: {
             enabled?: boolean;

package/dist/types/components/ui/resizable.d.ts

@@ -1,6 +1,6 @@
 import * as ResizablePrimitive from "react-resizable-panels";
 declare const ResizablePanelGroup: ({ className, ...props }: React.ComponentProps<typeof ResizablePrimitive.PanelGroup>) => import("react/jsx-runtime").JSX.Element;
-declare const ResizablePanel: import('react').ForwardRefExoticComponent<Omit<import('react').HTMLAttributes<HTMLElement | HTMLObjectElement | HTMLMapElement | HTMLLabelElement | HTMLSourceElement | HTMLInputElement | HTMLTimeElement | HTMLTableElement | HTMLBodyElement | HTMLStyleElement | HTMLTitleElement | HTMLAreaElement | HTMLLinkElement | HTMLProgressElement | HTMLHRElement | HTMLOutputElement | HTMLAnchorElement | HTMLDataElement | HTMLBaseElement | HTMLCanvasElement | HTMLSlotElement | HTMLAudioElement | HTMLQuoteElement | HTMLBRElement | HTMLButtonElement | HTMLTableCaptionElement | HTMLTableColElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDivElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHeadElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMenuElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLParagraphElement | HTMLPictureElement | HTMLPreElement | HTMLScriptElement | HTMLSelectElement | HTMLSpanElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement>, "id" | "onResize"> & {
+declare const ResizablePanel: import('react').ForwardRefExoticComponent<Omit<import('react').HTMLAttributes<HTMLElement | HTMLObjectElement | HTMLMapElement | HTMLLabelElement | HTMLSourceElement | HTMLInputElement | HTMLTimeElement | HTMLTableElement | HTMLBodyElement | HTMLStyleElement | HTMLTitleElement | HTMLAreaElement | HTMLOutputElement | HTMLLinkElement | HTMLProgressElement | HTMLHRElement | HTMLAnchorElement | HTMLDataElement | HTMLBaseElement | HTMLCanvasElement | HTMLAudioElement | HTMLQuoteElement | HTMLBRElement | HTMLButtonElement | HTMLTableCaptionElement | HTMLTableColElement | HTMLDataListElement | HTMLModElement | HTMLDetailsElement | HTMLDialogElement | HTMLDivElement | HTMLDListElement | HTMLEmbedElement | HTMLFieldSetElement | HTMLFormElement | HTMLHeadingElement | HTMLHeadElement | HTMLHtmlElement | HTMLIFrameElement | HTMLImageElement | HTMLLegendElement | HTMLLIElement | HTMLMenuElement | HTMLMetaElement | HTMLMeterElement | HTMLOListElement | HTMLOptGroupElement | HTMLOptionElement | HTMLParagraphElement | HTMLPictureElement | HTMLPreElement | HTMLScriptElement | HTMLSelectElement | HTMLSlotElement | HTMLSpanElement | HTMLTableSectionElement | HTMLTableCellElement | HTMLTemplateElement | HTMLTextAreaElement | HTMLTableRowElement | HTMLTrackElement | HTMLUListElement | HTMLVideoElement>, "id" | "onResize"> & {
     className?: string | undefined;
     collapsedSize?: number | undefined;
     collapsible?: boolean | undefined;

package/dist/types/components/visual/matrix-table/matrix-interaction-actions.d.ts

@@ -1,10 +1,22 @@
 import { MatrixInteractionInput, MatrixInteraction } from '../../../lib/interactions/get-click-context-from-matrix.js';
+export type MatrixSelectionSource = 'rowMembers' | 'columnMembers' | 'cells';
 export type MatrixInteractionHost = Pick<MatrixInteractionInput, 'resolveField' | 'capabilities'> & {
     canDispatch?: (mode: 'clickFilter' | 'drillToDetail', context: NonNullable<MatrixInteraction['context']>) => boolean;
     filter: (context: NonNullable<MatrixInteraction['context']>) => void;
+    /**
+     * A direct click on a member or a cell. The host decides whether that part
+     * of the grid starts a selection and which gesture the pointer asked for.
+     */
+    select?: (context: NonNullable<MatrixInteraction['context']>, source: MatrixSelectionSource, event: Pick<React.MouseEvent, 'shiftKey' | 'metaKey' | 'ctrlKey' | 'nativeEvent'>) => void;
+    /**
+     * Whether this part of the grid is in the card's filter selection, so the
+     * viewer can mark it. Absent when the card has nothing selected, which lets
+     * the viewer skip the question for every member and cell.
+     */
+    isSelected?: (context: NonNullable<MatrixInteraction['context']>) => boolean;
     drill: (context: NonNullable<MatrixInteraction['context']>, measure: NonNullable<MatrixInteraction['measure']>) => void;
 };
-/** The host adapts callbacks to the existing event engine; no query or permission owner here. */
+/** The host adapts Matrix gestures to selection and drill callbacks; it owns no query or permission policy. */
 export declare function MatrixInteractionActions({ input, host, menu, }: {
     input: Omit<MatrixInteractionInput, 'resolveField' | 'capabilities'>;
     host?: MatrixInteractionHost;

package/dist/types/components/visual/matrix-table/matrix-selection-click.d.ts

@@ -0,0 +1,6 @@
+import { MatrixInteractionInput } from '../../../lib/interactions/get-click-context-from-matrix.js';
+import { MatrixInteractionHost, MatrixSelectionSource } from './matrix-interaction-actions.js';
+/** Turns a direct click into the host's selection gesture when the clicked paths can filter. */
+export declare function selectFromMatrixClick(host: MatrixInteractionHost | undefined, input: Omit<MatrixInteractionInput, 'resolveField' | 'capabilities'>, source: MatrixSelectionSource, event: Parameters<NonNullable<MatrixInteractionHost['select']>>[2]): void;
+/** Whether this member or cell is in the card's filter selection. */
+export declare function isMatrixClickSelected(host: MatrixInteractionHost | undefined, input: Omit<MatrixInteractionInput, 'resolveField' | 'capabilities'>): boolean;

package/dist/types/data-app-sdk/adapters.d.ts

@@ -1,5 +1,5 @@
-import { SemaphorAnalyticsIntent, SemaphorFieldRef, SemaphorInputBinding, SemaphorInputOperator, SemaphorMatrixIntent, SemaphorMetricIntent, SemaphorRecordsIntent, SemaphorSqlIntent } from '../shared/analytics-protocol/index.js';
-import { SemaphorInputOptionsQuerySpec, SemaphorInputReference, SemaphorActiveInput, SemaphorInputSpec, SemaphorInputValue, SemaphorAnalysisQueryOptions, SemaphorAnalysisQuerySpec, SemaphorControlRole, SemaphorMatrixQuerySpec, SemaphorMetricQuerySpec, SemaphorOptionValue, SemaphorRecordsQuerySpec, SemaphorSqlQuerySpec } from './contracts.js';
+import { AnalyticsSelection, SemaphorAnalyticsIntent, SemaphorFieldRef, SemaphorInputBinding, SemaphorInputOperator, SemaphorMatrixIntent, SemaphorMetricIntent, SemaphorRecordsIntent, SemaphorSqlIntent } from '../shared/analytics-protocol/index.js';
+import { SemaphorInputOptionsQuerySpec, SemaphorInputReference, SemaphorActiveInput, SemaphorInputSpec, SemaphorInputValue, SemaphorAnalysisQueryOptions, SemaphorAnalysisQuerySpec, SemaphorControlRole, SemaphorMatrixQuerySpec, SemaphorMetricQuerySpec, SemaphorOptionValue, SemaphorRecordsQuerySpec, SemaphorSelectionReference, SemaphorSqlQuerySpec } from './contracts.js';
 export declare function toSemaphorMetricIntent(spec: SemaphorMetricQuerySpec): SemaphorMetricIntent;
 export declare function toSemaphorAnalysisIntent(spec: SemaphorAnalysisQuerySpec): SemaphorMetricIntent;
 export declare function toSemaphorAnalysisQueryOptions(spec: SemaphorAnalysisQuerySpec): SemaphorAnalysisQueryOptions;
@@ -13,6 +13,7 @@ export declare function toSemaphorInputBinding(input: SemaphorInputReference): S
 export declare function toSemaphorInputBindings(inputs: SemaphorInputReference[] | undefined): SemaphorInputBinding[] | undefined;
 export declare function toSemaphorInputSnapshots(inputs: SemaphorInputReference[] | undefined): SemaphorActiveInput[];
 export declare function toSemaphorActiveInputSnapshots(inputs: SemaphorInputReference[] | undefined): SemaphorActiveInput[];
+export declare function toSemaphorSelectionSnapshots(selections: SemaphorSelectionReference[] | undefined): AnalyticsSelection[];
 export declare function toSemaphorInputSpec<TValue extends SemaphorInputValue = SemaphorInputValue>(spec: SemaphorInputSpec<TValue>): SemaphorInputBinding & {
     kind: SemaphorInputSpec['kind'];
     label?: string;

package/dist/types/data-app-sdk/builders.d.ts

@@ -1,4 +1,4 @@
-import { SemaphorAnalysisQueryDefinition, SemaphorAnalysisQuerySpec, SemaphorControlInputSpec, SemaphorControlRole, SemaphorDataAppDefinition, SemaphorDerivedFieldDefinition, SemaphorFilterInputSpec, SemaphorInputOptionsQueryDefinition, SemaphorInputOptionsQuerySpec, SemaphorInputBinding, SemaphorInputBindingReference, SemaphorInputReference, SemaphorInputSpec, SemaphorInputValue, SemaphorMatrixQueryDefinition, SemaphorMatrixQuerySpec, SemaphorMetricQueryDefinition, SemaphorMetricQuerySpec, SemaphorRecordsQueryDefinition, SemaphorRecordsQuerySpec, SemaphorSqlParameterValue, SemaphorSqlQueryDefinition, SemaphorSqlQuerySpec } from './contracts.js';
+import { SemaphorAnalysisQueryDefinition, SemaphorAnalysisQuerySpec, SemaphorControlInputSpec, SemaphorControlRole, SemaphorDataAppDefinition, SemaphorDerivedFieldDefinition, SemaphorFilterInputSpec, SemaphorInputOptionsQueryDefinition, SemaphorInputOptionsQuerySpec, SemaphorInputBinding, SemaphorInputBindingReference, SemaphorInputReference, SemaphorInputSpec, SemaphorInputValue, SemaphorMatrixQueryDefinition, SemaphorMatrixQuerySpec, SemaphorMetricQueryDefinition, SemaphorMetricQuerySpec, SemaphorRecordsQueryDefinition, SemaphorRecordsQuerySpec, SemaphorSelectionInputSpec, SemaphorSqlParameterValue, SemaphorSqlQueryDefinition, SemaphorSqlQuerySpec } from './contracts.js';
 import { SemaphorFieldRef, SemaphorSemanticSourceRef, SemaphorSourceRef } from '../shared/analytics-protocol/index.js';
 export type SemaphorSqlParamInputSpec<TValue extends SemaphorInputValue = SemaphorInputValue> = Omit<SemaphorControlInputSpec<TValue>, 'kind' | 'role'> & {
     defaultValue?: TValue;
@@ -46,6 +46,7 @@ export declare const semaphor: {
         };
     };
     filter<TValue extends SemaphorInputValue = SemaphorInputValue>(spec: Omit<SemaphorFilterInputSpec<TValue>, "kind">): SemaphorFilterInputSpec<TValue>;
+    selection(spec: Omit<SemaphorSelectionInputSpec, "kind">): SemaphorSelectionInputSpec;
     bindInput(input: SemaphorInputReference, binding: SemaphorBindInputSpec): SemaphorInputBindingReference;
     control<TValue extends SemaphorInputValue = SemaphorInputValue>(spec: SemaphorControlBuilderSpec<TValue>): SemaphorControlInputSpec<TValue>;
     sqlParam<TValue extends SemaphorSqlParameterValue = SemaphorSqlParameterValue>(spec: SemaphorSqlParamInputSpec<TValue>): SemaphorControlInputSpec<TValue>;