@w5s/configurator-core 1.0.0-alpha.1 → 1.0.0-alpha.10

package/dist/index.cjs

@@ -1,6 +1,30 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
+let yaml = require("yaml");
+yaml = __toESM(yaml, 1);
 let node_child_process = require("node:child_process");
 //#region src/__exists.ts
 async function __exists(path) {
@@ -12,14 +36,6 @@ async function __exists(path) {
 	}
 }
 //#endregion
-//#region src/__toMode.ts
-function toModeFlag(permissionSet, read, write, execute) {
-	return (permissionSet?.read === true ? read : 0) | (permissionSet?.write === true ? write : 0) | (permissionSet?.execute === true ? execute : 0);
-}
-function __toMode(mode) {
-	return mode == null ? mode : toModeFlag(mode.owner, 256, 128, 64) | toModeFlag(mode.group, 32, 16, 8) | toModeFlag(mode.other, 4, 2, 1);
-}
-//#endregion
 //#region src/__existsSync.ts
 function __existsSync(path) {
 	try {
@@ -30,66 +46,12 @@ function __existsSync(path) {
 	}
 }
 //#endregion
-//#region src/directory.ts
-/**
-* Ensure directory is present/absent
-*
-* @example
-* ```ts
-* await directory({
-*   path: 'foo/bar',
-*   state: 'present',
-*   mode: {
-*     owner: { read: true, write: true, execute: true },
-*     group: { read: true, write: true, execute: true },
-*     other: { read: true, write: true, execute: true },
-*   },
-* })
-* ```
-*
-* @param options
-*/
-async function directory(options) {
-	const { path, state, mode } = options;
-	const isPresent = await __exists(path);
-	if (state === "present") {
-		const newMode = __toMode(mode);
-		if (!isPresent) await (0, node_fs_promises.mkdir)(path, {
-			recursive: true,
-			mode: newMode
-		});
-		if (newMode != null && isPresent) await (0, node_fs_promises.chmod)(path, newMode);
-	} else if (isPresent) await (0, node_fs_promises.rm)(path, { recursive: true });
+//#region src/__toMode.ts
+function __toMode(mode) {
+	return mode == null ? mode : toModeFlag(mode.owner, 256, 128, 64) | toModeFlag(mode.group, 32, 16, 8) | toModeFlag(mode.other, 4, 2, 1);
 }
-/**
-* Ensure directory is present/absent
-*
-* @example
-* ```ts
-* directorySync({
-*   path: 'foo/bar',
-*   state: 'present',
-*   mode: {
-*     owner: { read: true, write: true, execute: true },
-*     group: { read: true, write: true, execute: true },
-*     other: { read: true, write: true, execute: true },
-*   },
-* })
-* ```
-*
-* @param options
-*/
-function directorySync(options) {
-	const { path, state, mode } = options;
-	const isPresent = __existsSync(path);
-	if (state === "present") {
-		const newMode = __toMode(mode);
-		if (!isPresent) (0, node_fs.mkdirSync)(path, {
-			recursive: true,
-			mode: newMode
-		});
-		if (newMode != null && isPresent) (0, node_fs.chmodSync)(path, newMode);
-	} else if (isPresent) (0, node_fs.rmSync)(path, { recursive: true });
+function toModeFlag(permissionSet, read, write, execute) {
+	return (permissionSet?.read === true ? read : 0) | (permissionSet?.write === true ? write : 0) | (permissionSet?.execute === true ? execute : 0);
 }
 //#endregion
 //#region src/file.ts
@@ -113,7 +75,7 @@ function directorySync(options) {
 * @param options
 */
 async function file(options) {
-	const { path, state, update, encoding = "utf8", mode } = options;
+	const { encoding = "utf8", mode, path, state, update } = options;
 	if (state === "present") {
 		const isPresent = await __exists(path);
 		const previousContent = isPresent ? await (0, node_fs_promises.readFile)(path, encoding) : "";
@@ -146,7 +108,7 @@ async function file(options) {
 * @param options
 */
 function fileSync(options) {
-	const { path, state, update, encoding = "utf8", mode } = options;
+	const { encoding = "utf8", mode, path, state, update } = options;
 	if (state === "present") {
 		const isPresent = __existsSync(path);
 		const previousContent = isPresent ? (0, node_fs.readFileSync)(path, encoding) : "";
@@ -180,8 +142,32 @@ const matchLast = (string, regexp) => {
 		lastIndex
 	};
 };
+/**
+* Replace asynchronously a block in file that follows pattern :
+*
+* marker(markerBegin)
+* ...
+* marker(markerEnd)
+*
+* @param options
+*/
+function block(options) {
+	return file(toFileOptions(options));
+}
+/**
+* Replace synchronously a block in file that follows pattern :
+*
+* marker(markerBegin)
+* ...
+* marker(markerEnd)
+*
+* @param options
+*/
+function blockSync(options) {
+	return fileSync(toFileOptions(options));
+}
 function toFileOptions(options) {
-	const { marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`, path, block: blockName, insertPosition = ["after", EOF], state = "present" } = options;
+	const { block: blockName, insertPosition = ["after", EOF], marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`, path, state = "present" } = options;
 	const EOL = "\n";
 	const beginBlock = marker("Begin");
 	const endBlock = marker("End");
@@ -205,18 +191,18 @@ function toFileOptions(options) {
 		if (found.exists) return fullContent.slice(0, found.startIndex) + replaceBlock + fullContent.slice(found.endIndex);
 		if (remove) return fullContent;
 		switch (positionDirection) {
-			case "before":
-				if (positionAnchor !== BOF) {
-					const { firstIndex } = matchLast(fullContent, positionAnchor);
-					if (firstIndex >= 0) return insertAt(fullContent, firstIndex, replaceBlock + EOL);
-				}
-				return replaceBlock + EOL + fullContent;
 			case "after":
 				if (positionAnchor !== EOF) {
 					const { lastIndex } = matchLast(fullContent, positionAnchor);
 					if (lastIndex >= 0) return insertAt(fullContent, lastIndex, EOL + replaceBlock);
 				}
 				return fullContent + EOL + replaceBlock;
+			case "before":
+				if (positionAnchor !== BOF) {
+					const { firstIndex } = matchLast(fullContent, positionAnchor);
+					if (firstIndex >= 0) return insertAt(fullContent, firstIndex, replaceBlock + EOL);
+				}
+				return replaceBlock + EOL + fullContent;
 			default: throw new Error(`Unsupported position ${String(positionDirection)}`);
 		}
 	}
@@ -226,48 +212,119 @@ function toFileOptions(options) {
 		update: (sourceContent) => apply(sourceContent, blockName)
 	};
 }
+//#endregion
+//#region src/directory.ts
 /**
-* Replace asynchronously a block in file that follows pattern :
+* Ensure directory is present/absent
 *
-* marker(markerBegin)
-* ...
-* marker(markerEnd)
+* @example
+* ```ts
+* await directory({
+*   path: 'foo/bar',
+*   state: 'present',
+*   mode: {
+*     owner: { read: true, write: true, execute: true },
+*     group: { read: true, write: true, execute: true },
+*     other: { read: true, write: true, execute: true },
+*   },
+* })
+* ```
 *
 * @param options
 */
-function block(options) {
-	return file(toFileOptions(options));
+async function directory(options) {
+	const { mode, path, state } = options;
+	const isPresent = await __exists(path);
+	if (state === "present") {
+		const newMode = __toMode(mode);
+		if (!isPresent) await (0, node_fs_promises.mkdir)(path, {
+			mode: newMode,
+			recursive: true
+		});
+		if (newMode != null && isPresent) await (0, node_fs_promises.chmod)(path, newMode);
+	} else if (isPresent) await (0, node_fs_promises.rm)(path, { recursive: true });
 }
 /**
-* Replace synchronously a block in file that follows pattern :
+* Ensure directory is present/absent
 *
-* marker(markerBegin)
-* ...
-* marker(markerEnd)
+* @example
+* ```ts
+* directorySync({
+*   path: 'foo/bar',
+*   state: 'present',
+*   mode: {
+*     owner: { read: true, write: true, execute: true },
+*     group: { read: true, write: true, execute: true },
+*     other: { read: true, write: true, execute: true },
+*   },
+* })
+* ```
 *
 * @param options
 */
-function blockSync(options) {
-	return fileSync(toFileOptions(options));
+function directorySync(options) {
+	const { mode, path, state } = options;
+	const isPresent = __existsSync(path);
+	if (state === "present") {
+		const newMode = __toMode(mode);
+		if (!isPresent) (0, node_fs.mkdirSync)(path, {
+			mode: newMode,
+			recursive: true
+		});
+		if (newMode != null && isPresent) (0, node_fs.chmodSync)(path, newMode);
+	} else if (isPresent) (0, node_fs.rmSync)(path, { recursive: true });
 }
 //#endregion
-//#region src/json.ts
-function toFileOption({ update, ...otherOptions }) {
+//#region src/ignoreFile.ts
+/**
+* Ensure file is present/absent asynchronously with content initialized or modified by line.
+*
+* @example
+* ```ts
+* await ignoreFile({
+*   path: '.gitignore',
+*   update: (lines) => [...(lines ?? []), 'dist'],
+* });
+* ```
+* @param options File target options.
+*/
+async function ignoreFile(options) {
+	return file(toFileOption$2(options));
+}
+/**
+* Ensure file is present/absent synchronously with content initialized or modified by line.
+*
+* @example
+* ```ts
+* ignoreFileSync({
+*   path: '.gitignore',
+*   update: (lines) => [...(lines ?? []), 'dist'],
+* });
+* ```
+* @param options File target options.
+*/
+function ignoreFileSync(options) {
+	return fileSync(toFileOption$2(options));
+}
+function toFileOption$2({ update, ...otherOptions }) {
 	return {
 		...otherOptions,
 		update: update == null ? update : (content) => {
-			const jsonValue = content === "" ? void 0 : JSON.parse(content);
-			return JSON.stringify(update(jsonValue));
+			const eol = content.includes("\r\n") ? "\r\n" : "\n";
+			const updatedLines = update(content === "" ? void 0 : content.split(eol));
+			return updatedLines == null ? void 0 : updatedLines.join(eol);
 		}
 	};
 }
+//#endregion
+//#region src/json.ts
 /**
 * Ensure file is present/absent asynchronously with content value initialized or modified with `update`
 *
 * @param options
 */
 async function json(options) {
-	return file(toFileOption(options));
+	return file(toFileOption$1(options));
 }
 /**
 * Ensure file is present/absent synchronously with content value initialized or modified with `update`
@@ -275,34 +332,53 @@ async function json(options) {
 * @param options
 */
 function jsonSync(options) {
-	return fileSync(toFileOption(options));
+	return fileSync(toFileOption$1(options));
+}
+function toFileOption$1({ update, ...otherOptions }) {
+	return {
+		...otherOptions,
+		update: update == null ? update : (content) => {
+			const jsonValue = content === "" ? void 0 : JSON.parse(content);
+			return JSON.stringify(update(jsonValue));
+		}
+	};
 }
 //#endregion
 //#region src/meta.ts
 const meta = Object.freeze({
+	buildNumber: 1,
 	name: "@w5s/configurator-core",
-	version: "1.0.0-alpha.1",
-	buildNumber: 1
+	version: "1.0.0-alpha.10"
 });
 //#endregion
-//#region src/exec.ts
+//#region src/yaml.ts
 /**
-* Runs a command in a shell and returns a promise that resolves with an object
-* containing the stdout and stderr strings.
+* Ensure file is present/absent asynchronously with content value initialized or modified with `update`
 *
-* @param command The command to run
-* @param args The arguments to pass to the command
 * @param options
-* @returns A promise that resolves with an object like `{ stdout: string, stderr: string }`
 */
-function execSync(command, args, options) {
-	const result = (0, node_child_process.spawnSync)(command, args, { ...options });
-	const encoding = "utf8";
+async function yaml$1(options) {
+	return file(toFileOption(options));
+}
+/**
+* Ensure file is present/absent synchronously with content value initialized or modified with `update`
+*
+* @param options
+*/
+function yamlSync(options) {
+	return fileSync(toFileOption(options));
+}
+function toFileOption({ update, ...otherOptions }) {
 	return {
-		stdout: result.stdout.toString(encoding),
-		stderr: result.stderr.toString(encoding)
+		...otherOptions,
+		update: update == null ? update : (content) => {
+			const yamlValue = content === "" ? void 0 : yaml.default.parse(content);
+			return yaml.default.stringify(update(yamlValue));
+		}
 	};
 }
+//#endregion
+//#region src/exec.ts
 /**
 * Runs a command in a shell and returns a promise that resolves with an object
 * containing the stdout and stderr strings.
@@ -325,106 +401,123 @@ async function exec(command, args, options) {
 		});
 		child.on("close", (_code) => {
 			resolve({
-				stdout,
-				stderr
+				stderr,
+				stdout
 			});
 		});
 		child.on("error", reject);
 	});
 }
+/**
+* Runs a command in a shell and returns a promise that resolves with an object
+* containing the stdout and stderr strings.
+*
+* @param command The command to run
+* @param args The arguments to pass to the command
+* @param options
+* @returns A promise that resolves with an object like `{ stdout: string, stderr: string }`
+*/
+function execSync(command, args, options) {
+	const result = (0, node_child_process.spawnSync)(command, args, { ...options });
+	const encoding = "utf8";
+	return {
+		stderr: result.stderr.toString(encoding),
+		stdout: result.stdout.toString(encoding)
+	};
+}
 //#endregion
 //#region src/yarnConfig.ts
 /**
-* Synchronous version of {@link yarnConfig}
+* Set/Unset yarn configuration value
 *
 * @param options
 * @example
-* yarnConfigSync({
+* await yarnConfig({
 *   key: 'nodeLinker',
 *   state: 'present',
 *   update: (content) => content.replace('node-modules', 'hoisted'),
 * })
 */
-function yarnConfigSync(options) {
+async function yarnConfig(options) {
 	const { key, state, update } = options;
 	if (state === "present") {
-		const { stdout } = execSync("yarn", [
+		const { stdout } = await exec("yarn", [
 			"config",
 			"get",
 			String(key)
 		]);
-		execSync("yarn", [
+		await exec("yarn", [
 			"config",
 			"set",
 			String(key),
-			`${update == null ? "" : update(stdout)}`
+			String(update == null ? "" : update(stdout))
 		]);
-	} else execSync("yarn", ["config", "unset"]);
+	} else await exec("yarn", ["config", "unset"]);
 }
 /**
-* Set/Unset yarn configuration value
+* Synchronous version of {@link yarnConfig}
 *
 * @param options
 * @example
-* await yarnConfig({
+* yarnConfigSync({
 *   key: 'nodeLinker',
 *   state: 'present',
 *   update: (content) => content.replace('node-modules', 'hoisted'),
 * })
 */
-async function yarnConfig(options) {
+function yarnConfigSync(options) {
 	const { key, state, update } = options;
 	if (state === "present") {
-		const { stdout } = await exec("yarn", [
+		const { stdout } = execSync("yarn", [
 			"config",
 			"get",
 			String(key)
 		]);
-		await exec("yarn", [
+		execSync("yarn", [
 			"config",
 			"set",
 			String(key),
-			`${update == null ? "" : update(stdout)}`
+			String(update == null ? "" : update(stdout))
 		]);
-	} else await exec("yarn", ["config", "unset"]);
+	} else execSync("yarn", ["config", "unset"]);
 }
 //#endregion
 //#region src/yarnVersion.ts
 /**
-* Synchronous version of {@link yarnVersion}
+* Set/Unset yarn configuration value
 *
 * @param options
 * @example
-* yarnVersionSync({
+* await yarnVersion({
 *   state: 'present',
 *   update: () => 'berry', // or 'classic'
 * })
 */
-function yarnVersionSync(options) {
+async function yarnVersion(options) {
 	const { state, update } = options;
-	if (state === "present") execSync("yarn", [
+	if (state === "present") await exec("yarn", [
 		"set",
 		"version",
-		`${update == null ? "berry" : update()}`
+		String(update == null ? "berry" : update())
 	]);
 	else throw new Error("Not implemented");
 }
 /**
-* Set/Unset yarn configuration value
+* Synchronous version of {@link yarnVersion}
 *
 * @param options
 * @example
-* await yarnVersion({
+* yarnVersionSync({
 *   state: 'present',
 *   update: () => 'berry', // or 'classic'
 * })
 */
-async function yarnVersion(options) {
+function yarnVersionSync(options) {
 	const { state, update } = options;
-	if (state === "present") await exec("yarn", [
+	if (state === "present") execSync("yarn", [
 		"set",
 		"version",
-		`${update == null ? "berry" : update()}`
+		String(update == null ? "berry" : update())
 	]);
 	else throw new Error("Not implemented");
 }
@@ -435,9 +528,13 @@ exports.directory = directory;
 exports.directorySync = directorySync;
 exports.file = file;
 exports.fileSync = fileSync;
+exports.ignoreFile = ignoreFile;
+exports.ignoreFileSync = ignoreFileSync;
 exports.json = json;
 exports.jsonSync = jsonSync;
 exports.meta = meta;
+exports.yaml = yaml$1;
+exports.yamlSync = yamlSync;
 exports.yarnConfig = yarnConfig;
 exports.yarnConfigSync = yarnConfigSync;
 exports.yarnVersion = yarnVersion;