robobyte-front-builder 1.0.25 → 1.0.27

package/INTEGRATION.md

@@ -173,6 +173,9 @@ function RoboByteBridge({ children }) {
       user={auth.user}
       accessToken={auth.accessToken}
       agGridLicenseKey={process.env.NEXT_PUBLIC_AG_GRID_LICENSE_KEY}
+      // Optional — Quartz theme overrides for every <AgGridReact> in the
+      // package. Merged on top of the package defaults.
+      // agGridTheme={{ accentColor: '#3b82f6', headerHeight: 32 }}
     >
       {children}
     </RoboByteFrontBuilderProvider>
@@ -200,11 +203,15 @@ export default function App({ Component, pageProps }) {
 | `user`             | object   | Current user object from your auth context |
 | `accessToken`      | string   | Bearer token — attached to every robobyte service call |
 | `agGridLicenseKey` | string   | AG Grid Enterprise license key. The provider calls `LicenseManager.setLicenseKey()` and registers `AllEnterpriseModule` + `IntegratedChartsModule.with(AgChartsEnterpriseModule)` internally. |
+| `agGridTheme`      | object   | Optional. Quartz theme overrides applied to every `<AgGridReact>` in the package. Merged on top of `DEFAULT_AG_THEME_PARAMS` (see [`src/lib/agGridTheme.js`](src/lib/agGridTheme.js)). Example: `{ accentColor: '#3b82f6', headerHeight: 32 }`. |
 | `navExtensions`    | array    | Static nav items to inject into the sidebar (optional) |
 | `endpoints`        | object   | Full-URL overrides per endpoint group + name (optional) |
 
 > **AG Grid note:** Do not call `LicenseManager` or `ModuleRegistry` in the
-> host app — the provider handles it entirely via `agGridLicenseKey`.
+> host app — the provider handles it entirely via `agGridLicenseKey`. The
+> theme is also handled internally — do not pass `theme={...}` to
+> individual `<AgGridReact>` instances rendered by the package; the
+> `agGridTheme` prop is the single source of truth.
 
 ---
 
@@ -308,17 +315,35 @@ Paths to stub out:
 Fetches report data by `pageId` without any AG Grid dependency. The canonical
 implementation lives in the package at `services/reportData/fetchReportData`.
 
-### Sourcing — always from the package
+For the full host-app reference (cancellation in `useEffect`, memoizing
+filters, paginated cursor hook, exporting to XLSX, all recipes and pitfalls),
+see **[`docs/fetchReportData.md`](docs/fetchReportData.md)**. The companion
+in-builder Calculation manual is **[`training/48-fetchReportData.md`](training/48-fetchReportData.md)**
+(the auto-injected `fetchReportData` symbol).
 
-The `packageOwnedServices` entry in `next.config.js` (§4) routes every import
-of `services/reportData/fetchReportData` — from any file, host or package — to
-the package's copy via `NormalModuleReplacementPlugin`. The host app's local
-copy (if any) should be emptied out and never executed.
+### Sourcing — both import paths work
 
-### Usage
+Since v1.0.23, the recommended import is the package surface:
+
+```js
+import { fetchReportDataByPageId } from 'robobyte-front-builder'
+```
+
+The legacy bare-alias path also still works and resolves to the same module
+via the `NormalModuleReplacementPlugin` rule:
 
 ```js
 import fetchReportDataByPageId from 'services/reportData/fetchReportData'
+```
+
+Both paths point to the same file, so the in-memory `builderModelCache` is
+shared. Pick the package import for new code — it doesn't depend on the
+webpack rule.
+
+### Usage
+
+```js
+import { fetchReportDataByPageId } from 'robobyte-front-builder'
 
 const result = await fetchReportDataByPageId({
   pageId,            // string | number — required
@@ -374,9 +399,18 @@ import { ReportViewer } from 'robobyte-front-builder'
   noHeader={true}
   filter={{ Tfilter: [...] }}
   height="400px"
+  title="Q1 Orders"            // toolbar title (left side)
+  caption="2026-01-01 → 2026-03-31"
 />
 ```
 
+For the complete host-app reference — every prop, the new `viewerActions` /
+`title` / `caption` / `debug` props, `setOutGridApi` for raw AG Grid API
+access, building filters from React state, master/detail patterns, dialog
+embedding, all pitfalls — see **[`docs/ReportViewer.md`](docs/ReportViewer.md)**.
+The schema-side AI manual for the same component is
+**[`training/35-reportViewer.md`](training/35-reportViewer.md)**.
+
 ### Props
 
 | Prop            | Type     | Description |
@@ -858,9 +892,9 @@ The print builder persists layouts via four REST endpoints. The host API must im
 
 The `value` field is the schema serialised with `JSON.stringify`. The print builder deserialises it with `JSON.parse` after fetching.
 
-### Step 3 — Trigger print from a view
+### Step 3 — Trigger print from a view (inside the builder)
 
-Inside any action code (button `onClick`, row action, etc.) in a UI Builder view:
+Inside any action code (button `onClick`, row action, viewer action, form `onSubmit`, etc.) in a UI Builder view:
 
 ```js
 openPrintLayout('your-layout-id', {
@@ -871,7 +905,57 @@ openPrintLayout('your-layout-id', {
 })
 ```
 
-`openPrintLayout` is injected into every action's execution scope automatically by `ProductionViewer`. No import is needed.
+`openPrintLayout` is injected into every action's execution scope automatically by `ProductionViewer`. No import is needed. The companion helper `closePrintLayout()` dismisses the dialog programmatically.
+
+For the full Calculation-scope reference (data shape, all trigger points, recipes for row actions / viewer actions / form submits, pitfalls), see **[`training/49-printLayout.md`](training/49-printLayout.md)**.
+
+### Step 3b — Trigger print from host-app code (outside the builder)
+
+When you need to print from regular host-app React code — a custom page, an action handler, a dialog, a hook, anywhere outside a builder Calculation — use the imperative `PrintDialog` API.
+
+The pattern, condensed:
+
+```jsx
+// host-app/pages/invoices.jsx (or any host React file)
+import { useRef } from 'react'
+import PrintDialog from 'views/builder/viewer/PrintDialog'  // bare-aliased import
+
+export default function InvoicesPage() {
+  const printDialogRef = useRef(null)
+
+  const viewerContext = {
+    printDialogRef,
+    data: {}, setData: () => {}, form: {}, setForm: () => {},
+    mode: 'preview', isEditMode: false, isPreviewMode: true, isPrintContext: true,
+  }
+
+  return (
+    <>
+      <Button
+        onClick={() => printDialogRef.current?.open('invoice-layout-id', {
+          invoiceNumber: 'INV-1042',
+          customerName:  'Acme Corp',
+          lines:         [{ sku: 'A', qty: 2 }],
+        })}
+      >
+        Print Invoice
+      </Button>
+
+      <PrintDialog viewerContext={viewerContext} />
+    </>
+  )
+}
+```
+
+Three things to know:
+
+1. **The `PrintDialog` import is bare-aliased.** Either add `views/builder/viewer/PrintDialog` to your `packageOwnedServices` array in `next.config.js` (next to the existing `services/reportData/fetchReportData` entry), or use the longer path `'robobyte-front-builder/src/views/builder/viewer/PrintDialog'`. Both resolve to the same file.
+
+2. **The dialog is mounted-but-hidden.** It registers itself on `printDialogRef.current` after first render and exposes `{ open(layoutId, data), openWithSchema(schema, data), close() }`.
+
+3. **For multi-page apps, prefer a `PrintProvider` pattern** — mount the dialog once at `_app.js` level and expose `usePrintLayout()` from a React context so every page gets `openPrintLayout(id, data)` without re-mounting. The full pattern is in **[`docs/printLayout.md`](docs/printLayout.md)**.
+
+For the complete host-app reference (the three mounting patterns, listing layouts, recipes for printing from a `<ReportViewer>` viewer action, all pitfalls), see **[`docs/printLayout.md`](docs/printLayout.md)**.
 
 ### Step 4 — Build the layout
 

package/LICENSE

@@ -0,0 +1,65 @@
+MIT License
+
+Copyright (c) 2024-2026 RoboByte / Hossny37
+
+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.
+
+---
+
+## Third-party components and commercial dependencies
+
+The MIT license above applies to the source code of `robobyte-front-builder`
+itself. This package depends on third-party libraries with their own licenses
+that consumers must comply with separately. The notable ones:
+
+### AG Grid Enterprise (peer dependency)
+
+This package's report and grid components rely on AG Grid Enterprise features
+(server-side row model, side tool panel, integrated charts, etc.) via the
+`ag-grid-enterprise` peer dependency. AG Grid Enterprise is a **commercial,
+proprietary product owned by AG Grid Ltd**. Consumers deploying this package
+in production must obtain a valid AG Grid Enterprise license from AG Grid
+Ltd and comply with their license terms:
+
+  https://www.ag-grid.com/license-pricing/
+
+AG Grid Community (the base library, MIT-licensed) is sufficient for
+development with a watermark; production use requires a paid license.
+
+### MUI X (peer dependency)
+
+`@mui/x-data-grid`, `@mui/x-date-pickers`, and related packages have free
+(MIT) and paid (Pro / Premium) tiers. This package uses only the free
+tiers by default. If a consumer opts to install Pro / Premium variants,
+they must comply with MUI's commercial license:
+
+  https://mui.com/pricing/
+
+### Other dependencies
+
+All other runtime and peer dependencies are open-source under permissive
+licenses (MIT, Apache 2.0, ISC, BSD). Run `npm ls --omit dev` to inspect
+the full graph and `npm-license-checker` (or similar) to enumerate licenses.
+
+---
+
+The license above does not waive or modify the terms of any third-party
+license referenced in this document. Consumers are responsible for
+obtaining and complying with licenses required by their use of those
+third-party components.

package/README.md

@@ -3,6 +3,27 @@
 A low-code **UI Builder**, **Report Builder**, **Print Layout Designer**, and **Navigation Extension API** for Next.js applications.
 
 [![npm version](https://img.shields.io/npm/v/robobyte-front-builder)](https://www.npmjs.com/package/robobyte-front-builder)
+[![license](https://img.shields.io/npm/l/robobyte-front-builder)](./LICENSE)
+[![github](https://img.shields.io/badge/github-Hossny37%2FRoboByteFrontBuilder-181717?logo=github)](https://github.com/Hossny37/RoboByteFrontBuilder)
+
+---
+
+## 📚 Documentation
+
+| Document | Audience | What it covers |
+|---|---|---|
+| **[README.md](./README.md)** *(this file)* | Everyone | Public surface, provider props, every component's inspector schema, action-scope tables, troubleshooting, changelog. The exhaustive reference. |
+| **[INTEGRATION.md](./INTEGRATION.md)** | Host-app developers | `next.config.js` setup, peer deps, page wrapper pattern, provider bridge, print layout integration steps. |
+| **[docs/ReportViewer.md](./docs/ReportViewer.md)** | Host-app developers | Embedding `<ReportViewer>` in regular React (cancellation, memo'd filters, `viewerActions`, master/detail patterns). |
+| **[docs/fetchReportData.md](./docs/fetchReportData.md)** | Host-app developers | Calling `fetchReportDataByPageId` directly from host code (hooks, KPI counters, XLSX export, paginated cursors). |
+| **[docs/printLayout.md](./docs/printLayout.md)** | Host-app developers | Triggering print layouts via `PrintDialog` ref API, recommended `PrintProvider` + `usePrintLayout()` pattern. |
+| **[training/00-index.md](./training/00-index.md)** | AI sessions / schema authors | Component catalog index — categories and one-page refs for every component the builder ships. |
+| **[training/35-reportViewer.md](./training/35-reportViewer.md)** | AI sessions / schema authors | Full AI manual for the `reportViewer` component (Calculation scope, action arrays, filter shape, recipes). |
+| **[training/48-fetchReportData.md](./training/48-fetchReportData.md)** | AI sessions / schema authors | In-builder Calculation reference for the auto-injected `fetchReportData` helper. |
+| **[training/49-printLayout.md](./training/49-printLayout.md)** | AI sessions / schema authors | In-builder Calculation reference for `openPrintLayout` / `closePrintLayout`. |
+| **[RoboByteBuilder_User_Manual.docx](./RoboByteBuilder_User_Manual.docx)** | End users | Visual user manual for the builder UI. Ships inside the package. |
+
+> **Pair convention.** Most features have **two** manuals: a `docs/` one for host-app React code (consumer of the package) and a `training/` one for AI sessions emitting builder schemas / Calculation code. They cross-link each other; pick the audience that matches your task.
 
 ---
 
@@ -17,27 +38,28 @@ A low-code **UI Builder**, **Report Builder**, **Print Layout Designer**, and **
 7. [Builder pages](#builder-pages)
 8. [Navigation Extension API](#navigation-extension-api)
 9. [Provider props reference](#provider-props-reference)
-10. [fetchReportDataByPageId](#fetchreportdatabypageid)
-11. [ReportViewer as a component](#reportviewer-as-a-component)
-12. [Data Grid component](#data-grid-component)
-13. [Dialog component](#dialog-component)
-14. [Popover component](#popover-component)
-15. [Excel Upload component](#excel-upload-component)
-16. [Wizard component](#wizard-component)
-17. [Repeater component](#repeater-component)
-18. [Menu component](#menu-component)
-19. [View Renderer component](#view-renderer-component)
-20. [Layout Grid component](#layout-grid-component)
-21. [Breadcrumb component](#breadcrumb-component)
-22. [Print Layout Builder](#print-layout-builder)
-23. [Calculation Scope Reference](#calculation-scope-reference)
-24. [KPI Component Actions](#kpi-component-actions)
-25. [Global Data Store](#global-data-store)
-26. [Dark / Light theme](#dark--light-theme)
-27. [Syncing local changes](#syncing-local-changes)
-28. [Troubleshooting](#troubleshooting)
-29. [Publishing](#publishing)
-30. [Changelog](#changelog)
+10. [AG Grid theme](#ag-grid-theme)
+11. [fetchReportDataByPageId](#fetchreportdatabypageid)
+12. [ReportViewer as a component](#reportviewer-as-a-component)
+13. [Data Grid component](#data-grid-component)
+14. [Dialog component](#dialog-component)
+15. [Popover component](#popover-component)
+16. [Excel Upload component](#excel-upload-component)
+17. [Wizard component](#wizard-component)
+18. [Repeater component](#repeater-component)
+19. [Menu component](#menu-component)
+20. [View Renderer component](#view-renderer-component)
+21. [Layout Grid component](#layout-grid-component)
+22. [Breadcrumb component](#breadcrumb-component)
+23. [Print Layout Builder](#print-layout-builder)
+24. [Calculation Scope Reference](#calculation-scope-reference)
+25. [KPI Component Actions](#kpi-component-actions)
+26. [Global Data Store](#global-data-store)
+27. [Dark / Light theme](#dark--light-theme)
+28. [Syncing local changes](#syncing-local-changes)
+29. [Troubleshooting](#troubleshooting)
+30. [Publishing](#publishing)
+31. [Changelog](#changelog)
 
 ---
 
@@ -171,6 +193,11 @@ function RoboByteBridge({ children }) {
       user={auth.user}
       accessToken={auth.accessToken}
       agGridLicenseKey={process.env.NEXT_PUBLIC_AG_GRID_LICENSE_KEY}
+      // Optional: Quartz theme overrides applied to every <AgGridReact>
+      // in the package. Merged on top of the package defaults — see the
+      // "AG Grid theme" section for the full list of params and the
+      // programmatic API. Omit to use the package defaults.
+      agGridTheme={{ accentColor: '#3b82f6' }}
     >
       {children}
     </RoboByteFrontBuilderProvider>
@@ -316,6 +343,7 @@ function MyFeaturePlugin() {
 | `user` | object | Current user object from your auth context |
 | `accessToken` | string | Bearer token attached to every service call |
 | `agGridLicenseKey` | string | AG Grid Enterprise license key — the provider calls `LicenseManager.setLicenseKey()` and registers all enterprise modules internally |
+| `agGridTheme` | object | Quartz theme overrides applied to every `<AgGridReact>` in the package. Merged on top of `DEFAULT_AG_THEME_PARAMS`. Example: `{ accentColor: '#3b82f6', headerHeight: 32 }`. See [AG Grid theme](#ag-grid-theme). |
 | `navExtensions` | array | Static nav items to inject into the sidebar |
 | `endpoints` | object | Full-URL overrides per endpoint group + name |
 
@@ -323,6 +351,58 @@ function MyFeaturePlugin() {
 
 ---
 
+## AG Grid theme
+
+Every `<AgGridReact>` in the package — `reportViewer`, `dataGrid`, the role-permission editor, the navigator picker — reads its theme from a single context. The default lives in code at [`src/lib/agGridTheme.js`](src/lib/agGridTheme.js) and can be overridden in two places:
+
+### 1. Host-app override via the provider
+
+Pass an object of Quartz params to `agGridTheme`. The object is merged on top of the package defaults — keys you set win, everything else falls back.
+
+```jsx
+<RoboByteFrontBuilderProvider
+  agGridTheme={{
+    accentColor:  '#3b82f6',
+    headerHeight: 32,
+    fontFamily:   'inherit',
+  }}
+  /* …other props… */
+>
+  <App />
+</RoboByteFrontBuilderProvider>
+```
+
+See the [AG Grid Quartz theming reference](https://www.ag-grid.com/react-data-grid/theming/) for the full list of params.
+
+### 2. Package-wide default
+
+Open [`src/lib/agGridTheme.js`](src/lib/agGridTheme.js) and edit `DEFAULT_AG_THEME_PARAMS`. Affects every consumer of `robobyte-front-builder` that doesn't supply its own `agGridTheme`.
+
+### Programmatic use
+
+```js
+import {
+  DEFAULT_AG_THEME_PARAMS,   // frozen params object
+  DEFAULT_AG_THEME,          // pre-built Quartz theme
+  buildAgGridTheme,          // (overrides) => Quartz theme
+  AgGridThemeProvider,       // standalone provider (no other dependencies)
+  useAgGridTheme,            // hook returning the resolved theme
+} from 'robobyte-front-builder'
+
+// In a host component that renders its own AG Grid:
+import { AgGridReact } from 'ag-grid-react'
+function MyGrid() {
+  const theme = useAgGridTheme()
+  return <AgGridReact theme={theme} columnDefs={[...]} />
+}
+```
+
+The hook falls back to `DEFAULT_AG_THEME` when called outside `RoboByteFrontBuilderProvider`, so isolated grids still render correctly.
+
+> **Future plan.** A "system settings" path will eventually layer between `DEFAULT_AG_THEME_PARAMS` and the host's `agGridTheme` prop, letting admins customize the theme without a code change. The provider API will stay the same.
+
+---
+
 ## `fetchReportDataByPageId`
 
 Fetches report data by `pageId` without any AG Grid dependency. Always imported from the package path — the `NormalModuleReplacementPlugin` in `next.config.js` routes it to the package's canonical implementation.
@@ -868,6 +948,9 @@ Hot-reload picks up all file changes automatically. Only `next.config.js` change
 **AG Grid error #200 — IntegratedChartsModule not registered**  
 → The provider registers `IntegratedChartsModule.with(AgChartsEnterpriseModule)` automatically. Ensure `ag-charts-enterprise` is installed in the package.
 
+**AG Grid theme override not applying**  
+→ Pass it via `<RoboByteFrontBuilderProvider agGridTheme={{ … }}>`, not as a `theme={…}` prop on individual `<AgGridReact>` instances rendered by the package. Internal grids ignore per-instance themes; the provider's context is the single source of truth. See the *AG Grid theme* section.
+
 **ReportViewer renders at half width**  
 → The outer `Box` in `reportViewer/index.js` must use `display: 'block'`, not `display: 'flex'`.
 
@@ -903,6 +986,15 @@ npm publish --dry-run
 
 ## Changelog
 
+### 1.0.25
+- **Centralized AG Grid theme.** Every `<AgGridReact>` in the package (`reportViewer`, `dataGrid`, role-permission editor, navigator picker) now reads its Quartz theme from a single context. Host apps can override package-wide theme params (accent color, header height, fonts, border radius, etc.) via the new `agGridTheme` prop on `RoboByteFrontBuilderProvider`. Defaults live in [`src/lib/agGridTheme.js`](src/lib/agGridTheme.js). New exports: `DEFAULT_AG_THEME_PARAMS`, `DEFAULT_AG_THEME`, `buildAgGridTheme`, `AgGridThemeProvider`, `useAgGridTheme`.
+- **`<ReportViewer>` redesigned toolbar.** Single-row toolbar: title + caption on the left; collapsible search, Filter (outlined button), Refresh (outlined button), and configurable viewer actions on the right. Auto-refresh interval, "Load all data" toggle, and Excel export moved into the side tool panel under *Display Settings*. Search popover navigable by keyboard (↑ ↓ Home End Enter Esc).
+- **`<ReportViewer>` new inspector fields.** `title`, `caption`, `viewerActions` (array of page-level action buttons appended after Filter/Refresh), `debug` (renders a floating bug icon with a popover showing resolved `pageId`/`id`/builder model id/etc. — hidden in production by default).
+- **Print Layout integration.** Host apps can now trigger print layouts directly via the imperative `PrintDialog` ref API — see [docs/printLayout.md](./docs/printLayout.md) for the recommended `PrintProvider` pattern with `usePrintLayout()`.
+- **Public exports expanded.** `fetchReportDataByPageId` now exported from the package surface (`import { fetchReportDataByPageId } from 'robobyte-front-builder'`); the legacy bare-alias path still works.
+- **Unsaved changes guard.** Builder pages now warn on tab close / refresh / in-app navigation when the schema has unsaved edits. `BuilderProvider` exposes `loadSchema(schema)` (clears history baseline), `markClean()` (post-save reset), and `isDirty`.
+- **Session log + AI fine-tune pipeline.** Every successful save (UI Builder + Print Builder) is auto-logged to localStorage with the full schema. New *Session Logs* toolbar dialog lets developers add training prompts to entries and export a Together AI-ready JSONL. Together is now a first-class AI provider in `/api/ai`.
+
 ### 1.0.21
 - Added Timer Engine — configurable auto-refresh timers per view
 - Added full Undo / Redo history with keyboard shortcuts (Ctrl+Z / Ctrl+Y)
@@ -925,4 +1017,40 @@ npm publish --dry-run
 
 ---
 
+## License & third-party components
+
+`robobyte-front-builder` itself is released under the **[MIT License](./LICENSE)** — the source code in this repository is free to use, modify, and distribute, including in commercial products.
+
+> **Important:** this package depends on third-party libraries with their own licenses. The MIT license applies only to *this* package's source code; it does not relicense or waive obligations under those third-party licenses.
+
+### AG Grid Enterprise — commercial license required for production
+
+The report and grid components use AG Grid Enterprise features (server-side row model, side tool panel, status bar, integrated charts, master/detail). The `ag-grid-enterprise` package is a **commercial product** owned by AG Grid Ltd:
+
+- **Development:** AG Grid Enterprise works without a license key, but renders a watermark and prints a console warning. Fine for local dev and evaluation.
+- **Production deployment:** requires a paid AG Grid Enterprise license. See [ag-grid.com/license-pricing](https://www.ag-grid.com/license-pricing/) for the current terms.
+
+Pass your license key via the provider — the package calls `LicenseManager.setLicenseKey()` and registers `AllEnterpriseModule` + `IntegratedChartsModule.with(AgChartsEnterpriseModule)` internally:
+
+```jsx
+<RoboByteFrontBuilderProvider
+  agGridLicenseKey={process.env.NEXT_PUBLIC_AG_GRID_LICENSE_KEY}
+  // …other props…
+>
+  …
+</RoboByteFrontBuilderProvider>
+```
+
+### MUI X — free vs. Pro / Premium tiers
+
+`@mui/x-data-grid`, `@mui/x-date-pickers`, and related packages have a free MIT tier and paid Pro / Premium tiers. This package uses only the free tier. If you swap in `@mui/x-data-grid-pro` or `@mui/x-date-pickers-pro` in your host app, comply with MUI's commercial license: [mui.com/pricing](https://mui.com/pricing/).
+
+### Everything else
+
+All other runtime and peer dependencies are open-source under permissive licenses (MIT, Apache 2.0, ISC, BSD). Run `npm ls --omit dev` for the full dependency graph and a tool like `license-checker` for a license enumeration.
+
+A condensed version of this notice lives in the [`LICENSE`](./LICENSE) file shipped with the package.
+
+---
+
 *Full user manual: [RoboByteBuilder_User_Manual.docx](./RoboByteBuilder_User_Manual.docx) (included in the package)*