fix(58): refacto path function

Author: ZeRiix

docs/en/v1/api/common/index.md

@@ -178,19 +178,10 @@ Defines named overrides (methods or default values) and applies them to an inter
 ## Path
 
 ### [Path](/en/v1/api/common/path/)
-Mini-domain for path utilities (normalization, joining, extraction).
+Mini-domain for POSIX path utilities (resolution, extraction).
 
 ### [Path.isAbsolute](/en/v1/api/common/path/isAbsolute)
-Checks whether a path is absolute (POSIX, UNC, or Windows drive).
-
-### [Path.isUnixPath](/en/v1/api/common/path/isUnixPath)
-Checks whether a path only uses Unix separators.
-
-### [Path.normalize](/en/v1/api/common/path/normalize)
-Normalizes a path by resolving segments and separators.
-
-### [Path.join](/en/v1/api/common/path/join)
-Joins path segments and normalizes the result.
+Checks whether a path is absolute.
 
 ### [Path.resolveFrom](/en/v1/api/common/path/resolveFrom)
 Resolves a list of segments from an origin.

docs/en/v1/api/common/path/getBaseName.md

@@ -1,6 +1,6 @@
 ---
 outline: [2, 3]
-description: "The getBaseName() function returns the last segment of a path, with optional extension removal."
+description: "The getBaseName() function returns the last non-empty segment of a path, with optional extension removal."
 prev:
   text: "getParentFolderPath"
   link: "/en/v1/api/common/path/getParentFolderPath"
@@ -11,7 +11,11 @@ next:
 
 # getBaseName
 
-The **`getBaseName()`** function returns the last segment of a path, with optional extension removal.
+The **`getBaseName()`** function returns the last non-empty segment of a path, with optional extension removal.
+
+::: warning
+Works only with POSIX paths (not Windows paths).
+:::
 
 ## Interactive example
 
@@ -32,6 +36,7 @@ function getBaseName<
 		extension?: string;
 	}
 ): string;
+): string | null;
 ```
 
 ## Parameters
@@ -41,7 +46,7 @@ function getBaseName<
 
 ## Return value
 
-The last segment, with the extension removed when it matches.
+The last segment, with the extension removed when it matches, or `null` when no segment is available.
 
 ## See also
 

docs/en/v1/api/common/path/getExtensionName.md

@@ -1,6 +1,6 @@
 ---
 outline: [2, 3]
-description: "The getExtensionName() function returns the extension of a path, including the dot."
+description: "The getExtensionName() function returns the last extension of a path, including the dot."
 prev:
   text: "getBaseName"
   link: "/en/v1/api/common/path/getBaseName"
@@ -11,7 +11,11 @@ next:
 
 # getExtensionName
 
-The **`getExtensionName()`** function returns the extension of a path, including the dot.
+The **`getExtensionName()`** function returns the last extension of a path, including the dot.
+
+::: warning
+Works only with POSIX paths (not Windows paths).
+:::
 
 ## Interactive example
 
@@ -28,7 +32,7 @@ function getExtensionName<
 	GenericPath extends string
 >(
 	path: GenericPath
-): string;
+): string | null;
 ```
 
 ## Parameters
@@ -37,7 +41,7 @@ function getExtensionName<
 
 ## Return value
 
-The extension including the dot (e.g. `.txt`) or an empty string when none is found.
+The extension including the dot (e.g. `.txt`) or `null` when none is found.
 
 ## See also
 

docs/en/v1/api/common/path/getParentFolderPath.md

@@ -1,6 +1,6 @@
 ---
 outline: [2, 3]
-description: "The getParentFolderPath() function returns the parent folder of a path."
+description: "The getParentFolderPath() function returns the parent folder of a POSIX path."
 prev:
   text: "resolveFrom"
   link: "/en/v1/api/common/path/resolveFrom"
@@ -11,7 +11,11 @@ next:
 
 # getParentFolderPath
 
-The **`getParentFolderPath()`** function returns the parent folder of a path.
+The **`getParentFolderPath()`** function returns the parent folder of a POSIX path.
+
+::: warning
+Works only with POSIX paths (not Windows paths).
+:::
 
 ## Interactive example
 

docs/en/v1/api/common/path/index.md

@@ -1,6 +1,6 @@
 ---
 outline: [2, 3]
-description: "Path utilities to normalize, join, and inspect cross-platform paths."
+description: "Path utilities to resolve and inspect POSIX paths."
 prev:
   text: "Common"
   link: "/en/v1/api/common/"
@@ -11,7 +11,7 @@ next:
 
 # Path
 
-Path utilities to normalize, join, and inspect cross-platform paths.
+Path utilities to resolve and inspect POSIX paths.
 
 ## How to import?
 
@@ -25,18 +25,12 @@ import * as Path from "@duplojs/utils/common/path";
 ## Checks
 
 ### [isAbsolute](/en/v1/api/common/path/isAbsolute)
-Checks whether a path is absolute (POSIX, UNC, or Windows drive).
+Checks whether a path is absolute.
 
-### [isUnixPath](/en/v1/api/common/path/isUnixPath)
-Checks whether a path only uses Unix separators.
+## Resolution
 
-## Normalization and composition
-
-### [normalize](/en/v1/api/common/path/normalize)
-Normalizes a path by resolving segments and separators.
-
-### [join](/en/v1/api/common/path/join)
-Joins path segments and normalizes the result.
+### [resolveRelative](/en/v1/api/common/path/resolveRelative)
+Resolves multiple segments into a single path.
 
 ### [resolveFrom](/en/v1/api/common/path/resolveFrom)
 Resolves a list of segments from an origin.

docs/en/v1/api/common/path/isAbsolute.md

@@ -1,37 +1,36 @@
 ---
 outline: [2, 3]
-description: "The isAbsolute() function checks whether a path is absolute (POSIX, UNC, or Windows drive) and acts as a type guard."
+description: "The isAbsolute() function checks whether a POSIX path is absolute and does not traverse above root."
 prev:
   text: "Path"
   link: "/en/v1/api/common/path/"
 next:
-  text: "isUnixPath"
-  link: "/en/v1/api/common/path/isUnixPath"
+  text: "resolveRelative"
+  link: "/en/v1/api/common/path/resolveRelative"
 ---
 
 # isAbsolute
 
-The **`isAbsolute()`** function checks whether a path is absolute (POSIX, UNC, or Windows drive) and acts as a type guard.
+The **`isAbsolute()`** function checks whether a path is absolute and does not traverse above root.
+
+::: warning
+Works only with POSIX paths (not Windows paths).
+:::
 
 ## Interactive example
 
 <MonacoTSEditor
   src="/examples/v1/api/common/path/isAbsolute/tryout.doc.ts"
   majorVersion="v1"
-  height="313px"
+  height="208px"
 />
 
 ## Syntax
 
 ```typescript
-function isAbsolute<
-	GenericPath extends string
->(
-	path: GenericPath
-): path is Extract<
-	GenericPath,
-	`/${string}` | `\\${string}` | `${string}:${"/" | "\\"}${string}`
->;
+function isAbsolute(
+	path: string
+): boolean;
 ```
 
 ## Parameters
@@ -40,9 +39,8 @@ function isAbsolute<
 
 ## Return value
 
-A boolean and a type guard that narrows the path when it is absolute.
+A boolean indicating whether the path is absolute.
 
 ## See also
 
-- [`isUnixPath`](/en/v1/api/common/path/isUnixPath) - Checks for Unix separators
-- [`normalize`](/en/v1/api/common/path/normalize) - Normalizes a path
+- [`resolveFrom`](/en/v1/api/common/path/resolveFrom) - Resolves a list of segments from an origin