@alloy-js/core 0.7.0 → 0.9.0

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

@@ -1,7 +1,7 @@
 import { Children } from "@alloy-js/core/jsx-runtime";
 import { Ref } from "@vue/reactivity";
 import { BaseListProps } from "./List.jsx";
-export type ForCallbackArgs<T> = T extends Ref<infer U> ? ForCallbackArgs<U> : T extends () => infer U ? ForCallbackArgs<U> : T extends (infer U)[] ? [value: U] : T extends Map<infer U, infer V> ? [key: U, value: V] : T extends Set<infer U> ? [value: U] : [];
+export type ForCallbackArgs<T> = T extends Ref<infer U> ? ForCallbackArgs<U> : T extends () => infer U ? ForCallbackArgs<U> : T extends (infer U)[] ? [value: U] : T extends Map<infer U, infer V> ? [key: U, value: V] : T extends Set<infer U> ? [value: U] : T extends IterableIterator<infer U> ? [value: U] : [];
 export interface ForProps<T extends ForSupportedCollections | (() => ForSupportedCollections) | Ref<ForSupportedCollections>, U extends Children> extends BaseListProps {
     /**
      * The array to iterate over.
@@ -11,8 +11,14 @@ export interface ForProps<T extends ForSupportedCollections | (() => ForSupporte
      * A function to call for each item.
      */
     children: (...args: [...ForCallbackArgs<T>, index: number]) => U;
+    /**
+     * Whether to skip falsy values. By default, falsy values are mapped. However,
+     * when mapping children, it is useful to skip falsy values, as it enables
+     * omitting list elements via patterns like `{condition && <ListItem />}`.
+     */
+    skipFalsy?: boolean;
 }
-export type ForSupportedCollections = any[] | Map<any, any> | Set<any>;
+export type ForSupportedCollections = any[] | Map<any, any> | Set<any> | IterableIterator<any>;
 /**
  * The For component iterates over the provided array and invokes the child
  * callback for each item. It can optionally be provided with a `joiner` which

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

@@ -1 +1 @@
-{"version":3,"file":"For.d.ts","sourceRoot":"","sources":["../../../src/components/For.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAQ,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAS,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAA8B,MAAM,YAAY,CAAC;AAEvE,MAAM,MAAM,eAAe,CAAC,CAAC,IAC3B,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GACzC,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAC5C,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GAClC,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GACpD,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GACnC,EAAE,CAAC;AAEP,MAAM,WAAW,QAAQ,CACvB,CAAC,SACG,uBAAuB,GACvB,CAAC,MAAM,uBAAuB,CAAC,GAC/B,GAAG,CAAC,uBAAuB,CAAC,EAChC,CAAC,SAAS,QAAQ,CAClB,SAAQ,aAAa;IACrB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,uBAAuB,GAAG,GAAG,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;AACvE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CACjB,CAAC,SACG,uBAAuB,GACvB,CAAC,MAAM,uBAAuB,CAAC,GAC/B,GAAG,CAAC,uBAAuB,CAAC,EAChC,CAAC,SAAS,QAAQ,EAClB,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,aAetB"}
+{"version":3,"file":"For.d.ts","sourceRoot":"","sources":["../../../src/components/For.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAQ,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAS,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,MAAM,eAAe,CAAC,CAAC,IAC3B,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GACzC,CAAC,SAAS,MAAM,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,GAC5C,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GAClC,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GACpD,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GACnC,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,GAChD,EAAE,CAAC;AAEP,MAAM,WAAW,QAAQ,CACvB,CAAC,SACG,uBAAuB,GACvB,CAAC,MAAM,uBAAuB,CAAC,GAC/B,GAAG,CAAC,uBAAuB,CAAC,EAChC,CAAC,SAAS,QAAQ,CAClB,SAAQ,aAAa;IACrB;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAEjE;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,uBAAuB,GAC/B,GAAG,EAAE,GACL,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GACb,GAAG,CAAC,GAAG,CAAC,GACR,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CACjB,CAAC,SACG,uBAAuB,GACvB,CAAC,MAAM,uBAAuB,CAAC,GAC/B,GAAG,CAAC,uBAAuB,CAAC,EAChC,CAAC,SAAS,QAAQ,EAClB,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,aAetB"}

package/dist/src/components/For.js

@@ -1,7 +1,6 @@
 import { memo } from "@alloy-js/core/jsx-runtime";
 import { isRef } from "@vue/reactivity";
-import { mapJoin } from "../utils.js";
-import { baseListPropsToMapJoinArgs } from "./List.js";
+import { baseListPropsToMapJoinArgs, mapJoin } from "../utils.js";
 /**
  * The For component iterates over the provided array and invokes the child
  * callback for each item. It can optionally be provided with a `joiner` which
@@ -32,7 +31,7 @@ import { baseListPropsToMapJoinArgs } from "./List.js";
 export function For(props) {
   const cb = props.children;
   const options = baseListPropsToMapJoinArgs(props);
-  options.skipFalsy = true;
+  options.skipFalsy = props.skipFalsy;
   return memo(() => {
     const maybeRef = props.each;
     return mapJoin(typeof maybeRef === "function" ? maybeRef : () => isRef(maybeRef) ? maybeRef.value : maybeRef, cb, options);

package/dist/src/components/For.js.map

@@ -1 +1 @@
-{"version":3,"file":"For.js","names":["memo","isRef","mapJoin","baseListPropsToMapJoinArgs","For","props","cb","children","options","skipFalsy","maybeRef","each","value"],"sources":["../../../src/components/For.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAAmBA,IAAI,QAAQ,4BAA4B;AAC3D,SAASC,KAAK,QAAa,iBAAiB;AAC5C,SAASC,OAAO,QAAQ,aAAa;AACrC,SAAwBC,0BAA0B;AA6BlD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,GAAGA,CAMjBC,KAAqB,EAAE;EACvB,MAAMC,EAAE,GAAGD,KAAK,CAACE,QAAQ;EACzB,MAAMC,OAAO,GAAGL,0BAA0B,CAACE,KAAK,CAAC;EACjDG,OAAO,CAACC,SAAS,GAAG,IAAI;EACxB,OAAOT,IAAI,CAAC,MAAM;IAChB,MAAMU,QAAQ,GAAGL,KAAK,CAACM,IAAI;IAE3B,OAAQT,OAAO,CACb,OAAOQ,QAAQ,KAAK,UAAU,GAAGA,QAAQ,GACvC,MAAOT,KAAK,CAACS,QAAQ,CAAC,GAAGA,QAAQ,CAACE,KAAK,GAAGF,QAC3C,EACDJ,EAAE,EACFE,OACF,CAAC;EACH,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"file":"For.js","names":["memo","isRef","baseListPropsToMapJoinArgs","mapJoin","For","props","cb","children","options","skipFalsy","maybeRef","each","value"],"sources":["../../../src/components/For.tsx"],"sourcesContent":[null],"mappings":"AAAA,SAAmBA,IAAI,QAAQ,4BAA4B;AAC3D,SAASC,KAAK,QAAa,iBAAiB;AAC5C,SAASC,0BAA0B,EAAEC,OAAO,QAAQ,aAAa;AA0CjE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,GAAGA,CAMjBC,KAAqB,EAAE;EACvB,MAAMC,EAAE,GAAGD,KAAK,CAACE,QAAQ;EACzB,MAAMC,OAAO,GAAGN,0BAA0B,CAACG,KAAK,CAAC;EACjDG,OAAO,CAACC,SAAS,GAAGJ,KAAK,CAACI,SAAS;EACnC,OAAOT,IAAI,CAAC,MAAM;IAChB,MAAMU,QAAQ,GAAGL,KAAK,CAACM,IAAI;IAE3B,OAAQR,OAAO,CACb,OAAOO,QAAQ,KAAK,UAAU,GAAGA,QAAQ,GACvC,MAAOT,KAAK,CAACS,QAAQ,CAAC,GAAGA,QAAQ,CAACE,KAAK,GAAGF,QAC3C,EACDJ,EAAE,EACFE,OACF,CAAC;EACH,CAAC,CAAC;AACJ","ignoreList":[]}

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

@@ -1,9 +1,37 @@
 import { Children } from "@alloy-js/core/jsx-runtime";
 export interface IndentProps {
     children: Children;
+    /**
+     * Don't include a line break. The new indentation level will start after the
+     * first linebreak within the children.
+     */
     nobreak?: boolean;
-    break?: "space" | "soft" | "hard";
+    /**
+     * Use a regular line (`<br />`) to start (and optionally end with
+     * `trailingBreak`) the new indentation level.
+     */
+    line?: boolean;
+    /**
+     * Use a soft line (`<sbr />`) to start (and optionally end with
+     * `trailingBreak`) the new indentation level.
+     */
+    softline?: boolean;
+    /**
+     * Use a hard line (`<hbr />`) to start (and optionally end with
+     * `trailingBreak`) the new indentation level.
+     */
+    hardline?: boolean;
+    /**
+     * Place the configured line break at the end of the block after restoring the
+     * indentation level.
+     */
     trailingBreak?: boolean;
 }
+/**
+ * Create an indented block of source text. The indented block starts a new line
+ * at the new indentation level and, with `trailingBreak`, ends with a new line
+ * after restoring the indentation level. The default line break is a hard line
+ * break suitable for typical blocks of statements but can be configured.
+ */
 export declare function Indent(props: IndentProps): Children;
 //# sourceMappingURL=Indent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Indent.d.ts","sourceRoot":"","sources":["../../../src/components/Indent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AACD,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,YAiBxC"}
+{"version":3,"file":"Indent.d.ts","sourceRoot":"","sources":["../../../src/components/Indent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,YAiBxC"}

package/dist/src/components/Indent.js

@@ -1,8 +1,13 @@
 import { memo as _$memo } from "@alloy-js/core/jsx-runtime";
 import { createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+/**
+ * Create an indented block of source text. The indented block starts a new line
+ * at the new indentation level and, with `trailingBreak`, ends with a new line
+ * after restoring the indentation level. The default line break is a hard line
+ * break suitable for typical blocks of statements but can be configured.
+ */
 export function Indent(props) {
-  const breakStyle = props.break ?? "hard";
-  const breakElem = props.nobreak ? "" : breakStyle === "hard" ? _$createIntrinsic("hbr", {}) : breakStyle === "soft" ? _$createIntrinsic("sbr", {}) : _$createIntrinsic("br", {});
+  const breakElem = props.nobreak ? "" : props.hardline ? _$createIntrinsic("hbr", {}) : props.softline ? _$createIntrinsic("sbr", {}) : props.line ? _$createIntrinsic("br", {}) : _$createIntrinsic("hbr", {});
   return [_$createIntrinsic("indent", {
     get children() {
       return [breakElem, _$memo(() => props.children)];

package/dist/src/components/Indent.js.map

@@ -1 +1 @@
-{"version":3,"file":"Indent.js","names":["Indent","props","breakStyle","break","breakElem","nobreak","_$createIntrinsic","children","_$memo","trailingBreak"],"sources":["../../../src/components/Indent.tsx"],"sourcesContent":[null],"mappings":";;AAQA,OAAO,SAASA,MAAMA,CAACC,KAAkB,EAAE;EACzC,MAAMC,UAAU,GAAGD,KAAK,CAACE,KAAK,IAAI,MAAM;EACxC,MAAMC,SAAS,GACbH,KAAK,CAACI,OAAO,GAAG,EAAE,GAChBH,UAAU,KAAK,MAAM,GAAAI,iBAAA,cACrBJ,UAAU,KAAK,MAAM,GAAAI,iBAAA,cAAAA,iBAAA,UACf;EAEV,QAAAA,iBAAA;IAAA,IAAAC,SAAA;MAAA,QAGOH,SAAS,EAAAI,MAAA,OACTP,KAAK,CAACM,QAAQ;IAAA;EAAA,IAAAC,MAAA,OAEhBP,KAAK,CAACQ,aAAa,IAAIL,SAAS;AAGvC","ignoreList":[]}
+{"version":3,"file":"Indent.js","names":["Indent","props","breakElem","nobreak","hardline","_$createIntrinsic","softline","line","children","_$memo","trailingBreak"],"sources":["../../../src/components/Indent.tsx"],"sourcesContent":[null],"mappings":";;AAmCA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,MAAMA,CAACC,KAAkB,EAAE;EACzC,MAAMC,SAAS,GACbD,KAAK,CAACE,OAAO,GAAG,EAAE,GAChBF,KAAK,CAACG,QAAQ,GAAAC,iBAAA,cACdJ,KAAK,CAACK,QAAQ,GAAAD,iBAAA,cACdJ,KAAK,CAACM,IAAI,GAAAF,iBAAA,aAAAA,iBAAA,WACH;EAEX,QAAAA,iBAAA;IAAA,IAAAG,SAAA;MAAA,QAGON,SAAS,EAAAO,MAAA,OACTR,KAAK,CAACO,QAAQ;IAAA;EAAA,IAAAC,MAAA,OAEhBR,KAAK,CAACS,aAAa,IAAIR,SAAS;AAGvC","ignoreList":[]}

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

@@ -1,6 +1,4 @@
 import { Children } from "@alloy-js/core/jsx-runtime";
-import { JoinOptions } from "../utils.js";
-export type BreakKind = "none" | "space" | "soft" | "hard" | "literal";
 export interface BaseListProps {
     /** Text to place between each element */
     joiner?: Children;
@@ -8,10 +6,17 @@ export interface BaseListProps {
     comma?: boolean;
     /** Place a semicolon between each element */
     semicolon?: boolean;
+    /** Place a regular line (`<br />`) between each element */
     line?: boolean;
+    /** Place a softline (`<sbr />`) between each element */
     softline?: boolean;
+    /** Place a hardline (`<hbr />`) between each element */
     hardline?: boolean;
+    /** Place two hardlines between each element */
+    doubleHardline?: boolean;
+    /** Place a literal line (`<lbr />`) between each element */
     literalline?: boolean;
+    /** Place a space between each element */
     space?: boolean;
     /**
      * Text to place at the end of the list when there is at least one item. If
@@ -23,7 +28,6 @@ export interface BaseListProps {
      */
     enderPunctuation?: boolean;
 }
-export declare function baseListPropsToMapJoinArgs(props: BaseListProps): JoinOptions;
 export interface ListProps extends BaseListProps {
     children?: Children;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/components/List.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAiB,WAAW,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;QAGI;IACJ,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,WAAW,CAkC5E;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,YAYpC"}
+{"version":3,"file":"List.d.ts","sourceRoot":"","sources":["../../../src/components/List.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoB,MAAM,4BAA4B,CAAC;AAIxE,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,MAAM,CAAC,EAAE,QAAQ,CAAC;IAElB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;QAGI;IACJ,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,SAAU,SAAQ,aAAa;IAC9C,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,YAYpC"}

package/dist/src/components/List.js

@@ -1,24 +1,8 @@
 import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
 import { mergeProps as _$mergeProps } from "@alloy-js/core/jsx-runtime";
-import { createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
-import { memo as _$memo } from "@alloy-js/core/jsx-runtime";
 import { memo, splitProps } from "@alloy-js/core/jsx-runtime";
 import { childrenArray } from "../utils.js";
 import { For } from "./For.js";
-export function baseListPropsToMapJoinArgs(props) {
-  let joiner, punctuation;
-  if ("joiner" in props) {
-    joiner = props.joiner;
-  } else {
-    punctuation = props.comma ? "," : props.semicolon ? ";" : "";
-    joiner = [punctuation, _$memo(() => _$memo(() => !!props.softline)() ? _$createIntrinsic("sbr", {}) : _$memo(() => !!props.hardline)() ? _$createIntrinsic("hbr", {}) : _$memo(() => !!props.literalline)() ? _$createIntrinsic("lbr", {}) : _$memo(() => !!props.line)() ? _$createIntrinsic("br", {}) : _$memo(() => !!props.space)() ? [" "] : _$createIntrinsic("hbr", {}))];
-  }
-  const ender = "ender" in props ? props.ender : props.enderPunctuation ? punctuation : undefined;
-  return {
-    joiner,
-    ender
-  };
-}
 /**
  * Create a list of children with text between each child. The text to join with
  * is specified by providing either `joiner` children, or providing boolean
@@ -34,6 +18,7 @@ export function List(props) {
   return _$createComponent(For, _$mergeProps({
     each: resolvedChildren
   }, forProps, {
+    skipFalsy: true,
     children: child => child
   }));
 }

package/dist/src/components/List.js.map

@@ -1 +1 @@
-{"version":3,"file":"List.js","names":["memo","splitProps","childrenArray","For","baseListPropsToMapJoinArgs","props","joiner","punctuation","comma","semicolon","_$memo","softline","_$createIntrinsic","hardline","literalline","line","space","ender","enderPunctuation","undefined","List","rest","forProps","resolvedChildren","children","preserveFragments","_$createComponent","_$mergeProps","each","child"],"sources":["../../../src/components/List.tsx"],"sourcesContent":[null],"mappings":";;;;AAAA,SAAmBA,IAAI,EAAEC,UAAU,QAAQ,4BAA4B;AACvE,SAASC,aAAa,QAAqB,aAAa;AACxD,SAASC,GAAG;AAgCZ,OAAO,SAASC,0BAA0BA,CAACC,KAAoB,EAAe;EAC5E,IAAIC,MAAM,EAAEC,WAAW;EACvB,IAAI,QAAQ,IAAIF,KAAK,EAAE;IACrBC,MAAM,GAAGD,KAAK,CAACC,MAAM;EACvB,CAAC,MAAM;IACLC,WAAW,GACTF,KAAK,CAACG,KAAK,GAAG,GAAG,GACfH,KAAK,CAACI,SAAS,GAAG,GAAG,GACrB,EAAE;IAENH,MAAM,IAEDC,WAAW,EAAAG,MAAA,OACXA,MAAA,SAAAL,KAAK,CAACM,QAAQ,MAAAC,iBAAA,cAEbF,MAAA,SAAAL,KAAK,CAACQ,QAAQ,MAAAD,iBAAA,cAEdF,MAAA,SAAAL,KAAK,CAACS,WAAW,MAAAF,iBAAA,cAEjBF,MAAA,SAAAL,KAAK,CAACU,IAAI,MAAAH,iBAAA,aAEVF,MAAA,SAAAL,KAAK,CAACW,KAAK,cAAAJ,iBAAA,WAEJ,EAEZ;EACH;EAEA,MAAMK,KAAK,GACT,OAAO,IAAIZ,KAAK,GAAGA,KAAK,CAACY,KAAK,GAC5BZ,KAAK,CAACa,gBAAgB,GAAGX,WAAW,GACpCY,SAAS;EAEb,OAAO;IAAEb,MAAM;IAAEW;EAAM,CAAC;AAC1B;AAMA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,IAAIA,CAACf,KAAgB,EAAE;EACrC,MAAM,CAACgB,IAAI,EAAEC,QAAQ,CAAC,GAAGrB,UAAU,CAACI,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC;EACxD,MAAMkB,gBAAgB,GAAGvB,IAAI,CAAC,MAC5BE,aAAa,CAAC,MAAMmB,IAAI,CAACG,QAAQ,EAAE;IACjCC,iBAAiB,EAAE;EACrB,CAAC,CACH,CAAC;EACD,OAAAC,iBAAA,CACGvB,GAAG,EAAAwB,YAAA;IAACC,IAAI,EAAEL;EAAgB,GAAMD,QAAQ;IAAAE,QAAA,EACrCK,KAAK,IAAKA;EAAK;AAGvB","ignoreList":[]}
+{"version":3,"file":"List.js","names":["memo","splitProps","childrenArray","For","List","props","rest","forProps","resolvedChildren","children","preserveFragments","_$createComponent","_$mergeProps","each","skipFalsy","child"],"sources":["../../../src/components/List.tsx"],"sourcesContent":[null],"mappings":";;AAAA,SAAmBA,IAAI,EAAEC,UAAU,QAAQ,4BAA4B;AACvE,SAASC,aAAa,QAAQ,aAAa;AAC3C,SAASC,GAAG;AA8CZ;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAACC,KAAgB,EAAE;EACrC,MAAM,CAACC,IAAI,EAAEC,QAAQ,CAAC,GAAGN,UAAU,CAACI,KAAK,EAAE,CAAC,UAAU,CAAC,CAAC;EACxD,MAAMG,gBAAgB,GAAGR,IAAI,CAAC,MAC5BE,aAAa,CAAC,MAAMI,IAAI,CAACG,QAAQ,EAAE;IACjCC,iBAAiB,EAAE;EACrB,CAAC,CACH,CAAC;EACD,OAAAC,iBAAA,CACGR,GAAG,EAAAS,YAAA;IAACC,IAAI,EAAEL;EAAgB,GAAMD,QAAQ;IAAEO,SAAS;IAAAL,QAAA,EAChDM,KAAK,IAAKA;EAAK;AAGvB","ignoreList":[]}

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

@@ -1,13 +1,43 @@
 import { OutputSymbol } from "../binder.js";
 import { Children } from "../jsx-runtime.js";
 import { Refkey } from "../refkey.js";
-export interface MemberDeclarationProps {
-    name?: string;
-    refkey?: Refkey;
-    symbol?: OutputSymbol;
-    children?: Children;
+/**
+ * Create a member declaration by providing a symbol name and optional symbol
+ * metadata.
+ */
+export interface MemberDeclarationPropsWithInfo {
+    /**
+     * The name of this declaration.
+     */
+    name: string;
+    /**
+     * The refkey or array refkeys for this declaration.
+     */
+    refkey?: Refkey | Refkey[];
+    /**
+     * Additional metadata for the declared symbol.
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Whether this is a static member. If not provided, the member is an instance
+     * member.
+     */
     static?: boolean;
+    children?: Children;
+}
+/**
+ * Create a declaration by providing an already created symbol. The symbol is
+ * merely exposed via {@link DeclarationContext}.
+ */
+export interface MemberDeclarationPropsWithSymbol {
+    /**
+     * The symbol being declared. When provided, the name, refkey, and metadata
+     * props are ignored.
+     */
+    symbol: OutputSymbol;
+    children?: Children;
 }
+export type MemberDeclarationProps = MemberDeclarationPropsWithInfo | MemberDeclarationPropsWithSymbol;
 /**
  * Declares a symbol in the current member scope for this component's children.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"MemberDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/MemberDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC;AAI/D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAU,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,YA+B9D"}
+{"version":3,"file":"MemberDeclaration.d.ts","sourceRoot":"","sources":["../../../src/components/MemberDeclaration.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAqB,MAAM,cAAc,CAAC;AAI/D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;;OAGG;IACH,MAAM,EAAE,YAAY,CAAC;IAErB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAC9B,8BAA8B,GAC9B,gCAAgC,CAAC;AAErC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,YAgC9D"}

package/dist/src/components/MemberDeclaration.js

@@ -4,7 +4,17 @@ import { OutputSymbolFlags } from "../binder.js";
 import { useContext } from "../context.js";
 import { BinderContext } from "../context/binder.js";
 import { MemberDeclarationContext } from "../context/member-declaration.js";
-import { refkey } from "../refkey.js";
+
+/**
+ * Create a member declaration by providing a symbol name and optional symbol
+ * metadata.
+ */
+
+/**
+ * Create a declaration by providing an already created symbol. The symbol is
+ * merely exposed via {@link DeclarationContext}.
+ */
+
 /**
  * Declares a symbol in the current member scope for this component's children.
  *
@@ -29,17 +39,18 @@ export function MemberDeclaration(props) {
     throw new Error("Need binder context to create declarations");
   }
   let declaration;
-  if (props.symbol) {
+  if ("symbol" in props && props.symbol) {
     declaration = props.symbol;
   } else {
-    if (!props.name) {
+    const infoProps = props;
+    if (!infoProps.name) {
       throw new Error("Must provide a member name, or else provide a member symbol");
     }
-    const rk = props.refkey ? props.refkey : refkey(props.name);
     declaration = binder.createSymbol({
-      name: props.name,
-      refkey: rk,
-      flags: props.static ? OutputSymbolFlags.StaticMember : OutputSymbolFlags.InstanceMember
+      name: infoProps.name,
+      refkey: infoProps.refkey,
+      metadata: infoProps.metadata,
+      flags: infoProps.static ? OutputSymbolFlags.StaticMember : OutputSymbolFlags.InstanceMember
     });
   }
   return _$createComponent(MemberDeclarationContext.Provider, {

package/dist/src/components/MemberDeclaration.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemberDeclaration.js","names":["OutputSymbolFlags","useContext","BinderContext","MemberDeclarationContext","refkey","MemberDeclaration","props","binder","Error","declaration","symbol","name","rk","createSymbol","flags","static","StaticMember","InstanceMember","_$createComponent","Provider","value","children"],"sources":["../../../src/components/MemberDeclaration.tsx"],"sourcesContent":[null],"mappings":";;AAAA,SAAuBA,iBAAiB,QAAQ,cAAc;AAC9D,SAASC,UAAU,QAAQ,eAAe;AAC1C,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,wBAAwB,QAAQ,kCAAkC;AAE3E,SAAiBC,MAAM,QAAQ,cAAc;AAU7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACC,KAA6B,EAAE;EAC/D,MAAMC,MAAM,GAAGN,UAAU,CAACC,aAAa,CAAC;EACxC,IAAI,CAACK,MAAM,EAAE;IACX,MAAM,IAAIC,KAAK,CAAC,4CAA4C,CAAC;EAC/D;EAEA,IAAIC,WAAW;EACf,IAAIH,KAAK,CAACI,MAAM,EAAE;IAChBD,WAAW,GAAGH,KAAK,CAACI,MAAM;EAC5B,CAAC,MAAM;IACL,IAAI,CAACJ,KAAK,CAACK,IAAI,EAAE;MACf,MAAM,IAAIH,KAAK,CACb,6DACF,CAAC;IACH;IACA,MAAMI,EAAE,GAAGN,KAAK,CAACF,MAAM,GAAGE,KAAK,CAACF,MAAM,GAAGA,MAAM,CAACE,KAAK,CAACK,IAAI,CAAC;IAC3DF,WAAW,GAAGF,MAAM,CAACM,YAAY,CAAC;MAChCF,IAAI,EAAEL,KAAK,CAACK,IAAK;MACjBP,MAAM,EAAEQ,EAAE;MACVE,KAAK,EACHR,KAAK,CAACS,MAAM,GACVf,iBAAiB,CAACgB,YAAY,GAC9BhB,iBAAiB,CAACiB;IACxB,CAAC,CAAC;EACJ;EAEA,OAAAC,iBAAA,CACGf,wBAAwB,CAACgB,QAAQ;IAACC,KAAK,EAAEX,WAAW;IAAA,IAAAY,SAAA;MAAA,OAClDf,KAAK,CAACe,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}
+{"version":3,"file":"MemberDeclaration.js","names":["OutputSymbolFlags","useContext","BinderContext","MemberDeclarationContext","MemberDeclaration","props","binder","Error","declaration","symbol","infoProps","name","createSymbol","refkey","metadata","flags","static","StaticMember","InstanceMember","_$createComponent","Provider","value","children"],"sources":["../../../src/components/MemberDeclaration.tsx"],"sourcesContent":[null],"mappings":";;AAAA,SAAuBA,iBAAiB,QAAQ,cAAc;AAC9D,SAASC,UAAU,QAAQ,eAAe;AAC1C,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,wBAAwB,QAAQ,kCAAkC;;AAI3E;AACA;AACA;AACA;;AAyBA;AACA;AACA;AACA;;AAeA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACC,KAA6B,EAAE;EAC/D,MAAMC,MAAM,GAAGL,UAAU,CAACC,aAAa,CAAC;EACxC,IAAI,CAACI,MAAM,EAAE;IACX,MAAM,IAAIC,KAAK,CAAC,4CAA4C,CAAC;EAC/D;EAEA,IAAIC,WAAW;EACf,IAAI,QAAQ,IAAIH,KAAK,IAAIA,KAAK,CAACI,MAAM,EAAE;IACrCD,WAAW,GAAGH,KAAK,CAACI,MAAM;EAC5B,CAAC,MAAM;IACL,MAAMC,SAAS,GAAGL,KAAuC;IACzD,IAAI,CAACK,SAAS,CAACC,IAAI,EAAE;MACnB,MAAM,IAAIJ,KAAK,CACb,6DACF,CAAC;IACH;IACAC,WAAW,GAAGF,MAAM,CAACM,YAAY,CAAC;MAChCD,IAAI,EAAED,SAAS,CAACC,IAAK;MACrBE,MAAM,EAAEH,SAAS,CAACG,MAAM;MACxBC,QAAQ,EAAEJ,SAAS,CAACI,QAAQ;MAC5BC,KAAK,EACHL,SAAS,CAACM,MAAM,GACdhB,iBAAiB,CAACiB,YAAY,GAC9BjB,iBAAiB,CAACkB;IACxB,CAAC,CAAC;EACJ;EAEA,OAAAC,iBAAA,CACGhB,wBAAwB,CAACiB,QAAQ;IAACC,KAAK,EAAEb,WAAW;IAAA,IAAAc,SAAA;MAAA,OAClDjB,KAAK,CAACiB,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}

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

@@ -22,6 +22,8 @@ export interface MemberScopeProps {
  *
  * The member scope contains scopes for both instance and static members.
  * However, it does not affect the resolution of static members.
+ *
+ * @see {@link (MemberScopeContext:variable)}
  */
 export declare function MemberScope(props: MemberScopeProps): Children;
 //# sourceMappingURL=MemberScope.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MemberScope.d.ts","sourceRoot":"","sources":["../../../src/components/MemberScope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK7C,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,YAUlD"}
+{"version":3,"file":"MemberScope.d.ts","sourceRoot":"","sources":["../../../src/components/MemberScope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAK7C,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,YAUlD"}

package/dist/src/components/MemberScope.js

@@ -12,6 +12,8 @@ import { MemberScopeContext } from "../context/member-scope.js";
  *
  * The member scope contains scopes for both instance and static members.
  * However, it does not affect the resolution of static members.
+ *
+ * @see {@link (MemberScopeContext:variable)}
  */
 export function MemberScope(props) {
   const context = {

package/dist/src/components/MemberScope.js.map

@@ -1 +1 @@
-{"version":3,"file":"MemberScope.js","names":["MemberScopeContext","MemberScope","props","context","instanceMembers","owner","instanceMemberScope","staticMembers","staticMemberScope","_$createComponent","Provider","value","children"],"sources":["../../../src/components/MemberScope.tsx"],"sourcesContent":[null],"mappings":";;AAGA;;AAEA,SAASA,kBAAkB,QAAQ,4BAA4B;AAgB/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,KAAuB,EAAE;EACnD,MAAMC,OAA2B,GAAG;IAClCC,eAAe,EAAEF,KAAK,CAACG,KAAK,CAACC,mBAAmB;IAChDC,aAAa,EAAEL,KAAK,CAACG,KAAK,CAACG;EAC7B,CAAC;EACD,OAAAC,iBAAA,CACGT,kBAAkB,CAACU,QAAQ;IAACC,KAAK,EAAER,OAAO;IAAA,IAAAS,SAAA;MAAA,OACxCV,KAAK,CAACU,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}
+{"version":3,"file":"MemberScope.js","names":["MemberScopeContext","MemberScope","props","context","instanceMembers","owner","instanceMemberScope","staticMembers","staticMemberScope","_$createComponent","Provider","value","children"],"sources":["../../../src/components/MemberScope.tsx"],"sourcesContent":[null],"mappings":";;AAGA;;AAEA,SAASA,kBAAkB,QAAQ,4BAA4B;AAgB/D;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,WAAWA,CAACC,KAAuB,EAAE;EACnD,MAAMC,OAA2B,GAAG;IAClCC,eAAe,EAAEF,KAAK,CAACG,KAAK,CAACC,mBAAmB;IAChDC,aAAa,EAAEL,KAAK,CAACG,KAAK,CAACG;EAC7B,CAAC;EACD,OAAAC,iBAAA,CACGT,kBAAkB,CAACU,QAAQ;IAACC,KAAK,EAAER,OAAO;IAAA,IAAAS,SAAA;MAAA,OACxCV,KAAK,CAACU,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}

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

@@ -0,0 +1,10 @@
+import { Children } from "@alloy-js/core/jsx-runtime";
+export interface Prose {
+    children: Children;
+}
+/**
+ * Create a block of text which will break once a word exceeds the configured line width.
+ * The children are expected to be strings, and a <br /> is added between each word.
+ */
+export declare function Prose(props: Prose): Children;
+//# sourceMappingURL=Prose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Prose.d.ts","sourceRoot":"","sources":["../../../src/components/Prose.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEtD,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,YAuBjC"}

package/dist/src/components/Prose.js

@@ -0,0 +1,23 @@
+import { createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { childrenArray, computed } from "@alloy-js/core";
+/**
+ * Create a block of text which will break once a word exceeds the configured line width.
+ * The children are expected to be strings, and a <br /> is added between each word.
+ */
+export function Prose(props) {
+  const brokenChildren = computed(() => {
+    const children = childrenArray(() => props.children);
+    return children.map(child => {
+      if (typeof child === "string") {
+        return child.trim().split(/\s+/).map(word => [word, _$createIntrinsic("br", {})]);
+      }
+      return child;
+    }).flat(2);
+  });
+  return _$createIntrinsic("fill", {
+    get children() {
+      return brokenChildren.value;
+    }
+  });
+}
+//# sourceMappingURL=Prose.js.map

package/dist/src/components/Prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prose.js","names":["childrenArray","computed","Prose","props","brokenChildren","children","map","child","trim","split","word","_$createIntrinsic","flat","value"],"sources":["../../../src/components/Prose.tsx"],"sourcesContent":[null],"mappings":";AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,gBAAgB;AAOxD;AACA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAACC,KAAY,EAAE;EAClC,MAAMC,cAAc,GAAGH,QAAQ,CAAC,MAAM;IACpC,MAAMI,QAAQ,GAAGL,aAAa,CAAC,MAAMG,KAAK,CAACE,QAAQ,CAAC;IACpD,OAAOA,QAAQ,CACZC,GAAG,CAAEC,KAAK,IAAK;MACd,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;QAC7B,OAAOA,KAAK,CACTC,IAAI,CAAC,CAAC,CACNC,KAAK,CAAC,KAAK,CAAC,CACZH,GAAG,CAAEI,IAAI,KAELA,IAAI,EAAAC,iBAAA,WAGR,CAAC;MACN;MAEA,OAAOJ,KAAK;IACd,CAAC,CAAC,CACDK,IAAI,CAAC,CAAC,CAAC;EACZ,CAAC,CAAC;EAEF,OAAAD,iBAAA;IAAA,IAAAN,SAAA;MAAA,OAAcD,cAAc,CAACS,KAAK;IAAA;EAAA;AACpC","ignoreList":[]}

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

@@ -1,10 +1,41 @@
 import { OutputScope } from "../binder.js";
 import { Children } from "../jsx-runtime.js";
-export interface ScopeProps {
+/**
+ * Declare a scope by providing an already created scope. The scope is merely
+ * exposed via {@link ScopeContext}.
+ */
+export interface ScopePropsWithValue {
+    /**
+     * The scope to use. If not provided, a new scope will be created.
+     */
+    value: OutputScope;
+    children?: Children;
+}
+/**
+ * Create a scope by providing a name and optional metadata.
+ */
+export interface ScopePropsWithInfo {
+    /**
+     * The kind of scope. This may be used by application code to determine how
+     * to handle symbols in this scope. It is not used by the core framework.
+     */
     kind?: string;
+    /**
+     * The name of this scope.
+     */
     name?: string;
-    value?: OutputScope;
+    /**
+     * Additional metadata for the scope.
+     */
+    metadata?: Record<string, unknown>;
     children?: Children;
 }
+export type ScopeProps = ScopePropsWithValue | ScopePropsWithInfo;
+/**
+ * Declare a scope for this component's children. Any symbols and scopes
+ * declared in the children of this component will be in this scope.
+ *
+ * @see {@link ScopeContext}
+ */
 export declare function Scope(props: ScopeProps): Children;
 //# sourceMappingURL=Scope.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Scope.d.ts","sourceRoot":"","sources":["../../../src/components/Scope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,YAetC"}
+{"version":3,"file":"Scope.d.ts","sourceRoot":"","sources":["../../../src/components/Scope.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,YAkBtC"}

package/dist/src/components/Scope.js

@@ -3,16 +3,32 @@ import { memo as _$memo } from "@alloy-js/core/jsx-runtime";
 import { useContext } from "../context.js";
 import { BinderContext } from "../context/binder.js";
 import { ScopeContext } from "../context/scope.js";
+
+/**
+ * Declare a scope by providing an already created scope. The scope is merely
+ * exposed via {@link ScopeContext}.
+ */
+
+/**
+ * Create a scope by providing a name and optional metadata.
+ */
+
+/**
+ * Declare a scope for this component's children. Any symbols and scopes
+ * declared in the children of this component will be in this scope.
+ *
+ * @see {@link ScopeContext}
+ */
 export function Scope(props) {
   let scope;
-  if (props.value) {
+  if ("value" in props) {
     scope = props.value;
   } else {
-    const kind = props.kind ?? "file";
     const binder = useContext(BinderContext);
     scope = binder.createScope({
-      kind,
-      name: props.name
+      kind: props.kind,
+      metadata: props.metadata,
+      name: props.name ?? ""
     });
   }
   return _$createComponent(ScopeContext.Provider, {

package/dist/src/components/Scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"Scope.js","names":["useContext","BinderContext","ScopeContext","Scope","props","scope","value","kind","binder","createScope","name","_$createComponent","Provider","children"],"sources":["../../../src/components/Scope.tsx"],"sourcesContent":[null],"mappings":";;AACA,SAASA,UAAU,QAAQ,eAAe;AAC1C,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,YAAY,QAAQ,qBAAqB;AAUlD,OAAO,SAASC,KAAKA,CAACC,KAAiB,EAAE;EACvC,IAAIC,KAAkB;EACtB,IAAID,KAAK,CAACE,KAAK,EAAE;IACfD,KAAK,GAAGD,KAAK,CAACE,KAAK;EACrB,CAAC,MAAM;IACL,MAAMC,IAAI,GAAGH,KAAK,CAACG,IAAI,IAAI,MAAM;IACjC,MAAMC,MAAM,GAAGR,UAAU,CAACC,aAAa,CAAE;IACzCI,KAAK,GAAGG,MAAM,CAACC,WAAW,CAAC;MAAEF,IAAI;MAAEG,IAAI,EAAEN,KAAK,CAACM;IAAM,CAAC,CAAC;EACzD;EAEA,OAAAC,iBAAA,CACGT,YAAY,CAACU,QAAQ;IAACN,KAAK,EAAED,KAAK;IAAA,IAAAQ,SAAA;MAAA,OAChCT,KAAK,CAACS,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}
+{"version":3,"file":"Scope.js","names":["useContext","BinderContext","ScopeContext","Scope","props","scope","value","binder","createScope","kind","metadata","name","_$createComponent","Provider","children"],"sources":["../../../src/components/Scope.tsx"],"sourcesContent":[null],"mappings":";;AACA,SAASA,UAAU,QAAQ,eAAe;AAC1C,SAASC,aAAa,QAAQ,sBAAsB;AACpD,SAASC,YAAY,QAAQ,qBAAqB;;AAGlD;AACA;AACA;AACA;;AAUA;AACA;AACA;;AAuBA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,KAAKA,CAACC,KAAiB,EAAE;EACvC,IAAIC,KAAkB;EACtB,IAAI,OAAO,IAAID,KAAK,EAAE;IACpBC,KAAK,GAAGD,KAAK,CAACE,KAAK;EACrB,CAAC,MAAM;IACL,MAAMC,MAAM,GAAGP,UAAU,CAACC,aAAa,CAAE;IACzCI,KAAK,GAAGE,MAAM,CAACC,WAAW,CAAC;MACzBC,IAAI,EAAEL,KAAK,CAACK,IAAI;MAChBC,QAAQ,EAAEN,KAAK,CAACM,QAAQ;MACxBC,IAAI,EAAEP,KAAK,CAACO,IAAI,IAAI;IACtB,CAAC,CAAC;EACJ;EAEA,OAAAC,iBAAA,CACGV,YAAY,CAACW,QAAQ;IAACP,KAAK,EAAED,KAAK;IAAA,IAAAS,SAAA;MAAA,OAChCV,KAAK,CAACU,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}

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

@@ -18,6 +18,11 @@ export interface SourceFileProps extends PrintTreeOptions {
     reference?: ComponentDefinition<{
         refkey: Refkey;
     }>;
+    /**
+     * The header of the file. This is rendered before the contents of the file.
+     * This is useful for adding license headers or other metadata to the file.
+     */
+    header?: Children;
 }
 export declare function SourceFile(props: SourceFileProps): Children;
 //# sourceMappingURL=SourceFile.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SourceFile.d.ts","sourceRoot":"","sources":["../../../src/components/SourceFile.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAc,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,YAsBhD"}
+{"version":3,"file":"SourceFile.d.ts","sourceRoot":"","sources":["../../../src/components/SourceFile.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAc,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IACvD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,YA0BhD"}

package/dist/src/components/SourceFile.js

@@ -1,10 +1,12 @@
 import { createComponent as _$createComponent } from "@alloy-js/core/jsx-runtime";
+import { createIntrinsic as _$createIntrinsic } from "@alloy-js/core/jsx-runtime";
 import { memo as _$memo } from "@alloy-js/core/jsx-runtime";
 import { join } from "pathe";
 import { useContext } from "../context.js";
 import { SourceDirectoryContext } from "../context/source-directory.js";
 import { SourceFileContext } from "../context/source-file.js";
 import { getContext } from "../jsx-runtime.js";
+import { Show } from "./Show.js";
 export function SourceFile(props) {
   const parentDirectory = useContext(SourceDirectoryContext);
   const context = {
@@ -24,7 +26,14 @@ export function SourceFile(props) {
   return _$createComponent(SourceFileContext.Provider, {
     value: context,
     get children() {
-      return props.children;
+      return [_$createComponent(Show, {
+        get when() {
+          return props.header !== undefined;
+        },
+        get children() {
+          return [_$memo(() => props.header), _$createIntrinsic("hbr", {})];
+        }
+      }), _$memo(() => props.children)];
     }
   });
 }

package/dist/src/components/SourceFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"SourceFile.js","names":["join","useContext","SourceDirectoryContext","SourceFileContext","getContext","SourceFile","props","parentDirectory","context","path","filetype","reference","addContent","nodeContext","meta","sourceFile","printOptions","printWidth","tabWidth","useTabs","_$createComponent","Provider","value","children"],"sources":["../../../src/components/SourceFile.tsx"],"sourcesContent":[null],"mappings":";;AAAA,SAASA,IAAI,QAAQ,OAAO;AAC5B,SAASC,UAAU,QAAQ,eAAe;AAC1C,SAASC,sBAAsB,QAAQ,gCAAgC;AACvE,SAASC,iBAAiB,QAAQ,2BAA2B;AAC7D,SAAwCC,UAAU,QAAQ,mBAAmB;AAwB7E,OAAO,SAASC,UAAUA,CAACC,KAAsB,EAAE;EACjD,MAAMC,eAAe,GAAGN,UAAU,CAACC,sBAAsB,CAAE;EAC3D,MAAMM,OAA0B,GAAG;IACjCC,IAAI,EAAET,IAAI,CAACO,eAAe,GAAGA,eAAe,CAACE,IAAI,GAAG,EAAE,EAAEH,KAAK,CAACG,IAAI,CAAC;IACnEC,QAAQ,EAAEJ,KAAK,CAACI,QAAQ;IACxBC,SAAS,EAAEL,KAAK,CAACK;EACnB,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,UAAU,GAAGP,OAAO;EACrCK,WAAW,CAACC,IAAI,CAACE,YAAY,GAAG;IAC9BC,UAAU,EAAEX,KAAK,CAACW,UAAU;IAC5BC,QAAQ,EAAEZ,KAAK,CAACY,QAAQ;IACxBC,OAAO,EAAEb,KAAK,CAACa;EACjB,CAAC;EAED,OAAAC,iBAAA,CACGjB,iBAAiB,CAACkB,QAAQ;IAACC,KAAK,EAAEd,OAAO;IAAA,IAAAe,SAAA;MAAA,OACvCjB,KAAK,CAACiB,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}
+{"version":3,"file":"SourceFile.js","names":["join","useContext","SourceDirectoryContext","SourceFileContext","getContext","Show","SourceFile","props","parentDirectory","context","path","filetype","reference","addContent","nodeContext","meta","sourceFile","printOptions","printWidth","tabWidth","useTabs","_$createComponent","Provider","value","children","when","header","undefined","_$memo","_$createIntrinsic"],"sources":["../../../src/components/SourceFile.tsx"],"sourcesContent":[null],"mappings":";;;AAAA,SAASA,IAAI,QAAQ,OAAO;AAC5B,SAASC,UAAU,QAAQ,eAAe;AAC1C,SAASC,sBAAsB,QAAQ,gCAAgC;AACvE,SAASC,iBAAiB,QAAQ,2BAA2B;AAC7D,SAAwCC,UAAU,QAAQ,mBAAmB;AAG7E,SAASC,IAAI;AA2Bb,OAAO,SAASC,UAAUA,CAACC,KAAsB,EAAE;EACjD,MAAMC,eAAe,GAAGP,UAAU,CAACC,sBAAsB,CAAE;EAC3D,MAAMO,OAA0B,GAAG;IACjCC,IAAI,EAAEV,IAAI,CAACQ,eAAe,GAAGA,eAAe,CAACE,IAAI,GAAG,EAAE,EAAEH,KAAK,CAACG,IAAI,CAAC;IACnEC,QAAQ,EAAEJ,KAAK,CAACI,QAAQ;IACxBC,SAAS,EAAEL,KAAK,CAACK;EACnB,CAAC;EACDJ,eAAe,EAAEK,UAAU,CAACJ,OAAO,CAAC;EACpC,MAAMK,WAAW,GAAGV,UAAU,CAAC,CAAE;EACjCU,WAAW,CAACC,IAAI,KAAK,CAAC,CAAC;EACvBD,WAAW,CAACC,IAAI,CAACC,UAAU,GAAGP,OAAO;EACrCK,WAAW,CAACC,IAAI,CAACE,YAAY,GAAG;IAC9BC,UAAU,EAAEX,KAAK,CAACW,UAAU;IAC5BC,QAAQ,EAAEZ,KAAK,CAACY,QAAQ;IACxBC,OAAO,EAAEb,KAAK,CAACa;EACjB,CAAC;EAED,OAAAC,iBAAA,CACGlB,iBAAiB,CAACmB,QAAQ;IAACC,KAAK,EAAEd,OAAO;IAAA,IAAAe,SAAA;MAAA,QAAAH,iBAAA,CACvChB,IAAI;QAAA,IAACoB,IAAIA,CAAA;UAAA,OAAElB,KAAK,CAACmB,MAAM,KAAKC,SAAS;QAAA;QAAA,IAAAH,SAAA;UAAA,QAAAI,MAAA,OACnCrB,KAAK,CAACmB,MAAM,GAAAG,iBAAA;QAAA;MAAA,IAAAD,MAAA,OAGdrB,KAAK,CAACiB,QAAQ;IAAA;EAAA;AAGrB","ignoreList":[]}

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

@@ -8,6 +8,7 @@ export * from "./MemberName.jsx";
 export * from "./MemberScope.jsx";
 export * from "./Name.jsx";
 export * from "./Output.js";
+export * from "./Prose.jsx";
 export * from "./Scope.js";
 export * from "./Show.jsx";
 export * from "./SourceDirectory.js";

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,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,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,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"}

package/dist/src/components/index.js

@@ -8,6 +8,7 @@ export * from "./MemberName.js";
 export * from "./MemberScope.js";
 export * from "./Name.js";
 export * from "./Output.js";
+export * from "./Prose.js";
 export * from "./Scope.js";
 export * from "./Show.js";
 export * from "./SourceDirectory.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/index.tsx"],"sourcesContent":[null],"mappings":"AAAA,cAAc,YAAY;AAC1B,cAAc,kBAAkB;AAChC,cAAc,UAAU;AACxB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B,cAAc,YAAY;AAC1B;AACA,cAAc,sBAAsB;AACpC,cAAc,iBAAiB;AAC/B;AACA;AACA","ignoreList":[]}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/components/index.tsx"],"sourcesContent":[null],"mappings":"AAAA,cAAc,YAAY;AAC1B,cAAc,kBAAkB;AAChC,cAAc,UAAU;AACxB;AACA;AACA;AACA;AACA;AACA;AACA,cAAc,aAAa;AAC3B;AACA,cAAc,YAAY;AAC1B;AACA,cAAc,sBAAsB;AACpC,cAAc,iBAAiB;AAC/B;AACA;AACA","ignoreList":[]}