@alloy-js/core 0.23.0-dev.1 → 0.23.0-dev.8

package/dist/src/devtools/devtools-protocol.d.ts.map

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

package/dist/src/devtools/devtools-protocol.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=devtools-protocol.js.map

package/dist/src/devtools/devtools-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":[],"sourcesContent":[],"mappings":"","ignoreList":[]}

package/dist/src/devtools/devtools-server.browser.d.ts

@@ -0,0 +1,28 @@
+export interface DevtoolsMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export interface DevtoolsIncomingMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export interface DevtoolsServerInfo {
+    port: number;
+    connected: boolean;
+}
+export declare function isDevtoolsEnabled(): boolean;
+export declare function waitForDevtoolsConnection(): Promise<void>;
+export interface EnableDevtoolsOptions {
+    port?: number;
+    waitForConnection?: boolean;
+}
+export declare function enableDevtools(_options?: EnableDevtoolsOptions): Promise<void>;
+export declare function initDevtoolsIfEnabled(): Promise<void>;
+export declare function broadcastDevtoolsMessage(_message: DevtoolsMessage): void;
+export declare function registerDevtoolsMessageHandler(_handler: (message: DevtoolsIncomingMessage) => void): () => void;
+export declare function assertDevtoolsConnectedForSyncRender(): void;
+export declare function isDevtoolsConnected(): boolean;
+export declare function getDevtoolsServerInfo(): DevtoolsServerInfo | null;
+export declare function enableDevtoolsAndConnect(_options?: EnableDevtoolsOptions): Promise<DevtoolsServerInfo | null>;
+export declare function resetDevtoolsServerForTests(): Promise<void>;
+//# sourceMappingURL=devtools-server.browser.d.ts.map

package/dist/src/devtools/devtools-server.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-server.browser.d.ts","sourceRoot":"","sources":["../../../src/devtools/devtools-server.browser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,cAAc,CAClC,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAExE;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,GACnD,MAAM,IAAI,CAEZ;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAEjE;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,CAAC,EAAE,qBAAqB,GAC/B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAEpC;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAEjE"}

package/dist/src/devtools/devtools-server.browser.js

@@ -0,0 +1,36 @@
+// Browser stub for devtools-server - devtools are not supported in browsers
+
+export function isDevtoolsEnabled() {
+  return false;
+}
+export async function waitForDevtoolsConnection() {
+  // No-op in browser
+}
+export async function enableDevtools(_options) {
+  // No-op in browser
+}
+export async function initDevtoolsIfEnabled() {
+  // No-op in browser
+}
+export function broadcastDevtoolsMessage(_message) {
+  // No-op in browser
+}
+export function registerDevtoolsMessageHandler(_handler) {
+  return () => {};
+}
+export function assertDevtoolsConnectedForSyncRender() {
+  // No-op in browser
+}
+export function isDevtoolsConnected() {
+  return false;
+}
+export function getDevtoolsServerInfo() {
+  return null;
+}
+export async function enableDevtoolsAndConnect(_options) {
+  return null;
+}
+export async function resetDevtoolsServerForTests() {
+  // No-op in browser
+}
+//# sourceMappingURL=devtools-server.browser.js.map

package/dist/src/devtools/devtools-server.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isDevtoolsEnabled","waitForDevtoolsConnection","enableDevtools","_options","initDevtoolsIfEnabled","broadcastDevtoolsMessage","_message","registerDevtoolsMessageHandler","_handler","assertDevtoolsConnectedForSyncRender","isDevtoolsConnected","getDevtoolsServerInfo","enableDevtoolsAndConnect","resetDevtoolsServerForTests"],"sources":["../../../src/devtools/devtools-server.browser.ts"],"sourcesContent":[null],"mappings":"AAAA;;AAiBA,OAAO,SAASA,iBAAiBA,CAAA,EAAY;EAC3C,OAAO,KAAK;AACd;AAEA,OAAO,eAAeC,yBAAyBA,CAAA,EAAkB;EAC/D;AAAA;AAQF,OAAO,eAAeC,cAAcA,CAClCC,QAAgC,EACjB;EACf;AAAA;AAGF,OAAO,eAAeC,qBAAqBA,CAAA,EAAkB;EAC3D;AAAA;AAGF,OAAO,SAASC,wBAAwBA,CAACC,QAAyB,EAAQ;EACxE;AAAA;AAGF,OAAO,SAASC,8BAA8BA,CAC5CC,QAAoD,EACxC;EACZ,OAAO,MAAM,CAAC,CAAC;AACjB;AAEA,OAAO,SAASC,oCAAoCA,CAAA,EAAS;EAC3D;AAAA;AAGF,OAAO,SAASC,mBAAmBA,CAAA,EAAY;EAC7C,OAAO,KAAK;AACd;AAEA,OAAO,SAASC,qBAAqBA,CAAA,EAA8B;EACjE,OAAO,IAAI;AACb;AAEA,OAAO,eAAeC,wBAAwBA,CAC5CT,QAAgC,EACI;EACpC,OAAO,IAAI;AACb;AAEA,OAAO,eAAeU,2BAA2BA,CAAA,EAAkB;EACjE;AAAA","ignoreList":[]}

package/dist/src/devtools/devtools-server.d.ts

@@ -0,0 +1,72 @@
+export interface DevtoolsMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export interface DevtoolsIncomingMessage {
+    type: string;
+    [key: string]: unknown;
+}
+export interface DevtoolsServerInfo {
+    port: number;
+    connected: boolean;
+}
+export interface EnableDevtoolsOptions {
+    /** Port to listen on. Use 0 for a random available port. Defaults to ALLOY_DEBUG_PORT or 8123. */
+    port?: number;
+}
+/** Returns true when devtools are enabled (via env var or explicit call). */
+export declare function isDevtoolsEnabled(): boolean;
+/** Returns true when a devtools client is currently connected. */
+export declare function isDevtoolsConnected(): boolean;
+/** Get the current server info, or null if not running. */
+export declare function getDevtoolsServerInfo(): DevtoolsServerInfo | null;
+/**
+ * Wait for a devtools client to connect before proceeding.
+ *
+ * Starts the devtools server if not already running, and blocks until a
+ * devtools client connects via WebSocket.
+ *
+ * @example
+ * ```ts
+ * import { waitForDevtoolsConnection } from "@alloy-js/core/devtools";
+ * import { render } from "@alloy-js/core";
+ *
+ * await waitForDevtoolsConnection();
+ * const tree = render(<MyComponent />);
+ * ```
+ */
+export declare function waitForDevtoolsConnection(): Promise<void>;
+/**
+ * Enable devtools and start the server, returning when the server is ready.
+ * Use this in tests to enable devtools before connecting a client.
+ *
+ * @returns Server info with port number
+ */
+export declare function enableDevtools(options?: EnableDevtoolsOptions): Promise<DevtoolsServerInfo>;
+/**
+ * Initialize devtools if ALLOY_DEBUG is set. Called lazily by render functions.
+ * Returns immediately if devtools are not enabled or already initialized.
+ */
+export declare function initDevtoolsIfEnabled(): Promise<void>;
+/**
+ * Start the devtools server and wait for a client connection.
+ *
+ * @example
+ * ```ts
+ * const serverInfo = await enableDevtoolsAndConnect({ port: 0 });
+ * // ... run your test ...
+ * await resetDevtoolsServerForTests();
+ * ```
+ *
+ * @returns Server info once a client has connected
+ */
+export declare function enableDevtoolsAndConnect(options?: EnableDevtoolsOptions): Promise<DevtoolsServerInfo>;
+/** Broadcast a message to all connected devtools clients. */
+export declare function broadcastDevtoolsMessage(message: DevtoolsMessage): void;
+/** Register a handler for incoming devtools messages. Returns an unsubscribe function. */
+export declare function registerDevtoolsMessageHandler(handler: (message: DevtoolsIncomingMessage) => void): () => boolean;
+/** Throw if devtools are enabled but no client is connected (for sync render). */
+export declare function assertDevtoolsConnectedForSyncRender(): void;
+/** Reset all devtools state. For use in tests only. */
+export declare function resetDevtoolsServerForTests(): Promise<void>;
+//# sourceMappingURL=devtools-server.d.ts.map

package/dist/src/devtools/devtools-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-server.d.ts","sourceRoot":"","sources":["../../../src/devtools/devtools-server.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAgDD,6EAA6E;AAC7E,wBAAgB,iBAAiB,YAGhC;AAED,kEAAkE;AAClE,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,kBAAkB,GAAG,IAAI,CAGjE;AA2DD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK/D;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAQ7B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,kBAAkB,CAAC,CAM7B;AAMD,6DAA6D;AAC7D,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,QAmBhE;AAED,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,iBAIpD;AAED,kFAAkF;AAClF,wBAAgB,oCAAoC,SAOnD;AAMD,uDAAuD;AACvD,wBAAsB,2BAA2B,kBAUhD"}

package/dist/src/devtools/devtools-server.js

@@ -0,0 +1,256 @@
+/**
+ * Devtools session manager.
+ *
+ * Manages the lifecycle of a devtools session: enable, connect, broadcast
+ * messages, and reset. Transport details (HTTP/WebSocket) are delegated
+ * to devtools-transport.ts.
+ */
+import { createTransport, getAlloyVersion } from "./devtools-transport.js";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Public types
+// ─────────────────────────────────────────────────────────────────────────────
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Session state
+// ─────────────────────────────────────────────────────────────────────────────
+
+let transportState = null;
+let transportPromise = null;
+const messageHandlers = new Set();
+let devtoolsExplicitlyEnabled = false;
+let devtoolsInitialized = false;
+let loggedDevtoolsLinks = false;
+let waitingForConnection = false;
+let configuredPort;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Environment helpers
+// ─────────────────────────────────────────────────────────────────────────────
+
+function isNodeEnvironment() {
+  return typeof process !== "undefined" && typeof process.versions === "object" && Boolean(process.versions?.node);
+}
+function getCwd() {
+  if (!isNodeEnvironment()) return undefined;
+  try {
+    return process.cwd();
+  } catch {
+    return undefined;
+  }
+}
+function resolveDebugPort() {
+  const raw = process.env.ALLOY_DEBUG_PORT;
+  if (!raw) return 8123;
+  const parsed = Number.parseInt(raw, 10);
+  if (Number.isNaN(parsed)) return 8123;
+  return parsed;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Query functions
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Returns true when devtools are enabled (via env var or explicit call). */
+export function isDevtoolsEnabled() {
+  if (!isNodeEnvironment()) return false;
+  return devtoolsExplicitlyEnabled || Boolean(process.env.ALLOY_DEBUG);
+}
+
+/** Returns true when a devtools client is currently connected. */
+export function isDevtoolsConnected() {
+  return Boolean(transportState?.connected);
+}
+
+/** Get the current server info, or null if not running. */
+export function getDevtoolsServerInfo() {
+  if (!transportState) return null;
+  return {
+    port: transportState.port,
+    connected: transportState.connected
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Server lifecycle
+// ─────────────────────────────────────────────────────────────────────────────
+
+async function ensureServer() {
+  if (transportState) return transportState;
+  if (!transportPromise) {
+    transportPromise = createTransport({
+      port: configuredPort ?? resolveDebugPort(),
+      onConnection(socket) {
+        if (waitingForConnection) {
+          waitingForConnection = false;
+          process.stdout.write(" Connected!\n");
+        }
+        socket.send(JSON.stringify({
+          type: "debugger:info",
+          version: getAlloyVersion(),
+          cwd: getCwd()
+        }));
+      },
+      onMessage(raw) {
+        const message = raw;
+        if (!message || !message.type) return;
+        for (const handler of messageHandlers) {
+          handler(message);
+        }
+      },
+      onDisconnect() {
+        // Currently no-op; transport handles client set management
+      }
+    }).then(state => {
+      transportState = state;
+      if (!loggedDevtoolsLinks) {
+        loggedDevtoolsLinks = true;
+        // eslint-disable-next-line no-console
+        console.log(`Alloy ${getAlloyVersion()}`);
+        // eslint-disable-next-line no-console
+        console.log(`➜ Debug UI: http://localhost:${state.port}/`);
+        // eslint-disable-next-line no-console
+        console.log(`➜ Websocket: ws://localhost:${state.port}/`);
+        // eslint-disable-next-line no-console
+        console.log("");
+        waitingForConnection = true;
+        process.stdout.write("Waiting for connection...");
+      }
+      return state;
+    });
+  }
+  return transportPromise;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Wait for a devtools client to connect before proceeding.
+ *
+ * Starts the devtools server if not already running, and blocks until a
+ * devtools client connects via WebSocket.
+ *
+ * @example
+ * ```ts
+ * import { waitForDevtoolsConnection } from "@alloy-js/core/devtools";
+ * import { render } from "@alloy-js/core";
+ *
+ * await waitForDevtoolsConnection();
+ * const tree = render(<MyComponent />);
+ * ```
+ */
+export async function waitForDevtoolsConnection() {
+  devtoolsExplicitlyEnabled = true;
+  const server = await ensureServer();
+  if (server.connected) return;
+  await server.ready;
+}
+
+/**
+ * Enable devtools and start the server, returning when the server is ready.
+ * Use this in tests to enable devtools before connecting a client.
+ *
+ * @returns Server info with port number
+ */
+export async function enableDevtools(options) {
+  devtoolsExplicitlyEnabled = true;
+  devtoolsInitialized = true;
+  if (options?.port !== undefined) {
+    configuredPort = options.port;
+  }
+  const server = await ensureServer();
+  return {
+    port: server.port,
+    connected: server.connected
+  };
+}
+
+/**
+ * Initialize devtools if ALLOY_DEBUG is set. Called lazily by render functions.
+ * Returns immediately if devtools are not enabled or already initialized.
+ */
+export async function initDevtoolsIfEnabled() {
+  if (devtoolsInitialized) return;
+  if (!isDevtoolsEnabled()) return;
+  devtoolsInitialized = true;
+  await waitForDevtoolsConnection();
+}
+
+/**
+ * Start the devtools server and wait for a client connection.
+ *
+ * @example
+ * ```ts
+ * const serverInfo = await enableDevtoolsAndConnect({ port: 0 });
+ * // ... run your test ...
+ * await resetDevtoolsServerForTests();
+ * ```
+ *
+ * @returns Server info once a client has connected
+ */
+export async function enableDevtoolsAndConnect(options) {
+  const info = await enableDevtools(options);
+  if (!info.connected) {
+    await transportState.ready;
+  }
+  return {
+    port: transportState.port,
+    connected: true
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Messaging
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Broadcast a message to all connected devtools clients. */
+export function broadcastDevtoolsMessage(message) {
+  if (!isDevtoolsEnabled()) return;
+  if (!transportState) return;
+  if (transportState.clients.size === 0) return;
+  try {
+    const payload = JSON.stringify(message);
+    for (const client of transportState.clients) {
+      if (client.readyState === client.OPEN) {
+        client.send(payload);
+      }
+    }
+  } catch (err) {
+    // eslint-disable-next-line no-console
+    console.error(`Failed to send devtools message (type: ${message.type}):`, err);
+  }
+}
+
+/** Register a handler for incoming devtools messages. Returns an unsubscribe function. */
+export function registerDevtoolsMessageHandler(handler) {
+  messageHandlers.add(handler);
+  return () => messageHandlers.delete(handler);
+}
+
+/** Throw if devtools are enabled but no client is connected (for sync render). */
+export function assertDevtoolsConnectedForSyncRender() {
+  if (!isDevtoolsEnabled()) return;
+  if (!transportState || !transportState.connected) {
+    throw new Error("ALLOY_DEBUG is set but devtools are not connected. Use renderAsync or wait for the devtools client before rendering.");
+  }
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Test utilities
+// ─────────────────────────────────────────────────────────────────────────────
+
+/** Reset all devtools state. For use in tests only. */
+export async function resetDevtoolsServerForTests() {
+  if (transportState) {
+    await transportState.close();
+  }
+  transportState = null;
+  transportPromise = null;
+  devtoolsExplicitlyEnabled = false;
+  devtoolsInitialized = false;
+  configuredPort = undefined;
+  loggedDevtoolsLinks = false;
+}
+//# sourceMappingURL=devtools-server.js.map

package/dist/src/devtools/devtools-server.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createTransport","getAlloyVersion","transportState","transportPromise","messageHandlers","Set","devtoolsExplicitlyEnabled","devtoolsInitialized","loggedDevtoolsLinks","waitingForConnection","configuredPort","isNodeEnvironment","process","versions","Boolean","node","getCwd","undefined","cwd","resolveDebugPort","raw","env","ALLOY_DEBUG_PORT","parsed","Number","parseInt","isNaN","isDevtoolsEnabled","ALLOY_DEBUG","isDevtoolsConnected","connected","getDevtoolsServerInfo","port","ensureServer","onConnection","socket","stdout","write","send","JSON","stringify","type","version","onMessage","message","handler","onDisconnect","then","state","console","log","waitForDevtoolsConnection","server","ready","enableDevtools","options","initDevtoolsIfEnabled","enableDevtoolsAndConnect","info","broadcastDevtoolsMessage","clients","size","payload","client","readyState","OPEN","err","error","registerDevtoolsMessageHandler","add","delete","assertDevtoolsConnectedForSyncRender","Error","resetDevtoolsServerForTests","close"],"sources":["../../../src/devtools/devtools-server.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/devtools/devtools-transport.d.ts

@@ -0,0 +1,23 @@
+import { createServer as createHttpServer } from "node:http";
+export interface DevtoolsTransportState {
+    port: number;
+    connected: boolean;
+    clients: Set<any>;
+    httpServer: ReturnType<typeof createHttpServer>;
+    ready: Promise<void>;
+    close(): Promise<void>;
+}
+/** Read the @alloy-js/core package version, cached after first call. */
+export declare function getAlloyVersion(): string;
+export interface CreateTransportOptions {
+    port: number;
+    onConnection(socket: any): void;
+    onMessage(message: unknown): void;
+    onDisconnect(): void;
+}
+/**
+ * Create the HTTP + WebSocket transport. Returns when the server is listening.
+ * Only accepts one concurrent WebSocket connection.
+ */
+export declare function createTransport(options: CreateTransportOptions): Promise<DevtoolsTransportState>;
+//# sourceMappingURL=devtools-transport.d.ts.map

package/dist/src/devtools/devtools-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-transport.d.ts","sourceRoot":"","sources":["../../../src/devtools/devtools-transport.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,YAAY,IAAI,gBAAgB,EAGjC,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;IAChD,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID,wEAAwE;AACxE,wBAAgB,eAAe,IAAI,MAAM,CAYxC;AAmBD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,YAAY,IAAI,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,sBAAsB,CAAC,CAmFjC"}

package/dist/src/devtools/devtools-transport.js

@@ -0,0 +1,114 @@
+/**
+ * WebSocket transport for the Alloy devtools server.
+ *
+ * Handles HTTP serving of the devtools UI and WebSocket connection management.
+ * This module is concerned only with the transport layer — session lifecycle
+ * is managed by devtools-server.ts.
+ */
+import { readFileSync } from "node:fs";
+import { createServer as createHttpServer } from "node:http";
+let cachedAlloyVersion = null;
+
+/** Read the @alloy-js/core package version, cached after first call. */
+export function getAlloyVersion() {
+  if (cachedAlloyVersion) return cachedAlloyVersion;
+  try {
+    const pkgUrl = new URL("../../../package.json", import.meta.url);
+    const pkg = JSON.parse(readFileSync(pkgUrl, "utf-8"));
+    cachedAlloyVersion = pkg.version ?? "0.0.0";
+  } catch {
+    cachedAlloyVersion = "0.0.0";
+  }
+  return cachedAlloyVersion;
+}
+
+/** Attempt to load the devtools UI HTML from known candidate paths. */
+function loadDevtoolsUiHtml() {
+  const candidates = [new URL("../../dist/devtools/index.html", import.meta.url), new URL("../../devtools/index.html", import.meta.url), new URL("../../../devtools/dist/index.html", import.meta.url)];
+  for (const candidate of candidates) {
+    try {
+      return readFileSync(candidate, "utf-8");
+    } catch {
+      // try next
+    }
+  }
+  return null;
+}
+/**
+ * Create the HTTP + WebSocket transport. Returns when the server is listening.
+ * Only accepts one concurrent WebSocket connection.
+ */
+export async function createTransport(options) {
+  const {
+    WebSocketServer
+  } = await import("ws");
+  const devtoolsUiHtml = loadDevtoolsUiHtml();
+  const httpServer = createHttpServer((req, res) => {
+    const url = req.url ?? "/";
+    if (url !== "/" && url !== "/index.html") {
+      res.statusCode = 404;
+      res.end("Not Found");
+      return;
+    }
+    if (!devtoolsUiHtml) {
+      res.statusCode = 404;
+      res.end("Not Found");
+      return;
+    }
+    res.statusCode = 200;
+    res.setHeader("Content-Type", "text/html; charset=utf-8");
+    res.end(devtoolsUiHtml);
+  });
+  const wss = new WebSocketServer({
+    server: httpServer
+  });
+  await new Promise((resolve, reject) => {
+    httpServer.once("listening", resolve);
+    httpServer.once("error", reject);
+    httpServer.listen(options.port);
+  });
+  const address = httpServer.address();
+  const actualPort = typeof address === "object" && address !== null ? address.port : options.port;
+  let resolveReady;
+  const ready = new Promise(resolve => {
+    resolveReady = resolve;
+  });
+  const clients = new Set();
+  const state = {
+    port: actualPort,
+    connected: false,
+    clients,
+    httpServer,
+    ready,
+    close: async () => {
+      await new Promise(resolve => wss.close(() => resolve()));
+      await new Promise(resolve => httpServer.close(() => resolve()));
+      clients.clear();
+      state.connected = false;
+    }
+  };
+  wss.on("connection", socket => {
+    if (state.connected) {
+      socket.close(1000, "Another devtools client is already connected");
+      return;
+    }
+    clients.add(socket);
+    state.connected = true;
+    resolveReady?.();
+    options.onConnection(socket);
+    socket.on("message", data => {
+      try {
+        options.onMessage(JSON.parse(String(data)));
+      } catch {
+        // ignore malformed messages
+      }
+    });
+    socket.on("close", () => {
+      clients.delete(socket);
+      state.connected = clients.size > 0;
+      options.onDisconnect();
+    });
+  });
+  return state;
+}
+//# sourceMappingURL=devtools-transport.js.map

package/dist/src/devtools/devtools-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["readFileSync","createServer","createHttpServer","cachedAlloyVersion","getAlloyVersion","pkgUrl","URL","import","meta","url","pkg","JSON","parse","version","loadDevtoolsUiHtml","candidates","candidate","createTransport","options","WebSocketServer","devtoolsUiHtml","httpServer","req","res","statusCode","end","setHeader","wss","server","Promise","resolve","reject","once","listen","port","address","actualPort","resolveReady","ready","clients","Set","state","connected","close","clear","on","socket","add","onConnection","data","onMessage","String","delete","size","onDisconnect"],"sources":["../../../src/devtools/devtools-transport.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/devtools-entry.browser.d.ts

@@ -0,0 +1,4 @@
+export type { BatchMessage, ClientToServerMessage, DebuggerInfoMessage, DiagnosticInfo, DiagnosticsReportMessage, DirectoryAddedMessage, DirectoryRemovedMessage, EffectAddedMessage, EffectEdgeInfo, EffectEdgeUpdatedMessage, EffectInfo, EffectTrackMessage, EffectTriggerMessage, EffectUpdatedMessage, FileAddedMessage, FileRemovedMessage, FileUpdatedMessage, FlushJobsCompleteMessage, RefAddedMessage, RefInfo, RenderCompleteMessage, RenderErrorMessage, RenderErrorStackEntry, RenderNodeAddedMessage, RenderNodeRemovedMessage, RenderNodeUpdatedMessage, RenderResetMessage, RenderTreeNode, RerenderBreakRequestMessage, RerenderRequestMessage, ScopeCreateMessage, ScopeDeleteMessage, ScopeInfo, ScopeUpdateMessage, ServerToClientMessage, SourceLocation, SymbolCreateMessage, SymbolDeleteMessage, SymbolInfo, SymbolUpdateMessage, } from "./devtools/devtools-protocol.js";
+export { enableDevtools, enableDevtoolsAndConnect, resetDevtoolsServerForTests, waitForDevtoolsConnection, } from "./devtools/devtools-server.browser.js";
+export type { DevtoolsServerInfo, EnableDevtoolsOptions, } from "./devtools/devtools-server.browser.js";
+//# sourceMappingURL=devtools-entry.browser.d.ts.map

package/dist/src/devtools-entry.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-entry.browser.d.ts","sourceRoot":"","sources":["../../src/devtools-entry.browser.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,OAAO,EACP,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EACV,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,uCAAuC,CAAC"}

package/dist/src/devtools-entry.browser.js

@@ -0,0 +1,2 @@
+export { enableDevtools, enableDevtoolsAndConnect, resetDevtoolsServerForTests, waitForDevtoolsConnection } from "./devtools/devtools-server.browser.js";
+//# sourceMappingURL=devtools-entry.browser.js.map

package/dist/src/devtools-entry.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["enableDevtools","enableDevtoolsAndConnect","resetDevtoolsServerForTests","waitForDevtoolsConnection"],"sources":["../../src/devtools-entry.browser.ts"],"sourcesContent":[null],"mappings":"AA0CA,SACEA,cAAc,EACdC,wBAAwB,EACxBC,2BAA2B,EAC3BC,yBAAyB,QACpB,uCAAuC","ignoreList":[]}

package/dist/src/devtools-entry.d.ts

@@ -0,0 +1,4 @@
+export type { BatchMessage, ClientToServerMessage, DebuggerInfoMessage, DiagnosticInfo, DiagnosticsReportMessage, DirectoryAddedMessage, DirectoryRemovedMessage, EffectAddedMessage, EffectEdgeInfo, EffectEdgeUpdatedMessage, EffectInfo, EffectTrackMessage, EffectTriggerMessage, EffectUpdatedMessage, FileAddedMessage, FileRemovedMessage, FileUpdatedMessage, FlushJobsCompleteMessage, RefAddedMessage, RefInfo, RenderCompleteMessage, RenderErrorMessage, RenderErrorStackEntry, RenderNodeAddedMessage, RenderNodeRemovedMessage, RenderNodeUpdatedMessage, RenderResetMessage, RenderTreeNode, RerenderBreakRequestMessage, RerenderRequestMessage, ScopeCreateMessage, ScopeDeleteMessage, ScopeInfo, ScopeUpdateMessage, ServerToClientMessage, SourceLocation, SymbolCreateMessage, SymbolDeleteMessage, SymbolInfo, SymbolUpdateMessage, } from "./devtools/devtools-protocol.js";
+export { enableDevtools, enableDevtoolsAndConnect, resetDevtoolsServerForTests, waitForDevtoolsConnection, } from "./devtools/devtools-server.js";
+export type { DevtoolsServerInfo, EnableDevtoolsOptions, } from "./devtools/devtools-server.js";
+//# sourceMappingURL=devtools-entry.d.ts.map

package/dist/src/devtools-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-entry.d.ts","sourceRoot":"","sources":["../../src/devtools-entry.ts"],"names":[],"mappings":"AAAA,YAAY,EAEV,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,eAAe,EACf,OAAO,EACP,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EAEd,2BAA2B,EAC3B,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC"}

package/dist/src/devtools-entry.js

@@ -0,0 +1,2 @@
+export { enableDevtools, enableDevtoolsAndConnect, resetDevtoolsServerForTests, waitForDevtoolsConnection } from "./devtools/devtools-server.js";
+//# sourceMappingURL=devtools-entry.js.map

package/dist/src/devtools-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["enableDevtools","enableDevtoolsAndConnect","resetDevtoolsServerForTests","waitForDevtoolsConnection"],"sources":["../../src/devtools-entry.ts"],"sourcesContent":[null],"mappings":"AA4CA,SACEA,cAAc,EACdC,wBAAwB,EACxBC,2BAA2B,EAC3BC,yBAAyB,QACpB,+BAA+B","ignoreList":[]}