@persona/design-system 0.9.1 → 0.10.1

package/dist/url-state.d.mts

@@ -1,2 +1,2 @@
-import { a as decodeFilterStateFromUrl, i as decodeFilterStateFromString, n as UrlStateCodecResult, o as encodeFilterStateToUrlParam, r as applyFilterStateToSearchParams, t as FILTER_STATE_URL_PARAM } from "./url-state-B_gTQ9uu.mjs";
+import { a as decodeFilterStateFromUrl, i as decodeFilterStateFromString, n as UrlStateCodecResult, o as encodeFilterStateToUrlParam, r as applyFilterStateToSearchParams, t as FILTER_STATE_URL_PARAM } from "./url-state-CwaRVyXR.mjs";
 export { FILTER_STATE_URL_PARAM, UrlStateCodecResult, applyFilterStateToSearchParams, decodeFilterStateFromString, decodeFilterStateFromUrl, encodeFilterStateToUrlParam };

package/dist/{useChain-DPRVMwX8.d.mts → useChain-DXkKKe-J.d.mts}

@@ -1,8 +1,8 @@
-import { r as Sticker } from "./Sticker-C260e6kl.mjs";
-import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-6mcLrVG3.mjs";
-import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BuwpPC73.mjs";
-import { t as Option } from "./schemaOptions-DBOUChxi.mjs";
-import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-DT-9j_sG.mjs";
+import { r as Sticker } from "./Sticker-CsUSNIH-.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-DmOA0Lnu.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-a7kHYhs7.mjs";
+import { t as Option } from "./schemaOptions-BQgLOgtD.mjs";
+import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-Cjp0zZ4E.mjs";
 import { ComponentProps } from "react";
 
 //#region lib/useChain.d.ts
@@ -74,4 +74,4 @@ declare const useChainSchema: ({
 declare const useChain: UseChainHook;
 //#endregion
 export { useChain as n, useChainSchema as r, chainRootsFromSchemaProperties as t };
-//# sourceMappingURL=useChain-DPRVMwX8.d.mts.map
+//# sourceMappingURL=useChain-DXkKKe-J.d.mts.map

package/dist/useChainAtCursor.d.mts

@@ -1,9 +1,9 @@
-import { t as ASTNode } from "./types-VgGkS4JB.mjs";
-import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-6mcLrVG3.mjs";
-import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BuwpPC73.mjs";
-import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-DT-9j_sG.mjs";
-import { u as ValueType } from "./types-CEQWndtF.mjs";
-import { n as useChain } from "./useChain-DPRVMwX8.mjs";
+import { t as ASTNode } from "./types-DfpVVjso.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-DmOA0Lnu.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-a7kHYhs7.mjs";
+import { n as PossibleChainSchema, t as ChainRoot } from "./chainTypes-Cjp0zZ4E.mjs";
+import { u as ValueType } from "./types-DWU0Dmy9.mjs";
+import { n as useChain } from "./useChain-DXkKKe-J.mjs";
 
 //#region components/SmartTextInput/useChainAtCursor.d.ts
 /**

package/dist/useCodeChainFunctionPanel.d.mts

@@ -1,4 +1,4 @@
-import { o as OpenCodeChainFunctionPanel, t as CodeChainFunctionPanelRenderProps } from "./types-CEQWndtF.mjs";
+import { o as OpenCodeChainFunctionPanel, t as CodeChainFunctionPanelRenderProps } from "./types-DWU0Dmy9.mjs";
 import { ReactNode } from "react";
 
 //#region components/SmartTextInput/useCodeChainFunctionPanel.d.ts

package/dist/useColumnConfiguration.d.mts

@@ -0,0 +1,34 @@
+import { i as TableViewConfigurationProps } from "./TableViewConfigurationDropdown-CvN7tE98.mjs";
+import { i as ColumnConfig } from "./types-BQP14Fng.mjs";
+import { RowData } from "@tanstack/react-table";
+
+//#region patterns/IndexTableLayout/useColumnConfiguration.d.ts
+type AttributeColumn = TableViewConfigurationProps['columnConfiguration'][number];
+interface ColumnDefinition<TData extends RowData> extends ColumnConfig<TData> {
+  key?: string;
+  label: string;
+  isCustomField?: boolean;
+}
+type ColumnDefinitions<TData extends RowData> = Record<string, ColumnDefinition<TData>>;
+interface UseColumnConfigurationOptions<TData extends RowData> {
+  columnDefinitions: ColumnDefinitions<TData>;
+  defaultColumns: string[];
+  columnConfiguration?: AttributeColumn[];
+  onColumnConfigurationChange?: (c: AttributeColumn[]) => void;
+  getColumnDisabled?: (columnId: string, shownColumnIds: string[]) => boolean;
+  sortByRelevance?: boolean;
+}
+declare const useColumnConfiguration: <TData extends RowData>({
+  columnDefinitions,
+  columnConfiguration,
+  onColumnConfigurationChange,
+  defaultColumns,
+  getColumnDisabled,
+  sortByRelevance
+}: UseColumnConfigurationOptions<TData>) => {
+  columns: ColumnConfig<TData>[];
+  columnConfigurationProps?: TableViewConfigurationProps;
+};
+//#endregion
+export { ColumnDefinition, ColumnDefinitions, UseColumnConfigurationOptions, useColumnConfiguration };
+//# sourceMappingURL=useColumnConfiguration.d.mts.map

package/dist/useComboboxFooterAction.d.mts

@@ -1,4 +1,4 @@
-import { p as FooterAction } from "./ComboboxBase-2nVpt8oj.mjs";
+import { p as FooterAction } from "./ComboboxBase-B7ZcqU9p.mjs";
 import { KeyboardEvent } from "react";
 
 //#region components/Combobox/useComboboxFooterAction.d.ts

package/dist/{useFilterStateV2-BQZppUR0.d.mts → useFilterStateV2-Bzo27PR-.d.mts}

@@ -1,5 +1,5 @@
-import { m as FilterStateV2, n as CompoundExpression, u as FilterRule } from "./types-DEzlAdZW.mjs";
-import { t as FieldRegistry } from "./FieldRegistry-DAk_3PhH.mjs";
+import { m as FilterStateV2, n as CompoundExpression, u as FilterRule } from "./types-EodOhsjw.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-B5E-GN91.mjs";
 import { SetStateAction } from "react";
 
 //#region components/DataTable/TableControls/FiltersV2/useFilterStateV2.d.ts
@@ -91,4 +91,4 @@ interface UseFilterStateV2Result {
 declare function useFilterStateV2(options: UseFilterStateV2Options): UseFilterStateV2Result;
 //#endregion
 export { UseFilterStateV2Result as n, useFilterStateV2 as r, UseFilterStateV2Options as t };
-//# sourceMappingURL=useFilterStateV2-BQZppUR0.d.mts.map
+//# sourceMappingURL=useFilterStateV2-Bzo27PR-.d.mts.map

package/dist/useFilterStateV2.d.mts

@@ -1,2 +1,2 @@
-import { n as UseFilterStateV2Result, r as useFilterStateV2, t as UseFilterStateV2Options } from "./useFilterStateV2-BQZppUR0.mjs";
+import { n as UseFilterStateV2Result, r as useFilterStateV2, t as UseFilterStateV2Options } from "./useFilterStateV2-Bzo27PR-.mjs";
 export { UseFilterStateV2Options, UseFilterStateV2Result, useFilterStateV2 };

package/dist/{useFormField-DAwApAKK.d.mts → useFormField-Ba8rh1CH.d.mts}

@@ -1,4 +1,4 @@
-import { t as ErrorProps } from "./ErrorProps-oCHtJzEB.mjs";
+import { t as ErrorProps } from "./ErrorProps-DH0fzeGf.mjs";
 import * as _$react from "react";
 
 //#region components/FormControl/useFormField.d.ts
@@ -29,4 +29,4 @@ declare const useFormField: (props: Partial<FormControlContextProps>) => {
 };
 //#endregion
 export { FormControlContextProps as n, useFormField as r, FormControlContext as t };
-//# sourceMappingURL=useFormField-DAwApAKK.d.mts.map
+//# sourceMappingURL=useFormField-Ba8rh1CH.d.mts.map

package/dist/{useFormField-BAmkdxtA.mjs → useFormField-CbNYbDdp.mjs}

@@ -1,4 +1,4 @@
-import { n as useFormGroup } from "./useFormGroup-BZayb9fZ.mjs";
+import { n as useFormGroup } from "./useFormGroup-CsKC93Pt.mjs";
 import { createContext, useContext } from "react";
 //#region components/FormControl/useFormField.ts
 const FormControlContext = createContext({});
@@ -23,4 +23,4 @@ const useFormField = (props) => {
 //#endregion
 export { useFormField as n, FormControlContext as t };
 
-//# sourceMappingURL=useFormField-BAmkdxtA.mjs.map
+//# sourceMappingURL=useFormField-CbNYbDdp.mjs.map

package/dist/{useFormField-BAmkdxtA.mjs.map → useFormField-CbNYbDdp.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormField-BAmkdxtA.mjs","names":[],"sources":["../components/FormControl/useFormField.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport useFormGroup from 'design-system/components/ConfigFormGroup/useFormGroup';\nimport type ErrorProps from 'design-system/types/ErrorProps';\n\nexport interface FormControlContextProps extends ErrorProps {\n  inputId?: string;\n  helperTextId?: string;\n  errorTextId?: string;\n  warningTextId?: string;\n  labelId?: string;\n  disabled?: boolean;\n  required?: boolean;\n  maxLength?: number;\n  configField?: boolean;\n}\n\nexport const FormControlContext = createContext<FormControlContextProps>({});\n\nconst useFormField = (props: Partial<FormControlContextProps>) => {\n  const group = useFormGroup();\n  const field = useContext(FormControlContext);\n\n  const inputId = props.inputId ?? field.inputId;\n\n  return {\n    configField: props.configField ?? group.configField,\n    hasError: props.hasError ?? field.hasError,\n    hasWarning: props.hasWarning ?? field.hasWarning,\n    inputId,\n    helperTextId: props.helperTextId ?? field.helperTextId,\n    errorTextId: props.errorTextId ?? field.errorTextId,\n    warningTextId: props.warningTextId ?? field.warningTextId,\n    labelId: props.labelId ?? field.labelId,\n    disabled: props.disabled ?? field.disabled,\n    required: props.required ?? field.required,\n    maxLength: props.maxLength ?? field.maxLength,\n  };\n};\n\nexport default useFormField;\n"],"mappings":";;;AAiBA,MAAa,qBAAqB,cAAuC,EAAE,CAAC;AAE5E,MAAM,gBAAgB,UAA4C;CAChE,MAAM,QAAQ,cAAc;CAC5B,MAAM,QAAQ,WAAW,mBAAmB;CAE5C,MAAM,UAAU,MAAM,WAAW,MAAM;AAEvC,QAAO;EACL,aAAa,MAAM,eAAe,MAAM;EACxC,UAAU,MAAM,YAAY,MAAM;EAClC,YAAY,MAAM,cAAc,MAAM;EACtC;EACA,cAAc,MAAM,gBAAgB,MAAM;EAC1C,aAAa,MAAM,eAAe,MAAM;EACxC,eAAe,MAAM,iBAAiB,MAAM;EAC5C,SAAS,MAAM,WAAW,MAAM;EAChC,UAAU,MAAM,YAAY,MAAM;EAClC,UAAU,MAAM,YAAY,MAAM;EAClC,WAAW,MAAM,aAAa,MAAM;EACrC"}
+{"version":3,"file":"useFormField-CbNYbDdp.mjs","names":[],"sources":["../components/FormControl/useFormField.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nimport useFormGroup from 'design-system/components/ConfigFormGroup/useFormGroup';\nimport type ErrorProps from 'design-system/types/ErrorProps';\n\nexport interface FormControlContextProps extends ErrorProps {\n  inputId?: string;\n  helperTextId?: string;\n  errorTextId?: string;\n  warningTextId?: string;\n  labelId?: string;\n  disabled?: boolean;\n  required?: boolean;\n  maxLength?: number;\n  configField?: boolean;\n}\n\nexport const FormControlContext = createContext<FormControlContextProps>({});\n\nconst useFormField = (props: Partial<FormControlContextProps>) => {\n  const group = useFormGroup();\n  const field = useContext(FormControlContext);\n\n  const inputId = props.inputId ?? field.inputId;\n\n  return {\n    configField: props.configField ?? group.configField,\n    hasError: props.hasError ?? field.hasError,\n    hasWarning: props.hasWarning ?? field.hasWarning,\n    inputId,\n    helperTextId: props.helperTextId ?? field.helperTextId,\n    errorTextId: props.errorTextId ?? field.errorTextId,\n    warningTextId: props.warningTextId ?? field.warningTextId,\n    labelId: props.labelId ?? field.labelId,\n    disabled: props.disabled ?? field.disabled,\n    required: props.required ?? field.required,\n    maxLength: props.maxLength ?? field.maxLength,\n  };\n};\n\nexport default useFormField;\n"],"mappings":";;;AAiBA,MAAa,qBAAqB,cAAuC,EAAE,CAAC;AAE5E,MAAM,gBAAgB,UAA4C;CAChE,MAAM,QAAQ,cAAc;CAC5B,MAAM,QAAQ,WAAW,mBAAmB;CAE5C,MAAM,UAAU,MAAM,WAAW,MAAM;AAEvC,QAAO;EACL,aAAa,MAAM,eAAe,MAAM;EACxC,UAAU,MAAM,YAAY,MAAM;EAClC,YAAY,MAAM,cAAc,MAAM;EACtC;EACA,cAAc,MAAM,gBAAgB,MAAM;EAC1C,aAAa,MAAM,eAAe,MAAM;EACxC,eAAe,MAAM,iBAAiB,MAAM;EAC5C,SAAS,MAAM,WAAW,MAAM;EAChC,UAAU,MAAM,YAAY,MAAM;EAClC,UAAU,MAAM,YAAY,MAAM;EAClC,WAAW,MAAM,aAAa,MAAM;EACrC"}

package/dist/useFormField.d.mts

@@ -1,2 +1,2 @@
-import { n as FormControlContextProps, r as useFormField, t as FormControlContext } from "./useFormField-DAwApAKK.mjs";
+import { n as FormControlContextProps, r as useFormField, t as FormControlContext } from "./useFormField-Ba8rh1CH.mjs";
 export { FormControlContext, FormControlContextProps, useFormField as default };

package/dist/{useFormGroup-BZayb9fZ.mjs → useFormGroup-CsKC93Pt.mjs}

@@ -11,4 +11,4 @@ const useFormGroup = (props) => {
 //#endregion
 export { useFormGroup as n, FormGroupContext as t };
 
-//# sourceMappingURL=useFormGroup-BZayb9fZ.mjs.map
+//# sourceMappingURL=useFormGroup-CsKC93Pt.mjs.map

package/dist/{useFormGroup-BZayb9fZ.mjs.map → useFormGroup-CsKC93Pt.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"useFormGroup-BZayb9fZ.mjs","names":[],"sources":["../components/ConfigFormGroup/useFormGroup.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport interface FormGroupContextProps {\n  configField?: boolean;\n  /**\n   * The z-index to use when labels are rendered as tooltips (e.g. when configField is true).\n   */\n  labelTooltipZIndex?: number;\n}\n\nexport const FormGroupContext = createContext<FormGroupContextProps>({});\n\nconst useFormGroup = (props?: Partial<FormGroupContextProps>) => {\n  const field = useContext(FormGroupContext);\n\n  return {\n    configField: props?.configField ?? field.configField,\n    labelTooltipZIndex: props?.labelTooltipZIndex ?? field.labelTooltipZIndex,\n  };\n};\n\nexport default useFormGroup;\n"],"mappings":";;AAUA,MAAa,mBAAmB,cAAqC,EAAE,CAAC;AAExE,MAAM,gBAAgB,UAA2C;CAC/D,MAAM,QAAQ,WAAW,iBAAiB;AAE1C,QAAO;EACL,aAAa,OAAO,eAAe,MAAM;EACzC,oBAAoB,OAAO,sBAAsB,MAAM;EACxD"}
+{"version":3,"file":"useFormGroup-CsKC93Pt.mjs","names":[],"sources":["../components/ConfigFormGroup/useFormGroup.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\n\nexport interface FormGroupContextProps {\n  configField?: boolean;\n  /**\n   * The z-index to use when labels are rendered as tooltips (e.g. when configField is true).\n   */\n  labelTooltipZIndex?: number;\n}\n\nexport const FormGroupContext = createContext<FormGroupContextProps>({});\n\nconst useFormGroup = (props?: Partial<FormGroupContextProps>) => {\n  const field = useContext(FormGroupContext);\n\n  return {\n    configField: props?.configField ?? field.configField,\n    labelTooltipZIndex: props?.labelTooltipZIndex ?? field.labelTooltipZIndex,\n  };\n};\n\nexport default useFormGroup;\n"],"mappings":";;AAUA,MAAa,mBAAmB,cAAqC,EAAE,CAAC;AAExE,MAAM,gBAAgB,UAA2C;CAC/D,MAAM,QAAQ,WAAW,iBAAiB;AAE1C,QAAO;EACL,aAAa,OAAO,eAAe,MAAM;EACzC,oBAAoB,OAAO,sBAAsB,MAAM;EACxD"}

package/dist/{useLocationPathname-BHL0pgiu.d.mts → useLocationPathname-OsvI7mH5.d.mts}

@@ -2,4 +2,4 @@
 declare const usePathname: () => string;
 //#endregion
 export { usePathname as t };
-//# sourceMappingURL=useLocationPathname-BHL0pgiu.d.mts.map
+//# sourceMappingURL=useLocationPathname-OsvI7mH5.d.mts.map

package/dist/useLocationPathname.d.mts

@@ -1,2 +1,2 @@
-import { t as usePathname } from "./useLocationPathname-BHL0pgiu.mjs";
+import { t as usePathname } from "./useLocationPathname-OsvI7mH5.mjs";
 export { usePathname };

package/dist/{useTableBoxDragAndDrop-Dq30b6yY.d.mts → useTableBoxDragAndDrop-CKPIY98e.d.mts}

@@ -66,4 +66,4 @@ declare const useTableBoxDragAndDrop: <T extends object>({
 }: UseTableBoxDragAndDropArgs<T>) => UseTableBoxDragAndDropResult;
 //#endregion
 export { ReorderConfig as n, useTableBoxDragAndDrop as r, DragDirection as t };
-//# sourceMappingURL=useTableBoxDragAndDrop-Dq30b6yY.d.mts.map
+//# sourceMappingURL=useTableBoxDragAndDrop-CKPIY98e.d.mts.map

package/dist/useTableBoxDragAndDrop.d.mts

@@ -1,2 +1,2 @@
-import { n as ReorderConfig, r as useTableBoxDragAndDrop, t as DragDirection } from "./useTableBoxDragAndDrop-Dq30b6yY.mjs";
+import { n as ReorderConfig, r as useTableBoxDragAndDrop, t as DragDirection } from "./useTableBoxDragAndDrop-CKPIY98e.mjs";
 export { DragDirection, ReorderConfig, useTableBoxDragAndDrop };

package/dist/useTableColumns-DdU0CLcU.d.mts

@@ -0,0 +1,72 @@
+import { C as RowAction, O as SortProps, _ as DataTableColumns, l as DataTableColumnFormat } from "./types-BQP14Fng.mjs";
+import { ColumnDef, Row, RowData, Table } from "@tanstack/react-table";
+
+//#region components/DataTable/useTableColumns.d.ts
+/**
+ * Host-injected cell format renderer. Dashboard passes its own implementation
+ * that handles all format types including tags, files, and status indicators.
+ */
+type RenderFormatFn<TData = unknown, TFormat extends {
+  type: string;
+} = {
+  type: string;
+}> = (value: unknown, format?: TFormat, row?: TData) => React.ReactNode;
+interface UseTableColumnsParams<TData extends RowData, TFormat extends {
+  type: string;
+} = DataTableColumnFormat<TData>, TFilter = unknown> {
+  columns: DataTableColumns<TData, TFormat, TFilter>;
+  data: TData[];
+  compact?: boolean;
+  sort?: boolean | SortProps;
+  clientSearch?: boolean | {
+    placeholder?: string;
+    initialValue?: string;
+  };
+  clientFiltering?: boolean;
+  expandColumnVisibility?: 'auto' | 'always';
+  showControls?: boolean;
+  enableRowSelection?: boolean;
+  enableSubRowSelection?: boolean;
+  rowActions?: RowAction[] | ((row: TData) => RowAction[]);
+  getRowId?: (row: TData) => string;
+  expandedRows: Set<string>;
+  toggleRowExpansion: (rowId: string) => void;
+  canRowExpand: (rowData: TData) => boolean;
+  checkboxColumnStates: Record<string, Set<string>>;
+  handleCheckboxCellChange: (columnId: string, rowId: string, checked: boolean) => void;
+  handleSelectAllCheckboxCell: (columnId: string, checked: boolean) => void;
+  getSelfAndNestedRowIds: (row: TData, indexPath: number[]) => string[];
+  handleRowSelectionWithShift: (clickedRow: Row<TData>, table: Table<TData>, checked: boolean, isShiftKey: boolean) => void;
+  renderFormat: RenderFormatFn<TData, TFormat>;
+}
+declare function useTableColumns<TData extends RowData, TFormat extends {
+  type: string;
+} = DataTableColumnFormat<TData>, TFilter = unknown>({
+  columns,
+  data,
+  compact,
+  sort,
+  clientSearch,
+  clientFiltering,
+  expandColumnVisibility,
+  showControls,
+  enableRowSelection,
+  enableSubRowSelection,
+  rowActions,
+  getRowId,
+  expandedRows,
+  toggleRowExpansion,
+  canRowExpand,
+  checkboxColumnStates,
+  handleCheckboxCellChange,
+  handleSelectAllCheckboxCell,
+  getSelfAndNestedRowIds,
+  handleRowSelectionWithShift,
+  renderFormat
+}: UseTableColumnsParams<TData, TFormat, TFilter>): [ColumnDef<TData, any>[], {
+  key: string;
+  label: string;
+}[]];
+//#endregion
+export { UseTableColumnsParams as n, useTableColumns as r, RenderFormatFn as t };
+//# sourceMappingURL=useTableColumns-DdU0CLcU.d.mts.map

package/dist/useTableColumns.d.mts

@@ -1,72 +1,2 @@
-import { DataTableColumnFormat, DataTableColumns, RowAction, SortProps } from "./components/DataTable/types.mjs";
-import { ColumnDef, Row, RowData, Table } from "@tanstack/react-table";
-
-//#region components/DataTable/useTableColumns.d.ts
-/**
- * Host-injected cell format renderer. Dashboard passes its own implementation
- * that handles all format types including tags, files, and status indicators.
- */
-type RenderFormatFn<TData = unknown, TFormat extends {
-  type: string;
-} = {
-  type: string;
-}> = (value: unknown, format?: TFormat, row?: TData) => React.ReactNode;
-interface UseTableColumnsParams<TData extends RowData, TFormat extends {
-  type: string;
-} = DataTableColumnFormat<TData>, TFilter = unknown> {
-  columns: DataTableColumns<TData, TFormat, TFilter>;
-  data: TData[];
-  compact?: boolean;
-  sort?: boolean | SortProps;
-  clientSearch?: boolean | {
-    placeholder?: string;
-    initialValue?: string;
-  };
-  clientFiltering?: boolean;
-  expandColumnVisibility?: 'auto' | 'always';
-  showControls?: boolean;
-  enableRowSelection?: boolean;
-  enableSubRowSelection?: boolean;
-  rowActions?: RowAction[] | ((row: TData) => RowAction[]);
-  getRowId?: (row: TData) => string;
-  expandedRows: Set<string>;
-  toggleRowExpansion: (rowId: string) => void;
-  canRowExpand: (rowData: TData) => boolean;
-  checkboxColumnStates: Record<string, Set<string>>;
-  handleCheckboxCellChange: (columnId: string, rowId: string, checked: boolean) => void;
-  handleSelectAllCheckboxCell: (columnId: string, checked: boolean) => void;
-  getSelfAndNestedRowIds: (row: TData, indexPath: number[]) => string[];
-  handleRowSelectionWithShift: (clickedRow: Row<TData>, table: Table<TData>, checked: boolean, isShiftKey: boolean) => void;
-  renderFormat: RenderFormatFn<TData, TFormat>;
-}
-declare function useTableColumns<TData extends RowData, TFormat extends {
-  type: string;
-} = DataTableColumnFormat<TData>, TFilter = unknown>({
-  columns,
-  data,
-  compact,
-  sort,
-  clientSearch,
-  clientFiltering,
-  expandColumnVisibility,
-  showControls,
-  enableRowSelection,
-  enableSubRowSelection,
-  rowActions,
-  getRowId,
-  expandedRows,
-  toggleRowExpansion,
-  canRowExpand,
-  checkboxColumnStates,
-  handleCheckboxCellChange,
-  handleSelectAllCheckboxCell,
-  getSelfAndNestedRowIds,
-  handleRowSelectionWithShift,
-  renderFormat
-}: UseTableColumnsParams<TData, TFormat, TFilter>): [ColumnDef<TData, any>[], {
-  key: string;
-  label: string;
-}[]];
-//#endregion
-export { RenderFormatFn, UseTableColumnsParams, useTableColumns };
-//# sourceMappingURL=useTableColumns.d.mts.map
+import { n as UseTableColumnsParams, r as useTableColumns, t as RenderFormatFn } from "./useTableColumns-DdU0CLcU.mjs";
+export { RenderFormatFn, UseTableColumnsParams, useTableColumns };

package/dist/useTruncation.d.mts

@@ -1,4 +1,4 @@
-import { i as ComboboxOption } from "./ComboboxBase-2nVpt8oj.mjs";
+import { i as ComboboxOption } from "./ComboboxBase-B7ZcqU9p.mjs";
 import { MutableRefObject, RefObject } from "react";
 
 //#region components/Combobox/useTruncation.d.ts

package/dist/{utilities-B2ry7_20.d.mts → utilities-BrEUGFGq.d.mts}

@@ -6,4 +6,4 @@
 type RequireOneOf<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & { [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>> }[Keys];
 //#endregion
 export { RequireOneOf as t };
-//# sourceMappingURL=utilities-B2ry7_20.d.mts.map
+//# sourceMappingURL=utilities-BrEUGFGq.d.mts.map

package/dist/utilities.d.mts

@@ -1,2 +1,2 @@
-import { t as RequireOneOf } from "./utilities-B2ry7_20.mjs";
+import { t as RequireOneOf } from "./utilities-BrEUGFGq.mjs";
 export { RequireOneOf };

package/dist/utils/testing.d.mts

@@ -1,4 +1,4 @@
-import { n as RouterAdapter } from "../types-CgKSEQyB.mjs";
+import { n as RouterAdapter } from "../types-HxiGiwQN.mjs";
 import { ReactElement } from "react";
 import * as _$_testing_library_react0 from "@testing-library/react";
 import { RenderOptions, screen } from "@testing-library/react";

package/dist/utils.d.mts

@@ -1,4 +1,4 @@
-import { d as FilterRuleValue } from "./types-DEzlAdZW.mjs";
+import { d as FilterRuleValue } from "./types-EodOhsjw.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/value-controls/utils.d.ts
 /**

package/dist/utils4.d.mts

@@ -1,8 +1,8 @@
-import { n as ASTChain } from "./types-4wnr5R9P.mjs";
-import { t as ASTNode } from "./types-VgGkS4JB.mjs";
-import { n as Chain, s as MethodChainNode } from "./methodChainTypes-BuwpPC73.mjs";
-import { t as ChainRoot } from "./chainTypes-DT-9j_sG.mjs";
-import { a as Mode, r as FunctionAtCursor, u as ValueType } from "./types-CEQWndtF.mjs";
+import { n as ASTChain } from "./types-Kmnood9Y.mjs";
+import { t as ASTNode } from "./types-DfpVVjso.mjs";
+import { n as Chain, s as MethodChainNode } from "./methodChainTypes-a7kHYhs7.mjs";
+import { t as ChainRoot } from "./chainTypes-Cjp0zZ4E.mjs";
+import { a as Mode, r as FunctionAtCursor, u as ValueType } from "./types-DWU0Dmy9.mjs";
 import { RefObject } from "react";
 
 //#region components/SmartTextInput/utils.d.ts

package/dist/{validation-BODkbEvr.d.mts → validation-D6NPueNk.d.mts}

@@ -1,5 +1,5 @@
-import { m as FilterStateV2, u as FilterRule } from "./types-DEzlAdZW.mjs";
-import { t as FieldRegistry } from "./FieldRegistry-DAk_3PhH.mjs";
+import { m as FilterStateV2, u as FilterRule } from "./types-EodOhsjw.mjs";
+import { t as FieldRegistry } from "./FieldRegistry-B5E-GN91.mjs";
 
 //#region components/DataTable/TableControls/FiltersV2/validation.d.ts
 /**
@@ -48,4 +48,4 @@ declare function pruneToRegistry(state: FilterStateV2, registry: FieldRegistry |
 declare function hasCompleteValue(rule: FilterRule, registry: FieldRegistry): boolean;
 //#endregion
 export { isFilterStateV2 as n, pruneToRegistry as r, hasCompleteValue as t };
-//# sourceMappingURL=validation-BODkbEvr.d.mts.map
+//# sourceMappingURL=validation-D6NPueNk.d.mts.map

package/dist/validation.d.mts

@@ -1,2 +1,2 @@
-import { n as isFilterStateV2, r as pruneToRegistry, t as hasCompleteValue } from "./validation-BODkbEvr.mjs";
+import { n as isFilterStateV2, r as pruneToRegistry, t as hasCompleteValue } from "./validation-D6NPueNk.mjs";
 export { hasCompleteValue, isFilterStateV2, pruneToRegistry };

package/dist/validation2.d.mts

@@ -1,7 +1,7 @@
-import { t as ASTNode } from "./types-VgGkS4JB.mjs";
-import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-6mcLrVG3.mjs";
-import { t as ChainRoot } from "./chainTypes-DT-9j_sG.mjs";
-import { u as ValueType } from "./types-CEQWndtF.mjs";
+import { t as ASTNode } from "./types-DfpVVjso.mjs";
+import { dt as ObjectSchemaMap, n as JsonSchema, st as FunctionJsonSchema } from "./jsonSchema-DmOA0Lnu.mjs";
+import { t as ChainRoot } from "./chainTypes-Cjp0zZ4E.mjs";
+import { u as ValueType } from "./types-DWU0Dmy9.mjs";
 import { ReactNode } from "react";
 
 //#region components/SmartTextInput/validation.d.ts

package/dist/{value-control-resolver-BcZiReQ7.d.mts → value-control-resolver-C-UrXVlB.d.mts}

@@ -1,4 +1,4 @@
-import { d as FilterRuleValue, f as FilterRuleValueChange, l as FilterOperator, o as FilterField, u as FilterRule } from "./types-DEzlAdZW.mjs";
+import { d as FilterRuleValue, f as FilterRuleValueChange, l as FilterOperator, o as FilterField, u as FilterRule } from "./types-EodOhsjw.mjs";
 import { ReactNode } from "react";
 
 //#region components/DataTable/TableControls/FiltersV2/FilterBar/value-control-resolver.d.ts
@@ -46,4 +46,4 @@ type ValueControlResolver = (opts: ResolveValueControlOptions) => ReactNode | un
 declare function resolveValueControl(opts: ResolveValueControlOptions, hostResolver?: ValueControlResolver): ReactNode;
 //#endregion
 export { ValueControlResolver as n, resolveValueControl as r, ResolveValueControlOptions as t };
-//# sourceMappingURL=value-control-resolver-BcZiReQ7.d.mts.map
+//# sourceMappingURL=value-control-resolver-C-UrXVlB.d.mts.map

package/dist/value-control-resolver.d.mts

@@ -1,2 +1,2 @@
-import { n as ValueControlResolver, r as resolveValueControl, t as ResolveValueControlOptions } from "./value-control-resolver-BcZiReQ7.mjs";
+import { n as ValueControlResolver, r as resolveValueControl, t as ResolveValueControlOptions } from "./value-control-resolver-C-UrXVlB.mjs";
 export { ResolveValueControlOptions, ValueControlResolver, resolveValueControl };

package/dist/variables/effect.d.mts

@@ -1,4 +1,4 @@
-import { t as MaybeSemanticTheme } from "../semanticColor-BuG977_M.mjs";
+import { t as MaybeSemanticTheme } from "../semanticColor-CmGmGRj8.mjs";
 
 //#region variables/effect.d.ts
 /**

package/dist/variables/semantic.d.mts

@@ -1,2 +1,2 @@
-import { i as semanticLight, n as SemanticTokens, r as semanticDark, t as CssPercentage } from "../semantic-Duoh2Pxp.mjs";
+import { i as semanticLight, n as SemanticTokens, r as semanticDark, t as CssPercentage } from "../semantic-DjKvtUi8.mjs";
 export { CssPercentage, SemanticTokens, semanticDark, semanticLight };

package/llms.txt

@@ -14,8 +14,8 @@ For exact prop types, prefer the published type declarations (`dist/**/*.d.mts`,
 ## Skills
 
 - [ui-authoring](skills/ui-authoring/SKILL.md): design tokens, PDS implementation guidelines, table guidelines (DataTable vs TableBox vs TableLayout), routing/link adapters (react-router, TanStack, custom), localization (PDSProvider strings/locale), loading states, testing, Storybook
-- [Tokens](skills/ui-authoring/TOKENS.md): Color / Spacing / Typography selection and catalog, radius, charts
-- [Patterns](skills/ui-authoring/PATTERNS.md): forms, layout, indicators, feedback, empty states, charts, panels
+- [Tokens](skills/ui-authoring/TOKENS.md): semantic color tokens (Fg / Surface / Border / Action / Input / Feedback / Status / Opacity) with recipes and a dark-mode checklist; Spacing / Typography catalog, radius, elevation, charts
+- [Patterns](skills/ui-authoring/PATTERNS.md): forms, layout, index tables, indicators, feedback, empty states, charts, panels
 - [Components](skills/ui-authoring/COMPONENTS.md): which PDS component to use (and its import path); APIs live in that component's `.mdx` when one exists, otherwise in `dist/components/<Name>/index.d.mts`
 - [design-system-component-authoring](skills/design-system-component-authoring/SKILL.md): authoring a new PDS component in this repo — clarifying scope, component conventions, prop interface patterns
 
@@ -32,11 +32,16 @@ their own subpaths.
 - Layout: `Stack` / `HStack` (components/Stack), `Spacer`
 - Text: `Heading`, `Paragraph`, `Label` (components/Text)
 - Tables: `DataTable` (data views w/ pagination + sorting), `TableBox` (editable form tables), `TableLayout` + `Table`/`TableRow`/`TableCell`/`TableHeaderCell` primitives (components/Table) — `TableLayout` has built-in `isLoading`/`isEmpty`/`nullState`/`showHeader` handling
+- Index pages: `IndexTableLayout` (`patterns/IndexTableLayout`) composes the page shell around `DataTable`; hosts pass ready-made controls and own saved-view persistence
 - Page chrome: `PageHeader` (title or breadcrumbs variant), `Breadcrumbs`, `TabBar`, `BottomPanel` (resizable bottom drawer)
 - Feedback: `Spinner`, `Banner`, `Toast`, `LoadingShimmer`, `ProgressBar`
 - Overlays: `Modal`, `WizardModal` (`patterns/WizardModal`), `RightPanel`, `Popover`, `Tooltip` / `TextUnderlineTooltip`, `DropdownMenu`, `FloatingPanel`
+- Modal close button: localize the default with `PDSProvider strings={{ closeModal: translatedLabel }}` (English: "Close"), or override one modal with `contentProps.closeButtonLabel`.
 - Forms: `ConfigFormGroup`, `FormField` (`TextField`, `TextAreaField`, `TableBoxField`), `Input`, `TextArea`, `Select`, `Combobox`, `Checkbox`, `Radio`, `Toggle`, `DatePicker`
 - Status: `Sticker` (status badges), `Badge` (counts), `StatusIndicator`
+- Saved views: `TableControls` (or `DataTable.controls`) requires `onSetDefaultView` and `onUnsetDefaultView` together, or neither. Editable views offer "Set as default" / "Unset default" based on `view.isDefault`; the design system confirms before calling either callback and warns that both changes affect the entire organization. Consumers own persistence and must remove their own confirmations to avoid double prompts. Compact controls omit saved views.
+- DataTable filters: pass `filtersV2` (`TableControlsFiltersV2Props` / `FilterBarProps`) through `DataTable.controls` or directly to `TableControls` for a first-class FilterBar; defaults visible with size derived from `compact`. Hosts own V2 data filtering and feed `onChange` back to `initialState` for active-filter messaging; hydration needs no remount key. Precedence: `filterPanel` → `filtersV2` → legacy `filters`. Legacy `filters` supports `input`, `select`, `multiselect`, `combobox`, and `daterange` with optional `filterResolver`. With `clientFiltering`, `column.filter` generates legacy-only controls backed by TanStack column-filter state, not V2 filtering.
+- SmartTextInput: when method chains are allowed (`ValueType.MethodChain` or `{{...}}` interpolation), you MUST pass `renderFunctionForm`. PDS does not build the function-parameter form, so without it the dialog opened by placing the cursor in a call like `convert_to(...)` shows only the function name over an empty body. It receives `FunctionFormRenderProps` and must call `onComplete(nodes)` or `onCancel()`. In persona-web, `useDashboardSmartTextInputProps` supplies it (backed by `InputMethodChain/FunctionForm`). See components/SmartTextInput/SmartTextInput.mdx.
 - FilterBar: optional `FilterField.condition`, `pickerGroup`, and `disabledReason` support host-defined individual predicates in pills and native Rules; existing aggregate fields stay unchanged. See components/DataTable/DataTable.mdx. Hosts own feature activation and serialization.
 
 ## Testing
@@ -52,3 +57,10 @@ role/label/text queries over test IDs.
 JSON type it serializes as. Register via
 `declare module '@persona/design-system/lib/jsonSchema' { interface JsonSchemaFieldTypeRegistry { fieldTypes: typeof FIELD_TYPE_JSON_TYPES } }`;
 without registration both widen to `string`.
+
+## Colour mode
+
+`lib/colorMode` follows the dashboard's light/dark mode: `<PDSProvider colorMode={readDocumentColorMode()}>`
+installs the semantic palette and publishes it as `--pds-*` CSS variables (`FgPrimary` ->
+`var(--pds-fg-primary)`); `<ColorModeScope mode='dark'>` renders a subtree in the other mode. Plain
+CSS in portaled overlays reads the `:root` variables. See `tokens/README.md` ("Colour mode in apps").

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@persona/design-system",
-  "version": "0.9.1",
+  "version": "0.10.1",
   "description": "React components for Persona UI",
   "keywords": [
     "tanstack-intent"
@@ -90,6 +90,7 @@
     "./components/VersionHistory": "./dist/components/VersionHistory/index.mjs",
     "./lib/chainTypes": "./dist/lib/chainTypes.mjs",
     "./lib/color": "./dist/lib/color.mjs",
+    "./lib/colorMode": "./dist/lib/colorMode.mjs",
     "./lib/comboboxHelper": "./dist/lib/comboboxHelper.mjs",
     "./lib/ConfigContext": "./dist/lib/ConfigContext.mjs",
     "./lib/copyTextToClipboard": "./dist/lib/copyTextToClipboard.mjs",
@@ -141,6 +142,7 @@
     "./mixins/scrollbar": "./dist/mixins/scrollbar.mjs",
     "./mixins/text": "./dist/mixins/text.mjs",
     "./patterns/CardGrouping": "./dist/patterns/CardGrouping/index.mjs",
+    "./patterns/IndexTableLayout": "./dist/patterns/IndexTableLayout/index.mjs",
     "./patterns/LayoutLoadingShimmer": "./dist/patterns/LayoutLoadingShimmer/index.mjs",
     "./patterns/LayoutLoadingSpinner": "./dist/patterns/LayoutLoadingSpinner/index.mjs",
     "./patterns/PageLayout": "./dist/patterns/PageLayout/index.mjs",
@@ -212,8 +214,8 @@
   "devDependencies": {
     "@faker-js/faker": "^10.5.0",
     "@figma/code-connect": "^1.4.4",
-    "@persona/design-tokens": "0.4.19",
-    "@persona/icons": "0.1.8",
+    "@persona/design-tokens": "0.4.20",
+    "@persona/icons": "0.1.9",
     "@storybook/react": "^10.4.6",
     "@storybook/react-vite": "^10.4.6",
     "@tanstack/intent": "^0.3.6",
@@ -346,6 +348,7 @@
       "./components/VersionHistory": "./dist/components/VersionHistory/index.mjs",
       "./lib/chainTypes": "./dist/lib/chainTypes.mjs",
       "./lib/color": "./dist/lib/color.mjs",
+      "./lib/colorMode": "./dist/lib/colorMode.mjs",
       "./lib/comboboxHelper": "./dist/lib/comboboxHelper.mjs",
       "./lib/ConfigContext": "./dist/lib/ConfigContext.mjs",
       "./lib/copyTextToClipboard": "./dist/lib/copyTextToClipboard.mjs",
@@ -397,6 +400,7 @@
       "./mixins/scrollbar": "./dist/mixins/scrollbar.mjs",
       "./mixins/text": "./dist/mixins/text.mjs",
       "./patterns/CardGrouping": "./dist/patterns/CardGrouping/index.mjs",
+      "./patterns/IndexTableLayout": "./dist/patterns/IndexTableLayout/index.mjs",
       "./patterns/LayoutLoadingShimmer": "./dist/patterns/LayoutLoadingShimmer/index.mjs",
       "./patterns/LayoutLoadingSpinner": "./dist/patterns/LayoutLoadingSpinner/index.mjs",
       "./patterns/PageLayout": "./dist/patterns/PageLayout/index.mjs",

package/skills/ui-authoring/COMPONENTS.md

@@ -24,6 +24,7 @@ exists. If there is no `.mdx`, use the published type declarations
 | `SingleColumnLayout` | One page column, with optional tabs and a page notice. `width="wide"` uses the fluid grid | `@persona/design-system/patterns/PageLayout` |
 | `SplitColumnLayout` | An 8:4 main and aside page. Same optional regions as `SingleColumnLayout`. Stacks main then aside below 768px | `@persona/design-system/patterns/PageLayout` |
 | `DataTable` | Data table — browsing tabular data with filtering, bulk actions, search, pagination, and sorting | `@persona/design-system/components/DataTable` |
+| `IndexTableLayout` | Standard page shell for a DataTable index; hosts supply controls and own saved-view persistence | `@persona/design-system/patterns/IndexTableLayout` |
 | `FilterBar` | Structured filters with native Rules; opt-in field `condition`, `pickerGroup`, and `disabledReason` support individual host-defined predicates. Hosts own flags and serialization; see DataTable.mdx | `@persona/design-system/components/DataTable/TableControls` |
 | `DatePicker` | Picking a date or date range from a calendar | `@persona/design-system/components/DatePicker` |
 | `DropdownButton` | Opening a menu of related actions from a button | `@persona/design-system/components/DropdownButton` |
@@ -54,7 +55,7 @@ exists. If there is no `.mdx`, use the published type declarations
 | `SegmentedControl` | Picking one option from a compact set of mutually exclusive choices | `@persona/design-system/components/SegmentedControl` |
 | `Select` | Dropdown — picking one value from a short, known list with no search. Use `Combobox` when the list needs search | `@persona/design-system/components/Select` |
 | `Slider` | Picking a numeric value or range along a scale | `@persona/design-system/components/Slider` |
-| `SmartTextInput` | Authoring a value that mixes plain text with structured data references — `{{account.id}}` interpolation or a single `account.id` method chain, with autocomplete, syntax highlighting and schema validation. Use `Input` for plain text | `@persona/design-system/components/SmartTextInput` |
+| `SmartTextInput` | Authoring a value that mixes plain text with structured data references — `{{account.id}}` interpolation or a single `account.id` method chain, with autocomplete, syntax highlighting and schema validation. Use `Input` for plain text. Method chains REQUIRE `renderFunctionForm` (otherwise the function dialog is empty) — see its `.mdx` | `@persona/design-system/components/SmartTextInput` |
 | `Spacer` | Prefer `Stack` — leftover gap helper | `@persona/design-system/components/Spacer` |
 | `Spinner` | Showing that something is loading | `@persona/design-system/components/Spinner` |
 | `Stack` | Flex column — laying out children vertically with token spacing | `@persona/design-system/components/Stack` |

package/skills/ui-authoring/PATTERNS.md

@@ -15,6 +15,7 @@ Which pattern to use, and for what. Patterns with a dedicated doc link to
 | Indicators | A record’s open, pending, completed, or failed state next to other content. An in-page notice the user shouldn’t miss (success, warning, error). Use `Toast` if it can auto-dismiss |
 | [SingleColumnLayout](../../patterns/PageLayout/SingleColumnLayout.mdx) | One page column under `PageHeader`, with optional tabs and a page notice. `width="wide"` uses the fluid grid |
 | [SplitColumnLayout](../../patterns/PageLayout/SplitColumnLayout.mdx) | An 8:4 main and aside page. Same optional regions. Stacks main then aside below 768px |
+| [IndexTableLayout](../../patterns/IndexTableLayout/IndexTableLayout.mdx) | index page = `IndexTableLayout`. A standard page shell for `DataTable`; hosts provide controls and own saved-view persistence |
 | LayoutLoadingSpinner | Centered 120px loading ring that fills its container. Use as the loading state for a page or embedded app when no layout-specific shimmer exists. |
 | LayoutLoadingShimmer | Filling space while content loads |
 | [Panels](../../patterns/Panels/Panels.mdx) | Use `RightPanel` when the page should stay visible. Use `Modal` when the task needs full attention. Never a custom drawer. |
@@ -24,8 +25,9 @@ Which pattern to use, and for what. Patterns with a dedicated doc link to
 
 ## Page layouts
 
-New pages render `PageHeader`, then `SingleColumnLayout` or `SplitColumnLayout`. Do not wrap the
-template in `Container` or `Section`.
+Index pages backed by `DataTable` use `IndexTableLayout`, which owns its `Container`, `PageHeader`,
+`Section`, and `Card` shell. Other pages render `PageHeader`, then `SingleColumnLayout` or
+`SplitColumnLayout`. Do not wrap those templates in `Container` or `Section`.
 
 ```tsx
 import Header from '@persona/design-system/components/PageHeader';