@agile-team/mach-table-react 0.5.0 → 0.14.0

package/dist/index.cjs

@@ -1,206 +1,2 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  MachTable: () => RobotGrid,
-  RobotGrid: () => RobotGrid,
-  default: () => index_default,
-  reactCellRenderer: () => reactCellRenderer,
-  reactDetailRenderer: () => reactDetailRenderer,
-  useMachGrid: () => useMachGrid
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/RobotGrid.tsx
-var import_react = require("react");
-var import_mach_table = require("@agile-team/mach-table");
-var UPDATABLE_KEYS = import_mach_table.DIRECT_GRID_OPTION_KEYS.filter((key) => key !== "className");
-function RobotGrid(props) {
-  const { className, style, apiRef } = props;
-  const hostRef = (0, import_react.useRef)(null);
-  const gridApiRef = (0, import_react.useRef)(null);
-  const propsRef = (0, import_react.useRef)(props);
-  propsRef.current = props;
-  (0, import_react.useEffect)(() => {
-    const host = hostRef.current;
-    if (!host) return;
-    const initial = propsRef.current;
-    const options = {};
-    for (const key of Object.keys(initial)) {
-      if (key === "className" || key === "gridClassName" || key === "style" || key === "apiRef") continue;
-      if (key.startsWith("on")) continue;
-      options[key] = initial[key];
-    }
-    if (initial.gridClassName !== void 0) options.className = initial.gridClassName;
-    for (const eventType of import_mach_table.EVENT_TYPES) {
-      const handlerKey = `on${eventType.charAt(0).toUpperCase()}${eventType.slice(1)}`;
-      options[handlerKey] = (event) => {
-        const latest = propsRef.current;
-        const handler = latest[handlerKey];
-        if (typeof handler === "function") handler(event);
-      };
-    }
-    const api = (0, import_mach_table.createGrid)(host, options);
-    gridApiRef.current = api;
-    return () => {
-      api.destroy();
-      gridApiRef.current = null;
-    };
-  }, []);
-  (0, import_react.useEffect)(() => {
-    if (!apiRef) return;
-    const assigned = gridApiRef.current;
-    apiRef.current = assigned;
-    return () => {
-      if (apiRef.current === assigned) apiRef.current = null;
-    };
-  }, [apiRef]);
-  const rowDataReady = (0, import_react.useRef)(false);
-  (0, import_react.useEffect)(() => {
-    if (!rowDataReady.current) {
-      rowDataReady.current = true;
-      return;
-    }
-    gridApiRef.current?.setRowData(props.rowData);
-  }, [props.rowData]);
-  const columnDefsReady = (0, import_react.useRef)(false);
-  (0, import_react.useEffect)(() => {
-    if (!columnDefsReady.current) {
-      columnDefsReady.current = true;
-      return;
-    }
-    gridApiRef.current?.setColumnDefs(props.columnDefs);
-  }, [props.columnDefs]);
-  const quickFilterReady = (0, import_react.useRef)(false);
-  (0, import_react.useEffect)(() => {
-    if (!quickFilterReady.current) {
-      quickFilterReady.current = true;
-      return;
-    }
-    gridApiRef.current?.setQuickFilter(props.quickFilterText);
-  }, [props.quickFilterText]);
-  const gridClassNameReady = (0, import_react.useRef)(false);
-  (0, import_react.useEffect)(() => {
-    if (!gridClassNameReady.current) {
-      gridClassNameReady.current = true;
-      return;
-    }
-    gridApiRef.current?.updateOptions({ className: props.gridClassName });
-  }, [props.gridClassName]);
-  const optionValues = UPDATABLE_KEYS.map((key) => props[key]);
-  const previousOptionValues = (0, import_react.useRef)(null);
-  (0, import_react.useEffect)(() => {
-    const previous = previousOptionValues.current;
-    previousOptionValues.current = optionValues;
-    if (!previous) {
-      return;
-    }
-    const changed = {};
-    optionValues.forEach((value, index) => {
-      if (!Object.is(value, previous[index])) changed[UPDATABLE_KEYS[index]] = value;
-    });
-    if (Object.keys(changed).length > 0) {
-      gridApiRef.current?.updateOptions(changed);
-    }
-  }, optionValues);
-  return (0, import_react.createElement)("div", {
-    ref: hostRef,
-    className: `mach-react-host ${className ?? ""}`.trim() || void 0,
-    style
-  });
-}
-
-// src/useMachGrid.ts
-var import_react2 = require("react");
-function useMachGrid() {
-  const [api, setApi] = (0, import_react2.useState)(null);
-  const apiRef = (0, import_react2.useMemo)(() => {
-    let current = null;
-    return Object.defineProperty({}, "current", {
-      enumerable: true,
-      get: () => current,
-      set: (next) => {
-        if (next === current) return;
-        current = next;
-        setApi(next);
-      }
-    });
-  }, []);
-  return { apiRef, api };
-}
-
-// src/adapters.ts
-var import_react3 = require("react");
-var import_client = require("react-dom/client");
-function reactCellRenderer(Component) {
-  return (params) => {
-    const host = document.createElement("div");
-    host.className = "mach-cell-react";
-    host.style.width = "100%";
-    const root = (0, import_client.createRoot)(host);
-    root.render((0, import_react3.createElement)(Component, params));
-    let destroyed = false;
-    return {
-      el: host,
-      destroy: () => {
-        if (destroyed) return;
-        destroyed = true;
-        window.setTimeout(() => {
-          root.unmount();
-        }, 0);
-      }
-    };
-  };
-}
-function reactDetailRenderer(Component) {
-  return (params) => {
-    const host = document.createElement("div");
-    host.style.height = "100%";
-    const root = (0, import_client.createRoot)(host);
-    root.render((0, import_react3.createElement)(Component, params));
-    let destroyed = false;
-    return {
-      el: host,
-      destroy: () => {
-        if (destroyed) return;
-        destroyed = true;
-        window.setTimeout(() => {
-          root.unmount();
-        }, 0);
-      }
-    };
-  };
-}
-
-// src/index.ts
-__reExport(index_exports, require("@agile-team/mach-table"), module.exports);
-var index_default = RobotGrid;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MachTable,
-  RobotGrid,
-  reactCellRenderer,
-  reactDetailRenderer,
-  useMachGrid,
-  ...require("@agile-team/mach-table")
-});
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _createStarExport(obj) { Object.keys(obj) .filter((key) => key !== "default" && key !== "__esModule") .forEach((key) => { if (exports.hasOwnProperty(key)) { return; } Object.defineProperty(exports, key, {enumerable: true, configurable: true, get: () => obj[key]}); }); } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var _chunkZ5XSUQ5Ocjs = require('./chunk-Z5XSUQ5O.cjs');var _react = require('react');var _machtable = require('@agile-team/mach-table'); _createStarExport(_machtable);var I=_machtable.normalizeMachTableConfig.call(void 0, ),T=_react.createContext.call(void 0, I);function Q({config:e,defaults:a,children:r}){let t=_react.useContext.call(void 0, T),n=_react.useMemo.call(void 0, ()=>_machtable.mergeMachTableConfig.call(void 0, t,{..._nullishCoalesce(e, () => ({})),...a?{defaults:a}:{}}),[t,e,a]);return _react.createElement.call(void 0, T.Provider,{value:n},r)}function j(){return _react.useContext.call(void 0, T).defaults}function P(){return _react.useContext.call(void 0, T)}function W(e,a){let r={};for(let t of _machtable.GRID_OPTION_KEYS){if(t==="className")continue;let n=t==="ariaLabel"?e.gridAriaLabel:t==="ariaLabelledBy"?e.gridAriaLabelledBy:t==="ariaDescribedBy"?e.gridAriaDescribedBy:e[t];n!==void 0&&(r[t]=n)}return e.gridClassName!==void 0&&(r.className=e.gridClassName),_machtable.resolveMachTableGridOptions.call(void 0, a,e.preset,r).options}function N(e){let{className:a,style:r,apiRef:t}=e,n=_react.useRef.call(void 0, null),b=_react.useRef.call(void 0, null),G=_react.useRef.call(void 0, e);G.current=e;let O=P(),y=[O,e.preset,..._machtable.GRID_OPTION_KEYS.map(o=>o==="className"?e.gridClassName:o==="ariaLabel"?e.gridAriaLabel:o==="ariaLabelledBy"?e.gridAriaLabelledBy:o==="ariaDescribedBy"?e.gridAriaDescribedBy:e[o])],u=_react.useRef.call(void 0, null);(!u.current||u.current.inputs.length!==y.length||y.some((o,i)=>!Object.is(o,_optionalChain([u, 'access', _2 => _2.current, 'optionalAccess', _3 => _3.inputs, 'access', _4 => _4[i]]))))&&(u.current={inputs:y,options:W(e,O)});let R=u.current.options,g=_react.useRef.call(void 0, R);g.current=R,_react.useEffect.call(void 0, ()=>{let o=n.current;if(!o)return;let i={...g.current};for(let f of _machtable.EVENT_TYPES){let p=`on${f.charAt(0).toUpperCase()}${f.slice(1)}`;i[p]=A=>{let D=g.current[p];typeof D=="function"&&D(A);let C=G.current[p];typeof C=="function"&&C!==D&&C(A)}}let m=_machtable.createGrid.call(void 0, o,i);return b.current=m,()=>{m.destroy(),b.current=null}},[]),_react.useEffect.call(void 0, ()=>{if(!t)return;let o=b.current;return t.current=o,()=>{t.current===o&&(t.current=null)}},[t]);let M=_machtable.GRID_OPTION_KEYS.map(o=>R[o]),E=_react.useRef.call(void 0, null);return _react.useEffect.call(void 0, ()=>{let o=E.current;if(E.current=M,!o)return;let i={};M.forEach((m,f)=>{Object.is(m,o[f])||(i[_machtable.GRID_OPTION_KEYS[f]]=m)}),Object.keys(i).length>0&&_optionalChain([b, 'access', _5 => _5.current, 'optionalAccess', _6 => _6.updateOptions, 'call', _7 => _7(i)])},M),_react.createElement.call(void 0, "div",{ref:n,className:`mach-react-host ${_nullishCoalesce(a, () => (""))}`.trim()||void 0,style:r,"aria-label":e["aria-label"],"aria-labelledby":e["aria-labelledby"],"aria-describedby":e["aria-describedby"]})}var J=N;var X={search:!0,refresh:!0,columns:!0,density:!0,export:!0,undoRedo:!1,fullscreen:!1};function c(e,a){return _nullishCoalesce(_optionalChain([e, 'optionalAccess', _8 => _8[a]]), () => (X[a]))}function d(e,a,r,t=!1){return _react.createElement.call(void 0, "button",{key:e,type:"button",className:"mach-toolbar__button",title:e,"aria-label":e,disabled:t,onClick:r},a)}function Z(e){let a=[e.start],r=_nullishCoalesce(e.searchPlaceholder, () => ("\u641C\u7D22\u5F53\u524D\u7ED3\u679C"));return c(e.features,"search")&&a.push(_react.createElement.call(void 0, "label",{className:"mach-toolbar__search",key:"search"},_react.createElement.call(void 0, "span",{className:"mach-sr-only"},r),_react.createElement.call(void 0, "span",{"aria-hidden":!0},"\u2315"),_react.createElement.call(void 0, "input",{type:"search",value:_nullishCoalesce(e.search, () => ("")),placeholder:r,onChange:t=>{let n=t.currentTarget.value;_optionalChain([e, 'access', _9 => _9.onSearchChange, 'optionalCall', _10 => _10(n)]),e.onSearchChange||(e.commands?e.commands.search(n||null):_optionalChain([e, 'access', _11 => _11.api, 'optionalAccess', _12 => _12.setQuickFilter, 'call', _13 => _13(n||null)]))}}))),c(e.features,"refresh")&&a.push(d("\u5237\u65B0",e.loading?"\u2026":"\u21BB",()=>{_optionalChain([e, 'access', _14 => _14.onRefresh, 'optionalCall', _15 => _15()]),e.onRefresh||(e.commands?e.commands.refresh():_optionalChain([e, 'access', _16 => _16.api, 'optionalAccess', _17 => _17.isInfinite, 'call', _18 => _18()])?e.api.reload():_optionalChain([e, 'access', _19 => _19.api, 'optionalAccess', _20 => _20.refreshCells, 'call', _21 => _21()]))},e.loading)),c(e.features,"columns")&&a.push(d("\u5217\u8BBE\u7F6E","\u2637",t=>{e.commands?e.commands.openColumns(t.currentTarget):_optionalChain([e, 'access', _22 => _22.api, 'optionalAccess', _23 => _23.openColumnWorkbench, 'call', _24 => _24(t.currentTarget)])})),c(e.features,"density")&&a.push(_react.createElement.call(void 0, "select",{key:"density",className:"mach-toolbar__select",value:_nullishCoalesce(_optionalChain([e, 'access', _25 => _25.api, 'optionalAccess', _26 => _26.getGridOption, 'call', _27 => _27("size")]), () => ("normal")),"aria-label":"\u8868\u683C\u5BC6\u5EA6",onChange:t=>{let n=t.currentTarget.value;e.commands?e.commands.setDensity(n):_optionalChain([e, 'access', _28 => _28.api, 'optionalAccess', _29 => _29.setGridOption, 'call', _30 => _30("size",n)])}},_react.createElement.call(void 0, "option",{value:"compact"},"\u7D27\u51D1"),_react.createElement.call(void 0, "option",{value:"normal"},"\u6807\u51C6"),_react.createElement.call(void 0, "option",{value:"large"},"\u5BBD\u677E"))),a.push(e.children),a}function ee(e){e.commands?e.commands.undo():_optionalChain([e, 'access', _31 => _31.api, 'optionalAccess', _32 => _32.undo, 'call', _33 => _33()])}function ae(e){e.commands?e.commands.redo():_optionalChain([e, 'access', _34 => _34.api, 'optionalAccess', _35 => _35.redo, 'call', _36 => _36()])}function te(e){let a=[];return(_nullishCoalesce(e.selectedCount, () => (0)))>0&&a.push(_react.createElement.call(void 0, "button",{type:"button",className:"mach-toolbar__selection",onClick:()=>_optionalChain([e, 'access', _37 => _37.onClearSelection, 'optionalCall', _38 => _38()])},`\u5DF2\u9009 ${e.selectedCount} \u9879 \xD7`)),c(e.features,"undoRedo")&&(a.push(d("\u64A4\u9500","\u21B6",()=>ee(e),e.commands?!e.commands.canUndo():!_optionalChain([e, 'access', _39 => _39.api, 'optionalAccess', _40 => _40.canUndo, 'call', _41 => _41()]))),a.push(d("\u91CD\u505A","\u21B7",()=>ae(e),e.commands?!e.commands.canRedo():!_optionalChain([e, 'access', _42 => _42.api, 'optionalAccess', _43 => _43.canRedo, 'call', _44 => _44()])))),c(e.features,"export")&&a.push(d("\u5BFC\u51FA CSV","\u21E9",()=>{_optionalChain([e, 'access', _45 => _45.commands, 'optionalAccess', _46 => _46.exportCsv, 'call', _47 => _47(e.exportFilename)])},!e.commands)),c(e.features,"fullscreen")&&a.push(d("\u5168\u5C4F","\u26F6",()=>{_optionalChain([e, 'access', _48 => _48.commands, 'optionalAccess', _49 => _49.toggleFullscreen, 'call', _50 => _50()])},!e.commands)),a.push(e.end),a}function re(e){return _react.createElement.call(void 0, "div",{className:"mach-toolbar",role:"toolbar","aria-label":"\u8868\u683C\u5DE5\u5177\u680F"},_react.createElement.call(void 0, "div",{className:"mach-toolbar__main"},...Z(e)),_react.createElement.call(void 0, "div",{className:"mach-toolbar__aside"},...te(e)))}var _client = require('react-dom/client');function ne(e){return a=>{let r=document.createElement("div");r.className="mach-cell-react",r.style.width="100%";let t=_client.createRoot.call(void 0, r);t.render(_react.createElement.call(void 0, e,a));let n=!1;return{el:r,destroy:()=>{n||(n=!0,window.setTimeout(()=>{t.unmount()},0))}}}}function oe(e){return a=>{let r=document.createElement("div");r.style.height="100%";let t=_client.createRoot.call(void 0, r);t.render(_react.createElement.call(void 0, e,a));let n=!1;return{el:r,destroy:()=>{n||(n=!0,window.setTimeout(()=>{t.unmount()},0))}}}}var pe=N;exports.MachTable = N; exports.MachTableProvider = Q; exports.MachTableToolbar = re; exports.RobotGrid = J; exports.default = pe; exports.reactCellRenderer = ne; exports.reactDetailRenderer = oe; exports.useMachGrid = _chunkZ5XSUQ5Ocjs.a; exports.useMachTableConfig = P; exports.useMachTableController = _chunkZ5XSUQ5Ocjs.d; exports.useMachTableDefaults = j; exports.useMachTableEditing = _chunkZ5XSUQ5Ocjs.b; exports.useMachTableQuery = _chunkZ5XSUQ5Ocjs.c;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/RobotGrid.tsx","../src/useMachGrid.ts","../src/adapters.ts"],"sourcesContent":["import { RobotGrid } from \"./RobotGrid\";\n\nexport { RobotGrid };\nexport { RobotGrid as MachTable };\nexport type { RobotGridReactProps } from \"./RobotGrid\";\nexport { useMachGrid } from \"./useMachGrid\";\nexport type { UseMachGridReturn } from \"./useMachGrid\";\nexport { reactCellRenderer, reactDetailRenderer } from \"./adapters\";\nexport type { ReactCellRendererProps, ReactDetailProps } from \"./adapters\";\nexport * from \"@agile-team/mach-table\";\n\n/** Enables `React.lazy(() => import(\"@agile-team/mach-table-react\"))`. */\nexport default RobotGrid;\n","import {\n  createElement,\n  useEffect,\n  useRef,\n  type CSSProperties,\n  type MutableRefObject\n} from \"react\";\nimport { createGrid, DIRECT_GRID_OPTION_KEYS, EVENT_TYPES } from \"@agile-team/mach-table\";\nimport type { GridApi, GridOptions } from \"@agile-team/mach-table\";\n\nexport type RobotGridReactProps<TData = any> = Omit<GridOptions<TData>, \"className\"> & {\n  /** CSS class applied to the React host element. */\n  className?: string;\n  /** CSS class forwarded to MachTable's inner grid root. */\n  gridClassName?: string;\n  style?: CSSProperties;\n  apiRef?: MutableRefObject<GridApi<TData> | null>;\n};\n\nconst UPDATABLE_KEYS = DIRECT_GRID_OPTION_KEYS.filter((key) => key !== \"className\");\n\nexport function RobotGrid<TData = any>(props: RobotGridReactProps<TData>) {\n  const { className, style, apiRef } = props;\n  const hostRef = useRef<HTMLDivElement | null>(null);\n  const gridApiRef = useRef<GridApi<TData> | null>(null);\n  const propsRef = useRef(props);\n  propsRef.current = props;\n\n  useEffect(() => {\n    const host = hostRef.current;\n    if (!host) return;\n\n    const initial = propsRef.current;\n    const options: Record<string, unknown> = {};\n    for (const key of Object.keys(initial) as string[]) {\n      if (key === \"className\" || key === \"gridClassName\" || key === \"style\" || key === \"apiRef\") continue;\n      if (key.startsWith(\"on\")) continue;\n      options[key] = (initial as Record<string, unknown>)[key];\n    }\n    if (initial.gridClassName !== undefined) options.className = initial.gridClassName;\n    for (const eventType of EVENT_TYPES) {\n      const handlerKey = `on${eventType.charAt(0).toUpperCase()}${eventType.slice(1)}`;\n      options[handlerKey] = (event: unknown) => {\n        const latest = propsRef.current as Record<string, unknown>;\n        const handler = latest[handlerKey];\n        if (typeof handler === \"function\") (handler as (event: unknown) => void)(event);\n      };\n    }\n\n    const api = createGrid<TData>(host, options as GridOptions<TData>);\n    gridApiRef.current = api;\n    return () => {\n      api.destroy();\n      gridApiRef.current = null;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (!apiRef) return;\n    const assigned = gridApiRef.current;\n    apiRef.current = assigned;\n    return () => {\n      if (apiRef.current === assigned) apiRef.current = null;\n    };\n  }, [apiRef]);\n\n  const rowDataReady = useRef(false);\n  useEffect(() => {\n    if (!rowDataReady.current) {\n      rowDataReady.current = true;\n      return;\n    }\n    gridApiRef.current?.setRowData(props.rowData);\n  }, [props.rowData]);\n\n  const columnDefsReady = useRef(false);\n  useEffect(() => {\n    if (!columnDefsReady.current) {\n      columnDefsReady.current = true;\n      return;\n    }\n    gridApiRef.current?.setColumnDefs(props.columnDefs);\n  }, [props.columnDefs]);\n\n  const quickFilterReady = useRef(false);\n  useEffect(() => {\n    if (!quickFilterReady.current) {\n      quickFilterReady.current = true;\n      return;\n    }\n    gridApiRef.current?.setQuickFilter(props.quickFilterText);\n  }, [props.quickFilterText]);\n\n  const gridClassNameReady = useRef(false);\n  useEffect(() => {\n    if (!gridClassNameReady.current) {\n      gridClassNameReady.current = true;\n      return;\n    }\n    gridApiRef.current?.updateOptions({ className: props.gridClassName });\n  }, [props.gridClassName]);\n\n  const optionValues = UPDATABLE_KEYS.map((key) => props[key]);\n  const previousOptionValues = useRef<readonly unknown[] | null>(null);\n  useEffect(() => {\n    const previous = previousOptionValues.current;\n    previousOptionValues.current = optionValues;\n    if (!previous) {\n      return;\n    }\n    const changed: Record<string, unknown> = {};\n    optionValues.forEach((value, index) => {\n      if (!Object.is(value, previous[index])) changed[UPDATABLE_KEYS[index]] = value;\n    });\n    if (Object.keys(changed).length > 0) {\n      gridApiRef.current?.updateOptions(changed as Partial<GridOptions<TData>>);\n    }\n  }, optionValues);\n\n  return createElement(\"div\", {\n    ref: hostRef,\n    className: `mach-react-host ${className ?? \"\"}`.trim() || undefined,\n    style\n  });\n}\n","import { useMemo, useState, type MutableRefObject } from \"react\";\nimport type { GridApi } from \"@agile-team/mach-table\";\n\nexport interface UseMachGridReturn<TData = any> {\n  apiRef: MutableRefObject<GridApi<TData> | null>;\n  api: GridApi<TData> | null;\n}\n\nexport function useMachGrid<TData = any>(): UseMachGridReturn<TData> {\n  const [api, setApi] = useState<GridApi<TData> | null>(null);\n  const apiRef = useMemo(() => {\n    let current: GridApi<TData> | null = null;\n    return Object.defineProperty({}, \"current\", {\n      enumerable: true,\n      get: () => current,\n      set: (next: GridApi<TData> | null) => {\n        if (next === current) return;\n        current = next;\n        setApi(next);\n      }\n    }) as MutableRefObject<GridApi<TData> | null>;\n  }, []);\n\n  return { apiRef, api };\n}\n","import { createElement, isValidElement, type ComponentType, type ReactNode } from \"react\";\nimport { createRoot } from \"react-dom/client\";\nimport type { CellRendererParams, CellRendererFn, DetailRowRendererParams, GridApi, RowNode } from \"@agile-team/mach-table\";\n\nexport interface ReactCellRendererProps<TData = any, TValue = any> extends CellRendererParams<TData, TValue> {\n  children?: ReactNode;\n}\n\nexport interface ReactDetailProps<TData = any> {\n  data: TData | null;\n  node: RowNode<TData>;\n  api: GridApi<TData>;\n}\n\nexport function reactCellRenderer<TData = any, TValue = any>(\n  Component: ComponentType<ReactCellRendererProps<TData, TValue>>\n): CellRendererFn {\n  return (params) => {\n    const host = document.createElement(\"div\");\n    host.className = \"mach-cell-react\";\n    host.style.width = \"100%\";\n    const root = createRoot(host);\n    root.render(createElement(Component, params as ReactCellRendererProps<TData, TValue>));\n    let destroyed = false;\n    return {\n      el: host,\n      destroy: () => {\n        if (destroyed) return;\n        destroyed = true;\n        window.setTimeout(() => {\n          root.unmount();\n        }, 0);\n      }\n    };\n  };\n}\n\nexport function reactDetailRenderer<TData = any>(\n  Component: ComponentType<ReactDetailProps<TData>>\n): (params: DetailRowRendererParams<TData>) => { el: HTMLElement; destroy?: () => void } {\n  return (params) => {\n    const host = document.createElement(\"div\");\n    host.style.height = \"100%\";\n    const root = createRoot(host);\n    root.render(createElement(Component, params));\n    let destroyed = false;\n    return {\n      el: host,\n      destroy: () => {\n        if (destroyed) return;\n        destroyed = true;\n        window.setTimeout(() => {\n          root.unmount();\n        }, 0);\n      }\n    };\n  };\n}\n\nexport function isReactElement(value: unknown): boolean {\n  return isValidElement(value);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAMO;AACP,wBAAiE;AAYjE,IAAM,iBAAiB,0CAAwB,OAAO,CAAC,QAAQ,QAAQ,WAAW;AAE3E,SAAS,UAAuB,OAAmC;AACxE,QAAM,EAAE,WAAW,OAAO,OAAO,IAAI;AACrC,QAAM,cAAU,qBAA8B,IAAI;AAClD,QAAM,iBAAa,qBAA8B,IAAI;AACrD,QAAM,eAAW,qBAAO,KAAK;AAC7B,WAAS,UAAU;AAEnB,8BAAU,MAAM;AACd,UAAM,OAAO,QAAQ;AACrB,QAAI,CAAC,KAAM;AAEX,UAAM,UAAU,SAAS;AACzB,UAAM,UAAmC,CAAC;AAC1C,eAAW,OAAO,OAAO,KAAK,OAAO,GAAe;AAClD,UAAI,QAAQ,eAAe,QAAQ,mBAAmB,QAAQ,WAAW,QAAQ,SAAU;AAC3F,UAAI,IAAI,WAAW,IAAI,EAAG;AAC1B,cAAQ,GAAG,IAAK,QAAoC,GAAG;AAAA,IACzD;AACA,QAAI,QAAQ,kBAAkB,OAAW,SAAQ,YAAY,QAAQ;AACrE,eAAW,aAAa,+BAAa;AACnC,YAAM,aAAa,KAAK,UAAU,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,UAAU,MAAM,CAAC,CAAC;AAC9E,cAAQ,UAAU,IAAI,CAAC,UAAmB;AACxC,cAAM,SAAS,SAAS;AACxB,cAAM,UAAU,OAAO,UAAU;AACjC,YAAI,OAAO,YAAY,WAAY,CAAC,QAAqC,KAAK;AAAA,MAChF;AAAA,IACF;AAEA,UAAM,UAAM,8BAAkB,MAAM,OAA6B;AACjE,eAAW,UAAU;AACrB,WAAO,MAAM;AACX,UAAI,QAAQ;AACZ,iBAAW,UAAU;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,8BAAU,MAAM;AACd,QAAI,CAAC,OAAQ;AACb,UAAM,WAAW,WAAW;AAC5B,WAAO,UAAU;AACjB,WAAO,MAAM;AACX,UAAI,OAAO,YAAY,SAAU,QAAO,UAAU;AAAA,IACpD;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEX,QAAM,mBAAe,qBAAO,KAAK;AACjC,8BAAU,MAAM;AACd,QAAI,CAAC,aAAa,SAAS;AACzB,mBAAa,UAAU;AACvB;AAAA,IACF;AACA,eAAW,SAAS,WAAW,MAAM,OAAO;AAAA,EAC9C,GAAG,CAAC,MAAM,OAAO,CAAC;AAElB,QAAM,sBAAkB,qBAAO,KAAK;AACpC,8BAAU,MAAM;AACd,QAAI,CAAC,gBAAgB,SAAS;AAC5B,sBAAgB,UAAU;AAC1B;AAAA,IACF;AACA,eAAW,SAAS,cAAc,MAAM,UAAU;AAAA,EACpD,GAAG,CAAC,MAAM,UAAU,CAAC;AAErB,QAAM,uBAAmB,qBAAO,KAAK;AACrC,8BAAU,MAAM;AACd,QAAI,CAAC,iBAAiB,SAAS;AAC7B,uBAAiB,UAAU;AAC3B;AAAA,IACF;AACA,eAAW,SAAS,eAAe,MAAM,eAAe;AAAA,EAC1D,GAAG,CAAC,MAAM,eAAe,CAAC;AAE1B,QAAM,yBAAqB,qBAAO,KAAK;AACvC,8BAAU,MAAM;AACd,QAAI,CAAC,mBAAmB,SAAS;AAC/B,yBAAmB,UAAU;AAC7B;AAAA,IACF;AACA,eAAW,SAAS,cAAc,EAAE,WAAW,MAAM,cAAc,CAAC;AAAA,EACtE,GAAG,CAAC,MAAM,aAAa,CAAC;AAExB,QAAM,eAAe,eAAe,IAAI,CAAC,QAAQ,MAAM,GAAG,CAAC;AAC3D,QAAM,2BAAuB,qBAAkC,IAAI;AACnE,8BAAU,MAAM;AACd,UAAM,WAAW,qBAAqB;AACtC,yBAAqB,UAAU;AAC/B,QAAI,CAAC,UAAU;AACb;AAAA,IACF;AACA,UAAM,UAAmC,CAAC;AAC1C,iBAAa,QAAQ,CAAC,OAAO,UAAU;AACrC,UAAI,CAAC,OAAO,GAAG,OAAO,SAAS,KAAK,CAAC,EAAG,SAAQ,eAAe,KAAK,CAAC,IAAI;AAAA,IAC3E,CAAC;AACD,QAAI,OAAO,KAAK,OAAO,EAAE,SAAS,GAAG;AACnC,iBAAW,SAAS,cAAc,OAAsC;AAAA,IAC1E;AAAA,EACF,GAAG,YAAY;AAEf,aAAO,4BAAc,OAAO;AAAA,IAC1B,KAAK;AAAA,IACL,WAAW,mBAAmB,aAAa,EAAE,GAAG,KAAK,KAAK;AAAA,IAC1D;AAAA,EACF,CAAC;AACH;;;AC5HA,IAAAA,gBAAyD;AAQlD,SAAS,cAAqD;AACnE,QAAM,CAAC,KAAK,MAAM,QAAI,wBAAgC,IAAI;AAC1D,QAAM,aAAS,uBAAQ,MAAM;AAC3B,QAAI,UAAiC;AACrC,WAAO,OAAO,eAAe,CAAC,GAAG,WAAW;AAAA,MAC1C,YAAY;AAAA,MACZ,KAAK,MAAM;AAAA,MACX,KAAK,CAAC,SAAgC;AACpC,YAAI,SAAS,QAAS;AACtB,kBAAU;AACV,eAAO,IAAI;AAAA,MACb;AAAA,IACF,CAAC;AAAA,EACH,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,QAAQ,IAAI;AACvB;;;ACxBA,IAAAC,gBAAkF;AAClF,oBAA2B;AAapB,SAAS,kBACd,WACgB;AAChB,SAAO,CAAC,WAAW;AACjB,UAAM,OAAO,SAAS,cAAc,KAAK;AACzC,SAAK,YAAY;AACjB,SAAK,MAAM,QAAQ;AACnB,UAAM,WAAO,0BAAW,IAAI;AAC5B,SAAK,WAAO,6BAAc,WAAW,MAA+C,CAAC;AACrF,QAAI,YAAY;AAChB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,SAAS,MAAM;AACb,YAAI,UAAW;AACf,oBAAY;AACZ,eAAO,WAAW,MAAM;AACtB,eAAK,QAAQ;AAAA,QACf,GAAG,CAAC;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,oBACd,WACuF;AACvF,SAAO,CAAC,WAAW;AACjB,UAAM,OAAO,SAAS,cAAc,KAAK;AACzC,SAAK,MAAM,SAAS;AACpB,UAAM,WAAO,0BAAW,IAAI;AAC5B,SAAK,WAAO,6BAAc,WAAW,MAAM,CAAC;AAC5C,QAAI,YAAY;AAChB,WAAO;AAAA,MACL,IAAI;AAAA,MACJ,SAAS,MAAM;AACb,YAAI,UAAW;AACf,oBAAY;AACZ,eAAO,WAAW,MAAM;AACtB,eAAK,QAAQ;AAAA,QACf,GAAG,CAAC;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;;;AHhDA,0BAAc,mCATd;AAYA,IAAO,gBAAQ;","names":["import_react","import_react"]}
+{"version":3,"sources":["d:\\office-project\\wl\\MachTable\\packages\\react\\dist\\index.cjs"],"names":[],"mappings":"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","file":"D:\\office-project\\wl\\MachTable\\packages\\react\\dist\\index.cjs","sourcesContent":[null]}

package/dist/index.d.cts

@@ -1,27 +1,81 @@
 import * as react from 'react';
 import { CSSProperties, MutableRefObject, ReactNode, ComponentType } from 'react';
-import { GridOptions, GridApi, CellRendererParams, RowNode, CellRendererFn, DetailRowRendererParams } from '@agile-team/mach-table';
+import { GridOptions, MachTablePresetSelection, GridApi, MachTableCommands, MachTableRuntimeConfig, ResolvedMachTableConfig, CellRendererParams, RowNode, CellRendererFn, DetailRowRendererParams } from '@agile-team/mach-table';
 export * from '@agile-team/mach-table';
+export { M as MachTablePageRequest, a as MachTablePageResult, b as MachTableQuerySource, c as MachTableRemoteSelectionState, U as UseMachGridReturn, d as UseMachTableControllerOptions, e as UseMachTableControllerReturn, f as UseMachTableEditingOptions, g as UseMachTableEditingReturn, h as UseMachTableQueryOptions, i as UseMachTableQueryReturn, u as useMachGrid, j as useMachTableController, k as useMachTableEditing, l as useMachTableQuery } from './workflows-BhNumPcR.cjs';
 
-type RobotGridReactProps<TData = any> = Omit<GridOptions<TData>, "className"> & {
+type AdapterOnlyGridOption = "className" | "ariaLabel" | "ariaLabelledBy" | "ariaDescribedBy";
+type MachTableReactProps<TData = any> = Omit<GridOptions<TData>, AdapterOnlyGridOption> & {
+    /** Named application preset(s). Explicit component props still win. */
+    preset?: MachTablePresetSelection;
     /** CSS class applied to the React host element. */
     className?: string;
     /** CSS class forwarded to MachTable's inner grid root. */
     gridClassName?: string;
+    gridAriaLabel?: string;
+    gridAriaLabelledBy?: string;
+    gridAriaDescribedBy?: string;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
     style?: CSSProperties;
     apiRef?: MutableRefObject<GridApi<TData> | null>;
 };
-declare function RobotGrid<TData = any>(props: RobotGridReactProps<TData>): react.DetailedReactHTMLElement<{
+declare function MachTable<TData = any>(props: MachTableReactProps<TData>): react.DetailedReactHTMLElement<{
     ref: MutableRefObject<HTMLDivElement | null>;
     className: string | undefined;
     style: CSSProperties | undefined;
+    "aria-label": string | undefined;
+    "aria-labelledby": string | undefined;
+    "aria-describedby": string | undefined;
 }, HTMLDivElement>;
+/** @deprecated Use MachTable. Kept as a source-compatible alias through 0.x. */
+declare const RobotGrid: typeof MachTable;
+/** @deprecated Use MachTableReactProps. */
+type RobotGridReactProps<TData = any> = MachTableReactProps<TData>;
 
-interface UseMachGridReturn<TData = any> {
-    apiRef: MutableRefObject<GridApi<TData> | null>;
-    api: GridApi<TData> | null;
+interface MachTableToolbarFeatures {
+    search?: boolean;
+    refresh?: boolean;
+    columns?: boolean;
+    density?: boolean;
+    export?: boolean;
+    undoRedo?: boolean;
+    fullscreen?: boolean;
 }
-declare function useMachGrid<TData = any>(): UseMachGridReturn<TData>;
+interface MachTableToolbarProps<TData = any> {
+    api?: GridApi<TData> | null;
+    commands?: MachTableCommands | null;
+    search?: string;
+    onSearchChange?(value: string): void;
+    onRefresh?(): void;
+    onClearSelection?(): void;
+    loading?: boolean;
+    selectedCount?: number;
+    searchPlaceholder?: string;
+    exportFilename?: string;
+    features?: MachTableToolbarFeatures;
+    start?: ReactNode;
+    children?: ReactNode;
+    end?: ReactNode;
+}
+declare function MachTableToolbar<TData = any>(props: MachTableToolbarProps<TData>): react.DetailedReactHTMLElement<{
+    className: string;
+    role: "toolbar";
+    "aria-label": string;
+}, HTMLElement>;
+
+interface MachTableProviderProps<TData = any> {
+    /** Full app/route configuration. Prefer importing this from mach-table.config.ts. */
+    config?: MachTableRuntimeConfig;
+    /** Backwards-compatible shorthand for config.defaults. */
+    defaults?: Partial<GridOptions<TData>>;
+    children?: ReactNode;
+}
+/** Supplies app-, route- or layout-scoped defaults without making tables eager. */
+declare function MachTableProvider<TData = any>({ config, defaults, children }: MachTableProviderProps<TData>): react.FunctionComponentElement<react.ProviderProps<ResolvedMachTableConfig>>;
+declare function useMachTableDefaults<TData = any>(): Partial<GridOptions<TData>>;
+declare function useMachTableConfig(): ResolvedMachTableConfig;
 
 interface ReactCellRendererProps<TData = any, TValue = any> extends CellRendererParams<TData, TValue> {
     children?: ReactNode;
@@ -37,4 +91,4 @@ declare function reactDetailRenderer<TData = any>(Component: ComponentType<React
     destroy?: () => void;
 };
 
-export { RobotGrid as MachTable, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, type UseMachGridReturn, RobotGrid as default, reactCellRenderer, reactDetailRenderer, useMachGrid };
+export { MachTable, MachTableProvider, type MachTableProviderProps, type MachTableReactProps, MachTableToolbar, type MachTableToolbarFeatures, type MachTableToolbarProps, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, MachTable as default, reactCellRenderer, reactDetailRenderer, useMachTableConfig, useMachTableDefaults };

package/dist/index.d.ts

@@ -1,27 +1,81 @@
 import * as react from 'react';
 import { CSSProperties, MutableRefObject, ReactNode, ComponentType } from 'react';
-import { GridOptions, GridApi, CellRendererParams, RowNode, CellRendererFn, DetailRowRendererParams } from '@agile-team/mach-table';
+import { GridOptions, MachTablePresetSelection, GridApi, MachTableCommands, MachTableRuntimeConfig, ResolvedMachTableConfig, CellRendererParams, RowNode, CellRendererFn, DetailRowRendererParams } from '@agile-team/mach-table';
 export * from '@agile-team/mach-table';
+export { M as MachTablePageRequest, a as MachTablePageResult, b as MachTableQuerySource, c as MachTableRemoteSelectionState, U as UseMachGridReturn, d as UseMachTableControllerOptions, e as UseMachTableControllerReturn, f as UseMachTableEditingOptions, g as UseMachTableEditingReturn, h as UseMachTableQueryOptions, i as UseMachTableQueryReturn, u as useMachGrid, j as useMachTableController, k as useMachTableEditing, l as useMachTableQuery } from './workflows-BhNumPcR.js';
 
-type RobotGridReactProps<TData = any> = Omit<GridOptions<TData>, "className"> & {
+type AdapterOnlyGridOption = "className" | "ariaLabel" | "ariaLabelledBy" | "ariaDescribedBy";
+type MachTableReactProps<TData = any> = Omit<GridOptions<TData>, AdapterOnlyGridOption> & {
+    /** Named application preset(s). Explicit component props still win. */
+    preset?: MachTablePresetSelection;
     /** CSS class applied to the React host element. */
     className?: string;
     /** CSS class forwarded to MachTable's inner grid root. */
     gridClassName?: string;
+    gridAriaLabel?: string;
+    gridAriaLabelledBy?: string;
+    gridAriaDescribedBy?: string;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
     style?: CSSProperties;
     apiRef?: MutableRefObject<GridApi<TData> | null>;
 };
-declare function RobotGrid<TData = any>(props: RobotGridReactProps<TData>): react.DetailedReactHTMLElement<{
+declare function MachTable<TData = any>(props: MachTableReactProps<TData>): react.DetailedReactHTMLElement<{
     ref: MutableRefObject<HTMLDivElement | null>;
     className: string | undefined;
     style: CSSProperties | undefined;
+    "aria-label": string | undefined;
+    "aria-labelledby": string | undefined;
+    "aria-describedby": string | undefined;
 }, HTMLDivElement>;
+/** @deprecated Use MachTable. Kept as a source-compatible alias through 0.x. */
+declare const RobotGrid: typeof MachTable;
+/** @deprecated Use MachTableReactProps. */
+type RobotGridReactProps<TData = any> = MachTableReactProps<TData>;
 
-interface UseMachGridReturn<TData = any> {
-    apiRef: MutableRefObject<GridApi<TData> | null>;
-    api: GridApi<TData> | null;
+interface MachTableToolbarFeatures {
+    search?: boolean;
+    refresh?: boolean;
+    columns?: boolean;
+    density?: boolean;
+    export?: boolean;
+    undoRedo?: boolean;
+    fullscreen?: boolean;
 }
-declare function useMachGrid<TData = any>(): UseMachGridReturn<TData>;
+interface MachTableToolbarProps<TData = any> {
+    api?: GridApi<TData> | null;
+    commands?: MachTableCommands | null;
+    search?: string;
+    onSearchChange?(value: string): void;
+    onRefresh?(): void;
+    onClearSelection?(): void;
+    loading?: boolean;
+    selectedCount?: number;
+    searchPlaceholder?: string;
+    exportFilename?: string;
+    features?: MachTableToolbarFeatures;
+    start?: ReactNode;
+    children?: ReactNode;
+    end?: ReactNode;
+}
+declare function MachTableToolbar<TData = any>(props: MachTableToolbarProps<TData>): react.DetailedReactHTMLElement<{
+    className: string;
+    role: "toolbar";
+    "aria-label": string;
+}, HTMLElement>;
+
+interface MachTableProviderProps<TData = any> {
+    /** Full app/route configuration. Prefer importing this from mach-table.config.ts. */
+    config?: MachTableRuntimeConfig;
+    /** Backwards-compatible shorthand for config.defaults. */
+    defaults?: Partial<GridOptions<TData>>;
+    children?: ReactNode;
+}
+/** Supplies app-, route- or layout-scoped defaults without making tables eager. */
+declare function MachTableProvider<TData = any>({ config, defaults, children }: MachTableProviderProps<TData>): react.FunctionComponentElement<react.ProviderProps<ResolvedMachTableConfig>>;
+declare function useMachTableDefaults<TData = any>(): Partial<GridOptions<TData>>;
+declare function useMachTableConfig(): ResolvedMachTableConfig;
 
 interface ReactCellRendererProps<TData = any, TValue = any> extends CellRendererParams<TData, TValue> {
     children?: ReactNode;
@@ -37,4 +91,4 @@ declare function reactDetailRenderer<TData = any>(Component: ComponentType<React
     destroy?: () => void;
 };
 
-export { RobotGrid as MachTable, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, type UseMachGridReturn, RobotGrid as default, reactCellRenderer, reactDetailRenderer, useMachGrid };
+export { MachTable, MachTableProvider, type MachTableProviderProps, type MachTableReactProps, MachTableToolbar, type MachTableToolbarFeatures, type MachTableToolbarProps, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, MachTable as default, reactCellRenderer, reactDetailRenderer, useMachTableConfig, useMachTableDefaults };

package/dist/index.js

@@ -1,177 +1,2 @@
-// src/RobotGrid.tsx
-import {
-  createElement,
-  useEffect,
-  useRef
-} from "react";
-import { createGrid, DIRECT_GRID_OPTION_KEYS, EVENT_TYPES } from "@agile-team/mach-table";
-var UPDATABLE_KEYS = DIRECT_GRID_OPTION_KEYS.filter((key) => key !== "className");
-function RobotGrid(props) {
-  const { className, style, apiRef } = props;
-  const hostRef = useRef(null);
-  const gridApiRef = useRef(null);
-  const propsRef = useRef(props);
-  propsRef.current = props;
-  useEffect(() => {
-    const host = hostRef.current;
-    if (!host) return;
-    const initial = propsRef.current;
-    const options = {};
-    for (const key of Object.keys(initial)) {
-      if (key === "className" || key === "gridClassName" || key === "style" || key === "apiRef") continue;
-      if (key.startsWith("on")) continue;
-      options[key] = initial[key];
-    }
-    if (initial.gridClassName !== void 0) options.className = initial.gridClassName;
-    for (const eventType of EVENT_TYPES) {
-      const handlerKey = `on${eventType.charAt(0).toUpperCase()}${eventType.slice(1)}`;
-      options[handlerKey] = (event) => {
-        const latest = propsRef.current;
-        const handler = latest[handlerKey];
-        if (typeof handler === "function") handler(event);
-      };
-    }
-    const api = createGrid(host, options);
-    gridApiRef.current = api;
-    return () => {
-      api.destroy();
-      gridApiRef.current = null;
-    };
-  }, []);
-  useEffect(() => {
-    if (!apiRef) return;
-    const assigned = gridApiRef.current;
-    apiRef.current = assigned;
-    return () => {
-      if (apiRef.current === assigned) apiRef.current = null;
-    };
-  }, [apiRef]);
-  const rowDataReady = useRef(false);
-  useEffect(() => {
-    if (!rowDataReady.current) {
-      rowDataReady.current = true;
-      return;
-    }
-    gridApiRef.current?.setRowData(props.rowData);
-  }, [props.rowData]);
-  const columnDefsReady = useRef(false);
-  useEffect(() => {
-    if (!columnDefsReady.current) {
-      columnDefsReady.current = true;
-      return;
-    }
-    gridApiRef.current?.setColumnDefs(props.columnDefs);
-  }, [props.columnDefs]);
-  const quickFilterReady = useRef(false);
-  useEffect(() => {
-    if (!quickFilterReady.current) {
-      quickFilterReady.current = true;
-      return;
-    }
-    gridApiRef.current?.setQuickFilter(props.quickFilterText);
-  }, [props.quickFilterText]);
-  const gridClassNameReady = useRef(false);
-  useEffect(() => {
-    if (!gridClassNameReady.current) {
-      gridClassNameReady.current = true;
-      return;
-    }
-    gridApiRef.current?.updateOptions({ className: props.gridClassName });
-  }, [props.gridClassName]);
-  const optionValues = UPDATABLE_KEYS.map((key) => props[key]);
-  const previousOptionValues = useRef(null);
-  useEffect(() => {
-    const previous = previousOptionValues.current;
-    previousOptionValues.current = optionValues;
-    if (!previous) {
-      return;
-    }
-    const changed = {};
-    optionValues.forEach((value, index) => {
-      if (!Object.is(value, previous[index])) changed[UPDATABLE_KEYS[index]] = value;
-    });
-    if (Object.keys(changed).length > 0) {
-      gridApiRef.current?.updateOptions(changed);
-    }
-  }, optionValues);
-  return createElement("div", {
-    ref: hostRef,
-    className: `mach-react-host ${className ?? ""}`.trim() || void 0,
-    style
-  });
-}
-
-// src/useMachGrid.ts
-import { useMemo, useState } from "react";
-function useMachGrid() {
-  const [api, setApi] = useState(null);
-  const apiRef = useMemo(() => {
-    let current = null;
-    return Object.defineProperty({}, "current", {
-      enumerable: true,
-      get: () => current,
-      set: (next) => {
-        if (next === current) return;
-        current = next;
-        setApi(next);
-      }
-    });
-  }, []);
-  return { apiRef, api };
-}
-
-// src/adapters.ts
-import { createElement as createElement2, isValidElement } from "react";
-import { createRoot } from "react-dom/client";
-function reactCellRenderer(Component) {
-  return (params) => {
-    const host = document.createElement("div");
-    host.className = "mach-cell-react";
-    host.style.width = "100%";
-    const root = createRoot(host);
-    root.render(createElement2(Component, params));
-    let destroyed = false;
-    return {
-      el: host,
-      destroy: () => {
-        if (destroyed) return;
-        destroyed = true;
-        window.setTimeout(() => {
-          root.unmount();
-        }, 0);
-      }
-    };
-  };
-}
-function reactDetailRenderer(Component) {
-  return (params) => {
-    const host = document.createElement("div");
-    host.style.height = "100%";
-    const root = createRoot(host);
-    root.render(createElement2(Component, params));
-    let destroyed = false;
-    return {
-      el: host,
-      destroy: () => {
-        if (destroyed) return;
-        destroyed = true;
-        window.setTimeout(() => {
-          root.unmount();
-        }, 0);
-      }
-    };
-  };
-}
-
-// src/index.ts
-export * from "@agile-team/mach-table";
-var index_default = RobotGrid;
-export {
-  RobotGrid as MachTable,
-  RobotGrid,
-  index_default as default,
-  reactCellRenderer,
-  reactDetailRenderer,
-  useMachGrid
-};
+import{a as L,b as _,c as k,d as F}from"./chunk-VVQCWQ2C.js";import{createElement as $,useEffect as x,useRef as s}from"react";import{createGrid as q,GRID_OPTION_KEYS as h,EVENT_TYPES as K,resolveMachTableGridOptions as Y}from"@agile-team/mach-table";import{createContext as B,createElement as U,useContext as v,useMemo as V}from"react";import{mergeMachTableConfig as z,normalizeMachTableConfig as H}from"@agile-team/mach-table";var I=H(),T=B(I);function Q({config:e,defaults:a,children:r}){let t=v(T),n=V(()=>z(t,{...e??{},...a?{defaults:a}:{}}),[t,e,a]);return U(T.Provider,{value:n},r)}function j(){return v(T).defaults}function P(){return v(T)}function W(e,a){let r={};for(let t of h){if(t==="className")continue;let n=t==="ariaLabel"?e.gridAriaLabel:t==="ariaLabelledBy"?e.gridAriaLabelledBy:t==="ariaDescribedBy"?e.gridAriaDescribedBy:e[t];n!==void 0&&(r[t]=n)}return e.gridClassName!==void 0&&(r.className=e.gridClassName),Y(a,e.preset,r).options}function N(e){let{className:a,style:r,apiRef:t}=e,n=s(null),b=s(null),G=s(e);G.current=e;let O=P(),y=[O,e.preset,...h.map(o=>o==="className"?e.gridClassName:o==="ariaLabel"?e.gridAriaLabel:o==="ariaLabelledBy"?e.gridAriaLabelledBy:o==="ariaDescribedBy"?e.gridAriaDescribedBy:e[o])],u=s(null);(!u.current||u.current.inputs.length!==y.length||y.some((o,i)=>!Object.is(o,u.current?.inputs[i])))&&(u.current={inputs:y,options:W(e,O)});let R=u.current.options,g=s(R);g.current=R,x(()=>{let o=n.current;if(!o)return;let i={...g.current};for(let f of K){let p=`on${f.charAt(0).toUpperCase()}${f.slice(1)}`;i[p]=A=>{let D=g.current[p];typeof D=="function"&&D(A);let C=G.current[p];typeof C=="function"&&C!==D&&C(A)}}let m=q(o,i);return b.current=m,()=>{m.destroy(),b.current=null}},[]),x(()=>{if(!t)return;let o=b.current;return t.current=o,()=>{t.current===o&&(t.current=null)}},[t]);let M=h.map(o=>R[o]),E=s(null);return x(()=>{let o=E.current;if(E.current=M,!o)return;let i={};M.forEach((m,f)=>{Object.is(m,o[f])||(i[h[f]]=m)}),Object.keys(i).length>0&&b.current?.updateOptions(i)},M),$("div",{ref:n,className:`mach-react-host ${a??""}`.trim()||void 0,style:r,"aria-label":e["aria-label"],"aria-labelledby":e["aria-labelledby"],"aria-describedby":e["aria-describedby"]})}var J=N;import{createElement as l}from"react";var X={search:!0,refresh:!0,columns:!0,density:!0,export:!0,undoRedo:!1,fullscreen:!1};function c(e,a){return e?.[a]??X[a]}function d(e,a,r,t=!1){return l("button",{key:e,type:"button",className:"mach-toolbar__button",title:e,"aria-label":e,disabled:t,onClick:r},a)}function Z(e){let a=[e.start],r=e.searchPlaceholder??"\u641C\u7D22\u5F53\u524D\u7ED3\u679C";return c(e.features,"search")&&a.push(l("label",{className:"mach-toolbar__search",key:"search"},l("span",{className:"mach-sr-only"},r),l("span",{"aria-hidden":!0},"\u2315"),l("input",{type:"search",value:e.search??"",placeholder:r,onChange:t=>{let n=t.currentTarget.value;e.onSearchChange?.(n),e.onSearchChange||(e.commands?e.commands.search(n||null):e.api?.setQuickFilter(n||null))}}))),c(e.features,"refresh")&&a.push(d("\u5237\u65B0",e.loading?"\u2026":"\u21BB",()=>{e.onRefresh?.(),e.onRefresh||(e.commands?e.commands.refresh():e.api?.isInfinite()?e.api.reload():e.api?.refreshCells())},e.loading)),c(e.features,"columns")&&a.push(d("\u5217\u8BBE\u7F6E","\u2637",t=>{e.commands?e.commands.openColumns(t.currentTarget):e.api?.openColumnWorkbench(t.currentTarget)})),c(e.features,"density")&&a.push(l("select",{key:"density",className:"mach-toolbar__select",value:e.api?.getGridOption("size")??"normal","aria-label":"\u8868\u683C\u5BC6\u5EA6",onChange:t=>{let n=t.currentTarget.value;e.commands?e.commands.setDensity(n):e.api?.setGridOption("size",n)}},l("option",{value:"compact"},"\u7D27\u51D1"),l("option",{value:"normal"},"\u6807\u51C6"),l("option",{value:"large"},"\u5BBD\u677E"))),a.push(e.children),a}function ee(e){e.commands?e.commands.undo():e.api?.undo()}function ae(e){e.commands?e.commands.redo():e.api?.redo()}function te(e){let a=[];return(e.selectedCount??0)>0&&a.push(l("button",{type:"button",className:"mach-toolbar__selection",onClick:()=>e.onClearSelection?.()},`\u5DF2\u9009 ${e.selectedCount} \u9879 \xD7`)),c(e.features,"undoRedo")&&(a.push(d("\u64A4\u9500","\u21B6",()=>ee(e),e.commands?!e.commands.canUndo():!e.api?.canUndo())),a.push(d("\u91CD\u505A","\u21B7",()=>ae(e),e.commands?!e.commands.canRedo():!e.api?.canRedo()))),c(e.features,"export")&&a.push(d("\u5BFC\u51FA CSV","\u21E9",()=>{e.commands?.exportCsv(e.exportFilename)},!e.commands)),c(e.features,"fullscreen")&&a.push(d("\u5168\u5C4F","\u26F6",()=>{e.commands?.toggleFullscreen()},!e.commands)),a.push(e.end),a}function re(e){return l("div",{className:"mach-toolbar",role:"toolbar","aria-label":"\u8868\u683C\u5DE5\u5177\u680F"},l("div",{className:"mach-toolbar__main"},...Z(e)),l("div",{className:"mach-toolbar__aside"},...te(e)))}import{createElement as S,isValidElement as ye}from"react";import{createRoot as w}from"react-dom/client";function ne(e){return a=>{let r=document.createElement("div");r.className="mach-cell-react",r.style.width="100%";let t=w(r);t.render(S(e,a));let n=!1;return{el:r,destroy:()=>{n||(n=!0,window.setTimeout(()=>{t.unmount()},0))}}}}function oe(e){return a=>{let r=document.createElement("div");r.style.height="100%";let t=w(r);t.render(S(e,a));let n=!1;return{el:r,destroy:()=>{n||(n=!0,window.setTimeout(()=>{t.unmount()},0))}}}}export*from"@agile-team/mach-table";var pe=N;export{N as MachTable,Q as MachTableProvider,re as MachTableToolbar,J as RobotGrid,pe as default,ne as reactCellRenderer,oe as reactDetailRenderer,L as useMachGrid,P as useMachTableConfig,F as useMachTableController,j as useMachTableDefaults,_ as useMachTableEditing,k as useMachTableQuery};
 //# sourceMappingURL=index.js.map