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

package/dist/src/reactivity.js

@@ -1,38 +1,63 @@
-import { isRef, pauseTracking, ref, resetTracking, shallowRef, stop, effect as vueEffect } from "@vue/reactivity";
+import { isRef, pauseTracking, resetTracking, stop, computed as vueComputed, effect as vueEffect, ref as vueRef, shallowReactive as vueShallowReactive, shallowRef as vueShallowRef, toRef as vueToRef, toRefs as vueToRefs } from "@vue/reactivity";
+import { captureSourceLocation, debug, isDevtoolsEnabled } from "./debug/index.js";
 import { scheduler } from "./scheduler.js";
-import { trace, TracePhase } from "./tracer.js";
-
-// check for multiple versions of alloy here.
 if (globalThis.__ALLOY__) {
   throw new Error("Multiple versions of Alloy are loaded for this project. This will likely cause undesirable behavior.");
 }
 globalThis.__ALLOY__ = true;
 export function getElementCache() {
-  return getContext().elementCache;
+  const ctx = getContext();
+  return ctx.elementCache ??= new Map();
 }
+let contextIdCounter = 0;
 let globalContext = null;
 export function getContext() {
   return globalContext;
 }
+
+/**
+ * Walk up the owner chain to find the nearest ancestor context that
+ * corresponds to an effect (has meta.effectId). This bridges non-effect
+ * scopes (like createRoot iterations in For) so the owner chain always
+ * connects effect-to-effect.
+ */
+function resolveOwnerEffectContextId(context) {
+  let owner = context.owner;
+  while (owner) {
+    if (owner.meta?.effectId !== undefined) {
+      return owner.id;
+    }
+    owner = owner.owner;
+  }
+  return context.owner?.id ?? null;
+}
+
+/**
+ * Ensure that a context has an isEmpty ref, creating one if needed.
+ * Only call this when you need to reactively observe isEmpty (e.g.,
+ * ContentSlot, mapJoin). Most contexts don't need an isEmpty ref.
+ */
+export function ensureIsEmpty(context) {
+  context.isEmpty ??= ref(context.childrenWithContent === 0);
+  return context.isEmpty;
+}
 export function root(fn, options) {
   const context = {
+    id: contextIdCounter++,
     componentOwner: options?.componentOwner,
-    disposables: [],
     owner: globalContext,
-    context: {},
-    elementCache: new Map(),
     takesSymbols: false,
     takenSymbols: undefined,
     childrenWithContent: 0,
-    isEmpty: ref(true),
+    _lastEmpty: true,
     isRoot: true
   };
   globalContext = context;
   let ret;
   try {
     ret = untrack(() => fn(() => {
-      for (const d of context.disposables) {
-        d();
+      for (const d of context.disposables ?? []) {
+        untrack(d);
       }
     }));
   } finally {
@@ -46,36 +71,127 @@ export function untrack(fn) {
   resetTracking();
   return v;
 }
-export function memo(fn, equal) {
+
+/**
+ * Walk up the context owner chain to find the nearest effect ID.
+ * Used to attribute reactive mutations to the effect that caused them.
+ */
+export function findCurrentEffectId() {
+  let ctx = globalContext;
+  while (ctx) {
+    const id = ctx.meta?.effectId;
+    if (id !== undefined && id !== -1) return id;
+    ctx = ctx.owner;
+  }
+  return undefined;
+}
+export function memo(fn, equal, name) {
   const o = shallowRef();
   effect(prev => {
     const res = fn();
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     (!equal || prev !== res) && (o.value = res);
     return res;
-  }, undefined);
-  return () => o.value;
+  }, undefined, {
+    debug: {
+      name: name ? `memo:${name}` : "memo"
+    }
+  });
+  const getter = () => o.value;
+  if (name) {
+    Object.defineProperty(getter, "name", {
+      value: name,
+      configurable: true
+    });
+  }
+  return getter;
 }
-export function effect(fn, current) {
+export function effect(fn, current, options) {
   const context = {
-    context: {},
-    disposables: [],
+    id: contextIdCounter++,
     owner: globalContext,
-    elementCache: new Map(),
     takesSymbols: false,
     takenSymbols: undefined,
     childrenWithContent: 0,
+    _lastEmpty: true,
     isRoot: false
   };
+  const debugInfo = options?.debug;
+  const effectId = debug.effect.register({
+    name: debugInfo?.name ?? fn.name,
+    type: debugInfo?.type,
+    createdAt: captureSourceLocation(),
+    contextId: context.id,
+    ownerContextId: resolveOwnerEffectContextId(context)
+  });
+  if (effectId !== -1) {
+    context.meta ??= {};
+    context.meta.effectId = effectId;
+  }
   const cleanupFn = final => {
     const d = context.disposables;
-    context.disposables = [];
-    for (let k = 0, len = d.length; k < len; k++) d[k]();
+    context.disposables = undefined;
+    if (d) {
+      for (let k = 0, len = d.length; k < len; k++) untrack(d[k]);
+    }
 
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     final && stop(runner);
   };
   onCleanup(() => cleanupFn(true));
+  const effectOpts = {
+    // allow recursive effects with 32, 1 and 4 are default flags
+    flags: 1 | 4 | 32,
+    scheduler: scheduler()
+  };
+  if (effectId !== -1) {
+    effectOpts.onTrack = event => {
+      const targetKey = typeof event.key === "symbol" ? event.key.toString() : event.key;
+      if (isRef(event.target)) {
+        const id = refId(event.target);
+        debug.effect.ensureRef({
+          id,
+          kind: "ref"
+        });
+        debug.effect.track({
+          effectId,
+          target: event.target,
+          refId: id,
+          targetKey
+        });
+      } else {
+        debug.effect.track({
+          effectId,
+          target: event.target,
+          targetKey
+        });
+      }
+    };
+    effectOpts.onTrigger = event => {
+      const targetKey = typeof event.key === "symbol" ? event.key.toString() : event.key;
+      if (isRef(event.target)) {
+        const id = refId(event.target);
+        debug.effect.ensureRef({
+          id,
+          kind: "ref"
+        });
+        debug.effect.trigger({
+          effectId,
+          target: event.target,
+          refId: id,
+          targetKey,
+          kind: "triggered-by"
+        });
+      } else {
+        debug.effect.trigger({
+          effectId,
+          target: event.target,
+          targetKey,
+          kind: "triggered-by"
+        });
+      }
+    };
+  }
   const runner = vueEffect(() => {
     cleanupFn(false);
     const oldContext = globalContext;
@@ -85,22 +201,10 @@ export function effect(fn, current) {
     } finally {
       globalContext = oldContext;
     }
-  }, {
-    // allow recursive effects with 32, 1 and 4 are default flags
-    // @ts-expect-error flags is a vue internal thing
-    flags: 1 | 4 | 32,
-    scheduler: scheduler(),
-    onTrack(event) {
-      trace(TracePhase.effect.track, () => {
-        return `tracking ${isRef(event.target) ? `Ref:${refId(event.target)}` : event.target}, ${String(event.key)}`;
-      });
-    },
-    onTrigger(event) {
-      trace(TracePhase.effect.trigger, () => {
-        return `triggering ${isRef(event.target) ? `Ref:${refId(event.target)}` : event.target}, ${String(event.key)}`;
-      });
-    }
-  });
+  }, effectOpts);
+  if (effectId !== -1) {
+    effectIdMap.set(runner.effect, effectId);
+  }
 }
 
 /**
@@ -123,7 +227,7 @@ export function effect(fn, current) {
  */
 export function onCleanup(fn) {
   if (globalContext != null) {
-    globalContext.disposables.push(fn);
+    (globalContext.disposables ??= []).push(fn);
   }
 }
 
@@ -144,14 +248,96 @@ export function createCustomContext(useCallback) {
 export function isCustomContext(child) {
   return typeof child === "object" && child !== null && Object.hasOwn(child, CUSTOM_CONTEXT_SYM);
 }
+export function ref(value, options) {
+  const result = vueRef(value);
+  debug.effect.registerRef({
+    id: refId(result, options?.isInfrastructure),
+    kind: "ref",
+    createdAt: captureSourceLocation(),
+    createdByEffectId: globalContext?.meta?.effectId,
+    isInfrastructure: options?.isInfrastructure
+  });
+  return result;
+}
+
+// Stores creation location for shallowReactive objects so registerNonRefTarget
+// can look it up later (since targets are lazily registered on first track/trigger).
+const reactiveCreationLocations = new WeakMap();
+export function getReactiveCreationLocation(target) {
+  return reactiveCreationLocations.get(target);
+}
+export function shallowReactive(target) {
+  const result = vueShallowReactive(target);
+  if (isDevtoolsEnabled()) {
+    // Store by raw target — Vue's onTrack/onTrigger events pass the raw object, not the proxy.
+    reactiveCreationLocations.set(target, captureSourceLocation());
+  }
+  return result;
+}
+export function shallowRef(value) {
+  const result = vueShallowRef(value);
+  debug.effect.registerRef({
+    id: refId(result),
+    kind: "shallowRef",
+    createdAt: captureSourceLocation(),
+    createdByEffectId: globalContext?.meta?.effectId
+  });
+  return result;
+}
+export function computed(getter) {
+  const result = vueComputed(getter);
+  debug.effect.registerRef({
+    id: refId(result),
+    kind: "computed",
+    createdAt: captureSourceLocation(),
+    createdByEffectId: globalContext?.meta?.effectId
+  });
+  return result;
+}
+export function toRef(object, key, defaultValue) {
+  const result = defaultValue === undefined ? vueToRef(object, key) : vueToRef(object, key, defaultValue);
+  debug.effect.registerRef({
+    id: refId(result),
+    kind: "toRef",
+    createdAt: captureSourceLocation(),
+    createdByEffectId: globalContext?.meta?.effectId
+  });
+  return result;
+}
+export function toRefs(object) {
+  const result = vueToRefs(object);
+  for (const refValue of Object.values(result)) {
+    debug.effect.registerRef({
+      id: refId(refValue),
+      kind: "toRef",
+      createdAt: captureSourceLocation(),
+      createdByEffectId: globalContext?.meta?.effectId
+    });
+  }
+  return result;
+}
 const seenRefs = new WeakMap();
 let refIdCounter = 1;
-export function refId(ref) {
+let infraRefIdCounter = -1;
+const effectIdMap = new WeakMap();
+export function refId(ref, isInfrastructure) {
   let id = seenRefs.get(ref);
   if (id === undefined) {
-    id = refIdCounter++;
+    id = isInfrastructure ? infraRefIdCounter-- : refIdCounter++;
     seenRefs.set(ref, id);
   }
   return id;
 }
+
+/** Allocate a unique reactive target ID from the same counter space as ref IDs. */
+export function nextReactiveId() {
+  return refIdCounter++;
+}
+export function resetRefIdCounter() {
+  refIdCounter = 1;
+  infraRefIdCounter = -1;
+}
+export function getEffectDebugId(effect) {
+  return effectIdMap.get(effect);
+}
 //# sourceMappingURL=reactivity.js.map

package/dist/src/reactivity.js.map

@@ -1 +1 @@
-{"version":3,"names":["isRef","pauseTracking","ref","resetTracking","shallowRef","stop","effect","vueEffect","scheduler","trace","TracePhase","globalThis","__ALLOY__","Error","getElementCache","getContext","elementCache","globalContext","root","fn","options","context","componentOwner","disposables","owner","Map","takesSymbols","takenSymbols","undefined","childrenWithContent","isEmpty","isRoot","ret","untrack","d","v","memo","equal","o","prev","res","value","current","cleanupFn","final","k","len","length","runner","onCleanup","oldContext","flags","onTrack","event","track","target","refId","String","key","onTrigger","trigger","push","CUSTOM_CONTEXT_SYM","Symbol","createCustomContext","useCallback","useCustomContext","useCb","isCustomContext","child","Object","hasOwn","seenRefs","WeakMap","refIdCounter","id","get","set"],"sources":["../../src/reactivity.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["isRef","pauseTracking","resetTracking","stop","computed","vueComputed","effect","vueEffect","ref","vueRef","shallowReactive","vueShallowReactive","shallowRef","vueShallowRef","toRef","vueToRef","toRefs","vueToRefs","captureSourceLocation","debug","isDevtoolsEnabled","scheduler","globalThis","__ALLOY__","Error","getElementCache","ctx","getContext","elementCache","Map","contextIdCounter","globalContext","resolveOwnerEffectContextId","context","owner","meta","effectId","undefined","id","ensureIsEmpty","isEmpty","childrenWithContent","root","fn","options","componentOwner","takesSymbols","takenSymbols","_lastEmpty","isRoot","ret","untrack","d","disposables","v","findCurrentEffectId","memo","equal","name","o","prev","res","value","getter","Object","defineProperty","configurable","current","debugInfo","register","type","createdAt","contextId","ownerContextId","cleanupFn","final","k","len","length","runner","onCleanup","effectOpts","flags","onTrack","event","targetKey","key","toString","target","refId","ensureRef","kind","track","onTrigger","trigger","oldContext","effectIdMap","set","push","CUSTOM_CONTEXT_SYM","Symbol","createCustomContext","useCallback","useCustomContext","useCb","isCustomContext","child","hasOwn","result","registerRef","isInfrastructure","createdByEffectId","reactiveCreationLocations","WeakMap","getReactiveCreationLocation","get","object","defaultValue","refValue","values","seenRefs","refIdCounter","infraRefIdCounter","nextReactiveId","resetRefIdCounter","getEffectDebugId"],"sources":["../../src/reactivity.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/render-stack.d.ts

@@ -1,13 +1,30 @@
+import { Context } from "./reactivity.js";
 import { Component, Props, SourceLocation } from "./runtime/component.js";
+export interface RenderStackSnapshotEntry {
+    component: Component<any>;
+    props: Props;
+    context: Context | null;
+    source?: SourceLocation;
+    displayName: string;
+}
 export declare function pushStack(component: Component<any>, props: Props, source?: SourceLocation): void;
 export declare function popStack(): void;
+export declare function currentComponentName(): string | undefined;
 export declare function clearRenderStack(): void;
+/**
+ * Get the current rendering path from the render stack context.
+ * Prefers SourceFileContext over SourceDirectoryContext.
+ */
+export declare function getCurrentRenderPath(): string | undefined;
+export declare function getRenderStackSnapshot(): RenderStackSnapshotEntry[];
 /**
  * Print the current render stack to the console for debugging.
  *
  * This differs from debug.component.stack in that this uses a purpose-built
  * stack rather than walking the context chain. When this is called, the context
  * chain has been restored. In the future this can probably be unified nicely.
+ *
+ * @param error - Optional error to print the stack trace from
  */
-export declare function printRenderStack(): void;
+export declare function printRenderStack(error?: unknown): void;
 //# sourceMappingURL=render-stack.d.ts.map

package/dist/src/render-stack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-stack.d.ts","sourceRoot":"","sources":["../../src/render-stack.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAU1E,wBAAgB,SAAS,CACvB,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EACzB,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,cAAc,QAGxB;AAED,wBAAgB,QAAQ,SAEvB;AAED,wBAAgB,gBAAgB,SAE/B;AA4DD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,SA6H/B"}
+{"version":3,"file":"render-stack.d.ts","sourceRoot":"","sources":["../../src/render-stack.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAc,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAU1E,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,SAAS,CACvB,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EACzB,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,cAAc,QAGxB;AAED,wBAAgB,QAAQ,SAEvB;AAED,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAGzD;AAED,wBAAgB,gBAAgB,SAE/B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAoBzD;AAED,wBAAgB,sBAAsB,IAAI,wBAAwB,EAAE,CAQnE;AA4DD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,OAAO,QAkJ/C"}

package/dist/src/render-stack.js

@@ -16,10 +16,47 @@ export function pushStack(component, props, source) {
 export function popStack() {
   renderStack.pop();
 }
+export function currentComponentName() {
+  const entry = renderStack[renderStack.length - 1];
+  return entry?.component.name || undefined;
+}
 export function clearRenderStack() {
   renderStack.length = 0;
 }
 
+/**
+ * Get the current rendering path from the render stack context.
+ * Prefers SourceFileContext over SourceDirectoryContext.
+ */
+export function getCurrentRenderPath() {
+  let currentPath;
+  for (let i = renderStack.length - 1; i >= 0; i--) {
+    const {
+      context
+    } = renderStack[i];
+    // Prefer SourceFileContext over SourceDirectoryContext
+    if (context?.context?.[SourceFileContext.id]) {
+      const fileContext = context.context[SourceFileContext.id];
+      return fileContext.path;
+    }
+    if (!currentPath && context?.context?.[SourceDirectoryContext.id]) {
+      const dirContext = context.context[SourceDirectoryContext.id];
+      currentPath = dirContext.path;
+      // Don't break - keep looking for a SourceFileContext
+    }
+  }
+  return currentPath;
+}
+export function getRenderStackSnapshot() {
+  return renderStack.map(entry => ({
+    component: entry.component,
+    props: entry.props,
+    context: entry.context,
+    source: entry.source,
+    displayName: getComponentDisplayName(entry.component, entry.props)
+  }));
+}
+
 // Helper functions
 function getComponentDisplayName(component, props) {
   // Check if this is a Provider and if we can find its context name
@@ -75,8 +112,10 @@ function formatSourceLocation(source) {
  * This differs from debug.component.stack in that this uses a purpose-built
  * stack rather than walking the context chain. When this is called, the context
  * chain has been restored. In the future this can probably be unified nicely.
+ *
+ * @param error - Optional error to print the stack trace from
  */
-export function printRenderStack() {
+export function printRenderStack(error) {
   // Find the nearest SourceFileContext or SourceDirectoryContext from the render stack
   let currentPath;
   for (let i = renderStack.length - 1; i >= 0; i--) {
@@ -103,6 +142,27 @@ export function printRenderStack() {
     console.error(pc.red("Error rendering:"));
   }
 
+  // Print the error message and stack if provided
+  if (error) {
+    if (error instanceof Error) {
+      // eslint-disable-next-line no-console
+      console.error(pc.red(`  ${error.message}`));
+      if (error.stack) {
+        // Print stack lines (skip the first line which is the error message)
+        const stackLines = error.stack.split("\n").slice(1);
+        for (const line of stackLines) {
+          // eslint-disable-next-line no-console
+          console.error(pc.gray(line));
+        }
+      }
+    } else {
+      // eslint-disable-next-line no-console
+      console.error(pc.red(`  ${String(error)}`));
+    }
+    // eslint-disable-next-line no-console
+    console.error(); // Empty line before component stack
+  }
+
   // First pass: determine which providers should be nested vs standalone
   // A provider should be nested under its parent if it's from a different file
   // (i.e., it's part of the component's implementation, not user-provided)

package/dist/src/render-stack.js.map

@@ -1 +1 @@
-{"version":3,"names":["pc","contextsByKey","SourceDirectoryContext","SourceFileContext","getContext","renderStack","pushStack","component","props","source","push","context","popStack","pop","clearRenderStack","length","getComponentDisplayName","name","ctx","values","Provider","inspectProps","entries","Object","filter","key","map","value","formattedValue","formatValue","dim","join","blue","String","gray","formatSourceLocation","cwd","process","filePath","fileName","startsWith","slice","lineNumber","columnNumber","printRenderStack","currentPath","i","id","fileContext","path","dirContext","console","error","red","nestedProviderIndices","Set","j","providerEntry","shouldNest","add","has","displayName","sourceStr","cyan","bold","propsStr","providerName","providerSourceStr","magenta","providerPropsStr"],"sources":["../../src/render-stack.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["pc","contextsByKey","SourceDirectoryContext","SourceFileContext","getContext","renderStack","pushStack","component","props","source","push","context","popStack","pop","currentComponentName","entry","length","name","undefined","clearRenderStack","getCurrentRenderPath","currentPath","i","id","fileContext","path","dirContext","getRenderStackSnapshot","map","displayName","getComponentDisplayName","ctx","values","Provider","inspectProps","entries","Object","filter","key","value","formattedValue","formatValue","dim","join","blue","String","gray","formatSourceLocation","cwd","process","filePath","fileName","startsWith","slice","lineNumber","columnNumber","printRenderStack","error","console","red","Error","message","stack","stackLines","split","line","nestedProviderIndices","Set","j","providerEntry","shouldNest","add","has","sourceStr","cyan","bold","propsStr","providerName","providerSourceStr","magenta","providerPropsStr"],"sources":["../../src/render-stack.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/render.d.ts

@@ -1,4 +1,4 @@
-import { Doc } from "prettier";
+import { printHookTag, type PrintHook, type RenderedTextTree } from "./print-hook.js";
 import { Context } from "./reactivity.js";
 import { Children } from "./runtime/component.js";
 /**
@@ -98,16 +98,9 @@ export interface ContentOutputFile extends OutputFileBase {
 }
 export type OutputFile = ContentOutputFile | CopyOutputFile;
 export declare function getContextForRenderNode(node: RenderedTextTree): Context | undefined;
-export declare const printHookTag: unique symbol;
-export interface PrintHook {
-    [printHookTag]: true;
-    transform?(tree: RenderedTextTree): RenderedTextTree;
-    print?(tree: RenderedTextTree, print: (subtree: RenderedTextTree) => Doc): Doc;
-    subtree: RenderedTextTree;
-}
+export declare function getDiagnosticsForTree(tree: RenderedTextTree): import("./diagnostics.js").Diagnostic[];
+export { isPrintHook, printHookTag, type PrintHook, type RenderedTextTree, } from "./print-hook.js";
 export declare function createRenderTreeHook(subtree: RenderedTextTree, hooks: Omit<PrintHook, typeof printHookTag | "subtree">): PrintHook;
-export declare function isPrintHook(type: unknown): type is PrintHook;
-export type RenderedTextTree = (string | RenderedTextTree | PrintHook)[];
 /**
  * Render a component tree to source directories and files. Will ensure that
  * all non-async scheduled jobs are completed before returning. If async jobs
@@ -120,11 +113,6 @@ export declare function render(children: Children, options?: PrintTreeOptions):
  * scheduled jobs are completed before returning.
  */
 export declare function renderAsync(children: Children, options?: PrintTreeOptions): Promise<OutputDirectory>;
-/**
- * Convert a rendered text tree to source directories and files. Will ensure that
- * all scheduled jobs are completed, including async ones.
- */
-export declare function sourceFilesForTreeAsync(tree: RenderedTextTree, options?: PrintTreeOptions): Promise<OutputDirectory>;
 /**
  * Convert a rendered text tree to source directories and files. Will ensure
  * that all scheduled jobs are completed before returning.
@@ -151,6 +139,11 @@ export interface PrintTreeOptions {
      * @default true
      */
     insertFinalNewLine?: boolean;
+    /**
+     * Skip flushing scheduled jobs before printing.
+     * @default false
+     */
+    noFlush?: boolean;
 }
 /**
  * Convert a rendered text tree to a string. Will ensure that the scheduler is

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

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAO,MAAM,UAAU,CAAC;AAIpC,OAAO,EACL,OAAO,EAQR,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAEL,QAAQ,EAIT,MAAM,wBAAwB,CAAC;AA0BhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,eAAe,GAAG,UAAU,CAAC,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAI5D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,uBAE7D;AAED,eAAO,MAAM,YAAY,eAAW,CAAC;AAErC,MAAM,WAAW,SAAS;IACxB,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;IACrB,SAAS,CAAC,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;IACrD,KAAK,CAAC,CACJ,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,GAAG,GACxC,GAAG,CAAC;IACP,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,YAAY,GAAG,SAAS,CAAC,GACtD,SAAS,CAMX;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAE5D;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC,EAAE,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAIjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,gBAAgB,4BAO3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAyFjB;AACD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,oBAY5C;AA4BD,wBAAgB,kBAAkB,SAqDjC;AAqRD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAOD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,UAoB3E"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,OAAO,EAUR,MAAM,iBAAiB,CAAC;AAQzB,OAAO,EAEL,QAAQ,EAIT,MAAM,wBAAwB,CAAC;AA6GhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,CAAC,eAAe,GAAG,UAAU,CAAC,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAK5D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,uBAE7D;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,gBAAgB,2CAE3D;AAeD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,YAAY,GAAG,SAAS,CAAC,GACtD,SAAS,CAMX;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAWjB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAW1B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CA4FjB;AACD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,oBAsB5C;AA6BD,wBAAgB,kBAAkB,SA6DjC;AAwbD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,UAsB3E"}