pwd-fs 3.5.4 → 3.5.5

package/dist/bitmask.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module permission mask normalization helper for public stat-derived mode values.
+ *
+ * Allowed here:
+ * - extracting standard rwxrwxrwx permission bits;
+ * - rejecting non-number input before bit operations;
+ * - staying independent from filesystem reads and platform state.
+ *
+ * This file must not contain path resolution, filesystem access, or wrapper method wiring.
+ */
 /**
  * Normalizes a permission mask to the standard rwxrwxrwx bit set.
  */

package/dist/bitmask.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module permission mask normalization helper for public stat-derived mode values.
+ *
+ * Allowed here:
+ * - extracting standard rwxrwxrwx permission bits;
+ * - rejecting non-number input before bit operations;
+ * - staying independent from filesystem reads and platform state.
+ *
+ * This file must not contain path resolution, filesystem access, or wrapper method wiring.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bitmask = bitmask;
 /**

package/dist/powered-file-system/append.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module deprecated append method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - preserving the legacy `append()` public method;
+ * - forwarding append behavior to `write()` with append flags;
+ * - keeping async and sync overloads aligned with the wrapper contract.
+ *
+ * This file must not contain independent file writing logic.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 type AppendOptions = {
     encoding?: BufferEncoding | null;

package/dist/powered-file-system/append.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module deprecated append method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - preserving the legacy `append()` public method;
+ * - forwarding append behavior to `write()` with append flags;
+ * - keeping async and sync overloads aligned with the wrapper contract.
+ *
+ * This file must not contain independent file writing logic.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.append = append;
 function append(src, data, options) {

package/dist/powered-file-system/chmod.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module chmod method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving instance-relative paths before permission changes;
+ * - selecting async or sync recursive chmod implementation;
+ * - preserving wrapper error propagation for missing targets.
+ *
+ * This file must not contain recursive traversal logic.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Resolves the target path and delegates recursive mode updates.

package/dist/powered-file-system/chmod.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module chmod method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving instance-relative paths before permission changes;
+ * - selecting async or sync recursive chmod implementation;
+ * - preserving wrapper error propagation for missing targets.
+ *
+ * This file must not contain recursive traversal logic.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.chmod = chmod;
 const recurse_io_1 = require("../recurse-io");

package/dist/powered-file-system/chown.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module chown method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving instance-relative paths before ownership changes;
+ * - preserving Windows path validation without POSIX ownership mutation;
+ * - selecting async or sync recursive chown implementation.
+ *
+ * This file must not contain generic permission or copy behavior.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Resolves the target path and applies recursive ownership changes where supported.

package/dist/powered-file-system/chown.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module chown method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving instance-relative paths before ownership changes;
+ * - preserving Windows path validation without POSIX ownership mutation;
+ * - selecting async or sync recursive chown implementation.
+ *
+ * This file must not contain generic permission or copy behavior.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/copy.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module copy method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving source and destination paths against the instance base path;
+ * - shaping copy options for recursive copy implementations;
+ * - selecting async or sync copy execution.
+ *
+ * This file must not contain recursive copy traversal or collision replacement algorithms.
+ */
 import type { AsyncOption, CopyFilter, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 type CopyOptions = {
     umask?: number;

package/dist/powered-file-system/copy.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module copy method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving source and destination paths against the instance base path;
+ * - shaping copy options for recursive copy implementations;
+ * - selecting async or sync copy execution.
+ *
+ * This file must not contain recursive copy traversal or collision replacement algorithms.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.copy = copy;
 const recurse_io_1 = require("../recurse-io");

package/dist/powered-file-system/empty-dir.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module empty-directory method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving the target directory against the instance base path;
+ * - preserving the directory while delegating entry removal;
+ * - selecting async or sync empty-directory execution.
+ *
+ * This file must not contain recursive removal algorithms.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Removes directory contents while preserving the directory itself.

package/dist/powered-file-system/empty-dir.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module empty-directory method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving the target directory against the instance base path;
+ * - preserving the directory while delegating entry removal;
+ * - selecting async or sync empty-directory execution.
+ *
+ * This file must not contain recursive removal algorithms.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.emptyDir = emptyDir;
 const recurse_io_1 = require("../recurse-io");

package/dist/powered-file-system/mkdir.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module mkdir method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving directory paths against the instance base path;
+ * - applying wrapper umask options to recursive directory creation;
+ * - selecting async or sync mkdir execution.
+ *
+ * This file must not contain unrelated file creation or cleanup behavior.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 type MkdirOptions = {
     umask?: number;

package/dist/powered-file-system/mkdir.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module mkdir method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving directory paths against the instance base path;
+ * - applying wrapper umask options to recursive directory creation;
+ * - selecting async or sync mkdir execution.
+ *
+ * This file must not contain unrelated file creation or cleanup behavior.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mkdir = mkdir;
 const recurse_io_1 = require("../recurse-io");

package/dist/powered-file-system/read.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module read method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving file paths against the instance base path;
+ * - preserving string and Buffer return modes from read options;
+ * - selecting async or sync file read execution.
+ *
+ * This file must not contain parsing, transformation, or stream handling.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, ReadOptions, SyncOption } from '../powered-file-system';
 /**
  * Reads a file relative to `pwd` and preserves Buffer mode when `encoding` is `null`.

package/dist/powered-file-system/read.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module read method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving file paths against the instance base path;
+ * - preserving string and Buffer return modes from read options;
+ * - selecting async or sync file read execution.
+ *
+ * This file must not contain parsing, transformation, or stream handling.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/readdir.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module readdir method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving directory paths against the instance base path;
+ * - preserving string and Buffer entry modes from readdir options;
+ * - selecting async or sync directory listing execution.
+ *
+ * This file must not contain recursive traversal or filtering policy.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, ReaddirOptions, SyncOption } from '../powered-file-system';
 /**
  * Lists directory entries relative to the instance base path.

package/dist/powered-file-system/readdir.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module readdir method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving directory paths against the instance base path;
+ * - preserving string and Buffer entry modes from readdir options;
+ * - selecting async or sync directory listing execution.
+ *
+ * This file must not contain recursive traversal or filtering policy.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/readlink.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module readlink method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving link paths against the instance base path;
+ * - preserving Node readlink encoding behavior;
+ * - selecting async or sync symbolic-link target reads.
+ *
+ * This file must not contain canonical path resolution or symlink creation.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Reads the target path stored in a symbolic link.

package/dist/powered-file-system/readlink.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module readlink method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving link paths against the instance base path;
+ * - preserving Node readlink encoding behavior;
+ * - selecting async or sync symbolic-link target reads.
+ *
+ * This file must not contain canonical path resolution or symlink creation.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/realpath.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module realpath method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving input paths against the instance base path;
+ * - delegating canonical path resolution to Node filesystem APIs;
+ * - selecting async or sync realpath execution.
+ *
+ * This file must not contain symlink creation or raw link-target reads.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Resolves a path to its canonical absolute location.

package/dist/powered-file-system/realpath.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module realpath method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving input paths against the instance base path;
+ * - delegating canonical path resolution to Node filesystem APIs;
+ * - selecting async or sync realpath execution.
+ *
+ * This file must not contain symlink creation or raw link-target reads.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/remove.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module remove method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving removal targets against the instance base path;
+ * - delegating recursive removal while preserving symlink behavior;
+ * - selecting async or sync remove execution.
+ *
+ * This file must not contain directory-emptying or copy replacement policy.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Removes a path relative to the instance base path.

package/dist/powered-file-system/remove.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module remove method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving removal targets against the instance base path;
+ * - delegating recursive removal while preserving symlink behavior;
+ * - selecting async or sync remove execution.
+ *
+ * This file must not contain directory-emptying or copy replacement policy.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.remove = remove;
 const recurse_io_1 = require("../recurse-io");

package/dist/powered-file-system/rename.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module rename method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving source and destination paths against the instance base path;
+ * - delegating rename operations to Node filesystem APIs;
+ * - selecting async or sync rename execution.
+ *
+ * This file must not contain recursive copy or overwrite replacement behavior.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Resolves both paths against the instance base path before delegating to Node's rename API.

package/dist/powered-file-system/rename.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module rename method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving source and destination paths against the instance base path;
+ * - delegating rename operations to Node filesystem APIs;
+ * - selecting async or sync rename execution.
+ *
+ * This file must not contain recursive copy or overwrite replacement behavior.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/stat.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module stat method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving paths against the instance base path;
+ * - returning `lstat` data so symbolic links remain observable;
+ * - selecting async or sync stat execution.
+ *
+ * This file must not contain permission normalization or existence fallback behavior.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, Stats, SyncOption } from '../powered-file-system';
 /**
  * Returns `lstat` data so symlinks are reported as links instead of followed targets.

package/dist/powered-file-system/stat.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module stat method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving paths against the instance base path;
+ * - returning `lstat` data so symbolic links remain observable;
+ * - selecting async or sync stat execution.
+ *
+ * This file must not contain permission normalization or existence fallback behavior.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/symlink.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module symlink method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving source and destination paths against the instance base path;
+ * - handling Windows symlink type requirements;
+ * - selecting async or sync symbolic-link creation.
+ *
+ * This file must not contain link target reading or canonical path resolution.
+ */
 import type { AsyncOption, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 export declare function symlink(this: PoweredFileSystem, src: string, dest: string, options: SyncOption): void;
 export declare function symlink(this: PoweredFileSystem, src: string, dest: string, options?: AsyncOption): Promise<void>;

package/dist/powered-file-system/symlink.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module symlink method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving source and destination paths against the instance base path;
+ * - handling Windows symlink type requirements;
+ * - selecting async or sync symbolic-link creation.
+ *
+ * This file must not contain link target reading or canonical path resolution.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/test.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module access-test method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving paths against the instance base path;
+ * - mapping wrapper access flags to Node access constants;
+ * - converting access errors into boolean results.
+ *
+ * This file must not contain stat metadata reads or mutation behavior.
+ */
 import type { AsyncOption, MaybeSyncOption, Mode, PoweredFileSystem, SyncOption } from '../powered-file-system';
 /**
  * Thin wrapper around `fs.access` that resolves paths against the instance base path.

package/dist/powered-file-system/test.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module access-test method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving paths against the instance base path;
+ * - mapping wrapper access flags to Node access constants;
+ * - converting access errors into boolean results.
+ *
+ * This file must not contain stat metadata reads or mutation behavior.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system/write.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module write method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving file paths against the instance base path;
+ * - applying write options and explicit final permissions;
+ * - selecting async or sync file write execution.
+ *
+ * This file must not contain append compatibility routing or stream handling.
+ */
 import type { AsyncOption, Flag, MaybeSyncOption, PoweredFileSystem, SyncOption } from '../powered-file-system';
 type WriteOptions = {
     encoding?: BufferEncoding | null;

package/dist/powered-file-system/write.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module write method adapter for the path-aware filesystem wrapper.
+ *
+ * Allowed here:
+ * - resolving file paths against the instance base path;
+ * - applying write options and explicit final permissions;
+ * - selecting async or sync file write execution.
+ *
+ * This file must not contain append compatibility routing or stream handling.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/powered-file-system.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module public path-aware filesystem wrapper contract.
+ *
+ * Allowed here:
+ * - defining public method overloads and shared option types;
+ * - binding method modules to a resolved instance base path;
+ * - exposing permission constants and public helpers.
+ *
+ * This file must not contain recursive filesystem algorithms or test fixture behavior.
+ */
 import fs from 'node:fs';
 import { bitmask } from './bitmask';
 /**

package/dist/powered-file-system.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module public path-aware filesystem wrapper contract.
+ *
+ * Allowed here:
+ * - defining public method overloads and shared option types;
+ * - binding method modules to a resolved instance base path;
+ * - exposing permission constants and public helpers.
+ *
+ * This file must not contain recursive filesystem algorithms or test fixture behavior.
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);

package/dist/recurse-io-sync.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module synchronous recursive filesystem algorithms.
+ *
+ * Allowed here:
+ * - mirroring recursive filesystem behavior for `{ sync: true }` calls;
+ * - applying replace-before-copy and permission rules synchronously;
+ * - sharing only option shapes with the asynchronous recursive module.
+ *
+ * This file must not contain Promise or callback orchestration.
+ */
 import type { ICopyOptions } from './recurse-io';
 /**
  * Synchronous counterpart of the recursive chmod implementation.

package/dist/recurse-io-sync.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module synchronous recursive filesystem algorithms.
+ *
+ * Allowed here:
+ * - mirroring recursive filesystem behavior for `{ sync: true }` calls;
+ * - applying replace-before-copy and permission rules synchronously;
+ * - sharing only option shapes with the asynchronous recursive module.
+ *
+ * This file must not contain Promise or callback orchestration.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

package/dist/recurse-io.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Module asynchronous recursive filesystem algorithms.
+ *
+ * Allowed here:
+ * - traversing filesystem trees with callback-based Node APIs;
+ * - preserving recursive chmod, chown, copy, remove, empty, and mkdir semantics;
+ * - normalizing callback completion for concurrent recursive branches.
+ *
+ * This file must not contain public path-aware wrapper overloads or synchronous variants.
+ */
 import { NoParamCallback } from 'node:fs';
 export interface ICopyOptions {
     umask: number;

package/dist/recurse-io.js

@@ -1,4 +1,14 @@
 "use strict";
+/**
+ * Module asynchronous recursive filesystem algorithms.
+ *
+ * Allowed here:
+ * - traversing filesystem trees with callback-based Node APIs;
+ * - preserving recursive chmod, chown, copy, remove, empty, and mkdir semantics;
+ * - normalizing callback completion for concurrent recursive branches.
+ *
+ * This file must not contain public path-aware wrapper overloads or synchronous variants.
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };