quetch 0.30.0 → 0.31.0

package/doc/type-aliases/IntrinsicFilter.md

@@ -16,4 +16,4 @@ Filter that does not rely on query settings, and thus can be evaluated directly
 
 ## Defined in
 
-[lib/types/IntrinsicFilter.ts:6](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/IntrinsicFilter.ts#L6)
+[lib/types/IntrinsicFilter.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/IntrinsicFilter.ts#L6)

package/doc/type-aliases/Item.md

@@ -18,4 +18,4 @@ Returns the inferred item type of an array, or an alternative type if it is some
 
 ## Defined in
 
-[lib/types/Item.ts:4](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Item.ts#L4)
+[lib/types/Item.ts:4](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Item.ts#L4)

package/doc/type-aliases/Join.md

@@ -16,4 +16,4 @@
 
 ## Defined in
 
-[lib/types/Join.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Join.ts#L1)
+[lib/types/Join.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Join.ts#L1)

package/doc/type-aliases/Key.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/types/Key.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Key.ts#L1)
+[lib/types/Key.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Key.ts#L1)

package/doc/type-aliases/KeyFiltered.md

@@ -6,7 +6,7 @@
 
 # Type Alias: KeyFiltered\<T, P\>
 
-> **KeyFiltered**\<`T`, `P`\>: [`0`] *extends* [`1` & `T`] ? [`Key`](Key.md) \| `SymbolSelf` : `T` *extends* `string` \| `number` \| `boolean` \| `bigint` \| `symbol` ? `T` *extends* `P` ? `SymbolSelf` : `never` : `T` *extends* `object` ? keyof `{ [K in keyof T as Extract<T[K], P> extends never ? never : K]-?: T[K] }` : `never`
+> **KeyFiltered**\<`T`, `P`\>: [`unknown`] *extends* [`T`] ? [`Key`](Key.md) \| `SymbolSelf` : [`0`] *extends* [`1` & `T`] ? [`Key`](Key.md) \| `SymbolSelf` : `T` *extends* `string` \| `number` \| `boolean` \| `bigint` \| `symbol` ? `T` *extends* `P` ? `SymbolSelf` : `never` : `T` *extends* `object` ? keyof `{ [K in keyof T as Extract<T[K], P> extends never ? never : K]-?: T[K] }` : `never`
 
 Returns union of keys whose mapped value extend the provided `P` type.
 
@@ -18,4 +18,4 @@ Returns union of keys whose mapped value extend the provided `P` type.
 
 ## Defined in
 
-[lib/types/KeyFiltered.ts:10](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/KeyFiltered.ts#L10)
+[lib/types/KeyFiltered.ts:10](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/KeyFiltered.ts#L10)

package/doc/type-aliases/KeyFromUnion.md

@@ -14,4 +14,4 @@
 
 ## Defined in
 
-[lib/types/KeyFromUnion.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/KeyFromUnion.ts#L1)
+[lib/types/KeyFromUnion.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/KeyFromUnion.ts#L1)

package/doc/type-aliases/Locale.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/types/Locale.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Locale.ts#L1)
+[lib/types/Locale.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Locale.ts#L1)

package/doc/type-aliases/NextHandler.md

@@ -28,4 +28,4 @@ Handles an `input` query and returns an `output` promise.
 
 ## Defined in
 
-[lib/types/NextHandler.ts:4](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/NextHandler.ts#L4)
+[lib/types/NextHandler.ts:4](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/NextHandler.ts#L4)

package/doc/type-aliases/NormalizedPathFieldSettings.md

@@ -0,0 +1,57 @@
+[**quetch**](../README.md)
+
+***
+
+[quetch](../README.md) / NormalizedPathFieldSettings
+
+# Type Alias: NormalizedPathFieldSettings\<T\>
+
+> **NormalizedPathFieldSettings**\<`T`\>: `object`
+
+Settings for fields that contain path values of items, used for displaying items in a tree.
+
+## Type Parameters
+
+• **T**
+
+## Type declaration
+
+### pathField?
+
+> `optional` **pathField**: [`FieldFiltered`](FieldFiltered.md)\<`T`, `string`\>
+
+Path to the field that contains the path value of an item, used for displaying items in a tree.
+
+#### Default
+
+```ts
+"path"
+```
+
+### pathFieldSeparator?
+
+> `optional` **pathFieldSeparator**: `string`
+
+Maps path fields to a string used to separate the path nodes of a field value.
+
+#### Default
+
+```ts
+"/"
+```
+
+### pathFieldSeparatorEscape?
+
+> `optional` **pathFieldSeparatorEscape**: `string`
+
+String used to escape the separator.
+
+#### Default
+
+```ts
+"\\"
+```
+
+## Defined in
+
+[lib/types/NormalizedPathFieldSettings.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/NormalizedPathFieldSettings.ts#L6)

package/doc/type-aliases/Order.md

@@ -16,4 +16,4 @@ Order item.
 
 ## Defined in
 
-[lib/types/Order.ts:6](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Order.ts#L6)
+[lib/types/Order.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Order.ts#L6)

package/doc/type-aliases/OrderNormalized.md

@@ -24,4 +24,4 @@
 
 ## Defined in
 
-[lib/types/OrderNormalized.ts:3](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/OrderNormalized.ts#L3)
+[lib/types/OrderNormalized.ts:3](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/OrderNormalized.ts#L3)

package/doc/type-aliases/Parameters.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/types/Parameters.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Parameters.ts#L1)
+[lib/types/Parameters.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Parameters.ts#L1)

package/doc/type-aliases/Path.md

@@ -6,14 +6,14 @@
 
 # Type Alias: Path\<T, D\>
 
-> **Path**\<`T`, `D`\>: [`0`] *extends* [`1` & `T`] ? readonly ([`Key`](Key.md) \| `never`)[] : `D` *extends* `-1` ? `never` : `T` *extends* [`Primitive`](Primitive.md) ? readonly `never`[] : `T` *extends* infer P[] ? readonly [`number`] \| readonly [`number`, `...Path<P, Increment<D>>`] : `T` *extends* `object` ? \{ \[K in keyof T\]: readonly \[K\] \| readonly \[K, ...(...)\] \}\[keyof `T`\] : `never`
+> **Path**\<`T`, `D`\>: [`unknown`] *extends* [`T`] ? readonly ([`Key`](Key.md) \| `never`)[] : [`0`] *extends* [`1` & `T`] ? readonly ([`Key`](Key.md) \| `never`)[] : `D` *extends* `-1` ? `never` : `T` *extends* [`Primitive`](Primitive.md) ? readonly `never`[] : `T` *extends* infer P[] ? readonly [`number`] \| readonly [`number`, `...Path<P, Decrement<(...)>>`] : `T` *extends* `object` ? \{ \[K in keyof T\]: readonly \[(...)\] \| readonly \[(...), (...)\] \}\[keyof `T`\] : `never`
 
 ## Type Parameters
 
 • **T**
 
-• **D** = `7`
+• **D** = [`DepthLimit`](DepthLimit.md)
 
 ## Defined in
 
-[lib/types/Path.ts:5](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Path.ts#L5)
+[lib/types/Path.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Path.ts#L6)

package/doc/type-aliases/PathFiltered.md

@@ -6,7 +6,7 @@
 
 # Type Alias: PathFiltered\<T, P, D\>
 
-> **PathFiltered**\<`T`, `P`, `D`\>: [`0`] *extends* [`1` & `T`] ? readonly ([`Key`](Key.md) \| `never`)[] : `D` *extends* `-1` ? `never` : `T` *extends* `P` ? readonly `never`[] : `T` *extends* `ReadonlyArray`\<infer I\> ? `Extract`\<`I`, `P`\> *extends* `never` ? readonly [`number`, `...PathFiltered<I, P, Increment<D>>`] : readonly [`number`] : `T` *extends* `object` ? `{ [K in keyof T]: Extract<T[K], P> extends never ? readonly [K, ...(...)] : readonly [K] }`\[keyof `T`\] : `never`
+> **PathFiltered**\<`T`, `P`, `D`\>: [`unknown`] *extends* [`T`] ? readonly ([`Key`](Key.md) \| `never`)[] : [`0`] *extends* [`1` & `T`] ? readonly ([`Key`](Key.md) \| `never`)[] : `D` *extends* `-1` ? `never` : `T` *extends* `P` ? readonly `never`[] : `T` *extends* `ReadonlyArray`\<infer I\> ? `Extract`\<`I`, `P`\> *extends* `never` ? readonly [`number`, `...PathFiltered<I, P, Decrement<(...)>>`] : readonly [`number`] : `T` *extends* `object` ? `{ [K in keyof T]: Extract<(...)[(...)], P> extends never ? readonly [(...), (...)] : readonly [(...)] }`\[keyof `T`\] : `never`
 
 ## Type Parameters
 
@@ -14,8 +14,8 @@
 
 • **P**
 
-• **D** = `7`
+• **D** = [`DepthLimit`](DepthLimit.md)
 
 ## Defined in
 
-[lib/types/PathFiltered.ts:4](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/PathFiltered.ts#L4)
+[lib/types/PathFiltered.ts:5](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/PathFiltered.ts#L5)

package/doc/type-aliases/Primitive.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/types/Primitive.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Primitive.ts#L1)
+[lib/types/Primitive.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Primitive.ts#L1)

package/doc/type-aliases/PrimitiveObject.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/types/PrimitiveObject.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/PrimitiveObject.ts#L1)
+[lib/types/PrimitiveObject.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/PrimitiveObject.ts#L1)

package/doc/type-aliases/Query.md

@@ -16,4 +16,4 @@ Query that fetches or mutates an entity.
 
 ## Defined in
 
-[lib/types/Query.ts:14](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Query.ts#L14)
+[lib/types/Query.ts:14](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Query.ts#L14)

package/doc/type-aliases/QueryAggregate.md

@@ -68,4 +68,4 @@ Query settings.
 
 ## Defined in
 
-[lib/types/QueryAggregate.ts:11](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryAggregate.ts#L11)
+[lib/types/QueryAggregate.ts:11](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryAggregate.ts#L11)

package/doc/type-aliases/QueryCreate.md

@@ -50,4 +50,4 @@ Value properties of the item to create.
 
 ## Defined in
 
-[lib/types/QueryCreate.ts:8](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryCreate.ts#L8)
+[lib/types/QueryCreate.ts:8](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryCreate.ts#L8)

package/doc/type-aliases/QueryCreateMultiple.md

@@ -48,4 +48,4 @@ Query settings.
 
 ## Defined in
 
-[lib/types/QueryCreateMultiple.ts:8](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryCreateMultiple.ts#L8)
+[lib/types/QueryCreateMultiple.ts:8](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryCreateMultiple.ts#L8)

package/doc/type-aliases/QueryDelete.md

@@ -60,4 +60,4 @@ Query settings.
 
 ## Defined in
 
-[lib/types/QueryDelete.ts:9](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryDelete.ts#L9)
+[lib/types/QueryDelete.ts:9](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryDelete.ts#L9)

package/doc/type-aliases/QueryDeleteMultiple.md

@@ -62,4 +62,4 @@ Query settings.
 
 ## Defined in
 
-[lib/types/QueryDeleteMultiple.ts:9](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryDeleteMultiple.ts#L9)
+[lib/types/QueryDeleteMultiple.ts:9](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryDeleteMultiple.ts#L9)

package/doc/type-aliases/QueryMethod.md

@@ -12,4 +12,4 @@ Available query methods.
 
 ## Defined in
 
-[lib/types/QueryMethod.ts:6](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryMethod.ts#L6)
+[lib/types/QueryMethod.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryMethod.ts#L6)

package/doc/type-aliases/QueryRead.md

@@ -76,4 +76,4 @@ Query settings.
 
 ## Defined in
 
-[lib/types/QueryRead.ts:10](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryRead.ts#L10)
+[lib/types/QueryRead.ts:10](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryRead.ts#L10)

package/doc/type-aliases/QueryReadMultiple.md

@@ -80,4 +80,4 @@ Query settings.
 
 ## Defined in
 
-[lib/types/QueryReadMultiple.ts:11](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryReadMultiple.ts#L11)
+[lib/types/QueryReadMultiple.ts:11](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryReadMultiple.ts#L11)

package/doc/type-aliases/QuerySettings.md

@@ -22,62 +22,68 @@ Settings to use when doing a query.
 
 Abort controller to abort the query.
 
-### pathField?
-
-> `optional` **pathField**: [`FieldFiltered`](FieldFiltered.md)\<`T`, `string`\>
+### signal?
 
-Path to the field that contains the path value of an item, used for displaying items in a tree.
+> `optional` **signal**: `AbortSignal`
 
-### pathFieldSeparator?
+Abort signal to abort the query.
 
-> `optional` **pathFieldSeparator**: `string`
+### transformFilterChildren()?
 
-Maps path fields to a string used to separate the path nodes of a field value.
+> `optional` **transformFilterChildren**: (`filter`) => [`IntrinsicFilter`](IntrinsicFilter.md)\<`T`\>
 
-#### Default
+Returns a filter that captures the items expressed by the provided `FilterChildren`. The return filter cannot use filters of type `FilterChildren` or `FilterContext`.
 
-```ts
-"/"
-```
+#### Parameters
 
-### pathFieldSeparatorEscape?
+##### filter
 
-> `optional` **pathFieldSeparatorEscape**: `string`
+[`FilterChildren`](FilterChildren.md)\<`T`\>
 
-String used to escape the separator.
+The provided `FilterChildren` to express.
 
-#### Default
+#### Returns
 
-```ts
-"\\"
-```
+[`IntrinsicFilter`](IntrinsicFilter.md)\<`T`\>
 
-### signal?
+A filter that captures the items expressed by the provided `FilterChildren`.
 
-> `optional` **signal**: `AbortSignal`
+### compareFieldValues()?
 
-Abort signal to abort the query.
+Compares two values of a field for sorting purposes. If not provided, values are compared using the default comparison operators (`>`, `<`, `===`).
 
-### transformFilterChildren()?
+This function is called only when both `a` and `b` are defined and different. If it returns `undefined`, the default comparison operators are used as a fallback.
 
-> `optional` **transformFilterChildren**: (`filter`) => [`IntrinsicFilter`](IntrinsicFilter.md)\<`T`\>
+#### Type Parameters
 
-Returns a filter that captures the items expressed by the provided `FilterChildren`. The return filter cannot use filters of type `FilterChildren` or `FilterContext`.
+• **T**
 
 #### Parameters
 
-##### filter
+##### field
 
-[`FilterChildren`](FilterChildren.md)\<`T`\>
+[`Field`](Field.md)\<`T`\>
 
-The provided `FilterChildren` to express.
+The field for which the values are compared.
+
+##### a
+
+`any`
+
+The first value to compare.
+
+##### b
+
+`any`
+
+The second value to compare.
 
 #### Returns
 
-[`IntrinsicFilter`](IntrinsicFilter.md)\<`T`\>
+`undefined` \| `0` \| `1` \| `-1`
 
-A filter that captures the items expressed by the provided `FilterChildren`.
+`-1` if `a` should be sorted before `b`, `1` if `a` should be sorted after `b`, `0` if they are considered equal, or `undefined` to use the default comparison operators.
 
 ## Defined in
 
-[lib/types/QuerySettings.ts:8](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QuerySettings.ts#L8)
+[lib/types/QuerySettings.ts:8](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QuerySettings.ts#L8)

package/doc/type-aliases/QueryUpdate.md

@@ -68,4 +68,4 @@ Partial property values to update.
 
 ## Defined in
 
-[lib/types/QueryUpdate.ts:9](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryUpdate.ts#L9)
+[lib/types/QueryUpdate.ts:9](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryUpdate.ts#L9)

package/doc/type-aliases/QueryUpdateMultiple.md

@@ -74,4 +74,4 @@ Partial property values to update.
 
 ## Defined in
 
-[lib/types/QueryUpdateMultiple.ts:10](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/QueryUpdateMultiple.ts#L10)
+[lib/types/QueryUpdateMultiple.ts:10](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/QueryUpdateMultiple.ts#L10)

package/doc/type-aliases/Result.md

@@ -16,4 +16,4 @@
 
 ## Defined in
 
-[lib/types/Result.ts:20](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Result.ts#L20)
+[lib/types/Result.ts:20](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Result.ts#L20)

package/doc/type-aliases/Store.md

@@ -68,4 +68,4 @@
 
 ## Defined in
 
-[lib/types/Store.ts:2](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Store.ts#L2)
+[lib/types/Store.ts:2](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Store.ts#L2)

package/doc/type-aliases/Value.md

@@ -36,4 +36,4 @@ Path leading to the value.
 
 ## Defined in
 
-[lib/types/Value.ts:6](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/Value.ts#L6)
+[lib/types/Value.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/Value.ts#L6)

package/doc/type-aliases/ValueMap.md

@@ -18,4 +18,4 @@ Maps the properties of the provided value `T` to a specific value `V`.
 
 ## Defined in
 
-[lib/types/ValueMap.ts:6](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/types/ValueMap.ts#L6)
+[lib/types/ValueMap.ts:6](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/types/ValueMap.ts#L6)

package/doc/variables/CACHE.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/constants/CACHE.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/constants/CACHE.ts#L1)
+[lib/constants/CACHE.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/constants/CACHE.ts#L1)

package/doc/variables/FILTER_ANY.md

@@ -16,4 +16,4 @@
 
 ## Defined in
 
-[lib/constants/FILTER\_ANY.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/constants/FILTER_ANY.ts#L1)
+[lib/constants/FILTER\_ANY.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/constants/FILTER_ANY.ts#L1)

package/doc/variables/FILTER_NONE.md

@@ -16,4 +16,4 @@
 
 ## Defined in
 
-[lib/constants/FILTER\_NONE.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/constants/FILTER_NONE.ts#L1)
+[lib/constants/FILTER\_NONE.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/constants/FILTER_NONE.ts#L1)

package/doc/variables/SELF.md

@@ -10,4 +10,4 @@
 
 ## Defined in
 
-[lib/constants/SELF.ts:1](https://github.com/nevoland/quetch/blob/94f546831241bf41f83cf97787b7e923c8cf7824/lib/constants/SELF.ts#L1)
+[lib/constants/SELF.ts:1](https://github.com/nevoland/quetch/blob/1cf615b166541d2a753e34c0a2dd4a9474026d7a/lib/constants/SELF.ts#L1)

package/lib/tools/comparatorFieldValues.ts

@@ -0,0 +1,46 @@
+import { EMPTY_OBJECT } from "unchangeable";
+
+import type {
+  FieldFiltered,
+  NormalizedPathFieldSettings,
+  QuerySettings,
+} from "../types";
+
+import { escapeRegex } from "./escapeRegex.js";
+import { sameField } from "./sameField.js";
+
+/**
+ * Returns a function that transforms a `FilterChildren` into a `FilterStringMatch`.
+ *
+ * @param options - Options for the transformer.
+ * @returns A function that takes a `FilterChildren` and returns a `FilterStringMatch` that matches the paths of the children of the item specified in the `FilterChildren`.
+ */
+export function comparatorFieldValues<T>({
+  pathField = "path" as FieldFiltered<T, string>,
+  pathFieldSeparator = "/",
+  pathFieldSeparatorEscape = "\\",
+}: NormalizedPathFieldSettings<T> = EMPTY_OBJECT): QuerySettings<T>["compareFieldValues"] {
+  const fieldSeparatorRegexp = new RegExp(
+    !pathFieldSeparatorEscape
+      ? escapeRegex(pathFieldSeparator)
+      : `(?<!${escapeRegex(pathFieldSeparatorEscape)})${escapeRegex(pathFieldSeparator)}`,
+    "g",
+  );
+  return (field, a, b) => {
+    if (!sameField(field, pathField)) {
+      return undefined;
+    }
+    const normalizedA = (a as string).replaceAll?.(
+      fieldSeparatorRegexp,
+      "\x00",
+    );
+    const normalizedB = (b as string).replaceAll?.(
+      fieldSeparatorRegexp,
+      "\x00",
+    );
+    if (normalizedA > normalizedB) {
+      return 1;
+    }
+    return -1;
+  };
+}

package/lib/tools/get.ts

@@ -1,5 +1,7 @@
 import { SELF } from "../constants/SELF.js";
-import type { Get, Path } from "../types";
+import type { Field, Get } from "../types";
+
+const { isArray } = Array;
 
 /**
  * Gets the property value of the given `value` at the specified `path` (an array of object property names or array indexes).
@@ -7,11 +9,11 @@ import type { Get, Path } from "../types";
  * If the `path` is a string, it is considered as a path with one item.
  * If the `path` leads to an unknown property, returns `undefined`.
  *
- * @param value The value from which to get the property value.
- * @param path The path leading to the property value or a property name or `undefined`.
+ * @param value - The value from which to get the property value.
+ * @param path - The path leading to the property value or a property name or `undefined`.
  * @returns The property value found at the given path, or `undefined` if it cannot be found.
  */
-export function get<const T, const P extends Path<T> | keyof T>(
+export function get<const T, const P extends Field<T>>(
   value: T,
   path?: P,
 ): Get<T, P> {
@@ -24,6 +26,9 @@ export function get<const T, const P extends Path<T> | keyof T>(
     case "symbol":
       return (value as any)?.[path];
     default: {
+      if (!isArray(path)) {
+        return value as any;
+      }
       switch (path.length as number) {
         case 0:
           return value as any;

package/lib/tools/querySettings.ts

@@ -0,0 +1,20 @@
+import { EMPTY_OBJECT } from "unchangeable";
+
+import type { NormalizedPathFieldSettings, QuerySettings } from "../types";
+
+import { comparatorFieldValues } from "./comparatorFieldValues.js";
+import { transformerFilterChildren } from "./transformerFilterChildren.js";
+/**
+ * Returns query settings for path fields.
+ *
+ * @param settings - Settings for normalizing path fields.
+ * @returns Query settings for path fields.
+ */
+export function querySettings<T>(
+  settings: NormalizedPathFieldSettings<T> = EMPTY_OBJECT,
+): QuerySettings<T> {
+  return {
+    compareFieldValues: comparatorFieldValues(settings),
+    transformFilterChildren: transformerFilterChildren(settings),
+  };
+}

package/lib/tools/sortItemList.test.ts

@@ -1,5 +1,6 @@
 import { expect, test } from "vitest";
 
+import { querySettings } from "./querySettings.js";
 import { sortItemList } from "./sortItemList.js";
 
 test("sorts items", () => {
@@ -76,10 +77,7 @@ test("sorts items with separator setting", () => {
         { path: "a\\/b.c" },
         { path: "a.b/c" },
       ],
-      {
-        pathField: "path",
-        pathFieldSeparator: "/",
-      },
+      querySettings(),
     ),
   ).toEqual([
     { path: "a" },
@@ -104,10 +102,7 @@ test("sorts items with separator setting", () => {
         { path: "a\\/b.c" },
         { path: "a.b/c" },
       ],
-      {
-        pathField: "path",
-        pathFieldSeparator: "/",
-      },
+      querySettings(),
     ),
   ).toEqual([
     { path: "a" },
@@ -119,4 +114,32 @@ test("sorts items with separator setting", () => {
     { path: "a.b.c" },
     { path: "a\\/b.c" },
   ]);
+
+  expect(
+    sortItemList(
+      [{ descending: false, field: "path" }],
+      [
+        { path: "a" },
+        { path: "a/b" },
+        { path: "a.b" },
+        { path: "a/b/c" },
+        { path: "a.b.c" },
+        { path: "a/b.c" },
+        { path: "a\\.b.c" },
+        { path: "a.b/c" },
+      ],
+      querySettings({
+        pathFieldSeparator: ".",
+      }),
+    ),
+  ).toEqual([
+    { path: "a" },
+    { path: "a.b" },
+    { path: "a.b.c" },
+    { path: "a.b/c" },
+    { path: "a/b" },
+    { path: "a/b.c" },
+    { path: "a/b/c" },
+    { path: "a\\.b.c" },
+  ]);
 });