@ai-matrx/design-system 0.55.0 → 0.56.0

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

@@ -1,6 +1,6 @@
 import { ContentTransferReference } from './content-transfer.cjs';
 import * as React from 'react';
-import { ReactNode } from 'react';
+import { ReactNode, ComponentType, MouseEvent } from 'react';
 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';
@@ -95,6 +95,21 @@ type TableSearchMatchMode = "contains" | "whole_words";
 type CellEditType = "string" | "number" | "boolean" | "select"
 /** Free-text multi-value chips (string[] cells: tags, labels, aliases). */
  | "tags" | "date" | false;
+/** The table owns action markup and geometry; hosts supply behavior and an icon component only. */
+interface MatrxTableIconAction {
+    id: string;
+    icon: ComponentType<{
+        className?: string;
+        "aria-hidden"?: boolean;
+    }>;
+    label: string;
+    tooltip?: string;
+    onClick: (event: MouseEvent<HTMLButtonElement>) => void;
+    disabled?: boolean;
+    loading?: boolean;
+    tone?: "default" | "primary" | "destructive" | "success" | "warning";
+    variant?: "default" | "secondary" | "destructive" | "outline" | "ghost" | "link";
+}
 interface MatrxColumnDef<T> {
     /** Stable id used for sort/filter state. Defaults to `accessorKey` when set. */
     id?: string;
@@ -118,6 +133,8 @@ interface MatrxColumnDef<T> {
     label?: string;
     /** Cell renderer. Defaults to stringified accessor value. */
     cell?: (row: T, index: number) => ReactNode;
+    /** An explicitly declared custom actions column. Arbitrary content never enters the built-in Actions column. */
+    customActions?: (row: T, controls: MatrxDataTableRecordControls) => ReactNode;
     /** Sortable unless explicitly false. Default true. */
     sortable?: boolean;
     /**
@@ -1629,8 +1646,8 @@ interface MatrxDataTableProps<T> {
      * the table owns checkbox selection and Alchemy copy for loaded rows.
      */
     selection?: false | MatrxDataTableSelectionConfig<T>;
-    /** Extra row actions rendered in a trailing Actions column. */
-    rowActions?: (row: T, controls: MatrxDataTableRecordControls) => ReactNode;
+    /** Icon-only actions in the built-in Actions column. Labels are accessible names/tooltips, never button text. */
+    rowActions?: (row: T, controls: MatrxDataTableRecordControls) => readonly MatrxTableIconAction[];
     /** 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. */
@@ -1703,12 +1720,6 @@ interface MatrxDataTableProps<T> {
      * scrolls. A phone always scrolls: a fitted phone table is columns too narrow to read.
      */
     fitToWidth?: boolean | undefined;
-    /**
-     * WHAT THE ACTIONS HEADER OFFERS, beside its word — the table's own "add a row action" and the
-     * actions menu (merged-grid review 2, G4: "the ACTIONS header has no controls at all"). Drawn
-     * only where the Actions column is.
-     */
-    rowActionsHeader?: ReactNode;
     /** Highlight an index in the currently rendered page without selecting it. */
     highlightedIndex?: number | undefined;
     /** Receives the complete visible local view after local processing, before paging. Attaching after absence receives one snapshot; callback identity changes alone do not notify. */
@@ -1840,4 +1851,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 TableRankedSearchOptions as $, type AnyOfColumnSearch as A, type MatrxDataTableMobileCardControls as B, type ColumnFiltersState as C, type MatrxDataTableMultiExpandedDetailConfig as D, type MatrxDataTableQueryControl as E, type MatrxDataTableReadStatus as F, type MatrxDataTableSelectionConfig as G, type MatrxDataTableSingleExpandedDetailConfig as H, type MatrxDataTableSourceProcessing as I, type MatrxDataTableSpreadsheetConfig as J, type MatrxDataTableStyleConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableSummaryConfig as N, type MatrxDataTableSummaryContext as O, type MatrxDataTableSummaryMetric as P, type MatrxDataTableToolbar as Q, type MatrxDataTableUrlStateConfig as R, type SortState as S, type TableSearchMatchMode as T, type MatrxDataTableVirtualizeConfig as U, type MatrxDataTableWindowConfig as V, type MatrxTablePagination as W, type NumberFilterOp as X, type SavedTableViewTab as Y, type SortDirection as Z, type SpreadsheetSelection as _, type ColumnFilterValue as a, type TableSearchRole as a0, type TableSearchScope as a1, type TableViewQuery as a2, type TableViewTab as a3, TableViewTabs as a4, type TableViewTabsProps as a5, type TableViewTabsStore as a6, type TextFilterMode as a7, type ToolbarFacet as a8, inferTableSearchRole as a9, rankTableSearchRows as aa, resolveTableSearchScopes as ab, LAYERED_FILTER_OPERATORS as ac, LAYERED_FILTER_OPERATOR_LABELS as ad, type LayeredFilterField as ae, type LayeredFilterOperator as af, columnFiltersToLayeredRules as ag, completeLayeredFilterRules as ah, decodeLayeredFilterRules as ai, encodeLayeredFilterRules as aj, isCompleteLayeredFilterRule as ak, isLayeredFilterOperator as al, layeredFilterMatchesValue as am, layeredFilterNeedsValue as an, layeredFilterRuleSummary as ao, operatorsForLayeredField as ap, 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 MatrxDataTableProps as h, type MatrxDataTableAppearance as i, type TableViewSnapshot as j, type MatrxDataTableRead as k, type ColumnMarker as l, type CellEditType as m, type CellEditsMap as n, type MatrxDataTableContextMenuConfig as o, type MatrxDataTableCoverageConfig as p, type MatrxDataTableDetailConfig as q, type MatrxDataTableDrillConfig as r, type MatrxDataTableEditConfig as s, type MatrxDataTableEmptyState as t, type MatrxDataTableExpandedDetailConfig as u, type MatrxDataTableFacetsConfig as v, type MatrxDataTableFilterUi as w, type MatrxDataTableGroupingConfig as x, type MatrxDataTableHierarchyConfig as y, type MatrxDataTableHierarchyMove 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, 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 };

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

@@ -1,6 +1,6 @@
 import { ContentTransferReference } from './content-transfer.js';
 import * as React from 'react';
-import { ReactNode } from 'react';
+import { ReactNode, ComponentType, MouseEvent } from 'react';
 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';
@@ -95,6 +95,21 @@ type TableSearchMatchMode = "contains" | "whole_words";
 type CellEditType = "string" | "number" | "boolean" | "select"
 /** Free-text multi-value chips (string[] cells: tags, labels, aliases). */
  | "tags" | "date" | false;
+/** The table owns action markup and geometry; hosts supply behavior and an icon component only. */
+interface MatrxTableIconAction {
+    id: string;
+    icon: ComponentType<{
+        className?: string;
+        "aria-hidden"?: boolean;
+    }>;
+    label: string;
+    tooltip?: string;
+    onClick: (event: MouseEvent<HTMLButtonElement>) => void;
+    disabled?: boolean;
+    loading?: boolean;
+    tone?: "default" | "primary" | "destructive" | "success" | "warning";
+    variant?: "default" | "secondary" | "destructive" | "outline" | "ghost" | "link";
+}
 interface MatrxColumnDef<T> {
     /** Stable id used for sort/filter state. Defaults to `accessorKey` when set. */
     id?: string;
@@ -118,6 +133,8 @@ interface MatrxColumnDef<T> {
     label?: string;
     /** Cell renderer. Defaults to stringified accessor value. */
     cell?: (row: T, index: number) => ReactNode;
+    /** An explicitly declared custom actions column. Arbitrary content never enters the built-in Actions column. */
+    customActions?: (row: T, controls: MatrxDataTableRecordControls) => ReactNode;
     /** Sortable unless explicitly false. Default true. */
     sortable?: boolean;
     /**
@@ -1629,8 +1646,8 @@ interface MatrxDataTableProps<T> {
      * the table owns checkbox selection and Alchemy copy for loaded rows.
      */
     selection?: false | MatrxDataTableSelectionConfig<T>;
-    /** Extra row actions rendered in a trailing Actions column. */
-    rowActions?: (row: T, controls: MatrxDataTableRecordControls) => ReactNode;
+    /** Icon-only actions in the built-in Actions column. Labels are accessible names/tooltips, never button text. */
+    rowActions?: (row: T, controls: MatrxDataTableRecordControls) => readonly MatrxTableIconAction[];
     /** 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. */
@@ -1703,12 +1720,6 @@ interface MatrxDataTableProps<T> {
      * scrolls. A phone always scrolls: a fitted phone table is columns too narrow to read.
      */
     fitToWidth?: boolean | undefined;
-    /**
-     * WHAT THE ACTIONS HEADER OFFERS, beside its word — the table's own "add a row action" and the
-     * actions menu (merged-grid review 2, G4: "the ACTIONS header has no controls at all"). Drawn
-     * only where the Actions column is.
-     */
-    rowActionsHeader?: ReactNode;
     /** Highlight an index in the currently rendered page without selecting it. */
     highlightedIndex?: number | undefined;
     /** Receives the complete visible local view after local processing, before paging. Attaching after absence receives one snapshot; callback identity changes alone do not notify. */
@@ -1840,4 +1851,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 TableRankedSearchOptions as $, type AnyOfColumnSearch as A, type MatrxDataTableMobileCardControls as B, type ColumnFiltersState as C, type MatrxDataTableMultiExpandedDetailConfig as D, type MatrxDataTableQueryControl as E, type MatrxDataTableReadStatus as F, type MatrxDataTableSelectionConfig as G, type MatrxDataTableSingleExpandedDetailConfig as H, type MatrxDataTableSourceProcessing as I, type MatrxDataTableSpreadsheetConfig as J, type MatrxDataTableStyleConfig as K, type LayeredFilterRule as L, type MatrxColumnDef as M, type MatrxDataTableSummaryConfig as N, type MatrxDataTableSummaryContext as O, type MatrxDataTableSummaryMetric as P, type MatrxDataTableToolbar as Q, type MatrxDataTableUrlStateConfig as R, type SortState as S, type TableSearchMatchMode as T, type MatrxDataTableVirtualizeConfig as U, type MatrxDataTableWindowConfig as V, type MatrxTablePagination as W, type NumberFilterOp as X, type SavedTableViewTab as Y, type SortDirection as Z, type SpreadsheetSelection as _, type ColumnFilterValue as a, type TableSearchRole as a0, type TableSearchScope as a1, type TableViewQuery as a2, type TableViewTab as a3, TableViewTabs as a4, type TableViewTabsProps as a5, type TableViewTabsStore as a6, type TextFilterMode as a7, type ToolbarFacet as a8, inferTableSearchRole as a9, rankTableSearchRows as aa, resolveTableSearchScopes as ab, LAYERED_FILTER_OPERATORS as ac, LAYERED_FILTER_OPERATOR_LABELS as ad, type LayeredFilterField as ae, type LayeredFilterOperator as af, columnFiltersToLayeredRules as ag, completeLayeredFilterRules as ah, decodeLayeredFilterRules as ai, encodeLayeredFilterRules as aj, isCompleteLayeredFilterRule as ak, isLayeredFilterOperator as al, layeredFilterMatchesValue as am, layeredFilterNeedsValue as an, layeredFilterRuleSummary as ao, operatorsForLayeredField as ap, 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 MatrxDataTableProps as h, type MatrxDataTableAppearance as i, type TableViewSnapshot as j, type MatrxDataTableRead as k, type ColumnMarker as l, type CellEditType as m, type CellEditsMap as n, type MatrxDataTableContextMenuConfig as o, type MatrxDataTableCoverageConfig as p, type MatrxDataTableDetailConfig as q, type MatrxDataTableDrillConfig as r, type MatrxDataTableEditConfig as s, type MatrxDataTableEmptyState as t, type MatrxDataTableExpandedDetailConfig as u, type MatrxDataTableFacetsConfig as v, type MatrxDataTableFilterUi as w, type MatrxDataTableGroupingConfig as x, type MatrxDataTableHierarchyConfig as y, type MatrxDataTableHierarchyMove 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, 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 };

package/dist/styles.css

@@ -453,50 +453,49 @@
   }
 }
 .matrx-motion-sheet-top[data-state="open"] {
-  animation: matrx-slide-in-top var(--matrx-motion-duration-sheet)
-    var(--matrx-motion-ease-out);
+  animation: matrx-slide-in-top var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-top[data-state="closed"] {
-  animation: matrx-slide-out-top var(--matrx-motion-duration-slow)
-    var(--matrx-motion-ease-in);
+  animation: matrx-slide-out-top var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-bottom[data-state="open"] {
-  animation: matrx-slide-in-bottom var(--matrx-motion-duration-sheet)
-    var(--matrx-motion-ease-out);
+  animation: matrx-slide-in-bottom var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-bottom[data-state="closed"] {
-  animation: matrx-slide-out-bottom var(--matrx-motion-duration-slow)
-    var(--matrx-motion-ease-in);
+  animation: matrx-slide-out-bottom var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-left[data-state="open"] {
-  animation: matrx-slide-in-left var(--matrx-motion-duration-sheet)
-    var(--matrx-motion-ease-out);
+  animation: matrx-slide-in-left var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-left[data-state="closed"] {
-  animation: matrx-slide-out-left var(--matrx-motion-duration-slow)
-    var(--matrx-motion-ease-in);
+  animation: matrx-slide-out-left var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-right[data-state="open"] {
-  animation: matrx-slide-in-right var(--matrx-motion-duration-sheet)
-    var(--matrx-motion-ease-out);
+  animation: matrx-slide-in-right var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-right[data-state="closed"] {
-  animation: matrx-slide-out-right var(--matrx-motion-duration-slow)
-    var(--matrx-motion-ease-in);
+  animation: matrx-slide-out-right var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 /* A `side="center"` Sheet has no edge to come from, so it fades like a
    dialog scrim rather than sliding from nowhere. */
 .matrx-motion-sheet-center[data-state="open"] {
-  animation: matrx-fade-in var(--matrx-motion-duration-sheet)
-    var(--matrx-motion-ease-out);
+  animation: matrx-fade-in var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-sheet-center[data-state="closed"] {
-  animation: matrx-fade-out var(--matrx-motion-duration-slow)
-    var(--matrx-motion-ease-in);
+  animation: matrx-fade-out var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
-/* The mobile Dialog / CommandDialog bottom sheet: slides AND fades, at the
-   dialog's 200ms rather than the Sheet's 500ms, because it is a dialog
-   wearing sheet geometry and it opens from a tap, not from a nav gesture. */
+/* The mobile Dialog / CommandDialog bottom sheet: slides AND fades on THE
+   panel motion (0.56.0, the motion standard) — a bottom sheet is a panel. */
 @keyframes matrx-bottom-sheet-in {
   from {
     opacity: 0;
@@ -518,12 +517,12 @@
   }
 }
 .matrx-motion-bottom-sheet[data-state="open"] {
-  animation: matrx-bottom-sheet-in var(--matrx-motion-duration-base)
-    var(--matrx-motion-ease-out);
+  animation: matrx-bottom-sheet-in var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 .matrx-motion-bottom-sheet[data-state="closed"] {
-  animation: matrx-bottom-sheet-out var(--matrx-motion-duration-base)
-    var(--matrx-motion-ease-in);
+  animation: matrx-bottom-sheet-out var(--matrx-motion-duration-panel)
+    var(--matrx-motion-ease-panel);
 }
 
 /* --- poppers -----------------------------------------------------------
@@ -957,6 +956,26 @@
   animation: none;
 }
 
+/* THE PANEL MOTION on the vaul Drawer (0.56.0, the motion standard). vaul
+   1.1.2 injects `[data-vaul-drawer]{transition: transform .5s
+   cubic-bezier(.32,.72,0,1); animation-duration: .5s; …}` (0,1,0) and sets the
+   same pace INLINE when a released drag settles. Two attributes (0,2,0) beat
+   its sheet whatever the load order; `!important` on the two timing longhands
+   beats its inline settle WITHOUT touching `transition-property`, so vaul's
+   inline `transition: none` while a finger drags still means no motion. */
+[data-vaul-drawer][data-vaul-drawer-direction] {
+  animation-duration: var(--matrx-motion-duration-panel) !important;
+  animation-timing-function: var(--matrx-motion-ease-panel) !important;
+  transition-duration: var(--matrx-motion-duration-panel) !important;
+  transition-timing-function: var(--matrx-motion-ease-panel) !important;
+}
+[data-vaul-overlay][data-vaul-snap-points][data-state] {
+  animation-duration: var(--matrx-motion-duration-panel);
+  animation-timing-function: var(--matrx-motion-ease-panel);
+  transition-duration: var(--matrx-motion-duration-panel);
+  transition-timing-function: var(--matrx-motion-ease-panel);
+}
+
 .matrx-mobile-sheet > [data-slot="dialog-footer"] {
   padding-bottom: max(var(--dialog-pad, 0px), env(safe-area-inset-bottom, 0px));
 }

package/dist/tokens.css

@@ -139,14 +139,21 @@
        switch: `prefers-reduced-motion: reduce` silences the animations
        outright in styles.css, regardless of these values.
 
-       The numbers are the ones the primitives already carried as Tailwind
-       `duration-*` utilities before the package owned the keyframes:
-       poppers/tooltips 150ms, dialogs and overlays 200ms, a sheet closing
-       300ms and opening 500ms. */
+       The small-motion numbers are the ones the primitives already carried as
+       Tailwind `duration-*` utilities before the package owned the keyframes:
+       poppers/tooltips 150ms, dialogs and overlays 200ms, 300ms slow. */
     --matrx-motion-duration-fast: 150ms;
     --matrx-motion-duration-base: 200ms;
     --matrx-motion-duration-slow: 300ms;
-    --matrx-motion-duration-sheet: 500ms;
+    /* THE PANEL MOTION (0.56.0) — the motion standard (AI Matrx
+       common-docs/policies/motion-standard.md, Arman 2026-10-02): every panel-like
+       slide — the Sheet on every side, the mobile Dialog bottom sheet, the vaul
+       Drawer and the Sidebar's collapse — opens AND closes on this one pair. The
+       NAMES are the package's contract; the VALUES are the host's (a host that
+       declares them unlayered wins over this layered default). An even
+       ease-in-out, never a spring; 0ms under reduced motion (below). */
+    --matrx-motion-duration-panel: 600ms;
+    --matrx-motion-ease-panel: cubic-bezier(0.4, 0, 0.2, 1);
     /* Enters decelerate (the surface arrives and settles); exits accelerate
        (it leaves and is gone). Linear on both — which is what
        `tailwindcss-animate` defaulted to — reads mechanical at these
@@ -263,4 +270,11 @@
     --background-texture: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='2' height='2' viewBox='0 0 2 2'%3E%3Cpath fill='%23999' fill-opacity='0.07' d='M1 1h0.5v0.5H1V1z'%3E%3C/path%3E%3C/svg%3E");
     --card-texture: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='2' height='2' viewBox='0 0 2 2'%3E%3Cpath fill='%23fff' fill-opacity='0.02' d='M1 1h0.5v0.5H1V1z'%3E%3C/path%3E%3C/svg%3E");
   }
+
+  /* Reduced motion means no panel slide (the motion standard, rule 6). */
+  @media (prefers-reduced-motion: reduce) {
+    :root {
+      --matrx-motion-duration-panel: 0ms;
+    }
+  }
 }

package/package.json

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