powr-sdk-web 6.1.0 → 6.2.1

package/dist/theme/PowrThemeSettings.js

@@ -1,29 +1,39 @@
 "use strict";
 
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports["default"] = PowrThemeSettings;
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 var _PowrThemeProvider = require("./PowrThemeProvider");
 var _tokens = require("./tokens");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t2 in e) "default" !== _t2 && {}.hasOwnProperty.call(e, _t2) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t2)) && (i.get || i.set) ? o(f, _t2, i) : f[_t2] = e[_t2]); return f; })(e, t); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/**
- * User-level theme selectors: scheme · density · product preset.
- *
- * Reads and writes through `usePowrTheme()`, so it needs a `PowrThemeProvider`
- * above it. Legacy apps mount this inside their own Settings page; the
- * wrapper opens it in a drawer. Presets come from the product — this panel
- * never invents colours (no colour wheel).
- *
- * `onSave` is the hook for card 3 (host `/users/me/preferences`). Until then
- * changes are live + cached in localStorage by the provider.
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+/**
+ * User-level theme selectors: scheme · density · product preset.
+ *
+ * Reads and writes through `usePowrTheme()`, so it needs a `PowrThemeProvider`
+ * above it. Legacy apps mount this inside their own Settings page; the
+ * wrapper opens it in a drawer. Presets come from the product — this panel
+ * never invents colours (no colour wheel).
+ *
+ * `onSave` is the hook for card 3 (host `/users/me/preferences`). Until then
+ * changes are live + cached in localStorage by the provider.
  */
 
 var SCHEME_LABELS = {
@@ -159,15 +169,15 @@ function presetSwatches(preset, dark) {
   return [t.bg, t.surface, t.primary, t.text].filter(Boolean);
 }
 
-/**
- * @param {object} props
- * @param {string} [props.title="Appearance"]
- * @param {boolean} [props.showScheme=true]
- * @param {boolean} [props.showDensity=true]
- * @param {boolean} [props.showPresets=true] - Hidden automatically when the product passed no presets.
- * @param {(value: {scheme, density, preset}) => void|Promise<void>} [props.onSave] - Card 3: host save. Shows a Save button when given.
- * @param {boolean} [props.saving]
- * @param {string} [props.saveLabel="Save"]
+/**
+ * @param {object} props
+ * @param {string} [props.title="Appearance"]
+ * @param {boolean} [props.showScheme=true]
+ * @param {boolean} [props.showDensity=true]
+ * @param {boolean} [props.showPresets=true] - Hidden automatically when the product passed no presets.
+ * @param {(value: {scheme, density, preset}) => void|Promise<void>} [props.onSave] - Card 3: host save. Shows a Save button when given.
+ * @param {boolean} [props.saving]
+ * @param {string} [props.saveLabel="Save"]
  */
 function PowrThemeSettings(_ref2) {
   var _ref2$title = _ref2.title,
@@ -181,9 +191,46 @@ function PowrThemeSettings(_ref2) {
     onSave = _ref2.onSave,
     _ref2$saving = _ref2.saving,
     saving = _ref2$saving === void 0 ? false : _ref2$saving,
+    _ref2$error = _ref2.error,
+    error = _ref2$error === void 0 ? null : _ref2$error,
     _ref2$saveLabel = _ref2.saveLabel,
     saveLabel = _ref2$saveLabel === void 0 ? "Save" : _ref2$saveLabel;
   var t = (0, _PowrThemeProvider.usePowrTheme)();
+  var _useState = (0, _react.useState)(null),
+    _useState2 = _slicedToArray(_useState, 2),
+    savedAt = _useState2[0],
+    setSavedAt = _useState2[1];
+  var dirty = savedAt === null || savedAt.scheme !== t.scheme || savedAt.density !== t.density || savedAt.preset !== t.preset;
+  var handleSave = /*#__PURE__*/function () {
+    var _ref3 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+      var value, _t;
+      return _regenerator().w(function (_context) {
+        while (1) switch (_context.p = _context.n) {
+          case 0:
+            value = {
+              scheme: t.scheme,
+              density: t.density,
+              preset: t.preset
+            };
+            _context.p = 1;
+            _context.n = 2;
+            return onSave(value);
+          case 2:
+            setSavedAt(value);
+            _context.n = 4;
+            break;
+          case 3:
+            _context.p = 3;
+            _t = _context.v;
+          case 4:
+            return _context.a(2);
+        }
+      }, _callee, null, [[1, 3]]);
+    }));
+    return function handleSave() {
+      return _ref3.apply(this, arguments);
+    };
+  }();
   var presets = Array.isArray(t.presets) ? t.presets : [];
   var hasPresets = showPresets && presets.length > 0;
   var isDark = t.resolvedScheme === "dark";
@@ -256,13 +303,7 @@ function PowrThemeSettings(_ref2) {
   }, onSave ? /*#__PURE__*/_react["default"].createElement("button", {
     type: "button",
     disabled: saving,
-    onClick: function onClick() {
-      return onSave({
-        scheme: t.scheme,
-        density: t.density,
-        preset: t.preset
-      });
-    },
+    onClick: handleSave,
     style: _objectSpread(_objectSpread({}, styles.button(true)), {}, {
       opacity: saving ? 0.6 : 1
     })
@@ -270,7 +311,13 @@ function PowrThemeSettings(_ref2) {
     type: "button",
     onClick: t.reset,
     style: styles.button(false)
-  }, "Reset"), !onSave ? /*#__PURE__*/_react["default"].createElement("p", {
+  }, "Reset"), error ? /*#__PURE__*/_react["default"].createElement("p", {
+    style: _objectSpread(_objectSpread({}, styles.hint), {}, {
+      color: (0, _tokens.powrVar)("danger", "#dc2626")
+    })
+  }, error) : onSave ? /*#__PURE__*/_react["default"].createElement("p", {
+    style: styles.hint
+  }, dirty ? "Saves to your Powr account — follows you to other devices." : "Saved to your account.") : /*#__PURE__*/_react["default"].createElement("p", {
     style: styles.hint
-  }, "Saved on this device.") : null));
+  }, "Saved on this device.")));
 }

package/dist/theme/host.js

@@ -0,0 +1,280 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.fetchThemePreference = fetchThemePreference;
+exports.saveThemePreference = saveThemePreference;
+exports.usePowrThemeHost = usePowrThemeHost;
+var _react = require("react");
+var _auth = require("../utils/auth");
+var _PowrThemeProvider = require("./PowrThemeProvider");
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+/**
+ * Theme preference on the Powr host — `GET/PUT /users/me/preferences`.
+ *
+ * localStorage is the cache before first paint; the host is the truth once
+ * the user is logged in. Pull once per token, apply what the host has, and
+ * write on Save. Same thesis as login: host stores, SDK reads/writes,
+ * products omit `apiUrl`.
+ */
+
+var ENDPOINT = "/users/me/preferences";
+function fetchThemePreference() {
+  return _fetchThemePreference.apply(this, arguments);
+}
+function _fetchThemePreference() {
+  _fetchThemePreference = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+    var _data$data;
+    var _ref,
+      apiUrl,
+      projectId,
+      token,
+      headers,
+      _yield$apiCall,
+      data,
+      ok,
+      response,
+      err,
+      _args3 = arguments;
+    return _regenerator().w(function (_context3) {
+      while (1) switch (_context3.n) {
+        case 0:
+          _ref = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : {}, apiUrl = _ref.apiUrl, projectId = _ref.projectId, token = _ref.token;
+          headers = token ? {
+            Authorization: "Bearer ".concat(token)
+          } : undefined;
+          _context3.n = 1;
+          return (0, _auth.apiCall)(apiUrl, ENDPOINT, projectId, {
+            method: "GET",
+            headers: headers
+          });
+        case 1:
+          _yield$apiCall = _context3.v;
+          data = _yield$apiCall.data;
+          ok = _yield$apiCall.ok;
+          response = _yield$apiCall.response;
+          if (ok) {
+            _context3.n = 2;
+            break;
+          }
+          err = new Error((data === null || data === void 0 ? void 0 : data.message) || "Failed to load preferences (".concat(response.status, ")"));
+          err.status = response.status;
+          throw err;
+        case 2:
+          return _context3.a(2, (data === null || data === void 0 || (_data$data = data.data) === null || _data$data === void 0 ? void 0 : _data$data.theme) || null);
+      }
+    }, _callee3);
+  }));
+  return _fetchThemePreference.apply(this, arguments);
+}
+function saveThemePreference() {
+  return _saveThemePreference.apply(this, arguments);
+}
+/**
+ * Keep the mounted `PowrThemeProvider` in sync with the host for one user.
+ *
+ * @param {object} opts
+ * @param {string|null} [opts.token] - Powr JWT. No token → nothing happens (cache only).
+ * @param {string} [opts.apiUrl] - Leave unset; SDK default host.
+ * @param {string} [opts.projectId] - Defaults to NEXT_PUBLIC_PROJECT_ID.
+ * @param {boolean} [opts.enabled=true]
+ * @returns {{ loaded: boolean, saving: boolean, error: string|null, save: (theme?) => Promise<void>, refresh: () => Promise<void> }}
+ */
+function _saveThemePreference() {
+  _saveThemePreference = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
+    var _data$data2;
+    var _ref2,
+      apiUrl,
+      projectId,
+      token,
+      theme,
+      headers,
+      _yield$apiCall2,
+      data,
+      ok,
+      response,
+      err,
+      _args4 = arguments;
+    return _regenerator().w(function (_context4) {
+      while (1) switch (_context4.n) {
+        case 0:
+          _ref2 = _args4.length > 0 && _args4[0] !== undefined ? _args4[0] : {}, apiUrl = _ref2.apiUrl, projectId = _ref2.projectId, token = _ref2.token, theme = _ref2.theme;
+          headers = token ? {
+            Authorization: "Bearer ".concat(token)
+          } : undefined;
+          _context4.n = 1;
+          return (0, _auth.apiCall)(apiUrl, ENDPOINT, projectId, {
+            method: "PUT",
+            headers: headers,
+            body: {
+              theme: theme
+            }
+          });
+        case 1:
+          _yield$apiCall2 = _context4.v;
+          data = _yield$apiCall2.data;
+          ok = _yield$apiCall2.ok;
+          response = _yield$apiCall2.response;
+          if (ok) {
+            _context4.n = 2;
+            break;
+          }
+          err = new Error((data === null || data === void 0 ? void 0 : data.message) || "Failed to save preferences (".concat(response.status, ")"));
+          err.status = response.status;
+          throw err;
+        case 2:
+          return _context4.a(2, (data === null || data === void 0 || (_data$data2 = data.data) === null || _data$data2 === void 0 ? void 0 : _data$data2.theme) || null);
+      }
+    }, _callee4);
+  }));
+  return _saveThemePreference.apply(this, arguments);
+}
+function usePowrThemeHost() {
+  var _ref3 = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+    token = _ref3.token,
+    apiUrl = _ref3.apiUrl,
+    projectId = _ref3.projectId,
+    _ref3$enabled = _ref3.enabled,
+    enabled = _ref3$enabled === void 0 ? true : _ref3$enabled;
+  var t = (0, _PowrThemeProvider.usePowrTheme)();
+  var _useState = (0, _react.useState)(false),
+    _useState2 = _slicedToArray(_useState, 2),
+    loaded = _useState2[0],
+    setLoaded = _useState2[1];
+  var _useState3 = (0, _react.useState)(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    saving = _useState4[0],
+    setSaving = _useState4[1];
+  var _useState5 = (0, _react.useState)(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    error = _useState6[0],
+    setError = _useState6[1];
+  var lastToken = (0, _react.useRef)(null);
+  var themeRef = (0, _react.useRef)(t);
+  themeRef.current = t;
+  var apply = (0, _react.useCallback)(function (theme) {
+    if (!theme) return;
+    var cur = themeRef.current;
+    if (theme.scheme && theme.scheme !== cur.scheme) cur.setScheme(theme.scheme);
+    if (theme.density && theme.density !== cur.density) cur.setDensity(theme.density);
+    if (theme.preset !== undefined && theme.preset !== cur.preset) cur.setPreset(theme.preset);
+  }, []);
+  var refresh = (0, _react.useCallback)(/*#__PURE__*/_asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+    var theme, _t;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.p = _context.n) {
+        case 0:
+          if (token) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          _context.p = 1;
+          _context.n = 2;
+          return fetchThemePreference({
+            apiUrl: apiUrl,
+            projectId: projectId,
+            token: token
+          });
+        case 2:
+          theme = _context.v;
+          apply(theme);
+          setError(null);
+          _context.n = 4;
+          break;
+        case 3:
+          _context.p = 3;
+          _t = _context.v;
+          setError(_t.message);
+        case 4:
+          _context.p = 4;
+          setLoaded(true);
+          return _context.f(4);
+        case 5:
+          return _context.a(2);
+      }
+    }, _callee, null, [[1, 3, 4, 5]]);
+  })), [token, apiUrl, projectId, apply]);
+
+  // Pull once per token (login / refresh). Logout resets so the next user pulls again.
+  (0, _react.useEffect)(function () {
+    if (!enabled || !t.mounted) return;
+    if (!token) {
+      lastToken.current = null;
+      setLoaded(false);
+      return;
+    }
+    if (lastToken.current === token) return;
+    lastToken.current = token;
+    refresh();
+  }, [enabled, token, t.mounted, refresh]);
+  var save = (0, _react.useCallback)(/*#__PURE__*/function () {
+    var _ref5 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(theme) {
+      var cur, body, saved, _t2;
+      return _regenerator().w(function (_context2) {
+        while (1) switch (_context2.p = _context2.n) {
+          case 0:
+            if (token) {
+              _context2.n = 1;
+              break;
+            }
+            return _context2.a(2);
+          case 1:
+            cur = themeRef.current;
+            body = theme || {
+              scheme: cur.scheme,
+              density: cur.density,
+              preset: cur.preset
+            };
+            setSaving(true);
+            _context2.p = 2;
+            _context2.n = 3;
+            return saveThemePreference({
+              apiUrl: apiUrl,
+              projectId: projectId,
+              token: token,
+              theme: body
+            });
+          case 3:
+            saved = _context2.v;
+            apply(saved);
+            setError(null);
+            _context2.n = 5;
+            break;
+          case 4:
+            _context2.p = 4;
+            _t2 = _context2.v;
+            setError(_t2.message);
+            throw _t2;
+          case 5:
+            _context2.p = 5;
+            setSaving(false);
+            return _context2.f(5);
+          case 6:
+            return _context2.a(2);
+        }
+      }, _callee2, null, [[2, 4, 5, 6]]);
+    }));
+    return function (_x) {
+      return _ref5.apply(this, arguments);
+    };
+  }(), [token, apiUrl, projectId, apply]);
+  return {
+    loaded: loaded,
+    saving: saving,
+    error: error,
+    save: save,
+    refresh: refresh
+  };
+}

package/dist/theme/index.js

@@ -70,6 +70,12 @@ Object.defineProperty(exports, "PowrThemeSettings", {
     return _PowrThemeSettings["default"];
   }
 });
+Object.defineProperty(exports, "fetchThemePreference", {
+  enumerable: true,
+  get: function get() {
+    return _host.fetchThemePreference;
+  }
+});
 Object.defineProperty(exports, "findPreset", {
   enumerable: true,
   get: function get() {
@@ -88,6 +94,12 @@ Object.defineProperty(exports, "normalizeScheme", {
     return _tokens.normalizeScheme;
   }
 });
+Object.defineProperty(exports, "powrThemeInitScript", {
+  enumerable: true,
+  get: function get() {
+    return _initScript.powrThemeInitScript;
+  }
+});
 Object.defineProperty(exports, "powrThemeStorageKey", {
   enumerable: true,
   get: function get() {
@@ -106,6 +118,12 @@ Object.defineProperty(exports, "resolvePowrTokens", {
     return _tokens.resolvePowrTokens;
   }
 });
+Object.defineProperty(exports, "saveThemePreference", {
+  enumerable: true,
+  get: function get() {
+    return _host.saveThemePreference;
+  }
+});
 Object.defineProperty(exports, "themeForScheme", {
   enumerable: true,
   get: function get() {
@@ -124,8 +142,16 @@ Object.defineProperty(exports, "usePowrTheme", {
     return _PowrThemeProvider.usePowrTheme;
   }
 });
+Object.defineProperty(exports, "usePowrThemeHost", {
+  enumerable: true,
+  get: function get() {
+    return _host.usePowrThemeHost;
+  }
+});
 var _PowrThemeProvider = _interopRequireWildcard(require("./PowrThemeProvider"));
 var _PowrThemeSettings = _interopRequireDefault(require("./PowrThemeSettings"));
+var _host = require("./host");
+var _initScript = require("./initScript");
 var _tokens = require("./tokens");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }

package/dist/theme/initScript.js

@@ -0,0 +1,86 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+exports.powrThemeInitScript = powrThemeInitScript;
+var _tokens = require("./tokens");
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _toConsumableArray(r) { return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
+function _arrayWithoutHoles(r) { if (Array.isArray(r)) return _arrayLikeToArray(r); }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+/**
+ * No-flash head script.
+ *
+ * `PowrThemeProvider` applies vars in an effect, so a cached dark user sees one
+ * light frame on hard reload. This returns a tiny inline script that reads the
+ * same localStorage cache and paints `<html>` before React runs.
+ *
+ * No logic is duplicated: the css-var table for every scheme × preset × density
+ * is precomputed here with `resolvePowrTokens` and embedded. The script only
+ * looks up.
+ *
+ * Next (app router) root layout:
+ *   <head><script dangerouslySetInnerHTML={{ __html: powrThemeInitScript({ projectId, theme, presets }) }} /></head>
+ *
+ * @param {object} opts - The same `theme` / `presets` / `projectId` you give the provider.
+ * @returns {string} JavaScript source.
+ */
+function powrThemeInitScript() {
+  var _ref = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {},
+    projectId = _ref.projectId,
+    theme = _ref.theme,
+    _ref$presets = _ref.presets,
+    presets = _ref$presets === void 0 ? [] : _ref$presets,
+    _ref$scheme = _ref.scheme,
+    scheme = _ref$scheme === void 0 ? _tokens.DEFAULT_POWR_SCHEME : _ref$scheme,
+    _ref$density = _ref.density,
+    density = _ref$density === void 0 ? _tokens.DEFAULT_POWR_DENSITY : _ref$density,
+    _ref$preset = _ref.preset,
+    preset = _ref$preset === void 0 ? null : _ref$preset;
+  var table = {};
+  var presetIds = [null].concat(_toConsumableArray(presets.map(function (p) {
+    return p.id;
+  })));
+  for (var _i = 0, _arr = ["light", "dark"]; _i < _arr.length; _i++) {
+    var s = _arr[_i];
+    var _iterator = _createForOfIteratorHelper(presetIds),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var p = _step.value;
+        for (var _i2 = 0, _Object$keys = Object.keys(_tokens.POWR_DENSITIES); _i2 < _Object$keys.length; _i2++) {
+          var d = _Object$keys[_i2];
+          var r = (0, _tokens.resolvePowrTokens)({
+            scheme: s,
+            density: d,
+            theme: theme,
+            preset: p,
+            presets: presets
+          });
+          table["".concat(s, "|").concat(p || "", "|").concat(d)] = (0, _tokens.tokensToCssVars)(r.tokens, r.densityScale);
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  }
+  var payload = {
+    key: (0, _tokens.powrThemeStorageKey)(projectId),
+    defaults: {
+      scheme: scheme,
+      density: density,
+      preset: preset
+    },
+    presets: presetIds.filter(Boolean),
+    table: table
+  };
+  return "(function(){try{" + "var P=".concat(JSON.stringify(payload), ";") + "var c=null;try{c=JSON.parse(localStorage.getItem(P.key)||'null')}catch(e){}" + "var s=(c&&c.scheme)||P.defaults.scheme,d=(c&&c.density)||P.defaults.density,p=c&&c.preset!==undefined?c.preset:P.defaults.preset;" + "if(s!=='light'&&s!=='dark'&&s!=='system')s='light';" + "if(d!=='comfortable'&&d!=='compact')d='comfortable';" + "if(p&&P.presets.indexOf(p)<0)p=null;" + "var rs=s==='system'?(window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light'):s;" + "var v=P.table[rs+'|'+(p||'')+'|'+d];if(!v)return;" + "var el=document.documentElement;for(var k in v)el.style.setProperty(k,v[k]);" + "el.setAttribute('data-powr-scheme',rs);el.setAttribute('data-powr-density',d);" + "if(p)el.setAttribute('data-powr-preset',p);el.style.colorScheme=rs;" + "}catch(e){}})();";
+}
+var _default = exports["default"] = powrThemeInitScript;