@unisim/sdk 0.142.11 → 0.143.1

package/dist/themeStore.js

@@ -1,17 +1,23 @@
 'use client';
 import { useSyncExternalStore } from 'react';
+import { GLOBAL_COLOR_SCHEME_EVENT, GLOBAL_COLOR_SCHEME_KEY } from './colorSchemeKeys.js';
+export { GLOBAL_COLOR_SCHEME_EVENT, GLOBAL_COLOR_SCHEME_KEY } from './colorSchemeKeys.js';
 const DARK_QUERY = '(prefers-color-scheme: dark)';
 function hasDom() {
     return typeof window !== 'undefined' && typeof document !== 'undefined';
 }
+function isThemePref(v) {
+    return v === 'light' || v === 'dark' || v === 'system';
+}
+/** A valid stored preference, or `null` for absent, corrupt or unreadable. */
 function readStored(storageKey) {
     try {
         const v = window.localStorage.getItem(storageKey);
-        if (v === 'light' || v === 'dark' || v === 'system')
+        if (isThemePref(v))
             return v;
     }
     catch { /* private mode / storage disabled */ }
-    return 'light';
+    return null;
 }
 function osPrefersDark() {
     try {
@@ -39,30 +45,55 @@ function apply(pref) {
  * export const useThemeStore = createThemeStore('unisim-video-theme')
  * ```
  *
- * The stored preference is read and applied to `<html>` immediately — at
+ * The resolved preference is read and applied to `<html>` immediately — at
  * import time, before React renders — so a dark-mode user does not see a light
- * frame first.
+ * frame first. Pass the store to the navbar (`themeStore={useThemeStore}`) and
+ * App preferences offers the override.
  *
- * ⚠️ **The key is the user's saved choice.** Changing it on an existing app
- * resets everyone's theme to light without a word. Existing apps keep the key
- * their copy used (`unisim-<app>-theme`); a new app should follow that pattern.
+ * ⚠️ **The key is the user's saved choice** — since 0.143.0, their override of
+ * the global one. Changing it on an existing app silently puts everyone who
+ * chose something in that app back to following global. Existing apps keep
+ * the key their copy used (`unisim-<app>-theme`); a new app should follow that
+ * pattern.
  *
- * Only follows the OS live while the user has actually chosen `'system'`.
+ * Only follows the OS live while the resolved preference is `'system'`.
  */
 export function createThemeStore(storageKey) {
     const listeners = new Set();
     const emit = () => { for (const l of listeners)
         l(); };
-    const setPref = (next) => {
+    // Held in memory as well as in storage: when storage throws (private mode,
+    // blocked site data) these are the only copy, and a choice must still apply
+    // for the life of the page.
+    let override = hasDom() ? readStored(storageKey) : null;
+    let global = (hasDom() ? readStored(GLOBAL_COLOR_SCHEME_KEY) : null) ?? 'light';
+    // Declarations, not arrows: `state` is built from them below, and both must
+    // be the SAME function on every state object — a selector on `setPref` is
+    // what a component holds on to (see the "same function on every render" test).
+    function setOverride(next) {
+        const value = isThemePref(next) ? next : null;
         try {
-            window.localStorage.setItem(storageKey, next);
+            if (value)
+                window.localStorage.setItem(storageKey, value);
+            else
+                window.localStorage.removeItem(storageKey);
         }
         catch { /* ignore */ }
-        state = { pref: next, effective: apply(next), setPref };
+        override = value;
+        commit();
+    }
+    function setPref(next) {
+        setOverride(next);
+    }
+    function resolve() {
+        const pref = override ?? global;
+        return { pref, effective: apply(pref), override, global, setOverride, setPref };
+    }
+    function commit() {
+        state = resolve();
         emit();
-    };
-    const initial = hasDom() ? readStored(storageKey) : 'light';
-    let state = { pref: initial, effective: apply(initial), setPref };
+    }
+    let state = resolve();
     if (hasDom()) {
         try {
             window.matchMedia?.(DARK_QUERY).addEventListener?.('change', () => {
@@ -73,6 +104,23 @@ export function createThemeStore(storageKey) {
             });
         }
         catch { /* no matchMedia: 'system' resolves once and stays */ }
+        // The provider on this page changed the global. `detail` is trusted before
+        // storage: it is the value just chosen, and storage may be what threw.
+        window.addEventListener(GLOBAL_COLOR_SCHEME_EVENT, (e) => {
+            const detail = e.detail;
+            global = isThemePref(detail) ? detail : (readStored(GLOBAL_COLOR_SCHEME_KEY) ?? 'light');
+            commit();
+        });
+        // Another tab changed either key. `key === null` is a `localStorage.clear()`.
+        window.addEventListener('storage', (e) => {
+            if (e.key !== null && e.key !== storageKey && e.key !== GLOBAL_COLOR_SCHEME_KEY)
+                return;
+            if (e.key === null || e.key === storageKey)
+                override = readStored(storageKey);
+            if (e.key === null || e.key === GLOBAL_COLOR_SCHEME_KEY)
+                global = readStored(GLOBAL_COLOR_SCHEME_KEY) ?? 'light';
+            commit();
+        });
     }
     const getState = () => state;
     const subscribe = (listener) => {

package/dist/themeStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"themeStore.js","sourceRoot":"","sources":["../src/themeStore.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AA2C5C,MAAM,UAAU,GAAG,8BAA8B,CAAA;AAEjD,SAAS,MAAM;IACb,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,CAAA;AACzE,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB;IACpC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACjD,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAA;IAC/D,CAAC;IAAC,MAAM,CAAC,CAAC,qCAAqC,CAAC,CAAC;IACjD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,CAAC,OAAO,KAAK,IAAI,CAAA;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,IAAe;IAC5B,IAAI,CAAC,MAAM,EAAE;QAAE,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;IACxD,MAAM,SAAS,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjF,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,CAAC,CAAA;IACvE,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAA;IACtD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;IACvC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,CAAC,EAAE,CAAA,CAAC,CAAC,CAAA;IAErD,MAAM,OAAO,GAAG,CAAC,IAAe,EAAQ,EAAE;QACxC,IAAI,CAAC;YAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAC5E,KAAK,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;QACvD,IAAI,EAAE,CAAA;IACR,CAAC,CAAA;IAED,MAAM,OAAO,GAAc,MAAM,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACtE,IAAI,KAAK,GAAe,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IAE7E,IAAI,MAAM,EAAE,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,CAAC,UAAU,EAAE,CAAC,UAAU,CAAC,CAAC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBAChE,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAM;gBACnC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAA;gBAChD,IAAI,EAAE,CAAA;YACR,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC,CAAC,qDAAqD,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,KAAK,CAAA;IAC5B,MAAM,SAAS,GAAG,CAAC,QAAoB,EAAE,EAAE;QACzC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACvB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;IAC7C,CAAC,CAAA;IAID,SAAS,aAAa,CAAI,QAAmC;QAC3D,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACpE,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IACjD,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAA;AAC1E,CAAC"}
+{"version":3,"file":"themeStore.js","sourceRoot":"","sources":["../src/themeStore.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisim/sdk",
-  "version": "0.142.11",
+  "version": "0.143.1",
   "description": "Shared React SDK for the Universal Suite — auth, entitlements, usage telemetry, changelog, org admin.",
   "license": "MIT",
   "author": "Universal Simulation Ltd",
@@ -78,6 +78,7 @@
     "test:mock-auth": "npm run build && node tests/mock-auth-trial.browser.mjs",
     "test:usage-tracker": "npm run build && node tests/usage-tracker.browser.mjs",
     "test:theme-store": "npm run build && node tests/theme-store.browser.mjs",
+    "test:preferences": "npm run build && node tests/preferences-dialog.browser.mjs",
     "test:contrast": "npm run build && node tests/contrast.mjs",
     "test:chips": "npm run build && node tests/chips.browser.mjs",
     "test:i18n": "npm run build && node tests/i18n.mjs",