@oh-just-another/templates 0.57.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAGpC,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { TemplateRegistry, defaultRegistry } from "./registry.js";
+export { BUILTIN_TEMPLATES, installBuiltinTemplates, matchesTemplateSearch, } from "./built-in.js";
+export * as icons from "./icons.js";
+export { TemplateSpecZ, TemplateLibrarySpecZ, ShapeBlueprintZ, templateFromSpec } from "./spec.js";
+export { parseTemplateLibrary, templatesFromLibrary, loadTemplateLibrary, TemplateLibraryError, } from "./library.js";
+// Rich-template surface: node-tree + flex layout + bindings.
+export * as rich from "./rich/index.js";
+// Tunable visual constants.
+export { ICON_VIEWBOX_SIZE, ICON_STROKE_WIDTH } from "./constants.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAIpC,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACnG,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,6DAA6D;AAC7D,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AAExC,4BAA4B;AAC5B,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/library.d.ts

@@ -0,0 +1,29 @@
+import { type TemplateLibrarySpec } from "./spec.js";
+import { type TemplateRegistry } from "./registry.js";
+import type { Template } from "./types.js";
+/**
+ * Errors thrown by library import. Carries the underlying zod error in
+ * `reason` for callers that want field-level inspection.
+ */
+export declare class TemplateLibraryError extends Error {
+    readonly reason: unknown;
+    constructor(message: string, reason: unknown);
+}
+/** Validate `input` and return the typed library spec. */
+export declare const parseTemplateLibrary: (input: unknown) => TemplateLibrarySpec;
+/**
+ * Convert a validated library spec into runtime `Template[]`. Pure — no side
+ * effects on any registry.
+ */
+export declare const templatesFromLibrary: (lib: TemplateLibrarySpec) => readonly Template[];
+/**
+ * Parse, materialise, and register in one call.
+ *
+ * @param input    parsed JSON object or a JSON string
+ * @param registry which registry to load into (defaults to `defaultRegistry`)
+ * @param options  `replace: true` overwrites duplicates; otherwise dupe ids throw
+ */
+export declare const loadTemplateLibrary: (input: unknown, registry?: TemplateRegistry, options?: {
+    replace?: boolean;
+}) => readonly Template[];
+//# sourceMappingURL=library.d.ts.map

package/dist/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;CAK7C;AAED,0DAA0D;AAC1D,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,mBASrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,mBAAmB,KAAG,SAAS,QAAQ,EAC5C,CAAC;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,OAAO,EACd,WAAU,gBAAkC,EAC5C,UAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,KAClC,SAAS,QAAQ,EASnB,CAAC"}

package/dist/library.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { templateFromSpec, TemplateLibrarySpecZ } from "./spec.js";
+import { defaultRegistry } from "./registry.js";
+/**
+ * Errors thrown by library import. Carries the underlying zod error in
+ * `reason` for callers that want field-level inspection.
+ */
+export class TemplateLibraryError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.name = "TemplateLibraryError";
+        this.reason = reason;
+    }
+}
+/** Validate `input` and return the typed library spec. */
+export const parseTemplateLibrary = (input) => {
+    try {
+        return TemplateLibrarySpecZ.parse(input);
+    }
+    catch (err) {
+        if (err instanceof z.ZodError) {
+            throw new TemplateLibraryError(`Invalid template library: ${err.message}`, err);
+        }
+        throw err;
+    }
+};
+/**
+ * Convert a validated library spec into runtime `Template[]`. Pure — no side
+ * effects on any registry.
+ */
+export const templatesFromLibrary = (lib) => lib.templates.map(templateFromSpec);
+/**
+ * Parse, materialise, and register in one call.
+ *
+ * @param input    parsed JSON object or a JSON string
+ * @param registry which registry to load into (defaults to `defaultRegistry`)
+ * @param options  `replace: true` overwrites duplicates; otherwise dupe ids throw
+ */
+export const loadTemplateLibrary = (input, registry = defaultRegistry, options = {}) => {
+    const raw = typeof input === "string" ? safeParseJson(input) : input;
+    const lib = parseTemplateLibrary(raw);
+    const templates = templatesFromLibrary(lib);
+    for (const t of templates) {
+        if (options.replace)
+            registry.replace(t);
+        else
+            registry.register(t);
+    }
+    return templates;
+};
+const safeParseJson = (s) => {
+    try {
+        return JSON.parse(s);
+    }
+    catch (err) {
+        throw new TemplateLibraryError("Library file is not valid JSON", err);
+    }
+};
+//# sourceMappingURL=library.js.map

package/dist/library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../src/library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAA4B,MAAM,WAAW,CAAC;AAC7F,OAAO,EAAE,eAAe,EAAyB,MAAM,eAAe,CAAC;AAGvE;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,MAAM,CAAU;IACzB,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAuB,EAAE;IAC1E,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,oBAAoB,CAAC,6BAA6B,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAwB,EAAuB,EAAE,CACpF,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAc,EACd,WAA6B,eAAe,EAC5C,UAAiC,EAAE,EACd,EAAE;IACvB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACrE,MAAM,GAAG,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,OAAO;YAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;;YACpC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,CAAS,EAAW,EAAE;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,oBAAoB,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACxE,CAAC;AACH,CAAC,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,27 @@
+import type { Category, Template } from "./types.js";
+/**
+ * In-process registry of templates. Plugins register at module load; the demo
+ * iterates by category to fill the palette.
+ *
+ * There is no precedence or namespace — registering an existing id throws so
+ * collisions are caught early.
+ */
+export declare class TemplateRegistry {
+    private readonly items;
+    register(template: Template): void;
+    /** Overwrite a registration. Use in tests / hot-reload paths. */
+    replace(template: Template): void;
+    get(id: string): Template | undefined;
+    has(id: string): boolean;
+    /** All templates in registration order. */
+    list(): readonly Template[];
+    /** Templates belonging to a given category, in registration order. */
+    byCategory(category: Category): readonly Template[];
+    /** Distinct categories present in the registry. */
+    categories(): readonly Category[];
+    /** Drop everything. */
+    clear(): void;
+}
+/** Default singleton used by `installBuiltinTemplates()` and most hosts. */
+export declare const defaultRegistry: TemplateRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+B;IAErD,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAOlC,iEAAiE;IACjE,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIrC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,2CAA2C;IAC3C,IAAI,IAAI,SAAS,QAAQ,EAAE;IAI3B,sEAAsE;IACtE,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,QAAQ,EAAE;IAInD,mDAAmD;IACnD,UAAU,IAAI,SAAS,QAAQ,EAAE;IAMjC,uBAAuB;IACvB,KAAK,IAAI,IAAI;CAGd;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,kBAAyB,CAAC"}

package/dist/registry.js

@@ -0,0 +1,48 @@
+/**
+ * In-process registry of templates. Plugins register at module load; the demo
+ * iterates by category to fill the palette.
+ *
+ * There is no precedence or namespace — registering an existing id throws so
+ * collisions are caught early.
+ */
+export class TemplateRegistry {
+    items = new Map();
+    register(template) {
+        if (this.items.has(template.id)) {
+            throw new Error(`Template already registered: ${template.id}`);
+        }
+        this.items.set(template.id, template);
+    }
+    /** Overwrite a registration. Use in tests / hot-reload paths. */
+    replace(template) {
+        this.items.set(template.id, template);
+    }
+    get(id) {
+        return this.items.get(id);
+    }
+    has(id) {
+        return this.items.has(id);
+    }
+    /** All templates in registration order. */
+    list() {
+        return [...this.items.values()];
+    }
+    /** Templates belonging to a given category, in registration order. */
+    byCategory(category) {
+        return this.list().filter((t) => t.category === category);
+    }
+    /** Distinct categories present in the registry. */
+    categories() {
+        const out = new Set();
+        for (const t of this.items.values())
+            out.add(t.category);
+        return [...out];
+    }
+    /** Drop everything. */
+    clear() {
+        this.items.clear();
+    }
+}
+/** Default singleton used by `installBuiltinTemplates()` and most hosts. */
+export const defaultRegistry = new TemplateRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACV,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;IAErD,QAAQ,CAAC,QAAkB;QACzB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,iEAAiE;IACjE,OAAO,CAAC,QAAkB;QACxB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,2CAA2C;IAC3C,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,sEAAsE;IACtE,UAAU,CAAC,QAAkB;QAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC5D,CAAC;IAED,mDAAmD;IACnD,UAAU;QACR,MAAM,GAAG,GAAG,IAAI,GAAG,EAAY,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAED,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/rich/binding.d.ts

@@ -0,0 +1,10 @@
+import type { TemplateNode } from "./node.js";
+/**
+ * Resolve every `{ bind: "key" }` reference in a tree against `data`. Returns
+ * a new tree with literal values in place of bindings. Unknown keys resolve
+ * to `undefined`, which the renderer treats as empty.
+ *
+ * Pure — does not mutate the input tree.
+ */
+export declare const resolveBindings: (node: TemplateNode, data: Readonly<Record<string, unknown>>) => TemplateNode;
+//# sourceMappingURL=binding.d.ts.map

package/dist/rich/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/rich/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,MAAM,YAAY,EAClB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACtC,YAsBF,CAAC"}

package/dist/rich/binding.js

@@ -0,0 +1,42 @@
+/**
+ * Resolve every `{ bind: "key" }` reference in a tree against `data`. Returns
+ * a new tree with literal values in place of bindings. Unknown keys resolve
+ * to `undefined`, which the renderer treats as empty.
+ *
+ * Pure — does not mutate the input tree.
+ */
+export const resolveBindings = (node, data) => {
+    switch (node.type) {
+        case "container":
+            if (!node.children)
+                return node;
+            return {
+                ...node,
+                children: node.children.map((c) => resolveBindings(c, data)),
+            };
+        case "text":
+            return { ...node, text: resolve(node.text, data, "") };
+        case "icon":
+            return { ...node, svg: resolve(node.svg, data, "") };
+        case "image":
+            return { ...node, src: resolve(node.src, data, "") };
+        case "button":
+            return node.label === undefined ? node : { ...node, label: resolve(node.label, data, "") };
+        case "drop-zone":
+            return node.label === undefined ? node : { ...node, label: resolve(node.label, data, "") };
+        case "port":
+            // Ports carry no bindings — they're pure positional markers.
+            return node;
+    }
+};
+const resolve = (value, data, fallback) => {
+    if (typeof value === "object" && value !== null && "bind" in value) {
+        const key = value.bind;
+        const raw = data[key];
+        if (raw === undefined || raw === null)
+            return fallback;
+        return raw;
+    }
+    return value;
+};
+//# sourceMappingURL=binding.js.map

package/dist/rich/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/rich/binding.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAkB,EAClB,IAAuC,EACzB,EAAE;IAChB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,WAAW;YACd,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAChC,OAAO;gBACL,GAAG,IAAI;gBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;aAC7D,CAAC;QACJ,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACzD,KAAK,MAAM;YACT,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACvD,KAAK,OAAO;YACV,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACvD,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7F,KAAK,WAAW;YACd,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7F,KAAK,MAAM;YACT,6DAA6D;YAC7D,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CAAI,KAAiB,EAAE,IAAuC,EAAE,QAAW,EAAK,EAAE;IAChG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACnE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QACvD,OAAO,GAAQ,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/rich/bounds.d.ts

@@ -0,0 +1,16 @@
+import type { Bounds } from "@oh-just-another/types";
+import { type MeasureText } from "./layout.js";
+import type { TemplateNode } from "./node.js";
+/**
+ * Local AABB of a rich-template instance — the bounds of the root after
+ * layout. Use this from a `ElementBounder` registered on `"template"` to feed
+ * the scene's spatial index.
+ */
+export declare const getTemplateLocalBounds: (root: TemplateNode, data?: Readonly<Record<string, unknown>>, options?: {
+    measureText?: MeasureText;
+    available?: {
+        width: number;
+        height: number;
+    };
+}) => Bounds;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/rich/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../../src/rich/bounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,YAAY,EAClB,OAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,EAC5C,UAAS;IAAE,WAAW,CAAC,EAAE,WAAW,CAAC;IAAC,SAAS,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAO,KACzF,MAIF,CAAC"}

package/dist/rich/bounds.js

@@ -0,0 +1,13 @@
+import { layoutTree } from "./layout.js";
+import { resolveBindings } from "./binding.js";
+/**
+ * Local AABB of a rich-template instance — the bounds of the root after
+ * layout. Use this from a `ElementBounder` registered on `"template"` to feed
+ * the scene's spatial index.
+ */
+export const getTemplateLocalBounds = (root, data = {}, options = {}) => {
+    const resolved = resolveBindings(root, data);
+    const layouted = layoutTree(resolved, options);
+    return layouted.bounds;
+};
+//# sourceMappingURL=bounds.js.map

package/dist/rich/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../../src/rich/bounds.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,IAAkB,EAClB,OAA0C,EAAE,EAC5C,UAAwF,EAAE,EAClF,EAAE;IACV,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,MAAM,CAAC;AACzB,CAAC,CAAC"}

package/dist/rich/define.d.ts

@@ -0,0 +1,44 @@
+import type { TemplateNode } from "./node.js";
+/**
+ * Description of a rich template's data shape. Each entry maps a `{ bind: }`
+ * key in the tree to its expected runtime type. The kernel does not enforce
+ * the schema beyond surfacing it in the registry — host UIs use it to render
+ * forms / inspectors.
+ */
+export type RichTemplateSchema = Readonly<Record<string, "string" | "number" | "boolean">>;
+/**
+ * A rich template definition: tree + binding schema + version. Versioning is
+ * the template's own — kernel migrations apply to the scene document, not to
+ * individual templates.
+ */
+export interface RichTemplate {
+    readonly id: string;
+    readonly name: string;
+    readonly category: string;
+    /** SVG markup for the palette thumbnail. */
+    readonly icon: string;
+    /** Root of the layout tree. */
+    readonly root: TemplateNode;
+    readonly schema?: RichTemplateSchema;
+    readonly version?: number;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+    /**
+     * Default values for the `data` argument the host will pass to the editor
+     * when an instance is created. Optional; the host can substitute its own.
+     */
+    readonly defaults?: Readonly<Record<string, unknown>>;
+    /**
+     * Interactive-resize constraints. Copied onto the spawned `TemplateElement`'s
+     * `minWidth` / `minHeight` / `maxWidth` / `maxHeight` / `noFlip` fields so
+     * the editor enforces them. Omitted = no constraint on that axis.
+     */
+    readonly minWidth?: number;
+    readonly minHeight?: number;
+    readonly maxWidth?: number;
+    readonly maxHeight?: number;
+    /** Disable mirroring when overshooting the opposite edge. Defaults to `false`. */
+    readonly noFlip?: boolean;
+}
+/** Type-safe constructor for `RichTemplate`. Identity function. */
+export declare const defineRichTemplate: (template: RichTemplate) => RichTemplate;
+//# sourceMappingURL=define.d.ts.map

package/dist/rich/define.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/rich/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAE3F;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAEtD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,GAAI,UAAU,YAAY,KAAG,YAAwB,CAAC"}

package/dist/rich/define.js

@@ -0,0 +1,3 @@
+/** Type-safe constructor for `RichTemplate`. Identity function. */
+export const defineRichTemplate = (template) => template;
+//# sourceMappingURL=define.js.map

package/dist/rich/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/rich/define.ts"],"names":[],"mappings":"AA6CA,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAAsB,EAAgB,EAAE,CAAC,QAAQ,CAAC"}

package/dist/rich/drop-zones.d.ts

@@ -0,0 +1,25 @@
+import type { Bounds } from "@oh-just-another/types";
+import type { LayoutedNode } from "./layout.js";
+/**
+ * Walk a layouted template tree and find the first `drop-zone` node.
+ * Returns its bounds in **local** coordinates — relative to the
+ * template root's top-left (so it can be stored as
+ * `shape.metadata.container.dropZone` without further translation).
+ *
+ * Templates with multiple drop-zone nodes are unusual; this helper
+ * returns the **largest** one (by area) so that the container
+ * protocol picks the meaningful body region instead of a tiny
+ * decoration. Returns `null` when the tree has no drop-zone.
+ */
+export declare const extractDropZone: (root: LayoutedNode) => Bounds | null;
+/**
+ * Walk a layouted template tree and return **every** `drop-zone` node's bounds
+ * in **local** coordinates (relative to the root top-left), in tree order.
+ *
+ * Unlike `extractDropZone` (which collapses to the single largest zone for the
+ * container-attach protocol), this keeps all zones — e.g. each lane of a
+ * multi-lane swim-lane. Used by the debug hit-zone overlay to highlight every
+ * drop region; returns `[]` when the tree has no drop-zone.
+ */
+export declare const extractAllDropZones: (root: LayoutedNode) => Bounds[];
+//# sourceMappingURL=drop-zones.d.ts.map

package/dist/rich/drop-zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-zones.d.ts","sourceRoot":"","sources":["../../src/rich/drop-zones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,KAAG,MAAM,GAAG,IAuB7D,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,YAAY,KAAG,MAAM,EAgB9D,CAAC"}

package/dist/rich/drop-zones.js

@@ -0,0 +1,63 @@
+/**
+ * Walk a layouted template tree and find the first `drop-zone` node.
+ * Returns its bounds in **local** coordinates — relative to the
+ * template root's top-left (so it can be stored as
+ * `shape.metadata.container.dropZone` without further translation).
+ *
+ * Templates with multiple drop-zone nodes are unusual; this helper
+ * returns the **largest** one (by area) so that the container
+ * protocol picks the meaningful body region instead of a tiny
+ * decoration. Returns `null` when the tree has no drop-zone.
+ */
+export const extractDropZone = (root) => {
+    const rootBounds = root.bounds;
+    let best = null;
+    let bestArea = 0;
+    const visit = (l) => {
+        if (l.node.type === "drop-zone") {
+            const local = {
+                x: l.bounds.x - rootBounds.x,
+                y: l.bounds.y - rootBounds.y,
+                width: l.bounds.width,
+                height: l.bounds.height,
+            };
+            const area = local.width * local.height;
+            if (area > bestArea) {
+                best = local;
+                bestArea = area;
+            }
+        }
+        for (const child of l.children)
+            visit(child);
+    };
+    visit(root);
+    return best;
+};
+/**
+ * Walk a layouted template tree and return **every** `drop-zone` node's bounds
+ * in **local** coordinates (relative to the root top-left), in tree order.
+ *
+ * Unlike `extractDropZone` (which collapses to the single largest zone for the
+ * container-attach protocol), this keeps all zones — e.g. each lane of a
+ * multi-lane swim-lane. Used by the debug hit-zone overlay to highlight every
+ * drop region; returns `[]` when the tree has no drop-zone.
+ */
+export const extractAllDropZones = (root) => {
+    const rootBounds = root.bounds;
+    const zones = [];
+    const visit = (l) => {
+        if (l.node.type === "drop-zone") {
+            zones.push({
+                x: l.bounds.x - rootBounds.x,
+                y: l.bounds.y - rootBounds.y,
+                width: l.bounds.width,
+                height: l.bounds.height,
+            });
+        }
+        for (const child of l.children)
+            visit(child);
+    };
+    visit(root);
+    return zones;
+};
+//# sourceMappingURL=drop-zones.js.map

package/dist/rich/drop-zones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop-zones.js","sourceRoot":"","sources":["../../src/rich/drop-zones.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAkB,EAAiB,EAAE;IACnE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/B,IAAI,IAAI,GAAkB,IAAI,CAAC;IAC/B,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,MAAM,KAAK,GAAG,CAAC,CAAe,EAAQ,EAAE;QACtC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,KAAK,GAAW;gBACpB,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;gBAC5B,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;gBAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK;gBACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;aACxB,CAAC;YACF,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;YACxC,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;gBACpB,IAAI,GAAG,KAAK,CAAC;gBACb,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAkB,EAAY,EAAE;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,CAAe,EAAQ,EAAE;QACtC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC;gBACT,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;gBAC5B,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC;gBAC5B,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK;gBACrB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM;aACxB,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/rich/extends.d.ts

@@ -0,0 +1,35 @@
+import type { RichTemplate } from "./define.js";
+/**
+ * Recipe for building a rich template by extending another. The base
+ * template is looked up by id in a registry-like map; `overrides` is
+ * deep-merged on top.
+ *
+ *   extendRichTemplate({
+ *     id: "myorg.bigger-card",
+ *     extends: "myorg.card",
+ *     overrides: { width: 360, defaults: { title: "Big" } },
+ *   }, registry)
+ */
+export interface RichTemplateExtension {
+    readonly id: string;
+    readonly extends: string;
+    readonly name?: string;
+    readonly category?: string;
+    readonly icon?: string;
+    readonly overrides?: DeepPartial<RichTemplate>;
+}
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends Readonly<Record<string, unknown>> ? DeepPartial<T[K]> : T[K] extends readonly (infer U)[] ? readonly U[] : T[K];
+};
+/**
+ * Resolve a `RichTemplateExtension` (and any chain of base templates it
+ * references) into a fully-merged `RichTemplate`. Each layer's
+ * `overrides` are deep-merged on top of the previous (base first, leaf
+ * last) so child layers naturally win.
+ *
+ * `lookup` is the registry accessor — usually `(id) => registry.get(id)`.
+ * Throws if the chain references a missing base id.
+ */
+export declare const resolveRichTemplateChain: (ext: RichTemplateExtension, lookup: (id: string) => RichTemplate | RichTemplateExtension | undefined) => RichTemplate;
+export {};
+//# sourceMappingURL=extends.d.ts.map

package/dist/rich/extends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extends.d.ts","sourceRoot":"","sources":["../../src/rich/extends.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC;CAChD;AAED,KAAK,WAAW,CAAC,CAAC,IAAI;KACnB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC3D,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjB,CAAC,CAAC,CAAC,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC/B,SAAS,CAAC,EAAE,GACZ,CAAC,CAAC,CAAC,CAAC;CACX,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,KAAK,qBAAqB,EAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,GAAG,qBAAqB,GAAG,SAAS,KACvE,YAyBF,CAAC"}

package/dist/rich/extends.js

@@ -0,0 +1,46 @@
+/**
+ * Resolve a `RichTemplateExtension` (and any chain of base templates it
+ * references) into a fully-merged `RichTemplate`. Each layer's
+ * `overrides` are deep-merged on top of the previous (base first, leaf
+ * last) so child layers naturally win.
+ *
+ * `lookup` is the registry accessor — usually `(id) => registry.get(id)`.
+ * Throws if the chain references a missing base id.
+ */
+export const resolveRichTemplateChain = (ext, lookup) => {
+    const chain = [ext];
+    let current = lookup(ext.extends);
+    while (current && "extends" in current) {
+        chain.unshift(current);
+        current = lookup(current.extends);
+    }
+    if (!current) {
+        const first = chain[0];
+        throw new Error(`Rich template "${ext.id}" extends "${first ? first.extends : ext.extends}", which is not registered.`);
+    }
+    // `current` is the concrete base `RichTemplate` now.
+    let result = current;
+    for (const layer of chain) {
+        result = mergeRichTemplate(result, {
+            id: layer.id,
+            ...(layer.name !== undefined ? { name: layer.name } : {}),
+            ...(layer.category !== undefined ? { category: layer.category } : {}),
+            ...(layer.icon !== undefined ? { icon: layer.icon } : {}),
+            ...(layer.overrides ?? {}),
+        });
+    }
+    return result;
+};
+const mergeRichTemplate = (base, patch) => {
+    return {
+        ...base,
+        ...patch,
+        // Defaults merge object-shallow — overriding individual keys is the
+        // common case; full replacement is rare and authors can pass the
+        // whole object.
+        ...(patch.defaults !== undefined ? { defaults: { ...base.defaults, ...patch.defaults } } : {}),
+        // Same for metadata.
+        ...(patch.metadata !== undefined ? { metadata: { ...base.metadata, ...patch.metadata } } : {}),
+    };
+};
+//# sourceMappingURL=extends.js.map

package/dist/rich/extends.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extends.js","sourceRoot":"","sources":["../../src/rich/extends.ts"],"names":[],"mappings":"AA8BA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CACtC,GAA0B,EAC1B,MAAwE,EAC1D,EAAE;IAChB,MAAM,KAAK,GAA4B,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAqD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpF,OAAO,OAAO,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,kBAAkB,GAAG,CAAC,EAAE,cAAc,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,6BAA6B,CACvG,CAAC;IACJ,CAAC;IACD,qDAAqD;IACrD,IAAI,MAAM,GAAiB,OAAO,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,GAAG,iBAAiB,CAAC,MAAM,EAAE;YACjC,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,iBAAiB,GAAG,CACxB,IAAkB,EAClB,KAAiD,EACnC,EAAE;IAChB,OAAO;QACL,GAAG,IAAI;QACP,GAAG,KAAK;QACR,oEAAoE;QACpE,iEAAiE;QACjE,gBAAgB;QAChB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,qBAAqB;QACrB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC;AACJ,CAAC,CAAC"}

package/dist/rich/hit-test.d.ts

@@ -0,0 +1,14 @@
+import type { Vec2 } from "@oh-just-another/types";
+import type { LayoutedNode } from "./layout.js";
+/**
+ * Walk the layouted tree top-down (parent before children) and return the
+ * deepest node that contains `point`. Returns `null` if `point` lies outside
+ * the root bounds. Coordinates are in the template's local space.
+ */
+export declare const nodeAtPoint: (root: LayoutedNode, point: Vec2) => LayoutedNode | null;
+/**
+ * Like `nodeAtPoint` but only returns interactive nodes (`button` or
+ * `drop-zone`). Returns the innermost interactive ancestor under `point`.
+ */
+export declare const interactiveNodeAtPoint: (root: LayoutedNode, point: Vec2) => LayoutedNode | null;
+//# sourceMappingURL=hit-test.d.ts.map

package/dist/rich/hit-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-test.d.ts","sourceRoot":"","sources":["../../src/rich/hit-test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,EAAE,OAAO,IAAI,KAAG,YAAY,GAAG,IAO5E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,MAAM,YAAY,EAAE,OAAO,IAAI,KAAG,YAAY,GAAG,IAIvF,CAAC"}

package/dist/rich/hit-test.js

@@ -0,0 +1,53 @@
+import { isInteractive } from "./node.js";
+const containsPoint = (b, p) => p.x >= b.x && p.x <= b.x + b.width && p.y >= b.y && p.y <= b.y + b.height;
+/**
+ * Walk the layouted tree top-down (parent before children) and return the
+ * deepest node that contains `point`. Returns `null` if `point` lies outside
+ * the root bounds. Coordinates are in the template's local space.
+ */
+export const nodeAtPoint = (root, point) => {
+    if (!containsPoint(root.bounds, point))
+        return null;
+    for (const child of root.children) {
+        const hit = nodeAtPoint(child, point);
+        if (hit)
+            return hit;
+    }
+    return root;
+};
+/**
+ * Like `nodeAtPoint` but only returns interactive nodes (`button` or
+ * `drop-zone`). Returns the innermost interactive ancestor under `point`.
+ */
+export const interactiveNodeAtPoint = (root, point) => {
+    const hit = nodeAtPoint(root, point);
+    if (!hit)
+        return null;
+    return findInteractiveAncestor(root, hit);
+};
+const findInteractiveAncestor = (root, target) => {
+    if (target === root) {
+        return isInteractive(root.node) ? root : null;
+    }
+    // Walk parent chain top-down. Build the chain by DFS from root.
+    const chain = findChain(root, target);
+    if (!chain)
+        return null;
+    for (let i = chain.length - 1; i >= 0; i--) {
+        const node = chain[i];
+        if (node && isInteractive(node.node))
+            return node;
+    }
+    return null;
+};
+const findChain = (root, target) => {
+    if (root === target)
+        return [root];
+    for (const child of root.children) {
+        const inner = findChain(child, target);
+        if (inner)
+            return [root, ...inner];
+    }
+    return null;
+};
+//# sourceMappingURL=hit-test.js.map