@itwin/core-quantity 5.9.1 → 5.9.2

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Change Log - @itwin/core-quantity
 
-This log was last generated on Tue, 05 May 2026 17:43:30 GMT and should not be manually modified.
+This log was last generated on Fri, 08 May 2026 20:36:41 GMT and should not be manually modified.
+
+## 5.9.2
+Fri, 08 May 2026 20:36:41 GMT
+
+### Updates
+
+- Fix FormatSpecHandle stale state during onFormattingReady
 
 ## 5.9.1
 Tue, 05 May 2026 17:43:30 GMT

package/lib/cjs/FormatSpecHandle.d.ts

@@ -9,22 +9,20 @@ import type { UnitSystemKey } from "./Interfaces";
  * @internal
  */
 export interface FormatSpecHandleArgs extends FormattingSpecArgs {
-    /** The provider that supplies spec lookups and reload events. */
+    /** The provider that supplies current formatting spec lookups. */
     provider: FormattingSpecProvider;
 }
-/** A cacheable handle to formatting and parsing specs for a specific KoQ and persistence unit.
- * Automatically refreshes when the QuantityFormatter reloads. Use [[QuantityFormatter.getFormatSpecHandle]]
+/** A handle to formatting and parsing specs for a specific KoQ and persistence unit.
+ * Reads the current specs from the provider on access. Use [[QuantityFormatter.getFormatSpecHandle]]
  * to create instances.
  *
  * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.
- * Call [[dispose]] when the handle is no longer needed to unsubscribe from reload events.
+ * Dispose the handle when it is no longer needed to invalidate it.
  *
  * @beta
  */
 export declare class FormatSpecHandle implements Disposable {
-    private _formatterSpec;
-    private _parserSpec;
-    private _removeListener;
+    private _disposed;
     private readonly _provider;
     private readonly _koqName;
     private readonly _persistenceUnit;
@@ -47,10 +45,11 @@ export declare class FormatSpecHandle implements Disposable {
      * @returns The formatted string.
      */
     format(value: number): string;
-    /** Unsubscribe from reload events and clear cached specs.
-     * Idempotent and safe to call during a pending reload.
+    /** Invalidate this handle.
+     * Idempotent and safe to call multiple times.
+     * No additional teardown is required because the handle owns no external resources.
      */
     [Symbol.dispose](): void;
-    private _refresh;
+    private _getEntry;
 }
 //# sourceMappingURL=FormatSpecHandle.d.ts.map

package/lib/cjs/FormatSpecHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormatSpecHandle.d.ts","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAuB,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,iEAAiE;IACjE,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,gBAAgB;gBACJ,IAAI,EAAE,oBAAoB;IAWtC,4CAA4C;IAC5C,IAAW,OAAO,IAAI,MAAM,CAA0B;IAEtD,oDAAoD;IACpD,IAAW,eAAe,IAAI,MAAM,CAAkC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,IAAI,aAAa,GAAG,SAAS,CAAyB;IAEvE,iEAAiE;IACjE,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAAgC;IAErF,8DAA8D;IAC9D,IAAW,UAAU,IAAI,UAAU,GAAG,SAAS,CAA6B;IAE5E;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMpC;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAS/B,OAAO,CAAC,QAAQ;CAiBjB"}
+{"version":3,"file":"FormatSpecHandle.d.ts","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAuB,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,kEAAkE;IAClE,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,gBAAgB;gBACJ,IAAI,EAAE,oBAAoB;IAOtC,4CAA4C;IAC5C,IAAW,OAAO,IAAI,MAAM,CAA0B;IAEtD,oDAAoD;IACpD,IAAW,eAAe,IAAI,MAAM,CAAkC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,IAAI,aAAa,GAAG,SAAS,CAAyB;IAEvE,iEAAiE;IACjE,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAA4C;IAEjG,8DAA8D;IAC9D,IAAW,UAAU,IAAI,UAAU,GAAG,SAAS,CAAyC;IAExF;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOpC;;;OAGG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAI/B,OAAO,CAAC,SAAS;CAUlB"}

package/lib/cjs/FormatSpecHandle.js

@@ -5,19 +5,17 @@
 *--------------------------------------------------------------------------------------------*/
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FormatSpecHandle = void 0;
-/** A cacheable handle to formatting and parsing specs for a specific KoQ and persistence unit.
- * Automatically refreshes when the QuantityFormatter reloads. Use [[QuantityFormatter.getFormatSpecHandle]]
+/** A handle to formatting and parsing specs for a specific KoQ and persistence unit.
+ * Reads the current specs from the provider on access. Use [[QuantityFormatter.getFormatSpecHandle]]
  * to create instances.
  *
  * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.
- * Call [[dispose]] when the handle is no longer needed to unsubscribe from reload events.
+ * Dispose the handle when it is no longer needed to invalidate it.
  *
  * @beta
  */
 class FormatSpecHandle {
-    _formatterSpec;
-    _parserSpec;
-    _removeListener;
+    _disposed = false;
     _provider;
     _koqName;
     _persistenceUnit;
@@ -28,10 +26,6 @@ class FormatSpecHandle {
         this._koqName = args.name;
         this._persistenceUnit = args.persistenceUnitName;
         this._system = args.system;
-        this._removeListener = args.provider.onFormattingReady.addListener(() => {
-            this._refresh();
-        });
-        this._refresh();
     }
     /** The KoQ name this handle is keyed to. */
     get koqName() { return this._koqName; }
@@ -40,47 +34,35 @@ class FormatSpecHandle {
     /** The unit system this handle is pinned to, or `undefined` for the active system. */
     get system() { return this._system; }
     /** The current FormatterSpec, or undefined if not yet loaded. */
-    get formatterSpec() { return this._formatterSpec; }
+    get formatterSpec() { return this._getEntry()?.formatterSpec; }
     /** The current ParserSpec, or undefined if not yet loaded. */
-    get parserSpec() { return this._parserSpec; }
+    get parserSpec() { return this._getEntry()?.parserSpec; }
     /** Format a quantity value using the current spec.
      * If the formatter is not yet ready, returns `value.toString()` as a fallback.
      * @param value - The numeric value to format.
      * @returns The formatted string.
      */
     format(value) {
-        if (!this._formatterSpec)
+        const formatterSpec = this.formatterSpec;
+        if (!formatterSpec)
             return value.toString();
-        return this._provider.formatQuantity(value, this._formatterSpec);
+        return this._provider.formatQuantity(value, formatterSpec);
     }
-    /** Unsubscribe from reload events and clear cached specs.
-     * Idempotent and safe to call during a pending reload.
+    /** Invalidate this handle.
+     * Idempotent and safe to call multiple times.
+     * No additional teardown is required because the handle owns no external resources.
      */
     [Symbol.dispose]() {
-        if (this._removeListener) {
-            this._removeListener();
-            this._removeListener = undefined;
-        }
-        this._formatterSpec = undefined;
-        this._parserSpec = undefined;
+        this._disposed = true;
     }
-    _refresh() {
-        // Guard against mid-emission callbacks after dispose() — event may still fire during iteration.
-        if (!this._removeListener)
-            return;
-        const entry = this._provider.getSpecsByNameAndUnit({
+    _getEntry() {
+        if (this._disposed)
+            return undefined;
+        return this._provider.getSpecsByNameAndUnit({
             name: this._koqName,
             persistenceUnitName: this._persistenceUnit,
             system: this._system,
         });
-        if (entry) {
-            this._formatterSpec = entry.formatterSpec;
-            this._parserSpec = entry.parserSpec;
-        }
-        else {
-            this._formatterSpec = undefined;
-            this._parserSpec = undefined;
-        }
     }
 }
 exports.FormatSpecHandle = FormatSpecHandle;

package/lib/cjs/FormatSpecHandle.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormatSpecHandle.js","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAmB/F;;;;;;;;GAQG;AACH,MAAa,gBAAgB;IACnB,cAAc,CAA4B;IAC1C,WAAW,CAAyB;IACpC,eAAe,CAA2B;IACjC,SAAS,CAAyB;IAClC,QAAQ,CAAS;IACjB,gBAAgB,CAAS;IACzB,OAAO,CAA4B;IAEpD,gBAAgB;IAChB,YAAY,IAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE;YACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,4CAA4C;IAC5C,IAAW,OAAO,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,oDAAoD;IACpD,IAAW,eAAe,KAAa,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,KAAgC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvE,iEAAiE;IACjE,IAAW,aAAa,KAAgC,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAErF,8DAA8D;IAC9D,IAAW,UAAU,KAA6B,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5E;;;;OAIG;IACI,MAAM,CAAC,KAAa;QACzB,IAAI,CAAC,IAAI,CAAC,cAAc;YACtB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAEO,QAAQ;QACd,gGAAgG;QAChG,IAAI,CAAC,IAAI,CAAC,eAAe;YACvB,OAAO;QACT,MAAM,KAAK,GAAoC,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;YAClF,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,mBAAmB,EAAE,IAAI,CAAC,gBAAgB;YAC1C,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AA5ED,4CA4EC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport type { FormatterSpec } from \"./Formatter/FormatterSpec\";\nimport type { FormattingSpecArgs, FormattingSpecEntry, FormattingSpecProvider } from \"./Formatter/Interfaces\";\nimport type { ParserSpec } from \"./ParserSpec\";\nimport type { UnitSystemKey } from \"./Interfaces\";\n\n/** Arguments for constructing a [[FormatSpecHandle]].\n * @internal\n */\nexport interface FormatSpecHandleArgs extends FormattingSpecArgs {\n  /** The provider that supplies spec lookups and reload events. */\n  provider: FormattingSpecProvider;\n}\n\n/** A cacheable handle to formatting and parsing specs for a specific KoQ and persistence unit.\n * Automatically refreshes when the QuantityFormatter reloads. Use [[QuantityFormatter.getFormatSpecHandle]]\n * to create instances.\n *\n * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.\n * Call [[dispose]] when the handle is no longer needed to unsubscribe from reload events.\n *\n * @beta\n */\nexport class FormatSpecHandle implements Disposable {\n  private _formatterSpec: FormatterSpec | undefined;\n  private _parserSpec: ParserSpec | undefined;\n  private _removeListener: (() => void) | undefined;\n  private readonly _provider: FormattingSpecProvider;\n  private readonly _koqName: string;\n  private readonly _persistenceUnit: string;\n  private readonly _system: UnitSystemKey | undefined;\n\n  /** @internal */\n  constructor(args: FormatSpecHandleArgs) {\n    this._provider = args.provider;\n    this._koqName = args.name;\n    this._persistenceUnit = args.persistenceUnitName;\n    this._system = args.system;\n    this._removeListener = args.provider.onFormattingReady.addListener(() => {\n      this._refresh();\n    });\n    this._refresh();\n  }\n\n  /** The KoQ name this handle is keyed to. */\n  public get koqName(): string { return this._koqName; }\n\n  /** The persistence unit this handle is keyed to. */\n  public get persistenceUnit(): string { return this._persistenceUnit; }\n\n  /** The unit system this handle is pinned to, or `undefined` for the active system. */\n  public get system(): UnitSystemKey | undefined { return this._system; }\n\n  /** The current FormatterSpec, or undefined if not yet loaded. */\n  public get formatterSpec(): FormatterSpec | undefined { return this._formatterSpec; }\n\n  /** The current ParserSpec, or undefined if not yet loaded. */\n  public get parserSpec(): ParserSpec | undefined { return this._parserSpec; }\n\n  /** Format a quantity value using the current spec.\n   * If the formatter is not yet ready, returns `value.toString()` as a fallback.\n   * @param value - The numeric value to format.\n   * @returns The formatted string.\n   */\n  public format(value: number): string {\n    if (!this._formatterSpec)\n      return value.toString();\n    return this._provider.formatQuantity(value, this._formatterSpec);\n  }\n\n  /** Unsubscribe from reload events and clear cached specs.\n   * Idempotent and safe to call during a pending reload.\n   */\n  public [Symbol.dispose](): void {\n    if (this._removeListener) {\n      this._removeListener();\n      this._removeListener = undefined;\n    }\n    this._formatterSpec = undefined;\n    this._parserSpec = undefined;\n  }\n\n  private _refresh(): void {\n    // Guard against mid-emission callbacks after dispose() — event may still fire during iteration.\n    if (!this._removeListener)\n      return;\n    const entry: FormattingSpecEntry | undefined = this._provider.getSpecsByNameAndUnit({\n      name: this._koqName,\n      persistenceUnitName: this._persistenceUnit,\n      system: this._system,\n    });\n    if (entry) {\n      this._formatterSpec = entry.formatterSpec;\n      this._parserSpec = entry.parserSpec;\n    } else {\n      this._formatterSpec = undefined;\n      this._parserSpec = undefined;\n    }\n  }\n}\n"]}
+{"version":3,"file":"FormatSpecHandle.js","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;;;AAmB/F;;;;;;;;GAQG;AACH,MAAa,gBAAgB;IACnB,SAAS,GAAG,KAAK,CAAC;IACT,SAAS,CAAyB;IAClC,QAAQ,CAAS;IACjB,gBAAgB,CAAS;IACzB,OAAO,CAA4B;IAEpD,gBAAgB;IAChB,YAAY,IAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,4CAA4C;IAC5C,IAAW,OAAO,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,oDAAoD;IACpD,IAAW,eAAe,KAAa,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,KAAgC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvE,iEAAiE;IACjE,IAAW,aAAa,KAAgC,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAEjG,8DAA8D;IAC9D,IAAW,UAAU,KAA6B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAExF;;;;OAIG;IACI,MAAM,CAAC,KAAa;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACzC,IAAI,CAAC,aAAa;YAChB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,SAAS;YAChB,OAAO,SAAS,CAAC;QAEnB,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;YAC1C,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,mBAAmB,EAAE,IAAI,CAAC,gBAAgB;YAC1C,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;CACF;AA5DD,4CA4DC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport type { FormatterSpec } from \"./Formatter/FormatterSpec\";\nimport type { FormattingSpecArgs, FormattingSpecEntry, FormattingSpecProvider } from \"./Formatter/Interfaces\";\nimport type { ParserSpec } from \"./ParserSpec\";\nimport type { UnitSystemKey } from \"./Interfaces\";\n\n/** Arguments for constructing a [[FormatSpecHandle]].\n * @internal\n */\nexport interface FormatSpecHandleArgs extends FormattingSpecArgs {\n  /** The provider that supplies current formatting spec lookups. */\n  provider: FormattingSpecProvider;\n}\n\n/** A handle to formatting and parsing specs for a specific KoQ and persistence unit.\n * Reads the current specs from the provider on access. Use [[QuantityFormatter.getFormatSpecHandle]]\n * to create instances.\n *\n * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.\n * Dispose the handle when it is no longer needed to invalidate it.\n *\n * @beta\n */\nexport class FormatSpecHandle implements Disposable {\n  private _disposed = false;\n  private readonly _provider: FormattingSpecProvider;\n  private readonly _koqName: string;\n  private readonly _persistenceUnit: string;\n  private readonly _system: UnitSystemKey | undefined;\n\n  /** @internal */\n  constructor(args: FormatSpecHandleArgs) {\n    this._provider = args.provider;\n    this._koqName = args.name;\n    this._persistenceUnit = args.persistenceUnitName;\n    this._system = args.system;\n  }\n\n  /** The KoQ name this handle is keyed to. */\n  public get koqName(): string { return this._koqName; }\n\n  /** The persistence unit this handle is keyed to. */\n  public get persistenceUnit(): string { return this._persistenceUnit; }\n\n  /** The unit system this handle is pinned to, or `undefined` for the active system. */\n  public get system(): UnitSystemKey | undefined { return this._system; }\n\n  /** The current FormatterSpec, or undefined if not yet loaded. */\n  public get formatterSpec(): FormatterSpec | undefined { return this._getEntry()?.formatterSpec; }\n\n  /** The current ParserSpec, or undefined if not yet loaded. */\n  public get parserSpec(): ParserSpec | undefined { return this._getEntry()?.parserSpec; }\n\n  /** Format a quantity value using the current spec.\n   * If the formatter is not yet ready, returns `value.toString()` as a fallback.\n   * @param value - The numeric value to format.\n   * @returns The formatted string.\n   */\n  public format(value: number): string {\n    const formatterSpec = this.formatterSpec;\n    if (!formatterSpec)\n      return value.toString();\n    return this._provider.formatQuantity(value, formatterSpec);\n  }\n\n  /** Invalidate this handle.\n   * Idempotent and safe to call multiple times.\n   * No additional teardown is required because the handle owns no external resources.\n   */\n  public [Symbol.dispose](): void {\n    this._disposed = true;\n  }\n\n  private _getEntry(): FormattingSpecEntry | undefined {\n    if (this._disposed)\n      return undefined;\n\n    return this._provider.getSpecsByNameAndUnit({\n      name: this._koqName,\n      persistenceUnitName: this._persistenceUnit,\n      system: this._system,\n    });\n  }\n}\n"]}

package/lib/cjs/Formatter/Interfaces.d.ts

@@ -213,7 +213,7 @@ export interface AddFormattingSpecArgs extends FormattingSpecArgs {
     /** Format properties to use. When omitted, the provider resolves them from the KoQ schema. */
     formatProps?: FormatProps;
 }
-/** Minimal contract required by [[FormatSpecHandle]] to look up specs and subscribe to reloads.
+/** Minimal contract required by [[FormatSpecHandle]] to look up current specs and expose formatting readiness.
  * Implemented by [[QuantityFormatter]] in `@itwin/core-frontend`.
  * @beta
  */

package/lib/cjs/Formatter/Interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interfaces.js","sourceRoot":"","sources":["../../../src/Formatter/Interfaces.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAwHH;;GAEG;AACI,MAAM,mBAAmB,GAAG,CAAC,IAAiB,EAA6B,EAAE;IAClF,OAAQ,IAA0B,CAAC,MAAM,KAAK,SAAS,CAAC;AAC1D,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { BeEvent, BeUnorderedUiEvent } from \"@itwin/core-bentley\";\nimport { UnitProps, UnitSystemKey } from \"../Interfaces\";\nimport { DecimalPrecision, FormatTraits, FormatType, FractionalPrecision } from \"./FormatEnums\";\nimport type { FormatterSpec } from \"./FormatterSpec\";\nimport type { ParserSpec } from \"../ParserSpec\";\n\n/** Defines a unit specification with a name and optional label override.\n * Used in composite formats and ratio unit specifications.\n * @beta\n */\nexport interface FormatUnitSpec {\n  /** The name of the unit (e.g., \"Units.FT\", \"Units.IN\") */\n  readonly name: string;\n  /** Optional custom label that overrides the unit's default label (e.g., '\"' for inches, \"'\" for feet) */\n  readonly label?: string;\n}\n\n/** A resolved [[FormatUnitSpec]] with the unit name replaced with the resolved UnitProps.\n * @beta\n */\nexport interface ResolvedFormatUnitSpec {\n  /** The resolved unit */\n  readonly unit: UnitProps;\n  /** Optional custom label that overrides the unit's default label */\n  readonly label?: string;\n}\n\n/** Defines the units that make up a composite format and their display properties.\n * A composite format allows displaying a single quantity value across multiple units,\n * such as displaying length as \"5 feet 6 inches\" or angle as \"45° 30' 15\"\".\n * @beta\n */\nexport interface FormatCompositeProps {\n  /** Separator character between unit values when formatting composite strings. Must be empty or a single character. */\n  readonly spacer?: string;\n  /** Whether to include unit segments with zero magnitude in the formatted output. */\n  readonly includeZero?: boolean;\n  /** Array of units this format is comprised of. Each unit specifies the unit name and\n   * an optional custom label that will override the unit's default label when displaying values. */\n  readonly units: FormatUnitSpec[];\n}\n\n/** This interface defines the persistence format for describing the formatting of quantity values.\n * @beta\n */\nexport interface FormatProps {\n  /** The format type. See [[FormatType]] */\n  readonly type: string;\n\n  /** The precision for the format. Must be an integer. See [[DecimalPrecision]] and [[FractionalPrecision]] */\n  readonly precision?: number;\n\n  /** Value is rounded to a multiple of this factor if nonzero and the `applyRounding` trait is set, defaults to 0 */\n  readonly roundFactor?: number;\n\n  /** Minimum width of the formatted output including digits and separators. Must be a positive integer (≥ 0). */\n  readonly minWidth?: number;\n\n  /** How and when positive and negative signs are displayed. See [[ShowSignOption]] */\n  readonly showSignOption?: string;\n\n  /** Array of format traits controlling display behavior. See [[FormatTraits]] */\n  readonly formatTraits?: string | string[];\n\n  /** Character separating integer from fractional part. Must be empty or a single character. */\n  readonly decimalSeparator?: string;\n\n  /** Character separating thousands in the integer part. Must be empty or a single character. */\n  readonly thousandSeparator?: string;\n\n  /** Character separating the magnitude from the unit label. Must be empty or a single character. */\n  readonly uomSeparator?: string;\n\n  /** Required when type is Scientific. See [[ScientificType]] */\n  readonly scientificType?: string;\n\n  /** Required when type is Ratio. See [[RatioType]]*/\n  readonly ratioType?: string;\n  /** The separator character for ratio formatting. Defaults to ':' if not specified. */\n  readonly ratioSeparator?: string;\n   /** The format type for the numbers within a ratio. Defaults to \"Decimal\". */\n  readonly ratioFormatType?: string;\n\n  /** Required when type is Station. Number of decimal places for calculating station offset magnitude. Must be a positive integer > 0. */\n  readonly stationOffsetSize?: number;\n\n  /** Character separating station and offset portions of a Station formatted value. Must be empty or a single character. */\n  readonly stationSeparator?: string;\n\n  /** Optional base factor for station formatting. A positive integer, defaults to 1. */\n  readonly stationBaseFactor?: number;\n\n  /** The base value for azimuth, specified from east counter-clockwise. */\n  readonly azimuthBase?: number;\n\n  /** The name of the unit for the azimuth base value. Required if azimuthBase is set. */\n  readonly azimuthBaseUnit?: string;\n\n  /** If set to true, azimuth values are returned counter-clockwise from the base. */\n  readonly azimuthCounterClockwise?: boolean;\n\n  /** The name of the unit that represents a revolution/perigon. Required for bearing or azimuth types. */\n  readonly revolutionUnit?: string;\n\n  /** Enables calculating mathematic operations during parsing; only addition and subtraction are supported. */\n  readonly allowMathematicOperations?: boolean;\n\n  /** Composite format specification for multi-unit display. */\n  readonly composite?: FormatCompositeProps;\n}\n\n/** This interface is used when supporting Custom Formatters that need more than the standard set of properties.\n * @beta\n */\nexport interface CustomFormatProps extends FormatProps {\n  readonly custom: any;\n}\n\n/** CustomFormatProps type guard.\n * @beta\n */\nexport const isCustomFormatProps = (item: FormatProps): item is CustomFormatProps => {\n  return (item as CustomFormatProps).custom !== undefined;\n};\n\n/** A [[FormatCompositeProps]] with unit names replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatCompositeProps = Omit<FormatCompositeProps, \"units\"> & {\n  readonly units: ResolvedFormatUnitSpec[];\n};\n\n/** A [[FormatProps]] with all the references to units replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatProps = Omit<FormatDefinition, \"azimuthBaseUnit\" | \"revolutionUnit\" | \"composite\"> & {\n  readonly azimuthBaseUnit?: UnitProps;\n  readonly revolutionUnit?: UnitProps;\n  readonly composite?: ResolvedFormatCompositeProps;\n  readonly custom?: any;\n};\n\n/** CloneFormat defines unit and label specification if primary unit is to be set during clone.\n * @beta\n */\nexport interface CloneUnit {\n  unit?: UnitProps;\n  label?: string;\n}\n\n/** CloneOptions that define modifications that can be made during the cloning of a Format.\n * @beta\n */\nexport interface CloneOptions {\n  /** allows composite formats to be converted to only show primary unit */\n  showOnlyPrimaryUnit?: boolean;\n  /** allow format traits to be set */\n  traits?: FormatTraits;\n  /** allows new FormatType to be specified */\n  type?: FormatType;\n  /** allows precision to be set, this will throw if value is not valid for FormatType */\n  precision?: DecimalPrecision | FractionalPrecision;\n  /** allows primary unit and label to be specified */\n  primaryUnit?: CloneUnit;\n}\n\n/** An extension of FormatProps to help identify formats.\n * @beta\n */\nexport interface FormatDefinition extends FormatProps {\n  readonly name?: string;\n  readonly label?: string;\n  readonly description?: string;\n}\n\n/** Argument for [[FormatsProvider.onFormatsChanged]]\n * @beta\n */\nexport interface FormatsChangedArgs {\n  /**\n   * If `all` - all formats within the `FormatsProvider` have changed.\n   * If array, the array items list the names of formats that were changed or removed.\n   */\n  formatsChanged: \"all\" | string[];\n  /** If set, indicates that the format set implies a particular unit system. The consumer\n   * (e.g., QuantityFormatter) will synchronize the active unit system to match.\n   * If `undefined`, the format change does not imply a unit system switch — the active\n   * unit system remains unchanged.\n   * @beta\n   */\n  impliedUnitSystem?: UnitSystemKey;\n}\n\n/** This interface is implemented by a class that would provide formats for use in formatting quantities.\n * @beta\n */\nexport interface FormatsProvider {\n  /**\n   * @param name The full name of the Format or KindOfQuantity.\n   */\n  getFormat(name: string, system?: UnitSystemKey): Promise<FormatDefinition | undefined>;\n\n  /**\n   * Fired when formats are added, removed, or changed.\n   * If all formats are changed, a single string \"all\" is emitted. Else, an array of changed format names is emitted.\n   */\n  onFormatsChanged: BeEvent<(args: FormatsChangedArgs) => void>;\n}\n\n/** This interface is implemented by a class that would provide and allow creating formats for use in formatting quantities.\n * @beta\n */\nexport interface MutableFormatsProvider extends FormatsProvider {\n  /**\n   * Adds a new format or updates an existing format associated with the specified name.\n   */\n  addFormat(name: string, format: FormatDefinition): Promise<void>;\n  /**\n   * Removes the format associated with the specified name.\n   * @param name The name of the format to remove.\n   */\n  removeFormat(name: string): Promise<void>;\n}\n\n/** Entries returned when looking up specs from the format registry.\n * @beta\n */\nexport interface FormattingSpecEntry {\n  formatterSpec: FormatterSpec;\n  parserSpec: ParserSpec;\n}\n\n/** Arguments for looking up a formatting spec entry.\n * @beta\n */\nexport interface FormattingSpecArgs {\n  /** The KoQ name to look up. */\n  name: string;\n  /** The persistence unit name (e.g., `\"Units.M\"`). */\n  persistenceUnitName: string;\n  /** Optional unit system override. When omitted, the active system is used. */\n  system?: UnitSystemKey;\n}\n\n/** Arguments for registering a formatting spec entry.\n * @beta\n */\nexport interface AddFormattingSpecArgs extends FormattingSpecArgs {\n  /** Format properties to use. When omitted, the provider resolves them from the KoQ schema. */\n  formatProps?: FormatProps;\n}\n\n/** Minimal contract required by [[FormatSpecHandle]] to look up specs and subscribe to reloads.\n * Implemented by [[QuantityFormatter]] in `@itwin/core-frontend`.\n * @beta\n */\nexport interface FormattingSpecProvider {\n  /** Look up a formatting spec entry by KoQ name and persistence unit. */\n  getSpecsByNameAndUnit(args: FormattingSpecArgs): FormattingSpecEntry | undefined;\n  /** Format a numeric value using the given formatter spec. */\n  formatQuantity(magnitude: number, formatSpec: FormatterSpec): string;\n  /** Event raised after the provider has finished reloading its caches.\n   * Uses Set-backed event for safe concurrent add/remove during emit.\n   */\n  readonly onFormattingReady: BeUnorderedUiEvent<void>;\n}\n\n"]}
+{"version":3,"file":"Interfaces.js","sourceRoot":"","sources":["../../../src/Formatter/Interfaces.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAwHH;;GAEG;AACI,MAAM,mBAAmB,GAAG,CAAC,IAAiB,EAA6B,EAAE;IAClF,OAAQ,IAA0B,CAAC,MAAM,KAAK,SAAS,CAAC;AAC1D,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { BeEvent, BeUnorderedUiEvent } from \"@itwin/core-bentley\";\nimport { UnitProps, UnitSystemKey } from \"../Interfaces\";\nimport { DecimalPrecision, FormatTraits, FormatType, FractionalPrecision } from \"./FormatEnums\";\nimport type { FormatterSpec } from \"./FormatterSpec\";\nimport type { ParserSpec } from \"../ParserSpec\";\n\n/** Defines a unit specification with a name and optional label override.\n * Used in composite formats and ratio unit specifications.\n * @beta\n */\nexport interface FormatUnitSpec {\n  /** The name of the unit (e.g., \"Units.FT\", \"Units.IN\") */\n  readonly name: string;\n  /** Optional custom label that overrides the unit's default label (e.g., '\"' for inches, \"'\" for feet) */\n  readonly label?: string;\n}\n\n/** A resolved [[FormatUnitSpec]] with the unit name replaced with the resolved UnitProps.\n * @beta\n */\nexport interface ResolvedFormatUnitSpec {\n  /** The resolved unit */\n  readonly unit: UnitProps;\n  /** Optional custom label that overrides the unit's default label */\n  readonly label?: string;\n}\n\n/** Defines the units that make up a composite format and their display properties.\n * A composite format allows displaying a single quantity value across multiple units,\n * such as displaying length as \"5 feet 6 inches\" or angle as \"45° 30' 15\"\".\n * @beta\n */\nexport interface FormatCompositeProps {\n  /** Separator character between unit values when formatting composite strings. Must be empty or a single character. */\n  readonly spacer?: string;\n  /** Whether to include unit segments with zero magnitude in the formatted output. */\n  readonly includeZero?: boolean;\n  /** Array of units this format is comprised of. Each unit specifies the unit name and\n   * an optional custom label that will override the unit's default label when displaying values. */\n  readonly units: FormatUnitSpec[];\n}\n\n/** This interface defines the persistence format for describing the formatting of quantity values.\n * @beta\n */\nexport interface FormatProps {\n  /** The format type. See [[FormatType]] */\n  readonly type: string;\n\n  /** The precision for the format. Must be an integer. See [[DecimalPrecision]] and [[FractionalPrecision]] */\n  readonly precision?: number;\n\n  /** Value is rounded to a multiple of this factor if nonzero and the `applyRounding` trait is set, defaults to 0 */\n  readonly roundFactor?: number;\n\n  /** Minimum width of the formatted output including digits and separators. Must be a positive integer (≥ 0). */\n  readonly minWidth?: number;\n\n  /** How and when positive and negative signs are displayed. See [[ShowSignOption]] */\n  readonly showSignOption?: string;\n\n  /** Array of format traits controlling display behavior. See [[FormatTraits]] */\n  readonly formatTraits?: string | string[];\n\n  /** Character separating integer from fractional part. Must be empty or a single character. */\n  readonly decimalSeparator?: string;\n\n  /** Character separating thousands in the integer part. Must be empty or a single character. */\n  readonly thousandSeparator?: string;\n\n  /** Character separating the magnitude from the unit label. Must be empty or a single character. */\n  readonly uomSeparator?: string;\n\n  /** Required when type is Scientific. See [[ScientificType]] */\n  readonly scientificType?: string;\n\n  /** Required when type is Ratio. See [[RatioType]]*/\n  readonly ratioType?: string;\n  /** The separator character for ratio formatting. Defaults to ':' if not specified. */\n  readonly ratioSeparator?: string;\n   /** The format type for the numbers within a ratio. Defaults to \"Decimal\". */\n  readonly ratioFormatType?: string;\n\n  /** Required when type is Station. Number of decimal places for calculating station offset magnitude. Must be a positive integer > 0. */\n  readonly stationOffsetSize?: number;\n\n  /** Character separating station and offset portions of a Station formatted value. Must be empty or a single character. */\n  readonly stationSeparator?: string;\n\n  /** Optional base factor for station formatting. A positive integer, defaults to 1. */\n  readonly stationBaseFactor?: number;\n\n  /** The base value for azimuth, specified from east counter-clockwise. */\n  readonly azimuthBase?: number;\n\n  /** The name of the unit for the azimuth base value. Required if azimuthBase is set. */\n  readonly azimuthBaseUnit?: string;\n\n  /** If set to true, azimuth values are returned counter-clockwise from the base. */\n  readonly azimuthCounterClockwise?: boolean;\n\n  /** The name of the unit that represents a revolution/perigon. Required for bearing or azimuth types. */\n  readonly revolutionUnit?: string;\n\n  /** Enables calculating mathematic operations during parsing; only addition and subtraction are supported. */\n  readonly allowMathematicOperations?: boolean;\n\n  /** Composite format specification for multi-unit display. */\n  readonly composite?: FormatCompositeProps;\n}\n\n/** This interface is used when supporting Custom Formatters that need more than the standard set of properties.\n * @beta\n */\nexport interface CustomFormatProps extends FormatProps {\n  readonly custom: any;\n}\n\n/** CustomFormatProps type guard.\n * @beta\n */\nexport const isCustomFormatProps = (item: FormatProps): item is CustomFormatProps => {\n  return (item as CustomFormatProps).custom !== undefined;\n};\n\n/** A [[FormatCompositeProps]] with unit names replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatCompositeProps = Omit<FormatCompositeProps, \"units\"> & {\n  readonly units: ResolvedFormatUnitSpec[];\n};\n\n/** A [[FormatProps]] with all the references to units replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatProps = Omit<FormatDefinition, \"azimuthBaseUnit\" | \"revolutionUnit\" | \"composite\"> & {\n  readonly azimuthBaseUnit?: UnitProps;\n  readonly revolutionUnit?: UnitProps;\n  readonly composite?: ResolvedFormatCompositeProps;\n  readonly custom?: any;\n};\n\n/** CloneFormat defines unit and label specification if primary unit is to be set during clone.\n * @beta\n */\nexport interface CloneUnit {\n  unit?: UnitProps;\n  label?: string;\n}\n\n/** CloneOptions that define modifications that can be made during the cloning of a Format.\n * @beta\n */\nexport interface CloneOptions {\n  /** allows composite formats to be converted to only show primary unit */\n  showOnlyPrimaryUnit?: boolean;\n  /** allow format traits to be set */\n  traits?: FormatTraits;\n  /** allows new FormatType to be specified */\n  type?: FormatType;\n  /** allows precision to be set, this will throw if value is not valid for FormatType */\n  precision?: DecimalPrecision | FractionalPrecision;\n  /** allows primary unit and label to be specified */\n  primaryUnit?: CloneUnit;\n}\n\n/** An extension of FormatProps to help identify formats.\n * @beta\n */\nexport interface FormatDefinition extends FormatProps {\n  readonly name?: string;\n  readonly label?: string;\n  readonly description?: string;\n}\n\n/** Argument for [[FormatsProvider.onFormatsChanged]]\n * @beta\n */\nexport interface FormatsChangedArgs {\n  /**\n   * If `all` - all formats within the `FormatsProvider` have changed.\n   * If array, the array items list the names of formats that were changed or removed.\n   */\n  formatsChanged: \"all\" | string[];\n  /** If set, indicates that the format set implies a particular unit system. The consumer\n   * (e.g., QuantityFormatter) will synchronize the active unit system to match.\n   * If `undefined`, the format change does not imply a unit system switch — the active\n   * unit system remains unchanged.\n   * @beta\n   */\n  impliedUnitSystem?: UnitSystemKey;\n}\n\n/** This interface is implemented by a class that would provide formats for use in formatting quantities.\n * @beta\n */\nexport interface FormatsProvider {\n  /**\n   * @param name The full name of the Format or KindOfQuantity.\n   */\n  getFormat(name: string, system?: UnitSystemKey): Promise<FormatDefinition | undefined>;\n\n  /**\n   * Fired when formats are added, removed, or changed.\n   * If all formats are changed, a single string \"all\" is emitted. Else, an array of changed format names is emitted.\n   */\n  onFormatsChanged: BeEvent<(args: FormatsChangedArgs) => void>;\n}\n\n/** This interface is implemented by a class that would provide and allow creating formats for use in formatting quantities.\n * @beta\n */\nexport interface MutableFormatsProvider extends FormatsProvider {\n  /**\n   * Adds a new format or updates an existing format associated with the specified name.\n   */\n  addFormat(name: string, format: FormatDefinition): Promise<void>;\n  /**\n   * Removes the format associated with the specified name.\n   * @param name The name of the format to remove.\n   */\n  removeFormat(name: string): Promise<void>;\n}\n\n/** Entries returned when looking up specs from the format registry.\n * @beta\n */\nexport interface FormattingSpecEntry {\n  formatterSpec: FormatterSpec;\n  parserSpec: ParserSpec;\n}\n\n/** Arguments for looking up a formatting spec entry.\n * @beta\n */\nexport interface FormattingSpecArgs {\n  /** The KoQ name to look up. */\n  name: string;\n  /** The persistence unit name (e.g., `\"Units.M\"`). */\n  persistenceUnitName: string;\n  /** Optional unit system override. When omitted, the active system is used. */\n  system?: UnitSystemKey;\n}\n\n/** Arguments for registering a formatting spec entry.\n * @beta\n */\nexport interface AddFormattingSpecArgs extends FormattingSpecArgs {\n  /** Format properties to use. When omitted, the provider resolves them from the KoQ schema. */\n  formatProps?: FormatProps;\n}\n\n/** Minimal contract required by [[FormatSpecHandle]] to look up current specs and expose formatting readiness.\n * Implemented by [[QuantityFormatter]] in `@itwin/core-frontend`.\n * @beta\n */\nexport interface FormattingSpecProvider {\n  /** Look up a formatting spec entry by KoQ name and persistence unit. */\n  getSpecsByNameAndUnit(args: FormattingSpecArgs): FormattingSpecEntry | undefined;\n  /** Format a numeric value using the given formatter spec. */\n  formatQuantity(magnitude: number, formatSpec: FormatterSpec): string;\n  /** Event raised after the provider has finished reloading its caches.\n   * Uses Set-backed event for safe concurrent add/remove during emit.\n   */\n  readonly onFormattingReady: BeUnorderedUiEvent<void>;\n}\n\n"]}

package/lib/esm/FormatSpecHandle.d.ts

@@ -9,22 +9,20 @@ import type { UnitSystemKey } from "./Interfaces";
  * @internal
  */
 export interface FormatSpecHandleArgs extends FormattingSpecArgs {
-    /** The provider that supplies spec lookups and reload events. */
+    /** The provider that supplies current formatting spec lookups. */
     provider: FormattingSpecProvider;
 }
-/** A cacheable handle to formatting and parsing specs for a specific KoQ and persistence unit.
- * Automatically refreshes when the QuantityFormatter reloads. Use [[QuantityFormatter.getFormatSpecHandle]]
+/** A handle to formatting and parsing specs for a specific KoQ and persistence unit.
+ * Reads the current specs from the provider on access. Use [[QuantityFormatter.getFormatSpecHandle]]
  * to create instances.
  *
  * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.
- * Call [[dispose]] when the handle is no longer needed to unsubscribe from reload events.
+ * Dispose the handle when it is no longer needed to invalidate it.
  *
  * @beta
  */
 export declare class FormatSpecHandle implements Disposable {
-    private _formatterSpec;
-    private _parserSpec;
-    private _removeListener;
+    private _disposed;
     private readonly _provider;
     private readonly _koqName;
     private readonly _persistenceUnit;
@@ -47,10 +45,11 @@ export declare class FormatSpecHandle implements Disposable {
      * @returns The formatted string.
      */
     format(value: number): string;
-    /** Unsubscribe from reload events and clear cached specs.
-     * Idempotent and safe to call during a pending reload.
+    /** Invalidate this handle.
+     * Idempotent and safe to call multiple times.
+     * No additional teardown is required because the handle owns no external resources.
      */
     [Symbol.dispose](): void;
-    private _refresh;
+    private _getEntry;
 }
 //# sourceMappingURL=FormatSpecHandle.d.ts.map

package/lib/esm/FormatSpecHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormatSpecHandle.d.ts","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAuB,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,iEAAiE;IACjE,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,eAAe,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,gBAAgB;gBACJ,IAAI,EAAE,oBAAoB;IAWtC,4CAA4C;IAC5C,IAAW,OAAO,IAAI,MAAM,CAA0B;IAEtD,oDAAoD;IACpD,IAAW,eAAe,IAAI,MAAM,CAAkC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,IAAI,aAAa,GAAG,SAAS,CAAyB;IAEvE,iEAAiE;IACjE,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAAgC;IAErF,8DAA8D;IAC9D,IAAW,UAAU,IAAI,UAAU,GAAG,SAAS,CAA6B;IAE5E;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMpC;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAS/B,OAAO,CAAC,QAAQ;CAiBjB"}
+{"version":3,"file":"FormatSpecHandle.d.ts","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAuB,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC9G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC9D,kEAAkE;IAClE,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,gBAAgB;gBACJ,IAAI,EAAE,oBAAoB;IAOtC,4CAA4C;IAC5C,IAAW,OAAO,IAAI,MAAM,CAA0B;IAEtD,oDAAoD;IACpD,IAAW,eAAe,IAAI,MAAM,CAAkC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,IAAI,aAAa,GAAG,SAAS,CAAyB;IAEvE,iEAAiE;IACjE,IAAW,aAAa,IAAI,aAAa,GAAG,SAAS,CAA4C;IAEjG,8DAA8D;IAC9D,IAAW,UAAU,IAAI,UAAU,GAAG,SAAS,CAAyC;IAExF;;;;OAIG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOpC;;;OAGG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAI/B,OAAO,CAAC,SAAS;CAUlB"}

package/lib/esm/FormatSpecHandle.js

@@ -2,19 +2,17 @@
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
-/** A cacheable handle to formatting and parsing specs for a specific KoQ and persistence unit.
- * Automatically refreshes when the QuantityFormatter reloads. Use [[QuantityFormatter.getFormatSpecHandle]]
+/** A handle to formatting and parsing specs for a specific KoQ and persistence unit.
+ * Reads the current specs from the provider on access. Use [[QuantityFormatter.getFormatSpecHandle]]
  * to create instances.
  *
  * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.
- * Call [[dispose]] when the handle is no longer needed to unsubscribe from reload events.
+ * Dispose the handle when it is no longer needed to invalidate it.
  *
  * @beta
  */
 export class FormatSpecHandle {
-    _formatterSpec;
-    _parserSpec;
-    _removeListener;
+    _disposed = false;
     _provider;
     _koqName;
     _persistenceUnit;
@@ -25,10 +23,6 @@ export class FormatSpecHandle {
         this._koqName = args.name;
         this._persistenceUnit = args.persistenceUnitName;
         this._system = args.system;
-        this._removeListener = args.provider.onFormattingReady.addListener(() => {
-            this._refresh();
-        });
-        this._refresh();
     }
     /** The KoQ name this handle is keyed to. */
     get koqName() { return this._koqName; }
@@ -37,47 +31,35 @@ export class FormatSpecHandle {
     /** The unit system this handle is pinned to, or `undefined` for the active system. */
     get system() { return this._system; }
     /** The current FormatterSpec, or undefined if not yet loaded. */
-    get formatterSpec() { return this._formatterSpec; }
+    get formatterSpec() { return this._getEntry()?.formatterSpec; }
     /** The current ParserSpec, or undefined if not yet loaded. */
-    get parserSpec() { return this._parserSpec; }
+    get parserSpec() { return this._getEntry()?.parserSpec; }
     /** Format a quantity value using the current spec.
      * If the formatter is not yet ready, returns `value.toString()` as a fallback.
      * @param value - The numeric value to format.
      * @returns The formatted string.
      */
     format(value) {
-        if (!this._formatterSpec)
+        const formatterSpec = this.formatterSpec;
+        if (!formatterSpec)
             return value.toString();
-        return this._provider.formatQuantity(value, this._formatterSpec);
+        return this._provider.formatQuantity(value, formatterSpec);
     }
-    /** Unsubscribe from reload events and clear cached specs.
-     * Idempotent and safe to call during a pending reload.
+    /** Invalidate this handle.
+     * Idempotent and safe to call multiple times.
+     * No additional teardown is required because the handle owns no external resources.
      */
     [Symbol.dispose]() {
-        if (this._removeListener) {
-            this._removeListener();
-            this._removeListener = undefined;
-        }
-        this._formatterSpec = undefined;
-        this._parserSpec = undefined;
+        this._disposed = true;
     }
-    _refresh() {
-        // Guard against mid-emission callbacks after dispose() — event may still fire during iteration.
-        if (!this._removeListener)
-            return;
-        const entry = this._provider.getSpecsByNameAndUnit({
+    _getEntry() {
+        if (this._disposed)
+            return undefined;
+        return this._provider.getSpecsByNameAndUnit({
             name: this._koqName,
             persistenceUnitName: this._persistenceUnit,
             system: this._system,
         });
-        if (entry) {
-            this._formatterSpec = entry.formatterSpec;
-            this._parserSpec = entry.parserSpec;
-        }
-        else {
-            this._formatterSpec = undefined;
-            this._parserSpec = undefined;
-        }
     }
 }
 //# sourceMappingURL=FormatSpecHandle.js.map

package/lib/esm/FormatSpecHandle.js.map

@@ -1 +1 @@
-{"version":3,"file":"FormatSpecHandle.js","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAmB/F;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IACnB,cAAc,CAA4B;IAC1C,WAAW,CAAyB;IACpC,eAAe,CAA2B;IACjC,SAAS,CAAyB;IAClC,QAAQ,CAAS;IACjB,gBAAgB,CAAS;IACzB,OAAO,CAA4B;IAEpD,gBAAgB;IAChB,YAAY,IAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE;YACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAED,4CAA4C;IAC5C,IAAW,OAAO,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,oDAAoD;IACpD,IAAW,eAAe,KAAa,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,KAAgC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvE,iEAAiE;IACjE,IAAW,aAAa,KAAgC,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAErF,8DAA8D;IAC9D,IAAW,UAAU,KAA6B,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAE5E;;;;OAIG;IACI,MAAM,CAAC,KAAa;QACzB,IAAI,CAAC,IAAI,CAAC,cAAc;YACtB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAChC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;IAC/B,CAAC;IAEO,QAAQ;QACd,gGAAgG;QAChG,IAAI,CAAC,IAAI,CAAC,eAAe;YACvB,OAAO;QACT,MAAM,KAAK,GAAoC,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;YAClF,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,mBAAmB,EAAE,IAAI,CAAC,gBAAgB;YAC1C,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC;YAC1C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC/B,CAAC;IACH,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport type { FormatterSpec } from \"./Formatter/FormatterSpec\";\nimport type { FormattingSpecArgs, FormattingSpecEntry, FormattingSpecProvider } from \"./Formatter/Interfaces\";\nimport type { ParserSpec } from \"./ParserSpec\";\nimport type { UnitSystemKey } from \"./Interfaces\";\n\n/** Arguments for constructing a [[FormatSpecHandle]].\n * @internal\n */\nexport interface FormatSpecHandleArgs extends FormattingSpecArgs {\n  /** The provider that supplies spec lookups and reload events. */\n  provider: FormattingSpecProvider;\n}\n\n/** A cacheable handle to formatting and parsing specs for a specific KoQ and persistence unit.\n * Automatically refreshes when the QuantityFormatter reloads. Use [[QuantityFormatter.getFormatSpecHandle]]\n * to create instances.\n *\n * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.\n * Call [[dispose]] when the handle is no longer needed to unsubscribe from reload events.\n *\n * @beta\n */\nexport class FormatSpecHandle implements Disposable {\n  private _formatterSpec: FormatterSpec | undefined;\n  private _parserSpec: ParserSpec | undefined;\n  private _removeListener: (() => void) | undefined;\n  private readonly _provider: FormattingSpecProvider;\n  private readonly _koqName: string;\n  private readonly _persistenceUnit: string;\n  private readonly _system: UnitSystemKey | undefined;\n\n  /** @internal */\n  constructor(args: FormatSpecHandleArgs) {\n    this._provider = args.provider;\n    this._koqName = args.name;\n    this._persistenceUnit = args.persistenceUnitName;\n    this._system = args.system;\n    this._removeListener = args.provider.onFormattingReady.addListener(() => {\n      this._refresh();\n    });\n    this._refresh();\n  }\n\n  /** The KoQ name this handle is keyed to. */\n  public get koqName(): string { return this._koqName; }\n\n  /** The persistence unit this handle is keyed to. */\n  public get persistenceUnit(): string { return this._persistenceUnit; }\n\n  /** The unit system this handle is pinned to, or `undefined` for the active system. */\n  public get system(): UnitSystemKey | undefined { return this._system; }\n\n  /** The current FormatterSpec, or undefined if not yet loaded. */\n  public get formatterSpec(): FormatterSpec | undefined { return this._formatterSpec; }\n\n  /** The current ParserSpec, or undefined if not yet loaded. */\n  public get parserSpec(): ParserSpec | undefined { return this._parserSpec; }\n\n  /** Format a quantity value using the current spec.\n   * If the formatter is not yet ready, returns `value.toString()` as a fallback.\n   * @param value - The numeric value to format.\n   * @returns The formatted string.\n   */\n  public format(value: number): string {\n    if (!this._formatterSpec)\n      return value.toString();\n    return this._provider.formatQuantity(value, this._formatterSpec);\n  }\n\n  /** Unsubscribe from reload events and clear cached specs.\n   * Idempotent and safe to call during a pending reload.\n   */\n  public [Symbol.dispose](): void {\n    if (this._removeListener) {\n      this._removeListener();\n      this._removeListener = undefined;\n    }\n    this._formatterSpec = undefined;\n    this._parserSpec = undefined;\n  }\n\n  private _refresh(): void {\n    // Guard against mid-emission callbacks after dispose() — event may still fire during iteration.\n    if (!this._removeListener)\n      return;\n    const entry: FormattingSpecEntry | undefined = this._provider.getSpecsByNameAndUnit({\n      name: this._koqName,\n      persistenceUnitName: this._persistenceUnit,\n      system: this._system,\n    });\n    if (entry) {\n      this._formatterSpec = entry.formatterSpec;\n      this._parserSpec = entry.parserSpec;\n    } else {\n      this._formatterSpec = undefined;\n      this._parserSpec = undefined;\n    }\n  }\n}\n"]}
+{"version":3,"file":"FormatSpecHandle.js","sourceRoot":"","sources":["../../src/FormatSpecHandle.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAmB/F;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IACnB,SAAS,GAAG,KAAK,CAAC;IACT,SAAS,CAAyB;IAClC,QAAQ,CAAS;IACjB,gBAAgB,CAAS;IACzB,OAAO,CAA4B;IAEpD,gBAAgB;IAChB,YAAY,IAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QACjD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED,4CAA4C;IAC5C,IAAW,OAAO,KAAa,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEtD,oDAAoD;IACpD,IAAW,eAAe,KAAa,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEtE,sFAAsF;IACtF,IAAW,MAAM,KAAgC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvE,iEAAiE;IACjE,IAAW,aAAa,KAAgC,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAEjG,8DAA8D;IAC9D,IAAW,UAAU,KAA6B,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC;IAExF;;;;OAIG;IACI,MAAM,CAAC,KAAa;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACzC,IAAI,CAAC,aAAa;YAChB,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACI,CAAC,MAAM,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACxB,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,SAAS;YAChB,OAAO,SAAS,CAAC;QAEnB,OAAO,IAAI,CAAC,SAAS,CAAC,qBAAqB,CAAC;YAC1C,IAAI,EAAE,IAAI,CAAC,QAAQ;YACnB,mBAAmB,EAAE,IAAI,CAAC,gBAAgB;YAC1C,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport type { FormatterSpec } from \"./Formatter/FormatterSpec\";\nimport type { FormattingSpecArgs, FormattingSpecEntry, FormattingSpecProvider } from \"./Formatter/Interfaces\";\nimport type { ParserSpec } from \"./ParserSpec\";\nimport type { UnitSystemKey } from \"./Interfaces\";\n\n/** Arguments for constructing a [[FormatSpecHandle]].\n * @internal\n */\nexport interface FormatSpecHandleArgs extends FormattingSpecArgs {\n  /** The provider that supplies current formatting spec lookups. */\n  provider: FormattingSpecProvider;\n}\n\n/** A handle to formatting and parsing specs for a specific KoQ and persistence unit.\n * Reads the current specs from the provider on access. Use [[QuantityFormatter.getFormatSpecHandle]]\n * to create instances.\n *\n * When formatting is not yet ready, [[format]] returns a `value.toString()` fallback.\n * Dispose the handle when it is no longer needed to invalidate it.\n *\n * @beta\n */\nexport class FormatSpecHandle implements Disposable {\n  private _disposed = false;\n  private readonly _provider: FormattingSpecProvider;\n  private readonly _koqName: string;\n  private readonly _persistenceUnit: string;\n  private readonly _system: UnitSystemKey | undefined;\n\n  /** @internal */\n  constructor(args: FormatSpecHandleArgs) {\n    this._provider = args.provider;\n    this._koqName = args.name;\n    this._persistenceUnit = args.persistenceUnitName;\n    this._system = args.system;\n  }\n\n  /** The KoQ name this handle is keyed to. */\n  public get koqName(): string { return this._koqName; }\n\n  /** The persistence unit this handle is keyed to. */\n  public get persistenceUnit(): string { return this._persistenceUnit; }\n\n  /** The unit system this handle is pinned to, or `undefined` for the active system. */\n  public get system(): UnitSystemKey | undefined { return this._system; }\n\n  /** The current FormatterSpec, or undefined if not yet loaded. */\n  public get formatterSpec(): FormatterSpec | undefined { return this._getEntry()?.formatterSpec; }\n\n  /** The current ParserSpec, or undefined if not yet loaded. */\n  public get parserSpec(): ParserSpec | undefined { return this._getEntry()?.parserSpec; }\n\n  /** Format a quantity value using the current spec.\n   * If the formatter is not yet ready, returns `value.toString()` as a fallback.\n   * @param value - The numeric value to format.\n   * @returns The formatted string.\n   */\n  public format(value: number): string {\n    const formatterSpec = this.formatterSpec;\n    if (!formatterSpec)\n      return value.toString();\n    return this._provider.formatQuantity(value, formatterSpec);\n  }\n\n  /** Invalidate this handle.\n   * Idempotent and safe to call multiple times.\n   * No additional teardown is required because the handle owns no external resources.\n   */\n  public [Symbol.dispose](): void {\n    this._disposed = true;\n  }\n\n  private _getEntry(): FormattingSpecEntry | undefined {\n    if (this._disposed)\n      return undefined;\n\n    return this._provider.getSpecsByNameAndUnit({\n      name: this._koqName,\n      persistenceUnitName: this._persistenceUnit,\n      system: this._system,\n    });\n  }\n}\n"]}

package/lib/esm/Formatter/Interfaces.d.ts

@@ -213,7 +213,7 @@ export interface AddFormattingSpecArgs extends FormattingSpecArgs {
     /** Format properties to use. When omitted, the provider resolves them from the KoQ schema. */
     formatProps?: FormatProps;
 }
-/** Minimal contract required by [[FormatSpecHandle]] to look up specs and subscribe to reloads.
+/** Minimal contract required by [[FormatSpecHandle]] to look up current specs and expose formatting readiness.
  * Implemented by [[QuantityFormatter]] in `@itwin/core-frontend`.
  * @beta
  */

package/lib/esm/Formatter/Interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interfaces.js","sourceRoot":"","sources":["../../../src/Formatter/Interfaces.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAwHH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAiB,EAA6B,EAAE;IAClF,OAAQ,IAA0B,CAAC,MAAM,KAAK,SAAS,CAAC;AAC1D,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { BeEvent, BeUnorderedUiEvent } from \"@itwin/core-bentley\";\nimport { UnitProps, UnitSystemKey } from \"../Interfaces\";\nimport { DecimalPrecision, FormatTraits, FormatType, FractionalPrecision } from \"./FormatEnums\";\nimport type { FormatterSpec } from \"./FormatterSpec\";\nimport type { ParserSpec } from \"../ParserSpec\";\n\n/** Defines a unit specification with a name and optional label override.\n * Used in composite formats and ratio unit specifications.\n * @beta\n */\nexport interface FormatUnitSpec {\n  /** The name of the unit (e.g., \"Units.FT\", \"Units.IN\") */\n  readonly name: string;\n  /** Optional custom label that overrides the unit's default label (e.g., '\"' for inches, \"'\" for feet) */\n  readonly label?: string;\n}\n\n/** A resolved [[FormatUnitSpec]] with the unit name replaced with the resolved UnitProps.\n * @beta\n */\nexport interface ResolvedFormatUnitSpec {\n  /** The resolved unit */\n  readonly unit: UnitProps;\n  /** Optional custom label that overrides the unit's default label */\n  readonly label?: string;\n}\n\n/** Defines the units that make up a composite format and their display properties.\n * A composite format allows displaying a single quantity value across multiple units,\n * such as displaying length as \"5 feet 6 inches\" or angle as \"45° 30' 15\"\".\n * @beta\n */\nexport interface FormatCompositeProps {\n  /** Separator character between unit values when formatting composite strings. Must be empty or a single character. */\n  readonly spacer?: string;\n  /** Whether to include unit segments with zero magnitude in the formatted output. */\n  readonly includeZero?: boolean;\n  /** Array of units this format is comprised of. Each unit specifies the unit name and\n   * an optional custom label that will override the unit's default label when displaying values. */\n  readonly units: FormatUnitSpec[];\n}\n\n/** This interface defines the persistence format for describing the formatting of quantity values.\n * @beta\n */\nexport interface FormatProps {\n  /** The format type. See [[FormatType]] */\n  readonly type: string;\n\n  /** The precision for the format. Must be an integer. See [[DecimalPrecision]] and [[FractionalPrecision]] */\n  readonly precision?: number;\n\n  /** Value is rounded to a multiple of this factor if nonzero and the `applyRounding` trait is set, defaults to 0 */\n  readonly roundFactor?: number;\n\n  /** Minimum width of the formatted output including digits and separators. Must be a positive integer (≥ 0). */\n  readonly minWidth?: number;\n\n  /** How and when positive and negative signs are displayed. See [[ShowSignOption]] */\n  readonly showSignOption?: string;\n\n  /** Array of format traits controlling display behavior. See [[FormatTraits]] */\n  readonly formatTraits?: string | string[];\n\n  /** Character separating integer from fractional part. Must be empty or a single character. */\n  readonly decimalSeparator?: string;\n\n  /** Character separating thousands in the integer part. Must be empty or a single character. */\n  readonly thousandSeparator?: string;\n\n  /** Character separating the magnitude from the unit label. Must be empty or a single character. */\n  readonly uomSeparator?: string;\n\n  /** Required when type is Scientific. See [[ScientificType]] */\n  readonly scientificType?: string;\n\n  /** Required when type is Ratio. See [[RatioType]]*/\n  readonly ratioType?: string;\n  /** The separator character for ratio formatting. Defaults to ':' if not specified. */\n  readonly ratioSeparator?: string;\n   /** The format type for the numbers within a ratio. Defaults to \"Decimal\". */\n  readonly ratioFormatType?: string;\n\n  /** Required when type is Station. Number of decimal places for calculating station offset magnitude. Must be a positive integer > 0. */\n  readonly stationOffsetSize?: number;\n\n  /** Character separating station and offset portions of a Station formatted value. Must be empty or a single character. */\n  readonly stationSeparator?: string;\n\n  /** Optional base factor for station formatting. A positive integer, defaults to 1. */\n  readonly stationBaseFactor?: number;\n\n  /** The base value for azimuth, specified from east counter-clockwise. */\n  readonly azimuthBase?: number;\n\n  /** The name of the unit for the azimuth base value. Required if azimuthBase is set. */\n  readonly azimuthBaseUnit?: string;\n\n  /** If set to true, azimuth values are returned counter-clockwise from the base. */\n  readonly azimuthCounterClockwise?: boolean;\n\n  /** The name of the unit that represents a revolution/perigon. Required for bearing or azimuth types. */\n  readonly revolutionUnit?: string;\n\n  /** Enables calculating mathematic operations during parsing; only addition and subtraction are supported. */\n  readonly allowMathematicOperations?: boolean;\n\n  /** Composite format specification for multi-unit display. */\n  readonly composite?: FormatCompositeProps;\n}\n\n/** This interface is used when supporting Custom Formatters that need more than the standard set of properties.\n * @beta\n */\nexport interface CustomFormatProps extends FormatProps {\n  readonly custom: any;\n}\n\n/** CustomFormatProps type guard.\n * @beta\n */\nexport const isCustomFormatProps = (item: FormatProps): item is CustomFormatProps => {\n  return (item as CustomFormatProps).custom !== undefined;\n};\n\n/** A [[FormatCompositeProps]] with unit names replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatCompositeProps = Omit<FormatCompositeProps, \"units\"> & {\n  readonly units: ResolvedFormatUnitSpec[];\n};\n\n/** A [[FormatProps]] with all the references to units replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatProps = Omit<FormatDefinition, \"azimuthBaseUnit\" | \"revolutionUnit\" | \"composite\"> & {\n  readonly azimuthBaseUnit?: UnitProps;\n  readonly revolutionUnit?: UnitProps;\n  readonly composite?: ResolvedFormatCompositeProps;\n  readonly custom?: any;\n};\n\n/** CloneFormat defines unit and label specification if primary unit is to be set during clone.\n * @beta\n */\nexport interface CloneUnit {\n  unit?: UnitProps;\n  label?: string;\n}\n\n/** CloneOptions that define modifications that can be made during the cloning of a Format.\n * @beta\n */\nexport interface CloneOptions {\n  /** allows composite formats to be converted to only show primary unit */\n  showOnlyPrimaryUnit?: boolean;\n  /** allow format traits to be set */\n  traits?: FormatTraits;\n  /** allows new FormatType to be specified */\n  type?: FormatType;\n  /** allows precision to be set, this will throw if value is not valid for FormatType */\n  precision?: DecimalPrecision | FractionalPrecision;\n  /** allows primary unit and label to be specified */\n  primaryUnit?: CloneUnit;\n}\n\n/** An extension of FormatProps to help identify formats.\n * @beta\n */\nexport interface FormatDefinition extends FormatProps {\n  readonly name?: string;\n  readonly label?: string;\n  readonly description?: string;\n}\n\n/** Argument for [[FormatsProvider.onFormatsChanged]]\n * @beta\n */\nexport interface FormatsChangedArgs {\n  /**\n   * If `all` - all formats within the `FormatsProvider` have changed.\n   * If array, the array items list the names of formats that were changed or removed.\n   */\n  formatsChanged: \"all\" | string[];\n  /** If set, indicates that the format set implies a particular unit system. The consumer\n   * (e.g., QuantityFormatter) will synchronize the active unit system to match.\n   * If `undefined`, the format change does not imply a unit system switch — the active\n   * unit system remains unchanged.\n   * @beta\n   */\n  impliedUnitSystem?: UnitSystemKey;\n}\n\n/** This interface is implemented by a class that would provide formats for use in formatting quantities.\n * @beta\n */\nexport interface FormatsProvider {\n  /**\n   * @param name The full name of the Format or KindOfQuantity.\n   */\n  getFormat(name: string, system?: UnitSystemKey): Promise<FormatDefinition | undefined>;\n\n  /**\n   * Fired when formats are added, removed, or changed.\n   * If all formats are changed, a single string \"all\" is emitted. Else, an array of changed format names is emitted.\n   */\n  onFormatsChanged: BeEvent<(args: FormatsChangedArgs) => void>;\n}\n\n/** This interface is implemented by a class that would provide and allow creating formats for use in formatting quantities.\n * @beta\n */\nexport interface MutableFormatsProvider extends FormatsProvider {\n  /**\n   * Adds a new format or updates an existing format associated with the specified name.\n   */\n  addFormat(name: string, format: FormatDefinition): Promise<void>;\n  /**\n   * Removes the format associated with the specified name.\n   * @param name The name of the format to remove.\n   */\n  removeFormat(name: string): Promise<void>;\n}\n\n/** Entries returned when looking up specs from the format registry.\n * @beta\n */\nexport interface FormattingSpecEntry {\n  formatterSpec: FormatterSpec;\n  parserSpec: ParserSpec;\n}\n\n/** Arguments for looking up a formatting spec entry.\n * @beta\n */\nexport interface FormattingSpecArgs {\n  /** The KoQ name to look up. */\n  name: string;\n  /** The persistence unit name (e.g., `\"Units.M\"`). */\n  persistenceUnitName: string;\n  /** Optional unit system override. When omitted, the active system is used. */\n  system?: UnitSystemKey;\n}\n\n/** Arguments for registering a formatting spec entry.\n * @beta\n */\nexport interface AddFormattingSpecArgs extends FormattingSpecArgs {\n  /** Format properties to use. When omitted, the provider resolves them from the KoQ schema. */\n  formatProps?: FormatProps;\n}\n\n/** Minimal contract required by [[FormatSpecHandle]] to look up specs and subscribe to reloads.\n * Implemented by [[QuantityFormatter]] in `@itwin/core-frontend`.\n * @beta\n */\nexport interface FormattingSpecProvider {\n  /** Look up a formatting spec entry by KoQ name and persistence unit. */\n  getSpecsByNameAndUnit(args: FormattingSpecArgs): FormattingSpecEntry | undefined;\n  /** Format a numeric value using the given formatter spec. */\n  formatQuantity(magnitude: number, formatSpec: FormatterSpec): string;\n  /** Event raised after the provider has finished reloading its caches.\n   * Uses Set-backed event for safe concurrent add/remove during emit.\n   */\n  readonly onFormattingReady: BeUnorderedUiEvent<void>;\n}\n\n"]}
+{"version":3,"file":"Interfaces.js","sourceRoot":"","sources":["../../../src/Formatter/Interfaces.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAwHH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAiB,EAA6B,EAAE;IAClF,OAAQ,IAA0B,CAAC,MAAM,KAAK,SAAS,CAAC;AAC1D,CAAC,CAAC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Quantity\n */\n\nimport { BeEvent, BeUnorderedUiEvent } from \"@itwin/core-bentley\";\nimport { UnitProps, UnitSystemKey } from \"../Interfaces\";\nimport { DecimalPrecision, FormatTraits, FormatType, FractionalPrecision } from \"./FormatEnums\";\nimport type { FormatterSpec } from \"./FormatterSpec\";\nimport type { ParserSpec } from \"../ParserSpec\";\n\n/** Defines a unit specification with a name and optional label override.\n * Used in composite formats and ratio unit specifications.\n * @beta\n */\nexport interface FormatUnitSpec {\n  /** The name of the unit (e.g., \"Units.FT\", \"Units.IN\") */\n  readonly name: string;\n  /** Optional custom label that overrides the unit's default label (e.g., '\"' for inches, \"'\" for feet) */\n  readonly label?: string;\n}\n\n/** A resolved [[FormatUnitSpec]] with the unit name replaced with the resolved UnitProps.\n * @beta\n */\nexport interface ResolvedFormatUnitSpec {\n  /** The resolved unit */\n  readonly unit: UnitProps;\n  /** Optional custom label that overrides the unit's default label */\n  readonly label?: string;\n}\n\n/** Defines the units that make up a composite format and their display properties.\n * A composite format allows displaying a single quantity value across multiple units,\n * such as displaying length as \"5 feet 6 inches\" or angle as \"45° 30' 15\"\".\n * @beta\n */\nexport interface FormatCompositeProps {\n  /** Separator character between unit values when formatting composite strings. Must be empty or a single character. */\n  readonly spacer?: string;\n  /** Whether to include unit segments with zero magnitude in the formatted output. */\n  readonly includeZero?: boolean;\n  /** Array of units this format is comprised of. Each unit specifies the unit name and\n   * an optional custom label that will override the unit's default label when displaying values. */\n  readonly units: FormatUnitSpec[];\n}\n\n/** This interface defines the persistence format for describing the formatting of quantity values.\n * @beta\n */\nexport interface FormatProps {\n  /** The format type. See [[FormatType]] */\n  readonly type: string;\n\n  /** The precision for the format. Must be an integer. See [[DecimalPrecision]] and [[FractionalPrecision]] */\n  readonly precision?: number;\n\n  /** Value is rounded to a multiple of this factor if nonzero and the `applyRounding` trait is set, defaults to 0 */\n  readonly roundFactor?: number;\n\n  /** Minimum width of the formatted output including digits and separators. Must be a positive integer (≥ 0). */\n  readonly minWidth?: number;\n\n  /** How and when positive and negative signs are displayed. See [[ShowSignOption]] */\n  readonly showSignOption?: string;\n\n  /** Array of format traits controlling display behavior. See [[FormatTraits]] */\n  readonly formatTraits?: string | string[];\n\n  /** Character separating integer from fractional part. Must be empty or a single character. */\n  readonly decimalSeparator?: string;\n\n  /** Character separating thousands in the integer part. Must be empty or a single character. */\n  readonly thousandSeparator?: string;\n\n  /** Character separating the magnitude from the unit label. Must be empty or a single character. */\n  readonly uomSeparator?: string;\n\n  /** Required when type is Scientific. See [[ScientificType]] */\n  readonly scientificType?: string;\n\n  /** Required when type is Ratio. See [[RatioType]]*/\n  readonly ratioType?: string;\n  /** The separator character for ratio formatting. Defaults to ':' if not specified. */\n  readonly ratioSeparator?: string;\n   /** The format type for the numbers within a ratio. Defaults to \"Decimal\". */\n  readonly ratioFormatType?: string;\n\n  /** Required when type is Station. Number of decimal places for calculating station offset magnitude. Must be a positive integer > 0. */\n  readonly stationOffsetSize?: number;\n\n  /** Character separating station and offset portions of a Station formatted value. Must be empty or a single character. */\n  readonly stationSeparator?: string;\n\n  /** Optional base factor for station formatting. A positive integer, defaults to 1. */\n  readonly stationBaseFactor?: number;\n\n  /** The base value for azimuth, specified from east counter-clockwise. */\n  readonly azimuthBase?: number;\n\n  /** The name of the unit for the azimuth base value. Required if azimuthBase is set. */\n  readonly azimuthBaseUnit?: string;\n\n  /** If set to true, azimuth values are returned counter-clockwise from the base. */\n  readonly azimuthCounterClockwise?: boolean;\n\n  /** The name of the unit that represents a revolution/perigon. Required for bearing or azimuth types. */\n  readonly revolutionUnit?: string;\n\n  /** Enables calculating mathematic operations during parsing; only addition and subtraction are supported. */\n  readonly allowMathematicOperations?: boolean;\n\n  /** Composite format specification for multi-unit display. */\n  readonly composite?: FormatCompositeProps;\n}\n\n/** This interface is used when supporting Custom Formatters that need more than the standard set of properties.\n * @beta\n */\nexport interface CustomFormatProps extends FormatProps {\n  readonly custom: any;\n}\n\n/** CustomFormatProps type guard.\n * @beta\n */\nexport const isCustomFormatProps = (item: FormatProps): item is CustomFormatProps => {\n  return (item as CustomFormatProps).custom !== undefined;\n};\n\n/** A [[FormatCompositeProps]] with unit names replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatCompositeProps = Omit<FormatCompositeProps, \"units\"> & {\n  readonly units: ResolvedFormatUnitSpec[];\n};\n\n/** A [[FormatProps]] with all the references to units replaced with JSON representations of those units.\n * @beta\n */\nexport type ResolvedFormatProps = Omit<FormatDefinition, \"azimuthBaseUnit\" | \"revolutionUnit\" | \"composite\"> & {\n  readonly azimuthBaseUnit?: UnitProps;\n  readonly revolutionUnit?: UnitProps;\n  readonly composite?: ResolvedFormatCompositeProps;\n  readonly custom?: any;\n};\n\n/** CloneFormat defines unit and label specification if primary unit is to be set during clone.\n * @beta\n */\nexport interface CloneUnit {\n  unit?: UnitProps;\n  label?: string;\n}\n\n/** CloneOptions that define modifications that can be made during the cloning of a Format.\n * @beta\n */\nexport interface CloneOptions {\n  /** allows composite formats to be converted to only show primary unit */\n  showOnlyPrimaryUnit?: boolean;\n  /** allow format traits to be set */\n  traits?: FormatTraits;\n  /** allows new FormatType to be specified */\n  type?: FormatType;\n  /** allows precision to be set, this will throw if value is not valid for FormatType */\n  precision?: DecimalPrecision | FractionalPrecision;\n  /** allows primary unit and label to be specified */\n  primaryUnit?: CloneUnit;\n}\n\n/** An extension of FormatProps to help identify formats.\n * @beta\n */\nexport interface FormatDefinition extends FormatProps {\n  readonly name?: string;\n  readonly label?: string;\n  readonly description?: string;\n}\n\n/** Argument for [[FormatsProvider.onFormatsChanged]]\n * @beta\n */\nexport interface FormatsChangedArgs {\n  /**\n   * If `all` - all formats within the `FormatsProvider` have changed.\n   * If array, the array items list the names of formats that were changed or removed.\n   */\n  formatsChanged: \"all\" | string[];\n  /** If set, indicates that the format set implies a particular unit system. The consumer\n   * (e.g., QuantityFormatter) will synchronize the active unit system to match.\n   * If `undefined`, the format change does not imply a unit system switch — the active\n   * unit system remains unchanged.\n   * @beta\n   */\n  impliedUnitSystem?: UnitSystemKey;\n}\n\n/** This interface is implemented by a class that would provide formats for use in formatting quantities.\n * @beta\n */\nexport interface FormatsProvider {\n  /**\n   * @param name The full name of the Format or KindOfQuantity.\n   */\n  getFormat(name: string, system?: UnitSystemKey): Promise<FormatDefinition | undefined>;\n\n  /**\n   * Fired when formats are added, removed, or changed.\n   * If all formats are changed, a single string \"all\" is emitted. Else, an array of changed format names is emitted.\n   */\n  onFormatsChanged: BeEvent<(args: FormatsChangedArgs) => void>;\n}\n\n/** This interface is implemented by a class that would provide and allow creating formats for use in formatting quantities.\n * @beta\n */\nexport interface MutableFormatsProvider extends FormatsProvider {\n  /**\n   * Adds a new format or updates an existing format associated with the specified name.\n   */\n  addFormat(name: string, format: FormatDefinition): Promise<void>;\n  /**\n   * Removes the format associated with the specified name.\n   * @param name The name of the format to remove.\n   */\n  removeFormat(name: string): Promise<void>;\n}\n\n/** Entries returned when looking up specs from the format registry.\n * @beta\n */\nexport interface FormattingSpecEntry {\n  formatterSpec: FormatterSpec;\n  parserSpec: ParserSpec;\n}\n\n/** Arguments for looking up a formatting spec entry.\n * @beta\n */\nexport interface FormattingSpecArgs {\n  /** The KoQ name to look up. */\n  name: string;\n  /** The persistence unit name (e.g., `\"Units.M\"`). */\n  persistenceUnitName: string;\n  /** Optional unit system override. When omitted, the active system is used. */\n  system?: UnitSystemKey;\n}\n\n/** Arguments for registering a formatting spec entry.\n * @beta\n */\nexport interface AddFormattingSpecArgs extends FormattingSpecArgs {\n  /** Format properties to use. When omitted, the provider resolves them from the KoQ schema. */\n  formatProps?: FormatProps;\n}\n\n/** Minimal contract required by [[FormatSpecHandle]] to look up current specs and expose formatting readiness.\n * Implemented by [[QuantityFormatter]] in `@itwin/core-frontend`.\n * @beta\n */\nexport interface FormattingSpecProvider {\n  /** Look up a formatting spec entry by KoQ name and persistence unit. */\n  getSpecsByNameAndUnit(args: FormattingSpecArgs): FormattingSpecEntry | undefined;\n  /** Format a numeric value using the given formatter spec. */\n  formatQuantity(magnitude: number, formatSpec: FormatterSpec): string;\n  /** Event raised after the provider has finished reloading its caches.\n   * Uses Set-backed event for safe concurrent add/remove during emit.\n   */\n  readonly onFormattingReady: BeUnorderedUiEvent<void>;\n}\n\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itwin/core-quantity",
-  "version": "5.9.1",
+  "version": "5.9.2",
   "description": "Quantity parsing, formatting and conversions for iModel.js",
   "main": "lib/cjs/core-quantity.js",
   "module": "lib/esm/core-quantity.js",
@@ -28,11 +28,11 @@
     "rimraf": "^6.0.1",
     "typescript": "~5.6.2",
     "vitest": "^3.0.6",
-    "@itwin/build-tools": "5.9.1",
-    "@itwin/core-bentley": "5.9.1"
+    "@itwin/core-bentley": "5.9.2",
+    "@itwin/build-tools": "5.9.2"
   },
   "peerDependencies": {
-    "@itwin/core-bentley": "5.9.1"
+    "@itwin/core-bentley": "5.9.2"
   },
   "scripts": {
     "build": "node scripts/generateUnitsJson.js && npm run -s build:cjs && npm run -s build:esm",