@aglyn/shared-ui-jsx 1.0.0-beta.143

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,7 @@
+# @aglyn/shared-ui-jsx
+
+This library was generated with [Nx](https://nx.dev).
+
+## Running unit tests
+
+Run `nx test ui-common` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@aglyn/shared-ui-jsx",
+  "version": "1.0.0-beta.143",
+  "license": "Apache-2.0",
+  "homepage": "https://aglyn.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aglyn/aglyn.git",
+    "directory": "libs/shared/ui/jsx"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./*": {
+      "types": "./src/lib/*.d.ts",
+      "default": "./src/lib/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@aglyn/shared-data-mdi": "1.0.0-beta.143",
+    "@aglyn/shared-ui-theme": "1.0.0-beta.143",
+    "@aglyn/shared-util-tools": "1.0.0-beta.143",
+    "@aglyn/shared-util-vendor": "1.0.0-beta.143",
+    "@mdi/js": "^7.4.47",
+    "@swc/helpers": "0.5.23",
+    "change-case": "^5.4.4",
+    "clsx": "^2.1.1",
+    "framer-motion": "^12.42.2",
+    "jss": "^10.10.0",
+    "jss-rtl": "^0.3.0",
+    "lodash-es": "^4.18.1",
+    "mobx": "^6.16.1",
+    "react-frame-component": "^5.3.2",
+    "react-is": "^19.2.8",
+    "react-use": "^17.6.1",
+    "react-virtuoso": "^4.18.11",
+    "rxjs": "^7.8.2",
+    "warning": "^4.0.3"
+  },
+  "peerDependencies": {
+    "@mui/base": "5.0.0-beta.70",
+    "@mui/material": "^9.3.1",
+    "@mui/styles": "^6.4.8",
+    "@mui/system": "^9.2.0",
+    "@mui/utils": "^9.2.0",
+    "@mui/x-data-grid": "^9.12.0",
+    "next": "16.3.3",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8"
+  },
+  "sideEffects": false,
+  "types": "./src/index.d.ts",
+  "module": "./src/index.js",
+  "main": "./src/index.js"
+}

package/src/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export * from './lib/components/app-link';
+export * from './lib/components/card-display';
+export * from './lib/components/card-list-item';
+export * from './lib/components/container';
+export * from './lib/components/error-boundary.component';
+export * from './lib/components/grid-items';
+export * from './lib/components/aglyn-text';
+export * from './lib/components/help-tip.component';
+export * from './lib/components/menu';
+export * from './lib/components/mui-shadow-dom';
+export * from './lib/components/shadow-dom';
+export * from './lib/components/sr-only';
+export * from './lib/contexts/confirmation.context';
+export * from './lib/contexts/loading.context';
+export * from './lib/hooks/router-events';
+export * from './lib/hooks/use-callback-param-ref';
+export * from './lib/hooks/use-async-effect';
+export * from './lib/hooks/use-id';
+export * from './lib/hooks/use-isomorphic-layout-effect';
+export * from './lib/hooks/use-merge-refs';
+export * from './lib/hooks/use-subscribable';
+export * from './lib/const/svg-icons';
+export * from './lib/hocs/create-hoc-with-context-consumer';
+export * from './lib/hocs/with-hoc';
+export * from './lib/utils/make-link-elements';
+export * from './lib/utils/make-meta-elements';
+export * from './lib/types';
+export * from './lib/hooks/mdi-icon/use-mdi-icon';
+export * from './lib/hooks/mdi-icon/use-mdi-icons';
+export * from './lib/components/mdi-icon/mdi-icon';
+export * from './lib/components/mdi-icon/mdi-icon-from-id';
+export * from '@aglyn/shared-data-mdi';

package/src/index.js

@@ -0,0 +1,179 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ // ── Barrel discipline (AGL-1290, extending AGL-1151) ────────────────────────
+// The tenant runtime reaches this barrel statically (the node renderer
+// imports ShadowDom/ErrorBoundary through it), and Turbopack cannot prove a
+// module with top-level `styled()`/`forwardRef()` calls side-effect-free —
+// so EVERY component re-exported here ships eagerly on EVERY published
+// customer page, used or not. Measured: RulerGuides, SplashScreen,
+// NavigationDrawer, DialogConfirm and the whole MUI Dialog/Drawer/Popper
+// stack were in /pricing's first-load chunks, imported by nothing.
+//
+// Rule: a component joins this barrel only if the tenant page graph or the
+// besigner needs it by name. Console-/www-only components are imported by
+// subpath instead: '@aglyn/shared-ui-jsx/components/<file>' (the tsconfig
+// wildcard path already resolves it — same pattern as DataTable/GridList
+// below). Pure modules (hooks, types, const data) are exempt: the bundler
+// proves them pure and drops the unused ones.
+//
+// THIS RULE IS ENFORCED (AGL-1895) — `npm run check:jsx-barrel`, in CI. Every
+// line below is pinned in `tools/scripts/jsx-barrel-baseline.json`, along with
+// every third-party package this barrel transitively reaches, so a heavy
+// import added inside a module ALREADY listed here goes red too. Adding or
+// removing an export fails until the allowlist moves in the same commit,
+// which is what puts the cost in front of a reviewer. Measured with esbuild,
+// minified and GZIPPED: re-exporting data-table.component costs +162,866 B and
+// grid-list +20,386 B on every page of every published customer site.
+// Until then this rule was a comment, and a comment cannot fail.
+//
+// `package.json` here declares `"sideEffects": false`, which is what lets a
+// bundler act on the paragraph above rather than only obey it. Without the
+// declaration every module reachable from this file has to be assumed
+// side-effectful and kept, so a named import of one component through this
+// barrel still drags the rest — measured on a published page's cold load, the
+// PAGES ROUTER (`next/router`, reached from `hooks/router-events`) was a 40 KB
+// chunk on a page that has no Pages Router, and declaring this tree pure is
+// what took it off the wire. The claim was audited file by file: the only
+// module-scope work here is local `.displayName` / `.aglyn` assignment and
+// `createContext`, none of which another module can observe. `shadow-dom` and
+// `mui-shadow-dom` build a Proxy over a module-local Map, which is not an
+// exception either. A second clause stood here for `use-observer-resize`,
+// whose default import of `resize-observer-polyfill` was the one bare-looking
+// import in the tree; the hook went with the nineteen nothing called and the
+// dependency followed it out of `package.json` (AGL-2706), so the audit is
+// shorter by a module rather than by an argument.
+// A module added here that DOES do observable
+// work at import time — a global write, a registration, a bare polyfill
+// import — must be listed in `sideEffects` in the same commit, or it will be
+// dropped from builds that never name it.
+export * from "./lib/components/app-link.js";
+// aspect-ratio, background-image, children-function-prop, dialog-confirm +
+// confirmation-provider, ellipsis-pulse, grid-buttons, loading-layout,
+// loading-modal, loading-text, navigation-view, next-link, popper-styled,
+// resizeable-stack, ruler-guides, sandbox-frame, scroll-reaction,
+// splash-screen, emotion-cache-provider and const/prebuilt-components are
+// NOT in the barrel (AGL-1290) — subpath-import them (see rule above).
+// navigation-drawer is the one deliberate exception, below.
+export * from "./lib/components/card-display.js";
+export * from "./lib/components/card-list-item.js";
+// NOT in the barrel (AGL-1151). `DataTable` wraps MUI X DataGrid, which with
+// its virtualizer is ~257 KB of the bundle — and exporting it here put all of
+// that behind every `@aglyn/shared-ui-jsx` import, including the tenant
+// runtime. Every visitor to every published site downloaded a data grid to
+// render a page that has never contained one; nothing in the tenant or the
+// node renderer references DataTable at all.
+//
+// Measured both ways: removing this line drops MuiDataGrid from the tenant
+// bundle entirely (13741 KB → 13484 KB built output).
+//
+// Import it from '@aglyn/shared-ui-jsx/components/data-table.component' — the
+// subpath already resolves. Kept out of the barrel rather than lazy-loaded
+// because `GridOverlay` is used at module scope inside `styled()`, so the
+// module cannot be deferred without splitting the component.
+export * from "./lib/components/container.js";
+export * from "./lib/components/error-boundary.component.js";
+export * from "./lib/components/grid-items.js";
+// `grid-list` is deliberately NOT re-exported (AGL-1151). It is the only
+// consumer of `react-virtuoso`, and the tenant runtime imports this barrel —
+// so exporting it here put a virtualizer into every published customer page to
+// render a list those pages never contain. Exactly what `DataTable` did with
+// MUI X DataGrid in 828c43939. Import it from
+// `@aglyn/shared-ui-jsx/components/grid-list` instead.
+export * from "./lib/components/aglyn-text.js";
+export * from "./lib/components/help-tip.component.js";
+export * from "./lib/components/menu.js";
+export * from "./lib/components/mui-shadow-dom.js";
+// navigation-drawer is NOT re-exported (AGL-1290): it kept the MUI Drawer
+// stack in the tenant's first-load chunk. Import it from
+// `@aglyn/shared-ui-jsx/components/navigation-drawer.component`.
+export * from "./lib/components/shadow-dom/index.js";
+export * from "./lib/components/sr-only.js";
+// zoomable-panning-component is NOT re-exported (AGL-2486), for the same
+// reason navigation-drawer is not — and with less excuse, because nothing
+// imports it. The only references left in the tree are a COMMENTED-OUT import
+// in `viewport-canvas.component.tsx` and three prose mentions; the barrel
+// export was its last live edge, so every published customer page was paying
+// to parse an editor-only pan/zoom canvas class (and the five
+// `getBoundingClientRect()` call sites in it) that nothing on the page mounts.
+// Still importable from
+// `@aglyn/shared-ui-jsx/components/zoomable-panning-component` if the besigner
+// ever uncomments that import.
+export * from "./lib/contexts/confirmation.context.js";
+export * from "./lib/contexts/loading.context.js";
+// Nineteen hooks were DELETED here, not merely un-exported (AGL-2706):
+// use-client-rect, use-debounce, use-debounced-transition,
+// use-effect-post-mount, use-element-position, use-interval,
+// use-local-storage-item-state, use-mouse-enter, use-mouse-over,
+// use-mouse-position, use-node-property, use-observer-intersection,
+// use-observer-mutation, use-observer-resize, use-on-mouse-enter,
+// use-on-mouse-over, use-tag-name, use-timeout and use-timeout-delay.
+//
+// Not one had a caller — not an app, not a plugin, not a tool — and a React
+// hook cannot be reached except by importing it, so nothing could have. The
+// AGL-2486 note that stood here for `use-observer-resize` said exactly this
+// and stopped at dropping the re-export; the rest were in the same position
+// and had been for as long.
+//
+// `useLocalStorageItemState` is the one worth naming, because it is the one
+// that was TRIED. Roughly twenty places in the console, the plugins and the
+// besigner keep a value in `localStorage` and hand-roll the same hook beside
+// it, and every one of them reads storage in a mount effect with the same
+// comment: reading during render hydrate-mismatches, because there is no
+// `localStorage` on the server. This hook seeded `useState` from storage
+// directly, which is precisely the defect they were each working around, so
+// adopting it would have been a regression. Deleted rather than widened: the
+// shape those callers actually need is a patch update over typed defaults,
+// which is not this signature, and designing a second one against no caller
+// is how the first got here.
+//
+// Deleting cost zero bytes — the barrel declares `sideEffects: false` and
+// every one of these was already tree-shaken out of both apps. What it buys
+// is that nobody adopts them by mistake.
+export * from "./lib/hooks/router-events.js";
+export * from "./lib/hooks/use-callback-param-ref.js";
+export * from "./lib/hooks/use-async-effect.js";
+export * from "./lib/hooks/use-id.js";
+export * from "./lib/hooks/use-isomorphic-layout-effect.js";
+export * from "./lib/hooks/use-merge-refs.js";
+export * from "./lib/hooks/use-subscribable.js";
+// prebuilt-components is a module-scope `<LoadingModal open />` — rendering
+// at import time is exactly the impurity the rule above exists for.
+export * from "./lib/const/svg-icons.js";
+export * from "./lib/hocs/create-hoc-with-context-consumer.js";
+export * from "./lib/hocs/with-hoc.js";
+export * from "./lib/utils/make-link-elements.js";
+export * from "./lib/utils/make-meta-elements.js";
+// `./lib/utils/vendor` is NOT re-exported (AGL-2682). It wraps eleven `react-is`
+// predicates and NOTHING reads any of them from this index — the two real
+// consumers, `aglyn-node-renderer`'s `leaf.tsx` and the besigner's
+// `component-icon.component.tsx`, import `react-is` directly. So the line's
+// only effect was to hold `react-is` inside the reachable set of a barrel that
+// ships eagerly on every published page. Still importable as
+// `@aglyn/shared-ui-jsx/utils/vendor`.
+export * from "./lib/types.js";
+export * from "./lib/hooks/mdi-icon/use-mdi-icon.js";
+export * from "./lib/hooks/mdi-icon/use-mdi-icons.js";
+export * from "./lib/components/mdi-icon/mdi-icon.js";
+export * from "./lib/components/mdi-icon/mdi-icon-from-id.js";
+export * from "@aglyn/shared-data-mdi"; // import dynamic from 'next/dynamic'
+ // export const MdiIconFromId = dynamic(
+ //   () => import('./components/mdi-svg-icon'),
+ //   {loading: () => (<span />)},
+ // )
+ // MdiIconFromId.displayName = 'MdiIconFromId'
+ // MdiIconFromId.aglyn = true
+
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/shared/ui/jsx/src/index.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n// ── Barrel discipline (AGL-1290, extending AGL-1151) ────────────────────────\n// The tenant runtime reaches this barrel statically (the node renderer\n// imports ShadowDom/ErrorBoundary through it), and Turbopack cannot prove a\n// module with top-level `styled()`/`forwardRef()` calls side-effect-free —\n// so EVERY component re-exported here ships eagerly on EVERY published\n// customer page, used or not. Measured: RulerGuides, SplashScreen,\n// NavigationDrawer, DialogConfirm and the whole MUI Dialog/Drawer/Popper\n// stack were in /pricing's first-load chunks, imported by nothing.\n//\n// Rule: a component joins this barrel only if the tenant page graph or the\n// besigner needs it by name. Console-/www-only components are imported by\n// subpath instead: '@aglyn/shared-ui-jsx/components/<file>' (the tsconfig\n// wildcard path already resolves it — same pattern as DataTable/GridList\n// below). Pure modules (hooks, types, const data) are exempt: the bundler\n// proves them pure and drops the unused ones.\n//\n// THIS RULE IS ENFORCED (AGL-1895) — `npm run check:jsx-barrel`, in CI. Every\n// line below is pinned in `tools/scripts/jsx-barrel-baseline.json`, along with\n// every third-party package this barrel transitively reaches, so a heavy\n// import added inside a module ALREADY listed here goes red too. Adding or\n// removing an export fails until the allowlist moves in the same commit,\n// which is what puts the cost in front of a reviewer. Measured with esbuild,\n// minified and GZIPPED: re-exporting data-table.component costs +162,866 B and\n// grid-list +20,386 B on every page of every published customer site.\n// Until then this rule was a comment, and a comment cannot fail.\n//\n// `package.json` here declares `\"sideEffects\": false`, which is what lets a\n// bundler act on the paragraph above rather than only obey it. Without the\n// declaration every module reachable from this file has to be assumed\n// side-effectful and kept, so a named import of one component through this\n// barrel still drags the rest — measured on a published page's cold load, the\n// PAGES ROUTER (`next/router`, reached from `hooks/router-events`) was a 40 KB\n// chunk on a page that has no Pages Router, and declaring this tree pure is\n// what took it off the wire. The claim was audited file by file: the only\n// module-scope work here is local `.displayName` / `.aglyn` assignment and\n// `createContext`, none of which another module can observe. `shadow-dom` and\n// `mui-shadow-dom` build a Proxy over a module-local Map, which is not an\n// exception either. A second clause stood here for `use-observer-resize`,\n// whose default import of `resize-observer-polyfill` was the one bare-looking\n// import in the tree; the hook went with the nineteen nothing called and the\n// dependency followed it out of `package.json` (AGL-2706), so the audit is\n// shorter by a module rather than by an argument.\n// A module added here that DOES do observable\n// work at import time — a global write, a registration, a bare polyfill\n// import — must be listed in `sideEffects` in the same commit, or it will be\n// dropped from builds that never name it.\nexport * from './lib/components/app-link'\n// aspect-ratio, background-image, children-function-prop, dialog-confirm +\n// confirmation-provider, ellipsis-pulse, grid-buttons, loading-layout,\n// loading-modal, loading-text, navigation-view, next-link, popper-styled,\n// resizeable-stack, ruler-guides, sandbox-frame, scroll-reaction,\n// splash-screen, emotion-cache-provider and const/prebuilt-components are\n// NOT in the barrel (AGL-1290) — subpath-import them (see rule above).\n// navigation-drawer is the one deliberate exception, below.\nexport * from './lib/components/card-display'\nexport * from './lib/components/card-list-item'\n// NOT in the barrel (AGL-1151). `DataTable` wraps MUI X DataGrid, which with\n// its virtualizer is ~257 KB of the bundle — and exporting it here put all of\n// that behind every `@aglyn/shared-ui-jsx` import, including the tenant\n// runtime. Every visitor to every published site downloaded a data grid to\n// render a page that has never contained one; nothing in the tenant or the\n// node renderer references DataTable at all.\n//\n// Measured both ways: removing this line drops MuiDataGrid from the tenant\n// bundle entirely (13741 KB → 13484 KB built output).\n//\n// Import it from '@aglyn/shared-ui-jsx/components/data-table.component' — the\n// subpath already resolves. Kept out of the barrel rather than lazy-loaded\n// because `GridOverlay` is used at module scope inside `styled()`, so the\n// module cannot be deferred without splitting the component.\nexport * from './lib/components/container'\nexport * from './lib/components/error-boundary.component'\nexport * from './lib/components/grid-items'\n// `grid-list` is deliberately NOT re-exported (AGL-1151). It is the only\n// consumer of `react-virtuoso`, and the tenant runtime imports this barrel —\n// so exporting it here put a virtualizer into every published customer page to\n// render a list those pages never contain. Exactly what `DataTable` did with\n// MUI X DataGrid in 828c43939. Import it from\n// `@aglyn/shared-ui-jsx/components/grid-list` instead.\nexport * from './lib/components/aglyn-text'\nexport * from './lib/components/help-tip.component'\nexport * from './lib/components/menu'\nexport * from './lib/components/mui-shadow-dom'\n// navigation-drawer is NOT re-exported (AGL-1290): it kept the MUI Drawer\n// stack in the tenant's first-load chunk. Import it from\n// `@aglyn/shared-ui-jsx/components/navigation-drawer.component`.\nexport * from './lib/components/shadow-dom'\nexport * from './lib/components/sr-only'\n// zoomable-panning-component is NOT re-exported (AGL-2486), for the same\n// reason navigation-drawer is not — and with less excuse, because nothing\n// imports it. The only references left in the tree are a COMMENTED-OUT import\n// in `viewport-canvas.component.tsx` and three prose mentions; the barrel\n// export was its last live edge, so every published customer page was paying\n// to parse an editor-only pan/zoom canvas class (and the five\n// `getBoundingClientRect()` call sites in it) that nothing on the page mounts.\n// Still importable from\n// `@aglyn/shared-ui-jsx/components/zoomable-panning-component` if the besigner\n// ever uncomments that import.\n\nexport * from './lib/contexts/confirmation.context'\nexport * from './lib/contexts/loading.context'\n\n// Nineteen hooks were DELETED here, not merely un-exported (AGL-2706):\n// use-client-rect, use-debounce, use-debounced-transition,\n// use-effect-post-mount, use-element-position, use-interval,\n// use-local-storage-item-state, use-mouse-enter, use-mouse-over,\n// use-mouse-position, use-node-property, use-observer-intersection,\n// use-observer-mutation, use-observer-resize, use-on-mouse-enter,\n// use-on-mouse-over, use-tag-name, use-timeout and use-timeout-delay.\n//\n// Not one had a caller — not an app, not a plugin, not a tool — and a React\n// hook cannot be reached except by importing it, so nothing could have. The\n// AGL-2486 note that stood here for `use-observer-resize` said exactly this\n// and stopped at dropping the re-export; the rest were in the same position\n// and had been for as long.\n//\n// `useLocalStorageItemState` is the one worth naming, because it is the one\n// that was TRIED. Roughly twenty places in the console, the plugins and the\n// besigner keep a value in `localStorage` and hand-roll the same hook beside\n// it, and every one of them reads storage in a mount effect with the same\n// comment: reading during render hydrate-mismatches, because there is no\n// `localStorage` on the server. This hook seeded `useState` from storage\n// directly, which is precisely the defect they were each working around, so\n// adopting it would have been a regression. Deleted rather than widened: the\n// shape those callers actually need is a patch update over typed defaults,\n// which is not this signature, and designing a second one against no caller\n// is how the first got here.\n//\n// Deleting cost zero bytes — the barrel declares `sideEffects: false` and\n// every one of these was already tree-shaken out of both apps. What it buys\n// is that nobody adopts them by mistake.\nexport * from './lib/hooks/router-events'\nexport * from './lib/hooks/use-callback-param-ref'\nexport * from './lib/hooks/use-async-effect'\nexport * from './lib/hooks/use-id'\nexport * from './lib/hooks/use-isomorphic-layout-effect'\nexport * from './lib/hooks/use-merge-refs'\nexport * from './lib/hooks/use-subscribable'\n\n// prebuilt-components is a module-scope `<LoadingModal open />` — rendering\n// at import time is exactly the impurity the rule above exists for.\nexport * from './lib/const/svg-icons'\n\nexport * from './lib/hocs/create-hoc-with-context-consumer'\nexport * from './lib/hocs/with-hoc'\n\nexport * from './lib/utils/make-link-elements'\nexport * from './lib/utils/make-meta-elements'\n// `./lib/utils/vendor` is NOT re-exported (AGL-2682). It wraps eleven `react-is`\n// predicates and NOTHING reads any of them from this index — the two real\n// consumers, `aglyn-node-renderer`'s `leaf.tsx` and the besigner's\n// `component-icon.component.tsx`, import `react-is` directly. So the line's\n// only effect was to hold `react-is` inside the reachable set of a barrel that\n// ships eagerly on every published page. Still importable as\n// `@aglyn/shared-ui-jsx/utils/vendor`.\n\nexport * from './lib/types'\n\nexport * from './lib/hooks/mdi-icon/use-mdi-icon'\nexport * from './lib/hooks/mdi-icon/use-mdi-icons'\n\nexport * from './lib/components/mdi-icon/mdi-icon'\nexport * from './lib/components/mdi-icon/mdi-icon-from-id'\n\nexport * from '@aglyn/shared-data-mdi'\n\n// import dynamic from 'next/dynamic'\n// export const MdiIconFromId = dynamic(\n//   () => import('./components/mdi-svg-icon'),\n//   {loading: () => (<span />)},\n// )\n// MdiIconFromId.displayName = 'MdiIconFromId'\n// MdiIconFromId.aglyn = true\n"],"names":[],"mappings":"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"}

package/src/lib/components/aglyn-text.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * The authored text of a leaf, as a plain element (AGL-2011).
+ *
+ * ## Why this is no longer a shadow host
+ *
+ * This used to be `ShadowDom.AglynText` — a `shadowDomRootFactory` host that
+ * `attachShadow`ed and then rendered the string through a `createPortal` into
+ * the shadow root. The tag name is unchanged, so every
+ * `querySelectorAll('aglyn-text')` and every editor ref target still resolves;
+ * what is gone is the shadow boundary.
+ *
+ * A shadow root exists to encapsulate STYLE, and here it encapsulated nothing.
+ * Measured on the live `/pricing` page: **960 hosts, 960 shadow roots holding a
+ * single bare text node, zero elements inside any of them, and zero carrying
+ * any CSS** — no `adoptedStyleSheets`, no `<style>`, no `<link>`. There was
+ * nothing for a selector to match, and inherited typography (font, colour,
+ * line-height) crosses a shadow boundary regardless. The encapsulation was a
+ * no-op.
+ *
+ * The COSTS were not. A shadow root makes text invisible to `textContent`,
+ * and the repo paid for that four separate times:
+ *
+ *  - **AGL-2349 shipped a bug.** Every published split accordion summary named
+ *    its chevron "Toggle section", because the label could not be read back.
+ *    `accordion.tsx` still carries the bespoke `childText` React-tree walker
+ *    written to work around it.
+ *  - Legal-page verification had to read the **Flight payload** rather than the
+ *    DOM (`published-legal-pages.ts`).
+ *  - `leaf.spec.tsx` records that `textContent` cannot see it.
+ *  - Every external check — drift tooling, a11y tooling, find-in-page — needed
+ *    a bespoke shadow-piercing walk before the page would yield any text.
+ *
+ * ## Why dropping it is safe
+ *
+ * The original reason for the shadow root was to give the editor a ref target
+ * for inline editing. That is not load-bearing: an ELEMENT provides the ref,
+ * not a shadow root, and the besigner's inline text and markdown editors mount
+ * **light-DOM** `contenteditable` halves (`besigner/core` → `text-entry.ts`).
+ * Nothing edits inside this element.
+ *
+ * Layout is unchanged: an unknown element defaults to `display: inline`, which
+ * is what the shadow HOST already was, and the host was always in the light
+ * tree — only its CONTENT moved.
+ *
+ * Hydration gets simpler rather than riskier. The old component rendered the
+ * text as light DOM on the server and during the first client render, then
+ * attached the shadow in a layout effect and re-rendered the same string
+ * through a portal; the light copy stopped displaying only because a shadow
+ * host without slots hides its children. Now the server output is final — and
+ * a page like `/pricing` does 960 fewer `attachShadow` calls and mounts 960
+ * fewer portals.
+ */
+export interface AglynTextProps {
+    children?: any;
+    /**
+     * Sanitized author markup, for a leaf whose text carries formatting
+     * (AGL-2557). Every caller passes the output of `sanitizeAuthorHtml`,
+     * re-sanitized on each render per AGL-497 — this element does no filtering
+     * of its own and must never be handed a raw stored value.
+     *
+     * It rides this element rather than a wrapper of its own so the formatted
+     * label and the plain one are the SAME edit target on the canvas, which is
+     * the element the besigner looks for (AGL-2556).
+     */
+    dangerouslySetInnerHTML?: {
+        __html: string;
+    };
+}
+export declare const AglynText: import("react").ForwardRefExoticComponent<AglynTextProps & import("react").RefAttributes<HTMLElement>>;
+export default AglynText;