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

package/dist/lib/dom/server/parse-template.cjs

@@ -1 +1,395 @@
-"use strict";var b=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var k=(n,t)=>{for(var e in t)b(n,e,{get:t[e],enumerable:!0})},H=(n,t,e,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of L(t))!M.call(n,o)&&o!==e&&b(n,o,{get:()=>t[o],enumerable:!(r=O(t,o))||r.enumerable});return n};var V=n=>H(b({},"__esModule",{value:!0}),n);var U={};k(U,{TemplateParseError:()=>l,parseTemplate:()=>G});module.exports=V(U);var T=Symbol.for("fluixi.server-node"),$=Symbol.for("fluixi.dom.server-host"),D=globalThis,B=D[$]??={server:typeof document>"u",nodes:null};var R=1,F=3,I=8,y;y=T;var h=class{constructor(){this[y]=!0;this.parentNode=null;this.childNodes=[]}get firstChild(){return this.childNodes[0]??null}get lastChild(){return this.childNodes[this.childNodes.length-1]??null}get nextSibling(){let t=this.parentNode;if(!t)return null;let e=t.childNodes.indexOf(this);return e>=0?t.childNodes[e+1]??null:null}get previousSibling(){let t=this.parentNode;if(!t)return null;let e=t.childNodes.indexOf(this);return e>0?t.childNodes[e-1]??null:null}get parentElement(){return this.parentNode}appendChild(t){return t.parentNode&&t.parentNode.removeChild(t),t.parentNode=this,this.childNodes.push(t),t}insertBefore(t,e){if(e==null)return this.appendChild(t);t.parentNode&&t.parentNode.removeChild(t);let r=this.childNodes.indexOf(e);return t.parentNode=this,r<0?this.childNodes.push(t):this.childNodes.splice(r,0,t),t}removeChild(t){let e=this.childNodes.indexOf(t);return e>=0&&this.childNodes.splice(e,1),t.parentNode=null,t}replaceChild(t,e){let r=this.childNodes.indexOf(e);return r>=0&&(t.parentNode&&t.parentNode.removeChild(t),t.parentNode=this,this.childNodes[r]=t,e.parentNode=null),e}addEventListener(){}removeEventListener(){}},g=class n extends h{constructor(e){super();this.nodeType=F;this.data=e}get nodeValue(){return this.data}set nodeValue(e){this.data=e==null?"":String(e)}get textContent(){return this.data}set textContent(e){this.data=e==null?"":String(e)}cloneNode(){return new n(this.data)}};var f=class n extends h{constructor(e){super();this.nodeType=I;this.data=e}get nodeValue(){return this.data}set nodeValue(e){this.data=e==null?"":String(e)}cloneNode(){return new n(this.data)}},m=class{constructor(){this.cssText=""}setProperty(t,e){this[t]=e}removeProperty(t){delete this[t]}},w=class{constructor(t){this.el=t}list(){let t=this.el.getAttribute("class");return t?t.split(/\s+/).filter(Boolean):[]}write(t){t.length?this.el.setAttribute("class",t.join(" ")):this.el.removeAttribute("class")}add(...t){let e=this.list();for(let r of t)e.includes(r)||e.push(r);this.write(e)}remove(...t){this.write(this.list().filter(e=>!t.includes(e)))}contains(t){return this.list().includes(t)}toggle(t,e){let r=this.contains(t),o=e===void 0?!r:e;return o?this.add(t):this.remove(t),o}},p=class n extends h{constructor(e,r=!1){super();this.nodeType=R;this.attributes=new Map;this.style=new m;this.classList=new w(this);this.rawHTML=null;this.localName=e.toLowerCase(),this.tagName=r?e:e.toUpperCase(),this.isSVG=r,this.namespaceURI=r?"http://www.w3.org/2000/svg":null}setAttribute(e,r){this.attributes.set(e,String(r))}removeAttribute(e){this.attributes.delete(e)}getAttribute(e){return this.attributes.has(e)?this.attributes.get(e):null}hasAttribute(e){return this.attributes.has(e)}get id(){return this.getAttribute("id")??""}set id(e){e==null?this.removeAttribute("id"):this.setAttribute("id",e)}get className(){return this.getAttribute("class")??""}set className(e){e==null?this.removeAttribute("class"):this.setAttribute("class",e)}get htmlFor(){return this.getAttribute("for")??""}set htmlFor(e){e==null?this.removeAttribute("for"):this.setAttribute("for",e)}set value(e){e==null?this.removeAttribute("value"):this.setAttribute("value",String(e))}set checked(e){e?this.setAttribute("checked",""):this.removeAttribute("checked")}set selected(e){e?this.setAttribute("selected",""):this.removeAttribute("selected")}set indeterminate(e){}get textContent(){return this.childNodes.map(e=>e.textContent??"").join("")}set textContent(e){for(let r of this.childNodes)r.parentNode=null;this.childNodes=[],this.rawHTML=null,e!=null&&e!==""&&this.appendChild(new g(String(e)))}set innerText(e){this.textContent=e}set innerHTML(e){for(let r of this.childNodes)r.parentNode=null;this.childNodes=[],this.rawHTML=e==null?"":String(e)}cloneNode(e=!1){let r=new n(this.localName,this.isSVG);if(r.attributes=new Map(this.attributes),r.style.cssText=this.style.cssText,r.rawHTML=this.rawHTML,e)for(let o of this.childNodes)r.appendChild(o.cloneNode(!0));return r}};var j=new Set(["area","base","br","col","embed","hr","img","input","link","meta","param","source","track","wbr"]),q={amp:"&",lt:"<",gt:">",quot:'"',"#39":"'"};function E(n){return n.replace(/&(#?\w+);/g,(t,e)=>q[e]??t)}var l=class extends Error{};function G(n,t=!1){let e=0,r=[],o=[],N=s=>{let a=o[o.length-1];a?a.appendChild(s):r.push(s)};for(;e<n.length;){let s=n.indexOf("<",e);if(s===-1){S(n.slice(e));break}if(s>e&&S(n.slice(e,s)),n.startsWith("<!--",s)){let a=n.indexOf("-->",s);if(a===-1)throw new l(`unterminated comment at ${s}`);N(new f(n.slice(s+4,a))),e=a+3;continue}if(n[s+1]==="/"){let a=n.indexOf(">",s);if(a===-1)throw new l(`unterminated closing tag at ${s}`);let u=n.slice(s+2,a).trim().toLowerCase(),d=o.pop();if(!d||d.localName!==u)throw new l(`</${u}> does not close <${d?.localName??"nothing"}>`);e=a+1;continue}e=C(s)}if(o.length>0)throw new l(`unclosed <${o[o.length-1].localName}>`);let x=r[0];if(r.length!==1||!(x instanceof p))throw new l(`expected exactly one root element, got ${r.length}`);return x;function S(s){s!==""&&N(new g(E(s)))}function C(s){let a=/[\s/>]/.exec(n.slice(s+1));if(!a)throw new l(`unterminated tag at ${s}`);let u=n.slice(s+1,s+1+a.index).toLowerCase(),d=new p(u,t),i=s+1+a.index;for(;i<n.length;){for(;i<n.length&&/\s/.test(n[i]);)i++;if(n[i]===">"){i++;break}if(n[i]==="/"&&n[i+1]===">"){i+=2;break}let A=i;for(;i<n.length&&!/[\s=/>]/.test(n[i]);)i++;let c=n.slice(A,i);if(c==="")throw new l(`malformed attribute at ${i}`);if(n[i]==="="){if(n[i+1]!=='"')throw new l(`attribute ${c} must have a double-quoted value`);let v=n.indexOf('"',i+2);if(v===-1)throw new l(`unterminated value for ${c}`);d.setAttribute(c,E(n.slice(i+2,v))),i=v+1}else d.setAttribute(c,"")}return N(d),j.has(u)||o.push(d),i}}
+"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/parse-template.ts
+var parse_template_exports = {};
+__export(parse_template_exports, {
+  TemplateParseError: () => TemplateParseError,
+  parseTemplate: () => parseTemplate
+});
+module.exports = __toCommonJS(parse_template_exports);
+
+// 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
+};
+
+// src/lib/dom/server/nodes.ts
+var NODE_ELEMENT = 1;
+var NODE_TEXT = 3;
+var NODE_COMMENT = 8;
+var _a;
+_a = SERVER_NODE;
+var ServerNode = class {
+  constructor() {
+    // Brand the host.ts guards check for (lets them skip an instanceof on these classes).
+    this[_a] = true;
+    this.parentNode = null;
+    this.childNodes = [];
+  }
+  get firstChild() {
+    return this.childNodes[0] ?? null;
+  }
+  get lastChild() {
+    return this.childNodes[this.childNodes.length - 1] ?? null;
+  }
+  get nextSibling() {
+    const p = this.parentNode;
+    if (!p) return null;
+    const i = p.childNodes.indexOf(this);
+    return i >= 0 ? p.childNodes[i + 1] ?? null : null;
+  }
+  get previousSibling() {
+    const p = this.parentNode;
+    if (!p) return null;
+    const i = p.childNodes.indexOf(this);
+    return i > 0 ? p.childNodes[i - 1] ?? null : null;
+  }
+  get parentElement() {
+    return this.parentNode;
+  }
+  appendChild(child) {
+    if (child.parentNode) child.parentNode.removeChild(child);
+    child.parentNode = this;
+    this.childNodes.push(child);
+    return child;
+  }
+  insertBefore(child, ref) {
+    if (ref == null) return this.appendChild(child);
+    if (child.parentNode) child.parentNode.removeChild(child);
+    const i = this.childNodes.indexOf(ref);
+    child.parentNode = this;
+    if (i < 0) this.childNodes.push(child);
+    else this.childNodes.splice(i, 0, child);
+    return child;
+  }
+  removeChild(child) {
+    const i = this.childNodes.indexOf(child);
+    if (i >= 0) this.childNodes.splice(i, 1);
+    child.parentNode = null;
+    return child;
+  }
+  replaceChild(next, old) {
+    const i = this.childNodes.indexOf(old);
+    if (i >= 0) {
+      if (next.parentNode) next.parentNode.removeChild(next);
+      next.parentNode = this;
+      this.childNodes[i] = next;
+      old.parentNode = null;
+    }
+    return old;
+  }
+  // Event listeners are inert on the server.
+  addEventListener() {
+  }
+  removeEventListener() {
+  }
+};
+var ServerText = class _ServerText extends ServerNode {
+  constructor(value) {
+    super();
+    this.nodeType = NODE_TEXT;
+    this.data = value;
+  }
+  get nodeValue() {
+    return this.data;
+  }
+  set nodeValue(v) {
+    this.data = v == null ? "" : String(v);
+  }
+  get textContent() {
+    return this.data;
+  }
+  set textContent(v) {
+    this.data = v == null ? "" : String(v);
+  }
+  cloneNode() {
+    return new _ServerText(this.data);
+  }
+};
+var ServerComment = class _ServerComment extends ServerNode {
+  constructor(value) {
+    super();
+    this.nodeType = NODE_COMMENT;
+    this.data = value;
+  }
+  get nodeValue() {
+    return this.data;
+  }
+  set nodeValue(v) {
+    this.data = v == null ? "" : String(v);
+  }
+  cloneNode() {
+    return new _ServerComment(this.data);
+  }
+};
+var ServerStyle = class {
+  constructor() {
+    // declared keys are stored as own props; cssText holds a raw string blob.
+    this.cssText = "";
+  }
+  setProperty(name, value) {
+    this[name] = value;
+  }
+  removeProperty(name) {
+    delete this[name];
+  }
+};
+var ServerClassList = class {
+  constructor(el) {
+    this.el = el;
+  }
+  list() {
+    const c = this.el.getAttribute("class");
+    return c ? c.split(/\s+/).filter(Boolean) : [];
+  }
+  write(arr) {
+    if (arr.length) this.el.setAttribute("class", arr.join(" "));
+    else this.el.removeAttribute("class");
+  }
+  add(...names) {
+    const arr = this.list();
+    for (const n of names) if (!arr.includes(n)) arr.push(n);
+    this.write(arr);
+  }
+  remove(...names) {
+    this.write(this.list().filter((c) => !names.includes(c)));
+  }
+  contains(name) {
+    return this.list().includes(name);
+  }
+  toggle(name, force) {
+    const has = this.contains(name);
+    const on = force === void 0 ? !has : force;
+    if (on) this.add(name);
+    else this.remove(name);
+    return on;
+  }
+};
+var ServerElement = class _ServerElement extends ServerNode {
+  constructor(tag, isSVG = false) {
+    super();
+    this.nodeType = NODE_ELEMENT;
+    this.attributes = /* @__PURE__ */ new Map();
+    this.style = new ServerStyle();
+    this.classList = new ServerClassList(this);
+    /** raw HTML set via innerHTML: emitted verbatim, bypassing childNodes. */
+    this.rawHTML = null;
+    this.localName = tag.toLowerCase();
+    this.tagName = isSVG ? tag : tag.toUpperCase();
+    this.isSVG = isSVG;
+    this.namespaceURI = isSVG ? "http://www.w3.org/2000/svg" : null;
+  }
+  setAttribute(name, value) {
+    this.attributes.set(name, String(value));
+  }
+  removeAttribute(name) {
+    this.attributes.delete(name);
+  }
+  getAttribute(name) {
+    return this.attributes.has(name) ? this.attributes.get(name) : null;
+  }
+  hasAttribute(name) {
+    return this.attributes.has(name);
+  }
+  get id() {
+    return this.getAttribute("id") ?? "";
+  }
+  set id(v) {
+    if (v == null) this.removeAttribute("id");
+    else this.setAttribute("id", v);
+  }
+  // JSX_PROPERTIES: className/value/checked/selected/innerHTML/innerText/
+  // textContent/indeterminate/htmlFor flow through setProperty (element[k]=v).
+  get className() {
+    return this.getAttribute("class") ?? "";
+  }
+  set className(v) {
+    if (v == null) this.removeAttribute("class");
+    else this.setAttribute("class", v);
+  }
+  get htmlFor() {
+    return this.getAttribute("for") ?? "";
+  }
+  set htmlFor(v) {
+    if (v == null) this.removeAttribute("for");
+    else this.setAttribute("for", v);
+  }
+  set value(v) {
+    if (v == null) this.removeAttribute("value");
+    else this.setAttribute("value", String(v));
+  }
+  set checked(v) {
+    if (v) this.setAttribute("checked", "");
+    else this.removeAttribute("checked");
+  }
+  set selected(v) {
+    if (v) this.setAttribute("selected", "");
+    else this.removeAttribute("selected");
+  }
+  // indeterminate is a live-only DOM property with no HTML serialization.
+  set indeterminate(_v) {
+  }
+  get textContent() {
+    return this.childNodes.map((c) => c.textContent ?? "").join("");
+  }
+  set textContent(v) {
+    for (const c of this.childNodes) c.parentNode = null;
+    this.childNodes = [];
+    this.rawHTML = null;
+    if (v != null && v !== "") this.appendChild(new ServerText(String(v)));
+  }
+  set innerText(v) {
+    this.textContent = v;
+  }
+  set innerHTML(v) {
+    for (const c of this.childNodes) c.parentNode = null;
+    this.childNodes = [];
+    this.rawHTML = v == null ? "" : String(v);
+  }
+  cloneNode(deep = false) {
+    const el = new _ServerElement(this.localName, this.isSVG);
+    el.attributes = new Map(this.attributes);
+    el.style.cssText = this.style.cssText;
+    el.rawHTML = this.rawHTML;
+    if (deep) for (const c of this.childNodes) el.appendChild(c.cloneNode(true));
+    return el;
+  }
+};
+
+// src/lib/dom/server/parse-template.ts
+var VOID_ELEMENTS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+var ENTITIES = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  "#39": "'"
+};
+function unescape(text) {
+  return text.replace(/&(#?\w+);/g, (whole, name) => ENTITIES[name] ?? whole);
+}
+var TemplateParseError = class extends Error {
+};
+function parseTemplate(html, isSVG = false) {
+  let i = 0;
+  const roots = [];
+  const stack = [];
+  const append = (node) => {
+    const parent = stack[stack.length - 1];
+    if (parent) parent.appendChild(node);
+    else roots.push(node);
+  };
+  while (i < html.length) {
+    const lt = html.indexOf("<", i);
+    if (lt === -1) {
+      addText(html.slice(i));
+      break;
+    }
+    if (lt > i) addText(html.slice(i, lt));
+    if (html.startsWith("<!--", lt)) {
+      const end = html.indexOf("-->", lt);
+      if (end === -1) throw new TemplateParseError(`unterminated comment at ${lt}`);
+      append(new ServerComment(html.slice(lt + 4, end)));
+      i = end + 3;
+      continue;
+    }
+    if (html[lt + 1] === "/") {
+      const end = html.indexOf(">", lt);
+      if (end === -1) throw new TemplateParseError(`unterminated closing tag at ${lt}`);
+      const tag = html.slice(lt + 2, end).trim().toLowerCase();
+      const open = stack.pop();
+      if (!open || open.localName !== tag) {
+        throw new TemplateParseError(
+          `</${tag}> does not close <${open?.localName ?? "nothing"}>`
+        );
+      }
+      i = end + 1;
+      continue;
+    }
+    i = openTag(lt);
+  }
+  if (stack.length > 0) {
+    throw new TemplateParseError(`unclosed <${stack[stack.length - 1].localName}>`);
+  }
+  const root = roots[0];
+  if (roots.length !== 1 || !(root instanceof ServerElement)) {
+    throw new TemplateParseError(`expected exactly one root element, got ${roots.length}`);
+  }
+  return root;
+  function addText(raw) {
+    if (raw === "") return;
+    append(new ServerText(unescape(raw)));
+  }
+  function openTag(lt) {
+    const nameEnd = /[\s/>]/.exec(html.slice(lt + 1));
+    if (!nameEnd) throw new TemplateParseError(`unterminated tag at ${lt}`);
+    const tag = html.slice(lt + 1, lt + 1 + nameEnd.index).toLowerCase();
+    const el = new ServerElement(tag, isSVG);
+    let j = lt + 1 + nameEnd.index;
+    while (j < html.length) {
+      while (j < html.length && /\s/.test(html[j])) j++;
+      if (html[j] === ">") {
+        j++;
+        break;
+      }
+      if (html[j] === "/" && html[j + 1] === ">") {
+        j += 2;
+        break;
+      }
+      const attrStart = j;
+      while (j < html.length && !/[\s=/>]/.test(html[j])) j++;
+      const name = html.slice(attrStart, j);
+      if (name === "") throw new TemplateParseError(`malformed attribute at ${j}`);
+      if (html[j] === "=") {
+        if (html[j + 1] !== '"') {
+          throw new TemplateParseError(`attribute ${name} must have a double-quoted value`);
+        }
+        const close = html.indexOf('"', j + 2);
+        if (close === -1) throw new TemplateParseError(`unterminated value for ${name}`);
+        el.setAttribute(name, unescape(html.slice(j + 2, close)));
+        j = close + 1;
+      } else {
+        el.setAttribute(name, "");
+      }
+    }
+    append(el);
+    if (!VOID_ELEMENTS.has(tag)) stack.push(el);
+    return j;
+  }
+}

package/dist/lib/dom/server/parse-template.d.ts

@@ -5,7 +5,7 @@
  * compiler's `serializeStatic`, which emits a narrow, known grammar: lowercase tag names,
  * double-quoted attribute values, entity-escaped text, void elements left unclosed, no
  * namespaces, no comments, no raw `<script>`/`<style>` content. Keeping the input
- * controlled is what makes this a small total function instead of a spec project — and
+ * controlled is what makes this a small total function instead of a spec project, and
  * the round-trip test pins the two together, so the grammar cannot drift on one side.
  *
  * A hole-free template never reaches here: it is carried verbatim as a `ServerRaw` node,

package/dist/lib/dom/server/parse-template.js

@@ -5,7 +5,7 @@
  * compiler's `serializeStatic`, which emits a narrow, known grammar: lowercase tag names,
  * double-quoted attribute values, entity-escaped text, void elements left unclosed, no
  * namespaces, no comments, no raw `<script>`/`<style>` content. Keeping the input
- * controlled is what makes this a small total function instead of a spec project — and
+ * controlled is what makes this a small total function instead of a spec project, and
  * the round-trip test pins the two together, so the grammar cannot drift on one side.
  *
  * A hole-free template never reaches here: it is carried verbatim as a `ServerRaw` node,
@@ -13,7 +13,7 @@
  * to produce real nodes for the hole content to be inserted into.
  */
 import { ServerComment, ServerElement, ServerText } from './nodes.js';
-/** Elements the HTML parser closes itself — they never have children. */
+/** Elements the HTML parser closes itself, they never have children. */
 const VOID_ELEMENTS = new Set([
     'area',
     'base',
@@ -105,7 +105,7 @@ export function parseTemplate(html, isSVG = false) {
             return;
         append(new ServerText(unescape(raw)));
     }
-    /** Consume `<tag attr="v" …>` starting at `lt`, returning the offset just past it. */
+    /** Consume `<tag attr="v" ...>` starting at `lt`, returning the offset just past it. */
     function openTag(lt) {
         const nameEnd = /[\s/>]/.exec(html.slice(lt + 1));
         if (!nameEnd)
@@ -132,7 +132,7 @@ export function parseTemplate(html, isSVG = false) {
                 throw new TemplateParseError(`malformed attribute at ${j}`);
             if (html[j] === '=') {
                 // The serializer always quotes, so an unquoted value means the input did not
-                // come from it — refuse rather than guess.
+                // come from it: refuse rather than guess.
                 if (html[j + 1] !== '"') {
                     throw new TemplateParseError(`attribute ${name} must have a double-quoted value`);
                 }