@alloy-js/core 0.23.0-dev.9 → 0.23.0

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

@@ -0,0 +1,106 @@
+import { isRef } from "@vue/reactivity";
+import { effect, getContext, onCleanup, shallowReactive } from "../reactivity.js";
+import { MemberContext } from "../context/member-scope.js";
+import { ScopeContext } from "../context/scope.js";
+import { debug, TracePhase } from "../debug/index.js";
+import { formatSymbolName } from "../tracer.js";
+export function takeSymbols(cb) {
+  const context = getContext();
+  context.takesSymbols = true;
+  context.takenSymbols = shallowReactive(new Set());
+  if (cb) {
+    effect(oldSymbols => {
+      for (const symbol of context.takenSymbols) {
+        if (oldSymbols && oldSymbols.has(symbol)) {
+          continue;
+        }
+        cb(symbol);
+      }
+      return new Set(context.takenSymbols);
+    }, undefined, {
+      debug: {
+        name: "symbolFlow:takeSymbols",
+        type: "symbol"
+      }
+    });
+  }
+  return context.takenSymbols;
+}
+export function emitSymbol(symbol) {
+  if (isRef(symbol)) {
+    debug.trace(TracePhase.symbol.flow, () => `Emitting ref to symbol`);
+  } else {
+    debug.trace(TracePhase.symbol.flow, () => `Emitting symbol ${formatSymbolName(symbol)}`);
+  }
+  let symbolTaker;
+  let context = getContext().owner;
+  while (context) {
+    if (context.takesSymbols) {
+      symbolTaker = context;
+      break;
+    }
+    if (context.context && (context.context[ScopeContext.id] || context.context[MemberContext.id])) {
+      // don't cross scope boundaries.
+      debug.trace(TracePhase.symbol.flow, () => `Not emitting symbol across scope boundary`);
+      break;
+    }
+    context = context.owner;
+  }
+  if (!symbolTaker) {
+    debug.trace(TracePhase.symbol.flow, () => `No symbol taker found, not emitting`);
+    return;
+  }
+  if (isRef(symbol)) {
+    effect(prevSymbol => {
+      onCleanup(() => {
+        if (symbol.value) {
+          symbolTaker.takenSymbols.delete(symbol.value);
+        }
+      });
+      if (symbol.value === undefined) {
+        symbolTaker.takenSymbols.delete(prevSymbol);
+        return undefined;
+      } else {
+        symbolTaker.takenSymbols.add(symbol.value);
+        return symbol.value;
+      }
+    }, undefined, {
+      debug: {
+        name: "symbolFlow:emitRef",
+        type: "symbol"
+      }
+    });
+  } else {
+    debug.trace(TracePhase.symbol.flow, () => `Emitting symbol ${formatSymbolName(symbol)} taken by ${symbolTaker.componentOwner?.name ?? "unknown component"}`);
+    symbolTaker.takenSymbols.add(symbol);
+    onCleanup(() => {
+      context.takenSymbols.delete(symbol);
+    });
+  }
+}
+export function moveTakenMembersTo(baseSymbol) {
+  const taken = takeSymbols();
+  effect(() => {
+    for (const symbol of taken) {
+      if (symbol.isTransient) {
+        symbol.moveMembersTo(baseSymbol);
+      }
+      for (const refkey of symbol.refkeys) {
+        if (!baseSymbol.refkeys.includes(refkey)) {
+          baseSymbol.refkeys.push(refkey);
+        }
+      }
+    }
+  }, undefined, {
+    debug: {
+      name: "symbolFlow:moveTakenMembers",
+      type: "symbol"
+    }
+  });
+}
+export function instantiateTakenMembersTo(baseSymbol, toSpaceKey, fromSpaceKey) {
+  takeSymbols(symbol => {
+    baseSymbol.type = symbol;
+  });
+}
+//# sourceMappingURL=symbol-flow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["isRef","effect","getContext","onCleanup","shallowReactive","MemberContext","ScopeContext","debug","TracePhase","formatSymbolName","takeSymbols","cb","context","takesSymbols","takenSymbols","Set","oldSymbols","symbol","has","undefined","name","type","emitSymbol","trace","flow","symbolTaker","owner","id","prevSymbol","value","delete","add","componentOwner","moveTakenMembersTo","baseSymbol","taken","isTransient","moveMembersTo","refkey","refkeys","includes","push","instantiateTakenMembersTo","toSpaceKey","fromSpaceKey"],"sources":["../../../../src/symbols/symbol-flow.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,75 @@
+import { shallowRef } from "@vue/reactivity";
+import { emitDiagnostic } from "../diagnostics.js";
+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) {
+    if (symbolSlotRef.value !== undefined) {
+      emitDiagnostic({
+        message: "SymbolSlot rendered more than once. The second render will overwrite symbols captured by the first render.",
+        severity: "error"
+      });
+    }
+    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","emitDiagnostic","effect","onCleanup","takeSymbols","createSymbolSlot","symbolSlotRef","SymbolSlot","props","value","undefined","message","severity","set","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,cAAc,QAAQ,mBAAmB;AAClD,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,GACtEN,UAAU,CAAC,CAAC;EACd,SAASO,UAAUA,CAACC,KAA6B,EAAE;IACjD,IAAIF,aAAa,CAACG,KAAK,KAAKC,SAAS,EAAE;MACrCT,cAAc,CAAC;QACbU,OAAO,EACL,4GAA4G;QAC9GC,QAAQ,EAAE;MACZ,CAAC,CAAC;IACJ;IACA,MAAMC,GAAG,GAAGT,WAAW,CAAC,CAAC;IACzBE,aAAa,CAACG,KAAK,GAAGI,GAAG;IAEzBV,SAAS,CAAC,MAAM;MACdG,aAAa,CAACG,KAAK,GAAGC,SAAS;IACjC,CAAC,CAAC;IAEF,OAAOF,KAAK,CAACM,QAAQ;EACvB;EAEAP,UAAU,CAACQ,GAAG,GAAGT,aAAa;EAE9BU,MAAM,CAACC,cAAc,CAACV,UAAU,EAAE,aAAa,EAAE;IAC/CW,GAAGA,CAAA,EAAG;MACJ,MAAMH,GAAG,GAAGf,UAAU,CAAC,CAAC;MACxBE,MAAM,CACJ,MAAM;QACJa,GAAG,CAACN,KAAK,GAAGH,aAAa,CAACG,KAAK,EAAEU,MAAM,CAAC,CAAC,CAACC,IAAI,CAAC,CAAC,CAACX,KAAK;MACxD,CAAC,EACDC,SAAS,EACT;QACEW,KAAK,EAAE;UACLC,IAAI,EAAE,wBAAwB;UAC9BC,IAAI,EAAE;QACR;MACF,CACF,CAAC;MACD,OAAOR,GAAG;IACZ;EACF,CAAC,CAAC;EAEFR,UAAU,CAACiB,aAAa,GAAIC,UAAwB,IAAK;IACvDvB,MAAM,CACJ,MAAM;MACJ,IAAI,CAACI,aAAa,CAACG,KAAK,EAAE;QACxB;MACF;MAEA,KAAK,MAAMiB,MAAM,IAAIpB,aAAa,CAACG,KAAK,EAAE;QACxCiB,MAAM,CAACF,aAAa,CAACC,UAAU,CAAC;MAClC;IACF,CAAC,EACDf,SAAS,EACT;MACEW,KAAK,EAAE;QACLC,IAAI,EAAE,wBAAwB;QAC9BC,IAAI,EAAE;MACR;IACF,CACF,CAAC;EACH,CAAC;EAEDhB,UAAU,CAACoB,aAAa,GAAIF,UAAwB,IAAK;IACvDvB,MAAM,CACJ,MAAM;MACJ,IAAI,CAACI,aAAa,CAACG,KAAK,EAAE;QACxB;MACF;MACA,KAAK,MAAMiB,MAAM,IAAIpB,aAAa,CAACG,KAAK,EAAE;QACxC,IAAIiB,MAAM,CAACE,WAAW,EAAE;UACtBF,MAAM,CAACC,aAAa,CAACF,UAAU,CAAC;QAClC;MACF;IACF,CAAC,EACDf,SAAS,EACT;MACEW,KAAK,EAAE;QACLC,IAAI,EAAE,wBAAwB;QAC9BC,IAAI,EAAE;MACR;IACF,CACF,CAAC;EACH,CAAC;EAED,OAAOhB,UAAU;AACnB","ignoreList":[]}

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

@@ -0,0 +1,68 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { shallowRef } from "@vue/reactivity";
+import { expect, it } from "vitest";
+import { getDiagnosticsForTree, 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("emits error diagnostic when rendered more than once", async () => {
+  const Slot = createSymbolSlot();
+  const tree = renderTree([_$createComponent(Slot, {
+    children: () => {
+      emitSymbol(new BasicSymbol("a", undefined));
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 29,
+    columnNumber: 7
+  }), _$createComponent(Slot, {
+    children: () => {
+      emitSymbol(new BasicSymbol("b", undefined));
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 34,
+    columnNumber: 7
+  })]);
+  await flushJobs();
+  const diagnostics = getDiagnosticsForTree(tree);
+  expect(diagnostics.length).toBe(1);
+  expect(diagnostics[0].severity).toBe("error");
+  expect(diagnostics[0].message).toContain("SymbolSlot rendered more than once");
+});
+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: 56,
+    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","getDiagnosticsForTree","renderTree","flushJobs","BasicSymbol","emitSymbol","createSymbolSlot","Slot","_$createComponent","children","undefined","fileName","import","meta","url","lineNumber","columnNumber","firstSymbol","value","toBeDefined","name","toBe","tree","diagnostics","length","severity","message","toContain","symref","toBeUndefined"],"sources":["../../../../src/symbols/symbol-slot.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,103 @@
+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.canonicalName === 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.canonicalName);
+        queueJob(this.#deconflictNames);
+        return symbol;
+      },
+      onDelete: symbol => {
+        debug.trace(TracePhase.symbol.removeFromScope, () => `${formatSymbolName(symbol)} removed from ${formatSymbolTableName(this)}`);
+        // Re-run conflict resolution for the deleted symbol's canonical name
+        // so survivors in the same cohort (those that share the canonical
+        // name) can clear any prior `deconflictedName` rename now that the
+        // collision is reduced.
+        this.#namesToDeconflict.add(symbol.canonicalName);
+        queueJob(this.#deconflictNames);
+      }
+    });
+    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) {
+  if (conflictedSymbols.length === 0) return;
+  // The first symbol keeps its original name; clear any prior deconflict
+  // rename so it reverts after a collision is resolved.
+  conflictedSymbols[0].deconflictedName = undefined;
+  for (let i = 1; i < conflictedSymbols.length; i++) {
+    conflictedSymbols[i].deconflictedName = 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","canonicalName","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","_","length","deconflictedName","undefined","i","originalName"],"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":[]}