@itwin/presentation-shared 2.0.0-alpha.0 → 2.0.0-alpha.10

package/lib/esm/shared/instance-label-factory-impls/IModelInstanceLabelSelectClauseFactory.js

@@ -0,0 +1,332 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+// cspell:words rilt
+import { assert } from "@itwin/core-bentley";
+import { createRelationshipPathJoinClause } from "../ecsql-snippets/ECSqlJoinSnippets.js";
+import { createConcatenatedValueJsonSelector, createRawPropertyValueSelector, } from "../ecsql-snippets/ECSqlValueSelectorSnippets.js";
+import { getClass } from "../Metadata.js";
+import { parseFullClassName } from "../Utils.js";
+import { createBisInstanceLabelSelectClauseFactory } from "./BisInstanceLabelSelectClauseFactory.js";
+import { createClassBasedInstanceLabelSelectClauseFactory } from "./ClassBasedInstanceLabelSelectClauseFactory.js";
+/**
+ * Creates an instance label select clause factory that reads `InstanceLabelOverride` rules from
+ * `PresentationRules` rulesets stored in the iModel and compiles them into ECSQL label selectors.
+ *
+ * Rules are loaded lazily on first use and cached per factory instance. Rulesets are discovered
+ * by querying `PresentationRules.Ruleset`. When the `PresentationRules` schema is not imported
+ * into the iModel the factory transparently falls back to `defaultClauseFactory` (defaults
+ * to `createBisInstanceLabelSelectClauseFactory`).
+ *
+ * @public
+ */
+export function createIModelInstanceLabelSelectClauseFactory(props) {
+    let factoryCache;
+    async function getCachedFactory() {
+        if (!factoryCache) {
+            factoryCache = createIModelInstanceLabelSelectClauseFactoryImpl(props);
+        }
+        return factoryCache;
+    }
+    return {
+        async createSelectClause(clauseProps) {
+            const factory = await getCachedFactory();
+            return factory.createSelectClause(clauseProps);
+        },
+    };
+}
+async function createIModelInstanceLabelSelectClauseFactoryImpl(props) {
+    const defaultClauseFactory = props.defaultClauseFactory ??
+        createBisInstanceLabelSelectClauseFactory({ classHierarchyInspector: props.imodelAccess });
+    const rules = await loadOverrideRules(props.imodelAccess);
+    if (rules.length === 0) {
+        return defaultClauseFactory;
+    }
+    rules.sort((lhs, rhs) => (rhs.priority ?? 1000) - (lhs.priority ?? 1000));
+    const clauses = rules.map((rule) => ({
+        className: `${rule.class.schemaName}.${rule.class.className}`,
+        clause: async (clauseProps) => compileOverrideClause({
+            rule,
+            clauseProps,
+            // `innerFactory` is declared below but is already assigned by the time this callback is invoked (never called synchronously)
+            labelFactory: innerFactory,
+            schemaProvider: props.imodelAccess,
+        }),
+    }));
+    const innerFactory = createClassBasedInstanceLabelSelectClauseFactory({
+        classHierarchyInspector: props.imodelAccess,
+        clauses,
+        defaultClauseFactory,
+    });
+    return innerFactory;
+}
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const CLASS_NAME_PresentationRules = "PresentationRules.Ruleset";
+async function loadOverrideRules(executor) {
+    const rules = [];
+    try {
+        const reader = executor.createQueryReader({
+            ecsql: `SELECT json_extract(JsonProperties, '$.jsonProperties') AS jsonProperties FROM ${CLASS_NAME_PresentationRules}`,
+        });
+        for await (const row of reader) {
+            const payload = row.jsonProperties;
+            if (payload === null || payload === undefined) {
+                continue;
+            }
+            let parsed;
+            try {
+                parsed = JSON.parse(payload);
+            }
+            catch {
+                continue;
+            }
+            if (!parsed || typeof parsed !== "object") {
+                continue;
+            }
+            const rulesetObj = parsed;
+            // Collect from top-level rules[]
+            const topRules = Array.isArray(rulesetObj.rules) ? rulesetObj.rules : [];
+            for (const rule of topRules) {
+                const normalized = normalizeInstanceLabelOverrideRule(rule);
+                if (normalized) {
+                    rules.push(normalized);
+                }
+            }
+        }
+    }
+    catch (e) {
+        if (isPresentationRulesSchemaAbsenceError(e)) {
+            return [];
+        }
+        throw e;
+    }
+    return rules;
+}
+function isPresentationRulesSchemaAbsenceError(e) {
+    if (!(e instanceof Error)) {
+        return false;
+    }
+    return e.message.includes(`'${CLASS_NAME_PresentationRules}' does not exist`);
+}
+function isInstanceLabelOverrideRule(rule) {
+    return rule.ruleType === "InstanceLabelOverride";
+}
+function normalizeInstanceLabelOverrideRule(rule) {
+    if (!isInstanceLabelOverrideRule(rule)) {
+        return undefined;
+    }
+    if (rule.values.length === 0) {
+        return undefined;
+    }
+    return rule;
+}
+async function compileOverrideClause(props) {
+    const { rule, clauseProps, labelFactory, schemaProvider } = props;
+    assert(rule.values.length > 0);
+    const ctx = {
+        classAlias: clauseProps.classAlias,
+        selectorsConcatenator: clauseProps.selectorsConcatenator ?? createConcatenatedValueJsonSelector,
+        labelFactory,
+        visitedClasses: clauseProps.visitedClasses ?? new Set(),
+        schemaProvider,
+        ruleClassName: `${rule.class.schemaName}.${rule.class.className}`,
+        depth: clauseProps.depth ?? 0,
+    };
+    const compiledSpecs = await Promise.all(rule.values.map(async (spec) => compileValueSpec(spec, ctx)));
+    if (compiledSpecs.length === 1) {
+        return compiledSpecs[0];
+    }
+    return `COALESCE(${compiledSpecs.join(", ")})`;
+}
+async function compileValueSpec(spec, ctx) {
+    switch (spec.specType) {
+        case "String": {
+            return ctx.selectorsConcatenator([{ value: spec.value, type: "String" }]);
+        }
+        case "Property": {
+            if (spec.propertySource) {
+                const steps = normalizeRelationshipPath(spec.propertySource);
+                if (steps.length === 0) {
+                    return "NULL";
+                }
+                const finalTargetAlias = subqueryAlias(PROPERTY_SOURCE_TARGET_ALIAS, ctx.depth);
+                const subquery = await buildRelationshipPathSubquery({
+                    schemaProvider: ctx.schemaProvider,
+                    steps,
+                    ruleClassName: ctx.ruleClassName,
+                    classAlias: ctx.classAlias,
+                    selectExpression: createRawPropertyValueSelector(finalTargetAlias, spec.propertyName),
+                    finalTargetAlias,
+                    depth: ctx.depth,
+                });
+                return subquery;
+            }
+            return createRawPropertyValueSelector(ctx.classAlias, spec.propertyName);
+        }
+        case "ClassName": {
+            return `ec_classname(${createRawPropertyValueSelector(ctx.classAlias, "ECClassId")}, '${spec.full ? "s.c" : "c"}')`;
+        }
+        case "ClassLabel": {
+            return `(
+        SELECT COALESCE(
+          ${createRawPropertyValueSelector("c", "DisplayLabel")},
+          ${createRawPropertyValueSelector("c", "Name")}
+        )
+        FROM [meta].[ECClassDef] AS [c]
+        WHERE [c].[ECInstanceId] = ${createRawPropertyValueSelector(ctx.classAlias, "ECClassId")}
+      )`;
+        }
+        case "BriefcaseId": {
+            return `CAST(base36(${createRawPropertyValueSelector(ctx.classAlias, "ECInstanceId")} >> 40) AS TEXT)`;
+        }
+        case "LocalId": {
+            return `CAST(base36(${createRawPropertyValueSelector(ctx.classAlias, "ECInstanceId")} & ((1 << 40) - 1)) AS TEXT)`;
+        }
+        case "Composite": {
+            return compileCompositeSpec(spec, ctx);
+        }
+        case "RelatedInstanceLabel": {
+            const steps = normalizeRelationshipPath(spec.pathToRelatedInstance);
+            if (steps.length === 0) {
+                return "NULL";
+            }
+            const lastStep = steps[steps.length - 1];
+            let targetClassName;
+            if (lastStep.targetClass) {
+                targetClassName = `${lastStep.targetClass.schemaName}.${lastStep.targetClass.className}`;
+            }
+            else {
+                const relName = `${lastStep.relationship.schemaName}.${lastStep.relationship.className}`;
+                const relClass = await getClass(ctx.schemaProvider, relName);
+                if (!relClass.isRelationshipClass()) {
+                    throw new Error(`Class ${relName} is not a relationship class`);
+                }
+                const endpoint = lastStep.direction === "Backward" ? relClass.source : relClass.target;
+                const constraintClass = await endpoint.abstractConstraint;
+                if (!constraintClass) {
+                    return "''";
+                }
+                targetClassName = constraintClass.fullName;
+            }
+            if (ctx.visitedClasses.has(targetClassName)) {
+                return "NULL";
+            }
+            const finalTargetAlias = subqueryAlias(RELATED_INSTANCE_LABEL_TARGET_ALIAS, ctx.depth);
+            const selectClauseProps = {
+                classAlias: finalTargetAlias,
+                className: targetClassName,
+                selectorsConcatenator: ctx.selectorsConcatenator,
+                visitedClasses: new Set(ctx.visitedClasses).add(targetClassName),
+                depth: ctx.depth + 1,
+            };
+            const subquery = await buildRelationshipPathSubquery({
+                schemaProvider: ctx.schemaProvider,
+                steps,
+                ruleClassName: ctx.ruleClassName,
+                classAlias: ctx.classAlias,
+                selectExpression: await ctx.labelFactory.createSelectClause(selectClauseProps),
+                finalTargetAlias,
+                depth: ctx.depth,
+            });
+            return subquery;
+        }
+    }
+}
+async function compileCompositeSpec(spec, ctx) {
+    if (spec.parts.length === 0) {
+        return "''";
+    }
+    const separator = spec.separator ?? " ";
+    const compiledParts = await Promise.all(spec.parts.map(async (part) => ({
+        selector: await compileValueSpec(part.spec, ctx),
+        isRequired: !!part.isRequired,
+    })));
+    const selectors = [];
+    compiledParts.forEach(({ selector }, index) => {
+        if (index > 0 && separator) {
+            selectors.push({ value: separator, type: "String" });
+        }
+        selectors.push({ selector });
+    });
+    const checkSelectors = compiledParts.filter((p) => p.isRequired).map((p) => `IFNULL(${p.selector}, '') <> ''`);
+    const checkSelector = checkSelectors.length > 0 ? checkSelectors.join(" AND ") : undefined;
+    return ctx.selectorsConcatenator(selectors, checkSelector);
+}
+function normalizeRelationshipPath(path) {
+    return Array.isArray(path) ? path : [path];
+}
+const ALIAS_PREFIX = "pres_";
+const SUBQUERY_SOURCE_ALIAS = "src";
+const PROPERTY_SOURCE_TARGET_ALIAS = "pst";
+const RELATED_INSTANCE_LABEL_TARGET_ALIAS = "rilt";
+const RELATIONSHIP_ALIAS = "r";
+const INTERMEDIATE_TARGET_ALIAS = "m";
+function subqueryAlias(prefix, depth, stepIndex) {
+    const alias = `${ALIAS_PREFIX}${prefix}${depth}`;
+    return stepIndex !== undefined ? `${alias}_${stepIndex}` : alias;
+}
+async function toJoinRelationshipPath(props) {
+    assert(props.steps.length > 0);
+    const result = [];
+    let currentSourceClassName = props.sourceClassName;
+    let currentSourceAlias = props.sourceAlias;
+    for (let i = 0; i < props.steps.length; i++) {
+        const step = props.steps[i];
+        const relationshipName = `${step.relationship.schemaName}.${step.relationship.className}`;
+        const relationshipReverse = step.direction === "Backward";
+        let targetClassName;
+        if (step.targetClass) {
+            targetClassName = `${step.targetClass.schemaName}.${step.targetClass.className}`;
+        }
+        else {
+            const relClass = await getClass(props.schemaProvider, relationshipName);
+            if (!relClass.isRelationshipClass()) {
+                throw new Error(`Class ${relationshipName} is not a relationship class`);
+            }
+            const endpoint = relationshipReverse ? relClass.source : relClass.target;
+            const constraintClass = await endpoint.abstractConstraint;
+            if (!constraintClass) {
+                throw new Error(`Relationship's ${relationshipName} endpoint does not have an abstract constraint`);
+            }
+            targetClassName = constraintClass.fullName;
+        }
+        const isLastStep = i === props.steps.length - 1;
+        const targetAlias = isLastStep ? props.finalTargetAlias : subqueryAlias(INTERMEDIATE_TARGET_ALIAS, props.depth, i);
+        const relationshipAlias = subqueryAlias(RELATIONSHIP_ALIAS, props.depth, i);
+        result.push({
+            sourceClassName: currentSourceClassName,
+            targetClassName,
+            relationshipName,
+            relationshipReverse,
+            sourceAlias: currentSourceAlias,
+            targetAlias,
+            relationshipAlias,
+        });
+        currentSourceClassName = targetClassName;
+        currentSourceAlias = targetAlias;
+    }
+    return result;
+}
+async function buildRelationshipPathSubquery(props) {
+    assert(props.steps.length > 0);
+    const sourceAlias = subqueryAlias(SUBQUERY_SOURCE_ALIAS, props.depth);
+    const joinPath = await toJoinRelationshipPath({
+        schemaProvider: props.schemaProvider,
+        steps: props.steps,
+        sourceClassName: props.ruleClassName,
+        sourceAlias,
+        finalTargetAlias: props.finalTargetAlias,
+        depth: props.depth,
+    });
+    const joinClauses = await createRelationshipPathJoinClause({ schemaProvider: props.schemaProvider, path: joinPath });
+    const { schemaName, className } = parseFullClassName(props.ruleClassName);
+    return `(
+    SELECT ${props.selectExpression}
+    FROM [${schemaName}].[${className}] [${sourceAlias}]
+    ${joinClauses}
+    WHERE [${sourceAlias}].[ECInstanceId] = [${props.classAlias}].[ECInstanceId]
+    LIMIT 1
+  )`;
+}
+//# sourceMappingURL=IModelInstanceLabelSelectClauseFactory.js.map

package/lib/esm/shared/instance-label-factory-impls/IModelInstanceLabelSelectClauseFactory.js.map

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

package/lib/esm/shared/instance-label-factory-impls/Utils.d.ts

@@ -0,0 +1,6 @@
+import type { TypedValueSelectClauseProps } from "../ecsql-snippets/ECSqlValueSelectorSnippets.js";
+export declare function createECInstanceIdSuffixSelectors(classAlias: string): TypedValueSelectClauseProps[];
+export declare function concatenate(props: {
+    selectorsConcatenator?: (selectors: TypedValueSelectClauseProps[], checkSelector?: string) => string;
+}, selectors: TypedValueSelectClauseProps[], checkSelector?: string): string;
+//# sourceMappingURL=Utils.d.ts.map

package/lib/esm/shared/instance-label-factory-impls/Utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.d.ts","sourceRoot":"","sources":["../../../../src/shared/instance-label-factory-impls/Utils.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAEnG,wBAAgB,iCAAiC,CAAC,UAAU,EAAE,MAAM,GAAG,2BAA2B,EAAE,CAUnG;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE;IAAE,qBAAqB,CAAC,EAAE,CAAC,SAAS,EAAE,2BAA2B,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CAAE,EAC/G,SAAS,EAAE,2BAA2B,EAAE,EACxC,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAER"}

package/lib/esm/shared/instance-label-factory-impls/Utils.js

@@ -0,0 +1,20 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { createConcatenatedValueJsonSelector, createRawPropertyValueSelector, } from "../ecsql-snippets/ECSqlValueSelectorSnippets.js";
+export function createECInstanceIdSuffixSelectors(classAlias) {
+    return [
+        { value: ` [`, type: "String" },
+        { selector: `CAST(base36(${createRawPropertyValueSelector(classAlias, "ECInstanceId")} >> 40) AS TEXT)` },
+        { value: `-`, type: "String" },
+        {
+            selector: `CAST(base36(${createRawPropertyValueSelector(classAlias, "ECInstanceId")} & ((1 << 40) - 1)) AS TEXT)`,
+        },
+        { value: `]`, type: "String" },
+    ];
+}
+export function concatenate(props, selectors, checkSelector) {
+    return (props.selectorsConcatenator ?? createConcatenatedValueJsonSelector)(selectors, checkSelector);
+}
+//# sourceMappingURL=Utils.js.map

package/lib/esm/shared/instance-label-factory-impls/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../../../src/shared/instance-label-factory-impls/Utils.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG,OAAO,EACL,mCAAmC,EACnC,8BAA8B,GAC/B,MAAM,iDAAiD,CAAC;AAIzD,MAAM,UAAU,iCAAiC,CAAC,UAAkB;IAClE,OAAO;QACL,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC/B,EAAE,QAAQ,EAAE,eAAe,8BAA8B,CAAC,UAAU,EAAE,cAAc,CAAC,kBAAkB,EAAE;QACzG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B;YACE,QAAQ,EAAE,eAAe,8BAA8B,CAAC,UAAU,EAAE,cAAc,CAAC,8BAA8B;SAClH;QACD,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE;KAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAA+G,EAC/G,SAAwC,EACxC,aAAsB;IAEtB,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,mCAAmC,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AACxG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/presentation-shared",
-  "version": "2.0.0-alpha.0",
+  "version": "2.0.0-alpha.10",
   "description": "The package contains types and utilities used across different iTwin.js Presentation packages.",
   "license": "MIT",
   "author": {
@@ -32,37 +32,29 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@itwin/core-bentley": "^4.10.10"
+    "@itwin/core-bentley": "^5.8.0"
   },
   "devDependencies": {
-    "@itwin/build-tools": "5.0.0-dev.67",
-    "@itwin/eslint-plugin": "5.0.0-dev.1",
-    "@types/chai": "^5.2.0",
-    "@types/chai-as-promised": "^8.0.2",
-    "@types/mocha": "^10.0.10",
-    "@types/node": "^22.13.9",
-    "@types/sinon": "^17.0.4",
-    "@types/sinon-chai": "^4.0.0",
-    "c8": "^10.1.3",
-    "chai": "^5.2.0",
-    "chai-as-promised": "^8.0.1",
-    "eslint": "^9.13.0",
-    "mocha": "^11.1.0",
-    "rimraf": "^6.0.1",
-    "sinon": "^19.0.4",
-    "sinon-chai": "^4.0.0",
+    "@itwin/build-tools": "^5.8.0",
+    "@itwin/eslint-plugin": "5.1.0",
+    "@types/node": "^24.12.2",
+    "@vitest/coverage-v8": "^4.1.3",
+    "eslint": "^9.39.4",
+    "rimraf": "^6.1.3",
     "typescript": "~5.7.3",
-    "presentation-test-utilities": "^0.0.0"
+    "vitest": "^4.1.3",
+    "presentation-test-utilities": "0.0.1"
   },
   "scripts": {
-    "build": "npm run -s build:cjs && npm run -s build:esm",
+    "build": "npm run -s typecheck && npm run -s build:cjs && npm run -s build:esm",
     "build:cjs": "node ../../scripts/package-cjs.mjs ./lib/cjs && tsc -p tsconfig.cjs.json",
     "build:esm": "tsc -p tsconfig.esm.json",
     "clean": "rimraf lib temp",
-    "cover": "c8 npm -s test",
+    "cover": "vitest run --coverage",
     "lint": "eslint \"./src/**/*.ts\"",
-    "test:dev": "mocha --enable-source-maps --config ./.mocharc.json",
-    "test": "npm run test:dev",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "extract-api": "betools extract-api --entry=presentation-shared --apiReportFolder=./api --apiReportTempFolder=./api/temp --apiSummaryFolder=./api --includeUnexportedApis",
     "check-internal": "node ../../scripts/checkInternal.js --apiSummary ./api/presentation-shared.api.md",
     "validate-markdowns": "node ../../scripts/validateMarkdowns.js README.md"