Add parsePath()

src/config/normalize/lib/wild_wild_path/main.js

@@ -7,6 +7,6 @@ export {
   isParentPath,
 } from './parsing/compare.js'
 export { serialize } from './parsing/serialize.js'
-export { parse } from './parsing/parse.js'
+export { parse, parsePath } from './parsing/parse.js'
 export { remove } from './remove.js'
 export { set } from './set.js'

src/config/normalize/lib/wild_wild_path/parsing/normalize.js

@@ -8,6 +8,17 @@ export const isQueryString = function (query) {
   return typeof query === 'string'
 }
 
+// Transform a queryArrays into a path, if possible
+export const normalizePath = function (queryArrays) {
+  if (queryArrays.length !== 1) {
+    throwQueryArraysError(queryArrays, 'It must not be a union.')
+  }
+
+  const [queryArray] = queryArrays
+  validatePath(queryArray)
+  return queryArray
+}
+
 // Paths are a subset of query arrays which use:
 //  - No unions
 //  - Only prop tokens, and array tokens (positive only)

src/config/normalize/lib/wild_wild_path/parsing/parse.js

@@ -1,4 +1,8 @@
-import { normalizeQueryArrays, isQueryString } from './normalize.js'
+import {
+  normalizeQueryArrays,
+  isQueryString,
+  normalizePath,
+} from './normalize.js'
 import { parseQueryString } from './query.js'
 
 // Parse a query string into an array of tokens.
@@ -77,6 +81,11 @@ import { parseQueryString } from './query.js'
 // Exceptions are thrown on syntax errors:
 //  - I.e. query or path syntax errors, or wrong arguments
 //  - But queries matching nothing do not throw: instead they return nothing
+export const parsePath = function (query) {
+  const queryArrays = parse(query)
+  return normalizePath(queryArrays)
+}
+
 export const parse = function (query) {
   return isQueryString(query)
     ? safeParseQueryString(query)