@alloy-js/core 0.24.0-dev.2 → 0.24.0-dev.6

package/docs/api/components/Output.md

@@ -14,7 +14,6 @@ This component is the root component for all your emitted output. Place your var
     insertFinalNewLine
     nameConflictResolver={NameConflictResolver}
     namePolicy={NamePolicy<string>}
-    noFlush
     printWidth={number}
     tabWidth={number}
     useTabs
@@ -35,7 +34,6 @@ This component is the root component for all your emitted output. Place your var
     insertFinalNewLine: boolean,
     nameConflictResolver: NameConflictResolver,
     namePolicy: NamePolicy<string>,
-    noFlush: boolean,
     printWidth: number,
     tabWidth: number,
     useTabs: boolean,
@@ -52,7 +50,6 @@ This component is the root component for all your emitted output. Place your var
 | insertFinalNewLine   | optional boolean                                                   | If files should end with a final new line.                                     |
 | nameConflictResolver | optional [NameConflictResolver](../../types/nameconflictresolver/) | Policy for handling multiple symbols declared with the same name.              |
 | namePolicy           | optional [NamePolicy](../../types/namepolicy/)\<string>            | Name policy to use for this output.                                            |
-| noFlush              | optional boolean                                                   | Skip flushing scheduled jobs before printing.                                  |
 | printWidth           | optional number                                                    | The number of characters the printer will wrap on. Defaults to 100 characters. |
 | tabWidth             | optional number                                                    | The number of spaces to use for indentation. Defaults to 2 spaces.             |
 | useTabs              | optional boolean                                                   | Whether to use tabs instead of spaces for indentation. Defaults to false.      |

package/docs/api/components/SourceFile.md

@@ -10,7 +10,6 @@
     filetype="string"
     header={Children}
     insertFinalNewLine
-    noFlush
     path="string"
     printWidth={number}
     reference={ComponentDefinition<{
@@ -33,7 +32,6 @@
     filetype: string,
     header: Children,
     insertFinalNewLine: boolean,
-    noFlush: boolean,
     path: string,
     printWidth: number,
     reference: ComponentDefinition<{
@@ -52,7 +50,6 @@
 | filetype           | string                                                                                                       | The type of contents in this file. This is a metadata hint only. It does not trigger formatting or content processing. The value is forwarded to debug tooling and the [`ContentOutputFile`](../types/ContentOutputFile.md) output metadata.                                                                                      |
 | header             | optional [Children](../../types/children/)                                                                   | Content rendered before the file body, separated from it by a hard line break. The separator is emitted whenever `header` is not `undefined` — including when it is an empty string or a component that renders nothing. To suppress both the header and the separator, omit this prop entirely. |
 | insertFinalNewLine | optional boolean                                                                                             | If files should end with a final new line.                                                                                                                                                                                                                                                       |
-| noFlush            | optional boolean                                                                                             | Skip flushing scheduled jobs before printing.                                                                                                                                                                                                                                                    |
 | path               | string                                                                                                       | The path of this file relative to its parent directory                                                                                                                                                                                                                                           |
 | printWidth         | optional number                                                                                              | The number of characters the printer will wrap on. Defaults to 100 characters.                                                                                                                                                                                                                   |
 | reference          | optional [ComponentDefinition](../../types/componentdefinition/)<{ refkey: [Refkey](../../types/refkey/); }> | The component to use to render refkeys references within the file’s contents.                                                                                                                                                                                                                    |

package/docs/api/functions/createComment.md

@@ -0,0 +1,18 @@
+# createComment
+
+```ts
+import { createComment } from "@alloy-js/core";
+
+
+function createComment(data?: string): CommentNode;
+```
+
+## Parameters
+
+|      |                 |   |
+| ---- | --------------- | - |
+| data | optional string |   |
+
+## Returns
+
+[CommentNode](../../types/commentnode/)

package/docs/api/functions/createElement.md

@@ -0,0 +1,19 @@
+# createElement
+
+```ts
+import { createElement } from "@alloy-js/core";
+
+
+function createElement(localName: string, data?: unknown): ElementNode;
+```
+
+## Parameters
+
+|           |                  |   |
+| --------- | ---------------- | - |
+| localName | string           |   |
+| data      | optional unknown |   |
+
+## Returns
+
+[ElementNode](../../types/elementnode/)

package/docs/api/functions/createFragment.md

@@ -0,0 +1,17 @@
+# createFragment
+
+```ts
+import { createFragment } from "@alloy-js/core";
+
+
+function createFragment(): FragmentNode;
+```
+
+## Parameters
+
+|   |
+| - |
+
+## Returns
+
+[FragmentNode](../../types/fragmentnode/)

package/docs/api/functions/createTextNode.md

@@ -0,0 +1,18 @@
+# createTextNode
+
+```ts
+import { createTextNode } from "@alloy-js/core";
+
+
+function createTextNode(data: string): TextNode;
+```
+
+## Parameters
+
+|      |        |   |
+| ---- | ------ | - |
+| data | string |   |
+
+## Returns
+
+[TextNode](../../types/textnode/)

package/docs/api/functions/emitDiagnosticForTree.md

@@ -0,0 +1,19 @@
+# emitDiagnosticForTree
+
+```ts
+import { emitDiagnosticForTree } from "@alloy-js/core";
+
+
+function emitDiagnosticForTree(tree: object, input: DiagnosticInput): DiagnosticHandle;
+```
+
+## Parameters
+
+|       |                 |   |
+| ----- | --------------- | - |
+| tree  | object          |   |
+| input | DiagnosticInput |   |
+
+## Returns
+
+[DiagnosticHandle](../../types/diagnostichandle/)

package/docs/api/functions/ensureIsEmpty.md

@@ -1,6 +1,6 @@
 # ensureIsEmpty
 
-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.
+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`](../types/ContentSlot.md)). `mapJoin` does not call this — it uses an internal empty-change callback directly so most slots never allocate a Ref at all.
 
 ```ts
 import { ensureIsEmpty } from "@alloy-js/core";

package/docs/api/functions/getContextForNode.md

@@ -0,0 +1,18 @@
+# getContextForNode
+
+```ts
+import { getContextForNode } from "@alloy-js/core";
+
+
+function getContextForNode(node: AlloyNode): Context | undefined;
+```
+
+## Parameters
+
+|      |           |   |
+| ---- | --------- | - |
+| node | AlloyNode |   |
+
+## Returns
+
+[Context](../../types/context/) | undefined

package/docs/api/functions/getContextForRenderNode.md

@@ -4,14 +4,14 @@
 import { getContextForRenderNode } from "@alloy-js/core";
 
 
-function getContextForRenderNode(node: RenderedTextTree): Context | undefined;
+function getContextForRenderNode(node: AlloyNode): Context | undefined;
 ```
 
 ## Parameters
 
-|      |                  |   |
-| ---- | ---------------- | - |
-| node | RenderedTextTree |   |
+|      |           |   |
+| ---- | --------- | - |
+| node | AlloyNode |   |
 
 ## Returns
 

package/docs/api/functions/getDiagnosticsForTree.md

@@ -1,18 +1,20 @@
 # getDiagnosticsForTree
 
+Diagnostics collected during the render of `rootNode`.
+
 ```ts
 import { getDiagnosticsForTree } from "@alloy-js/core";
 
 
-function getDiagnosticsForTree(tree: RenderedTextTree): import("./diagnostics.js").Diagnostic[];
+function getDiagnosticsForTree(rootNode: AlloyNode): Diagnostic[];
 ```
 
 ## Parameters
 
-|      |                  |   |
-| ---- | ---------------- | - |
-| tree | RenderedTextTree |   |
+|          |           |   |
+| -------- | --------- | - |
+| rootNode | AlloyNode |   |
 
 ## Returns
 
-import(”./diagnostics.js”).[Diagnostic](../../types/diagnostic/)\[]
+[Diagnostic](../../types/diagnostic/)\[]

package/docs/api/functions/getRegisteredDiagnosticsForTree.md

@@ -0,0 +1,18 @@
+# getRegisteredDiagnosticsForTree
+
+```ts
+import { getRegisteredDiagnosticsForTree } from "@alloy-js/core";
+
+
+function getRegisteredDiagnosticsForTree(tree: object): Diagnostic[];
+```
+
+## Parameters
+
+|      |        |   |
+| ---- | ------ | - |
+| tree | object |   |
+
+## Returns
+
+[Diagnostic](../../types/diagnostic/)\[]

package/docs/api/functions/index.md

@@ -6,19 +6,20 @@
 - [childrenArray](childrenArray.md) — import { childrenArray } from "@alloy-js/core";
 - [code](code.md) — Turn the provided string template into Children by replacing literal line breaks with hardlines and automatically indenting indented content.
 - [computed](computed.md) — import { computed } from "@alloy-js/core";
+- [createComment](createComment.md) — import { createComment } from "@alloy-js/core";
 - [createComponent](createComponent.md) — import { createComponent } from "@alloy-js/core";
 - [createContentSlot](createContentSlot.md) — Create a component which tracks whether any content is placed inside of it.
 - [createContext](createContext.md) — import { createContext } from "@alloy-js/core";
 - [createCustomContext](createCustomContext.md) — import { createCustomContext } from "@alloy-js/core";
 - [createDeclarationTap](createDeclarationTap.md) — Create a tap for [Declaration context](../../contexts/declaration-context/).
+- [createElement](createElement.md) — import { createElement } from "@alloy-js/core";
 - [createFileResource](createFileResource.md) — Create a resource that reads a file from the file system.
 - [createFormatOptionsContextFor](createFormatOptionsContextFor.md) — Create a format options context for a specific file type.
-- [createIntrinsic](createIntrinsic.md) — import { createIntrinsic } from "@alloy-js/core";
+- [createFragment](createFragment.md) — import { createFragment } from "@alloy-js/core";
 - [createMemberTap](createMemberTap.md) — Create a tap for [MemberDeclaration context](../../contexts/memberdeclaration-context/).
 - [createNamedContext](createNamedContext.md) — import { createNamedContext } from "@alloy-js/core";
 - [createNamePolicy](createNamePolicy.md) — Creates a name policy that transforms symbol names based on element kind.
 - [createOutputBinder](createOutputBinder.md) — import { createOutputBinder } from "@alloy-js/core";
-- [createRenderTreeHook](createRenderTreeHook.md) — import { createRenderTreeHook } from "@alloy-js/core";
 - [createResource](createResource.md) — Create a resource that fetches data asynchronously.
 - [createScope](createScope.md) — Construct a scope instance and register it with devtools.
 - [createScopeTap](createScopeTap.md) — Create a tap for [OutputScope](../../types/outputscope/).
@@ -26,10 +27,12 @@
 - [createSymbol](createSymbol.md) — Construct a symbol instance and register it with devtools.
 - [createSymbolSlot](createSymbolSlot.md) — Create a component which accepts emitted symbols.
 - [createTap](createTap.md) — Create a component that when rendered, initializes the tapped value with the provided callback.
+- [createTextNode](createTextNode.md) — import { createTextNode } from "@alloy-js/core";
 - [decl](decl.md) — Create a declaration in the current scope with the given namekey.
 - [defaultProps](defaultProps.md) — Applies default values to a props object.
 - [effect](effect.md) — import { effect } from "@alloy-js/core";
 - [emitDiagnostic](emitDiagnostic.md) — import { emitDiagnostic } from "@alloy-js/core";
+- [emitDiagnosticForTree](emitDiagnosticForTree.md) — import { emitDiagnosticForTree } from "@alloy-js/core";
 - [emitSymbol](emitSymbol.md) — import { emitSymbol } from "@alloy-js/core";
 - [ensureIsEmpty](ensureIsEmpty.md) — Ensure that a context has an isEmpty ref, creating one if needed.
 - [findCurrentEffectId](findCurrentEffectId.md) — Walk up the context owner chain to find the nearest effect ID.
@@ -39,23 +42,22 @@
 - [formatReactivePropertyLabel](formatReactivePropertyLabel.md) — Build a human-readable label for a reactive property like `symbolName.prop`.
 - [getAssignmentSymbol](getAssignmentSymbol.md) — Get the symbol being defined.
 - [getContext](getContext.md) — import { getContext } from "@alloy-js/core";
+- [getContextForNode](getContextForNode.md) — import { getContextForNode } from "@alloy-js/core";
 - [getContextForRenderNode](getContextForRenderNode.md) — import { getContextForRenderNode } from "@alloy-js/core";
-- [getDiagnosticsForTree](getDiagnosticsForTree.md) — import { getDiagnosticsForTree } from "@alloy-js/core";
+- [getDiagnosticsForTree](getDiagnosticsForTree.md) — Diagnostics collected during the render of `rootNode`.
 - [getEffectDebugId](getEffectDebugId.md) — import { getEffectDebugId } from "@alloy-js/core";
-- [getElementCache](getElementCache.md) — import { getElementCache } from "@alloy-js/core";
 - [getReactiveCreationLocation](getReactiveCreationLocation.md) — import { getReactiveCreationLocation } from "@alloy-js/core";
+- [getRegisteredDiagnosticsForTree](getRegisteredDiagnosticsForTree.md) — import { getRegisteredDiagnosticsForTree } from "@alloy-js/core";
 - [getSymbolCreator](getSymbolCreator.md) — import { getSymbolCreator } from "@alloy-js/core";
 - [getSymbolCreatorSymbol](getSymbolCreatorSymbol.md) — import { getSymbolCreatorSymbol } from "@alloy-js/core";
 - [inspectRefkey](inspectRefkey.md) — import { inspectRefkey } from "@alloy-js/core";
 - [instantiateTakenMembersTo](instantiateTakenMembersTo.md) — import { instantiateTakenMembersTo } from "@alloy-js/core";
 - [isComponentCreator](isComponentCreator.md) — import { isComponentCreator } from "@alloy-js/core";
 - [isCustomContext](isCustomContext.md) — import { isCustomContext } from "@alloy-js/core";
-- [isIntrinsicElement](isIntrinsicElement.md) — import { isIntrinsicElement } from "@alloy-js/core";
 - [isKeyedChild](isKeyedChild.md) — import { isKeyedChild } from "@alloy-js/core";
 - [isLibrarySymbolReference](isLibrarySymbolReference.md) — import { isLibrarySymbolReference } from "@alloy-js/core";
 - [isMemberRefkey](isMemberRefkey.md) — import { isMemberRefkey } from "@alloy-js/core";
 - [isNamekey](isNamekey.md) — import { isNamekey } from "@alloy-js/core";
-- [isPrintHook](isPrintHook.md) — import { isPrintHook } from "@alloy-js/core";
 - [isRefkey](isRefkey.md) — import { isRefkey } from "@alloy-js/core";
 - [isRefkeyable](isRefkeyable.md) — import { isRefkeyable } from "@alloy-js/core";
 - [isRenderableObject](isRenderableObject.md) — Returns true if the item is a renderable object, meaning it has an `[ay.RENDERABLE]` method.
@@ -68,23 +70,26 @@
 - [moveTakenMembersTo](moveTakenMembersTo.md) — import { moveTakenMembersTo } from "@alloy-js/core";
 - [namekey](namekey.md) — Create a namekey with the given name.
 - [nextReactiveId](nextReactiveId.md) — Allocate a unique reactive target ID from the same counter space as ref IDs.
-- [notifyContentState](notifyContentState.md) — import { notifyContentState } from "@alloy-js/core";
+- [notifyContentState](notifyContentState.md) — Reconcile the current context’s last-empty flag and `isEmpty` ref with its current `childrenWithContent` count, propagat
 - [onCleanup](onCleanup.md) — Register a cleanup function which is called when the current reactive scope is recalculated or disposed.
-- [printTree](printTree.md) — Convert a rendered text tree to a string.
+- [printTree](printTree.md) — Print an AlloyNode tree to a string.
 - [reactivePropertyRefId](reactivePropertyRefId.md) — Get a stable ref ID for a property of a reactive object.
 - [ref](ref.md) — import { ref } from "@alloy-js/core";
 - [refId](refId.md) — import { refId } from "@alloy-js/core";
 - [refkey](refkey.md) — Create a refkey for the provided arguments.
-- [render](render.md) — Render a component tree to source directories and files.
-- [renderAsync](renderAsync.md) — Render a component tree to source directories and files.
-- [renderTree](renderTree.md) — import { renderTree } from "@alloy-js/core";
+- [registerDiagnosticsForTree](registerDiagnosticsForTree.md) — import { registerDiagnosticsForTree } from "@alloy-js/core";
+- [render](render.md) — Render a component tree to an [OutputDirectory](../../types/outputdirectory/).
+- [renderAsync](renderAsync.md) — Async variant — awaits any scheduled async jobs (e.g.
+- [renderTree](renderTree.md) — Render `children` into a fresh root AlloyNode.
 - [reportDiagnostics](reportDiagnostics.md) — import { reportDiagnostics } from "@alloy-js/core";
+- [reportDiagnosticsForTree](reportDiagnosticsForTree.md) — import { reportDiagnosticsForTree } from "@alloy-js/core";
 - [resetRefIdCounter](resetRefIdCounter.md) — import { resetRefIdCounter } from "@alloy-js/core";
 - [resolve](resolve.md) — Resolve a refkey in the current scope.
 - [root](root.md) — import { root } from "@alloy-js/core";
+- [runInContext](runInContext.md) — Run `fn` in a fresh child Context (just like [effect](../effect/)) but **without** a tracking ReactiveEffect wrapper.
 - [shallowReactive](shallowReactive.md) — import { shallowReactive } from "@alloy-js/core";
 - [shallowRef](shallowRef.md) — import { shallowRef } from "@alloy-js/core";
-- [sourceFilesForTree](sourceFilesForTree.md) — Convert a rendered text tree to source directories and files.
+- [sourceFilesForTree](sourceFilesForTree.md) — Walk the AlloyNode tree, collecting `<SourceDirectory>`, `<SourceFile>`, and `<CopyFile>` markers into an [OutputDirecto
 - [splitProps](splitProps.md) — import { splitProps } from "@alloy-js/core";
 - [stc](stc.md) — import { stc } from "@alloy-js/core";
 - [sti](sti.md) — import { sti } from "@alloy-js/core";

package/docs/api/functions/isCustomContext.md

@@ -4,14 +4,14 @@
 import { isCustomContext } from "@alloy-js/core";
 
 
-function isCustomContext(child: Children): child is CustomContext;
+function isCustomContext(child: unknown): child is CustomContext;
 ```
 
 ## Parameters
 
-|       |          |   |
-| ----- | -------- | - |
-| child | Children |   |
+|       |         |   |
+| ----- | ------- | - |
+| child | unknown |   |
 
 ## Returns
 

package/docs/api/functions/notifyContentState.md

@@ -1,5 +1,11 @@
 # notifyContentState
 
+Reconcile the current context’s last-empty flag and `isEmpty` ref with its current `childrenWithContent` count, propagating changes up the owner chain.
+
+Call after mutating `childrenWithContent`. Safe to call when there is no active context — it just no-ops.
+
+On every transition, both write the (lazily-allocated) `isEmpty` Ref (if present) AND invoke the internal empty-change callback (if present). Order is ref-first so external observers see the new Ref value before any internal mapJoin bookkeeping mutates dependent Refs.
+
 ```ts
 import { notifyContentState } from "@alloy-js/core";
 

package/docs/api/functions/printTree.md

@@ -1,30 +1,20 @@
 # printTree
 
-Convert a rendered text tree to a string. Will ensure that the scheduler is empty before printing.
+Print an AlloyNode tree to a string.
 
 ```ts
 import { printTree } from "@alloy-js/core";
 
 
-function printTree(tree: RenderedTextTree, options?: PrintTreeOptions): string;
+function printTree(node: AlloyNode, opts?: PrintTreeOptions & RenderTreeOptions): string;
 ```
 
 ## Parameters
 
-|         |                           |   |
-| ------- | ------------------------- | - |
-| tree    | RenderedTextTree          |   |
-| options | optional PrintTreeOptions |   |
-
-## Options
-
-|                    |                  |                                                                                |
-| ------------------ | ---------------- | ------------------------------------------------------------------------------ |
-| insertFinalNewLine | optional boolean | If files should end with a final new line.                                     |
-| noFlush            | optional boolean | Skip flushing scheduled jobs before printing.                                  |
-| printWidth         | optional number  | The number of characters the printer will wrap on. Defaults to 100 characters. |
-| tabWidth           | optional number  | The number of spaces to use for indentation. Defaults to 2 spaces.             |
-| useTabs            | optional boolean | Whether to use tabs instead of spaces for indentation. Defaults to false.      |
+|      |                                               |   |
+| ---- | --------------------------------------------- | - |
+| node | AlloyNode                                     |   |
+| opts | optional PrintTreeOptions & RenderTreeOptions |   |
 
 ## Returns
 

package/docs/api/functions/registerDiagnosticsForTree.md

@@ -0,0 +1,19 @@
+# registerDiagnosticsForTree
+
+```ts
+import { registerDiagnosticsForTree } from "@alloy-js/core";
+
+
+function registerDiagnosticsForTree(tree: object, collector: DiagnosticsCollector): void;
+```
+
+## Parameters
+
+|           |                      |   |
+| --------- | -------------------- | - |
+| tree      | object               |   |
+| collector | DiagnosticsCollector |   |
+
+## Returns
+
+void

package/docs/api/functions/render.md

@@ -1,6 +1,6 @@
 # render
 
-Render a component tree to source directories and files. Will ensure that all non-async scheduled jobs are completed before returning. If async jobs are found, an error will be thrown. Use `renderAsync` when asynchronous jobs are expected.
+Render a component tree to an [OutputDirectory](../../types/outputdirectory/).
 
 ```ts
 import { render } from "@alloy-js/core";
@@ -21,7 +21,6 @@ function render(children: Children, options?: PrintTreeOptions): OutputDirectory
 |                    |                  |                                                                                |
 | ------------------ | ---------------- | ------------------------------------------------------------------------------ |
 | insertFinalNewLine | optional boolean | If files should end with a final new line.                                     |
-| noFlush            | optional boolean | Skip flushing scheduled jobs before printing.                                  |
 | printWidth         | optional number  | The number of characters the printer will wrap on. Defaults to 100 characters. |
 | tabWidth           | optional number  | The number of spaces to use for indentation. Defaults to 2 spaces.             |
 | useTabs            | optional boolean | Whether to use tabs instead of spaces for indentation. Defaults to false.      |

package/docs/api/functions/renderAsync.md

@@ -1,6 +1,6 @@
 # renderAsync
 
-Render a component tree to source directories and files. Will ensure that all scheduled jobs are completed before returning.
+Async variant — awaits any scheduled async jobs (e.g. produced by `<Output>` consumers that read external data) before walking the tree.
 
 ```ts
 import { renderAsync } from "@alloy-js/core";
@@ -21,7 +21,6 @@ function renderAsync(children: Children, options?: PrintTreeOptions): Promise<Ou
 |                    |                  |                                                                                |
 | ------------------ | ---------------- | ------------------------------------------------------------------------------ |
 | insertFinalNewLine | optional boolean | If files should end with a final new line.                                     |
-| noFlush            | optional boolean | Skip flushing scheduled jobs before printing.                                  |
 | printWidth         | optional number  | The number of characters the printer will wrap on. Defaults to 100 characters. |
 | tabWidth           | optional number  | The number of spaces to use for indentation. Defaults to 2 spaces.             |
 | useTabs            | optional boolean | Whether to use tabs instead of spaces for indentation. Defaults to false.      |

package/docs/api/functions/renderTree.md

@@ -1,18 +1,21 @@
 # renderTree
 
+Render `children` into a fresh root AlloyNode.
+
 ```ts
 import { renderTree } from "@alloy-js/core";
 
 
-function renderTree(children: Children): RenderedTextTree;
+function renderTree(children: Children, opts?: RenderTreeOptions): ElementNode;
 ```
 
 ## Parameters
 
-|          |          |   |
-| -------- | -------- | - |
-| children | Children |   |
+|          |                            |   |
+| -------- | -------------------------- | - |
+| children | Children                   |   |
+| opts     | optional RenderTreeOptions |   |
 
 ## Returns
 
-[RenderedTextTree](../../types/renderedtexttree/)
+[ElementNode](../../types/elementnode/)

package/docs/api/functions/reportDiagnosticsForTree.md

@@ -0,0 +1,18 @@
+# reportDiagnosticsForTree
+
+```ts
+import { reportDiagnosticsForTree } from "@alloy-js/core";
+
+
+function reportDiagnosticsForTree(tree: object): void;
+```
+
+## Parameters
+
+|      |        |   |
+| ---- | ------ | - |
+| tree | object |   |
+
+## Returns
+
+void

package/docs/api/functions/runInContext.md

@@ -0,0 +1,28 @@
+# runInContext
+
+Run `fn` in a fresh child Context (just like [effect](../effect/)) but **without** a tracking ReactiveEffect wrapper. Use this when the caller knows the body does not establish reactive subscriptions at its top level (e.g. it wraps its only reactive reads in `untrack()` or function children) — typically for component-invocation plumbing where the outer “effect” never re-fires.
+
+Compared to [effect](../effect/):
+
+* No `vueEffect` allocation, no scheduler binding.
+* The body runs synchronously to completion exactly once.
+* Disposables registered via `onCleanup` inside `fn` (or its descendants) are still registered on the new context, and disposed via the parent context’s cleanup chain.
+
+Returns the value returned by `fn`.
+
+```ts
+import { runInContext } from "@alloy-js/core";
+
+
+function runInContext<T>(fn: () => T): T;
+```
+
+## Parameters
+
+|    |         |   |
+| -- | ------- | - |
+| fn | () => T |   |
+
+## Returns
+
+T

package/docs/api/functions/sourceFilesForTree.md

@@ -1,30 +1,20 @@
 # sourceFilesForTree
 
-Convert a rendered text tree to source directories and files. Will ensure that all scheduled jobs are completed before returning.
+Walk the AlloyNode tree, collecting `<SourceDirectory>`, `<SourceFile>`, and `<CopyFile>` markers into an [OutputDirectory](../../types/outputdirectory/).
 
 ```ts
 import { sourceFilesForTree } from "@alloy-js/core";
 
 
-function sourceFilesForTree(tree: RenderedTextTree, options?: PrintTreeOptions): OutputDirectory;
+function sourceFilesForTree(rootNode: AlloyNode, opts?: PrintTreeOptions): OutputDirectory;
 ```
 
 ## Parameters
 
-|         |                           |   |
-| ------- | ------------------------- | - |
-| tree    | RenderedTextTree          |   |
-| options | optional PrintTreeOptions |   |
-
-## Options
-
-|                    |                  |                                                                                |
-| ------------------ | ---------------- | ------------------------------------------------------------------------------ |
-| insertFinalNewLine | optional boolean | If files should end with a final new line.                                     |
-| noFlush            | optional boolean | Skip flushing scheduled jobs before printing.                                  |
-| printWidth         | optional number  | The number of characters the printer will wrap on. Defaults to 100 characters. |
-| tabWidth           | optional number  | The number of spaces to use for indentation. Defaults to 2 spaces.             |
-| useTabs            | optional boolean | Whether to use tabs instead of spaces for indentation. Defaults to false.      |
+|          |                           |   |
+| -------- | ------------------------- | - |
+| rootNode | AlloyNode                 |   |
+| opts     | optional PrintTreeOptions |   |
 
 ## Returns
 

package/docs/api/index.md

@@ -2,8 +2,8 @@
 
 - [components](components/index.md) (25 items)
 - [contexts](contexts/index.md) (9 items)
-- [functions](functions/index.md) (103 items)
+- [functions](functions/index.md) (108 items)
 - [testing/functions](testing/functions/index.md) (4 items)
 - [testing/types](testing/types/index.md) (2 items)
-- [types](types/index.md) (120 items)
-- [variables](variables/index.md) (9 items)
+- [types](types/index.md) (102 items)
+- [variables](variables/index.md) (11 items)

package/docs/api/testing/functions/index.md

@@ -3,4 +3,4 @@
 - [createTestWrapper](createTestWrapper.md) — Create a reusable test harness for a language package.
 - [d](d.md) — Dedented template literal tag.
 - [dedent](dedent.md) — import { dedent } from "@alloy-js/core/testing";
-- [renderToString](renderToString.md) — Render a JSX element tree to a string.
+- [renderToString](renderToString.md) — Convenience wrapper combining `renderTree` and `printTree`.

package/docs/api/testing/functions/renderToString.md

@@ -1,6 +1,6 @@
 # renderToString
 
-Render a JSX element tree to a string. Convenience wrapper combining `renderTree` and `printTree`.
+Convenience wrapper combining `renderTree` and `printTree`.
 
 ```ts
 import { renderToString } from "@alloy-js/core/testing";