@alloy-js/core 0.23.0-dev.11 → 0.23.0-dev.13

package/dist/dev/src/symbols/symbol-slot.js

@@ -0,0 +1,68 @@
+import { shallowRef } from "@vue/reactivity";
+import { effect, onCleanup } from "../reactivity.js";
+import { takeSymbols } from "./symbol-flow.js";
+/**
+ * Create a component which accepts emitted symbols. The returned component has
+ * a `ref` property which is a ref to a reactive set of all symbols emitted by
+ * children of the component.
+ */
+export function createSymbolSlot() {
+  const symbolSlotRef = shallowRef();
+  function SymbolSlot(props) {
+    const set = takeSymbols();
+    symbolSlotRef.value = set;
+    onCleanup(() => {
+      symbolSlotRef.value = undefined;
+    });
+    return props.children;
+  }
+  SymbolSlot.ref = symbolSlotRef;
+  Object.defineProperty(SymbolSlot, "firstSymbol", {
+    get() {
+      const ref = shallowRef();
+      effect(() => {
+        ref.value = symbolSlotRef.value?.values().next().value;
+      }, undefined, {
+        debug: {
+          name: "symbolSlot:firstSymbol",
+          type: "symbol"
+        }
+      });
+      return ref;
+    }
+  });
+  SymbolSlot.copyMembersTo = baseSymbol => {
+    effect(() => {
+      if (!symbolSlotRef.value) {
+        return;
+      }
+      for (const symbol of symbolSlotRef.value) {
+        symbol.copyMembersTo(baseSymbol);
+      }
+    }, undefined, {
+      debug: {
+        name: "symbolSlot:copyMembers",
+        type: "symbol"
+      }
+    });
+  };
+  SymbolSlot.moveMembersTo = baseSymbol => {
+    effect(() => {
+      if (!symbolSlotRef.value) {
+        return;
+      }
+      for (const symbol of symbolSlotRef.value) {
+        if (symbol.isTransient) {
+          symbol.moveMembersTo(baseSymbol);
+        }
+      }
+    }, undefined, {
+      debug: {
+        name: "symbolSlot:moveMembers",
+        type: "symbol"
+      }
+    });
+  };
+  return SymbolSlot;
+}
+//# sourceMappingURL=symbol-slot.js.map

package/dist/dev/src/symbols/symbol-slot.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["shallowRef","effect","onCleanup","takeSymbols","createSymbolSlot","symbolSlotRef","SymbolSlot","props","set","value","undefined","children","ref","Object","defineProperty","get","values","next","debug","name","type","copyMembersTo","baseSymbol","symbol","moveMembersTo","isTransient"],"sources":["../../../../src/symbols/symbol-slot.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAA+BA,UAAU,QAAQ,iBAAiB;AAClE,SAASC,MAAM,EAAEC,SAAS,QAAQ,kBAAkB;AAGpD,SAASC,WAAW,QAAQ,kBAAkB;AAwB9C;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAA,EAAe;EAC7C,MAAMC,aAAkE,GACtEL,UAAU,CAAC,CAAC;EACd,SAASM,UAAUA,CAACC,KAA6B,EAAE;IACjD,MAAMC,GAAG,GAAGL,WAAW,CAAC,CAAC;IACzBE,aAAa,CAACI,KAAK,GAAGD,GAAG;IAEzBN,SAAS,CAAC,MAAM;MACdG,aAAa,CAACI,KAAK,GAAGC,SAAS;IACjC,CAAC,CAAC;IAEF,OAAOH,KAAK,CAACI,QAAQ;EACvB;EAEAL,UAAU,CAACM,GAAG,GAAGP,aAAa;EAE9BQ,MAAM,CAACC,cAAc,CAACR,UAAU,EAAE,aAAa,EAAE;IAC/CS,GAAGA,CAAA,EAAG;MACJ,MAAMH,GAAG,GAAGZ,UAAU,CAAC,CAAC;MACxBC,MAAM,CACJ,MAAM;QACJW,GAAG,CAACH,KAAK,GAAGJ,aAAa,CAACI,KAAK,EAAEO,MAAM,CAAC,CAAC,CAACC,IAAI,CAAC,CAAC,CAACR,KAAK;MACxD,CAAC,EACDC,SAAS,EACT;QACEQ,KAAK,EAAE;UACLC,IAAI,EAAE,wBAAwB;UAC9BC,IAAI,EAAE;QACR;MACF,CACF,CAAC;MACD,OAAOR,GAAG;IACZ;EACF,CAAC,CAAC;EAEFN,UAAU,CAACe,aAAa,GAAIC,UAAwB,IAAK;IACvDrB,MAAM,CACJ,MAAM;MACJ,IAAI,CAACI,aAAa,CAACI,KAAK,EAAE;QACxB;MACF;MAEA,KAAK,MAAMc,MAAM,IAAIlB,aAAa,CAACI,KAAK,EAAE;QACxCc,MAAM,CAACF,aAAa,CAACC,UAAU,CAAC;MAClC;IACF,CAAC,EACDZ,SAAS,EACT;MACEQ,KAAK,EAAE;QACLC,IAAI,EAAE,wBAAwB;QAC9BC,IAAI,EAAE;MACR;IACF,CACF,CAAC;EACH,CAAC;EAEDd,UAAU,CAACkB,aAAa,GAAIF,UAAwB,IAAK;IACvDrB,MAAM,CACJ,MAAM;MACJ,IAAI,CAACI,aAAa,CAACI,KAAK,EAAE;QACxB;MACF;MACA,KAAK,MAAMc,MAAM,IAAIlB,aAAa,CAACI,KAAK,EAAE;QACxC,IAAIc,MAAM,CAACE,WAAW,EAAE;UACtBF,MAAM,CAACC,aAAa,CAACF,UAAU,CAAC;QAClC;MACF;IACF,CAAC,EACDZ,SAAS,EACT;MACEQ,KAAK,EAAE;QACLC,IAAI,EAAE,wBAAwB;QAC9BC,IAAI,EAAE;MACR;IACF,CACF,CAAC;EACH,CAAC;EAED,OAAOd,UAAU;AACnB","ignoreList":[]}

package/dist/dev/src/symbols/symbol-slot.test.js

@@ -0,0 +1,43 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { shallowRef } from "@vue/reactivity";
+import { expect, it } from "vitest";
+import { renderTree } from "../render.js";
+import { flushJobs } from "../scheduler.js";
+import { BasicSymbol } from "./basic-symbol.js";
+import { emitSymbol } from "./symbol-flow.js";
+import { createSymbolSlot } from "./symbol-slot.js";
+it("captures firstSymbol", async () => {
+  const Slot = createSymbolSlot();
+  renderTree(_$createComponent(Slot, {
+    children: () => {
+      emitSymbol(new BasicSymbol("a", undefined));
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 13,
+    columnNumber: 5
+  }));
+  await flushJobs();
+  expect(Slot.firstSymbol.value).toBeDefined();
+  expect(Slot.firstSymbol.value.name).toBe("a");
+});
+it("captures firstSymbol when emitting a ref to a symbol", async () => {
+  const Slot = createSymbolSlot();
+  const symref = shallowRef();
+  renderTree(_$createComponent(Slot, {
+    children: () => {
+      emitSymbol(symref);
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 29,
+    columnNumber: 5
+  }));
+  await flushJobs();
+  expect(Slot.firstSymbol.value).toBeUndefined();
+  symref.value = new BasicSymbol("a", undefined);
+  await flushJobs();
+  expect(Slot.firstSymbol.value).toBeDefined();
+  expect(Slot.firstSymbol.value.name).toBe("a");
+});
+//# sourceMappingURL=symbol-slot.test.js.map

package/dist/dev/src/symbols/symbol-slot.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["shallowRef","expect","it","renderTree","flushJobs","BasicSymbol","emitSymbol","createSymbolSlot","Slot","_$createComponent","children","undefined","fileName","import","meta","url","lineNumber","columnNumber","firstSymbol","value","toBeDefined","name","toBe","symref","toBeUndefined"],"sources":["../../../../src/symbols/symbol-slot.test.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,UAAU,QAAQ,iBAAiB;AAC5C,SAASC,MAAM,EAAEC,EAAE,QAAQ,QAAQ;AACnC,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,SAAS,QAAQ,iBAAiB;AAC3C,SAASC,WAAW,QAAQ,mBAAmB;AAC/C,SAASC,UAAU,QAAQ,kBAAkB;AAC7C,SAASC,gBAAgB;AAEzBL,EAAE,CAAC,sBAAsB,EAAE,YAAY;EACrC,MAAMM,IAAI,GAAGD,gBAAgB,CAAC,CAAC;EAE/BJ,UAAU,CAAAM,iBAAA,CACPD,IAAI;IAAAE,QAAA,EACFA,CAAA,KAAM;MACLJ,UAAU,CAAC,IAAID,WAAW,CAAC,GAAG,EAAEM,SAAS,CAAC,CAAC;IAC7C;EAAC;IAAAC,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA,EAEL,CAAC;EACD,MAAMb,SAAS,CAAC,CAAC;EACjBH,MAAM,CAACO,IAAI,CAACU,WAAW,CAACC,KAAK,CAAC,CAACC,WAAW,CAAC,CAAC;EAC5CnB,MAAM,CAACO,IAAI,CAACU,WAAW,CAACC,KAAK,CAAEE,IAAI,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC;AAChD,CAAC,CAAC;AAEFpB,EAAE,CAAC,sDAAsD,EAAE,YAAY;EACrE,MAAMM,IAAI,GAAGD,gBAAgB,CAAC,CAAC;EAC/B,MAAMgB,MAAM,GAAGvB,UAAU,CAA0B,CAAC;EAEpDG,UAAU,CAAAM,iBAAA,CACPD,IAAI;IAAAE,QAAA,EACFA,CAAA,KAAM;MACLJ,UAAU,CAACiB,MAAM,CAAC;IACpB;EAAC;IAAAX,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA,EAEL,CAAC;EACD,MAAMb,SAAS,CAAC,CAAC;EACjBH,MAAM,CAACO,IAAI,CAACU,WAAW,CAACC,KAAK,CAAC,CAACK,aAAa,CAAC,CAAC;EAC9CD,MAAM,CAACJ,KAAK,GAAG,IAAId,WAAW,CAAC,GAAG,EAAEM,SAAS,CAAC;EAC9C,MAAMP,SAAS,CAAC,CAAC;EACjBH,MAAM,CAACO,IAAI,CAACU,WAAW,CAACC,KAAK,CAAC,CAACC,WAAW,CAAC,CAAC;EAC5CnB,MAAM,CAACO,IAAI,CAACU,WAAW,CAACC,KAAK,CAAEE,IAAI,CAAC,CAACC,IAAI,CAAC,GAAG,CAAC;AAChD,CAAC,CAAC","ignoreList":[]}

package/dist/dev/src/symbols/symbol-table.js

@@ -0,0 +1,93 @@
+import { debug, TracePhase } from "../debug/index.js";
+import { ReactiveUnionSet } from "../reactive-union-set.js";
+import { queueJob } from "../scheduler.js";
+import { formatSymbolName, formatSymbolTableName } from "../tracer.js";
+export class SymbolTable extends ReactiveUnionSet {
+  #namesToDeconflict = new Set();
+  #nameConflictResolver;
+  #deconflictNames = () => {
+    for (const name of this.#namesToDeconflict) {
+      const conflictedSymbols = [...this].filter(sym => sym.originalName === name && !sym.ignoreNameConflict);
+      if (this.#nameConflictResolver) {
+        this.#nameConflictResolver(name, conflictedSymbols);
+      } else {
+        defaultConflictHandler(name, conflictedSymbols);
+      }
+      this.#namesToDeconflict.delete(name);
+    }
+  };
+  #binder;
+  get binder() {
+    return this.#binder;
+  }
+  #key;
+
+  /**
+   * The key of this symbol table, e.g. "static" or "instance".
+   */
+  get key() {
+    return this.#key;
+  }
+  #symbolsByRefkey;
+  /**
+   * The symbols defined within this scope, indexed by refkey.
+   */
+  get symbolsByRefkey() {
+    return this.#symbolsByRefkey;
+  }
+  #symbolNames;
+  get symbolNames() {
+    return this.#symbolNames;
+  }
+  constructor(key, binder, options = {}) {
+    super({
+      onAdd: symbol => {
+        debug.trace(TracePhase.symbol.addToScope, () => `${formatSymbolName(symbol)} added to ${formatSymbolTableName(this)}`);
+        this.#namesToDeconflict.add(symbol.name);
+        queueJob(this.#deconflictNames);
+        return symbol;
+      },
+      onDelete: symbol => {
+        debug.trace(TracePhase.symbol.removeFromScope, () => `${formatSymbolName(symbol)} removed from ${formatSymbolTableName(this)}`);
+      }
+    });
+    this.#nameConflictResolver = options.nameConflictResolver ?? binder?.nameConflictResolver;
+    this.#binder = binder;
+    this.#key = key;
+    this.#symbolsByRefkey = this.createIndex(s => s.refkeys);
+    this.#symbolNames = this.createIndex(s => {
+      return s.name;
+    });
+  }
+  moveTo(target) {
+    debug.trace(TracePhase.scope.moveSymbols, () => `${formatSymbolTableName(this)} -> ${formatSymbolTableName(target)}`);
+    target.addSubset(this, {
+      onAdd: symbol => {
+        symbol.spaces = [target];
+        return symbol;
+      }
+    });
+  }
+  copyTo(target, options = {}) {
+    debug.trace(TracePhase.scope.copySymbols, () => `${formatSymbolTableName(this)} copied to ${formatSymbolTableName(target)}`);
+    target.addSubset(this, {
+      onAdd: symbol => {
+        const copy = symbol.copy();
+        copy.spaces = [target];
+        copy.refkeys = options.createRefkeys?.(symbol) ?? [];
+        return copy;
+      }
+    });
+  }
+}
+
+/**
+ * Default conflict handler. This will rename all but the first symbol
+ * to have a suffix of _2, _3, etc.
+ */
+function defaultConflictHandler(_, conflictedSymbols) {
+  for (let i = 1; i < conflictedSymbols.length; i++) {
+    conflictedSymbols[i].name = conflictedSymbols[i].originalName + "_" + (i + 1);
+  }
+}
+//# sourceMappingURL=symbol-table.js.map

package/dist/dev/src/symbols/symbol-table.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["debug","TracePhase","ReactiveUnionSet","queueJob","formatSymbolName","formatSymbolTableName","SymbolTable","namesToDeconflict","Set","nameConflictResolver","deconflictNames","#deconflictNames","name","conflictedSymbols","filter","sym","originalName","ignoreNameConflict","defaultConflictHandler","delete","binder","key","symbolsByRefkey","symbolNames","constructor","options","onAdd","symbol","trace","addToScope","add","onDelete","removeFromScope","createIndex","s","refkeys","moveTo","target","scope","moveSymbols","addSubset","spaces","copyTo","copySymbols","copy","createRefkeys","_","i","length"],"sources":["../../../../src/symbols/symbol-table.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/tap.js

@@ -0,0 +1,109 @@
+import { shallowRef } from "@vue/reactivity";
+import { useContext } from "./context.js";
+import { DeclarationContext } from "./context/declaration.js";
+import { MemberDeclarationContext } from "./context/member-declaration.js";
+import { useScope } from "./context/scope.js";
+import { SourceFileContext } from "./context/source-file.js";
+
+/**
+ * The return value of {@link createTap}, this holds a reference to the tapped
+ * value. It will be undefined until the tapped value is initialized.
+ */
+
+/**
+ * A function called when the Tap is rendered.
+ *
+ * @returns The tapped value.
+ */
+
+/**
+ * A function that is called when the tapped value is available.
+ */
+
+/**
+ * Create a component that when rendered, initializes the tapped value
+ * with the provided callback. This is useful for accessing context
+ * provided by child components inside a parent component.
+ *
+ * @example
+ * ```tsx
+ * import { type Children, computed, createTap } from "@alloy-js/core";
+ *
+ * // context we will tap into
+ * const SomeContext = createContext<string>();
+ *
+ * // a component which provides some specific context
+ * function MyDeclaration(props: { children: Children }) {
+ *   return <SomeContext.Provider value="Hello World">
+ *     {props.children}
+ *   </SomeContext.Provider>;
+ * }
+ *
+ * // a parent component which wants to know about the context set
+ * // by its children
+ * function MySpecialDeclaration() {
+ *   const SomeContextTap = createTap(() => useContext(SomeContext));
+ *
+ *   return <>
+ *     The declaration context is: {SomeContextTap.ref}
+ *     <MyDeclaration>
+ *       <SomeContextTap />
+ *     </MyDeclaration>
+ *   </>
+ * }
+ *
+ * @see {@link createDeclarationTap} for tapping {@link DeclarationContext}.
+ * @see {@link createMemberTap} for tapping {@link MemberDeclarationContext}.
+ * @see {@link createScopeTap} for tapping {@link OutputScope}.
+ * @see {@link createSourceFileTap} for tapping {@link SourceFileContext}.
+ * ```
+ */
+export function createTap(tapper, handler) {
+  const signal = shallowRef(undefined);
+  const fn = () => {
+    signal.value = tapper();
+    if (handler && signal.value !== undefined) {
+      handler(signal.value);
+    }
+    return "";
+  };
+  fn.ref = signal;
+  return fn;
+}
+
+/**
+ * Create a tap for {@link DeclarationContext}.
+ */
+export function createDeclarationTap(handler) {
+  return createTap(() => {
+    return useContext(DeclarationContext);
+  }, handler);
+}
+
+/**
+ * Create a tap for {@link MemberDeclarationContext}.
+ */
+export function createMemberTap(handler) {
+  return createTap(() => {
+    return useContext(MemberDeclarationContext);
+  }, handler);
+}
+
+/**
+ * Create a tap for {@link OutputScope}.
+ */
+export function createScopeTap(handler) {
+  return createTap(() => {
+    return useScope();
+  }, handler);
+}
+
+/**
+ * Create a tap for {@link (SourceFileContext:interface)}.
+ */
+export function createSourceFileTap(handler) {
+  return createTap(() => {
+    return useContext(SourceFileContext);
+  }, handler);
+}
+//# sourceMappingURL=tap.js.map

package/dist/dev/src/tap.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["shallowRef","useContext","DeclarationContext","MemberDeclarationContext","useScope","SourceFileContext","createTap","tapper","handler","signal","undefined","fn","value","ref","createDeclarationTap","createMemberTap","createScopeTap","createSourceFileTap"],"sources":["../../../src/tap.ts"],"sourcesContent":[null],"mappings":"AAAA,SAAqBA,UAAU,QAAQ,iBAAiB;AACxD,SAASC,UAAU,QAAQ,cAAc;AACzC,SAASC,kBAAkB,QAAQ,0BAA0B;AAC7D,SAASC,wBAAwB,QAAQ,iCAAiC;AAC1E,SAASC,QAAQ,QAAQ,oBAAoB;AAC7C,SAASC,iBAAiB,QAAQ,0BAA0B;;AAK5D;AACA;AACA;AACA;;AAMA;AACA;AACA;AACA;AACA;;AAKA;AACA;AACA;;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CACvBC,MAAiB,EACjBC,OAAuB,EACf;EACR,MAAMC,MAAM,GAAGT,UAAU,CAAgBU,SAAS,CAAC;EACnD,MAAMC,EAAE,GAAGA,CAAA,KAAM;IACfF,MAAM,CAACG,KAAK,GAAGL,MAAM,CAAC,CAAC;IACvB,IAAIC,OAAO,IAAIC,MAAM,CAACG,KAAK,KAAKF,SAAS,EAAE;MACzCF,OAAO,CAACC,MAAM,CAACG,KAAK,CAAC;IACvB;IAEA,OAAO,EAAE;EACX,CAAC;EAEDD,EAAE,CAACE,GAAG,GAAGJ,MAAM;EAEf,OAAOE,EAAE;AACX;;AAEA;AACA;AACA;AACA,OAAO,SAASG,oBAAoBA,CAElCN,OAA6B,EAAE;EAC/B,OAAOF,SAAS,CAAU,MAAM;IAC9B,OAAOL,UAAU,CAACC,kBAAkB,CAAC;EACvC,CAAC,EAAEM,OAAO,CAAC;AACb;;AAEA;AACA;AACA;AACA,OAAO,SAASO,eAAeA,CAC7BP,OAA6B,EAC7B;EACA,OAAOF,SAAS,CAAU,MAAM;IAC9B,OAAOL,UAAU,CAACE,wBAAwB,CAAC;EAC7C,CAAC,EAAEK,OAAO,CAAC;AACb;;AAEA;AACA;AACA;AACA,OAAO,SAASQ,cAAcA,CAC5BR,OAA4B,EAC5B;EACA,OAAOF,SAAS,CAAS,MAAM;IAC7B,OAAOF,QAAQ,CAAC,CAAC;EACnB,CAAC,EAAEI,OAAO,CAAC;AACb;;AAEA;AACA;AACA;AACA,OAAO,SAASS,mBAAmBA,CAACT,OAAuC,EAAE;EAC3E,OAAOF,SAAS,CAAC,MAAM;IACrB,OAAOL,UAAU,CAACI,iBAAiB,CAAC;EACtC,CAAC,EAAEG,OAAO,CAAC;AACb","ignoreList":[]}

package/dist/dev/src/trace.js

@@ -0,0 +1,2 @@
+// Legacy module removed in favor of ./debug.ts.
+//# sourceMappingURL=trace.js.map

package/dist/dev/src/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["../../../src/trace.ts"],"sourcesContent":[null],"mappings":"AAAA","ignoreList":[]}

package/dist/dev/src/tracer.js

@@ -0,0 +1,180 @@
+import { effect } from "@vue/reactivity";
+import { debug, isConsoleTraceEnabled } from "./debug/index.js";
+import { colorText, parseBreakOnIds } from "./debug/trace.js";
+import { untrack } from "./reactivity.js";
+import { inspectRefkey } from "./refkey.js";
+import { scheduler } from "./scheduler.js";
+const dids = parseBreakOnIds();
+let triggerCount = 0;
+export function traceEffect(phase, cb) {
+  if (!isConsoleTraceEnabled(phase.area) && !isConsoleTraceEnabled(phase.area + "." + phase.subarea)) return;
+  let first = true;
+  const triggerIds = new Set();
+  effect(() => {
+    if (first) {
+      // just track what we need, don't log.
+      cb();
+      first = false;
+      return;
+    }
+    debug.trace(phase, cb, triggerIds);
+    triggerIds.clear();
+  }, {
+    scheduler: scheduler(true),
+    onTrigger(event) {
+      const id = triggerCount++;
+      if (dids.has(id)) {
+        // eslint-disable-next-line no-debugger
+        debugger;
+      }
+      triggerIds.add(id);
+    }
+  });
+}
+
+/**
+ * Format a symbol name with its ID in a blue-green color
+ * @param symbol The symbol to format
+ * @returns A formatted string representation of the symbol name with ID
+ */
+export function formatSymbolName(symbol) {
+  return colorText(`Symbol ${symbol.name}[${symbol.id}]`, {
+    fg: {
+      r: 0,
+      b: 150,
+      g: 100
+    }
+  });
+}
+export function formatSymbol(symbol) {
+  // Base display with name and ID
+  let result = formatSymbolName(symbol);
+
+  // Add details on subsequent lines
+  const details = [];
+  if (!symbol.binder) {
+    details.push(colorText("  !UNBOUND", {
+      fg: {
+        r: 255,
+        g: 0,
+        b: 0
+      }
+    }));
+  }
+
+  // Show scope info with formatted name
+  if (symbol.scope) {
+    details.push(untrack(() => `  scope: ${formatScopeName(symbol.scope)}`));
+  }
+  for (const space of symbol.memberSpaces) {
+    details.push(untrack(() => formatSpaceSymbols(space)));
+  }
+  if (symbol.ownerSymbol) {
+    details.push(untrack(() => `  ownerSymbol: ${formatSymbolName(symbol.ownerSymbol)}`));
+  }
+
+  // Show all refkeys with proper formatting
+  if (symbol.refkeys && symbol.refkeys.length > 0) {
+    details.push(`  refkeys: ${formatRefkeys(symbol.refkeys)}`);
+  }
+  if (details.length > 0) {
+    result += "\n" + details.join("\n");
+  }
+  return result;
+}
+export function formatSpaceSymbols(space) {
+  return `  ${space.key} symbols (${space.size}): ${[...space].map(s => s.name).join(", ")}`;
+}
+export function formatScopeName(scope) {
+  if (!scope) {
+    return "no scope";
+  }
+  return colorText(`${scope.name}[${scope.id}]`, {
+    fg: {
+      r: 0,
+      g: 150,
+      b: 50
+    }
+  });
+}
+export function formatSymbolTableName(table) {
+  // avoid instance of checks here in order to not create circular module imports.
+  const name = "symbol" in table ? formatSymbolName(table.symbol) : formatScopeName(table.scope);
+  return colorText(`${name}:${table.key}`, {
+    fg: {
+      r: 0,
+      g: 125,
+      b: 25
+    }
+  });
+}
+
+/**
+ * Format an OutputScope for display, showing information in a concise format
+ * @param scope The scope to format
+ * @returns A formatted string representation of the scope
+ */
+export function formatScope(scope) {
+  if (!scope) {
+    return "!Undefined scope!";
+  }
+  // Base display with name
+  let result = colorText(`Scope ${formatScopeName(scope)}`, {
+    fg: {
+      r: 0,
+      b: 200,
+      g: 100
+    }
+  });
+
+  // Add details on subsequent lines
+  const details = [];
+  if (!scope.binder) {
+    details.push(colorText("  !UNBOUND", {
+      fg: {
+        r: 255,
+        g: 0,
+        b: 0
+      }
+    }));
+  }
+
+  // Show parent scope if present
+  if (scope.parent) {
+    details.push(`  parent: ${formatScopeName(scope.parent)}`);
+  }
+
+  // Show child scopes if present
+  if (scope.children && scope.children.size > 0) {
+    details.push(`  children: ${scope.children.size}`);
+  }
+
+  // Show declaration spaces
+  for (const space of scope.spaces) {
+    details.push(`  ${untrack(() => formatSpaceSymbols(space))}`);
+  }
+  if (details.length > 0) {
+    result += "\n" + details.join("\n");
+  }
+  return result;
+}
+export function formatRefkeys(refkeys) {
+  if (!refkeys) {
+    return "";
+  }
+  if (Array.isArray(refkeys)) {
+    return refkeys.map(formatRefkey).join(", ");
+  }
+  return formatRefkey(refkeys);
+}
+function formatRefkey(refkey) {
+  const text = inspectRefkey(refkey);
+  return colorText(text, {
+    fg: {
+      r: 150,
+      g: 0,
+      b: 0
+    }
+  });
+}
+//# sourceMappingURL=tracer.js.map

package/dist/dev/src/tracer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["effect","debug","isConsoleTraceEnabled","colorText","parseBreakOnIds","untrack","inspectRefkey","scheduler","dids","triggerCount","traceEffect","phase","cb","area","subarea","first","triggerIds","Set","trace","clear","onTrigger","event","id","has","add","formatSymbolName","symbol","name","fg","r","b","g","formatSymbol","result","details","binder","push","scope","formatScopeName","space","memberSpaces","formatSpaceSymbols","ownerSymbol","refkeys","length","formatRefkeys","join","key","size","map","s","formatSymbolTableName","table","formatScope","parent","children","spaces","Array","isArray","formatRefkey","refkey","text"],"sources":["../../../src/tracer.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}