@w5s/configurator-core 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Julien Polo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=# W5S Configurator _(${name})_) -->
+# W5S Configurator _(@w5s/configurator-core)_
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+[![NPM Version][package-version-svg]][package-url]
+[![License][license-image]][license-url]
+
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=> ${description}&unknownTxt= ) -->
+> Shared development constants and functions
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+## Installation
+
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=```console\nnpm install --save-dev ${name}\n```) -->
+```console
+npm install --save-dev @w5s/configurator-core
+```
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+## Usage
+
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=```json\n"${name}"\n```) -->
+```json
+"@w5s/configurator-core"
+```
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+## License
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=[${license}][license-url] © ${author}) -->
+[MIT][license-url] © Julien Polo <julien.polo@gmail.com>
+<!-- AUTO-GENERATED-CONTENT:END -->
+
+<!-- VARIABLES -->
+
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=[package-version-svg]: https://img.shields.io/npm/v/${name}.svg?style=flat-square) -->
+[package-version-svg]: https://img.shields.io/npm/v/@w5s/configurator-core.svg?style=flat-square
+<!-- AUTO-GENERATED-CONTENT:END -->
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=[package-url]: https://www.npmjs.com/package/${name}) -->
+[package-url]: https://www.npmjs.com/package/@w5s/configurator-core
+<!-- AUTO-GENERATED-CONTENT:END -->
+<!-- AUTO-GENERATED-CONTENT:START (PKG_JSON:template=[license-image]: https://img.shields.io/badge/license-${license}-green.svg?style=flat-square) -->
+[license-image]: https://img.shields.io/badge/license-MIT-green.svg?style=flat-square
+<!-- AUTO-GENERATED-CONTENT:END -->
+[license-url]: ../../LICENSE

package/dist/index.cjs

@@ -0,0 +1,446 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_fs = require("node:fs");
+let node_fs_promises = require("node:fs/promises");
+let node_child_process = require("node:child_process");
+//#region src/__exists.ts
+async function __exists(path) {
+	try {
+		await (0, node_fs_promises.access)(path, node_fs.constants.F_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#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 {
+		(0, node_fs.accessSync)(path, node_fs.constants.F_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#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 });
+}
+/**
+* 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 });
+}
+//#endregion
+//#region src/file.ts
+/**
+* Ensure file is present/absent with content initialized or modified with `update
+*
+* @example
+* ```ts
+* await file({
+*   path: 'foo/bar',
+*   state: 'present',
+*   update: (content) => content + '_test', // This will append '_test' after current content
+*   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 file(options) {
+	const { path, state, update, encoding = "utf8", mode } = options;
+	if (state === "present") {
+		const isPresent = await __exists(path);
+		const previousContent = isPresent ? await (0, node_fs_promises.readFile)(path, encoding) : "";
+		const newContent = update == null ? isPresent ? void 0 : "" : update(previousContent);
+		const newMode = __toMode(mode);
+		if (newContent != null) await (0, node_fs_promises.writeFile)(path, newContent, {
+			encoding,
+			mode: newMode
+		});
+		if (newMode != null && (isPresent || newContent != null)) await (0, node_fs_promises.chmod)(path, newMode);
+	} else await (0, node_fs_promises.rm)(path, { force: true });
+}
+/**
+* Ensure file is present/absent with content initialized or modified with `update
+*
+* @example
+* ```ts
+* fileSync({
+*   path: 'foo/bar',
+*   state: 'present',
+*   update: (content) => content + '_test', // This will append '_test' after current content
+*   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 fileSync(options) {
+	const { path, state, update, encoding = "utf8", mode } = options;
+	if (state === "present") {
+		const isPresent = __existsSync(path);
+		const previousContent = isPresent ? (0, node_fs.readFileSync)(path, encoding) : "";
+		const newContent = update == null ? isPresent ? void 0 : "" : update(previousContent);
+		const newMode = __toMode(mode);
+		if (newContent != null) (0, node_fs.writeFileSync)(path, newContent, {
+			encoding,
+			mode: newMode
+		});
+		if (newMode != null && (isPresent || newContent != null)) (0, node_fs.chmodSync)(path, newMode);
+	} else (0, node_fs.rmSync)(path, { force: true });
+}
+//#endregion
+//#region src/block.ts
+const EOF = "EndOfFile";
+const BOF = "BeginningOfFile";
+const insertAt = (str, index, toInsert) => str.slice(0, index) + toInsert + str.slice(index);
+const matchLast = (string, regexp) => {
+	const matcher = new RegExp(regexp.source, `${regexp.flags}g`);
+	let firstIndex = -1;
+	let lastIndex = -1;
+	let matches;
+	while (true) {
+		matches = matcher.exec(string);
+		if (matches == null) break;
+		firstIndex = matches.index;
+		lastIndex = matcher.lastIndex;
+	}
+	return {
+		firstIndex,
+		lastIndex
+	};
+};
+function toFileOptions(options) {
+	const { marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`, path, block: blockName, insertPosition = ["after", EOF], state = "present" } = options;
+	const EOL = "\n";
+	const beginBlock = marker("Begin");
+	const endBlock = marker("End");
+	/**
+	* @param content
+	*/
+	function findBlock(content) {
+		const startIndex = content.indexOf(beginBlock);
+		const endIndex = content.indexOf(endBlock) + endBlock.length;
+		return {
+			endIndex,
+			exists: startIndex !== -1 && endIndex >= 0,
+			startIndex
+		};
+	}
+	function apply(fullContent, blockContent) {
+		const found = findBlock(fullContent);
+		const remove = state === "absent";
+		const replaceBlock = remove ? "" : beginBlock + EOL + blockContent + EOL + endBlock;
+		const [positionDirection, positionAnchor] = insertPosition;
+		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;
+			default: throw new Error(`Unsupported position ${String(positionDirection)}`);
+		}
+	}
+	return {
+		path,
+		state: "present",
+		update: (sourceContent) => apply(sourceContent, blockName)
+	};
+}
+/**
+* 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));
+}
+//#endregion
+//#region src/json.ts
+function toFileOption({ update, ...otherOptions }) {
+	return {
+		...otherOptions,
+		update: update == null ? update : (content) => {
+			const jsonValue = content === "" ? void 0 : JSON.parse(content);
+			return JSON.stringify(update(jsonValue));
+		}
+	};
+}
+/**
+* Ensure file is present/absent asynchronously with content value initialized or modified with `update`
+*
+* @param options
+*/
+async function json(options) {
+	return file(toFileOption(options));
+}
+/**
+* Ensure file is present/absent synchronously with content value initialized or modified with `update`
+*
+* @param options
+*/
+function jsonSync(options) {
+	return fileSync(toFileOption(options));
+}
+//#endregion
+//#region src/meta.ts
+const meta = Object.freeze({
+	name: "@w5s/configurator-core",
+	version: "1.0.0-alpha.1",
+	buildNumber: 1
+});
+//#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.
+*
+* @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 {
+		stdout: result.stdout.toString(encoding),
+		stderr: result.stderr.toString(encoding)
+	};
+}
+/**
+* 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
+*/
+async function exec(command, args, options) {
+	return new Promise((resolve, reject) => {
+		const encoding = "utf8";
+		const child = (0, node_child_process.spawn)(command, args, { ...options });
+		let stdout = "";
+		let stderr = "";
+		if (child.stdout != null) child.stdout.on("data", (data) => {
+			stdout += data.toString(encoding);
+		});
+		if (child.stderr != null) child.stderr.on("data", (data) => {
+			stderr += data.toString(encoding);
+		});
+		child.on("close", (_code) => {
+			resolve({
+				stdout,
+				stderr
+			});
+		});
+		child.on("error", reject);
+	});
+}
+//#endregion
+//#region src/yarnConfig.ts
+/**
+* Synchronous version of {@link yarnConfig}
+*
+* @param options
+* @example
+* yarnConfigSync({
+*   key: 'nodeLinker',
+*   state: 'present',
+*   update: (content) => content.replace('node-modules', 'hoisted'),
+* })
+*/
+function yarnConfigSync(options) {
+	const { key, state, update } = options;
+	if (state === "present") {
+		const { stdout } = execSync("yarn", [
+			"config",
+			"get",
+			String(key)
+		]);
+		execSync("yarn", [
+			"config",
+			"set",
+			String(key),
+			`${update == null ? "" : update(stdout)}`
+		]);
+	} else execSync("yarn", ["config", "unset"]);
+}
+/**
+* Set/Unset yarn configuration value
+*
+* @param options
+* @example
+* await yarnConfig({
+*   key: 'nodeLinker',
+*   state: 'present',
+*   update: (content) => content.replace('node-modules', 'hoisted'),
+* })
+*/
+async function yarnConfig(options) {
+	const { key, state, update } = options;
+	if (state === "present") {
+		const { stdout } = await exec("yarn", [
+			"config",
+			"get",
+			String(key)
+		]);
+		await exec("yarn", [
+			"config",
+			"set",
+			String(key),
+			`${update == null ? "" : update(stdout)}`
+		]);
+	} else await exec("yarn", ["config", "unset"]);
+}
+//#endregion
+//#region src/yarnVersion.ts
+/**
+* Synchronous version of {@link yarnVersion}
+*
+* @param options
+* @example
+* yarnVersionSync({
+*   state: 'present',
+*   update: () => 'berry', // or 'classic'
+* })
+*/
+function yarnVersionSync(options) {
+	const { state, update } = options;
+	if (state === "present") execSync("yarn", [
+		"set",
+		"version",
+		`${update == null ? "berry" : update()}`
+	]);
+	else throw new Error("Not implemented");
+}
+/**
+* Set/Unset yarn configuration value
+*
+* @param options
+* @example
+* await yarnVersion({
+*   state: 'present',
+*   update: () => 'berry', // or 'classic'
+* })
+*/
+async function yarnVersion(options) {
+	const { state, update } = options;
+	if (state === "present") await exec("yarn", [
+		"set",
+		"version",
+		`${update == null ? "berry" : update()}`
+	]);
+	else throw new Error("Not implemented");
+}
+//#endregion
+exports.block = block;
+exports.blockSync = blockSync;
+exports.directory = directory;
+exports.directorySync = directorySync;
+exports.file = file;
+exports.fileSync = fileSync;
+exports.json = json;
+exports.jsonSync = jsonSync;
+exports.meta = meta;
+exports.yarnConfig = yarnConfig;
+exports.yarnConfigSync = yarnConfigSync;
+exports.yarnVersion = yarnVersion;
+exports.yarnVersionSync = yarnVersionSync;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["constants","constants"],"sources":["../src/__exists.ts","../src/__toMode.ts","../src/__existsSync.ts","../src/directory.ts","../src/file.ts","../src/block.ts","../src/json.ts","../src/meta.ts","../src/exec.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"sourcesContent":["import { access } from 'node:fs/promises';\nimport { constants } from 'node:fs';\n\nexport async function __exists(path: string) {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import type { FileMode, FilePermissionSet } from './FileMode.js';\n\nfunction toModeFlag(permissionSet: FilePermissionSet | undefined, read: number, write: number, execute: number): number {\n  return (\n    (permissionSet?.read === true ? read : 0)\n    | (permissionSet?.write === true ? write : 0)\n    | (permissionSet?.execute === true ? execute : 0)\n  );\n}\n\nexport function __toMode(mode: FileMode | undefined): number | undefined {\n  return mode == null\n    ? mode\n    : (\n        toModeFlag(mode.owner, 0o400, 0o200, 0o100)\n        | toModeFlag(mode.group, 0o040, 0o020, 0o010)\n        | toModeFlag(mode.other, 0o004, 0o002, 0o001)\n      );\n}\n","import { accessSync, constants } from 'node:fs';\n\nexport function __existsSync(path: string) {\n  try {\n    accessSync(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import { chmodSync, mkdirSync, rmSync } from 'node:fs';\nimport { chmod, mkdir, rm } from 'node:fs/promises';\nimport { __exists } from './__exists.js';\nimport type { FileMode } from './FileMode.js';\nimport { __toMode } from './__toMode.js';\nimport { __existsSync } from './__existsSync.js';\n\nexport interface DirectoryOptions {\n  /**\n   * Directory path\n   */\n  readonly path: string;\n\n  /**\n   * Directory target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n}\n\n/**\n * Ensure directory is present/absent\n *\n * @example\n * ```ts\n * await directory({\n *   path: 'foo/bar',\n *   state: 'present',\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport async function directory(options: DirectoryOptions): Promise<void> {\n  const { path, state, mode } = options;\n  const isPresent = await __exists(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      await mkdir(path, { recursive: true, mode: newMode });\n    }\n    if (newMode != null && isPresent) {\n      await chmod(path, newMode);\n    }\n  } else if (isPresent) {\n    await rm(path, { recursive: true });\n  }\n}\n\n/**\n * Ensure directory is present/absent\n *\n * @example\n * ```ts\n * directorySync({\n *   path: 'foo/bar',\n *   state: 'present',\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport function directorySync(options: DirectoryOptions): void {\n  const { path, state, mode } = options;\n  const isPresent = __existsSync(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      mkdirSync(path, { recursive: true, mode: newMode });\n    }\n    if (newMode != null && isPresent) {\n      chmodSync(path, newMode);\n    }\n  } else if (isPresent) {\n    rmSync(path, { recursive: true });\n  }\n}\n","import { chmod, readFile, rm, writeFile } from 'node:fs/promises';\nimport { chmodSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport type { FileMode } from './FileMode.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface FileOptions {\n  /**\n   * File path\n   */\n  readonly path: string;\n\n  /**\n   * File target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\n\n  /**\n   * File encoding\n   */\n  readonly encoding?: BufferEncoding;\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n}\n\n/**\n * Ensure file is present/absent with content initialized or modified with `update\n *\n * @example\n * ```ts\n * await file({\n *   path: 'foo/bar',\n *   state: 'present',\n *   update: (content) => content + '_test', // This will append '_test' after current content\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport async function file(options: FileOptions): Promise<void> {\n  const { path, state, update, encoding = 'utf8', mode } = options;\n  if (state === 'present') {\n    const isPresent = await __exists(path);\n    const previousContent = isPresent ? await readFile(path, encoding) : '';\n    const newContent = update == null ? (isPresent ? undefined : '') : update(previousContent);\n    const newMode = __toMode(mode);\n    if (newContent != null) {\n      await writeFile(path, newContent, { encoding, mode: newMode });\n    }\n    if (newMode != null && (isPresent || newContent != null)) {\n      await chmod(path, newMode);\n    }\n  } else {\n    await rm(path, { force: true });\n  }\n}\n\n/**\n * Ensure file is present/absent with content initialized or modified with `update\n *\n * @example\n * ```ts\n * fileSync({\n *   path: 'foo/bar',\n *   state: 'present',\n *   update: (content) => content + '_test', // This will append '_test' after current content\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport function fileSync(options: FileOptions): void {\n  const { path, state, update, encoding = 'utf8', mode } = options;\n  if (state === 'present') {\n    const isPresent = __existsSync(path);\n    const previousContent = isPresent ? readFileSync(path, encoding) : '';\n    const newContent = update == null ? (isPresent ? undefined : '') : update(previousContent);\n    const newMode = __toMode(mode);\n    if (newContent != null) {\n      writeFileSync(path, newContent, { encoding, mode: newMode });\n    }\n    if (newMode != null && (isPresent || newContent != null)) {\n      chmodSync(path, newMode);\n    }\n  } else {\n    rmSync(path, { force: true });\n  }\n}\n","import { type FileOptions, file, fileSync } from './file.js';\n\nexport interface BlockOptions {\n  /**\n   * The marker builder function that will take either `markerBegin` or `markerEnd`\n   *\n   * @default '# ${mark} MANAGED BLOCK'\n   */\n  marker?: (mark: 'Begin' | 'End') => string;\n\n  /**\n   * File path\n   */\n  path: string;\n\n  /**\n   * Block content to insert\n   */\n  block: string;\n\n  /**\n   * Insert position\n   */\n  insertPosition?: ['before', 'BeginningOfFile' | RegExp] | ['after', 'EndOfFile' | RegExp];\n\n  /**\n   * Block target state\n   */\n  state?: 'present' | 'absent';\n}\n\nconst EOF = 'EndOfFile';\nconst BOF = 'BeginningOfFile';\nconst insertAt = (str: string, index: number, toInsert: string) => str.slice(0, index) + toInsert + str.slice(index);\nconst matchLast = (string: string, regexp: RegExp) => {\n  const matcher = new RegExp(regexp.source, `${regexp.flags}g`);\n  let firstIndex = -1;\n  let lastIndex = -1;\n  let matches;\n\n  while (true) {\n    matches = matcher.exec(string);\n    if (matches == null) {\n      break;\n    }\n    firstIndex = matches.index;\n    lastIndex = matcher.lastIndex;\n  }\n  return { firstIndex, lastIndex };\n};\n\nfunction toFileOptions(options: BlockOptions): FileOptions {\n  const {\n    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,\n    path,\n    block: blockName,\n    insertPosition = ['after', EOF],\n    state = 'present',\n  } = options;\n\n  const EOL = '\\n';\n  const beginBlock = marker('Begin');\n  const endBlock = marker('End');\n\n  /**\n   * @param content\n   */\n  function findBlock(content: string) {\n    const startIndex = content.indexOf(beginBlock);\n    const endIndex = content.indexOf(endBlock) + endBlock.length;\n\n    return {\n      endIndex,\n      exists: startIndex !== -1 && endIndex >= 0,\n      startIndex,\n    };\n  }\n\n  function apply(fullContent: string, blockContent: string) {\n    const found = findBlock(fullContent);\n    const remove = state === 'absent';\n    const replaceBlock = remove ? '' : beginBlock + EOL + blockContent + EOL + endBlock;\n    const [positionDirection, positionAnchor] = insertPosition;\n\n    if (found.exists) {\n      return fullContent.slice(0, found.startIndex) + replaceBlock + fullContent.slice(found.endIndex);\n    }\n    if (remove) {\n      return fullContent;\n    }\n    switch (positionDirection) {\n      case 'before': {\n        if (positionAnchor !== BOF) {\n          const { firstIndex } = matchLast(fullContent, positionAnchor);\n          if (firstIndex >= 0) {\n            return insertAt(fullContent, firstIndex, replaceBlock + EOL);\n          }\n        }\n\n        // Beginning of file\n        return replaceBlock + EOL + fullContent;\n      }\n      case 'after': {\n        // insert\n        if (positionAnchor !== EOF) {\n          const { lastIndex } = matchLast(fullContent, positionAnchor);\n          if (lastIndex >= 0) {\n            return insertAt(fullContent, lastIndex, EOL + replaceBlock);\n          }\n        }\n\n        // end of file\n        return fullContent + EOL + replaceBlock;\n      }\n\n      default: {\n        throw new Error(`Unsupported position ${String(positionDirection)}`);\n      }\n    }\n  }\n\n  return {\n    path,\n    state: 'present',\n    update: (sourceContent) => apply(sourceContent, blockName),\n  };\n}\n\n/**\n * Replace asynchronously a block in file that follows pattern :\n *\n * marker(markerBegin)\n * ...\n * marker(markerEnd)\n *\n * @param options\n */\nexport function block(options: BlockOptions) {\n  return file(toFileOptions(options));\n}\n\n/**\n * Replace synchronously a block in file that follows pattern :\n *\n * marker(markerBegin)\n * ...\n * marker(markerEnd)\n *\n * @param options\n */\nexport function blockSync(options: BlockOptions) {\n  return fileSync(toFileOptions(options));\n}\n","import { type FileOptions, file, fileSync } from './file.js';\n\nexport type JSONValue = null | number | string | boolean | JSONValue[] | { [key: string]: JSONValue };\n\nexport interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: V | undefined) => V | undefined) | undefined;\n}\n\nfunction toFileOption<Value>({ update, ...otherOptions }: JSONOption<Value>): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const jsonValue = content === '' ? undefined : (JSON.parse(content) as Value);\n\n            return JSON.stringify(update(jsonValue));\n          },\n  };\n}\n\n/**\n * Ensure file is present/absent asynchronously with content value initialized or modified with `update`\n *\n * @param options\n */\nexport async function json<Value>(options: JSONOption<Value>): Promise<void> {\n  return file(toFileOption(options));\n}\n\n/**\n * Ensure file is present/absent synchronously with content value initialized or modified with `update`\n *\n * @param options\n */\nexport function jsonSync<Value>(options: JSONOption<Value>): void {\n  return fileSync(toFileOption(options));\n}\n","export const meta = Object.freeze({\n  // @ts-ignore - these variables are injected at build time\n  name: (typeof __PACKAGE_NAME__ === 'undefined' ? '' : __PACKAGE_NAME__) as string,\n  // @ts-ignore - these variables are injected at build time\n  version: (typeof __PACKAGE_VERSION__ === 'undefined' ? '' : __PACKAGE_VERSION__) as string,\n  // @ts-ignore - these variables are injected at build time\n  buildNumber: 1 as number, // (typeof __PACKAGE_BUILD_NUMBER__ === 'undefined' ? 0 : __PACKAGE_BUILD_NUMBER__) as number,\n});\n","import { spawn, spawnSync } from 'node:child_process';\n\nexport interface ExecOptions {\n  /**\n   * Current working directory\n   */\n  cwd?: string;\n\n  /**\n   * Stdio options\n   */\n  stdio?: 'inherit' | 'pipe' | 'ignore';\n}\n\n/**\n * Runs a command in a shell and returns a promise that resolves with an object\n * containing the stdout and stderr strings.\n *\n * @param command The command to run\n * @param args The arguments to pass to the command\n * @param options\n * @returns A promise that resolves with an object like `{ stdout: string, stderr: string }`\n */\nexport function execSync(\n  command: string,\n  args: ReadonlyArray<string>,\n  options?: ExecOptions,\n): { stdout: string; stderr: string } {\n  const result = spawnSync(command, args, { ...options });\n  const encoding = 'utf8';\n\n  return { stdout: result.stdout.toString(encoding), stderr: result.stderr.toString(encoding) };\n}\n\n/**\n * Runs a command in a shell and returns a promise that resolves with an object\n * containing the stdout and stderr strings.\n *\n * @param command The command to run\n * @param args The arguments to pass to the command\n * @param options\n */\nexport async function exec(\n  command: string,\n  args: ReadonlyArray<string>,\n  options?: ExecOptions,\n): Promise<{ stdout: string; stderr: string }> {\n  return new Promise((resolve, reject) => {\n    const encoding = 'utf8';\n    const child = spawn(command, args, { ...options });\n    let stdout = '';\n    let stderr = '';\n\n    // Capture the stdout and stderr streams\n    if (child.stdout != null) {\n      child.stdout.on('data', (data) => {\n        stdout += data.toString(encoding);\n      });\n    }\n    if (child.stderr != null) {\n      child.stderr.on('data', (data) => {\n        stderr += data.toString(encoding);\n      });\n    }\n    // Handle process exit\n    child.on('close', (_code) => {\n      resolve({ stdout, stderr });\n    });\n\n    // Handle errors\n    child.on('error', reject);\n  });\n}\n","import { exec, execSync } from './exec.js';\n\nexport interface YarnConfigOptions {\n  /**\n   * Configuration key\n   */\n  readonly key: string;\n\n  /**\n   * Option target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\n}\n\n/**\n * Synchronous version of {@link yarnConfig}\n *\n * @param options\n * @example\n * yarnConfigSync({\n *   key: 'nodeLinker',\n *   state: 'present',\n *   update: (content) => content.replace('node-modules', 'hoisted'),\n * })\n */\nexport function yarnConfigSync(options: YarnConfigOptions) {\n  const { key, state, update } = options;\n  if (state === 'present') {\n    const { stdout } = execSync('yarn', ['config', 'get', String(key)]);\n    execSync('yarn', ['config', 'set', String(key), `${update == null ? '' : update(stdout)}`]);\n  } else {\n    execSync('yarn', ['config', 'unset']);\n  }\n}\n\n/**\n * Set/Unset yarn configuration value\n *\n * @param options\n * @example\n * await yarnConfig({\n *   key: 'nodeLinker',\n *   state: 'present',\n *   update: (content) => content.replace('node-modules', 'hoisted'),\n * })\n */\nexport async function yarnConfig(options: YarnConfigOptions): Promise<void> {\n  const { key, state, update } = options;\n  if (state === 'present') {\n    const { stdout } = await exec('yarn', ['config', 'get', String(key)]);\n    await exec('yarn', ['config', 'set', String(key), `${update == null ? '' : update(stdout)}`]);\n  } else {\n    await exec('yarn', ['config', 'unset']);\n  }\n}\n","import { exec, execSync } from './exec.js';\n\nexport type YarnVersionKind = 'berry' | 'classic';\n\nexport interface YarnVersionOptions {\n  /**\n   * Option target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * Version mapping function\n   *\n   */\n  readonly update?: (() => YarnVersionKind | undefined) | undefined;\n}\n\n/**\n * Synchronous version of {@link yarnVersion}\n *\n * @param options\n * @example\n * yarnVersionSync({\n *   state: 'present',\n *   update: () => 'berry', // or 'classic'\n * })\n */\nexport function yarnVersionSync(options: YarnVersionOptions) {\n  const { state, update } = options;\n  if (state === 'present') {\n    execSync('yarn', ['set', 'version', `${update == null ? 'berry' : update()}`]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\n}\n\n/**\n * Set/Unset yarn configuration value\n *\n * @param options\n * @example\n * await yarnVersion({\n *   state: 'present',\n *   update: () => 'berry', // or 'classic'\n * })\n */\nexport async function yarnVersion(options: YarnVersionOptions): Promise<void> {\n  const { state, update } = options;\n  if (state === 'present') {\n    await exec('yarn', ['set', 'version', `${update == null ? 'berry' : update()}`]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\n}\n"],"mappings":"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"}