@agile-team/mach-table 0.23.0 → 0.25.0

package/dist/adapter.d.ts

@@ -0,0 +1,384 @@
+import { G as GridOptions, a as GridEventType } from './options-CL6BYXVZ.js';
+export { M as MachTableOptionExplanation, R as ResolvedMachTableConfig, a as ResolvedMachTableGridOptions, m as mergeMachTableConfig, n as normalizeMachTableConfig, r as resolveMachTableGridOptions } from './configuration-CFMDwmiR.js';
+
+type EventOptionKey = `on${Capitalize<GridEventType>}`;
+type GridOptionKey = Exclude<keyof GridOptions<any>, EventOptionKey>;
+/**
+ * Runtime single source of truth for every non-event GridOptions property.
+ *
+ * The mapped `satisfies` type intentionally makes adding a GridOptions field a
+ * compile error until its adapter/update behavior is declared here.
+ */
+declare const GRID_OPTION_META: {
+    readonly columnDefs: {
+        readonly kind: "array";
+        readonly update: "columnDefs";
+    };
+    readonly rowData: {
+        readonly kind: "array";
+        readonly update: "rowData";
+    };
+    readonly defaultColDef: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly columnTypes: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly rowKey: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly rowHeight: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly headerHeight: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly rowBuffer: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly columnLayout: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly enableColumnResize: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly domLayout: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly rowSelection: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly multiSort: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly size: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly stripedRows: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly showCellBorders: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly theme: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly quickFilterText: {
+        readonly kind: "string";
+        readonly update: "quickFilter";
+    };
+    readonly advancedFilterModel: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly masterDetail: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly detailRowHeight: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly detailRowRenderer: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly isRowExpandable: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly detailToggleColumn: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly columnMenu: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly aggFuncs: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly components: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly actionPolicy: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly features: {
+        readonly kind: "array";
+        readonly update: "options";
+    };
+    readonly initialState: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly persistence: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly locale: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly editType: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly editableIndicator: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly rowEditValidator: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly singleClickEdit: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly manualSorting: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly manualFiltering: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly showSummary: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly summaryMethod: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly treeData: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly childrenKey: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly isTreeRowExpandable: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly loadTreeChildren: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly autoCheckedChildren: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly defaultExpandAll: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly indexOffset: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly applyRowDrag: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly undoStackSize: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly asyncTransactionWaitMillis: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly getRowHeight: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly pinnedTopRowData: {
+        readonly kind: "array";
+        readonly update: "options";
+    };
+    readonly pinnedBottomRowData: {
+        readonly kind: "array";
+        readonly update: "options";
+    };
+    readonly pagination: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly watermark: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly suppressWarnings: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly enableRangeSelection: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressClipboard: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly contextMenu: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly getContextMenuItems: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly tooltipComponent: {
+        readonly kind: "function";
+        readonly update: "options";
+    };
+    readonly tooltipShowDelay: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly flashCells: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly fillHandle: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly statusBar: {
+        readonly kind: "boolean-object";
+        readonly update: "options";
+    };
+    readonly datasource: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly datasourceMode: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly blockSize: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly infiniteBufferRows: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly maxBlocksInCache: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceMaxConcurrentRequests: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly blockPrefetch: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRowCount: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly dataProcessor: {
+        readonly kind: "object";
+        readonly update: "options";
+    };
+    readonly dataProcessorMinRows: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRetryCount: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRetryDelay: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly datasourceRetryJitter: {
+        readonly kind: "number";
+        readonly update: "options";
+    };
+    readonly suppressCellFocus: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressRowHoverHighlight: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressNoRowsOverlay: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly suppressHeaderFocus: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly ariaLabel: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly ariaLabelledBy: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly ariaDescribedBy: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+    readonly loading: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly error: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly overlayNoRowsTemplate: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly overlayLoadingTemplate: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly overlayErrorTemplate: {
+        readonly kind: "unknown";
+        readonly update: "options";
+    };
+    readonly allowUnsafeOverlayHtml: {
+        readonly kind: "boolean";
+        readonly update: "options";
+    };
+    readonly className: {
+        readonly kind: "string";
+        readonly update: "options";
+    };
+};
+declare const GRID_OPTION_KEYS: readonly GridOptionKey[];
+
+export { GRID_OPTION_KEYS, GRID_OPTION_META };

package/dist/adapter.js

@@ -0,0 +1 @@
+var c={columnDefs:{kind:"array",update:"columnDefs"},rowData:{kind:"array",update:"rowData"},defaultColDef:{kind:"object",update:"options"},columnTypes:{kind:"object",update:"options"},rowKey:{kind:"unknown",update:"options"},rowHeight:{kind:"number",update:"options"},headerHeight:{kind:"number",update:"options"},rowBuffer:{kind:"number",update:"options"},columnLayout:{kind:"string",update:"options"},enableColumnResize:{kind:"boolean",update:"options"},domLayout:{kind:"string",update:"options"},rowSelection:{kind:"string",update:"options"},multiSort:{kind:"boolean",update:"options"},size:{kind:"string",update:"options"},stripedRows:{kind:"boolean",update:"options"},showCellBorders:{kind:"boolean",update:"options"},theme:{kind:"string",update:"options"},quickFilterText:{kind:"string",update:"quickFilter"},advancedFilterModel:{kind:"object",update:"options"},masterDetail:{kind:"boolean",update:"options"},detailRowHeight:{kind:"number",update:"options"},detailRowRenderer:{kind:"function",update:"options"},isRowExpandable:{kind:"function",update:"options"},detailToggleColumn:{kind:"boolean",update:"options"},columnMenu:{kind:"boolean",update:"options"},aggFuncs:{kind:"object",update:"options"},components:{kind:"object",update:"options"},actionPolicy:{kind:"object",update:"options"},features:{kind:"array",update:"options"},initialState:{kind:"object",update:"options"},persistence:{kind:"boolean-object",update:"options"},locale:{kind:"object",update:"options"},editType:{kind:"string",update:"options"},editableIndicator:{kind:"string",update:"options"},rowEditValidator:{kind:"function",update:"options"},singleClickEdit:{kind:"boolean",update:"options"},manualSorting:{kind:"boolean",update:"options"},manualFiltering:{kind:"boolean",update:"options"},showSummary:{kind:"boolean",update:"options"},summaryMethod:{kind:"function",update:"options"},treeData:{kind:"boolean",update:"options"},childrenKey:{kind:"string",update:"options"},isTreeRowExpandable:{kind:"function",update:"options"},loadTreeChildren:{kind:"function",update:"options"},autoCheckedChildren:{kind:"boolean",update:"options"},defaultExpandAll:{kind:"boolean",update:"options"},indexOffset:{kind:"number",update:"options"},applyRowDrag:{kind:"boolean",update:"options"},undoStackSize:{kind:"number",update:"options"},asyncTransactionWaitMillis:{kind:"number",update:"options"},getRowHeight:{kind:"function",update:"options"},pinnedTopRowData:{kind:"array",update:"options"},pinnedBottomRowData:{kind:"array",update:"options"},pagination:{kind:"boolean-object",update:"options"},watermark:{kind:"boolean-object",update:"options"},suppressWarnings:{kind:"boolean",update:"options"},enableRangeSelection:{kind:"boolean",update:"options"},suppressClipboard:{kind:"boolean",update:"options"},contextMenu:{kind:"boolean",update:"options"},getContextMenuItems:{kind:"function",update:"options"},tooltipComponent:{kind:"function",update:"options"},tooltipShowDelay:{kind:"number",update:"options"},flashCells:{kind:"boolean",update:"options"},fillHandle:{kind:"boolean",update:"options"},statusBar:{kind:"boolean-object",update:"options"},datasource:{kind:"object",update:"options"},datasourceMode:{kind:"string",update:"options"},blockSize:{kind:"number",update:"options"},infiniteBufferRows:{kind:"number",update:"options"},maxBlocksInCache:{kind:"number",update:"options"},datasourceMaxConcurrentRequests:{kind:"number",update:"options"},blockPrefetch:{kind:"number",update:"options"},datasourceRowCount:{kind:"number",update:"options"},dataProcessor:{kind:"object",update:"options"},dataProcessorMinRows:{kind:"number",update:"options"},datasourceRetryCount:{kind:"number",update:"options"},datasourceRetryDelay:{kind:"number",update:"options"},datasourceRetryJitter:{kind:"number",update:"options"},suppressCellFocus:{kind:"boolean",update:"options"},suppressRowHoverHighlight:{kind:"boolean",update:"options"},suppressNoRowsOverlay:{kind:"boolean",update:"options"},suppressHeaderFocus:{kind:"boolean",update:"options"},ariaLabel:{kind:"string",update:"options"},ariaLabelledBy:{kind:"string",update:"options"},ariaDescribedBy:{kind:"string",update:"options"},loading:{kind:"boolean",update:"options"},error:{kind:"unknown",update:"options"},overlayNoRowsTemplate:{kind:"unknown",update:"options"},overlayLoadingTemplate:{kind:"unknown",update:"options"},overlayErrorTemplate:{kind:"unknown",update:"options"},allowUnsafeOverlayHtml:{kind:"boolean",update:"options"},className:{kind:"string",update:"options"}},g=Object.freeze(Object.keys(c)),C=Object.freeze(g.filter(e=>c[e].update==="options"));function f(e,n){return n===void 0?e:typeof n!="object"||n===null||typeof e!="object"||e===null?n:{...e,...n}}function m(e,n){return typeof e!="function"?n:typeof n!="function"?e:(...t)=>{let o;try{e(...t)}catch(a){o=a}try{n(...t)}catch(a){o??(o=a)}if(o!==void 0)throw o}}function T(e,n){let t={...e,...n,features:n.features??e.features};if((e.defaultColDef||n.defaultColDef)&&(t.defaultColDef={...e.defaultColDef,...n.defaultColDef}),(e.locale||n.locale)&&(t.locale={...e.locale,...n.locale}),(e.components||n.components)&&(t.components={cellRenderers:{...e.components?.cellRenderers,...n.components?.cellRenderers},cellEditors:{...e.components?.cellEditors,...n.components?.cellEditors}}),e.columnTypes||n.columnTypes){let o={};for(let a of new Set([...Object.keys(e.columnTypes??{}),...Object.keys(n.columnTypes??{})]))o[a]={...e.columnTypes?.[a],...n.columnTypes?.[a]};t.columnTypes=o}(e.aggFuncs||n.aggFuncs)&&(t.aggFuncs={...e.aggFuncs,...n.aggFuncs}),t.pagination=f(e.pagination,n.pagination),t.statusBar=f(e.statusBar,n.statusBar),t.watermark=f(e.watermark,n.watermark);for(let o of new Set([...Object.keys(e),...Object.keys(n)])){if(!/^on[A-Z]/.test(o))continue;let a=e[o],i=n[o];typeof a=="function"&&typeof i=="function"&&(t[o]=m(a,i))}return t}function p(...e){return e.reduce(T,{})}function y(e){return e?(Array.isArray(e)?e:[e]).filter(n=>typeof n=="string"&&n.trim().length>0):[]}var O=new Set(["rowData","columnDefs","datasource","loading","error","initialState","persistence","components","columnTypes","stateKey","stateStore","stateSaveDebounceMs","columnStateKey","columnStateStore"]);function b(e,n,t){if(!n||typeof n!="object"||Array.isArray(n))return{};let o={};for(let[a,i]of Object.entries(n)){if(!O.has(a)){o[a]=i;continue}let d={code:t==="defaults"?"INVALID_DEFAULT_OPTION":"INVALID_PRESET_OPTION",option:a,layer:t,message:`[MachTable] "${a}" is instance-only and cannot be declared in config ${t}.`};if(e.onConfigWarning?.(d),e.strict!==!1)throw new TypeError(d.message)}return o}function k(e={}){let n=b(e,e.defaults,"defaults");return{defaults:p({columnTypes:e.columnTypes,components:e.components},n),presets:Object.fromEntries(Object.entries(e.presets??{}).map(([t,o])=>[t,p(b(e,o,`preset:${t}`))])),defaultPreset:e.defaultPreset??!1,strict:e.strict!==!1,...e.onConfigWarning?{onConfigWarning:e.onConfigWarning}:{}}}function h(e,n){let t=k({...n,strict:n.strict??e.strict,onConfigWarning:n.onConfigWarning??e.onConfigWarning}),o={...e.presets};for(let[a,i]of Object.entries(t.presets))o[a]=p(e.presets[a]??{},i);return{defaults:p(e.defaults,t.defaults),presets:o,defaultPreset:n.defaultPreset===void 0?e.defaultPreset:n.defaultPreset,strict:n.strict??e.strict,...n.onConfigWarning??e.onConfigWarning?{onConfigWarning:n.onConfigWarning??e.onConfigWarning}:{}}}function D(e,n,t,o){let a=n===void 0?e.defaultPreset:n,i=[{name:"application defaults",options:e.defaults}];for(let r of y(a)){let s=e.presets[r];if(!s){let l={code:"UNKNOWN_PRESET",preset:r,message:`[MachTable] Unknown preset "${r}". Register it in mach-table.config.ts or remove the preset.`};o?o(l):e.onConfigWarning?e.onConfigWarning(l):console.warn(l.message);continue}i.push({name:`preset:${r}`,options:s})}i.push({name:"table props",options:t});let d=p(...i.map(r=>r.options));return{options:d,explain(r){let s=i.filter(u=>Object.prototype.hasOwnProperty.call(u.options,r)).map(u=>({name:u.name,value:u.options[r]})),l=s[s.length-1];return{key:r,value:d[r],source:l?.name??"MachTable built-in",layers:s}}}}export{g as GRID_OPTION_KEYS,c as GRID_OPTION_META,h as mergeMachTableConfig,k as normalizeMachTableConfig,D as resolveMachTableGridOptions};

package/dist/configuration-CFMDwmiR.d.ts

@@ -0,0 +1,57 @@
+import { G as GridOptions, C as ColDef, b as GridComponents } from './options-CL6BYXVZ.js';
+
+type MachTablePresetSelection = string | readonly string[] | false;
+type MachTableInstanceOptionKey = "rowData" | "columnDefs" | "datasource" | "loading" | "error" | "initialState" | "persistence" | "components" | "columnTypes";
+/** Safe application/preset defaults. Data, request state and persistence identity stay per table. */
+type MachTableDefaults = Omit<Partial<GridOptions<any>>, MachTableInstanceOptionKey>;
+type MachTablePreset = MachTableDefaults;
+interface MachTableConfigWarning {
+    code: "UNKNOWN_PRESET" | "INVALID_DEFAULT_OPTION" | "INVALID_PRESET_OPTION";
+    message: string;
+    preset?: string;
+    option?: string;
+    layer?: string;
+}
+interface MachTableRuntimeConfig {
+    /** Defaults inherited by every table in this application or subtree. */
+    defaults?: MachTableDefaults;
+    /** Application-wide semantic column types. Kept separate for config readability. */
+    columnTypes?: Readonly<Record<string, Partial<ColDef<any>>>>;
+    /** Application-wide renderer/editor registry. Per-table components can override it. */
+    components?: GridComponents;
+    /** Named, reusable behavior profiles such as `list`, `crud` or `picker`. */
+    presets?: Readonly<Record<string, MachTablePreset>>;
+    /** Preset used when a table does not declare its own preset. Set false to disable. */
+    defaultPreset?: MachTablePresetSelection;
+    /** Throw on unsafe config-center keys. Defaults to true. */
+    strict?: boolean;
+    onConfigWarning?: (warning: MachTableConfigWarning) => void;
+}
+interface ResolvedMachTableConfig {
+    readonly defaults: MachTableDefaults;
+    readonly presets: Readonly<Record<string, MachTablePreset>>;
+    readonly defaultPreset: MachTablePresetSelection;
+    readonly strict: boolean;
+    readonly onConfigWarning?: (warning: MachTableConfigWarning) => void;
+}
+interface MachTableOptionExplanation {
+    readonly key: keyof GridOptions<any> | string;
+    readonly value: unknown;
+    readonly source: string;
+    readonly layers: readonly {
+        name: string;
+        value: unknown;
+    }[];
+}
+interface ResolvedMachTableGridOptions<TData = any> {
+    readonly options: GridOptions<TData>;
+    explain(key: keyof GridOptions<TData> | string): MachTableOptionExplanation;
+}
+/** Type-checks a dedicated `mach-table.config.ts` without runtime work. */
+declare function defineMachTableConfig<const TConfig extends MachTableRuntimeConfig>(config: TConfig): TConfig;
+declare function normalizeMachTableConfig(config?: MachTableRuntimeConfig): ResolvedMachTableConfig;
+/** Merges app, route and layout configuration while preserving named presets. */
+declare function mergeMachTableConfig(parent: ResolvedMachTableConfig, child: MachTableRuntimeConfig): ResolvedMachTableConfig;
+declare function resolveMachTableGridOptions<TData>(config: ResolvedMachTableConfig, requestedPreset: MachTablePresetSelection | undefined, explicit: Partial<GridOptions<TData>>, reportWarning?: (warning: MachTableConfigWarning) => void): ResolvedMachTableGridOptions<TData>;
+
+export { type MachTableOptionExplanation as M, type ResolvedMachTableConfig as R, type ResolvedMachTableGridOptions as a, type MachTableConfigWarning as b, type MachTableDefaults as c, type MachTableInstanceOptionKey as d, type MachTablePreset as e, type MachTablePresetSelection as f, type MachTableRuntimeConfig as g, defineMachTableConfig as h, mergeMachTableConfig as m, normalizeMachTableConfig as n, resolveMachTableGridOptions as r };

package/dist/configuration-DmUvpJLO.d.cts

@@ -0,0 +1,57 @@
+import { G as GridOptions, C as ColDef, b as GridComponents } from './options-CL6BYXVZ.cjs';
+
+type MachTablePresetSelection = string | readonly string[] | false;
+type MachTableInstanceOptionKey = "rowData" | "columnDefs" | "datasource" | "loading" | "error" | "initialState" | "persistence" | "components" | "columnTypes";
+/** Safe application/preset defaults. Data, request state and persistence identity stay per table. */
+type MachTableDefaults = Omit<Partial<GridOptions<any>>, MachTableInstanceOptionKey>;
+type MachTablePreset = MachTableDefaults;
+interface MachTableConfigWarning {
+    code: "UNKNOWN_PRESET" | "INVALID_DEFAULT_OPTION" | "INVALID_PRESET_OPTION";
+    message: string;
+    preset?: string;
+    option?: string;
+    layer?: string;
+}
+interface MachTableRuntimeConfig {
+    /** Defaults inherited by every table in this application or subtree. */
+    defaults?: MachTableDefaults;
+    /** Application-wide semantic column types. Kept separate for config readability. */
+    columnTypes?: Readonly<Record<string, Partial<ColDef<any>>>>;
+    /** Application-wide renderer/editor registry. Per-table components can override it. */
+    components?: GridComponents;
+    /** Named, reusable behavior profiles such as `list`, `crud` or `picker`. */
+    presets?: Readonly<Record<string, MachTablePreset>>;
+    /** Preset used when a table does not declare its own preset. Set false to disable. */
+    defaultPreset?: MachTablePresetSelection;
+    /** Throw on unsafe config-center keys. Defaults to true. */
+    strict?: boolean;
+    onConfigWarning?: (warning: MachTableConfigWarning) => void;
+}
+interface ResolvedMachTableConfig {
+    readonly defaults: MachTableDefaults;
+    readonly presets: Readonly<Record<string, MachTablePreset>>;
+    readonly defaultPreset: MachTablePresetSelection;
+    readonly strict: boolean;
+    readonly onConfigWarning?: (warning: MachTableConfigWarning) => void;
+}
+interface MachTableOptionExplanation {
+    readonly key: keyof GridOptions<any> | string;
+    readonly value: unknown;
+    readonly source: string;
+    readonly layers: readonly {
+        name: string;
+        value: unknown;
+    }[];
+}
+interface ResolvedMachTableGridOptions<TData = any> {
+    readonly options: GridOptions<TData>;
+    explain(key: keyof GridOptions<TData> | string): MachTableOptionExplanation;
+}
+/** Type-checks a dedicated `mach-table.config.ts` without runtime work. */
+declare function defineMachTableConfig<const TConfig extends MachTableRuntimeConfig>(config: TConfig): TConfig;
+declare function normalizeMachTableConfig(config?: MachTableRuntimeConfig): ResolvedMachTableConfig;
+/** Merges app, route and layout configuration while preserving named presets. */
+declare function mergeMachTableConfig(parent: ResolvedMachTableConfig, child: MachTableRuntimeConfig): ResolvedMachTableConfig;
+declare function resolveMachTableGridOptions<TData>(config: ResolvedMachTableConfig, requestedPreset: MachTablePresetSelection | undefined, explicit: Partial<GridOptions<TData>>, reportWarning?: (warning: MachTableConfigWarning) => void): ResolvedMachTableGridOptions<TData>;
+
+export { type MachTableOptionExplanation as M, type ResolvedMachTableConfig as R, type ResolvedMachTableGridOptions as a, type MachTableConfigWarning as b, type MachTableDefaults as c, type MachTableInstanceOptionKey as d, type MachTablePreset as e, type MachTablePresetSelection as f, type MachTableRuntimeConfig as g, defineMachTableConfig as h, mergeMachTableConfig as m, normalizeMachTableConfig as n, resolveMachTableGridOptions as r };