@llui/dom 0.0.26 → 0.0.27

package/dist/dom-env.d.ts

@@ -57,12 +57,14 @@ export interface DomEnv {
      * runtimes where no real document exists (detached linkedom, empty
      * shadow root, etc.) can safely return `null` here.
      *
-     * Optional at the interface level so pre-existing consumer envs
-     * constructed by hand continue to type-check; a portal call site
-     * with a string target falls back to returning no nodes when the
-     * method is absent.
+     * Required — making this mandatory on the interface means a custom
+     * env that forgets to wire up selector resolution fails compile
+     * instead of silently falling back to `globalThis.document` at
+     * render time (which would crash under Cloudflare Workers + other
+     * strict-isolate runtimes). The three first-party envs
+     * (`browserEnv`, `jsdomEnv`, `linkedomEnv`) all implement it.
      */
-    querySelector?(selector: string): Element | null;
+    querySelector(selector: string): Element | null;
 }
 /**
  * Wrap the browser globals as a `DomEnv`. Used as the default env for

package/dist/dom-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom-env.d.ts","sourceRoot":"","sources":["../src/dom-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,MAAM;IAErB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACjD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACpC,sBAAsB,IAAI,gBAAgB,CAAA;IAC1C;;;;;OAKG;IACH,WAAW,IAAI,KAAK,CAAA;IAKpB,QAAQ,CAAC,OAAO,EAAE,OAAO,OAAO,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,OAAO,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAA;IACxC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,mBAAmB,CAAA;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,UAAU,CAAA;IAGtC,QAAQ,CAAC,UAAU,EAAE,OAAO,UAAU,CAAA;IAEtC;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAA;IAEjD;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAQjD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA8CnC"}
+{"version":3,"file":"dom-env.d.ts","sourceRoot":"","sources":["../src/dom-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,MAAM;IAErB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACjD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACpC,sBAAsB,IAAI,gBAAgB,CAAA;IAC1C;;;;;OAKG;IACH,WAAW,IAAI,KAAK,CAAA;IAKpB,QAAQ,CAAC,OAAO,EAAE,OAAO,OAAO,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,OAAO,CAAA;IAChC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,gBAAgB,CAAA;IAClD,QAAQ,CAAC,WAAW,EAAE,OAAO,WAAW,CAAA;IACxC,QAAQ,CAAC,mBAAmB,EAAE,OAAO,mBAAmB,CAAA;IACxD,QAAQ,CAAC,UAAU,EAAE,OAAO,UAAU,CAAA;IAGtC,QAAQ,CAAC,UAAU,EAAE,OAAO,UAAU,CAAA;IAEtC;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAA;IAEjD;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAQhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,IAAI,MAAM,CA8CnC"}

package/dist/dom-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"dom-env.js","sourceRoot":"","sources":["../src/dom-env.ts"],"names":[],"mappings":"AAmFA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU;IACxB,8DAA8D;IAC9D,mEAAmE;IACnE,0DAA0D;IAC1D,OAAO;QACL,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC;QACnD,eAAe,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC;QAC/D,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC;QACvD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC;QACrD,sBAAsB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,sBAAsB,EAAE;QAC/D,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE;QACzC,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,IAAI;YACN,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,IAAI;YACN,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,gBAAgB;YAClB,OAAO,gBAAgB,CAAA;QACzB,CAAC;QACD,IAAI,WAAW;YACb,OAAO,WAAW,CAAA;QACpB,CAAC;QACD,IAAI,mBAAmB;YACrB,OAAO,mBAAmB,CAAA;QAC5B,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;YACnD,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;YACzB,OAAO,QAAQ,CAAC,OAAO,CAAA;QACzB,CAAC;QACD,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;QAC7D,SAAS,EAAE,IAAI;KAChB,CAAA;AACH,CAAC","sourcesContent":["/**\n * Minimal DOM surface that `@llui/dom`'s internals depend on. Passed to\n * `mountApp` / `hydrateApp` / `renderToString` as a context object so\n * the runtime never reaches for `globalThis.document` directly.\n *\n * Why an injected shape instead of a global shim:\n *\n * 1. **Bundler-friendly.** A Cloudflare Worker that imports\n *    `@llui/dom/ssr/linkedom` reaches only linkedom via its module\n *    graph. No `await import('jsdom')` appears in reachable source,\n *    so rollup doesn't inline the 9 MiB jsdom bundle.\n * 2. **Concurrency-safe.** Two `renderToString` calls can pass\n *    different envs; no process-level singleton to collide on.\n * 3. **Strict-isolate safe.** No `globalThis[key] = ...` mutation —\n *    Cloudflare workerd and Deno strict modes forbid it.\n *\n * The surface is deliberately narrow: exactly the methods and\n * constructors the runtime touches. Grep `document\\.` /\n * `instanceof (HTMLElement|Element|...)` inside `@llui/dom/src` for\n * the exhaustive set.\n */\nexport interface DomEnv {\n  // ── Factories ────────────────────────────────────────────────────\n  createElement(tag: string): Element\n  createElementNS(ns: string, tag: string): Element\n  createTextNode(text: string): Text\n  createComment(text: string): Comment\n  createDocumentFragment(): DocumentFragment\n  /**\n   * Used by `each()`'s fast clear/bulk-remove paths to delete a range\n   * of siblings in one call. SSR adapters that don't need those paths\n   * (jsdom + linkedom both do) can stub — the runtime tolerates a\n   * missing range during SSR render, which never hits the bulk paths.\n   */\n  createRange(): Range\n\n  // ── Node / element constructors ─────────────────────────────────\n  // Exposed for `instanceof` checks in binding targeting + for any\n  // rare site that needs to construct a node type directly.\n  readonly Element: typeof Element\n  readonly Node: typeof Node\n  readonly Text: typeof Text\n  readonly Comment: typeof Comment\n  readonly DocumentFragment: typeof DocumentFragment\n  readonly HTMLElement: typeof HTMLElement\n  readonly HTMLTemplateElement: typeof HTMLTemplateElement\n  readonly ShadowRoot: typeof ShadowRoot\n\n  // ── Event constructor ───────────────────────────────────────────\n  readonly MouseEvent: typeof MouseEvent\n\n  /**\n   * Parse an HTML fragment string into a `DocumentFragment`. Used by\n   * `unsafeHtml()`. Browsers and jsdom parse via template-element\n   * innerHTML; linkedom has its own fragment parser. Adapter chooses\n   * the right mechanism.\n   */\n  parseHtmlFragment(html: string): DocumentFragment\n\n  /**\n   * Resolve a CSS selector against the env's root document. Used by\n   * `portal()` to locate its target when `opts.target` is a string.\n   *\n   * Returns `null` when the selector doesn't match — portal callers\n   * treat a null target as a no-op (render nothing), so adapters on\n   * runtimes where no real document exists (detached linkedom, empty\n   * shadow root, etc.) can safely return `null` here.\n   *\n   * Optional at the interface level so pre-existing consumer envs\n   * constructed by hand continue to type-check; a portal call site\n   * with a string target falls back to returning no nodes when the\n   * method is absent.\n   */\n  querySelector?(selector: string): Element | null\n\n  /**\n   * @internal Lets hot-path code (e.g. `el-split.ts`'s template-clone)\n   * skip env indirection when the env wraps the browser globals. Only\n   * set by `browserEnv()`.\n   */\n  readonly isBrowser?: boolean\n}\n\n/**\n * Wrap the browser globals as a `DomEnv`. Used as the default env for\n * `mountApp` / `hydrateApp` on the client.\n *\n * The returned object delegates to `globalThis.document` / `globalThis.X`\n * lazily — evaluating `browserEnv()` on a server process before a DOM\n * exists is safe because the delegation only dereferences the globals\n * when a method is actually called.\n *\n * Never mutates `globalThis`. A process with no browser globals that\n * invokes one of the factory methods gets a `TypeError` / `ReferenceError`\n * at the call site — which is correct: you're trying to build DOM on a\n * runtime that has no DOM.\n */\nexport function browserEnv(): DomEnv {\n  // Evaluate globals lazily through getters so module-load on a\n  // DOM-less process doesn't throw. Hot client code is still cheap —\n  // V8/SpiderMonkey inline the getter after the first call.\n  return {\n    createElement: (tag) => document.createElement(tag),\n    createElementNS: (ns, tag) => document.createElementNS(ns, tag),\n    createTextNode: (text) => document.createTextNode(text),\n    createComment: (text) => document.createComment(text),\n    createDocumentFragment: () => document.createDocumentFragment(),\n    createRange: () => document.createRange(),\n    get Element() {\n      return Element\n    },\n    get Node() {\n      return Node\n    },\n    get Text() {\n      return Text\n    },\n    get Comment() {\n      return Comment\n    },\n    get DocumentFragment() {\n      return DocumentFragment\n    },\n    get HTMLElement() {\n      return HTMLElement\n    },\n    get HTMLTemplateElement() {\n      return HTMLTemplateElement\n    },\n    get ShadowRoot() {\n      return ShadowRoot\n    },\n    get MouseEvent() {\n      return MouseEvent\n    },\n    parseHtmlFragment: (html) => {\n      const template = document.createElement('template')\n      template.innerHTML = html\n      return template.content\n    },\n    querySelector: (selector) => document.querySelector(selector),\n    isBrowser: true,\n  }\n}\n"]}
+{"version":3,"file":"dom-env.js","sourceRoot":"","sources":["../src/dom-env.ts"],"names":[],"mappings":"AAqFA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU;IACxB,8DAA8D;IAC9D,mEAAmE;IACnE,0DAA0D;IAC1D,OAAO;QACL,aAAa,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC;QACnD,eAAe,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC;QAC/D,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC;QACvD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC;QACrD,sBAAsB,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,sBAAsB,EAAE;QAC/D,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE;QACzC,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,IAAI;YACN,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,IAAI;YACN,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,OAAO;YACT,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,IAAI,gBAAgB;YAClB,OAAO,gBAAgB,CAAA;QACzB,CAAC;QACD,IAAI,WAAW;YACb,OAAO,WAAW,CAAA;QACpB,CAAC;QACD,IAAI,mBAAmB;YACrB,OAAO,mBAAmB,CAAA;QAC5B,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,iBAAiB,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;YACnD,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAA;YACzB,OAAO,QAAQ,CAAC,OAAO,CAAA;QACzB,CAAC;QACD,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;QAC7D,SAAS,EAAE,IAAI;KAChB,CAAA;AACH,CAAC","sourcesContent":["/**\n * Minimal DOM surface that `@llui/dom`'s internals depend on. Passed to\n * `mountApp` / `hydrateApp` / `renderToString` as a context object so\n * the runtime never reaches for `globalThis.document` directly.\n *\n * Why an injected shape instead of a global shim:\n *\n * 1. **Bundler-friendly.** A Cloudflare Worker that imports\n *    `@llui/dom/ssr/linkedom` reaches only linkedom via its module\n *    graph. No `await import('jsdom')` appears in reachable source,\n *    so rollup doesn't inline the 9 MiB jsdom bundle.\n * 2. **Concurrency-safe.** Two `renderToString` calls can pass\n *    different envs; no process-level singleton to collide on.\n * 3. **Strict-isolate safe.** No `globalThis[key] = ...` mutation —\n *    Cloudflare workerd and Deno strict modes forbid it.\n *\n * The surface is deliberately narrow: exactly the methods and\n * constructors the runtime touches. Grep `document\\.` /\n * `instanceof (HTMLElement|Element|...)` inside `@llui/dom/src` for\n * the exhaustive set.\n */\nexport interface DomEnv {\n  // ── Factories ────────────────────────────────────────────────────\n  createElement(tag: string): Element\n  createElementNS(ns: string, tag: string): Element\n  createTextNode(text: string): Text\n  createComment(text: string): Comment\n  createDocumentFragment(): DocumentFragment\n  /**\n   * Used by `each()`'s fast clear/bulk-remove paths to delete a range\n   * of siblings in one call. SSR adapters that don't need those paths\n   * (jsdom + linkedom both do) can stub — the runtime tolerates a\n   * missing range during SSR render, which never hits the bulk paths.\n   */\n  createRange(): Range\n\n  // ── Node / element constructors ─────────────────────────────────\n  // Exposed for `instanceof` checks in binding targeting + for any\n  // rare site that needs to construct a node type directly.\n  readonly Element: typeof Element\n  readonly Node: typeof Node\n  readonly Text: typeof Text\n  readonly Comment: typeof Comment\n  readonly DocumentFragment: typeof DocumentFragment\n  readonly HTMLElement: typeof HTMLElement\n  readonly HTMLTemplateElement: typeof HTMLTemplateElement\n  readonly ShadowRoot: typeof ShadowRoot\n\n  // ── Event constructor ───────────────────────────────────────────\n  readonly MouseEvent: typeof MouseEvent\n\n  /**\n   * Parse an HTML fragment string into a `DocumentFragment`. Used by\n   * `unsafeHtml()`. Browsers and jsdom parse via template-element\n   * innerHTML; linkedom has its own fragment parser. Adapter chooses\n   * the right mechanism.\n   */\n  parseHtmlFragment(html: string): DocumentFragment\n\n  /**\n   * Resolve a CSS selector against the env's root document. Used by\n   * `portal()` to locate its target when `opts.target` is a string.\n   *\n   * Returns `null` when the selector doesn't match — portal callers\n   * treat a null target as a no-op (render nothing), so adapters on\n   * runtimes where no real document exists (detached linkedom, empty\n   * shadow root, etc.) can safely return `null` here.\n   *\n   * Required — making this mandatory on the interface means a custom\n   * env that forgets to wire up selector resolution fails compile\n   * instead of silently falling back to `globalThis.document` at\n   * render time (which would crash under Cloudflare Workers + other\n   * strict-isolate runtimes). The three first-party envs\n   * (`browserEnv`, `jsdomEnv`, `linkedomEnv`) all implement it.\n   */\n  querySelector(selector: string): Element | null\n\n  /**\n   * @internal Lets hot-path code (e.g. `el-split.ts`'s template-clone)\n   * skip env indirection when the env wraps the browser globals. Only\n   * set by `browserEnv()`.\n   */\n  readonly isBrowser?: boolean\n}\n\n/**\n * Wrap the browser globals as a `DomEnv`. Used as the default env for\n * `mountApp` / `hydrateApp` on the client.\n *\n * The returned object delegates to `globalThis.document` / `globalThis.X`\n * lazily — evaluating `browserEnv()` on a server process before a DOM\n * exists is safe because the delegation only dereferences the globals\n * when a method is actually called.\n *\n * Never mutates `globalThis`. A process with no browser globals that\n * invokes one of the factory methods gets a `TypeError` / `ReferenceError`\n * at the call site — which is correct: you're trying to build DOM on a\n * runtime that has no DOM.\n */\nexport function browserEnv(): DomEnv {\n  // Evaluate globals lazily through getters so module-load on a\n  // DOM-less process doesn't throw. Hot client code is still cheap —\n  // V8/SpiderMonkey inline the getter after the first call.\n  return {\n    createElement: (tag) => document.createElement(tag),\n    createElementNS: (ns, tag) => document.createElementNS(ns, tag),\n    createTextNode: (text) => document.createTextNode(text),\n    createComment: (text) => document.createComment(text),\n    createDocumentFragment: () => document.createDocumentFragment(),\n    createRange: () => document.createRange(),\n    get Element() {\n      return Element\n    },\n    get Node() {\n      return Node\n    },\n    get Text() {\n      return Text\n    },\n    get Comment() {\n      return Comment\n    },\n    get DocumentFragment() {\n      return DocumentFragment\n    },\n    get HTMLElement() {\n      return HTMLElement\n    },\n    get HTMLTemplateElement() {\n      return HTMLTemplateElement\n    },\n    get ShadowRoot() {\n      return ShadowRoot\n    },\n    get MouseEvent() {\n      return MouseEvent\n    },\n    parseHtmlFragment: (html) => {\n      const template = document.createElement('template')\n      template.innerHTML = html\n      return template.content\n    },\n    querySelector: (selector) => document.querySelector(selector),\n    isBrowser: true,\n  }\n}\n"]}

package/dist/primitives/portal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/primitives/portal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIhD,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,CAmDlD"}
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/primitives/portal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIhD,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,CAuClD"}

package/dist/primitives/portal.js

@@ -3,26 +3,12 @@ import { createLifetime, addDisposer } from '../lifetime.js';
 export function portal(opts) {
     const ctx = getRenderContext('portal');
     const parentLifetime = ctx.rootLifetime;
-    // Resolve a string target against the current env's document.
-    // `ctx.dom.querySelector` is present on every env shipped by
-    // `@llui/dom` (browserEnv, jsdomEnv, linkedomEnv). For a user-built
-    // env that predates this method we fall back to `globalThis.document`,
-    // and if THAT is also absent — which is exactly the Cloudflare
-    // Workers + linkedom-with-stale-env case portal used to crash on —
-    // we return [] instead of throwing. Portal is a client concept; SSR
-    // silently skipping the resolution is the right "no-op" behavior.
-    let target = null;
-    if (typeof opts.target === 'string') {
-        if (ctx.dom.querySelector) {
-            target = ctx.dom.querySelector(opts.target);
-        }
-        else if (typeof document !== 'undefined') {
-            target = document.querySelector(opts.target);
-        }
-    }
-    else {
-        target = opts.target;
-    }
+    // `DomEnv.querySelector` is a required method — see dom-env.ts.
+    // Custom envs that don't implement it fail TS compile; at runtime
+    // every LLui-shipped env resolves against its own document, which
+    // keeps portal safe on both client and SSR (returns `null` →
+    // no-op when the target is unreachable).
+    const target = typeof opts.target === 'string' ? ctx.dom.querySelector(opts.target) : opts.target;
     if (!target) {
         return [];
     }

package/dist/primitives/portal.js.map

@@ -1 +1 @@
-{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/primitives/portal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC7F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5D,MAAM,UAAU,MAAM,CAAC,IAAmB;IACxC,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,cAAc,GAAG,GAAG,CAAC,YAAY,CAAA;IAEvC,8DAA8D;IAC9D,6DAA6D;IAC7D,oEAAoE;IACpE,uEAAuE;IACvE,+DAA+D;IAC/D,mEAAmE;IACnE,oEAAoE;IACpE,kEAAkE;IAClE,IAAI,MAAM,GAAmB,IAAI,CAAA;IACjC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7C,CAAC;aAAM,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IACtB,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,cAAc,CAAC,CAAA;IAClD,WAAW,CAAC,KAAK,GAAG,QAAQ,CAAA;IAC5B,MAAM,QAAQ,GAAG,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAiB,EAAE,CAAA;IACpF,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,kBAAkB,EAAE,CAAA;IACpB,yBAAyB;IACzB,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,qDAAqD;IACrD,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC/B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,sEAAsE;IACtE,OAAO,EAAE,CAAA;AACX,CAAC","sourcesContent":["import type { PortalOptions } from '../types.js'\nimport { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js'\nimport { createLifetime, addDisposer } from '../lifetime.js'\n\nexport function portal(opts: PortalOptions): Node[] {\n  const ctx = getRenderContext('portal')\n  const parentLifetime = ctx.rootLifetime\n\n  // Resolve a string target against the current env's document.\n  // `ctx.dom.querySelector` is present on every env shipped by\n  // `@llui/dom` (browserEnv, jsdomEnv, linkedomEnv). For a user-built\n  // env that predates this method we fall back to `globalThis.document`,\n  // and if THAT is also absent — which is exactly the Cloudflare\n  // Workers + linkedom-with-stale-env case portal used to crash on —\n  // we return [] instead of throwing. Portal is a client concept; SSR\n  // silently skipping the resolution is the right \"no-op\" behavior.\n  let target: Element | null = null\n  if (typeof opts.target === 'string') {\n    if (ctx.dom.querySelector) {\n      target = ctx.dom.querySelector(opts.target)\n    } else if (typeof document !== 'undefined') {\n      target = document.querySelector(opts.target)\n    }\n  } else {\n    target = opts.target\n  }\n\n  if (!target) {\n    return []\n  }\n\n  const portalScope = createLifetime(parentLifetime)\n  portalScope._kind = 'portal'\n  const buildCtx = { ...ctx, rootLifetime: portalScope, container: target as Element }\n  setRenderContext(buildCtx)\n  const nodes = opts.render()\n  clearRenderContext()\n  // Restore parent context\n  setRenderContext(ctx)\n\n  for (const node of nodes) {\n    target.appendChild(node)\n  }\n\n  // On scope disposal, remove portal nodes from target\n  addDisposer(portalScope, () => {\n    for (const node of nodes) {\n      if (node.parentNode === target) {\n        target.removeChild(node)\n      }\n    }\n  })\n\n  // Portal returns nothing to the parent DOM — nodes live in the target\n  return []\n}\n"]}
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/primitives/portal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC7F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5D,MAAM,UAAU,MAAM,CAAC,IAAmB;IACxC,MAAM,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,cAAc,GAAG,GAAG,CAAC,YAAY,CAAA;IAEvC,gEAAgE;IAChE,kEAAkE;IAClE,kEAAkE;IAClE,6DAA6D;IAC7D,yCAAyC;IACzC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;IAEjG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,cAAc,CAAC,CAAA;IAClD,WAAW,CAAC,KAAK,GAAG,QAAQ,CAAA;IAC5B,MAAM,QAAQ,GAAG,EAAE,GAAG,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAiB,EAAE,CAAA;IACpF,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,kBAAkB,EAAE,CAAA;IACpB,yBAAyB;IACzB,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAED,qDAAqD;IACrD,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE;QAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;gBAC/B,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,sEAAsE;IACtE,OAAO,EAAE,CAAA;AACX,CAAC","sourcesContent":["import type { PortalOptions } from '../types.js'\nimport { getRenderContext, setRenderContext, clearRenderContext } from '../render-context.js'\nimport { createLifetime, addDisposer } from '../lifetime.js'\n\nexport function portal(opts: PortalOptions): Node[] {\n  const ctx = getRenderContext('portal')\n  const parentLifetime = ctx.rootLifetime\n\n  // `DomEnv.querySelector` is a required method — see dom-env.ts.\n  // Custom envs that don't implement it fail TS compile; at runtime\n  // every LLui-shipped env resolves against its own document, which\n  // keeps portal safe on both client and SSR (returns `null` →\n  // no-op when the target is unreachable).\n  const target = typeof opts.target === 'string' ? ctx.dom.querySelector(opts.target) : opts.target\n\n  if (!target) {\n    return []\n  }\n\n  const portalScope = createLifetime(parentLifetime)\n  portalScope._kind = 'portal'\n  const buildCtx = { ...ctx, rootLifetime: portalScope, container: target as Element }\n  setRenderContext(buildCtx)\n  const nodes = opts.render()\n  clearRenderContext()\n  // Restore parent context\n  setRenderContext(ctx)\n\n  for (const node of nodes) {\n    target.appendChild(node)\n  }\n\n  // On scope disposal, remove portal nodes from target\n  addDisposer(portalScope, () => {\n    for (const node of nodes) {\n      if (node.parentNode === target) {\n        target.removeChild(node)\n      }\n    }\n  })\n\n  // Portal returns nothing to the parent DOM — nodes live in the target\n  return []\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/dom",
-  "version": "0.0.26",
+  "version": "0.0.27",
   "type": "module",
   "sideEffects": false,
   "exports": {