@toyz/loom 0.1.0

package/dist/decorators/symbols.d.ts

@@ -0,0 +1,13 @@
+export declare const REACTIVES: unique symbol;
+export declare const PROPS: unique symbol;
+export declare const ON_HANDLERS: unique symbol;
+export declare const WATCHERS: unique symbol;
+export declare const EMITTERS: unique symbol;
+export declare const COMPUTED_DIRTY: unique symbol;
+export declare const CATCH_HANDLER: unique symbol;
+export declare const MOUNT_HANDLERS: unique symbol;
+export declare const UNMOUNT_HANDLERS: unique symbol;
+export declare const INJECT_PARAMS: unique symbol;
+export declare const ROUTE_PROPS: unique symbol;
+export declare const TRANSFORMS: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/decorators/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/decorators/symbols.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,SAAS,eAA2B,CAAC;AAClD,eAAO,MAAM,KAAK,eAAuB,CAAC;AAC1C,eAAO,MAAM,WAAW,eAAoB,CAAC;AAC7C,eAAO,MAAM,QAAQ,eAAuB,CAAC;AAC7C,eAAO,MAAM,QAAQ,eAAsB,CAAC;AAC5C,eAAO,MAAM,cAAc,eAAgC,CAAC;AAC5D,eAAO,MAAM,aAAa,eAAuB,CAAC;AAClD,eAAO,MAAM,cAAc,eAAuB,CAAC;AACnD,eAAO,MAAM,gBAAgB,eAAyB,CAAC;AACvD,eAAO,MAAM,aAAa,eAA+B,CAAC;AAC1D,eAAO,MAAM,WAAW,eAA6B,CAAC;AACtD,eAAO,MAAM,UAAU,eAA4B,CAAC"}

package/dist/decorators/symbols.js

@@ -0,0 +1,15 @@
+// ── Symbol keys ──
+// Shared contract between decorators and LoomElement.
+export const REACTIVES = Symbol("loom:reactives");
+export const PROPS = Symbol("loom:props");
+export const ON_HANDLERS = Symbol("loom:on");
+export const WATCHERS = Symbol("loom:watch");
+export const EMITTERS = Symbol("loom:emit");
+export const COMPUTED_DIRTY = Symbol("loom:computed:dirty");
+export const CATCH_HANDLER = Symbol("loom:catch");
+export const MOUNT_HANDLERS = Symbol("loom:mount");
+export const UNMOUNT_HANDLERS = Symbol("loom:unmount");
+export const INJECT_PARAMS = Symbol("loom:inject:params");
+export const ROUTE_PROPS = Symbol("loom:route:props");
+export const TRANSFORMS = Symbol("loom:transforms");
+//# sourceMappingURL=symbols.js.map

package/dist/decorators/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/decorators/symbols.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,sDAAsD;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/decorators/timing.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Auto-cleaned setInterval. Runs the method every `ms` milliseconds.
+ * Timer is started on connect, cleared on disconnect via track().
+ *
+ * ```ts
+ * @interval(1000)
+ * tick() { this.time = new Date(); }
+ * ```
+ */
+export declare function interval(ms: number): (target: any, key: string) => void;
+/**
+ * Auto-cleaned setTimeout. Runs the method once after `ms` milliseconds.
+ * Timer is started on connect, cleared on disconnect via track().
+ *
+ * ```ts
+ * @timeout(3000)
+ * hideWelcome() { this.$(".welcome")?.remove(); }
+ * ```
+ */
+export declare function timeout(ms: number): (target: any, key: string) => void;
+/**
+ * Centralized rAF loop via RenderLoop. Method receives (deltaTime, timestamp).
+ * Use layer to control execution order (lower = earlier).
+ *
+ * ```ts
+ * @animationFrame(10)       // layer 10
+ * draw(dt: number, t: number) { ... }
+ *
+ * @animationFrame()          // default layer 0
+ * physics(dt: number) { ... }
+ * ```
+ */
+export declare function animationFrame(layer?: number): (target: any, key: string) => void;
+export declare function animationFrame(target: any, key: string): void;
+//# sourceMappingURL=timing.d.ts.map

package/dist/decorators/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../src/decorators/timing.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,IACzB,QAAQ,GAAG,EAAE,KAAK,MAAM,UAQjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,IACxB,QAAQ,GAAG,EAAE,KAAK,MAAM,UAQjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AACnF,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC"}

package/dist/decorators/timing.js

@@ -0,0 +1,57 @@
+import { renderLoop } from "../render-loop";
+/**
+ * Auto-cleaned setInterval. Runs the method every `ms` milliseconds.
+ * Timer is started on connect, cleared on disconnect via track().
+ *
+ * ```ts
+ * @interval(1000)
+ * tick() { this.time = new Date(); }
+ * ```
+ */
+export function interval(ms) {
+    return (target, key) => {
+        const origConnect = target.connectedCallback;
+        target.connectedCallback = function () {
+            origConnect?.call(this);
+            const id = setInterval(() => this[key](), ms);
+            this.track(() => clearInterval(id));
+        };
+    };
+}
+/**
+ * Auto-cleaned setTimeout. Runs the method once after `ms` milliseconds.
+ * Timer is started on connect, cleared on disconnect via track().
+ *
+ * ```ts
+ * @timeout(3000)
+ * hideWelcome() { this.$(".welcome")?.remove(); }
+ * ```
+ */
+export function timeout(ms) {
+    return (target, key) => {
+        const origConnect = target.connectedCallback;
+        target.connectedCallback = function () {
+            origConnect?.call(this);
+            const id = setTimeout(() => this[key](), ms);
+            this.track(() => clearTimeout(id));
+        };
+    };
+}
+export function animationFrame(targetOrLayer, key) {
+    // Called as @animationFrame (no parens)
+    if (typeof targetOrLayer === "object" && typeof key === "string") {
+        wireAnimationFrame(targetOrLayer, key, 0);
+        return;
+    }
+    // Called as @animationFrame() or @animationFrame(layer)
+    const layer = typeof targetOrLayer === "number" ? targetOrLayer : 0;
+    return (target, key) => wireAnimationFrame(target, key, layer);
+}
+function wireAnimationFrame(target, key, layer) {
+    const origConnect = target.connectedCallback;
+    target.connectedCallback = function () {
+        origConnect?.call(this);
+        this.track(renderLoop.add(layer, (dt, t) => this[key](dt, t)));
+    };
+}
+//# sourceMappingURL=timing.js.map

package/dist/decorators/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/decorators/timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,EAAE;QAClC,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC7C,MAAM,CAAC,iBAAiB,GAAG;YACzB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,EAAU;IAChC,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,EAAE;QAClC,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAC;QAC7C,MAAM,CAAC,iBAAiB,GAAG;YACzB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAgBD,MAAM,UAAU,cAAc,CAC5B,aAAmB,EACnB,GAAY;IAEZ,wCAAwC;IACxC,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACjE,kBAAkB,CAAC,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,wDAAwD;IACxD,MAAM,KAAK,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAW,EAAE,GAAW,EAAE,KAAa;IACjE,MAAM,WAAW,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAC7C,MAAM,CAAC,iBAAiB,GAAG;QACzB,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAU,EAAE,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/transform.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @transform — Type conversion for route params/query values.
+ *
+ * Accepts any `(value: any) => T` function. Built-in constructors
+ * like `Number` and `Boolean` work natively since they match the signature.
+ *
+ * ```ts
+ * @prop({ param: "id" })
+ * @transform(Number)
+ * userId!: number;  // "42" → 42
+ *
+ * @prop({ param: "tags" })
+ * @transform((v) => v.split(","))
+ * tags!: string[];  // "a,b,c" → ["a", "b", "c"]
+ * ```
+ *
+ * For full object decomposition, use `typed<T>()`:
+ *
+ * ```ts
+ * interface MyParams { id: number; slug: string }
+ *
+ * @prop({ params })
+ * @transform(typed<MyParams>({ id: Number }))
+ * routeParams!: MyParams;
+ * ```
+ */
+export declare function transform(fn: (value: any) => any): (target: any, key: string) => void;
+/**
+ * Type-safe field-level transform for object decomposition.
+ *
+ * Schema keys must match fields of `T`. Each converter must return
+ * the correct type for that field. Unlisted fields pass through as-is.
+ *
+ * ```ts
+ * interface MyParams { id: number; slug: string }
+ * typed<MyParams>({ id: Number })
+ * // → { id: 42, slug: "hello" }
+ * ```
+ */
+type TransformSchema<T> = {
+    [K in keyof T]?: (raw: string) => T[K];
+};
+export declare function typed<T>(schema: TransformSchema<T>): (raw: Record<string, string>) => T;
+export {};
+//# sourceMappingURL=transform.d.ts.map

package/dist/decorators/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/decorators/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,wBAAgB,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,IACvC,QAAQ,GAAG,EAAE,KAAK,MAAM,UAKjC;AAED;;;;;;;;;;;GAWG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;CACvC,CAAC;AAEF,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAWvF"}

package/dist/decorators/transform.js

@@ -0,0 +1,48 @@
+/**
+ * @transform — Type conversion for route params/query values.
+ *
+ * Accepts any `(value: any) => T` function. Built-in constructors
+ * like `Number` and `Boolean` work natively since they match the signature.
+ *
+ * ```ts
+ * @prop({ param: "id" })
+ * @transform(Number)
+ * userId!: number;  // "42" → 42
+ *
+ * @prop({ param: "tags" })
+ * @transform((v) => v.split(","))
+ * tags!: string[];  // "a,b,c" → ["a", "b", "c"]
+ * ```
+ *
+ * For full object decomposition, use `typed<T>()`:
+ *
+ * ```ts
+ * interface MyParams { id: number; slug: string }
+ *
+ * @prop({ params })
+ * @transform(typed<MyParams>({ id: Number }))
+ * routeParams!: MyParams;
+ * ```
+ */
+import { TRANSFORMS } from "./symbols";
+export function transform(fn) {
+    return (target, key) => {
+        const ctor = target.constructor;
+        if (!ctor[TRANSFORMS])
+            ctor[TRANSFORMS] = new Map();
+        ctor[TRANSFORMS].set(key, fn);
+    };
+}
+export function typed(schema) {
+    return (raw) => {
+        const result = { ...raw };
+        for (const key of Object.keys(schema)) {
+            const fn = schema[key];
+            if (fn && key in result) {
+                result[key] = fn(result[key]);
+            }
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/decorators/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../src/decorators/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,UAAU,SAAS,CAAC,EAAuB;IAC/C,OAAO,CAAC,MAAW,EAAE,GAAW,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,EAAoB,CAAC;QACtE,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC;AACJ,CAAC;AAkBD,MAAM,UAAU,KAAK,CAAI,MAA0B;IACjD,OAAO,CAAC,GAA2B,EAAK,EAAE;QACxC,MAAM,MAAM,GAAQ,EAAE,GAAG,GAAG,EAAE,CAAC;QAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,EAAE,GAAI,MAAc,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,EAAE,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,MAAW,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}

package/dist/element.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Loom — LoomElement base class
+ *
+ * Web Component base with shadow DOM, css tagged templates,
+ * lifecycle hooks, and cleanup tracking.
+ */
+import { type Constructor, type Handler } from "./bus";
+import { type LoomEvent } from "./event";
+import { type CSSValue } from "./css";
+export declare abstract class LoomElement extends HTMLElement {
+    /** Access the LoomApp instance for inline provider resolution */
+    protected get app(): import("./app").LoomApp;
+    protected shadow: ShadowRoot;
+    private cleanups;
+    constructor();
+    /** Adopt styles — supports both tagged template and string */
+    protected css(text: string): void;
+    protected css(strings: TemplateStringsArray, ...values: CSSValue[]): void;
+    /**
+     * Adopt external CSSStyleSheets into this component's shadow root.
+     * Used by the router outlet to pass inherited styles down.
+     * Deduplicates — sheets already present are skipped.
+     */
+    adoptStyles(sheets: CSSStyleSheet[]): void;
+    /** Subscribe to a typed event — auto-cleaned on disconnect */
+    protected on<T>(type: Constructor<T>, handler: Handler<T>): () => void;
+    /** Emit a typed event */
+    protected emit<T extends LoomEvent>(event: T): void;
+    /** Track any cleanup function — runs on disconnect */
+    protected track(unsub: () => void): void;
+    /** querySelector within shadow root */
+    protected $<T extends Element = HTMLElement>(sel: string): T | null;
+    /** querySelectorAll within shadow root */
+    protected $$<T extends Element = HTMLElement>(sel: string): T[];
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * Batched re-render. Fires once per microtask when any @reactive/@prop changes.
+     * Override this to render your component.
+     */
+    update(): Node | Node[] | void;
+    /**
+     * Called after the very first update(). DOM is guaranteed to exist.
+     * Perfect for wiring up canvas, charts, third-party libs, or initial focus.
+     */
+    firstUpdated(): void;
+    /**
+     * Return false to skip this render cycle. Called before each update().
+     * Default: always renders.
+     */
+    shouldUpdate(): boolean;
+    private _updateScheduled;
+    private _hasUpdated;
+    /** Called by @reactive setters — batches via microtask */
+    scheduleUpdate(): void;
+    /**
+     * Re-run lifecycle from scratch (after @catch error).
+     * Cleans up, then re-connects.
+     */
+    retry(): void;
+}
+//# sourceMappingURL=element.d.ts.map

package/dist/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAO,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,OAAO,CAAC;AAKhD,8BAAsB,WAAY,SAAQ,WAAW;IACnD,iEAAiE;IACjE,SAAS,KAAK,GAAG,4BAAkB;IAEnC,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAsB;;IAStC,8DAA8D;IAC9D,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IACjC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI;IAQzE;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAU1C,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAMtE,yBAAyB;IACzB,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAMnD,sDAAsD;IACtD,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,IAAI,GAAG,IAAI;IAMxC,uCAAuC;IACvC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAInE,0CAA0C;IAC1C,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,OAAO,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE;IAM/D,iBAAiB,IAAI,IAAI;IAuBzB,oBAAoB,IAAI,IAAI;IAY5B;;;OAGG;IACH,MAAM,IAAI,IAAI,GAAG,IAAI,EAAE,GAAG,IAAI;IAE9B;;;OAGG;IACH,YAAY,IAAI,IAAI;IAEpB;;;OAGG;IACH,YAAY,IAAI,OAAO;IAMvB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,WAAW,CAAS;IAE5B,0DAA0D;IAC1D,cAAc,IAAI,IAAI;IAsBtB;;;OAGG;IACH,KAAK,IAAI,IAAI;CAKd"}

package/dist/element.js

@@ -0,0 +1,150 @@
+/**
+ * Loom — LoomElement base class
+ *
+ * Web Component base with shadow DOM, css tagged templates,
+ * lifecycle hooks, and cleanup tracking.
+ */
+import { bus } from "./bus";
+import { adoptCSS } from "./css";
+import { ON_HANDLERS, COMPUTED_DIRTY, MOUNT_HANDLERS, UNMOUNT_HANDLERS, REACTIVES } from "./decorators";
+import { morph } from "./morph";
+import { app } from "./app";
+export class LoomElement extends HTMLElement {
+    /** Access the LoomApp instance for inline provider resolution */
+    get app() { return app; }
+    shadow;
+    cleanups = [];
+    constructor() {
+        super();
+        this.shadow = this.attachShadow({ mode: "open" });
+    }
+    css(stringsOrText, ...values) {
+        adoptCSS(this.shadow, stringsOrText, ...values);
+    }
+    /**
+     * Adopt external CSSStyleSheets into this component's shadow root.
+     * Used by the router outlet to pass inherited styles down.
+     * Deduplicates — sheets already present are skipped.
+     */
+    adoptStyles(sheets) {
+        const existing = this.shadow.adoptedStyleSheets;
+        const newSheets = sheets.filter(s => !existing.includes(s));
+        if (newSheets.length > 0) {
+            this.shadow.adoptedStyleSheets = [...existing, ...newSheets];
+        }
+    }
+    // ── Event helpers ──
+    /** Subscribe to a typed event — auto-cleaned on disconnect */
+    on(type, handler) {
+        const unsub = bus.on(type, handler);
+        this.cleanups.push(unsub);
+        return unsub;
+    }
+    /** Emit a typed event */
+    emit(event) {
+        bus.emit(event);
+    }
+    // ── Cleanup tracking ──
+    /** Track any cleanup function — runs on disconnect */
+    track(unsub) {
+        this.cleanups.push(unsub);
+    }
+    // ── DOM queries ──
+    /** querySelector within shadow root */
+    $(sel) {
+        return this.shadow.querySelector(sel);
+    }
+    /** querySelectorAll within shadow root */
+    $$(sel) {
+        return Array.from(this.shadow.querySelectorAll(sel));
+    }
+    // ── Lifecycle ──
+    connectedCallback() {
+        // Wire @on handlers (bus events + DOM events)
+        for (const handler of this[ON_HANDLERS] ?? []) {
+            if (handler.domTarget) {
+                // DOM EventTarget: @on(window, "resize")
+                const fn = (e) => this[handler.key](e);
+                handler.domTarget.addEventListener(handler.event, fn);
+                this.track(() => handler.domTarget.removeEventListener(handler.event, fn));
+            }
+            else {
+                // Bus event: @on(ColorSelect)
+                this.track(bus.on(handler.type, (e) => this[handler.key](e)));
+            }
+        }
+        // Only auto-render if component uses reactive patterns
+        const hasReactives = (this[REACTIVES]?.length ?? 0) > 0;
+        const overridesUpdate = this.update !== LoomElement.prototype.update;
+        if (hasReactives || overridesUpdate)
+            this.scheduleUpdate();
+        // Fire @mount handlers
+        for (const key of this[MOUNT_HANDLERS] ?? []) {
+            this[key]();
+        }
+    }
+    disconnectedCallback() {
+        // Fire @unmount handlers (before cleanup)
+        for (const key of this[UNMOUNT_HANDLERS] ?? []) {
+            this[key]();
+        }
+        // Run all track() cleanups
+        this.cleanups.forEach((fn) => fn());
+        this.cleanups = [];
+    }
+    // ── Lifecycle hooks (override in subclass) ──
+    /**
+     * Batched re-render. Fires once per microtask when any @reactive/@prop changes.
+     * Override this to render your component.
+     */
+    update() { }
+    /**
+     * Called after the very first update(). DOM is guaranteed to exist.
+     * Perfect for wiring up canvas, charts, third-party libs, or initial focus.
+     */
+    firstUpdated() { }
+    /**
+     * Return false to skip this render cycle. Called before each update().
+     * Default: always renders.
+     */
+    shouldUpdate() {
+        return true;
+    }
+    // ── Batching internals ──
+    _updateScheduled = false;
+    _hasUpdated = false;
+    /** Called by @reactive setters — batches via microtask */
+    scheduleUpdate() {
+        if (this._updateScheduled)
+            return;
+        this._updateScheduled = true;
+        queueMicrotask(() => {
+            this._updateScheduled = false;
+            if (!this.shouldUpdate())
+                return;
+            // Dirty all @computed caches
+            for (const dirtyKey of this[COMPUTED_DIRTY] ?? []) {
+                this[dirtyKey] = true;
+            }
+            const result = this.update();
+            // Auto-morph if update() returned DOM nodes
+            if (result != null) {
+                morph(this.shadow, result);
+            }
+            if (!this._hasUpdated) {
+                this._hasUpdated = true;
+                this.firstUpdated();
+            }
+        });
+    }
+    /**
+     * Re-run lifecycle from scratch (after @catch error).
+     * Cleans up, then re-connects.
+     */
+    retry() {
+        this.disconnectedCallback();
+        this._hasUpdated = false;
+        this.connectedCallback();
+    }
+}
+//# sourceMappingURL=element.js.map

package/dist/element.js.map

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

package/dist/event.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Loom — LoomEvent base class
+ *
+ * All events extend this. Gives you for free:
+ * - timestamp (auto-stamped)
+ * - clone(overrides?) — typed shallow clone
+ * - is(event) — static type guard
+ * - toJSON() — serialize to plain object
+ * - toString() — debug-friendly string
+ */
+import type { Constructor } from "./bus";
+export declare abstract class LoomEvent {
+    /** Auto-stamped on creation */
+    readonly timestamp: number;
+    /** Shallow clone with optional overrides */
+    clone(overrides?: Partial<this>): this;
+    /** Type guard — `if (SomeEvent.is(event))` */
+    static is<T extends LoomEvent>(this: Constructor<T>, event: unknown): event is T;
+    /** Serialize to plain object (strips methods) */
+    toJSON(): Record<string, unknown>;
+    /** Debug-friendly string */
+    toString(): string;
+}
+//# sourceMappingURL=event.d.ts.map

package/dist/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC,8BAAsB,SAAS;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,SAAc;IAEhC,4CAA4C;IAC5C,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAQtC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,SAAS,EAC3B,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC;IAIb,iDAAiD;IACjD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQjC,4BAA4B;IAC5B,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/event.js

@@ -0,0 +1,35 @@
+/**
+ * Loom — LoomEvent base class
+ *
+ * All events extend this. Gives you for free:
+ * - timestamp (auto-stamped)
+ * - clone(overrides?) — typed shallow clone
+ * - is(event) — static type guard
+ * - toJSON() — serialize to plain object
+ * - toString() — debug-friendly string
+ */
+export class LoomEvent {
+    /** Auto-stamped on creation */
+    timestamp = Date.now();
+    /** Shallow clone with optional overrides */
+    clone(overrides) {
+        return Object.assign(Object.create(Object.getPrototypeOf(this)), this, overrides);
+    }
+    /** Type guard — `if (SomeEvent.is(event))` */
+    static is(event) {
+        return event instanceof this;
+    }
+    /** Serialize to plain object (strips methods) */
+    toJSON() {
+        const out = {};
+        for (const key of Object.keys(this)) {
+            out[key] = this[key];
+        }
+        return out;
+    }
+    /** Debug-friendly string */
+    toString() {
+        return `${this.constructor.name}(${JSON.stringify(this.toJSON())})`;
+    }
+}
+//# sourceMappingURL=event.js.map

package/dist/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,OAAgB,SAAS;IAC7B,+BAA+B;IACtB,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEhC,4CAA4C;IAC5C,KAAK,CAAC,SAAyB;QAC7B,OAAO,MAAM,CAAC,MAAM,CAClB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAC1C,IAAI,EACJ,SAAS,CACV,CAAC;IACJ,CAAC;IAED,8CAA8C;IAC9C,MAAM,CAAC,EAAE,CAEP,KAAc;QAEd,OAAO,KAAK,YAAY,IAAI,CAAC;IAC/B,CAAC;IAED,iDAAiD;IACjD,MAAM;QACJ,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,GAAG,CAAC,GAAG,CAAC,GAAI,IAAY,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,4BAA4B;IAC5B,QAAQ;QACN,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC;IACtE,CAAC;CACF"}

package/dist/icon.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Loom — Icon Component
+ *
+ * Reusable SVG icon wrapper with a static registry.
+ * Ships with zero built-in icons — register your own.
+ *
+ * Usage:
+ *   // Register icons (once, at boot)
+ *   LoomIcon.register("bolt", '<path d="M13 2 3 14h9l-1 8 10-12h-9l1-8z" />');
+ *
+ *   // Use anywhere in JSX
+ *   <loom-icon name="bolt" size={20} color="var(--accent)" />
+ */
+import { LoomElement } from "./element";
+export declare class LoomIcon extends LoomElement {
+    /** Icon name (must be registered via LoomIcon.register) */
+    name: string;
+    /** Size in pixels */
+    size: number;
+    /** Stroke color (CSS value) */
+    color: string;
+    /** Register an icon. `svgInner` is the SVG inner content (paths, circles, etc). */
+    static register(name: string, svgInner: string): void;
+    /** Register multiple icons at once. */
+    static registerAll(icons: Record<string, string>): void;
+    /** Check if an icon is registered. */
+    static has(name: string): boolean;
+    /** List all registered icon names. */
+    static get names(): string[];
+    /** Immediately apply size/color from attributes — runs before connectedCallback */
+    attributeChangedCallback(name: string, _old: string | null, val: string | null): void;
+    connectedCallback(): void;
+    update(): SVGSVGElement | HTMLSpanElement;
+}
+//# sourceMappingURL=icon.d.ts.map

package/dist/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../src/icon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AA4BxC,qBACa,QAAS,SAAQ,WAAW;IAEvC,2DAA2D;IACrD,IAAI,SAAM;IAEhB,qBAAqB;IACf,IAAI,SAAM;IAEhB,+BAA+B;IACzB,KAAK,SAAkB;IAE7B,mFAAmF;IACnF,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrD,uCAAuC;IACvC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAMvD,sCAAsC;IACtC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,sCAAsC;IACtC,MAAM,KAAK,KAAK,IAAI,MAAM,EAAE,CAE3B;IAED,mFAAmF;IACnF,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAU9E,iBAAiB;IASjB,MAAM;CAiBP"}