@wpmoo/ui 1.0.0-rc.7 → 1.0.0-rc.8

package/ASSET_LICENSE.md

@@ -14,6 +14,6 @@ product, site, template, library, training dataset, or marketing asset without
 prior written permission from WPMoo.
 
 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.7/THIRD_PARTY_NOTICES.md).
+[version-pinned third-party notices](https://github.com/wpmoo-org/ui/blob/v1.0.0-rc.8/THIRD_PARTY_NOTICES.md).
 Those notices are repository-only and are intentionally not shipped in the npm
 package.

package/README.md

@@ -40,10 +40,6 @@ language needs to feel more current.
 - **Explicit runtime.** Optional Moo UI behavior loads through ESM entrypoints
   only when a component needs behavior Bootstrap does not provide.
 
-This branch prepares `@wpmoo/ui@1.0.0-rc.7` for release. The published RC6
-package remains the CDN baseline for catalog CodePen exports until the RC7 npm
-tag exists.
-
 ## Try It in 30 Seconds
 
 The quick demo intentionally follows the floating npm tag:
@@ -93,6 +89,41 @@ import "bootstrap/dist/js/bootstrap.bundle.min.js"; // only when plugins are use
 </div>
 ```
 
+### Theme ownership and first paint
+
+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`:
+
+```html
+<!-- Server-resolved document: no prepaint 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>
+```
+
+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:
+
+```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/theme-prepaint.js"></script>
+  <!-- embedded Moo UI fragment -->
+</div>
+```
+
+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. The published
+asset is available as `@wpmoo/ui/theme-prepaint.js`.
+
 ### Optional runtime
 
 ```js
@@ -135,7 +166,7 @@ calm.
 
 ## Status And Support
 
-Moo UI is preparing the `1.0.0-rc.7` release candidate. Public exports, package boundaries, browser support, and release evidence live in [Support & Evidence](https://ui.wpmoo.org/support/).
+Moo UI is preparing the `1.0.0-rc.8` release candidate. 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).
 
@@ -158,4 +189,4 @@ Moo UI source code is MIT licensed. License details live in
 [LICENSE](LICENSE) and the [License page](https://ui.wpmoo.org/license/).
 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.7/THIRD_PARTY_NOTICES.md).
+[version-pinned third-party notices](https://github.com/wpmoo-org/ui/blob/v1.0.0-rc.8/THIRD_PARTY_NOTICES.md).

package/certification.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "0.1",
   "status": "preview",
-  "coreVersion": "1.0.0-rc.7",
+  "coreVersion": "1.0.0-rc.8",
   "bootstrap": {
     "canonicalVersion": "5.3.3",
     "targetRange": ">=5.3.0 <5.4",
@@ -40,9 +40,13 @@
       "./scss/components",
       "./scss/settings"
     ],
+    "browser": [
+      "./theme-prepaint.js"
+    ],
     "metadata": [
       "./certification.json",
-      "./package.json"
+      "./package.json",
+      "./release-manifest.json"
     ]
   },
   "supportPolicy": "https://github.com/wpmoo-org/ui/blob/main/SUPPORT.md"