mates-fullstack 1.0.0-beta.1

package/dist/ssr-globals.js

@@ -0,0 +1,1010 @@
+/**
+ * mates-fullstack — ssr-globals.ts
+ *
+ * Install stateless no-op browser global stubs ONCE at boot.
+ *
+ * Why this exists:
+ *   lit-html reads `const r = document` at module parse time.
+ *   Mates CSS-in-JS calls `document.adoptedStyleSheets` at module init.
+ *   Mates calls `customElements.define("x-view", ...)` at module init.
+ *   User code may accidentally read `window.innerWidth` outside `onMount`.
+ *
+ *   Without stubs, importing mates in a pure Node.js environment throws
+ *   "document is not defined".
+ *
+ * Design rules:
+ *   - Set ONCE at boot — never swapped per request (unlike happy-dom).
+ *   - Stateless — every stub returns a predictable no-op value.
+ *     No internal maps, no accumulation, no side effects.
+ *   - Idempotent — safe to call multiple times.
+ *   - Only sets globals that are undefined — won't overwrite a real browser or
+ *     a happy-dom window if one is already present.
+ *   - Not a full polyfill — just enough to prevent crashes.
+ *
+ * App code that needs real values during SSR should use isSSR() guards:
+ *   const width = isSSR() ? 1024 : window.innerWidth;
+ */
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+const noop = () => { };
+const noopReturn = (v) => () => v;
+// ─── Comprehensive mock element factory ──────────────────────────────────────
+//
+// Returns an object that satisfies most common DOM Element property accesses.
+// All methods are no-ops. All getters return null/0/[] as appropriate.
+// The object is NOT an instance of any class — it's a plain object with
+// duck-typed DOM properties. This is intentional: instanceof checks are
+// handled by the separate class stubs (e.g., HTMLElementStub).
+//
+// document.createElement() returns one of these. Custom element constructors
+// (like x-x's Component) create their own instances via `extends HTMLElement`.
+const _mockNodeProto = {
+    // Node properties
+    nodeType: 1,
+    nodeName: "DIV",
+    tagName: "DIV",
+    baseURI: "http://localhost/",
+    ownerDocument: null,
+    parentNode: null,
+    parentElement: null,
+    childNodes: [],
+    children: [],
+    firstChild: null,
+    lastChild: null,
+    nextSibling: null,
+    previousSibling: null,
+    textContent: "",
+    nodeValue: null,
+    isConnected: false,
+    // Element properties
+    innerHTML: "",
+    outerHTML: "",
+    id: "",
+    className: "",
+    classList: {
+        add: noop,
+        remove: noop,
+        contains: noopReturn(false),
+        toggle: noopReturn(false),
+        replace: noop,
+        item: noopReturn(null),
+        entries: noopReturn([]),
+        keys: noopReturn([]),
+        values: noopReturn([]),
+        forEach: noop,
+        length: 0,
+        toString: noopReturn(""),
+        value: "",
+    },
+    style: {},
+    dataset: {},
+    attributes: { length: 0 },
+    tabIndex: -1,
+    dir: "",
+    hidden: false,
+    lang: "",
+    title: "",
+    slot: "",
+    scrollTop: 0,
+    scrollLeft: 0,
+    scrollWidth: 0,
+    scrollHeight: 0,
+    clientTop: 0,
+    clientLeft: 0,
+    clientWidth: 0,
+    clientHeight: 0,
+    offsetTop: 0,
+    offsetLeft: 0,
+    offsetWidth: 0,
+    offsetHeight: 0,
+    offsetParent: null,
+    localName: "div",
+    namespaceURI: "http://www.w3.org/1999/xhtml",
+    prefix: null,
+    // Content for <template> elements — should be a DocumentFragment
+    content: null,
+    // Methods
+    setAttribute: noop,
+    getAttribute: noopReturn(null),
+    getAttributeNames: noopReturn([]),
+    hasAttribute: noopReturn(false),
+    hasAttributes: noopReturn(false),
+    removeAttribute: noop,
+    toggleAttribute: noopReturn(false),
+    setAttributeNS: noop,
+    getAttributeNS: noopReturn(null),
+    removeAttributeNS: noop,
+    addEventListener: noop,
+    removeEventListener: noop,
+    dispatchEvent: noopReturn(false),
+    appendChild: function (child) {
+        this.childNodes.push(child);
+        if (this.children)
+            this.children.push(child);
+        child.parentNode = this;
+        return child;
+    },
+    removeChild: function (child) {
+        const idx = this.childNodes.indexOf(child);
+        if (idx !== -1)
+            this.childNodes.splice(idx, 1);
+        return child;
+    },
+    insertBefore: function (child, _ref) {
+        this.childNodes.push(child);
+        child.parentNode = this;
+        return child;
+    },
+    replaceChild: function (child, old) {
+        const idx = this.childNodes.indexOf(old);
+        if (idx !== -1)
+            this.childNodes.splice(idx, 1, child);
+        return old;
+    },
+    contains: noopReturn(false),
+    hasChildNodes: noopReturn(false),
+    cloneNode: function (_deep) {
+        // Shallow copy that preserves the prototype shape
+        return { ...this, childNodes: [], children: [] };
+    },
+    isEqualNode: noopReturn(true),
+    isSameNode: function (other) {
+        return this === other;
+    },
+    compareDocumentPosition: noopReturn(0),
+    normalize: noop,
+    closest: noopReturn(null),
+    matches: noopReturn(false),
+    querySelector: noopReturn(null),
+    querySelectorAll: noopReturn([]),
+    getElementsByTagName: noopReturn([]),
+    getElementsByClassName: noopReturn([]),
+    getElementsByName: noopReturn([]),
+    getBoundingClientRect: noopReturn({
+        x: 0,
+        y: 0,
+        width: 0,
+        height: 0,
+        top: 0,
+        right: 0,
+        bottom: 0,
+        left: 0,
+        toJSON: noopReturn(""),
+    }),
+    getClientRects: noopReturn([]),
+    scrollIntoView: noop,
+    scroll: noop,
+    scrollTo: noop,
+    scrollBy: noop,
+    focus: noop,
+    blur: noop,
+    click: noop,
+    insertAdjacentHTML: noop,
+    insertAdjacentElement: noopReturn(null),
+    insertAdjacentText: noop,
+    replaceWith: function (..._args) {
+        if (this.parentNode) {
+            this.parentNode.removeChild(this);
+        }
+    },
+    remove: function () {
+        if (this.parentNode) {
+            this.parentNode.removeChild(this);
+        }
+    },
+    before: noop,
+    after: noop,
+    prepend: noop,
+    append: noop,
+    attachShadow: noopReturn({ mode: "open", host: null }),
+    shadowRoot: null,
+    // Event timing
+    getAnimations: noopReturn(Promise.resolve([])),
+    animate: noopReturn(null),
+    // Form-related (for input elements)
+    value: "",
+    checked: false,
+    disabled: false,
+    name: "",
+    type: "text",
+    form: null,
+    files: null,
+    selectionStart: 0,
+    selectionEnd: 0,
+    validity: { valid: true },
+    validationMessage: "",
+    reportValidity: noopReturn(true),
+    setSelectionRange: noop,
+    select: noop,
+    // SVG properties
+    viewBox: null,
+    preserveAspectRatio: null,
+    toString() {
+        return `[object ${this.tagName || "Element"}]`;
+    },
+};
+function _makeMockNode(tagName = "DIV", namespace = "http://www.w3.org/1999/xhtml") {
+    const el = Object.create(_mockNodeProto);
+    el.nodeName = tagName;
+    el.tagName = tagName;
+    el.localName = tagName.toLowerCase();
+    el.namespaceURI = namespace;
+    el.ownerDocument = el; // circular reference
+    el.content = Object.create(_mockNodeProto);
+    el.content.ownerDocument = el;
+    el.content.childNodes = [];
+    el.content.children = [];
+    return el;
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Install stateless no-op browser global stubs.
+ * Call once at server startup, before importing mates or lit-html.
+ */
+export function installSsrGlobals() {
+    const g = globalThis;
+    const mockBody = _makeMockNode();
+    const mockHead = _makeMockNode();
+    // ── document ────────────────────────────────────────────────────────────────
+    if (typeof g.document === "undefined") {
+        g.document = {
+            // Node creation — lit-html calls these at module parse time
+            createElement: (_tag) => _makeMockNode(),
+            createElementNS: (_ns, _tag) => _makeMockNode(),
+            createComment: (_data) => ({ nodeType: 8, data: _data ?? "" }),
+            createTextNode: (data) => ({ nodeType: 3, data: data ?? "" }),
+            createDocumentFragment: () => _makeMockNode(),
+            createAttribute: (_name) => ({ name: _name, value: "" }),
+            createAttributeNS: (_ns, _name) => ({
+                name: _name,
+                value: "",
+            }),
+            createRange: () => ({
+                setStart: noop,
+                setEnd: noop,
+                selectNode: noop,
+                selectNodeContents: noop,
+                getBoundingClientRect: noopReturn({ x: 0, y: 0, width: 0, height: 0 }),
+                getClientRects: noopReturn([]),
+                commonAncestorContainer: null,
+                startContainer: null,
+                startOffset: 0,
+                endContainer: null,
+                endOffset: 0,
+                collapsed: true,
+                toString: noopReturn(""),
+                cloneRange: noopReturn(null),
+                detach: noop,
+                deleteContents: noop,
+                extractContents: noopReturn(null),
+                insertNode: noop,
+                surroundContents: noop,
+            }),
+            createTreeWalker: () => ({
+                root: _makeMockNode(),
+                whatToShow: 0xffffffff,
+                filter: null,
+                nextNode: noopReturn(null),
+                previousNode: noopReturn(null),
+                firstChild: noopReturn(null),
+                lastChild: noopReturn(null),
+                nextSibling: noopReturn(null),
+                previousSibling: noopReturn(null),
+                parentNode: noopReturn(null),
+                currentNode: null,
+            }),
+            createNodeIterator: () => ({
+                nextNode: noopReturn(null),
+                previousNode: noopReturn(null),
+                detach: noop,
+            }),
+            createEvent: (_type) => ({
+                type: _type,
+                initEvent: noop,
+                preventDefault: noop,
+                stopPropagation: noop,
+            }),
+            createExpression: noopReturn(null),
+            createNSResolver: noopReturn(null),
+            evaluate: noopReturn(null),
+            // Queries
+            querySelector: noopReturn(null),
+            querySelectorAll: noopReturn([]),
+            getElementById: noopReturn(null),
+            getElementsByTagName: noopReturn([]),
+            getElementsByClassName: noopReturn([]),
+            getElementsByName: noopReturn([]),
+            // Selection
+            getSelection: noopReturn(null),
+            caretRangeFromPoint: noopReturn(null),
+            caretPositionFromPoint: noopReturn(null),
+            elementFromPoint: noopReturn(null),
+            elementsFromPoint: noopReturn([]),
+            // Cookie
+            cookie: "",
+            // Common properties
+            body: mockBody,
+            head: mockHead,
+            documentElement: _makeMockNode(),
+            title: "",
+            readyState: "complete",
+            URL: "http://localhost/",
+            documentURI: "http://localhost/",
+            baseURI: "http://localhost/",
+            compatMode: "CSS1Compat",
+            characterSet: "UTF-8",
+            charset: "UTF-8",
+            contentType: "text/html",
+            designMode: "off",
+            dir: "ltr",
+            hidden: false,
+            visibilityState: "visible",
+            lastModified: "",
+            referrer: "",
+            domain: "localhost",
+            location: g.location ?? {
+                href: "http://localhost/",
+                origin: "http://localhost",
+                pathname: "/",
+                search: "",
+                hash: "",
+            },
+            defaultView: g.window ?? null,
+            implementation: {
+                hasFeature: noopReturn(true),
+                createDocumentType: noopReturn(null),
+                createDocument: noopReturn(null),
+                createHTMLDocument: noopReturn(null),
+            },
+            scrollingElement: null,
+            activeElement: mockBody,
+            fullscreenElement: null,
+            pointerLockElement: null,
+            fonts: {
+                ready: Promise.resolve([]),
+                addEventListener: noop,
+                removeEventListener: noop,
+                check: noopReturn(true),
+                load: noopReturn(Promise.resolve([])),
+            },
+            timeline: {
+                currentTime: null,
+            },
+            fgColor: "",
+            linkColor: "",
+            vlinkColor: "",
+            alinkColor: "",
+            bgColor: "",
+            anchors: [],
+            applets: [],
+            forms: [],
+            images: [],
+            links: [],
+            plugins: [],
+            scripts: [],
+            styleSheets: [],
+            embeds: [],
+            // CSS-in-JS: mates calls document.adoptedStyleSheets = [..., sheet]
+            adoptedStyleSheets: [],
+            // Events
+            addEventListener: noop,
+            removeEventListener: noop,
+            dispatchEvent: noopReturn(false),
+            onload: null,
+            onreadystatechange: null,
+            onscroll: null,
+            onresize: null,
+            onclick: null,
+            // importNode — used by lit-html Template construction
+            importNode: (node, _deep) => node,
+            // write — legacy but sometimes used
+            write: noop,
+            writeln: noop,
+            open: noop,
+            close: noop,
+            clear: noop,
+            // focus management
+            hasFocus: noopReturn(false),
+            hasStorageAccess: noopReturn(Promise.resolve(false)),
+            // execCommand (deprecated but used by some editors)
+            execCommand: noopReturn(false),
+            queryCommandSupported: noopReturn(false),
+            queryCommandEnabled: noopReturn(false),
+            queryCommandState: noopReturn(false),
+            queryCommandValue: noopReturn(""),
+        };
+    }
+    // ── CSSStyleSheet ────────────────────────────────────────────────────────────
+    // Mates CSS-in-JS does `new CSSStyleSheet()` at module level.
+    if (typeof g.CSSStyleSheet === "undefined") {
+        g.CSSStyleSheet = class CSSStyleSheetStub {
+            cssRules = [];
+            replaceSync(_text) { }
+            replace(_text) {
+                return Promise.resolve(this);
+            }
+            insertRule(rule, index = 0) {
+                this.cssRules.splice(index, 0, rule);
+                return index;
+            }
+            deleteRule(_index) { }
+        };
+    }
+    // ── window ──────────────────────────────────────────────────────────────────
+    if (typeof g.window === "undefined") {
+        g.window = {
+            // Dimensions — sensible defaults for SSR layout calculations
+            innerWidth: 1024,
+            innerHeight: 768,
+            outerWidth: 1024,
+            outerHeight: 768,
+            devicePixelRatio: 1,
+            scrollX: 0,
+            scrollY: 0,
+            // Screen
+            screen: {
+                width: 1920,
+                height: 1080,
+                availWidth: 1920,
+                availHeight: 1040,
+                colorDepth: 24,
+                pixelDepth: 24,
+                top: 0,
+                left: 0,
+                availTop: 0,
+                availLeft: 0,
+                orientation: {
+                    type: "landscape-primary",
+                    angle: 0,
+                    addEventListener: noop,
+                    removeEventListener: noop,
+                    dispatchEvent: noopReturn(false),
+                },
+            },
+            // Visual viewport
+            visualViewport: {
+                width: 1024,
+                height: 768,
+                scale: 1,
+                offsetLeft: 0,
+                offsetTop: 0,
+                pageLeft: 0,
+                pageTop: 0,
+                addEventListener: noop,
+                removeEventListener: noop,
+                dispatchEvent: noopReturn(false),
+                onresize: null,
+                onscroll: null,
+            },
+            // Security
+            origin: "http://localhost",
+            isSecureContext: false,
+            crossOriginIsolated: false,
+            // Location — SSR sets pathAtom explicitly; this is just a stub
+            location: {
+                href: "http://localhost/",
+                origin: "http://localhost",
+                protocol: "http:",
+                host: "localhost",
+                hostname: "localhost",
+                port: "",
+                pathname: "/",
+                search: "",
+                hash: "",
+                assign: noop,
+                replace: noop,
+                reload: noop,
+            },
+            // History
+            history: {
+                length: 1,
+                pushState: noop,
+                replaceState: noop,
+                go: noop,
+                back: noop,
+                forward: noop,
+                state: null,
+            },
+            // Storage
+            localStorage: {
+                getItem: noopReturn(null),
+                setItem: noop,
+                removeItem: noop,
+                clear: noop,
+                length: 0,
+                key: noopReturn(null),
+            },
+            sessionStorage: {
+                getItem: noopReturn(null),
+                setItem: noop,
+                removeItem: noop,
+                clear: noop,
+                length: 0,
+                key: noopReturn(null),
+            },
+            // Events
+            addEventListener: noop,
+            removeEventListener: noop,
+            dispatchEvent: noopReturn(false),
+            // Timing
+            requestAnimationFrame: (fn) => {
+                // Run on next tick so components don't block
+                setTimeout(fn, 0);
+                return 0;
+            },
+            cancelAnimationFrame: noop,
+            requestIdleCallback: (fn) => {
+                setTimeout(() => fn({ timeRemaining: () => 50, didTimeout: false }), 0);
+                return 0;
+            },
+            cancelIdleCallback: noop,
+            setTimeout: globalThis.setTimeout.bind(globalThis),
+            clearTimeout: globalThis.clearTimeout.bind(globalThis),
+            setInterval: globalThis.setInterval.bind(globalThis),
+            clearInterval: globalThis.clearInterval.bind(globalThis),
+            // Observers — no-op stubs
+            MutationObserver: class {
+                observe() { }
+                disconnect() { }
+                takeRecords() {
+                    return [];
+                }
+            },
+            ResizeObserver: class {
+                observe() { }
+                disconnect() { }
+                unobserve() { }
+            },
+            IntersectionObserver: class {
+                observe() { }
+                disconnect() { }
+                unobserve() { }
+            },
+            // CSS / layout
+            getComputedStyle: (_el) => ({}),
+            matchMedia: (_query) => ({
+                matches: false,
+                media: _query,
+                onchange: null,
+                addListener: noop,
+                removeListener: noop,
+                addEventListener: noop,
+                removeEventListener: noop,
+                dispatchEvent: noopReturn(false),
+            }),
+            // Performance
+            performance: {
+                now: () => Date.now(),
+                mark: noop,
+                measure: noop,
+                clearMarks: noop,
+                clearMeasures: noop,
+                getEntriesByName: noopReturn([]),
+                getEntriesByType: noopReturn([]),
+            },
+            // Navigator
+            navigator: {
+                userAgent: "mates-ssr",
+                language: "en-US",
+                languages: ["en-US"],
+                onLine: true,
+                platform: "server",
+            },
+            // Misc
+            scrollTo: noop,
+            scrollBy: noop,
+            open: noopReturn(null),
+            close: noop,
+            focus: noop,
+            blur: noop,
+            alert: noop,
+            confirm: noopReturn(false),
+            prompt: noopReturn(null),
+            fetch: typeof fetch !== "undefined" ? fetch : undefined,
+            crypto: typeof crypto !== "undefined"
+                ? crypto
+                : {
+                    getRandomValues: (arr) => arr,
+                    randomUUID: () => "ssr-uuid",
+                },
+            // Self-reference
+            get self() {
+                return g.window;
+            },
+            get top() {
+                return g.window;
+            },
+            get parent() {
+                return g.window;
+            },
+            get globalThis() {
+                return g;
+            },
+        };
+        // Also expose window props at globalThis level (how browsers work)
+        if (typeof g.location === "undefined")
+            g.location = g.window.location;
+        if (typeof g.history === "undefined")
+            g.history = g.window.history;
+        if (typeof g.performance === "undefined")
+            g.performance = g.window.performance;
+        if (typeof g.navigator === "undefined")
+            g.navigator = g.window.navigator;
+        if (typeof g.localStorage === "undefined")
+            g.localStorage = g.window.localStorage;
+        if (typeof g.sessionStorage === "undefined")
+            g.sessionStorage = g.window.sessionStorage;
+        if (typeof g.screen === "undefined")
+            g.screen = g.window.screen;
+        if (typeof g.requestAnimationFrame === "undefined")
+            g.requestAnimationFrame = g.window.requestAnimationFrame;
+        if (typeof g.cancelAnimationFrame === "undefined")
+            g.cancelAnimationFrame = g.window.cancelAnimationFrame;
+        if (typeof g.MutationObserver === "undefined")
+            g.MutationObserver = g.window.MutationObserver;
+        if (typeof g.ResizeObserver === "undefined")
+            g.ResizeObserver = g.window.ResizeObserver;
+        if (typeof g.IntersectionObserver === "undefined")
+            g.IntersectionObserver = g.window.IntersectionObserver;
+        if (typeof g.matchMedia === "undefined")
+            g.matchMedia = g.window.matchMedia;
+    }
+    // ── customElements ──────────────────────────────────────────────────────────
+    if (typeof g.customElements === "undefined") {
+        const _registry = new Map();
+        g.customElements = {
+            get: (name) => _registry.get(name),
+            whenDefined: (_name) => Promise.resolve(),
+            upgrade: noop,
+            define(name, constructor, _options) {
+                // Silent no-op on re-registration — same guard as renderer's
+                // _patchCustomElementsDefine()
+                if (_registry.has(name))
+                    return;
+                _registry.set(name, constructor);
+            },
+        };
+    }
+    else if (g.customElements && !g.customElements.__matesSSRGlobalsPatched__) {
+        // customElements already exists — patch define() to be silent on re-register
+        const orig = g.customElements.define.bind(g.customElements);
+        g.customElements.define = function (name, ctor, opts) {
+            if (g.customElements.get(name))
+                return;
+            try {
+                orig(name, ctor, opts);
+            }
+            catch {
+                /* ignore */
+            }
+        };
+        g.customElements.__matesSSRGlobalsPatched__ = true;
+    }
+    // ── DOM class stubs ─────────────────────────────────────────────────────────
+    // Mates registers x-view as `class Component extends HTMLElement`.
+    // Without these, `class Foo extends HTMLElement` throws.
+    // Custom element constructors create instances via `class extends HTMLElement`,
+    // not via `document.createElement()`. The mock elements from _makeMockNode()
+    // are plain objects — they don't extend HTMLElementStub. This is correct
+    // because: (a) custom elements get their prototype from the class, not from
+    // createElement, and (b) plain objects are sufficient for SSR since no DOM
+    // operations actually execute.
+    if (typeof g.HTMLElement === "undefined") {
+        g.HTMLElement = class HTMLElementStub {
+            // ── Node identity ────────────────────────────────────────────────────
+            nodeType = 1;
+            nodeName = "";
+            tagName = "";
+            baseURI = "http://localhost/";
+            ownerDocument = null;
+            parentNode = null;
+            parentElement = null;
+            childNodes = [];
+            children = [];
+            firstChild = null;
+            lastChild = null;
+            nextSibling = null;
+            previousSibling = null;
+            textContent = "";
+            nodeValue = null;
+            isConnected = false;
+            // ── Element content ──────────────────────────────────────────────────
+            innerHTML = "";
+            outerHTML = "";
+            id = "";
+            className = "";
+            classList = {
+                add: noop,
+                remove: noop,
+                contains: noopReturn(false),
+                toggle: noopReturn(false),
+                replace: noop,
+                item: noopReturn(null),
+                addEventListener: noop,
+                removeEventListener: noop,
+                forEach: noop,
+                length: 0,
+                toString: noopReturn(""),
+                value: "",
+            };
+            style = {};
+            dataset = {};
+            attributes = { length: 0 };
+            tabIndex = -1;
+            dir = "";
+            hidden = false;
+            lang = "";
+            slot = "";
+            scrollTop = 0;
+            scrollLeft = 0;
+            offsetTop = 0;
+            offsetLeft = 0;
+            offsetWidth = 0;
+            offsetHeight = 0;
+            offsetParent = null;
+            localName = "";
+            namespaceURI = "http://www.w3.org/1999/xhtml";
+            prefix = null;
+            // ── Accessibility ────────────────────────────────────────────────────
+            role = null;
+            ariaLabel = null;
+            ariaHidden = null;
+            // ── Shadow DOM ────────────────────────────────────────────────────────
+            shadowRoot = null;
+            // ── Methods ────────────────────────────────────────────────────────────
+            addEventListener = noop;
+            removeEventListener = noop;
+            dispatchEvent = noopReturn(false);
+            setAttribute = noop;
+            getAttribute = noopReturn(null);
+            getAttributeNames = noopReturn([]);
+            hasAttribute = noopReturn(false);
+            hasAttributes = noopReturn(false);
+            removeAttribute = noop;
+            toggleAttribute = noopReturn(false);
+            appendChild = function (child) {
+                this.childNodes.push(child);
+                this.children.push(child);
+                child.parentNode = this;
+                return child;
+            };
+            removeChild = function (child) {
+                const idx = this.childNodes.indexOf(child);
+                if (idx !== -1)
+                    this.childNodes.splice(idx, 1);
+                return child;
+            };
+            insertBefore = function (child, _ref) {
+                this.childNodes.push(child);
+                child.parentNode = this;
+                return child;
+            };
+            replaceChild = function (child, old) {
+                const idx = this.childNodes.indexOf(old);
+                if (idx !== -1)
+                    this.childNodes.splice(idx, 1, child);
+                return old;
+            };
+            contains = noopReturn(false);
+            hasChildNodes = noopReturn(false);
+            cloneNode = function (_deep) {
+                return { ...this, childNodes: [], children: [] };
+            };
+            isEqualNode = noopReturn(true);
+            isSameNode = function (other) {
+                return this === other;
+            };
+            compareDocumentPosition = noopReturn(0);
+            normalize = noop;
+            closest = noopReturn(null);
+            matches = noopReturn(false);
+            querySelector = noopReturn(null);
+            querySelectorAll = noopReturn([]);
+            getElementsByTagName = noopReturn([]);
+            getElementsByClassName = noopReturn([]);
+            getBoundingClientRect = noopReturn({
+                x: 0,
+                y: 0,
+                width: 0,
+                height: 0,
+                top: 0,
+                right: 0,
+                bottom: 0,
+                left: 0,
+                toJSON: noopReturn(""),
+            });
+            getClientRects = noopReturn([]);
+            scrollIntoView = noop;
+            scroll = noop;
+            scrollTo = noop;
+            scrollBy = noop;
+            focus = noop;
+            blur = noop;
+            click = noop;
+            insertAdjacentHTML = noop;
+            insertAdjacentElement = noopReturn(null);
+            insertAdjacentText = noop;
+            replaceWith = noop;
+            remove = noop;
+            before = noop;
+            after = noop;
+            prepend = noop;
+            append = noop;
+            attachShadow = function (_init) {
+                const root = { mode: _init?.mode ?? "open", host: this, innerHTML: "" };
+                this.shadowRoot = root;
+                return root;
+            };
+            getAnimations = noopReturn(Promise.resolve([]));
+            animate = noopReturn(null);
+            // Form element properties (for input-like elements)
+            value = "";
+            checked = false;
+            disabled = false;
+            name = "";
+            type = "text";
+            form = null;
+            files = null;
+            validity = { valid: true };
+            validationMessage = "";
+            reportValidity = noopReturn(true);
+            setSelectionRange = noop;
+            select = noop;
+            toString() {
+                return `[object ${this.tagName || "Element"}]`;
+            }
+        };
+    }
+    // ── Element subclass stubs ─────────────────────────────────────────────────
+    // These exist so that `element instanceof HTMLDivElement` doesn't throw.
+    // They share HTMLElementStub's prototype — no separate behavior needed.
+    const HTML_CTORS = [
+        "HTMLDivElement",
+        "HTMLSpanElement",
+        "HTMLParagraphElement",
+        "HTMLAnchorElement",
+        "HTMLImageElement",
+        "HTMLInputElement",
+        "HTMLButtonElement",
+        "HTMLFormElement",
+        "HTMLTextAreaElement",
+        "HTMLSelectElement",
+        "HTMLOptionElement",
+        "HTMLLIElement",
+        "HTMLUListElement",
+        "HTMLOListElement",
+        "HTMLTableElement",
+        "HTMLTableRowElement",
+        "HTMLTableCellElement",
+        "HTMLHeadingElement",
+        "HTMLBRElement",
+        "HTMLHRElement",
+        "HTMLTemplateElement",
+        "HTMLCanvasElement",
+        "HTMLVideoElement",
+        "HTMLAudioElement",
+        "HTMLSourceElement",
+        "HTMLScriptElement",
+        "HTMLStyleElement",
+        "HTMLLinkElement",
+        "HTMLMetaElement",
+        "HTMLTitleElement",
+        "HTMLHeadElement",
+        "HTMLBodyElement",
+        "HTMLHtmlElement",
+        "HTMLIFrameElement",
+        "HTMLLabelElement",
+        "HTMLFieldSetElement",
+        "HTMLLegendElement",
+        "HTMLDataListElement",
+        "HTMLProgressElement",
+        "HTMLMeterElement",
+        "HTMLSlotElement",
+        "HTMLDetailsElement",
+        "HTMLDialogElement",
+        "HTMLMenuElement",
+        "HTMLUnknownElement",
+        "SVGSVGElement",
+        "SVGCircleElement",
+        "SVGRectElement",
+        "SVGLineElement",
+        "SVGPathElement",
+        "SVGTextElement",
+        "SVGGElement",
+        "SVGDefsElement",
+        "SVGUseElement",
+        "SVGImageElement",
+        "SVGSymbolElement",
+    ];
+    for (const name of HTML_CTORS) {
+        if (typeof g[name] === "undefined") {
+            g[name] = g.HTMLElement;
+        }
+    }
+    if (typeof g.SVGElement === "undefined")
+        g.SVGElement = g.HTMLElement;
+    if (typeof g.Element === "undefined")
+        g.Element = g.HTMLElement;
+    if (typeof g.DocumentFragment === "undefined") {
+        g.DocumentFragment = g.HTMLElement;
+    }
+    if (typeof g.Text === "undefined") {
+        g.Text = class TextStub {
+            nodeType = 3;
+            nodeName = "#text";
+            data = "";
+            textContent = "";
+            wholeText = "";
+            splitText = noopReturn({});
+            replaceWholeText = noop;
+        };
+    }
+    if (typeof g.Comment === "undefined") {
+        g.Comment = class CommentStub {
+            nodeType = 8;
+            nodeName = "#comment";
+            data = "";
+            textContent = "";
+        };
+    }
+    if (typeof g.DOMParser === "undefined") {
+        g.DOMParser = class DOMParserStub {
+            parseFromString() {
+                return g.document ?? { querySelector: noopReturn(null) };
+            }
+        };
+    }
+    if (typeof g.Node === "undefined") {
+        g.Node = class NodeStub {
+        };
+        g.Node.ELEMENT_NODE = 1;
+        g.Node.TEXT_NODE = 3;
+        g.Node.COMMENT_NODE = 8;
+        g.Node.DOCUMENT_FRAGMENT_NODE = 11;
+        g.Node.DOCUMENT_POSITION_DISCONNECTED = 1;
+        g.Node.DOCUMENT_POSITION_PRECEDING = 2;
+        g.Node.DOCUMENT_POSITION_FOLLOWING = 4;
+        g.Node.DOCUMENT_POSITION_CONTAINS = 8;
+        g.Node.DOCUMENT_POSITION_CONTAINED_BY = 16;
+        g.Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 32;
+    }
+    if (typeof g.NodeFilter === "undefined") {
+        g.NodeFilter = {
+            SHOW_ALL: 0xffffffff,
+            SHOW_ELEMENT: 1,
+            SHOW_TEXT: 4,
+            SHOW_COMMENT: 128,
+            SHOW_DOCUMENT: 256,
+            SHOW_DOCUMENT_FRAGMENT: 1024,
+            FILTER_ACCEPT: 1,
+            FILTER_REJECT: 2,
+            FILTER_SKIP: 3,
+        };
+    }
+    // ── Event classes ────────────────────────────────────────────────────────────
+    if (typeof g.Event === "undefined") {
+        g.Event = class EventStub {
+            type;
+            bubbles;
+            cancelable;
+            defaultPrevented = false;
+            stopPropagation = noop;
+            preventDefault = noop;
+            stopImmediatePropagation = noop;
+            constructor(type, opts) {
+                this.type = type;
+                this.bubbles = opts?.bubbles ?? false;
+                this.cancelable = opts?.cancelable ?? false;
+            }
+        };
+    }
+    if (typeof g.CustomEvent === "undefined") {
+        g.CustomEvent = class CustomEventStub extends g.Event {
+            detail;
+            constructor(type, opts) {
+                super(type, opts);
+                this.detail = opts?.detail ?? null;
+            }
+        };
+    }
+}
+//# sourceMappingURL=ssr-globals.js.map