@itwin/ecschema-rpcinterface-tests 5.15.0-dev.3 → 5.15.0-dev.4

package/lib/dist/bundled-tests.js

@@ -92073,12 +92073,27 @@ class IModelApp {
     static get publicPath() { return this._publicPath; }
     /** The [[FormatsProvider]] for this session.
      * @param provider The provider to use for formatting quantities.
+     * @note Prefer [[IModelApp.setFormatsProvider]] when replacing the provider; assigning this property starts an asynchronous reload without returning a promise.
      * @beta
      */
     static get formatsProvider() { return this._formatsProviderManager; }
     static set formatsProvider(provider) {
         this._formatsProviderManager.formatsProvider = provider;
     }
+    /**
+     * Replaces the formats provider and optionally changes the active unit system.
+     * Resolves after the formatter has rebuilt its formatting and parsing caches.
+     * Incompatible provider entries are logged and skipped, so they do not reject this Promise.
+     * If the reload fails, this Promise rejects and the new provider stays installed. The formatter remains usable, but some cached formats may still come from the previous provider.
+     * If a later setFormatsProvider call supersedes this request, this Promise rejects.
+     * It also rejects if the application shuts down first.
+     * @beta
+     */
+    static async setFormatsProvider(provider, options) {
+        await this.quantityFormatter.runAndWaitForReload(() => {
+            this._formatsProviderManager.setFormatsProvider(provider, options?.unitSystem);
+        });
+    }
     /** @alpha */
     static extensionAdmin = this._createExtensionAdmin();
     /** Map of classFullName to EntityState class */
@@ -161177,6 +161192,161 @@ class BaseUnitFormattingSettingsProvider {
 }
 
 
+/***/ },
+
+/***/ "../../core/frontend/lib/esm/quantity-formatting/FormatsProviderReloadCoordinator.js"
+/*!*******************************************************************************************!*\
+  !*** ../../core/frontend/lib/esm/quantity-formatting/FormatsProviderReloadCoordinator.js ***!
+  \*******************************************************************************************/
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+"use strict";
+__webpack_require__.r(__webpack_exports__);
+/* harmony export */ __webpack_require__.d(__webpack_exports__, {
+/* harmony export */   FormatsProviderReloadCoordinator: () => (/* binding */ FormatsProviderReloadCoordinator),
+/* harmony export */   ReloadSupersededError: () => (/* binding */ ReloadSupersededError)
+/* harmony export */ });
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @internal */
+class ReloadSupersededError extends Error {
+    constructor() {
+        super("QuantityFormatter reload was superseded by a newer request.");
+        this.name = "ReloadSupersededError";
+    }
+}
+/**
+ * Serializes formatting reloads and resolves or rejects the caller waiting for formatting to become ready.
+ * @internal
+ */
+class FormatsProviderReloadCoordinator {
+    _host;
+    _disposedError;
+    _reloadInFlight = false;
+    _pendingReload;
+    _pendingFormatsChange;
+    _reloadCaller;
+    _isDisposed = false;
+    constructor(_host, _disposedError) {
+        this._host = _host;
+        this._disposedError = _disposedError;
+    }
+    dispose() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        this._pendingReload = undefined;
+        this._pendingFormatsChange = undefined;
+        this._rejectReloadCaller(this._disposedError);
+    }
+    /**
+     * Runs an action that schedules a reload and waits for the reload queue to drain.
+     * A newer call rejects an older call that is still waiting.
+     */
+    async runAndWaitForReload(action) {
+        if (this._isDisposed)
+            throw this._disposedError;
+        let caller;
+        const reload = new Promise((resolve, reject) => {
+            caller = { resolve, reject };
+        });
+        this._rejectReloadCaller(new ReloadSupersededError());
+        this._reloadCaller = caller;
+        try {
+            action();
+        }
+        catch (error) {
+            if (this._reloadCaller === caller)
+                this._reloadCaller = undefined;
+            throw error;
+        }
+        await reload;
+    }
+    /**
+     * Runs a reload now, or queues it if one is already running.
+     * Pending format changes are merged and kept apart from other pending reloads, so a later unit-system or units-provider reload cannot drop a provider change.
+     * If a reload is already running, this method returns immediately; use [[runAndWaitForReload]] when the caller must wait for completion.
+     * The waiting caller is rejected if any reload fails before the queue drains.
+     */
+    async scheduleReload(intent) {
+        if (this._isDisposed)
+            return;
+        if (this._reloadInFlight) {
+            if (intent.scope === "formatsChanged")
+                this._pendingFormatsChange = mergeFormatsChanges(this._pendingFormatsChange, intent);
+            else
+                this._pendingReload = intent;
+            return;
+        }
+        this._reloadInFlight = true;
+        let failure;
+        let current = intent;
+        while (current) {
+            try {
+                this._host.startReload();
+                await this._host.executeReload(current);
+                if (this._stopAfterDisposal())
+                    return;
+                current = this._takePendingReload();
+                if (!current) {
+                    await this._host.finalizeReload();
+                    if (this._stopAfterDisposal())
+                        return;
+                    current = this._takePendingReload();
+                }
+            }
+            catch (error) {
+                if (this._stopAfterDisposal())
+                    return;
+                // Keep draining so queued work still runs, but report the failure to the waiting caller.
+                this._host.handleReloadFailure(error);
+                failure = { error };
+                current = this._takePendingReload();
+            }
+        }
+        this._reloadInFlight = false;
+        if (failure)
+            this._rejectReloadCaller(failure.error);
+        else
+            this._resolveReloadCaller();
+    }
+    _stopAfterDisposal() {
+        if (!this._isDisposed)
+            return false;
+        this._reloadInFlight = false;
+        return true;
+    }
+    _takePendingReload() {
+        const next = this._pendingFormatsChange ?? this._pendingReload;
+        if (next === this._pendingFormatsChange)
+            this._pendingFormatsChange = undefined;
+        else
+            this._pendingReload = undefined;
+        return next;
+    }
+    _resolveReloadCaller() {
+        const caller = this._reloadCaller;
+        this._reloadCaller = undefined;
+        caller?.resolve();
+    }
+    _rejectReloadCaller(error) {
+        const caller = this._reloadCaller;
+        this._reloadCaller = undefined;
+        caller?.reject(error);
+    }
+}
+function mergeFormatsChanges(pending, next) {
+    if (!pending)
+        return next;
+    const pendingNames = pending.args.formatsChanged;
+    const nextNames = next.args.formatsChanged;
+    const formatsChanged = pendingNames === "all" || nextNames === "all" ? "all" : [...new Set([...pendingNames, ...nextNames])];
+    return { scope: "formatsChanged", args: { formatsChanged } };
+}
+
+
 /***/ },
 
 /***/ "../../core/frontend/lib/esm/quantity-formatting/LocalUnitFormatProvider.js"
@@ -161285,6 +161455,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _common_FrontendLoggerCategory__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../common/FrontendLoggerCategory */ "../../core/frontend/lib/esm/common/FrontendLoggerCategory.js");
 /* harmony import */ var _IModelApp__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../IModelApp */ "../../core/frontend/lib/esm/IModelApp.js");
 /* harmony import */ var _AlternateUnitLabels__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(/*! ./AlternateUnitLabels */ "../../core/frontend/lib/esm/quantity-formatting/AlternateUnitLabels.js");
+/* harmony import */ var _FormatsProviderReloadCoordinator__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(/*! ./FormatsProviderReloadCoordinator */ "../../core/frontend/lib/esm/quantity-formatting/FormatsProviderReloadCoordinator.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -161297,6 +161468,7 @@ __webpack_require__.r(__webpack_exports__);
 
 
 
+
 // cSpell:ignore FORMATPROPS FORMATKEY ussurvey uscustomary USCUSTOM
 /**
  * Defines standard format types for tools that need to display measurements to user.
@@ -161481,12 +161653,24 @@ class FormatsProviderManager {
     }
     get formatsProvider() { return this; }
     set formatsProvider(formatsProvider) {
+        this.setFormatsProvider(formatsProvider);
+    }
+    /**
+     * Replaces the underlying formats provider and raises an event indicating that all formats changed.
+     * @param formatsProvider The formats provider to use for subsequent format lookups.
+     * @param impliedUnitSystem The unit system implied by the replacement provider, if any. Not stored here; [[QuantityFormatter]] applies it as the active unit system when handling `onFormatsChanged`.
+     * @internal
+     */
+    setFormatsProvider(formatsProvider, impliedUnitSystem) {
         this._removeProviderListener?.();
         this._formatsProvider = formatsProvider;
         this._removeProviderListener = this._formatsProvider.onFormatsChanged.addListener((args) => {
             this.onFormatsChanged.raiseEvent(args);
         });
-        this.onFormatsChanged.raiseEvent({ formatsChanged: "all" });
+        const args = { formatsChanged: "all" };
+        if (impliedUnitSystem !== undefined)
+            args.impliedUnitSystem = impliedUnitSystem;
+        this.onFormatsChanged.raiseEvent(args);
     }
 }
 /** The QuantityFormatter class provides methods for formatting and parsing quantities. There are a set of standard quantity types
@@ -161567,10 +161751,13 @@ class QuantityFormatter {
     _hasEverBeenReady = false;
     _initializedPromise;
     _resolveInitialized;
-    _reloadInFlight = false;
-    _pendingReload;
-    _deferredSystemChangedEmit;
+    _emitSystemChangedOnReady = false;
+    _isDisposed = false;
+    _disposedError = new Error("QuantityFormatter was disposed before the reload completed.");
+    _reloadCoordinator;
     _removeFormatsProviderListener;
+    _activeFormatSpecsTarget;
+    _activeParserSpecsTarget;
     /**
      * constructor
      * @param showMetricOrUnitSystem - Pass in `true` to show Metric formatted quantity values. Defaults to Imperial. To explicitly
@@ -161580,6 +161767,12 @@ class QuantityFormatter {
         this._initializedPromise = new Promise((resolve) => {
             this._resolveInitialized = resolve;
         });
+        this._reloadCoordinator = new _FormatsProviderReloadCoordinator__WEBPACK_IMPORTED_MODULE_5__.FormatsProviderReloadCoordinator({
+            startReload: () => { this._isReady = false; },
+            executeReload: async (intent) => this._executeReload(intent),
+            finalizeReload: async () => this.finalizeReload(),
+            handleReloadFailure: (error) => this._handleReloadFailure(error),
+        }, this._disposedError);
         if (undefined !== showMetricOrUnitSystem) {
             if (typeof showMetricOrUnitSystem === "boolean")
                 this._activeUnitSystem = showMetricOrUnitSystem ? "metric" : "imperial";
@@ -161588,70 +161781,44 @@ class QuantityFormatter {
         }
     }
     [Symbol.dispose]() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        this._isReady = false;
+        this._emitSystemChangedOnReady = false;
+        this._reloadCoordinator.dispose();
         if (this._removeFormatsProviderListener) {
             this._removeFormatsProviderListener();
             this._removeFormatsProviderListener = undefined;
         }
     }
+    /** Runs an action that schedules a reload and waits for the reload queue to drain.
+     * The most recent call wins. If another call is made before this reload queue drains, this call is rejected.
+     * @internal
+     */
+    async runAndWaitForReload(action) {
+        return this._reloadCoordinator.runAndWaitForReload(action);
+    }
     /** Schedule an async reload. If no reload is in flight, runs immediately. If a reload is
-     * already in flight, stores the intent as pending (latest-wins: only the last scheduled reload
-     * is kept). `finalizeReload()` fires only when the queue is fully drained.
+     * already in flight, stores the intent as pending. Pending format changes are merged and run before
+     * the latest other pending intent. `finalizeReload()` fires only when the queue is fully drained.
      *
      * **Await semantics:** When a reload is already in flight, the returned promise resolves
      * immediately *without* the requested reload having run. Callers that need to know when
-     * the reload has actually completed should listen for `onFormattingReady` instead.
+     * an explicitly triggered reload has actually completed should use [[runAndWaitForReload]].
      *
-     * Reload intents:
-     * - `"full"` — rebuild entire registry + re-register provider listener (onInitialized, setUnitsProvider)
-     * - `"formatsChanged"` — patch registry from provider + load maps (formatsChanged listener)
-     * - `"activeSystem"` — reload format/parsing maps for current unit system (setActiveUnitSystem, reinitializeFormatAndParsingsMaps)
      * @internal
      */
     async scheduleReload(intent) {
-        if (this._reloadInFlight) {
-            // A reload is already running — queue this one (latest-wins)
-            this._pendingReload = intent;
-            return;
-        }
-        this._reloadInFlight = true;
-        this._isReady = false;
-        this._deferredSystemChangedEmit = undefined; // Clear stale deferred from prior cycle
-        try {
-            await this._executeReload(intent);
-        }
-        catch (err) {
-            _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Logger.logError(`${_common_FrontendLoggerCategory__WEBPACK_IMPORTED_MODULE_2__.FrontendLoggerCategory.Package}.QuantityFormatter`, _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.BentleyError.getErrorMessage(err));
-            this._reloadInFlight = false;
-            // If there's a pending reload, still try to run it
-            if (this._pendingReload) {
-                const next = this._pendingReload;
-                this._pendingReload = undefined;
-                return this.scheduleReload(next);
-            }
-            // Restore prior ready state so stale-but-usable specs remain accessible
-            if (this._hasEverBeenReady) {
-                _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Logger.logWarning(`${_common_FrontendLoggerCategory__WEBPACK_IMPORTED_MODULE_2__.FrontendLoggerCategory.Package}.QuantityFormatter`, "Reload failed — restoring previous ready state. Cached specs may be stale.");
-                this._isReady = true;
-            }
-            return;
-        }
-        // Current reload succeeded — check if another was queued
-        if (this._pendingReload) {
-            const next = this._pendingReload;
-            this._pendingReload = undefined;
-            this._reloadInFlight = false;
-            return this.scheduleReload(next);
-        }
-        // Queue is drained — finalize
-        await this.finalizeReload();
-        // A new reload may have been queued during the async finalizeReload window
-        if (this._pendingReload) {
-            const next = this._pendingReload;
-            this._pendingReload = undefined;
-            this._reloadInFlight = false;
-            return this.scheduleReload(next);
+        return this._reloadCoordinator.scheduleReload(intent);
+    }
+    _handleReloadFailure(error) {
+        if (!this._isDisposed)
+            _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Logger.logError(`${_common_FrontendLoggerCategory__WEBPACK_IMPORTED_MODULE_2__.FrontendLoggerCategory.Package}.QuantityFormatter`, _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.BentleyError.getErrorMessage(error));
+        if (this._hasEverBeenReady && !this._isDisposed) {
+            _itwin_core_bentley__WEBPACK_IMPORTED_MODULE_0__.Logger.logWarning(`${_common_FrontendLoggerCategory__WEBPACK_IMPORTED_MODULE_2__.FrontendLoggerCategory.Package}.QuantityFormatter`, "Reload failed — restoring previous ready state. Cached specs may be stale.");
+            this._isReady = true;
         }
-        this._reloadInFlight = false;
     }
     /** Execute the reload work for a given intent. All reload logic is centralized here.
      * @internal
@@ -161660,47 +161827,51 @@ class QuantityFormatter {
         switch (intent.scope) {
             case "full":
                 await this._reloadCore();
+                return;
+            case "formatsChanged":
+                await this._rebuildRegistryFromProvider(intent.args);
                 break;
-            case "formatsChanged": {
-                const { args } = intent;
-                await this._rebuildRegistryFromProvider(args);
-                if (args.impliedUnitSystem && args.impliedUnitSystem !== this._activeUnitSystem) {
-                    this._activeUnitSystem = args.impliedUnitSystem;
-                }
-                await this.loadFormatAndParsingMapsForSystem(this._activeUnitSystem);
-                if (args.impliedUnitSystem) {
-                    this._deferredSystemChangedEmit = { system: this._activeUnitSystem };
-                }
-                break;
-            }
-            case "activeSystem":
-                await this.loadFormatAndParsingMapsForSystem(this._activeUnitSystem);
-                if (intent.emitSystemChanged) {
-                    this._deferredSystemChangedEmit = { system: this._activeUnitSystem };
-                }
-                break;
         }
+        // Build the active specs in temporary maps so readers keep using complete specs until the new ones are ready.
+        const nextFormatSpecs = new Map();
+        const nextParserSpecs = new Map();
+        this._activeFormatSpecsTarget = nextFormatSpecs;
+        this._activeParserSpecsTarget = nextParserSpecs;
+        try {
+            await this.loadFormatAndParsingMapsForSystem(this._activeUnitSystem);
+        }
+        finally {
+            this._activeFormatSpecsTarget = undefined;
+            this._activeParserSpecsTarget = undefined;
+        }
+        this._activeFormatSpecsByType = nextFormatSpecs;
+        this._activeParserSpecsByType = nextParserSpecs;
     }
     /** Called when the reload queue is fully drained after a successful reload.
      * Sets `isReady` to true, resolves `whenInitialized` (one-shot), and emits ready events.
      * @internal
      */
     async finalizeReload() {
+        if (this._isDisposed)
+            return;
         // Phase 1: Let providers register async work
         const collector = new _itwin_core_quantity__WEBPACK_IMPORTED_MODULE_1__.FormattingReadyCollector();
         this.onBeforeFormattingReady.raiseEvent(collector);
         await collector.awaitAll();
+        if (this._isDisposed)
+            return;
         // Phase 2: Signal ready to consumers
         this._isReady = true;
         this._hasEverBeenReady = true;
         this._resolveInitialized();
         this.onFormattingReady.emit();
-        // Phase 3: Emit deferred unit-system-changed if the winning reload set one.
+        if (this._isDisposed)
+            return;
+        // Phase 3: Emit unit-system-changed if the unit system was changed since the last ready state, reporting the system that is now active.
         // This fires after isReady === true so listeners can safely use the formatter.
-        if (this._deferredSystemChangedEmit) {
-            const args = this._deferredSystemChangedEmit;
-            this._deferredSystemChangedEmit = undefined;
-            this.onActiveFormattingUnitSystemChanged.emit(args);
+        if (this._emitSystemChangedOnReady) {
+            this._emitSystemChangedOnReady = false;
+            this.onActiveFormattingUnitSystemChanged.emit({ system: this._activeUnitSystem });
         }
     }
     getOverrideFormatPropsByQuantityType(quantityTypeKey, unitSystem) {
@@ -161771,8 +161942,8 @@ class QuantityFormatter {
     async loadFormatAndParserSpec(quantityTypeDefinition, formatProps) {
         const formatterSpec = await quantityTypeDefinition.generateFormatterSpec(formatProps, this.unitsProvider);
         const parserSpec = await quantityTypeDefinition.generateParserSpec(formatProps, this.unitsProvider, this.alternateUnitLabelsProvider);
-        this._activeFormatSpecsByType.set(quantityTypeDefinition.key, formatterSpec);
-        this._activeParserSpecsByType.set(quantityTypeDefinition.key, parserSpec);
+        (this._activeFormatSpecsTarget ?? this._activeFormatSpecsByType).set(quantityTypeDefinition.key, formatterSpec);
+        (this._activeParserSpecsTarget ?? this._activeParserSpecsByType).set(quantityTypeDefinition.key, parserSpec);
     }
     // repopulate formatSpec and parserSpec entries using only default format
     async loadDefaultFormatAndParserSpecForQuantity(typeKey) {
@@ -161829,17 +162000,20 @@ class QuantityFormatter {
      * @internal
      */
     async onInitialized() {
+        // Register once, before the first reload, so provider changes made while a units-provider reload is running are not missed.
+        this._removeFormatsProviderListener ??= _IModelApp__WEBPACK_IMPORTED_MODULE_3__.IModelApp.formatsProvider.onFormatsChanged.addListener((args) => {
+            if (args.impliedUnitSystem && args.impliedUnitSystem !== this._activeUnitSystem) {
+                this._activeUnitSystem = args.impliedUnitSystem;
+                this._emitSystemChangedOnReady = true;
+            }
+            void this.scheduleReload({ scope: "formatsChanged", args });
+        });
         await this.scheduleReload({ scope: "full" });
     }
     /** Core reload logic — does all async I/O and cache rebuilding without events or state management.
      * @internal
      */
     async _reloadCore() {
-        // Remove any existing listener before re-registering to avoid duplicates when called via setUnitsProvider.
-        if (this._removeFormatsProviderListener) {
-            this._removeFormatsProviderListener();
-            this._removeFormatsProviderListener = undefined;
-        }
         await this.initializeQuantityTypesRegistry();
         const initialKoQs = [["DefaultToolsUnits.LENGTH", "Units.M"], ["DefaultToolsUnits.ANGLE", "Units.RAD"], ["DefaultToolsUnits.AREA", "Units.SQ_M"], ["DefaultToolsUnits.VOLUME", "Units.CUB_M"], ["DefaultToolsUnits.LENGTH_COORDINATE", "Units.M"], ["CivilUnits.STATION", "Units.M"], ["CivilUnits.LENGTH", "Units.M"], ["AecUnits.LENGTH", "Units.M"]];
         for (const entry of initialKoQs) {
@@ -161852,10 +162026,6 @@ class QuantityFormatter {
                 }
             }
         }
-        // Register formatsProvider listener that triggers a queued reload when formats change
-        this._removeFormatsProviderListener = _IModelApp__WEBPACK_IMPORTED_MODULE_3__.IModelApp.formatsProvider.onFormatsChanged.addListener((args) => {
-            void this.scheduleReload({ scope: "formatsChanged", args });
-        });
         // initialize default format and parsing specs
         await this.loadFormatAndParsingMapsForSystem();
     }
@@ -161949,6 +162119,9 @@ class QuantityFormatter {
             await _IModelApp__WEBPACK_IMPORTED_MODULE_3__.IModelApp.quantityFormatter.resetToUseInternalUnitsProvider();
             return;
         }
+        // Disposal can occur while the reload is awaited, so do not notify afterward.
+        if (this._isDisposed)
+            return;
         this.onUnitsProviderChanged.emit();
     }
     /**
@@ -161988,7 +162161,11 @@ class QuantityFormatter {
             this._overrideFormatPropsByUnitSystem = overrideFormatPropsByUnitSystem;
         }
         unitSystemKey && (this._activeUnitSystem = unitSystemKey);
-        await this.scheduleReload({ scope: "activeSystem", emitSystemChanged: fireUnitSystemChanged });
+        if (fireUnitSystemChanged)
+            this._emitSystemChangedOnReady = true;
+        await this.scheduleReload({ scope: "activeSystem" });
+        if (this._isDisposed)
+            return;
         _IModelApp__WEBPACK_IMPORTED_MODULE_3__.IModelApp.toolAdmin && startDefaultTool && await _IModelApp__WEBPACK_IMPORTED_MODULE_3__.IModelApp.toolAdmin.startDefaultTool();
     }
     /** Set the Active unit system to one of the supported types. This will asynchronously load the formatter and parser specs for the activated system. */
@@ -162001,7 +162178,10 @@ class QuantityFormatter {
         if (this._activeUnitSystem === systemType)
             return;
         this._activeUnitSystem = systemType;
-        await this.scheduleReload({ scope: "activeSystem", emitSystemChanged: true });
+        this._emitSystemChangedOnReady = true;
+        await this.scheduleReload({ scope: "activeSystem" });
+        if (this._isDisposed)
+            return;
         // allow settings provider to store the change
         await this._unitFormattingSettingsProvider?.storeUnitSystemSetting({ system: systemType });
         if (_IModelApp__WEBPACK_IMPORTED_MODULE_3__.IModelApp.toolAdmin && restartActiveTool)
@@ -206988,6 +207168,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   EllipsoidPatch: () => (/* reexport safe */ _geometry3d_Ellipsoid__WEBPACK_IMPORTED_MODULE_5__.EllipsoidPatch),
 /* harmony export */   EllipticalArcApproximationOptions: () => (/* reexport safe */ _curve_Arc3d__WEBPACK_IMPORTED_MODULE_60__.EllipticalArcApproximationOptions),
 /* harmony export */   EllipticalArcSampleMethod: () => (/* reexport safe */ _curve_Arc3d__WEBPACK_IMPORTED_MODULE_60__.EllipticalArcSampleMethod),
+/* harmony export */   ExteriorFractionSelector: () => (/* reexport safe */ _geometry3d_AngleSweep__WEBPACK_IMPORTED_MODULE_1__.ExteriorFractionSelector),
 /* harmony export */   FacetFaceData: () => (/* reexport safe */ _polyface_FacetFaceData__WEBPACK_IMPORTED_MODULE_113__.FacetFaceData),
 /* harmony export */   FacetIntersectOptions: () => (/* reexport safe */ _polyface_FacetLocationDetail__WEBPACK_IMPORTED_MODULE_115__.FacetIntersectOptions),
 /* harmony export */   FacetLocationDetailPair: () => (/* reexport safe */ _polyface_FacetLocationDetail__WEBPACK_IMPORTED_MODULE_115__.FacetLocationDetailPair),
@@ -211269,6 +211450,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   CurveExtendOptions: () => (/* binding */ CurveExtendOptions)
 /* harmony export */ });
 /* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
+/* harmony import */ var _geometry3d_AngleSweep__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../geometry3d/AngleSweep */ "../../core/geometry/lib/esm/geometry3d/AngleSweep.js");
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
@@ -211277,6 +211459,7 @@ __webpack_require__.r(__webpack_exports__);
  * @module Curve
  */
 
+
 /**
  * Enumeration of condition for extending a curve beyond start or end point.
  * * Not all CurvePrimitives support these modes.
@@ -211344,27 +211527,21 @@ class CurveExtendOptions {
      * the sweep extended per `extendParam`.
      */
     static resolveRadiansToValidSweepFraction(extendParam, radians, sweep) {
-        extendParam ??= false;
-        let fraction = sweep.radiansToSignedPeriodicFraction(radians);
+        let fraction = sweep.radiansToSignedPeriodicFraction(radians, 0, _geometry3d_AngleSweep__WEBPACK_IMPORTED_MODULE_1__.ExteriorFractionSelector.Closer);
         let isValid = true;
-        if (!sweep.isRadiansInSweep(radians)) {
-            const fractionPeriod = sweep.fractionPeriod();
+        if (!_Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.isIn01(fraction)) {
             const mode0 = CurveExtendOptions.resolveVariantCurveExtendParameterToCurveExtendMode(extendParam, 0);
             const mode1 = CurveExtendOptions.resolveVariantCurveExtendParameterToCurveExtendMode(extendParam, 1);
-            if (mode0 !== CurveExtendMode.None) {
-                if (mode1 === CurveExtendMode.None) { // only extend to negative
-                    if (fraction > 1.0)
-                        fraction -= fractionPeriod;
-                }
-            }
-            else if (mode1 !== CurveExtendMode.None) { // only extend to positive
-                if (fraction < 0.0)
-                    fraction += fractionPeriod;
-            }
-            else { // no extension allowed
+            if (mode0 === CurveExtendMode.None && mode1 === CurveExtendMode.None) {
                 fraction = _Geometry__WEBPACK_IMPORTED_MODULE_0__.Geometry.clamp(fraction, 0, 1);
                 isValid = false;
             }
+            else if (mode1 === CurveExtendMode.None && mode0 !== CurveExtendMode.None) {
+                fraction = sweep.radiansToSignedPeriodicFraction(radians, 0, _geometry3d_AngleSweep__WEBPACK_IMPORTED_MODULE_1__.ExteriorFractionSelector.Negative);
+            }
+            else if (mode0 === CurveExtendMode.None && mode1 !== CurveExtendMode.None) {
+                fraction = sweep.radiansToSignedPeriodicFraction(radians, 0, _geometry3d_AngleSweep__WEBPACK_IMPORTED_MODULE_1__.ExteriorFractionSelector.Positive);
+            }
         }
         return { fraction, isValid };
     }
@@ -212720,7 +212897,22 @@ class CurveLocationDetail {
         if (detailA) {
             if (!detailB)
                 return detailA;
-            return detailA.a <= detailB.a ? detailA : detailB;
+            // tiebreakers (exact comparison!)
+            if (detailA.a === detailB.a) {
+                // prefer interior to exterior
+                const isInteriorA = _Geometry__WEBPACK_IMPORTED_MODULE_1__.Geometry.isIn01(detailA.fraction);
+                const isInteriorB = _Geometry__WEBPACK_IMPORTED_MODULE_1__.Geometry.isIn01(detailB.fraction);
+                if (isInteriorA && !isInteriorB)
+                    return detailA;
+                if (!isInteriorA && isInteriorB)
+                    return detailB;
+                if (!isInteriorA && !isInteriorB) { // prefer exterior closer to [0,1]
+                    const distFrom01A = detailA.fraction < 0 ? -detailA.fraction : detailA.fraction - 1;
+                    const distFrom01B = detailB.fraction < 0 ? -detailB.fraction : detailB.fraction - 1;
+                    return (distFrom01A <= distFrom01B) ? detailA : detailB;
+                }
+            }
+            return detailA.a < detailB.a ? detailA : detailB;
         }
         return detailB;
     }
@@ -233811,7 +234003,8 @@ class Angle {
 "use strict";
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   AngleSweep: () => (/* binding */ AngleSweep)
+/* harmony export */   AngleSweep: () => (/* binding */ AngleSweep),
+/* harmony export */   ExteriorFractionSelector: () => (/* binding */ ExteriorFractionSelector)
 /* harmony export */ });
 /* harmony import */ var _Geometry__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../Geometry */ "../../core/geometry/lib/esm/Geometry.js");
 /* harmony import */ var _Angle__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./Angle */ "../../core/geometry/lib/esm/geometry3d/Angle.js");
@@ -233824,6 +234017,22 @@ __webpack_require__.r(__webpack_exports__);
  */
 
 
+/**
+ * Selector for how to convert an angle outside of a sweep to an exterior fraction.
+ * @see [[AngleSweep.radiansToSignedPeriodicFractionStartEnd]], [[AngleSweep.angleToSignedPeriodicFraction]], [[AngleSweep.radiansToSignedPeriodicFraction]]
+ * @public
+ */
+var ExteriorFractionSelector;
+(function (ExteriorFractionSelector) {
+    /** Request [[Positive]] or [[Negative]] based on input sign. */
+    ExteriorFractionSelector[ExteriorFractionSelector["SameSign"] = -1] = "SameSign";
+    /** Request positive exterior fraction within one period of 1. */
+    ExteriorFractionSelector[ExteriorFractionSelector["Positive"] = 0] = "Positive";
+    /** Request negative exterior fraction within one period of 0. */
+    ExteriorFractionSelector[ExteriorFractionSelector["Negative"] = 1] = "Negative";
+    /** Request the period-shifted exterior fraction closest to [0,1]. */
+    ExteriorFractionSelector[ExteriorFractionSelector["Closer"] = 2] = "Closer";
+})(ExteriorFractionSelector || (ExteriorFractionSelector = {}));
 /**
  * An `AngleSweep` is a pair of angles at start and end of an interval.
  *
@@ -234208,9 +234417,12 @@ class AngleSweep {
      * @param radians0 start angle of sweep (in radians)
      * @param radians1 end angle of sweep (in radians)
      * @param zeroSweepDefault return value when the sweep is empty (default 0)
+     * @param selector how to handle an angle outside of the sweep. Default value is
+     * [[ExteriorFractionSelector.SameSign]], to request a fraction with the same sign
+     * as the unbounded fraction `(radians - radians0) / (radians1 - radians0)`.
      * @returns fraction, or `zeroSweepDefault` if the sweep is empty.
      */
-    static radiansToSignedPeriodicFractionStartEnd(radians, radians0, radians1, zeroSweepDefault = 0.0) {
+    static radiansToSignedPeriodicFractionStartEnd(radians, radians0, radians1, zeroSweepDefault = 0.0, selector = ExteriorFractionSelector.SameSign) {
         const sweep = radians1 - radians0;
         if (_Angle__WEBPACK_IMPORTED_MODULE_1__.Angle.isAlmostEqualRadiansNoPeriodShift(0, sweep))
             return zeroSweepDefault;
@@ -234228,7 +234440,14 @@ class AngleSweep {
                 return 1.0;
         }
         const fraction = (radians - radians0) / sweep;
-        return this.fractionToSignedPeriodicFractionStartEnd(fraction, radians0, radians1, fraction < 0);
+        let toNegativeFraction;
+        if (selector === ExteriorFractionSelector.Negative)
+            toNegativeFraction = true;
+        else if (selector === ExteriorFractionSelector.Positive)
+            toNegativeFraction = false;
+        else if (selector === ExteriorFractionSelector.SameSign)
+            toNegativeFraction = fraction < 0;
+        return this.fractionToSignedPeriodicFractionStartEnd(fraction, radians0, radians1, toNegativeFraction);
     }
     /**
      * Return the fractionalized position of the given angle (as radians) computed with consideration of
@@ -234241,10 +234460,13 @@ class AngleSweep {
      * *  allows period shift
      * @param radians input angle (in radians)
      * @param zeroSweepDefault return value when this sweep is empty (default 0)
+     * @param selector how to handle an angle outside of the sweep. Default value is
+     * [[ExteriorFractionSelector.SameSign]], to request a fraction with the same sign
+     * as the unbounded fraction `(radians - startRadians) / sweepRadians`.
      * @returns fraction, or `zeroSweepDefault` if this sweep is empty.
      */
-    radiansToSignedPeriodicFraction(radians, zeroSweepDefault = 0.0) {
-        return AngleSweep.radiansToSignedPeriodicFractionStartEnd(radians, this._radians0, this._radians1, zeroSweepDefault);
+    radiansToSignedPeriodicFraction(radians, zeroSweepDefault = 0.0, selector = ExteriorFractionSelector.SameSign) {
+        return AngleSweep.radiansToSignedPeriodicFractionStartEnd(radians, this._radians0, this._radians1, zeroSweepDefault, selector);
     }
     /**
      * Return the fractionalized position of the given angle (as Angle) computed with consideration of
@@ -234257,10 +234479,13 @@ class AngleSweep {
      * *  allows period shift
      * @param theta input angle
      * @param zeroSweepDefault return value when this sweep is empty (default 0)
+     * @param selector how to handle an angle outside of the sweep. Default value is
+     * [[ExteriorFractionSelector.SameSign]], to request a fraction with the same sign
+     * as the fraction returned by `angleToUnboundedFraction(theta)`.
      * @returns fraction, or `zeroSweepDefault` if this sweep is empty.
      */
-    angleToSignedPeriodicFraction(theta, zeroSweepDefault = 0.0) {
-        return this.radiansToSignedPeriodicFraction(theta.radians, zeroSweepDefault);
+    angleToSignedPeriodicFraction(theta, zeroSweepDefault = 0.0, selector = ExteriorFractionSelector.SameSign) {
+        return this.radiansToSignedPeriodicFraction(theta.radians, zeroSweepDefault, selector);
     }
     /**
      * Return the fractionalized position of the given radian angle with respect to the sweep.
@@ -337329,7 +337554,7 @@ class WMS {
 (module) {
 
 "use strict";
-module.exports = /*#__PURE__*/JSON.parse('{"name":"@itwin/core-frontend","version":"5.15.0-dev.3","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs && npm run -s build:esm && npm run -s build:workers && npm run -s copy:draco","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2022 --outDir lib/esm","clean":"rimraf -g lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","copy:draco":"cpx \\"./node_modules/@loaders.gl/draco/dist/libs/*\\" ./lib/public/scripts","docs":"betools docs --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts && npm run -s extract","extract":"betools extract --fileExt=ts --extractFrom=./src/test/example-code --recursive --out=../../generated-docs/extract","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-inline-config -c extraction.eslint.config.js  \\"./src/**/*.ts\\" 1>&2","lint":"eslint \\"./src/**/*.ts\\" 1>&2","lint-fix":"eslint --fix -f visualstudio \\"./src/**/*.ts\\" 1>&2","lint-deprecation":"eslint --fix -f visualstudio --no-inline-config -c ../../common/config/eslint/eslint.config.deprecation-policy.js \\"./src/**/*.ts\\"","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run build:test-worker && vitest --run","cover":"npm run build:test-worker && vitest --run","build:test-worker":"vite build --config ./src/test/worker/vite.config.mts 1>&2","build:workers":"rimraf lib/workers/webpack && vite build --config ./src/workers/ImdlParser/vite.config.mts 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@bentley/aec-units-schema":"^1.0.3","@bentley/formats-schema":"^1.0.0","@bentley/units-schema":"^1.0.11","@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*","@itwin/object-storage-core":"^3.0.4","@itwin/eslint-plugin":"^6.0.0","@types/node":"~20.17.0","@types/sinon":"^17.0.2","@vitest/browser-playwright":"^4.1.10","@vitest/coverage-v8":"^4.1.10","cpx2":"^8.0.0","eslint":"^9.31.0","playwright":"~1.56.1","rimraf":"^6.0.1","sinon":"^17.0.2","typescript":"~5.6.2","vite":"^6.4.3","vitest":"^4.1.10"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/core-i18n":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^4.4.5","@loaders.gl/draco":"^4.4.5","fuse.js":"^3.3.0","wms-capabilities":"0.6.0"}}');
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@itwin/core-frontend","version":"5.15.0-dev.4","description":"iTwin.js frontend components","main":"lib/cjs/core-frontend.js","module":"lib/esm/core-frontend.js","typings":"lib/cjs/core-frontend","license":"MIT","scripts":{"build":"npm run -s copy:public && npm run -s build:cjs && npm run -s build:esm && npm run -s build:workers && npm run -s copy:draco","build:cjs":"npm run -s copy:js:cjs && tsc 1>&2 --outDir lib/cjs","build:esm":"npm run -s copy:js:esm && tsc 1>&2 --module ES2022 --outDir lib/esm","clean":"rimraf -g lib .rush/temp/package-deps*.json","copy:public":"cpx \\"./src/public/**/*\\" ./lib/public","copy:js:cjs":"cpx \\"./src/**/*.js\\" ./lib/cjs","copy:js:esm":"cpx \\"./src/**/*.js\\" ./lib/esm","copy:draco":"cpx \\"./node_modules/@loaders.gl/draco/dist/libs/*\\" ./lib/public/scripts","docs":"betools docs --json=../../generated-docs/core/core-frontend/file.json --tsIndexFile=./core-frontend.ts --onlyJson --excludes=webgl/**/*,**/map/*.d.ts,**/tile/*.d.ts,**/*-css.ts && npm run -s extract","extract":"betools extract --fileExt=ts --extractFrom=./src/test/example-code --recursive --out=../../generated-docs/extract","extract-api":"betools extract-api --entry=core-frontend && npm run extract-extension-api","extract-extension-api":"eslint --no-inline-config -c extraction.eslint.config.js  \\"./src/**/*.ts\\" 1>&2","lint":"eslint \\"./src/**/*.ts\\" 1>&2","lint-fix":"eslint --fix -f visualstudio \\"./src/**/*.ts\\" 1>&2","lint-deprecation":"eslint --fix -f visualstudio --no-inline-config -c ../../common/config/eslint/eslint.config.deprecation-policy.js \\"./src/**/*.ts\\"","pseudolocalize":"betools pseudolocalize --englishDir ./src/public/locales/en --out ./public/locales/en-PSEUDO","test":"npm run build:test-worker && vitest --run","cover":"npm run build:test-worker && vitest --run","build:test-worker":"vite build --config ./src/test/worker/vite.config.mts 1>&2","build:workers":"rimraf lib/workers/webpack && vite build --config ./src/workers/ImdlParser/vite.config.mts 1>&2"},"repository":{"type":"git","url":"https://github.com/iTwin/itwinjs-core.git","directory":"core/frontend"},"keywords":["Bentley","BIM","iModel","digital-twin","iTwin"],"author":{"name":"Bentley Systems, Inc.","url":"http://www.bentley.com"},"peerDependencies":{"@itwin/appui-abstract":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*"},"//devDependencies":["NOTE: All peerDependencies should also be listed as devDependencies since peerDependencies are not considered by npm install","NOTE: All tools used by scripts in this package must be listed as devDependencies"],"devDependencies":{"@bentley/aec-units-schema":"^1.0.3","@bentley/formats-schema":"^1.0.0","@bentley/units-schema":"^1.0.11","@itwin/appui-abstract":"workspace:*","@itwin/build-tools":"workspace:*","@itwin/core-bentley":"workspace:*","@itwin/core-common":"workspace:*","@itwin/core-geometry":"workspace:*","@itwin/core-orbitgt":"workspace:*","@itwin/core-quantity":"workspace:*","@itwin/ecschema-metadata":"workspace:*","@itwin/ecschema-rpcinterface-common":"workspace:*","@itwin/object-storage-core":"^3.0.4","@itwin/eslint-plugin":"^6.0.0","@types/node":"~20.17.0","@types/sinon":"^17.0.2","@vitest/browser-playwright":"^4.1.10","@vitest/coverage-v8":"^4.1.10","cpx2":"^8.0.0","eslint":"^9.31.0","playwright":"~1.56.1","rimraf":"^6.0.1","sinon":"^17.0.2","typescript":"~5.6.2","vite":"^6.4.3","vitest":"^4.1.10"},"//dependencies":["NOTE: these dependencies should be only for things that DO NOT APPEAR IN THE API","NOTE: core-frontend should remain UI technology agnostic, so no react/angular dependencies are allowed"],"dependencies":{"@itwin/core-i18n":"workspace:*","@itwin/webgl-compatibility":"workspace:*","@loaders.gl/core":"^4.4.5","@loaders.gl/draco":"^4.4.5","fuse.js":"^3.3.0","wms-capabilities":"0.6.0"}}');
 
 /***/ },