pathtrace 1.0.0-beta.1 → 1.0.0

package/README.md

@@ -1,15 +1,16 @@
 # pathtrace 🔍
 
+[![npm version](https://badge.fury.io/js/pathtrace.svg)](https://badge.fury.io/js/pathtrace)
+[![codecov](https://codecov.io/gh/tada5hi/pathtrace/graph/badge.svg?token=VIP3G2QT16)](https://codecov.io/gh/tada5hi/pathtrace)
 [![main](https://github.com/tada5hi/pathtrace/actions/workflows/main.yml/badge.svg)](https://github.com/tada5hi/pathtrace/actions/workflows/main.yml)
-[![CodeQL](https://github.com/tada5hi/pathtrace/actions/workflows/codeql.yml/badge.svg)](https://github.com/tada5hi/pathtrace/actions/workflows/codeql.yml)
 [![Known Vulnerabilities](https://snyk.io/test/github/tada5hi/pathtrace/badge.svg)](https://snyk.io/test/github/tada5hi/pathtrace)
 [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
 
 **Pathtrace** is a library for managing nested objects and arrays. 
-It offers straightforward methods for 
-retrieving ([getPathValue](#getPathValue)) and
-setting ([setPathValue](#setPathValue)) values at any path.
-Additionally, [getPathInfo](#getPathInfo) provides detailed path information, 
+It offers straightforward methods for retrieving ([getPathValue](#getpathvalue)) and
+setting ([setPathValue](#setpathvalue)) values at any path. 
+Additionally, [getPathInfo](#getpathinfo) provides detailed path information, 
+and the [expandPath](#expandpath) helper allows for querying and expanding paths with wildcards and globstars,
 making it ideal for handling complex data structures efficiently.
 
 **Table of Contents**
@@ -18,6 +19,7 @@ making it ideal for handling complex data structures efficiently.
 - [Usage](#usage)
     - [getPathValue](#getpathvalue)
     - [setPathValue](#setpathvalue)
+    - [expandPath](#expandpath)
     - [getPathInfo](#getpathinfo)
 - [License](#license)
 
@@ -213,6 +215,52 @@ var modifiedObj = setPathValue(obj, 'user.contact.phone', '987-654-3210');
 console.log(modifiedObj === obj); // true
 ```
 
+### expandPath
+
+The expandPath function takes an object and a string representing a path, 
+potentially containing wildcards (`*`) and globstars (`**`),
+and returns an array of all possible matching paths within the object.
+
+**Example: Wildcard (`*`) - Select all shallow paths of an array**
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = {
+    foo: ['bar', 'baz'],
+};
+const paths = expandPath(obj, 'foo.*');
+console.log(paths); // ['foo[0]', 'foo[1]']
+```
+
+**Example: Wildcard (`*`) - Select matching paths under a wildcard branch**
+
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = { foo: { bar: { a: true }, baz: { a: false, b: 1 } } };
+const paths = expandPath(obj, 'foo.*.a');
+console.log(paths); // ['foo.bar.a', 'foo.baz.a']
+```
+
+**Example: Globstar (`**`) - Select all leaves that match a leaf globstar**
+
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = { foo: { a: { b: { c: 1 } }, d: { e: 2 } } };
+const paths = expandPath(obj, 'foo.**');
+console.log(paths); // ['foo.a.b.c', 'foo.d.e']
+```
+
+**Example: Globstar (`**`) - Select deeply nested matching paths under a globstar branch**
+
+```ts
+import { expandPath } from 'pathtrace';
+
+const obj = { foo: { a: { b: { bar: 1 } }, c: { bar: 2 } } };
+const paths = expandPath(obj, 'foo.**.bar');
+console.log(paths); // ['foo.a.b.bar', 'foo.c.bar']
+```
 
 ### getPathInfo
 

package/dist/index.cjs

@@ -11,7 +11,6 @@
  */ function arrayToPath(parts) {
     return parts.reduce((prev, segment)=>{
         let part = '';
-        segment = segment === '\\*' ? '*' : segment;
         segment = segment.replace(/^\[(\d+)]$/g, '\\[$1]');
         segment = segment.replace(/\./g, '\\.');
         if (/^\d+$/.test(segment)) {
@@ -62,6 +61,118 @@
     return result;
 }
 
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ var Character;
+(function(Character) {
+    Character["WILDCARD"] = "*";
+    Character["GLOBSTAR"] = "**";
+})(Character || (Character = {}));
+
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ function isObject(input) {
+    return !!input && typeof input === 'object' && !Array.isArray(input);
+}
+
+function expandPathVerboseInternal(data, path, currPath = [], currMatches = []) {
+    const segments = Array.isArray(path) ? path : pathToArray(path);
+    if (!segments.length) {
+        // no more paths to traverse
+        return [
+            {
+                value: arrayToPath(currPath),
+                matches: currMatches
+            }
+        ];
+    }
+    const key = segments[0];
+    const rest = segments.slice(1);
+    if (typeof data !== 'undefined' && data !== null && !isObject(data) && !Array.isArray(data)) {
+        if (key === Character.GLOBSTAR) {
+            if (!rest.length) {
+                // globstar leaves are always selected
+                return [
+                    {
+                        value: arrayToPath(currPath),
+                        matches: currMatches
+                    }
+                ];
+            }
+            return [];
+        }
+        if (key === Character.WILDCARD) {
+            return [];
+        }
+        // value is a primitive, paths being traversed from here might be in their prototype,
+        // return the entire path
+        return [
+            {
+                value: arrayToPath([
+                    ...currPath,
+                    ...segments
+                ]),
+                matches: currMatches
+            }
+        ];
+    }
+    // Use a non-null value so that non-existing fields are still selected
+    data = data || {};
+    if (key === Character.WILDCARD) {
+        return Object.keys(data).flatMap((key)=>expandPathVerboseInternal(data[key], arrayToPath(rest), currPath.concat(key), currMatches.concat(key)));
+    }
+    if (key === Character.GLOBSTAR) {
+        return Object.keys(data).flatMap((key)=>{
+            const nextPath = currPath.concat(key);
+            const value = data[key];
+            // recursively find matching sub-paths & skip the first remaining segment, if it matches the current key
+            const children = expandPathVerboseInternal(value, arrayToPath(segments), nextPath, [
+                key
+            ]).concat(rest[0] === key ? expandPathVerboseInternal(value, arrayToPath(rest.slice(1)), nextPath, []) : []);
+            const pathMatches = [];
+            const output = [];
+            for(let i = 0; i < children.length; i++){
+                /* istanbul ignore next */ if (pathMatches.indexOf(children[i].value) !== -1) {
+                    continue;
+                }
+                pathMatches.push(children[i].value);
+                output.push({
+                    value: children[i].value,
+                    matches: children[i].matches.length > 0 ? [
+                        ...currMatches,
+                        children[i].matches.flat()
+                    ] : currMatches
+                });
+            }
+            return output;
+        });
+    }
+    return expandPathVerboseInternal(data[key], rest, currPath.concat(key), currMatches);
+}
+/**
+ * Verbose expand wildcard and glob patterns.
+ * Track wildcard/glob pattern matches.
+ *
+ * @param data
+ * @param path
+ */ function expandPathVerbose(data, path) {
+    return expandPathVerboseInternal(data, path);
+}
+/**
+ * Expand wildcard and glob patterns to paths.
+ *
+ * @param data
+ * @param path
+ */ function expandPath(data, path) {
+    return expandPathVerbose(data, path).map((el)=>el.value);
+}
+
 function getPathValue(data, path) {
     const parts = Array.isArray(path) ? path : pathToArray(path);
     let res;
@@ -86,6 +197,35 @@ function getPathValue(data, path) {
     return res;
 }
 
+const NUMBER_REGEX = /^\d+$/;
+function setPathValue(data, path, value) {
+    const parts = Array.isArray(path) ? path : pathToArray(path);
+    let temp = data;
+    let index = 0;
+    while(index < parts.length){
+        /* istanbul ignore next */ if (!Array.isArray(temp) && !isObject(temp)) {
+            break;
+        }
+        const key = parts[index];
+        // [foo, '0']
+        if (typeof temp[key] === 'undefined') {
+            const match = NUMBER_REGEX.test(key);
+            if (match) {
+                temp[key] = [];
+            } else {
+                temp[key] = {};
+            }
+        }
+        if (index === parts.length - 1) {
+            temp[key] = value;
+            break;
+        }
+        index++;
+        temp = temp[key];
+    }
+    return data;
+}
+
 class PathInfo {
     get value() {
         if (typeof this._value !== 'undefined') {
@@ -113,10 +253,9 @@ class PathInfo {
             return this._parent;
         }
         if (this.pathParts.length > 1) {
-            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);
-            this._parent = new PathInfo(this.data, arrayToPath(parentPathParts));
+            this._parent = new PathInfo(this.data, this.pathParts.slice(0, this.pathParts.length - 1));
         } else {
-            this._parent = new PathInfo(this.data);
+            this._parent = new PathInfo(this.data, []);
         }
         return this._parent;
     }
@@ -137,8 +276,11 @@ class PathInfo {
     }
     constructor(data, path){
         this.data = data;
-        this.path = path;
-        this.pathParts = this.path ? pathToArray(this.path) : [];
+        if (Array.isArray(path)) {
+            this.pathParts = path;
+        } else {
+            this.pathParts = pathToArray(path);
+        }
     }
 }
 
@@ -146,46 +288,11 @@ function getPathInfo(data, path) {
     return new PathInfo(data, path);
 }
 
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function isObject(input) {
-    return !!input && typeof input === 'object' && !Array.isArray(input);
-}
-
-const NUMBER_REGEX = /^\d+$/;
-function setPathValue(data, path, value) {
-    const parts = Array.isArray(path) ? path : pathToArray(path);
-    let temp = data;
-    let index = 0;
-    while(index < parts.length){
-        /* istanbul ignore next */ if (!Array.isArray(temp) && !isObject(temp)) {
-            break;
-        }
-        const key = parts[index];
-        // [foo, '0']
-        if (typeof temp[key] === 'undefined') {
-            const match = NUMBER_REGEX.test(key);
-            if (match) {
-                temp[key] = [];
-            } else {
-                temp[key] = {};
-            }
-        }
-        if (index === parts.length - 1) {
-            temp[key] = value;
-            break;
-        }
-        index++;
-        temp = temp[key];
-    }
-    return data;
-}
-
 exports.BRACKET_NUMBER_REGEX = BRACKET_NUMBER_REGEX;
+exports.PathInfo = PathInfo;
 exports.arrayToPath = arrayToPath;
+exports.expandPath = expandPath;
+exports.expandPathVerbose = expandPathVerbose;
 exports.getPathInfo = getPathInfo;
 exports.getPathValue = getPathValue;
 exports.pathToArray = pathToArray;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/get-path-value.ts","../src/path-info.ts","../src/get-path-info.ts","../src/utils/is-object.ts","../src/set-path-value.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n        segment = segment === '\\\\*' ? '*' : segment;\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from './get-path-value';\nimport { arrayToPath, pathToArray } from './helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected path : string | undefined;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path?: string) {\n        this.data = data;\n        this.path = path;\n        this.pathParts = this.path ?\n            pathToArray(this.path) :\n            [];\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);\n            this._parent = new PathInfo(\n                this.data,\n                arrayToPath(parentPathParts),\n            );\n        } else {\n            this._parent = new PathInfo(this.data);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './path-info';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path?: string,\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\nimport { isObject } from './utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","getPathValue","data","path","Array","isArray","res","temp","index","Object","PathInfo","value","_value","pathParts","name","parent","_parent","parentPathParts","slice","exists","_exists","constructor","getPathInfo","isObject","input","NUMBER_REGEX","setPathValue","key"],"mappings":"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"}
+{"version":3,"file":"index.cjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/path-expand/constants.ts","../src/utils/is-object.ts","../src/path-expand/module.ts","../src/path-value/get.ts","../src/path-value/set.ts","../src/path-info/module.ts","../src/path-info/helper.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum Character {\n    WILDCARD = '*',\n    GLOBSTAR = '**',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { Character } from './constants';\nimport type { PathExpanded } from './types';\nimport { isObject } from '../utils';\nimport { arrayToPath, pathToArray } from '../helpers';\n\nfunction expandPathVerboseInternal(\n    data: Record<string, any>,\n    path: string | string[],\n    currPath: readonly string[] = [],\n    currMatches: readonly (string | string[])[] = [],\n): PathExpanded[] {\n    const segments = Array.isArray(path) ? path : pathToArray(path);\n    if (!segments.length) {\n        // no more paths to traverse\n        return [\n            {\n                value: arrayToPath(currPath),\n                matches: currMatches,\n            },\n        ];\n    }\n\n    const key = segments[0];\n    const rest = segments.slice(1);\n\n    if (\n        typeof data !== 'undefined' &&\n        data !== null &&\n        !isObject(data) &&\n        !Array.isArray(data)\n    ) {\n        if (key === Character.GLOBSTAR) {\n            if (!rest.length) {\n                // globstar leaves are always selected\n                return [\n                    {\n                        value: arrayToPath(currPath),\n                        matches: currMatches,\n                    },\n                ];\n            }\n\n            return [];\n        }\n\n        if (key === Character.WILDCARD) {\n            return [];\n        }\n\n        // value is a primitive, paths being traversed from here might be in their prototype,\n        // return the entire path\n        return [{ value: arrayToPath([...currPath, ...segments]), matches: currMatches }];\n    }\n\n    // Use a non-null value so that non-existing fields are still selected\n    data = data || {};\n\n    if (key === Character.WILDCARD) {\n        return Object.keys(data)\n            .flatMap((key) => expandPathVerboseInternal(\n                data[key],\n                arrayToPath(rest),\n                currPath.concat(key),\n                currMatches.concat(key),\n            ));\n    }\n\n    if (key === Character.GLOBSTAR) {\n        return Object.keys(data)\n            .flatMap((key) => {\n                const nextPath = currPath.concat(key);\n                const value = data[key];\n\n                // recursively find matching sub-paths & skip the first remaining segment, if it matches the current key\n                const children = expandPathVerboseInternal(value, arrayToPath(segments), nextPath, [key])\n                    .concat(rest[0] === key ? expandPathVerboseInternal(value, arrayToPath(rest.slice(1)), nextPath, []) : []);\n\n                const pathMatches : string[] = [];\n                const output : PathExpanded[] = [];\n                for (let i = 0; i < children.length; i++) {\n                    /* istanbul ignore next */\n                    if (pathMatches.indexOf(children[i].value) !== -1) {\n                        continue;\n                    }\n\n                    pathMatches.push(children[i].value);\n\n                    output.push({\n                        value: children[i].value,\n                        matches: children[i].matches.length > 0 ?\n                            [...currMatches, children[i].matches.flat()] :\n                            currMatches,\n                    });\n                }\n\n                return output;\n            });\n    }\n\n    return expandPathVerboseInternal(data[key], rest, currPath.concat(key), currMatches);\n}\n\n/**\n * Verbose expand wildcard and glob patterns.\n * Track wildcard/glob pattern matches.\n *\n * @param data\n * @param path\n */\nexport function expandPathVerbose(\n    data: Record<string, any>,\n    path: string | string[],\n): PathExpanded[] {\n    return expandPathVerboseInternal(data, path);\n}\n\n/**\n * Expand wildcard and glob patterns to paths.\n *\n * @param data\n * @param path\n */\nexport function expandPath(\n    data: Record<string, any>,\n    path: string | string[],\n): string[] {\n    return expandPathVerbose(data, path)\n        .map((el) => el.value);\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from '../helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from '../helpers';\nimport { isObject } from '../utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from '../path-value/get';\nimport { pathToArray } from '../helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path: string | string[]) {\n        this.data = data;\n\n        if (Array.isArray(path)) {\n            this.pathParts = path;\n        } else {\n            this.pathParts = pathToArray(path);\n        }\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            this._parent = new PathInfo(\n                this.data,\n                this.pathParts.slice(0, this.pathParts.length - 1),\n            );\n        } else {\n            this._parent = new PathInfo(this.data, []);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './module';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path: string | string[],\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","Character","isObject","input","Array","isArray","expandPathVerboseInternal","data","path","currPath","currMatches","segments","value","matches","key","rest","slice","GLOBSTAR","WILDCARD","Object","keys","flatMap","concat","nextPath","children","pathMatches","output","indexOf","flat","expandPathVerbose","expandPath","map","el","getPathValue","res","temp","index","NUMBER_REGEX","setPathValue","PathInfo","_value","pathParts","name","parent","_parent","exists","_exists","constructor","getPathInfo"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export * from './helpers';
-export * from './get-path-value';
-export * from './get-path-info';
-export * from './set-path-value';
+export * from './path-expand';
+export * from './path-value';
+export * from './path-info';

package/dist/index.mjs

@@ -9,7 +9,6 @@
  */ function arrayToPath(parts) {
     return parts.reduce((prev, segment)=>{
         let part = '';
-        segment = segment === '\\*' ? '*' : segment;
         segment = segment.replace(/^\[(\d+)]$/g, '\\[$1]');
         segment = segment.replace(/\./g, '\\.');
         if (/^\d+$/.test(segment)) {
@@ -60,6 +59,118 @@
     return result;
 }
 
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ var Character;
+(function(Character) {
+    Character["WILDCARD"] = "*";
+    Character["GLOBSTAR"] = "**";
+})(Character || (Character = {}));
+
+/*
+ * Copyright (c) 2024.
+ * Author Peter Placzek (tada5hi)
+ * For the full copyright and license information,
+ * view the LICENSE file that was distributed with this source code.
+ */ function isObject(input) {
+    return !!input && typeof input === 'object' && !Array.isArray(input);
+}
+
+function expandPathVerboseInternal(data, path, currPath = [], currMatches = []) {
+    const segments = Array.isArray(path) ? path : pathToArray(path);
+    if (!segments.length) {
+        // no more paths to traverse
+        return [
+            {
+                value: arrayToPath(currPath),
+                matches: currMatches
+            }
+        ];
+    }
+    const key = segments[0];
+    const rest = segments.slice(1);
+    if (typeof data !== 'undefined' && data !== null && !isObject(data) && !Array.isArray(data)) {
+        if (key === Character.GLOBSTAR) {
+            if (!rest.length) {
+                // globstar leaves are always selected
+                return [
+                    {
+                        value: arrayToPath(currPath),
+                        matches: currMatches
+                    }
+                ];
+            }
+            return [];
+        }
+        if (key === Character.WILDCARD) {
+            return [];
+        }
+        // value is a primitive, paths being traversed from here might be in their prototype,
+        // return the entire path
+        return [
+            {
+                value: arrayToPath([
+                    ...currPath,
+                    ...segments
+                ]),
+                matches: currMatches
+            }
+        ];
+    }
+    // Use a non-null value so that non-existing fields are still selected
+    data = data || {};
+    if (key === Character.WILDCARD) {
+        return Object.keys(data).flatMap((key)=>expandPathVerboseInternal(data[key], arrayToPath(rest), currPath.concat(key), currMatches.concat(key)));
+    }
+    if (key === Character.GLOBSTAR) {
+        return Object.keys(data).flatMap((key)=>{
+            const nextPath = currPath.concat(key);
+            const value = data[key];
+            // recursively find matching sub-paths & skip the first remaining segment, if it matches the current key
+            const children = expandPathVerboseInternal(value, arrayToPath(segments), nextPath, [
+                key
+            ]).concat(rest[0] === key ? expandPathVerboseInternal(value, arrayToPath(rest.slice(1)), nextPath, []) : []);
+            const pathMatches = [];
+            const output = [];
+            for(let i = 0; i < children.length; i++){
+                /* istanbul ignore next */ if (pathMatches.indexOf(children[i].value) !== -1) {
+                    continue;
+                }
+                pathMatches.push(children[i].value);
+                output.push({
+                    value: children[i].value,
+                    matches: children[i].matches.length > 0 ? [
+                        ...currMatches,
+                        children[i].matches.flat()
+                    ] : currMatches
+                });
+            }
+            return output;
+        });
+    }
+    return expandPathVerboseInternal(data[key], rest, currPath.concat(key), currMatches);
+}
+/**
+ * Verbose expand wildcard and glob patterns.
+ * Track wildcard/glob pattern matches.
+ *
+ * @param data
+ * @param path
+ */ function expandPathVerbose(data, path) {
+    return expandPathVerboseInternal(data, path);
+}
+/**
+ * Expand wildcard and glob patterns to paths.
+ *
+ * @param data
+ * @param path
+ */ function expandPath(data, path) {
+    return expandPathVerbose(data, path).map((el)=>el.value);
+}
+
 function getPathValue(data, path) {
     const parts = Array.isArray(path) ? path : pathToArray(path);
     let res;
@@ -84,6 +195,35 @@ function getPathValue(data, path) {
     return res;
 }
 
+const NUMBER_REGEX = /^\d+$/;
+function setPathValue(data, path, value) {
+    const parts = Array.isArray(path) ? path : pathToArray(path);
+    let temp = data;
+    let index = 0;
+    while(index < parts.length){
+        /* istanbul ignore next */ if (!Array.isArray(temp) && !isObject(temp)) {
+            break;
+        }
+        const key = parts[index];
+        // [foo, '0']
+        if (typeof temp[key] === 'undefined') {
+            const match = NUMBER_REGEX.test(key);
+            if (match) {
+                temp[key] = [];
+            } else {
+                temp[key] = {};
+            }
+        }
+        if (index === parts.length - 1) {
+            temp[key] = value;
+            break;
+        }
+        index++;
+        temp = temp[key];
+    }
+    return data;
+}
+
 class PathInfo {
     get value() {
         if (typeof this._value !== 'undefined') {
@@ -111,10 +251,9 @@ class PathInfo {
             return this._parent;
         }
         if (this.pathParts.length > 1) {
-            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);
-            this._parent = new PathInfo(this.data, arrayToPath(parentPathParts));
+            this._parent = new PathInfo(this.data, this.pathParts.slice(0, this.pathParts.length - 1));
         } else {
-            this._parent = new PathInfo(this.data);
+            this._parent = new PathInfo(this.data, []);
         }
         return this._parent;
     }
@@ -135,8 +274,11 @@ class PathInfo {
     }
     constructor(data, path){
         this.data = data;
-        this.path = path;
-        this.pathParts = this.path ? pathToArray(this.path) : [];
+        if (Array.isArray(path)) {
+            this.pathParts = path;
+        } else {
+            this.pathParts = pathToArray(path);
+        }
     }
 }
 
@@ -144,43 +286,5 @@ function getPathInfo(data, path) {
     return new PathInfo(data, path);
 }
 
-/*
- * Copyright (c) 2024.
- * Author Peter Placzek (tada5hi)
- * For the full copyright and license information,
- * view the LICENSE file that was distributed with this source code.
- */ function isObject(input) {
-    return !!input && typeof input === 'object' && !Array.isArray(input);
-}
-
-const NUMBER_REGEX = /^\d+$/;
-function setPathValue(data, path, value) {
-    const parts = Array.isArray(path) ? path : pathToArray(path);
-    let temp = data;
-    let index = 0;
-    while(index < parts.length){
-        /* istanbul ignore next */ if (!Array.isArray(temp) && !isObject(temp)) {
-            break;
-        }
-        const key = parts[index];
-        // [foo, '0']
-        if (typeof temp[key] === 'undefined') {
-            const match = NUMBER_REGEX.test(key);
-            if (match) {
-                temp[key] = [];
-            } else {
-                temp[key] = {};
-            }
-        }
-        if (index === parts.length - 1) {
-            temp[key] = value;
-            break;
-        }
-        index++;
-        temp = temp[key];
-    }
-    return data;
-}
-
-export { BRACKET_NUMBER_REGEX, arrayToPath, getPathInfo, getPathValue, pathToArray, setPathValue };
+export { BRACKET_NUMBER_REGEX, PathInfo, arrayToPath, expandPath, expandPathVerbose, getPathInfo, getPathValue, pathToArray, setPathValue };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/get-path-value.ts","../src/path-info.ts","../src/get-path-info.ts","../src/utils/is-object.ts","../src/set-path-value.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n        segment = segment === '\\\\*' ? '*' : segment;\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from './get-path-value';\nimport { arrayToPath, pathToArray } from './helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected path : string | undefined;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path?: string) {\n        this.data = data;\n        this.path = path;\n        this.pathParts = this.path ?\n            pathToArray(this.path) :\n            [];\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            const parentPathParts = this.pathParts.slice(0, this.pathParts.length - 1);\n            this._parent = new PathInfo(\n                this.data,\n                arrayToPath(parentPathParts),\n            );\n        } else {\n            this._parent = new PathInfo(this.data);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './path-info';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path?: string,\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from './helpers';\nimport { isObject } from './utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ? path : pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","getPathValue","data","path","Array","isArray","res","temp","index","Object","PathInfo","value","_value","pathParts","name","parent","_parent","parentPathParts","slice","exists","_exists","constructor","getPathInfo","isObject","input","NUMBER_REGEX","setPathValue","key"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/helpers/array-to-path.ts","../src/helpers/path-to-array.ts","../src/path-expand/constants.ts","../src/utils/is-object.ts","../src/path-expand/module.ts","../src/path-value/get.ts","../src/path-value/set.ts","../src/path-info/module.ts","../src/path-info/helper.ts"],"sourcesContent":["/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\n/**\n * @see https://github.com/express-validator/express-validator/blob/bec1dcbaa29002dcd21093ec84818c4671063b5d/src/field-selection.ts#L214\n * @param parts\n */\nexport function arrayToPath(parts: readonly string[]) : string {\n    return parts.reduce((prev, segment) => {\n        let part = '';\n\n        segment = segment.replace(/^\\[(\\d+)]$/g, '\\\\[$1]');\n        segment = segment.replace(/\\./g, '\\\\.');\n\n        if (/^\\d+$/.test(segment)) {\n            // Index access\n            part = `[${segment}]`;\n        } else if (prev) {\n            // Object key access\n            part = `.${segment}`;\n        } else {\n            // Top level key\n            part = segment;\n        }\n\n        return prev + part;\n    }, '');\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport const BRACKET_NUMBER_REGEX = /(?<!\\\\)\\[(\\d+)]$/;\n\n/**\n * Convert string to property path array.\n *\n * @see https://github.com/lodash/lodash/blob/main/src/.internal/stringToPath.ts\n * @see https://github.com/chaijs/pathval\n *\n * @param segment\n */\nexport function pathToArray(segment: string) : string[] {\n    const str = segment.replace(/([^\\\\])\\[/g, '$1.[');\n    const parts = str.match(/(\\\\\\.|[^.]+?)+/g);\n    if (!parts) {\n        return [];\n    }\n\n    const result : string[] = [];\n\n    for (let i = 0; i < parts.length; i++) {\n        if (\n            parts[i] === 'constructor' ||\n            parts[i] === '__proto__' ||\n            parts[i] === 'prototype'\n        ) {\n            continue;\n        }\n\n        const regex = BRACKET_NUMBER_REGEX.exec(parts[i]);\n        if (regex) {\n            result.push(regex[1]);\n        } else {\n            result.push(parts[i].replace(/\\\\([.[\\]])/g, '$1'));\n        }\n    }\n\n    return result;\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport enum Character {\n    WILDCARD = '*',\n    GLOBSTAR = '**',\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nexport function isObject(input: unknown) : input is Record<string, any> {\n    return !!input &&\n        typeof input === 'object' &&\n        !Array.isArray(input);\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { Character } from './constants';\nimport type { PathExpanded } from './types';\nimport { isObject } from '../utils';\nimport { arrayToPath, pathToArray } from '../helpers';\n\nfunction expandPathVerboseInternal(\n    data: Record<string, any>,\n    path: string | string[],\n    currPath: readonly string[] = [],\n    currMatches: readonly (string | string[])[] = [],\n): PathExpanded[] {\n    const segments = Array.isArray(path) ? path : pathToArray(path);\n    if (!segments.length) {\n        // no more paths to traverse\n        return [\n            {\n                value: arrayToPath(currPath),\n                matches: currMatches,\n            },\n        ];\n    }\n\n    const key = segments[0];\n    const rest = segments.slice(1);\n\n    if (\n        typeof data !== 'undefined' &&\n        data !== null &&\n        !isObject(data) &&\n        !Array.isArray(data)\n    ) {\n        if (key === Character.GLOBSTAR) {\n            if (!rest.length) {\n                // globstar leaves are always selected\n                return [\n                    {\n                        value: arrayToPath(currPath),\n                        matches: currMatches,\n                    },\n                ];\n            }\n\n            return [];\n        }\n\n        if (key === Character.WILDCARD) {\n            return [];\n        }\n\n        // value is a primitive, paths being traversed from here might be in their prototype,\n        // return the entire path\n        return [{ value: arrayToPath([...currPath, ...segments]), matches: currMatches }];\n    }\n\n    // Use a non-null value so that non-existing fields are still selected\n    data = data || {};\n\n    if (key === Character.WILDCARD) {\n        return Object.keys(data)\n            .flatMap((key) => expandPathVerboseInternal(\n                data[key],\n                arrayToPath(rest),\n                currPath.concat(key),\n                currMatches.concat(key),\n            ));\n    }\n\n    if (key === Character.GLOBSTAR) {\n        return Object.keys(data)\n            .flatMap((key) => {\n                const nextPath = currPath.concat(key);\n                const value = data[key];\n\n                // recursively find matching sub-paths & skip the first remaining segment, if it matches the current key\n                const children = expandPathVerboseInternal(value, arrayToPath(segments), nextPath, [key])\n                    .concat(rest[0] === key ? expandPathVerboseInternal(value, arrayToPath(rest.slice(1)), nextPath, []) : []);\n\n                const pathMatches : string[] = [];\n                const output : PathExpanded[] = [];\n                for (let i = 0; i < children.length; i++) {\n                    /* istanbul ignore next */\n                    if (pathMatches.indexOf(children[i].value) !== -1) {\n                        continue;\n                    }\n\n                    pathMatches.push(children[i].value);\n\n                    output.push({\n                        value: children[i].value,\n                        matches: children[i].matches.length > 0 ?\n                            [...currMatches, children[i].matches.flat()] :\n                            currMatches,\n                    });\n                }\n\n                return output;\n            });\n    }\n\n    return expandPathVerboseInternal(data[key], rest, currPath.concat(key), currMatches);\n}\n\n/**\n * Verbose expand wildcard and glob patterns.\n * Track wildcard/glob pattern matches.\n *\n * @param data\n * @param path\n */\nexport function expandPathVerbose(\n    data: Record<string, any>,\n    path: string | string[],\n): PathExpanded[] {\n    return expandPathVerboseInternal(data, path);\n}\n\n/**\n * Expand wildcard and glob patterns to paths.\n *\n * @param data\n * @param path\n */\nexport function expandPath(\n    data: Record<string, any>,\n    path: string | string[],\n): string[] {\n    return expandPathVerbose(data, path)\n        .map((el) => el.value);\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from '../helpers';\n\nexport function getPathValue(\n    data: unknown,\n    path: string | string[],\n): unknown {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let res : unknown | undefined;\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        if (temp === null || typeof temp === 'undefined') {\n            break;\n        }\n\n        if (parts[index] in Object(temp)) {\n            // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n            // @ts-expect-error\n            temp = temp[parts[index]];\n        } else {\n            break;\n        }\n\n        if (index === parts.length - 1) {\n            res = temp;\n        }\n\n        index++;\n    }\n\n    return res;\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { pathToArray } from '../helpers';\nimport { isObject } from '../utils';\n\nconst NUMBER_REGEX = /^\\d+$/;\n\nexport function setPathValue(\n    data: Record<string, any> | Record<string, any>[],\n    path: string | string[],\n    value: unknown,\n) {\n    const parts = Array.isArray(path) ?\n        path :\n        pathToArray(path);\n\n    let temp = data;\n    let index = 0;\n    while (index < parts.length) {\n        /* istanbul ignore next */\n        if (!Array.isArray(temp) && !isObject(temp)) {\n            break;\n        }\n\n        const key = parts[index] as keyof typeof temp;\n\n        // [foo, '0']\n        if (typeof temp[key] === 'undefined') {\n            const match = NUMBER_REGEX.test(key);\n            if (match) {\n                (temp as Record<string, any>)[key] = [];\n            } else {\n                temp[key] = {};\n            }\n        }\n\n        if (index === parts.length - 1) {\n            temp[key] = value;\n            break;\n        }\n\n        index++;\n        temp = temp[key];\n    }\n\n    return data;\n}\n","/*\n * Copyright (c) 2024-2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { getPathValue } from '../path-value/get';\nimport { pathToArray } from '../helpers';\n\nexport class PathInfo {\n    protected data: unknown;\n\n    protected pathParts: string[];\n\n    protected _value: unknown;\n\n    protected _parent: PathInfo | null | undefined;\n\n    protected _exists: boolean | undefined;\n\n    constructor(data: unknown, path: string | string[]) {\n        this.data = data;\n\n        if (Array.isArray(path)) {\n            this.pathParts = path;\n        } else {\n            this.pathParts = pathToArray(path);\n        }\n    }\n\n    get value() {\n        if (typeof this._value !== 'undefined') {\n            return this._value;\n        }\n\n        if (this.pathParts.length > 0) {\n            this._value = getPathValue(this.data, this.pathParts);\n        } else {\n            this._value = this.data;\n        }\n\n        return this._value;\n    }\n\n    get name() : string | null {\n        if (this.pathParts.length > 0) {\n            return this.pathParts[this.pathParts.length - 1];\n        }\n\n        return null;\n    }\n\n    get parent() : PathInfo | null {\n        if (typeof this._parent !== 'undefined') {\n            return this._parent;\n        }\n\n        if (this.pathParts.length === 0) {\n            this._parent = null;\n            return this._parent;\n        }\n\n        if (this.pathParts.length > 1) {\n            this._parent = new PathInfo(\n                this.data,\n                this.pathParts.slice(0, this.pathParts.length - 1),\n            );\n        } else {\n            this._parent = new PathInfo(this.data, []);\n        }\n\n        return this._parent;\n    }\n\n    get exists() : boolean {\n        if (typeof this._exists !== 'undefined') {\n            return this._exists;\n        }\n\n        if (!this.name || !this.parent) {\n            this._exists = true;\n            return this._exists;\n        }\n\n        if (\n            this.parent.value !== null &&\n            typeof this.parent.value !== 'undefined'\n        ) {\n            this._exists = this.name in Object(this.parent.value);\n        } else {\n            this._exists = false;\n        }\n\n        return this._exists;\n    }\n}\n","/*\n * Copyright (c) 2024.\n * Author Peter Placzek (tada5hi)\n * For the full copyright and license information,\n * view the LICENSE file that was distributed with this source code.\n */\n\nimport { PathInfo } from './module';\n\nexport function getPathInfo(\n    data: Record<string, any>,\n    path: string | string[],\n) : PathInfo {\n    return new PathInfo(data, path);\n}\n"],"names":["arrayToPath","parts","reduce","prev","segment","part","replace","test","BRACKET_NUMBER_REGEX","pathToArray","str","match","result","i","length","regex","exec","push","Character","isObject","input","Array","isArray","expandPathVerboseInternal","data","path","currPath","currMatches","segments","value","matches","key","rest","slice","GLOBSTAR","WILDCARD","Object","keys","flatMap","concat","nextPath","children","pathMatches","output","indexOf","flat","expandPathVerbose","expandPath","map","el","getPathValue","res","temp","index","NUMBER_REGEX","setPathValue","PathInfo","_value","pathParts","name","parent","_parent","exists","_exists","constructor","getPathInfo"],"mappings":"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"}

package/dist/path-expand/constants.d.ts

@@ -0,0 +1,4 @@
+export declare enum Character {
+    WILDCARD = "*",
+    GLOBSTAR = "**"
+}

package/dist/path-expand/index.d.ts

@@ -0,0 +1,2 @@
+export * from './module';
+export * from './types';

package/dist/path-expand/module.d.ts

@@ -0,0 +1,16 @@
+import type { PathExpanded } from './types';
+/**
+ * Verbose expand wildcard and glob patterns.
+ * Track wildcard/glob pattern matches.
+ *
+ * @param data
+ * @param path
+ */
+export declare function expandPathVerbose(data: Record<string, any>, path: string | string[]): PathExpanded[];
+/**
+ * Expand wildcard and glob patterns to paths.
+ *
+ * @param data
+ * @param path
+ */
+export declare function expandPath(data: Record<string, any>, path: string | string[]): string[];

package/dist/path-expand/types.d.ts

@@ -0,0 +1,4 @@
+export type PathExpanded = {
+    value: string;
+    matches: readonly (string | string[])[];
+};

package/dist/path-info/helper.d.ts

@@ -0,0 +1,2 @@
+import { PathInfo } from './module';
+export declare function getPathInfo(data: Record<string, any>, path: string | string[]): PathInfo;

package/dist/path-info/index.d.ts

@@ -0,0 +1,2 @@
+export * from './helper';
+export * from './module';

package/dist/{path-info.d.ts → path-info/module.d.ts}

@@ -1,11 +1,10 @@
 export declare class PathInfo {
     protected data: unknown;
-    protected path: string | undefined;
     protected pathParts: string[];
     protected _value: unknown;
     protected _parent: PathInfo | null | undefined;
     protected _exists: boolean | undefined;
-    constructor(data: unknown, path?: string);
+    constructor(data: unknown, path: string | string[]);
     get value(): unknown;
     get name(): string | null;
     get parent(): PathInfo | null;

package/dist/path-value/index.d.ts

@@ -0,0 +1,2 @@
+export * from './get';
+export * from './set';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pathtrace",
-    "version": "1.0.0-beta.1",
+    "version": "1.0.0",
     "description": "Simplifies working with nested objects and arrays by providing easy methods to retrieve, set, and check values at any path.",
     "exports": {
         "./package.json": "./package.json",
@@ -25,15 +25,14 @@
         "lint": "eslint --ext .js,.vue,.ts ./src ./test",
         "lint:fix": "npm run lint -- --fix"
     },
-    "bin": {
-        "authup": "dist/index.cjs"
-    },
     "keywords": [
-        "nested-objects",
         "path",
-        "path-retrival",
-        "javascript",
         "path-info",
+        "path-value",
+        "expand-path",
+        "path-retrival",
+        "get-path",
+        "nested-objects",
         "deep-access"
     ],
     "author": {
@@ -41,7 +40,7 @@
         "email": "contact@tada5hi.net",
         "url": "https://github.com/tada5hi"
     },
-    "license": "Apache-2.0",
+    "license": "MIT",
     "repository": {
         "type": "git",
         "url": "git+https://github.com/tada5hi/pathtrace.git"
@@ -54,18 +53,18 @@
         "@rollup/plugin-node-resolve": "^15.2.3",
         "@rollup/plugin-swc": "^0.3.1",
         "@swc/jest": "^0.2.36",
-        "@tada5hi/commitlint-config": "^1.2.1",
-        "@tada5hi/eslint-config-typescript": "^1.2.11",
+        "@tada5hi/commitlint-config": "^1.2.2",
+        "@tada5hi/eslint-config-typescript": "^1.2.12",
         "@tada5hi/semantic-release": "^0.3.1",
         "@tada5hi/tsconfig": "^0.5.1",
         "@types/jest": "^29.5.12",
-        "@types/node": "^22.5.0",
+        "@types/node": "^22.5.2",
         "@types/pathval": "^1.1.2",
         "cross-env": "^7.0.3",
         "eslint": "^8.37.0",
         "husky": "^9.0.11",
         "jest": "^29.7.0",
-        "rollup": "^4.21.1",
+        "rollup": "^4.21.2",
         "semantic-release": "^22.0.12",
         "ts-jest": "^29.2.5",
         "typescript": "^5.5.4"

package/dist/get-path-info.d.ts

@@ -1,2 +0,0 @@
-import { PathInfo } from './path-info';
-export declare function getPathInfo(data: Record<string, any>, path?: string): PathInfo;