@itwin/presentation-shared 2.0.0-alpha.8 → 2.0.0

package/lib/{esm/shared → shared}/Utils.js

@@ -6,47 +6,41 @@ import { assert } from "@itwin/core-bentley";
 /**
  * An utility to parse schema and class names from full class name, where
  * schema and class names are separated by either `:` or `.`.
+ *
+ * @throws Error if the provided full class name is not valid.
  * @public
  */
 export function parseFullClassName(fullClassName) {
-    const [schemaName, className] = fullClassName.split(/[\.:]/);
-    assert(!!schemaName && !!className, "Invalid full class name");
-    return { schemaName, className };
+    let idx = fullClassName.indexOf(".");
+    let includesDot = true;
+    if (idx <= 0) {
+        includesDot = false;
+        idx = fullClassName.indexOf(":");
+        if (idx <= 0) {
+            throw new Error(`Invalid full class name: ${fullClassName}`);
+        }
+    }
+    assert(() => {
+        return (idx < fullClassName.length - 1 &&
+            (includesDot
+                ? fullClassName.lastIndexOf(".") === idx && fullClassName.indexOf(":") === -1
+                : fullClassName.lastIndexOf(":") === idx));
+    }, `Invalid full class name: ${fullClassName}`);
+    return { schemaName: fullClassName.slice(0, idx), className: fullClassName.slice(idx + 1) };
 }
 /**
  * An utility to normalize full class name from either `SchemaName:ClassName` or
  * `SchemaName.ClassName` to always use the dot format.
+ *
+ * @throws Error if the provided full class name is not valid.
  * @public
  */
 export function normalizeFullClassName(fullClassName) {
-    const colonPos = fullClassName.indexOf(":");
-    if (-1 === colonPos) {
-        assert(fullClassName.indexOf(".") !== -1, "Invalid full class name");
-        return fullClassName;
-    }
-    const schemaName = fullClassName.slice(0, colonPos);
-    const className = fullClassName.slice(colonPos + 1);
+    const { schemaName, className } = parseFullClassName(fullClassName);
     return `${schemaName}.${className}`;
 }
-/**
- * An utility that compares two full class names in a case insensitive way, ignoring different
- * supported schema-class name separators (`.` or `:`).
- * @public
- */
-export function compareFullClassNames(lhs, rhs) {
-    const parsed = {
-        lhs: parseFullClassName(lhs),
-        rhs: parseFullClassName(rhs),
-    };
-    const schemaCompare = parsed.lhs.schemaName.toLocaleLowerCase().localeCompare(parsed.rhs.schemaName.toLocaleLowerCase());
-    if (schemaCompare !== 0) {
-        return schemaCompare;
-    }
-    return parsed.lhs.className.toLocaleLowerCase().localeCompare(parsed.rhs.className.toLocaleLowerCase());
-}
 /** @public */
 export function trimWhitespace(str) {
-    /* c8 ignore next 3 */
     if (!str) {
         return str;
     }

package/lib/shared/Utils.js.map

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

package/lib/shared/Values.d.ts

@@ -0,0 +1,144 @@
+import type { Id64String } from "@itwin/core-bentley";
+import type { ConcatenatedValue } from "./ConcatenatedValue.js";
+import type { EC, PrimitiveValueType } from "./Metadata.js";
+/**
+ * A data structure uniquely identifying an ECInstance in an iModel.
+ * @public
+ */
+export interface InstanceKey {
+    /** Full class name in format `SchemaName.ClassName` */
+    className: EC.FullClassNameDotNotation;
+    /** ECInstance ID */
+    id: Id64String;
+}
+/** @public */
+export declare namespace InstanceKey {
+    /**
+     * Checks whether the two given instance keys are equal.
+     * @public
+     */
+    function equals(lhs: InstanceKey, rhs: InstanceKey): boolean;
+    /**
+     * Compares two given instance keys.
+     * @returns
+     *- `0` if they are equal
+     *- `negative value` if lhs key is less than rhs key
+     *- `positive value` if lhs key is more than rhs key
+     */
+    function compare(lhs: InstanceKey, rhs: InstanceKey): number;
+}
+/**
+ * A data structure for a 2d point.
+ * @public
+ */
+export interface Point2dValue {
+    x: number;
+    y: number;
+}
+/**
+ * A data structure for a 3d point.
+ * @public
+ */
+export interface Point3dValue {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * A union for all supported primitive value types.
+ * @public
+ */
+export type PrimitiveValue = Id64String | string | number | boolean | Date | Point2dValue | Point3dValue;
+/** @public */
+export declare namespace PrimitiveValue {
+    /**
+     * Checks whether the given value is a `Point2dValue`.
+     * @note Since `Point3dValue` is a superset of `Point2dValue`, this function will return `true` for `Point3dValue` as well.
+     * @public
+     */
+    function isPoint2d(value: PrimitiveValue): value is Point2dValue;
+    /**
+     * Checks whether the given value is a `Point3dValue`.
+     * @public
+     */
+    function isPoint3d(value: PrimitiveValue): value is Point3dValue;
+}
+/**
+ * A type for a primitive value, its type and, optionally, its extended type.
+ * @note Use `TypedPrimitiveValue.create` to create an instance of this type.
+ * @public
+ */
+export type TypedPrimitiveValue = ({
+    value: number;
+    type: Extract<PrimitiveValueType, "Double">;
+    koqName?: string;
+} | {
+    value: number;
+    type: Extract<PrimitiveValueType, "Integer">;
+    koqName?: string;
+} | {
+    value: number;
+    type: Extract<PrimitiveValueType, "Long">;
+    koqName?: string;
+} | {
+    value: boolean;
+    type: Extract<PrimitiveValueType, "Boolean">;
+} | {
+    value: Id64String;
+    type: Extract<PrimitiveValueType, "Id">;
+} | {
+    value: string;
+    type: Extract<PrimitiveValueType, "String">;
+} | {
+    value: number | string | Date;
+    type: Extract<PrimitiveValueType, "DateTime">;
+} | {
+    value: Point2dValue;
+    type: Extract<PrimitiveValueType, "Point2d">;
+} | {
+    value: Point3dValue;
+    type: Extract<PrimitiveValueType, "Point3d">;
+}) & {
+    extendedType?: string;
+};
+/** @public */
+export declare namespace TypedPrimitiveValue {
+    /**
+     * A function for a creating a `TypedPrimitiveValue` object.
+     * @throws Error if primitive type and value are incompatible.
+     * @public
+     */
+    function create<TValue extends PrimitiveValue, TType extends PrimitiveValueType>(value: TValue, type: TType, koqName?: string, extendedType?: string): Extract<TypedPrimitiveValue, {
+        type: TType;
+    }>;
+}
+/**
+ * A composite value representing a struct (named record with member values).
+ * @public
+ */
+export interface StructValue {
+    [memberName: string]: Value;
+}
+/**
+ * A composite value representing an array of values.
+ * @public
+ */
+export type ArrayValue = Value[];
+/**
+ * A value representing a navigation value pointing to another instance.
+ * @public
+ */
+export interface NavigationValue {
+    /**
+     * Key of the instance the navigation value points to.
+     */
+    key: InstanceKey;
+    /** Unformatted label of the instance the navigation value points to. */
+    label: ConcatenatedValue | string;
+}
+/**
+ * Any value that can be assigned to an ECInstance — a primitive, struct, array, navigation value, or undefined (null/empty).
+ * @public
+ */
+export type Value = PrimitiveValue | StructValue | ArrayValue | NavigationValue | undefined;
+//# sourceMappingURL=Values.d.ts.map

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

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

package/lib/shared/Values.js

@@ -0,0 +1,121 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { compareStrings, Id64 } from "@itwin/core-bentley";
+/** @public */
+export var InstanceKey;
+(function (InstanceKey) {
+    /**
+     * Checks whether the two given instance keys are equal.
+     * @public
+     */
+    function equals(lhs, rhs) {
+        return compare(lhs, rhs) === 0;
+    }
+    InstanceKey.equals = equals;
+    /**
+     * Compares two given instance keys.
+     * @returns
+     *- `0` if they are equal
+     *- `negative value` if lhs key is less than rhs key
+     *- `positive value` if lhs key is more than rhs key
+     */
+    function compare(lhs, rhs) {
+        const classNameCompareResult = compareStrings(lhs.className, rhs.className);
+        if (classNameCompareResult !== 0) {
+            return classNameCompareResult;
+        }
+        return compareStrings(lhs.id, rhs.id);
+    }
+    InstanceKey.compare = compare;
+})(InstanceKey || (InstanceKey = {}));
+/** @public */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export var PrimitiveValue;
+(function (PrimitiveValue) {
+    /**
+     * Checks whether the given value is a `Point2dValue`.
+     * @note Since `Point3dValue` is a superset of `Point2dValue`, this function will return `true` for `Point3dValue` as well.
+     * @public
+     */
+    function isPoint2d(value) {
+        if (typeof value !== "object") {
+            return false;
+        }
+        return "x" in value && "y" in value;
+    }
+    PrimitiveValue.isPoint2d = isPoint2d;
+    /**
+     * Checks whether the given value is a `Point3dValue`.
+     * @public
+     */
+    function isPoint3d(value) {
+        if (typeof value !== "object") {
+            return false;
+        }
+        return "x" in value && "y" in value && "z" in value;
+    }
+    PrimitiveValue.isPoint3d = isPoint3d;
+})(PrimitiveValue || (PrimitiveValue = {}));
+/** @public */
+// eslint-disable-next-line @typescript-eslint/no-redeclare
+export var TypedPrimitiveValue;
+(function (TypedPrimitiveValue) {
+    /**
+     * A function for a creating a `TypedPrimitiveValue` object.
+     * @throws Error if primitive type and value are incompatible.
+     * @public
+     */
+    function create(value, type, koqName, extendedType) {
+        // The function's return type narrows `TypedPrimitiveValue` based on the generic `TType`. TypeScript can't verify that the
+        // objects created below satisfy that narrowed type, because narrowing the `type`/`value` variables via control flow doesn't
+        // narrow the `TType` type parameter itself (it stays generic within the function body). So we build the value with a concrete
+        // `TypedPrimitiveValue` return type - which TypeScript does check branch-by-branch - and apply the narrowing with a single
+        // cast at the boundary, rather than casting every `return` statement individually.
+        return (function () {
+            switch (type) {
+                case "Double":
+                case "Integer":
+                case "Long":
+                    if (typeof value === "number") {
+                        return { type, koqName, extendedType, value };
+                    }
+                    break;
+                case "Boolean":
+                    if (typeof value === "boolean") {
+                        return { type, extendedType, value };
+                    }
+                    break;
+                case "Id":
+                    if (typeof value === "string" && Id64.isId64(value)) {
+                        return { type, extendedType, value };
+                    }
+                    break;
+                case "String":
+                    if (typeof value === "string") {
+                        return { type, extendedType, value };
+                    }
+                    break;
+                case "DateTime":
+                    if (typeof value === "string" || typeof value === "number" || value instanceof Date) {
+                        return { type, extendedType, value };
+                    }
+                    break;
+                case "Point3d":
+                    if (PrimitiveValue.isPoint3d(value)) {
+                        return { type, extendedType, value };
+                    }
+                    break;
+                case "Point2d":
+                    if (PrimitiveValue.isPoint2d(value)) {
+                        return { type, extendedType, value };
+                    }
+                    break;
+            }
+            throw new Error(`PrimitiveValueType ${type} isn't compatible with value ${JSON.stringify(value)}`);
+        })();
+    }
+    TypedPrimitiveValue.create = create;
+})(TypedPrimitiveValue || (TypedPrimitiveValue = {}));
+//# sourceMappingURL=Values.js.map

package/lib/shared/Values.js.map

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

package/lib/shared/ecsql-snippets/ECSqlHiddenClassesSnippets.d.ts

@@ -0,0 +1,40 @@
+import type { EC, ECSchemaProvider } from "../Metadata.js";
+/**
+ * Creates a filter that excludes instances of classes hidden through `CoreCustomAttributes.HiddenClass` or
+ * `CoreCustomAttributes.HiddenSchema` custom attributes, relative to the given base class:
+ * - The base class is the visibility boundary: `HiddenClass` attributes on it and on its own base classes are ignored,
+ *   so it is never excluded, even if it's hidden. Its derived classes are excluded or included according to the rules
+ *   described by `HiddenClassesTreeNode`.
+ * - Classes outside the base class' hierarchy are not affected, so the filter may be applied to queries selecting
+ *   the base class, its derived class, or a broader class.
+ * - The base class should be the class the query is meant to select. When the query's `FROM` class gets specialized,
+ *   e.g. by an instance filter, still pass the original class - otherwise, specializing to a hidden class would
+ *   include its instances.
+ *
+ * The hidden classes tree is requested from `schemaProvider` once, when creating the filter, and errors are
+ * propagated. Caching the tree is the provider's responsibility, so create the filter when building queries and
+ * reuse it for all aliases within the same operation, rather than holding on to it.
+ *
+ * Usage example:
+ *
+ * ```ts
+ * const filter = await ECSql.createHiddenClassesFilter({ schemaProvider, baseClassName: "BisCore.GeometricElement3d" });
+ * const whereClause = filter.createWhereClause("e");
+ * const ecsql = `SELECT e.ECInstanceId FROM bis.GeometricElement3d e ${whereClause ? `WHERE ${whereClause}` : ""}`;
+ * ```
+ *
+ * @public
+ */
+export declare function createHiddenClassesFilter(props: {
+    /** Schema provider used to get the hidden classes tree of the base class. */
+    schemaProvider: Pick<ECSchemaProvider, "getHiddenClassesTree">;
+    /** Full name of the class, relative to which classes are hidden. */
+    baseClassName: EC.FullClassNameDotNotation;
+}): Promise<{
+    /**
+     * Creates an ECSQL condition (without the `WHERE` keyword) that excludes instances of hidden classes, selected
+     * under the given alias. Returns an empty string when nothing needs to be excluded.
+     */
+    createWhereClause(classAlias: string): string;
+}>;
+//# sourceMappingURL=ECSqlHiddenClassesSnippets.d.ts.map

package/lib/shared/ecsql-snippets/ECSqlHiddenClassesSnippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSqlHiddenClassesSnippets.d.ts","sourceRoot":"","sources":["../../../src/shared/ecsql-snippets/ECSqlHiddenClassesSnippets.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,EAAE,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,6EAA6E;IAC7E,cAAc,EAAE,IAAI,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC;IAC/D,oEAAoE;IACpE,aAAa,EAAE,EAAE,CAAC,wBAAwB,CAAC;CAC5C,GAAG,OAAO,CAAC;IACV;;;OAGG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/C,CAAC,CAGD"}

package/lib/shared/ecsql-snippets/ECSqlHiddenClassesSnippets.js

@@ -0,0 +1,66 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { createClassSelector } from "./ECSqlValueSelectorSnippets.js";
+/**
+ * Creates a filter that excludes instances of classes hidden through `CoreCustomAttributes.HiddenClass` or
+ * `CoreCustomAttributes.HiddenSchema` custom attributes, relative to the given base class:
+ * - The base class is the visibility boundary: `HiddenClass` attributes on it and on its own base classes are ignored,
+ *   so it is never excluded, even if it's hidden. Its derived classes are excluded or included according to the rules
+ *   described by `HiddenClassesTreeNode`.
+ * - Classes outside the base class' hierarchy are not affected, so the filter may be applied to queries selecting
+ *   the base class, its derived class, or a broader class.
+ * - The base class should be the class the query is meant to select. When the query's `FROM` class gets specialized,
+ *   e.g. by an instance filter, still pass the original class - otherwise, specializing to a hidden class would
+ *   include its instances.
+ *
+ * The hidden classes tree is requested from `schemaProvider` once, when creating the filter, and errors are
+ * propagated. Caching the tree is the provider's responsibility, so create the filter when building queries and
+ * reuse it for all aliases within the same operation, rather than holding on to it.
+ *
+ * Usage example:
+ *
+ * ```ts
+ * const filter = await ECSql.createHiddenClassesFilter({ schemaProvider, baseClassName: "BisCore.GeometricElement3d" });
+ * const whereClause = filter.createWhereClause("e");
+ * const ecsql = `SELECT e.ECInstanceId FROM bis.GeometricElement3d e ${whereClause ? `WHERE ${whereClause}` : ""}`;
+ * ```
+ *
+ * @public
+ */
+export async function createHiddenClassesFilter(props) {
+    const tree = await props.schemaProvider.getHiddenClassesTree(props.baseClassName);
+    return { createWhereClause: (classAlias) => createHiddenClassesWhereClause({ tree, classAlias }) };
+}
+function createHiddenClassesWhereClause(props) {
+    // Instances of the selected class are visible by default, so root `show` nodes are redundant - only their
+    // hidden descendants restrict anything.
+    const rootNodes = getRestrictingRootNodes(props.tree);
+    return createHideClause(rootNodes, props.classAlias) ?? "";
+}
+function getRestrictingRootNodes(nodes) {
+    return nodes.flatMap((node) => (node.state === "show" ? getRestrictingRootNodes(node.children) : [node]));
+}
+/** Creates a clause that excludes the given hidden nodes, except for their shown descendants. */
+function createHideClause(nodes, classAlias) {
+    if (nodes.length === 0) {
+        return undefined;
+    }
+    const hideClause = `[${classAlias}].[ECClassId] IS NOT (${createClassesList(nodes)})`;
+    const showClause = createShowClause(nodes.flatMap(({ children }) => children), classAlias);
+    return showClause ? `(${hideClause} OR ${showClause})` : hideClause;
+}
+/** Creates a clause that includes the given shown nodes, except for their hidden descendants. */
+function createShowClause(nodes, classAlias) {
+    if (nodes.length === 0) {
+        return undefined;
+    }
+    const showClause = `[${classAlias}].[ECClassId] IS (${createClassesList(nodes)})`;
+    const hideClause = createHideClause(nodes.flatMap(({ children }) => children), classAlias);
+    return hideClause ? `(${showClause} AND ${hideClause})` : showClause;
+}
+function createClassesList(nodes) {
+    return nodes.map(({ fullName }) => createClassSelector(fullName)).join(", ");
+}
+//# sourceMappingURL=ECSqlHiddenClassesSnippets.js.map

package/lib/shared/ecsql-snippets/ECSqlHiddenClassesSnippets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSqlHiddenClassesSnippets.js","sourceRoot":"","sources":["../../../src/shared/ecsql-snippets/ECSqlHiddenClassesSnippets.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAKtE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,KAK/C;IAOC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClF,OAAO,EAAE,iBAAiB,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,8BAA8B,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,8BAA8B,CAAC,KAGvC;IACC,0GAA0G;IAC1G,wCAAwC;IACxC,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAA4C;IAE5C,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5G,CAAC;AAED,iGAAiG;AACjG,SAAS,gBAAgB,CACvB,KAAwE,EACxE,UAAkB;IAElB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,UAAU,yBAAyB,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC;IACtF,MAAM,UAAU,GAAG,gBAAgB,CACjC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EACzC,UAAU,CACX,CAAC;IACF,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,OAAO,UAAU,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AACtE,CAAC;AAED,iGAAiG;AACjG,SAAS,gBAAgB,CACvB,KAAwE,EACxE,UAAkB;IAElB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,UAAU,qBAAqB,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC;IAClF,MAAM,UAAU,GAAG,gBAAgB,CACjC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EACzC,UAAU,CACX,CAAC;IACF,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,QAAQ,UAAU,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC;AACvE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA4C;IACrE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC"}

package/lib/shared/ecsql-snippets/ECSqlJoinSnippets.d.ts

@@ -0,0 +1,174 @@
+import type { ECSqlBinding } from "../ECSqlCore.js";
+import type { EC, ECSchemaProvider, RelationshipPath, RelationshipPathStep } from "../Metadata.js";
+/**
+ * Describes a single JOIN step from source to target through a relationship.
+ * @public
+ */
+interface JoinRelationshipPathStep extends RelationshipPathStep {
+    sourceAlias: string;
+    targetAlias: string;
+    relationshipAlias: string;
+    joinType?: "inner" | "outer";
+}
+/**
+ * Describes a path of JOINs from source to target.
+ * @public
+ */
+type JoinRelationshipPath = RelationshipPath<JoinRelationshipPathStep>;
+/**
+ * Props for `createRelationshipPathJoinClause` and `createRelationshipPathJoinInfo`.
+ * @public
+ */
+export interface CreateRelationshipPathJoinClauseProps {
+    schemaProvider: ECSchemaProvider;
+    path: JoinRelationshipPath;
+}
+/**
+ * A join onto a plain class table.
+ * @public
+ */
+interface JoinTargetClass {
+    kind: "class";
+    className: EC.FullClassNameDotNotation;
+}
+/**
+ * A join onto a pre-joined relationship subquery (the outer link-table case), i.e.
+ * `(SELECT [rel].* FROM [relationship] [rel] INNER JOIN [target] [t] ON <innerJoinCondition>)`.
+ * Rendering emits the subquery; the outer target is a separate `RelationshipJoinInfo` entry.
+ * @public
+ */
+interface JoinTargetRelationshipSelect {
+    kind: "relationship-select";
+    relationshipClassName: EC.FullClassNameDotNotation;
+    relationshipAlias: string;
+    /** The class inner-joined inside the subquery, its alias, and the inner `ON` condition. */
+    innerTarget: JoinTargetClass;
+    innerTargetAlias: string;
+    innerJoinCondition: string;
+}
+/**
+ * One concrete JOIN clause rendered as either `INNER JOIN ... ON ...` or `LEFT OUTER JOIN ... ON ...`.
+ * @public
+ */
+interface RelationshipJoinInfo {
+    joinType: "inner" | "outer";
+    /** What is joined: a class table, or (outer link-table case) a nested relationship SELECT. */
+    joinTarget: JoinTargetClass | JoinTargetRelationshipSelect;
+    /** Alias assigned to the joined table. */
+    joinAlias: string;
+    /** The `ON` condition expression (without the `ON` keyword). */
+    joinCondition: string;
+}
+/**
+ * Per-path-step resolution info that is not tied to a specific JOIN clause.
+ * @public
+ */
+interface RelationshipPathStepJoinInfo {
+    /**
+     * The ordered JOIN clauses to emit — one entry per JOIN. A path step contributes 1 (navigation
+     * property) or 2 (link-table) entries. Note the join-table count is not `joins.length`: an
+     * outer link-table entry (`JoinTargetRelationshipSelect`) wraps a subquery that itself joins the
+     * relationship + target.
+     */
+    joins: RelationshipJoinInfo[];
+    /**
+     * An ECSQL selector that yields the step's concrete relationship `ECClassId` for the actual data
+     * row being traversed. The concept is the same for every step; only the expression differs by how
+     * the relationship is represented:
+     * - link-table step: `[relationship_alias].[ECClassId]` (the joined relationship table),
+     * - navigation-property step: `[owner_alias].[navigation_property_name].[RelECClassId]`, where the
+     *   owner alias is the source or target of the step depending on the navigation property direction.
+     *
+     * Note: for `outer` joins the relationship row / navigation value may be `NULL` when nothing is
+     * related, in which case this selector yields `NULL`.
+     */
+    relationshipClassIdSelector: string;
+    /**
+     * An ECSQL selector that yields the step's concrete source `ECClassId` for the actual data row
+     * being traversed, i.e. `[source_alias].[ECClassId]` of the class the step is joined from.
+     */
+    sourceClassIdSelector: string;
+    /**
+     * An ECSQL selector that yields the step's concrete target `ECClassId` for the actual data row
+     * being traversed, i.e. `[target_alias].[ECClassId]` of the class the step is joined to.
+     *
+     * Note: for `outer` joins the target row may be `NULL` when nothing is related, in which case this
+     * selector yields `NULL`.
+     */
+    targetClassIdSelector: string;
+}
+/**
+ * A resolved, render-ready description of a relationship-path JOIN, as a flat, ordered list of
+ * concrete join clauses. Produced by `createRelationshipPathJoinInfo`; consumed by the
+ * `createRelationshipPathJoinClause` render overload.
+ * @public
+ */
+interface RelationshipPathJoinInfo {
+    /** Per-path-step resolution info, one entry per input path step, in path order. */
+    steps: RelationshipPathStepJoinInfo[];
+    /** `instanceFilter` bindings collected across all steps, or `undefined` when none. */
+    bindings?: Record<string, ECSqlBinding>;
+}
+/**
+ * Resolves a relationship path into a `RelationshipPathJoinInfo` (schema-reading pass; produces no ECSQL).
+ * @public
+ */
+export declare function createRelationshipPathJoinInfo(props: CreateRelationshipPathJoinClauseProps): Promise<RelationshipPathJoinInfo>;
+/**
+ * Result of `createRelationshipPathJoinClause`.
+ * @public
+ */
+interface RelationshipPathJoinClauseResult {
+    joins: string;
+    bindings?: Record<string, ECSqlBinding>;
+}
+/**
+ * Creates an ECSQL JOIN snippet for given relationships' path.
+ *
+ * When a step specifies `instanceFilter`, its resolved expression is appended as an `AND`
+ * condition to the target class JOIN's `ON` clause. In the outer-join case the condition also
+ * appears on the `INNER JOIN` inside the subquery so the pre-joined subquery is already
+ * filtered. Bindings declared in `instanceFilter.bindings` across all steps are collected
+ * and returned alongside the SQL string.
+ *
+ * Possible results:
+ * - When the relationship is represented by a navigation property on either source or target:
+ *   ```SQL
+ *   INNER JOIN [target_schema_name].[target_class_name] [target_alias] ON [target_alias].[navigation_property_name].[Id] = [source_alias].[ECInstanceId]
+ *   ```
+ * - When outer joining through a non-navigation-property relationship:
+ *   ```SQL
+ *   LEFT OUTER JOIN (
+ *     SELECT [relationship_alias].*
+ *     FROM [relationship_schema_name].[relationship_class_name] [relationship_alias]
+ *     INNER JOIN [target_schema_name].[target_class_name] [target_alias] ON [target_alias].[ECInstanceId] = [relationship_alias].[TargetECInstanceId]
+ *   ) [relationship_alias] ON [relationship_alias].[SourceECInstanceId] = [source_alias].[ECInstanceId]
+ *   LEFT OUTER JOIN [target_schema_name].[target_class_name] [target_alias] ON [target_alias].[ECInstanceId] = [relationship_alias].[TargetECInstanceId]
+ *   ```
+ * - When inner joining through a non-navigation-property relationship:
+ *   ```SQL
+ *   INNER JOIN [relationship_schema_name].[relationship_class_name] [relationship_alias] ON [relationship_alias].[SourceECInstanceId] = [source_alias].[ECInstanceId]
+ *   INNER JOIN [target_schema_name].[target_class_name] [target_alias] ON [target_alias].[ECInstanceId] = [relationship_alias].[TargetECInstanceId]
+ *   ```
+ *
+ * @returns An object containing:
+ *   - `joins`: the ECSQL JOIN clause string to embed in a query.
+ *   - `bindings`: ECSQL parameter bindings collected from `instanceFilter.bindings` across all steps,
+ *     or `undefined` if no step specified any bindings.
+ * @public
+ */
+export declare function createRelationshipPathJoinClause(props: CreateRelationshipPathJoinClauseProps): Promise<RelationshipPathJoinClauseResult>;
+/**
+ * Render a pre-resolved `RelationshipPathJoinInfo` into an ECSQL JOIN clause (sync, no schema access).
+ * @public
+ */
+export declare function createRelationshipPathJoinClause(props: RenderRelationshipPathJoinClauseProps): RelationshipPathJoinClauseResult;
+/**
+ * Props for `createRelationshipPathJoinClause` overload that renders a pre-resolved `RelationshipPathJoinInfo` (sync, no schema access).
+ * @public
+ */
+type RenderRelationshipPathJoinClauseProps = Pick<RelationshipPathJoinInfo, "bindings"> & {
+    steps: Array<Pick<RelationshipPathJoinInfo["steps"][number], "joins">>;
+};
+export {};
+//# sourceMappingURL=ECSqlJoinSnippets.d.ts.map

package/lib/shared/ecsql-snippets/ECSqlJoinSnippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ECSqlJoinSnippets.d.ts","sourceRoot":"","sources":["../../../src/shared/ecsql-snippets/ECSqlJoinSnippets.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,EAAE,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEnG;;;GAGG;AACH,UAAU,wBAAyB,SAAQ,oBAAoB;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC9B;AAED;;;GAGG;AACH,KAAK,oBAAoB,GAAG,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,WAAW,qCAAqC;IACpD,cAAc,EAAE,gBAAgB,CAAC;IACjC,IAAI,EAAE,oBAAoB,CAAC;CAC5B;AAED;;;GAGG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,EAAE,CAAC,wBAAwB,CAAC;CACxC;AAED;;;;;GAKG;AACH,UAAU,4BAA4B;IACpC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,qBAAqB,EAAE,EAAE,CAAC,wBAAwB,CAAC;IACnD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2FAA2F;IAC3F,WAAW,EAAE,eAAe,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,8FAA8F;IAC9F,UAAU,EAAE,eAAe,GAAG,4BAA4B,CAAC;IAC3D,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,UAAU,4BAA4B;IACpC;;;;;OAKG;IACH,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B;;;;;;;;;;OAUG;IACH,2BAA2B,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;GAKG;AACH,UAAU,wBAAwB;IAChC,mFAAmF;IACnF,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACtC,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAClD,KAAK,EAAE,qCAAqC,GAC3C,OAAO,CAAC,wBAAwB,CAAC,CAsGnC;AAED;;;GAGG;AACH,UAAU,gCAAgC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,qCAAqC,GAC3C,OAAO,CAAC,gCAAgC,CAAC,CAAC;AAC7C;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,qCAAqC,GAC3C,gCAAgC,CAAC;AAUpC;;;GAGG;AACH,KAAK,qCAAqC,GAAG,IAAI,CAAC,wBAAwB,EAAE,UAAU,CAAC,GAAG;IACxF,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;CACxE,CAAC"}