@xpack/xpm-lib 3.1.2 → 4.0.0

package/src/types/xpm-init-template.ts

@@ -0,0 +1,282 @@
+/*
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2021-2026 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/license/mit.
+ */
+
+// ============================================================================
+
+/**
+ * Represents a map of `xpm init` template property definitions.
+ *
+ * @remarks
+ * Template properties define the interactive configuration interface for
+ * `xpm init` command, allowing templates to collect user input before
+ * generating project files.
+ *
+ * Each property key becomes accessible in template files via Liquid syntax
+ * as `{{ properties.key }}`. Property definitions control the prompt type,
+ * validation, default values, and available options.
+ *
+ * Example usage in template metadata:
+ *
+ * ```js
+ * {
+ *   language: {
+ *     label: 'Programming language',
+ *     description: 'Select the preferred programming language',
+ *     type: 'select',
+ *     items: {
+ *       c: 'C for the application files',
+ *       cpp: 'C++ for the application files'
+ *     },
+ *     default: 'cpp',
+ *     isMandatory: true
+ *   }
+ * }
+ * ```
+ */
+export type InitTemplatePropertiesDefinitions = Record<
+  string,
+  InitTemplatePropertiesDefinition
+>
+
+/**
+ * Defines an `xpm init` single template property.
+ *
+ * @remarks
+ * Property definitions control how users are prompted for template
+ * configuration values during `xpm init` execution.
+ *
+ * Property types:
+ *
+ * <ul>
+ * <li><code>select</code>: Present a list of options for the user to
+ *    choose from.
+ *    Requires <code>items</code> to be populated with available choices.</li>
+ * <li><code>string</code>: Accept free-form text input from the user.</li>
+ * <li><code>number</code>: Accept numeric input with validation.</li>
+ * <li><code>boolean</code>: Accept yes/no input
+ *    (<code>true</code>/<code>false</code>).</li>
+ * </ul>
+ *
+ * Platform filtering: For `select` types, items can specify platform
+ * constraints via `InitTemplateItemValue`, hiding options that
+ * don't match the current platform. This enables platform-specific
+ * configuration without manual filtering.
+ *
+ * Mandatory properties without defaults will block template initialization
+ * until the user provides a value. Optional properties with defaults use
+ * the default when the user skips the prompt.
+ */
+export interface InitTemplatePropertiesDefinition {
+  /**
+   * The human-readable label used in prompts.
+   */
+  label: string
+  /**
+   * The description shown when the user requests help.
+   */
+  description: string
+  /**
+   * The property value type.
+   */
+  type: InitTemplateType
+  /**
+   * The selectable items for a `select` property.
+   */
+  items?: InitTemplateItems
+  /**
+   * Indicates whether the property is mandatory; defaults to `false`.
+   */
+  isMandatory?: boolean
+  /**
+   * The default value for the property. Must match the property type.
+   */
+  default?: string | number | boolean
+}
+
+/**
+ * Represents the supported property types for `xpm init` template
+ * properties.
+ *
+ * @remarks
+ * Property types control how the `xpm init` command prompts users for
+ * configuration values during template initialisation:
+ *
+ * <ul>
+ * <li><b><code>select</code>:</b> Presents a list of predefined options
+ *    for the user to choose from. Requires the <code>items</code> field to
+ *    be populated.</li>
+ * <li><b><code>string</code>:</b> Accepts free-form text input from the
+ *    user.</li>
+ * <li><b><code>number</code>:</b> Accepts numeric input with
+ *    validation.</li>
+ * <li><b><code>boolean</code>:</b> Accepts yes/no input, converted to
+ *    <code>true</code> or <code>false</code>.</li>
+ * </ul>
+ */
+export type InitTemplateType = 'select' | 'string' | 'number' | 'boolean'
+
+/**
+ * Represents the available items for a `select` type property in `xpm init`
+ * templates.
+ *
+ * @remarks
+ * Items define the options users can choose from when a property uses the
+ * <code>select</code> type. Each key represents the value stored when that
+ * option is selected, whilst the value provides the description shown to
+ * the user.
+ *
+ * Item values can be either:
+ *
+ * <ul>
+ * <li><b>Simple string:</b> A description shown to all users regardless
+ *    of platform.</li>
+ * <li><b><code>InitTemplateItemValue</code>:</b> A platform-specific
+ *    item that only appears when the current platform matches the
+ *    <code>platforms</code> constraint.</li>
+ * </ul>
+ *
+ * Example:
+ * ```js
+ * {
+ *   gcc: 'The GCC compiler',
+ *   clang: {
+ *     platforms: ['darwin'],
+ *     message: 'The Clang compiler (macOS only)'
+ *   }
+ * }
+ * ```
+ */
+export type InitTemplateItems = Record<string, string | InitTemplateItemValue>
+
+/**
+ * Represents the supported platform identifiers for `xpm init` template items.
+ *
+ * @remarks
+ * Platform identifiers filter select items based on the current execution
+ * environment, allowing templates to show only relevant options.
+ *
+ * Platform matching strategy:
+ *
+ * <ul>
+ * <li><b>Generic platforms (linux, win32, darwin):</b> match any
+ *    architecture on  operating system.</li>
+ * <li><b>Specific platforms (linux-x64, darwin-arm64, etc.):</b> match
+ *    only the exact  OS and architecture combination.</li>
+ * </ul>
+ *
+ * Example: An item with `platforms: ["darwin-arm64"]` only appears when
+ * running on Apple Silicon Macs, while `platforms: ["darwin"]` appears on
+ * both Intel and ARM Macs.
+ *
+ * Common use case: Offering different toolchain options based on whether
+ * the user is on Windows, macOS Intel, macOS ARM, or Linux.
+ */
+export type InitTemplatePlatform =
+  | 'linux'
+  | 'linux-x64'
+  | 'linux-arm64'
+  | 'win32'
+  | 'darwin'
+  | 'darwin-x64'
+  | 'darwin-arm64'
+
+/**
+ * Defines an `xpm init` template platform-specific item value.
+ *
+ * @remarks
+ * Platform-specific items allow select properties to offer different
+ * options based on the user's operating system and architecture. Only items
+ * matching the current platform are shown to the user.
+ *
+ * Example usage in property definition:
+ * ```js
+ * {
+ *   toolchain: {
+ *     label: 'Toolchain',
+ *     description: 'Select the toolchain to be used by the builds',
+ *     type: 'select',
+ *     items: {
+ *       gcc: {
+ *         // There is no gcc on macOS.
+ *         platforms: ['linux', 'win32'],
+ *         message: 'The xPack GNU Compiler Collection (GCC) toolchain'
+ *       },
+ *       clang: 'The xPack LLVM clang toolchain',
+ *       system: {
+ *         // There is no system toolchain on Windows.
+ *         platforms: ['linux', 'darwin'],
+ *         message: 'The system toolchain'
+ *       }
+ *     },
+ *     default: 'clang'
+ *   }
+ * }
+ * ```
+ *
+ * When running on Windows, only the "msvc" option appears. On Linux or
+ * macOS Intel, only "gcc-arm" appears.
+ */
+export interface InitTemplateItemValue {
+  /**
+   * The list of supported platforms.
+   */
+  platforms: InitTemplatePlatform[]
+  /**
+   * The description message for this item.
+   */
+  message: string
+}
+
+/**
+ * Defines the substitution variables used by `xpm init` templates.
+ *
+ * @remarks
+ * Substitution variables provide the context for Liquid template processing
+ * during project initialization. All collected property values and
+ * additional template-specific variables are accessible in template files.
+ *
+ * Variable structure:
+ *
+ * <ul>
+ * <li><b><code>properties</code></b>: Contains all user-provided or
+ *    default values from the
+ *    template property definitions, accessible via
+ *    <code>\{\{ properties.propertyName \}\}</code> in template files.</li>
+ * <li><b>Additional variables:</b> Templates can define custom variables
+ *    for reuse across multiple files or for computed values based on
+ *    properties.</li>
+ * </ul>
+ *
+ * Template files (with `.liquid` extension) are
+ * processed with this context, allowing conditional content, loops, and
+ * value substitution. Non-template files are copied as-is without
+ * processing.
+ *
+ * Example template usage:
+ * ```
+ * Project name: {{ properties.name }}
+ * {% if properties.language == "cpp" %}
+ * Language: C++
+ * {% endif %}
+ * ```
+ */
+export interface InitTemplateSubstitutionsVariables {
+  /**
+   * The resolved template properties.
+   */
+  properties: Record<string, string | boolean | number>
+  /**
+   * Additional template variables.
+   */
+  [key: string]: unknown
+}
+
+// ----------------------------------------------------------------------------

package/src/types/xpm.ts

@@ -0,0 +1,162 @@
+/*
+ * This file is part of the xPack project (http://xpack.github.io).
+ * Copyright (c) 2021-2026 Liviu Ionescu. All rights reserved.
+ *
+ * Permission to use, copy, modify, and/or distribute this software
+ * for any purpose is hereby granted, under the terms of the MIT license.
+ *
+ * If a copy of the license was not distributed with this file, it can
+ * be obtained from https://opensource.org/license/mit.
+ */
+
+// ----------------------------------------------------------------------------
+
+import { Logger } from '@xpack/logger'
+
+// ============================================================================
+
+/**
+ * Represents a list of action command strings.
+ *
+ * @remarks
+ * Action commands are always stored as an array of strings after Liquid
+ * template evaluation, even if the original definition in `package.json` was
+ * a single string.
+ *
+ * Each string represents a complete command to be executed in sequence.
+ * Commands are typically shell commands but can be any executable that can
+ * be invoked from the command line.
+ *
+ * The array structure enables:
+ *
+ * <ul>
+ * <li><b>Multi-step actions:</b> Execute multiple commands in order.</li>
+ * <li><b>Error handling:</b> Stop execution on first command failure (default
+ *   behavior).</li>
+ * <li><b>Logging:</b> Report progress as each command completes.</li>
+ * </ul>
+ *
+ * Commands have access to the full shell environment and can reference
+ * environment variables, pipe outputs, or chain operations using standard
+ * shell syntax (`&&`, `||`, `|`, etc.).
+ */
+export type ActionCommands = string[]
+
+/**
+ * Defines the <b>xpm</b> configuration options.
+ *
+ * @remarks
+ * Configuration options control <b>xpm</b> operation behavior,
+ * providing flags for
+ * safe mode overrides, installation optimizations, testing scenarios, and
+ * property overrides.
+ *
+ * Configuration lifecycle:
+ *
+ * <ol>
+ * <li>Created from CLI arguments or programmatic API calls.</li>
+ * <li>Merged with defaults to form complete configuration.</li>
+ * <li>Passed through <code>Context</code> to all <b>xpm</b> operations.</li>
+ * <li>Consulted by operations to determine behavior (skip, force,
+ * dry-run).</li>
+ * </ol>
+ *
+ * Key configuration patterns:
+ *
+ * <ul>
+ * <li><b>Force mode (<code>doForce: true</code>):</b> Bypasses safety checks
+ *   like "already
+ *   installed" or "files exist". Use with caution as it can overwrite
+ *   data.</li>
+ * <li><b>Dry run (<code>isDryRun: true</code>):</b> Simulates operations
+ *   without making changes,
+ *   useful for testing or previewing actions.</li>
+ * </ul>
+ *
+ * The extensible design (additional properties allowed) supports future
+ * configuration options without breaking changes.
+ */
+export interface Config {
+  /**
+   * Whether to force operations even when safeguards would prevent them.
+   */
+  doForce?: boolean
+  /**
+   * Whether to skip operations if the target is already installed.
+   */
+  doSkipIfInstalled?: boolean
+  /**
+   * Whether to perform a dry run without making changes.
+   */
+  isDryRun?: boolean
+  /**
+   * The properties map used for substitutions.
+   */
+  properties?: Record<string, string | boolean | number>
+
+  /**
+   * The current working directory for operations that require a base path.
+   */
+  cwd: string
+
+  /**
+   * Allows additional configuration properties.
+   */
+  [key: string]: unknown // Allow any additional property
+}
+
+/**
+ * Provides the execution context for <b>xpm</b> operations.
+ *
+ * @remarks
+ * The context object serves as the central coordination point for all
+ * <b>xpm</b>
+ * operations, providing access to logging, configuration, and extensible
+ * state.
+ *
+ * Context flow:
+ *
+ * <ol>
+ * <li>Created at the start of each <b>xpm</b> command execution.</li>
+ * <li>Initialized with logger instance and configuration options.</li>
+ * <li>Passed to all library functions and classes that perform <b>xpm</b>
+ *    operations.</li>
+ * <li>Extended with additional properties as needed by specific operations
+ *    (e.g., package paths, temporary directories, cache state).</li>
+ * </ol>
+ *
+ * Core responsibilities:
+ *
+ * <ul>
+ * <li><b>Logging:</b> Provides consistent output and diagnostics
+ *    through the logger
+ *    instance, enabling verbosity control and structured output.</li>
+ * <li><b>Configuration:</b> Makes operational flags and user preferences
+ *    accessible to all components.</li>
+ * <li><b>State sharing:</b> The extensible design allows operations to attach
+ *   computed values or state that should be available to subsequent
+ *   operations within the same execution.</li>
+ * </ul>
+ *
+ * The context pattern enables dependency injection, making the code more
+ * testable and allowing operations to access shared resources without
+ * global state.
+ */
+export interface Context {
+  /**
+   * The logger instance for output and diagnostics.
+   */
+  log: Logger
+  /**
+   * The <b>xpm</b> configuration options.
+   */
+  config: Config
+
+  /**
+   * Allows additional context properties.
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any // Allow any additional property
+}
+
+// ----------------------------------------------------------------------------

package/dist/lib/chmod-recursive.d.ts

@@ -1,7 +0,0 @@
-import { Logger } from '@xpack/logger';
-export declare function chmodRecursive({ inputPath, readOnly, log, }: {
-    inputPath: string;
-    readOnly: boolean;
-    log: Logger;
-}): Promise<void>;
-//# sourceMappingURL=chmod-recursive.d.ts.map

package/dist/lib/chmod-recursive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chmod-recursive.d.ts","sourceRoot":"","sources":["../../src/lib/chmod-recursive.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAItC,wBAAsB,cAAc,CAAC,EACnC,SAAS,EACT,QAAQ,EACR,GAAG,GACJ,EAAE;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAoEhB"}

package/dist/lib/chmod-recursive.js

@@ -1,81 +0,0 @@
-/*
- * This file is part of the xPack project (http://xpack.github.io).
- * Copyright (c) 2017-2025 Liviu Ionescu. All rights reserved.
- *
- * Permission to use, copy, modify, and/or distribute this software
- * for any purpose is hereby granted, under the terms of the MIT license.
- *
- * If a copy of the license was not distributed with this file, it can
- * be obtained from https://opensource.org/license/mit.
- */
-/* eslint max-len: [ "error", 80, { "ignoreUrls": true } ] */
-// ----------------------------------------------------------------------------
-// https://nodejs.org/docs/latest/api/
-import assert from 'node:assert';
-import * as fs from 'node:fs/promises';
-import path from 'node:path';
-// ----------------------------------------------------------------------------
-export async function chmodRecursive({ inputPath, readOnly, log, }) {
-    assert(inputPath, 'mandatory inputPath');
-    assert(log, 'mandatory log');
-    const stat = await fs.lstat(inputPath);
-    // log.trace(util.inspect(stat))
-    if (stat.isSymbolicLink()) {
-        // Since it is not possible to change the modes of links (lchmod
-        // was deprecated and worked on macOS anyway), don't bother
-        // with them.
-        return;
-    }
-    // The order is important, process the folder before
-    // changing it to RO.
-    if (readOnly && stat.isDirectory()) {
-        log.trace(inputPath);
-        const dirents = await fs.readdir(inputPath, {
-            withFileTypes: true,
-        });
-        for (const dirent of dirents) {
-            await chmodRecursive({
-                inputPath: path.resolve(inputPath, dirent.name),
-                readOnly,
-                log,
-            });
-        }
-    }
-    const mode = stat.mode;
-    // For RO, remove all W bits, for RW add only user.
-    const newMode = readOnly
-        ? mode &
-            ~(fs.constants.S_IWUSR | fs.constants.S_IWGRP | fs.constants.S_IWOTH)
-        : mode | fs.constants.S_IWUSR;
-    // log.trace(
-    //  `set ${inputPath} from ${mode.toString(8)} to ${newMode.toString(8)}`)
-    await fs.chmod(inputPath, newMode);
-    const actualStat = await fs.stat(inputPath);
-    // log.trace(`actual ${inputPath} is ${actualStat.mode.toString(8)}`)
-    if (readOnly) {
-        if ((actualStat.mode & fs.constants.S_IWUSR) !== 0) {
-            log.warn(`${inputPath} not set to RO`);
-        }
-    }
-    else {
-        if ((actualStat.mode & fs.constants.S_IWUSR) === 0) {
-            log.warn(`${inputPath} not set to RW`);
-        }
-    }
-    // If RW, process the folder after changing it to RW.
-    if (!readOnly && stat.isDirectory()) {
-        log.trace(inputPath);
-        const dirents = await fs.readdir(inputPath, {
-            withFileTypes: true,
-        });
-        for (const dirent of dirents) {
-            await chmodRecursive({
-                inputPath: path.resolve(inputPath, dirent.name),
-                readOnly,
-                log,
-            });
-        }
-    }
-}
-// ----------------------------------------------------------------------------
-//# sourceMappingURL=chmod-recursive.js.map

package/dist/lib/chmod-recursive.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"chmod-recursive.js","sourceRoot":"","sources":["../../src/lib/chmod-recursive.ts"],"names":[],"mappings":"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"}

package/dist/lib/errors.d.ts

@@ -1,11 +0,0 @@
-export declare class XpmError extends Error {
-}
-export declare class XpmPrerequisitesError extends Error {
-}
-export declare class XpmInputError extends Error {
-}
-export declare class XpmSyntaxError extends Error {
-}
-export declare class XpmOutputError extends Error {
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAgBA,qBAAa,QAAS,SAAQ,KAAK;CAAG;AAEtC,qBAAa,qBAAsB,SAAQ,KAAK;CAAG;AAEnD,qBAAa,aAAc,SAAQ,KAAK;CAAG;AAE3C,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,qBAAa,cAAe,SAAQ,KAAK;CAAG"}

package/dist/lib/errors.js

@@ -1,26 +0,0 @@
-/*
- * This file is part of the xPack project (http://xpack.github.io).
- * Copyright (c) 2021-2026 Liviu Ionescu. All rights reserved.
- *
- * Permission to use, copy, modify, and/or distribute this software
- * for any purpose is hereby granted, under the terms of the MIT license.
- *
- * If a copy of the license was not distributed with this file, it can
- * be obtained from https://opensource.org/license/mit.
- */
-/* eslint max-len: [ "error", 80, { "ignoreUrls": true } ] */
-// ----------------------------------------------------------------------------
-// Application errors
-export class XpmError extends Error {
-}
-export class XpmPrerequisitesError extends Error {
-}
-export class XpmInputError extends Error {
-}
-export class XpmSyntaxError extends Error {
-}
-export class XpmOutputError extends Error {
-}
-// Other errors:  Child.
-// ----------------------------------------------------------------------------
-//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,6DAA6D;AAE7D,+EAA+E;AAE/E,qBAAqB;AACrB,MAAM,OAAO,QAAS,SAAQ,KAAK;CAAG;AAEtC,MAAM,OAAO,qBAAsB,SAAQ,KAAK;CAAG;AAEnD,MAAM,OAAO,aAAc,SAAQ,KAAK;CAAG;AAE3C,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C,wBAAwB;AAExB,+EAA+E"}

package/dist/lib/functions/chmod-recursive.d.ts

@@ -1,7 +0,0 @@
-import { Logger } from '@xpack/logger';
-export declare function chmodRecursive({ inputPath, readOnly, log, }: {
-    inputPath: string;
-    readOnly: boolean;
-    log: Logger;
-}): Promise<void>;
-//# sourceMappingURL=chmod-recursive.d.ts.map

package/dist/lib/functions/chmod-recursive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chmod-recursive.d.ts","sourceRoot":"","sources":["../../../src/lib/functions/chmod-recursive.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAItC,wBAAsB,cAAc,CAAC,EACnC,SAAS,EACT,QAAQ,EACR,GAAG,GACJ,EAAE;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAoEhB"}

package/dist/lib/functions/chmod-recursive.js

@@ -1,81 +0,0 @@
-/*
- * This file is part of the xPack project (http://xpack.github.io).
- * Copyright (c) 2017-2026 Liviu Ionescu. All rights reserved.
- *
- * Permission to use, copy, modify, and/or distribute this software
- * for any purpose is hereby granted, under the terms of the MIT license.
- *
- * If a copy of the license was not distributed with this file, it can
- * be obtained from https://opensource.org/license/mit.
- */
-/* eslint max-len: [ "error", 80, { "ignoreUrls": true } ] */
-// ----------------------------------------------------------------------------
-// https://nodejs.org/docs/latest/api/
-import assert from 'node:assert';
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-// ----------------------------------------------------------------------------
-export async function chmodRecursive({ inputPath, readOnly, log, }) {
-    assert(inputPath, 'mandatory inputPath');
-    assert(log, 'mandatory log');
-    const stat = await fs.lstat(inputPath);
-    // log.trace(util.inspect(stat))
-    if (stat.isSymbolicLink()) {
-        // Since it is not possible to change the modes of links (lchmod
-        // was deprecated and worked on macOS anyway), don't bother
-        // with them.
-        return;
-    }
-    // The order is important, process the folder before
-    // changing it to RO.
-    if (readOnly && stat.isDirectory()) {
-        log.trace(inputPath);
-        const dirents = await fs.readdir(inputPath, {
-            withFileTypes: true,
-        });
-        for (const dirent of dirents) {
-            await chmodRecursive({
-                inputPath: path.resolve(inputPath, dirent.name),
-                readOnly,
-                log,
-            });
-        }
-    }
-    const mode = stat.mode;
-    // For RO, remove all W bits, for RW add only user.
-    const newMode = readOnly
-        ? mode &
-            ~(fs.constants.S_IWUSR | fs.constants.S_IWGRP | fs.constants.S_IWOTH)
-        : mode | fs.constants.S_IWUSR;
-    // log.trace(
-    //  `set ${inputPath} from ${mode.toString(8)} to ${newMode.toString(8)}`)
-    await fs.chmod(inputPath, newMode);
-    const actualStat = await fs.stat(inputPath);
-    // log.trace(`actual ${inputPath} is ${actualStat.mode.toString(8)}`)
-    if (readOnly) {
-        if ((actualStat.mode & fs.constants.S_IWUSR) !== 0) {
-            log.warn(`${inputPath} not set to RO`);
-        }
-    }
-    else {
-        if ((actualStat.mode & fs.constants.S_IWUSR) === 0) {
-            log.warn(`${inputPath} not set to RW`);
-        }
-    }
-    // If RW, process the folder after changing it to RW.
-    if (!readOnly && stat.isDirectory()) {
-        log.trace(inputPath);
-        const dirents = await fs.readdir(inputPath, {
-            withFileTypes: true,
-        });
-        for (const dirent of dirents) {
-            await chmodRecursive({
-                inputPath: path.resolve(inputPath, dirent.name),
-                readOnly,
-                log,
-            });
-        }
-    }
-}
-// ----------------------------------------------------------------------------
-//# sourceMappingURL=chmod-recursive.js.map