@shamar/wire 0.3.0

package/dist/component.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Public state for a Wire component. Only keys present on `data` are
+ * accepted from the browser.
+ */
+export interface WireEffects {
+    /** Full URL or path. The browser navigates after this response. */
+    redirect?: string;
+}
+export interface WireComponent {
+    data: Record<string, unknown>;
+    /** Response-only effects. Not stored in the signed snapshot. */
+    effects?: WireEffects;
+    updating?(key: string, value: unknown): Promise<void> | void;
+    /** Called after a public property changes. */
+    updated?(key: string): Promise<void> | void;
+    /** Called for `wire:click` style actions. */
+    call?(method: string, params: unknown[]): Promise<void> | void;
+}
+export declare function applyUpdates(component: WireComponent, updates: Record<string, unknown> | undefined): string[];
+export declare function invokeMethod(component: WireComponent, method: string, params?: unknown[]): Promise<void>;
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,gEAAgE;IAChE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,QAAQ,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,8CAA8C;IAC9C,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,6CAA6C;IAC7C,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChE;AAYD,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAS7G;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,OAAO,EAAO,GACrB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/component.js

@@ -0,0 +1,32 @@
+const BLOCKED = new Set([
+    'data',
+    'updated',
+    'call',
+    'constructor',
+    'hydrate',
+    'dehydrate',
+    'render',
+]);
+export function applyUpdates(component, updates) {
+    if (!updates)
+        return [];
+    const changed = [];
+    for (const [key, value] of Object.entries(updates)) {
+        if (!(key in component.data) || BLOCKED.has(key))
+            continue;
+        component.data[key] = value;
+        changed.push(key);
+    }
+    return changed;
+}
+export async function invokeMethod(component, method, params = []) {
+    if (!method || BLOCKED.has(method) || method.startsWith('_')) {
+        throw new Error(`Unknown wire method: ${method}`);
+    }
+    const target = component;
+    const fn = target[method];
+    if (typeof fn !== 'function')
+        throw new Error(`Unknown wire method: ${method}`);
+    await fn.apply(component, params);
+}
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;IACtB,MAAM;IACN,SAAS;IACT,MAAM;IACN,aAAa;IACb,SAAS;IACT,WAAW;IACX,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,SAAwB,EAAE,OAA4C;IACjG,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC3D,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAwB,EACxB,MAAc,EACd,SAAoB,EAAE;IAEtB,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAG,SAA+C,CAAC;IAC/D,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IAChF,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/html.d.ts

@@ -0,0 +1,3 @@
+export declare function escapeHtml(value: string): string;
+export declare function escapeAttr(value: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/html.js

@@ -0,0 +1,11 @@
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+export function escapeAttr(value) {
+    return escapeHtml(value).replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/** Absolute path to the browser runtime (`wire.js`). Serve this file yourself, or let `registerWire` in `@shamar/adonis` serve it. */
+export declare function wireClientPath(): string;
+export { escapeAttr, escapeHtml } from './html.js';
+export { applyUpdates, invokeMethod, type WireComponent, type WireEffects } from './component.js';
+export { newComponentId, signSnapshot, verifySnapshot, type WireSnapshot } from './snapshot.js';
+export { WireKernel, type WireDefinition, type WireEnvelope, type WireRequest } from './kernel.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,sIAAsI;AACtI,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** Absolute path to the browser runtime (`wire.js`). Serve this file yourself, or let `registerWire` in `@shamar/adonis` serve it. */
+export function wireClientPath() {
+    return join(dirname(fileURLToPath(import.meta.url)), '../client/wire.js');
+}
+export { escapeAttr, escapeHtml } from './html.js';
+export { applyUpdates, invokeMethod } from './component.js';
+export { newComponentId, signSnapshot, verifySnapshot } from './snapshot.js';
+export { WireKernel } from './kernel.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":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,sIAAsI;AACtI,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAC5E,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAwC,MAAM,gBAAgB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAqB,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,UAAU,EAA4D,MAAM,aAAa,CAAC"}

package/dist/kernel.d.ts

@@ -0,0 +1,43 @@
+import { type WireComponent } from './component.js';
+import { type WireSnapshot } from './snapshot.js';
+export interface WireDefinition {
+    create(): WireComponent;
+    /**
+     * Reload server-owned state after the snapshot is restored and before
+     * the request's updates and calls run. Use this for lists that live in a
+     * store, and keep client flags (such as `open`) yourself.
+     */
+    refresh?(component: WireComponent): Promise<void> | void;
+    /** `slots` holds already-rendered child islands, keyed by slot name. */
+    render(component: WireComponent, slots?: Record<string, string>): string;
+}
+export interface WireRequest {
+    snapshot: WireSnapshot;
+    updates?: Record<string, unknown>;
+    calls?: Array<{
+        method: string;
+        params?: unknown[];
+    }>;
+}
+export interface WireEnvelope {
+    snapshot: WireSnapshot;
+    html: string;
+    effects?: WireComponent['effects'];
+}
+export declare class WireKernel {
+    private readonly secret;
+    private readonly components;
+    constructor(secret: string, components: Record<string, WireDefinition>);
+    /**
+     * `slots` maps a slot name to a child component name. Children are separate
+     * islands: they keep their own snapshot and the browser does not morph them
+     * when the parent re-renders.
+     */
+    mount(name: string, endpoint: string, slots?: Record<string, string>, state?: Record<string, unknown>): WireEnvelope;
+    update(request: WireRequest, endpoint: string): Promise<WireEnvelope>;
+    private mountChildren;
+    private renderChildren;
+    private require;
+    private island;
+}
+//# sourceMappingURL=kernel.d.ts.map

package/dist/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAgD,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAEhG,MAAM,WAAW,cAAc;IAC7B,MAAM,IAAI,aAAa,CAAC;IACxB;;;;OAIG;IACH,OAAO,CAAC,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACzD,wEAAwE;IACxE,MAAM,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;CAC1E;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CACvD;AAgBD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACpC;AAED,qBAAa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAG7D;;;;OAIG;IACH,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,YAAY;IAqBT,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwC3E,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;IAmBtB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,MAAM;CAIf"}

package/dist/kernel.js

@@ -0,0 +1,129 @@
+import { escapeAttr } from './html.js';
+import { invokeMethod } from './component.js';
+import { newComponentId, signSnapshot, verifySnapshot } from './snapshot.js';
+/**
+ * HTML attributes arrive as strings. When the class field is a number or
+ * boolean, `<wire:counter count="4" />` should still seed that field.
+ */
+function seedValue(current, incoming) {
+    if (typeof current === 'number' && typeof incoming === 'string' && /^-?\d+(\.\d+)?$/.test(incoming)) {
+        return Number(incoming);
+    }
+    if (typeof current === 'boolean' && typeof incoming === 'string') {
+        return incoming === 'true' || incoming === '1';
+    }
+    return incoming;
+}
+export class WireKernel {
+    secret;
+    components;
+    constructor(secret, components) {
+        this.secret = secret;
+        this.components = components;
+    }
+    /**
+     * `slots` maps a slot name to a child component name. Children are separate
+     * islands: they keep their own snapshot and the browser does not morph them
+     * when the parent re-renders.
+     */
+    mount(name, endpoint, slots, state) {
+        const definition = this.require(name);
+        const component = definition.create();
+        if (state) {
+            for (const [key, value] of Object.entries(state)) {
+                if (key in component.data)
+                    component.data[key] = seedValue(component.data[key], value);
+            }
+        }
+        const nested = this.mountChildren(slots, endpoint);
+        const snapshot = signSnapshot(this.secret, {
+            id: newComponentId(),
+            name,
+            data: { ...component.data },
+            children: nested.snapshots,
+        });
+        return {
+            snapshot,
+            html: this.island(endpoint, snapshot, definition.render(component, nested.html)),
+        };
+    }
+    async update(request, endpoint) {
+        const incoming = request?.snapshot;
+        if (!incoming || !verifySnapshot(this.secret, incoming)) {
+            throw new Error('Invalid wire snapshot');
+        }
+        const definition = this.require(incoming.name);
+        const component = definition.create();
+        for (const key of Object.keys(component.data)) {
+            if (key in (incoming.data ?? {}))
+                component.data[key] = incoming.data[key];
+        }
+        await definition.refresh?.(component);
+        for (const [key, value] of Object.entries(request.updates ?? {})) {
+            if (!(key in component.data))
+                continue;
+            await component.updating?.(key, value);
+            component.data[key] = value;
+            await component.updated?.(key);
+            const specific = `updated${key.charAt(0).toUpperCase()}${key.slice(1)}`;
+            const hook = component[specific];
+            if (typeof hook === 'function')
+                await hook.call(component);
+        }
+        for (const call of request.calls ?? []) {
+            await invokeMethod(component, call.method, call.params ?? []);
+        }
+        const nested = this.renderChildren(incoming.children, endpoint);
+        const snapshot = signSnapshot(this.secret, {
+            id: incoming.id,
+            name: incoming.name,
+            data: { ...component.data },
+            children: incoming.children,
+        });
+        const effects = component.effects?.redirect ? { redirect: component.effects.redirect } : undefined;
+        return {
+            snapshot,
+            html: this.island(endpoint, snapshot, definition.render(component, nested)),
+            effects,
+        };
+    }
+    mountChildren(slots, endpoint) {
+        if (!slots || Object.keys(slots).length === 0)
+            return { html: {} };
+        const snapshots = {};
+        const html = {};
+        for (const [slot, childName] of Object.entries(slots)) {
+            const child = this.mount(childName, endpoint);
+            snapshots[slot] = child.snapshot;
+            html[slot] = child.html;
+        }
+        return { snapshots, html };
+    }
+    renderChildren(children, endpoint) {
+        const html = {};
+        for (const [slot, child] of Object.entries(children ?? {})) {
+            if (!verifySnapshot(this.secret, child)) {
+                throw new Error('Invalid wire snapshot');
+            }
+            const definition = this.require(child.name);
+            const component = definition.create();
+            for (const key of Object.keys(component.data)) {
+                if (key in (child.data ?? {}))
+                    component.data[key] = child.data[key];
+            }
+            html[slot] = this.island(endpoint, child, definition.render(component));
+        }
+        return html;
+    }
+    require(name) {
+        const definition = this.components[name];
+        if (!definition)
+            throw new Error(`Unknown wire component: ${name}`);
+        return definition;
+    }
+    island(endpoint, snapshot, inner) {
+        const json = escapeAttr(JSON.stringify(snapshot));
+        return `<div wire:id="${escapeAttr(snapshot.id)}" wire:snapshot="${json}" wire:endpoint="${escapeAttr(endpoint)}">${inner}</div>`;
+    }
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

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

package/dist/snapshot.d.ts

@@ -0,0 +1,12 @@
+export interface WireSnapshot {
+    id: string;
+    name: string;
+    data: Record<string, unknown>;
+    checksum: string;
+    /** Stable child islands, keyed by slot name. Each child is signed on its own. */
+    children?: Record<string, WireSnapshot>;
+}
+export declare function newComponentId(): string;
+export declare function signSnapshot(secret: string, snapshot: Omit<WireSnapshot, 'checksum'>): WireSnapshot;
+export declare function verifySnapshot(secret: string, snapshot: WireSnapshot): boolean;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAUD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GACvC,YAAY,CAOd;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAW9E"}

package/dist/snapshot.js

@@ -0,0 +1,33 @@
+import { createHmac, randomBytes, timingSafeEqual } from 'node:crypto';
+export function newComponentId() {
+    return randomBytes(8).toString('hex');
+}
+function canonical(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map((item) => canonical(item)).join(',')}]`;
+    const record = value;
+    const keys = Object.keys(record).sort();
+    return `{${keys.map((key) => `${JSON.stringify(key)}:${canonical(record[key])}`).join(',')}}`;
+}
+export function signSnapshot(secret, snapshot) {
+    const checksum = createHmac('sha256', secret)
+        .update(`${snapshot.id}:${snapshot.name}:${canonical(snapshot.data)}:${canonical(snapshot.children ?? null)}`)
+        .digest('hex');
+    return { ...snapshot, checksum };
+}
+export function verifySnapshot(secret, snapshot) {
+    const expected = signSnapshot(secret, {
+        id: snapshot.id,
+        name: snapshot.name,
+        data: snapshot.data,
+        children: snapshot.children,
+    });
+    const left = Buffer.from(expected.checksum);
+    const right = Buffer.from(String(snapshot.checksum ?? ''));
+    if (left.length !== right.length)
+        return false;
+    return timingSafeEqual(left, right);
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWvE,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvF,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,QAAwC;IAExC,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC1C,MAAM,CACL,GAAG,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC,EAAE,CACtG;SACA,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAsB;IACnE,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE;QACpC,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,eAAe,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@shamar/wire",
+  "version": "0.3.0",
+  "description": "Server-driven reactive components. Usable on its own or inside a Shamar admin panel.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/coolsam726/shamar.git",
+    "directory": "packages/wire"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client/wire.js": "./client/wire.js"
+  },
+  "files": [
+    "dist",
+    "client"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "tsx --test test/**/*.test.ts"
+  }
+}