@itwin/presentation-shared 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @itwin/presentation-shared
 
+## 0.5.0
+
+### Minor Changes
+
+- [#703](https://github.com/iTwin/presentation/pull/703): **BREAKING:** Removed the option to specify value + ECProperty identifier when creating a `ConcatenatedValue`.
+
+  The change provides two benefits:
+
+  1. Access to schema is not required to format `ConcatenatedValue` parts as they already contain all the necessary metadata required for formatting the value. This is a step towards supporting multiple data sources, where schema information might be not available during formatting.
+  2. Previously, the property type information had to be extracted for every row in the result set, which was inefficient. Now, the type information is extracted only once, when creating an ECSql query.
+
+  Full list of changes:
+
+  - `ConcatenatedValuePart.isProperty` - removed, as the "property" type was removed from the type union.
+  - `ECSql.createConcatenatedValueJsonSelector` and `ECSql.createConcatenatedValueStringSelector` don't accept an option to specify value + ECProperty identifier as a selector argument anymore. Instead, the option that specifies value selector + type information should be used. The latter kind of selector can be created using the newly added `ECSql.createPrimitivePropertyValueSelectorProps` function (see below).
+  - Added `ECSql.createPrimitivePropertyValueSelectorProps` function to help create a selector that specifies a value selector + type information. See README for more details.
+  - The change allows formatting `ConcatenatedValue` parts without the need to access schema information, so `formatConcatenatedValue` function now doesn't require a `schemaProvider` prop.
+
+  Mitigation example:
+
+  _Before:_
+
+  ```ts
+  const selector: ECSql.createConcatenatedValueJsonSelector([
+    { type: "String", value: "[" },
+    { propertyClassName: "MySchema.MyClass", propertyClassAlias: "this", propertyName: "PropX" },
+    { type: "String", value: "]" },
+  ]);
+  ```
+
+  _After:_
+
+  ```ts
+  const selector: ECSql.createConcatenatedValueJsonSelector([
+    { type: "String", value: "[" },
+    await ECSql.createPrimitivePropertyValueSelectorProps({ schemaProvider, propertyClassName: "MySchema.MyClass", propertyClassAlias: "this", propertyName: "PropX" }),
+    { type: "String", value: "]" },
+  ]);
+  ```
+
+### Patch Changes
+
+- [#703](https://github.com/iTwin/presentation/pull/703): Fix `ECSql.createConcatenatedValueStringSelector` not casting property value to string. This could cause ECSQL query execution to fail when more than one selector is used.
+
+## 0.4.1
+
+### Patch Changes
+
+- [#695](https://github.com/iTwin/presentation/pull/695): Bump `iTwin.js` core package dependency versions to `4.8.0`
+
 ## 0.4.0
 
 ### Minor Changes

package/README.md

@@ -139,6 +139,28 @@ The ECSql utilities group contains a number of functions to help create complex
   // result = "'STRING VALUE'"
   ```
 
+- `createPrimitivePropertyValueSelectorProps` - creates `TypedValueSelectClauseProps` for selecting a primitive property value, while also
+  accounting for the property type. The created props may be used when creating `ConcatenatedValue` selectors (see `createConcatenatedValueJsonSelector`
+  and `createConcatenatedValueStringSelector`).
+
+  Example usage:
+
+  ```ts
+  import { ECSql } from "@itwin/presentation-shared";
+
+  const categoryRankSelectorProps = ECSql.createPrimitivePropertyValueSelectorProps({
+    schemaProvider,
+    propertyClassAlias: "x",
+    propertyClassName: "BisCore.Category",
+    propertyName: "Rank",
+  });
+  // categoryRankSelectorProps = { selector: "[x].[Rank]", type: "Integer" }
+
+  // Now we can use the result to create a `ConcatenatedValue` selector:
+  const selector = ECSql.createConcatenatedValueJsonSelector(["Rank: ", categoryRankSelectorProps]);
+  // selector = `json_array('Rank: ', json_object('selector', '[x].[Rank]', 'type', 'Integer'))`
+  ```
+
 - `createInstanceKeySelector` - creates an ECSQL selector for a serialized `InstanceKey` JSON object.
 
   Example usage:
@@ -158,12 +180,7 @@ The ECSql utilities group contains a number of functions to help create complex
 
   const selector = ECSql.createConcatenatedValueJsonSelector([
     {
-      propertyClassName: "MySchema.MyClass",
-      propertyClassAlias: "my_class",
-      propertyName: "MyProperty",
-    },
-    {
-      selector: "my_class.MyOtherProperty",
+      selector: "my_class.MyProperty",
     },
     {
       value: 123.456,
@@ -171,12 +188,7 @@ The ECSql utilities group contains a number of functions to help create complex
     },
   ]);
   // selector = `json_array(
-  //     json_object(
-  //         'className', 'MySchema.MyClass',
-  //         'propertyName', 'MyProperty',
-  //         'value', [my_class].[MyProperty]
-  //     ),
-  //     my_class.MyOtherProperty,
+  //     my_class.MyProperty,
   //     json_object(
   //         'value', 123.456,
   //         'type', 'Double'
@@ -205,19 +217,14 @@ The ECSql utilities group contains a number of functions to help create complex
 
   const selector = ECSql.createConcatenatedValueStringSelector([
     {
-      propertyClassName: "MySchema.MyClass",
-      propertyClassAlias: "my_class",
-      propertyName: "MyProperty",
-    },
-    {
-      selector: "my_class.MyOtherProperty",
+      selector: "my_class.MyProperty",
     },
     {
       value: 123.456,
       type: "Double",
     },
   ]);
-  // selector = `[my_class].[MyProperty] || my_class.MyOtherProperty || 123.456`
+  // selector = `CAST(my_class.MyProperty AS TEXT) || '123.456'`
 
   const queryReader = queryExecutor.createQueryReader(
     {
@@ -274,11 +281,10 @@ The APIs in Values group contain various value types and utilities to work with
 
   - `create` - given a `PrimitiveValue`, its type and, optionally, extra information, validates the input and creates a `TypedPrimitiveValue`.
 
-- `ConcatenatedValuePart` - a union of different types that may be used to create a single, combined value: primitive ECInstance property value, hardcoded primitive value or just plain string. Also, a namespace, containing the following utilities:
+- `ConcatenatedValuePart` - a union of different types that may be used to create a single, combined value: nested `ConcatenatedValue`, `TypedPrimitiveValue` or just plain string. Also, a namespace, containing the following utilities:
 
   - `isString` - type guard to check if the given `ConcatenatedValuePart` is a `string`.
   - `isPrimitive` - type guard to check if the given `ConcatenatedValuePart` is a `TypedPrimitiveValue`.
-  - `isProperty` - type guard to check if the given `ConcatenatedValuePart` describes a primitive property value.
 
 - `ConcatenatedValue` - an array of `ConcatenatedValuePart`. Also, a namespace containing the following utilities:
 

package/lib/cjs/shared/ConcatenatedValue.d.ts

@@ -1,9 +1,7 @@
-import { PrimitivePropertyValue, TypedPrimitiveValue } from "./Values";
+import { TypedPrimitiveValue } from "./Values";
 /**
  * A part of a `ConcatenatedValue`, describing one piece of the value. Possible types:
  * - `ConcatenatedValue` describes a nested concatenated value.
- * - `PrimitivePropertyValue` describes an ECProperty value. Generally the value is formatted according to
- *   property metadata before concatenating with other parts.
  * - `TypedPrimitiveValue` describes a value with its type. Generally the value is formatted
  *   according to its type information before concatenating with other parts.
  * - `string` is just concatenated to other parts as-is.
@@ -11,7 +9,7 @@ import { PrimitivePropertyValue, TypedPrimitiveValue } from "./Values";
  * @see `ConcatenatedValue`
  * @beta
  */
-export type ConcatenatedValuePart = ConcatenatedValue | PrimitivePropertyValue | TypedPrimitiveValue | string;
+export type ConcatenatedValuePart = ConcatenatedValue | TypedPrimitiveValue | string;
 /** @beta */
 export declare namespace ConcatenatedValuePart {
     /** @beta */
@@ -19,8 +17,6 @@ export declare namespace ConcatenatedValuePart {
     /** @beta */
     function isPrimitive(part: ConcatenatedValuePart): part is TypedPrimitiveValue;
     /** @beta */
-    function isProperty(part: ConcatenatedValuePart): part is PrimitivePropertyValue;
-    /** @beta */
     function isConcatenatedValue(part: ConcatenatedValuePart): part is ConcatenatedValue;
 }
 /**

package/lib/cjs/shared/ConcatenatedValue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConcatenatedValue.d.ts","sourceRoot":"","sources":["../../../src/shared/ConcatenatedValue.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAE9G,YAAY;AAEZ,yBAAiB,qBAAqB,CAAC;IACrC,YAAY;IACZ,SAAgB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,MAAM,CAEpE;IAED,YAAY;IACZ,SAAgB,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,mBAAmB,CAEpF;IAED,YAAY;IACZ,SAAgB,UAAU,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,sBAAsB,CAGtF;IAED,YAAY;IACZ,SAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,iBAAiB,CAE1F;CACF;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,EAAE,CAAC;AAExD,YAAY;AAEZ,yBAAiB,iBAAiB,CAAC;IACjC;;;;;OAKG;IACH,SAAsB,SAAS,CAAC,KAAK,EAAE;QACrC,yBAAyB;QACzB,KAAK,EAAE,iBAAiB,CAAC;QACzB,qDAAqD;QACrD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5F,6EAA6E;QAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;CACF"}
+{"version":3,"file":"ConcatenatedValue.d.ts","sourceRoot":"","sources":["../../../src/shared/ConcatenatedValue.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAErF,YAAY;AAEZ,yBAAiB,qBAAqB,CAAC;IACrC,YAAY;IACZ,SAAgB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,MAAM,CAEpE;IAED,YAAY;IACZ,SAAgB,WAAW,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,mBAAmB,CAEpF;IAED,YAAY;IACZ,SAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,IAAI,iBAAiB,CAE1F;CACF;AAED;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,EAAE,CAAC;AAExD,YAAY;AAEZ,yBAAiB,iBAAiB,CAAC;IACjC;;;;;OAKG;IACH,SAAsB,SAAS,CAAC,KAAK,EAAE;QACrC,yBAAyB;QACzB,KAAK,EAAE,iBAAiB,CAAC;QACzB,qDAAqD;QACrD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5F,6EAA6E;QAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlB;CACF"}

package/lib/cjs/shared/ConcatenatedValue.js

@@ -20,12 +20,6 @@ var ConcatenatedValuePart;
     }
     ConcatenatedValuePart.isPrimitive = isPrimitive;
     /** @beta */
-    function isProperty(part) {
-        const candidate = part;
-        return !!candidate.className && !!candidate.propertyName;
-    }
-    ConcatenatedValuePart.isProperty = isProperty;
-    /** @beta */
     function isConcatenatedValue(part) {
         return Array.isArray(part);
     }

package/lib/cjs/shared/ConcatenatedValue.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConcatenatedValue.js","sourceRoot":"","sources":["../../../src/shared/ConcatenatedValue.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAkBhG,YAAY;AACZ,2DAA2D;AAC3D,IAAiB,qBAAqB,CAqBrC;AArBD,WAAiB,qBAAqB;IACpC,YAAY;IACZ,SAAgB,QAAQ,CAAC,IAA2B;QAClD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC;IAClC,CAAC;IAFe,8BAAQ,WAEvB,CAAA;IAED,YAAY;IACZ,SAAgB,WAAW,CAAC,IAA2B;QACrD,OAAO,CAAC,CAAE,IAA4B,CAAC,IAAI,CAAC;IAC9C,CAAC;IAFe,iCAAW,cAE1B,CAAA;IAED,YAAY;IACZ,SAAgB,UAAU,CAAC,IAA2B;QACpD,MAAM,SAAS,GAAG,IAA8B,CAAC;QACjD,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;IAC3D,CAAC;IAHe,gCAAU,aAGzB,CAAA;IAED,YAAY;IACZ,SAAgB,mBAAmB,CAAC,IAA2B;QAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAFe,yCAAmB,sBAElC,CAAA;AACH,CAAC,EArBgB,qBAAqB,qCAArB,qBAAqB,QAqBrC;AAUD,YAAY;AACZ,2DAA2D;AAC3D,IAAiB,iBAAiB,CA2BjC;AA3BD,WAAiB,iBAAiB;IAChC;;;;;OAKG;IACI,KAAK,UAAU,SAAS,CAAC,KAO/B;QACC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QAClD,OAAO,CACL,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,IAAI,qBAAqB,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,OAAO,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CACH,CACF,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IAnBqB,2BAAS,YAmB9B,CAAA;AACH,CAAC,EA3BgB,iBAAiB,iCAAjB,iBAAiB,QA2BjC"}
+{"version":3,"file":"ConcatenatedValue.js","sourceRoot":"","sources":["../../../src/shared/ConcatenatedValue.ts"],"names":[],"mappings":";AAAA;;;gGAGgG;;;AAgBhG,YAAY;AACZ,2DAA2D;AAC3D,IAAiB,qBAAqB,CAerC;AAfD,WAAiB,qBAAqB;IACpC,YAAY;IACZ,SAAgB,QAAQ,CAAC,IAA2B;QAClD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC;IAClC,CAAC;IAFe,8BAAQ,WAEvB,CAAA;IAED,YAAY;IACZ,SAAgB,WAAW,CAAC,IAA2B;QACrD,OAAO,CAAC,CAAE,IAA4B,CAAC,IAAI,CAAC;IAC9C,CAAC;IAFe,iCAAW,cAE1B,CAAA;IAED,YAAY;IACZ,SAAgB,mBAAmB,CAAC,IAA2B;QAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,CAAC;IAFe,yCAAmB,sBAElC,CAAA;AACH,CAAC,EAfgB,qBAAqB,qCAArB,qBAAqB,QAerC;AAUD,YAAY;AACZ,2DAA2D;AAC3D,IAAiB,iBAAiB,CA2BjC;AA3BD,WAAiB,iBAAiB;IAChC;;;;;OAKG;IACI,KAAK,UAAU,SAAS,CAAC,KAO/B;QACC,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;QAClD,OAAO,CACL,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACvB,IAAI,qBAAqB,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,OAAO,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC,CAAC,CACH,CACF,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC1B,CAAC;IAnBqB,2BAAS,YAmB9B,CAAA;AACH,CAAC,EA3BgB,iBAAiB,iCAAjB,iBAAiB,QA2BjC"}

package/lib/cjs/shared/Formatting.d.ts

@@ -1,5 +1,4 @@
 import { ConcatenatedValue } from "./ConcatenatedValue";
-import { ECSchemaProvider } from "./Metadata";
 import { TypedPrimitiveValue } from "./Values";
 /**
  * A type definition for a function that knows how to create a display string for a typed primitive value.
@@ -11,12 +10,10 @@ export type IPrimitiveValueFormatter = (value: TypedPrimitiveValue) => Promise<s
  * Formats a concatenated value into a string, taking into account different types of `ConcatenatedValuePart` that
  * the value consists of.
  *
- * @throws Error if a `ConcatenatedValuePart` in given `ConcatenatedValue` references a non-primitive, `IGeometry` or `Binary` property.
  * @beta
  */
 export declare function formatConcatenatedValue(props: {
     value: ConcatenatedValue | string;
-    schemaProvider: ECSchemaProvider;
     valueFormatter: IPrimitiveValueFormatter;
 }): Promise<string>;
 /**

package/lib/cjs/shared/Formatting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Formatting.d.ts","sourceRoot":"","sources":["../../../src/shared/Formatting.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAY,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvF;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAClC,cAAc,EAAE,gBAAgB,CAAC;IACjC,cAAc,EAAE,wBAAwB,CAAC;CAC1C,GAAG,OAAO,CAAC,MAAM,CAAC,CA0ClB;AAOD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,2BAA2B,IAAI,wBAAwB,CAatE"}
+{"version":3,"file":"Formatting.d.ts","sourceRoot":"","sources":["../../../src/shared/Formatting.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEvF;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAAC;IAAC,cAAc,EAAE,wBAAwB,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrJ;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,2BAA2B,IAAI,wBAAwB,CAatE"}

package/lib/cjs/shared/Formatting.js

@@ -9,16 +9,14 @@ exports.createDefaultValueFormatter = createDefaultValueFormatter;
 const core_bentley_1 = require("@itwin/core-bentley");
 const ConcatenatedValue_1 = require("./ConcatenatedValue");
 const InternalUtils_1 = require("./InternalUtils");
-const Metadata_1 = require("./Metadata");
 /**
  * Formats a concatenated value into a string, taking into account different types of `ConcatenatedValuePart` that
  * the value consists of.
  *
- * @throws Error if a `ConcatenatedValuePart` in given `ConcatenatedValue` references a non-primitive, `IGeometry` or `Binary` property.
  * @beta
  */
 async function formatConcatenatedValue(props) {
-    const { value, schemaProvider, valueFormatter } = props;
+    const { value, valueFormatter } = props;
     if (typeof value === "string") {
         return valueFormatter({ value, type: "String" });
     }
@@ -32,34 +30,11 @@ async function formatConcatenatedValue(props) {
                     type: "String",
                 };
             }
-            // for property parts - find property metadata and create `TypedPrimitiveValue` for them.
-            if (ConcatenatedValue_1.ConcatenatedValuePart.isProperty(part)) {
-                const property = await getProperty(part, schemaProvider);
-                if (!property?.isPrimitive()) {
-                    throw new Error(`Concatenated values formatter expects a primitive property, but it's not.`);
-                }
-                if (property.primitiveType === "IGeometry") {
-                    throw new Error(`Concatenated values formatter does not support "IGeometry" values, but the provided ${part.className}.${part.propertyName} property is.`);
-                }
-                if (property.primitiveType === "Binary") {
-                    throw new Error(`Concatenated values formatter does not support "Binary" values, but the provided ${part.className}.${part.propertyName} property is.`);
-                }
-                part = {
-                    type: property.primitiveType,
-                    extendedType: property.extendedTypeName,
-                    koqName: (await property.kindOfQuantity)?.fullName,
-                    value: part.value,
-                };
-            }
             // finally, use provided value formatter to create a string from `TypedPrimitiveValue`
             return valueFormatter(part);
         },
     });
 }
-async function getProperty({ className, propertyName }, schemaProvider) {
-    const propertyClass = await (0, Metadata_1.getClass)(schemaProvider, className);
-    return propertyClass.getProperty(propertyName);
-}
 /**
  * A values' formatter that knows how to format the following types:
  *

package/lib/cjs/shared/Formatting.js.map

@@ -1 +1 @@
-{"version":3,"file":"Formatting.js","sourceRoot":"","sources":["../../../src/shared/Formatting.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Formatting.js","sourceRoot":"","sources":["../../../src/shared/Formatting.ts"],"names":[],"mappings":"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"}

package/lib/cjs/shared/Values.d.ts

@@ -104,16 +104,4 @@ export declare namespace TypedPrimitiveValue {
      */
     function create(value: PrimitiveValue, type: PrimitiveValueType, koqName?: string, extendedType?: string): TypedPrimitiveValue;
 }
-/**
- * A type for a primitive property value and its metadata - property name and its class full name.
- * @beta
- */
-export interface PrimitivePropertyValue {
-    /** Full name of the class containing the property with `propertyName` name. */
-    className: string;
-    /** Name of the primitive property whose value this data structure holds. */
-    propertyName: string;
-    /** Raw value of the primitive property. */
-    value: PrimitiveValue;
-}
 //# sourceMappingURL=Values.d.ts.map

package/lib/cjs/shared/Values.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Values.d.ts","sourceRoot":"","sources":["../../../src/shared/Values.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,EAAE,EAAE,UAAU,CAAC;CAChB;AAED,YAAY;AACZ,yBAAiB,WAAW,CAAC;IAC3B;;;OAGG;IACH,SAAgB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAElE;IACD;;;;;;OAMG;IACH,SAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAMlE;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/F,YAAY;AAEZ,yBAAiB,cAAc,CAAC;IAC9B;;;;OAIG;IACH,SAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,OAAO,CAMjE;IAED;;;OAGG;IACH,SAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,OAAO,CAMjE;CACF;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAC9B;IACE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;CAC1B,GACD;IACE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,GACD;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;CACZ,GACD;IACE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,GACD;IACE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;CAClB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,CACJ,GAAG;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,YAAY;AAEZ,yBAAiB,mBAAmB,CAAC;IACnC;;;;OAIG;IACH,SAAgB,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB,CA8EpI;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,KAAK,EAAE,cAAc,CAAC;CACvB"}
+{"version":3,"file":"Values.d.ts","sourceRoot":"","sources":["../../../src/shared/Values.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,EAAE,EAAE,UAAU,CAAC;CAChB;AAED,YAAY;AACZ,yBAAiB,WAAW,CAAC;IAC3B;;;OAGG;IACH,SAAgB,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAElE;IACD;;;;;;OAMG;IACH,SAAgB,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAMlE;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/F,YAAY;AAEZ,yBAAiB,cAAc,CAAC;IAC9B;;;;OAIG;IACH,SAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,OAAO,CAMjE;IAED;;;OAGG;IACH,SAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,IAAI,OAAO,CAMjE;CACF;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAC9B;IACE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;CAC1B,GACD;IACE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,GACD;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;CACZ,GACD;IACE,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB,GACD;IACE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;CAClB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,GACD;IACE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB,CACJ,GAAG;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,YAAY;AAEZ,yBAAiB,mBAAmB,CAAC;IACnC;;;;OAIG;IACH,SAAgB,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB,CA8EpI;CACF"}

package/lib/cjs/shared/ecsql-snippets/ECSqlValueSelectorSnippets.d.ts

@@ -1,51 +1,48 @@
-import { PrimitiveValueType } from "../Metadata";
+import { ECSchemaProvider, PrimitiveValueType } from "../Metadata";
 import { PrimitiveValue, TypedPrimitiveValue } from "../Values";
 /**
- * A union of property types that need special handling when creating a property value selector.
- * For example, Guid values are stored as binary and need to be selected with `GuidToStr` function to
- * get a meaningful value.
+ * Props for selecting a `TypedPrimitiveValue` using given ECSQL selector.
  * @beta
  */
-type SpecialPropertyType = "Navigation" | "Guid" | "Point2d" | "Point3d";
-/**
- * Props for selecting property value along with its metadata.
- *
- * It's recommended to only select properties with metadata only when they need additional formatting and
- * otherwise use `createRawPropertyValueSelector` to select their value.
- *
- * @beta
- */
-interface PropertyValueSelectClauseProps {
-    /** Full class name of the property. Format: `SchemaName.ClassName`. */
-    propertyClassName: string;
-    /** Query alias of the class that contains the property. */
-    propertyClassAlias: string;
-    /** Name of the property. */
-    propertyName: string;
-    /** Special type of the property if it matches any. */
-    specialType?: SpecialPropertyType;
-}
-/**
- * Props for selecting a primitive value using given ECSQL selector.
- * @beta
- */
-interface PrimitiveValueSelectorProps {
+type TypedPrimitiveValueSelectorProps = {
     /** ECSQL selector to query the value */
     selector: string;
+} & ({
     /** Type of the value. Defaults to `String`. */
-    type?: PrimitiveValueType;
-}
+    type?: undefined;
+} | {
+    type: Exclude<PrimitiveValueType, "Double">;
+    extendedType?: string;
+} | {
+    type: Extract<PrimitiveValueType, "Double">;
+    extendedType?: string;
+    koqName?: string;
+});
 /**
  * A union of prop types for selecting a value and its metadata in ECSQL query.
  * @beta
  */
-export type TypedValueSelectClauseProps = PropertyValueSelectClauseProps | TypedPrimitiveValue | PrimitiveValueSelectorProps;
+export type TypedValueSelectClauseProps = TypedPrimitiveValue | TypedPrimitiveValueSelectorProps;
 /** @beta */
 export declare namespace TypedValueSelectClauseProps {
-    function isPropertySelector(props: TypedValueSelectClauseProps): props is PropertyValueSelectClauseProps;
     function isPrimitiveValue(props: TypedValueSelectClauseProps): props is TypedPrimitiveValue;
-    function isPrimitiveValueSelector(props: TypedValueSelectClauseProps): props is PrimitiveValueSelectorProps;
+    function isPrimitiveValueSelector(props: TypedValueSelectClauseProps): props is TypedPrimitiveValueSelectorProps;
 }
+/**
+ * A function for a creating a `TypedPrimitiveValueSelectorProps` object from given primitive ECProperty information.
+ * @throws Error if the property is not found, is not primitive or has unsupported primitive type (Binary, IGeometry).
+ * @beta
+ */
+export declare function createPrimitivePropertyValueSelectorProps({ schemaProvider, propertyClassAlias, propertyClassName, propertyName, }: {
+    /** Access to schema information. */
+    schemaProvider: ECSchemaProvider;
+    /** Full class name of the property. Format: `SchemaName.ClassName`. */
+    propertyClassName: string;
+    /** Query alias of the class that contains the property. */
+    propertyClassAlias: string;
+    /** Name of the property to create `TypedPrimitiveValue` for. */
+    propertyName: string;
+}): Promise<TypedPrimitiveValueSelectorProps>;
 /**
  * Creates an ECSQL selector for raw property value, or, optionally - it's component. Example result:
  * `[classAlias].[propertyName].[componentName]`.

package/lib/cjs/shared/ecsql-snippets/ECSqlValueSelectorSnippets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ECSqlValueSelectorSnippets.d.ts","sourceRoot":"","sources":["../../../../src/shared/ecsql-snippets/ECSqlValueSelectorSnippets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhE;;;;;GAKG;AACH,KAAK,mBAAmB,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE;;;;;;;GAOG;AACH,UAAU,8BAA8B;IACtC,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED;;;GAGG;AACH,UAAU,2BAA2B;IACnC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG,8BAA8B,GAAG,mBAAmB,GAAG,2BAA2B,CAAC;AAE7H,YAAY;AAEZ,yBAAiB,2BAA2B,CAAC;IAC3C,SAAgB,kBAAkB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,IAAI,8BAA8B,CAE9G;IACD,SAAgB,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,IAAI,mBAAmB,CAEjG;IACD,SAAgB,wBAAwB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,IAAI,2BAA2B,CAEjH;CACF;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvH;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,UAqBhF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,UAIjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,2BAA2B,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,UAMnH;AAmED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,2BAA2B,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,UAMrH"}
+{"version":3,"file":"ECSqlValueSelectorSnippets.d.ts","sourceRoot":"","sources":["../../../../src/shared/ecsql-snippets/ECSqlValueSelectorSnippets.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAY,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhE;;;GAGG;AACH,KAAK,gCAAgC,GAAG;IACtC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,CACA;IACE,+CAA+C;IAC/C,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB,GACD;IACE,IAAI,EAAE,OAAO,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACD;IACE,IAAI,EAAE,OAAO,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CACJ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,GAAG,gCAAgC,CAAC;AAEjG,YAAY;AAEZ,yBAAiB,2BAA2B,CAAC;IAC3C,SAAgB,gBAAgB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,IAAI,mBAAmB,CAEjG;IACD,SAAgB,wBAAwB,CAAC,KAAK,EAAE,2BAA2B,GAAG,KAAK,IAAI,gCAAgC,CAEtH;CACF;AAED;;;;GAIG;AACH,wBAAsB,yCAAyC,CAAC,EAC9D,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,GACb,EAAE;IACD,oCAAoC;IACpC,cAAc,EAAE,gBAAgB,CAAC;IACjC,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAsD5C;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvH;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,UAqBhF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,UAIjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtG;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,2BAA2B,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,UAMnH;AA2CD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qCAAqC,CAAC,SAAS,EAAE,2BAA2B,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,UAMrH"}

package/lib/cjs/shared/ecsql-snippets/ECSqlValueSelectorSnippets.js

@@ -5,6 +5,7 @@
  *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypedValueSelectClauseProps = void 0;
+exports.createPrimitivePropertyValueSelectorProps = createPrimitivePropertyValueSelectorProps;
 exports.createRawPropertyValueSelector = createRawPropertyValueSelector;
 exports.createRawPrimitiveValueSelector = createRawPrimitiveValueSelector;
 exports.createInstanceKeySelector = createInstanceKeySelector;
@@ -12,24 +13,76 @@ exports.createNullableSelector = createNullableSelector;
 exports.createConcatenatedValueJsonSelector = createConcatenatedValueJsonSelector;
 exports.createConcatenatedValueStringSelector = createConcatenatedValueStringSelector;
 const core_bentley_1 = require("@itwin/core-bentley");
+const Metadata_1 = require("../Metadata");
 const Values_1 = require("../Values");
 /** @beta */
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 var TypedValueSelectClauseProps;
 (function (TypedValueSelectClauseProps) {
-    function isPropertySelector(props) {
-        return !!props.propertyName;
-    }
-    TypedValueSelectClauseProps.isPropertySelector = isPropertySelector;
     function isPrimitiveValue(props) {
-        return !!props.value;
+        return "value" in props;
     }
     TypedValueSelectClauseProps.isPrimitiveValue = isPrimitiveValue;
     function isPrimitiveValueSelector(props) {
-        return !!props.selector;
+        return "selector" in props;
     }
     TypedValueSelectClauseProps.isPrimitiveValueSelector = isPrimitiveValueSelector;
 })(TypedValueSelectClauseProps || (exports.TypedValueSelectClauseProps = TypedValueSelectClauseProps = {}));
+/**
+ * A function for a creating a `TypedPrimitiveValueSelectorProps` object from given primitive ECProperty information.
+ * @throws Error if the property is not found, is not primitive or has unsupported primitive type (Binary, IGeometry).
+ * @beta
+ */
+async function createPrimitivePropertyValueSelectorProps({ schemaProvider, propertyClassAlias, propertyClassName, propertyName, }) {
+    const ecClass = await (0, Metadata_1.getClass)(schemaProvider, propertyClassName);
+    const property = await ecClass.getProperty(propertyName);
+    if (!property) {
+        throw new Error(`The property "${propertyName}" not found in class "${propertyClassName}".`);
+    }
+    const propertySelector = createRawPropertyValueSelector(propertyClassAlias, propertyName);
+    if (property.isNavigation()) {
+        return { selector: `${propertySelector}.[Id]`, type: "Id" };
+    }
+    if (!property.isPrimitive()) {
+        throw new Error(`The property "${propertyName}" should be of either navigation or primitive type.`);
+    }
+    const propertyValueType = property.primitiveType;
+    const extendedType = property.extendedTypeName;
+    switch (propertyValueType) {
+        case "IGeometry":
+            throw new Error(`The property "${propertyName}" of type "IGeometry" is not supported.`);
+        case "Binary":
+            if (extendedType === "BeGuid") {
+                return { selector: `GuidToStr(${propertySelector})`, type: "String" };
+            }
+            throw new Error(`The property "${propertyName}" of type "Binary" is not supported.`);
+        case "Point2d":
+            return {
+                selector: `json_object('x', ${propertySelector}.[x], 'y', ${propertySelector}.[y])`,
+                type: "Point2d",
+                ...(extendedType ? { extendedType } : /* istanbul ignore next */ {}),
+            };
+        case "Point3d":
+            return {
+                selector: `json_object('x', ${propertySelector}.[x], 'y', ${propertySelector}.[y], 'z', ${propertySelector}.[z])`,
+                type: "Point3d",
+                ...(extendedType ? { extendedType } : /* istanbul ignore next */ {}),
+            };
+        case "Double":
+            const koqName = (await property.kindOfQuantity)?.fullName;
+            return {
+                selector: propertySelector,
+                type: "Double",
+                ...(extendedType ? { extendedType } : /* istanbul ignore next */ {}),
+                ...(koqName ? { koqName } : /* istanbul ignore next */ {}),
+            };
+    }
+    return {
+        selector: propertySelector,
+        type: propertyValueType,
+        ...(extendedType ? { extendedType } : /* istanbul ignore next */ {}),
+    };
+}
 /**
  * Creates an ECSQL selector for raw property value, or, optionally - it's component. Example result:
  * `[classAlias].[propertyName].[componentName]`.
@@ -120,51 +173,28 @@ function createConcatenatedValueJsonSelector(selectors, checkSelector) {
     return combinedSelectors;
 }
 function createTypedValueJsonSelector(props) {
-    if (TypedValueSelectClauseProps.isPropertySelector(props)) {
-        if (props.specialType) {
-            // eslint-disable-next-line @typescript-eslint/no-shadow
-            const [valueSelector, typeOverride] = createSpecialPropertyValueJsonSelector(props.propertyClassAlias, props.propertyName, props.specialType);
-            return createTypedValueJsonSelector({ selector: valueSelector, type: typeOverride });
-        }
-        return `
-      json_object(
-        'className', '${props.propertyClassName}',
-        'propertyName', '${props.propertyName}',
-        'value', ${createRawPropertyValueSelector(props.propertyClassAlias, props.propertyName)}
-      )
-    `;
+    let valueSelector;
+    if (TypedValueSelectClauseProps.isPrimitiveValue(props)) {
+        valueSelector = createPrimitiveValueJsonSelector(props.value);
     }
-    if (TypedValueSelectClauseProps.isPrimitiveValueSelector(props)) {
-        if (props.type) {
-            return `
-        json_object(
-          'value', ${props.selector},
-          'type', '${props.type}'
-        )
-      `;
-        }
+    else if (props.type) {
+        valueSelector = props.selector;
+    }
+    else {
         return props.selector;
     }
+    const args = {
+        value: valueSelector,
+        type: `'${props.type}'`,
+        ...(props.extendedType ? { extendedType: `'${props.extendedType}'` } : {}),
+        ...(props.type === "Double" && props.koqName ? { koqName: `'${props.koqName}'` } : {}),
+    };
     return `
-    json_object(
-      'value', ${createPrimitiveValueJsonSelector(props.value)},
-      'type', '${props.type}'
-    )
+    json_object(${Object.entries(args)
+        .map(([key, value]) => `'${key}', ${value}`)
+        .join(", ")})
   `;
 }
-function createSpecialPropertyValueJsonSelector(classAlias, propertyName, specialType) {
-    const propertySelector = `[${classAlias}].[${propertyName}]`;
-    switch (specialType) {
-        case "Navigation":
-            return [`${propertySelector}.[Id]`, "Id"];
-        case "Guid":
-            return [`GuidToStr(${propertySelector})`, "String"];
-        case "Point2d":
-            return [`json_object('x', ${propertySelector}.[x], 'y', ${propertySelector}.[y])`, "Point2d"];
-        case "Point3d":
-            return [`json_object('x', ${propertySelector}.[x], 'y', ${propertySelector}.[y], 'z', ${propertySelector}.[z])`, "Point3d"];
-    }
-}
 function createPrimitiveValueJsonSelector(value) {
     if (value instanceof Date) {
         return `'${value.toISOString()}'`;
@@ -210,32 +240,11 @@ function createConcatenatedValueStringSelector(selectors, checkSelector) {
     return combinedSelectors;
 }
 function createTypedValueStringSelector(props) {
-    if (TypedValueSelectClauseProps.isPropertySelector(props)) {
-        if (props.specialType) {
-            // eslint-disable-next-line @typescript-eslint/no-shadow
-            const [valueSelector, typeOverride] = createSpecialPropertyValueStringSelector(props.propertyClassAlias, props.propertyName, props.specialType);
-            return createTypedValueStringSelector({ selector: valueSelector, type: typeOverride });
-        }
-        return createRawPropertyValueSelector(props.propertyClassAlias, props.propertyName);
-    }
     if (TypedValueSelectClauseProps.isPrimitiveValueSelector(props)) {
-        return props.selector;
+        return `CAST(${props.selector} AS TEXT)`;
     }
     return createPrimitiveValueStringSelector(props.value);
 }
-function createSpecialPropertyValueStringSelector(classAlias, propertyName, specialType) {
-    const propertySelector = createRawPropertyValueSelector(classAlias, propertyName);
-    switch (specialType) {
-        case "Navigation":
-            return [`CAST(${propertySelector}.[Id] AS TEXT)`, "Id"];
-        case "Guid":
-            return [`GuidToStr(${propertySelector})`, "String"];
-        case "Point2d":
-            return [`'(' || ${propertySelector}.[x] || ', ' || ${propertySelector}.[y] || ')'`, "Point2d"];
-        case "Point3d":
-            return [`'(' || ${propertySelector}.[x] || ', ' || ${propertySelector}.[y] || ', ' || ${propertySelector}.[z] || ')'`, "Point3d"];
-    }
-}
 function createPrimitiveValueStringSelector(value) {
     if (value instanceof Date) {
         return `'${value.toLocaleString()}'`;