1.3.0

.devcontainer/readme.md

@@ -6,8 +6,8 @@ Ensure both Containers and Hyper-V are enabled in Windows.
 
 - Open the Start Menu and starting typing "Turn Windows features on or off" to select it
 - Ensure both 'Containers' and all of 'Hyper-V' are enabled.
-  - [Hyper-V MS Docs](https://docs.microsoft.com/en-us/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v)
-  - [Container MS Docs](https://docs.microsoft.com/en-us/virtualization/windowscontainers/quick-start/quick-start-windows-10-linux)
+  - [Hyper-V MS Docs](https://docs.microsoft.com/virtualization/hyper-v-on-windows/quick-start/enable-hyper-v)
+  - [Container MS Docs](https://docs.microsoft.com/virtualization/windowscontainers/quick-start/quick-start-windows-10-linux)
   - Hyper-V requires that virtualization is enabled in your BIOS. Every BIOS is different, so use Google or ask around if you encounter related errors.
 
 Install [Docker CE](https://hub.docker.com/editions/community/docker-ce-desktop-windows) ([direct](https://download.docker.com/win/stable/Docker%20for%20Windows%20Installer.exe)). Keep all defaults. Tested with version 2.0.0.3 (engine 18.09.2); newer versions should likely work as well.

.gitattributes

@@ -1,2 +1,9 @@
 package.json text eol=lf
 package-lock.json text eol=lf
+
+# Don't allow people to merge changes to these generated files, because the result
+# may be invalid.  You need to run "rush update" again.
+pnpm-lock.yaml               merge=binary
+shrinkwrap.yaml              merge=binary
+npm-shrinkwrap.json          merge=binary
+yarn.lock                    merge=binary

.vscode/cSpell.json

@@ -129,6 +129,7 @@
         "keyboardshortcut",
         "keyin",
         "keyinbrowser",
+        "keyins",
         "Keypoint",
         "Kubernetes",
         "languagedetector",
@@ -151,12 +152,14 @@
         "modelselector",
         "modularized",
         "monorepo",
+        "Multipass",
         "Mutex",
         "NEEDSWORK",
         "ninezone",
         "nodeaddonapi",
         "nonconvex",
         "nonnull",
+        "nonsingular",
         "nullptr",
         "numericinput",
         "numeronyms",
@@ -200,6 +203,7 @@
         "Renormalize",
         "renormalized",
         "Resizer",
+        "Resymbolization",
         "roadmap",
         "ruleset",
         "rulesets",
@@ -222,6 +226,7 @@
         "svgdotjs",
         "svgjs",
         "Svgs",
+        "sweepable",
         "symb",
         "symbologies",
         "symbology",
@@ -274,6 +279,7 @@
         "XYZUVW",
         "XYZW",
         "XYZXYZ",
+        "xyzxyzxyz",
         "zbuffer"
     ],
     // flagWords - list of words to be always considered incorrect

.vscode/launch.json

@@ -530,7 +530,7 @@
       "request": "launch",
       "name": "Debug buildIModelJsModule",
       "program": "${workspaceRoot}/core/bentley/node_modules/@bentley/webpack-tools/lib/buildIModelJsModule.js",
-      "cwd": "${workspaceRoot}/test-apps/ui-test-app/",
+      "cwd": "${workspaceRoot}/plugins/wms/",
       "outFiles": [
         "${workspaceRoot}/core/bentley/node_modules/@bentley/webpack-tools/lib/*.js",
       ],

.vscode/settings.json

@@ -40,6 +40,7 @@
     "Linestyle",
     "Memoized",
     "Millis",
+    "Multipass",
     "Mutex",
     "NEEDSWORK",
     "Nums",
@@ -53,6 +54,7 @@
     "Reimplement",
     "Renormalize",
     "Resizer",
+    "Resymbolization",
     "Serializable",
     "Strokable",
     "Svgs",
@@ -159,6 +161,7 @@
     "keyboardshortcut",
     "keyin",
     "keyinbrowser",
+    "keyins",
     "languagedetector",
     "lifecycle",
     "linestring",
@@ -178,6 +181,7 @@
     "nodeaddonapi",
     "nonconvex",
     "nonnull",
+    "nonsingular",
     "nullptr",
     "numericinput",
     "numeronyms",
@@ -219,6 +223,7 @@
     "superset",
     "svgdotjs",
     "svgjs",
+    "sweepable",
     "symb",
     "symbologies",
     "syncui",
@@ -254,6 +259,7 @@
     "w",
     "withispressed",
     "xyxy",
+    "xyzxyzxyz",
     "zbuffer"
   ],
   "typescript.tsdk": "node_modules\\typescript\\lib",

README.md

@@ -1,8 +1,8 @@
-# The iModel.js Library
+# iModel.js
 
 Copyright © Bentley Systems, Incorporated. All rights reserved.
 
-The [iModel.js](http://imodeljs.org) library is an open source platform for creating, querying, modifying, and displaying Infrastructure Digital Twins.
+[iModel.js](http://imodeljs.org) is an open source platform for creating, querying, modifying, and displaying Infrastructure Digital Twins.
 
 If you have questions, or wish to contribute to iModel.js, see our [Contributing guide](./CONTRIBUTING.md).
 

common/api/ecschema-metadata.api.md

@@ -1055,7 +1055,7 @@ export abstract class FormatDiagnosticReporter extends SuppressionDiagnosticRepo
     reportInternal(diagnostic: AnyDiagnostic): void;
     }
 
-// @internal (undocumented)
+// @internal
 export const formatStringRgx: RegExp;
 
 // @beta
@@ -1137,9 +1137,6 @@ export enum FractionalPrecision {
     TwoHundredFiftySix = 256
 }
 
-// @internal
-export function generateFormatString(format: Format | OverrideFormat): string;
-
 // @internal
 export function getItemNamesFromFormatString(formatString: string): Iterable<string>;
 
@@ -1344,22 +1341,19 @@ export class KindOfQuantity extends SchemaItem {
     constructor(schema: Schema, name: string);
     // (undocumented)
     protected addPresentationFormat(format: Format | OverrideFormat, isDefault?: boolean): void;
-    // (undocumented)
-    protected createFormatOverride(parent: Format, name: string, precision?: number, unitLabelOverrides?: Array<[Unit | InvertedUnit, string | undefined]>): OverrideFormat;
-    // (undocumented)
-    readonly defaultPresentationFormat: undefined | Format | OverrideFormat;
+    protected createFormatOverride(parent: Format, precision?: number, unitLabelOverrides?: Array<[Unit | InvertedUnit, string | undefined]>): OverrideFormat;
+    readonly defaultPresentationFormat: Format | OverrideFormat | undefined;
     // (undocumented)
     deserialize(kindOfQuantityProps: KindOfQuantityProps): Promise<void>;
     // (undocumented)
     deserializeSync(kindOfQuantityProps: KindOfQuantityProps): void;
     // (undocumented)
-    persistenceUnit: LazyLoadedUnit | LazyLoadedInvertedUnit | undefined;
+    readonly persistenceUnit: LazyLoadedUnit | LazyLoadedInvertedUnit | undefined;
     // (undocumented)
     protected _persistenceUnit?: LazyLoadedUnit | LazyLoadedInvertedUnit;
+    readonly presentationFormats: Array<Format | OverrideFormat>;
     // (undocumented)
-    readonly presentationUnits: Array<Format | OverrideFormat> | undefined;
-    // (undocumented)
-    protected _presentationUnits: Array<Format | OverrideFormat>;
+    protected _presentationFormats: Array<Format | OverrideFormat>;
     // (undocumented)
     readonly relativeError: number;
     // (undocumented)
@@ -1501,13 +1495,15 @@ export interface NoDelayedPromiseMethods {
 // @beta
 export class OverrideFormat {
     constructor(parent: Format, precision?: DecimalPrecision | FractionalPrecision, unitAndLabels?: Array<[Unit | InvertedUnit, string | undefined]>);
-    static createOverrideFormatFullName(parent: Format, unitAndLabels?: Array<[Unit | InvertedUnit, string | undefined]>): string;
+    static createOverrideFormatFullName(parent: Format, precision?: DecimalPrecision | FractionalPrecision, unitAndLabels?: Array<[Unit | InvertedUnit, string | undefined]>): string;
     // (undocumented)
     readonly decimalSeparator: string;
     // (undocumented)
     readonly formatTraits: FormatTraits;
     // (undocumented)
     readonly fullName: string;
+    // @alpha
+    fullNameXml(koqSchema: Schema): string;
     // (undocumented)
     hasFormatTrait(formatTrait: FormatTraits): boolean;
     // (undocumented)
@@ -2251,7 +2247,7 @@ export const SchemaCompareDiagnostics: {
     };
     SchemaItemDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2263,7 +2259,7 @@ export const SchemaCompareDiagnostics: {
     };
     SchemaItemMissing: {
         new (ecDefinition: SchemaItem, messageArgs: []): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2321,7 +2317,7 @@ export const SchemaCompareDiagnostics: {
     };
     EntityMixinMissing: {
         new (ecDefinition: SchemaItem, messageArgs: [Mixin]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2333,7 +2329,7 @@ export const SchemaCompareDiagnostics: {
     };
     MixinDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2345,7 +2341,7 @@ export const SchemaCompareDiagnostics: {
     };
     RelationshipDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2360,7 +2356,7 @@ export const SchemaCompareDiagnostics: {
             readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
-            readonly schema: Schema;
+            readonly schema: Schema; /** Required message parameters: property name, property A value, property B value  */
             readonly diagnosticType: import("./Diagnostic").DiagnosticType;
             ecDefinition: import("../Metadata/RelationshipClass").RelationshipConstraint;
             messageArgs?: [string, any, any] | undefined;
@@ -2371,15 +2367,15 @@ export const SchemaCompareDiagnostics: {
             readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
-            readonly schema: Schema;
+            readonly schema: Schema; /** Required message parameters: property name, property A value, property B value  */
             readonly diagnosticType: import("./Diagnostic").DiagnosticType;
             ecDefinition: import("../Metadata/RelationshipClass").RelationshipConstraint;
             messageArgs?: [AnyClass] | undefined;
         };
     };
     CustomAttributeClassDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2402,7 +2398,7 @@ export const SchemaCompareDiagnostics: {
     };
     EnumerationDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, string, string]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2414,7 +2410,7 @@ export const SchemaCompareDiagnostics: {
     };
     EnumeratorMissing: {
         new (ecDefinition: SchemaItem, messageArgs: [import("../Metadata/Enumeration").Enumerator<string | number>]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2426,7 +2422,7 @@ export const SchemaCompareDiagnostics: {
     };
     EnumeratorDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [import("../Metadata/Enumeration").Enumerator<string | number>, string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2438,7 +2434,7 @@ export const SchemaCompareDiagnostics: {
     };
     KoqDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2450,7 +2446,7 @@ export const SchemaCompareDiagnostics: {
     };
     PresentationUnitMissing: {
         new (ecDefinition: SchemaItem, messageArgs: [Format | OverrideFormat]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2462,7 +2458,7 @@ export const SchemaCompareDiagnostics: {
     };
     PropertyCategoryDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2474,7 +2470,7 @@ export const SchemaCompareDiagnostics: {
     };
     FormatDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, any, any]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2486,7 +2482,7 @@ export const SchemaCompareDiagnostics: {
     };
     FormatUnitMissing: {
         new (ecDefinition: SchemaItem, messageArgs: [Unit | InvertedUnit]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2498,7 +2494,7 @@ export const SchemaCompareDiagnostics: {
     };
     UnitLabelOverrideDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [Unit | InvertedUnit, string | undefined, string | undefined]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2510,7 +2506,7 @@ export const SchemaCompareDiagnostics: {
     };
     UnitDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, string, string]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2522,7 +2518,7 @@ export const SchemaCompareDiagnostics: {
     };
     InvertedUnitDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, string, string]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2534,7 +2530,7 @@ export const SchemaCompareDiagnostics: {
     };
     PhenomenonDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, string, string]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;
@@ -2546,7 +2542,7 @@ export const SchemaCompareDiagnostics: {
     };
     ConstantDelta: {
         new (ecDefinition: SchemaItem, messageArgs: [string, string, string]): {
-            readonly code: string; /** Required message parameters: property name, property A value, property B value  */
+            readonly code: string;
             readonly category: import("./Diagnostic").DiagnosticCategory;
             readonly messageText: string;
             readonly schema: Schema;