@ai-matrx/design-system 0.60.7 → 0.60.9

package/dist/{layered-filters-cXDqSLSR.d.ts → layered-filters-B0q8G3QR.d.ts}

@@ -1,6 +1,6 @@
-import { ContentTransferReference } from './content-transfer.js';
 import * as React from 'react';
 import { ReactNode, ComponentType, MouseEvent } from 'react';
+import { ContentTransferReference } from './content-transfer.js';
 import { AgentPayloadInput, AiVariant, AiCustomSource, CopyExportConfig } from './data-table/copy-types.js';
 import { TableStyle, ChoiceColorLookup } from './data-table/table-style.js';
 import { F as FieldFormatConfig } from './types-JnZD8wM0.js';
@@ -12,6 +12,46 @@ import { SpreadsheetIntent, SpreadsheetPastePlan, SpreadsheetController } from '
 import { DateColumnFilterValue } from './data-table/date-filter.js';
 import { MatrxTableMenuItem, MatrxTableMenuPayload, MatrxTableMenuSection } from './data-table/menu-targets.js';
 
+interface TableScopeLane {
+    value: string;
+    label: string;
+    /** Unknown counts are omitted; a known zero remains visible. */
+    count?: number | null;
+    disabled?: boolean;
+}
+interface TableScopeOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+type TableScopeFilter = {
+    label: string;
+    options: readonly TableScopeOption[];
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    control?: never;
+} | {
+    label: string;
+    control: ReactNode;
+    options?: never;
+    value?: never;
+    onChange?: never;
+    disabled?: never;
+};
+/** Hosts own source queries, page resets and selection. These are display filters,
+ * never authorization or the active organization used for writes. */
+interface TableScopeBarProps {
+    lanes: readonly TableScopeLane[];
+    value: string;
+    onChange: (value: string) => void;
+    dimension?: TableScopeFilter;
+    organization?: TableScopeFilter;
+}
+/** Shared scope row, available independently or through MatrxDataTable.scopeBar.
+ * On narrow screens a select exposes every lane without hiding either filter. */
+declare function TableScopeBar({ lanes, value, onChange, dimension, organization }: TableScopeBarProps): React.JSX.Element;
+
 interface TableViewTab {
     id: string;
     label: string;
@@ -647,6 +687,15 @@ interface MatrxDataTableToolbar {
      * is drawn. Absent: the row is drawn in place, as always.
      */
     portalInto?: HTMLElement | null;
+    /**
+     * Draw the saved-view tabs INTO this element — the leading edge of the placing page's own
+     * toolbar row — while the rest of the table's row (its actions) goes to `portalInto`. The
+     * tabs then open the page row on the left and the table's actions close it on the right,
+     * instead of both riding one slot. Drawn without the strip's bottom rule (the page row is
+     * not the table's top edge). `null`: not mounted yet, the tabs are not drawn. Absent: the
+     * tabs stay in the table's own row.
+     */
+    tabsPortalInto?: HTMLElement | null;
     /** Keep the toolbar on ONE row at every width; a narrow screen scrolls it sideways. */
     singleRow?: boolean;
     /**
@@ -1627,6 +1676,11 @@ interface MatrxDataTableProps<T> {
     window?: MatrxDataTableWindowConfig<T>;
     /** Copy + Copy for AI (rows + this view). Omit for the declared-column default; false suppresses it. */
     copy?: false | MatrxDataTableCopyConfig<T>;
+    /** Independently hide table or row copy without replacing canonical payloads. */
+    copyControls?: {
+        table?: boolean;
+        row?: boolean;
+    };
     /** Where canonical per-row Alchemy appears. Inline preserves current behavior. */
     rowCopyPlacement?: "inline" | "menu";
     /** One pane-level right-click resolver; host owns the opaque descriptor. */
@@ -1651,6 +1705,8 @@ interface MatrxDataTableProps<T> {
     /** Extra rows rendered in the table footer with the same columns as data rows. */
     footerRows?: T[];
     /** Optional KPIs above the toolbar and aligned totals in the canonical footer. */
+    /** Controlled list filters. Hosts reset source paging/selection in callbacks. */
+    scopeBar?: TableScopeBarProps;
     summary?: MatrxDataTableSummaryConfig<T>;
     /** Per-row presentation class, after canonical selection/highlight state. */
     rowClassName?: (row: T, index: number) => string | undefined;
@@ -1766,6 +1822,18 @@ interface MatrxDataTableProps<T> {
     stickyHeader?: boolean;
     className?: string;
     tableClassName?: string;
+    /**
+     * `fill` (default): the bordered frame takes the full height it is given. `content`: the frame
+     * ends at its last row and scrolls only once the rows outgrow that height — a list of three
+     * rows draws no tall empty box.
+     */
+    frameHeight?: "fill" | "content";
+    /**
+     * `show` (default): the column header is always drawn. `hide`: a settled result with no rows
+     * draws no column header (chrome over rows that do not exist) — unless a column filter is
+     * set, because the header is where that filter is cleared.
+     */
+    emptyHeader?: "show" | "hide";
     /**
      * Optional compact row presentation rendered below `mobileCardsBreakpoint`
      * in place of the horizontal table. The caller supplies the record summary
@@ -1851,4 +1919,4 @@ declare function columnFiltersToLayeredRules(filters: ColumnFiltersState, fieldI
 declare function layeredFilterMatchesValue(value: unknown, rule: LayeredFilterRule): boolean;
 declare function layeredFilterRuleSummary(rule: LayeredFilterRule, fields: readonly LayeredFilterField[]): string;
 
-export { type SpreadsheetSelection as $, type AnyOfColumnSearch as A, type MatrxDataTableHierarchyMove as B, type ColumnFiltersState as C, type MatrxDataTableMobileCardControls as D, type MatrxDataTableMultiExpandedDetailConfig as E, type MatrxDataTableQueryControl as F, type MatrxDataTableReadStatus as G, type MatrxDataTableSelectionConfig as H, type MatrxDataTableSingleExpandedDetailConfig as I, type MatrxDataTableSourceProcessing as J, type MatrxDataTableSpreadsheetConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableStyleConfig as N, type MatrxDataTableSummaryConfig as O, type MatrxDataTableSummaryContext as P, type MatrxDataTableSummaryMetric as Q, type MatrxDataTableToolbar as R, type SortState as S, type TableSearchMatchMode as T, type MatrxDataTableUrlStateConfig as U, type MatrxDataTableVirtualizeConfig as V, type MatrxDataTableWindowConfig as W, type MatrxTablePagination as X, type NumberFilterOp as Y, type SavedTableViewTab as Z, type SortDirection as _, type ColumnFilterValue as a, type TableRankedSearchOptions as a0, type TableSearchRole as a1, type TableSearchScope as a2, type TableViewQuery as a3, type TableViewTab as a4, TableViewTabs as a5, type TableViewTabsProps as a6, type TableViewTabsStore as a7, type TextFilterMode as a8, type ToolbarFacet as a9, inferTableSearchRole as aa, rankTableSearchRows as ab, resolveTableSearchScopes as ac, LAYERED_FILTER_OPERATORS as ad, LAYERED_FILTER_OPERATOR_LABELS as ae, type LayeredFilterField as af, type LayeredFilterOperator as ag, columnFiltersToLayeredRules as ah, completeLayeredFilterRules as ai, decodeLayeredFilterRules as aj, encodeLayeredFilterRules as ak, isCompleteLayeredFilterRule as al, isLayeredFilterOperator as am, layeredFilterMatchesValue as an, layeredFilterNeedsValue as ao, layeredFilterRuleSummary as ap, operatorsForLayeredField as aq, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxTableIconAction as h, type MatrxDataTableProps as i, type MatrxDataTableAppearance as j, type TableViewSnapshot as k, type MatrxDataTableRead as l, type ColumnMarker as m, type CellEditType as n, type CellEditsMap as o, type MatrxDataTableContextMenuConfig as p, type MatrxDataTableCoverageConfig as q, type MatrxDataTableDetailConfig as r, type MatrxDataTableDrillConfig as s, type MatrxDataTableEditConfig as t, type MatrxDataTableEmptyState as u, type MatrxDataTableExpandedDetailConfig as v, type MatrxDataTableFacetsConfig as w, type MatrxDataTableFilterUi as x, type MatrxDataTableGroupingConfig as y, type MatrxDataTableHierarchyConfig as z };
+export { type SpreadsheetSelection as $, type AnyOfColumnSearch as A, type MatrxDataTableHierarchyMove as B, type ColumnFiltersState as C, type MatrxDataTableMobileCardControls as D, type MatrxDataTableMultiExpandedDetailConfig as E, type MatrxDataTableQueryControl as F, type MatrxDataTableReadStatus as G, type MatrxDataTableSelectionConfig as H, type MatrxDataTableSingleExpandedDetailConfig as I, type MatrxDataTableSourceProcessing as J, type MatrxDataTableSpreadsheetConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableStyleConfig as N, type MatrxDataTableSummaryConfig as O, type MatrxDataTableSummaryContext as P, type MatrxDataTableSummaryMetric as Q, type MatrxDataTableToolbar as R, type SortState as S, type TableSearchMatchMode as T, type MatrxDataTableUrlStateConfig as U, type MatrxDataTableVirtualizeConfig as V, type MatrxDataTableWindowConfig as W, type MatrxTablePagination as X, type NumberFilterOp as Y, type SavedTableViewTab as Z, type SortDirection as _, type ColumnFilterValue as a, type TableRankedSearchOptions as a0, TableScopeBar as a1, type TableScopeBarProps as a2, type TableScopeFilter as a3, type TableScopeLane as a4, type TableScopeOption as a5, type TableSearchRole as a6, type TableSearchScope as a7, type TableViewQuery as a8, type TableViewTab as a9, TableViewTabs as aa, type TableViewTabsProps as ab, type TableViewTabsStore as ac, type TextFilterMode as ad, type ToolbarFacet as ae, inferTableSearchRole as af, rankTableSearchRows as ag, resolveTableSearchScopes as ah, LAYERED_FILTER_OPERATORS as ai, LAYERED_FILTER_OPERATOR_LABELS as aj, type LayeredFilterField as ak, type LayeredFilterOperator as al, columnFiltersToLayeredRules as am, completeLayeredFilterRules as an, decodeLayeredFilterRules as ao, encodeLayeredFilterRules as ap, isCompleteLayeredFilterRule as aq, isLayeredFilterOperator as ar, layeredFilterMatchesValue as as, layeredFilterNeedsValue as at, layeredFilterRuleSummary as au, operatorsForLayeredField as av, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxTableIconAction as h, type MatrxDataTableProps as i, type MatrxDataTableAppearance as j, type TableViewSnapshot as k, type MatrxDataTableRead as l, type ColumnMarker as m, type CellEditType as n, type CellEditsMap as o, type MatrxDataTableContextMenuConfig as p, type MatrxDataTableCoverageConfig as q, type MatrxDataTableDetailConfig as r, type MatrxDataTableDrillConfig as s, type MatrxDataTableEditConfig as t, type MatrxDataTableEmptyState as u, type MatrxDataTableExpandedDetailConfig as v, type MatrxDataTableFacetsConfig as w, type MatrxDataTableFilterUi as x, type MatrxDataTableGroupingConfig as y, type MatrxDataTableHierarchyConfig as z };

package/dist/{layered-filters-CNFxkmfs.d.cts → layered-filters-CisXX8K5.d.cts}

@@ -1,6 +1,6 @@
-import { ContentTransferReference } from './content-transfer.cjs';
 import * as React from 'react';
 import { ReactNode, ComponentType, MouseEvent } from 'react';
+import { ContentTransferReference } from './content-transfer.cjs';
 import { AgentPayloadInput, AiVariant, AiCustomSource, CopyExportConfig } from './data-table/copy-types.cjs';
 import { TableStyle, ChoiceColorLookup } from './data-table/table-style.cjs';
 import { F as FieldFormatConfig } from './types-JnZD8wM0.cjs';
@@ -12,6 +12,46 @@ import { SpreadsheetIntent, SpreadsheetPastePlan, SpreadsheetController } from '
 import { DateColumnFilterValue } from './data-table/date-filter.cjs';
 import { MatrxTableMenuItem, MatrxTableMenuPayload, MatrxTableMenuSection } from './data-table/menu-targets.cjs';
 
+interface TableScopeLane {
+    value: string;
+    label: string;
+    /** Unknown counts are omitted; a known zero remains visible. */
+    count?: number | null;
+    disabled?: boolean;
+}
+interface TableScopeOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+type TableScopeFilter = {
+    label: string;
+    options: readonly TableScopeOption[];
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    control?: never;
+} | {
+    label: string;
+    control: ReactNode;
+    options?: never;
+    value?: never;
+    onChange?: never;
+    disabled?: never;
+};
+/** Hosts own source queries, page resets and selection. These are display filters,
+ * never authorization or the active organization used for writes. */
+interface TableScopeBarProps {
+    lanes: readonly TableScopeLane[];
+    value: string;
+    onChange: (value: string) => void;
+    dimension?: TableScopeFilter;
+    organization?: TableScopeFilter;
+}
+/** Shared scope row, available independently or through MatrxDataTable.scopeBar.
+ * On narrow screens a select exposes every lane without hiding either filter. */
+declare function TableScopeBar({ lanes, value, onChange, dimension, organization }: TableScopeBarProps): React.JSX.Element;
+
 interface TableViewTab {
     id: string;
     label: string;
@@ -647,6 +687,15 @@ interface MatrxDataTableToolbar {
      * is drawn. Absent: the row is drawn in place, as always.
      */
     portalInto?: HTMLElement | null;
+    /**
+     * Draw the saved-view tabs INTO this element — the leading edge of the placing page's own
+     * toolbar row — while the rest of the table's row (its actions) goes to `portalInto`. The
+     * tabs then open the page row on the left and the table's actions close it on the right,
+     * instead of both riding one slot. Drawn without the strip's bottom rule (the page row is
+     * not the table's top edge). `null`: not mounted yet, the tabs are not drawn. Absent: the
+     * tabs stay in the table's own row.
+     */
+    tabsPortalInto?: HTMLElement | null;
     /** Keep the toolbar on ONE row at every width; a narrow screen scrolls it sideways. */
     singleRow?: boolean;
     /**
@@ -1627,6 +1676,11 @@ interface MatrxDataTableProps<T> {
     window?: MatrxDataTableWindowConfig<T>;
     /** Copy + Copy for AI (rows + this view). Omit for the declared-column default; false suppresses it. */
     copy?: false | MatrxDataTableCopyConfig<T>;
+    /** Independently hide table or row copy without replacing canonical payloads. */
+    copyControls?: {
+        table?: boolean;
+        row?: boolean;
+    };
     /** Where canonical per-row Alchemy appears. Inline preserves current behavior. */
     rowCopyPlacement?: "inline" | "menu";
     /** One pane-level right-click resolver; host owns the opaque descriptor. */
@@ -1651,6 +1705,8 @@ interface MatrxDataTableProps<T> {
     /** Extra rows rendered in the table footer with the same columns as data rows. */
     footerRows?: T[];
     /** Optional KPIs above the toolbar and aligned totals in the canonical footer. */
+    /** Controlled list filters. Hosts reset source paging/selection in callbacks. */
+    scopeBar?: TableScopeBarProps;
     summary?: MatrxDataTableSummaryConfig<T>;
     /** Per-row presentation class, after canonical selection/highlight state. */
     rowClassName?: (row: T, index: number) => string | undefined;
@@ -1766,6 +1822,18 @@ interface MatrxDataTableProps<T> {
     stickyHeader?: boolean;
     className?: string;
     tableClassName?: string;
+    /**
+     * `fill` (default): the bordered frame takes the full height it is given. `content`: the frame
+     * ends at its last row and scrolls only once the rows outgrow that height — a list of three
+     * rows draws no tall empty box.
+     */
+    frameHeight?: "fill" | "content";
+    /**
+     * `show` (default): the column header is always drawn. `hide`: a settled result with no rows
+     * draws no column header (chrome over rows that do not exist) — unless a column filter is
+     * set, because the header is where that filter is cleared.
+     */
+    emptyHeader?: "show" | "hide";
     /**
      * Optional compact row presentation rendered below `mobileCardsBreakpoint`
      * in place of the horizontal table. The caller supplies the record summary
@@ -1851,4 +1919,4 @@ declare function columnFiltersToLayeredRules(filters: ColumnFiltersState, fieldI
 declare function layeredFilterMatchesValue(value: unknown, rule: LayeredFilterRule): boolean;
 declare function layeredFilterRuleSummary(rule: LayeredFilterRule, fields: readonly LayeredFilterField[]): string;
 
-export { type SpreadsheetSelection as $, type AnyOfColumnSearch as A, type MatrxDataTableHierarchyMove as B, type ColumnFiltersState as C, type MatrxDataTableMobileCardControls as D, type MatrxDataTableMultiExpandedDetailConfig as E, type MatrxDataTableQueryControl as F, type MatrxDataTableReadStatus as G, type MatrxDataTableSelectionConfig as H, type MatrxDataTableSingleExpandedDetailConfig as I, type MatrxDataTableSourceProcessing as J, type MatrxDataTableSpreadsheetConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableStyleConfig as N, type MatrxDataTableSummaryConfig as O, type MatrxDataTableSummaryContext as P, type MatrxDataTableSummaryMetric as Q, type MatrxDataTableToolbar as R, type SortState as S, type TableSearchMatchMode as T, type MatrxDataTableUrlStateConfig as U, type MatrxDataTableVirtualizeConfig as V, type MatrxDataTableWindowConfig as W, type MatrxTablePagination as X, type NumberFilterOp as Y, type SavedTableViewTab as Z, type SortDirection as _, type ColumnFilterValue as a, type TableRankedSearchOptions as a0, type TableSearchRole as a1, type TableSearchScope as a2, type TableViewQuery as a3, type TableViewTab as a4, TableViewTabs as a5, type TableViewTabsProps as a6, type TableViewTabsStore as a7, type TextFilterMode as a8, type ToolbarFacet as a9, inferTableSearchRole as aa, rankTableSearchRows as ab, resolveTableSearchScopes as ac, LAYERED_FILTER_OPERATORS as ad, LAYERED_FILTER_OPERATOR_LABELS as ae, type LayeredFilterField as af, type LayeredFilterOperator as ag, columnFiltersToLayeredRules as ah, completeLayeredFilterRules as ai, decodeLayeredFilterRules as aj, encodeLayeredFilterRules as ak, isCompleteLayeredFilterRule as al, isLayeredFilterOperator as am, layeredFilterMatchesValue as an, layeredFilterNeedsValue as ao, layeredFilterRuleSummary as ap, operatorsForLayeredField as aq, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxTableIconAction as h, type MatrxDataTableProps as i, type MatrxDataTableAppearance as j, type TableViewSnapshot as k, type MatrxDataTableRead as l, type ColumnMarker as m, type CellEditType as n, type CellEditsMap as o, type MatrxDataTableContextMenuConfig as p, type MatrxDataTableCoverageConfig as q, type MatrxDataTableDetailConfig as r, type MatrxDataTableDrillConfig as s, type MatrxDataTableEditConfig as t, type MatrxDataTableEmptyState as u, type MatrxDataTableExpandedDetailConfig as v, type MatrxDataTableFacetsConfig as w, type MatrxDataTableFilterUi as x, type MatrxDataTableGroupingConfig as y, type MatrxDataTableHierarchyConfig as z };
+export { type SpreadsheetSelection as $, type AnyOfColumnSearch as A, type MatrxDataTableHierarchyMove as B, type ColumnFiltersState as C, type MatrxDataTableMobileCardControls as D, type MatrxDataTableMultiExpandedDetailConfig as E, type MatrxDataTableQueryControl as F, type MatrxDataTableReadStatus as G, type MatrxDataTableSelectionConfig as H, type MatrxDataTableSingleExpandedDetailConfig as I, type MatrxDataTableSourceProcessing as J, type MatrxDataTableSpreadsheetConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableStyleConfig as N, type MatrxDataTableSummaryConfig as O, type MatrxDataTableSummaryContext as P, type MatrxDataTableSummaryMetric as Q, type MatrxDataTableToolbar as R, type SortState as S, type TableSearchMatchMode as T, type MatrxDataTableUrlStateConfig as U, type MatrxDataTableVirtualizeConfig as V, type MatrxDataTableWindowConfig as W, type MatrxTablePagination as X, type NumberFilterOp as Y, type SavedTableViewTab as Z, type SortDirection as _, type ColumnFilterValue as a, type TableRankedSearchOptions as a0, TableScopeBar as a1, type TableScopeBarProps as a2, type TableScopeFilter as a3, type TableScopeLane as a4, type TableScopeOption as a5, type TableSearchRole as a6, type TableSearchScope as a7, type TableViewQuery as a8, type TableViewTab as a9, TableViewTabs as aa, type TableViewTabsProps as ab, type TableViewTabsStore as ac, type TextFilterMode as ad, type ToolbarFacet as ae, inferTableSearchRole as af, rankTableSearchRows as ag, resolveTableSearchScopes as ah, LAYERED_FILTER_OPERATORS as ai, LAYERED_FILTER_OPERATOR_LABELS as aj, type LayeredFilterField as ak, type LayeredFilterOperator as al, columnFiltersToLayeredRules as am, completeLayeredFilterRules as an, decodeLayeredFilterRules as ao, encodeLayeredFilterRules as ap, isCompleteLayeredFilterRule as aq, isLayeredFilterOperator as ar, layeredFilterMatchesValue as as, layeredFilterNeedsValue as at, layeredFilterRuleSummary as au, operatorsForLayeredField as av, type TableSavedViewsProps as b, type MatrxDataTableDensity as c, type MatrxDataTableRecordControls as d, type MatrxDataTableQueryState as e, type ColumnFilterKind as f, type MatrxDataTableCopyConfig as g, type MatrxTableIconAction as h, type MatrxDataTableProps as i, type MatrxDataTableAppearance as j, type TableViewSnapshot as k, type MatrxDataTableRead as l, type ColumnMarker as m, type CellEditType as n, type CellEditsMap as o, type MatrxDataTableContextMenuConfig as p, type MatrxDataTableCoverageConfig as q, type MatrxDataTableDetailConfig as r, type MatrxDataTableDrillConfig as s, type MatrxDataTableEditConfig as t, type MatrxDataTableEmptyState as u, type MatrxDataTableExpandedDetailConfig as v, type MatrxDataTableFacetsConfig as w, type MatrxDataTableFilterUi as x, type MatrxDataTableGroupingConfig as y, type MatrxDataTableHierarchyConfig as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/design-system",
-  "version": "0.60.7",
+  "version": "0.60.9",
   "description": "AI Matrx semantic React primitives shared across Vite, Next.js, desktop, and customer-built applications.",
   "type": "module",
   "license": "MIT",