@nisli/core 0.50.0 → 0.52.0

package/dist/esbuild-hmr/plugin.js

@@ -1,183 +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$/;
-/**
- * `transformSource` (wrap `component()` call sites) now lives in the shared
- * `../hmr/transform.js` and is re-exported here so this module's surface — and
- * the tests that import it from './plugin.js' — are unchanged (ADR 0110).
- */
-import { transformSource } from '../hmr/transform.js';
-export { transformSource };
-/**
- * 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 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,86 +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.
- */
-export { __register, pendingRemountCount, drainRemounts, remount, __resetRegistry, type HmrSetup, } from '../hmr/registry.js';
-/** 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;
-}
-/**
- * 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>;

package/dist/esbuild-hmr/runtime.js

@@ -1,163 +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.
- */
-// ── Types ───────────────────────────────────────────────────────────
-// Transport-agnostic registry/remount core lives in ../hmr/registry.js and is
-// shared with the Vite adapter (ADR 0110). Re-exported here so this module's
-// public surface — and the tests that import from './runtime.js' — are
-// unchanged by the extraction.
-export { __register, pendingRemountCount, drainRemounts, remount, __resetRegistry, } from '../hmr/registry.js';
-import { beginManualDrain, drainRemounts, endManualDrain, pendingRemountCount } from '../hmr/registry.js';
-// ── 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.
-        beginManualDrain();
-        try {
-            await deps.reimport();
-        }
-        finally {
-            endManualDrain();
-        }
-        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;

package/dist/esbuild-hmr/server.js

@@ -1,87 +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.
- */
-/// <reference types="node" />
-import { createServer } from 'node:http';
-/**
- * Create a standalone SSE hub. Returns immediately; call `listen()` to bind.
- * The plugin calls `broadcast()` from its `onEnd` after each watch rebuild.
- */
-export function createHmrServer(options = {}) {
-    const path = options.path ?? '/esbuild';
-    const clients = new Set();
-    const server = createServer((req, res) => {
-        if (req.url !== path) {
-            res.statusCode = 404;
-            res.end();
-            return;
-        }
-        // SSE handshake.
-        res.writeHead(200, {
-            'Content-Type': 'text/event-stream',
-            'Cache-Control': 'no-cache',
-            Connection: 'keep-alive',
-            'Access-Control-Allow-Origin': '*',
-        });
-        res.write('retry: 500\n\n');
-        clients.add(res);
-        req.on('close', () => {
-            clients.delete(res);
-        });
-    });
-    const broadcast = (payload) => {
-        const frame = `event: change\ndata: ${JSON.stringify(payload)}\n\n`;
-        for (const res of clients) {
-            try {
-                res.write(frame);
-            }
-            catch {
-                clients.delete(res);
-            }
-        }
-    };
-    return {
-        server,
-        broadcast,
-        get clientCount() {
-            return clients.size;
-        },
-        listen(port = 0, host = '127.0.0.1') {
-            return new Promise((resolve) => {
-                server.listen(port, host, () => {
-                    const addr = server.address();
-                    const boundPort = typeof addr === 'object' && addr ? addr.port : port;
-                    resolve({ port: boundPort, host });
-                });
-            });
-        },
-        close() {
-            return new Promise((resolve) => {
-                for (const res of clients) {
-                    try {
-                        res.end();
-                    }
-                    catch {
-                        /* ignore */
-                    }
-                }
-                clients.clear();
-                server.close(() => resolve());
-            });
-        },
-    };
-}
-//# sourceMappingURL=server.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/esbuild-hmr/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAA0D,MAAM,WAAW,CAAC;AAgCjG;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE1C,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAoB,EAAE,GAAmB,EAAE,EAAE;QACxE,IAAI,GAAG,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;YACrB,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QACD,iBAAiB;QACjB,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACjB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;YACxB,6BAA6B,EAAE,GAAG;SACnC,CAAC,CAAC;QACH,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,OAAsB,EAAQ,EAAE;QACjD,MAAM,KAAK,GAAG,wBAAwB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;QACpE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,MAAM;QACN,SAAS;QACT,IAAI,WAAW;YACb,OAAO,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC;QACD,MAAM,CAAC,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,WAAW;YACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE;oBAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC9B,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;oBACtE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK;YACH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,GAAG,CAAC,GAAG,EAAE,CAAC;oBACZ,CAAC;oBAAC,MAAM,CAAC;wBACP,YAAY;oBACd,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChB,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}