@vxrn/color-scheme 1.13.2 → 1.13.4

package/dist/esm/index.mjs

@@ -1,5 +1,5 @@
 import { useIsomorphicLayoutEffect } from "@vxrn/use-isomorphic-layout-effect";
-import { setUserScheme, useUserScheme } from "./userScheme.mjs";
+import { getForceScheme, setForceScheme, setUserScheme, useUserScheme } from "./userScheme.mjs";
 import { getSystemScheme, useSystemScheme } from "./systemScheme.mjs";
 import { getUserScheme, onUserSchemeChange, setUserScheme as setUserScheme2, useUserScheme as useUserScheme2 } from "./userScheme.mjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -7,28 +7,32 @@ const storageKey = "vxrn-scheme";
 function SchemeProvider({
   children,
   getClassName = name => `t_${name}`,
-  defaultScheme
+  defaultScheme,
+  forceScheme
 }) {
+  setForceScheme(forceScheme ?? null);
   const {
-    value
-  } = useUserScheme();
+      value
+    } = useUserScheme(),
+    resolvedValue = forceScheme ?? value;
   useIsomorphicLayoutEffect(() => {
-    defaultScheme && typeof localStorage < "u" && (localStorage.getItem(storageKey) || setUserScheme(defaultScheme));
-  }, []), useIsomorphicLayoutEffect(() => {
-    const toAdd = getClassName(value),
-      toRemove = getClassName(value === "light" ? "dark" : "light"),
+    !forceScheme && defaultScheme && typeof localStorage < "u" && (localStorage.getItem(storageKey) || setUserScheme(defaultScheme));
+  }, [defaultScheme, forceScheme]), useIsomorphicLayoutEffect(() => {
+    const toAdd = getClassName(resolvedValue),
+      toRemove = getClassName(resolvedValue === "light" ? "dark" : "light"),
       {
         classList
       } = document.documentElement;
     classList.remove(toRemove), classList.contains(toAdd) || classList.add(toAdd);
-  }, [value]);
-  const fallback = defaultScheme ? `'${defaultScheme}' === 'dark'` : "window.matchMedia('(prefers-color-scheme: dark)').matches",
-    seedStorage = defaultScheme ? `if(!e){localStorage.setItem('${storageKey}','${defaultScheme}')}` : "";
-  return /* @__PURE__ */jsxs(Fragment, {
-    children: [/* @__PURE__ */jsx("script", {
-      suppressHydrationWarning: !0,
-      dangerouslySetInnerHTML: {
-        __html: `let d = document.documentElement.classList
+  }, [getClassName, resolvedValue]);
+  let scriptContent;
+  if (forceScheme) scriptContent = `let d = document.documentElement.classList
+d.remove('${getClassName("light")}')
+d.remove('${getClassName("dark")}')
+d.add('${getClassName(forceScheme)}')`;else {
+    const fallback = defaultScheme ? `'${defaultScheme}' === 'dark'` : "window.matchMedia('(prefers-color-scheme: dark)').matches",
+      seedStorage = defaultScheme ? `if(!e){localStorage.setItem('${storageKey}','${defaultScheme}')}` : "";
+    scriptContent = `let d = document.documentElement.classList
 d.remove('${getClassName("light")}')
 d.remove('${getClassName("dark")}')
 let e = localStorage.getItem('${storageKey}')
@@ -36,8 +40,13 @@ ${seedStorage}
 let t = 'system' === e || !e
   ? ${fallback}
   : e === 'dark'
-t ? d.add('${getClassName("dark")}') : d.add('${getClassName("light")}')
-`
+t ? d.add('${getClassName("dark")}') : d.add('${getClassName("light")}')`;
+  }
+  return /* @__PURE__ */jsxs(Fragment, {
+    children: [/* @__PURE__ */jsx("script", {
+      suppressHydrationWarning: !0,
+      dangerouslySetInnerHTML: {
+        __html: scriptContent
       }
     }), children]
   });
@@ -48,8 +57,13 @@ function MetaTheme({
   lightColor
 }) {
   const {
-    value
-  } = useUserScheme();
+      value
+    } = useUserScheme(),
+    forced = getForceScheme(),
+    scriptContent = forced ? `document.getElementById('vxrn-theme-color').setAttribute('content','${forced === "dark" ? darkColor : lightColor}')` : `let dc = document.getElementById('vxrn-theme-color')
+let e1 = localStorage.getItem('${storageKey}')
+let isD = 'system' === e1 || !e1 ? window.matchMedia('(prefers-color-scheme: dark)').matches : e1 === 'dark'
+dc.setAttribute('content', isD ? '${darkColor}' : '${lightColor}')`;
   return /* @__PURE__ */jsxs(Fragment, {
     children: [/* @__PURE__ */jsx("meta", {
       suppressHydrationWarning: !0,
@@ -60,12 +74,7 @@ function MetaTheme({
       suppressHydrationWarning: !0,
       id: "meta-theme-hydrate",
       dangerouslySetInnerHTML: {
-        __html: `
-let dc = document.getElementById('vxrn-theme-color')
-let e1 = localStorage.getItem('${storageKey}')
-let isD = 'system' === e1 || !e1 ? window.matchMedia('(prefers-color-scheme: dark)').matches : e1 === 'dark'
-dc.setAttribute('content', isD ? '${darkColor}' : '${lightColor}')
-`
+        __html: scriptContent
       }
     })]
   });

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["useIsomorphicLayoutEffect","setUserScheme","useUserScheme","getSystemScheme","useSystemScheme","getUserScheme","onUserSchemeChange","setUserScheme2","useUserScheme2","Fragment","jsx","jsxs","storageKey","SchemeProvider","children","getClassName","name","defaultScheme","value","localStorage","getItem","toAdd","toRemove","classList","document","documentElement","remove","contains","add","fallback","seedStorage","suppressHydrationWarning","dangerouslySetInnerHTML","__html","MetaTheme","color","darkColor","lightColor","id","content"],"sources":["../../src/index.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,yBAAA,QAAiC;AAE1C,SAASC,aAAA,EAAeC,aAAA,QAAqB;AAO7C,SAASC,eAAA,EAAiBC,eAAA,QAAuB;AACjD,SACEC,aAAA,EACAC,kBAAA,EACAL,aAAA,IAAAM,cAAA,EACAL,aAAA,IAAAM,cAAA,QACK;AA8CH,SAAAC,QAAA,EAEIC,GAAA,EAFJC,IAAA;AA5CJ,MAAMC,UAAA,GAAa;AAEZ,SAASC,eAAe;EAC7BC,QAAA;EACAC,YAAA,GAAgBC,IAAA,IAAS,KAAKA,IAAI;EAClCC;AACF,GAKG;EACD,MAAM;IAAEC;EAAM,IAAIhB,aAAA,CAAc;EAI9BF,yBAAA,CAA0B,MAAM;IAC1BiB,aAAA,IAAiB,OAAOE,YAAA,GAAiB,QACtCA,YAAA,CAAaC,OAAA,CAAQR,UAAU,KAClCX,aAAA,CAAcgB,aAAa;EAGjC,GAAG,EAAE,GAELjB,yBAAA,CAA0B,MAAM;IAC9B,MAAMqB,KAAA,GAAQN,YAAA,CAAaG,KAAK;MAC1BI,QAAA,GAAWP,YAAA,CAAaG,KAAA,KAAU,UAAU,SAAS,OAAO;MAC5D;QAAEK;MAAU,IAAIC,QAAA,CAASC,eAAA;IAC/BF,SAAA,CAAUG,MAAA,CAAOJ,QAAQ,GACpBC,SAAA,CAAUI,QAAA,CAASN,KAAK,KAC3BE,SAAA,CAAUK,GAAA,CAAIP,KAAK;EAEvB,GAAG,CAACH,KAAK,CAAC;EAGZ,MAAMW,QAAA,GAAWZ,aAAA,GACb,IAAIA,aAAa,iBACjB;IAEEa,WAAA,GAAcb,aAAA,GAChB,gCAAgCL,UAAU,MAAMK,aAAa,QAC7D;EAEJ,OACE,eAAAN,IAAA,CAAAF,QAAA;IAEIK,QAAA,kBAAAJ,GAAA,CAAC;MACCqB,wBAAA,EAAwB;MACxBC,uBAAA,EAAyB;QACvBC,MAAA,EAAQ;AAAA,YACRlB,YAAA,CAAa,OAAO,CAAC;AAAA,YACrBA,YAAA,CAAa,MAAM,CAAC;AAAA,gCACAH,UAAU;AAAA,EACxCkB,WAAW;AAAA;AAAA,MAEPD,QAAQ;AAAA;AAAA,aAEDd,YAAA,CAAa,MAAM,CAAC,eAAeA,YAAA,CAAa,OAAO,CAAC;AAAA;MAE3D;IAAA,CACF,GAEDD,QAAA;EAAA,CACH;AAEJ;AAEO,SAASoB,UAAU;EACxBC,KAAA;EACAC,SAAA;EACAC;AACF,GAIG;EACD,MAAM;IAAEnB;EAAM,IAAIhB,aAAA,CAAc;EAEhC,OACE,eAAAS,IAAA,CAAAF,QAAA;IACEK,QAAA,kBAAAJ,GAAA,CAAC;MACCqB,wBAAA,EAAwB;MACxBO,EAAA,EAAG;MACHtB,IAAA,EAAK;MACLuB,OAAA,EAASJ,KAAA,KAAUjB,KAAA,KAAU,SAASkB,SAAA,GAAYC,UAAA;IAAA,CACpD,GACA,eAAA3B,GAAA,CAAC;MACCqB,wBAAA,EAAwB;MACxBO,EAAA,EAAG;MACHN,uBAAA,EAAyB;QACvBC,MAAA,EAAQ;AAAA;AAAA,iCAEerB,UAAU;AAAA;AAAA,oCAEPwB,SAAS,QAAQC,UAAU;AAAA;MAEvD;IAAA,CACF;EAAA,CACF;AAEJ","ignoreList":[]}
+{"version":3,"names":["useIsomorphicLayoutEffect","getForceScheme","setForceScheme","setUserScheme","useUserScheme","getSystemScheme","useSystemScheme","getUserScheme","onUserSchemeChange","setUserScheme2","useUserScheme2","Fragment","jsx","jsxs","storageKey","SchemeProvider","children","getClassName","name","defaultScheme","forceScheme","value","resolvedValue","localStorage","getItem","toAdd","toRemove","classList","document","documentElement","remove","contains","add","scriptContent","fallback","seedStorage","suppressHydrationWarning","dangerouslySetInnerHTML","__html","MetaTheme","color","darkColor","lightColor","forced","id","content"],"sources":["../../src/index.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/index.native.js

@@ -1,21 +1,39 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useUserScheme } from "./userScheme.native.js";
+import { getForceScheme, setForceScheme, useUserScheme } from "./userScheme.native.js";
 import { getSystemScheme, useSystemScheme } from "./systemScheme.native.js";
 import { getUserScheme, onUserSchemeChange, setUserScheme as setUserScheme2, useUserScheme as useUserScheme2 } from "./userScheme.native.js";
 var storageKey = "vxrn-scheme";
 function SchemeProvider(param) {
   var {
-      children,
-      getClassName = function (name) {
-        return `t_${name}`;
-      },
-      defaultScheme
-    } = param,
-    {
+    children,
+    getClassName = function (name) {
+      return `t_${name}`;
+    },
+    defaultScheme,
+    forceScheme
+  } = param;
+  setForceScheme(forceScheme ?? null);
+  var {
       value
     } = useUserScheme(),
-    fallback = defaultScheme ? `'${defaultScheme}' === 'dark'` : "window.matchMedia('(prefers-color-scheme: dark)').matches",
-    seedStorage = defaultScheme ? `if(!e){localStorage.setItem('${storageKey}','${defaultScheme}')}` : "";
+    resolvedValue = forceScheme ?? value,
+    scriptContent;
+  if (forceScheme) scriptContent = `let d = document.documentElement.classList
+d.remove('${getClassName("light")}')
+d.remove('${getClassName("dark")}')
+d.add('${getClassName(forceScheme)}')`;else {
+    var fallback = defaultScheme ? `'${defaultScheme}' === 'dark'` : "window.matchMedia('(prefers-color-scheme: dark)').matches",
+      seedStorage = defaultScheme ? `if(!e){localStorage.setItem('${storageKey}','${defaultScheme}')}` : "";
+    scriptContent = `let d = document.documentElement.classList
+d.remove('${getClassName("light")}')
+d.remove('${getClassName("dark")}')
+let e = localStorage.getItem('${storageKey}')
+${seedStorage}
+let t = 'system' === e || !e
+  ? ${fallback}
+  : e === 'dark'
+t ? d.add('${getClassName("dark")}') : d.add('${getClassName("light")}')`;
+  }
   return /* @__PURE__ */_jsxs(_Fragment, {
     children: [null, children]
   });
@@ -28,7 +46,12 @@ function MetaTheme(param) {
     } = param,
     {
       value
-    } = useUserScheme();
+    } = useUserScheme(),
+    forced = getForceScheme(),
+    scriptContent = forced ? `document.getElementById('vxrn-theme-color').setAttribute('content','${forced === "dark" ? darkColor : lightColor}')` : `let dc = document.getElementById('vxrn-theme-color')
+let e1 = localStorage.getItem('${storageKey}')
+let isD = 'system' === e1 || !e1 ? window.matchMedia('(prefers-color-scheme: dark)').matches : e1 === 'dark'
+dc.setAttribute('content', isD ? '${darkColor}' : '${lightColor}')`;
   return /* @__PURE__ */_jsxs(_Fragment, {
     children: [/* @__PURE__ */_jsx("meta", {
       suppressHydrationWarning: !0,
@@ -39,12 +62,7 @@ function MetaTheme(param) {
       suppressHydrationWarning: !0,
       id: "meta-theme-hydrate",
       dangerouslySetInnerHTML: {
-        __html: `
-let dc = document.getElementById('vxrn-theme-color')
-let e1 = localStorage.getItem('${storageKey}')
-let isD = 'system' === e1 || !e1 ? window.matchMedia('(prefers-color-scheme: dark)').matches : e1 === 'dark'
-dc.setAttribute('content', isD ? '${darkColor}' : '${lightColor}')
-`
+        __html: scriptContent
       }
     })]
   });

package/dist/esm/index.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["jsx","_jsx","jsxs","_jsxs","Fragment","_Fragment","useUserScheme","getSystemScheme","useSystemScheme","getUserScheme","onUserSchemeChange","setUserScheme","setUserScheme2","useUserScheme2","storageKey","SchemeProvider","param","children","getClassName","name","defaultScheme","value","fallback","seedStorage","MetaTheme","color","darkColor","lightColor","suppressHydrationWarning","id","content","dangerouslySetInnerHTML","__html"],"sources":["../../src/index.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA,EAAAC,QAAiC,IAAAC,SAAA;AAS1C,SAASC,aAAA,QAAiB;AAC1B,SAAAC,eAAA,EAAAC,eAAA;AAAA,SACEC,aAAA,EAAAC,kBAAA,EAAAC,aAAA,IAAAC,cAAA,EAAAN,aAAA,IAAAO,cAAA;AAAA,IACAC,UAAA;AAAA,SACAC,eAAAC,KAAA;EACA;MAAAC,QAAA;MAAAC,YAAA,YAAAA,CAAAC,IAAA;QAAA,OACK,KAAAA,IAAA;MA8CH;MAAAC;IAEI,IAAAJ,KAFJ;IAAA;MAAAK;IAAA,IAAAf,aAAA;IAAAgB,QAAA,GAAAF,aAAA,OAAAA,aAAA;IAAAG,WAAA,GAAAH,aAAA,mCAAAN,UAAA,MAAAM,aAAA;EA5CJ,OAAM,eAAajB,KAAA,CAAAE,SAAA;IAEZY,QAAS,GACd,MACAA,QAAA;EAEF,CAKG;AACD;AAIE,SAAAO,UAAAR,KAAA;EACE,IAAI;MAAAS,KAAA;MAAAC,SAAiB;MAAAC;IAAO,IAAAX,KAAiB;IAAA;MAAAK;IACtC,IAAAf,aAAqB;EAI9B,OAAK,eAELH,KAAA,CAAAE,SAA0B,EAAM;IAC9BY,QAAM,GAGN,eAAiBhB,IAAA,OACZ;MAGH2B,wBAAM;MAGNC,EAAA,oBAAW;MAQjBV,IACE;MAEIW,OAAA,EAAAL,KAAA,KAAAJ,KAAA,cAAAK,SAAA,GAAAC,UAAA;IAAC,mBAAA1B,IAAA;MACC2B,wBAAA,EAAwB;MACxBC,EAAA;MAAyBE,uBACf;QAAAC,MACR;AAAqB;AACD,iCACAlB,UAAU;AAAA;AAC7B,oCAAAY,SAAA,QAAAC,UAAA;AAAA;MAEC;IAAA;EAEuD;AAE3D;AAAA,SACFH,SAED,EAAAT,cACH,EAEJR,eAAA,EAEOE,aAAS,EACdC,kBAAA,EACAE,cAAA,IAAAD,aAAA,EACAH,eAAA,EACFK,cAIG,IAAAP,aAAA","ignoreList":[]}
+{"version":3,"names":["jsx","_jsx","jsxs","_jsxs","Fragment","_Fragment","getForceScheme","setForceScheme","useUserScheme","getSystemScheme","useSystemScheme","getUserScheme","onUserSchemeChange","setUserScheme","setUserScheme2","useUserScheme2","storageKey","SchemeProvider","param","children","getClassName","name","defaultScheme","forceScheme","value","resolvedValue","scriptContent","fallback","seedStorage","MetaTheme","color","darkColor","lightColor","forced","suppressHydrationWarning","id","content","dangerouslySetInnerHTML","__html"],"sources":["../../src/index.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA,EAAAC,QAAiC,IAAAC,SAAA;AAE1C,SACEC,cAAA,EAAAC,cAAA,EAAAC,aAAA;AAAA,SACAC,eAAA,EAAAC,eAAA;AAAA,SACAC,aAAA,EAAAC,kBAAA,EAAAC,aAAA,IAAAC,cAAA,EAAAN,aAAA,IAAAO,cAAA;AAAA,IACAC,UAAA;AAAA,SACKC,eAAAC,KAAA;EAOP;IAAAC,QAAS;IAAAC,YAAiB,YAAAA,CAAAC,IAAA;MAC1B,YAAAA,IAAA;IACE;IAAAC,aAAA;IAAAC;EAAA,IAAAL,KAAA;EACAX,cAAA,CAAAgB,WAAA;EACA;MAAAC;IAAA,IAAAhB,aAAA;IAAAiB,aAAA,GAAAF,WAAA,IAAAC,KAAA;IAAAE,aAAA;EACA,IAAAH,WAAA,EAAAG,aACK;AAyEH,YAAAN,YAAA;AAvEJ,YAAMA,YAAa;AAEZ,SAASA,YAAA,CAAAG,WAAe,WAC7B;IACA,IAAAI,QAAA,GAAgBL,aAAc,OAAIA,aAAA;MAAAM,WAAA,GAAAN,aAAA,mCAAAN,UAAA,MAAAM,aAAA;IAClCI,aAAA;AAAA,YACAN,YAAA;AACF,YAOGA,YAAA;AAED,gCAA8BJ,UAAI;AAElC,EAAAY,WAAQ;AAKN;AACE,MAAKD,QAAA;AAE0B;AAM/B,aAAMP,YAAQ,OAAa,gBACrBA,YAAW,aAAa;EAE9B;EAIF,OAAI,eAAcjB,KAAA,CAAAE,SAAc;IAGlCc,QAAI,GAEA,MAEFA,QAAA;EAC6B;AACD;AACE,SACzBU,UAAAX,KAAA;EACL;MAAAY,KAAM;MAAAC,SAAW;MAAAC;IACb,IAAId,KAAA;IAAA;MAAAM;IAAa,IAAAhB,aACjB;IAAAyB,MAAA,GAAA3B,cAAA;IAAAoB,aAAA,GAAAO,MAAA,0EAGgCA,MAAU,KAAM,SAAAF,SAAa,GAC7DC,UAAA;AAEJ,iCAAgBhB,UAAA;AAAA;AACa,oCACDe,SAAA,QAAAC,UAAA;EAAA,sBAAA7B,KAAA,CAAAE,SACA,EAAU;IACxCc,QAAA,EAAW,gBAAAlB,IAAA;MAEPiC,wBAAQ;MAAAC,EAAA;MAAAd,IAAA,EAED,aAAa;MACxBe,OAAA,EAAAN,KAAA,KAAAN,KAAA,cAAAO,SAAA,GAAAC,UAAA;IAEA,IAGM,eAAA/B,IAAA;MAACiC,wBAAA;MAAAC,EAAA;MACCE,uBAAA;QACAC,MAAA,EAAAZ;MAAiD;IACnD;EAED;AAGP;AAEO,SACLG,SAAA,EACAZ,cAAA,EACAR,eAAA,EACFE,aAIG,EACDC,kBAAkB,EAKdE,cAAA,IAAAD,aAC2B,EAAUH,eAAA,EAAAK,cAAA,IAAAP,aAAA","ignoreList":[]}

package/dist/esm/userScheme.mjs

@@ -3,6 +3,29 @@ import { useState, useMemo } from "react";
 import { getSystemScheme } from "./systemScheme.mjs";
 const listeners = /* @__PURE__ */new Set(),
   storageKey = "vxrn-scheme";
+let _forceScheme = null;
+function notifyListeners() {
+  listeners.forEach(listener => {
+    listener(currentSetting, currentValue);
+  });
+}
+function restoreUnforcedScheme() {
+  if (typeof localStorage < "u") {
+    const stored = localStorage.getItem(storageKey);
+    if (stored) {
+      currentSetting = stored, currentValue = stored === "system" ? resolveValue("system") : stored;
+      return;
+    }
+  }
+  currentSetting = "system", currentValue = resolveValue("system");
+}
+function setForceScheme(scheme) {
+  const wasForced = _forceScheme;
+  wasForced !== scheme && (_forceScheme = scheme, scheme ? (currentSetting = scheme, currentValue = scheme) : wasForced && (restoreUnforcedScheme(), startWebListener()));
+}
+function getForceScheme() {
+  return _forceScheme;
+}
 function getInitialSetting() {
   return "system";
 }
@@ -26,22 +49,23 @@ function resolveValue(setting) {
   return setting === "system" ? getSystemScheme() : setting;
 }
 function updateValueFromSystem() {
+  if (_forceScheme) return;
   const value = resolveValue("system");
-  value !== currentValue && (currentValue = value, listeners.forEach(l => {
-    l(currentSetting, currentValue);
-  }));
+  value !== currentValue && (currentValue = value, notifyListeners());
 }
 function updateScheme(setting) {
+  if (_forceScheme) return;
   const value = setting === "system" ? resolveValue("system") : setting;
-  (value !== currentValue || currentSetting !== setting) && (currentSetting = setting, currentValue = value, listeners.forEach(l => {
-    l(currentSetting, currentValue);
-  }));
+  (value !== currentValue || currentSetting !== setting) && (currentSetting = setting, currentValue = value, notifyListeners());
 }
 function setUserScheme(setting) {
-  typeof localStorage < "u" && localStorage.setItem(storageKey, setting), updateScheme(setting);
+  _forceScheme || (typeof localStorage < "u" && localStorage.setItem(storageKey, setting), updateScheme(setting));
 }
 function getUserScheme() {
-  return {
+  return _forceScheme ? {
+    setting: _forceScheme,
+    value: _forceScheme
+  } : {
     setting: currentSetting,
     value: currentValue
   };
@@ -52,24 +76,28 @@ function onUserSchemeChange(listener) {
   };
 }
 function useUserScheme() {
-  const [state, setState] = useState(() => getUserScheme());
+  const [state, setState] = useState(() => getUserScheme()),
+    snapshot = getUserScheme(),
+    resolvedState = state.setting === snapshot.setting && state.value === snapshot.value ? state : snapshot;
   return useIsomorphicLayoutEffect(() => {
-    if (typeof localStorage < "u") {
-      const stored = localStorage.getItem(storageKey);
-      stored && updateScheme(stored);
+    if (!_forceScheme) {
+      if (typeof localStorage < "u") {
+        const stored = localStorage.getItem(storageKey);
+        stored && updateScheme(stored);
+      }
+      startWebListener();
     }
-    const dispose = onUserSchemeChange((setting, value) => {
+    return onUserSchemeChange((setting, value) => {
       setState({
         setting,
         value
       });
     });
-    return startWebListener(), dispose;
   }, []), useMemo(() => ({
-    setting: state.setting,
-    value: state.value,
+    setting: resolvedState.setting,
+    value: resolvedState.value,
     set: setUserScheme
-  }), [state.setting, state.value]);
+  }), [resolvedState.setting, resolvedState.value]);
 }
-export { getUserScheme, onUserSchemeChange, setUserScheme, useUserScheme };
+export { getForceScheme, getUserScheme, onUserSchemeChange, setForceScheme, setUserScheme, useUserScheme };
 //# sourceMappingURL=userScheme.mjs.map

package/dist/esm/userScheme.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["useIsomorphicLayoutEffect","useState","useMemo","getSystemScheme","listeners","Set","storageKey","getInitialSetting","getInitialValue","setting","initialSetting","currentSetting","currentValue","isWebListening","startWebListener","matcher","window","matchMedia","onSystemChange","updateValueFromSystem","addEventListener","resolveValue","value","forEach","l","updateScheme","setUserScheme","localStorage","setItem","getUserScheme","onUserSchemeChange","listener","add","delete","useUserScheme","state","setState","stored","getItem","dispose","set"],"sources":["../../src/userScheme.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useIsomorphicLayoutEffect","useState","useMemo","getSystemScheme","listeners","Set","storageKey","_forceScheme","notifyListeners","forEach","listener","currentSetting","currentValue","restoreUnforcedScheme","localStorage","stored","getItem","resolveValue","setForceScheme","scheme","wasForced","startWebListener","getForceScheme","getInitialSetting","getInitialValue","setting","initialSetting","isWebListening","matcher","window","matchMedia","onSystemChange","updateValueFromSystem","addEventListener","value","updateScheme","setUserScheme","setItem","getUserScheme","onUserSchemeChange","add","delete","useUserScheme","state","setState","snapshot","resolvedState","set"],"sources":["../../src/userScheme.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/userScheme.native.js

@@ -3,7 +3,30 @@ import { useState, useMemo } from "react";
 import { Appearance } from "react-native";
 import { getSystemScheme } from "./systemScheme.native.js";
 var listeners = /* @__PURE__ */new Set(),
-  storageKey = "vxrn-scheme";
+  storageKey = "vxrn-scheme",
+  _forceScheme = null;
+function notifyListeners() {
+  listeners.forEach(function (listener) {
+    listener(currentSetting, currentValue);
+  });
+}
+function restoreUnforcedScheme() {
+  if (typeof localStorage < "u") {
+    var stored = localStorage.getItem(storageKey);
+    if (stored) {
+      currentSetting = stored, currentValue = stored === "system" ? resolveValue("system") : stored;
+      return;
+    }
+  }
+  currentSetting = "system", currentValue = resolveValue("system");
+}
+function setForceScheme(scheme) {
+  var wasForced = _forceScheme;
+  wasForced !== scheme && (_forceScheme = scheme, scheme ? (currentSetting = scheme, currentValue = scheme) : wasForced && (restoreUnforcedScheme(), startWebListener()));
+}
+function getForceScheme() {
+  return _forceScheme;
+}
 function getInitialSetting() {
   if (typeof localStorage < "u") {
     var stored = localStorage.getItem(storageKey);
@@ -36,22 +59,25 @@ function resolveValue(setting) {
   return setting === "system" ? Appearance.getColorScheme() === "dark" ? "dark" : "light" : setting;
 }
 function updateValueFromSystem() {
-  var value = resolveValue("system");
-  value !== currentValue && (currentValue = value, listeners.forEach(function (l) {
-    l(currentSetting, currentValue);
-  }));
+  if (!_forceScheme) {
+    var value = resolveValue("system");
+    value !== currentValue && (currentValue = value, notifyListeners());
+  }
 }
 function updateScheme(setting) {
-  var value = setting === "system" ? resolveValue("system") : setting;
-  (value !== currentValue || currentSetting !== setting) && (currentSetting = setting, currentValue = value, setting !== "system" ? Appearance.setColorScheme(value) : Appearance.setColorScheme("unspecified"), listeners.forEach(function (l) {
-    l(currentSetting, currentValue);
-  }));
+  if (!_forceScheme) {
+    var value = setting === "system" ? resolveValue("system") : setting;
+    (value !== currentValue || currentSetting !== setting) && (currentSetting = setting, currentValue = value, setting !== "system" ? Appearance.setColorScheme(value) : Appearance.setColorScheme("unspecified"), notifyListeners());
+  }
 }
 function setUserScheme(setting) {
-  typeof localStorage < "u" && localStorage.setItem(storageKey, setting), updateScheme(setting);
+  _forceScheme || (typeof localStorage < "u" && localStorage.setItem(storageKey, setting), updateScheme(setting));
 }
 function getUserScheme() {
-  return {
+  return _forceScheme ? {
+    setting: _forceScheme,
+    value: _forceScheme
+  } : {
     setting: currentSetting,
     value: currentValue
   };
@@ -63,12 +89,17 @@ function onUserSchemeChange(listener) {
 }
 function useUserScheme() {
   var [state, setState] = useState(function () {
-    return getUserScheme();
-  });
+      return getUserScheme();
+    }),
+    snapshot = getUserScheme(),
+    resolvedState = state.setting === snapshot.setting && state.value === snapshot.value ? state : snapshot;
   return useIsomorphicLayoutEffect(function () {
-    if (typeof localStorage < "u") {
-      var stored = localStorage.getItem(storageKey);
-      stored && updateScheme(stored);
+    if (!_forceScheme) {
+      if (typeof localStorage < "u") {
+        var stored = localStorage.getItem(storageKey);
+        stored && updateScheme(stored);
+      }
+      startWebListener();
     }
     var dispose = onUserSchemeChange(function (setting, value) {
       setState({
@@ -76,14 +107,14 @@ function useUserScheme() {
         value
       });
     });
-    return startWebListener(), dispose;
+    return dispose;
   }, []), useMemo(function () {
     return {
-      setting: state.setting,
-      value: state.value,
+      setting: resolvedState.setting,
+      value: resolvedState.value,
       set: setUserScheme
     };
-  }, [state.setting, state.value]);
+  }, [resolvedState.setting, resolvedState.value]);
 }
-export { getUserScheme, onUserSchemeChange, setUserScheme, useUserScheme };
+export { getForceScheme, getUserScheme, onUserSchemeChange, setForceScheme, setUserScheme, useUserScheme };
 //# sourceMappingURL=userScheme.native.js.map

package/dist/esm/userScheme.native.js.map

@@ -1 +1 @@
-{"version":3,"names":["useIsomorphicLayoutEffect","useState","useMemo","Appearance","getSystemScheme","listeners","Set","storageKey","getInitialSetting","localStorage","stored","getItem","getInitialValue","setting","getColorScheme","initialSetting","currentSetting","currentValue","addChangeListener","next","colorScheme","updateValueFromSystem","isWebListening","startWebListener","_window_matchMedia","_window","_matcher_addEventListener","matcher","window","matchMedia","call","onSystemChange","addEventListener","resolveValue","value","forEach","l","updateScheme","setColorScheme","setUserScheme","setItem","getUserScheme","onUserSchemeChange","listener","add","delete","useUserScheme","state","setState"],"sources":["../../src/userScheme.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useIsomorphicLayoutEffect","useState","useMemo","Appearance","getSystemScheme","listeners","Set","storageKey","_forceScheme","notifyListeners","forEach","listener","currentSetting","currentValue","restoreUnforcedScheme","localStorage","stored","getItem","resolveValue","setForceScheme","scheme","wasForced","startWebListener","getForceScheme","getInitialSetting","getInitialValue","setting","getColorScheme","initialSetting","addChangeListener","next","colorScheme","updateValueFromSystem","isWebListening","_window_matchMedia","_window","_matcher_addEventListener","matcher","window","matchMedia","call","onSystemChange","addEventListener","value","updateScheme","setColorScheme","setUserScheme","setItem","getUserScheme","onUserSchemeChange","add","delete","useUserScheme","state","setState","snapshot","resolvedState"],"sources":["../../src/userScheme.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vxrn/color-scheme",
-  "version": "1.13.2",
+  "version": "1.13.4",
   "sideEffects": false,
   "exports": {
     "./package.json": "./package.json",
@@ -30,7 +30,7 @@
     "watch": "tamagui-build --watch"
   },
   "dependencies": {
-    "@vxrn/use-isomorphic-layout-effect": "1.13.2"
+    "@vxrn/use-isomorphic-layout-effect": "1.13.4"
   },
   "devDependencies": {
     "@tamagui/build": "2.0.0-rc.32",

package/src/index.tsx

@@ -1,6 +1,11 @@
 import { useIsomorphicLayoutEffect } from '@vxrn/use-isomorphic-layout-effect'
 import type { Scheme } from './systemScheme'
-import { setUserScheme, useUserScheme } from './userScheme'
+import {
+  getForceScheme,
+  setForceScheme,
+  setUserScheme,
+  useUserScheme,
+} from './userScheme'
 
 // re-export types
 export type { Scheme } from './systemScheme'
@@ -21,50 +26,60 @@ export function SchemeProvider({
   children,
   getClassName = (name) => `t_${name}`,
   defaultScheme,
+  forceScheme,
 }: {
   children: any
   getClassName?: (name: Scheme) => string
   /** Force a default scheme when no user preference is stored. Without this, falls back to system preference. */
   defaultScheme?: Scheme
+  /** Lock the scheme to this value. Ignores user preference, system preference, and localStorage. Prevents hydration flicker. */
+  forceScheme?: Scheme
 }) {
+  // set force before hooks so useState initializers return the forced value
+  setForceScheme(forceScheme ?? null)
+
   const { value } = useUserScheme()
+  const resolvedValue = forceScheme ?? value
 
   if (process.env.TAMAGUI_TARGET !== 'native') {
     // when defaultScheme is set and no stored preference, apply it on mount
     useIsomorphicLayoutEffect(() => {
-      if (defaultScheme && typeof localStorage !== 'undefined') {
+      if (!forceScheme && defaultScheme && typeof localStorage !== 'undefined') {
         if (!localStorage.getItem(storageKey)) {
           setUserScheme(defaultScheme)
         }
       }
-    }, [])
+    }, [defaultScheme, forceScheme])
 
     useIsomorphicLayoutEffect(() => {
-      const toAdd = getClassName(value)
-      const toRemove = getClassName(value === 'light' ? 'dark' : 'light')
+      const toAdd = getClassName(resolvedValue)
+      const toRemove = getClassName(resolvedValue === 'light' ? 'dark' : 'light')
       const { classList } = document.documentElement
       classList.remove(toRemove)
       if (!classList.contains(toAdd)) {
         classList.add(toAdd)
       }
-    }, [value])
+    }, [getClassName, resolvedValue])
   }
 
-  const fallback = defaultScheme
-    ? `'${defaultScheme}' === 'dark'`
-    : `window.matchMedia('(prefers-color-scheme: dark)').matches`
+  let scriptContent: string
+
+  if (forceScheme) {
+    // forced: just set the class, no localStorage interaction
+    scriptContent = `let d = document.documentElement.classList
+d.remove('${getClassName('light')}')
+d.remove('${getClassName('dark')}')
+d.add('${getClassName(forceScheme)}')`
+  } else {
+    const fallback = defaultScheme
+      ? `'${defaultScheme}' === 'dark'`
+      : `window.matchMedia('(prefers-color-scheme: dark)').matches`
 
-  const seedStorage = defaultScheme
-    ? `if(!e){localStorage.setItem('${storageKey}','${defaultScheme}')}`
-    : ''
+    const seedStorage = defaultScheme
+      ? `if(!e){localStorage.setItem('${storageKey}','${defaultScheme}')}`
+      : ''
 
-  return (
-    <>
-      {process.env.TAMAGUI_TARGET === 'native' ? null : (
-        <script
-          suppressHydrationWarning
-          dangerouslySetInnerHTML={{
-            __html: `let d = document.documentElement.classList
+    scriptContent = `let d = document.documentElement.classList
 d.remove('${getClassName('light')}')
 d.remove('${getClassName('dark')}')
 let e = localStorage.getItem('${storageKey}')
@@ -72,9 +87,15 @@ ${seedStorage}
 let t = 'system' === e || !e
   ? ${fallback}
   : e === 'dark'
-t ? d.add('${getClassName('dark')}') : d.add('${getClassName('light')}')
-`,
-          }}
+t ? d.add('${getClassName('dark')}') : d.add('${getClassName('light')}')`
+  }
+
+  return (
+    <>
+      {process.env.TAMAGUI_TARGET === 'native' ? null : (
+        <script
+          suppressHydrationWarning
+          dangerouslySetInnerHTML={{ __html: scriptContent }}
         />
       )}
       {children}
@@ -92,6 +113,14 @@ export function MetaTheme({
   lightColor: string
 }) {
   const { value } = useUserScheme()
+  const forced = getForceScheme()
+
+  const scriptContent = forced
+    ? `document.getElementById('vxrn-theme-color').setAttribute('content','${forced === 'dark' ? darkColor : lightColor}')`
+    : `let dc = document.getElementById('vxrn-theme-color')
+let e1 = localStorage.getItem('${storageKey}')
+let isD = 'system' === e1 || !e1 ? window.matchMedia('(prefers-color-scheme: dark)').matches : e1 === 'dark'
+dc.setAttribute('content', isD ? '${darkColor}' : '${lightColor}')`
 
   return (
     <>
@@ -104,14 +133,7 @@ export function MetaTheme({
       <script
         suppressHydrationWarning
         id="meta-theme-hydrate"
-        dangerouslySetInnerHTML={{
-          __html: `
-let dc = document.getElementById('vxrn-theme-color')
-let e1 = localStorage.getItem('${storageKey}')
-let isD = 'system' === e1 || !e1 ? window.matchMedia('(prefers-color-scheme: dark)').matches : e1 === 'dark'
-dc.setAttribute('content', isD ? '${darkColor}' : '${lightColor}')
-`,
-        }}
+        dangerouslySetInnerHTML={{ __html: scriptContent }}
       />
     </>
   )