@mangos/filepath 1.0.5 → 1.0.7

package/README.md

@@ -64,7 +64,19 @@ import { allPath, firstPath, resolve, resolvePathObject } from '@mangos/filepath
 There are 2 exported classes:
 
 ```typescript
-import { ParsedPath,  ParsedPathError } from '@mangos/filepath';
+import { ParsedPath,  ParsedPathError, PathToken } from '@mangos/filepath';
+```
+
+There is 1 exported enum:
+
+```typescript
+import { PathTokenEnum } from '@mangos/filepath'
+```
+
+There is 1 exported type:
+
+```typescript
+import type { InferPathOptions } from '@mangos/filepath'
 ```
 
 Most of the time you will be using <a href="#fn-resolve"><code>resolve</code></a>, <a href="#fn-first-path"><code>firstPath</code></a>.
@@ -127,6 +139,32 @@ When a string is parsed it will be evaluated according to path types in the foll
 3. `dos` tokanization will be tried third, (if the `dos` boolean is set to true).
 4. `posix` tokanization will be tried forth, (if the `posix` boolean is set to true)
 
+<h3 id="path-token-type"><code>PathToken</code> object</h3>
+
+You dont create `PathToken`s yourself the api will do it for you.
+
+```typescript
+class PathToken {
+    token: PathTokenValueType;
+	value: string; // actual path fragment (directory, seperator, or file)
+	start: number; // start location in the original string
+	end: number; // end (inclusive) in the original string
+	error?: string; // this token has invalid character for the OS selected
+}
+```
+
+The `PathTokenValueType` match the exported `PathTokenEnum` object
+
+```typescript
+export const PathTokenEnum = {
+	SEP: '\x01',       // path seperator
+	ROOT: '\x03',      // the root (if it is an absolute path)
+	PATHELT: '\x06',   // directory, file, 
+	PARENT: '\x07',    // two dots (..) meaning parent directory
+	CURRENT: '\x08',   // a single dot (.) meaning current directory
+} as const;
+```
+
 <h3 id="api-functions">Functions</h3>
 
 <h4 id="fn-all-path">function: <code>allPath</code></h4>

package/dist/index.d.ts

@@ -1,7 +1,8 @@
+import { PathTokenEnum } from './constants.js';
 import { ParsedPath } from './ParsedPath.js';
 import { ParsedPathError } from './ParsedPathError.js';
-import { allPath, firstPath, resolve } from './parser.js';
+import { allPath, firstPath, resolve, resolvePathObject } from './parser.js';
 import type { PathToken } from './Token.js';
 import type { PathTokenValueType } from './types/TokenValueType.js';
-export { resolve, firstPath, allPath, ParsedPath, ParsedPathError };
+export { resolve, firstPath, allPath, ParsedPath, ParsedPathError, resolvePathObject, PathTokenEnum };
 export type { PathTokenValueType, PathToken };

package/dist/index.js

@@ -1,10 +1,13 @@
+import { PathTokenEnum } from "./constants.js";
 import { ParsedPath } from "./ParsedPath.js";
 import { ParsedPathError } from "./ParsedPathError.js";
-import { allPath, firstPath, resolve } from "./parser.js";
+import { allPath, firstPath, resolve, resolvePathObject } from "./parser.js";
 export {
   ParsedPath,
   ParsedPathError,
+  PathTokenEnum,
   allPath,
   firstPath,
-  resolve
+  resolve,
+  resolvePathObject
 };

package/dist/parser.d.ts

@@ -14,4 +14,4 @@ declare function resolvePathObject(from: ParsedPath, ...toFragments: string[]):
 type InferPathOptions = {
     [key in FileSystem]+?: boolean;
 };
-export { resolve, type resolvePathObject, firstPath, allPath };
+export { resolve, resolvePathObject, firstPath, allPath };

package/dist/parser.js

@@ -160,5 +160,6 @@ function* inferPathType(path, options = {}) {
 export {
   allPath,
   firstPath,
-  resolve
+  resolve,
+  resolvePathObject
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mangos/filepath",
-	"version": "1.0.5",
+	"version": "1.0.7",
 	"author": "jacob bogers <jkfbogers@gmail.com>",
 	"repository": {
 		"type": "git",
@@ -17,7 +17,7 @@
 	"main": "./dist/index.js",
 	"devDependencies": {
 		"@biomejs/biome": "^2.3.8",
-		"@types/node": "^25.0.0",
+		"@types/node": "^25.0.3",
 		"@vitest/coverage-v8": "^4.0.15",
 		"typescript": "^5.9.3",
 		"vite": "^7.2.7",