@powerlines/plugin-env 0.15.4 → 0.15.6

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

@@ -0,0 +1,127 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_toc = require('./types/toc.cjs');
+const require_plugin = require('./types/plugin.cjs');
+const require_plugin$1 = require('../../powerlines/src/types/plugin.cjs');
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_fs_is_file = require("@stryke/fs/is-file");
+let __stryke_fs_list_files = require("@stryke/fs/list-files");
+let __stryke_path_append = require("@stryke/path/append");
+let __stryke_path_is_type = require("@stryke/path/is-type");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let automd = require("automd");
+let c12 = require("c12");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let markdown_toc = require("markdown-toc");
+markdown_toc = require_rolldown_runtime.__toESM(markdown_toc);
+
+//#region ../plugin-automd/src/index.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* AutoMD Plugin
+*
+* @remarks
+* A Powerlines plugin to use the AutoMD markdown transformer during the prepare task.
+*
+* @see https://automd.unjs.io/
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = __assignType((options = {}) => {
+	return {
+		name: "automd",
+		config: __assignType(async function config() {
+			const config$1 = await (0, automd.loadConfig)((0, __stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.projectRoot), options);
+			if (!config$1.prefix || !Array.isArray(config$1.prefix)) config$1.prefix = (0, __stryke_convert_to_array.toArray)(config$1.prefix ?? []);
+			if (!config$1.prefix.includes("automd")) config$1.prefix.push("automd");
+			if (!config$1.prefix.includes("powerlines")) config$1.prefix.push("powerlines");
+			return { automd: (0, defu.default)(config$1 ?? {}, {
+				configFile: options.configFile,
+				allowIssues: true,
+				dir: this.config.projectRoot,
+				watch: false,
+				input: "README.md",
+				toc: {
+					maxDepth: 6,
+					bullets: "-"
+				}
+			}) };
+		}, ["config", "P\"/!"]),
+		async configResolved() {
+			if (this.config.framework && !(0, __stryke_convert_to_array.toArray)(this.config.automd.prefix).includes(this.config.framework)) this.config.automd.prefix = (0, __stryke_convert_to_array.toArray)(this.config.automd.prefix).concat(this.config.framework);
+			if (this.config.automd.configFile) {
+				const { config } = await (c12.loadConfig.Ω = [["!"]], (0, c12.loadConfig)({
+					cwd: this.config.automd.dir,
+					configFile: this.config.automd.configFile,
+					defaults: {
+						ignore: [
+							"**/node_modules",
+							"**/dist",
+							"**/.*"
+						],
+						dir: this.config.automd.dir
+					}
+				}));
+				this.config.automd = (0, automd.resolveConfig)((0, defu.default)(this.config.automd, {
+					...config,
+					prefix: (0, __stryke_convert_to_array.toArray)(config.prefix ?? [])
+				}));
+			}
+			this.config.automd.input = (await Promise.all((0, __stryke_convert_to_array.toArray)(this.config.automd.input).map(__assignType(async (input) => {
+				if (input.includes("*")) return (0, __stryke_fs_list_files.listFiles)((0, __stryke_path_is_type.isAbsolutePath)(input) ? input : (0, __stryke_path_append.appendPath)(input, this.config.projectRoot), { ignore: this.config.automd.ignore });
+				return (0, __stryke_path_is_type.isAbsolutePath)(input) ? input : (0, __stryke_path_append.appendPath)(input, this.config.projectRoot);
+			}, [
+				"input",
+				"",
+				"P\"2!\"/\""
+			])))).flat();
+			if (this.config.automd.output && !(0, __stryke_path_is_type.isAbsolutePath)(this.config.automd.output)) this.config.automd.output = (0, __stryke_path_append.appendPath)(this.config.automd.output, this.config.projectRoot);
+			this.config.automd.generators ??= {};
+			if (this.config.automd.toc !== false) this.config.automd.generators.toc ??= {
+				name: "toc",
+				generate: __assignType((ctx) => {
+					const opts = this.config.automd.toc ?? {};
+					return { contents: (0, markdown_toc.default)(ctx.block.md, {
+						...opts,
+						maxdepth: opts.maxDepth,
+						first1: opts.firstH1
+					}).content };
+				}, [
+					"ctx",
+					"",
+					"P!2!!/\""
+				])
+			};
+		},
+		async docs() {
+			await Promise.all((0, __stryke_convert_to_array.toArray)(this.config.automd.input).map(__assignType(async (input) => {
+				const contents = await this.fs.read(input);
+				if (contents) {
+					const result = await (0, automd.transform)(contents, this.config.automd);
+					if (result.hasIssues && this.config.automd.allowIssues === false) throw new Error(`AutoMD found issues in file "${input}". Please resolve the issues or set \`allowIssues\` to true in the plugin configuration to ignore them.`);
+					if (result.hasChanged) await this.fs.write((0, __stryke_path_append.appendPath)(this.config.automd.output ? (0, __stryke_fs_is_file.isDirectory)(this.config.automd.output) ? (0, __stryke_path_replace.replacePath)(input, this.config.automd.output) : this.config.automd.output : input, this.config.projectRoot), result.contents);
+				}
+			}, [
+				"input",
+				"",
+				"P\"2!\"/\""
+			])));
+		}
+	};
+}, [
+	() => require_plugin.__ΩAutoMDPluginOptions,
+	"options",
+	() => ({}),
+	() => require_plugin$1.__ΩPlugin,
+	"",
+	"Pn!2\">#\"o$\"/%"
+]);
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;

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

@@ -0,0 +1,124 @@
+import { __ΩTOCOptions } from "./types/toc.mjs";
+import { __ΩAutoMDPluginOptions } from "./types/plugin.mjs";
+import { __ΩPlugin } from "../../powerlines/src/types/plugin.mjs";
+import { replacePath } from "@stryke/path/replace";
+import { toArray } from "@stryke/convert/to-array";
+import { isDirectory } from "@stryke/fs/is-file";
+import { listFiles } from "@stryke/fs/list-files";
+import { appendPath } from "@stryke/path/append";
+import { isAbsolutePath } from "@stryke/path/is-type";
+import { joinPaths } from "@stryke/path/join-paths";
+import { loadConfig, resolveConfig, transform } from "automd";
+import { loadConfig as loadConfig$1 } from "c12";
+import defu$1 from "defu";
+import toc from "markdown-toc";
+
+//#region ../plugin-automd/src/index.ts
+function __assignType(fn, args) {
+	fn.__type = args;
+	return fn;
+}
+/**
+* AutoMD Plugin
+*
+* @remarks
+* A Powerlines plugin to use the AutoMD markdown transformer during the prepare task.
+*
+* @see https://automd.unjs.io/
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = __assignType((options = {}) => {
+	return {
+		name: "automd",
+		config: __assignType(async function config() {
+			const config$1 = await loadConfig(joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot), options);
+			if (!config$1.prefix || !Array.isArray(config$1.prefix)) config$1.prefix = toArray(config$1.prefix ?? []);
+			if (!config$1.prefix.includes("automd")) config$1.prefix.push("automd");
+			if (!config$1.prefix.includes("powerlines")) config$1.prefix.push("powerlines");
+			return { automd: defu$1(config$1 ?? {}, {
+				configFile: options.configFile,
+				allowIssues: true,
+				dir: this.config.projectRoot,
+				watch: false,
+				input: "README.md",
+				toc: {
+					maxDepth: 6,
+					bullets: "-"
+				}
+			}) };
+		}, ["config", "P\"/!"]),
+		async configResolved() {
+			if (this.config.framework && !toArray(this.config.automd.prefix).includes(this.config.framework)) this.config.automd.prefix = toArray(this.config.automd.prefix).concat(this.config.framework);
+			if (this.config.automd.configFile) {
+				const { config } = await (loadConfig$1.Ω = [["!"]], loadConfig$1({
+					cwd: this.config.automd.dir,
+					configFile: this.config.automd.configFile,
+					defaults: {
+						ignore: [
+							"**/node_modules",
+							"**/dist",
+							"**/.*"
+						],
+						dir: this.config.automd.dir
+					}
+				}));
+				this.config.automd = resolveConfig(defu$1(this.config.automd, {
+					...config,
+					prefix: toArray(config.prefix ?? [])
+				}));
+			}
+			this.config.automd.input = (await Promise.all(toArray(this.config.automd.input).map(__assignType(async (input) => {
+				if (input.includes("*")) return listFiles(isAbsolutePath(input) ? input : appendPath(input, this.config.projectRoot), { ignore: this.config.automd.ignore });
+				return isAbsolutePath(input) ? input : appendPath(input, this.config.projectRoot);
+			}, [
+				"input",
+				"",
+				"P\"2!\"/\""
+			])))).flat();
+			if (this.config.automd.output && !isAbsolutePath(this.config.automd.output)) this.config.automd.output = appendPath(this.config.automd.output, this.config.projectRoot);
+			this.config.automd.generators ??= {};
+			if (this.config.automd.toc !== false) this.config.automd.generators.toc ??= {
+				name: "toc",
+				generate: __assignType((ctx) => {
+					const opts = this.config.automd.toc ?? {};
+					return { contents: toc(ctx.block.md, {
+						...opts,
+						maxdepth: opts.maxDepth,
+						first1: opts.firstH1
+					}).content };
+				}, [
+					"ctx",
+					"",
+					"P!2!!/\""
+				])
+			};
+		},
+		async docs() {
+			await Promise.all(toArray(this.config.automd.input).map(__assignType(async (input) => {
+				const contents = await this.fs.read(input);
+				if (contents) {
+					const result = await transform(contents, this.config.automd);
+					if (result.hasIssues && this.config.automd.allowIssues === false) throw new Error(`AutoMD found issues in file "${input}". Please resolve the issues or set \`allowIssues\` to true in the plugin configuration to ignore them.`);
+					if (result.hasChanged) await this.fs.write(appendPath(this.config.automd.output ? isDirectory(this.config.automd.output) ? replacePath(input, this.config.automd.output) : this.config.automd.output : input, this.config.projectRoot), result.contents);
+				}
+			}, [
+				"input",
+				"",
+				"P\"2!\"/\""
+			])));
+		}
+	};
+}, [
+	() => __ΩAutoMDPluginOptions,
+	"options",
+	() => ({}),
+	() => __ΩPlugin,
+	"",
+	"Pn!2\">#\"o$\"/%"
+]);
+var src_default = plugin;
+
+//#endregion
+export { src_default as default };

package/dist/plugin-automd/src/types/plugin.cjs

@@ -0,0 +1,47 @@
+const require_toc = require('./toc.cjs');
+
+//#region ../plugin-automd/src/types/plugin.ts
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+const __ΩAutoMDPluginOptions = [
+	() => __ΩOmit,
+	"dir",
+	"watch",
+	"onWatch",
+	"prefix",
+	"configFile",
+	"Path to the AutoMD configuration file.",
+	"allowIssues",
+	true,
+	"An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.",
+	"prefix",
+	"[\"automd\", \"powerlines\", \"\\{framework\\}\"]",
+	"Alternate prefix strings to use for finding generators",
+	false,
+	() => require_toc.__ΩTOCOptions,
+	"toc",
+	"Table of Contents generator options",
+	"AutoMDPluginOptions",
+	"P!P.\".#.$.%Jo!#P&4&8?')4(8>)?*P&&FJ4+8>,?-P..n/J408?1MKw2y"
+];
+
+//#endregion
+exports.__ΩAutoMDPluginOptions = __ΩAutoMDPluginOptions;

package/dist/plugin-automd/src/types/plugin.d.cts

@@ -0,0 +1,38 @@
+import { TOCOptions } from "./toc.cjs";
+import { Config } from "automd";
+
+//#region ../plugin-automd/src/types/plugin.d.ts
+
+type AutoMDPluginOptions = Omit<Config, "dir" | "watch" | "onWatch" | "prefix"> & {
+  /**
+   * Path to the AutoMD configuration file.
+   *
+   * @remarks
+   * If not provided, the plugin will use the default AutoMD configuration resolution mechanism.
+   */
+  configFile?: string;
+  /**
+   * An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.
+   *
+   * @defaultValue true
+   */
+  allowIssues?: boolean;
+  /**
+   * Alternate prefix strings to use for finding generators
+   *
+   * @remarks
+   * By default, AutoMD looks for generators with the "automd" prefix, so that any `<!-- automd:generator [...args] --> ... <!-- /automd -->` comments will be picked up. If you want to use different prefixes (for example, to avoid conflicts with other tools), you would provide a value like "myPrefix" and AutoMD would also look for `<!-- myPrefix:generator [...args] --> ... <!-- /myPrefix -->` comments.
+   *
+   * @defaultValue ["automd", "powerlines", "\{framework\}"]
+   */
+  prefix?: string | string[];
+  /**
+   * Table of Contents generator options
+   *
+   * @remarks
+   * If set to `false`, the built-in Table of Contents generator will be disabled.
+   */
+  toc?: false | TOCOptions;
+};
+//#endregion
+export { AutoMDPluginOptions };

package/dist/plugin-automd/src/types/plugin.d.mts

@@ -0,0 +1,40 @@
+import "../../../powerlines/src/types/context.mjs";
+import "../../../powerlines/src/types/config.mjs";
+import "../../../powerlines/src/types/resolved.mjs";
+import { TOCOptions } from "./toc.mjs";
+import { Config } from "automd";
+
+//#region ../plugin-automd/src/types/plugin.d.ts
+type AutoMDPluginOptions = Omit<Config, "dir" | "watch" | "onWatch" | "prefix"> & {
+  /**
+   * Path to the AutoMD configuration file.
+   *
+   * @remarks
+   * If not provided, the plugin will use the default AutoMD configuration resolution mechanism.
+   */
+  configFile?: string;
+  /**
+   * An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.
+   *
+   * @defaultValue true
+   */
+  allowIssues?: boolean;
+  /**
+   * Alternate prefix strings to use for finding generators
+   *
+   * @remarks
+   * By default, AutoMD looks for generators with the "automd" prefix, so that any `<!-- automd:generator [...args] --> ... <!-- /automd -->` comments will be picked up. If you want to use different prefixes (for example, to avoid conflicts with other tools), you would provide a value like "myPrefix" and AutoMD would also look for `<!-- myPrefix:generator [...args] --> ... <!-- /myPrefix -->` comments.
+   *
+   * @defaultValue ["automd", "powerlines", "\{framework\}"]
+   */
+  prefix?: string | string[];
+  /**
+   * Table of Contents generator options
+   *
+   * @remarks
+   * If set to `false`, the built-in Table of Contents generator will be disabled.
+   */
+  toc?: false | TOCOptions;
+};
+//#endregion
+export { AutoMDPluginOptions };

package/dist/plugin-automd/src/types/plugin.mjs

@@ -0,0 +1,47 @@
+import { __ΩTOCOptions } from "./toc.mjs";
+
+//#region ../plugin-automd/src/types/plugin.ts
+const __ΩOmit = [
+	"T",
+	"K",
+	() => __ΩPick,
+	() => __ΩExclude,
+	"Omit",
+	"b!b\"e!!e!!ge!\"o$#o##w%y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+const __ΩExclude = [
+	"T",
+	"U",
+	"Exclude",
+	"l6!Re$!RPe#!e$\"qk#%QRb!b\"Pde\"!p)w#y"
+];
+const __ΩAutoMDPluginOptions = [
+	() => __ΩOmit,
+	"dir",
+	"watch",
+	"onWatch",
+	"prefix",
+	"configFile",
+	"Path to the AutoMD configuration file.",
+	"allowIssues",
+	true,
+	"An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.",
+	"prefix",
+	"[\"automd\", \"powerlines\", \"\\{framework\\}\"]",
+	"Alternate prefix strings to use for finding generators",
+	false,
+	() => __ΩTOCOptions,
+	"toc",
+	"Table of Contents generator options",
+	"AutoMDPluginOptions",
+	"P!P.\".#.$.%Jo!#P&4&8?')4(8>)?*P&&FJ4+8>,?-P..n/J408?1MKw2y"
+];
+
+//#endregion
+export { __ΩAutoMDPluginOptions };

package/dist/plugin-automd/src/types/toc.cjs

@@ -0,0 +1,26 @@
+
+//#region ../plugin-automd/src/types/toc.ts
+const __ΩTOCOptions = [
+	"str",
+	"",
+	"slugify",
+	"A slugify function to generate slugs for the headings.",
+	"maxDepth",
+	6,
+	"The maximum depth of headings to include in the TOC.",
+	"firstH1",
+	"Whether to include the first H1 heading in the TOC.",
+	"bullets",
+	"-",
+	"The bullet character to use for list items in the TOC.",
+	"prefix",
+	"A prefix to add to each heading in the TOC.",
+	"level",
+	"filter",
+	"A filter function to determine which headings to include in the TOC.",
+	"TOCOptions",
+	"PP&2!&/\"4#8?$'4%8>&?')4(8?)&4*8>+?,&4-8?.P&2!'2/)/\"408?1Mw2y"
+];
+
+//#endregion
+exports.__ΩTOCOptions = __ΩTOCOptions;

package/dist/plugin-automd/src/types/toc.d.cts

@@ -0,0 +1,33 @@
+//#region ../plugin-automd/src/types/toc.d.ts
+interface TOCOptions {
+  /**
+   * A slugify function to generate slugs for the headings.
+   */
+  slugify?: (str: string) => string;
+  /**
+   * The maximum depth of headings to include in the TOC.
+   *
+   * @defaultValue 6
+   */
+  maxDepth?: number;
+  /**
+   * Whether to include the first H1 heading in the TOC.
+   */
+  firstH1?: boolean;
+  /**
+   * The bullet character to use for list items in the TOC.
+   *
+   * @defaultValue "-"
+   */
+  bullets?: string;
+  /**
+   * A prefix to add to each heading in the TOC.
+   */
+  prefix?: string;
+  /**
+   * A filter function to determine which headings to include in the TOC.
+   */
+  filter?: (str: string, level: number) => boolean;
+}
+//#endregion
+export { TOCOptions };

package/dist/plugin-automd/src/types/toc.d.mts

@@ -0,0 +1,33 @@
+//#region ../plugin-automd/src/types/toc.d.ts
+interface TOCOptions {
+  /**
+   * A slugify function to generate slugs for the headings.
+   */
+  slugify?: (str: string) => string;
+  /**
+   * The maximum depth of headings to include in the TOC.
+   *
+   * @defaultValue 6
+   */
+  maxDepth?: number;
+  /**
+   * Whether to include the first H1 heading in the TOC.
+   */
+  firstH1?: boolean;
+  /**
+   * The bullet character to use for list items in the TOC.
+   *
+   * @defaultValue "-"
+   */
+  bullets?: string;
+  /**
+   * A prefix to add to each heading in the TOC.
+   */
+  prefix?: string;
+  /**
+   * A filter function to determine which headings to include in the TOC.
+   */
+  filter?: (str: string, level: number) => boolean;
+}
+//#endregion
+export { TOCOptions };

package/dist/plugin-automd/src/types/toc.mjs

@@ -0,0 +1,25 @@
+//#region ../plugin-automd/src/types/toc.ts
+const __ΩTOCOptions = [
+	"str",
+	"",
+	"slugify",
+	"A slugify function to generate slugs for the headings.",
+	"maxDepth",
+	6,
+	"The maximum depth of headings to include in the TOC.",
+	"firstH1",
+	"Whether to include the first H1 heading in the TOC.",
+	"bullets",
+	"-",
+	"The bullet character to use for list items in the TOC.",
+	"prefix",
+	"A prefix to add to each heading in the TOC.",
+	"level",
+	"filter",
+	"A filter function to determine which headings to include in the TOC.",
+	"TOCOptions",
+	"PP&2!&/\"4#8?$'4%8>&?')4(8?)&4*8>+?,&4-8?.P&2!'2/)/\"408?1Mw2y"
+];
+
+//#endregion
+export { __ΩTOCOptions };

package/dist/plugin-babel/src/helpers/ast-utils.cjs

@@ -0,0 +1,74 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __babel_generator = require("@babel/generator");
+__babel_generator = require_rolldown_runtime.__toESM(__babel_generator);
+let __babel_parser = require("@babel/parser");
+
+//#region ../plugin-babel/src/helpers/ast-utils.ts
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
+const __ΩPick = [
+	"T",
+	"K",
+	"Pick",
+	"l+e#!e\"!fRb!b\"Pde\"\"N#!w#y"
+];
+/**
+* Parse the given code into an AST.
+*
+* @param code - The code to parse.
+* @param opts - The options for parsing.
+* @returns The parsed AST.
+*/
+function parseAst(code, opts = {}) {
+	return (0, __babel_parser.parse)(code, {
+		plugins: ["typescript"],
+		sourceType: "module",
+		allowImportExportEverywhere: true,
+		allowAwaitOutsideFunction: true,
+		...opts
+	});
+}
+parseAst.__type = [
+	"code",
+	"ParserOptions",
+	"opts",
+	() => ({}),
+	"ParseResult",
+	"parseAst",
+	"Parse the given code into an AST.",
+	"P&2!\"w\"2#>$\"w%/&?'"
+];
+let generate = __babel_generator.default;
+if ("default" in generate) generate = generate.default;
+const __ΩGenerateFromAstOptions = [
+	"GeneratorOptions",
+	() => __ΩRequired,
+	() => __ΩPick,
+	"sourceFileName",
+	"filename",
+	"GenerateFromAstOptions",
+	"P\"w!\"w!P.$.%Jo##o\"\"Kw&y"
+];
+function generateFromAst(ast, opts) {
+	return generate(ast, opts ? {
+		importAttributesKeyword: "with",
+		sourceMaps: true,
+		...opts
+	} : void 0);
+}
+generateFromAst.__type = [
+	"ast",
+	() => __ΩGenerateFromAstOptions,
+	"opts",
+	"GeneratorResult",
+	"generateFromAst",
+	"P!2!n\"2#8\"w$/%"
+];
+
+//#endregion
+exports.__ΩGenerateFromAstOptions = __ΩGenerateFromAstOptions;
+exports.generateFromAst = generateFromAst;
+exports.parseAst = parseAst;