@toyz/loom 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 toyz
+
+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/README.md

@@ -0,0 +1,108 @@
+<p align="center">
+  <img src="https://toyz.github.io/loom/loom-logo.svg" alt="Loom" width="80" />
+</p>
+
+<h1 align="center">Loom</h1>
+
+<p align="center">
+  Decorator-driven web components that started as a meme and accidentally became useful.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@toyz/loom"><img src="https://img.shields.io/npm/v/@toyz/loom?color=c084fc&label=npm" alt="npm" /></a>
+  <a href="https://toyz.github.io/loom/"><img src="https://img.shields.io/badge/docs-live-86efac" alt="docs" /></a>
+  <a href="https://placing.space"><img src="https://img.shields.io/badge/used%20on-placing.space-67e8f9" alt="placing.space" /></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/license-MIT-fbbf24" alt="MIT" /></a>
+</p>
+
+---
+
+## What is this?
+
+Loom was born out of pure spite for boilerplate. What began as an ironic "what if decorators did _everything_?" experiment turned into a genuinely useful framework for building web components.
+
+It powers [placing.space](https://placing.space) in production — a real-time collaborative pixel canvas — so it's been battle-tested with WebSocket streams, thousands of DOM nodes, and zero framework overhead.
+
+## Features
+
+- **`@component`** — register custom elements in one line
+- **`@reactive` / `@prop`** — fine-grained reactivity that only re-renders what changed
+- **`@computed` / `@watch`** — derived state and side effects
+- **`@on` / `@emit`** — declarative event handling
+- **JSX + DOM morphing** — write JSX, get surgical DOM patches (no virtual DOM)
+- **`@inject` / `@service`** — dependency injection container
+- **Hash & history router** — `@route`, `@guard`, `<loom-outlet>`
+- **`css\`\``** — adopted stylesheets with zero FOUC
+- **`<loom-virtual>`** — virtualized list for huge datasets
+- **Zero dependencies** — just TypeScript and the platform
+
+## Install
+
+```bash
+npm install @toyz/loom
+```
+
+## Quick Start
+
+```ts
+import { LoomElement, component, reactive, css } from "@toyz/loom";
+
+const styles = css`
+  button { padding: 0.5rem 1rem; border-radius: 6px; cursor: pointer; }
+  span   { font-weight: bold; margin-left: 0.5rem; }
+`;
+
+@component("click-counter")
+class ClickCounter extends LoomElement {
+  @reactive count = 0;
+
+  update() {
+    this.shadow.adoptedStyleSheets = [styles];
+    return (
+      <button onClick={() => this.count++}>
+        Clicks: <span>{this.count}</span>
+      </button>
+    );
+  }
+}
+```
+
+```html
+<click-counter></click-counter>
+<script type="module" src="./main.ts"></script>
+```
+
+## TSConfig
+
+Loom ships its own JSX runtime. Point your config at it:
+
+```json
+{
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "@toyz/loom"
+  }
+}
+```
+
+For Vite:
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  esbuild: {
+    jsx: "automatic",
+    jsxImportSource: "@toyz/loom",
+  },
+});
+```
+
+## Docs
+
+Full documentation with interactive examples:
+
+**[toyz.github.io/loom](https://toyz.github.io/loom/)**
+
+## License
+
+[MIT](./LICENSE) — do whatever you want with it.

package/dist/app.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Loom — Application entry point
+ *
+ * Boots the render loop, instantiates @service singletons,
+ * runs @factory methods, and registers @component custom elements.
+ *
+ * ```ts
+ * import { app } from "loom";
+ *
+ * app
+ *   .use(natsConnection)
+ *   .use(chatClient)
+ *   .start();
+ * ```
+ */
+import { type Constructor, type Handler } from "./bus";
+import type { LoomEvent } from "./event";
+declare class LoomApp {
+    private providers;
+    private services;
+    private factories;
+    private components;
+    private _started;
+    /** Subscribe to a typed event. Returns unsubscribe function. */
+    on<T>(type: Constructor<T>, handler: Handler<T>): () => void;
+    /** Emit a typed event to all listeners. */
+    emit<T extends LoomEvent>(event: T): void;
+    /** Remove a specific event handler. */
+    off<T>(type: Constructor<T>, handler: Handler<T>): void;
+    /**
+     * Chainable provider registration.
+     *
+     *   app.use(instance)              — key auto-inferred from constructor
+     *   app.use(MyClass)               — class constructor, auto-instantiated
+     *   app.use(() => createThing())   — factory fn, key from result constructor
+     *   app.use(Key, instance)         — explicit key
+     *
+     * T is always optional — no magic typing forced.
+     */
+    use<T = any>(thing: T): this;
+    use<T = any>(key: any, instance: T): this;
+    /** Queue a @service class for auto-instantiation on start() */
+    registerService(ctor: any): void;
+    /** Queue a @factory method for invocation on start() */
+    registerFactory(key: any, proto: any, method: string): void;
+    /** Queue a @component for customElements.define() on start() */
+    register(tag: string, ctor: CustomElementConstructor): void;
+    /** Retrieve a provider/service by key. Throws if missing. */
+    get<T = any>(key: any): T;
+    /** Retrieve a provider/service, or undefined if not registered. */
+    maybe<T = any>(key: any): T | undefined;
+    /** Resolve @inject parameter metadata for a constructor or method. */
+    private resolveParams;
+    /**
+     * Boot the app:
+     *  1. Auto-instantiate @service singletons (with constructor @inject)
+     *  2. Run @factory methods (with parameter @inject)
+     *  3. Start the render loop
+     *  4. Register all @component custom elements
+     */
+    start(): Promise<void>;
+    /** Tear down — stop render loop */
+    stop(): void;
+    /** Whether the app has been started */
+    get started(): boolean;
+}
+/** Module-level singleton — the Loom app instance */
+export declare const app: LoomApp;
+export type { LoomApp };
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAO,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC,cAAM,OAAO;IACX,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,UAAU,CAAyD;IAC3E,OAAO,CAAC,QAAQ,CAAS;IAIzB,gEAAgE;IAChE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAE5D,2CAA2C;IAC3C,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAEzC,uCAAuC;IACvC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvD;;;;;;;;;OASG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAC5B,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI;IAuBzC,+DAA+D;IAC/D,eAAe,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IAIhC,wDAAwD;IACxD,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3D,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,IAAI;IAM3D,6DAA6D;IAC7D,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;IAQzB,mEAAmE;IACnE,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,SAAS;IAIvC,sEAAsE;IACtE,OAAO,CAAC,aAAa;IAWrB;;;;;;OAMG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C5B,mCAAmC;IACnC,IAAI,IAAI,IAAI;IAKZ,uCAAuC;IACvC,IAAI,OAAO,IAAI,OAAO,CAErB;CACF;AAED,qDAAqD;AACrD,eAAO,MAAM,GAAG,SAAgB,CAAC;AACjC,YAAY,EAAE,OAAO,EAAE,CAAC"}

package/dist/app.js

@@ -0,0 +1,152 @@
+/**
+ * Loom — Application entry point
+ *
+ * Boots the render loop, instantiates @service singletons,
+ * runs @factory methods, and registers @component custom elements.
+ *
+ * ```ts
+ * import { app } from "loom";
+ *
+ * app
+ *   .use(natsConnection)
+ *   .use(chatClient)
+ *   .start();
+ * ```
+ */
+import { renderLoop } from "./render-loop";
+import { INJECT_PARAMS, ON_HANDLERS } from "./decorators";
+import { bus } from "./bus";
+class LoomApp {
+    providers = new Map();
+    services = [];
+    factories = [];
+    components = [];
+    _started = false;
+    // ── Event bus (delegates to the module-level bus singleton) ──
+    /** Subscribe to a typed event. Returns unsubscribe function. */
+    on(type, handler) { return bus.on(type, handler); }
+    /** Emit a typed event to all listeners. */
+    emit(event) { bus.emit(event); }
+    /** Remove a specific event handler. */
+    off(type, handler) { bus.off(type, handler); }
+    use(keyOrThing, instance) {
+        if (instance !== undefined) {
+            // Explicit key: app.use(Key, value)
+            this.providers.set(keyOrThing, instance);
+        }
+        else if (typeof keyOrThing === "function") {
+            if (keyOrThing.prototype?.constructor === keyOrThing) {
+                // Class constructor → instantiate
+                this.providers.set(keyOrThing, new keyOrThing());
+            }
+            else {
+                // Factory function → call it
+                const result = keyOrThing();
+                this.providers.set(result.constructor, result);
+            }
+        }
+        else {
+            // Instance → key from constructor
+            this.providers.set(keyOrThing.constructor, keyOrThing);
+        }
+        return this;
+    }
+    // ── Registration (called by decorators) ──
+    /** Queue a @service class for auto-instantiation on start() */
+    registerService(ctor) {
+        this.services.push(ctor);
+    }
+    /** Queue a @factory method for invocation on start() */
+    registerFactory(key, proto, method) {
+        this.factories.push({ proto, method, key });
+    }
+    /** Queue a @component for customElements.define() on start() */
+    register(tag, ctor) {
+        this.components.push({ tag, ctor });
+    }
+    // ── Resolution ──
+    /** Retrieve a provider/service by key. Throws if missing. */
+    get(key) {
+        const v = this.providers.get(key);
+        if (v === undefined) {
+            throw new Error(`[loom] no provider for ${key?.name ?? key}`);
+        }
+        return v;
+    }
+    /** Retrieve a provider/service, or undefined if not registered. */
+    maybe(key) {
+        return this.providers.get(key);
+    }
+    /** Resolve @inject parameter metadata for a constructor or method. */
+    resolveParams(proto, method) {
+        const meta = proto?.[INJECT_PARAMS] ?? [];
+        const params = meta
+            .filter((m) => m.method === method)
+            .sort((a, b) => a.index - b.index);
+        return params.map((m) => this.get(m.key));
+    }
+    // ── Lifecycle ──
+    /**
+     * Boot the app:
+     *  1. Auto-instantiate @service singletons (with constructor @inject)
+     *  2. Run @factory methods (with parameter @inject)
+     *  3. Start the render loop
+     *  4. Register all @component custom elements
+     */
+    async start() {
+        if (this._started)
+            return;
+        // 1. Instantiate @service singletons and wire @on handlers
+        for (const Svc of this.services) {
+            if (!this.providers.has(Svc)) {
+                const args = this.resolveParams(Svc.prototype, "constructor");
+                this.providers.set(Svc, new Svc(...args));
+            }
+            // Wire @on event handlers (bus events + DOM events)
+            const instance = this.providers.get(Svc);
+            for (const handler of instance[ON_HANDLERS] ?? []) {
+                if (handler.domTarget) {
+                    // DOM EventTarget: @on(window, "resize")
+                    handler.domTarget.addEventListener(handler.event, (e) => instance[handler.key](e));
+                }
+                else {
+                    // Bus event: @on(ColorSelect)
+                    bus.on(handler.type, (e) => instance[handler.key](e));
+                }
+            }
+        }
+        // 2. Run @factory methods on instantiated services
+        for (const { proto, method, key } of this.factories) {
+            // Find the service instance that owns this factory method
+            const svc = this.providers.get(proto.constructor);
+            if (!svc)
+                continue;
+            const args = this.resolveParams(proto, method);
+            const result = await svc[method](...args);
+            if (result != null) {
+                this.providers.set(key ?? result.constructor, result);
+            }
+        }
+        // 3. Start render loop
+        renderLoop.start();
+        // 4. Register all queued custom elements
+        for (const { tag, ctor } of this.components) {
+            if (!customElements.get(tag)) {
+                customElements.define(tag, ctor);
+            }
+        }
+        this._started = true;
+    }
+    /** Tear down — stop render loop */
+    stop() {
+        renderLoop.stop();
+        this._started = false;
+    }
+    /** Whether the app has been started */
+    get started() {
+        return this._started;
+    }
+}
+/** Module-level singleton — the Loom app instance */
+export const app = new LoomApp();
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAkC,MAAM,OAAO,CAAC;AAS5D,MAAM,OAAO;IACH,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;IAChC,QAAQ,GAAU,EAAE,CAAC;IACrB,SAAS,GAAkB,EAAE,CAAC;IAC9B,UAAU,GAAsD,EAAE,CAAC;IACnE,QAAQ,GAAG,KAAK,CAAC;IAEzB,gEAAgE;IAEhE,gEAAgE;IAChE,EAAE,CAAI,IAAoB,EAAE,OAAmB,IAAgB,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAE9F,2CAA2C;IAC3C,IAAI,CAAsB,KAAQ,IAAU,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE9D,uCAAuC;IACvC,GAAG,CAAI,IAAoB,EAAE,OAAmB,IAAU,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAgBnF,GAAG,CAAC,UAAe,EAAE,QAAc;QACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,oCAAoC;YACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,OAAO,UAAU,KAAK,UAAU,EAAE,CAAC;YAC5C,IAAI,UAAU,CAAC,SAAS,EAAE,WAAW,KAAK,UAAU,EAAE,CAAC;gBACrD,kCAAkC;gBAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,UAAU,EAAE,CAAC,CAAC;YACnD,CAAC;iBAAM,CAAC;gBACN,6BAA6B;gBAC7B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,kCAAkC;YAClC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAE5C,+DAA+D;IAC/D,eAAe,CAAC,IAAS;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,wDAAwD;IACxD,eAAe,CAAC,GAAQ,EAAE,KAAU,EAAE,MAAc;QAClD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,gEAAgE;IAChE,QAAQ,CAAC,GAAW,EAAE,IAA8B;QAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,mBAAmB;IAEnB,6DAA6D;IAC7D,GAAG,CAAU,GAAQ;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,EAAE,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,CAAM,CAAC;IAChB,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAU,GAAQ;QACrB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAClD,CAAC;IAED,sEAAsE;IAC9D,aAAa,CAAC,KAAU,EAAE,MAAc;QAC9C,MAAM,IAAI,GACR,KAAK,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;aAClC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,kBAAkB;IAElB;;;;;;OAMG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,2DAA2D;QAC3D,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;gBAC9D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAC5C,CAAC;YACD,oDAAoD;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;oBACtB,yCAAyC;oBACzC,OAAO,CAAC,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5F,CAAC;qBAAM,CAAC;oBACN,8BAA8B;oBAC9B,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QAED,mDAAmD;QACnD,KAAK,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpD,0DAA0D;YAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC1C,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,UAAU,CAAC,KAAK,EAAE,CAAC;QAEnB,yCAAyC;QACzC,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,cAAc,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,mCAAmC;IACnC,IAAI;QACF,UAAU,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,OAAO,EAAE,CAAC"}

package/dist/bus.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Loom — EventBus (type-discriminated)
+ *
+ * Events are classes. The class constructor IS the channel key.
+ * No string registry, full type inference.
+ */
+import type { LoomEvent } from "./event";
+export type Constructor<T = any> = new (...args: any[]) => T;
+export type Handler<T> = (data: T) => void;
+export declare class EventBus {
+    private listeners;
+    /** Subscribe to a typed event. Returns unsubscribe function. */
+    on<T>(type: Constructor<T>, handler: Handler<T>): () => void;
+    /** Emit a typed event — dispatches to all handlers of that class */
+    emit<T extends LoomEvent>(event: T): void;
+    /** Remove a specific handler */
+    off<T>(type: Constructor<T>, handler: Handler<T>): void;
+    /** Remove all listeners for a given event type */
+    clear<T>(type: Constructor<T>): void;
+    /** Remove ALL listeners */
+    reset(): void;
+}
+/** Module-level default bus — used by LoomElement and available via import */
+export declare let bus: EventBus;
+/** Swap the global bus (for test isolation) */
+export declare function useBus(b: EventBus): void;
+//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAC7D,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE3C,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAA6C;IAE9D,gEAAgE;IAChE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAO5D,oEAAoE;IACpE,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAKzC,gCAAgC;IAChC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvD,kDAAkD;IAClD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIpC,2BAA2B;IAC3B,KAAK,IAAI,IAAI;CAGd;AAED,8EAA8E;AAC9E,eAAO,IAAI,GAAG,UAAiB,CAAC;AAEhC,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAExC"}

package/dist/bus.js

@@ -0,0 +1,41 @@
+/**
+ * Loom — EventBus (type-discriminated)
+ *
+ * Events are classes. The class constructor IS the channel key.
+ * No string registry, full type inference.
+ */
+export class EventBus {
+    listeners = new Map();
+    /** Subscribe to a typed event. Returns unsubscribe function. */
+    on(type, handler) {
+        if (!this.listeners.has(type))
+            this.listeners.set(type, new Set());
+        const set = this.listeners.get(type);
+        set.add(handler);
+        return () => set.delete(handler);
+    }
+    /** Emit a typed event — dispatches to all handlers of that class */
+    emit(event) {
+        const ctor = event.constructor;
+        this.listeners.get(ctor)?.forEach((h) => h(event));
+    }
+    /** Remove a specific handler */
+    off(type, handler) {
+        this.listeners.get(type)?.delete(handler);
+    }
+    /** Remove all listeners for a given event type */
+    clear(type) {
+        this.listeners.delete(type);
+    }
+    /** Remove ALL listeners */
+    reset() {
+        this.listeners.clear();
+    }
+}
+/** Module-level default bus — used by LoomElement and available via import */
+export let bus = new EventBus();
+/** Swap the global bus (for test isolation) */
+export function useBus(b) {
+    bus = b;
+}
+//# sourceMappingURL=bus.js.map

package/dist/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,OAAO,QAAQ;IACX,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAE9D,gEAAgE;IAChE,EAAE,CAAI,IAAoB,EAAE,OAAmB;QAC7C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACtC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAsB,KAAQ;QAChC,MAAM,IAAI,GAAI,KAAgB,CAAC,WAA0B,CAAC;QAC1D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,gCAAgC;IAChC,GAAG,CAAI,IAAoB,EAAE,OAAmB;QAC9C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAI,IAAoB;QAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,2BAA2B;IAC3B,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,CAAC,IAAI,GAAG,GAAG,IAAI,QAAQ,EAAE,CAAC;AAEhC,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,CAAW;IAChC,GAAG,GAAG,CAAC,CAAC;AACV,CAAC"}

package/dist/css.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Loom — CSS tagged template + cache
+ *
+ * Standalone css`` tag for creating reusable, cached CSSStyleSheets.
+ * Same CSS string → same CSSStyleSheet instance (deduped across components).
+ */
+/** Allowed types for css`` interpolation */
+export type CSSValue = string | number;
+/**
+ * Tagged template for creating cached CSSStyleSheets.
+ *
+ * ```ts
+ * const styles = css`
+ *   :host { display: block; }
+ *   button { padding: ${8}px; background: ${"#ff6b6b"}; }
+ * `;
+ * ```
+ */
+export declare function css(strings: TemplateStringsArray, ...values: CSSValue[]): CSSStyleSheet;
+/**
+ * Adopt a stylesheet into a shadow root from either a tagged template or string.
+ * Used internally by LoomElement.css().
+ */
+export declare function adoptCSS(shadow: ShadowRoot, stringsOrText: string | TemplateStringsArray, ...values: CSSValue[]): void;
+//# sourceMappingURL=css.d.ts.map

package/dist/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4CAA4C;AAC5C,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAKvC;;;;;;;;;GASG;AACH,wBAAgB,GAAG,CACjB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,QAAQ,EAAE,GACpB,aAAa,CASf;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,UAAU,EAClB,aAAa,EAAE,MAAM,GAAG,oBAAoB,EAC5C,GAAG,MAAM,EAAE,QAAQ,EAAE,GACpB,IAAI,CAgBN"}

package/dist/css.js

@@ -0,0 +1,48 @@
+/**
+ * Loom — CSS tagged template + cache
+ *
+ * Standalone css`` tag for creating reusable, cached CSSStyleSheets.
+ * Same CSS string → same CSSStyleSheet instance (deduped across components).
+ */
+/** Global cache — same CSS string → same CSSStyleSheet instance */
+const cssCache = new Map();
+/**
+ * Tagged template for creating cached CSSStyleSheets.
+ *
+ * ```ts
+ * const styles = css`
+ *   :host { display: block; }
+ *   button { padding: ${8}px; background: ${"#ff6b6b"}; }
+ * `;
+ * ```
+ */
+export function css(strings, ...values) {
+    const text = String.raw(strings, ...values);
+    let sheet = cssCache.get(text);
+    if (!sheet) {
+        sheet = new CSSStyleSheet();
+        sheet.replaceSync(text);
+        cssCache.set(text, sheet);
+    }
+    return sheet;
+}
+/**
+ * Adopt a stylesheet into a shadow root from either a tagged template or string.
+ * Used internally by LoomElement.css().
+ */
+export function adoptCSS(shadow, stringsOrText, ...values) {
+    const text = typeof stringsOrText === "string"
+        ? stringsOrText
+        : String.raw(stringsOrText, ...values);
+    const sheet = cssCache.get(text) ??
+        (() => {
+            const s = new CSSStyleSheet();
+            s.replaceSync(text);
+            cssCache.set(text, s);
+            return s;
+        })();
+    if (!shadow.adoptedStyleSheets.includes(sheet)) {
+        shadow.adoptedStyleSheets = [...shadow.adoptedStyleSheets, sheet];
+    }
+}
+//# sourceMappingURL=css.js.map

package/dist/css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,mEAAmE;AACnE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,UAAU,GAAG,CACjB,OAA6B,EAC7B,GAAG,MAAkB;IAErB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;IAC5C,IAAI,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;QAC5B,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACxB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,MAAkB,EAClB,aAA4C,EAC5C,GAAG,MAAkB;IAErB,MAAM,IAAI,GACR,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GACT,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAClB,CAAC,GAAG,EAAE;YACJ,MAAM,CAAC,GAAG,IAAI,aAAa,EAAE,CAAC;YAC9B,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACpB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtB,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/C,MAAM,CAAC,kBAAkB,GAAG,CAAC,GAAG,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/decorators/component.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Register a class as a custom element. Wires @prop observed attributes
+ * and attributeChangedCallback auto-parsing.
+ *
+ * ```ts
+ * @component("my-counter")
+ * class MyCounter extends LoomElement { ... }
+ * ```
+ */
+export declare function component(tag: string): (ctor: any) => void;
+//# sourceMappingURL=component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/decorators/component.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,IAC3B,MAAM,GAAG,UA8BlB"}

package/dist/decorators/component.js

@@ -0,0 +1,38 @@
+import { PROPS } from "./symbols";
+import { app } from "../app";
+/**
+ * Register a class as a custom element. Wires @prop observed attributes
+ * and attributeChangedCallback auto-parsing.
+ *
+ * ```ts
+ * @component("my-counter")
+ * class MyCounter extends LoomElement { ... }
+ * ```
+ */
+export function component(tag) {
+    return (ctor) => {
+        const propMap = ctor[PROPS] ?? new Map();
+        // Wire observedAttributes from @prop fields
+        Object.defineProperty(ctor, "observedAttributes", {
+            get: () => [...propMap.keys()],
+        });
+        // Wire attributeChangedCallback to update @prop fields
+        const origCallback = ctor.prototype.attributeChangedCallback;
+        ctor.prototype.attributeChangedCallback = function (name, _old, val) {
+            const field = propMap.get(name);
+            if (field && val !== null) {
+                const current = this[field];
+                if (typeof current === "number")
+                    this[field] = Number(val);
+                else if (typeof current === "boolean")
+                    this[field] = val !== null && val !== "false";
+                else
+                    this[field] = val;
+            }
+            origCallback?.call(this, name, _old, val);
+        };
+        app.register(tag, ctor);
+        ctor.__loom_tag = tag;
+    };
+}
+//# sourceMappingURL=component.js.map

package/dist/decorators/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/decorators/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,CAAC,IAAS,EAAE,EAAE;QACnB,MAAM,OAAO,GACV,IAAY,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEpC,4CAA4C;QAC5C,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,EAAE;YAChD,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;SAC/B,CAAC,CAAC;QAEH,uDAAuD;QACvD,MAAM,YAAY,GAAI,IAAI,CAAC,SAAiB,CAAC,wBAAwB,CAAC;QACrE,IAAI,CAAC,SAAiB,CAAC,wBAAwB,GAAG,UACjD,IAAY,EACZ,IAAmB,EACnB,GAAkB;YAElB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,KAAK,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAI,IAAY,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAAG,IAAY,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;qBAC/D,IAAI,OAAO,OAAO,KAAK,SAAS;oBAClC,IAAY,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,OAAO,CAAC;;oBACnD,IAAY,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;YAClC,CAAC;YACD,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAgC,CAAC,CAAC;QACnD,IAAY,CAAC,UAAU,GAAG,GAAG,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/di.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Auto-instantiated singleton. Registered on app.start().
+ * Constructor @inject params are resolved automatically.
+ *
+ * ```ts
+ * @service
+ * class BookmarkStore extends CollectionStore<Bookmark> { ... }
+ * ```
+ */
+export declare function service(ctor: any): void;
+/**
+ * Dual-mode dependency injection.
+ *
+ * Property:     @inject(Foo) foo!: Foo;
+ * Constructor:  constructor(@inject(Config) config: Config)
+ * Factory arg:  createChat(@inject(NatsConn) nc: NatsConn)
+ *
+ * T is optional — use for explicit typing if desired.
+ */
+export declare function inject<T = any>(key: any): (target: any, propOrMethod: string | undefined, index?: number) => void;
+/**
+ * Method decorator on @service classes.
+ * Return value is registered as a provider on app.start().
+ * Supports @inject on parameters. Async methods are awaited.
+ *
+ * ```ts
+ * @service
+ * class Boot {
+ *   @factory(ChatServiceNatsClient)
+ *   createChat(@inject(NatsConnection) nc: NatsConnection) {
+ *     return new ChatServiceNatsClient(nc);
+ *   }
+ * }
+ * ```
+ */
+export declare function factory(key?: any): (target: any, method: string) => void;
+//# sourceMappingURL=di.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"di.d.ts","sourceRoot":"","sources":["../../src/decorators/di.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAEvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAC9B,QAAQ,GAAG,EAAE,cAAc,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,UAiBtE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IACvB,QAAQ,GAAG,EAAE,QAAQ,MAAM,UAGpC"}