@powerlines/plugin-alloy 0.25.49 → 0.25.52

package/dist/types/components.d.mts

@@ -0,0 +1,142 @@
+import { Children, Context } from "@alloy-js/core";
+import { SourceFileContext as SourceFileContext$1 } from "@alloy-js/typescript";
+import { ResolvedEntryTypeDefinition, StoragePreset } from "powerlines";
+
+//#region src/types/components.d.ts
+interface CopyOutputFile {
+  kind: "file";
+  path: string;
+  sourcePath: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+interface WriteOutputFile {
+  kind: "file" | "entry" | "builtin";
+  path: string;
+  contents: string;
+  filetype: string;
+  /**
+   * The format of the output files
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided \`output.mode\` value.
+   */
+  preset?: StoragePreset;
+}
+type OutputFile = (WriteOutputFile & {
+  kind: "file";
+}) | (WriteOutputFile & {
+  kind: "entry";
+  typeDefinition?: ResolvedEntryTypeDefinition;
+}) | (WriteOutputFile & {
+  kind: "builtin";
+  id: string;
+}) | CopyOutputFile;
+interface OutputDirectory {
+  kind: "directory";
+  path: string;
+  contents: (OutputDirectory | OutputFile)[];
+}
+interface RenderEntryContext {
+  typeDefinition: ResolvedEntryTypeDefinition;
+}
+interface RenderBuiltinContext {
+  id: string;
+}
+interface RenderOutputContext {
+  mode?: StoragePreset;
+}
+interface CopyFileOutputContext {
+  path?: string;
+  sourcePath?: string;
+}
+interface RenderContext extends Context {
+  meta?: {
+    copyFile?: CopyFileOutputContext;
+    /**
+     * The current context for the built-in module.
+     */
+    builtin?: RenderBuiltinContext;
+    /**
+     * The current context for the application entrypoint file being rendered.
+     */
+    entry?: RenderEntryContext;
+    /**
+     * The current context for output rendering.
+     */
+    output?: RenderOutputContext;
+  } & Record<string, any>;
+}
+/**
+ * A type that represents the props of a component that can have children.
+ */
+interface ComponentProps {
+  children?: Children;
+}
+/**
+ * A type that requires the `children` prop in a component.
+ */
+type ComponentPropsWithChildren = Omit<ComponentProps, "children"> & Required<Pick<ComponentProps, "children">>;
+interface BuiltinSourceFileContext extends SourceFileContext$1 {
+  /**
+   * The runtime module identifier.
+   */
+  id: string;
+}
+interface ReflectionOverrideInterface<T> {
+  name?: string | Children;
+  type?: string | Children;
+  extends?: string | false;
+  defaultValue?: Partial<T>;
+}
+interface TypescriptFileImportItem {
+  name: string;
+  default?: boolean;
+  alias?: string;
+  type?: boolean;
+}
+type TypescriptFileImports = Record<string, null | string | Array<TypescriptFileImportItem | string>>;
+interface SourceFileHeaderProps extends ComponentProps {
+  /**
+   * If true, disables the ESLint directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableEslint?: boolean;
+  /**
+   * If true, disables the Biome directive at the top of the file.
+   *
+   * @defaultValue true
+   */
+  disableBiome?: boolean;
+  /**
+   * If true, disables the Prettier directive at the top of the file.
+   *
+   * @defaultValue false
+   */
+  disablePrettier?: boolean;
+}
+declare type __ΩCopyOutputFile = any[];
+declare type __ΩWriteOutputFile = any[];
+declare type __ΩOutputFile = any[];
+declare type __ΩOutputDirectory = any[];
+declare type __ΩRenderEntryContext = any[];
+declare type __ΩRenderBuiltinContext = any[];
+declare type __ΩRenderOutputContext = any[];
+declare type __ΩCopyFileOutputContext = any[];
+declare type __ΩRenderContext = any[];
+declare type __ΩComponentProps = any[];
+declare type __ΩComponentPropsWithChildren = any[];
+declare type __ΩBuiltinSourceFileContext = any[];
+declare type __ΩReflectionOverrideInterface = any[];
+declare type __ΩTypescriptFileImportItem = any[];
+declare type __ΩTypescriptFileImports = any[];
+declare type __ΩSourceFileHeaderProps = any[];
+//#endregion
+export { BuiltinSourceFileContext, ComponentProps, ComponentPropsWithChildren, CopyFileOutputContext, CopyOutputFile, OutputDirectory, OutputFile, ReflectionOverrideInterface, RenderBuiltinContext, RenderContext, RenderEntryContext, RenderOutputContext, SourceFileHeaderProps, TypescriptFileImportItem, TypescriptFileImports, WriteOutputFile, __ΩBuiltinSourceFileContext, __ΩComponentProps, __ΩComponentPropsWithChildren, __ΩCopyFileOutputContext, __ΩCopyOutputFile, __ΩOutputDirectory, __ΩOutputFile, __ΩReflectionOverrideInterface, __ΩRenderBuiltinContext, __ΩRenderContext, __ΩRenderEntryContext, __ΩRenderOutputContext, __ΩSourceFileHeaderProps, __ΩTypescriptFileImportItem, __ΩTypescriptFileImports, __ΩWriteOutputFile };
+//# sourceMappingURL=components.d.mts.map

package/dist/types/components.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.mts","names":[],"sources":["../../src/types/components.ts"],"mappings":";;;;;UAsBiB,cAAA;EACf,IAAA;EACA,IAAA;EACA,UAAA;;;;;;;EAQA,MAAA,GAAS,aAAA;AAAA;AAAA,UAGM,eAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA;EACA,QAAA;EAHA;;;;;;EAWA,MAAA,GAAS,aAAA;AAAA;AAAA,KAGC,UAAA,IACP,eAAA;EAAoB,IAAA;AAAA,MACpB,eAAA;EACC,IAAA;EACA,cAAA,GAAiB,2BAAA;AAAA,MAElB,eAAA;EAAoB,IAAA;EAAiB,EAAA;AAAA,KACtC,cAAA;AAAA,UAEa,eAAA;EACf,IAAA;EACA,IAAA;EACA,QAAA,GAAW,eAAA,GAAkB,UAAA;AAAA;AAAA,UAGd,kBAAA;EACf,cAAA,EAAgB,2BAAA;AAAA;AAAA,UAGD,oBAAA;EACf,EAAA;AAAA;AAAA,UAGe,mBAAA;EACf,IAAA,GAAO,aAAA;AAAA;AAAA,UAGQ,qBAAA;EACf,IAAA;EACA,UAAA;AAAA;AAAA,UAGe,aAAA,SAAsB,OAAA;EACrC,IAAA;IACE,QAAA,GAAW,qBAAA;IAtBgB;;;IA2B3B,OAAA,GAAU,oBAAA;IAxBqB;;;IA6B/B,KAAA,GAAQ,kBAAA;IAzBK;;;IA8Bb,MAAA,GAAS,mBAAA;EAAA,IACP,MAAA;AAAA;;;;UAMW,cAAA;EACf,QAAA,GAAW,QAAA;AAAA;;;;KAMD,0BAAA,GAA6B,IAAA,CAAK,cAAA,gBAC5C,QAAA,CAAS,IAAA,CAAK,cAAA;AAAA,UAEC,wBAAA,SAAiC,mBAAA;;;;EAIhD,EAAA;AAAA;AAAA,UAGe,2BAAA;EACf,IAAA,YAAgB,QAAA;EAChB,IAAA,YAAgB,QAAA;EAChB,OAAA;EACA,YAAA,GAAe,OAAA,CAAQ,CAAA;AAAA;AAAA,UAGR,wBAAA;EACf,IAAA;EACA,OAAA;EACA,KAAA;EACA,IAAA;AAAA;AAAA,KAGU,qBAAA,GAAwB,MAAA,yBAElB,KAAA,CAAM,wBAAA;AAAA,UAGP,qBAAA,SAA8B,cAAA;EA1CzC;;;AAMN;;EA0CE,aAAA;EAzCA;;AAMF;;;EA0CE,YAAA;EA1CuC;;;;;EAiDvC,eAAA;AAAA;AAAA"}

package/dist/types/components.mjs

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

package/dist/types/index.d.cts

@@ -0,0 +1,3 @@
+import { BuiltinSourceFileContext, ComponentProps, ComponentPropsWithChildren, CopyFileOutputContext, CopyOutputFile, OutputDirectory, OutputFile, ReflectionOverrideInterface, RenderBuiltinContext, RenderContext, RenderEntryContext, RenderOutputContext, SourceFileHeaderProps, TypescriptFileImportItem, TypescriptFileImports, WriteOutputFile, __ΩBuiltinSourceFileContext, __ΩComponentProps, __ΩComponentPropsWithChildren, __ΩCopyFileOutputContext, __ΩCopyOutputFile, __ΩOutputDirectory, __ΩOutputFile, __ΩReflectionOverrideInterface, __ΩRenderBuiltinContext, __ΩRenderContext, __ΩRenderEntryContext, __ΩRenderOutputContext, __ΩSourceFileHeaderProps, __ΩTypescriptFileImportItem, __ΩTypescriptFileImports, __ΩWriteOutputFile } from "./components.cjs";
+import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig } from "./plugin.cjs";
+export { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, BuiltinSourceFileContext, ComponentProps, ComponentPropsWithChildren, CopyFileOutputContext, CopyOutputFile, OutputDirectory, OutputFile, ReflectionOverrideInterface, RenderBuiltinContext, RenderContext, RenderEntryContext, RenderOutputContext, SourceFileHeaderProps, TypescriptFileImportItem, TypescriptFileImports, WriteOutputFile, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig, __ΩBuiltinSourceFileContext, __ΩComponentProps, __ΩComponentPropsWithChildren, __ΩCopyFileOutputContext, __ΩCopyOutputFile, __ΩOutputDirectory, __ΩOutputFile, __ΩReflectionOverrideInterface, __ΩRenderBuiltinContext, __ΩRenderContext, __ΩRenderEntryContext, __ΩRenderOutputContext, __ΩSourceFileHeaderProps, __ΩTypescriptFileImportItem, __ΩTypescriptFileImports, __ΩWriteOutputFile };

package/dist/types/index.d.mts

@@ -0,0 +1,3 @@
+import { BuiltinSourceFileContext, ComponentProps, ComponentPropsWithChildren, CopyFileOutputContext, CopyOutputFile, OutputDirectory, OutputFile, ReflectionOverrideInterface, RenderBuiltinContext, RenderContext, RenderEntryContext, RenderOutputContext, SourceFileHeaderProps, TypescriptFileImportItem, TypescriptFileImports, WriteOutputFile, __ΩBuiltinSourceFileContext, __ΩComponentProps, __ΩComponentPropsWithChildren, __ΩCopyFileOutputContext, __ΩCopyOutputFile, __ΩOutputDirectory, __ΩOutputFile, __ΩReflectionOverrideInterface, __ΩRenderBuiltinContext, __ΩRenderContext, __ΩRenderEntryContext, __ΩRenderOutputContext, __ΩSourceFileHeaderProps, __ΩTypescriptFileImportItem, __ΩTypescriptFileImports, __ΩWriteOutputFile } from "./components.mjs";
+import { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig } from "./plugin.mjs";
+export { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, BuiltinSourceFileContext, ComponentProps, ComponentPropsWithChildren, CopyFileOutputContext, CopyOutputFile, OutputDirectory, OutputFile, ReflectionOverrideInterface, RenderBuiltinContext, RenderContext, RenderEntryContext, RenderOutputContext, SourceFileHeaderProps, TypescriptFileImportItem, TypescriptFileImports, WriteOutputFile, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig, __ΩBuiltinSourceFileContext, __ΩComponentProps, __ΩComponentPropsWithChildren, __ΩCopyFileOutputContext, __ΩCopyOutputFile, __ΩOutputDirectory, __ΩOutputFile, __ΩReflectionOverrideInterface, __ΩRenderBuiltinContext, __ΩRenderContext, __ΩRenderEntryContext, __ΩRenderOutputContext, __ΩSourceFileHeaderProps, __ΩTypescriptFileImportItem, __ΩTypescriptFileImports, __ΩWriteOutputFile };

package/dist/types/index.mjs

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

package/dist/types/plugin.d.cts

@@ -0,0 +1,39 @@
+import { PrintTreeOptions } from "@alloy-js/core";
+import { PluginContext } from "powerlines";
+import { BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types/plugin";
+
+//#region src/types/plugin.d.ts
+type AlloyPluginOptions = Partial<PrintTreeOptions> & {
+  /**
+   * If true, the Alloy framework is used to generate Typescript output files.
+   *
+   * @defaultValue true
+   */
+  typescript?: boolean;
+  /**
+   * If true, the Alloy framework is used to generate JSON output files.
+   *
+   * @defaultValue false
+   */
+  json?: boolean;
+  /**
+   * If true, the Alloy framework is used to generate Markdown output files.
+   *
+   * @defaultValue false
+   */
+  markdown?: boolean;
+};
+type AlloyPluginUserConfig = BabelPluginUserConfig & {
+  alloy?: AlloyPluginOptions;
+};
+type AlloyPluginResolvedConfig = BabelPluginResolvedConfig & {
+  alloy: AlloyPluginOptions;
+};
+type AlloyPluginContext<TResolvedConfig extends AlloyPluginResolvedConfig = AlloyPluginResolvedConfig> = PluginContext<TResolvedConfig>;
+declare type __ΩAlloyPluginOptions = any[];
+declare type __ΩAlloyPluginUserConfig = any[];
+declare type __ΩAlloyPluginResolvedConfig = any[];
+declare type __ΩAlloyPluginContext = any[];
+//#endregion
+export { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;KAyBY,kBAAA,GAAqB,OAAA,CAAQ,gBAAA;;AAAzC;;;;EAME,UAAA;EANuC;;;;;EAavC,IAAA;EAUU;;;;;EAHV,QAAA;AAAA;AAAA,KAGU,qBAAA,GAAwB,qBAAA;EAClC,KAAA,GAAQ,kBAAA;AAAA;AAAA,KAGE,yBAAA,GAA4B,yBAAA;EACtC,KAAA,EAAO,kBAAA;AAAA;AAAA,KAGG,kBAAA,yBACc,yBAAA,GAA4B,yBAAA,IAClD,aAAA,CAAc,eAAA;AAAA"}

package/dist/types/plugin.d.mts

@@ -0,0 +1,39 @@
+import { PrintTreeOptions } from "@alloy-js/core";
+import { PluginContext } from "powerlines";
+import { BabelPluginResolvedConfig, BabelPluginUserConfig } from "@powerlines/plugin-babel/types/plugin";
+
+//#region src/types/plugin.d.ts
+type AlloyPluginOptions = Partial<PrintTreeOptions> & {
+  /**
+   * If true, the Alloy framework is used to generate Typescript output files.
+   *
+   * @defaultValue true
+   */
+  typescript?: boolean;
+  /**
+   * If true, the Alloy framework is used to generate JSON output files.
+   *
+   * @defaultValue false
+   */
+  json?: boolean;
+  /**
+   * If true, the Alloy framework is used to generate Markdown output files.
+   *
+   * @defaultValue false
+   */
+  markdown?: boolean;
+};
+type AlloyPluginUserConfig = BabelPluginUserConfig & {
+  alloy?: AlloyPluginOptions;
+};
+type AlloyPluginResolvedConfig = BabelPluginResolvedConfig & {
+  alloy: AlloyPluginOptions;
+};
+type AlloyPluginContext<TResolvedConfig extends AlloyPluginResolvedConfig = AlloyPluginResolvedConfig> = PluginContext<TResolvedConfig>;
+declare type __ΩAlloyPluginOptions = any[];
+declare type __ΩAlloyPluginUserConfig = any[];
+declare type __ΩAlloyPluginResolvedConfig = any[];
+declare type __ΩAlloyPluginContext = any[];
+//#endregion
+export { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/types/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"mappings":";;;;;KAyBY,kBAAA,GAAqB,OAAA,CAAQ,gBAAA;;AAAzC;;;;EAME,UAAA;EANuC;;;;;EAavC,IAAA;EAUU;;;;;EAHV,QAAA;AAAA;AAAA,KAGU,qBAAA,GAAwB,qBAAA;EAClC,KAAA,GAAQ,kBAAA;AAAA;AAAA,KAGE,yBAAA,GAA4B,yBAAA;EACtC,KAAA,EAAO,kBAAA;AAAA;AAAA,KAGG,kBAAA,yBACc,yBAAA,GAA4B,yBAAA,IAClD,aAAA,CAAc,eAAA;AAAA"}

package/dist/types/plugin.mjs

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

package/dist/typescript/components/builtin-file.cjs

@@ -0,0 +1,63 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_core_contexts_context = require('../../core/contexts/context.cjs');
+const require_typescript_components_tsdoc = require('./tsdoc.cjs');
+const require_typescript_components_typescript_file = require('./typescript-file.cjs');
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let _alloy_js_core = require("@alloy-js/core");
+let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+
+//#region src/typescript/components/builtin-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function BuiltinFile(props) {
+	const [{ children, imports, builtinImports, id, description, tsx }, rest] = (0, _alloy_js_core.splitProps)(props, [
+		"children",
+		"imports",
+		"builtinImports",
+		"id",
+		"description",
+		"tsx"
+	]);
+	const context = require_core_contexts_context.usePowerlinesSafe();
+	const path = (0, _alloy_js_core.computed)(() => (0, _stryke_path_replace.replacePath)(`${!(0, _stryke_type_checks_is_set.isSet)(tsx) ? id : (0, _stryke_path_replace.replaceExtension)(id)}${(0, _stryke_path_file_path_fns.hasFileExtension)(id) && !(0, _stryke_type_checks_is_set.isSet)(tsx) ? "" : tsx ? ".tsx" : ".ts"}`, context?.builtinsPath));
+	return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_typescript_file.TypescriptFile, (0, _alloy_js_core_jsx_runtime.mergeProps)({
+		get header() {
+			return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_typescript_file.TypescriptFileHeader, {
+				get header() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_tsdoc.TSDocModule, {
+						name: id,
+						children: description
+					});
+				},
+				get children() {
+					return (0, _alloy_js_core_jsx_runtime.createComponent)(require_typescript_components_typescript_file.TypescriptFileHeaderImports, {
+						imports,
+						builtinImports
+					});
+				}
+			});
+		},
+		get meta() {
+			return {
+				kind: "builtin",
+				extension: tsx ? "tsx" : "ts",
+				id: (0, _stryke_path_replace.replaceExtension)(id)
+			};
+		}
+	}, rest, {
+		get path() {
+			return path.value;
+		},
+		children
+	}));
+}
+
+//#endregion
+exports.BuiltinFile = BuiltinFile;

package/dist/typescript/components/builtin-file.d.cts

@@ -0,0 +1,35 @@
+import { TSDocModuleProps } from "./tsdoc.cjs";
+import { TypescriptFileProps } from "./typescript-file.cjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/typescript/components/builtin-file.d.ts
+type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProps, "name"> & {
+  /**
+   * The runtime module identifier.
+   *
+   * @remarks
+   * This value will be included after the \`storm:\` prefix in the import statement.
+   */
+  id: string;
+  /**
+   * The description for the builtin module.
+   */
+  description?: string;
+  /**
+   * Whether the file is a TSX file.
+   *
+   * @defaultValue false
+   */
+  tsx?: boolean;
+};
+/**
+ * A base component representing a Powerlines generated Typescript source file.
+ *
+ * @param props - The properties for the source file.
+ * @returns The rendered source file component.
+ */
+declare function BuiltinFile(props: BuiltinFileProps): _alloy_js_core0.Children;
+declare type __ΩBuiltinFileProps = any[];
+//#endregion
+export { BuiltinFile, BuiltinFileProps, __ΩBuiltinFileProps };
+//# sourceMappingURL=builtin-file.d.cts.map

package/dist/typescript/components/builtin-file.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-file.d.cts","names":[],"sources":["../../../src/typescript/components/builtin-file.tsx"],"mappings":";;;;;KAgCY,gBAAA,GAAmB,IAAA,CAAK,mBAAA,YAClC,IAAA,CAAK,gBAAA;;;AADP;;;;EAQI,EAAA;EAPG;;;EAYH,WAAA;EAb2B;;;;;EAoB3B,GAAA;AAAA;;;AASJ;;;;iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,eAAA,CAAA,QAAA;AAAA"}

package/dist/typescript/components/builtin-file.d.mts

@@ -0,0 +1,35 @@
+import { TSDocModuleProps } from "./tsdoc.mjs";
+import { TypescriptFileProps } from "./typescript-file.mjs";
+import * as _alloy_js_core0 from "@alloy-js/core";
+
+//#region src/typescript/components/builtin-file.d.ts
+type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProps, "name"> & {
+  /**
+   * The runtime module identifier.
+   *
+   * @remarks
+   * This value will be included after the \`storm:\` prefix in the import statement.
+   */
+  id: string;
+  /**
+   * The description for the builtin module.
+   */
+  description?: string;
+  /**
+   * Whether the file is a TSX file.
+   *
+   * @defaultValue false
+   */
+  tsx?: boolean;
+};
+/**
+ * A base component representing a Powerlines generated Typescript source file.
+ *
+ * @param props - The properties for the source file.
+ * @returns The rendered source file component.
+ */
+declare function BuiltinFile(props: BuiltinFileProps): _alloy_js_core0.Children;
+declare type __ΩBuiltinFileProps = any[];
+//#endregion
+export { BuiltinFile, BuiltinFileProps, __ΩBuiltinFileProps };
+//# sourceMappingURL=builtin-file.d.mts.map

package/dist/typescript/components/builtin-file.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-file.d.mts","names":[],"sources":["../../../src/typescript/components/builtin-file.tsx"],"mappings":";;;;;KAgCY,gBAAA,GAAmB,IAAA,CAAK,mBAAA,YAClC,IAAA,CAAK,gBAAA;;;AADP;;;;EAQI,EAAA;EAPG;;;EAYH,WAAA;EAb2B;;;;;EAoB3B,GAAA;AAAA;;;AASJ;;;;iBAAgB,WAAA,CAAY,KAAA,EAAO,gBAAA,GAAgB,eAAA,CAAA,QAAA;AAAA"}

package/dist/typescript/components/builtin-file.mjs

@@ -0,0 +1,62 @@
+import { usePowerlinesSafe } from "../../core/contexts/context.mjs";
+import { TSDocModule } from "./tsdoc.mjs";
+import { TypescriptFile, TypescriptFileHeader, TypescriptFileHeaderImports } from "./typescript-file.mjs";
+import { hasFileExtension } from "@stryke/path/file-path-fns";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { computed, splitProps } from "@alloy-js/core";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { isSet } from "@stryke/type-checks/is-set";
+
+//#region src/typescript/components/builtin-file.tsx
+/**
+* A base component representing a Powerlines generated Typescript source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function BuiltinFile(props) {
+	const [{ children, imports, builtinImports, id, description, tsx }, rest] = splitProps(props, [
+		"children",
+		"imports",
+		"builtinImports",
+		"id",
+		"description",
+		"tsx"
+	]);
+	const context = usePowerlinesSafe();
+	const path = computed(() => replacePath(`${!isSet(tsx) ? id : replaceExtension(id)}${hasFileExtension(id) && !isSet(tsx) ? "" : tsx ? ".tsx" : ".ts"}`, context?.builtinsPath));
+	return createComponent(TypescriptFile, mergeProps({
+		get header() {
+			return createComponent(TypescriptFileHeader, {
+				get header() {
+					return createComponent(TSDocModule, {
+						name: id,
+						children: description
+					});
+				},
+				get children() {
+					return createComponent(TypescriptFileHeaderImports, {
+						imports,
+						builtinImports
+					});
+				}
+			});
+		},
+		get meta() {
+			return {
+				kind: "builtin",
+				extension: tsx ? "tsx" : "ts",
+				id: replaceExtension(id)
+			};
+		}
+	}, rest, {
+		get path() {
+			return path.value;
+		},
+		children
+	}));
+}
+
+//#endregion
+export { BuiltinFile };
+//# sourceMappingURL=builtin-file.mjs.map

package/dist/typescript/components/builtin-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-file.mjs","names":[],"sources":["../../../src/typescript/components/builtin-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 { hasFileExtension } from \"@stryke/path/file-path-fns\";\nimport { replaceExtension, replacePath } from \"@stryke/path/replace\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { usePowerlinesSafe } from \"../../core/contexts/context\";\nimport type { TSDocModuleProps } from \"./tsdoc\";\nimport { TSDocModule } from \"./tsdoc\";\nimport {\n  TypescriptFile,\n  TypescriptFileHeader,\n  TypescriptFileHeaderImports,\n  TypescriptFileProps\n} from \"./typescript-file\";\n\nexport type BuiltinFileProps = Omit<TypescriptFileProps, \"path\"> &\n  Omit<TSDocModuleProps, \"name\"> & {\n    /**\n     * The runtime module identifier.\n     *\n     * @remarks\n     * This value will be included after the \\`storm:\\` prefix in the import statement.\n     */\n    id: string;\n\n    /**\n     * The description for the builtin module.\n     */\n    description?: string;\n\n    /**\n     * Whether the file is a TSX file.\n     *\n     * @defaultValue false\n     */\n    tsx?: boolean;\n  };\n\n/**\n * A base component representing a Powerlines generated Typescript source file.\n *\n * @param props - The properties for the source file.\n * @returns The rendered source file component.\n */\nexport function BuiltinFile(props: BuiltinFileProps) {\n  const [{ children, imports, builtinImports, id, description, tsx }, rest] =\n    splitProps(props, [\n      \"children\",\n      \"imports\",\n      \"builtinImports\",\n      \"id\",\n      \"description\",\n      \"tsx\"\n    ]);\n\n  const context = usePowerlinesSafe();\n  const path = computed(() =>\n    replacePath(\n      `${!isSet(tsx) ? id : replaceExtension(id)}${\n        hasFileExtension(id) && !isSet(tsx) ? \"\" : tsx ? \".tsx\" : \".ts\"\n      }`,\n      context?.builtinsPath\n    )\n  );\n\n  return (\n    <TypescriptFile\n      header={\n        <TypescriptFileHeader\n          header={<TSDocModule name={id}>{description}</TSDocModule>}>\n          <TypescriptFileHeaderImports\n            imports={imports}\n            builtinImports={builtinImports}\n          />\n        </TypescriptFileHeader>\n      }\n      meta={{\n        kind: \"builtin\",\n        extension: tsx ? \"tsx\" : \"ts\",\n        id: replaceExtension(id)\n      }}\n      {...rest}\n      path={path.value}>\n      {children}\n    </TypescriptFile>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAuDA,SAAE,YAAA,OAAA;CACA,MAAG,CAAI,EACR,UACG,SACA,gBACF,IACF,aACE,OACE,QAAA,WAAkB,OAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA;EAAA,CAAA;CACpB,MAAK,UAAS,mBAAA;CACd,MAAK,OAAQ,eAAA,YAAA,GAAA,CAAA,MAAA,IAAA,GAAA,KAAA,iBAAA,GAAA,GAAA,iBAAA,GAAA,IAAA,CAAA,MAAA,IAAA,GAAA,KAAA,MAAA,SAAA,SAAA,SAAA,aAAA,CAAA;AACb,QAAK,gBAAe,gBAAA,WAAA;EAClB,IAAG,SAAG;AACJ,UAAC,gBAAY,sBAAA;IACZ,IAAG,SAAA;AACJ,YAAA,gBAAA,aAAA;;MAEE,UAAU;MACV,CAAI;;IAEJ,IAAE,WAAa;AACf,YAAA,gBAAyB,6BAA+B;MACxD;MACO;MACX,CAAA;;;;EAIA,IAAC,OAAA;AACC,UAAO;IACL,MAAC;IACD,WAAW,MAAA,QAAY;IACvB,IAAG,iBAAA,GAAA;IACJ;;EAEJ,EAAE,MAAM;EACP,IAAI,OAAE;AACJ,UAAA,KAAA;;EAEQ;EACX,CAAC,CAAC"}