@alloy-js/core 0.23.0-dev.0 → 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

@@ -0,0 +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(error?: unknown): void;
+//# sourceMappingURL=render-stack.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,251 @@
+import pc from "picocolors";
+import { contextsByKey } from "./context.js";
+import { SourceDirectoryContext } from "./context/source-directory.js";
+import { SourceFileContext } from "./context/source-file.js";
+import { getContext } from "./reactivity.js";
+// Store render stack for error diagnostics
+const renderStack = [];
+export function pushStack(component, props, source) {
+  renderStack.push({
+    component,
+    props,
+    context: getContext(),
+    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
+  if (component.name === "Provider") {
+    // Try to find the context this provider is associated with
+    for (const ctx of contextsByKey.values()) {
+      if (ctx.Provider === component && ctx.name) {
+        return ctx.name;
+      }
+    }
+  }
+  return component.name;
+}
+function inspectProps(props) {
+  const entries = Object.entries(props).filter(([key]) => key !== "children") // Exclude children prop
+  .map(([key, value]) => {
+    const formattedValue = formatValue(value);
+    return `${pc.dim(key)}: ${formattedValue}`;
+  });
+  return entries.length > 0 ? entries.join(pc.dim(", ")) : "";
+}
+function formatValue(value) {
+  switch (typeof value) {
+    case "string":
+      return pc.blue(`"${value}"`);
+    case "number":
+    case "boolean":
+      return pc.blue(String(value));
+    case "undefined":
+      return pc.gray("undefined");
+    case "object":
+      return value ? pc.gray("{...}") : pc.gray("null");
+    case "function":
+      return pc.gray("function");
+    default:
+      return pc.gray(String(value));
+  }
+}
+function formatSourceLocation(source) {
+  const cwd = process.cwd();
+  let filePath = source.fileName;
+
+  // Convert to relative path if under cwd
+  if (filePath.startsWith(cwd)) {
+    filePath = filePath.slice(cwd.length + 1); // +1 to remove leading slash
+  }
+  return `${filePath}:${source.lineNumber}:${source.columnNumber}`;
+}
+
+/**
+ * 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 function printRenderStack(error) {
+  // Find the nearest SourceFileContext or SourceDirectoryContext from the render stack
+  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];
+      currentPath = fileContext.path;
+      break;
+    }
+    if (!currentPath && context?.context?.[SourceDirectoryContext.id]) {
+      const dirContext = context.context[SourceDirectoryContext.id];
+      currentPath = dirContext.path;
+      // Don't break - keep looking for a SourceFileContext
+    }
+  }
+  if (currentPath) {
+    // eslint-disable-next-line no-console
+    console.error(pc.red(`Error rendering in file ${currentPath}`));
+  } else {
+    // eslint-disable-next-line no-console
+    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)
+  const nestedProviderIndices = new Set();
+  for (let i = renderStack.length - 1; i >= 0; i--) {
+    const {
+      component,
+      source
+    } = renderStack[i];
+
+    // Skip anonymous components and providers
+    if (!component.name || component.name === "Provider") {
+      continue;
+    }
+
+    // Look for providers that come immediately after this component
+    for (let j = i + 1; j < renderStack.length; j++) {
+      const providerEntry = renderStack[j];
+      if (!providerEntry.component.name) continue;
+      if (providerEntry.component.name !== "Provider") break;
+
+      // Nest provider if it's from a different file (component-internal)
+      const shouldNest = !source || !providerEntry.source || source.fileName !== providerEntry.source.fileName;
+      if (shouldNest) {
+        nestedProviderIndices.add(j);
+      } else {
+        // Stop looking - this provider and all after should be standalone
+        break;
+      }
+    }
+  }
+
+  // Second pass: print stack entries in order, nesting providers where appropriate
+  for (let i = renderStack.length - 1; i >= 0; i--) {
+    const {
+      component,
+      props,
+      source
+    } = renderStack[i];
+
+    // Skip anonymous components
+    if (!component.name) {
+      continue;
+    }
+
+    // Skip providers that will be nested under their parent
+    if (nestedProviderIndices.has(i)) {
+      continue;
+    }
+    const displayName = getComponentDisplayName(component, props);
+    const sourceStr = source ? pc.gray(` (${formatSourceLocation(source)})`) : "";
+
+    // eslint-disable-next-line no-console
+    console.error(`  ${pc.cyan("at")} ${pc.bold(displayName)}${sourceStr}`);
+
+    // Print props on next line if there are any
+    const propsStr = inspectProps(props);
+    if (propsStr) {
+      // eslint-disable-next-line no-console
+      console.error(`     ${propsStr}`);
+    }
+
+    // For non-Provider components, print any nested providers
+    if (component.name !== "Provider") {
+      for (let j = i + 1; j < renderStack.length; j++) {
+        if (!nestedProviderIndices.has(j)) break;
+        const providerEntry = renderStack[j];
+        if (!providerEntry.component.name) continue;
+        const providerName = getComponentDisplayName(providerEntry.component, providerEntry.props);
+        const providerSourceStr = providerEntry.source ? pc.gray(` (${formatSourceLocation(providerEntry.source)})`) : "";
+
+        // eslint-disable-next-line no-console
+        console.error(`     ${pc.magenta("provides")} ${pc.bold(providerName)}${providerSourceStr}`);
+        const providerPropsStr = inspectProps(providerEntry.props);
+        if (providerPropsStr) {
+          // eslint-disable-next-line no-console
+          console.error(`       ${providerPropsStr}`);
+        }
+      }
+    }
+  }
+
+  // Clear the stack after printing to avoid stale data on subsequent render errors
+  clearRenderStack();
+}
+//# sourceMappingURL=render-stack.js.map