@powerlines/plugin-alloy 0.26.51 → 0.26.52

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;

package/dist/core/components/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./source-file.cjs`),t=require(`./infrastructure-file.cjs`),n=require(`./output.cjs`),r=require(`./single-line-comment.cjs`),i=require(`./spacing.cjs`);exports.InfrastructureFile=t.InfrastructureFile,exports.Output=n.Output,exports.SingleLineComment=r.SingleLineComment,exports.SourceFile=e.SourceFile,exports.Spacing=i.Spacing;

package/dist/core/components/index.d.cts

@@ -0,0 +1,6 @@
+import { SourceFile, SourceFileProps } from "./source-file.cjs";
+import { InfrastructureFile, InfrastructureFileProps } from "./infrastructure-file.cjs";
+import { Output, OutputProps } from "./output.cjs";
+import { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant } from "./single-line-comment.cjs";
+import { Spacing, SpacingProps } from "./spacing.cjs";
+export { InfrastructureFile, InfrastructureFileProps, Output, OutputProps, SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, SourceFile, SourceFileProps, Spacing, SpacingProps };

package/dist/core/components/index.d.mts

@@ -0,0 +1,6 @@
+import { SourceFile, SourceFileProps } from "./source-file.mjs";
+import { InfrastructureFile, InfrastructureFileProps } from "./infrastructure-file.mjs";
+import { Output, OutputProps } from "./output.mjs";
+import { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant } from "./single-line-comment.mjs";
+import { Spacing, SpacingProps } from "./spacing.mjs";
+export { InfrastructureFile, InfrastructureFileProps, Output, OutputProps, SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant, SourceFile, SourceFileProps, Spacing, SpacingProps };

package/dist/core/components/index.mjs

@@ -0,0 +1 @@
+import{SourceFile as e}from"./source-file.mjs";import{InfrastructureFile as t}from"./infrastructure-file.mjs";import{Output as n}from"./output.mjs";import{SingleLineComment as r}from"./single-line-comment.mjs";import{Spacing as i}from"./spacing.mjs";export{t as InfrastructureFile,n as Output,r as SingleLineComment,e as SourceFile,i as Spacing};

package/dist/core/components/infrastructure-file.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../_virtual/_rolldown/runtime.cjs`),t=require(`../contexts/context.cjs`),n=require(`./source-file.cjs`);let r=require(`@stryke/path/file-path-fns`),i=require(`@alloy-js/core/jsx-runtime`),a=require(`@alloy-js/core`),o=require(`@stryke/path/append`),s=require(`@stryke/path/replace`),c=require(`defu`);c=e.__toESM(c);function l(e){let[{children:l,meta:u,id:d,extension:f,filetype:p},m]=(0,a.splitProps)(e,[`children`,`meta`,`id`,`extension`,`filetype`]),h=t.usePowerlinesSafe(),g=(0,a.computed)(()=>p||f?.replace(/^\.*/,``)||((0,r.hasFileExtension)(d)?(0,r.findFileExtensionSafe)(d):``)),_=(0,a.computed)(()=>(0,o.appendExtension)((0,s.replaceExtension)(h?(0,o.appendPath)(d,(0,s.replacePath)(h.infrastructurePath,h.config.cwd)):d),g.value));return(0,i.createComponent)(n.SourceFile,(0,i.mergeProps)(m,{get filetype(){return g.value},get path(){return _.value},get meta(){return(0,c.default)({kind:`infrastructure`},u??{})},children:l}))}exports.InfrastructureFile=l;

package/dist/core/components/infrastructure-file.d.cts

@@ -0,0 +1,27 @@
+import { SourceFileProps as SourceFileProps$1 } from "./source-file.cjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/infrastructure-file.d.ts
+type InfrastructureFileProps = Omit<SourceFileProps$1, "path"> & {
+  /**
+   * The infrastructure module identifier.
+   */
+  id: string;
+  /**
+   * The extension for the infrastructure file. This is used to determine the file extension if the `id` does not already include one.
+   *
+   * @remarks
+   * If none is provided, the file extension will be determined by the {@link SourceFileProps.filetype | filetype} property.
+   */
+  extension?: string;
+};
+/**
+ * A base component representing a Powerlines generated infrastructure file.
+ *
+ * @param props - The properties for the infrastructure file.
+ * @returns The rendered infrastructure file component.
+ */
+declare function InfrastructureFile(props: InfrastructureFileProps): _$_alloy_js_core0.Children;
+//#endregion
+export { InfrastructureFile, InfrastructureFileProps };
+//# sourceMappingURL=infrastructure-file.d.cts.map

package/dist/core/components/infrastructure-file.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-file.d.cts","names":[],"sources":["../../../src/core/components/infrastructure-file.tsx"],"mappings":";;;;KA6BY,uBAAA,GAA0B,IAAA,CAAK,iBAAA;;;AAA3C;EAIE,EAAA;;;;;;;EAQA,SAAA;AAAA;AASF;;;;;;AAAA,iBAAgB,kBAAA,CAAmB,KAAA,EAAO,uBAAA,GAAuB,iBAAA,CAAA,QAAA"}

package/dist/core/components/infrastructure-file.d.mts

@@ -0,0 +1,27 @@
+import { SourceFileProps as SourceFileProps$1 } from "./source-file.mjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/infrastructure-file.d.ts
+type InfrastructureFileProps = Omit<SourceFileProps$1, "path"> & {
+  /**
+   * The infrastructure module identifier.
+   */
+  id: string;
+  /**
+   * The extension for the infrastructure file. This is used to determine the file extension if the `id` does not already include one.
+   *
+   * @remarks
+   * If none is provided, the file extension will be determined by the {@link SourceFileProps.filetype | filetype} property.
+   */
+  extension?: string;
+};
+/**
+ * A base component representing a Powerlines generated infrastructure file.
+ *
+ * @param props - The properties for the infrastructure file.
+ * @returns The rendered infrastructure file component.
+ */
+declare function InfrastructureFile(props: InfrastructureFileProps): _$_alloy_js_core0.Children;
+//#endregion
+export { InfrastructureFile, InfrastructureFileProps };
+//# sourceMappingURL=infrastructure-file.d.mts.map

package/dist/core/components/infrastructure-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-file.d.mts","names":[],"sources":["../../../src/core/components/infrastructure-file.tsx"],"mappings":";;;;KA6BY,uBAAA,GAA0B,IAAA,CAAK,iBAAA;;;AAA3C;EAIE,EAAA;;;;;;;EAQA,SAAA;AAAA;AASF;;;;;;AAAA,iBAAgB,kBAAA,CAAmB,KAAA,EAAO,uBAAA,GAAuB,iBAAA,CAAA,QAAA"}

package/dist/core/components/infrastructure-file.mjs

@@ -0,0 +1,2 @@
+import{usePowerlinesSafe as e}from"../contexts/context.mjs";import{SourceFile as t}from"./source-file.mjs";import{findFileExtensionSafe as n,hasFileExtension as r}from"@stryke/path/file-path-fns";import{createComponent as i,mergeProps as a}from"@alloy-js/core/jsx-runtime";import{computed as o,splitProps as s}from"@alloy-js/core";import{appendExtension as c,appendPath as l}from"@stryke/path/append";import{replaceExtension as u,replacePath as d}from"@stryke/path/replace";import f from"defu";function p(p){let[{children:m,meta:h,id:g,extension:_,filetype:v},y]=s(p,[`children`,`meta`,`id`,`extension`,`filetype`]),b=e(),x=o(()=>v||_?.replace(/^\.*/,``)||(r(g)?n(g):``)),S=o(()=>c(u(b?l(g,d(b.infrastructurePath,b.config.cwd)):g),x.value));return i(t,a(y,{get filetype(){return x.value},get path(){return S.value},get meta(){return f({kind:`infrastructure`},h??{})},children:m}))}export{p as InfrastructureFile};
+//# sourceMappingURL=infrastructure-file.mjs.map

package/dist/core/components/infrastructure-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"infrastructure-file.mjs","names":[],"sources":["../../../src/core/components/infrastructure-file.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { computed, splitProps } from \"@alloy-js/core\";\nimport { appendExtension, appendPath } from \"@stryke/path/append\";\nimport {\n  findFileExtensionSafe,\n  hasFileExtension\n} from \"@stryke/path/file-path-fns\";\nimport { replaceExtension, replacePath } from \"@stryke/path/replace\";\nimport defu from \"defu\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport { SourceFile, SourceFileProps } from \"./source-file\";\n\nexport type InfrastructureFileProps = Omit<SourceFileProps, \"path\"> & {\n  /**\n   * The infrastructure module identifier.\n   */\n  id: string;\n\n  /**\n   * The extension for the infrastructure file. This is used to determine the file extension if the `id` does not already include one.\n   *\n   * @remarks\n   * If none is provided, the file extension will be determined by the {@link SourceFileProps.filetype | filetype} property.\n   */\n  extension?: string;\n};\n\n/**\n * A base component representing a Powerlines generated infrastructure file.\n *\n * @param props - The properties for the infrastructure file.\n * @returns The rendered infrastructure file component.\n */\nexport function InfrastructureFile(props: InfrastructureFileProps) {\n  const [{ children, meta, id, extension, filetype: _filetype }, rest] =\n    splitProps(props, [\"children\", \"meta\", \"id\", \"extension\", \"filetype\"]);\n\n  const context = usePowerlinesSafe();\n  const filetype = computed(\n    () =>\n      _filetype ||\n      extension?.replace(/^\\.*/, \"\") ||\n      (hasFileExtension(id) ? findFileExtensionSafe(id) : \"\")\n  );\n  const path = computed(() => {\n    const value = context\n      ? appendPath(\n          id,\n          replacePath(context.infrastructurePath, context.config.cwd)\n        )\n      : id;\n\n    return appendExtension(replaceExtension(value), filetype.value);\n  });\n\n  return (\n    <SourceFile\n      {...rest}\n      filetype={filetype.value}\n      path={path.value}\n      meta={defu(\n        {\n          kind: \"infrastructure\"\n        },\n        meta ?? {}\n      )}>\n      {children}\n    </SourceFile>\n  );\n}\n"],"mappings":"8eAgCA,SAAI,EAAA,EAAA,CACF,GAAI,CAAA,CAAA,WAEF,OACA,KACD,YACC,SAAE,GACD,GAAQ,EAAW,EAAM,CAAA,WAAc,OAAQ,KAAC,YAAkB,WAAO,CAAA,CAC1E,EAAA,GAAA,CACF,EAAY,MAAM,GAAA,GAAA,QAAA,OAAA,GAAA,GAAA,EAAA,EAAA,CAAA,EAAA,EAAA,CAAA,IAAA,CACnB,EAAA,MAEC,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,mBAAA,EAAA,OAAA,IAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,CACE,CACH,OAAA,EAAA,EAAA,EAAA,EAAA,CACG,IAAA,UAAc,CACd,OAAQ,EAAI,OAEhB,IAAO,MAAQ,CACb,OAAS,EAAA,kBAGT,OAAM,EAAU,CACV,KAAA,iBACD,CAAC,GAAA,EAAA,CAAA,EAEF,WACH,CAAC,CAAC"}

package/dist/core/components/output.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);const e=require(`../contexts/context.cjs`),t=require(`../contexts/meta.cjs`);require(`../contexts/index.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`);function i(i){let[{children:a,context:o,meta:s={}},c]=(0,r.splitProps)(i,[`children`,`context`,`meta`]),l=(0,r.computed)(()=>o);return(0,n.createComponent)(t.MetaContext.Provider,{value:s,get children(){return(0,n.createComponent)(e.PowerlinesContext.Provider,{get value(){return l.value},get children(){return(0,n.createComponent)(r.Output,(0,n.mergeProps)(c,{get basePath(){return l.value.config.cwd},children:a}))}})}})}exports.Output=i;

package/dist/core/components/output.d.cts

@@ -0,0 +1,23 @@
+import { MetaItem } from "../contexts/meta.cjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import { PluginContext } from "@powerlines/core";
+
+//#region src/core/components/output.d.ts
+interface OutputProps<TContext extends PluginContext = PluginContext> extends Omit<OutputProps$1, "basePath"> {
+  /**
+   * The current Powerlines process context.
+   */
+  context: TContext;
+  /**
+   * The file metadata collected during rendering.
+   */
+  meta?: Record<string, MetaItem>;
+}
+/**
+ * Output component for rendering the Powerlines plugin's output files via templates.
+ */
+declare function Output<TContext extends PluginContext = PluginContext>(props: OutputProps<TContext>): _$_alloy_js_core0.Children;
+//#endregion
+export { Output, OutputProps };
+//# sourceMappingURL=output.d.cts.map

package/dist/core/components/output.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.cts","names":[],"sources":["../../../src/core/components/output.tsx"],"mappings":";;;;;;UAwBiB,WAAA,kBACE,aAAA,GAAgB,aAAA,UACzB,IAAA,CAAK,aAAA;;;;EAIb,OAAA,EAAS,QAAA;EANiB;;;EAW1B,IAAA,GAAO,MAAA,SAAe,QAAA;AAAA;;;;iBAMR,MAAA,kBAAwB,aAAA,GAAgB,aAAA,CAAA,CACtD,KAAA,EAAO,WAAA,CAAY,QAAA,IAAD,iBAAA,CAAU,QAAA"}

package/dist/core/components/output.d.mts

@@ -0,0 +1,23 @@
+import { MetaItem } from "../contexts/meta.mjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+import { OutputProps as OutputProps$1 } from "@alloy-js/core";
+import { PluginContext } from "@powerlines/core";
+
+//#region src/core/components/output.d.ts
+interface OutputProps<TContext extends PluginContext = PluginContext> extends Omit<OutputProps$1, "basePath"> {
+  /**
+   * The current Powerlines process context.
+   */
+  context: TContext;
+  /**
+   * The file metadata collected during rendering.
+   */
+  meta?: Record<string, MetaItem>;
+}
+/**
+ * Output component for rendering the Powerlines plugin's output files via templates.
+ */
+declare function Output<TContext extends PluginContext = PluginContext>(props: OutputProps<TContext>): _$_alloy_js_core0.Children;
+//#endregion
+export { Output, OutputProps };
+//# sourceMappingURL=output.d.mts.map

package/dist/core/components/output.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.mts","names":[],"sources":["../../../src/core/components/output.tsx"],"mappings":";;;;;;UAwBiB,WAAA,kBACE,aAAA,GAAgB,aAAA,UACzB,IAAA,CAAK,aAAA;;;;EAIb,OAAA,EAAS,QAAA;EANiB;;;EAW1B,IAAA,GAAO,MAAA,SAAe,QAAA;AAAA;;;;iBAMR,MAAA,kBAAwB,aAAA,GAAgB,aAAA,CAAA,CACtD,KAAA,EAAO,WAAA,CAAY,QAAA,IAAD,iBAAA,CAAU,QAAA"}

package/dist/core/components/output.mjs

@@ -0,0 +1,2 @@
+import{PowerlinesContext as e}from"../contexts/context.mjs";import{MetaContext as t}from"../contexts/meta.mjs";import"../contexts/index.mjs";import{createComponent as n,mergeProps as r}from"@alloy-js/core/jsx-runtime";import{Output as i,computed as a,splitProps as o}from"@alloy-js/core";function s(s){let[{children:c,context:l,meta:u={}},d]=o(s,[`children`,`context`,`meta`]),f=a(()=>l);return n(t.Provider,{value:u,get children(){return n(e.Provider,{get value(){return f.value},get children(){return n(i,r(d,{get basePath(){return f.value.config.cwd},children:c}))}})}})}export{s as Output};
+//# sourceMappingURL=output.mjs.map

package/dist/core/components/output.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.mjs","names":[],"sources":["../../../src/core/components/output.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { OutputProps as OutputPropsExternal } from \"@alloy-js/core\";\nimport { computed, Output as OutputExternal, splitProps } from \"@alloy-js/core\";\nimport type { PluginContext } from \"@powerlines/core\";\nimport { MetaContext, MetaItem } from \"../contexts\";\nimport { PowerlinesContext } from \"../contexts/context\";\n\nexport interface OutputProps<\n  TContext extends PluginContext = PluginContext\n> extends Omit<OutputPropsExternal, \"basePath\"> {\n  /**\n   * The current Powerlines process context.\n   */\n  context: TContext;\n\n  /**\n   * The file metadata collected during rendering.\n   */\n  meta?: Record<string, MetaItem>;\n}\n\n/**\n * Output component for rendering the Powerlines plugin's output files via templates.\n */\nexport function Output<TContext extends PluginContext = PluginContext>(\n  props: OutputProps<TContext>\n) {\n  const [{ children, context, meta = {} }, rest] = splitProps(props, [\n    \"children\",\n    \"context\",\n    \"meta\"\n  ]);\n\n  const contextRef = computed(() => context);\n\n  return (\n    <MetaContext.Provider value={meta}>\n      <PowerlinesContext.Provider value={contextRef.value}>\n        <OutputExternal {...rest} basePath={contextRef.value.config.cwd}>\n          {children}\n        </OutputExternal>\n      </PowerlinesContext.Provider>\n    </MetaContext.Provider>\n  );\n}\n"],"mappings":"gSAyBA,SAAW,EAAQ,EAAA,CACjB,GAAA,CAAO,CACL,WACA,UACA,OAAA,EAAA,EACF,GAAS,EAAQ,EAAA,CAAA,WAAA,UAAA,OAAA,CAAA,YAEjB,OAAE,EAAA,EAAA,SAAA,CACA,MAAK,EACL,IAAA,UAAA,CACE,OAAG,EAAe,EAAS,SAAA,CACjC,IAAA,OAAA,iBAGG,IAAO,UAAa,CACrB,OAAA,EAAA,EAAA,EAAA,EAAA,CACK,IAAS,UAAO,CACd,OAAY,EAAQ,MAAA,OAAA,KAER,WAChB,CAAA,CAAQ,EAER,CAAA"}

package/dist/core/components/single-line-comment.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core/jsx-runtime`),t=require(`@alloy-js/core`);function n(n){let{variant:r=`double-slash`,children:i}=n,a=r===`slash-star`?`/* `:r===`slash-star-star`?`/** `:r===`triple-slash`?`/// `:r===`markdown`?`<!-- `:r===`yaml`||r===`hcl`?`# `:`// `;return[a,(0,e.createIntrinsic)(`align`,{string:a,get children(){return[(0,e.createComponent)(t.Prose,{children:i}),r===`slash-star`||r===`slash-star-star`?` */ `:r===`markdown`?` -->`:``]}})]}exports.SingleLineComment=n;

package/dist/core/components/single-line-comment.d.cts

@@ -0,0 +1,21 @@
+import { ComponentProps } from "../../types/components.cjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/single-line-comment.d.ts
+type SingleLineCommentVariant = "double-slash" | "triple-slash" | "slash-star" | "slash-star-star" | "markdown" | "yaml" | "hcl";
+interface SingleLineCommentProps extends ComponentProps {
+  /**
+   * The variant of the single line comment.
+   *
+   * @defaultValue "double-slash"
+   */
+  variant?: SingleLineCommentVariant;
+}
+/**
+ * A single line comment block. The children are rendered as a prose element, which means that they
+ * are broken into multiple lines
+ */
+declare function SingleLineComment(props: SingleLineCommentProps): _$_alloy_js_core0.Children;
+//#endregion
+export { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant };
+//# sourceMappingURL=single-line-comment.d.cts.map

package/dist/core/components/single-line-comment.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-line-comment.d.cts","names":[],"sources":["../../../src/core/components/single-line-comment.tsx"],"mappings":";;;;KAqBY,wBAAA;AAAA,UASK,sBAAA,SAA+B,cAAA;;AAThD;;;;EAeE,OAAA,GAAU,wBAAA;AAAA;;;;;iBAOI,iBAAA,CAAkB,KAAA,EAAO,sBAAA,GAAsB,iBAAA,CAAA,QAAA"}

package/dist/core/components/single-line-comment.d.mts

@@ -0,0 +1,21 @@
+import { ComponentProps } from "../../types/components.mjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/single-line-comment.d.ts
+type SingleLineCommentVariant = "double-slash" | "triple-slash" | "slash-star" | "slash-star-star" | "markdown" | "yaml" | "hcl";
+interface SingleLineCommentProps extends ComponentProps {
+  /**
+   * The variant of the single line comment.
+   *
+   * @defaultValue "double-slash"
+   */
+  variant?: SingleLineCommentVariant;
+}
+/**
+ * A single line comment block. The children are rendered as a prose element, which means that they
+ * are broken into multiple lines
+ */
+declare function SingleLineComment(props: SingleLineCommentProps): _$_alloy_js_core0.Children;
+//#endregion
+export { SingleLineComment, SingleLineCommentProps, SingleLineCommentVariant };
+//# sourceMappingURL=single-line-comment.d.mts.map

package/dist/core/components/single-line-comment.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-line-comment.d.mts","names":[],"sources":["../../../src/core/components/single-line-comment.tsx"],"mappings":";;;;KAqBY,wBAAA;AAAA,UASK,sBAAA,SAA+B,cAAA;;AAThD;;;;EAeE,OAAA,GAAU,wBAAA;AAAA;;;;;iBAOI,iBAAA,CAAkB,KAAA,EAAO,sBAAA,GAAsB,iBAAA,CAAA,QAAA"}

package/dist/core/components/single-line-comment.mjs

@@ -0,0 +1,2 @@
+import{createComponent as e,createIntrinsic as t}from"@alloy-js/core/jsx-runtime";import{Prose as n}from"@alloy-js/core";function r(r){let{variant:i=`double-slash`,children:a}=r,o=i===`slash-star`?`/* `:i===`slash-star-star`?`/** `:i===`triple-slash`?`/// `:i===`markdown`?`<!-- `:i===`yaml`||i===`hcl`?`# `:`// `;return[o,t(`align`,{string:o,get children(){return[e(n,{children:a}),i===`slash-star`||i===`slash-star-star`?` */ `:i===`markdown`?` -->`:``]}})]}export{r as SingleLineComment};
+//# sourceMappingURL=single-line-comment.mjs.map

package/dist/core/components/single-line-comment.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-line-comment.mjs","names":[],"sources":["../../../src/core/components/single-line-comment.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Prose } from \"@alloy-js/core\";\nimport { ComponentProps } from \"../../types/components\";\n\nexport type SingleLineCommentVariant =\n  | \"double-slash\"\n  | \"triple-slash\"\n  | \"slash-star\"\n  | \"slash-star-star\"\n  | \"markdown\"\n  | \"yaml\"\n  | \"hcl\";\n\nexport interface SingleLineCommentProps extends ComponentProps {\n  /**\n   * The variant of the single line comment.\n   *\n   * @defaultValue \"double-slash\"\n   */\n  variant?: SingleLineCommentVariant;\n}\n\n/**\n * A single line comment block. The children are rendered as a prose element, which means that they\n * are broken into multiple lines\n */\nexport function SingleLineComment(props: SingleLineCommentProps) {\n  const { variant = \"double-slash\", children } = props;\n\n  const commentStart =\n    variant === \"slash-star\"\n      ? \"/* \"\n      : variant === \"slash-star-star\"\n        ? \"/** \"\n        : variant === \"triple-slash\"\n          ? \"/// \"\n          : variant === \"markdown\"\n            ? \"<!-- \"\n            : variant === \"yaml\" || variant === \"hcl\"\n              ? \"# \"\n              : \"// \";\n\n  return (\n    <>\n      {commentStart}\n      <align string={commentStart}>\n        <Prose>{children}</Prose>\n\n        {variant === \"slash-star\" || variant === \"slash-star-star\"\n          ? \" */ \"\n          : variant === \"markdown\"\n            ? \" -->\"\n            : \"\"}\n      </align>\n    </>\n  );\n}\n"],"mappings":"yHAyBA,SAAgB,EAAI,EAAA,CAClB,GAAG,CACD,UAAK,eACL,YAAA,EAEG,EAAU,IAAA,aAA+B,MAAA,IAAe,kBAAA,OAAA,IAAA,eAAA,OAAA,IAAA,WAAA,QAAA,IAAA,QAAA,IAAA,MAAA,KAAA,MAC7D,MAAE,CAAA,EAAA,EAAA,QAAA,CACA,OAAK,EACN,IAAA,UAAA,CACG,MAAA,CAAA,EAA0B,EAAA,CAC5B,WACF,CAAA,CAAQ,IAAE,cAAwB,IAAA,kBAAA,OAAA,IAAA,WAAA,OAAA,GAAA"}

package/dist/core/components/source-file.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`../../_virtual/_rolldown/runtime.cjs`),t=require(`../contexts/meta.cjs`);let n=require(`@alloy-js/core/jsx-runtime`),r=require(`@alloy-js/core`),i=require(`@stryke/path/append`),a=require(`defu`);a=e.__toESM(a);function o(e){let[{children:o,meta:s,path:c,header:l,storage:u,filetype:d,reference:f}]=(0,r.splitProps)(e,[`children`,`meta`,`path`,`header`,`storage`,`filetype`,`reference`]),p=t.useMeta(),m=(0,r.useContext)(r.SourceDirectoryContext),h={path:(0,i.appendPath)(c,m.path),filetype:d,reference:f};m?.addContent(h);let g=(0,r.useFormatOptions)({printWidth:e.printWidth,tabWidth:e.tabWidth,useTabs:e.useTabs,insertFinalNewLine:e.insertFinalNewLine}),_=(0,r.getContext)();return _.meta=(0,a.default)({sourceFile:h,printOptions:g},s??{}),p&&(p[h.path]={storage:u,...s??{}}),(0,n.createComponent)(r.SourceFileContext.Provider,{value:h,get children(){return[(0,n.createComponent)(r.Show,{when:l!==void 0,get children(){return[l,(0,n.createIntrinsic)(`hbr`,{})]}}),o]}})}exports.SourceFile=o;

package/dist/core/components/source-file.d.cts

@@ -0,0 +1,32 @@
+import { ComponentProps } from "../../types/components.cjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
+import { StoragePreset } from "powerlines";
+
+//#region src/core/components/source-file.d.ts
+type SourceFileProps = SourceFileProps$1 & ComponentProps & {
+  /**
+   * The storage preset for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset;
+  /**
+   * The metadata associated with the source file.
+   *
+   * @remarks
+   * The values stored in the metadata will be available in the rendering context.
+   */
+  meta?: Record<string, any>;
+};
+/**
+ * A base component representing a Powerlines generated source file.
+ *
+ * @param props - The properties for the source file.
+ * @returns The rendered source file component.
+ */
+declare function SourceFile(props: SourceFileProps): _$_alloy_js_core0.Children;
+//#endregion
+export { SourceFile, SourceFileProps };
+//# sourceMappingURL=source-file.d.cts.map

package/dist/core/components/source-file.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.d.cts","names":[],"sources":["../../../src/core/components/source-file.tsx"],"mappings":";;;;;;KAkCY,eAAA,GAAkB,iBAAA,GAC5B,cAAA;;;AADF;;;;EAQI,OAAA,GAAU,aAAA;EAAA;;;;;;EAQV,IAAA,GAAO,MAAA;AAAA;;;;;AASX;;iBAAgB,UAAA,CAAW,KAAA,EAAO,eAAA,GAAe,iBAAA,CAAA,QAAA"}

package/dist/core/components/source-file.d.mts

@@ -0,0 +1,32 @@
+import { ComponentProps } from "../../types/components.mjs";
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+import { SourceFileProps as SourceFileProps$1 } from "@alloy-js/core";
+import { StoragePreset } from "powerlines";
+
+//#region src/core/components/source-file.d.ts
+type SourceFileProps = SourceFileProps$1 & ComponentProps & {
+  /**
+   * The storage preset for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset;
+  /**
+   * The metadata associated with the source file.
+   *
+   * @remarks
+   * The values stored in the metadata will be available in the rendering context.
+   */
+  meta?: Record<string, any>;
+};
+/**
+ * A base component representing a Powerlines generated source file.
+ *
+ * @param props - The properties for the source file.
+ * @returns The rendered source file component.
+ */
+declare function SourceFile(props: SourceFileProps): _$_alloy_js_core0.Children;
+//#endregion
+export { SourceFile, SourceFileProps };
+//# sourceMappingURL=source-file.d.mts.map

package/dist/core/components/source-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.d.mts","names":[],"sources":["../../../src/core/components/source-file.tsx"],"mappings":";;;;;;KAkCY,eAAA,GAAkB,iBAAA,GAC5B,cAAA;;;AADF;;;;EAQI,OAAA,GAAU,aAAA;EAAA;;;;;;EAQV,IAAA,GAAO,MAAA;AAAA;;;;;AASX;;iBAAgB,UAAA,CAAW,KAAA,EAAO,eAAA,GAAe,iBAAA,CAAA,QAAA"}

package/dist/core/components/source-file.mjs

@@ -0,0 +1,2 @@
+import{useMeta as e}from"../contexts/meta.mjs";import{createComponent as t,createIntrinsic as n}from"@alloy-js/core/jsx-runtime";import{Show as r,SourceDirectoryContext as i,SourceFileContext as a,getContext as o,splitProps as s,useContext as c,useFormatOptions as l}from"@alloy-js/core";import{appendPath as u}from"@stryke/path/append";import d from"defu";function f(f){let[{children:p,meta:m,path:h,header:g,storage:_,filetype:v,reference:y}]=s(f,[`children`,`meta`,`path`,`header`,`storage`,`filetype`,`reference`]),b=e(),x=c(i),S={path:u(h,x.path),filetype:v,reference:y};x?.addContent(S);let C=l({printWidth:f.printWidth,tabWidth:f.tabWidth,useTabs:f.useTabs,insertFinalNewLine:f.insertFinalNewLine}),w=o();return w.meta=d({sourceFile:S,printOptions:C},m??{}),b&&(b[S.path]={storage:_,...m??{}}),t(a.Provider,{value:S,get children(){return[t(r,{when:g!==void 0,get children(){return[g,n(`hbr`,{})]}}),p]}})}export{f as SourceFile};
+//# sourceMappingURL=source-file.mjs.map

package/dist/core/components/source-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.mjs","names":[],"sources":["../../../src/core/components/source-file.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  getContext,\n  Show,\n  SourceDirectoryContext,\n  SourceFileContext,\n  SourceFileProps as SourceFilePropsExternal,\n  splitProps,\n  useContext,\n  useFormatOptions\n} from \"@alloy-js/core\";\nimport { appendPath } from \"@stryke/path/append\";\nimport defu from \"defu\";\nimport type { StoragePreset } from \"powerlines\";\nimport { ComponentProps } from \"../../types/components\";\nimport { useMeta } from \"../contexts/meta\";\n\nexport type SourceFileProps = SourceFilePropsExternal &\n  ComponentProps & {\n    /**\n     * The storage preset for the output files.\n     *\n     * @remarks\n     * If not specified, the output mode will be determined by the provided `output.mode` value.\n     */\n    storage?: StoragePreset;\n\n    /**\n     * The metadata associated with the source file.\n     *\n     * @remarks\n     * The values stored in the metadata will be available in the rendering context.\n     */\n    meta?: Record<string, any>;\n  };\n\n/**\n * A base component representing a Powerlines generated source file.\n *\n * @param props - The properties for the source file.\n * @returns The rendered source file component.\n */\nexport function SourceFile(props: SourceFileProps) {\n  const [{ children, meta, path, header, storage, filetype, reference }] =\n    splitProps(props, [\n      \"children\",\n      \"meta\",\n      \"path\",\n      \"header\",\n      \"storage\",\n      \"filetype\",\n      \"reference\"\n    ]);\n\n  const metadata = useMeta();\n  const parentDirectory = useContext(SourceDirectoryContext)!;\n\n  const sourceFile: SourceFileContext = {\n    path: appendPath(path, parentDirectory.path),\n    filetype,\n    reference\n  };\n  parentDirectory?.addContent(sourceFile);\n\n  const printOptions = useFormatOptions({\n    printWidth: props.printWidth,\n    tabWidth: props.tabWidth,\n    useTabs: props.useTabs,\n    insertFinalNewLine: props.insertFinalNewLine\n  });\n\n  const nodeContext = getContext()!;\n  nodeContext.meta = defu(\n    {\n      sourceFile,\n      printOptions\n    },\n    meta ?? {}\n  );\n\n  if (metadata) {\n    metadata[sourceFile.path] = {\n      storage,\n      ...(meta ?? {})\n    };\n  }\n\n  return (\n    <SourceFileContext.Provider value={sourceFile}>\n      <Show when={header !== undefined}>\n        {header}\n        <hbr />\n      </Show>\n      {children}\n    </SourceFileContext.Provider>\n  );\n}\n"],"mappings":"qWA8BA,SAAc,EAAa,EAAO,CAClC,GAAQ,CAAC,CACT,WAAA,OAEA,OACE,SACE,UACA,WACA,cACG,EAAC,EAAA,CAAA,WAAA,OAAA,OAAA,SAAA,UAAA,WAAA,YAAA,CAAA,CACD,EAAO,GAAc,CACtB,EAAA,EAAA,EAAA,CACF,EAAU,kBAEV,WACA,YACD,CACD,GAAM,WAAA,EAAA,CACN,IAAK,EAAW,EAAsB,CACpC,WAAE,EAAA,WACF,SAAO,EAAO,SACf,QAAA,EAAA,gDAED,CAAA,CACG,EAAe,GAAc,CAWhC,MAVD,GAAA,KAAA,EAAA,CACG,aACA,eACF,CAAA,GAAA,EAAA,CAAA,CACI,IACJ,EAAS,EAAU,MAAW,CAC5B,UACE,GAAC,GAAS,EAAA,CACX,EAEE,EAAO,EAAA,SAAA,CACV,MAAG,EACH,IAAG,UAAS,CACV,MAAC,CAAA,EAAS,EAAA,CACV,KAAA,IAAA,IAAA,kBAEE,MAAS,CAAC,EAAQ,EAAE,MAAA,EAAA,CAAA,CAAA,QAIzB,CAAC"}

package/dist/core/components/spacing.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core/jsx-runtime`),t=require(`@alloy-js/core`);function n({scale:n=1}){return(0,e.createComponent)(t.For,{get each(){return Array.from({length:n})},children:t=>[(0,e.createIntrinsic)(`hbr`,{}),(0,e.createIntrinsic)(`hbr`,{})]})}exports.Spacing=n;

package/dist/core/components/spacing.d.cts

@@ -0,0 +1,23 @@
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/spacing.d.ts
+interface SpacingProps {
+  /**
+   * A scale factor that determines the amount of vertical space to be added.
+   *
+   * @remarks
+   * The default value is 1, which corresponds to a standard spacing. A value of 2 would double the spacing, while a value of 0.5 would halve it.
+   *
+   * @defaultValue 1
+   */
+  scale?: number;
+}
+/**
+ * A simple component that renders two horizontal breaks to create vertical spacing between elements.
+ */
+declare function Spacing({
+  scale
+}: SpacingProps): _$_alloy_js_core0.Children;
+//#endregion
+export { Spacing, SpacingProps };
+//# sourceMappingURL=spacing.d.cts.map

package/dist/core/components/spacing.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.cts","names":[],"sources":["../../../src/core/components/spacing.tsx"],"mappings":";;;UAoBiB,YAAA;;;AAAjB;;;;;AAeA;EANE,KAAA;AAAA;;;;iBAMc,OAAA,CAAA;EAAU;AAAA,GAAa,YAAA,GAAY,iBAAA,CAAA,QAAA"}

package/dist/core/components/spacing.d.mts

@@ -0,0 +1,23 @@
+import * as _$_alloy_js_core0 from "@alloy-js/core";
+
+//#region src/core/components/spacing.d.ts
+interface SpacingProps {
+  /**
+   * A scale factor that determines the amount of vertical space to be added.
+   *
+   * @remarks
+   * The default value is 1, which corresponds to a standard spacing. A value of 2 would double the spacing, while a value of 0.5 would halve it.
+   *
+   * @defaultValue 1
+   */
+  scale?: number;
+}
+/**
+ * A simple component that renders two horizontal breaks to create vertical spacing between elements.
+ */
+declare function Spacing({
+  scale
+}: SpacingProps): _$_alloy_js_core0.Children;
+//#endregion
+export { Spacing, SpacingProps };
+//# sourceMappingURL=spacing.d.mts.map

package/dist/core/components/spacing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.mts","names":[],"sources":["../../../src/core/components/spacing.tsx"],"mappings":";;;UAoBiB,YAAA;;;AAAjB;;;;;AAeA;EANE,KAAA;AAAA;;;;iBAMc,OAAA,CAAA;EAAU;AAAA,GAAa,YAAA,GAAY,iBAAA,CAAA,QAAA"}

package/dist/core/components/spacing.mjs

@@ -0,0 +1,2 @@
+import{createComponent as e,createIntrinsic as t}from"@alloy-js/core/jsx-runtime";import{For as n}from"@alloy-js/core";function r({scale:r=1}){return e(n,{get each(){return Array.from({length:r})},children:e=>[t(`hbr`,{}),t(`hbr`,{})]})}export{r as Spacing};
+//# sourceMappingURL=spacing.mjs.map

package/dist/core/components/spacing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.mjs","names":[],"sources":["../../../src/core/components/spacing.tsx"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { For } from \"@alloy-js/core\";\n\nexport interface SpacingProps {\n  /**\n   * A scale factor that determines the amount of vertical space to be added.\n   *\n   * @remarks\n   * The default value is 1, which corresponds to a standard spacing. A value of 2 would double the spacing, while a value of 0.5 would halve it.\n   *\n   * @defaultValue 1\n   */\n  scale?: number;\n}\n\n/**\n * A simple component that renders two horizontal breaks to create vertical spacing between elements.\n */\nexport function Spacing({ scale = 1 }: SpacingProps) {\n  return (\n    <For each={Array.from({ length: scale })}>\n      {_ => (\n        <>\n          <hbr />\n          <hbr />\n        </>\n      )}\n    </For>\n  );\n}\n"],"mappings":"uHAuBA,SAAG,EAAA,CACD,QAAI,GACH,CACD,OAAC,EAAA,EAAA,CACC,IAAE,MAAA,CACF,OAAA,MAAA,KAAA,CACI,OAAQ,EAChB,CAAA,EAEE,SAAA,GAAA,CAAA,EAAA,MAAA,EAAA,CAAA,CAAA,EAAA,MAAA,EAAA,CAAA,CAAA,CACC,CAAC"}

package/dist/core/contexts/context.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core`);const t=(0,e.createNamedContext)(`Powerlines`);function n(){return(0,e.useContext)(t)}function r(){return n()??void 0}function i(){let e=r();if(!e)throw Error("Powerlines - Context is not set. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");return e}exports.PowerlinesContext=t,exports.usePowerlines=i,exports.usePowerlinesContext=n,exports.usePowerlinesSafe=r;

package/dist/core/contexts/context.d.cts

@@ -0,0 +1,29 @@
+import { ComponentContext } from "@alloy-js/core";
+import { PluginContext } from "powerlines";
+
+//#region src/core/contexts/context.d.ts
+/**
+ * The Powerlines context used in template rendering.
+ */
+declare const PowerlinesContext: ComponentContext<PluginContext>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function usePowerlinesContext<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+/**
+ * Hook to safely access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context or undefined if not set.
+ */
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+/**
+ * Hook to access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context.
+ */
+declare function usePowerlines<TContext extends PluginContext = PluginContext>(): TContext;
+//#endregion
+export { PowerlinesContext, usePowerlines, usePowerlinesContext, usePowerlinesSafe };
+//# sourceMappingURL=context.d.cts.map

package/dist/core/contexts/context.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.cts","names":[],"sources":["../../../src/core/contexts/context.ts"],"mappings":";;;;;;AA4BA;cAAa,iBAAA,EAAmB,gBAAA,CAAiB,aAAA;;;;AAQjD;;iBAAgB,oBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAAA,GAC9B,QAAA;;;;;;iBASW,iBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAAA,GAC9B,QAAA;;;;;;iBAWW,aAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAAA,GAC9B,QAAA"}

package/dist/core/contexts/context.d.mts

@@ -0,0 +1,29 @@
+import { ComponentContext } from "@alloy-js/core";
+import { PluginContext } from "powerlines";
+
+//#region src/core/contexts/context.d.ts
+/**
+ * The Powerlines context used in template rendering.
+ */
+declare const PowerlinesContext: ComponentContext<PluginContext>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function usePowerlinesContext<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+/**
+ * Hook to safely access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context or undefined if not set.
+ */
+declare function usePowerlinesSafe<TContext extends PluginContext = PluginContext>(): TContext | undefined;
+/**
+ * Hook to access the {@link PluginContext | Powerlines context}.
+ *
+ * @returns The Powerlines context.
+ */
+declare function usePowerlines<TContext extends PluginContext = PluginContext>(): TContext;
+//#endregion
+export { PowerlinesContext, usePowerlines, usePowerlinesContext, usePowerlinesSafe };
+//# sourceMappingURL=context.d.mts.map

package/dist/core/contexts/context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.mts","names":[],"sources":["../../../src/core/contexts/context.ts"],"mappings":";;;;;;AA4BA;cAAa,iBAAA,EAAmB,gBAAA,CAAiB,aAAA;;;;AAQjD;;iBAAgB,oBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAAA,GAC9B,QAAA;;;;;;iBASW,iBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAAA,GAC9B,QAAA;;;;;;iBAWW,aAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAAA,GAC9B,QAAA"}

package/dist/core/contexts/context.mjs

@@ -0,0 +1,2 @@
+import{createNamedContext as e,useContext as t}from"@alloy-js/core";const n=e(`Powerlines`);function r(){return t(n)}function i(){return r()??void 0}function a(){let e=i();if(!e)throw Error("Powerlines - Context is not set. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");return e}export{n as PowerlinesContext,a as usePowerlines,r as usePowerlinesContext,i as usePowerlinesSafe};
+//# sourceMappingURL=context.mjs.map

package/dist/core/contexts/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","names":[],"sources":["../../../src/core/contexts/context.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport {\n  ComponentContext,\n  createNamedContext,\n  useContext\n} from \"@alloy-js/core\";\nimport type { PluginContext } from \"powerlines\";\n\n/**\n * The Powerlines context used in template rendering.\n */\nexport const PowerlinesContext: ComponentContext<PluginContext> =\n  createNamedContext<PluginContext>(\"Powerlines\");\n\n/**\n * Hook to access the Powerlines Context.\n *\n * @returns The Context.\n */\nexport function usePowerlinesContext<\n  TContext extends PluginContext = PluginContext\n>(): TContext | undefined {\n  return useContext(PowerlinesContext) as TContext | undefined;\n}\n\n/**\n * Hook to safely access the {@link PluginContext | Powerlines context}.\n *\n * @returns The Powerlines context or undefined if not set.\n */\nexport function usePowerlinesSafe<\n  TContext extends PluginContext = PluginContext\n>(): TContext | undefined {\n  const powerlines = usePowerlinesContext<TContext>();\n\n  return powerlines ?? undefined;\n}\n\n/**\n * Hook to access the {@link PluginContext | Powerlines context}.\n *\n * @returns The Powerlines context.\n */\nexport function usePowerlines<\n  TContext extends PluginContext = PluginContext\n>(): TContext {\n  const powerlines = usePowerlinesSafe<TContext>();\n  if (!powerlines) {\n    throw new Error(\n      \"Powerlines - Context is not set. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.\"\n    );\n  }\n\n  return powerlines;\n}\n"],"mappings":"oEAsBA,MAAS,EAAc,EAAA,aAAA,CAOvB,SAAE,GAAmC,aASrC,SAAgB,GAAU,CAE1B,OADoB,GACpB,EAAA,IAAA,GAQA,SAAW,GAAqB,CAC9B,IAAG,EAAW,GAAU,CACxB,GAAA,CAAK,EAAA,MAAA,MAAA,sLAAA,CAGP,OAAA"}

package/dist/core/contexts/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./context.cjs`),t=require(`./meta.cjs`),n=require(`./reflection.cjs`);exports.MetaContext=t.MetaContext,exports.PowerlinesContext=e.PowerlinesContext,exports.ReflectionClassContext=n.ReflectionClassContext,exports.ReflectionMethodContext=n.ReflectionMethodContext,exports.ReflectionParameterContext=n.ReflectionParameterContext,exports.ReflectionPropertyContext=n.ReflectionPropertyContext,exports.useMeta=t.useMeta,exports.useMetaContext=t.useMetaContext,exports.useMetaSafe=t.useMetaSafe,exports.usePowerlines=e.usePowerlines,exports.usePowerlinesContext=e.usePowerlinesContext,exports.usePowerlinesSafe=e.usePowerlinesSafe,exports.useReflectionClass=n.useReflectionClass,exports.useReflectionMethod=n.useReflectionMethod,exports.useReflectionParameter=n.useReflectionParameter,exports.useReflectionProperty=n.useReflectionProperty,exports.useReflectionPropertyContext=n.useReflectionPropertyContext;

package/dist/core/contexts/index.d.cts

@@ -0,0 +1,4 @@
+import { PowerlinesContext, usePowerlines, usePowerlinesContext, usePowerlinesSafe } from "./context.cjs";
+import { MetaContext, MetaItem, useMeta, useMetaContext, useMetaSafe } from "./meta.cjs";
+import { ReflectionClassContext, ReflectionClassContextInterface, ReflectionMethodContext, ReflectionParameterContext, ReflectionPropertyContext, ReflectionPropertyContextInterface, useReflectionClass, useReflectionMethod, useReflectionParameter, useReflectionProperty, useReflectionPropertyContext } from "./reflection.cjs";
+export { MetaContext, MetaItem, PowerlinesContext, ReflectionClassContext, ReflectionClassContextInterface, ReflectionMethodContext, ReflectionParameterContext, ReflectionPropertyContext, ReflectionPropertyContextInterface, useMeta, useMetaContext, useMetaSafe, usePowerlines, usePowerlinesContext, usePowerlinesSafe, useReflectionClass, useReflectionMethod, useReflectionParameter, useReflectionProperty, useReflectionPropertyContext };

package/dist/core/contexts/index.d.mts

@@ -0,0 +1,4 @@
+import { PowerlinesContext, usePowerlines, usePowerlinesContext, usePowerlinesSafe } from "./context.mjs";
+import { MetaContext, MetaItem, useMeta, useMetaContext, useMetaSafe } from "./meta.mjs";
+import { ReflectionClassContext, ReflectionClassContextInterface, ReflectionMethodContext, ReflectionParameterContext, ReflectionPropertyContext, ReflectionPropertyContextInterface, useReflectionClass, useReflectionMethod, useReflectionParameter, useReflectionProperty, useReflectionPropertyContext } from "./reflection.mjs";
+export { MetaContext, MetaItem, PowerlinesContext, ReflectionClassContext, ReflectionClassContextInterface, ReflectionMethodContext, ReflectionParameterContext, ReflectionPropertyContext, ReflectionPropertyContextInterface, useMeta, useMetaContext, useMetaSafe, usePowerlines, usePowerlinesContext, usePowerlinesSafe, useReflectionClass, useReflectionMethod, useReflectionParameter, useReflectionProperty, useReflectionPropertyContext };

package/dist/core/contexts/index.mjs

@@ -0,0 +1 @@
+import{PowerlinesContext as e,usePowerlines as t,usePowerlinesContext as n,usePowerlinesSafe as r}from"./context.mjs";import{MetaContext as i,useMeta as a,useMetaContext as o,useMetaSafe as s}from"./meta.mjs";import{ReflectionClassContext as c,ReflectionMethodContext as l,ReflectionParameterContext as u,ReflectionPropertyContext as d,useReflectionClass as f,useReflectionMethod as p,useReflectionParameter as m,useReflectionProperty as h,useReflectionPropertyContext as g}from"./reflection.mjs";export{i as MetaContext,e as PowerlinesContext,c as ReflectionClassContext,l as ReflectionMethodContext,u as ReflectionParameterContext,d as ReflectionPropertyContext,a as useMeta,o as useMetaContext,s as useMetaSafe,t as usePowerlines,n as usePowerlinesContext,r as usePowerlinesSafe,f as useReflectionClass,p as useReflectionMethod,m as useReflectionParameter,h as useReflectionProperty,g as useReflectionPropertyContext};

package/dist/core/contexts/meta.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`../../_virtual/_rolldown/runtime.cjs`);let e=require(`@alloy-js/core`);const t=(0,e.createNamedContext)(`Meta`);function n(){return(0,e.useContext)(t)}function r(){return n()??void 0}function i(){let e=r();if(!e)throw Error("Powerlines metadata is not available in the rendering context. Please make sure the Alloy components are being provided to an invocation of the `render` function added to plugins by `@powerlines/plugin-alloy`.");return e}exports.MetaContext=t,exports.useMeta=i,exports.useMetaContext=n,exports.useMetaSafe=r;

package/dist/core/contexts/meta.d.cts

@@ -0,0 +1,47 @@
+import { ComponentContext } from "@alloy-js/core";
+import { StoragePreset } from "powerlines";
+
+//#region src/core/contexts/meta.d.ts
+interface MetaItem {
+  /**
+   * The kind of metadata item.
+   */
+  kind?: "builtin" | "entry" | string;
+  /**
+   * Whether to skip formatting for this output.
+   */
+  skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output files.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
+  [key: string]: any;
+}
+/**
+ * The Powerlines meta context used to determine metadata of files generated during rendering.
+ */
+declare const MetaContext: ComponentContext<Record<string, MetaItem>>;
+/**
+ * Hook to access the Powerlines Context.
+ *
+ * @returns The Context.
+ */
+declare function useMetaContext(): Record<string, MetaItem> | undefined;
+/**
+ * Hook to safely access the render context's metadata.
+ *
+ * @returns The Powerlines context or undefined if not set.
+ */
+declare function useMetaSafe(): Record<string, MetaItem> | undefined;
+/**
+ * Hook to access the render context's metadata.
+ *
+ * @returns The Powerlines context.
+ */
+declare function useMeta(): Record<string, MetaItem>;
+//#endregion
+export { MetaContext, MetaItem, useMeta, useMetaContext, useMetaSafe };
+//# sourceMappingURL=meta.d.cts.map

package/dist/core/contexts/meta.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.cts","names":[],"sources":["../../../src/core/contexts/meta.ts"],"mappings":";;;;UAyBiB,QAAA;;AAAjB;;EAIE,IAAA;EAauB;;;EARvB,UAAA;EAQU;;;;AAQZ;;EARE,OAAA,GAAU,aAAA;EAAA,CAET,GAAA;AAAA;;;;cAMU,WAAA,EAAa,gBAAA,CAAiB,MAAA,SAAe,QAAA;;;;;AAQ1D;iBAAgB,cAAA,CAAA,GAAkB,MAAA,SAAe,QAAA;;;;AASjD;;iBAAgB,WAAA,CAAA,GAAe,MAAA,SAAe,QAAA;;;AAW9C;;;iBAAgB,OAAA,CAAA,GAAW,MAAA,SAAe,QAAA"}