@praxisjs/head 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @praxisjs/head
+
+## 0.1.0
+
+### Minor Changes
+
+- 2837664: Initial release of `@praxisjs/head` — reactive document head management via `@Head` class decorator. Supports title, description, canonical, arbitrary meta[], og:_, and twitter:_. Stack-based with automatic cleanup on component unmount.
+
+### Patch Changes
+
+- Updated dependencies [378cc54]
+  - @praxisjs/core@1.7.0
+  - @praxisjs/decorators@1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026-present Mateus Martins
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/head.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=head.test.d.ts.map

package/dist/__tests__/head.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/head.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/head.test.js

@@ -0,0 +1,463 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+// @vitest-environment jsdom
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { signal } from "@praxisjs/core/internal";
+import { StatefulComponent } from "@praxisjs/core";
+import { Head } from "../index";
+import { pushHead, removeHead, _resetHead, headVersion } from "../head-stack";
+beforeEach(() => {
+    document.head.innerHTML = "";
+    _resetHead();
+    document.title = "initial";
+});
+// ─── head-stack unit tests ────────────────────────────────────────────────────
+describe("pushHead / removeHead", () => {
+    it("sets document.title", () => {
+        const id = Symbol();
+        pushHead(id, { title: "Hello" });
+        expect(document.title).toBe("Hello");
+    });
+    it("adds meta name=description", () => {
+        const id = Symbol();
+        pushHead(id, { description: "My desc" });
+        expect(document.querySelector('meta[name="description"]')?.content).toBe("My desc");
+    });
+    it("adds og: meta properties", () => {
+        const id = Symbol();
+        pushHead(id, { og: { title: "OG Title", image: "https://example.com/img.jpg" } });
+        expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("OG Title");
+        expect(document.querySelector('[property="og:image"]')?.getAttribute("content")).toBe("https://example.com/img.jpg");
+    });
+    it("adds twitter: meta tags", () => {
+        const id = Symbol();
+        pushHead(id, { twitter: { card: "summary_large_image", title: "TW" } });
+        expect(document.querySelector('[name="twitter:card"]')?.getAttribute("content")).toBe("summary_large_image");
+        expect(document.querySelector('[name="twitter:title"]')?.getAttribute("content")).toBe("TW");
+    });
+    it("adds canonical link", () => {
+        const id = Symbol();
+        pushHead(id, { canonical: "https://example.com/page" });
+        expect(document.querySelector('link[rel="canonical"]')?.getAttribute("href")).toBe("https://example.com/page");
+    });
+    it("adds arbitrary meta[] by name and property", () => {
+        const id = Symbol();
+        pushHead(id, {
+            meta: [
+                { name: "robots", content: "noindex" },
+                { property: "fb:app_id", content: "12345" },
+            ],
+        });
+        expect(document.querySelector('[name="robots"]')?.getAttribute("content")).toBe("noindex");
+        expect(document.querySelector('[property="fb:app_id"]')?.getAttribute("content")).toBe("12345");
+    });
+    it("updates an existing entry (no duplicate push)", () => {
+        const id = Symbol();
+        pushHead(id, { title: "v1" });
+        pushHead(id, { title: "v2" });
+        expect(document.title).toBe("v2");
+    });
+    it("restores initial title and removes managed metas on removeHead", () => {
+        const id = Symbol();
+        pushHead(id, { title: "Page", description: "Desc" });
+        removeHead(id);
+        expect(document.title).toBe("initial");
+        expect(document.querySelector('meta[name="description"]')).toBeNull();
+    });
+    it("stack: last entry wins; removing it restores the previous one", () => {
+        const a = Symbol();
+        const b = Symbol();
+        pushHead(a, { title: "A", description: "desc-a" });
+        pushHead(b, { title: "B", description: "desc-b" });
+        expect(document.title).toBe("B");
+        removeHead(b);
+        expect(document.title).toBe("A");
+        expect(document.querySelector('meta[name="description"]')?.content).toBe("desc-a");
+    });
+    it("removes all managed metas when stack is empty", () => {
+        const id = Symbol();
+        pushHead(id, { description: "x", og: { title: "y" } });
+        removeHead(id);
+        expect(document.querySelectorAll("[data-praxis-head]").length).toBe(0);
+    });
+    it("removeHead with a non-existent id is a no-op (idx < 0 branch)", () => {
+        const id = Symbol("never-pushed");
+        // _apply() still runs but the stack stays empty
+        expect(() => removeHead(id)).not.toThrow();
+        expect(document.querySelectorAll("[data-praxis-head]").length).toBe(0);
+    });
+    it("_apply restores title to '' when _initialTitle is undefined and stack is empty", () => {
+        // _resetHead leaves _initialTitle = undefined; calling removeHead on a missing id
+        // triggers _apply with an empty stack and undefined _initialTitle → title = "" fallback.
+        const id = Symbol("missing");
+        document.title = "should-be-cleared";
+        removeHead(id); // idx < 0 → no splice; _apply runs → empty stack, _initialTitle = undefined
+        expect(document.title).toBe("");
+    });
+    it("meta tag with neither name nor property is silently skipped", () => {
+        const id = Symbol();
+        pushHead(id, { meta: [{ content: "orphan-content" }] });
+        // Neither _metaName nor _metaProp should be called
+        const all = document.querySelectorAll("[data-praxis-head]");
+        const hasOrphan = Array.from(all).some((el) => el.getAttribute("content") === "orphan-content");
+        expect(hasOrphan).toBe(false);
+        removeHead(id);
+    });
+    it("omits undefined og fields", () => {
+        const id = Symbol();
+        pushHead(id, { og: { title: "T" } });
+        expect(document.querySelector('[property="og:image"]')).toBeNull();
+        expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("T");
+    });
+});
+// ─── SSR guards ───────────────────────────────────────────────────────────────
+describe("SSR guards — no DOM operations when document is undefined", () => {
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it("pushHead is a no-op when document is undefined", () => {
+        const versionBefore = headVersion();
+        vi.stubGlobal("document", undefined);
+        const id = Symbol();
+        expect(() => pushHead(id, { title: "SSR" })).not.toThrow();
+        // headVersion must NOT have changed (function returned early)
+        expect(headVersion()).toBe(versionBefore);
+    });
+    it("removeHead is a no-op when document is undefined", () => {
+        vi.stubGlobal("document", undefined);
+        const id = Symbol();
+        expect(() => removeHead(id)).not.toThrow();
+    });
+    it("_resetHead skips DOM cleanup when document is undefined", () => {
+        vi.stubGlobal("document", undefined);
+        expect(() => _resetHead()).not.toThrow();
+    });
+});
+describe("_resetHead — DOM cleanup", () => {
+    it("removes managed elements from document.head when called with elements present", () => {
+        const id = Symbol();
+        pushHead(id, { title: "Before Reset", description: "desc" });
+        expect(document.querySelectorAll("[data-praxis-head]").length).toBeGreaterThan(0);
+        // Call _resetHead WITHOUT clearing head.innerHTML first — exercises the forEach
+        _resetHead();
+        expect(document.querySelectorAll("[data-praxis-head]").length).toBe(0);
+    });
+});
+// ─── @Head decorator ──────────────────────────────────────────────────────────
+// All decorated classes at module scope for correct TypeScript inference.
+let StaticComp = (() => {
+    let _classDecorators = [Head({ title: "Static Title", description: "Static desc" })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = StatefulComponent;
+    var StaticComp = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            StaticComp = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static { this.__isComponent = true; }
+        static { this.__isStateless = false; }
+        render() { return null; }
+        static {
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return StaticComp = _classThis;
+})();
+let BeforeComp = (() => {
+    let _classDecorators = [Head({ title: "Before" })];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = StatefulComponent;
+    var BeforeComp = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            BeforeComp = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static { this.__isComponent = true; }
+        static { this.__isStateless = false; }
+        render() { return null; }
+        static {
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+    };
+    return BeforeComp = _classThis;
+})();
+describe("@Head decorator — static config", () => {
+    it("applies head config on onMount", () => {
+        const inst = new StaticComp({});
+        inst.onMount?.();
+        expect(document.title).toBe("Static Title");
+        expect(document.querySelector('meta[name="description"]')?.content).toBe("Static desc");
+        inst.onUnmount?.();
+    });
+    it("removes head config on onUnmount", () => {
+        const inst = new BeforeComp({});
+        inst.onMount?.();
+        expect(document.title).toBe("Before");
+        inst.onUnmount?.();
+        expect(document.title).toBe("initial");
+    });
+});
+describe("@Head decorator — reactive config", () => {
+    it("updates document head when signal changes", async () => {
+        const count = signal(0);
+        let ReactiveComp = (() => {
+            let _classDecorators = [Head((self) => ({ title: `Count: ${self.n()}` }))];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            let _classSuper = StatefulComponent;
+            var ReactiveComp = class extends _classSuper {
+                static { _classThis = this; }
+                constructor() {
+                    super(...arguments);
+                    this.n = count;
+                }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    ReactiveComp = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                static { this.__isComponent = true; }
+                static { this.__isStateless = false; }
+                render() { return null; }
+                static {
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return ReactiveComp = _classThis;
+        })();
+        const inst = new ReactiveComp({});
+        inst.onMount?.();
+        expect(document.title).toBe("Count: 0");
+        count.set(5);
+        await Promise.resolve();
+        expect(document.title).toBe("Count: 5");
+        inst.onUnmount?.();
+    });
+    it("stops tracking after onUnmount", async () => {
+        const val = signal("a");
+        let StopComp = (() => {
+            let _classDecorators = [Head((self) => ({ title: self.v() }))];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            let _classSuper = StatefulComponent;
+            var StopComp = class extends _classSuper {
+                static { _classThis = this; }
+                constructor() {
+                    super(...arguments);
+                    this.v = val;
+                }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    StopComp = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                static { this.__isComponent = true; }
+                static { this.__isStateless = false; }
+                render() { return null; }
+                static {
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return StopComp = _classThis;
+        })();
+        const inst = new StopComp({});
+        inst.onMount?.();
+        inst.onUnmount?.();
+        val.set("b");
+        await Promise.resolve();
+        expect(document.title).not.toBe("b");
+    });
+    it("multiple instances — last mounted wins, cleanup restores previous", () => {
+        const t1 = signal("Page A");
+        const t2 = signal("Page B");
+        let CompA = (() => {
+            let _classDecorators = [Head((self) => ({ title: self.t() }))];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            let _classSuper = StatefulComponent;
+            var CompA = class extends _classSuper {
+                static { _classThis = this; }
+                constructor() {
+                    super(...arguments);
+                    this.t = t1;
+                }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    CompA = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                static { this.__isComponent = true; }
+                static { this.__isStateless = false; }
+                render() { return null; }
+                static {
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return CompA = _classThis;
+        })();
+        let CompB = (() => {
+            let _classDecorators = [Head((self) => ({ title: self.t() }))];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            let _classSuper = StatefulComponent;
+            var CompB = class extends _classSuper {
+                static { _classThis = this; }
+                constructor() {
+                    super(...arguments);
+                    this.t = t2;
+                }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    CompB = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                static { this.__isComponent = true; }
+                static { this.__isStateless = false; }
+                render() { return null; }
+                static {
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return CompB = _classThis;
+        })();
+        const a = new CompA({});
+        const b = new CompB({});
+        a.onMount?.();
+        expect(document.title).toBe("Page A");
+        b.onMount?.();
+        expect(document.title).toBe("Page B");
+        b.onUnmount?.();
+        expect(document.title).toBe("Page A");
+        a.onUnmount?.();
+    });
+    it("full og: config is applied reactively", async () => {
+        const slug = signal("hello");
+        let OGComp = (() => {
+            let _classDecorators = [Head((self) => ({
+                    og: { title: `Post: ${self.s()}`, url: `https://site.com/${self.s()}` },
+                }))];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            let _classSuper = StatefulComponent;
+            var OGComp = class extends _classSuper {
+                static { _classThis = this; }
+                constructor() {
+                    super(...arguments);
+                    this.s = slug;
+                }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    OGComp = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                static { this.__isComponent = true; }
+                static { this.__isStateless = false; }
+                render() { return null; }
+                static {
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return OGComp = _classThis;
+        })();
+        const inst = new OGComp({});
+        inst.onMount?.();
+        expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("Post: hello");
+        slug.set("world");
+        await Promise.resolve();
+        expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("Post: world");
+        inst.onUnmount?.();
+    });
+    it("getter is called only when deps change, not on every frame", async () => {
+        const name = signal("Alice");
+        const getter = vi.fn((self) => ({ title: self.n() }));
+        let SpyComp = (() => {
+            let _classDecorators = [Head(getter)];
+            let _classDescriptor;
+            let _classExtraInitializers = [];
+            let _classThis;
+            let _classSuper = StatefulComponent;
+            var SpyComp = class extends _classSuper {
+                static { _classThis = this; }
+                constructor() {
+                    super(...arguments);
+                    this.n = name;
+                }
+                static {
+                    const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+                    __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+                    SpyComp = _classThis = _classDescriptor.value;
+                    if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+                }
+                static { this.__isComponent = true; }
+                static { this.__isStateless = false; }
+                render() { return null; }
+                static {
+                    __runInitializers(_classThis, _classExtraInitializers);
+                }
+            };
+            return SpyComp = _classThis;
+        })();
+        const inst = new SpyComp({});
+        inst.onMount?.();
+        expect(getter).toHaveBeenCalledTimes(1);
+        name.set("Bob");
+        await Promise.resolve();
+        expect(getter).toHaveBeenCalledTimes(2);
+        await Promise.resolve();
+        expect(getter).toHaveBeenCalledTimes(2); // no extra calls
+        inst.onUnmount?.();
+    });
+});
+//# sourceMappingURL=head.test.js.map

package/dist/__tests__/head.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.test.js","sourceRoot":"","sources":["../../src/__tests__/head.test.ts"],"names":[],"mappings":"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"}

package/dist/head-stack.d.ts

@@ -0,0 +1,32 @@
+export interface MetaTag {
+    name?: string;
+    property?: string;
+    content: string;
+}
+export interface HeadConfig {
+    title?: string;
+    description?: string;
+    canonical?: string;
+    meta?: MetaTag[];
+    og?: {
+        title?: string;
+        description?: string;
+        image?: string;
+        url?: string;
+        type?: string;
+        siteName?: string;
+    };
+    twitter?: {
+        card?: string;
+        title?: string;
+        description?: string;
+        image?: string;
+    };
+}
+/** Increments on every head update. Read reactively to subscribe to head changes. */
+export declare const headVersion: import("@praxisjs/shared").Signal<number>;
+export declare function pushHead(id: symbol, config: HeadConfig): void;
+export declare function removeHead(id: symbol): void;
+/** Resets all head state. For use in tests only. */
+export declare function _resetHead(): void;
+//# sourceMappingURL=head-stack.d.ts.map

package/dist/head-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-stack.d.ts","sourceRoot":"","sources":["../src/head-stack.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,EAAE,CAAC,EAAE;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAYD,qFAAqF;AACrF,eAAO,MAAM,WAAW,2CAAY,CAAC;AAErC,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAU7D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK3C;AAiFD,oDAAoD;AACpD,wBAAgB,UAAU,IAAI,IAAI,CAMjC"}

package/dist/head-stack.js

@@ -0,0 +1,111 @@
+import { signal } from "@praxisjs/core/internal";
+const ATTR = "data-praxis-head";
+const _stack = [];
+let _initialTitle;
+/** Increments on every head update. Read reactively to subscribe to head changes. */
+export const headVersion = signal(0);
+export function pushHead(id, config) {
+    if (typeof document === "undefined")
+        return;
+    _initialTitle ??= document.title;
+    const idx = _stack.findIndex((e) => e.id === id);
+    if (idx >= 0) {
+        _stack[idx].config = config;
+    }
+    else {
+        _stack.push({ id, config });
+    }
+    _apply();
+}
+export function removeHead(id) {
+    if (typeof document === "undefined")
+        return;
+    const idx = _stack.findIndex((e) => e.id === id);
+    if (idx >= 0)
+        _stack.splice(idx, 1);
+    _apply();
+}
+function _apply() {
+    headVersion.update((n) => n + 1);
+    document.querySelectorAll(`[${ATTR}]`).forEach((el) => { el.remove(); });
+    const top = _stack.at(-1);
+    if (top === undefined) {
+        document.title = _initialTitle ?? "";
+        return;
+    }
+    const { config } = top;
+    if (config.title != null)
+        document.title = config.title;
+    if (config.description != null)
+        _metaName("description", config.description);
+    if (config.canonical != null)
+        _canonical(config.canonical);
+    for (const tag of config.meta ?? []) {
+        if (tag.property != null)
+            _metaProp(tag.property, tag.content);
+        else if (tag.name != null)
+            _metaName(tag.name, tag.content);
+    }
+    if (config.og != null) {
+        const og = config.og;
+        _applyMap("property", {
+            "og:title": og.title,
+            "og:description": og.description,
+            "og:image": og.image,
+            "og:url": og.url,
+            "og:type": og.type,
+            "og:site_name": og.siteName,
+        });
+    }
+    if (config.twitter != null) {
+        const tw = config.twitter;
+        _applyMap("name", {
+            "twitter:card": tw.card,
+            "twitter:title": tw.title,
+            "twitter:description": tw.description,
+            "twitter:image": tw.image,
+        });
+    }
+}
+function _applyMap(attr, map) {
+    for (const [key, value] of Object.entries(map)) {
+        if (value != null) {
+            if (attr === "name") {
+                _metaName(key, value);
+            }
+            else {
+                _metaProp(key, value);
+            }
+        }
+    }
+}
+function _metaName(name, content) {
+    const el = document.createElement("meta");
+    el.name = name;
+    el.content = content;
+    el.setAttribute(ATTR, "");
+    document.head.appendChild(el);
+}
+function _metaProp(property, content) {
+    const el = document.createElement("meta");
+    el.setAttribute("property", property);
+    el.content = content;
+    el.setAttribute(ATTR, "");
+    document.head.appendChild(el);
+}
+function _canonical(href) {
+    const el = document.createElement("link");
+    el.rel = "canonical";
+    el.href = href;
+    el.setAttribute(ATTR, "");
+    document.head.appendChild(el);
+}
+/** Resets all head state. For use in tests only. */
+export function _resetHead() {
+    _stack.length = 0;
+    _initialTitle = undefined;
+    if (typeof document !== "undefined") {
+        document.querySelectorAll(`[${ATTR}]`).forEach((el) => { el.remove(); });
+    }
+}
+//# sourceMappingURL=head-stack.js.map

package/dist/head-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-stack.js","sourceRoot":"","sources":["../src/head-stack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AA6BjD,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAOhC,MAAM,MAAM,GAAgB,EAAE,CAAC;AAC/B,IAAI,aAAiC,CAAC;AAEtC,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAErC,MAAM,UAAU,QAAQ,CAAC,EAAU,EAAE,MAAkB;IACrD,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,aAAa,KAAK,QAAQ,CAAC,KAAK,CAAC;IACjC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,IAAI,GAAG,IAAI,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC;AACX,CAAC;AAED,SAAS,MAAM;IACb,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,QAAQ,CAAC,KAAK,GAAG,aAAa,IAAI,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAEvB,IAAI,MAAM,CAAC,KAAK,IAAI,IAAI;QAAE,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACxD,IAAI,MAAM,CAAC,WAAW,IAAI,IAAI;QAAE,SAAS,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,SAAS,IAAI,IAAI;QAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAE3D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,GAAG,CAAC,QAAQ,IAAI,IAAI;YAAE,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;aAC1D,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,MAAM,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,UAAU,EAAE;YACpB,UAAU,EAAE,EAAE,CAAC,KAAK;YACpB,gBAAgB,EAAE,EAAE,CAAC,WAAW;YAChC,UAAU,EAAE,EAAE,CAAC,KAAK;YACpB,QAAQ,EAAE,EAAE,CAAC,GAAG;YAChB,SAAS,EAAE,EAAE,CAAC,IAAI;YAClB,cAAc,EAAE,EAAE,CAAC,QAAQ;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1B,SAAS,CAAC,MAAM,EAAE;YAChB,cAAc,EAAE,EAAE,CAAC,IAAI;YACvB,eAAe,EAAE,EAAE,CAAC,KAAK;YACzB,qBAAqB,EAAE,EAAE,CAAC,WAAW;YACrC,eAAe,EAAE,EAAE,CAAC,KAAK;SAC1B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAChB,IAAyB,EACzB,GAAuC;IAEvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;YAClB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;iBAAM,CAAC;gBAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAAC,CAAC;QACjF,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,OAAe;IAC9C,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC;IACf,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC;IACrB,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB,EAAE,OAAe;IAClD,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtC,EAAE,CAAC,OAAO,GAAG,OAAO,CAAC;IACrB,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,EAAE,CAAC,GAAG,GAAG,WAAW,CAAC;IACrB,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC;IACf,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,UAAU;IACxB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAClB,aAAa,GAAG,SAAS,CAAC;IAC1B,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { type RootComponent } from "@praxisjs/core/internal";
+import { type HeadConfig, type MetaTag, headVersion } from "./head-stack";
+export type { HeadConfig, MetaTag };
+export { headVersion };
+export declare function Head(config: HeadConfig | ((self: any) => HeadConfig)): <T extends new (...args: any[]) => RootComponent<Record<string, any>>>(constructor: T, _context: ClassDecoratorContext) => T;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAG,MAAM,yBAAyB,CAAC;AAOtE,OAAO,EAAwB,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhG,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,CAAC;AA4BvB,wBAAgB,IAAI,CAElB,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,UAAU,CAAC,mBAnBZ,GAEtC,0GAsBC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+import { effect } from "@praxisjs/core/internal";
+import { createClassDecorator, ClassBehavior, } from "@praxisjs/decorators";
+import { pushHead, removeHead, headVersion } from "./head-stack";
+export { headVersion };
+class HeadBehavior extends ClassBehavior {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    constructor(getter) {
+        super();
+        this.getter = getter;
+    }
+    create(instance) {
+        const id = Symbol();
+        const getter = this.getter;
+        let stop;
+        return {
+            onMount() {
+                stop = effect(() => {
+                    pushHead(id, getter(instance));
+                });
+            },
+            onUnmount() {
+                stop?.();
+                stop = undefined;
+                removeHead(id);
+            },
+        };
+    }
+}
+export function Head(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+config) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const getter = typeof config === "function" ? config : () => config;
+    return createClassDecorator(new HeadBehavior(getter));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAuB,MAAM,yBAAyB,CAAC;AACtE,OAAO,EACL,oBAAoB,EACpB,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAiC,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,MAAM,YAAa,SAAQ,aAAa;IACtC,8DAA8D;IAC9D,YAA6B,MAAiC;QAC5D,KAAK,EAAE,CAAC;QADmB,WAAM,GAAN,MAAM,CAA2B;IAE9D,CAAC;IAED,MAAM,CAAC,QAAuB;QAC5B,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,IAA8B,CAAC;QAEnC,OAAO;YACL,OAAO;gBACL,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE;oBACjB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACjC,CAAC,CAAC,CAAC;YACL,CAAC;YACD,SAAS;gBACP,IAAI,EAAE,EAAE,CAAC;gBACT,IAAI,GAAG,SAAS,CAAC;gBACjB,UAAU,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;SACF,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,IAAI;AAClB,8DAA8D;AAC9D,MAAgD;IAEhD,8DAA8D;IAC9D,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,UAAU,CAAC,CAAC,CAAE,MAAoC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC;IACnG,OAAO,oBAAoB,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@praxisjs/head",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@praxisjs/core": "1.7.0",
+    "@praxisjs/decorators": "1.1.0",
+    "@praxisjs/shared": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}

package/src/__tests__/head.test.ts

@@ -0,0 +1,322 @@
+// @vitest-environment jsdom
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { signal } from "@praxisjs/core/internal";
+import { StatefulComponent } from "@praxisjs/core";
+
+import { Head } from "../index";
+import { pushHead, removeHead, _resetHead, headVersion } from "../head-stack";
+
+beforeEach(() => {
+  document.head.innerHTML = "";
+  _resetHead();
+  document.title = "initial";
+});
+
+// ─── head-stack unit tests ────────────────────────────────────────────────────
+
+describe("pushHead / removeHead", () => {
+  it("sets document.title", () => {
+    const id = Symbol();
+    pushHead(id, { title: "Hello" });
+    expect(document.title).toBe("Hello");
+  });
+
+  it("adds meta name=description", () => {
+    const id = Symbol();
+    pushHead(id, { description: "My desc" });
+    expect(document.querySelector<HTMLMetaElement>('meta[name="description"]')?.content).toBe("My desc");
+  });
+
+  it("adds og: meta properties", () => {
+    const id = Symbol();
+    pushHead(id, { og: { title: "OG Title", image: "https://example.com/img.jpg" } });
+    expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("OG Title");
+    expect(document.querySelector('[property="og:image"]')?.getAttribute("content")).toBe("https://example.com/img.jpg");
+  });
+
+  it("adds twitter: meta tags", () => {
+    const id = Symbol();
+    pushHead(id, { twitter: { card: "summary_large_image", title: "TW" } });
+    expect(document.querySelector('[name="twitter:card"]')?.getAttribute("content")).toBe("summary_large_image");
+    expect(document.querySelector('[name="twitter:title"]')?.getAttribute("content")).toBe("TW");
+  });
+
+  it("adds canonical link", () => {
+    const id = Symbol();
+    pushHead(id, { canonical: "https://example.com/page" });
+    expect(document.querySelector('link[rel="canonical"]')?.getAttribute("href")).toBe("https://example.com/page");
+  });
+
+  it("adds arbitrary meta[] by name and property", () => {
+    const id = Symbol();
+    pushHead(id, {
+      meta: [
+        { name: "robots", content: "noindex" },
+        { property: "fb:app_id", content: "12345" },
+      ],
+    });
+    expect(document.querySelector('[name="robots"]')?.getAttribute("content")).toBe("noindex");
+    expect(document.querySelector('[property="fb:app_id"]')?.getAttribute("content")).toBe("12345");
+  });
+
+  it("updates an existing entry (no duplicate push)", () => {
+    const id = Symbol();
+    pushHead(id, { title: "v1" });
+    pushHead(id, { title: "v2" });
+    expect(document.title).toBe("v2");
+  });
+
+  it("restores initial title and removes managed metas on removeHead", () => {
+    const id = Symbol();
+    pushHead(id, { title: "Page", description: "Desc" });
+    removeHead(id);
+    expect(document.title).toBe("initial");
+    expect(document.querySelector('meta[name="description"]')).toBeNull();
+  });
+
+  it("stack: last entry wins; removing it restores the previous one", () => {
+    const a = Symbol();
+    const b = Symbol();
+    pushHead(a, { title: "A", description: "desc-a" });
+    pushHead(b, { title: "B", description: "desc-b" });
+    expect(document.title).toBe("B");
+    removeHead(b);
+    expect(document.title).toBe("A");
+    expect(document.querySelector<HTMLMetaElement>('meta[name="description"]')?.content).toBe("desc-a");
+  });
+
+  it("removes all managed metas when stack is empty", () => {
+    const id = Symbol();
+    pushHead(id, { description: "x", og: { title: "y" } });
+    removeHead(id);
+    expect(document.querySelectorAll("[data-praxis-head]").length).toBe(0);
+  });
+
+  it("removeHead with a non-existent id is a no-op (idx < 0 branch)", () => {
+    const id = Symbol("never-pushed");
+    // _apply() still runs but the stack stays empty
+    expect(() => removeHead(id)).not.toThrow();
+    expect(document.querySelectorAll("[data-praxis-head]").length).toBe(0);
+  });
+
+  it("_apply restores title to '' when _initialTitle is undefined and stack is empty", () => {
+    // _resetHead leaves _initialTitle = undefined; calling removeHead on a missing id
+    // triggers _apply with an empty stack and undefined _initialTitle → title = "" fallback.
+    const id = Symbol("missing");
+    document.title = "should-be-cleared";
+    removeHead(id); // idx < 0 → no splice; _apply runs → empty stack, _initialTitle = undefined
+    expect(document.title).toBe("");
+  });
+
+  it("meta tag with neither name nor property is silently skipped", () => {
+    const id = Symbol();
+    pushHead(id, { meta: [{ content: "orphan-content" }] });
+    // Neither _metaName nor _metaProp should be called
+    const all = document.querySelectorAll("[data-praxis-head]");
+    const hasOrphan = Array.from(all).some((el) =>
+      el.getAttribute("content") === "orphan-content",
+    );
+    expect(hasOrphan).toBe(false);
+    removeHead(id);
+  });
+
+  it("omits undefined og fields", () => {
+    const id = Symbol();
+    pushHead(id, { og: { title: "T" } });
+    expect(document.querySelector('[property="og:image"]')).toBeNull();
+    expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("T");
+  });
+});
+
+// ─── SSR guards ───────────────────────────────────────────────────────────────
+
+describe("SSR guards — no DOM operations when document is undefined", () => {
+  afterEach(() => {
+    vi.unstubAllGlobals();
+  });
+
+  it("pushHead is a no-op when document is undefined", () => {
+    const versionBefore = headVersion();
+    vi.stubGlobal("document", undefined);
+    const id = Symbol();
+    expect(() => pushHead(id, { title: "SSR" })).not.toThrow();
+    // headVersion must NOT have changed (function returned early)
+    expect(headVersion()).toBe(versionBefore);
+  });
+
+  it("removeHead is a no-op when document is undefined", () => {
+    vi.stubGlobal("document", undefined);
+    const id = Symbol();
+    expect(() => removeHead(id)).not.toThrow();
+  });
+
+  it("_resetHead skips DOM cleanup when document is undefined", () => {
+    vi.stubGlobal("document", undefined);
+    expect(() => _resetHead()).not.toThrow();
+  });
+});
+
+describe("_resetHead — DOM cleanup", () => {
+  it("removes managed elements from document.head when called with elements present", () => {
+    const id = Symbol();
+    pushHead(id, { title: "Before Reset", description: "desc" });
+    expect(document.querySelectorAll("[data-praxis-head]").length).toBeGreaterThan(0);
+
+    // Call _resetHead WITHOUT clearing head.innerHTML first — exercises the forEach
+    _resetHead();
+    expect(document.querySelectorAll("[data-praxis-head]").length).toBe(0);
+  });
+});
+
+// ─── @Head decorator ──────────────────────────────────────────────────────────
+
+// All decorated classes at module scope for correct TypeScript inference.
+
+@Head({ title: "Static Title", description: "Static desc" })
+class StaticComp extends StatefulComponent {
+  static __isComponent = true as const;
+  static __isStateless = false;
+  render() { return null; }
+}
+
+@Head({ title: "Before" })
+class BeforeComp extends StatefulComponent {
+  static __isComponent = true as const;
+  static __isStateless = false;
+  render() { return null; }
+}
+
+describe("@Head decorator — static config", () => {
+  it("applies head config on onMount", () => {
+    const inst = new StaticComp({});
+    inst.onMount?.();
+    expect(document.title).toBe("Static Title");
+    expect(document.querySelector<HTMLMetaElement>('meta[name="description"]')?.content).toBe("Static desc");
+    inst.onUnmount?.();
+  });
+
+  it("removes head config on onUnmount", () => {
+    const inst = new BeforeComp({});
+    inst.onMount?.();
+    expect(document.title).toBe("Before");
+    inst.onUnmount?.();
+    expect(document.title).toBe("initial");
+  });
+});
+
+describe("@Head decorator — reactive config", () => {
+  it("updates document head when signal changes", async () => {
+    const count = signal(0);
+
+    @Head((self: ReactiveComp) => ({ title: `Count: ${self.n()}` }))
+    class ReactiveComp extends StatefulComponent {
+      static __isComponent = true as const;
+      static __isStateless = false;
+      n = count;
+      render() { return null; }
+    }
+
+    const inst = new ReactiveComp({});
+    inst.onMount?.();
+    expect(document.title).toBe("Count: 0");
+    count.set(5);
+    await Promise.resolve();
+    expect(document.title).toBe("Count: 5");
+    inst.onUnmount?.();
+  });
+
+  it("stops tracking after onUnmount", async () => {
+    const val = signal("a");
+
+    @Head((self: StopComp) => ({ title: self.v() }))
+    class StopComp extends StatefulComponent {
+      static __isComponent = true as const;
+      static __isStateless = false;
+      v = val;
+      render() { return null; }
+    }
+
+    const inst = new StopComp({});
+    inst.onMount?.();
+    inst.onUnmount?.();
+    val.set("b");
+    await Promise.resolve();
+    expect(document.title).not.toBe("b");
+  });
+
+  it("multiple instances — last mounted wins, cleanup restores previous", () => {
+    const t1 = signal("Page A");
+    const t2 = signal("Page B");
+
+    @Head((self: CompA) => ({ title: self.t() }))
+    class CompA extends StatefulComponent {
+      static __isComponent = true as const;
+      static __isStateless = false;
+      t = t1;
+      render() { return null; }
+    }
+
+    @Head((self: CompB) => ({ title: self.t() }))
+    class CompB extends StatefulComponent {
+      static __isComponent = true as const;
+      static __isStateless = false;
+      t = t2;
+      render() { return null; }
+    }
+
+    const a = new CompA({});
+    const b = new CompB({});
+    a.onMount?.();
+    expect(document.title).toBe("Page A");
+    b.onMount?.();
+    expect(document.title).toBe("Page B");
+    b.onUnmount?.();
+    expect(document.title).toBe("Page A");
+    a.onUnmount?.();
+  });
+
+  it("full og: config is applied reactively", async () => {
+    const slug = signal("hello");
+
+    @Head((self: OGComp) => ({
+      og: { title: `Post: ${self.s()}`, url: `https://site.com/${self.s()}` },
+    }))
+    class OGComp extends StatefulComponent {
+      static __isComponent = true as const;
+      static __isStateless = false;
+      s = slug;
+      render() { return null; }
+    }
+
+    const inst = new OGComp({});
+    inst.onMount?.();
+    expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("Post: hello");
+    slug.set("world");
+    await Promise.resolve();
+    expect(document.querySelector('[property="og:title"]')?.getAttribute("content")).toBe("Post: world");
+    inst.onUnmount?.();
+  });
+
+  it("getter is called only when deps change, not on every frame", async () => {
+    const name = signal("Alice");
+    const getter = vi.fn((self: SpyComp) => ({ title: self.n() }));
+
+    @Head(getter)
+    class SpyComp extends StatefulComponent {
+      static __isComponent = true as const;
+      static __isStateless = false;
+      n = name;
+      render() { return null; }
+    }
+
+    const inst = new SpyComp({});
+    inst.onMount?.();
+    expect(getter).toHaveBeenCalledTimes(1);
+    name.set("Bob");
+    await Promise.resolve();
+    expect(getter).toHaveBeenCalledTimes(2);
+    await Promise.resolve();
+    expect(getter).toHaveBeenCalledTimes(2); // no extra calls
+    inst.onUnmount?.();
+  });
+});

package/src/head-stack.ts

@@ -0,0 +1,148 @@
+import { signal } from "@praxisjs/core/internal";
+
+export interface MetaTag {
+  name?: string;
+  property?: string;
+  content: string;
+}
+
+export interface HeadConfig {
+  title?: string;
+  description?: string;
+  canonical?: string;
+  meta?: MetaTag[];
+  og?: {
+    title?: string;
+    description?: string;
+    image?: string;
+    url?: string;
+    type?: string;
+    siteName?: string;
+  };
+  twitter?: {
+    card?: string;
+    title?: string;
+    description?: string;
+    image?: string;
+  };
+}
+
+const ATTR = "data-praxis-head";
+
+interface HeadEntry {
+  id: symbol;
+  config: HeadConfig;
+}
+
+const _stack: HeadEntry[] = [];
+let _initialTitle: string | undefined;
+
+/** Increments on every head update. Read reactively to subscribe to head changes. */
+export const headVersion = signal(0);
+
+export function pushHead(id: symbol, config: HeadConfig): void {
+  if (typeof document === "undefined") return;
+  _initialTitle ??= document.title;
+  const idx = _stack.findIndex((e) => e.id === id);
+  if (idx >= 0) {
+    _stack[idx].config = config;
+  } else {
+    _stack.push({ id, config });
+  }
+  _apply();
+}
+
+export function removeHead(id: symbol): void {
+  if (typeof document === "undefined") return;
+  const idx = _stack.findIndex((e) => e.id === id);
+  if (idx >= 0) _stack.splice(idx, 1);
+  _apply();
+}
+
+function _apply(): void {
+  headVersion.update((n) => n + 1);
+  document.querySelectorAll(`[${ATTR}]`).forEach((el) => { el.remove(); });
+
+  const top = _stack.at(-1);
+  if (top === undefined) {
+    document.title = _initialTitle ?? "";
+    return;
+  }
+
+  const { config } = top;
+
+  if (config.title != null) document.title = config.title;
+  if (config.description != null) _metaName("description", config.description);
+  if (config.canonical != null) _canonical(config.canonical);
+
+  for (const tag of config.meta ?? []) {
+    if (tag.property != null) _metaProp(tag.property, tag.content);
+    else if (tag.name != null) _metaName(tag.name, tag.content);
+  }
+
+  if (config.og != null) {
+    const og = config.og;
+    _applyMap("property", {
+      "og:title": og.title,
+      "og:description": og.description,
+      "og:image": og.image,
+      "og:url": og.url,
+      "og:type": og.type,
+      "og:site_name": og.siteName,
+    });
+  }
+
+  if (config.twitter != null) {
+    const tw = config.twitter;
+    _applyMap("name", {
+      "twitter:card": tw.card,
+      "twitter:title": tw.title,
+      "twitter:description": tw.description,
+      "twitter:image": tw.image,
+    });
+  }
+}
+
+function _applyMap(
+  attr: "name" | "property",
+  map: Record<string, string | undefined>,
+): void {
+  for (const [key, value] of Object.entries(map)) {
+    if (value != null) {
+      if (attr === "name") { _metaName(key, value); } else { _metaProp(key, value); }
+    }
+  }
+}
+
+function _metaName(name: string, content: string): void {
+  const el = document.createElement("meta");
+  el.name = name;
+  el.content = content;
+  el.setAttribute(ATTR, "");
+  document.head.appendChild(el);
+}
+
+function _metaProp(property: string, content: string): void {
+  const el = document.createElement("meta");
+  el.setAttribute("property", property);
+  el.content = content;
+  el.setAttribute(ATTR, "");
+  document.head.appendChild(el);
+}
+
+function _canonical(href: string): void {
+  const el = document.createElement("link");
+  el.rel = "canonical";
+  el.href = href;
+  el.setAttribute(ATTR, "");
+  document.head.appendChild(el);
+}
+
+/** Resets all head state. For use in tests only. */
+export function _resetHead(): void {
+  _stack.length = 0;
+  _initialTitle = undefined;
+  if (typeof document !== "undefined") {
+    document.querySelectorAll(`[${ATTR}]`).forEach((el) => { el.remove(); });
+  }
+}

package/src/index.ts

@@ -0,0 +1,46 @@
+import { effect, type RootComponent  } from "@praxisjs/core/internal";
+import {
+  createClassDecorator,
+  ClassBehavior,
+  type ClassEnhancement,
+} from "@praxisjs/decorators";
+
+import { pushHead, removeHead, type HeadConfig, type MetaTag, headVersion } from "./head-stack";
+
+export type { HeadConfig, MetaTag };
+export { headVersion };
+
+class HeadBehavior extends ClassBehavior {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  constructor(private readonly getter: (self: any) => HeadConfig) {
+    super();
+  }
+
+  create(instance: RootComponent): ClassEnhancement {
+    const id = Symbol();
+    const getter = this.getter;
+    let stop: (() => void) | undefined;
+
+    return {
+      onMount() {
+        stop = effect(() => {
+          pushHead(id, getter(instance));
+        });
+      },
+      onUnmount() {
+        stop?.();
+        stop = undefined;
+        removeHead(id);
+      },
+    };
+  }
+}
+
+export function Head(
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  config: HeadConfig | ((self: any) => HeadConfig),
+) {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const getter = typeof config === "function" ? (config as (self: any) => HeadConfig) : () => config;
+  return createClassDecorator(new HeadBehavior(getter));
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}