@adaas/are-html 0.0.2 → 0.0.4

package/src/engine/AreHTML.lifecycle.ts

@@ -9,8 +9,13 @@ import { AreDirectiveAttribute } from "@adaas/are-html/attributes/AreDirective.a
 import { AreDirectiveFeatures } from "@adaas/are-html/directive/AreDirective.constants";
 import { AreHTMLEngineContext } from "./AreHTML.context";
 import { AreHTMLNode } from "../lib/AreHTMLNode/AreHTMLNode";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'HTML-specific lifecycle handler extending AreLifecycle. Wires DOM-aware init hooks for component nodes, root nodes, interpolations, text nodes, and directive attributes to the ARE rendering pipeline, connecting each entity to its HTML engine context and priming the scene for subsequent compilation and interpretation.'
+})
 export class AreHTMLLifecycle extends AreLifecycle {
 
     @AreLifecycle.Init(AreComponentNode)

package/src/engine/AreHTML.tokenizer.ts

@@ -8,11 +8,16 @@ import { AreEventAttribute } from "@adaas/are-html/attributes/AreEvent.attribute
 import { AreBindingAttribute } from "@adaas/are-html/attributes/AreBinding.attribute";
 import { AreStaticAttribute } from "@adaas/are-html/attributes/AreStatic.attribute";
 import { AreHTMLAttribute } from "../lib/AreHTMLAttribute/AreHTML.attribute";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'HTML-specific tokenizer extending AreTokenizer. Parses raw HTML template strings into AreHTMLNode trees by scanning element tags and resolving directive ($), event (@), binding (:), and static attributes to their typed attribute classes, constructing AreComponentNode and AreRootNode instances where required.'
+})
 export class AreHTMLTokenizer extends AreTokenizer {
 
-    ATTR_PATTERN = /([$:@]?[\w-]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>/"'=]+)))?/g
+    ATTR_PATTERN = /([$:@]?[\w.-]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s>/"'=]+)))?/g
 
 
     @A_Feature.Extend({

package/src/engine/AreHTML.transformer.ts

@@ -3,8 +3,13 @@ import { A_Logger } from "@adaas/a-utils/a-logger";
 import { AreAttributeFeatures, AreTransformer, AreStore } from "@adaas/are";
 import { AreDirectiveAttribute } from "@adaas/are-html/attributes/AreDirective.attribute";
 import { AreDirectiveFeatures } from "@adaas/are-html/directive/AreDirective.constants";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'HTML-specific transformer extending AreTransformer. Handles directive-attribute structural rewrites before compilation — sorting directives by declared priority and expanding compound directive expressions — so the compiler receives a clean, ordered AreHTMLNode tree ready for instruction emission.'
+})
 export class AreHTMLTransformer extends AreTransformer {
 
     @A_Feature.Extend({

package/src/index.ts

@@ -75,6 +75,6 @@ export * from './lib/AreStyle/AreStyle.context';
 export * from './lib/AreStyle/AreStyle.types';
 
 // ─────────────────────────────────────────────────────────────────────────────
-// ── Lib / AreWatcher ─────────────────────────────────────────────────────────
+// ── Lib / AreRouteWatcher ─────────────────────────────────────────────────────────
 // ─────────────────────────────────────────────────────────────────────────────
-export * from './lib/AreWatcher/AreWatcher.component';
+export * from './lib/AreRouteWatcher/AreRouteWatcher.component';

package/src/instructions/AddAttribute.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreMutation, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddAttributeInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddAttributeInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Sets an attribute on an HTML element. Apply calls setAttribute; revert calls removeAttribute.'
 })
 export class AddAttributeInstruction extends AreMutation<AreHtmlAddAttributeInstructionPayload> {

package/src/instructions/AddComment.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddCommentInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddCommentInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Appends a comment node to an element. Apply creates the comment node; revert removes it. Content can be a static string or a dynamic getter for interpolations.'
 })
 export class AddCommentInstruction extends AreDeclaration<AreHtmlAddCommentInstructionPayload> {

package/src/instructions/AddElement.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddElementInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddElementInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Creates a new HTML element in the DOM. Apply creates the element; revert removes it.'
 })
 export class AddElementInstruction extends AreDeclaration<AreHtmlAddElementInstructionPayload> {

package/src/instructions/AddInterpolation.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreMutation, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddInterpolationInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddInterpolationInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Appends a reactive text node whose content is resolved dynamically from the store. Apply creates the text node with the getter; revert removes it.'
 })
 export class AddInterpolationInstruction extends AreMutation<AreHtmlAddInterpolationInstructionPayload> {

package/src/instructions/AddListener.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreMutation, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddListenerInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddListenerInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Attaches a DOM event listener to an element. Apply calls addEventListener; revert calls removeEventListener.'
 })
 export class AddListenerInstruction extends AreMutation<AreHtmlAddListenerInstructionPayload> {

package/src/instructions/AddStyle.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreMutation, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddStyleInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddStyleInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Sets an inline CSS style property on an element. Apply sets the property; revert removes it.'
 })
 export class AddStyleInstruction extends AreMutation<AreHtmlAddStyleInstructionPayload> {

package/src/instructions/AddText.instruction.ts

@@ -1,12 +1,11 @@
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { AreDeclaration, AreInstructionSerialized } from "@adaas/are";
 import { AreHtmlAddTextInstructionPayload } from "./AreHTML.instructions.types";
 import { AreHTMLInstructions } from "./AreHTML.instructions.constants";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AddTextInstruction',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'Appends a text node to an element. Apply creates the text node; revert removes it. Content can be a static string or a dynamic getter for interpolations.'
 })
 export class AddTextInstruction extends AreDeclaration<AreHtmlAddTextInstructionPayload> {

package/src/lib/AreDirective/AreDirective.component.ts

@@ -3,8 +3,13 @@ import { A_Logger } from "@adaas/a-utils/a-logger";
 import type { AreDirectiveAttribute } from "@adaas/are-html/attributes/AreDirective.attribute";
 import { AreDirectiveMeta } from "./AreDirective.meta";
 import { AreDirectiveFeatures } from "./AreDirective.constants";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'Abstract base component for all ARE directive types. Provides lifecycle decorators (Transform, Compile, Apply, Revert, Priority) that subclasses hook into at each pipeline stage. Subclasses implement Transform to rewrite the attribute or template node, Compile to emit scene instructions, Apply to activate them in the DOM, and Revert to undo them on removal.'
+})
 @A_Meta.Define(AreDirectiveMeta)
 export class AreDirective extends A_Component  {
 

package/src/lib/AreHTMLAttribute/AreHTML.attribute.ts

@@ -1,9 +1,14 @@
 import { AreAttribute } from "@adaas/are";
 import { AreHTMLNode } from "../AreHTMLNode/AreHTMLNode";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'Base class for all typed HTML attributes in the ARE framework. Provides typed access to the owning AreHTMLNode via the scope injector so that attribute subclasses can inspect host-node properties and resolve store bindings during transformation, compilation, and lifecycle phases.'
+})
 export class AreHTMLAttribute extends AreAttribute {
 
     get owner(): AreHTMLNode {

package/src/lib/AreHTMLNode/AreHTMLNode.ts

@@ -1,5 +1,5 @@
 import { A_Context, } from "@adaas/a-concept";
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core";
 import { AreNode} from "@adaas/are";
 import { AreBindingAttribute } from "@adaas/are-html/attributes/AreBinding.attribute";
 import { AreDirectiveAttribute } from "@adaas/are-html/attributes/AreDirective.attribute";
@@ -11,9 +11,8 @@ import { AreDirectiveMeta } from "@adaas/are-html/directive/AreDirective.meta";
 
 
 
-@A_Frame.Entity({
-    namespace: 'A-ARE',
-    name: 'AreHTMLNode',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'AreHTMLNode represents a node in the HTML structure. It extends the base AreNode and includes properties and methods specific to HTML nodes, such as handling attributes, directives, events, and styles.'
 })
 export class AreHTMLNode extends AreNode {

package/src/lib/AreRoot/AreRoot.component.ts

@@ -1,13 +1,12 @@
 import { A_Caller, A_Context, A_FormatterHelper, A_Inject, } from "@adaas/a-concept";
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core";
 import { A_Logger } from "@adaas/a-utils/a-logger";
 import { A_SignalVector } from "@adaas/a-utils/a-signal";
 import { Are, ArePropDefinition, AreStore, AreNode, AreSignals, AreSignalsMeta, AreSignalsContext, AreRoute } from "@adaas/are";
 
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AreRoot',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'The AreRoot component serves as the foundational entry point for the A-Concept Rendering Engine (ARE). It is responsible for initializing the rendering process, managing the root node of the component tree, and handling signal-based rendering logic. The AreRoot component processes incoming signals to determine which child components to render, allowing for dynamic and responsive UI updates based on application state and user interactions.'
 })
 export class AreRoot extends Are {

package/src/lib/{AreWatcher/AreWatcher.component.ts → AreRouteWatcher/AreRouteWatcher.component.ts}

@@ -1,12 +1,11 @@
 import { A_Component } from "@adaas/a-concept";
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core";
 
-@A_Frame.Component({
-    namespace: 'A-ARE',
-    name: 'AreWatcher',
-    description: 'AreWatcher is a component that observes browser navigation events (history pushState, replaceState, and popstate) and notifies registered handlers when the URL changes, enabling client-side routing and reactive route-based rendering within the ARE framework.'
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'AreRouteWatcher is a component that observes browser navigation events (history pushState, replaceState, and popstate) and notifies registered handlers when the URL changes, enabling client-side routing and reactive route-based rendering within the ARE framework.'
 })
-export class AreWatcher extends A_Component {
+export class AreRouteWatcher extends A_Component {
 
     private readonly handlers: Set<(url: URL) => void> = new Set();
     private current: URL = new URL(window.location.href);

package/src/lib/AreStyle/AreStyle.context.ts

@@ -1,6 +1,11 @@
 import { A_Fragment, ASEID } from "@adaas/a-concept";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'Context fragment that holds the resolved CSS style rules string for a component scope. Populated during lifecycle initialisation and read by the compiler when emitting AddStyle instructions for inline styles declared on the component host element.'
+})
 export class AreStyle extends A_Fragment {
 
     styles!: string;

package/src/nodes/AreComment.ts

@@ -1,6 +1,11 @@
 import { AreNodeNewProps } from "@adaas/are";
 import { AreHTMLNode } from "@adaas/are-html/node";
+import { A_Frame } from "@adaas/a-frame/core";
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'Node type representing a comment node in the AreHTMLNode tree. Used as a stable DOM anchor by structural directives such as $if and $for that swap rendered content in and out, ensuring the parent container always has a consistent insertion point.'
+})
 export class AreComment extends AreHTMLNode {
 
 

package/src/nodes/AreComponent.ts

@@ -1,12 +1,11 @@
 import { A_FormatterHelper, } from "@adaas/a-concept";
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { Are } from "@adaas/are";
 import { AreHTMLNode } from "@adaas/are-html/node";
 
 
-@A_Frame.Entity({
-    namespace: 'A-ARE',
-    name: 'AreComponentNode',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'AreComponentNode represents a node in the scene graph that corresponds to a component. It extends the base AreNode and includes additional properties and methods specific to component nodes, such as handling attributes, bindings, directives, events, styles, and interpolations associated with the component.'
 })
 export class AreComponentNode extends AreHTMLNode {

package/src/nodes/AreInterpolation.ts

@@ -1,7 +1,12 @@
 import { AreNodeNewProps } from "@adaas/are";
 import { AreHTMLNode } from "@adaas/are-html/node";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'Node type representing a reactive inline expression in the AreHTMLNode tree. Its content expression is resolved from the store at render time and kept live via an AddInterpolation instruction that updates the corresponding text node on each reactive cycle.'
+})
 export class AreInterpolation extends AreHTMLNode {
 
         fromNew(newEntity: AreNodeNewProps): void {

package/src/nodes/AreRoot.ts

@@ -1,12 +1,11 @@
 import { A_FormatterHelper, } from "@adaas/a-concept";
-import { A_Frame } from "@adaas/a-frame";
+import { A_Frame } from "@adaas/a-frame/core"
 import { Are } from "@adaas/are";
 import { AreHTMLNode } from "@adaas/are-html/node";
 
 
-@A_Frame.Entity({
-    namespace: 'A-ARE',
-    name: 'AreRootNode',
+@A_Frame.Define({
+    namespace: 'a-are-html',
     description: 'AreRootNode represents the root node in the scene graph. It extends the base AreHTMLNode and includes additional properties and methods specific to the root node, such as handling the root element and its associated component.'
 })
 export class AreRootNode extends AreHTMLNode {

package/src/nodes/AreText.ts

@@ -1,7 +1,12 @@
 import { AreNodeNewProps } from "@adaas/are";
 import { AreHTMLNode } from "@adaas/are-html/node";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'Node type representing a plain or partially-dynamic text segment in the AreHTMLNode tree. Emits an AddText instruction that sets or updates the corresponding DOM text node; the content may carry a store getter for any dynamic portion.'
+})
 export class AreText extends AreHTMLNode {
 
 

package/src/signals/AreRoute.signal.ts

@@ -1,9 +1,14 @@
 import { A_Route } from "@adaas/a-utils/a-route";
 import { A_Signal } from "@adaas/a-utils/a-signal";
 import { AreSignal } from "@adaas/are";
+import { A_Frame } from "@adaas/a-frame/core";
 
 
 
+@A_Frame.Define({
+    namespace: 'a-are-html',
+    description: 'ARE signal that carries an A_Route value. Dispatched by AreRouteWatcher on client-side navigation events (pushState, replaceState, popstate). The signal bus delivers it to all subscribed root nodes, triggering route-based conditional rendering across the component tree.'
+})
 export class AreRoute extends AreSignal<A_Route> {
 
     constructor(path: string | RegExp) {

package/dist/node/lib/AreWatcher/AreWatcher.component.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/lib/AreWatcher/AreWatcher.component.ts"],"names":["AreWatcher","A_Component","A_Frame"],"mappings":"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","file":"AreWatcher.component.js","sourcesContent":["import { A_Component } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreWatcher',\n    description: 'AreWatcher is a component that observes browser navigation events (history pushState, replaceState, and popstate) and notifies registered handlers when the URL changes, enabling client-side routing and reactive route-based rendering within the ARE framework.'\n})\nexport class AreWatcher extends A_Component {\n\n    private readonly handlers: Set<(url: URL) => void> = new Set();\n    private current: URL = new URL(window.location.href);\n\n    constructor() {\n        super();\n        this.patchHistory();\n        this.attachListeners();\n    }\n\n    // ── Public ────────────────────────────────────────────────────────────────\n\n    onChange(handler: (url: URL) => void): () => void {\n        this.handlers.add(handler);\n        return () => this.handlers.delete(handler);   // returns unsubscribe fn\n    }\n\n    get url(): URL {\n        return this.current;\n    }\n\n    destroy(): void {\n        window.removeEventListener('popstate', this.onPopState);\n        window.removeEventListener('hashchange', this.onHashChange);\n        window.removeEventListener('urlchange', this.onURLChange);\n        this.handlers.clear();\n    }\n\n    // ── Listeners ─────────────────────────────────────────────────────────────\n\n    private onPopState = (): void => {\n        this.notify();\n    }\n\n    private onHashChange = (): void => {\n        this.notify();\n    }\n\n    private onURLChange = (): void => {\n        this.notify();\n    }\n\n    private attachListeners(): void {\n        window.addEventListener('popstate', this.onPopState);\n        window.addEventListener('hashchange', this.onHashChange);\n        window.addEventListener('urlchange', this.onURLChange);   // custom event from patch\n    }\n\n    // ── Patch pushState / replaceState ────────────────────────────────────────\n\n    private patchHistory(): void {\n        const patch = (original: typeof history.pushState) =>\n            function (this: History, ...args: Parameters<typeof history.pushState>) {\n                original.apply(this, args);\n                window.dispatchEvent(new Event('urlchange'));\n            };\n\n        history.pushState = patch(history.pushState);\n        history.replaceState = patch(history.replaceState);\n    }\n\n    // ── Notify ────────────────────────────────────────────────────────────────\n\n    private notify(): void {\n        const next = new URL(window.location.href);\n\n        if (next.href === this.current.href) return;   // no actual change\n\n        this.current = next;\n\n        for (const handler of this.handlers) {\n            handler(this.current);\n        }\n    }\n}"]}

package/dist/node/lib/AreWatcher/AreWatcher.component.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../src/lib/AreWatcher/AreWatcher.component.ts"],"names":[],"mappings":"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","file":"AreWatcher.component.mjs","sourcesContent":["import { A_Component } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreWatcher',\n    description: 'AreWatcher is a component that observes browser navigation events (history pushState, replaceState, and popstate) and notifies registered handlers when the URL changes, enabling client-side routing and reactive route-based rendering within the ARE framework.'\n})\nexport class AreWatcher extends A_Component {\n\n    private readonly handlers: Set<(url: URL) => void> = new Set();\n    private current: URL = new URL(window.location.href);\n\n    constructor() {\n        super();\n        this.patchHistory();\n        this.attachListeners();\n    }\n\n    // ── Public ────────────────────────────────────────────────────────────────\n\n    onChange(handler: (url: URL) => void): () => void {\n        this.handlers.add(handler);\n        return () => this.handlers.delete(handler);   // returns unsubscribe fn\n    }\n\n    get url(): URL {\n        return this.current;\n    }\n\n    destroy(): void {\n        window.removeEventListener('popstate', this.onPopState);\n        window.removeEventListener('hashchange', this.onHashChange);\n        window.removeEventListener('urlchange', this.onURLChange);\n        this.handlers.clear();\n    }\n\n    // ── Listeners ─────────────────────────────────────────────────────────────\n\n    private onPopState = (): void => {\n        this.notify();\n    }\n\n    private onHashChange = (): void => {\n        this.notify();\n    }\n\n    private onURLChange = (): void => {\n        this.notify();\n    }\n\n    private attachListeners(): void {\n        window.addEventListener('popstate', this.onPopState);\n        window.addEventListener('hashchange', this.onHashChange);\n        window.addEventListener('urlchange', this.onURLChange);   // custom event from patch\n    }\n\n    // ── Patch pushState / replaceState ────────────────────────────────────────\n\n    private patchHistory(): void {\n        const patch = (original: typeof history.pushState) =>\n            function (this: History, ...args: Parameters<typeof history.pushState>) {\n                original.apply(this, args);\n                window.dispatchEvent(new Event('urlchange'));\n            };\n\n        history.pushState = patch(history.pushState);\n        history.replaceState = patch(history.replaceState);\n    }\n\n    // ── Notify ────────────────────────────────────────────────────────────────\n\n    private notify(): void {\n        const next = new URL(window.location.href);\n\n        if (next.href === this.current.href) return;   // no actual change\n\n        this.current = next;\n\n        for (const handler of this.handlers) {\n            handler(this.current);\n        }\n    }\n}"]}