@wpmoo/ui 1.0.0-rc.1 → 1.0.0-rc.11

package/ASSET_LICENSE.md

@@ -13,5 +13,7 @@ You may not copy, redistribute, modify, sell, sublicense, or use them in another
 product, site, template, library, training dataset, or marketing asset without
 prior written permission from WPMoo.
 
-Third-party assets remain under their own licenses. See
-`THIRD_PARTY_NOTICES.md`.
+Third-party assets remain under their own licenses. See the
+[version-pinned third-party notices](https://github.com/wpmoo-org/ui/blob/v1.0.0-rc.11/THIRD_PARTY_NOTICES.md).
+Those notices are repository-only and are intentionally not shipped in the npm
+package.

package/LICENSE

@@ -19,3 +19,31 @@ 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.
+
+---
+
+Chart.js v4.5.1
+
+The MIT License (MIT)
+
+Copyright (c) 2014-2024 Chart.js 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.
+
+---
+
+@kurkle/color v0.3.4
+
+The MIT License (MIT)
+
+Copyright (c) 2018-2024 Jukka Kurkela
+
+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.

package/README.md

@@ -24,18 +24,21 @@
 
 # Moo UI
 
-Moo UI preserves Bootstrap markup, variables, and JavaScript plugins wherever
-Bootstrap already provides the contract. For patterns Bootstrap does not
-provide, Moo UI adds small documented extensions, including optional ESM for
-Combobox, Context Menu, DataTable, and Sidebar.
-
-- **CSS-first.** Most components need only the stylesheet and ordinary HTML.
-- **Bootstrap owns native behavior.** Keep using Bootstrap's bundle for its
-  Dropdown, Modal, Offcanvas, Tooltip, Popover, Toast, and other plugins.
-- **Moo extends verified gaps.** Optional Moo ESM is explicit and
-  side-effect-free; importing it never scans the document automatically.
-- **Adopt all at once or gradually.** Use the full Bootstrap build or scope the
-  Moo component layer to a `.moo-ui` boundary.
+Moo UI gives Bootstrap 5.3 applications a calmer, shadcn-inspired product
+surface without asking teams to abandon the markup, variables, and plugin
+contracts they already use.
+
+It is built for server-rendered products, admin screens, dashboards, and SaaS
+interfaces where Bootstrap remains the public contract but the default visual
+language needs to feel more current.
+
+- **Bootstrap-native.** Keep familiar classes, form markup, layout utilities,
+  and Bootstrap JavaScript where Bootstrap already owns the behavior.
+- **CSS-first.** Most components need only one stylesheet and ordinary HTML.
+- **Gradual when needed.** Use the full build or scope Moo UI inside a
+  `.moo-ui` boundary while an existing Bootstrap app migrates piece by piece.
+- **Explicit runtime.** Optional Moo UI behavior loads through ESM entrypoints
+  only when a component needs behavior Bootstrap does not provide.
 
 ## Try It in 30 Seconds
 
@@ -50,20 +53,9 @@ The quick demo intentionally follows the floating npm tag:
 
 `moo-ui.css` is a complete Bootstrap CSS build with Moo UI defaults. Use it
 instead of another Bootstrap stylesheet, not in addition to one.
-
-## Runtime Ownership
-
-| Surface | Runtime owner | What to load |
-| --- | --- | --- |
-| Static HTML and CSS components | Browser + Bootstrap markup | `moo-ui.css`, or Bootstrap CSS followed by scoped `moo.css` |
-| Dropdown, Modal, Offcanvas, Tooltip, Popover, Toast, and other Bootstrap plugins | Bootstrap | Bootstrap's JavaScript bundle and documented initialization |
-| Combobox | Optional Moo ESM | `@wpmoo/ui/combobox.js`, then explicit initialization |
-| Context Menu pointer and keyboard invocation | Optional Moo ESM, composed with Bootstrap Dropdown | `@wpmoo/ui/context-menu.js`, then explicit initialization |
-| DataTable sorting, filtering, selection, pagination, and responsive card sync | Optional Moo ESM, composed with Bootstrap Table and controls | `@wpmoo/ui/datatable.js`, then explicit initialization |
-| Sidebar state and responsive coordination | Optional Moo ESM, composed with Bootstrap plugins | `@wpmoo/ui/sidebar.js`, then explicit initialization |
-
-Moo UI does not replace Bootstrap plugins and does not publish a mandatory
-aggregate JavaScript runtime.
+It emits Moo UI's root/body theme tokens before Bootstrap's reboot body rules;
+if you persist dark or system mode, set `data-bs-theme` synchronously in the
+head before this stylesheet loads.
 
 ## Install
 
@@ -97,59 +89,83 @@ import "bootstrap/dist/js/bootstrap.bundle.min.js"; // only when plugins are use
 </div>
 ```
 
-### Optional Moo ESM
+### Theme ownership and first paint
 
-Initialize only the documented behavior gaps you use:
+Resolve the initial `light` or `dark` value on the server whenever the host
+knows the request or session preference. Put it on the first application owner;
+keep `lang` and the document's default `dir` on `html`:
 
-```js
-import Combobox from "@wpmoo/ui/combobox.js";
-import ContextMenu from "@wpmoo/ui/context-menu.js";
-import DataTable from "@wpmoo/ui/datatable.js";
-import Sidebar from "@wpmoo/ui/sidebar.js";
-
-Combobox.getOrCreateInstance(document.querySelector(".combobox"));
-ContextMenu.getOrCreateInstance(document.querySelector(".context-menu"));
-DataTable.getOrCreateInstance(document.querySelector(".datatable"));
-Sidebar.getOrCreateInstance(document.querySelector('[data-slot="sidebar-wrapper"]'));
+```html
+<!-- Server-resolved document: no state bootstrap required. -->
+<html lang="en" dir="ltr">
+  <body>
+    <div class="moo-ui" data-bs-theme="dark" data-moo-document-owner="true">
+      <!-- Moo UI application -->
+    </div>
+  </body>
+</html>
 ```
 
-See the [Installation guide](https://ui.wpmoo.org/installation/) for CDN
-recipes, load order, and troubleshooting.
+For a static or strict-CSP host without an inline bootstrap, keep the classic
+external asset as the root's first child. An embedded owner uses explicit keys
+when it needs independent browser persistence:
 
-## Choose an Adoption Path
+```html
+<!-- Static or strict-CSP fallback: classic script is the root's first child. -->
+<div class="moo-ui" data-bs-theme="light" data-moo-theme-key="portal:theme">
+  <script src="/vendor/@wpmoo/ui/state.js"></script>
+  <!-- embedded Moo UI fragment -->
+</div>
+```
 
-| Situation | Recommended path |
-| --- | --- |
-| New page or whole application | Replace Bootstrap CSS with `moo-ui.css`. |
-| Existing Bootstrap application | Load `moo.css` after Bootstrap CSS and add `.moo-ui` around migrated regions. |
-| Static page with no interactive plugins | Load CSS only. |
-| Page using Bootstrap plugins | Keep Bootstrap's bundle and its documented initialization. |
-| Page using Combobox, Context Menu, DataTable, or Sidebar | Add only the corresponding optional Moo ESM module. |
+On a first visit, a static host without a known server preference can only
+correct a browser-only preference after the external asset is fetched, so that
+correction may be visible. The server value remains the deterministic fallback;
+an external fetch cannot guarantee zero flash in this profile. Since RC9, Moo UI exposes
+this asset as `@wpmoo/ui/state.js`.
 
-## Public Package Surface
+### Optional runtime
 
-`@wpmoo/ui` exports exactly these public entrypoints:
+```js
+import MooUI from "@wpmoo/ui/moo-ui.js";
 
-| Export | Purpose |
-| --- | --- |
-| `@wpmoo/ui/moo-ui.css` | Full expanded CSS build |
-| `@wpmoo/ui/moo-ui.min.css` | Full minified CSS build |
-| `@wpmoo/ui/moo.css` | Scoped expanded component layer for `.moo-ui` |
-| `@wpmoo/ui/moo.min.css` | Scoped minified component layer |
-| `@wpmoo/ui/combobox.js` | Optional Combobox ESM lifecycle |
-| `@wpmoo/ui/context-menu.js` | Optional Context Menu ESM lifecycle |
-| `@wpmoo/ui/datatable.js` | Optional DataTable ESM lifecycle |
-| `@wpmoo/ui/sidebar.js` | Optional Sidebar ESM lifecycle |
-| `@wpmoo/ui/scss/facade-settings` | Public Sass variable allow-list (LibSass `@import`) |
-| `@wpmoo/ui/certification.json` | Versioned support/evidence manifest |
-| `@wpmoo/ui/package.json` | Package metadata |
+const combobox = document.querySelector(".combobox");
+if (combobox) {
+  MooUI.Combobox.getOrCreateInstance(combobox);
+}
+```
 
-The tarball also contains `README.md`, `LICENSE`, and `ASSET_LICENSE.md`. It
-does not publish catalog templates, preview artwork, catalog JavaScript, or
-internal SCSS partials beyond the facade's required settings import. Internal
-Sass partials and Jinja macros are repository build tools, not npm APIs.
+The runtime bundle is optional and side-effect-free. Import the aggregate
+`@wpmoo/ui/moo-ui.js` entrypoint, or import only the component module you use.
+The aggregate loads Chart.js only when `loadChart()` is called:
 
-## Why Bootstrap Teams Try It
+```js
+const chartRoot = document.querySelector(".chart");
+if (chartRoot) {
+  const Chart = await MooUI.loadChart();
+  Chart.getOrCreateInstance(chartRoot);
+}
+```
+
+RC10 replaces the aggregate's synchronous `Chart` export with the asynchronous
+`loadChart()` loader, also available as a named export. Both aggregate variants
+resolve the adjacent `chart.js` asset, so keep that file beside the aggregate
+when self-hosting. Repeated loader calls and direct `chart.js` imports share
+the same constructor. The standalone `chart.js` and `chart.min.js` APIs remain
+synchronous and unchanged.
+
+See the [Installation guide](https://ui.wpmoo.org/installation/) for npm, CDN,
+Sass, Bootstrap JavaScript, and ESM recipes.
+
+For server-marked Sheets, call the explicit initializer after Bootstrap
+Offcanvas is available on the document's window:
+
+```js
+import { initSheets } from "@wpmoo/ui/sheet.js";
+initSheets(document);
+```
+
+## Why Teams Try It
 
 - Keep server-rendered HTML, Bootstrap classes, and familiar plugin behavior.
 - Apply a restrained product rhythm to forms, overlays, navigation, data
@@ -157,15 +173,15 @@ Sass partials and Jinja macros are repository build tools, not npm APIs.
 - Inspect static rendered examples and copy the resulting HTML contracts.
 - Start with one scoped region or replace the full stylesheet after review.
 
-Representative components include Button, Field, Table, DataTable, Dialog,
-Toast, Sheet, Combobox, Context Menu, and Sidebar. Browse the [component catalog](https://ui.wpmoo.org/components/)
-and composed [blocks](https://ui.wpmoo.org/blocks/).
+Browse the [component catalog](https://ui.wpmoo.org/components/), composed
+[blocks](https://ui.wpmoo.org/blocks/), and full
+[examples](https://ui.wpmoo.org/examples/).
 
 ## Designed, Not Just Restyled
 
-The README uses original WPMoo preview artwork stored under
-`site/static/images/`; those files are source assets for the public catalog and
-are not part of the npm package.
+Moo UI is tuned for product interfaces: compact controls, quiet cards,
+predictable overlays, readable forms, and data-heavy screens that still feel
+calm.
 
 <p align="center">
   <a href="https://ui.wpmoo.org/components/button/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://ui.wpmoo.org/assets/images/readme/button-dark.svg"><img src="https://ui.wpmoo.org/assets/images/readme/button-light.svg" alt="Button preview" width="31%"></picture></a>
@@ -175,40 +191,29 @@ are not part of the npm package.
 
 ## Status And Support
 
-Moo UI is at the `1.0.0-rc.1` release candidate. Current package: `@wpmoo/ui@1.0.0-rc.1`. The
-package's certification manifest currently has `preview` status; catalog
-availability is WPMoo-maintained preview evidence, not independent or
-accredited certification. Read [Support & Evidence](https://ui.wpmoo.org/support/)
-for the Bootstrap range, browser policy, maturity definitions, limitations, and
-release evidence. Complete release notes are on
+The current release candidate is `1.0.0-rc.11`. Public exports, package boundaries, browser support, and release evidence live in [Support & Evidence](https://ui.wpmoo.org/support/).
+Complete release notes are on
 [GitHub Releases](https://github.com/wpmoo-org/ui/releases).
 
 ## Contributing
 
 Small documentation corrections, reduced reproductions, accessibility checks,
-and bounded component improvements are welcome. Start with
-[`CONTRIBUTING.md`](CONTRIBUTING.md), choose an
-[issue type](https://github.com/wpmoo-org/ui/issues/new/choose), and review the
-[Code of Conduct](CODE_OF_CONDUCT.md) and [security policy](SECURITY.md).
+and bounded component improvements are welcome. The
+[Contributing guide](https://ui.wpmoo.org/contributing/) covers local
+development, project boundaries, workflow, and issue types.
 
 ## Repository Layout And Development
 
-Moo UI Core is published from the repository root. Core source and package
-outputs live outside `site/`; `dist/` is the package build. The `site/` tree
-owns ui.wpmoo.org documentation, catalog chrome, public metadata, and protected
-preview artwork; it builds to `site-dist/`.
-
-```bash
-.venv/bin/python build.py
-.venv/bin/python dev.py
-.venv/bin/python -m unittest discover -s tests -v
-```
-
-Browse the local catalog at `http://localhost:4173/` while `dev.py` runs.
+Development setup and repository boundary notes live in the
+[Contributing guide](https://ui.wpmoo.org/contributing/). Consumer install
+paths live in the [Installation guide](https://ui.wpmoo.org/installation/).
 
 ## Licensing
 
-Moo UI source code is MIT licensed. WPMoo-generated visual assets under
-`site/static/images/` remain separately protected as described in
-`ASSET_LICENSE.md`. Vendored dependencies retain their original licenses; see
-`LICENSE`, `ASSET_LICENSE.md`, and `THIRD_PARTY_NOTICES.md`.
+Moo UI source code is MIT licensed. License details live in
+[LICENSE](LICENSE) and the [License page](https://ui.wpmoo.org/license/).
+The published `LICENSE` also retains the full MIT notices for bundled
+Chart.js and `@kurkle/color`.
+Asset terms live in [ASSET_LICENSE.md](ASSET_LICENSE.md); dependency notices
+live in the
+[version-pinned third-party notices](https://github.com/wpmoo-org/ui/blob/v1.0.0-rc.11/THIRD_PARTY_NOTICES.md).

package/certification.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "0.1",
   "status": "preview",
-  "coreVersion": "1.0.0-rc.1",
+  "coreVersion": "1.0.0-rc.11",
   "bootstrap": {
     "canonicalVersion": "5.3.3",
     "targetRange": ">=5.3.0 <5.4",
@@ -21,12 +21,34 @@
       "./moo.min.css"
     ],
     "esm": [
+      "./moo-ui.js",
+      "./moo-ui.min.js",
       "./combobox.js",
       "./sidebar.js",
       "./context-menu.js",
-      "./datatable.js"
+      "./datatable.js",
+      "./slider.js",
+      "./sheet.js",
+      "./chart.js",
+      "./chart.min.js",
+      "./datepicker.js",
+      "./datepicker.min.js"
     ],
-    "sass": ["./scss/facade-settings"]
+    "sass": [
+      "./scss/config",
+      "./scss/moo-ui",
+      "./scss/moo-core",
+      "./scss/components",
+      "./scss/settings"
+    ],
+    "browser": [
+      "./state.js"
+    ],
+    "metadata": [
+      "./certification.json",
+      "./package.json",
+      "./release-manifest.json"
+    ]
   },
   "supportPolicy": "https://github.com/wpmoo-org/ui/blob/main/SUPPORT.md"
 }