@nisli/core 0.49.2 → 0.51.0

package/dist/esbuild-hmr/plugin.js

@@ -1,219 +0,0 @@
-/**
- * esbuild-hmr/plugin.ts — Dev-only esbuild plugin for Nisli component HMR.
- *
- * DEV-ONLY, build-time (Node). Reachable only via `@nisli/core/esbuild-hmr`,
- * never from the runtime `.` entry (ADR 0021, Ruling 1). It is added to the
- * esbuild plugin list ONLY on the `--watch` path; `pnpm build` (no watch) never
- * sees it, so prod is byte-identical by construction (Ruling 5).
- *
- * `esbuild` is an OPTIONAL peerDependency. To keep `@nisli/core` dependency-free
- * we do NOT `import` esbuild here — we type the plugin against a minimal local
- * structural surface. The host build script supplies the real esbuild.
- *
- * What it does:
- *  1. onLoad (Ruling 2): for author modules that import `component` from
- *     `@nisli/core`, rewrite the import so `component(tag, setup, opts)` routes
- *     `setup` through the runtime tag-keyed registry's STABLE indirection thunk.
- *     The real `FrameworkComponent` thus captures a thunk that always reads the
- *     current setup — no class swap, no tag re-definition.
- *  2. onEnd (Ruling 4 transport): diff the metafile outputs against the previous
- *     build and broadcast a `change` payload ({added, removed, updated}) over
- *     SSE so the browser client can escalate (css/js/reload).
- *  3. Inject the browser dev client (`@nisli/core/esbuild-hmr/runtime` +
- *     `connect({ path })`) via esbuild's `inject` option pointed at a VIRTUAL
- *     shim module, so the runtime is RESOLVED + BUNDLED into the output (no
- *     author HTML/JS change needed). We deliberately do NOT use `banner`: a
- *     banner is raw passthrough text that esbuild neither resolves nor bundles,
- *     so a bare `import … from "@nisli/core/esbuild-hmr/runtime"` would leak
- *     verbatim into the output and the browser would throw
- *     `Failed to resolve module specifier` (no import map). `inject` runs the
- *     shim through onResolve/onLoad so the runtime is inlined at build time, and
- *     esbuild applies `inject` ONLY to JS modules — never to file/copy-loaded
- *     entries (e.g. the viewer's `logo.svg`). Verified empirically against
- *     esbuild 0.28.1.
- */
-/// <reference types="node" />
-import { readFileSync } from 'node:fs';
-// ── Source transform (Ruling 2) ─────────────────────────────────────
-const DEFAULT_FILTER = /\.[mc]?[jt]sx?$/;
-/**
- * Virtual path + namespace for the injected client shim. The path is a bare
- * sentinel (not a real file); onResolve claims it into a private namespace and
- * onLoad supplies its generated source, so esbuild bundles the runtime inline.
- */
-const CLIENT_SHIM_PATH = 'nisli-hmr-client-shim';
-const CLIENT_SHIM_NAMESPACE = 'nisli-hmr-shim';
-const CLIENT_SHIM_FILTER = /^nisli-hmr-client-shim$/;
-/**
- * Rewrite a module's source so the `component` it imports from `@nisli/core` is
- * wrapped by the registry indirection. Pure function — exported for testing.
- *
- * Strategy: alias the real import, then shadow `component` with a wrapper that
- * registers the setup and passes a STABLE thunk to the real `component`. The
- * wrapper is a no-op-shaped passthrough at runtime cost of one Map write +
- * one thunk allocation per `component()` call.
- *
- * Returns the original source unchanged if it does not import `component` from
- * the core specifier (nothing to wrap).
- */
-export function transformSource(code, coreSpecifier, runtimeSpecifier) {
-    const spec = escapeRegExp(coreSpecifier);
-    // Match a named import of `component` (alone or among others) from core.
-    const importRe = new RegExp(`import\\s*\\{([^}]*)\\}\\s*from\\s*['"]${spec}['"]`, 'g');
-    let importsComponent = false;
-    const rewritten = code.replace(importRe, (_full, names) => {
-        const parts = names.split(',').map((s) => s.trim()).filter(Boolean);
-        const next = parts.map((p) => {
-            // Handle `component` and `component as X` — we only wrap the bare name.
-            if (p === 'component') {
-                importsComponent = true;
-                return 'component as __nisliRealComponent';
-            }
-            return p;
-        });
-        return `import { ${next.join(', ')} } from '${coreSpecifier}'`;
-    });
-    if (!importsComponent)
-        return code;
-    // Prepend the registry-import + wrapper. `__register` returns the STABLE
-    // thunk the real component captures; the wrapper preserves the factory's
-    // return value and signature.
-    const preamble = `import { __register as __nisliRegister } from '${runtimeSpecifier}';\n` +
-        `function component(tag, setup, opts) {\n` +
-        `  return __nisliRealComponent(tag, __nisliRegister(tag, setup), opts);\n` +
-        `}\n`;
-    return preamble + rewritten;
-}
-/**
- * Source of the virtual client shim that esbuild's `inject` pulls into every JS
- * module. Because it is `inject`ed (not a `banner`), esbuild RESOLVES the
- * `runtimeSpecifier` import and BUNDLES `connect` inline — no bare specifier
- * survives in the output (the 0.49.0 bug). `clientUrl` is baked in so the
- * client targets the right SSE origin. Pure function — exported for testing.
- */
-export function clientShimSource(runtimeSpecifier, clientUrl) {
-    return (`import { connect as __nisliConnect } from '${runtimeSpecifier}';\n` +
-        `__nisliConnect({ path: ${JSON.stringify(clientUrl)} });\n`);
-}
-// ── The plugin ──────────────────────────────────────────────────────
-/**
- * Create the dev-only Nisli HMR esbuild plugin. Add it to `plugins` ONLY when
- * building with `--watch`; never on the prod build path.
- */
-export function nisliHmrPlugin(options) {
-    const coreSpecifier = options.coreSpecifier ?? '@nisli/core';
-    const runtimeSpecifier = options.runtimeSpecifier ?? '@nisli/core/esbuild-hmr/runtime';
-    const clientUrl = options.clientUrl ?? '/esbuild';
-    const filter = options.filter ?? DEFAULT_FILTER;
-    const { broadcaster } = options;
-    let prevHashes = null;
-    return {
-        name: 'nisli-hmr',
-        setup(build) {
-            // Inject the browser dev client via esbuild's `inject` (NOT `banner`).
-            // A banner is raw passthrough text — its bare `import` would leak into the
-            // output and the browser could not resolve it. `inject` points at a
-            // virtual shim that esbuild resolves + bundles, inlining the runtime so no
-            // bare specifier survives. esbuild applies `inject` only to JS modules, so
-            // the viewer's file/copy-loaded `logo.svg` entry is never touched.
-            build.initialOptions.inject = [
-                ...(build.initialOptions.inject ?? []),
-                CLIENT_SHIM_PATH,
-            ];
-            build.onResolve({ filter: CLIENT_SHIM_FILTER }, (args) => {
-                if (args.path !== CLIENT_SHIM_PATH)
-                    return undefined;
-                return { path: CLIENT_SHIM_PATH, namespace: CLIENT_SHIM_NAMESPACE };
-            });
-            build.onLoad({ filter: /.*/, namespace: CLIENT_SHIM_NAMESPACE }, () => ({
-                contents: clientShimSource(runtimeSpecifier, clientUrl),
-                loader: 'js',
-                // A virtual module has no on-disk location, so esbuild won't know where
-                // to resolve the runtime import from. Anchor it to the build's working
-                // directory (where the consumer's `@nisli/core` resolves).
-                resolveDir: build.initialOptions.absWorkingDir ?? process.cwd(),
-            }));
-            // 1. Transform: wrap component() call sites (Ruling 2).
-            build.onLoad({ filter }, (args) => {
-                if (args.path.includes('node_modules'))
-                    return undefined;
-                const code = readFileSafe(args.path);
-                if (code === null)
-                    return undefined;
-                const contents = transformSource(code, coreSpecifier, runtimeSpecifier);
-                if (contents === code)
-                    return undefined; // nothing to wrap; let esbuild load it
-                return { contents, loader: loaderFor(args.path) };
-            });
-            // 2. Diff outputs and broadcast a change payload (Ruling 4 transport).
-            build.onEnd((result) => {
-                const outputs = result.metafile?.outputs;
-                if (!outputs) {
-                    // No metafile -> cannot diff -> signal a reload-worthy change.
-                    broadcaster.broadcast({ added: [], removed: [], updated: [] });
-                    return;
-                }
-                const nextHashes = new Map();
-                for (const [path, meta] of Object.entries(outputs)) {
-                    nextHashes.set(path, meta.hash ?? String(meta.bytes));
-                }
-                const payload = diffOutputs(prevHashes, nextHashes);
-                prevHashes = nextHashes;
-                // First build establishes the baseline; don't broadcast on it.
-                if (payload)
-                    broadcaster.broadcast(payload);
-            });
-        },
-    };
-}
-/**
- * Diff two output-hash maps into an esbuild-shaped change payload.
- * Returns `null` for the very first build (no previous baseline).
- * Exported for testing.
- */
-export function diffOutputs(prev, next) {
-    if (prev === null)
-        return null;
-    const added = [];
-    const removed = [];
-    const updated = [];
-    for (const [path, hash] of next) {
-        const before = prev.get(path);
-        if (before === undefined)
-            added.push(path);
-        else if (before !== hash)
-            updated.push(path);
-    }
-    for (const path of prev.keys()) {
-        if (!next.has(path))
-            removed.push(path);
-    }
-    return { added, removed, updated };
-}
-// ── helpers ─────────────────────────────────────────────────────────
-function escapeRegExp(s) {
-    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-function loaderFor(path) {
-    if (path.endsWith('.tsx'))
-        return 'tsx';
-    if (path.endsWith('.jsx'))
-        return 'jsx';
-    if (/\.[mc]?ts$/.test(path))
-        return 'ts';
-    return 'js';
-}
-/**
- * Read a file synchronously. Build-time only (Node); returns null on failure so
- * esbuild falls back to its own loader. `node:fs` is fine here — this module is
- * never reachable from the `.` runtime graph (ADR 0021, Ruling 1).
- */
-function readFileSafe(path) {
-    try {
-        return readFileSync(path, 'utf8');
-    }
-    catch {
-        return null;
-    }
-}
-//# sourceMappingURL=plugin.js.map

package/dist/esbuild-hmr/plugin.js.map

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

package/dist/esbuild-hmr/runtime.d.ts

@@ -1,122 +0,0 @@
-/**
- * esbuild-hmr/runtime.ts — Browser dev client for Nisli HMR.
- *
- * DEV-ONLY. Reachable only via the `@nisli/core/esbuild-hmr/runtime` subpath,
- * which the esbuild plugin injects on the `--watch` path. It is NEVER imported
- * by the `@nisli/core` runtime `.` entry, so it contributes zero production
- * bytes (ADR 0021, Ruling 1 & 5).
- *
- * Responsibilities (ADR 0021):
- *  - A tag -> setup registry with a STABLE indirection thunk (Ruling 2).
- *  - remount() of live elements through the existing custom-element lifecycle:
- *    disconnectedCallback() -> replaceChildren() -> connectedCallback() (Ruling 3).
- *  - An EventSource client that classifies an esbuild `change` payload and
- *    escalates: CSS hot-swap -> component re-mount -> full reload (Ruling 4).
- *
- * The class is NEVER swapped and the tag is NEVER re-defined; we swap only the
- * `setup` behind the registry, working *with* the `customElements.get` guard in
- * component.ts rather than against it.
- */
-/** The author's setup function, kept opaque here (props proxy, host). */
-export type HmrSetup = (props: unknown, host: HTMLElement) => unknown;
-/** esbuild's `change` event payload shape (added/removed/updated paths). */
-export interface EsbuildChangePayload {
-    added: string[];
-    removed: string[];
-    updated: string[];
-}
-/** What to do with a change, decided from the output diff (Ruling 4). */
-export type HmrAction = 'css' | 'js' | 'reload';
-/** Minimal structural EventSource (avoids depending on DOM lib EventSource). */
-interface EventSourceLike {
-    addEventListener(type: string, listener: (ev: {
-        data?: string;
-    }) => void): void;
-    close?(): void;
-}
-/** Options for {@link connect}. Seams kept injectable for tests. */
-export interface ConnectOptions {
-    /** SSE endpoint. Defaults to esbuild's `/esbuild`. */
-    path?: string;
-    /**
-     * Factory for the EventSource. Defaults to the global `EventSource`.
-     * Injectable so the client logic is testable without a live SSE server.
-     */
-    eventSourceFactory?: (url: string) => EventSourceLike;
-    /**
-     * Re-import the rebuilt JS so the wrapper re-runs `__register` for changed
-     * tags. Defaults to a cache-busted dynamic import of the page's module
-     * scripts. Returns a promise resolving when re-evaluation is done.
-     */
-    reimport?: () => Promise<void>;
-    /** Force a full reload. Defaults to `location.reload()`. */
-    reload?: () => void;
-}
-/**
- * Register (or update) the setup for a tag and return a STABLE indirection
- * thunk that always reads the *current* setup from the registry.
- *
- * On the first registration for a tag (initial page load) no re-mount is
- * scheduled. On a subsequent registration with a *different* setup reference
- * (a watch rebuild re-evaluating the module) the tag is queued for re-mount.
- *
- * The returned thunk is what `component()` hands to the real
- * `FrameworkComponent`; because it reads `registry.get(tag)` lazily, the live
- * element picks up new setup without any class swap or tag re-definition.
- */
-export declare function __register(tag: string, setup: HmrSetup): HmrSetup;
-/** Number of tags awaiting a re-mount (for orchestration/tests). */
-export declare function pendingRemountCount(): number;
-/** Drain and re-mount every pending tag. Returns the tags that were remounted. */
-export declare function drainRemounts(): string[];
-/**
- * Re-mount every live element of `tag` in place, on the SAME instance:
- *
- *   disconnectedCallback()  — resets `_mounted`, disposes effects + template
- *                             (the ADR 0008.1 disposal contract)
- *   replaceChildren()       — clears old DOM, firing nested custom elements'
- *                             disconnectedCallback so their disposers run too
- *   connectedCallback()     — re-runs the NEW setup (via the registry thunk)
- *                             inside the same `untrack(...)` mount path
- *
- * Props survive because `_propsProxy` is constructor-owned (component.ts), and
- * the element node identity is preserved — siblings, scroll, route, and global
- * stores are untouched.
- */
-export declare function remount(tag: string): void;
-/** Test-only: clear the registry and pending state between cases. */
-export declare function __resetRegistry(): void;
-/**
- * Decide the action for an esbuild output diff:
- *  - every changed output is CSS  -> 'css'   (hot-swap, preserves everything)
- *  - any JS output changed        -> 'js'    (re-import; re-mount changed tags
- *                                             or escalate to reload if none)
- *  - nothing actionable           -> 'reload'
- */
-export declare function classifyChange(payload: EsbuildChangePayload): HmrAction;
-/**
- * Hot-swap stylesheets in place by re-pointing matching `<link>` hrefs with a
- * cache-busting query — no reload, no state loss (esbuild's documented CSS
- * technique). Returns the number of links swapped.
- */
-export declare function hotSwapCss(updated: string[]): number;
-/**
- * Connect to the SSE change channel and apply updates with escalation.
- * Safe to call once from the dev client; injected by the plugin in watch builds.
- */
-export declare function connect(options?: ConnectOptions): EventSourceLike;
-/** Close the active SSE connection (test/teardown). */
-export declare function disconnect(): void;
-/**
- * Apply a classified change. Exposed for tests so the escalation ladder is
- * verifiable without a live EventSource.
- *
- * For a JS change we re-import (re-runs the wrapper's `__register` calls); if no
- * tag's setup actually changed, the edit was a non-component module (util/
- * service) and we escalate to a full reload — the correct, safe fallback.
- */
-export declare function applyChange(payload: EsbuildChangePayload, deps: {
-    reimport: () => Promise<void>;
-    reload: () => void;
-}): Promise<HmrAction>;
-export {};

package/dist/esbuild-hmr/runtime.js

@@ -1,252 +0,0 @@
-/**
- * esbuild-hmr/runtime.ts — Browser dev client for Nisli HMR.
- *
- * DEV-ONLY. Reachable only via the `@nisli/core/esbuild-hmr/runtime` subpath,
- * which the esbuild plugin injects on the `--watch` path. It is NEVER imported
- * by the `@nisli/core` runtime `.` entry, so it contributes zero production
- * bytes (ADR 0021, Ruling 1 & 5).
- *
- * Responsibilities (ADR 0021):
- *  - A tag -> setup registry with a STABLE indirection thunk (Ruling 2).
- *  - remount() of live elements through the existing custom-element lifecycle:
- *    disconnectedCallback() -> replaceChildren() -> connectedCallback() (Ruling 3).
- *  - An EventSource client that classifies an esbuild `change` payload and
- *    escalates: CSS hot-swap -> component re-mount -> full reload (Ruling 4).
- *
- * The class is NEVER swapped and the tag is NEVER re-defined; we swap only the
- * `setup` behind the registry, working *with* the `customElements.get` guard in
- * component.ts rather than against it.
- */
-// ── Tag -> setup registry (Ruling 2) ────────────────────────────────
-const registry = new Map();
-/** Tags whose setup changed since the last drain — pending a re-mount. */
-const pendingRemounts = new Set();
-let remountScheduled = false;
-/**
- * When true, `__register` accumulates pending tags but does NOT auto-schedule a
- * microtask drain — `applyChange` owns the drain so it can wait for a full
- * module re-eval to register ALL changed tags first.
- */
-let suppressAutoDrain = false;
-/**
- * Register (or update) the setup for a tag and return a STABLE indirection
- * thunk that always reads the *current* setup from the registry.
- *
- * On the first registration for a tag (initial page load) no re-mount is
- * scheduled. On a subsequent registration with a *different* setup reference
- * (a watch rebuild re-evaluating the module) the tag is queued for re-mount.
- *
- * The returned thunk is what `component()` hands to the real
- * `FrameworkComponent`; because it reads `registry.get(tag)` lazily, the live
- * element picks up new setup without any class swap or tag re-definition.
- */
-export function __register(tag, setup) {
-    const prev = registry.get(tag);
-    registry.set(tag, setup);
-    if (prev !== undefined && prev !== setup) {
-        pendingRemounts.add(tag);
-        if (!suppressAutoDrain)
-            scheduleRemount();
-    }
-    return (props, host) => {
-        const current = registry.get(tag);
-        if (!current)
-            throw new Error(`[nisli-hmr] no setup registered for <${tag}>`);
-        return current(props, host);
-    };
-}
-/** Number of tags awaiting a re-mount (for orchestration/tests). */
-export function pendingRemountCount() {
-    return pendingRemounts.size;
-}
-/** Drain and re-mount every pending tag. Returns the tags that were remounted. */
-export function drainRemounts() {
-    const tags = [...pendingRemounts];
-    pendingRemounts.clear();
-    remountScheduled = false;
-    for (const tag of tags)
-        remount(tag);
-    return tags;
-}
-function scheduleRemount() {
-    if (remountScheduled)
-        return;
-    remountScheduled = true;
-    // Defer so a full module re-eval can register *all* changed tags first.
-    queueMicrotask(() => {
-        if (remountScheduled)
-            drainRemounts();
-    });
-}
-/**
- * Re-mount every live element of `tag` in place, on the SAME instance:
- *
- *   disconnectedCallback()  — resets `_mounted`, disposes effects + template
- *                             (the ADR 0008.1 disposal contract)
- *   replaceChildren()       — clears old DOM, firing nested custom elements'
- *                             disconnectedCallback so their disposers run too
- *   connectedCallback()     — re-runs the NEW setup (via the registry thunk)
- *                             inside the same `untrack(...)` mount path
- *
- * Props survive because `_propsProxy` is constructor-owned (component.ts), and
- * the element node identity is preserved — siblings, scroll, route, and global
- * stores are untouched.
- */
-export function remount(tag) {
-    const elements = document.querySelectorAll(tag);
-    elements.forEach((node) => {
-        const el = node;
-        // Dispose first: must run BEFORE clearing DOM or effects/subscriptions
-        // leak across reloads (ADR 0008.1 hazard).
-        el.disconnectedCallback?.();
-        // Clear old DOM — removal fires nested children's disconnectedCallback.
-        el.replaceChildren();
-        // Re-run setup + re-mount on the same instance.
-        el.connectedCallback?.();
-    });
-}
-/** Test-only: clear the registry and pending state between cases. */
-export function __resetRegistry() {
-    registry.clear();
-    pendingRemounts.clear();
-    remountScheduled = false;
-    suppressAutoDrain = false;
-}
-// ── Change classification + escalation (Ruling 4) ───────────────────
-const CSS_RE = /\.css($|\?)/;
-/**
- * Decide the action for an esbuild output diff:
- *  - every changed output is CSS  -> 'css'   (hot-swap, preserves everything)
- *  - any JS output changed        -> 'js'    (re-import; re-mount changed tags
- *                                             or escalate to reload if none)
- *  - nothing actionable           -> 'reload'
- */
-export function classifyChange(payload) {
-    const touched = [...payload.added, ...payload.removed, ...payload.updated];
-    if (touched.length === 0)
-        return 'reload';
-    if (touched.every((p) => CSS_RE.test(p)))
-        return 'css';
-    if (touched.some((p) => /\.[mc]?js($|\?)/.test(p)))
-        return 'js';
-    return 'reload';
-}
-/**
- * Hot-swap stylesheets in place by re-pointing matching `<link>` hrefs with a
- * cache-busting query — no reload, no state loss (esbuild's documented CSS
- * technique). Returns the number of links swapped.
- */
-export function hotSwapCss(updated) {
-    let swapped = 0;
-    const links = document.querySelectorAll('link[rel="stylesheet"]');
-    links.forEach((node) => {
-        const link = node;
-        const href = link.getAttribute('href');
-        if (!href)
-            return;
-        const base = href.split('?')[0] ?? href;
-        const matches = updated.some((u) => {
-            const uBase = (u.split('?')[0] ?? u).replace(/^\.?\//, '');
-            return uBase.endsWith(base.replace(/^\.?\//, ''));
-        });
-        if (matches) {
-            link.setAttribute('href', `${base}?t=${Date.now()}`);
-            swapped++;
-        }
-    });
-    return swapped;
-}
-// ── EventSource client (transport) ──────────────────────────────────
-let connected = null;
-/**
- * Connect to the SSE change channel and apply updates with escalation.
- * Safe to call once from the dev client; injected by the plugin in watch builds.
- */
-export function connect(options = {}) {
-    // Idempotency guard (critical for the bundled re-import model). The plugin
-    // injects `connect()` at the entry's top level, and a JS update re-evaluates
-    // the entry (so `__register` re-runs for changed tags). That re-eval also
-    // re-runs this `connect()` call. Because `connected` lives in the persistent
-    // HMR runtime chunk (re-imported entries reuse it by name, un-busted), the
-    // guard survives across re-imports and keeps EXACTLY ONE EventSource + change
-    // listener alive — otherwise listeners stack and each edit fans out into N
-    // compounding re-imports.
-    if (connected)
-        return connected;
-    const path = options.path ?? '/esbuild';
-    const reload = options.reload ?? (() => location.reload());
-    const reimport = options.reimport ?? defaultReimport;
-    const factory = options.eventSourceFactory ??
-        ((url) => new globalThis.EventSource(url));
-    const source = factory(path);
-    connected = source;
-    source.addEventListener('change', (ev) => {
-        let payload;
-        try {
-            payload = ev.data ? JSON.parse(ev.data) : { added: [], removed: [], updated: [] };
-        }
-        catch {
-            reload();
-            return;
-        }
-        void applyChange(payload, { reimport, reload });
-    });
-    return source;
-}
-/** Close the active SSE connection (test/teardown). */
-export function disconnect() {
-    connected?.close?.();
-    connected = null;
-}
-/**
- * Apply a classified change. Exposed for tests so the escalation ladder is
- * verifiable without a live EventSource.
- *
- * For a JS change we re-import (re-runs the wrapper's `__register` calls); if no
- * tag's setup actually changed, the edit was a non-component module (util/
- * service) and we escalate to a full reload — the correct, safe fallback.
- */
-export async function applyChange(payload, deps) {
-    const action = classifyChange(payload);
-    if (action === 'css') {
-        hotSwapCss(payload.updated);
-        return 'css';
-    }
-    if (action === 'js') {
-        // Own the drain: suppress the auto microtask so ALL changed tags register
-        // during re-import before any re-mount runs.
-        suppressAutoDrain = true;
-        remountScheduled = false;
-        try {
-            await deps.reimport();
-        }
-        finally {
-            suppressAutoDrain = false;
-        }
-        if (pendingRemountCount() > 0) {
-            drainRemounts();
-            return 'js';
-        }
-        // JS changed but no component setup changed -> non-component edit -> reload.
-        deps.reload();
-        return 'reload';
-    }
-    deps.reload();
-    return 'reload';
-}
-/**
- * Default re-import: re-fetch every module `<script type="module">` with a
- * cache-busting query so the bundle re-evaluates and the wrapper re-runs
- * `__register` for changed tags.
- */
-async function defaultReimport() {
-    const scripts = document.querySelectorAll('script[type="module"][src]');
-    const imports = [];
-    scripts.forEach((node) => {
-        const src = node.getAttribute('src');
-        if (src)
-            imports.push(import(/* @vite-ignore */ `${src.split('?')[0]}?t=${Date.now()}`));
-    });
-    await Promise.all(imports);
-}
-//# sourceMappingURL=runtime.js.map

package/dist/esbuild-hmr/runtime.js.map

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

package/dist/esbuild-hmr/server.d.ts

@@ -1,51 +0,0 @@
-/**
- * esbuild-hmr/server.ts — Tiny SSE hub for the Nisli HMR change channel.
- *
- * DEV-ONLY, Node, build-time. Reachable only via `@nisli/core/esbuild-hmr`,
- * never the runtime `.` entry (ADR 0021, Ruling 1). Uses only `node:http`
- * (a Node built-in, not a package dependency), so the zero-dep posture of the
- * `.` entry is preserved.
- *
- * Two ways to wire transport (ADR 0021 Engineering Plan §1):
- *   (a) Standalone: `createHmrServer()` starts a minimal `node:http` SSE hub at
- *       `/esbuild` (matching esbuild's own client convention) and returns a
- *       broadcaster the plugin pushes `change` payloads to.
- *   (b) BYO: any object implementing {@link ChangeBroadcaster} (e.g. an esbuild
- *       `serve` adapter that owns the `/esbuild` endpoint) can be handed to the
- *       plugin instead.
- */
-import { type Server } from 'node:http';
-/** esbuild-shaped change payload broadcast to dev clients. */
-export interface ChangePayload {
-    added: string[];
-    removed: string[];
-    updated: string[];
-}
-/** Anything that can push a `change` event to connected dev clients. */
-export interface ChangeBroadcaster {
-    /** Broadcast a change to every connected client. */
-    broadcast(payload: ChangePayload): void;
-    /** Current number of connected clients (for diagnostics/tests). */
-    readonly clientCount: number;
-}
-/** Handle for the standalone SSE hub. */
-export interface HmrServer extends ChangeBroadcaster {
-    /** The underlying `node:http` server (for `.address()`, lifecycle, tests). */
-    readonly server: Server;
-    /** Start listening. Resolves once bound. */
-    listen(port?: number, host?: string): Promise<{
-        port: number;
-        host: string;
-    }>;
-    /** Close all client connections and stop the server. */
-    close(): Promise<void>;
-}
-export interface CreateHmrServerOptions {
-    /** SSE route. Defaults to `/esbuild` (esbuild's client convention). */
-    path?: string;
-}
-/**
- * Create a standalone SSE hub. Returns immediately; call `listen()` to bind.
- * The plugin calls `broadcast()` from its `onEnd` after each watch rebuild.
- */
-export declare function createHmrServer(options?: CreateHmrServerOptions): HmrServer;