@powerlines/plugin-alloy 0.18.50 → 0.18.53

package/dist/powerlines/src/types/resolved.d.mts

@@ -1,9 +1,9 @@
 import { BuilderVariant } from "./build.mjs";
 import { ESBuildUserConfig, EnvironmentConfig, FarmUserConfig, InlineConfig, OutputConfig, RolldownUserConfig, RollupUserConfig, RspackUserConfig, TsdownUserConfig, TsupUserConfig, UnbuildUserConfig, UserConfig as UserConfig$1, ViteUserConfig, WebpackUserConfig } from "./config.mjs";
 import { NonUndefined } from "@stryke/types/base";
-import { ResolvedPreviewOptions } from "vite";
 import { TypeDefinition } from "@stryke/types/configuration";
 import { AssetGlob } from "@stryke/types/file";
+import { ResolvedPreviewOptions } from "vite";
 
 //#region ../powerlines/src/types/resolved.d.ts
 interface ResolvedEntryTypeDefinition extends TypeDefinition {

package/dist/powerlines/src/types/unplugin.d.cts

@@ -1,8 +1,8 @@
 import { BuilderVariant, InferUnpluginVariant, UnpluginBuilderVariant } from "./build.cjs";
 import { InferResolvedConfig } from "./resolved.cjs";
-import { Context } from "./context.cjs";
 import { API } from "./api.cjs";
 import { PluginHook } from "./plugin.cjs";
+import { Context } from "./context.cjs";
 import { MaybePromise } from "@stryke/types/base";
 import { HookFilter, UnpluginOptions } from "unplugin";
 

package/dist/powerlines/src/types/unplugin.d.mts

@@ -1,8 +1,8 @@
 import { BuilderVariant, InferUnpluginVariant, UnpluginBuilderVariant } from "./build.mjs";
 import { InferResolvedConfig } from "./resolved.mjs";
-import { Context } from "./context.mjs";
 import { API } from "./api.mjs";
 import { PluginHook } from "./plugin.mjs";
+import { Context } from "./context.mjs";
 import { MaybePromise } from "@stryke/types/base";
 import { HookFilter, UnpluginOptions } from "unplugin";
 

package/dist/types/components.d.cts

@@ -0,0 +1,142 @@
+import { StoragePreset } from "../powerlines/src/types/fs.cjs";
+import { ResolvedEntryTypeDefinition } from "../powerlines/src/types/resolved.cjs";
+import { Children, Context } from "@alloy-js/core";
+import { SourceFileContext } from "@alloy-js/typescript";
+
+//#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 {
+  /**
+   * 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 };

package/dist/types/components.d.mts

@@ -0,0 +1,142 @@
+import { StoragePreset } from "../powerlines/src/types/fs.mjs";
+import { ResolvedEntryTypeDefinition } from "../powerlines/src/types/resolved.mjs";
+import { Children, Context } from "@alloy-js/core";
+import { SourceFileContext as SourceFileContext$1 } from "@alloy-js/typescript";
+
+//#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 };

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

@@ -1,4 +1,5 @@
 import { ResolvedConfig } from "../powerlines/src/types/resolved.cjs";
+import { UserConfig } from "../powerlines/src/types/config.cjs";
 import { PluginContext } from "../powerlines/src/types/context.cjs";
 import { Children, PrintTreeOptions } from "@alloy-js/core";
 
@@ -23,11 +24,18 @@ type AlloyPluginOptions = Partial<PrintTreeOptions> & {
    */
   markdown?: boolean;
 };
+type AlloyPluginUserConfig = UserConfig & {
+  alloy?: AlloyPluginOptions;
+};
 type AlloyPluginResolvedConfig = ResolvedConfig & {
   alloy: AlloyPluginOptions;
 };
 type AlloyPluginContext<TResolvedConfig extends AlloyPluginResolvedConfig = AlloyPluginResolvedConfig> = PluginContext<TResolvedConfig> & {
   render: <TContext extends AlloyPluginContext>(this: TContext, children: Children) => Promise<void>;
 };
+declare type __ΩAlloyPluginOptions = any[];
+declare type __ΩAlloyPluginUserConfig = any[];
+declare type __ΩAlloyPluginResolvedConfig = any[];
+declare type __ΩAlloyPluginContext = any[];
 //#endregion
-export { AlloyPluginContext, AlloyPluginOptions };
+export { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig };

package/dist/types/plugin.d.mts

@@ -1,4 +1,5 @@
 import { ResolvedConfig } from "../powerlines/src/types/resolved.mjs";
+import { UserConfig } from "../powerlines/src/types/config.mjs";
 import { PluginContext } from "../powerlines/src/types/context.mjs";
 import { Children, PrintTreeOptions } from "@alloy-js/core";
 
@@ -23,11 +24,18 @@ type AlloyPluginOptions = Partial<PrintTreeOptions> & {
    */
   markdown?: boolean;
 };
+type AlloyPluginUserConfig = UserConfig & {
+  alloy?: AlloyPluginOptions;
+};
 type AlloyPluginResolvedConfig = ResolvedConfig & {
   alloy: AlloyPluginOptions;
 };
 type AlloyPluginContext<TResolvedConfig extends AlloyPluginResolvedConfig = AlloyPluginResolvedConfig> = PluginContext<TResolvedConfig> & {
   render: <TContext extends AlloyPluginContext>(this: TContext, children: Children) => Promise<void>;
 };
+declare type __ΩAlloyPluginOptions = any[];
+declare type __ΩAlloyPluginUserConfig = any[];
+declare type __ΩAlloyPluginResolvedConfig = any[];
+declare type __ΩAlloyPluginContext = any[];
 //#endregion
-export { AlloyPluginContext, AlloyPluginOptions };
+export { AlloyPluginContext, AlloyPluginOptions, AlloyPluginResolvedConfig, AlloyPluginUserConfig, __ΩAlloyPluginContext, __ΩAlloyPluginOptions, __ΩAlloyPluginResolvedConfig, __ΩAlloyPluginUserConfig };

package/dist/types/plugin.mjs

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

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

@@ -0,0 +1,62 @@
+const require_rolldown_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 __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+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,34 @@
+import { TSDocModuleProps } from "./tsdoc.cjs";
+import { TypescriptFileProps } from "./typescript-file.cjs";
+import * as _alloy_js_core6 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_core6.Children;
+declare type __ΩBuiltinFileProps = any[];
+//#endregion
+export { BuiltinFile, BuiltinFileProps, __ΩBuiltinFileProps };

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

@@ -0,0 +1,34 @@
+import { TSDocModuleProps } from "./tsdoc.mjs";
+import { TypescriptFileProps } from "./typescript-file.mjs";
+import * as _alloy_js_core6 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_core6.Children;
+declare type __ΩBuiltinFileProps = any[];
+//#endregion
+export { BuiltinFile, BuiltinFileProps, __ΩBuiltinFileProps };

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

@@ -0,0 +1,61 @@
+import { usePowerlinesSafe } from "../../core/contexts/context.mjs";
+import { TSDocModule } from "./tsdoc.mjs";
+import { TypescriptFile, TypescriptFileHeader, TypescriptFileHeaderImports } from "./typescript-file.mjs";
+import { createComponent, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { computed, splitProps } from "@alloy-js/core";
+import { hasFileExtension } from "@stryke/path/file-path-fns";
+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 };

package/dist/typescript/components/dynamic-import-statement.cjs

@@ -0,0 +1,25 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __alloy_js_core = require("@alloy-js/core");
+let __alloy_js_typescript = require("@alloy-js/typescript");
+
+//#region src/typescript/components/dynamic-import-statement.tsx
+/**
+* Generates a dynamic import statement for a given module path and export name.
+*
+* @example
+* ```tsx
+* <DynamicImportStatement importPath="./my-module" exportName="myExport" const={true} name="myVar" />
+* // const myVar = await import("./my-module").then(m => m.myExport);
+* ```
+*
+* @param props - The properties for the dynamic import statement.
+* @returns A `VarDeclaration` component representing the dynamic import statement.
+*/
+function DynamicImportStatement(props) {
+	const { importPath, exportName = "default", const: isConst = true, ...rest } = props;
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.VarDeclaration, (0, __alloy_js_core_jsx_runtime.mergeProps)({ "const": isConst }, rest, { initializer: __alloy_js_core.code`await import("${importPath}").then(m => m.${exportName});` }));
+}
+
+//#endregion
+exports.DynamicImportStatement = DynamicImportStatement;

package/dist/typescript/components/dynamic-import-statement.d.cts

@@ -0,0 +1,32 @@
+import * as _alloy_js_core5 from "@alloy-js/core";
+import { VarDeclarationProps } from "@alloy-js/typescript";
+
+//#region src/typescript/components/dynamic-import-statement.d.ts
+interface DynamicImportStatementProps extends Omit<VarDeclarationProps, "initializer"> {
+  /**
+   * The path of the module to import.
+   */
+  importPath: string;
+  /**
+   * The name of the export to import from the module.
+   *
+   * @defaultValue "default"
+   */
+  exportName?: string;
+}
+/**
+ * Generates a dynamic import statement for a given module path and export name.
+ *
+ * @example
+ * ```tsx
+ * <DynamicImportStatement importPath="./my-module" exportName="myExport" const={true} name="myVar" />
+ * // const myVar = await import("./my-module").then(m => m.myExport);
+ * ```
+ *
+ * @param props - The properties for the dynamic import statement.
+ * @returns A `VarDeclaration` component representing the dynamic import statement.
+ */
+declare function DynamicImportStatement(props: DynamicImportStatementProps): _alloy_js_core5.Children;
+declare type __ΩDynamicImportStatementProps = any[];
+//#endregion
+export { DynamicImportStatement, DynamicImportStatementProps, __ΩDynamicImportStatementProps };