@powerlines/plugin-nodejs 0.1.115 → 0.1.117

package/dist/plugin-alloy/src/core/components/single-line-comment.mjs

@@ -0,0 +1,21 @@
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import { Prose } from "@alloy-js/core";
+
+//#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
+export { SingleLineComment };

package/dist/plugin-alloy/src/core/components/source-file.cjs

@@ -0,0 +1,64 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_context = require('../contexts/context.cjs');
+require('../contexts/index.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_path_append = require("@stryke/path/append");
+
+//#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 }] = (0, __alloy_js_core.splitProps)(props, [
+		"children",
+		"meta",
+		"path",
+		"header",
+		"storage",
+		"filetype",
+		"reference"
+	]);
+	const metadata = require_context.useMetaSafe();
+	const parentDirectory = (0, __alloy_js_core.useContext)(__alloy_js_core.SourceDirectoryContext);
+	const sourceFile = {
+		path: (0, __stryke_path_append.appendPath)(path, parentDirectory.path),
+		filetype,
+		reference
+	};
+	parentDirectory?.addContent(sourceFile);
+	const printOptions = (0, __alloy_js_core.useFormatOptions)({
+		printWidth: props.printWidth,
+		tabWidth: props.tabWidth,
+		useTabs: props.useTabs,
+		insertFinalNewLine: props.insertFinalNewLine
+	});
+	const nodeContext = (0, __alloy_js_core.getContext)();
+	nodeContext.meta = (0, defu.default)({
+		sourceFile,
+		printOptions
+	}, meta ?? {});
+	if (metadata) metadata[sourceFile.path] = {
+		storage,
+		...meta ?? {}
+	};
+	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.SourceFileContext.Provider, {
+		value: sourceFile,
+		get children() {
+			return [(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+				when: header !== void 0,
+				get children() {
+					return [header, (0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {})];
+				}
+			}), children];
+		}
+	});
+}
+
+//#endregion
+exports.SourceFile = SourceFile;

package/dist/plugin-alloy/src/core/components/source-file.mjs

@@ -0,0 +1,62 @@
+import { useMetaSafe } from "../contexts/context.mjs";
+import "../contexts/index.mjs";
+import { createComponent, createIntrinsic } from "@alloy-js/core/jsx-runtime";
+import defu from "defu";
+import { Show, SourceDirectoryContext, SourceFileContext, getContext, splitProps, useContext, useFormatOptions } from "@alloy-js/core";
+import { appendPath } from "@stryke/path/append";
+
+//#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 = useMetaSafe();
+	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 ?? {});
+	if (metadata) 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
+export { SourceFile };

package/dist/plugin-alloy/src/core/contexts/context.cjs

@@ -0,0 +1,49 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region ../plugin-alloy/src/core/contexts/context.ts
+/**
+* The Powerlines context used in template rendering.
+*/
+const PowerlinesContext = (0, __alloy_js_core.createNamedContext)("powerlines");
+/**
+* Hook to access the Powerlines Context.
+*
+* @returns The Context.
+*/
+function usePowerlinesContext() {
+	return (0, __alloy_js_core.useContext)(PowerlinesContext);
+}
+/**
+* Hook to safely access the {@link PluginContext | Powerlines context}.
+*
+* @returns The Powerlines context or undefined if not set.
+*/
+function usePowerlinesSafe() {
+	return usePowerlinesContext()?.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;
+}
+
+//#endregion
+exports.PowerlinesContext = PowerlinesContext;
+exports.useMetaSafe = useMetaSafe;
+exports.usePowerlines = usePowerlines;
+exports.usePowerlinesContext = usePowerlinesContext;
+exports.usePowerlinesSafe = usePowerlinesSafe;

package/dist/plugin-alloy/src/core/contexts/context.mjs

@@ -0,0 +1,44 @@
+import { createNamedContext, useContext } from "@alloy-js/core";
+
+//#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()?.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;
+}
+
+//#endregion
+export { PowerlinesContext, useMetaSafe, usePowerlines, usePowerlinesContext, usePowerlinesSafe };

package/dist/plugin-alloy/src/core/contexts/index.cjs

@@ -0,0 +1,2 @@
+const require_context = require('./context.cjs');
+const require_reflection = require('./reflection.cjs');

package/dist/plugin-alloy/src/core/contexts/index.mjs

@@ -0,0 +1,4 @@
+import { PowerlinesContext, useMetaSafe, usePowerlines, usePowerlinesContext, usePowerlinesSafe } from "./context.mjs";
+import { ReflectionClassContext, ReflectionPropertyContext, useReflectionClass, useReflectionProperty } from "./reflection.mjs";
+
+export {  };

package/dist/plugin-alloy/src/core/contexts/reflection.cjs

@@ -0,0 +1,46 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#region ../plugin-alloy/src/core/contexts/reflection.ts
+/**
+* The reflection class context used in template rendering.
+*/
+const ReflectionClassContext = (0, __alloy_js_core.createContext)();
+/**
+* Hook to access the Reflection context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionClass() {
+	const context = (0, __alloy_js_core.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 = (0, __alloy_js_core.createNamedContext)("reflection-property");
+/**
+* Hook to access the Reflection Property context.
+*
+* @returns A reactive version of the current reflection.
+*/
+function useReflectionProperty() {
+	const context = (0, __alloy_js_core.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 = (0, __alloy_js_core.createNamedContext)("reflection-method");
+/**
+* The reflection parameter context used in template rendering.
+*/
+const ReflectionParameterContext = (0, __alloy_js_core.createNamedContext)("reflection-parameter");
+
+//#endregion
+exports.ReflectionClassContext = ReflectionClassContext;
+exports.ReflectionPropertyContext = ReflectionPropertyContext;
+exports.useReflectionClass = useReflectionClass;
+exports.useReflectionProperty = useReflectionProperty;

package/dist/plugin-alloy/src/core/contexts/reflection.mjs

@@ -0,0 +1,42 @@
+import { createContext, createNamedContext, useContext } from "@alloy-js/core";
+
+//#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
+export { ReflectionClassContext, ReflectionPropertyContext, useReflectionClass, useReflectionProperty };

package/dist/plugin-alloy/src/helpers/refkey.cjs

@@ -0,0 +1,16 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __alloy_js_core = require("@alloy-js/core");
+
+//#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(...args) {
+	return (0, __alloy_js_core.refkey)("powerlines", ...args);
+}
+
+//#endregion
+exports.refkey = refkey;

package/dist/plugin-alloy/src/helpers/refkey.mjs

@@ -0,0 +1,15 @@
+import { refkey } from "@alloy-js/core";
+
+//#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
+export { refkey$1 as refkey };

package/dist/plugin-alloy/src/index.cjs

@@ -0,0 +1,105 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_index = require('../../plugin-babel/src/index.cjs');
+const require_output = require('./core/components/output.cjs');
+let __alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __alloy_js_babel_preset = require("@alloy-js/babel-preset");
+__alloy_js_babel_preset = require_rolldown_runtime.__toESM(__alloy_js_babel_preset);
+let __alloy_js_core = require("@alloy-js/core");
+let __stryke_json_storm_json = require("@stryke/json/storm-json");
+
+//#region ../plugin-alloy/src/index.tsx
+/**
+* Alloy-js plugin for Powerlines.
+*
+* @param options - The Alloy-js plugin user configuration options.
+* @returns A Powerlines plugin that integrates Alloy-js transformations.
+*/
+const plugin = (options = {}) => {
+	return [
+		require_index.default(),
+		{
+			name: "alloy:config",
+			config() {
+				this.debug("Updating configuration options to support Alloy-js builds.");
+				return {
+					alloy: {
+						typescript: true,
+						...options
+					},
+					transform: { babel: { presets: [[
+						(0, __alloy_js_babel_preset.default)({ addSourceInfo: this.config.mode === "development" }),
+						{},
+						(_, id) => /^(?:m|c)?tsx?$/.test((0, __stryke_path_file_path_fns.findFileExtensionSafe)(id, { fullExtension: true }))
+					]] } },
+					build: {
+						inputOptions: { transform: { jsx: "preserve" } },
+						external: [
+							"@alloy-js/core",
+							"@alloy-js/typescript",
+							"@alloy-js/json",
+							"@alloy-js/markdown"
+						]
+					}
+				};
+			},
+			async configResolved() {
+				this.debug("Ensuring TypeScript configuration is set up for Alloy-js.");
+				if (this.tsconfig.tsconfigJson.compilerOptions?.jsx !== "preserve" || this.tsconfig.tsconfigJson.compilerOptions?.jsxImportSource !== "@alloy-js/core") {
+					this.tsconfig.tsconfigJson.compilerOptions ??= {};
+					if (this.tsconfig.tsconfigJson.compilerOptions.jsx !== "preserve") this.tsconfig.tsconfigJson.compilerOptions.jsx = "preserve";
+					if (this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource !== "@alloy-js/core") this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource = "@alloy-js/core";
+					await this.fs.write(this.tsconfig.tsconfigFilePath, __stryke_json_storm_json.StormJSON.stringify(this.tsconfig.tsconfigJson));
+				}
+			}
+		},
+		{
+			name: "alloy:create-render",
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.debug("Attaching the `render` method to the context object.");
+					this.render = async (children) => {
+						const _self$ = this;
+						const meta = {};
+						await (0, __alloy_js_core.traverseOutput)(await (0, __alloy_js_core.renderAsync)((0, __alloy_js_core_jsx_runtime.createComponent)(require_output.Output, {
+							context: _self$,
+							meta,
+							get basePath() {
+								return _self$.workspaceConfig.workspaceRoot;
+							},
+							children
+						})), {
+							visitDirectory: (directory) => {
+								if (this.fs.existsSync(directory.path)) return;
+								this.fs.mkdirSync(directory.path);
+							},
+							visitFile: (file) => {
+								if ("contents" in file) {
+									const metadata = meta[file.path] ?? {};
+									if (metadata.kind === "builtin") {
+										if (!metadata.id) throw new Error(`Built-in file "${file.path}" is missing its ID in the render metadata.`);
+										this.emitBuiltinSync(file.contents, metadata.id, {
+											skipFormat: metadata.skipFormat,
+											storage: metadata.storage,
+											extension: (0, __stryke_path_file_path_fns.findFileExtension)(file.path)
+										});
+									} else if (metadata.kind === "entry") this.emitEntrySync(file.contents, file.path, {
+										skipFormat: metadata.skipFormat,
+										storage: metadata.storage,
+										...metadata.typeDefinition ?? {}
+									});
+									else this.emitSync(file.contents, file.path, metadata);
+								} else this.fs.copySync(file.sourcePath, file.path);
+							}
+						});
+					};
+				}
+			}
+		}
+	];
+};
+var src_default$1 = plugin;
+
+//#endregion
+exports.default = src_default$1;

package/dist/plugin-alloy/src/index.mjs

@@ -0,0 +1,103 @@
+import src_default from "../../plugin-babel/src/index.mjs";
+import { Output as Output$1 } from "./core/components/output.mjs";
+import { createComponent } from "@alloy-js/core/jsx-runtime";
+import { findFileExtension, findFileExtensionSafe } from "@stryke/path/file-path-fns";
+import alloyPreset from "@alloy-js/babel-preset";
+import { renderAsync, traverseOutput } from "@alloy-js/core";
+import { StormJSON } from "@stryke/json/storm-json";
+
+//#region ../plugin-alloy/src/index.tsx
+/**
+* Alloy-js plugin for Powerlines.
+*
+* @param options - The Alloy-js plugin user configuration options.
+* @returns A Powerlines plugin that integrates Alloy-js transformations.
+*/
+const plugin = (options = {}) => {
+	return [
+		src_default(),
+		{
+			name: "alloy:config",
+			config() {
+				this.debug("Updating configuration options to support Alloy-js builds.");
+				return {
+					alloy: {
+						typescript: true,
+						...options
+					},
+					transform: { babel: { presets: [[
+						alloyPreset({ addSourceInfo: this.config.mode === "development" }),
+						{},
+						(_, id) => /^(?:m|c)?tsx?$/.test(findFileExtensionSafe(id, { fullExtension: true }))
+					]] } },
+					build: {
+						inputOptions: { transform: { jsx: "preserve" } },
+						external: [
+							"@alloy-js/core",
+							"@alloy-js/typescript",
+							"@alloy-js/json",
+							"@alloy-js/markdown"
+						]
+					}
+				};
+			},
+			async configResolved() {
+				this.debug("Ensuring TypeScript configuration is set up for Alloy-js.");
+				if (this.tsconfig.tsconfigJson.compilerOptions?.jsx !== "preserve" || this.tsconfig.tsconfigJson.compilerOptions?.jsxImportSource !== "@alloy-js/core") {
+					this.tsconfig.tsconfigJson.compilerOptions ??= {};
+					if (this.tsconfig.tsconfigJson.compilerOptions.jsx !== "preserve") this.tsconfig.tsconfigJson.compilerOptions.jsx = "preserve";
+					if (this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource !== "@alloy-js/core") this.tsconfig.tsconfigJson.compilerOptions.jsxImportSource = "@alloy-js/core";
+					await this.fs.write(this.tsconfig.tsconfigFilePath, StormJSON.stringify(this.tsconfig.tsconfigJson));
+				}
+			}
+		},
+		{
+			name: "alloy:create-render",
+			configResolved: {
+				order: "pre",
+				async handler() {
+					this.debug("Attaching the `render` method to the context object.");
+					this.render = async (children) => {
+						const _self$ = this;
+						const meta = {};
+						await traverseOutput(await renderAsync(createComponent(Output$1, {
+							context: _self$,
+							meta,
+							get basePath() {
+								return _self$.workspaceConfig.workspaceRoot;
+							},
+							children
+						})), {
+							visitDirectory: (directory) => {
+								if (this.fs.existsSync(directory.path)) return;
+								this.fs.mkdirSync(directory.path);
+							},
+							visitFile: (file) => {
+								if ("contents" in file) {
+									const metadata = meta[file.path] ?? {};
+									if (metadata.kind === "builtin") {
+										if (!metadata.id) throw new Error(`Built-in file "${file.path}" is missing its ID in the render metadata.`);
+										this.emitBuiltinSync(file.contents, metadata.id, {
+											skipFormat: metadata.skipFormat,
+											storage: metadata.storage,
+											extension: findFileExtension(file.path)
+										});
+									} else if (metadata.kind === "entry") this.emitEntrySync(file.contents, file.path, {
+										skipFormat: metadata.skipFormat,
+										storage: metadata.storage,
+										...metadata.typeDefinition ?? {}
+									});
+									else this.emitSync(file.contents, file.path, metadata);
+								} else this.fs.copySync(file.sourcePath, file.path);
+							}
+						});
+					};
+				}
+			}
+		}
+	];
+};
+var src_default$1 = plugin;
+
+//#endregion
+export { src_default$1 as default };