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

package/dist/src/debug/effects.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["afterEach","beforeEach","expect","it","WebSocket","createMessageCollector","filterEffectsMessages","Output","enableDevtools","resetDevtoolsServerForTests","effect","ref","renderAsync","debug","socket","reset","server","port","Promise","resolve","reject","once","close","undefined","collector","r1","observed","value","_$createComponent","children","messages","waitForRender","effectsMessages","stop","byType","type","filter","m","length","toBeGreaterThanOrEqual","toMatchObject","objectContaining","id","any","Number","kind","edge","effectId","refId","toBe"],"sources":["../../../src/debug/effects.test.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,SAAS,EAAEC,UAAU,EAAEC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AAC1D,OAAOC,SAAS,MAAM,IAAI;AAC1B,SACEC,sBAAsB,EACtBC,qBAAqB,QAChB,iCAAiC;AACxC,SAASC,MAAM;AACf,SACEC,cAAc,EACdC,2BAA2B,QACtB,gCAAgC;AACvC,SAASC,MAAM,EAAEC,GAAG,QAAQ,kBAAkB;AAC9C,SAASC,WAAW,QAAQ,cAAc;AAC1C,SAASC,KAAK,QAAQ,YAAY;AAElC,IAAIC,MAA6B;AAEjCb,UAAU,CAAC,YAAY;EACrBY,KAAK,CAACH,MAAM,CAACK,KAAK,CAAC,CAAC;EAEpB,MAAMC,MAAM,GAAG,MAAMR,cAAc,CAAC;IAAES,IAAI,EAAE;EAAE,CAAC,CAAC;EAChDH,MAAM,GAAG,IAAIV,SAAS,CAAC,kBAAkBY,MAAM,CAACC,IAAI,EAAE,CAAC;EACvD,MAAM,IAAIC,OAAO,CAAO,CAACC,OAAO,EAAEC,MAAM,KAAK;IAC3CN,MAAM,EAAEO,IAAI,CAAC,MAAM,EAAEF,OAAO,CAAC;IAC7BL,MAAM,EAAEO,IAAI,CAAC,OAAO,EAAED,MAAM,CAAC;EAC/B,CAAC,CAAC;AACJ,CAAC,CAAC;AAEFpB,SAAS,CAAC,YAAY;EACpB,IAAIc,MAAM,EAAE;IACVA,MAAM,CAACQ,KAAK,CAAC,CAAC;IACdR,MAAM,GAAGS,SAAS;EACpB;EAEA,MAAMd,2BAA2B,CAAC,CAAC;EACnCI,KAAK,CAACH,MAAM,CAACK,KAAK,CAAC,CAAC;AACtB,CAAC,CAAC;AAEFZ,EAAE,CAAC,8CAA8C,EAAE,YAAY;EAC7D,MAAMqB,SAAS,GAAGnB,sBAAsB,CAACS,MAAO,CAAC;EACjD,MAAMW,EAAE,GAAGd,GAAG,CAAC,CAAC,CAAC;;EAEjB;EACA,IAAIe,QAAQ,GAAG,CAAC;EAChBhB,MAAM,CAAC,MAAM;IACXgB,QAAQ,GAAGD,EAAE,CAACE,KAAK;EACrB,CAAC,CAAC;;EAEF;EACAF,EAAE,CAACE,KAAK,GAAG,EAAE;EAEb,MAAMf,WAAW,CAAAgB,iBAAA,CAAErB,MAAM;IAAAsB,QAAA,EAAE;EAAI,EAAU,CAAC;EAE1C,MAAMC,QAAQ,GAAG,MAAMN,SAAS,CAACO,aAAa,CAAC,CAAC;EAChD,MAAMC,eAAe,GAAG1B,qBAAqB,CAACwB,QAAQ,CAAC;EACvDN,SAAS,CAACS,IAAI,CAAC,CAAC;;EAEhB;EACA,MAAMC,MAAM,GAAIC,IAAY,IAC1BH,eAAe,CAACI,MAAM,CAAEC,CAAM,IAAKA,CAAC,CAACF,IAAI,KAAKA,IAAI,CAAC;EACrDjC,MAAM,CAACgC,MAAM,CAAC,iBAAiB,CAAC,CAACI,MAAM,CAAC,CAACC,sBAAsB,CAAC,CAAC,CAAC;EAClErC,MAAM,CAACgC,MAAM,CAAC,oBAAoB,CAAC,CAACI,MAAM,CAAC,CAACC,sBAAsB,CAAC,CAAC,CAAC;EACrErC,MAAM,CAACgC,MAAM,CAAC,cAAc,CAAC,CAACI,MAAM,CAAC,CAACC,sBAAsB,CAAC,CAAC,CAAC;EAC/DrC,MAAM,CAACgC,MAAM,CAAC,gBAAgB,CAAC,CAACI,MAAM,CAAC,CAACC,sBAAsB,CAAC,CAAC,CAAC;EACjErC,MAAM,CAACgC,MAAM,CAAC,sBAAsB,CAAC,CAACI,MAAM,CAAC,CAACC,sBAAsB,CAAC,CAAC,CAAC;;EAEvE;EACArC,MAAM,CAACgC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAACM,aAAa,CAAC;IACjD7B,GAAG,EAAET,MAAM,CAACuC,gBAAgB,CAAC;MAAEC,EAAE,EAAExC,MAAM,CAACyC,GAAG,CAACC,MAAM,CAAC;MAAEC,IAAI,EAAE;IAAM,CAAC;EACtE,CAAC,CAAC;EACF3C,MAAM,CAACgC,MAAM,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAACM,aAAa,CAAC;IACpD9B,MAAM,EAAER,MAAM,CAACuC,gBAAgB,CAAC;MAAEC,EAAE,EAAExC,MAAM,CAACyC,GAAG,CAACC,MAAM;IAAE,CAAC;EAC5D,CAAC,CAAC;EACF1C,MAAM,CAACgC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAACM,aAAa,CAAC;IAC9CM,IAAI,EAAE5C,MAAM,CAACuC,gBAAgB,CAAC;MAC5BN,IAAI,EAAE,OAAO;MACbY,QAAQ,EAAE7C,MAAM,CAACyC,GAAG,CAACC,MAAM,CAAC;MAC5BI,KAAK,EAAE9C,MAAM,CAACyC,GAAG,CAACC,MAAM;IAC1B,CAAC;EACH,CAAC,CAAC;EACF1C,MAAM,CAACgC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAACM,aAAa,CAAC;IAChDM,IAAI,EAAE5C,MAAM,CAACuC,gBAAgB,CAAC;MAC5BM,QAAQ,EAAE7C,MAAM,CAACyC,GAAG,CAACC,MAAM,CAAC;MAC5BI,KAAK,EAAE9C,MAAM,CAACyC,GAAG,CAACC,MAAM;IAC1B,CAAC;EACH,CAAC,CAAC;EAEF1C,MAAM,CAACwB,QAAQ,CAAC,CAACuB,IAAI,CAAC,EAAE,CAAC;AAC3B,CAAC,CAAC","ignoreList":[]}

package/dist/src/debug/files.d.ts

@@ -0,0 +1,14 @@
+export interface FileUpdateInfo {
+    path: string;
+    filetype: string;
+    contents: string;
+}
+/** Record a directory being added to the output. */
+export declare function recordDirectory(path: string): void;
+/** Record a file being added to the output. */
+export declare function recordFile(path: string, filetype: string): void;
+/** Notify devtools that a file's contents have changed. De-duplicates by content. */
+export declare function updated(info: FileUpdateInfo): void;
+/** Clear all cached file state. Called when a new render begins. */
+export declare function reset(): void;
+//# sourceMappingURL=files.d.ts.map

package/dist/src/debug/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/debug/files.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,QAG3C;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAGxD;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,IAAI,EAAE,cAAc,QAW3C;AAED,oEAAoE;AACpE,wBAAgB,KAAK,SAEpB"}

package/dist/src/debug/files.js

@@ -0,0 +1,40 @@
+import { emitDevtoolsMessage, isDevtoolsEnabled } from "./trace.js";
+const fileContentCache = new Map();
+
+/** Record a directory being added to the output. */
+export function recordDirectory(path) {
+  if (!isDevtoolsEnabled()) return;
+  emitDevtoolsMessage({
+    type: "files:directoryAdded",
+    path
+  });
+}
+
+/** Record a file being added to the output. */
+export function recordFile(path, filetype) {
+  if (!isDevtoolsEnabled()) return;
+  emitDevtoolsMessage({
+    type: "files:fileAdded",
+    path,
+    filetype
+  });
+}
+
+/** Notify devtools that a file's contents have changed. De-duplicates by content. */
+export function updated(info) {
+  const previous = fileContentCache.get(info.path);
+  if (previous === info.contents) return;
+  fileContentCache.set(info.path, info.contents);
+  emitDevtoolsMessage({
+    type: "files:fileUpdated",
+    path: info.path,
+    filetype: info.filetype,
+    contents: info.contents
+  });
+}
+
+/** Clear all cached file state. Called when a new render begins. */
+export function reset() {
+  fileContentCache.clear();
+}
+//# sourceMappingURL=files.js.map

package/dist/src/debug/files.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["emitDevtoolsMessage","isDevtoolsEnabled","fileContentCache","Map","recordDirectory","path","type","recordFile","filetype","updated","info","previous","get","contents","set","reset","clear"],"sources":["../../../src/debug/files.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,mBAAmB,EAAEC,iBAAiB,QAAQ,YAAY;AAQnE,MAAMC,gBAAgB,GAAG,IAAIC,GAAG,CAAiB,CAAC;;AAElD;AACA,OAAO,SAASC,eAAeA,CAACC,IAAY,EAAE;EAC5C,IAAI,CAACJ,iBAAiB,CAAC,CAAC,EAAE;EAC1BD,mBAAmB,CAAC;IAAEM,IAAI,EAAE,sBAAsB;IAAED;EAAK,CAAC,CAAC;AAC7D;;AAEA;AACA,OAAO,SAASE,UAAUA,CAACF,IAAY,EAAEG,QAAgB,EAAE;EACzD,IAAI,CAACP,iBAAiB,CAAC,CAAC,EAAE;EAC1BD,mBAAmB,CAAC;IAAEM,IAAI,EAAE,iBAAiB;IAAED,IAAI;IAAEG;EAAS,CAAC,CAAC;AAClE;;AAEA;AACA,OAAO,SAASC,OAAOA,CAACC,IAAoB,EAAE;EAC5C,MAAMC,QAAQ,GAAGT,gBAAgB,CAACU,GAAG,CAACF,IAAI,CAACL,IAAI,CAAC;EAChD,IAAIM,QAAQ,KAAKD,IAAI,CAACG,QAAQ,EAAE;EAChCX,gBAAgB,CAACY,GAAG,CAACJ,IAAI,CAACL,IAAI,EAAEK,IAAI,CAACG,QAAQ,CAAC;EAE9Cb,mBAAmB,CAAC;IAClBM,IAAI,EAAE,mBAAmB;IACzBD,IAAI,EAAEK,IAAI,CAACL,IAAI;IACfG,QAAQ,EAAEE,IAAI,CAACF,QAAQ;IACvBK,QAAQ,EAAEH,IAAI,CAACG;EACjB,CAAC,CAAC;AACJ;;AAEA;AACA,OAAO,SAASE,KAAKA,CAAA,EAAG;EACtBb,gBAAgB,CAACc,KAAK,CAAC,CAAC;AAC1B","ignoreList":[]}

package/dist/src/debug/files.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=files.test.d.ts.map

package/dist/src/debug/files.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.test.d.ts","sourceRoot":"","sources":["../../../src/debug/files.test.tsx"],"names":[],"mappings":""}

package/dist/src/debug/files.test.js

@@ -0,0 +1,89 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { afterEach, beforeEach, expect, it } from "vitest";
+import WebSocket from "ws";
+import { createMessageCollector } from "../../testing/devtools-utils.js";
+import { Output } from "../components/Output.js";
+import { Show } from "../components/Show.js";
+import { SourceDirectory } from "../components/SourceDirectory.js";
+import { SourceFile } from "../components/SourceFile.js";
+import { enableDevtools, resetDevtoolsServerForTests } from "../devtools/devtools-server.js";
+import { ref } from "../reactivity.js";
+import { renderAsync } from "../render.js";
+import { flushJobsAsync } from "../scheduler.js";
+let socket;
+beforeEach(async () => {
+  const server = await enableDevtools({
+    port: 0
+  });
+  socket = new WebSocket(`ws://127.0.0.1:${server.port}`);
+  await new Promise((resolve, reject) => {
+    socket?.once("open", resolve);
+    socket?.once("error", reject);
+  });
+});
+afterEach(async () => {
+  if (socket) {
+    socket.close();
+    socket = undefined;
+  }
+  await resetDevtoolsServerForTests();
+});
+it("emits file and directory add/update/remove messages", async () => {
+  const show = ref(true);
+  const collector = createMessageCollector(socket);
+  await renderAsync(_$createComponent(Output, {
+    get children() {
+      return _$createComponent(Show, {
+        get when() {
+          return show.value;
+        },
+        get children() {
+          return _$createComponent(SourceDirectory, {
+            path: "src",
+            get children() {
+              return _$createComponent(SourceFile, {
+                path: "index.ts",
+                filetype: "ts",
+                children: "export const value = 1;"
+              });
+            }
+          });
+        }
+      });
+    }
+  }));
+  const initialMessages = await collector.waitForRender();
+  const initialFiles = initialMessages.filter(m => m.type.startsWith("files:"));
+  expect(initialFiles[0]).toMatchObject({
+    path: "./"
+  });
+  expect(initialFiles[1]).toMatchObject({
+    type: "files:directoryAdded",
+    path: "src"
+  });
+  expect(initialFiles[2]).toMatchObject({
+    type: "files:fileAdded",
+    path: "src/index.ts",
+    filetype: "ts"
+  });
+  expect(initialFiles[3]).toMatchObject({
+    type: "files:fileUpdated",
+    path: "src/index.ts",
+    filetype: "ts",
+    contents: expect.any(String)
+  });
+  show.value = false;
+  await flushJobsAsync();
+  const updateMessages = await collector.waitForFlush();
+  const updateFiles = updateMessages.filter(m => m.type.startsWith("files:"));
+  collector.stop();
+  expect(updateFiles[0]).toMatchObject({
+    type: "files:fileRemoved",
+    path: "src/index.ts"
+  });
+  expect(updateFiles[1]).toMatchObject({
+    type: "files:directoryRemoved",
+    path: "src"
+  });
+});
+//# sourceMappingURL=files.test.js.map

package/dist/src/debug/files.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["afterEach","beforeEach","expect","it","WebSocket","createMessageCollector","Output","Show","SourceDirectory","SourceFile","enableDevtools","resetDevtoolsServerForTests","ref","renderAsync","flushJobsAsync","socket","server","port","Promise","resolve","reject","once","close","undefined","show","collector","_$createComponent","children","when","value","path","filetype","initialMessages","waitForRender","initialFiles","filter","m","type","startsWith","toMatchObject","contents","any","String","updateMessages","waitForFlush","updateFiles","stop"],"sources":["../../../src/debug/files.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/debug/index.d.ts

@@ -0,0 +1,61 @@
+import { debugContext, debugRender, debugStack, debugTree, debugWatch } from "./cli.js";
+import { ensureRef, register, registerRef, reset, track, trigger, update } from "./effects.js";
+import { recordDirectory, recordFile, reset as resetFiles, updated } from "./files.js";
+import { appendCustomContext, appendFragmentChild, appendPrintHook, appendTextNode, beginComponent, complete, error, flushJobsComplete, initialize, prepareMemoNode } from "./render.js";
+import { registerScope, registerSymbol, relocateScope, reset as resetSymbols, unregisterScope, unregisterSymbol } from "./symbols.js";
+import { type TracePhaseInfo } from "./trace.js";
+export { captureSourceLocation } from "./effects.js";
+export type { EffectDebugInfo, EffectEdgeDebugInfo, RefDebugInfo, } from "./effects.js";
+export { getRenderNodeId, type RenderTreeNodeInfo } from "./render.js";
+export type { BeginComponentOptions, ComponentDebugSession, RenderErrorInfo, RenderErrorStackEntry, } from "./render.js";
+export { isConsoleTraceEnabled, isDevtoolsEnabled, trace, TracePhase, type TracePhaseInfo, } from "./trace.js";
+/** The full debug runtime interface, derived from the `debug` object implementation. */
+export type DebugRuntime = typeof debug;
+export declare const debug: {
+    component: {
+        stack: typeof debugStack;
+        tree: typeof debugTree;
+        watch: typeof debugWatch;
+        render: typeof debugRender;
+        context: typeof debugContext;
+    };
+    effect: {
+        register: typeof register;
+        update: typeof update;
+        registerRef: typeof registerRef;
+        ensureRef: typeof ensureRef;
+        track: typeof track;
+        trigger: typeof trigger;
+        reset: typeof reset;
+    };
+    render: {
+        initialize: typeof initialize;
+        appendTextNode: typeof appendTextNode;
+        appendCustomContext: typeof appendCustomContext;
+        appendPrintHook: typeof appendPrintHook;
+        appendFragmentChild: typeof appendFragmentChild;
+        beginComponent: typeof beginComponent;
+        prepareMemoNode: typeof prepareMemoNode;
+        error: typeof error;
+        complete: typeof complete;
+        flushJobsComplete: typeof flushJobsComplete;
+    };
+    files: {
+        recordDirectory: typeof recordDirectory;
+        recordFile: typeof recordFile;
+        updated: typeof updated;
+        reset: typeof resetFiles;
+    };
+    symbols: {
+        registerScope: typeof registerScope;
+        relocateScope: typeof relocateScope;
+        unregisterScope: typeof unregisterScope;
+        registerSymbol: typeof registerSymbol;
+        unregisterSymbol: typeof unregisterSymbol;
+        reset: typeof resetSymbols;
+    };
+    trace(phase: TracePhaseInfo, cb: () => string, triggerIds?: Set<number>): void;
+    prepare(): Promise<void>;
+    assertReadyForSyncRender(): void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/debug/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,UAAU,EACV,SAAS,EACT,UAAU,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,EACP,MAAM,EACP,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,eAAe,EACf,UAAU,EACV,KAAK,IAAI,UAAU,EACnB,OAAO,EACR,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,cAAc,EACd,QAAQ,EACR,KAAK,EACL,iBAAiB,EACjB,UAAU,EACV,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,KAAK,IAAI,YAAY,EACrB,eAAe,EACf,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACvE,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,EACL,UAAU,EACV,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AAEpB,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC;AAExC,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2CH,cAAc,MAAM,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,CAAC;eAGtD,OAAO,CAAC,IAAI,CAAC;gCAGF,IAAI;CAKjC,CAAC"}

package/dist/src/debug/index.js

@@ -0,0 +1,69 @@
+import { assertDevtoolsConnectedForSyncRender, initDevtoolsIfEnabled, isDevtoolsEnabled } from "../devtools/devtools-server.js";
+import { debugContext, debugRender, debugStack, debugTree, debugWatch } from "./cli.js";
+import { ensureRef, register, registerRef, reset, track, trigger, update } from "./effects.js";
+import { recordDirectory, recordFile, reset as resetFiles, updated } from "./files.js";
+import { appendCustomContext, appendFragmentChild, appendPrintHook, appendTextNode, beginComponent, complete, error, flushJobsComplete, initialize, prepareMemoNode } from "./render.js";
+import { registerScope, registerSymbol, relocateScope, reset as resetSymbols, unregisterScope, unregisterSymbol } from "./symbols.js";
+import { trace } from "./trace.js";
+export { captureSourceLocation } from "./effects.js";
+export { getRenderNodeId } from "./render.js";
+export { isConsoleTraceEnabled, isDevtoolsEnabled, trace, TracePhase } from "./trace.js";
+
+/** The full debug runtime interface, derived from the `debug` object implementation. */
+
+export const debug = {
+  component: {
+    stack: debugStack,
+    tree: debugTree,
+    watch: debugWatch,
+    render: debugRender,
+    context: debugContext
+  },
+  effect: {
+    register,
+    update,
+    registerRef,
+    ensureRef,
+    track,
+    trigger,
+    reset
+  },
+  render: {
+    initialize,
+    appendTextNode,
+    appendCustomContext,
+    appendPrintHook,
+    appendFragmentChild,
+    beginComponent,
+    prepareMemoNode,
+    error,
+    complete,
+    flushJobsComplete
+  },
+  files: {
+    recordDirectory,
+    recordFile,
+    updated,
+    reset: resetFiles
+  },
+  symbols: {
+    registerScope,
+    relocateScope,
+    unregisterScope,
+    registerSymbol,
+    unregisterSymbol,
+    reset: resetSymbols
+  },
+  trace(phase, cb, triggerIds) {
+    trace(phase, cb, triggerIds ?? new Set());
+  },
+  async prepare() {
+    await initDevtoolsIfEnabled();
+  },
+  assertReadyForSyncRender() {
+    if (isDevtoolsEnabled()) {
+      assertDevtoolsConnectedForSyncRender();
+    }
+  }
+};
+//# sourceMappingURL=index.js.map

package/dist/src/debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["assertDevtoolsConnectedForSyncRender","initDevtoolsIfEnabled","isDevtoolsEnabled","debugContext","debugRender","debugStack","debugTree","debugWatch","ensureRef","register","registerRef","reset","track","trigger","update","recordDirectory","recordFile","resetFiles","updated","appendCustomContext","appendFragmentChild","appendPrintHook","appendTextNode","beginComponent","complete","error","flushJobsComplete","initialize","prepareMemoNode","registerScope","registerSymbol","relocateScope","resetSymbols","unregisterScope","unregisterSymbol","trace","captureSourceLocation","getRenderNodeId","isConsoleTraceEnabled","TracePhase","debug","component","stack","tree","watch","render","context","effect","files","symbols","phase","cb","triggerIds","Set","prepare","assertReadyForSyncRender"],"sources":["../../../src/debug/index.ts"],"sourcesContent":[null],"mappings":"AAAA,SACEA,oCAAoC,EACpCC,qBAAqB,EACrBC,iBAAiB,QACZ,gCAAgC;AACvC,SACEC,YAAY,EACZC,WAAW,EACXC,UAAU,EACVC,SAAS,EACTC,UAAU,QACL,UAAU;AACjB,SACEC,SAAS,EACTC,QAAQ,EACRC,WAAW,EACXC,KAAK,EACLC,KAAK,EACLC,OAAO,EACPC,MAAM,QACD,cAAc;AACrB,SACEC,eAAe,EACfC,UAAU,EACVL,KAAK,IAAIM,UAAU,EACnBC,OAAO,QACF,YAAY;AACnB,SACEC,mBAAmB,EACnBC,mBAAmB,EACnBC,eAAe,EACfC,cAAc,EACdC,cAAc,EACdC,QAAQ,EACRC,KAAK,EACLC,iBAAiB,EACjBC,UAAU,EACVC,eAAe,QACV,aAAa;AACpB,SACEC,aAAa,EACbC,cAAc,EACdC,aAAa,EACbpB,KAAK,IAAIqB,YAAY,EACrBC,eAAe,EACfC,gBAAgB,QACX,cAAc;AACrB,SAASC,KAAK,QAA6B,YAAY;AAEvD,SAASC,qBAAqB,QAAQ,cAAc;AAMpD,SAASC,eAAe,QAAiC,aAAa;AAOtE,SACEC,qBAAqB,EACrBpC,iBAAiB,EACjBiC,KAAK,EACLI,UAAU,QAEL,YAAY;;AAEnB;;AAGA,OAAO,MAAMC,KAAK,GAAG;EACnBC,SAAS,EAAE;IACTC,KAAK,EAAErC,UAAU;IACjBsC,IAAI,EAAErC,SAAS;IACfsC,KAAK,EAAErC,UAAU;IACjBsC,MAAM,EAAEzC,WAAW;IACnB0C,OAAO,EAAE3C;EACX,CAAC;EACD4C,MAAM,EAAE;IACNtC,QAAQ;IACRK,MAAM;IACNJ,WAAW;IACXF,SAAS;IACTI,KAAK;IACLC,OAAO;IACPF;EACF,CAAC;EACDkC,MAAM,EAAE;IACNlB,UAAU;IACVL,cAAc;IACdH,mBAAmB;IACnBE,eAAe;IACfD,mBAAmB;IACnBG,cAAc;IACdK,eAAe;IACfH,KAAK;IACLD,QAAQ;IACRE;EACF,CAAC;EACDsB,KAAK,EAAE;IACLjC,eAAe;IACfC,UAAU;IACVE,OAAO;IACPP,KAAK,EAAEM;EACT,CAAC;EACDgC,OAAO,EAAE;IACPpB,aAAa;IACbE,aAAa;IACbE,eAAe;IACfH,cAAc;IACdI,gBAAgB;IAChBvB,KAAK,EAAEqB;EACT,CAAC;EACDG,KAAKA,CAACe,KAAqB,EAAEC,EAAgB,EAAEC,UAAwB,EAAE;IACvEjB,KAAK,CAACe,KAAK,EAAEC,EAAE,EAAEC,UAAU,IAAI,IAAIC,GAAG,CAAC,CAAC,CAAC;EAC3C,CAAC;EACD,MAAMC,OAAOA,CAAA,EAAkB;IAC7B,MAAMrD,qBAAqB,CAAC,CAAC;EAC/B,CAAC;EACDsD,wBAAwBA,CAAA,EAAS;IAC/B,IAAIrD,iBAAiB,CAAC,CAAC,EAAE;MACvBF,oCAAoC,CAAC,CAAC;IACxC;EACF;AACF,CAAC","ignoreList":[]}

package/dist/src/debug/render.d.ts

@@ -0,0 +1,57 @@
+import type { RenderErrorStackEntry as ProtocolRenderErrorStackEntry, RenderTreeNode } from "../devtools/devtools-protocol.js";
+import { type PrintHook, type RenderedTextTree } from "../print-hook.js";
+import type { ComponentCreator } from "../runtime/component.js";
+/** The kind discriminant for render tree nodes. */
+export type RenderTreeNodeKind = RenderTreeNode["kind"];
+/** Information about a render tree node, used when recording nodes to devtools. */
+export interface RenderTreeNodeInfo {
+    kind: RenderTreeNodeKind;
+    name?: string;
+    propsSerialized?: string;
+    value?: string;
+    source?: RenderTreeNode["source"];
+}
+export interface RenderNodeActions {
+    rerender: () => void;
+    rerenderAndBreak: () => void;
+}
+export interface BeginComponentOptions {
+    parent: RenderedTextTree;
+    index: number;
+    node: RenderedTextTree;
+    component: ComponentCreator<unknown>;
+    propsSource: Record<string, unknown> | undefined;
+    source: RenderTreeNodeInfo["source"] | undefined;
+    isExisting: boolean;
+    actions: RenderNodeActions;
+}
+export interface ComponentDebugSession {
+    recordDirectory(path: string): void;
+    recordFile(path: string, filetype: string): void;
+    dispose(): void;
+}
+export declare function getRenderNodeId(node: RenderedTextTree | PrintHook): number | undefined;
+export declare function initialize(root: RenderedTextTree): void;
+export declare function registerRenderNodeActions(node: RenderedTextTree | PrintHook, actions: RenderNodeActions): void;
+export declare function unregisterRenderNodeActions(node: RenderedTextTree | PrintHook): void;
+export declare function recordTextNode(parent: RenderedTextTree, index: number, value: string): void;
+/** Begin tracking a component render. Returns a session to record files/dirs and dispose watchers. */
+export declare function beginComponent(options: BeginComponentOptions): ComponentDebugSession;
+export declare function appendCustomContext(parent: RenderedTextTree, node: RenderedTextTree): void;
+export declare function appendPrintHook(parent: RenderedTextTree, index: number, hook: PrintHook, name: string, subtree?: RenderedTextTree): void;
+export declare function appendFragmentChild(parent: RenderedTextTree, child: RenderedTextTree): void;
+export declare function appendTextNode(parent: RenderedTextTree, index: number, value: string): void;
+export declare function prepareMemoNode(parent: RenderedTextTree, node: RenderedTextTree, isExisting: boolean): void;
+export interface RenderErrorInfo {
+    name: string;
+    message: string;
+    stack?: string;
+}
+/** Render error stack entry with optional runtime props (extends protocol type). */
+export interface RenderErrorStackEntry extends ProtocolRenderErrorStackEntry {
+    props?: Record<string, unknown> | undefined;
+}
+export declare function error(error: RenderErrorInfo, componentStack: RenderErrorStackEntry[]): void;
+export declare function complete(): void;
+export declare function flushJobsComplete(): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/src/debug/render.d.ts.map

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