@fluixi/dom 1.0.0-alpha.83 → 1.0.0-alpha.85

package/dist/lib/dom/server/fx-data.cjs

@@ -1 +1,53 @@
-"use strict";var u=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var _=Object.prototype.hasOwnProperty;var a=(e,n)=>{for(var t in n)u(e,t,{get:n[t],enumerable:!0})},l=(e,n,t,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of s(n))!_.call(e,r)&&r!==t&&u(e,r,{get:()=>n[r],enumerable:!(i=d(n,r))||i.enumerable});return e};var g=e=>l(u({},"__esModule",{value:!0}),e);var x={};a(x,{FX_DATA_ID:()=>c,escapeFxJson:()=>f,getServerData:()=>A,resetServerDataCache:()=>p});module.exports=g(x);var c="__FX_DATA__";function f(e){return e.replace(/[<>&\u2028\u2029]/g,n=>"\\u"+n.charCodeAt(0).toString(16).padStart(4,"0"))}var o;function p(){o=void 0}function A(){let e=globalThis.__FX_DATA__;if(e)return e;if(o!==void 0)return o;let n=null;if(typeof document<"u"){let t=document.getElementById(c)?.textContent;if(t)try{n=JSON.parse(t)}catch{n=null}}return o=n}
+"use strict";
+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);
+
+// src/lib/dom/server/fx-data.ts
+var fx_data_exports = {};
+__export(fx_data_exports, {
+  FX_DATA_ID: () => FX_DATA_ID,
+  escapeFxJson: () => escapeFxJson,
+  getServerData: () => getServerData,
+  resetServerDataCache: () => resetServerDataCache
+});
+module.exports = __toCommonJS(fx_data_exports);
+var FX_DATA_ID = "__FX_DATA__";
+function escapeFxJson(json) {
+  return json.replace(/[<>&\u2028\u2029]/g, (c) => "\\u" + c.charCodeAt(0).toString(16).padStart(4, "0"));
+}
+var _scriptCache;
+function resetServerDataCache() {
+  _scriptCache = void 0;
+}
+function getServerData() {
+  const g = globalThis.__FX_DATA__;
+  if (g) return g;
+  if (_scriptCache !== void 0) return _scriptCache;
+  let parsed = null;
+  if (typeof document !== "undefined") {
+    const text = document.getElementById(FX_DATA_ID)?.textContent;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = null;
+      }
+    }
+  }
+  return _scriptCache = parsed;
+}

package/dist/lib/dom/server/fx-data.d.ts

@@ -1,15 +1,15 @@
 /**
- * The SSR data transport (`__FX_DATA__`) — emission escaping + client reader.
+ * The SSR data transport (`__FX_DATA__`): emission escaping + client reader.
  *
  * The server collects resolved resource values + seeds (i18n locale, isomorphic state) and
  * embeds them in the page so the client hydrates without refetching. SECURITY MODEL:
  *
- *  - It is NON-SECRET BY DESIGN — it's in the page, readable by the user. Encrypting it buys
+ *  - It is NON-SECRET BY DESIGN, it's in the page, readable by the user. Encrypting it buys
  *    nothing (the client would need the key). Keep server-only fields OUT via setDataRedactor;
  *    fetch truly sensitive data through a `"use server"` function instead. Don't obfuscate.
  *
  *  - Emitted as a NON-EXECUTABLE `<script type="application/json">`, read via `JSON.parse` of
- *    its `textContent`. So (a) a value can never execute as JS, and (b) it's CSP-friendly —
+ *    its `textContent`. So (a) a value can never execute as JS, and (b) it's CSP-friendly:
  *    it works under a strict `script-src` that forbids inline executable scripts.
  *
  *  - The JSON is escaped with the standard SSR-JSON set (`<`, `>`, `&`, U+2028, U+2029) so no
@@ -20,8 +20,8 @@
 export declare const FX_DATA_ID = "__FX_DATA__";
 /**
  * Escape a JSON string for safe embedding inside a `<script>` element.
- * `<`/`>` → can't form `</script>`, `<!--` or `-->`; `&` → no HTML-entity surprises;
- * U+2028/U+2029 → JS line terminators that would break an inline-script read.
+ * `<`/`>` -> can't form `</script>`, `<!--` or `-->`; `&` -> no HTML-entity surprises;
+ * U+2028/U+2029 -> JS line terminators that would break an inline-script read.
  * JSON.parse decodes every `\uXXXX` back to the original character.
  */
 export declare function escapeFxJson(json: string): string;

package/dist/lib/dom/server/fx-data.js

@@ -1,15 +1,15 @@
 /**
- * The SSR data transport (`__FX_DATA__`) — emission escaping + client reader.
+ * The SSR data transport (`__FX_DATA__`): emission escaping + client reader.
  *
  * The server collects resolved resource values + seeds (i18n locale, isomorphic state) and
  * embeds them in the page so the client hydrates without refetching. SECURITY MODEL:
  *
- *  - It is NON-SECRET BY DESIGN — it's in the page, readable by the user. Encrypting it buys
+ *  - It is NON-SECRET BY DESIGN, it's in the page, readable by the user. Encrypting it buys
  *    nothing (the client would need the key). Keep server-only fields OUT via setDataRedactor;
  *    fetch truly sensitive data through a `"use server"` function instead. Don't obfuscate.
  *
  *  - Emitted as a NON-EXECUTABLE `<script type="application/json">`, read via `JSON.parse` of
- *    its `textContent`. So (a) a value can never execute as JS, and (b) it's CSP-friendly —
+ *    its `textContent`. So (a) a value can never execute as JS, and (b) it's CSP-friendly:
  *    it works under a strict `script-src` that forbids inline executable scripts.
  *
  *  - The JSON is escaped with the standard SSR-JSON set (`<`, `>`, `&`, U+2028, U+2029) so no
@@ -20,8 +20,8 @@
 export const FX_DATA_ID = '__FX_DATA__';
 /**
  * Escape a JSON string for safe embedding inside a `<script>` element.
- * `<`/`>` → can't form `</script>`, `<!--` or `-->`; `&` → no HTML-entity surprises;
- * U+2028/U+2029 → JS line terminators that would break an inline-script read.
+ * `<`/`>` -> can't form `</script>`, `<!--` or `-->`; `&` -> no HTML-entity surprises;
+ * U+2028/U+2029 -> JS line terminators that would break an inline-script read.
  * JSON.parse decodes every `\uXXXX` back to the original character.
  */
 export function escapeFxJson(json) {
@@ -52,7 +52,7 @@ export function getServerData() {
                 parsed = JSON.parse(text);
             }
             catch {
-                parsed = null; // malformed transport → behave as if not server-rendered (refetch)
+                parsed = null; // malformed transport -> behave as if not server-rendered (refetch)
             }
         }
     }

package/dist/lib/dom/server/fx-data.mjs

@@ -1 +1,32 @@
-var o="__FX_DATA__";function u(e){return e.replace(/[<>&\u2028\u2029]/g,n=>"\\u"+n.charCodeAt(0).toString(16).padStart(4,"0"))}var t;function i(){t=void 0}function c(){let e=globalThis.__FX_DATA__;if(e)return e;if(t!==void 0)return t;let n=null;if(typeof document<"u"){let r=document.getElementById(o)?.textContent;if(r)try{n=JSON.parse(r)}catch{n=null}}return t=n}export{o as FX_DATA_ID,u as escapeFxJson,c as getServerData,i as resetServerDataCache};
+// src/lib/dom/server/fx-data.ts
+var FX_DATA_ID = "__FX_DATA__";
+function escapeFxJson(json) {
+  return json.replace(/[<>&\u2028\u2029]/g, (c) => "\\u" + c.charCodeAt(0).toString(16).padStart(4, "0"));
+}
+var _scriptCache;
+function resetServerDataCache() {
+  _scriptCache = void 0;
+}
+function getServerData() {
+  const g = globalThis.__FX_DATA__;
+  if (g) return g;
+  if (_scriptCache !== void 0) return _scriptCache;
+  let parsed = null;
+  if (typeof document !== "undefined") {
+    const text = document.getElementById(FX_DATA_ID)?.textContent;
+    if (text) {
+      try {
+        parsed = JSON.parse(text);
+      } catch {
+        parsed = null;
+      }
+    }
+  }
+  return _scriptCache = parsed;
+}
+export {
+  FX_DATA_ID,
+  escapeFxJson,
+  getServerData,
+  resetServerDataCache
+};

package/dist/lib/dom/server/host.cjs

@@ -1 +1,66 @@
-"use strict";var i=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var f=(e,r)=>{for(var t in r)i(e,t,{get:r[t],enumerable:!0})},c=(e,r,t,a)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of d(r))!l.call(e,n)&&n!==t&&i(e,n,{get:()=>r[n],enumerable:!(a=u(r,n))||a.enumerable});return e};var y=e=>c(i({},"__esModule",{value:!0}),e);var g={};f(g,{SERVER_NODE:()=>s,getServerNodes:()=>b,isDomElement:()=>T,isDomNode:()=>N,isDomText:()=>E,isServer:()=>p,registerServerNodes:()=>x,setServerMode:()=>S});module.exports=y(g);var s=Symbol.for("fluixi.server-node"),m=Symbol.for("fluixi.dom.server-host"),v=globalThis,o=v[m]??={server:typeof document>"u",nodes:null};function p(){return o.server}function S(e){o.server=e}function x(e){o.nodes=e}function b(){if(!o.nodes)throw new Error("[fluixi] server render ran before @fluixi/dom/server loaded");return o.nodes}function N(e){return e!=null&&e[s]===!0?!0:typeof Node<"u"&&e instanceof Node}function T(e){return e!=null&&e[s]===!0?e.nodeType===1:typeof Element<"u"&&e instanceof Element}function E(e){return e!=null&&e[s]===!0?e.nodeType===3:typeof Text<"u"&&e instanceof Text}
+"use strict";
+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);
+
+// src/lib/dom/server/host.ts
+var host_exports = {};
+__export(host_exports, {
+  SERVER_NODE: () => SERVER_NODE,
+  getServerNodes: () => getServerNodes,
+  isDomElement: () => isDomElement,
+  isDomNode: () => isDomNode,
+  isDomText: () => isDomText,
+  isServer: () => isServer,
+  registerServerNodes: () => registerServerNodes,
+  setServerMode: () => setServerMode
+});
+module.exports = __toCommonJS(host_exports);
+var SERVER_NODE = /* @__PURE__ */ Symbol.for("fluixi.server-node");
+var STATE = /* @__PURE__ */ Symbol.for("fluixi.dom.server-host");
+var realm = globalThis;
+var state = realm[STATE] ??= {
+  server: typeof document === "undefined",
+  nodes: null
+};
+function isServer() {
+  return state.server;
+}
+function setServerMode(on) {
+  state.server = on;
+}
+function registerServerNodes(factory) {
+  state.nodes = factory;
+}
+function getServerNodes() {
+  if (!state.nodes) {
+    throw new Error("[fluixi] server render ran before @fluixi/dom/server loaded");
+  }
+  return state.nodes;
+}
+function isDomNode(x) {
+  if (x != null && x[SERVER_NODE] === true) return true;
+  return typeof Node !== "undefined" && x instanceof Node;
+}
+function isDomElement(x) {
+  if (x != null && x[SERVER_NODE] === true) return x.nodeType === 1;
+  return typeof Element !== "undefined" && x instanceof Element;
+}
+function isDomText(x) {
+  if (x != null && x[SERVER_NODE] === true) return x.nodeType === 3;
+  return typeof Text !== "undefined" && x instanceof Text;
+}

package/dist/lib/dom/server/host.d.ts

@@ -6,6 +6,12 @@ export declare const SERVER_NODE: unique symbol;
  * binding, and the two would disagree for the whole of a render.
  */
 export declare function isServer(): boolean;
+/**
+ * Turn server mode on or off for this realm.
+ *
+ * `renderToString` owns this and restores the previous value, so it is rarely called
+ * directly. A test that needs to exercise a server path is the exception.
+ */
 export declare function setServerMode(on: boolean): void;
 export interface ServerNodeFactory {
     createElement(tag: string, isSVG: boolean): any;

package/dist/lib/dom/server/host.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../../src/lib/dom/server/host.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,EAAE,OAAO,MAAyC,CAAC;AAuB3E;;;;;GAKG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC;IAChD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;IAC/B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,0DAA0D;IAC1D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IAC7B,gFAAgF;IAChF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC;CAClD;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAEpE;AAED,wBAAgB,cAAc,IAAI,iBAAiB,CAKlD;AAID,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAG3C;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAGjD;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAG3C"}
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../../src/lib/dom/server/host.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,EAAE,OAAO,MAAyC,CAAC;AAuB3E;;;;;GAKG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC;IAChD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;IAC/B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;IAClC,0DAA0D;IAC1D,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;IAC7B,gFAAgF;IAChF,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,GAAG,CAAC;CAClD;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAEpE;AAED,wBAAgB,cAAc,IAAI,iBAAiB,CAKlD;AAID,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAG3C;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,OAAO,CAGjD;AACD,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,IAAI,CAG3C"}

package/dist/lib/dom/server/host.js

@@ -1,5 +1,5 @@
 // The server seam the runtime imports from. Deliberately class-free so the
-// ServerNode classes in ./nodes.ts stay out of client bundles — they get pulled
+// ServerNode classes in ./nodes.ts stay out of client bundles, they get pulled
 // in (and registered) only when @fluixi/dom/server loads.
 // Stamped on every server node so the guards below can spot one without an
 // instanceof against the (unbundled) classes.
@@ -27,6 +27,12 @@ const state = (realm[STATE] ??= {
 export function isServer() {
     return state.server;
 }
+/**
+ * Turn server mode on or off for this realm.
+ *
+ * `renderToString` owns this and restores the previous value, so it is rarely called
+ * directly. A test that needs to exercise a server path is the exception.
+ */
 export function setServerMode(on) {
     state.server = on;
 }

package/dist/lib/dom/server/host.mjs

@@ -1 +1,45 @@
-var n=Symbol.for("fluixi.server-node"),o=Symbol.for("fluixi.dom.server-host"),t=globalThis,r=t[o]??={server:typeof document>"u",nodes:null};function s(){return r.server}function i(e){r.server=e}function a(e){r.nodes=e}function u(){if(!r.nodes)throw new Error("[fluixi] server render ran before @fluixi/dom/server loaded");return r.nodes}function d(e){return e!=null&&e[n]===!0?!0:typeof Node<"u"&&e instanceof Node}function l(e){return e!=null&&e[n]===!0?e.nodeType===1:typeof Element<"u"&&e instanceof Element}function f(e){return e!=null&&e[n]===!0?e.nodeType===3:typeof Text<"u"&&e instanceof Text}export{n as SERVER_NODE,u as getServerNodes,l as isDomElement,d as isDomNode,f as isDomText,s as isServer,a as registerServerNodes,i as setServerMode};
+// src/lib/dom/server/host.ts
+var SERVER_NODE = /* @__PURE__ */ Symbol.for("fluixi.server-node");
+var STATE = /* @__PURE__ */ Symbol.for("fluixi.dom.server-host");
+var realm = globalThis;
+var state = realm[STATE] ??= {
+  server: typeof document === "undefined",
+  nodes: null
+};
+function isServer() {
+  return state.server;
+}
+function setServerMode(on) {
+  state.server = on;
+}
+function registerServerNodes(factory) {
+  state.nodes = factory;
+}
+function getServerNodes() {
+  if (!state.nodes) {
+    throw new Error("[fluixi] server render ran before @fluixi/dom/server loaded");
+  }
+  return state.nodes;
+}
+function isDomNode(x) {
+  if (x != null && x[SERVER_NODE] === true) return true;
+  return typeof Node !== "undefined" && x instanceof Node;
+}
+function isDomElement(x) {
+  if (x != null && x[SERVER_NODE] === true) return x.nodeType === 1;
+  return typeof Element !== "undefined" && x instanceof Element;
+}
+function isDomText(x) {
+  if (x != null && x[SERVER_NODE] === true) return x.nodeType === 3;
+  return typeof Text !== "undefined" && x instanceof Text;
+}
+export {
+  SERVER_NODE,
+  getServerNodes,
+  isDomElement,
+  isDomNode,
+  isDomText,
+  isServer,
+  registerServerNodes,
+  setServerMode
+};