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

package/dist/dev/src/components/AccessExpression.test.js

@@ -0,0 +1,237 @@
+import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { describe, expect, it } from "vitest";
+import "../../testing/extend-expect.js";
+import { createAccessExpression } from "../components/AccessExpression.js";
+import { code } from "../index.js";
+import { printTree, renderTree } from "../render.js";
+const {
+  Expression,
+  Part
+} = createAccessExpression({
+  createDescriptor(props, symbol, first) {
+    return {
+      name: symbol?.name ?? props.name,
+      args: props.args,
+      isFirst: first
+    };
+  },
+  getBase(part) {
+    return part.name ?? "";
+  },
+  formatPart(part, _prevPart, _inCallChain) {
+    if (part.args !== undefined) {
+      return code`.${part.name}(${part.args})`;
+    }
+    return code`.${part.name}`;
+  },
+  isCallPart(part) {
+    return part.args !== undefined;
+  }
+});
+describe("createAccessExpression", () => {
+  it("renders a single part as the base", () => {
+    expect(_$createComponent(Expression, {
+      get children() {
+        return _$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 51,
+          columnNumber: 9
+        });
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 50,
+      columnNumber: 7
+    })).toRenderTo("foo");
+  });
+  it("renders multiple parts with dot access", () => {
+    expect(_$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 59,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "bar"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 60,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "baz"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 61,
+          columnNumber: 9
+        })];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 58,
+      columnNumber: 7
+    })).toRenderTo("foo.bar.baz");
+  });
+  it("renders parts with call arguments", () => {
+    expect(_$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 69,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "bar",
+          args: "x, y"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 70,
+          columnNumber: 9
+        })];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 68,
+      columnNumber: 7
+    })).toRenderTo("foo.bar(x, y)");
+  });
+  it("returns empty for no parts", () => {
+    expect(_$createComponent(Expression, {
+      children: false
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 76,
+      columnNumber: 12
+    })).toRenderTo("");
+  });
+  it("flattens nested Expression instances", () => {
+    const inner = _$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "bar"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 82,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "baz"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 83,
+          columnNumber: 9
+        })];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 81,
+      columnNumber: 7
+    });
+    expect(_$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 89,
+          columnNumber: 9
+        }), inner];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 88,
+      columnNumber: 7
+    })).toRenderTo("foo.bar.baz");
+  });
+  it("ignores non-Part children", () => {
+    expect(_$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 98,
+          columnNumber: 9
+        }), "some string", _$createComponent(Part, {
+          name: "bar"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 100,
+          columnNumber: 9
+        })];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 97,
+      columnNumber: 7
+    })).toRenderTo("foo.bar");
+  });
+});
+describe("createAccessExpression: call chain formatting", () => {
+  it("uses linear format with only one call", () => {
+    const tree = renderTree(_$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 110,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "bar",
+          args: "x"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 111,
+          columnNumber: 9
+        })];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 109,
+      columnNumber: 7
+    }));
+    // Single call → linear, no grouping.
+    expect(printTree(tree)).toBe("foo.bar(x)");
+  });
+  it("uses call chain format with multiple calls", () => {
+    const tree = renderTree(_$createComponent(Expression, {
+      get children() {
+        return [_$createComponent(Part, {
+          name: "foo"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 121,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "bar",
+          args: "x"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 122,
+          columnNumber: 9
+        }), _$createComponent(Part, {
+          name: "baz",
+          args: "y"
+        }, {
+          fileName: import.meta.url,
+          lineNumber: 123,
+          columnNumber: 9
+        })];
+      }
+    }, {
+      fileName: import.meta.url,
+      lineNumber: 120,
+      columnNumber: 7
+    }));
+    // Multiple calls → call chain with group/indent wrapping.
+    const result = printTree(tree);
+    // Should contain both calls.
+    expect(result).toContain("bar(x)");
+    expect(result).toContain("baz(y)");
+  });
+});
+//# sourceMappingURL=AccessExpression.test.js.map

package/dist/dev/src/components/AccessExpression.test.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","expect","it","createAccessExpression","code","printTree","renderTree","Expression","Part","createDescriptor","props","symbol","first","name","args","isFirst","getBase","part","formatPart","_prevPart","_inCallChain","undefined","isCallPart","_$createComponent","children","fileName","import","meta","url","lineNumber","columnNumber","toRenderTo","inner","tree","toBe","result","toContain"],"sources":["../../../../src/components/AccessExpression.test.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/components/AppendFile.js

@@ -0,0 +1,246 @@
+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 { emitDiagnostic } from "../diagnostics.js";
+import { createFileResource } from "../resource.js";
+import { isComponentCreator } from "../runtime/component.js";
+import { childrenArray } from "../utils.js";
+import { SourceFile } from "./SourceFile.js";
+
+// Regular expression for finding all sigils at once
+const SIGIL_REGEX = /^(\s*)(.*alloy-(.+)-(start|end).*)$/gm;
+/**
+ * A component that reads a file and returns content with new content appended
+ * at the end or within specific regions marked by alloy-\{region name\}-start/alloy-\{region name\}-end sigils.
+ *
+ * The component can append content in two ways:
+ * 1. **Simple append**: Content is appended to the end of the file
+ * 2. **Region-based append**: Content is appended before the end sigil on its own line
+ *
+ * Region sigils are line-based - any line containing "alloy-\{region name\}-start" or "alloy-\{region name\}-end"
+ * is considered a sigil.
+ *
+ * @example
+ * Simple append to end of file:
+ * ```tsx
+ * <AppendFile path="output.txt">
+ *   <AppendRegion id="append">New content to add</AppendRegion>
+ * </AppendFile>
+ *
+ * // Returns:
+ * //   Original file content
+ * //   New content to add
+ * ```
+ *
+ * @example
+ * Append to specific regions:
+ * ```tsx
+ * // File content before:
+ * // Header content
+ * // <!-- alloy-main-start -->
+ * // <!-- alloy-main-end -->
+ * // Footer content
+ *
+ * <AppendFile path="template.html" regions={["main"]}>
+ *   <AppendRegion id="main">New main content</AppendRegion>
+ * </AppendFile>
+ *
+ * // Returns:
+ * //   Header content
+ * //   <!-- alloy-main-start -->
+ * //   New main content
+ * //   <!-- alloy-main-end -->
+ * //   Footer content
+ * ```
+ */
+export function AppendFile(props) {
+  const regions = props.regions || ["append"];
+
+  // Get all children and filter for AppendRegion components
+  const children = childrenArray(() => props.children);
+  const appendRegions = {};
+
+  // Check if we have any AppendRegion components
+  let hasAppendRegions = false;
+  for (const child of children) {
+    if (isComponentCreator(child, AppendRegion)) {
+      hasAppendRegions = true;
+      const regionProps = child.props;
+      let content;
+      if ("children" in regionProps && regionProps.children !== undefined) {
+        content = regionProps.children;
+      } else if ("content" in regionProps) {
+        content = regionProps.content;
+      } else {
+        emitDiagnostic({
+          message: `AppendRegion "${regionProps.id}" must have either children or content`,
+          severity: "error"
+        });
+        // Still register the region to avoid duplicate "region not found" diagnostic
+      }
+      appendRegions[regionProps.id] = content;
+    }
+  }
+
+  // If no AppendRegion components found, treat all children as content for the default "append" region
+  if (!hasAppendRegions && children.length > 0) {
+    appendRegions["append"] = children;
+  }
+
+  // Validate that all requested regions have corresponding AppendRegion children
+  for (const regionId of regions) {
+    if (!(regionId in appendRegions)) {
+      emitDiagnostic({
+        message: `Region "${regionId}" specified but no corresponding AppendRegion child found`,
+        severity: "error"
+      });
+    }
+  }
+
+  // Read existing file content or start with empty string
+  const parentDirectory = useContext(SourceDirectoryContext);
+  const fullPath = join(parentDirectory ? parentDirectory.path : "", props.path);
+  const currentContents = createFileResource(fullPath);
+  const newFileContent = computed(() => {
+    if (currentContents.loading) {
+      return;
+    }
+    const fileContent = currentContents.error ? "" : currentContents.data;
+
+    // Find all sigils in the file
+    const sigilInfo = {};
+    const endSigils = [];
+
+    // Reset regex and find all sigils
+    SIGIL_REGEX.lastIndex = 0;
+    let match;
+    while ((match = SIGIL_REGEX.exec(fileContent)) !== null) {
+      const indent = match[1];
+      const fullLine = match[0];
+      const regionId = match[3];
+      const sigilType = match[4];
+      const index = match.index;
+
+      // Initialize sigil info for this region if not exists
+      if (!sigilInfo[regionId]) {
+        sigilInfo[regionId] = {
+          id: regionId,
+          start: null,
+          end: null
+        };
+      }
+      if (sigilType === "start") {
+        sigilInfo[regionId].start = index;
+      } else if (sigilType === "end") {
+        sigilInfo[regionId].end = index;
+
+        // If this is a region we care about, track it for processing
+        if (regions.includes(regionId)) {
+          endSigils.push({
+            regionId,
+            index,
+            indent,
+            line: fullLine
+          });
+        }
+      }
+    }
+
+    // Validate regions - check for unclosed regions
+    for (const regionId of regions) {
+      const info = sigilInfo[regionId];
+      if (info && info.start !== null && info.end === null) {
+        emitDiagnostic({
+          message: `Region "${regionId}" has start sigil but no corresponding end sigil`,
+          severity: "error"
+        });
+      }
+    }
+
+    // Check if we have any sigils to process
+    if (endSigils.length === 0) {
+      // No sigils found, append all regions to the end
+      const result = [fileContent];
+      for (const regionId of regions) {
+        if (fileContent && !fileContent.endsWith("\n")) {
+          result.push("\n");
+        }
+        result.push(appendRegions[regionId]);
+      }
+      return _$createComponent(SourceFile, {
+        get path() {
+          return props.path;
+        },
+        filetype: "text/plain",
+        children: result
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 206,
+        columnNumber: 9
+      });
+    }
+
+    // Sort end sigils by their position in the file
+    endSigils.sort((a, b) => a.index - b.index);
+
+    // Process content with sigils
+    const result = [];
+    let lastIndex = 0;
+
+    // Process each end sigil in order
+    for (const {
+      regionId,
+      index,
+      indent,
+      line
+    } of endSigils) {
+      // Add content before this sigil
+      if (index > lastIndex) {
+        const beforeContent = fileContent.substring(lastIndex, index);
+        if (beforeContent) {
+          result.push(beforeContent);
+        }
+      }
+
+      // Add the new content with proper indentation
+      result.push(indent);
+      result.push(appendRegions[regionId]);
+      result.push("\n");
+
+      // Add the sigil line
+      result.push(line);
+
+      // Update last processed index
+      lastIndex = index + line.length;
+    }
+
+    // Add any remaining content after the last sigil
+    if (lastIndex < fileContent.length) {
+      const remainingPart = fileContent.substring(lastIndex);
+      if (remainingPart) {
+        result.push(remainingPart);
+      }
+    }
+    return result;
+  });
+  return _$createComponent(SourceFile, {
+    get path() {
+      return props.path;
+    },
+    filetype: "text/plain",
+    children: newFileContent
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 252,
+    columnNumber: 5
+  });
+}
+export function AppendRegion(props) {
+  /**
+   * This component does nothing except hold props which are retrieved by
+   * the `AppendFile` component.
+   */
+}
+//# sourceMappingURL=AppendFile.js.map

package/dist/dev/src/components/AppendFile.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["computed","join","useContext","SourceDirectoryContext","emitDiagnostic","createFileResource","isComponentCreator","childrenArray","SourceFile","SIGIL_REGEX","AppendFile","props","regions","children","appendRegions","hasAppendRegions","child","AppendRegion","regionProps","content","undefined","message","id","severity","length","regionId","parentDirectory","fullPath","path","currentContents","newFileContent","loading","fileContent","error","data","sigilInfo","endSigils","lastIndex","match","exec","indent","fullLine","sigilType","index","start","end","includes","push","line","info","result","endsWith","_$createComponent","filetype","fileName","import","meta","url","lineNumber","columnNumber","sort","a","b","beforeContent","substring","remainingPart"],"sources":["../../../../src/components/AppendFile.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/dev/src/components/Block.js

@@ -0,0 +1,78 @@
+import { createIntrinsic as _$createIntrinsic, memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { createContentSlot } from "../content-slot.js";
+import { computed } from "../reactivity.js";
+import { Indent } from "./Indent.js";
+/**
+ * Create an indented block of source text. The block has `opener` text which is
+ * added prior to the block, which defaults to `"{"`, and `closer` text which is
+ * added after the block, which defaults to `"}"`.
+ *
+ * @remarks
+ *
+ * When `children` is empty, `Block` renders as `{}` (opener immediately followed
+ * by closer) with no indented content — no explicit empty check is needed before
+ * passing children.
+ *
+ * @example
+ * ```tsx
+ * // Safe even when props.members is empty — renders `{}`
+ * <Block>{props.members}</Block>
+ * ```
+ */
+export function Block(props) {
+  const ContentSlot = createContentSlot();
+  const leadingNewline = computed(() => {
+    if (!props.newline) return false;
+
+    // When inline, we want a newline only when content breaks, otherwise a nothing..
+    if (props.inline) return _$createIntrinsic("sbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 53,
+      columnNumber: 30
+    });
+
+    // When not inline, we want a hardline when the slot has contents otherwise a space.
+    if (ContentSlot.hasContent) return _$createIntrinsic("hbr", {}, {
+      fileName: import.meta.url,
+      lineNumber: 56,
+      columnNumber: 40
+    });
+    return " ";
+  });
+  return _$createIntrinsic("group", {
+    get children() {
+      return [leadingNewline, _$memo(() => props.opener ?? "{", false, "props.opener ?? \u2026"), _$createComponent(Indent, {
+        get hardline() {
+          return !props.inline && ContentSlot.hasContent;
+        },
+        get line() {
+          return props.inline && ContentSlot.hasContent;
+        },
+        get softline() {
+          return !props.inline || ContentSlot.isEmpty;
+        },
+        trailingBreak: true,
+        get children() {
+          return _$createComponent(ContentSlot, {
+            get children() {
+              return props.children;
+            }
+          }, {
+            fileName: import.meta.url,
+            lineNumber: 70,
+            columnNumber: 9
+          });
+        }
+      }, {
+        fileName: import.meta.url,
+        lineNumber: 64,
+        columnNumber: 7
+      }), _$memo(() => props.closer ?? "}", false, "props.closer ?? \u2026")];
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 61,
+    columnNumber: 5
+  });
+}
+//# sourceMappingURL=Block.js.map

package/dist/dev/src/components/Block.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContentSlot","computed","Indent","Block","props","ContentSlot","leadingNewline","newline","inline","_$createIntrinsic","fileName","import","meta","url","lineNumber","columnNumber","hasContent","children","_$memo","opener","_$createComponent","hardline","line","softline","isEmpty","trailingBreak","closer"],"sources":["../../../../src/components/Block.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,iBAAiB;AAC1B,SAASC,QAAQ,QAAQ,kBAAkB;AAE3C,SAASC,MAAM;AA0Bf;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAACC,KAAiB,EAAE;EACvC,MAAMC,WAAW,GAAGL,iBAAiB,CAAC,CAAC;EACvC,MAAMM,cAAc,GAAGL,QAAQ,CAAC,MAAM;IACpC,IAAI,CAACG,KAAK,CAACG,OAAO,EAAE,OAAO,KAAK;;IAEhC;IACA,IAAIH,KAAK,CAACI,MAAM,EAAE,OAAAC,iBAAA;MAAAC,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;MAAAC,UAAA;MAAAC,YAAA;IAAA;;IAElB;IACA,IAAIV,WAAW,CAACW,UAAU,EAAE,OAAAP,iBAAA;MAAAC,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;MAAAC,UAAA;MAAAC,YAAA;IAAA;IAE5B,OAAO,GAAG;EACZ,CAAC,CAAC;EACF,OAAAN,iBAAA;IAAA,IAAAQ,SAAA;MAAA,QAEKX,cAAc,EAAAY,MAAA,OACdd,KAAK,CAACe,MAAM,IAAI,GAAG,oCAAAC,iBAAA,CACnBlB,MAAM;QAAA,IACLmB,QAAQA,CAAA;UAAA,OAAE,CAACjB,KAAK,CAACI,MAAM,IAAIH,WAAW,CAACW,UAAU;QAAA;QAAA,IACjDM,IAAIA,CAAA;UAAA,OAAElB,KAAK,CAACI,MAAM,IAAIH,WAAW,CAACW,UAAU;QAAA;QAAA,IAC5CO,QAAQA,CAAA;UAAA,OAAE,CAACnB,KAAK,CAACI,MAAM,IAAIH,WAAW,CAACmB,OAAO;QAAA;QAC9CC,aAAa;QAAA,IAAAR,SAAA;UAAA,OAAAG,iBAAA,CAEZf,WAAW;YAAA,IAAAY,SAAA;cAAA,OAAEb,KAAK,CAACa,QAAQ;YAAA;UAAA;YAAAP,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;YAAAC,UAAA;YAAAC,YAAA;UAAA;QAAA;MAAA;QAAAL,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;QAAAC,UAAA;QAAAC,YAAA;MAAA,IAAAG,MAAA,OAE7Bd,KAAK,CAACsB,MAAM,IAAI,GAAG;IAAA;EAAA;IAAAhB,QAAA,EAAAC,MAAA,CAAAC,IAAA,CAAAC,GAAA;IAAAC,UAAA;IAAAC,YAAA;EAAA;AAG1B","ignoreList":[]}

package/dist/dev/src/components/CopyFile.js

@@ -0,0 +1,16 @@
+import { join } from "pathe";
+import { useContext } from "../context.js";
+import { SourceDirectoryContext } from "../context/source-directory.js";
+import { getContext } from "../reactivity.js";
+export function CopyFile(props) {
+  const parentDirectory = useContext(SourceDirectoryContext);
+  const context = {
+    path: join(parentDirectory ? parentDirectory.path : "", props.path),
+    sourcePath: props.src
+  };
+  parentDirectory?.addContent(context);
+  const nodeContext = getContext();
+  nodeContext.meta ??= {};
+  nodeContext.meta.copyFile = context;
+}
+//# sourceMappingURL=CopyFile.js.map

package/dist/dev/src/components/CopyFile.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["join","useContext","SourceDirectoryContext","getContext","CopyFile","props","parentDirectory","context","path","sourcePath","src","addContent","nodeContext","meta","copyFile"],"sources":["../../../../src/components/CopyFile.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAASA,IAAI,QAAQ,OAAO;AAC5B,SAASC,UAAU,QAAQ,eAAe;AAC1C,SAASC,sBAAsB,QAAQ,gCAAgC;AAEvE,SAASC,UAAU,QAAQ,kBAAkB;AAc7C,OAAO,SAASC,QAAQA,CAACC,KAAoB,EAAE;EAC7C,MAAMC,eAAe,GAAGL,UAAU,CAACC,sBAAsB,CAAE;EAC3D,MAAMK,OAAwB,GAAG;IAC/BC,IAAI,EAAER,IAAI,CAACM,eAAe,GAAGA,eAAe,CAACE,IAAI,GAAG,EAAE,EAAEH,KAAK,CAACG,IAAI,CAAC;IACnEC,UAAU,EAAEJ,KAAK,CAACK;EACpB,CAAC;EACDJ,eAAe,EAAEK,UAAU,CAACJ,OAAO,CAAC;EACpC,MAAMK,WAAW,GAAGT,UAAU,CAAC,CAAE;EACjCS,WAAW,CAACC,IAAI,KAAK,CAAC,CAAC;EACvBD,WAAW,CAACC,IAAI,CAACC,QAAQ,GAAGP,OAAO;AACrC","ignoreList":[]}

package/dist/dev/src/components/Declaration.js

@@ -0,0 +1,70 @@
+import { memo as _$memo, createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { createSymbol } from "../binder.js";
+import { useContext } from "../context.js";
+import { BinderContext } from "../context/binder.js";
+import { DeclarationContext } from "../context/declaration.js";
+import { useScope } from "../context/scope.js";
+import { onCleanup } from "../reactivity.js";
+import { BasicScope } from "../symbols/basic-scope.js";
+import { BasicSymbol } from "../symbols/basic-symbol.js";
+
+/**
+ * Create a declaration by providing an already created symbol. The symbol is
+ * merely exposed via {@link DeclarationContext}.
+ */
+
+/**
+ * Create a declaration by providing a symbol name and optional symbol metadata.
+ */
+
+/**
+ * Declares a symbol in the current scope for this component's children.
+ *
+ * @remarks
+ *
+ * This component must be called in one of two ways: with a name and an optional
+ * refkey, or else passing in the symbol. When called with a name and refkey, a
+ * symbol will be created in the current scope (provided by
+ * {@link ScopeContext}) with that name and refkey.
+ *
+ * When called with a symbol, that symbol is merely exposed via
+ * {@link DeclarationContext}. It is assumed that the caller of this component
+ * has created the symbol with the `createSymbol` API on the
+ * {@link BinderContext }.
+ *
+ * @see {@link BinderContext}
+ */
+export function Declaration(props) {
+  const binder = useContext(BinderContext);
+  if (!binder) {
+    throw new Error("Need binder context to create declarations");
+  }
+  let declaration;
+  if ("symbol" in props) {
+    declaration = props.symbol;
+  } else {
+    const scope = useScope();
+    if (!(scope instanceof BasicScope)) {
+      throw new Error(`Declaration component cannot create a symbol in a non-basic scope: ${scope}`);
+    }
+    declaration = createSymbol(BasicSymbol, props.name, scope.symbols, {
+      binder,
+      refkeys: [props.refkey ?? []].flat(),
+      metadata: props.metadata
+    });
+    onCleanup(() => {
+      declaration.delete();
+    });
+  }
+  return _$createComponent(DeclarationContext.Provider, {
+    value: declaration,
+    get children() {
+      return props.children;
+    }
+  }, {
+    fileName: import.meta.url,
+    lineNumber: 99,
+    columnNumber: 5
+  });
+}
+//# sourceMappingURL=Declaration.js.map