@w5s/configurator-core 1.18.0 → 1.20.0

package/dist/index.cjs

@@ -23,6 +23,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 //#endregion
 let node_fs = require("node:fs");
 let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+node_path = __toESM(node_path, 1);
 let yaml = require("yaml");
 yaml = __toESM(yaml, 1);
 let node_child_process = require("node:child_process");
@@ -317,6 +319,66 @@ function toFileOption$2({ update, ...otherOptions }) {
 	};
 }
 //#endregion
+//#region src/isConfigPresent.ts
+const defaultExtensions = [
+	".json",
+	".yaml",
+	".yml",
+	".js",
+	".cjs",
+	".mjs",
+	".ts",
+	".cts",
+	".mts"
+];
+/**
+* Return whether tool configuration exists at `cwd` (cosmiconfig-style).
+*
+* Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching
+* `package.json` key.
+*
+* @param options
+*/
+async function isConfigPresent(options) {
+	const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);
+	const [hasConfigFile, hasPackageConfig] = await Promise.all([hasAnyFile(candidatePaths), hasPackageConfigFile(packageJsonPath, packageConfig)]);
+	return hasConfigFile || hasPackageConfig;
+}
+function isConfigPresentSync(options) {
+	const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);
+	for (const candidatePath of candidatePaths) if (__existsSync(candidatePath)) return true;
+	if (__existsSync(packageJsonPath)) try {
+		return hasPackageConfigKey((0, node_fs.readFileSync)(packageJsonPath, "utf8"), packageConfig);
+	} catch {
+		return false;
+	}
+	return false;
+}
+async function hasAnyFile(paths) {
+	return (await Promise.all(paths.map((candidatePath) => __exists(candidatePath)))).some(Boolean);
+}
+async function hasPackageConfigFile(packageJsonPath, packageConfig) {
+	if (!await __exists(packageJsonPath)) return false;
+	try {
+		return hasPackageConfigKey(await (0, node_fs_promises.readFile)(packageJsonPath, "utf8"), packageConfig);
+	} catch {
+		return false;
+	}
+}
+function hasPackageConfigKey(packageJsonContent, packageConfig) {
+	const value = JSON.parse(packageJsonContent)[packageConfig];
+	return value !== void 0 && value !== null && value !== false;
+}
+function toCandidates({ app, cwd = process.cwd(), extensions = defaultExtensions, packageConfig = app }) {
+	const candidatePaths = [node_path.default.join(cwd, `.${app}rc`)];
+	for (const extension of extensions) candidatePaths.push(node_path.default.join(cwd, `.${app}rc${extension}`), node_path.default.join(cwd, `${app}.config${extension}`));
+	return {
+		candidatePaths,
+		packageConfig,
+		packageJsonPath: node_path.default.join(cwd, "package.json")
+	};
+}
+//#endregion
 //#region src/json.ts
 /**
 * Ensure file is present/absent asynchronously with content value initialized or modified with `update`
@@ -346,9 +408,9 @@ function toFileOption$1({ update, ...otherOptions }) {
 //#endregion
 //#region src/meta.ts
 const meta = Object.freeze({
-	buildNumber: 1790065426,
+	buildNumber: 1790874075,
 	name: "@w5s/configurator-core",
-	version: "1.18.0"
+	version: "1.20.0"
 });
 //#endregion
 //#region src/yaml.ts
@@ -538,6 +600,8 @@ exports.file = file;
 exports.fileSync = fileSync;
 exports.ignoreFile = ignoreFile;
 exports.ignoreFileSync = ignoreFileSync;
+exports.isConfigPresent = isConfigPresent;
+exports.isConfigPresentSync = isConfigPresentSync;
 exports.json = json;
 exports.jsonSync = jsonSync;
 exports.meta = meta;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["access","constants","constants","readFile","writeFile","chmod","rm","readFileSync","mkdir","chmod","rm","toFileOption","toFileOption","yaml","YAML","spawn","spawnSync"],"sources":["../src/__exists.ts","../src/__existsSync.ts","../src/__toMode.ts","../src/file.ts","../src/block.ts","../src/directory.ts","../src/ignoreFile.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/exec.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"sourcesContent":["import { constants } from 'node:fs';\nimport { access } from 'node:fs/promises';\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 { 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 type { FileMode, FilePermissionSet } from './FileMode.js';\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\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","import { chmodSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { chmod, readFile, rm, writeFile } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface FileOptions {\n  /**\n   * File encoding\n   */\n  readonly encoding?: BufferEncoding;\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * File path\n   */\n  readonly path: string;\n\n  /**\n   * File target state\n   */\n  readonly state: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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 { encoding = 'utf8', mode, path, state, update } = 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 { encoding = 'utf8', mode, path, state, update } = 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 { file, type FileOptions, fileSync } from './file.js';\n\nexport interface BlockOptions {\n  /**\n   * Block content to insert\n   */\n  block: string;\n\n  /**\n   * Insert position\n   */\n  insertPosition?: ['after', 'EndOfFile' | RegExp] | ['before', 'BeginningOfFile' | RegExp];\n\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 target state\n   */\n  state?: 'absent' | 'present';\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\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\nfunction toFileOptions(options: BlockOptions): FileOptions {\n  const {\n    block: blockName,\n    insertPosition = ['after', EOF],\n    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,\n    path,\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 '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      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\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","import { chmodSync, mkdirSync, rmSync } from 'node:fs';\nimport { chmod, mkdir, rm } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface DirectoryOptions {\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * Directory path\n   */\n  readonly path: string;\n\n  /**\n   * Directory target state\n   */\n  readonly state: 'absent' | 'present';\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 { mode, path, state } = options;\n  const isPresent = await __exists(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      await mkdir(path, { mode: newMode, recursive: true });\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 { mode, path, state } = options;\n  const isPresent = __existsSync(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      mkdirSync(path, { mode: newMode, recursive: true });\n    }\n    if (newMode != null && isPresent) {\n      chmodSync(path, newMode);\n    }\n  } else if (isPresent) {\n    rmSync(path, { recursive: true });\n  }\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface IgnoreFileOptions extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function where content is represented as lines.\n   * When the file does not yet exist, the callback receives `undefined`.\n   */\n  readonly update?: ((content: Array<string> | undefined) => Array<string> | undefined) | undefined;\n}\n\n/**\n * Ensure file is present/absent asynchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * await ignoreFile({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport async function ignoreFile(options: IgnoreFileOptions): Promise<void> {\n  return file(toFileOption(options));\n}\n\n/**\n * Ensure file is present/absent synchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * ignoreFileSync({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport function ignoreFileSync(options: IgnoreFileOptions): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption({ update, ...otherOptions }: IgnoreFileOptions): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const eol = content.includes('\\r\\n') ? '\\r\\n' : '\\n';\n            const lines = content === '' ? undefined : content.split(eol);\n            const updatedLines = update(lines);\n\n            return updatedLines == null ? undefined : updatedLines.join(eol);\n          },\n  };\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type JSONValue = Array<JSONValue> | boolean | null | number | string | { [key: string]: JSONValue };\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\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","export const meta = Object.freeze({\n  // @ts-ignore - these variables are injected at build time\n  buildNumber: (typeof __PACKAGE_BUILD_NUMBER__ === 'undefined' ? 0 : __PACKAGE_BUILD_NUMBER__) as number,\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});\n","import YAML from 'yaml';\n\nimport { file, type FileOptions, fileSync } from './file.js';\n\nexport interface YAMLOption<V = YAMLValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type YAMLValue = Array<YAMLValue> | boolean | null | number | string | { [key: string]: YAMLValue };\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 yaml<Value>(options: YAMLOption<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 yamlSync<Value>(options: YAMLOption<Value>): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption<Value>({ update, ...otherOptions }: YAMLOption<Value>): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const yamlValue = content === '' ? undefined : (YAML.parse(content) as Value);\n\n            return YAML.stringify(update(yamlValue));\n          },\n  };\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?: 'ignore' | 'inherit' | 'pipe';\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<{ stderr: string; stdout: 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        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stdout += data.toString(encoding);\n      });\n    }\n    if (child.stderr != null) {\n      child.stderr.on('data', (data) => {\n        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stderr += data.toString(encoding);\n      });\n    }\n    // Handle process exit\n    child.on('close', (_code) => {\n      resolve({ stderr, stdout });\n    });\n\n    // Handle errors\n    child.on('error', reject);\n  });\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): { stderr: string; stdout: string } {\n  const result = spawnSync(command, args, { ...options });\n  const encoding = 'utf8';\n\n  return { stderr: result.stderr.toString(encoding), stdout: result.stdout.toString(encoding) };\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: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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', key]);\n    await exec('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    await exec('yarn', ['config', 'unset', key]);\n  }\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', key]);\n    execSync('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    execSync('yarn', ['config', 'unset', key]);\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: 'absent' | 'present';\n\n  /**\n   * Version mapping function\n   *\n   */\n  readonly update?: (() => undefined | YarnVersionKind) | undefined;\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', String(update == null ? 'berry' : update())]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\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', String(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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"}
+{"version":3,"file":"index.cjs","names":["access","constants","constants","readFile","writeFile","chmod","rm","readFileSync","mkdir","chmod","rm","toFileOption","readFileSync","readFile","path","toFileOption","yaml","YAML","spawn","spawnSync"],"sources":["../src/__exists.ts","../src/__existsSync.ts","../src/__toMode.ts","../src/file.ts","../src/block.ts","../src/directory.ts","../src/ignoreFile.ts","../src/isConfigPresent.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/exec.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"sourcesContent":["import { constants } from 'node:fs';\nimport { access } from 'node:fs/promises';\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 { 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 type { FileMode, FilePermissionSet } from './FileMode.js';\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\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","import { chmodSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { chmod, readFile, rm, writeFile } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface FileOptions {\n  /**\n   * File encoding\n   */\n  readonly encoding?: BufferEncoding;\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * File path\n   */\n  readonly path: string;\n\n  /**\n   * File target state\n   */\n  readonly state: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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 { encoding = 'utf8', mode, path, state, update } = 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 { encoding = 'utf8', mode, path, state, update } = 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 { file, type FileOptions, fileSync } from './file.js';\n\nexport interface BlockOptions {\n  /**\n   * Block content to insert\n   */\n  block: string;\n\n  /**\n   * Insert position\n   */\n  insertPosition?: ['after', 'EndOfFile' | RegExp] | ['before', 'BeginningOfFile' | RegExp];\n\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 target state\n   */\n  state?: 'absent' | 'present';\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\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\nfunction toFileOptions(options: BlockOptions): FileOptions {\n  const {\n    block: blockName,\n    insertPosition = ['after', EOF],\n    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,\n    path,\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 '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      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\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","import { chmodSync, mkdirSync, rmSync } from 'node:fs';\nimport { chmod, mkdir, rm } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface DirectoryOptions {\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * Directory path\n   */\n  readonly path: string;\n\n  /**\n   * Directory target state\n   */\n  readonly state: 'absent' | 'present';\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 { mode, path, state } = options;\n  const isPresent = await __exists(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      await mkdir(path, { mode: newMode, recursive: true });\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 { mode, path, state } = options;\n  const isPresent = __existsSync(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      mkdirSync(path, { mode: newMode, recursive: true });\n    }\n    if (newMode != null && isPresent) {\n      chmodSync(path, newMode);\n    }\n  } else if (isPresent) {\n    rmSync(path, { recursive: true });\n  }\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface IgnoreFileOptions extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function where content is represented as lines.\n   * When the file does not yet exist, the callback receives `undefined`.\n   */\n  readonly update?: ((content: Array<string> | undefined) => Array<string> | undefined) | undefined;\n}\n\n/**\n * Ensure file is present/absent asynchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * await ignoreFile({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport async function ignoreFile(options: IgnoreFileOptions): Promise<void> {\n  return file(toFileOption(options));\n}\n\n/**\n * Ensure file is present/absent synchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * ignoreFileSync({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport function ignoreFileSync(options: IgnoreFileOptions): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption({ update, ...otherOptions }: IgnoreFileOptions): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const eol = content.includes('\\r\\n') ? '\\r\\n' : '\\n';\n            const lines = content === '' ? undefined : content.split(eol);\n            const updatedLines = update(lines);\n\n            return updatedLines == null ? undefined : updatedLines.join(eol);\n          },\n  };\n}\n","import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\n\nconst defaultExtensions: Array<string> = ['.json', '.yaml', '.yml', '.js', '.cjs', '.mjs', '.ts', '.cts', '.mts'];\n\nexport interface IsConfigPresentOptions {\n  /**\n   * The name of the application.\n   */\n  app: string;\n\n  /**\n   * The directory to look into. Defaults to `process.cwd()`.\n   */\n  cwd?: string | undefined;\n\n  /**\n   * The list of extensions to check for.\n   */\n  extensions?: Array<string> | undefined;\n\n  /**\n   * The name of the package configuration. Defaults to `app`.\n   */\n  packageConfig?: string | undefined;\n}\n\n/**\n * Return whether tool configuration exists at `cwd` (cosmiconfig-style).\n *\n * Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching\n * `package.json` key.\n *\n * @param options\n */\nexport async function isConfigPresent(options: IsConfigPresentOptions): Promise<boolean> {\n  const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);\n\n  const [hasConfigFile, hasPackageConfig] = await Promise.all([\n    hasAnyFile(candidatePaths),\n    hasPackageConfigFile(packageJsonPath, packageConfig),\n  ]);\n\n  return hasConfigFile || hasPackageConfig;\n}\n\nexport function isConfigPresentSync(options: IsConfigPresentOptions): boolean {\n  const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);\n\n  for (const candidatePath of candidatePaths) {\n    if (__existsSync(candidatePath)) {\n      return true;\n    }\n  }\n\n  if (__existsSync(packageJsonPath)) {\n    try {\n      return hasPackageConfigKey(readFileSync(packageJsonPath, 'utf8'), packageConfig);\n    } catch {\n      return false;\n    }\n  }\n\n  return false;\n}\n\nasync function hasAnyFile(paths: Array<string>): Promise<boolean> {\n  const results = await Promise.all(paths.map((candidatePath) => __exists(candidatePath)));\n\n  return results.some(Boolean);\n}\n\nasync function hasPackageConfigFile(packageJsonPath: string, packageConfig: string): Promise<boolean> {\n  if (!(await __exists(packageJsonPath))) {\n    return false;\n  }\n\n  try {\n    return hasPackageConfigKey(await readFile(packageJsonPath, 'utf8'), packageConfig);\n  } catch {\n    return false;\n  }\n}\n\nfunction hasPackageConfigKey(packageJsonContent: string, packageConfig: string): boolean {\n  const packageJson = JSON.parse(packageJsonContent) as Record<string, unknown>;\n  const value = packageJson[packageConfig];\n\n  return value !== undefined && value !== null && value !== false;\n}\n\nfunction toCandidates({ app, cwd = process.cwd(), extensions = defaultExtensions, packageConfig = app }: IsConfigPresentOptions) {\n  const candidatePaths = [path.join(cwd, `.${app}rc`)];\n  for (const extension of extensions) {\n    candidatePaths.push(path.join(cwd, `.${app}rc${extension}`), path.join(cwd, `${app}.config${extension}`));\n  }\n\n  return {\n    candidatePaths,\n    packageConfig,\n    packageJsonPath: path.join(cwd, 'package.json'),\n  };\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type JSONValue = Array<JSONValue> | boolean | null | number | string | { [key: string]: JSONValue };\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\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","export const meta = Object.freeze({\n  // @ts-ignore - these variables are injected at build time\n  buildNumber: (typeof __PACKAGE_BUILD_NUMBER__ === 'undefined' ? 0 : __PACKAGE_BUILD_NUMBER__) as number,\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});\n","import YAML from 'yaml';\n\nimport { file, type FileOptions, fileSync } from './file.js';\n\nexport interface YAMLOption<V = YAMLValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type YAMLValue = Array<YAMLValue> | boolean | null | number | string | { [key: string]: YAMLValue };\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 yaml<Value>(options: YAMLOption<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 yamlSync<Value>(options: YAMLOption<Value>): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption<Value>({ update, ...otherOptions }: YAMLOption<Value>): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const yamlValue = content === '' ? undefined : (YAML.parse(content) as Value);\n\n            return YAML.stringify(update(yamlValue));\n          },\n  };\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?: 'ignore' | 'inherit' | 'pipe';\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<{ stderr: string; stdout: 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        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stdout += data.toString(encoding);\n      });\n    }\n    if (child.stderr != null) {\n      child.stderr.on('data', (data) => {\n        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stderr += data.toString(encoding);\n      });\n    }\n    // Handle process exit\n    child.on('close', (_code) => {\n      resolve({ stderr, stdout });\n    });\n\n    // Handle errors\n    child.on('error', reject);\n  });\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): { stderr: string; stdout: string } {\n  const result = spawnSync(command, args, { ...options });\n  const encoding = 'utf8';\n\n  return { stderr: result.stderr.toString(encoding), stdout: result.stdout.toString(encoding) };\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: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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', key]);\n    await exec('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    await exec('yarn', ['config', 'unset', key]);\n  }\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', key]);\n    execSync('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    execSync('yarn', ['config', 'unset', key]);\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: 'absent' | 'present';\n\n  /**\n   * Version mapping function\n   *\n   */\n  readonly update?: (() => undefined | YarnVersionKind) | undefined;\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', String(update == null ? 'berry' : update())]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\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', String(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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"}

package/dist/index.d.cts

@@ -228,6 +228,36 @@ export declare function ignoreFile(options: IgnoreFileOptions): Promise<void>;
  */
 export declare function ignoreFileSync(options: IgnoreFileOptions): void;
 //#endregion
+//#region src/isConfigPresent.d.ts
+export interface IsConfigPresentOptions {
+  /**
+   * The name of the application.
+   */
+  app: string;
+  /**
+   * The directory to look into. Defaults to `process.cwd()`.
+   */
+  cwd?: string | undefined;
+  /**
+   * The list of extensions to check for.
+   */
+  extensions?: Array<string> | undefined;
+  /**
+   * The name of the package configuration. Defaults to `app`.
+   */
+  packageConfig?: string | undefined;
+}
+/**
+ * Return whether tool configuration exists at `cwd` (cosmiconfig-style).
+ *
+ * Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching
+ * `package.json` key.
+ *
+ * @param options
+ */
+export declare function isConfigPresent(options: IsConfigPresentOptions): Promise<boolean>;
+export declare function isConfigPresentSync(options: IsConfigPresentOptions): boolean;
+//#endregion
 //#region src/json.d.ts
 export interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {
   /**

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/block.ts","../src/FileMode.ts","../src/directory.ts","../src/file.ts","../src/ignoreFile.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"mappings":";iBAEiB;;;;EAIf;;;;EAKA,yCAAyC,yCAAyC;;;;;;EAOlF,UAAU;;;;EAKV;;;;EAKA;;;;;;;;;;;wBAgCc,MAAM,SAAS,eAAY;;;;;;;;;;wBAa3B,UAAU,SAAS;;;UCzElB;;;;WAIN,QAAQ;;;;WAKR,QAAQ;;;;WAKR,QAAQ;;UAGF;;;;WAIN;;;;WAKA;;;;WAKA;;;;iBCtBM;;;;WAIN,OAAO;;;;WAKP;;;;WAKA;;;;;;;;;;;;;;;;;;;;wBAqBW,UAAU,SAAS,mBAAmB;;;;;;;;;;;;;;;;;;;wBAkC5C,cAAc,SAAS;;;iBCrEtB;;;;WAIN,WAAW;;;;WAKX,OAAO;;;;WAKP;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;;;;;;;;;wBAsBA,KAAK,SAAS,cAAc;;;;;;;;;;;;;;;;;;;;wBAqClC,SAAS,SAAS;;;iBC3FjB,0BAA0B,KAAK;;;;;WAKrC,WAAW,SAAS,8BAA8B;;;;;;;;;;;;;;wBAevC,WAAW,SAAS,oBAAoB;;;;;;;;;;;;;wBAgB9C,eAAe,SAAS;;;iBCpCvB,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;qBCzBvC,MAAI;EAEkF;EAEtB;EAES;;;;iBCFrE,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;iBCzBnC;;;;WAIN;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;wBAcA,WAAW,SAAS,oBAAoB;;;;;;;;;;;;wBAqB9C,eAAe,SAAS;;;YClD5B;iBAEK;;;;WAIN;;;;;WAMA,4BAA4B;;;;;;;;;;;;wBAajB,YAAY,SAAS,qBAAqB;;;;;;;;;;;wBAoBhD,gBAAgB,SAAS"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/block.ts","../src/FileMode.ts","../src/directory.ts","../src/file.ts","../src/ignoreFile.ts","../src/isConfigPresent.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"mappings":";iBAEiB;;;;EAIf;;;;EAKA,yCAAyC,yCAAyC;;;;;;EAOlF,UAAU;;;;EAKV;;;;EAKA;;;;;;;;;;;wBAgCc,MAAM,SAAS,eAAY;;;;;;;;;;wBAa3B,UAAU,SAAS;;;UCzElB;;;;WAIN,QAAQ;;;;WAKR,QAAQ;;;;WAKR,QAAQ;;UAGF;;;;WAIN;;;;WAKA;;;;WAKA;;;;iBCtBM;;;;WAIN,OAAO;;;;WAKP;;;;WAKA;;;;;;;;;;;;;;;;;;;;wBAqBW,UAAU,SAAS,mBAAmB;;;;;;;;;;;;;;;;;;;wBAkC5C,cAAc,SAAS;;;iBCrEtB;;;;WAIN,WAAW;;;;WAKX,OAAO;;;;WAKP;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;;;;;;;;;wBAsBA,KAAK,SAAS,cAAc;;;;;;;;;;;;;;;;;;;;wBAqClC,SAAS,SAAS;;;iBC3FjB,0BAA0B,KAAK;;;;;WAKrC,WAAW,SAAS,8BAA8B;;;;;;;;;;;;;;wBAevC,WAAW,SAAS,oBAAoB;;;;;;;;;;;;;wBAgB9C,eAAe,SAAS;;;iBC7BvB;;;;EAIf;;;;EAKA;;;;EAKA,aAAa;;;;EAKb;;;;;;;;;;wBAWoB,gBAAgB,SAAS,yBAAyB;wBAWxD,oBAAoB,SAAS;;;iBChD5B,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;qBCzBvC,MAAI;EAEkF;EAEtB;EAES;;;;iBCFrE,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;iBCzBnC;;;;WAIN;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;wBAcA,WAAW,SAAS,oBAAoB;;;;;;;;;;;;wBAqB9C,eAAe,SAAS;;;YClD5B;iBAEK;;;;WAIN;;;;;WAMA,4BAA4B;;;;;;;;;;;;wBAajB,YAAY,SAAS,qBAAqB;;;;;;;;;;;wBAoBhD,gBAAgB,SAAS"}

package/dist/index.d.ts

@@ -228,6 +228,36 @@ export declare function ignoreFile(options: IgnoreFileOptions): Promise<void>;
  */
 export declare function ignoreFileSync(options: IgnoreFileOptions): void;
 //#endregion
+//#region src/isConfigPresent.d.ts
+export interface IsConfigPresentOptions {
+  /**
+   * The name of the application.
+   */
+  app: string;
+  /**
+   * The directory to look into. Defaults to `process.cwd()`.
+   */
+  cwd?: string | undefined;
+  /**
+   * The list of extensions to check for.
+   */
+  extensions?: Array<string> | undefined;
+  /**
+   * The name of the package configuration. Defaults to `app`.
+   */
+  packageConfig?: string | undefined;
+}
+/**
+ * Return whether tool configuration exists at `cwd` (cosmiconfig-style).
+ *
+ * Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching
+ * `package.json` key.
+ *
+ * @param options
+ */
+export declare function isConfigPresent(options: IsConfigPresentOptions): Promise<boolean>;
+export declare function isConfigPresentSync(options: IsConfigPresentOptions): boolean;
+//#endregion
 //#region src/json.d.ts
 export interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {
   /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/block.ts","../src/FileMode.ts","../src/directory.ts","../src/file.ts","../src/ignoreFile.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"mappings":";iBAEiB;;;;EAIf;;;;EAKA,yCAAyC,yCAAyC;;;;;;EAOlF,UAAU;;;;EAKV;;;;EAKA;;;;;;;;;;;wBAgCc,MAAM,SAAS,eAAY;;;;;;;;;;wBAa3B,UAAU,SAAS;;;UCzElB;;;;WAIN,QAAQ;;;;WAKR,QAAQ;;;;WAKR,QAAQ;;UAGF;;;;WAIN;;;;WAKA;;;;WAKA;;;;iBCtBM;;;;WAIN,OAAO;;;;WAKP;;;;WAKA;;;;;;;;;;;;;;;;;;;;wBAqBW,UAAU,SAAS,mBAAmB;;;;;;;;;;;;;;;;;;;wBAkC5C,cAAc,SAAS;;;iBCrEtB;;;;WAIN,WAAW;;;;WAKX,OAAO;;;;WAKP;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;;;;;;;;;wBAsBA,KAAK,SAAS,cAAc;;;;;;;;;;;;;;;;;;;;wBAqClC,SAAS,SAAS;;;iBC3FjB,0BAA0B,KAAK;;;;;WAKrC,WAAW,SAAS,8BAA8B;;;;;;;;;;;;;;wBAevC,WAAW,SAAS,oBAAoB;;;;;;;;;;;;;wBAgB9C,eAAe,SAAS;;;iBCpCvB,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;qBCzBvC,MAAI;EAEkF;EAEtB;EAES;;;;iBCFrE,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;iBCzBnC;;;;WAIN;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;wBAcA,WAAW,SAAS,oBAAoB;;;;;;;;;;;;wBAqB9C,eAAe,SAAS;;;YClD5B;iBAEK;;;;WAIN;;;;;WAMA,4BAA4B;;;;;;;;;;;;wBAajB,YAAY,SAAS,qBAAqB;;;;;;;;;;;wBAoBhD,gBAAgB,SAAS"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/block.ts","../src/FileMode.ts","../src/directory.ts","../src/file.ts","../src/ignoreFile.ts","../src/isConfigPresent.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"mappings":";iBAEiB;;;;EAIf;;;;EAKA,yCAAyC,yCAAyC;;;;;;EAOlF,UAAU;;;;EAKV;;;;EAKA;;;;;;;;;;;wBAgCc,MAAM,SAAS,eAAY;;;;;;;;;;wBAa3B,UAAU,SAAS;;;UCzElB;;;;WAIN,QAAQ;;;;WAKR,QAAQ;;;;WAKR,QAAQ;;UAGF;;;;WAIN;;;;WAKA;;;;WAKA;;;;iBCtBM;;;;WAIN,OAAO;;;;WAKP;;;;WAKA;;;;;;;;;;;;;;;;;;;;wBAqBW,UAAU,SAAS,mBAAmB;;;;;;;;;;;;;;;;;;;wBAkC5C,cAAc,SAAS;;;iBCrEtB;;;;WAIN,WAAW;;;;WAKX,OAAO;;;;WAKP;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;;;;;;;;;wBAsBA,KAAK,SAAS,cAAc;;;;;;;;;;;;;;;;;;;;wBAqClC,SAAS,SAAS;;;iBC3FjB,0BAA0B,KAAK;;;;;WAKrC,WAAW,SAAS,8BAA8B;;;;;;;;;;;;;;wBAevC,WAAW,SAAS,oBAAoB;;;;;;;;;;;;;wBAgB9C,eAAe,SAAS;;;iBC7BvB;;;;EAIf;;;;EAKA;;;;EAKA,aAAa;;;;EAKb;;;;;;;;;;wBAWoB,gBAAgB,SAAS,yBAAyB;wBAWxD,oBAAoB,SAAS;;;iBChD5B,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;qBCzBvC,MAAI;EAEkF;EAEtB;EAES;;;;iBCFrE,WAAW,IAAI,mBAAmB,KAAK;;;;WAI7C,WAAW,qBAAqB,kBAAkB;;YAGjD,YAAY,MAAM;GAAmD,cAAc;;;;;;;wBAOzE,KAAK,OAAO,SAAS,WAAW,SAAS;;;;;;wBAS/C,SAAS,OAAO,SAAS,WAAW;;;iBCzBnC;;;;WAIN;;;;WAKA;;;;;WAMA,WAAW;;;;;;;;;;;;;wBAcA,WAAW,SAAS,oBAAoB;;;;;;;;;;;;wBAqB9C,eAAe,SAAS;;;YClD5B;iBAEK;;;;WAIN;;;;;WAMA,4BAA4B;;;;;;;;;;;;wBAajB,YAAY,SAAS,qBAAqB;;;;;;;;;;;wBAoBhD,gBAAgB,SAAS"}

package/dist/index.js

@@ -1,5 +1,6 @@
 import { accessSync, chmodSync, constants, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { access, chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
 import YAML from "yaml";
 import { spawn, spawnSync } from "node:child_process";
 //#region src/__exists.ts
@@ -293,6 +294,66 @@ function toFileOption$2({ update, ...otherOptions }) {
 	};
 }
 //#endregion
+//#region src/isConfigPresent.ts
+const defaultExtensions = [
+	".json",
+	".yaml",
+	".yml",
+	".js",
+	".cjs",
+	".mjs",
+	".ts",
+	".cts",
+	".mts"
+];
+/**
+* Return whether tool configuration exists at `cwd` (cosmiconfig-style).
+*
+* Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching
+* `package.json` key.
+*
+* @param options
+*/
+async function isConfigPresent(options) {
+	const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);
+	const [hasConfigFile, hasPackageConfig] = await Promise.all([hasAnyFile(candidatePaths), hasPackageConfigFile(packageJsonPath, packageConfig)]);
+	return hasConfigFile || hasPackageConfig;
+}
+function isConfigPresentSync(options) {
+	const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);
+	for (const candidatePath of candidatePaths) if (__existsSync(candidatePath)) return true;
+	if (__existsSync(packageJsonPath)) try {
+		return hasPackageConfigKey(readFileSync(packageJsonPath, "utf8"), packageConfig);
+	} catch {
+		return false;
+	}
+	return false;
+}
+async function hasAnyFile(paths) {
+	return (await Promise.all(paths.map((candidatePath) => __exists(candidatePath)))).some(Boolean);
+}
+async function hasPackageConfigFile(packageJsonPath, packageConfig) {
+	if (!await __exists(packageJsonPath)) return false;
+	try {
+		return hasPackageConfigKey(await readFile(packageJsonPath, "utf8"), packageConfig);
+	} catch {
+		return false;
+	}
+}
+function hasPackageConfigKey(packageJsonContent, packageConfig) {
+	const value = JSON.parse(packageJsonContent)[packageConfig];
+	return value !== void 0 && value !== null && value !== false;
+}
+function toCandidates({ app, cwd = process.cwd(), extensions = defaultExtensions, packageConfig = app }) {
+	const candidatePaths = [path.join(cwd, `.${app}rc`)];
+	for (const extension of extensions) candidatePaths.push(path.join(cwd, `.${app}rc${extension}`), path.join(cwd, `${app}.config${extension}`));
+	return {
+		candidatePaths,
+		packageConfig,
+		packageJsonPath: path.join(cwd, "package.json")
+	};
+}
+//#endregion
 //#region src/json.ts
 /**
 * Ensure file is present/absent asynchronously with content value initialized or modified with `update`
@@ -322,9 +383,9 @@ function toFileOption$1({ update, ...otherOptions }) {
 //#endregion
 //#region src/meta.ts
 const meta = Object.freeze({
-	buildNumber: 1790065426,
+	buildNumber: 1790874075,
 	name: "@w5s/configurator-core",
-	version: "1.18.0"
+	version: "1.20.0"
 });
 //#endregion
 //#region src/yaml.ts
@@ -506,6 +567,6 @@ function yarnVersionSync(options) {
 	else throw new Error("Not implemented");
 }
 //#endregion
-export { block, blockSync, directory, directorySync, file, fileSync, ignoreFile, ignoreFileSync, json, jsonSync, meta, yaml, yamlSync, yarnConfig, yarnConfigSync, yarnVersion, yarnVersionSync };
+export { block, blockSync, directory, directorySync, file, fileSync, ignoreFile, ignoreFileSync, isConfigPresent, isConfigPresentSync, json, jsonSync, meta, yaml, yamlSync, yarnConfig, yarnConfigSync, yarnVersion, yarnVersionSync };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["toFileOption","toFileOption"],"sources":["../src/__exists.ts","../src/__existsSync.ts","../src/__toMode.ts","../src/file.ts","../src/block.ts","../src/directory.ts","../src/ignoreFile.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/exec.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"sourcesContent":["import { constants } from 'node:fs';\nimport { access } from 'node:fs/promises';\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 { 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 type { FileMode, FilePermissionSet } from './FileMode.js';\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\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","import { chmodSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { chmod, readFile, rm, writeFile } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface FileOptions {\n  /**\n   * File encoding\n   */\n  readonly encoding?: BufferEncoding;\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * File path\n   */\n  readonly path: string;\n\n  /**\n   * File target state\n   */\n  readonly state: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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 { encoding = 'utf8', mode, path, state, update } = 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 { encoding = 'utf8', mode, path, state, update } = 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 { file, type FileOptions, fileSync } from './file.js';\n\nexport interface BlockOptions {\n  /**\n   * Block content to insert\n   */\n  block: string;\n\n  /**\n   * Insert position\n   */\n  insertPosition?: ['after', 'EndOfFile' | RegExp] | ['before', 'BeginningOfFile' | RegExp];\n\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 target state\n   */\n  state?: 'absent' | 'present';\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\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\nfunction toFileOptions(options: BlockOptions): FileOptions {\n  const {\n    block: blockName,\n    insertPosition = ['after', EOF],\n    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,\n    path,\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 '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      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\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","import { chmodSync, mkdirSync, rmSync } from 'node:fs';\nimport { chmod, mkdir, rm } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface DirectoryOptions {\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * Directory path\n   */\n  readonly path: string;\n\n  /**\n   * Directory target state\n   */\n  readonly state: 'absent' | 'present';\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 { mode, path, state } = options;\n  const isPresent = await __exists(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      await mkdir(path, { mode: newMode, recursive: true });\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 { mode, path, state } = options;\n  const isPresent = __existsSync(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      mkdirSync(path, { mode: newMode, recursive: true });\n    }\n    if (newMode != null && isPresent) {\n      chmodSync(path, newMode);\n    }\n  } else if (isPresent) {\n    rmSync(path, { recursive: true });\n  }\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface IgnoreFileOptions extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function where content is represented as lines.\n   * When the file does not yet exist, the callback receives `undefined`.\n   */\n  readonly update?: ((content: Array<string> | undefined) => Array<string> | undefined) | undefined;\n}\n\n/**\n * Ensure file is present/absent asynchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * await ignoreFile({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport async function ignoreFile(options: IgnoreFileOptions): Promise<void> {\n  return file(toFileOption(options));\n}\n\n/**\n * Ensure file is present/absent synchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * ignoreFileSync({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport function ignoreFileSync(options: IgnoreFileOptions): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption({ update, ...otherOptions }: IgnoreFileOptions): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const eol = content.includes('\\r\\n') ? '\\r\\n' : '\\n';\n            const lines = content === '' ? undefined : content.split(eol);\n            const updatedLines = update(lines);\n\n            return updatedLines == null ? undefined : updatedLines.join(eol);\n          },\n  };\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type JSONValue = Array<JSONValue> | boolean | null | number | string | { [key: string]: JSONValue };\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\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","export const meta = Object.freeze({\n  // @ts-ignore - these variables are injected at build time\n  buildNumber: (typeof __PACKAGE_BUILD_NUMBER__ === 'undefined' ? 0 : __PACKAGE_BUILD_NUMBER__) as number,\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});\n","import YAML from 'yaml';\n\nimport { file, type FileOptions, fileSync } from './file.js';\n\nexport interface YAMLOption<V = YAMLValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type YAMLValue = Array<YAMLValue> | boolean | null | number | string | { [key: string]: YAMLValue };\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 yaml<Value>(options: YAMLOption<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 yamlSync<Value>(options: YAMLOption<Value>): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption<Value>({ update, ...otherOptions }: YAMLOption<Value>): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const yamlValue = content === '' ? undefined : (YAML.parse(content) as Value);\n\n            return YAML.stringify(update(yamlValue));\n          },\n  };\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?: 'ignore' | 'inherit' | 'pipe';\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<{ stderr: string; stdout: 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        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stdout += data.toString(encoding);\n      });\n    }\n    if (child.stderr != null) {\n      child.stderr.on('data', (data) => {\n        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stderr += data.toString(encoding);\n      });\n    }\n    // Handle process exit\n    child.on('close', (_code) => {\n      resolve({ stderr, stdout });\n    });\n\n    // Handle errors\n    child.on('error', reject);\n  });\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): { stderr: string; stdout: string } {\n  const result = spawnSync(command, args, { ...options });\n  const encoding = 'utf8';\n\n  return { stderr: result.stderr.toString(encoding), stdout: result.stdout.toString(encoding) };\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: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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', key]);\n    await exec('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    await exec('yarn', ['config', 'unset', key]);\n  }\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', key]);\n    execSync('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    execSync('yarn', ['config', 'unset', key]);\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: 'absent' | 'present';\n\n  /**\n   * Version mapping function\n   *\n   */\n  readonly update?: (() => undefined | YarnVersionKind) | undefined;\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', String(update == null ? 'berry' : update())]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\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', String(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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"}
+{"version":3,"file":"index.js","names":["toFileOption","toFileOption"],"sources":["../src/__exists.ts","../src/__existsSync.ts","../src/__toMode.ts","../src/file.ts","../src/block.ts","../src/directory.ts","../src/ignoreFile.ts","../src/isConfigPresent.ts","../src/json.ts","../src/meta.ts","../src/yaml.ts","../src/exec.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"sourcesContent":["import { constants } from 'node:fs';\nimport { access } from 'node:fs/promises';\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 { 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 type { FileMode, FilePermissionSet } from './FileMode.js';\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\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","import { chmodSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { chmod, readFile, rm, writeFile } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface FileOptions {\n  /**\n   * File encoding\n   */\n  readonly encoding?: BufferEncoding;\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * File path\n   */\n  readonly path: string;\n\n  /**\n   * File target state\n   */\n  readonly state: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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 { encoding = 'utf8', mode, path, state, update } = 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 { encoding = 'utf8', mode, path, state, update } = 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 { file, type FileOptions, fileSync } from './file.js';\n\nexport interface BlockOptions {\n  /**\n   * Block content to insert\n   */\n  block: string;\n\n  /**\n   * Insert position\n   */\n  insertPosition?: ['after', 'EndOfFile' | RegExp] | ['before', 'BeginningOfFile' | RegExp];\n\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 target state\n   */\n  state?: 'absent' | 'present';\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\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\nfunction toFileOptions(options: BlockOptions): FileOptions {\n  const {\n    block: blockName,\n    insertPosition = ['after', EOF],\n    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,\n    path,\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 '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      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\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","import { chmodSync, mkdirSync, rmSync } from 'node:fs';\nimport { chmod, mkdir, rm } from 'node:fs/promises';\n\nimport type { FileMode } from './FileMode.js';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface DirectoryOptions {\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n\n  /**\n   * Directory path\n   */\n  readonly path: string;\n\n  /**\n   * Directory target state\n   */\n  readonly state: 'absent' | 'present';\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 { mode, path, state } = options;\n  const isPresent = await __exists(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      await mkdir(path, { mode: newMode, recursive: true });\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 { mode, path, state } = options;\n  const isPresent = __existsSync(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      mkdirSync(path, { mode: newMode, recursive: true });\n    }\n    if (newMode != null && isPresent) {\n      chmodSync(path, newMode);\n    }\n  } else if (isPresent) {\n    rmSync(path, { recursive: true });\n  }\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface IgnoreFileOptions extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function where content is represented as lines.\n   * When the file does not yet exist, the callback receives `undefined`.\n   */\n  readonly update?: ((content: Array<string> | undefined) => Array<string> | undefined) | undefined;\n}\n\n/**\n * Ensure file is present/absent asynchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * await ignoreFile({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport async function ignoreFile(options: IgnoreFileOptions): Promise<void> {\n  return file(toFileOption(options));\n}\n\n/**\n * Ensure file is present/absent synchronously with content initialized or modified by line.\n *\n * @example\n * ```ts\n * ignoreFileSync({\n *   path: '.gitignore',\n *   update: (lines) => [...(lines ?? []), 'dist'],\n * });\n * ```\n * @param options File target options.\n */\nexport function ignoreFileSync(options: IgnoreFileOptions): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption({ update, ...otherOptions }: IgnoreFileOptions): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const eol = content.includes('\\r\\n') ? '\\r\\n' : '\\n';\n            const lines = content === '' ? undefined : content.split(eol);\n            const updatedLines = update(lines);\n\n            return updatedLines == null ? undefined : updatedLines.join(eol);\n          },\n  };\n}\n","import { readFileSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport path from 'node:path';\n\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\n\nconst defaultExtensions: Array<string> = ['.json', '.yaml', '.yml', '.js', '.cjs', '.mjs', '.ts', '.cts', '.mts'];\n\nexport interface IsConfigPresentOptions {\n  /**\n   * The name of the application.\n   */\n  app: string;\n\n  /**\n   * The directory to look into. Defaults to `process.cwd()`.\n   */\n  cwd?: string | undefined;\n\n  /**\n   * The list of extensions to check for.\n   */\n  extensions?: Array<string> | undefined;\n\n  /**\n   * The name of the package configuration. Defaults to `app`.\n   */\n  packageConfig?: string | undefined;\n}\n\n/**\n * Return whether tool configuration exists at `cwd` (cosmiconfig-style).\n *\n * Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching\n * `package.json` key.\n *\n * @param options\n */\nexport async function isConfigPresent(options: IsConfigPresentOptions): Promise<boolean> {\n  const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);\n\n  const [hasConfigFile, hasPackageConfig] = await Promise.all([\n    hasAnyFile(candidatePaths),\n    hasPackageConfigFile(packageJsonPath, packageConfig),\n  ]);\n\n  return hasConfigFile || hasPackageConfig;\n}\n\nexport function isConfigPresentSync(options: IsConfigPresentOptions): boolean {\n  const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);\n\n  for (const candidatePath of candidatePaths) {\n    if (__existsSync(candidatePath)) {\n      return true;\n    }\n  }\n\n  if (__existsSync(packageJsonPath)) {\n    try {\n      return hasPackageConfigKey(readFileSync(packageJsonPath, 'utf8'), packageConfig);\n    } catch {\n      return false;\n    }\n  }\n\n  return false;\n}\n\nasync function hasAnyFile(paths: Array<string>): Promise<boolean> {\n  const results = await Promise.all(paths.map((candidatePath) => __exists(candidatePath)));\n\n  return results.some(Boolean);\n}\n\nasync function hasPackageConfigFile(packageJsonPath: string, packageConfig: string): Promise<boolean> {\n  if (!(await __exists(packageJsonPath))) {\n    return false;\n  }\n\n  try {\n    return hasPackageConfigKey(await readFile(packageJsonPath, 'utf8'), packageConfig);\n  } catch {\n    return false;\n  }\n}\n\nfunction hasPackageConfigKey(packageJsonContent: string, packageConfig: string): boolean {\n  const packageJson = JSON.parse(packageJsonContent) as Record<string, unknown>;\n  const value = packageJson[packageConfig];\n\n  return value !== undefined && value !== null && value !== false;\n}\n\nfunction toCandidates({ app, cwd = process.cwd(), extensions = defaultExtensions, packageConfig = app }: IsConfigPresentOptions) {\n  const candidatePaths = [path.join(cwd, `.${app}rc`)];\n  for (const extension of extensions) {\n    candidatePaths.push(path.join(cwd, `.${app}rc${extension}`), path.join(cwd, `${app}.config${extension}`));\n  }\n\n  return {\n    candidatePaths,\n    packageConfig,\n    packageJsonPath: path.join(cwd, 'package.json'),\n  };\n}\n","import { file, type FileOptions, fileSync } from './file.js';\n\nexport interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type JSONValue = Array<JSONValue> | boolean | null | number | string | { [key: string]: JSONValue };\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\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","export const meta = Object.freeze({\n  // @ts-ignore - these variables are injected at build time\n  buildNumber: (typeof __PACKAGE_BUILD_NUMBER__ === 'undefined' ? 0 : __PACKAGE_BUILD_NUMBER__) as number,\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});\n","import YAML from 'yaml';\n\nimport { file, type FileOptions, fileSync } from './file.js';\n\nexport interface YAMLOption<V = YAMLValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: undefined | V) => undefined | V) | undefined;\n}\n\nexport type YAMLValue = Array<YAMLValue> | boolean | null | number | string | { [key: string]: YAMLValue };\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 yaml<Value>(options: YAMLOption<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 yamlSync<Value>(options: YAMLOption<Value>): void {\n  return fileSync(toFileOption(options));\n}\n\nfunction toFileOption<Value>({ update, ...otherOptions }: YAMLOption<Value>): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const yamlValue = content === '' ? undefined : (YAML.parse(content) as Value);\n\n            return YAML.stringify(update(yamlValue));\n          },\n  };\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?: 'ignore' | 'inherit' | 'pipe';\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<{ stderr: string; stdout: 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        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stdout += data.toString(encoding);\n      });\n    }\n    if (child.stderr != null) {\n      child.stderr.on('data', (data) => {\n        // eslint-disable-next-line ts/no-unsafe-call, ts/no-unsafe-member-access\n        stderr += data.toString(encoding);\n      });\n    }\n    // Handle process exit\n    child.on('close', (_code) => {\n      resolve({ stderr, stdout });\n    });\n\n    // Handle errors\n    child.on('error', reject);\n  });\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): { stderr: string; stdout: string } {\n  const result = spawnSync(command, args, { ...options });\n  const encoding = 'utf8';\n\n  return { stderr: result.stderr.toString(encoding), stdout: result.stdout.toString(encoding) };\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: 'absent' | 'present';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\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', key]);\n    await exec('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    await exec('yarn', ['config', 'unset', key]);\n  }\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', key]);\n    execSync('yarn', ['config', 'set', key, String(update == null ? '' : update(stdout))]);\n  } else {\n    execSync('yarn', ['config', 'unset', key]);\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: 'absent' | 'present';\n\n  /**\n   * Version mapping function\n   *\n   */\n  readonly update?: (() => undefined | YarnVersionKind) | undefined;\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', String(update == null ? 'berry' : update())]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\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', String(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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w5s/configurator-core",
-  "version": "1.18.0",
+  "version": "1.20.0",
   "description": "Core library for @w5s/configurator-core",
   "keywords": [
     "config",
@@ -46,5 +46,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ed181ba68ebff886310db849facb938bb00f61ca"
+  "gitHead": "22c5f0c577887c9855d4a6fa3c139e0e36a1bc6a"
 }

package/src/index.ts

@@ -2,6 +2,7 @@ export * from './block.js';
 export * from './directory.js';
 export * from './file.js';
 export * from './ignoreFile.js';
+export * from './isConfigPresent.js';
 export * from './json.js';
 export * from './meta.js';
 export * from './yaml.js';

package/src/isConfigPresent.ts

@@ -0,0 +1,107 @@
+import { readFileSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+
+import { __exists } from './__exists.js';
+import { __existsSync } from './__existsSync.js';
+
+const defaultExtensions: Array<string> = ['.json', '.yaml', '.yml', '.js', '.cjs', '.mjs', '.ts', '.cts', '.mts'];
+
+export interface IsConfigPresentOptions {
+  /**
+   * The name of the application.
+   */
+  app: string;
+
+  /**
+   * The directory to look into. Defaults to `process.cwd()`.
+   */
+  cwd?: string | undefined;
+
+  /**
+   * The list of extensions to check for.
+   */
+  extensions?: Array<string> | undefined;
+
+  /**
+   * The name of the package configuration. Defaults to `app`.
+   */
+  packageConfig?: string | undefined;
+}
+
+/**
+ * Return whether tool configuration exists at `cwd` (cosmiconfig-style).
+ *
+ * Looks for `.{app}rc`, `.{app}rc.{ext}`, `{app}.config.{ext}` and a matching
+ * `package.json` key.
+ *
+ * @param options
+ */
+export async function isConfigPresent(options: IsConfigPresentOptions): Promise<boolean> {
+  const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);
+
+  const [hasConfigFile, hasPackageConfig] = await Promise.all([
+    hasAnyFile(candidatePaths),
+    hasPackageConfigFile(packageJsonPath, packageConfig),
+  ]);
+
+  return hasConfigFile || hasPackageConfig;
+}
+
+export function isConfigPresentSync(options: IsConfigPresentOptions): boolean {
+  const { candidatePaths, packageConfig, packageJsonPath } = toCandidates(options);
+
+  for (const candidatePath of candidatePaths) {
+    if (__existsSync(candidatePath)) {
+      return true;
+    }
+  }
+
+  if (__existsSync(packageJsonPath)) {
+    try {
+      return hasPackageConfigKey(readFileSync(packageJsonPath, 'utf8'), packageConfig);
+    } catch {
+      return false;
+    }
+  }
+
+  return false;
+}
+
+async function hasAnyFile(paths: Array<string>): Promise<boolean> {
+  const results = await Promise.all(paths.map((candidatePath) => __exists(candidatePath)));
+
+  return results.some(Boolean);
+}
+
+async function hasPackageConfigFile(packageJsonPath: string, packageConfig: string): Promise<boolean> {
+  if (!(await __exists(packageJsonPath))) {
+    return false;
+  }
+
+  try {
+    return hasPackageConfigKey(await readFile(packageJsonPath, 'utf8'), packageConfig);
+  } catch {
+    return false;
+  }
+}
+
+function hasPackageConfigKey(packageJsonContent: string, packageConfig: string): boolean {
+  const packageJson = JSON.parse(packageJsonContent) as Record<string, unknown>;
+  const value = packageJson[packageConfig];
+
+  return value !== undefined && value !== null && value !== false;
+}
+
+function toCandidates({ app, cwd = process.cwd(), extensions = defaultExtensions, packageConfig = app }: IsConfigPresentOptions) {
+  const candidatePaths = [path.join(cwd, `.${app}rc`)];
+  for (const extension of extensions) {
+    candidatePaths.push(path.join(cwd, `.${app}rc${extension}`), path.join(cwd, `${app}.config${extension}`));
+  }
+
+  return {
+    candidatePaths,
+    packageConfig,
+    packageJsonPath: path.join(cwd, 'package.json'),
+  };
+}