@agile-team/mach-table-react 0.4.1 → 0.13.0

package/LICENSE

@@ -1,21 +1,110 @@
-MIT License
-
-Copyright (c) 2026 MachTable Contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MachTable Source-Available License 1.0
+
+Copyright (c) 2026 ChenyCHENYU (Agile Team). All rights reserved.
+
+IMPORTANT: The source code is publicly visible for review, but it is not
+open-source software as defined by the Open Source Initiative. Except for the
+limited inspection permission below, no permission is granted unless the
+copyright holder gives you prior written authorization.
+
+1. Definitions
+
+"Software" means MachTable and all source code, object code, packages,
+documentation, examples, designs, assets, and other materials distributed with
+this license.
+
+"Licensor" means ChenyCHENYU (Agile Team), the copyright holder of the
+Software.
+
+"Written Authorization" means a durable written permission issued directly by
+the Licensor that identifies the licensee and the permitted scope, purpose,
+environment, term, and any other applicable conditions.
+
+2. Limited Inspection Permission
+
+You may view the Software on the repository hosting service solely to inspect
+and evaluate it, to link to its public repository, to discuss it, and to submit
+good-faith issue reports. This limited permission does not include permission
+to use, run, build, compile, copy, download for reuse, install, integrate,
+modify, create derivative works from, deploy, distribute, sublicense, sell,
+lease, provide as a service, or otherwise exploit the Software.
+
+3. Authorization Required
+
+Any use beyond Section 2 requires the Licensor's prior Written Authorization.
+This requirement applies to personal, educational, research, governmental,
+non-profit, internal, evaluation, testing, development, staging, production,
+and commercial use. Possession of a copy, cloning the repository, downloading
+an npm package, receiving the Software from another person, or submitting a
+contribution does not grant any additional rights.
+
+The Licensor may grant separate commercial or non-commercial terms in a
+written agreement. If such an agreement conflicts with this license, that
+agreement controls only for the licensee and scope identified in it.
+
+4. Restrictions
+
+Without prior Written Authorization, you must not, directly or indirectly:
+
+a. use, execute, build, compile, install, test, or integrate the Software;
+b. copy, reproduce, modify, adapt, translate, or create derivative works;
+c. publish, distribute, sublicense, sell, rent, lease, transfer, host, or make
+   the Software available to any third party;
+d. use the Software to provide a hosted, managed, consulting, outsourcing,
+   software-as-a-service, or other service;
+e. remove or alter copyright, authorization, trademark, attribution, or other
+   proprietary notices; or
+f. represent the Software as open source or represent that you have received
+   authorization when you have not.
+
+5. Contributions
+
+Submitting a patch, pull request, code, documentation, design, or other
+material to the project does not authorize you to use the Software. Unless a
+separate written contributor agreement applies, by intentionally submitting a
+contribution you represent that you have the right to submit it and grant the
+Licensor a perpetual, worldwide, irrevocable, transferable, sublicensable,
+royalty-free license to use, reproduce, modify, create derivative works from,
+distribute, license, and relicense that contribution as part of the Software.
+
+6. Ownership and Trademarks
+
+The Software is licensed, not sold. The Licensor and applicable contributors
+retain all right, title, and interest in the Software. No trademark, service
+mark, trade name, logo, or branding rights are granted by this license.
+
+7. Termination
+
+Any permission granted under this license terminates automatically upon breach.
+On termination, you must immediately stop all use and destroy all copies in
+your possession or control, except where retention is required by law. Sections
+4 through 9 survive termination.
+
+8. Disclaimer
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE SOFTWARE IS PROVIDED "AS IS" AND
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE, AND
+NON-INFRINGEMENT.
+
+9. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, THE LICENSOR AND CONTRIBUTORS WILL NOT
+BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+CONSEQUENTIAL, OR OTHER DAMAGES, OR FOR LOSS OF DATA, PROFITS, REVENUE,
+GOODWILL, OR BUSINESS INTERRUPTION, ARISING FROM OR RELATED TO THE SOFTWARE OR
+THIS LICENSE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+10. Contact and Authorization
+
+See LICENSING.md in the repository for the authorization request process. No
+request, discussion, issue, payment, or contribution constitutes authorization
+unless and until the Licensor issues explicit Written Authorization.
+
+中文说明（仅为阅读便利；如有冲突，以英文条款为准）
+
+本项目源代码公开可查看，但不是 OSI 定义下的开源软件。除查看、链接、
+讨论和善意提交问题外，任何个人、教育、研究、公益、政府、内部、测试、
+开发、生产或商业用途，均须事先取得作者明确的书面授权。未经授权，不得
+运行、构建、复制、修改、集成、部署、分发、转授权、销售、出租、托管或
+以服务形式提供本软件。公开仓库、克隆代码或下载 npm 包不代表获得授权。

package/README.md

@@ -4,16 +4,25 @@
 
 # @agile-team/mach-table-react
 
-Official React 18+ adapter for MachTable. It provides `<MachTable>` / `<RobotGrid>`, `useMachGrid`, React cell/detail renderer factories, latest-closure event handling and StrictMode-safe cleanup.
+Official React 18+ adapter for MachTable 0.13. It provides `<MachTable>`, `MachTableProvider`, `useMachGrid`, React cell/detail renderer factories, the complete workbench/lazy-tree/semantic-column/action/state Core API, latest-closure event handling and StrictMode-safe cleanup. `RobotGrid` remains a deprecated 0.x alias.
+
+## Install
 
 ```bash
 pnpm add @agile-team/mach-table-react
 ```
 
+Import the stylesheet once from your application entry:
+
+```ts
+import "@agile-team/mach-table-react/styles.css";
+```
+
+## Direct import
+
 ```tsx
 import { useMemo } from "react";
 import { MachTable, useMachGrid, type ColDef } from "@agile-team/mach-table-react";
-import "@agile-team/mach-table-react/styles.css";
 
 interface Row { id: string; name: string }
 
@@ -37,8 +46,60 @@ export function App({ rows }: { rows: Row[] }) {
 }
 ```
 
+## Route-level lazy loading
+
+React intentionally has no global component registry. MachTable provides a default component export so the standard `React.lazy` API works without a mapping wrapper:
+
+```tsx
+import { lazy, Suspense } from "react";
+
+const MachTable = lazy(() => import("@agile-team/mach-table-react"));
+
+export function OrdersPage() {
+  return (
+    <Suspense fallback={<div>Loading table...</div>}>
+      <MachTable columnDefs={columns} rowData={rows} />
+    </Suspense>
+  );
+}
+```
+
+When the page itself is route-lazy, a normal named import inside that page already produces the same route-level split. Use `React.lazy` when the grid should be split independently from the page.
+
+## Application and route defaults
+
+Providers can be nested; the nearest defaults are merged and table props win:
+
+```tsx
+import { MachTableProvider } from "@agile-team/mach-table-react";
+
+<MachTableProvider defaults={{
+  size: "compact",
+  pagination: false,
+  defaultColDef: { sortable: true, resizable: true, filter: true }
+}}>
+  <App />
+</MachTableProvider>
+```
+
 The adapter installs the matching `@agile-team/mach-table` core automatically and re-exports its complete API and types. Only `react >= 18` and `react-dom >= 18` remain peer dependencies supplied by the host application.
 
+## Cell and full-row editing
+
+```tsx
+import { MachTable, rowActionsColumn } from "@agile-team/mach-table-react";
+
+const columns = [
+  { field: "name", editable: true },
+  { field: "age", editable: true, cellEditor: "number" },
+  rowActionsColumn({ onView, onDelete, overflow: "drawer" })
+];
+
+<MachTable editType="fullRow" columnDefs={columns} rowData={rows} />;
+```
+
+Cell mode is the default and provides a pencil plus inline confirm/cancel controls. Use `editableIndicator="always" | "hover" | "none"` to match the page density.
+
 Documentation: [React guide](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/react.md) · [Enterprise integration](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/enterprise-integration.md) · [Next.js / SSR](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/ssr.md)
 
-MIT © Agile Team
+Source-available © ChenyCHENYU (Agile Team). Any use requires prior written authorization. See the [license](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSE) and [authorization process](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSING.md).

package/dist/index.cjs

@@ -1,204 +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,
-  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);
-// 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";var x=Object.defineProperty;var I=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var F=(e,r)=>{for(var t in r)x(e,t,{get:r[t],enumerable:!0})},v=(e,r,t,a)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of _(r))!$.call(e,n)&&n!==t&&x(e,n,{get:()=>r[n],enumerable:!(a=I(r,n))||a.enumerable});return e},f=(e,r,t)=>(v(e,r,"default"),t&&v(t,r,"default"));var K=e=>v(x({},"__esModule",{value:!0}),e);var u={};F(u,{MachTable:()=>D,MachTableProvider:()=>k,RobotGrid:()=>V,default:()=>q,reactCellRenderer:()=>U,reactDetailRenderer:()=>H,useMachGrid:()=>S,useMachTableDefaults:()=>R});module.exports=K(u);var o=require("react"),l=require("@agile-team/mach-table");var d=require("react"),j=require("@agile-team/mach-table"),w=(0,d.createContext)({});function k({defaults:e,children:r}){let t=(0,d.useContext)(w),a=(0,d.useMemo)(()=>(0,j.createMachTablePreset)(t,e),[t,e]);return(0,d.createElement)(w.Provider,{value:a},r)}function R(){return(0,d.useContext)(w)}function Y(e,r){let t={};for(let a of l.GRID_OPTION_KEYS){if(a==="className")continue;let n=a==="ariaLabel"?e.gridAriaLabel:a==="ariaLabelledBy"?e.gridAriaLabelledBy:a==="ariaDescribedBy"?e.gridAriaDescribedBy:e[a];n!==void 0&&(t[a]=n)}return e.gridClassName!==void 0&&(t.className=e.gridClassName),(0,l.createMachTablePreset)(r,t)}function D(e){let{className:r,style:t,apiRef:a}=e,n=(0,o.useRef)(null),c=(0,o.useRef)(null),s=(0,o.useRef)(e);s.current=e;let E=R(),P=[E,...l.GRID_OPTION_KEYS.map(i=>i==="className"?e.gridClassName:i==="ariaLabel"?e.gridAriaLabel:i==="ariaLabelledBy"?e.gridAriaLabelledBy:i==="ariaDescribedBy"?e.gridAriaDescribedBy:e[i])],m=(0,o.useRef)(null);(!m.current||m.current.inputs.length!==P.length||P.some((i,p)=>!Object.is(i,m.current?.inputs[p])))&&(m.current={inputs:P,options:Y(e,E)});let G=m.current.options,g=(0,o.useRef)(G);g.current=G,(0,o.useEffect)(()=>{let i=n.current;if(!i)return;let p={...g.current};for(let b of l.EVENT_TYPES){let O=`on${b.charAt(0).toUpperCase()}${b.slice(1)}`;p[O]=B=>{let A=g.current[O];typeof A=="function"&&A(B);let C=s.current[O];typeof C=="function"&&C!==A&&C(B)}}let T=(0,l.createGrid)(i,p);return c.current=T,()=>{T.destroy(),c.current=null}},[]),(0,o.useEffect)(()=>{if(!a)return;let i=c.current;return a.current=i,()=>{a.current===i&&(a.current=null)}},[a]);let M=l.GRID_OPTION_KEYS.map(i=>G[i]),L=(0,o.useRef)(null);return(0,o.useEffect)(()=>{let i=L.current;if(L.current=M,!i)return;let p={};M.forEach((T,b)=>{Object.is(T,i[b])||(p[l.GRID_OPTION_KEYS[b]]=T)}),Object.keys(p).length>0&&c.current?.updateOptions(p)},M),(0,o.createElement)("div",{ref:n,className:`mach-react-host ${r??""}`.trim()||void 0,style:t,"aria-label":e["aria-label"],"aria-labelledby":e["aria-labelledby"],"aria-describedby":e["aria-describedby"]})}var V=D;var y=require("react");function S(){let[e,r]=(0,y.useState)(null),[t,a]=(0,y.useState)(!1);return{apiRef:(0,y.useMemo)(()=>{let c=null;return Object.defineProperty({},"current",{enumerable:!0,get:()=>c,set:s=>{s!==c&&(c=s,r(s),a(!1),s&&s.whenReady().then(()=>{c===s&&!s.isDestroyed()&&a(!0)}))}})},[]),api:e,ready:t}}var h=require("react"),N=require("react-dom/client");function U(e){return r=>{let t=document.createElement("div");t.className="mach-cell-react",t.style.width="100%";let a=(0,N.createRoot)(t);a.render((0,h.createElement)(e,r));let n=!1;return{el:t,destroy:()=>{n||(n=!0,window.setTimeout(()=>{a.unmount()},0))}}}}function H(e){return r=>{let t=document.createElement("div");t.style.height="100%";let a=(0,N.createRoot)(t);a.render((0,h.createElement)(e,r));let n=!1;return{el:t,destroy:()=>{n||(n=!0,window.setTimeout(()=>{a.unmount()},0))}}}}f(u,require("@agile-team/mach-table"),module.exports);var q=D;0&&(module.exports={MachTable,MachTableProvider,RobotGrid,reactCellRenderer,reactDetailRenderer,useMachGrid,useMachTableDefaults,...require("@agile-team/mach-table")});
 //# 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":["export { RobotGrid } from \"./RobotGrid\";\nexport { RobotGrid as MachTable } from \"./RobotGrid\";\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","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":"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","names":["import_react","import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/MachTable.tsx","../src/defaults.tsx","../src/useMachGrid.ts","../src/adapters.ts"],"sourcesContent":["import { MachTable, RobotGrid } from \"./MachTable\";\n\nexport { MachTable, RobotGrid };\nexport type { MachTableReactProps, RobotGridReactProps } from \"./MachTable\";\nexport { useMachGrid } from \"./useMachGrid\";\nexport type { UseMachGridReturn } from \"./useMachGrid\";\nexport { MachTableProvider, useMachTableDefaults } from \"./defaults\";\nexport type { MachTableProviderProps } from \"./defaults\";\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 MachTable;\n","import {\n  createElement,\n  useEffect,\n  useRef,\n  type CSSProperties,\n  type MutableRefObject\n} from \"react\";\nimport { createGrid, createMachTablePreset, GRID_OPTION_KEYS, EVENT_TYPES } from \"@agile-team/mach-table\";\nimport type { GridApi, GridOptions } from \"@agile-team/mach-table\";\nimport { useMachTableDefaults } from \"./defaults\";\n\ntype AdapterOnlyGridOption = \"className\" | \"ariaLabel\" | \"ariaLabelledBy\" | \"ariaDescribedBy\";\n\nexport type MachTableReactProps<TData = any> = Omit<GridOptions<TData>, AdapterOnlyGridOption> & {\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  gridAriaLabel?: string;\n  gridAriaLabelledBy?: string;\n  gridAriaDescribedBy?: string;\n  \"aria-label\"?: string;\n  \"aria-labelledby\"?: string;\n  \"aria-describedby\"?: string;\n  style?: CSSProperties;\n  apiRef?: MutableRefObject<GridApi<TData> | null>;\n};\n\nfunction collectGridOptions<TData>(\n  props: MachTableReactProps<TData>,\n  defaults: Partial<GridOptions<TData>>\n): GridOptions<TData> {\n  const explicit: Record<string, unknown> = {};\n  for (const key of GRID_OPTION_KEYS) {\n    if (key === \"className\") continue;\n    const value = key === \"ariaLabel\"\n      ? props.gridAriaLabel\n      : key === \"ariaLabelledBy\"\n        ? props.gridAriaLabelledBy\n        : key === \"ariaDescribedBy\"\n          ? props.gridAriaDescribedBy\n          : props[key];\n    if (value !== undefined) explicit[key] = value;\n  }\n  if (props.gridClassName !== undefined) explicit.className = props.gridClassName;\n  return createMachTablePreset(defaults, explicit as Partial<GridOptions<TData>>);\n}\n\nexport function MachTable<TData = any>(props: MachTableReactProps<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  const defaults = useMachTableDefaults<TData>();\n  const effectiveInputs = [\n    defaults,\n    ...GRID_OPTION_KEYS.map((key) => key === \"className\"\n      ? props.gridClassName\n      : key === \"ariaLabel\"\n        ? props.gridAriaLabel\n        : key === \"ariaLabelledBy\"\n          ? props.gridAriaLabelledBy\n          : key === \"ariaDescribedBy\"\n            ? props.gridAriaDescribedBy\n            : props[key])\n  ];\n  const effectiveCache = useRef<{ inputs: readonly unknown[]; options: GridOptions<TData> } | null>(null);\n  if (\n    !effectiveCache.current ||\n    effectiveCache.current.inputs.length !== effectiveInputs.length ||\n    effectiveInputs.some((value, index) => !Object.is(value, effectiveCache.current?.inputs[index]))\n  ) {\n    effectiveCache.current = { inputs: effectiveInputs, options: collectGridOptions(props, defaults) };\n  }\n  const effectiveOptions = effectiveCache.current.options;\n  const effectiveRef = useRef(effectiveOptions);\n  effectiveRef.current = effectiveOptions;\n\n  useEffect(() => {\n    const host = hostRef.current;\n    if (!host) return;\n\n    const options = { ...effectiveRef.current } as Record<string, unknown>;\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 defaultHandler = (effectiveRef.current as Record<string, unknown>)[handlerKey];\n        if (typeof defaultHandler === \"function\") (defaultHandler as (value: unknown) => void)(event);\n        const latest = propsRef.current as Record<string, unknown>;\n        const handler = latest[handlerKey];\n        if (typeof handler === \"function\" && handler !== defaultHandler) {\n          (handler as (value: unknown) => void)(event);\n        }\n      };\n    }\n\n    const api = createGrid<TData>(host, options);\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 optionValues = GRID_OPTION_KEYS.map((key) => effectiveOptions[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])) return;\n      changed[GRID_OPTION_KEYS[index]] = value;\n    });\n    if (Object.keys(changed).length > 0) {\n      gridApiRef.current?.updateOptions(changed);\n    }\n  }, optionValues);\n\n  return createElement(\"div\", {\n    ref: hostRef,\n    className: `mach-react-host ${className ?? \"\"}`.trim() || undefined,\n    style,\n    \"aria-label\": props[\"aria-label\"],\n    \"aria-labelledby\": props[\"aria-labelledby\"],\n    \"aria-describedby\": props[\"aria-describedby\"]\n  });\n}\n\n/** @deprecated Use MachTable. Kept as a source-compatible alias through 0.x. */\nexport const RobotGrid = MachTable;\n/** @deprecated Use MachTableReactProps. */\nexport type RobotGridReactProps<TData = any> = MachTableReactProps<TData>;\n","import { createContext, createElement, useContext, useMemo, type ReactNode } from \"react\";\nimport { createMachTablePreset, type GridOptions } from \"@agile-team/mach-table\";\n\nconst MachTableDefaultsContext = createContext<Partial<GridOptions<any>>>({});\n\nexport interface MachTableProviderProps<TData = any> {\n  defaults: Partial<GridOptions<TData>>;\n  children?: ReactNode;\n}\n\n/** Supplies app-, route- or layout-scoped defaults without making tables eager. */\nexport function MachTableProvider<TData = any>({ defaults, children }: MachTableProviderProps<TData>) {\n  const parent = useContext(MachTableDefaultsContext);\n  const value = useMemo(() => createMachTablePreset(parent, defaults), [parent, defaults]);\n  return createElement(MachTableDefaultsContext.Provider, { value }, children);\n}\n\nexport function useMachTableDefaults<TData = any>(): Partial<GridOptions<TData>> {\n  return useContext(MachTableDefaultsContext) as Partial<GridOptions<TData>>;\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  ready: boolean;\n}\n\nexport function useMachGrid<TData = any>(): UseMachGridReturn<TData> {\n  const [api, setApi] = useState<GridApi<TData> | null>(null);\n  const [ready, setReady] = useState(false);\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        setReady(false);\n        if (next) {\n          void next.whenReady().then(() => {\n            if (current === next && !next.isDestroyed()) setReady(true);\n          });\n        }\n      }\n    }) as MutableRefObject<GridApi<TData> | null>;\n  }, []);\n\n  return { apiRef, api, ready };\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":"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","names":["index_exports","__export","MachTable","MachTableProvider","RobotGrid","index_default","reactCellRenderer","reactDetailRenderer","useMachGrid","useMachTableDefaults","__toCommonJS","import_react","import_mach_table","import_react","import_mach_table","MachTableDefaultsContext","MachTableProvider","defaults","children","parent","value","useMachTableDefaults","collectGridOptions","props","defaults","explicit","key","value","MachTable","className","style","apiRef","hostRef","gridApiRef","propsRef","useMachTableDefaults","effectiveInputs","effectiveCache","index","effectiveOptions","effectiveRef","host","options","eventType","handlerKey","event","defaultHandler","handler","api","assigned","optionValues","previousOptionValues","previous","changed","RobotGrid","import_react","useMachGrid","api","setApi","ready","setReady","current","next","import_react","import_client","reactCellRenderer","Component","params","host","root","destroyed","reactDetailRenderer","__reExport","index_exports","index_default","MachTable"]}

package/dist/index.d.cts

@@ -3,26 +3,49 @@ import { CSSProperties, MutableRefObject, ReactNode, ComponentType } from 'react
 import { GridOptions, GridApi, CellRendererParams, RowNode, CellRendererFn, DetailRowRendererParams } from '@agile-team/mach-table';
 export * from '@agile-team/mach-table';
 
-type RobotGridReactProps<TData = any> = Omit<GridOptions<TData>, "className"> & {
+type AdapterOnlyGridOption = "className" | "ariaLabel" | "ariaLabelledBy" | "ariaDescribedBy";
+type MachTableReactProps<TData = any> = Omit<GridOptions<TData>, AdapterOnlyGridOption> & {
     /** 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;
+    ready: boolean;
 }
 declare function useMachGrid<TData = any>(): UseMachGridReturn<TData>;
 
+interface MachTableProviderProps<TData = any> {
+    defaults: Partial<GridOptions<TData>>;
+    children?: ReactNode;
+}
+/** Supplies app-, route- or layout-scoped defaults without making tables eager. */
+declare function MachTableProvider<TData = any>({ defaults, children }: MachTableProviderProps<TData>): react.FunctionComponentElement<react.ProviderProps<Partial<GridOptions<any>>>>;
+declare function useMachTableDefaults<TData = any>(): Partial<GridOptions<TData>>;
+
 interface ReactCellRendererProps<TData = any, TValue = any> extends CellRendererParams<TData, TValue> {
     children?: ReactNode;
 }
@@ -37,4 +60,4 @@ declare function reactDetailRenderer<TData = any>(Component: ComponentType<React
     destroy?: () => void;
 };
 
-export { RobotGrid as MachTable, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, type UseMachGridReturn, reactCellRenderer, reactDetailRenderer, useMachGrid };
+export { MachTable, MachTableProvider, type MachTableProviderProps, type MachTableReactProps, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, type UseMachGridReturn, MachTable as default, reactCellRenderer, reactDetailRenderer, useMachGrid, useMachTableDefaults };

package/dist/index.d.ts

@@ -3,26 +3,49 @@ import { CSSProperties, MutableRefObject, ReactNode, ComponentType } from 'react
 import { GridOptions, GridApi, CellRendererParams, RowNode, CellRendererFn, DetailRowRendererParams } from '@agile-team/mach-table';
 export * from '@agile-team/mach-table';
 
-type RobotGridReactProps<TData = any> = Omit<GridOptions<TData>, "className"> & {
+type AdapterOnlyGridOption = "className" | "ariaLabel" | "ariaLabelledBy" | "ariaDescribedBy";
+type MachTableReactProps<TData = any> = Omit<GridOptions<TData>, AdapterOnlyGridOption> & {
     /** 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;
+    ready: boolean;
 }
 declare function useMachGrid<TData = any>(): UseMachGridReturn<TData>;
 
+interface MachTableProviderProps<TData = any> {
+    defaults: Partial<GridOptions<TData>>;
+    children?: ReactNode;
+}
+/** Supplies app-, route- or layout-scoped defaults without making tables eager. */
+declare function MachTableProvider<TData = any>({ defaults, children }: MachTableProviderProps<TData>): react.FunctionComponentElement<react.ProviderProps<Partial<GridOptions<any>>>>;
+declare function useMachTableDefaults<TData = any>(): Partial<GridOptions<TData>>;
+
 interface ReactCellRendererProps<TData = any, TValue = any> extends CellRendererParams<TData, TValue> {
     children?: ReactNode;
 }
@@ -37,4 +60,4 @@ declare function reactDetailRenderer<TData = any>(Component: ComponentType<React
     destroy?: () => void;
 };
 
-export { RobotGrid as MachTable, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, type UseMachGridReturn, reactCellRenderer, reactDetailRenderer, useMachGrid };
+export { MachTable, MachTableProvider, type MachTableProviderProps, type MachTableReactProps, type ReactCellRendererProps, type ReactDetailProps, RobotGrid, type RobotGridReactProps, type UseMachGridReturn, MachTable as default, reactCellRenderer, reactDetailRenderer, useMachGrid, useMachTableDefaults };