@multiplatform.one/platform 6.7.0 → 7.1.0

package/README.md

@@ -13,7 +13,7 @@ pnpm add @multiplatform.one/platform
 ## What it owns
 
 - **Detection flags** — `isWeb`, `isNative`, `isIos`, `isAndroid`, `isServer`,
-  `isClient`, `isTauri`, `isDesktop`, `isExpo`, `isNext`, `isStorybook`,
+  `isClient`, `isGnome`, `isTauri`, `isDesktop`, `isExpo`, `isNext`, `isStorybook`,
   `isChrome`, `isFirefox`, `isWebExtension`, `isChromeExtension`,
   `isFirefoxExtension`, `isIframe`, `isTouchable`, `isWebTouchable`,
   `isWindowDefined`, … plus the full `platform` object (`platform.preciseName`)
@@ -29,12 +29,16 @@ pnpm add @multiplatform.one/platform
 ## Usage
 
 ```tsx
-import { isNative, isServer, isTauri } from "@multiplatform.one/platform";
+import { isGnome, isNative, isServer, isTauri } from "@multiplatform.one/platform";
 
 export function saveFile(contents: string) {
   if (isServer) return;
   if (isTauri) {
-    // desktop path (see @multiplatform.one/desktop)
+    // webview desktop path (see @multiplatform.one/desktop)
+    return;
+  }
+  if (isGnome) {
+    // GTK desktop path (see @multiplatform.one/desktop)
     return;
   }
   if (isNative) {

package/dist/cjs/config/config.cjs

@@ -25,13 +25,14 @@ __export(config_exports, {
   Config: () => Config
 });
 module.exports = __toCommonJS(config_exports);
-const import_meta = {};
+var import_runtimeConfig = require("./runtimeConfig.cjs");
 class Config {
   _config = {};
   _blacklist = /* @__PURE__ */new Set([]);
   _lookupEnv(key) {
     if (this._blacklist.has(key)) return void 0;
-    return process?.env?.[key];
+    if (typeof process === "undefined") return void 0;
+    return process.env?.[key];
   }
   _resolveConfig() {
     return Object.keys(this._config).reduce((config, key) => {
@@ -47,13 +48,18 @@ class Config {
     }, {});
   }
   constructor(config = {}) {
-    let viteConfig = {};
-    try {
-      const raw = typeof import_meta !== "undefined" && import_meta.env?.VITE_MP_CONFIG;
-      viteConfig = JSON.parse(raw || "{}");
-    } catch {}
     this._config = {
-      ...this._reduceConfig(typeof viteConfig === "object" ? viteConfig : {}),
+      // 1. BUILD time: public config baked into the bundle via VITE_MP_CONFIG.
+      //    Kept first (and kept working) so apps that bake their config in —
+      //    native, GNOME, static web — are unchanged.
+      ...this._reduceConfig((0, import_runtimeConfig.bakedPublicConfig)()),
+      // 2. RUNTIME: the public payload the SSR document published into the
+      //    browser (see runtimeConfig.ts). Wins over the bake so a redeployed
+      //    container overrides a stale build-time value, and so an image built
+      //    with an EMPTY build environment can still be configured per
+      //    deployment. `process.env` is not reachable here.
+      ...this._reduceConfig((0, import_runtimeConfig.readRuntimePublicConfig)()),
+      // 3. Explicit values handed to the constructor always win.
       ...this._reduceConfig(config)
     };
   }

package/dist/cjs/config/index.cjs

@@ -28,4 +28,5 @@ __export(config_exports, {
 module.exports = __toCommonJS(config_exports);
 var import_config = require("./config.cjs");
 __reExport(config_exports, require("./config.cjs"), module.exports);
+__reExport(config_exports, require("./runtimeConfig.cjs"), module.exports);
 const config = new import_config.Config();

package/dist/cjs/config/runtimeConfig.cjs

@@ -0,0 +1,100 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var runtimeConfig_exports = {};
+__export(runtimeConfig_exports, {
+  bakedConfigEnvKey: () => bakedConfigEnvKey,
+  bakedPublicConfig: () => bakedPublicConfig,
+  publicConfigKeys: () => publicConfigKeys,
+  publicConfigKeysEnvKey: () => publicConfigKeysEnvKey,
+  readRuntimePublicConfig: () => readRuntimePublicConfig,
+  resolvePublicConfig: () => resolvePublicConfig,
+  runtimePublicConfigKey: () => runtimePublicConfigKey,
+  serializeRuntimePublicConfig: () => serializeRuntimePublicConfig
+});
+module.exports = __toCommonJS(runtimeConfig_exports);
+const import_meta = {};
+const runtimePublicConfigKey = "__mp_public_config__";
+const publicConfigKeysEnvKey = "VITE_MP_PUBLIC_CONFIG_KEYS";
+const bakedConfigEnvKey = "VITE_MP_CONFIG";
+function importMetaEnv() {
+  try {
+    if (typeof import_meta === "undefined") return {};
+    return import_meta.env || {};
+  } catch {
+    return {};
+  }
+}
+function processEnv() {
+  try {
+    if (typeof process === "undefined") return {};
+    return process.env || {};
+  } catch {
+    return {};
+  }
+}
+function readBuildEnv(key) {
+  return importMetaEnv()[key] ?? processEnv()[key];
+}
+function parseJson(raw) {
+  if (!raw) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+}
+function stringifyValues(source) {
+  return Object.entries(source).reduce((acc, [key, value]) => {
+    if (typeof value !== "undefined" && value !== null) acc[key] = String(value);
+    return acc;
+  }, {});
+}
+function publicConfigKeys() {
+  const parsed = parseJson(readBuildEnv(publicConfigKeysEnvKey));
+  if (!Array.isArray(parsed)) return [];
+  return parsed.filter(key => typeof key === "string" && key.length > 0);
+}
+function bakedPublicConfig() {
+  const parsed = parseJson(readBuildEnv(bakedConfigEnvKey));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+  return stringifyValues(parsed);
+}
+function resolvePublicConfig(env = processEnv()) {
+  const baked = bakedPublicConfig();
+  return publicConfigKeys().reduce((acc, key) => {
+    const value = env[key] ?? baked[key];
+    if (typeof value === "string" && value.length > 0) acc[key] = value;
+    return acc;
+  }, {});
+}
+function readRuntimePublicConfig() {
+  const raw = globalThis[runtimePublicConfigKey];
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  return stringifyValues(raw);
+}
+function safeJsonStringify(value) {
+  return JSON.stringify(value ?? {}).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function serializeRuntimePublicConfig(config = resolvePublicConfig()) {
+  return `globalThis[${JSON.stringify(runtimePublicConfigKey)}]=${safeJsonStringify(config)};`;
+}

package/dist/cjs/index.cjs

@@ -32,6 +32,7 @@ __export(index_exports, {
   isExpo: () => isExpo,
   isFirefox: () => isFirefox,
   isFirefoxExtension: () => isFirefoxExtension,
+  isGnome: () => isGnome,
   isIframe: () => isIframe,
   isIos: () => isIos,
   isNative: () => isNative,
@@ -65,6 +66,7 @@ const {
   isExpo,
   isFirefox,
   isFirefoxExtension,
+  isGnome,
   isIframe,
   isIos,
   isNative,

package/dist/cjs/platform/index.gnome.cjs

@@ -0,0 +1,59 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var index_gnome_exports = {};
+__export(index_gnome_exports, {
+  platform: () => platform
+});
+module.exports = __toCommonJS(index_gnome_exports);
+var import_platformBase = require("./platformBase.cjs");
+const platform = {
+  ...import_platformBase.platformBase,
+  isGnome: true,
+  // GTK is a desktop, and it is not a browser — so `isNative` too, which is
+  // exactly why Gnome sits ahead of Native in the precision order.
+  isDesktop: true,
+  isNative: true,
+  isClient: true,
+  isServer: false,
+  isWeb: false,
+  isBrowser: false,
+  isChrome: false,
+  isFirefox: false,
+  isIframe: false,
+  isStorybook: false,
+  isWebExtension: false,
+  isChromeExtension: false,
+  isFirefoxExtension: false,
+  isExpo: false,
+  isNext: false,
+  // A GTK pointer desktop. Touch exists on some hardware but is not the
+  // interaction model the layout should assume.
+  isTouchable: false,
+  isWebTouchable: false,
+  // There is a `window` under the react-gnome polyfills, but it is a stub
+  // with no layout, no events and no document. Callers branching on this are
+  // asking "can I touch the DOM", and the answer is no.
+  isWindowDefined: false
+};
+platform.preciseName = (0, import_platformBase.getPreciseName)(platform);
+platform.broadName = (0, import_platformBase.getBroadName)(platform);

package/dist/cjs/platform/platformBase.cjs

@@ -28,7 +28,13 @@ __export(platformBase_exports, {
 });
 module.exports = __toCommonJS(platformBase_exports);
 var import_constants = require("@tamagui/constants");
-const platformOrder = ["Ios", "Android", "Native", "Tauri", "Desktop", "ChromeExtension", "FirefoxExtension", "WebExtension", "Next", "Expo", "Chrome", "Firefox", "Web", "Browser", "Client", "Server", "Iframe", "Storybook"];
+const platformOrder = ["Ios", "Android",
+// Gnome outranks Native: the GTK target reports isNative (it is not a
+// browser) but "gnome" is the precise answer callers want.
+"Gnome", "Native",
+// Tauri outranks Desktop/Web the same way: the webview host reports isWeb
+// and isDesktop, but "tauri" is the precise answer.
+"Tauri", "Desktop", "ChromeExtension", "FirefoxExtension", "WebExtension", "Next", "Expo", "Chrome", "Firefox", "Web", "Browser", "Client", "Server", "Iframe", "Storybook"];
 const platformBase = {
   isAndroid: false,
   isBrowser: false,
@@ -39,6 +45,7 @@ const platformBase = {
   isExpo: false,
   isFirefox: false,
   isFirefoxExtension: false,
+  isGnome: false,
   isIframe: false,
   isIos: false,
   isNative: false,

package/dist/esm/config/config.mjs

@@ -1,9 +1,11 @@
+import { bakedPublicConfig, readRuntimePublicConfig } from "./runtimeConfig.mjs";
 class Config {
   _config = {};
   _blacklist = /* @__PURE__ */new Set([]);
   _lookupEnv(key) {
     if (this._blacklist.has(key)) return void 0;
-    return process?.env?.[key];
+    if (typeof process === "undefined") return void 0;
+    return process.env?.[key];
   }
   _resolveConfig() {
     return Object.keys(this._config).reduce((config, key) => {
@@ -19,13 +21,18 @@ class Config {
     }, {});
   }
   constructor(config = {}) {
-    let viteConfig = {};
-    try {
-      const raw = typeof import.meta !== "undefined" && import.meta.env?.VITE_MP_CONFIG;
-      viteConfig = JSON.parse(raw || "{}");
-    } catch {}
     this._config = {
-      ...this._reduceConfig(typeof viteConfig === "object" ? viteConfig : {}),
+      // 1. BUILD time: public config baked into the bundle via VITE_MP_CONFIG.
+      //    Kept first (and kept working) so apps that bake their config in —
+      //    native, GNOME, static web — are unchanged.
+      ...this._reduceConfig(bakedPublicConfig()),
+      // 2. RUNTIME: the public payload the SSR document published into the
+      //    browser (see runtimeConfig.ts). Wins over the bake so a redeployed
+      //    container overrides a stale build-time value, and so an image built
+      //    with an EMPTY build environment can still be configured per
+      //    deployment. `process.env` is not reachable here.
+      ...this._reduceConfig(readRuntimePublicConfig()),
+      // 3. Explicit values handed to the constructor always win.
       ...this._reduceConfig(config)
     };
   }

package/dist/esm/config/config.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["Config","_config","_blacklist","Set","_lookupEnv","key","has","process","env","_resolveConfig","Object","keys","reduce","config","value","_reduceConfig","entries","toString","constructor","viteConfig","raw","import","meta","VITE_MP_CONFIG","JSON","parse","get","defaultValue","set","add","remove"],"sources":["../../../src/config/config.ts"],"sourcesContent":[null],"mappings":"AAEO,MAAMA,MAAA,CAA0B;EAC7BC,OAAA,GAAkC,CAAC;EAEnCC,UAAA,GAA0B,mBAAIC,GAAA,CAAI,EAAE;EAEpCC,WAAWC,GAAA,EAAiC;IAClD,IAAI,KAAKH,UAAA,CAAWI,GAAA,CAAID,GAAG,GAAG,OAAO;IACrC,OAAOE,OAAA,EAASC,GAAA,GAAMH,GAAG;EAC3B;EAEQI,eAAA,EAAiB;IACvB,OAAOC,MAAA,CAAOC,IAAA,CAAK,KAAKV,OAAO,EAAEW,MAAA,CAA+B,CAACC,MAAA,EAAQR,GAAA,KAAQ;MAC/E,MAAMS,KAAA,GAAQ,KAAKV,UAAA,CAAWC,GAAG,KAAK,KAAKJ,OAAA,CAAQI,GAAG;MACtD,IAAI,OAAOS,KAAA,KAAU,aAAaD,MAAA,CAAOR,GAAG,IAAIS,KAAA;MAChD,OAAOD,MAAA;IACT,GAAG,CAAC,CAAC;EACP;EAEQE,cAAcF,MAAA,GAA6C,CAAC,GAAG;IACrE,OAAOH,MAAA,CAAOM,OAAA,CAAQH,MAAM,EAAED,MAAA,CAC5B,CAACC,OAAA,EAAQ,CAACR,GAAA,EAAKS,KAAK,MAAoC;MACtD,IAAI,OAAOA,KAAA,KAAU,aAAaD,OAAA,CAAOR,GAAG,IAAIS,KAAA,CAAMG,QAAA,CAAS;MAC/D,OAAOJ,OAAA;IACT,GACA,CAAC,CACH;EACF;EAEAK,YAAYL,MAAA,GAA6C,CAAC,GAAG;IAC3D,IAAIM,UAAA,GAAiD,CAAC;IACtD,IAAI;MAEF,MAAMC,GAAA,GAAM,OAAOC,MAAA,CAAAC,IAAA,KAAgB,eAAeD,MAAA,CAAAC,IAAA,CAAYd,GAAA,EAAKe,cAAA;MACnEJ,UAAA,GAAaK,IAAA,CAAKC,KAAA,CAAML,GAAA,IAAO,IAAI;IACrC,QAAQ,CAAC;IACT,KAAKnB,OAAA,GAAU;MACb,GAAG,KAAKc,aAAA,CAAc,OAAOI,UAAA,KAAe,WAAWA,UAAA,GAAa,CAAC,CAAC;MACtE,GAAG,KAAKJ,aAAA,CAAcF,MAAM;IAC9B;EACF;EAKAa,IAAIrB,GAAA,EAAcsB,YAAA,EAAoE;IACpF,MAAMd,MAAA,GAAS,KAAKJ,cAAA,CAAe;IACnC,IAAI,CAACJ,GAAA,EAAK,OAAOQ,MAAA;IACjB,OAAOA,MAAA,CAAOR,GAAG,KAAKsB,YAAA;EACxB;EAEAC,IAAIvB,GAAA,EAAaS,KAAA,EAAe;IAC9B,KAAKb,OAAA,CAAQI,GAAG,IAAIS,KAAA;IACpB,OAAOA,KAAA;EACT;EAEAe,IAAIf,KAAA,EAA+B;IACjC,KAAKb,OAAA,GAAU;MACb,GAAG,KAAKA,OAAA;MACR,GAAGa;IACL;IACA,OAAO,KAAKY,GAAA,CAAI;EAClB;EAEAI,OAAOzB,GAAA,EAAiC;IACtC,MAAMS,KAAA,GAAQ,KAAKY,GAAA,CAAIrB,GAAG;IAC1B,OAAO,KAAKJ,OAAA,CAAQI,GAAG;IACvB,OAAOS,KAAA;EACT;AACF","ignoreList":[]}
+{"version":3,"names":["bakedPublicConfig","readRuntimePublicConfig","Config","_config","_blacklist","Set","_lookupEnv","key","has","process","env","_resolveConfig","Object","keys","reduce","config","value","_reduceConfig","entries","toString","constructor","get","defaultValue","set","add","remove"],"sources":["../../../src/config/config.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,iBAAA,EAAmBC,uBAAA,QAA+B;AAGpD,MAAMC,MAAA,CAA0B;EAC7BC,OAAA,GAAkC,CAAC;EAEnCC,UAAA,GAA0B,mBAAIC,GAAA,CAAI,EAAE;EAEpCC,WAAWC,GAAA,EAAiC;IAClD,IAAI,KAAKH,UAAA,CAAWI,GAAA,CAAID,GAAG,GAAG,OAAO;IAIrC,IAAI,OAAOE,OAAA,KAAY,aAAa,OAAO;IAC3C,OAAOA,OAAA,CAAQC,GAAA,GAAMH,GAAG;EAC1B;EAEQI,eAAA,EAAiB;IACvB,OAAOC,MAAA,CAAOC,IAAA,CAAK,KAAKV,OAAO,EAAEW,MAAA,CAA+B,CAACC,MAAA,EAAQR,GAAA,KAAQ;MAC/E,MAAMS,KAAA,GAAQ,KAAKV,UAAA,CAAWC,GAAG,KAAK,KAAKJ,OAAA,CAAQI,GAAG;MACtD,IAAI,OAAOS,KAAA,KAAU,aAAaD,MAAA,CAAOR,GAAG,IAAIS,KAAA;MAChD,OAAOD,MAAA;IACT,GAAG,CAAC,CAAC;EACP;EAEQE,cAAcF,MAAA,GAA6C,CAAC,GAAG;IACrE,OAAOH,MAAA,CAAOM,OAAA,CAAQH,MAAM,EAAED,MAAA,CAC5B,CAACC,OAAA,EAAQ,CAACR,GAAA,EAAKS,KAAK,MAAoC;MACtD,IAAI,OAAOA,KAAA,KAAU,aAAaD,OAAA,CAAOR,GAAG,IAAIS,KAAA,CAAMG,QAAA,CAAS;MAC/D,OAAOJ,OAAA;IACT,GACA,CAAC,CACH;EACF;EAEAK,YAAYL,MAAA,GAA6C,CAAC,GAAG;IAC3D,KAAKZ,OAAA,GAAU;MAAA;MAAA;MAAA;MAIb,GAAG,KAAKc,aAAA,CAAcjB,iBAAA,CAAkB,CAAC;MAAA;MAAA;MAAA;MAAA;MAAA;MAMzC,GAAG,KAAKiB,aAAA,CAAchB,uBAAA,CAAwB,CAAC;MAAA;MAE/C,GAAG,KAAKgB,aAAA,CAAcF,MAAM;IAC9B;EACF;EAKAM,IAAId,GAAA,EAAce,YAAA,EAAoE;IACpF,MAAMP,MAAA,GAAS,KAAKJ,cAAA,CAAe;IACnC,IAAI,CAACJ,GAAA,EAAK,OAAOQ,MAAA;IACjB,OAAOA,MAAA,CAAOR,GAAG,KAAKe,YAAA;EACxB;EAEAC,IAAIhB,GAAA,EAAaS,KAAA,EAAe;IAC9B,KAAKb,OAAA,CAAQI,GAAG,IAAIS,KAAA;IACpB,OAAOA,KAAA;EACT;EAEAQ,IAAIR,KAAA,EAA+B;IACjC,KAAKb,OAAA,GAAU;MACb,GAAG,KAAKA,OAAA;MACR,GAAGa;IACL;IACA,OAAO,KAAKK,GAAA,CAAI;EAClB;EAEAI,OAAOlB,GAAA,EAAiC;IACtC,MAAMS,KAAA,GAAQ,KAAKK,GAAA,CAAId,GAAG;IAC1B,OAAO,KAAKJ,OAAA,CAAQI,GAAG;IACvB,OAAOS,KAAA;EACT;AACF","ignoreList":[]}

package/dist/esm/config/index.mjs

@@ -1,5 +1,6 @@
 import { Config } from "./config.mjs";
 export * from "./config.mjs";
+export * from "./runtimeConfig.mjs";
 const config = new Config();
 export { config };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/config/index.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["Config","config"],"sources":["../../../src/config/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAA,QAAc;AAKvB,cAAc;AAHd,MAAMC,MAAA,GAAS,IAAID,MAAA,CAAO","ignoreList":[]}
+{"version":3,"names":["Config","config"],"sources":["../../../src/config/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,MAAA,QAAc;AAKvB,cAAc;AACd,cAAc;AAJd,MAAMC,MAAA,GAAS,IAAID,MAAA,CAAO","ignoreList":[]}

package/dist/esm/config/runtimeConfig.mjs

@@ -0,0 +1,67 @@
+const runtimePublicConfigKey = "__mp_public_config__";
+const publicConfigKeysEnvKey = "VITE_MP_PUBLIC_CONFIG_KEYS";
+const bakedConfigEnvKey = "VITE_MP_CONFIG";
+function importMetaEnv() {
+  try {
+    if (typeof import.meta === "undefined") return {};
+    return import.meta.env || {};
+  } catch {
+    return {};
+  }
+}
+function processEnv() {
+  try {
+    if (typeof process === "undefined") return {};
+    return process.env || {};
+  } catch {
+    return {};
+  }
+}
+function readBuildEnv(key) {
+  return importMetaEnv()[key] ?? processEnv()[key];
+}
+function parseJson(raw) {
+  if (!raw) return void 0;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return void 0;
+  }
+}
+function stringifyValues(source) {
+  return Object.entries(source).reduce((acc, [key, value]) => {
+    if (typeof value !== "undefined" && value !== null) acc[key] = String(value);
+    return acc;
+  }, {});
+}
+function publicConfigKeys() {
+  const parsed = parseJson(readBuildEnv(publicConfigKeysEnvKey));
+  if (!Array.isArray(parsed)) return [];
+  return parsed.filter(key => typeof key === "string" && key.length > 0);
+}
+function bakedPublicConfig() {
+  const parsed = parseJson(readBuildEnv(bakedConfigEnvKey));
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
+  return stringifyValues(parsed);
+}
+function resolvePublicConfig(env = processEnv()) {
+  const baked = bakedPublicConfig();
+  return publicConfigKeys().reduce((acc, key) => {
+    const value = env[key] ?? baked[key];
+    if (typeof value === "string" && value.length > 0) acc[key] = value;
+    return acc;
+  }, {});
+}
+function readRuntimePublicConfig() {
+  const raw = globalThis[runtimePublicConfigKey];
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  return stringifyValues(raw);
+}
+function safeJsonStringify(value) {
+  return JSON.stringify(value ?? {}).replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function serializeRuntimePublicConfig(config = resolvePublicConfig()) {
+  return `globalThis[${JSON.stringify(runtimePublicConfigKey)}]=${safeJsonStringify(config)};`;
+}
+export { bakedConfigEnvKey, bakedPublicConfig, publicConfigKeys, publicConfigKeysEnvKey, readRuntimePublicConfig, resolvePublicConfig, runtimePublicConfigKey, serializeRuntimePublicConfig };
+//# sourceMappingURL=runtimeConfig.mjs.map

package/dist/esm/config/runtimeConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["runtimePublicConfigKey","publicConfigKeysEnvKey","bakedConfigEnvKey","importMetaEnv","import","meta","env","processEnv","process","readBuildEnv","key","parseJson","raw","JSON","parse","stringifyValues","source","Object","entries","reduce","acc","value","String","publicConfigKeys","parsed","Array","isArray","filter","length","bakedPublicConfig","resolvePublicConfig","baked","readRuntimePublicConfig","globalThis","safeJsonStringify","stringify","replace","serializeRuntimePublicConfig","config"],"sources":["../../../src/config/runtimeConfig.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/index.mjs

@@ -17,6 +17,7 @@ const {
   isExpo,
   isFirefox,
   isFirefoxExtension,
+  isGnome,
   isIframe,
   isIos,
   isNative,
@@ -31,5 +32,5 @@ const {
   isWebTouchable,
   isWindowDefined
 } = platform;
-export { isAndroid, isBrowser, isChrome, isChromeExtension, isClient, isDesktop, isExpo, isFirefox, isFirefoxExtension, isIframe, isIos, isNative, isNext, isServer, isStorybook, isTauri, isTouchable, isWeb, isWebExtension, isWebTouchable, isWindowDefined };
+export { isAndroid, isBrowser, isChrome, isChromeExtension, isClient, isDesktop, isExpo, isFirefox, isFirefoxExtension, isGnome, isIframe, isIos, isNative, isNext, isServer, isStorybook, isTauri, isTouchable, isWeb, isWebExtension, isWebTouchable, isWindowDefined };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["platform","isAndroid","isBrowser","isChrome","isChromeExtension","isClient","isExpo","isFirefox","isFirefoxExtension","isIframe","isIos","isNative","isNext","isServer","isStorybook","isTauri","isDesktop","isTouchable","isWeb","isWebExtension","isWebTouchable","isWindowDefined"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAgB;AA0BzB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAhCP,MAAM;EACXC,SAAA;EACAC,SAAA;EACAC,QAAA;EACAC,iBAAA;EACAC,QAAA;EACAC,MAAA;EACAC,SAAA;EACAC,kBAAA;EACAC,QAAA;EACAC,KAAA;EACAC,QAAA;EACAC,MAAA;EACAC,QAAA;EACAC,WAAA;EACAC,OAAA;EACAC,SAAA;EACAC,WAAA;EACAC,KAAA;EACAC,cAAA;EACAC,cAAA;EACAC;AACF,IAAIrB,QAAA","ignoreList":[]}
+{"version":3,"names":["platform","isAndroid","isBrowser","isChrome","isChromeExtension","isClient","isExpo","isFirefox","isFirefoxExtension","isGnome","isIframe","isIos","isNative","isNext","isServer","isStorybook","isTauri","isDesktop","isTouchable","isWeb","isWebExtension","isWebTouchable","isWindowDefined"],"sources":["../../src/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,QAAgB;AA2BzB,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAjCP,MAAM;EACXC,SAAA;EACAC,SAAA;EACAC,QAAA;EACAC,iBAAA;EACAC,QAAA;EACAC,MAAA;EACAC,SAAA;EACAC,kBAAA;EACAC,OAAA;EACAC,QAAA;EACAC,KAAA;EACAC,QAAA;EACAC,MAAA;EACAC,QAAA;EACAC,WAAA;EACAC,OAAA;EACAC,SAAA;EACAC,WAAA;EACAC,KAAA;EACAC,cAAA;EACAC,cAAA;EACAC;AACF,IAAItB,QAAA","ignoreList":[]}

package/dist/esm/platform/index.gnome.mjs

@@ -0,0 +1,34 @@
+import { getBroadName, getPreciseName, platformBase } from "./platformBase.mjs";
+const platform = {
+  ...platformBase,
+  isGnome: true,
+  // GTK is a desktop, and it is not a browser — so `isNative` too, which is
+  // exactly why Gnome sits ahead of Native in the precision order.
+  isDesktop: true,
+  isNative: true,
+  isClient: true,
+  isServer: false,
+  isWeb: false,
+  isBrowser: false,
+  isChrome: false,
+  isFirefox: false,
+  isIframe: false,
+  isStorybook: false,
+  isWebExtension: false,
+  isChromeExtension: false,
+  isFirefoxExtension: false,
+  isExpo: false,
+  isNext: false,
+  // A GTK pointer desktop. Touch exists on some hardware but is not the
+  // interaction model the layout should assume.
+  isTouchable: false,
+  isWebTouchable: false,
+  // There is a `window` under the react-gnome polyfills, but it is a stub
+  // with no layout, no events and no document. Callers branching on this are
+  // asking "can I touch the DOM", and the answer is no.
+  isWindowDefined: false
+};
+platform.preciseName = getPreciseName(platform);
+platform.broadName = getBroadName(platform);
+export { platform };
+//# sourceMappingURL=index.gnome.mjs.map

package/dist/esm/platform/index.gnome.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["getBroadName","getPreciseName","platformBase","platform","isGnome","isDesktop","isNative","isClient","isServer","isWeb","isBrowser","isChrome","isFirefox","isIframe","isStorybook","isWebExtension","isChromeExtension","isFirefoxExtension","isExpo","isNext","isTouchable","isWebTouchable","isWindowDefined","preciseName","broadName"],"sources":["../../../src/platform/index.gnome.ts"],"sourcesContent":[null],"mappings":"AAeA,SAAwBA,YAAA,EAAcC,cAAA,EAAgBC,YAAA,QAAoB;AAEnE,MAAMC,QAAA,GAAqB;EAChC,GAAGD,YAAA;EACHE,OAAA,EAAS;EAAA;EAAA;EAGTC,SAAA,EAAW;EACXC,QAAA,EAAU;EACVC,QAAA,EAAU;EACVC,QAAA,EAAU;EACVC,KAAA,EAAO;EACPC,SAAA,EAAW;EACXC,QAAA,EAAU;EACVC,SAAA,EAAW;EACXC,QAAA,EAAU;EACVC,WAAA,EAAa;EACbC,cAAA,EAAgB;EAChBC,iBAAA,EAAmB;EACnBC,kBAAA,EAAoB;EACpBC,MAAA,EAAQ;EACRC,MAAA,EAAQ;EAAA;EAAA;EAGRC,WAAA,EAAa;EACbC,cAAA,EAAgB;EAAA;EAAA;EAAA;EAIhBC,eAAA,EAAiB;AACnB;AACAnB,QAAA,CAASoB,WAAA,GAActB,cAAA,CAAeE,QAAQ;AAC9CA,QAAA,CAASqB,SAAA,GAAYxB,YAAA,CAAaG,QAAQ","ignoreList":[]}

package/dist/esm/platform/platformBase.mjs

@@ -1,5 +1,11 @@
 import { isChrome, isClient, isServer, isTouchable, isWeb, isWebTouchable, isWindowDefined } from "@tamagui/constants";
-const platformOrder = ["Ios", "Android", "Native", "Tauri", "Desktop", "ChromeExtension", "FirefoxExtension", "WebExtension", "Next", "Expo", "Chrome", "Firefox", "Web", "Browser", "Client", "Server", "Iframe", "Storybook"];
+const platformOrder = ["Ios", "Android",
+// Gnome outranks Native: the GTK target reports isNative (it is not a
+// browser) but "gnome" is the precise answer callers want.
+"Gnome", "Native",
+// Tauri outranks Desktop/Web the same way: the webview host reports isWeb
+// and isDesktop, but "tauri" is the precise answer.
+"Tauri", "Desktop", "ChromeExtension", "FirefoxExtension", "WebExtension", "Next", "Expo", "Chrome", "Firefox", "Web", "Browser", "Client", "Server", "Iframe", "Storybook"];
 const platformBase = {
   isAndroid: false,
   isBrowser: false,
@@ -10,6 +16,7 @@ const platformBase = {
   isExpo: false,
   isFirefox: false,
   isFirefoxExtension: false,
+  isGnome: false,
   isIframe: false,
   isIos: false,
   isNative: false,

package/dist/esm/platform/platformBase.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["isChrome","isClient","isServer","isTouchable","isWeb","isWebTouchable","isWindowDefined","platformOrder","platformBase","isAndroid","isBrowser","isChromeExtension","isDesktop","isExpo","isFirefox","isFirefoxExtension","isIframe","isIos","isNative","isNext","isStorybook","window","__STORYBOOK_ADDONS_PREVIEW","isTauri","isWebExtension","preciseName","broadName","getPreciseName","platform","flags","name","toLowerCase","slice","getBroadName","reverse"],"sources":["../../../src/platform/platformBase.ts"],"sourcesContent":[null],"mappings":"AAAA,SACEA,QAAA,EACAC,QAAA,EACAC,QAAA,EACAC,WAAA,EACAC,KAAA,EACAC,cAAA,EACAC,eAAA,QACK;AAQP,MAAMC,aAAA,GAAgB,CACpB,OACA,WACA,UACA,SACA,WACA,mBACA,oBACA,gBACA,QACA,QACA,UACA,WACA,OACA,WACA,UACA,UACA,UACA,YACF;AAuBO,MAAMC,YAAA,GAAe;EAC1BC,SAAA,EAAW;EACXC,SAAA,EAAW;EACXV,QAAA;EACAW,iBAAA,EAAmB;EACnBV,QAAA;EACAW,SAAA,EAAW;EACXC,MAAA,EAAQ;EACRC,SAAA,EAAW;EACXC,kBAAA,EAAoB;EACpBC,QAAA,EAAU;EACVC,KAAA,EAAO;EACPC,QAAA,EAAU;EACVC,MAAA,EAAQ;EACRjB,QAAA;EACAkB,WAAA,EAAad,eAAA,IAAmB,OAAOe,MAAA,CAAOC,0BAAA,KAA+B;EAC7EC,OAAA,EAAS;EACTpB,WAAA;EACAC,KAAA;EACAoB,cAAA,EAAgB;EAChBnB,cAAA;EACAC,eAAA;EACAmB,WAAA,EAAa;EACbC,SAAA,EAAW;AACb;AAEO,SAASC,eAAeC,QAAA,EAAyC;EACtE,MAAMC,KAAA,GAAQD,QAAA;EACd,WAAWE,IAAA,IAAQvB,aAAA,EAAe;IAChC,IAAIsB,KAAA,CAAM,KAAKC,IAAI,EAAE,GAAG;MACtB,OAAO,GAAGA,IAAA,CAAK,CAAC,EAAEC,WAAA,CAAY,CAAC,GAAGD,IAAA,CAAKE,KAAA,CAAM,CAAC,CAAC;IACjD;EACF;EACA,OAAO;AACT;AAEO,SAASC,aAAaL,QAAA,EAAuC;EAClE,MAAMC,KAAA,GAAQD,QAAA;EACd,WAAWE,IAAA,IAAQvB,aAAA,CAAcyB,KAAA,CAAM,EAAEE,OAAA,CAAQ,GAAG;IAClD,IAAIL,KAAA,CAAM,KAAKC,IAAI,EAAE,GAAG;MACtB,OAAO,GAAGA,IAAA,CAAK,CAAC,EAAEC,WAAA,CAAY,CAAC,GAAGD,IAAA,CAAKE,KAAA,CAAM,CAAC,CAAC;IACjD;EACF;EACA,OAAO;AACT","ignoreList":[]}
+{"version":3,"names":["isChrome","isClient","isServer","isTouchable","isWeb","isWebTouchable","isWindowDefined","platformOrder","platformBase","isAndroid","isBrowser","isChromeExtension","isDesktop","isExpo","isFirefox","isFirefoxExtension","isGnome","isIframe","isIos","isNative","isNext","isStorybook","window","__STORYBOOK_ADDONS_PREVIEW","isTauri","isWebExtension","preciseName","broadName","getPreciseName","platform","flags","name","toLowerCase","slice","getBroadName","reverse"],"sources":["../../../src/platform/platformBase.ts"],"sourcesContent":[null],"mappings":"AAAA,SACEA,QAAA,EACAC,QAAA,EACAC,QAAA,EACAC,WAAA,EACAC,KAAA,EACAC,cAAA,EACAC,eAAA,QACK;AAQP,MAAMC,aAAA,GAAgB,CACpB,OACA;AAAA;AAAA;AAGA,SACA;AAAA;AAAA;AAGA,SACA,WACA,mBACA,oBACA,gBACA,QACA,QACA,UACA,WACA,OACA,WACA,UACA,UACA,UACA,YACF;AAwBO,MAAMC,YAAA,GAAe;EAC1BC,SAAA,EAAW;EACXC,SAAA,EAAW;EACXV,QAAA;EACAW,iBAAA,EAAmB;EACnBV,QAAA;EACAW,SAAA,EAAW;EACXC,MAAA,EAAQ;EACRC,SAAA,EAAW;EACXC,kBAAA,EAAoB;EACpBC,OAAA,EAAS;EACTC,QAAA,EAAU;EACVC,KAAA,EAAO;EACPC,QAAA,EAAU;EACVC,MAAA,EAAQ;EACRlB,QAAA;EACAmB,WAAA,EAAaf,eAAA,IAAmB,OAAOgB,MAAA,CAAOC,0BAAA,KAA+B;EAC7EC,OAAA,EAAS;EACTrB,WAAA;EACAC,KAAA;EACAqB,cAAA,EAAgB;EAChBpB,cAAA;EACAC,eAAA;EACAoB,WAAA,EAAa;EACbC,SAAA,EAAW;AACb;AAEO,SAASC,eAAeC,QAAA,EAAyC;EACtE,MAAMC,KAAA,GAAQD,QAAA;EACd,WAAWE,IAAA,IAAQxB,aAAA,EAAe;IAChC,IAAIuB,KAAA,CAAM,KAAKC,IAAI,EAAE,GAAG;MACtB,OAAO,GAAGA,IAAA,CAAK,CAAC,EAAEC,WAAA,CAAY,CAAC,GAAGD,IAAA,CAAKE,KAAA,CAAM,CAAC,CAAC;IACjD;EACF;EACA,OAAO;AACT;AAEO,SAASC,aAAaL,QAAA,EAAuC;EAClE,MAAMC,KAAA,GAAQD,QAAA;EACd,WAAWE,IAAA,IAAQxB,aAAA,CAAc0B,KAAA,CAAM,EAAEE,OAAA,CAAQ,GAAG;IAClD,IAAIL,KAAA,CAAM,KAAKC,IAAI,EAAE,GAAG;MACtB,OAAO,GAAGA,IAAA,CAAK,CAAC,EAAEC,WAAA,CAAY,CAAC,GAAGD,IAAA,CAAKE,KAAA,CAAM,CAAC,CAAC;IACjD;EACF;EACA,OAAO;AACT","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/platform",
-  "version": "6.7.0",
+  "version": "7.1.0",
   "description": "Platform detection flags and utilities for multiplatform.one",
   "keywords": [
     "detection",
@@ -44,16 +44,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@tamagui/constants": "2.0.0-rc.41"
+    "@tamagui/constants": "2.7.6"
   },
   "devDependencies": {
-    "@tamagui/build": "2.0.0-rc.41",
+    "@tamagui/build": "2.7.6",
     "@types/chrome": "^0.1.40",
     "@types/firefox-webext-browser": "^143.0.0",
     "@types/react": "~19.2.14",
+    "@vitest/coverage-v8": "^4.1.5",
+    "happy-dom": "^20.9.0",
     "react": "19.2.5",
     "typescript": "~5.9.3",
-    "@multiplatform.one/config": "6.7.0"
+    "vitest": "^4.1.5",
+    "@multiplatform.one/config": "7.1.0"
   },
   "peerDependencies": {
     "expo-constants": "~55.0.15",
@@ -69,6 +72,7 @@
   },
   "scripts": {
     "build": "rm -rf dist types 2>/dev/null && tamagui-build --ts-project ./tsconfig.build.json --exclude '\\.spec\\.|\\.test\\.|\\.stories\\.' && find dist -name '*.native.js' -delete && find dist -name '*.native.js.map' -delete",
+    "test": "vitest run --coverage --coverage.provider=v8 --coverage.reporter=text --coverage.reporter=lcov --coverage.reporter=html",
     "typecheck": "tsgo --noEmit"
   }
 }

package/src/config/config.spec.ts

@@ -1,9 +1,23 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { Config } from "./config";
+import { bakedConfigEnvKey, runtimePublicConfigKey } from "./runtimeConfig";
+
+function setRuntimePayload(payload: Record<string, string>) {
+  (globalThis as unknown as Record<string, unknown>)[runtimePublicConfigKey] = payload;
+}
+
+function clearRuntimePayload() {
+  delete (globalThis as unknown as Record<string, unknown>)[runtimePublicConfigKey];
+}
 
 describe("Config", () => {
   beforeEach(() => {
     vi.unstubAllEnvs();
+    clearRuntimePayload();
+  });
+
+  afterEach(() => {
+    clearRuntimePayload();
   });
 
   describe("constructor", () => {
@@ -130,4 +144,51 @@ describe("Config", () => {
       expect(c.get("ADDED_KEY")).toBe("env-wins");
     });
   });
+
+  describe("runtime public config published by the SSR document", () => {
+    it("resolves MARKETPLACE_API_URL from the runtime payload with no build-time VITE_MP_CONFIG", () => {
+      // The exact production shape: an image built by CI with an EMPTY build
+      // environment (no VITE_MP_CONFIG baked), configured per deployment by
+      // the container env, which the SSR document publishes to the browser.
+      setRuntimePayload({ MARKETPLACE_API_URL: "https://api.marketplace.example.org" });
+      const c = new Config();
+      expect(c.get("MARKETPLACE_API_URL")).toBe("https://api.marketplace.example.org");
+    });
+
+    it("resolves FRAPPE_ENABLED from the runtime payload so the frappe provider can mount", () => {
+      // CreateApp.tsx gates FrappeProvider on config.get("FRAPPE_ENABLED") === "1".
+      setRuntimePayload({ FRAPPE_ENABLED: "1" });
+      const c = new Config();
+      expect(c.get("FRAPPE_ENABLED")).toBe("1");
+    });
+
+    // These use MARKETPLACE_API_URL rather than BASE_URL on purpose: vite (and
+    // therefore vitest) publishes its own BASE_URL="/" into process.env, and
+    // _lookupEnv still outranks everything on the SERVER — so a BASE_URL
+    // fixture would measure vite's value, not the precedence under test.
+    it("prefers the runtime payload over a stale build-time baked value", () => {
+      vi.stubEnv(
+        bakedConfigEnvKey,
+        JSON.stringify({ MARKETPLACE_API_URL: "https://stale.example.org" }),
+      );
+      setRuntimePayload({ MARKETPLACE_API_URL: "https://fresh.example.org" });
+      const c = new Config();
+      expect(c.get("MARKETPLACE_API_URL")).toBe("https://fresh.example.org");
+    });
+
+    it("still resolves the build-time baked value when no runtime payload exists", () => {
+      vi.stubEnv(
+        bakedConfigEnvKey,
+        JSON.stringify({ MARKETPLACE_API_URL: "https://baked.example.org" }),
+      );
+      const c = new Config();
+      expect(c.get("MARKETPLACE_API_URL")).toBe("https://baked.example.org");
+    });
+
+    it("lets explicit constructor values win over the runtime payload", () => {
+      setRuntimePayload({ MARKETPLACE_API_URL: "https://runtime.example.org" });
+      const c = new Config({ MARKETPLACE_API_URL: "https://explicit.example.org" });
+      expect(c.get("MARKETPLACE_API_URL")).toBe("https://explicit.example.org");
+    });
+  });
 });