@powerlines/plugin-react 0.1.132 → 0.1.133

package/dist/react-optimized-BpFTLlx0.mjs

@@ -0,0 +1,937 @@
+import { createComponent, createIntrinsic, memo, mergeProps } from "@alloy-js/core/jsx-runtime";
+import { ReflectionKind } from "@powerlines/deepkit/vendor/type";
+import { hasFileExtension } from "@stryke/path/file-path-fns";
+import defu from "defu";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isString } from "@stryke/type-checks/is-string";
+import { For, List, Prose, Scope, Show, SourceDirectoryContext, SourceFileContext, childrenArray, code, computed, createContext, createNamedContext, getContext, refkey, splitProps, useContext, useFormatOptions, useScope } from "@alloy-js/core";
+import { StormJSON } from "@stryke/json/storm-json";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { appendPath } from "@stryke/path/append";
+import { getUniqueBy } from "@stryke/helpers/get-unique";
+import { isNull } from "@stryke/type-checks/is-null";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { FunctionDeclaration, ImportStatements, PackageContext, SourceFileContext as SourceFileContext$1, TSModuleScope, getSourceDirectoryData, useSourceFile } from "@alloy-js/typescript";
+import { isSet } from "@stryke/type-checks/is-set";
+import { isBoolean } from "@stryke/type-checks/is-boolean";
+
+//#region ../plugin-alloy/src/core/contexts/context.ts
+/**
+* The Powerlines context used in template rendering.
+*/
+const PowerlinesContext = createNamedContext("powerlines");
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function usePowerlinesContext() {
+	return useContext(PowerlinesContext);
+}
+/**
+* Hook to safely access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context or undefined if not set.
+*/
+function usePowerlinesSafe() {
+	return usePowerlinesContext()?.ref?.value;
+}
+/**
+* Hook to access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context.
+*/
+function usePowerlines() {
+	const powerlines = usePowerlinesSafe();
+	if (!powerlines) throw new 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 powerlines;
+}
+/**
+* Hook to safely access the render context's metadata.
+*
+* @returns The Powerlines context or undefined if not set.
+*/
+function useMetaSafe() {
+	return usePowerlinesContext()?.meta?.value;
+}
+/**
+* Hook to access the render context's metadata.
+*
+* @returns The Powerlines context.
+*/
+function useMeta() {
+	const meta = useMetaSafe();
+	if (!meta) throw new 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 meta;
+}
+
+//#endregion
+//#region ../deepkit/src/utilities.ts
+/**
+* Converts any {@link ReflectionProperty} or {@link ReflectionParameter}'s value to string representation.
+*
+* @param property - The {@link ReflectionProperty} or {@link ReflectionParameter} containing the value to stringify.
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyDefaultValue(property, value) {
+	return stringifyValue(property.type, value ?? property.getDefaultValue());
+}
+/**
+* Stringifies a value as a string.
+*
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyStringValue(value) {
+	return `"${String(value).replaceAll("\"", "\\\"")}"`;
+}
+/**
+* Converts any {@link Type}'s actual value to string representation.
+*
+* @param type - The {@link Type} of the value to stringify.
+* @param value - The value to stringify.
+* @returns A string representation of the value.
+*/
+function stringifyValue(type, value) {
+	return isUndefined(value) ? "undefined" : isNull(value) ? "null" : type.kind === ReflectionKind.boolean ? String(value).trim().toLowerCase() === "true" ? "true" : "false" : type.kind === ReflectionKind.string || type.kind === ReflectionKind.literal && isString(type.literal) ? stringifyStringValue(value) : type.kind === ReflectionKind.enum ? getEnumReflectionType(type).kind === ReflectionKind.string ? stringifyStringValue(value) : `${String(value)}` : type.kind === ReflectionKind.union ? isStringUnion(type) ? stringifyStringValue(value) : `${String(value)}` : type.kind === ReflectionKind.array ? stringifyStringValue(StormJSON.stringify(value)) : type.kind === ReflectionKind.object || type.kind === ReflectionKind.objectLiteral ? StormJSON.stringify(value) : type.kind === ReflectionKind.property || type.kind === ReflectionKind.parameter ? stringifyValue(type.type, value) : String(value);
+}
+/**
+* Converts a {@link TypeEnum} to its underlying primitive type representation.
+*
+* @param type - The {@link TypeEnum} to evaluate.
+* @returns A string representation of the primitive type.
+*/
+function getEnumReflectionType(type) {
+	if (type.kind !== ReflectionKind.enum) throw new Error(`Expected a TypeEnum, but received ${type.kind}.`);
+	const unique = getUniqueBy(type.values.filter((value) => value !== void 0 && value !== null), (enumMember) => isString(enumMember) ? { kind: ReflectionKind.string } : { kind: ReflectionKind.number });
+	if (unique.length === 0) throw new Error(`No valid enum members could be found.`);
+	return unique[0] && isString(unique[0]) ? { kind: ReflectionKind.string } : { kind: ReflectionKind.number };
+}
+/**
+* Converts a {@link TypeUnion} to its underlying primitive type representation.
+*
+* @param type - The {@link TypeUnion} to evaluate.
+* @returns A string representation of the primitive type.
+*/
+function getUnionTypes(type) {
+	if (type.kind === ReflectionKind.union && type.types.length > 0) return getUniqueBy(type.types, (member) => member.kind);
+	throw new Error(`Expected a TypeUnion, but received ${type.kind}.`);
+}
+function isStringUnion(type) {
+	return getUnionTypes(type).some((member) => member.kind === ReflectionKind.string || member.kind === ReflectionKind.literal && isString(member.literal));
+}
+
+//#endregion
+//#region ../plugin-alloy/src/helpers/refkey.ts
+/**
+* Create a refkey for the provided arguments. Passing no arguments returns a fresh refkey that is guaranteed to be unique. Otherwise, the arguments passed will be used to create a refkey for those values. Providing the same arguments will always return the same refkey.
+*
+* @remarks
+* Values are compared using the SameValueZero algorithm, which considers objects the same if they are reference identical, and primitives the same if they are the same value, with the exception of `NaN`, which is always considered equal to other `NaN` values, and `-0`, which is considered identical to `+0`
+*/
+function refkey$1(...args) {
+	return refkey("powerlines", ...args);
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/tsdoc.tsx
+/**
+* Generates a TypeScript interface for the given reflection class.
+*/
+function TSDoc(props) {
+	const [{ children, heading }] = splitProps(props, ["children", "heading"]);
+	return [
+		"/**",
+		createIntrinsic("align", {
+			string: " * ",
+			get children() {
+				return [
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return !isUndefined(heading);
+						},
+						get children() {
+							return [
+								heading,
+								createIntrinsic("hbr", {}),
+								createComponent(Show, {
+									get when() {
+										return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+									},
+									get children() {
+										return createIntrinsic("hbr", {});
+									}
+								})
+							];
+						}
+					}),
+					createComponent(Show, {
+						get when() {
+							return memo(() => !!!isUndefined(children))() && childrenArray(() => children).length > 0;
+						},
+						get children() {
+							return createComponent(List, { get children() {
+								return childrenArray(() => children);
+							} });
+						}
+					})
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`,
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@<props.tag>` tag.
+*/
+function TSDocTag(props) {
+	const [{ children, tag }] = splitProps(props, ["children", "tag"]);
+	return [
+		`@${tag} `,
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { children });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@title` tag.
+*/
+function TSDocTitle(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "title",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@domain` tag.
+*/
+function TSDocDomain(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "domain",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@alias` tag.
+*/
+function TSDocAlias(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "alias",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@permission` tag.
+*/
+function TSDocPermission(props) {
+	const [{ children }, rest] = splitProps(props, ["children"]);
+	return createComponent(TSDocTag, mergeProps(rest, {
+		tag: "permission",
+		children
+	}));
+}
+/**
+* Create a TSDoc `@defaultValue` tag.
+*/
+function TSDocDefaultValue(props) {
+	return [
+		"@defaultValue ",
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(props.value);
+			},
+			get children() {
+				return createIntrinsic("align", {
+					width: 2,
+					get children() {
+						return createComponent(Prose, { get children() {
+							return stringifyDefaultValue(props.value);
+						} });
+					}
+				});
+			}
+		}),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Create a TSDoc `@remarks` tag.
+*/
+function TSDocRemarks(props) {
+	return [
+		"@remarks ",
+		createIntrinsic("hbr", {}),
+		createComponent(List, {
+			hardline: true,
+			get children() {
+				return childrenArray(() => props.children);
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@see` tag.
+*/
+function TSDocLink(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "see" }));
+}
+/**
+* Create a TSDoc `@example` tag.
+*/
+function TSDocExample(props) {
+	const [{ tsx, fenced = true, language, children }] = splitProps(props, [
+		"tsx",
+		"fenced",
+		"language",
+		"children"
+	]);
+	return [
+		"@example ",
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			when: fenced,
+			get children() {
+				return [
+					"```",
+					language || (tsx ? "tsx" : "ts"),
+					createIntrinsic("hbr", {})
+				];
+			}
+		}),
+		children,
+		createComponent(Show, {
+			when: fenced,
+			get children() {
+				return [createIntrinsic("hbr", {}), "```"];
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc `@readonly` tag.
+*/
+function TSDocReadonly() {
+	return createComponent(TSDocTag, { tag: "readonly" });
+}
+/**
+* Create a TSDoc `@internal` tag.
+*/
+function TSDocInternal() {
+	return createComponent(TSDocTag, { tag: "internal" });
+}
+/**
+* Create a TSDoc `@ignore` tag.
+*/
+function TSDocIgnore() {
+	return createComponent(TSDocTag, { tag: "ignore" });
+}
+/**
+* Create a TSDoc `@hidden` tag.
+*/
+function TSDocHidden() {
+	return createComponent(TSDocTag, { tag: "hidden" });
+}
+/**
+* Generates a TypeScript interface property for the given reflection class.
+*/
+function TSDocAttributesTags(props) {
+	const [{ title, alias, permission, domain, readonly, internal, ignore, hidden, defaultValue }] = splitProps(props, [
+		"title",
+		"alias",
+		"permission",
+		"domain",
+		"readonly",
+		"internal",
+		"ignore",
+		"hidden",
+		"defaultValue"
+	]);
+	return [
+		createComponent(Show, {
+			get when() {
+				return isSetString(title);
+			},
+			get children() {
+				return createComponent(TSDocTitle, { children: title });
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(alias) && alias.length > 0;
+			},
+			get children() {
+				return createComponent(For, {
+					each: alias ?? [],
+					children: (alias$1) => createComponent(TSDocAlias, { children: alias$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return isSetString(domain);
+			},
+			get children() {
+				return createComponent(TSDocDomain, { children: domain });
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(permission) && permission.length > 0;
+			},
+			get children() {
+				return createComponent(For, {
+					each: permission ?? [],
+					children: (permission$1) => createComponent(TSDocPermission, { children: permission$1 })
+				});
+			}
+		}),
+		createComponent(Show, {
+			when: readonly === true,
+			get children() {
+				return createComponent(TSDocReadonly, {});
+			}
+		}),
+		createComponent(Show, {
+			when: internal === true,
+			get children() {
+				return createComponent(TSDocInternal, {});
+			}
+		}),
+		createComponent(Show, {
+			when: ignore === true,
+			get children() {
+				return createComponent(TSDocIgnore, {});
+			}
+		}),
+		createComponent(Show, {
+			when: hidden === true,
+			get children() {
+				return createComponent(TSDocHidden, {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return !isUndefined(defaultValue);
+			},
+			get children() {
+				return createComponent(TSDocDefaultValue, { value: defaultValue });
+			}
+		})
+	];
+}
+/**
+* Create a TSDoc parameter set off with `@param`.
+*/
+function TSDocParam(props) {
+	return [
+		"@param ",
+		createComponent(TSDocParamName, {
+			get name() {
+				return props.name;
+			},
+			get optional() {
+				return props.optional;
+			},
+			get defaultValue() {
+				return props.defaultValue;
+			}
+		}),
+		createComponent(TSDocParamDescription, { get children() {
+			return props.children;
+		} })
+	];
+}
+function TSDocParamName(props) {
+	return [
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "["
+		}),
+		memo(() => props.name),
+		createComponent(Show, {
+			get when() {
+				return Boolean(props.defaultValue);
+			},
+			get children() {
+				return ["=", memo(() => props.defaultValue)];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return props.optional;
+			},
+			children: "]"
+		})
+	];
+}
+function TSDocParamDescription(props) {
+	return createComponent(Show, {
+		get when() {
+			return Boolean(props.children);
+		},
+		get children() {
+			return [" - ", createIntrinsic("align", {
+				width: 2,
+				get children() {
+					return createComponent(Prose, { get children() {
+						return props.children;
+					} });
+				}
+			})];
+		}
+	});
+}
+/**
+* Create a TSDoc `@returns` tag.
+*/
+function TSDocReturns(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "returns" }));
+}
+/**
+* Create a TSDoc `@throws` tag.
+*/
+function TSDocThrows(props) {
+	return createComponent(TSDocTag, mergeProps(props, { tag: "throws" }));
+}
+/**
+* Generates a TSDoc `@module` tag for the given module name.
+*/
+function TSDocModule(props) {
+	const [{ children, name, prefix }] = splitProps(props, [
+		"children",
+		"name",
+		"prefix"
+	]);
+	const context = usePowerlines();
+	return [
+		"/**",
+		createIntrinsic("align", {
+			string: " * ",
+			get children() {
+				return [
+					createIntrinsic("hbr", {}),
+					createComponent(Show, {
+						get when() {
+							return Boolean(children);
+						},
+						get children() {
+							return [
+								createComponent(List, {
+									hardline: true,
+									get children() {
+										return childrenArray(() => children);
+									}
+								}),
+								createIntrinsic("hbr", {}),
+								createIntrinsic("hbr", {})
+							];
+						}
+					}),
+					"@module ",
+					memo(() => prefix || context?.config.output.builtinPrefix),
+					":",
+					name
+				];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		` */`
+	];
+}
+
+//#endregion
+//#region ../plugin-alloy/src/core/components/single-line-comment.tsx
+/**
+* A single line comment block. The children are rendered as a prose element, which means that they
+* are broken into multiple lines
+*/
+function SingleLineComment(props) {
+	const { variant = "double-slash", children } = props;
+	const commentStart = variant === "slash-star" ? "/* " : variant === "slash-star-star" ? "/** " : variant === "triple-slash" ? "/// " : variant === "markdown" ? "<!-- " : "// ";
+	return [commentStart, createIntrinsic("align", {
+		string: commentStart,
+		get children() {
+			return [createComponent(Prose, { children }), variant === "slash-star" || variant === "slash-star-star" ? " */ " : variant === "markdown" ? " -->" : ""];
+		}
+	})];
+}
+
+//#endregion
+//#region ../plugin-alloy/src/core/contexts/reflection.ts
+/**
+* The reflection class context used in template rendering.
+*/
+const ReflectionClassContext = createContext();
+/**
+* Hook to access the Reflection context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionClass() {
+	const context = useContext(ReflectionClassContext);
+	if (!context) throw new Error("Powerlines - ReflectionClass 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 context;
+}
+/**
+* The reflection property context used in template rendering.
+*/
+const ReflectionPropertyContext = createNamedContext("reflection-property");
+/**
+* Hook to access the Reflection Property context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionProperty() {
+	const context = useContext(ReflectionPropertyContext);
+	if (!context) throw new Error("Powerlines - Reflection Property 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 context;
+}
+/**
+* The reflection method context used in template rendering.
+*/
+const ReflectionMethodContext = createNamedContext("reflection-method");
+/**
+* The reflection parameter context used in template rendering.
+*/
+const ReflectionParameterContext = createNamedContext("reflection-parameter");
+
+//#endregion
+//#region ../plugin-alloy/src/core/components/source-file.tsx
+/**
+* A base component representing a Powerlines generated source file.
+*
+* @param props - The properties for the source file.
+* @returns The rendered source file component.
+*/
+function SourceFile(props) {
+	const [{ children, meta, path, header, storage, filetype, reference }] = splitProps(props, [
+		"children",
+		"meta",
+		"path",
+		"header",
+		"storage",
+		"filetype",
+		"reference"
+	]);
+	const metadata = useMeta();
+	const parentDirectory = useContext(SourceDirectoryContext);
+	const sourceFile = {
+		path: appendPath(path, parentDirectory.path),
+		filetype,
+		reference
+	};
+	parentDirectory?.addContent(sourceFile);
+	const printOptions = useFormatOptions({
+		printWidth: props.printWidth,
+		tabWidth: props.tabWidth,
+		useTabs: props.useTabs,
+		insertFinalNewLine: props.insertFinalNewLine
+	});
+	const nodeContext = getContext();
+	nodeContext.meta = defu({
+		sourceFile,
+		printOptions
+	}, meta ?? {});
+	metadata[sourceFile.path] = {
+		storage,
+		...meta ?? {}
+	};
+	return createComponent(SourceFileContext.Provider, {
+		value: sourceFile,
+		get children() {
+			return [createComponent(Show, {
+				when: header !== void 0,
+				get children() {
+					return [header, createIntrinsic("hbr", {})];
+				}
+			}), children];
+		}
+	});
+}
+
+//#endregion
+//#region ../plugin-alloy/src/typescript/components/typescript-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 TypescriptFile(props) {
+	const [{ children, path, imports, tsx, header, hashbang }, rest] = splitProps(props, [
+		"children",
+		"path",
+		"imports",
+		"tsx",
+		"header",
+		"hashbang"
+	]);
+	const directoryContext = useContext(SourceDirectoryContext);
+	const sdData = getSourceDirectoryData(directoryContext);
+	const modulePath = appendPath(path, directoryContext.path);
+	const scope = new TSModuleScope(modulePath, useScope());
+	sdData.modules.add(scope);
+	const pkg = useContext(PackageContext);
+	if (pkg) pkg.scope.addModule(scope);
+	if (props.export) {
+		if (pkg) if (isBoolean(props.export)) pkg.scope.addExport(modulePath, scope);
+		else pkg.scope.addExport(props.export, scope);
+	}
+	return createComponent(SourceFileContext$1.Provider, {
+		value: { scope },
+		get children() {
+			return createComponent(Scope, {
+				value: scope,
+				get children() {
+					return createComponent(SourceFile, mergeProps(rest, {
+						path: modulePath,
+						get header() {
+							return header ?? createComponent(TypescriptFileHeader, {
+								hashbang,
+								get children() {
+									return createComponent(TypescriptFileHeaderImports, {
+										imports,
+										scope
+									});
+								}
+							});
+						},
+						filetype: tsx ? "tsx" : "typescript",
+						children
+					}));
+				}
+			});
+		}
+	});
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function TypescriptFileHeader(props) {
+	const { header, hashbang, disableEslint = true, disableBiome = true, disablePrettier = false, children } = props;
+	const context = usePowerlines();
+	return [
+		createComponent(Show, {
+			get when() {
+				return Boolean(hashbang);
+			},
+			get children() {
+				return [memo(() => hashbang === true ? code`#!/usr/bin/env ${context?.config.mode === "development" ? "-S NODE_OPTIONS=--enable-source-maps" : ""} node` : hashbang), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(header);
+			},
+			get children() {
+				return [header, createIntrinsic("hbr", {})];
+			}
+		}),
+		createIntrinsic("hbr", {}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableEslint);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "slash-star",
+					children: "eslint-disable"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disablePrettier);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, {
+					variant: "slash-star",
+					children: "prettier-ignore"
+				}), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableBiome);
+			},
+			get children() {
+				return [createComponent(SingleLineComment, { children: "biome-ignore lint: disable" }), createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(disableEslint) || Boolean(disablePrettier) || Boolean(disableBiome);
+			},
+			get children() {
+				return createIntrinsic("hbr", {});
+			}
+		}),
+		createComponent(Show, {
+			get when() {
+				return Boolean(children);
+			},
+			get children() {
+				return [children, createIntrinsic("hbr", {})];
+			}
+		}),
+		createComponent(SingleLineComment, { get children() {
+			return code`Generated by ${titleCase(context?.config.framework) || "Powerlines"}`;
+		} }),
+		createIntrinsic("hbr", {}),
+		createComponent(SingleLineComment, { children: code`NOTE: Do not edit this file manually - it will be overwritten automatically by the "prepare" command` }),
+		createIntrinsic("hbr", {})
+	];
+}
+/**
+* Renders the header for a Powerlines Typescript source file.
+*
+* @param props - The properties for the source file header.
+* @returns The rendered source file header.
+*/
+function TypescriptFileHeaderImports(props) {
+	const { imports } = props;
+	const context = usePowerlines();
+	const sourceFile = useSourceFile();
+	const scope = props.scope ?? sourceFile.scope;
+	return createComponent(Show, {
+		get when() {
+			return scope.importedModules.size > 0 || !!imports && Object.keys(imports).length > 0;
+		},
+		get children() {
+			return [
+				createComponent(Show, {
+					get when() {
+						return !!imports && Object.keys(imports).length > 0;
+					},
+					get children() {
+						return Object.entries(imports ?? {}).filter(([key]) => key !== "$builtins").concat(imports && imports.$builtins ? Object.entries(imports.$builtins).map(([key, entry]) => [key.includes(":") ? key : `${context.config.output.builtinPrefix}:${key}`, entry]) : []).map(([module, imported]) => {
+							return code`import ${imported === null ? "" : imported.filter((i) => !isString(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (imported.filter((i) => !isString(i) && i.default).length > 0 && imported.filter((i) => isString(i) || !i.default).length > 0 ? ", " : "") + (imported.filter((i) => isString(i) || !i.default).length > 0 ? `{ ${imported.map((i) => isString(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} from "${module}";`;
+						});
+					}
+				}),
+				createComponent(Show, {
+					get when() {
+						return scope.importedModules.size > 0;
+					},
+					get children() {
+						return createComponent(ImportStatements, { get records() {
+							return scope.importedModules;
+						} });
+					}
+				}),
+				createIntrinsic("hbr", {})
+			];
+		}
+	});
+}
+
+//#endregion
+//#region ../plugin-alloy/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, id, description, tsx }, rest] = splitProps(props, [
+		"children",
+		"imports",
+		"id",
+		"description",
+		"tsx"
+	]);
+	const context = usePowerlines();
+	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 });
+				}
+			});
+		},
+		get meta() {
+			return {
+				kind: "builtin",
+				id: replaceExtension(id)
+			};
+		}
+	}, rest, {
+		get path() {
+			return path.value;
+		},
+		children
+	}));
+}
+
+//#endregion
+//#region src/components/react-optimized.tsx
+const isOptimizationEnabledRefkey = refkey$1("isOptimizationEnabled");
+/**
+* Generates the `react/optimized` builtin module for the Powerlines project.
+*/
+function ReactOptimizedBuiltin(props) {
+	const [{ override }, rest] = splitProps(props, ["override"]);
+	return createComponent(BuiltinFile, mergeProps(rest, {
+		id: "react/optimized",
+		description: "A built-in module to provide access to environment configuration to determine React optimizations.",
+		get imports() {
+			return defu({ $builtins: { env: ["env", "isDevelopment"] } }, rest.imports ?? {});
+		},
+		get children() {
+			return [createComponent(TSDoc, {
+				heading: "A gating function to determine if the optimized [React compiler](https://react.dev/reference/react-compiler) source code should be used.",
+				get children() {
+					return [createComponent(TSDocLink, { children: `https://react.dev/reference/react-compiler/gating` }), createComponent(TSDocReturns, { children: `A boolean indicating if the React compiler's optimizations should be used.` })];
+				}
+			}), createComponent(FunctionDeclaration, {
+				refkey: isOptimizationEnabledRefkey,
+				async: false,
+				"export": true,
+				name: "isOptimizationEnabled",
+				returnType: "boolean",
+				get children() {
+					return [createComponent(Show, {
+						when: override !== void 0,
+						fallback: code`return !env.DISABLE_REACT_COMPILER && !isDevelopment; `,
+						children: code`return ${override};`
+					}), createIntrinsic("hbr", {})];
+				}
+			})];
+		}
+	}));
+}
+
+//#endregion
+export { PowerlinesContext as _, useReflectionClass as a, TSDocAttributesTags as c, TSDocParam as d, TSDocRemarks as f, stringifyDefaultValue as g, refkey$1 as h, ReflectionPropertyContext as i, TSDocExample as l, TSDocThrows as m, BuiltinFile as n, useReflectionProperty as o, TSDocReturns as p, ReflectionClassContext as r, TSDoc as s, ReactOptimizedBuiltin as t, TSDocLink as u, usePowerlines as v };