@alloy-js/core 0.19.0-dev.0 → 0.19.0-dev.12

package/dist/src/components/UpdateFile.js

@@ -0,0 +1,66 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { computed } from "@vue/reactivity";
+import { join } from "pathe";
+import { useContext } from "../context.js";
+import { SourceDirectoryContext } from "../context/source-directory.js";
+import { createFileResource } from "../resource.js";
+import { SourceFile } from "./SourceFile.js";
+/**
+ * Props for the UpdateFile component.
+ */
+
+/**
+ * A component for updating existing files or initializing new files.
+ *
+ * This component allows you to read the current contents of a file and generate
+ * new content based on those contents. If the file doesn't exist, it can use
+ * default content from either a file path or inline content.
+ *
+ * @example
+ * ```tsx
+ * <UpdateFile path="config.json" defaultContent="{}">
+ *   {(currentContents) => {
+ *     const config = currentContents ? JSON.parse(currentContents) : {};
+ *     config.newProperty = "value";
+ *     return JSON.stringify(config, null, 2);
+ *   }}
+ * </UpdateFile>
+ * ```
+ */
+export function UpdateFile(props) {
+  const parentDirectory = useContext(SourceDirectoryContext);
+  const fullPath = join(parentDirectory ? parentDirectory.path : "", props.path);
+  const fileResource = createFileResource(fullPath);
+  const newContent = computed(() => {
+    if (fileResource.loading) {
+      return;
+    }
+    if (fileResource.error) {
+      if (fileResource.error.code === "ENOENT") {
+        if ("defaultContentPath" in props) {
+          const defaultContentResource = createFileResource(props.defaultContentPath);
+          return computed(() => {
+            if (defaultContentResource.loading) {
+              return;
+            }
+            if (defaultContentResource.error) {
+              throw defaultContentResource.error;
+            }
+            return props.children(defaultContentResource.data);
+          });
+        } else {
+          return props.children(null);
+        }
+      }
+      throw fileResource.error;
+    }
+    return props.children(fileResource.data);
+  });
+  return _$createComponent(SourceFile, {
+    get path() {
+      return props.path;
+    },
+    filetype: "text/plain",
+    children: newContent
+  });
+}

package/dist/src/components/index.d.ts

@@ -1,4 +1,6 @@
+export * from "./AppendFile.jsx";
 export * from "./Block.js";
+export * from "./CopyFile.jsx";
 export * from "./Declaration.js";
 export * from "./For.js";
 export * from "./Indent.jsx";
@@ -16,5 +18,7 @@ export * from "./SourceDirectory.js";
 export * from "./SourceFile.js";
 export * from "./StatementList.jsx";
 export * from "./Switch.jsx";
+export * from "./TemplateFile.jsx";
+export * from "./UpdateFile.jsx";
 export * from "./Wrap.jsx";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.tsx"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/index.tsx"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/src/components/index.js

@@ -1,4 +1,6 @@
+export * from "./AppendFile.js";
 export * from "./Block.js";
+export * from "./CopyFile.js";
 export * from "./Declaration.js";
 export * from "./For.js";
 export * from "./Indent.js";
@@ -16,4 +18,6 @@ export * from "./SourceDirectory.js";
 export * from "./SourceFile.js";
 export * from "./StatementList.js";
 export * from "./Switch.js";
+export * from "./TemplateFile.js";
+export * from "./UpdateFile.js";
 export * from "./Wrap.js";

package/dist/src/components/stc/index.d.ts

@@ -1,5 +1,7 @@
 import * as base from "../index.js";
+export declare const AppendFile: import("../../stc.js").StcSignature<base.AppendFileProps>;
 export declare const Block: import("../../stc.js").StcSignature<base.BlockProps>;
+export declare const CopyFile: import("../../stc.js").StcSignature<base.CopyFileProps>;
 export declare const Declaration: import("../../stc.js").StcSignature<base.DeclarationProps>;
 export declare const For: <T extends base.ForSupportedCollections | (() => base.ForSupportedCollections) | import("@vue/reactivity").Ref<base.ForSupportedCollections>, U extends import("@alloy-js/core/jsx-runtime").Children>(props: Omit<base.ForProps<T, U>, "children"> & Partial<Pick<base.ForProps<T, U>, "children">>) => import("../../stc.js").StcComponentCreator<base.ForProps<T, U>>;
 export declare const Indent: import("../../stc.js").StcSignature<base.IndentProps>;
@@ -16,6 +18,8 @@ export declare const StatementList: import("../../stc.js").StcSignature<base.Sta
 export declare const SourceDirectory: import("../../stc.js").StcSignature<base.SourceDirectoryProps>;
 export declare const SourceFile: import("../../stc.js").StcSignature<base.SourceFileProps>;
 export declare const Switch: import("../../stc.js").StcSignature<base.SwitchProps>;
+export declare const TemplateFile: import("../../stc.js").StcSignature<base.TemplateFileProps>;
+export declare const UpdateFile: import("../../stc.js").StcSignature<base.UpdateFileProps>;
 export declare const Wrap: <TProps>(props: Omit<base.WrapProps<TProps>, "children"> & Partial<Pick<base.WrapProps<TProps>, "children">>) => import("../../stc.js").StcComponentCreator<base.WrapProps<TProps>>;
 export declare const ReferenceOrContent: import("../../stc.js").StcSignature<base.ReferenceOrContentProps>;
 export * from "./sti.js";

package/dist/src/components/stc/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/stc/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,eAAO,MAAM,KAAK,sDAAkB,CAAC;AACrC,eAAO,MAAM,WAAW,4DAAwB,CAAC;AACjD,eAAO,MAAM,GAAG,0WAAgB,CAAC;AACjC,eAAO,MAAM,MAAM,uDAAmB,CAAC;AACvC,eAAO,MAAM,IAAI,qDAAiB,CAAC;AACnC,eAAO,MAAM,iBAAiB,kEAA8B,CAAC;AAC7D,eAAO,MAAM,UAAU,yCAAuB,CAAC;AAC/C,eAAO,MAAM,WAAW,4DAAwB,CAAC;AACjD,eAAO,MAAM,IAAI,yCAAiB,CAAC;AACnC,eAAO,MAAM,MAAM,uDAAmB,CAAC;AACvC,eAAO,MAAM,KAAK,iDAAkB,CAAC;AACrC,eAAO,MAAM,KAAK,sDAAkB,CAAC;AACrC,eAAO,MAAM,IAAI,qDAAiB,CAAC;AACnC,eAAO,MAAM,aAAa,8DAA0B,CAAC;AACrD,eAAO,MAAM,eAAe,gEAA4B,CAAC;AACzD,eAAO,MAAM,UAAU,2DAAuB,CAAC;AAC/C,eAAO,MAAM,MAAM,uDAAmB,CAAC;AACvC,eAAO,MAAM,IAAI,qLAAiB,CAAC;AACnC,eAAO,MAAM,kBAAkB,mEAA+B,CAAC;AAE/D,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/stc/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,eAAO,MAAM,UAAU,2DAAuB,CAAC;AAC/C,eAAO,MAAM,KAAK,sDAAkB,CAAC;AACrC,eAAO,MAAM,QAAQ,yDAAqB,CAAC;AAC3C,eAAO,MAAM,WAAW,4DAAwB,CAAC;AACjD,eAAO,MAAM,GAAG,0WAAgB,CAAC;AACjC,eAAO,MAAM,MAAM,uDAAmB,CAAC;AACvC,eAAO,MAAM,IAAI,qDAAiB,CAAC;AACnC,eAAO,MAAM,iBAAiB,kEAA8B,CAAC;AAC7D,eAAO,MAAM,UAAU,yCAAuB,CAAC;AAC/C,eAAO,MAAM,WAAW,4DAAwB,CAAC;AACjD,eAAO,MAAM,IAAI,yCAAiB,CAAC;AACnC,eAAO,MAAM,MAAM,uDAAmB,CAAC;AACvC,eAAO,MAAM,KAAK,iDAAkB,CAAC;AACrC,eAAO,MAAM,KAAK,sDAAkB,CAAC;AACrC,eAAO,MAAM,IAAI,qDAAiB,CAAC;AACnC,eAAO,MAAM,aAAa,8DAA0B,CAAC;AACrD,eAAO,MAAM,eAAe,gEAA4B,CAAC;AACzD,eAAO,MAAM,UAAU,2DAAuB,CAAC;AAC/C,eAAO,MAAM,MAAM,uDAAmB,CAAC;AACvC,eAAO,MAAM,YAAY,6DAAyB,CAAC;AACnD,eAAO,MAAM,UAAU,2DAAuB,CAAC;AAC/C,eAAO,MAAM,IAAI,qLAAiB,CAAC;AACnC,eAAO,MAAM,kBAAkB,mEAA+B,CAAC;AAE/D,cAAc,UAAU,CAAC"}

package/dist/src/components/stc/index.js

@@ -1,6 +1,8 @@
 import { stc } from "../../stc.js";
 import * as base from "../index.js";
+export const AppendFile = stc(base.AppendFile);
 export const Block = stc(base.Block);
+export const CopyFile = stc(base.CopyFile);
 export const Declaration = stc(base.Declaration);
 export const For = stc(base.For);
 export const Indent = stc(base.Indent);
@@ -17,6 +19,8 @@ export const StatementList = stc(base.StatementList);
 export const SourceDirectory = stc(base.SourceDirectory);
 export const SourceFile = stc(base.SourceFile);
 export const Switch = stc(base.Switch);
+export const TemplateFile = stc(base.TemplateFile);
+export const UpdateFile = stc(base.UpdateFile);
 export const Wrap = stc(base.Wrap);
 export const ReferenceOrContent = stc(base.ReferenceOrContent);
 export * from "./sti.js";

package/dist/src/context/source-directory.d.ts

@@ -1,8 +1,8 @@
 import { ComponentContext } from "../context.js";
-import type { SourceFileContext } from "./source-file.js";
+import type { CopyFileContext, SourceFileContext } from "./source-file.js";
 export interface SourceDirectoryContext {
-    contents: (SourceDirectoryContext | SourceFileContext)[];
-    addContent(content: SourceDirectoryContext | SourceFileContext): void;
+    contents: (SourceDirectoryContext | SourceFileContext | CopyFileContext)[];
+    addContent(content: SourceDirectoryContext | SourceFileContext | CopyFileContext): void;
     path: string;
 }
 export declare const SourceDirectoryContext: ComponentContext<SourceDirectoryContext>;

package/dist/src/context/source-directory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-directory.d.ts","sourceRoot":"","sources":["../../../src/context/source-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,sBAAsB,GAAG,iBAAiB,CAAC,EAAE,CAAC;IACzD,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,GAAG,IAAI,CAAC;IACtE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,sBAAsB,CACrC,CAAC"}
+{"version":3,"file":"source-directory.d.ts","sourceRoot":"","sources":["../../../src/context/source-directory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,sBAAsB,GAAG,iBAAiB,GAAG,eAAe,CAAC,EAAE,CAAC;IAC3E,UAAU,CACR,OAAO,EAAE,sBAAsB,GAAG,iBAAiB,GAAG,eAAe,GACpE,IAAI,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,sBAAsB,CACrC,CAAC"}

package/dist/src/context/source-file.d.ts

@@ -1,6 +1,10 @@
 import { ComponentContext } from "../context.js";
 import type { Refkey } from "../refkey.js";
 import { ComponentDefinition } from "../runtime/component.js";
+export interface CopyFileContext {
+    path: string;
+    sourcePath: string;
+}
 export interface SourceFileContext {
     path: string;
     filetype: string;

package/dist/src/context/source-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-file.d.ts","sourceRoot":"","sources":["../../../src/context/source-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,mBAAmB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,CAAC,iBAAiB,CAChC,CAAC"}
+{"version":3,"file":"source-file.d.ts","sourceRoot":"","sources":["../../../src/context/source-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,eAAe,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,mBAAmB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,CAAC,iBAAiB,CAChC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/debug.ts"],"names":[],"mappings":"AAOA,UAAU,cAAc;IACtB,SAAS,EAAE;QACT,KAAK,IAAI,IAAI,CAAC;QACd,IAAI,IAAI,IAAI,CAAC;QACb,KAAK,IAAI,IAAI,CAAC;QACd,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,IAAI,IAAI,CAAC;KACjB,CAAC;CACH;AAoGD,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,KAAK,EAAE,cAAc,CAAC;CAC3B;AA4FD,wBAAgB,WAAW,YAE1B"}
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/debug.ts"],"names":[],"mappings":"AAMA,UAAU,cAAc;IACtB,SAAS,EAAE;QACT,KAAK,IAAI,IAAI,CAAC;QACd,IAAI,IAAI,IAAI,CAAC;QACb,KAAK,IAAI,IAAI,CAAC;QACd,MAAM,IAAI,IAAI,CAAC;QACf,OAAO,IAAI,IAAI,CAAC;KACjB,CAAC;CACH;AAwGD,OAAO,CAAC,MAAM,CAAC;IAEb,IAAI,KAAK,EAAE,cAAc,CAAC;CAC3B;AA4FD,wBAAgB,WAAW,YAE1B"}

package/dist/src/debug.js

@@ -1,4 +1,3 @@
-/* eslint-disable no-console */
 import { isReactive } from "@vue/reactivity";
 import Table from "cli-table3";
 import pc from "picocolors";
@@ -8,12 +7,15 @@ const debug = {
   component: {
     stack: debugStack,
     tree() {
+      //eslint-disable-next-line no-console
       console.log("tree");
     },
     watch() {
+      //eslint-disable-next-line no-console
       console.log("watch");
     },
     render() {
+      //eslint-disable-next-line no-console
       console.log("render");
     },
     context: debugContext
@@ -47,6 +49,7 @@ function debugStack() {
 function debugContext() {
   let currentContext = getContext();
   while (currentContext !== null) {
+    //eslint-disable-next-line no-console
     console.log(printContext(currentContext));
     currentContext = currentContext.owner;
   }

package/dist/src/host/alloy-host.browser.d.ts

@@ -0,0 +1,11 @@
+import { AlloyFileInterface, AlloyHostInterface } from "./interface.js";
+export declare const AlloyHost: AlloyHostInterface;
+export declare class AlloyFile implements AlloyFileInterface {
+    private source;
+    constructor(source: string);
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    bytes(): Promise<Uint8Array>;
+    stream(): ReadableStream<Uint8Array>;
+}
+//# sourceMappingURL=alloy-host.browser.d.ts.map

package/dist/src/host/alloy-host.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alloy-host.browser.d.ts","sourceRoot":"","sources":["../../../src/host/alloy-host.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAExE,eAAO,MAAM,SAAS,EAAE,kBAyBvB,CAAC;AAEF,qBAAa,SAAU,YAAW,kBAAkB;IACtC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE5B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAMvB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAMnC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAMlC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;CAKrC"}

package/dist/src/host/alloy-host.browser.js

@@ -0,0 +1,31 @@
+export const AlloyHost = {
+  read(source) {
+    return new AlloyFile(source);
+  },
+  async write(destination, content) {
+    throw new Error("File system write operations are not supported in the browser");
+  },
+  async exists(source) {
+    throw new Error("File system exists operations are not supported in the browser");
+  },
+  async mkdir(path) {
+    throw new Error("File system mkdir operations are not supported in the browser");
+  }
+};
+export class AlloyFile {
+  constructor(source) {
+    this.source = source;
+  }
+  async text() {
+    throw new Error("File system read operations are not supported in the browser");
+  }
+  async arrayBuffer() {
+    throw new Error("File system read operations are not supported in the browser");
+  }
+  async bytes() {
+    throw new Error("File system read operations are not supported in the browser");
+  }
+  stream() {
+    throw new Error("File system read operations are not supported in the browser");
+  }
+}

package/dist/src/host/alloy-host.d.ts

@@ -0,0 +1,11 @@
+import { AlloyFileInterface, AlloyHostInterface } from "./interface.js";
+export declare const AlloyHost: AlloyHostInterface;
+export declare class AlloyFile implements AlloyFileInterface {
+    private source;
+    constructor(source: string);
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    bytes(): Promise<Uint8Array>;
+    stream(): ReadableStream<Uint8Array>;
+}
+//# sourceMappingURL=alloy-host.d.ts.map

package/dist/src/host/alloy-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alloy-host.d.ts","sourceRoot":"","sources":["../../../src/host/alloy-host.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAExE,eAAO,MAAM,SAAS,EAAE,kBAsFvB,CAAC;AAEF,qBAAa,SAAU,YAAW,kBAAkB;IACtC,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,MAAM;IAE5B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAUvB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;IAcnC,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC;IAWlC,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC;CA6BrC"}

package/dist/src/host/alloy-host.js

@@ -0,0 +1,143 @@
+import { createReadStream, createWriteStream } from "fs";
+import { access, mkdir, readFile, writeFile } from "fs/promises";
+export const AlloyHost = {
+  read(source) {
+    return new AlloyFile(source);
+  },
+  async write(destination, content) {
+    if (typeof content === "string") {
+      //eslint-disable-next-line no-useless-catch
+      try {
+        await writeFile(destination, content, "utf8");
+      } catch (e) {
+        // get good callstacks
+        throw e;
+      }
+    } else if (content instanceof ArrayBuffer) {
+      //eslint-disable-next-line no-useless-catch
+      try {
+        await writeFile(destination, new Uint8Array(content));
+      } catch (e) {
+        // get good callstacks
+        throw e;
+      }
+    } else if (content instanceof Uint8Array) {
+      //eslint-disable-next-line no-useless-catch
+      try {
+        await writeFile(destination, content);
+      } catch (e) {
+        // get good callstacks
+        throw e;
+      }
+    } else {
+      // content is ReadableStream<Uint8Array>
+      //eslint-disable-next-line no-useless-catch
+      try {
+        const writeStream = createWriteStream(destination);
+        const reader = content.getReader();
+        try {
+          while (true) {
+            const {
+              done,
+              value
+            } = await reader.read();
+            if (done) break;
+            await new Promise((resolve, reject) => {
+              writeStream.write(value, err => {
+                if (err) reject(err);else resolve();
+              });
+            });
+          }
+        } finally {
+          reader.releaseLock();
+          await new Promise((resolve, reject) => {
+            writeStream.end(err => {
+              if (err) reject(err);else resolve();
+            });
+          });
+        }
+      } catch (e) {
+        // get good callstacks
+        throw e;
+      }
+    }
+  },
+  async exists(source) {
+    try {
+      await access(source);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  async mkdir(path) {
+    //eslint-disable-next-line no-useless-catch
+    try {
+      await mkdir(path, {
+        recursive: true
+      });
+    } catch (e) {
+      // get good callstacks
+      throw e;
+    }
+  }
+};
+export class AlloyFile {
+  constructor(source) {
+    this.source = source;
+  }
+  async text() {
+    //eslint-disable-next-line no-useless-catch
+    try {
+      return await readFile(this.source, "utf8");
+    } catch (e) {
+      // get good callstacks
+      throw e;
+    }
+  }
+  async arrayBuffer() {
+    //eslint-disable-next-line no-useless-catch
+    try {
+      const buffer = await readFile(this.source);
+      return buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength);
+    } catch (e) {
+      // get good callstacks
+      throw e;
+    }
+  }
+  async bytes() {
+    //eslint-disable-next-line no-useless-catch
+    try {
+      const buffer = await readFile(this.source);
+      return new Uint8Array(buffer);
+    } catch (e) {
+      // get good callstacks
+      throw e;
+    }
+  }
+  stream() {
+    //eslint-disable-next-line no-useless-catch
+    try {
+      const nodeStream = createReadStream(this.source);
+      return new ReadableStream({
+        start(controller) {
+          nodeStream.on("data", chunk => {
+            controller.enqueue(new Uint8Array(chunk));
+          });
+          nodeStream.on("end", () => {
+            controller.close();
+          });
+          nodeStream.on("error", err => {
+            controller.error(err);
+          });
+        },
+        cancel() {
+          nodeStream.destroy();
+        }
+      });
+    } catch (e) {
+      // get good callstacks
+      throw e;
+    }
+  }
+}

package/dist/src/host/interface.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Interface for the Alloy host file system operations.
+ *
+ * This interface abstracts file system operations to allow different
+ * implementations across different environments (Node.js, browser, etc.).
+ */
+export interface AlloyHostInterface {
+    /**
+     * Read a file from the file system.
+     *
+     * @param source - The path to the file to read
+     * @returns An AlloyFileInterface for accessing the file content in different formats
+     *
+     * @example
+     * ```typescript
+     * const file = AlloyHost.read('./config.json');
+     * const content = await file.text();
+     * ```
+     */
+    read(source: string): AlloyFileInterface;
+    /**
+     * Write content to a file in the file system.
+     *
+     * Supports writing different types of content including strings, binary data,
+     * and streams. For strings, content is written with UTF-8 encoding.
+     *
+     * @param destination - The path where the file should be written
+     * @param content - The content to write (string, ArrayBuffer, Uint8Array, or ReadableStream)
+     * @returns A Promise that resolves when the write operation is complete
+     *
+     * @example
+     * ```typescript
+     * // Write a string
+     * await AlloyHost.write('./output.txt', 'Hello, world!');
+     *
+     * // Write binary data
+     * const data = new Uint8Array([72, 101, 108, 108, 111]);
+     * await AlloyHost.write('./binary.dat', data);
+     * ```
+     */
+    write(destination: string, content: string | ArrayBuffer | Uint8Array | ReadableStream<Uint8Array>): Promise<void>;
+    /**
+     * Check if a file or directory exists at the given path.
+     *
+     * @param source - The path to check for existence
+     * @returns A Promise that resolves to true if the path exists, false otherwise
+     *
+     * @example
+     * ```typescript
+     * const fileExists = await AlloyHost.exists('./config.json');
+     * if (fileExists) {
+     *   // File exists, safe to read
+     * }
+     * ```
+     */
+    exists(source: string): Promise<boolean>;
+    /**
+     * Create a directory at the specified path.
+     *
+     * Creates the directory and any necessary parent directories recursively.
+     * If the directory already exists, this operation succeeds without error.
+     *
+     * @param path - The path of the directory to create
+     * @returns A Promise that resolves when the directory creation is complete
+     *
+     * @example
+     * ```typescript
+     * await AlloyHost.mkdir('./output/nested/directory');
+     * ```
+     */
+    mkdir(path: string): Promise<void>;
+}
+/**
+ * Interface for reading file content in different formats.
+ *
+ * This interface provides multiple ways to access the same file content,
+ * allowing consumers to choose the most appropriate format for their use case.
+ */
+export interface AlloyFileInterface {
+    /**
+     * Read the file content as a UTF-8 encoded string.
+     *
+     * @returns A Promise that resolves to the file content as a string
+     *
+     * @example
+     * ```typescript
+     * const file = AlloyHost.read('./config.json');
+     * const jsonString = await file.text();
+     * const config = JSON.parse(jsonString);
+     * ```
+     */
+    text(): Promise<string>;
+    /**
+     * Read the file content as an ArrayBuffer.
+     *
+     * Useful for working with binary data or when you need a raw buffer
+     * that can be used with various JavaScript APIs.
+     *
+     * @returns A Promise that resolves to the file content as an ArrayBuffer
+     *
+     * @example
+     * ```typescript
+     * const file = AlloyHost.read('./image.png');
+     * const buffer = await file.arrayBuffer();
+     * ```
+     */
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /**
+     * Read the file content as a Uint8Array.
+     *
+     * Convenient for working with binary data when you need direct access
+     * to individual bytes.
+     *
+     * @returns A Promise that resolves to the file content as a Uint8Array
+     *
+     * @example
+     * ```typescript
+     * const file = AlloyHost.read('./binary.dat');
+     * const bytes = await file.bytes();
+     * console.log('First byte:', bytes[0]);
+     * ```
+     */
+    bytes(): Promise<Uint8Array>;
+    /**
+     * Get a readable stream of the file content.
+     *
+     * Useful for processing large files without loading the entire content
+     * into memory at once, or for piping data to other streams.
+     *
+     * @returns A ReadableStream that yields Uint8Array chunks of the file content
+     *
+     * @example
+     * ```typescript
+     * const file = AlloyHost.read('./large-file.dat');
+     * const stream = file.stream();
+     *
+     * for await (const chunk of stream) {
+     *   console.log('Received chunk:', chunk);
+     * }
+     * ```
+     */
+    stream(): ReadableStream<Uint8Array>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/src/host/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/host/interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAEzC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;OAWG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAExB;;;;;;;;;;;;;OAaG;IACH,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpC;;;;;;;;;;;;;;OAcG;IACH,KAAK,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7B;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;CACtC"}

package/dist/src/host/interface.js

@@ -0,0 +1 @@
+export {};

package/dist/src/index.browser.d.ts

@@ -1,3 +1,3 @@
+export * from "./host/alloy-host.browser.js";
 export * from "./index.js";
-export { writeOutput } from "./write-output.browser.js";
 //# sourceMappingURL=index.browser.d.ts.map

package/dist/src/index.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/index.browser.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../../src/index.browser.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,YAAY,CAAC"}

package/dist/src/index.browser.js

@@ -1,2 +1,2 @@
-export * from "./index.js"; // Re-export everything
-export { writeOutput } from "./write-output.browser.js"; // Override writeOutput for browsers
+export * from "./host/alloy-host.browser.js"; // Override writeOutput for browsers
+export * from "./index.js"; // Re-export everything

package/dist/src/reactivity.js

@@ -84,12 +84,12 @@ export function effect(fn, current) {
     scheduler: scheduler(() => runner),
     onTrack(event) {
       trace(TracePhase.effect.track, () => {
-        return `tracking ${event.target}, ${event.key}`;
+        return `tracking ${event.target}, ${String(event.key)}`;
       });
     },
     onTrigger(event) {
       trace(TracePhase.effect.trigger, () => {
-        return `triggering ${event.target}, ${event.key}`;
+        return `triggering ${event.target}, ${String(event.key)}`;
       });
     }
   });

package/dist/src/render.d.ts

@@ -85,12 +85,18 @@ export interface OutputDirectory {
     path: string;
     contents: (OutputDirectory | OutputFile)[];
 }
-export interface OutputFile {
+export interface OutputFileBase {
     kind: "file";
-    contents: string;
     path: string;
+}
+export interface CopyOutputFile extends OutputFileBase {
+    sourcePath: string;
+}
+export interface ContentOutputFile extends OutputFileBase {
+    contents: string;
     filetype: string;
 }
+export type OutputFile = ContentOutputFile | CopyOutputFile;
 export declare function getContextForRenderNode(node: RenderedTextTree): Context | undefined;
 export declare const printHookTag: unique symbol;
 export interface PrintHook {
@@ -103,6 +109,8 @@ export declare function createRenderTreeHook(subtree: RenderedTextTree, hooks: O
 export declare function isPrintHook(type: unknown): type is PrintHook;
 export type RenderedTextTree = (string | RenderedTextTree | PrintHook)[];
 export declare function render(children: Children, options?: PrintTreeOptions): OutputDirectory;
+export declare function renderAsync(children: Children, options?: PrintTreeOptions): Promise<OutputDirectory>;
+export declare function sourceFilesForTree(tree: RenderedTextTree, options?: PrintTreeOptions): OutputDirectory;
 export declare function renderTree(children: Children): RenderedTextTree;
 export interface PrintTreeOptions {
     /**

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;AAKpC,OAAO,EACL,OAAO,EAQR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,QAAQ,EACR,SAAS,EAET,KAAK,EACN,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,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,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,wBAAgB,MAAM,CACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAuFjB;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,oBAY5C;AA4QD,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;CACnB;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,UAc3E;AA2BD,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,QAGhE;AAED,wBAAgB,QAAQ,SAGvB;AAED,wBAAgB,gBAAgB,SAU/B"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/render.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAO,MAAM,UAAU,CAAC;AAKpC,OAAO,EACL,OAAO,EAQR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAEL,QAAQ,EACR,SAAS,EAET,KAAK,EACN,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,wBAAgB,MAAM,CACpB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAIjB;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAI1B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,eAAe,CAoGjB;AACD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,QAAQ,oBAY5C;AA4QD,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;CACnB;AAOD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,gBAAgB,UAc3E;AA2BD,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,QAGhE;AAED,wBAAgB,QAAQ,SAGvB;AAED,wBAAgB,gBAAgB,SAU/B"}