@zokugun/fs-path 0.1.0 → 0.2.0

package/README.md

@@ -44,19 +44,19 @@ This example expands the current user's home directory, joins paths safely, and
 API reference
 -------------
 
-- `absolute(...paths: string[]): string`: Return an absolute path for the given segments. Uses the current platform resolution behavior.
-- `dir(path: string): string`: Return the directory portion of `path` (empty string when the result is `.`).
-- `extension(path: string): string`: Return the file extension (same as `path.extname`).
+- `absolute(...paths: string[]): string`: Returns a normalized absolute path.
 - `isAbsolute(path: string): boolean`: Return `true` when `path` is absolute for the current platform.
 - `isInDir(path: string, parent: string): boolean`: Return `true` when `path` is equal to or contained within `parent`.
 - `isInDirs(path: string, parents: string[]): boolean`: Return `true` when `path` is equal to or contained within in one of the `parents`.
 - `isSafePath(path: string, options?): boolean`: Return `true` when `path` is considered safe for use (guards against suspicious segments such as `..` when appropriate for the platform).
 - `isSafeSegment(segment: string, target?: Target | 'auto'): boolean`: Return `true` when a single path segment is safe (doesn't contain path separators or traversal sequences).
-- `join(...paths: string[]): string`: Join path segments; returns empty string when the join result is `.`.
-- `leaf(path: string, suffix?: string): string`: Return the basename of `path` (alias of `path.basename`).
+- `join(...paths: string[]): string`: Join path segments.
+- `leafExt(path: string, length?: number): string`: Return the extensions.
+- `leafName(path: string, extension?: number | string): string`: Return the basename of `path` with/without the extensions.
 - `matchesGlob?(path: string, pattern: string): boolean`: Optional platform-provided glob matcher when available.
 - `normalize(path: string): string`: Normalize the path (same as `path.normalize`).
-- `parent(path: string): string`: Return the parent directory of `file` (empty string when the result is `.`).
+- `parentName(path: string): string`: Return the parent name of `path`.
+- `parentPath(path: string): string`: Return the parent directory of `path`.
 - `relative(from: string, to: string): string`: Compute the relative path from `from` to `to`.
 - `resolve(...paths: string[]): string`: Resolve path segments to an absolute path. Supports tilde expansion:
     - `~` expands to the current user's home directory.
@@ -73,8 +73,6 @@ export type PlatformPath = {
     readonly posix: PlatformPath;
     readonly win32: PlatformPath;
     absolute: (...paths: string[]) => string;
-    dir: (path: string) => string;
-    extension: (path: string) => string;
     isAbsolute: (path: string) => boolean;
     isInDir(path: string, parent: string): boolean;
     isInDirs(path: string, parents: string[]): boolean;
@@ -85,10 +83,12 @@ export type PlatformPath = {
 	}) => boolean;
     isSafeSegment: (segment: string, target?: Target | 'auto') => boolean;
     join: (...paths: string[]) => string;
-    leaf: (path: string, suffix?: string) => string;
+	leafExt: (path: string, length?: number) => string;
+    leafName: (path: string, extension?: number | string) => string;
     matchesGlob?: (path: string, pattern: string) => boolean;
     normalize: (path: string) => string;
-    parent: (path: string) => string;
+    parentName: (path: string) => string;
+	parentPath: (path: string) => string;
     relative: (from: string, to: string) => string;
     resolve: (...paths: string[]) => string;
     sanitize(path: string, options?: {
@@ -106,15 +106,10 @@ Comparison with Node's `path`
 
 This library intentionally mirrors many of Node's `path` APIs but provides small ergonomic differences and extra features where useful:
 
-- `absolute(...paths)`: resolves using the runtime platform and always returns a normalized absolute path.
-- `dir(path)`: returns `path.parse(path).dir` (similar to `path.dirname`, kept for API symmetry).
-- `extension(path)`: alias of `path.extname`.
 - `join(...paths)`: wraps `path.join`. Returns `''` instead of `.` when the joined result is the current directory.
 - `isAbsolute(path)`, `normalize(path)`, `relative(from, to)`: direct mappings to `path.isAbsolute`, `path.normalize`, and `path.relative` respectively.
-- `leaf(path, suffix?)`: alias of `path.basename`.
-- `parent(file)`: wraps `path.dirname`. Returns `''` instead of `.` for consistency with `join`.
+- `parentPath(file)`: wraps `path.dirname`. Returns `''` instead of `.` for consistency with `join`.
 - `resolve(...paths)`: wraps `path.resolve` but adds tilde expansion (`~` and `~username`) before resolving.
-- `untildify(path)`: purely handles `~` expansion; no direct equivalent in Node core.
 - `delimiter`: same value as `path.delimiter` on the current platform.
 - `separator`: same value as `path.sep` on the current platform.
 

package/lib/cjs/absolute.d.cts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.cjs';
-export declare function absolute(nodePath: path.PlatformPath, localPath: PlatformPath): (...paths: string[]) => string;
+export declare function absolute(nodePath: opath.PlatformPath, localPath: PlatformPath): (...paths: string[]) => string;

package/lib/cjs/index.cjs

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.win32 = exports.untildify = exports.separator = exports.sanitize = exports.resolve = exports.relative = exports.posix = exports.isSafeSegment = exports.isSafePath = exports.isInDirs = exports.isInDir = exports.parent = exports.normalize = exports.matchesGlob = exports.leaf = exports.join = exports.isAbsolute = exports.extension = exports.delimiter = exports.absolute = void 0;
+exports.win32 = exports.untildify = exports.separator = exports.sanitize = exports.resolve = exports.relative = exports.posix = exports.isSafeSegment = exports.isSafePath = exports.isInDirs = exports.isInDir = exports.parentPath = exports.parentName = exports.normalize = exports.matchesGlob = exports.leafName = exports.leafExt = exports.join = exports.isAbsolute = exports.delimiter = exports.absolute = void 0;
 const platform_js_1 = require("./platform.cjs");
-const { absolute, delimiter, extension, isAbsolute, join, leaf, matchesGlob, normalize, parent, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, } = platform_js_1.DEFAULT_PLATFORM;
+const { absolute, delimiter, isAbsolute, join, leafExt, leafName, matchesGlob, normalize, parentName, parentPath, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, } = platform_js_1.DEFAULT_PLATFORM;
 exports.absolute = absolute;
 exports.delimiter = delimiter;
-exports.extension = extension;
 exports.isAbsolute = isAbsolute;
 exports.join = join;
-exports.leaf = leaf;
+exports.leafExt = leafExt;
+exports.leafName = leafName;
 exports.matchesGlob = matchesGlob;
 exports.normalize = normalize;
-exports.parent = parent;
+exports.parentName = parentName;
+exports.parentPath = parentPath;
 exports.isInDir = isInDir;
 exports.isInDirs = isInDirs;
 exports.isSafePath = isSafePath;
@@ -29,13 +30,14 @@ exports.default = {
     PlatformPath: undefined,
     absolute,
     delimiter,
-    extension,
     isAbsolute,
     join,
-    leaf,
+    leafExt,
+    leafName,
     matchesGlob,
     normalize,
-    parent,
+    parentName,
+    parentPath,
     isInDir,
     isInDirs,
     isSafePath,

package/lib/cjs/index.d.cts

@@ -1,5 +1,5 @@
 import { type PlatformPath } from './types.cjs';
-declare const absolute: (...paths: string[]) => string, delimiter: ";" | ":", extension: (path: string) => string, isAbsolute: (path: string) => boolean, join: (...paths: string[]) => string, leaf: (path: string, suffix?: string) => string, matchesGlob: ((path: string, pattern: string) => boolean) | undefined, normalize: (path: string) => string, parent: (file: string) => string, isInDir: (file: string, dir: string) => boolean, isInDirs: (file: string, directories: string[]) => boolean, isSafePath: (path: string, options?: {
+declare const absolute: (...paths: string[]) => string, delimiter: ";" | ":", isAbsolute: (path: string) => boolean, join: (...paths: string[]) => string, leafExt: (path: string, length?: number) => string, leafName: (path: string, extension?: number | string) => string, matchesGlob: ((path: string, pattern: string) => boolean) | undefined, normalize: (path: string) => string, parentName: (path: string) => string, parentPath: (path: string) => string, isInDir: (path: string, dir: string) => boolean, isInDirs: (path: string, directories: string[]) => boolean, isSafePath: (path: string, options?: {
     parent?: string | null;
     parents?: string | string[] | null;
     target?: Target | "auto";
@@ -9,22 +9,23 @@ declare const absolute: (...paths: string[]) => string, delimiter: ";" | ":", ex
     replacement?: string | null;
     target?: Target | "auto";
 }) => DResult<string>, separator: "\\" | "/", untildify: (path: string) => string, win32: PlatformPath;
-export { type PlatformPath, absolute, delimiter, extension, isAbsolute, join, leaf, matchesGlob, normalize, parent, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, };
+export { type PlatformPath, absolute, delimiter, isAbsolute, join, leafExt, leafName, matchesGlob, normalize, parentName, parentPath, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, };
 import { type Target } from "@zokugun/fs-path-sanitize";
 import { type DResult } from "@zokugun/xtry/result";
 declare const _default: {
     PlatformPath: PlatformPath;
     absolute: (...paths: string[]) => string;
     delimiter: ";" | ":";
-    extension: (path: string) => string;
     isAbsolute: (path: string) => boolean;
     join: (...paths: string[]) => string;
-    leaf: (path: string, suffix?: string) => string;
+    leafExt: (path: string, length?: number) => string;
+    leafName: (path: string, extension?: number | string) => string;
     matchesGlob: ((path: string, pattern: string) => boolean) | undefined;
     normalize: (path: string) => string;
-    parent: (file: string) => string;
-    isInDir: (file: string, dir: string) => boolean;
-    isInDirs: (file: string, directories: string[]) => boolean;
+    parentName: (path: string) => string;
+    parentPath: (path: string) => string;
+    isInDir: (path: string, dir: string) => boolean;
+    isInDirs: (path: string, directories: string[]) => boolean;
     isSafePath: (path: string, options?: {
         parent?: string | null;
         parents?: string | string[] | null;

package/lib/cjs/is-in-dir.d.cts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.cjs';
-export declare function isInDir(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, parent: string) => boolean;
+export declare function isInDir(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, parent: string) => boolean;

package/lib/cjs/is-in-dirs.d.cts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.cjs';
-export declare function isInDirs(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, parents: string[]) => boolean;
+export declare function isInDirs(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, parents: string[]) => boolean;

package/lib/cjs/is-safe-path.d.cts

@@ -1,7 +1,7 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type Target } from '@zokugun/fs-path-sanitize';
 import { type PlatformPath } from './types.cjs';
-export declare function isSafePath(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, options?: {
+export declare function isSafePath(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, options?: {
     parent?: string | null;
     parents?: string | string[] | null;
     target?: Target | 'auto';

package/lib/cjs/is-safe-segment.d.cts

@@ -1,4 +1,4 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type Target } from '@zokugun/fs-path-sanitize';
 import { type PlatformPath } from './types.cjs';
-export declare function isSafeSegment(_nodePath: path.PlatformPath, localPath: PlatformPath): (segment: string, target?: Target | 'auto') => boolean;
+export declare function isSafeSegment(_nodePath: opath.PlatformPath, localPath: PlatformPath): (segment: string, target?: Target | 'auto') => boolean;

package/lib/cjs/join.d.cts

@@ -1,3 +1,3 @@
-import type path from 'path';
+import type opath from 'path';
 import { type PlatformPath } from './types.cjs';
-export declare function join(nodePath: path.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;
+export declare function join(nodePath: opath.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;

package/lib/cjs/leaf-ext.cjs

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.leafExt = leafExt;
+const is_it_type_1 = require("@zokugun/is-it-type");
+// eslint-disable-next-line unicorn/prevent-abbreviations
+function leafExt(nodePath, _localPath) {
+    return (path, length) => {
+        if ((0, is_it_type_1.isUndefined)(length)) {
+            return nodePath.extname(path);
+        }
+        const name = nodePath.basename(path);
+        if (name.length === 0 || name.startsWith('.')) {
+            return '';
+        }
+        if (length <= 0) {
+            const index = name.indexOf('.');
+            return index === -1 ? '' : name.slice(index);
+        }
+        else if (length === 1) {
+            const index = name.lastIndexOf('.');
+            return index === -1 ? '' : name.slice(index);
+        }
+        else {
+            const parts = name.split('.');
+            if (parts.length === 1) {
+                return '';
+            }
+            return '.' + parts.slice(parts.length <= length ? 1 : -length).join('.');
+        }
+    };
+}

package/lib/cjs/leaf-ext.d.cts

@@ -0,0 +1,3 @@
+import type path from 'node:path';
+import { type PlatformPath } from './types.cjs';
+export declare function leafExt(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string, length?: number) => string;

package/lib/cjs/leaf-name.cjs

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.leafName = leafName;
+const is_it_type_1 = require("@zokugun/is-it-type");
+function leafName(nodePath, _localPath) {
+    return (path, extension) => {
+        if ((0, is_it_type_1.isUndefined)(extension)) {
+            return nodePath.basename(path);
+        }
+        if ((0, is_it_type_1.isString)(extension)) {
+            return nodePath.basename(path, extension);
+        }
+        const name = nodePath.basename(path);
+        if (name.length === 0 || name.startsWith('.')) {
+            return name;
+        }
+        if (extension <= 0) {
+            const index = name.indexOf('.');
+            return index === -1 ? name : name.slice(0, index);
+        }
+        else if (extension === 1) {
+            const index = name.lastIndexOf('.');
+            return index === -1 ? name : name.slice(0, index);
+        }
+        else {
+            const parts = name.split('.');
+            if (parts.length <= extension) {
+                return parts[0];
+            }
+            return parts.slice(0, -extension).join('.');
+        }
+    };
+}

package/lib/cjs/leaf-name.d.cts

@@ -0,0 +1,3 @@
+import type path from 'node:path';
+import { type PlatformPath } from './types.cjs';
+export declare function leafName(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string, extension?: number | string) => string;

package/lib/cjs/parent-name.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parentName = parentName;
+function parentName(nodePath, _localPath) {
+    return (path) => {
+        const parent = nodePath.dirname(path);
+        if (parent === '.') {
+            return '';
+        }
+        else {
+            return nodePath.basename(parent);
+        }
+    };
+}

package/lib/cjs/parent-name.d.cts

@@ -0,0 +1,3 @@
+import type path from 'node:path';
+import { type PlatformPath } from './types.cjs';
+export declare function parentName(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/cjs/{parent.cjs → parent-path.cjs}

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parent = parent;
-function parent(nodePath, _localPath) {
-    return (file) => {
-        const parent = nodePath.dirname(file);
+exports.parentPath = parentPath;
+function parentPath(nodePath, _localPath) {
+    return (path) => {
+        const parent = nodePath.dirname(path);
         if (parent === '.') {
             return '';
         }

package/lib/cjs/parent-path.d.cts

@@ -0,0 +1,3 @@
+import type opath from 'node:path';
+import { type PlatformPath } from './types.cjs';
+export declare function parentPath(nodePath: opath.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/cjs/platform.cjs

@@ -6,37 +6,40 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_PLATFORM = void 0;
 const node_path_1 = __importDefault(require("node:path"));
 const absolute_js_1 = require("./absolute.cjs");
-const dir_js_1 = require("./dir.cjs");
 const is_in_dir_js_1 = require("./is-in-dir.cjs");
 // eslint-disable-next-line unicorn/prevent-abbreviations
 const is_in_dirs_js_1 = require("./is-in-dirs.cjs");
 const is_safe_path_js_1 = require("./is-safe-path.cjs");
 const is_safe_segment_js_1 = require("./is-safe-segment.cjs");
 const join_js_1 = require("./join.cjs");
-const parent_js_1 = require("./parent.cjs");
+// eslint-disable-next-line unicorn/prevent-abbreviations
+const leaf_ext_js_1 = require("./leaf-ext.cjs");
+const leaf_name_js_1 = require("./leaf-name.cjs");
+const parent_name_js_1 = require("./parent-name.cjs");
+const parent_path_js_1 = require("./parent-path.cjs");
 const resolve_js_1 = require("./resolve.cjs");
 const sanitize_js_1 = require("./sanitize.cjs");
 const untildify_js_1 = require("./untildify.cjs");
 function buildPlatform(path) {
-    const { basename: leaf, delimiter, extname: extension, isAbsolute, normalize, relative, sep: separator, } = path;
+    const { delimiter, isAbsolute, normalize, relative, sep: separator, } = path;
     const result = {
         delimiter,
         separator,
-        extension,
         isAbsolute,
-        leaf,
         matchesGlob: path.matchesGlob ?? undefined,
         normalize,
         relative,
     };
     result.absolute = (0, absolute_js_1.absolute)(path, result);
-    result.dir = (0, dir_js_1.dir)(path, result);
     result.isInDir = (0, is_in_dir_js_1.isInDir)(path, result);
     result.isInDirs = (0, is_in_dirs_js_1.isInDirs)(path, result);
     result.isSafePath = (0, is_safe_path_js_1.isSafePath)(path, result);
     result.isSafeSegment = (0, is_safe_segment_js_1.isSafeSegment)(path, result);
     result.join = (0, join_js_1.join)(path, result);
-    result.parent = (0, parent_js_1.parent)(path, result);
+    result.leafExt = (0, leaf_ext_js_1.leafExt)(path, result);
+    result.leafName = (0, leaf_name_js_1.leafName)(path, result);
+    result.parentName = (0, parent_name_js_1.parentName)(path, result);
+    result.parentPath = (0, parent_path_js_1.parentPath)(path, result);
     result.resolve = (0, resolve_js_1.resolve)(path, result);
     result.sanitize = (0, sanitize_js_1.sanitize)(path, result);
     result.untildify = (0, untildify_js_1.untildify)(path, result);

package/lib/cjs/resolve.d.cts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.cjs';
-export declare function resolve(nodePath: path.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;
+export declare function resolve(nodePath: opath.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;

package/lib/cjs/sanitize.d.cts

@@ -1,8 +1,8 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type Target } from '@zokugun/fs-path-sanitize';
 import { type DResult } from '@zokugun/xtry';
 import { type PlatformPath } from './types.cjs';
-export declare function sanitize(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, options?: {
+export declare function sanitize(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, options?: {
     parent?: string | null;
     parents?: string | string[] | null;
     replacement?: string | null;

package/lib/cjs/types.d.cts

@@ -6,11 +6,9 @@ export type PlatformPath = {
     readonly posix: PlatformPath;
     readonly win32: PlatformPath;
     absolute: (...paths: string[]) => string;
-    dir: (path: string) => string;
-    extension: (path: string) => string;
     isAbsolute: (path: string) => boolean;
-    isInDir: (file: string, dir: string) => boolean;
-    isInDirs: (file: string, directories: string[]) => boolean;
+    isInDir: (path: string, dir: string) => boolean;
+    isInDirs: (path: string, directories: string[]) => boolean;
     isSafePath: (path: string, options?: {
         parent?: string | null;
         parents?: string | string[] | null;
@@ -18,10 +16,12 @@ export type PlatformPath = {
     }) => boolean;
     isSafeSegment: (segment: string, target?: Target | 'auto') => boolean;
     join: (...paths: string[]) => string;
-    leaf: (path: string, suffix?: string) => string;
+    leafExt: (path: string, length?: number) => string;
+    leafName: (path: string, extension?: number | string) => string;
     matchesGlob?: (path: string, pattern: string) => boolean;
     normalize: (path: string) => string;
-    parent: (file: string) => string;
+    parentName: (path: string) => string;
+    parentPath: (path: string) => string;
     relative: (from: string, to: string) => string;
     resolve: (...paths: string[]) => string;
     sanitize: (path: string, options?: {

package/lib/cjs/untildify.d.cts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.cjs';
-export declare function untildify(_nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string) => string;
+export declare function untildify(_nodePath: opath.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/esm/absolute.d.mts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.mjs';
-export declare function absolute(nodePath: path.PlatformPath, localPath: PlatformPath): (...paths: string[]) => string;
+export declare function absolute(nodePath: opath.PlatformPath, localPath: PlatformPath): (...paths: string[]) => string;

package/lib/esm/index.d.mts

@@ -1,5 +1,5 @@
 import { type PlatformPath } from './types.mjs';
-declare const absolute: (...paths: string[]) => string, delimiter: ";" | ":", extension: (path: string) => string, isAbsolute: (path: string) => boolean, join: (...paths: string[]) => string, leaf: (path: string, suffix?: string) => string, matchesGlob: ((path: string, pattern: string) => boolean) | undefined, normalize: (path: string) => string, parent: (file: string) => string, isInDir: (file: string, dir: string) => boolean, isInDirs: (file: string, directories: string[]) => boolean, isSafePath: (path: string, options?: {
+declare const absolute: (...paths: string[]) => string, delimiter: ";" | ":", isAbsolute: (path: string) => boolean, join: (...paths: string[]) => string, leafExt: (path: string, length?: number) => string, leafName: (path: string, extension?: number | string) => string, matchesGlob: ((path: string, pattern: string) => boolean) | undefined, normalize: (path: string) => string, parentName: (path: string) => string, parentPath: (path: string) => string, isInDir: (path: string, dir: string) => boolean, isInDirs: (path: string, directories: string[]) => boolean, isSafePath: (path: string, options?: {
     parent?: string | null;
     parents?: string | string[] | null;
     target?: Target | "auto";
@@ -9,22 +9,23 @@ declare const absolute: (...paths: string[]) => string, delimiter: ";" | ":", ex
     replacement?: string | null;
     target?: Target | "auto";
 }) => DResult<string>, separator: "\\" | "/", untildify: (path: string) => string, win32: PlatformPath;
-export { type PlatformPath, absolute, delimiter, extension, isAbsolute, join, leaf, matchesGlob, normalize, parent, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, };
+export { type PlatformPath, absolute, delimiter, isAbsolute, join, leafExt, leafName, matchesGlob, normalize, parentName, parentPath, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, };
 import { type Target } from "@zokugun/fs-path-sanitize";
 import { type DResult } from "@zokugun/xtry";
 declare const _default: {
     PlatformPath: PlatformPath;
     absolute: (...paths: string[]) => string;
     delimiter: ";" | ":";
-    extension: (path: string) => string;
     isAbsolute: (path: string) => boolean;
     join: (...paths: string[]) => string;
-    leaf: (path: string, suffix?: string) => string;
+    leafExt: (path: string, length?: number) => string;
+    leafName: (path: string, extension?: number | string) => string;
     matchesGlob: ((path: string, pattern: string) => boolean) | undefined;
     normalize: (path: string) => string;
-    parent: (file: string) => string;
-    isInDir: (file: string, dir: string) => boolean;
-    isInDirs: (file: string, directories: string[]) => boolean;
+    parentName: (path: string) => string;
+    parentPath: (path: string) => string;
+    isInDir: (path: string, dir: string) => boolean;
+    isInDirs: (path: string, directories: string[]) => boolean;
     isSafePath: (path: string, options?: {
         parent?: string | null;
         parents?: string | string[] | null;

package/lib/esm/index.mjs

@@ -1,20 +1,21 @@
 import { DEFAULT_PLATFORM } from './platform.mjs';
-const { absolute, delimiter, extension, isAbsolute, join, leaf, matchesGlob, normalize, parent, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, } = DEFAULT_PLATFORM;
+const { absolute, delimiter, isAbsolute, join, leafExt, leafName, matchesGlob, normalize, parentName, parentPath, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, } = DEFAULT_PLATFORM;
 /* eslint-disable unicorn/prefer-export-from */
-export { absolute, delimiter, extension, isAbsolute, join, leaf, matchesGlob, normalize, parent, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, };
+export { absolute, delimiter, isAbsolute, join, leafExt, leafName, matchesGlob, normalize, parentName, parentPath, isInDir, isInDirs, isSafePath, isSafeSegment, posix, relative, resolve, sanitize, separator, untildify, win32, };
 /* eslint-enable unicorn/prefer-export-from */
 // eslint-disable-next-line import/no-anonymous-default-export
 export default {
     PlatformPath: undefined,
     absolute,
     delimiter,
-    extension,
     isAbsolute,
     join,
-    leaf,
+    leafExt,
+    leafName,
     matchesGlob,
     normalize,
-    parent,
+    parentName,
+    parentPath,
     isInDir,
     isInDirs,
     isSafePath,

package/lib/esm/is-in-dir.d.mts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.mjs';
-export declare function isInDir(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, parent: string) => boolean;
+export declare function isInDir(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, parent: string) => boolean;

package/lib/esm/is-in-dirs.d.mts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.mjs';
-export declare function isInDirs(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, parents: string[]) => boolean;
+export declare function isInDirs(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, parents: string[]) => boolean;

package/lib/esm/is-safe-path.d.mts

@@ -1,7 +1,7 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type Target } from '@zokugun/fs-path-sanitize';
 import { type PlatformPath } from './types.mjs';
-export declare function isSafePath(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, options?: {
+export declare function isSafePath(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, options?: {
     parent?: string | null;
     parents?: string | string[] | null;
     target?: Target | 'auto';

package/lib/esm/is-safe-segment.d.mts

@@ -1,4 +1,4 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type Target } from '@zokugun/fs-path-sanitize';
 import { type PlatformPath } from './types.mjs';
-export declare function isSafeSegment(_nodePath: path.PlatformPath, localPath: PlatformPath): (segment: string, target?: Target | 'auto') => boolean;
+export declare function isSafeSegment(_nodePath: opath.PlatformPath, localPath: PlatformPath): (segment: string, target?: Target | 'auto') => boolean;

package/lib/esm/join.d.mts

@@ -1,3 +1,3 @@
-import type path from 'path';
+import type opath from 'path';
 import { type PlatformPath } from './types.mjs';
-export declare function join(nodePath: path.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;
+export declare function join(nodePath: opath.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;

package/lib/esm/leaf-ext.d.mts

@@ -0,0 +1,3 @@
+import type path from 'node:path';
+import { type PlatformPath } from './types.mjs';
+export declare function leafExt(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string, length?: number) => string;

package/lib/esm/leaf-ext.mjs

@@ -0,0 +1,28 @@
+import { isUndefined } from '@zokugun/is-it-type';
+// eslint-disable-next-line unicorn/prevent-abbreviations
+export function leafExt(nodePath, _localPath) {
+    return (path, length) => {
+        if (isUndefined(length)) {
+            return nodePath.extname(path);
+        }
+        const name = nodePath.basename(path);
+        if (name.length === 0 || name.startsWith('.')) {
+            return '';
+        }
+        if (length <= 0) {
+            const index = name.indexOf('.');
+            return index === -1 ? '' : name.slice(index);
+        }
+        else if (length === 1) {
+            const index = name.lastIndexOf('.');
+            return index === -1 ? '' : name.slice(index);
+        }
+        else {
+            const parts = name.split('.');
+            if (parts.length === 1) {
+                return '';
+            }
+            return '.' + parts.slice(parts.length <= length ? 1 : -length).join('.');
+        }
+    };
+}

package/lib/esm/leaf-name.d.mts

@@ -0,0 +1,3 @@
+import type path from 'node:path';
+import { type PlatformPath } from './types.mjs';
+export declare function leafName(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string, extension?: number | string) => string;

package/lib/esm/leaf-name.mjs

@@ -0,0 +1,30 @@
+import { isString, isUndefined } from '@zokugun/is-it-type';
+export function leafName(nodePath, _localPath) {
+    return (path, extension) => {
+        if (isUndefined(extension)) {
+            return nodePath.basename(path);
+        }
+        if (isString(extension)) {
+            return nodePath.basename(path, extension);
+        }
+        const name = nodePath.basename(path);
+        if (name.length === 0 || name.startsWith('.')) {
+            return name;
+        }
+        if (extension <= 0) {
+            const index = name.indexOf('.');
+            return index === -1 ? name : name.slice(0, index);
+        }
+        else if (extension === 1) {
+            const index = name.lastIndexOf('.');
+            return index === -1 ? name : name.slice(0, index);
+        }
+        else {
+            const parts = name.split('.');
+            if (parts.length <= extension) {
+                return parts[0];
+            }
+            return parts.slice(0, -extension).join('.');
+        }
+    };
+}

package/lib/esm/parent-name.d.mts

@@ -0,0 +1,3 @@
+import type path from 'node:path';
+import { type PlatformPath } from './types.mjs';
+export declare function parentName(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/esm/parent-name.mjs

@@ -0,0 +1,11 @@
+export function parentName(nodePath, _localPath) {
+    return (path) => {
+        const parent = nodePath.dirname(path);
+        if (parent === '.') {
+            return '';
+        }
+        else {
+            return nodePath.basename(parent);
+        }
+    };
+}

package/lib/esm/parent-path.d.mts

@@ -0,0 +1,3 @@
+import type opath from 'node:path';
+import { type PlatformPath } from './types.mjs';
+export declare function parentPath(nodePath: opath.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/esm/{parent.mjs → parent-path.mjs}

@@ -1,6 +1,6 @@
-export function parent(nodePath, _localPath) {
-    return (file) => {
-        const parent = nodePath.dirname(file);
+export function parentPath(nodePath, _localPath) {
+    return (path) => {
+        const parent = nodePath.dirname(path);
         if (parent === '.') {
             return '';
         }

package/lib/esm/platform.mjs

@@ -1,43 +1,46 @@
-import path from 'node:path';
+import opath from 'node:path';
 import { absolute } from './absolute.mjs';
-import { dir } from './dir.mjs';
 import { isInDir } from './is-in-dir.mjs';
 // eslint-disable-next-line unicorn/prevent-abbreviations
 import { isInDirs } from './is-in-dirs.mjs';
 import { isSafePath } from './is-safe-path.mjs';
 import { isSafeSegment } from './is-safe-segment.mjs';
 import { join } from './join.mjs';
-import { parent } from './parent.mjs';
+// eslint-disable-next-line unicorn/prevent-abbreviations
+import { leafExt } from './leaf-ext.mjs';
+import { leafName } from './leaf-name.mjs';
+import { parentName } from './parent-name.mjs';
+import { parentPath } from './parent-path.mjs';
 import { resolve } from './resolve.mjs';
 import { sanitize } from './sanitize.mjs';
 import { untildify } from './untildify.mjs';
 function buildPlatform(path) {
-    const { basename: leaf, delimiter, extname: extension, isAbsolute, normalize, relative, sep: separator, } = path;
+    const { delimiter, isAbsolute, normalize, relative, sep: separator, } = path;
     const result = {
         delimiter,
         separator,
-        extension,
         isAbsolute,
-        leaf,
         matchesGlob: path.matchesGlob ?? undefined,
         normalize,
         relative,
     };
     result.absolute = absolute(path, result);
-    result.dir = dir(path, result);
     result.isInDir = isInDir(path, result);
     result.isInDirs = isInDirs(path, result);
     result.isSafePath = isSafePath(path, result);
     result.isSafeSegment = isSafeSegment(path, result);
     result.join = join(path, result);
-    result.parent = parent(path, result);
+    result.leafExt = leafExt(path, result);
+    result.leafName = leafName(path, result);
+    result.parentName = parentName(path, result);
+    result.parentPath = parentPath(path, result);
     result.resolve = resolve(path, result);
     result.sanitize = sanitize(path, result);
     result.untildify = untildify(path, result);
     return result;
 }
-const POSIX_PLATFORM = buildPlatform(path.posix);
-const WIN32_PLATFORM = buildPlatform(path.win32);
+const POSIX_PLATFORM = buildPlatform(opath.posix);
+const WIN32_PLATFORM = buildPlatform(opath.win32);
 Object.defineProperties(POSIX_PLATFORM, {
     posix: {
         value: POSIX_PLATFORM,
@@ -58,4 +61,4 @@ Object.defineProperties(WIN32_PLATFORM, {
         writable: false,
     },
 });
-export const DEFAULT_PLATFORM = (path === path.posix ? POSIX_PLATFORM : WIN32_PLATFORM);
+export const DEFAULT_PLATFORM = (opath === opath.posix ? POSIX_PLATFORM : WIN32_PLATFORM);

package/lib/esm/resolve.d.mts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.mjs';
-export declare function resolve(nodePath: path.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;
+export declare function resolve(nodePath: opath.PlatformPath, _localPath: PlatformPath): (...paths: string[]) => string;

package/lib/esm/sanitize.d.mts

@@ -1,8 +1,8 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type Target } from '@zokugun/fs-path-sanitize';
 import { type DResult } from '@zokugun/xtry';
 import { type PlatformPath } from './types.mjs';
-export declare function sanitize(_nodePath: path.PlatformPath, localPath: PlatformPath): (path: string, options?: {
+export declare function sanitize(_nodePath: opath.PlatformPath, localPath: PlatformPath): (path: string, options?: {
     parent?: string | null;
     parents?: string | string[] | null;
     replacement?: string | null;

package/lib/esm/types.d.mts

@@ -6,11 +6,9 @@ export type PlatformPath = {
     readonly posix: PlatformPath;
     readonly win32: PlatformPath;
     absolute: (...paths: string[]) => string;
-    dir: (path: string) => string;
-    extension: (path: string) => string;
     isAbsolute: (path: string) => boolean;
-    isInDir: (file: string, dir: string) => boolean;
-    isInDirs: (file: string, directories: string[]) => boolean;
+    isInDir: (path: string, dir: string) => boolean;
+    isInDirs: (path: string, directories: string[]) => boolean;
     isSafePath: (path: string, options?: {
         parent?: string | null;
         parents?: string | string[] | null;
@@ -18,10 +16,12 @@ export type PlatformPath = {
     }) => boolean;
     isSafeSegment: (segment: string, target?: Target | 'auto') => boolean;
     join: (...paths: string[]) => string;
-    leaf: (path: string, suffix?: string) => string;
+    leafExt: (path: string, length?: number) => string;
+    leafName: (path: string, extension?: number | string) => string;
     matchesGlob?: (path: string, pattern: string) => boolean;
     normalize: (path: string) => string;
-    parent: (file: string) => string;
+    parentName: (path: string) => string;
+    parentPath: (path: string) => string;
     relative: (from: string, to: string) => string;
     resolve: (...paths: string[]) => string;
     sanitize: (path: string, options?: {

package/lib/esm/untildify.d.mts

@@ -1,3 +1,3 @@
-import type path from 'node:path';
+import type opath from 'node:path';
 import { type PlatformPath } from './types.mjs';
-export declare function untildify(_nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string) => string;
+export declare function untildify(_nodePath: opath.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@zokugun/fs-path",
 	"description": "Path utilities complementing the builtin path module",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"author": {
 		"name": "Baptiste Augrain",
 		"email": "daiyam@zokugun.org"

package/lib/cjs/dir.cjs

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dir = dir;
-function dir(nodePath, _localPath) {
-    return (path) => nodePath.parse(path).dir;
-}

package/lib/cjs/dir.d.cts

@@ -1,3 +0,0 @@
-import type path from 'node:path';
-import { type PlatformPath } from './types.cjs';
-export declare function dir(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/cjs/parent.d.cts

@@ -1,3 +0,0 @@
-import type path from 'node:path';
-import { type PlatformPath } from './types.cjs';
-export declare function parent(nodePath: path.PlatformPath, _localPath: PlatformPath): (file: string) => string;

package/lib/esm/dir.d.mts

@@ -1,3 +0,0 @@
-import type path from 'node:path';
-import { type PlatformPath } from './types.mjs';
-export declare function dir(nodePath: path.PlatformPath, _localPath: PlatformPath): (path: string) => string;

package/lib/esm/dir.mjs

@@ -1,3 +0,0 @@
-export function dir(nodePath, _localPath) {
-    return (path) => nodePath.parse(path).dir;
-}

package/lib/esm/parent.d.mts

@@ -1,3 +0,0 @@
-import type path from 'node:path';
-import { type PlatformPath } from './types.mjs';
-export declare function parent(nodePath: path.PlatformPath, _localPath: PlatformPath): (file: string) => string;