@mlightcad/cad-simple-viewer 1.6.2 → 1.7.0

package/lib/app/{AcDbOpenDatabaseOptions.d.ts → AcApOpenDatabaseOptions.d.ts}

@@ -1,4 +1,4 @@
-import { AcDbOpenDatabaseOptions } from '@mlightcad/data-model';
+import { AcCmColor, AcDbOpenDatabaseOptions } from '@mlightcad/data-model';
 import { AcEdOpenMode } from '../editor/view';
 /**
  * Controls how the view is framed immediately after a document opens.
@@ -9,6 +9,14 @@ export declare enum AcApOpenViewMode {
     /** Restore AutoCAD's saved view (layout limits, VPORT `*ACTIVE`, EXTMIN/EXTMAX). */
     Saved = "saved"
 }
+/**
+ * Open-time system-variable overrides.
+ *
+ * Extends {@link AcDbOpenDatabaseOptions.sysVars} so colour sysvars such as
+ * `PAPERBKCOLOR` / `MODELBKCOLOR` can take an {@link AcCmColor} (for example
+ * from {@link layoutBackgroundColorFromRgb}), not only number/boolean/string.
+ */
+export type AcApOpenSysVars = Record<string, number | boolean | string | AcCmColor>;
 /**
  * Options for opening a CAD database.
  *
@@ -16,9 +24,15 @@ export declare enum AcApOpenViewMode {
  * the `readOnly` property with a `mode` property that provides more granular
  * access control.
  *
- * Inherits {@link AcDbOpenDatabaseOptions.drawNoPlotLayers} from the data
- * model. {@link AcApDocManager} defaults `drawNoPlotLayers` to `false`
- * (web viewer semantics) when omitted.
+ * Inherits {@link AcDbOpenDatabaseOptions.drawNoPlotLayers} and
+ * {@link AcDbOpenDatabaseOptions.circleSides} from the data model.
+ * {@link AcApDocManager} defaults `drawNoPlotLayers` to `false`
+ * (web viewer semantics) when omitted. When `circleSides` is omitted,
+ * the data model uses draft quality (50).
+ *
+ * Use {@link sysVars} to override session/database system variables at open
+ * time (for example `paperbkcolor` for the paper-space canvas background, or
+ * `lwdisplay: false` to hide lineweights).
  *
  * Fonts are not loaded during database open. They are fetched on demand by
  * `@mlightcad/mtext-renderer` (`FontManager.lazyFontLoading`) while text is
@@ -28,12 +42,18 @@ export declare enum AcApOpenViewMode {
  *
  * @example
  * ```typescript
+ * import { layoutBackgroundColorFromRgb } from '@mlightcad/cad-simple-viewer'
+ *
  * const options: AcApOpenDatabaseOptions = {
- *   mode: AcEdOpenMode.Write
- * };
+ *   mode: AcEdOpenMode.Write,
+ *   sysVars: {
+ *     lwdisplay: false,
+ *     paperbkcolor: layoutBackgroundColorFromRgb(0x000000)
+ *   }
+ * }
  * ```
  */
-export interface AcApOpenDatabaseOptions extends Omit<AcDbOpenDatabaseOptions, 'readOnly'> {
+export interface AcApOpenDatabaseOptions extends Omit<AcDbOpenDatabaseOptions, 'readOnly' | 'sysVars'> {
     /**
      * The access mode for opening the database.
      * Higher value modes are compatible with lower value modes.
@@ -59,5 +79,12 @@ export interface AcApOpenDatabaseOptions extends Omit<AcDbOpenDatabaseOptions, '
      * Write mode uses {@link AcApOpenViewMode.Saved} (AutoCAD VPORT behavior).
      */
     openViewMode?: AcApOpenViewMode;
+    /**
+     * System variables to override when the database opens.
+     *
+     * Keys are system variable names (case-insensitive). Colour sysvars such as
+     * `PAPERBKCOLOR` accept {@link AcCmColor}; see {@link AcApOpenSysVars}.
+     */
+    sysVars?: AcApOpenSysVars;
 }
-//# sourceMappingURL=AcDbOpenDatabaseOptions.d.ts.map
+//# sourceMappingURL=AcApOpenDatabaseOptions.d.ts.map

package/lib/app/AcApOpenDatabaseOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApOpenDatabaseOptions.d.ts","sourceRoot":"","sources":["../../src/app/AcApOpenDatabaseOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,uBAAuB,EACxB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7C;;GAEG;AACH,oBAAY,gBAAgB;IAC1B,+EAA+E;IAC/E,OAAO,YAAY;IACnB,oFAAoF;IACpF,KAAK,UAAU;CAChB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAClC,MAAM,EACN,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CACtC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,uBAAuB,EACvB,UAAU,GAAG,SAAS,CACvB;IACC;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAE9B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAA;IAE/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;CAC1B"}

package/lib/app/{AcDbOpenDatabaseOptions.js → AcApOpenDatabaseOptions.js}

@@ -8,4 +8,4 @@ export var AcApOpenViewMode;
     /** Restore AutoCAD's saved view (layout limits, VPORT `*ACTIVE`, EXTMIN/EXTMAX). */
     AcApOpenViewMode["Saved"] = "saved";
 })(AcApOpenViewMode || (AcApOpenViewMode = {}));
-//# sourceMappingURL=AcDbOpenDatabaseOptions.js.map
+//# sourceMappingURL=AcApOpenDatabaseOptions.js.map

package/lib/app/AcApOpenDatabaseOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApOpenDatabaseOptions.js","sourceRoot":"","sources":["../../src/app/AcApOpenDatabaseOptions.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,CAAN,IAAY,gBAKX;AALD,WAAY,gBAAgB;IAC1B,+EAA+E;IAC/E,uCAAmB,CAAA;IACnB,oFAAoF;IACpF,mCAAe,CAAA;AACjB,CAAC,EALW,gBAAgB,KAAhB,gBAAgB,QAK3B"}

package/lib/app/AcApOpenFileDialog.d.ts

@@ -1,4 +1,4 @@
-import type { AcApOpenDatabaseOptions } from './AcDbOpenDatabaseOptions';
+import type { AcApOpenDatabaseOptions } from './AcApOpenDatabaseOptions';
 /**
  * Resolver for default options used by the built-in OPEN file dialog.
  *

package/lib/app/AcApOpenFileProgressController.d.ts

@@ -22,6 +22,8 @@ export declare class AcApOpenFileProgressController {
     private _lastMessage;
     private _seeThrough;
     private _sceneBusyGate?;
+    /** Callback invoked after the overlay is hidden. */
+    private _onHidden?;
     private _holdPollId?;
     private static readonly OVERLAY_DEFAULT;
     private static readonly OVERLAY_SEE_THROUGH;
@@ -29,6 +31,12 @@ export declare class AcApOpenFileProgressController {
      * @param host - Canvas container that receives the progress overlay
      */
     constructor(host: HTMLElement);
+    /**
+     * Moves the overlay onto another host (e.g. the canvas being opened).
+     *
+     * @param host - New parent element for the overlay.
+     */
+    setHost(host: HTMLElement): void;
     /**
      * When true, uses a lighter overlay so progressive geometry is visible
      * under the spinner during open.
@@ -39,6 +47,12 @@ export declare class AcApOpenFileProgressController {
      * Used to keep the overlay until progressive scene convert finishes.
      */
     setSceneBusyGate(gate: (() => boolean) | undefined): void;
+    /**
+     * Called after the overlay is hidden (open finished or cancelled).
+     *
+     * @param callback - Handler, or `undefined` to clear.
+     */
+    setOnHidden(callback: (() => void) | undefined): void;
     /**
      * Resets tracked progress for a new open operation.
      */

package/lib/app/AcApOpenFileProgressController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApOpenFileProgressController.d.ts","sourceRoot":"","sources":["../../src/app/AcApOpenFileProgressController.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACvB,MAAM,uBAAuB,CAAA;AAO9B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,MAAM,CAAC,CAAiC;IAChD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,OAAO,CAAC,WAAW,CAAC,CAA+B;IAEnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IAEhE;;OAEG;gBACS,IAAI,EAAE,WAAW;IAQ7B;;;OAGG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAS5C;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI;IAIzD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5E;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,sBAAsB,GAAG,sBAAsB;IAO5D;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;CAMtB"}
+{"version":3,"file":"AcApOpenFileProgressController.d.ts","sourceRoot":"","sources":["../../src/app/AcApOpenFileProgressController.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,sBAAsB,EACvB,MAAM,uBAAuB,CAAA;AAO9B;;;;;;;;;;;;;;GAcG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,MAAM,CAAC,CAAiC;IAChD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAe;IACtC,oDAAoD;IACpD,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,WAAW,CAAC,CAA+B;IAEnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAqB;IAC5D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IAEhE;;OAEG;gBACS,IAAI,EAAE,WAAW;IAQ7B;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAIhC;;;OAGG;IACH,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAS5C;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI;IAIzD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI;IAIrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5E;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,sBAAsB,GAAG,sBAAsB;IAO5D;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,aAAa;IA6BrB,OAAO,CAAC,kBAAkB;IA6B1B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;CAMtB"}

package/lib/app/AcApOpenFileProgressController.js

@@ -80,6 +80,14 @@ var AcApOpenFileProgressController = /** @class */ (function () {
         });
         this._progress.hide();
     }
+    /**
+     * Moves the overlay onto another host (e.g. the canvas being opened).
+     *
+     * @param host - New parent element for the overlay.
+     */
+    AcApOpenFileProgressController.prototype.setHost = function (host) {
+        this._progress.setHost(host);
+    };
     /**
      * When true, uses a lighter overlay so progressive geometry is visible
      * under the spinner during open.
@@ -97,6 +105,14 @@ var AcApOpenFileProgressController = /** @class */ (function () {
     AcApOpenFileProgressController.prototype.setSceneBusyGate = function (gate) {
         this._sceneBusyGate = gate;
     };
+    /**
+     * Called after the overlay is hidden (open finished or cancelled).
+     *
+     * @param callback - Handler, or `undefined` to clear.
+     */
+    AcApOpenFileProgressController.prototype.setOnHidden = function (callback) {
+        this._onHidden = callback;
+    };
     /**
      * Resets tracked progress for a new open operation.
      */
@@ -224,9 +240,11 @@ var AcApOpenFileProgressController = /** @class */ (function () {
         this._holdPollId = setTimeout(poll, 50);
     };
     AcApOpenFileProgressController.prototype.hideAndReset = function () {
+        var _a;
         this.clearHoldPoll();
         this._progress.hide();
         this.reset();
+        (_a = this._onHidden) === null || _a === void 0 ? void 0 : _a.call(this);
     };
     AcApOpenFileProgressController.prototype.clearHoldPoll = function () {
         if (this._holdPollId != null) {

package/lib/app/AcApOpenFileProgressController.js.map

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

package/lib/app/AcApProgress.d.ts

@@ -133,6 +133,12 @@ export declare class AcApProgress {
      * @param color - CSS color for the dimming layer
      */
     setOverlayColor(color: string): this;
+    /**
+     * Moves the overlay onto another host (e.g. the focused split pane).
+     *
+     * @param host - New parent element for the overlay.
+     */
+    setHost(host: HTMLElement): this;
     /**
      * Completely removes the component from the DOM.
      * Safe to call multiple times.

package/lib/app/AcApProgress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApProgress.d.ts","sourceRoot":"","sources":["../../src/app/AcApProgress.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,gBAAuB,OAAO,EAAE,MAAM,CAAyB;IAE/D;;OAEG;IACH,OAAc,cAAc,UAAQ;IAEpC;;OAEG;IACI,IAAI,EAAG,cAAc,CAAA;IAE5B;;OAEG;IACI,OAAO,EAAG,cAAc,CAAA;IAE/B;;OAEG;IACI,SAAS,EAAG,cAAc,CAAA;IAEjC;;OAEG;IACH,SAAgB,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAEtD;;;;OAIG;gBACS,OAAO,GAAE,mBAAwB;IAqB7C;;;;;OAKG;IACI,IAAI,IAAI,IAAI;IAKnB;;;;OAIG;IACI,IAAI,IAAI,IAAI;IAKnB;;;;;;;OAOG;IACI,UAAU,CAAC,IAAI,SAAK,GAAG,IAAI;IAMlC;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO3C;;;OAGG;IACI,OAAO,IAAI,IAAI;IAMtB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAqEjB;;;OAGG;IACH,OAAO,CAAC,YAAY;CA4ErB"}
+{"version":3,"file":"AcApProgress.d.ts","sourceRoot":"","sources":["../../src/app/AcApProgress.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAElB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACH,gBAAuB,OAAO,EAAE,MAAM,CAAyB;IAE/D;;OAEG;IACH,OAAc,cAAc,UAAQ;IAEpC;;OAEG;IACI,IAAI,EAAG,cAAc,CAAA;IAE5B;;OAEG;IACI,OAAO,EAAG,cAAc,CAAA;IAE/B;;OAEG;IACI,SAAS,EAAG,cAAc,CAAA;IAEjC;;OAEG;IACH,SAAgB,OAAO,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAA;IAEtD;;;;OAIG;gBACS,OAAO,GAAE,mBAAwB;IAqB7C;;;;;OAKG;IACI,IAAI,IAAI,IAAI;IAKnB;;;;OAIG;IACI,IAAI,IAAI,IAAI;IAKnB;;;;;;;OAOG;IACI,UAAU,CAAC,IAAI,SAAK,GAAG,IAAI;IAMlC;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAO3C;;;;OAIG;IACI,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAavC;;;OAGG;IACI,OAAO,IAAI,IAAI;IAMtB;;;OAGG;IACH,OAAO,CAAC,SAAS;IAqEjB;;;OAGG;IACH,OAAO,CAAC,YAAY;CA4ErB"}

package/lib/app/AcApProgress.js

@@ -92,6 +92,23 @@ var AcApProgress = /** @class */ (function () {
         }
         return this;
     };
+    /**
+     * Moves the overlay onto another host (e.g. the focused split pane).
+     *
+     * @param host - New parent element for the overlay.
+     */
+    AcApProgress.prototype.setHost = function (host) {
+        if (this.options.host === host) {
+            return this;
+        }
+        this.options.host = host;
+        var hostPosition = getComputedStyle(host).position;
+        if (hostPosition === 'static') {
+            host.style.position = 'relative';
+        }
+        host.appendChild(this.root);
+        return this;
+    };
     /**
      * Completely removes the component from the DOM.
      * Safe to call multiple times.

package/lib/app/AcApProgress.js.map

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

package/lib/app/AcApSettingManager.d.ts

@@ -29,30 +29,69 @@ export interface AcApSettings {
     isShowCoordinate: boolean;
     /** Whether entity info card is visible */
     isShowEntityInfo: boolean;
-    /** Whether file name is visible */
-    isShowFileName: boolean;
     /** Whether language selector is visible */
     isShowLanguageSelector: boolean;
     /** Whether the command ribbon is visible */
     isShowRibbon: boolean;
     /** Whether the toolbar is visible */
     isShowToolbar: boolean;
+    /** Whether the floating shortcut toolbar (undo/redo/erase) is visible */
+    isShowShortCutToolbar: boolean;
     /** Whether performance statistics are displayed */
     isShowStats: boolean;
     /** Font mapping configuration for text rendering */
     fontMapping: AcApFontMapping;
     /** Object snap modes */
     osnapModes: number;
+    /** When true, never show the mobile precise point-pick tutorial again. */
+    hideTouchPointTutorial: boolean;
+    /**
+     * ISO date (`YYYY-MM-DD`) for which the tutorial is snoozed via
+     * "don't remind me today". Cleared automatically when the date passes.
+     */
+    touchPointTutorialSnoozeDate: string | null;
+    /**
+     * When true (default), touch long-press point picks use a simulated mouse
+     * crosshair above the finger so the fingertip does not obscure the sample.
+     * When false, the pick sample is the finger contact. In both modes a long
+     * press still shows the magnifier loupe around the active sample.
+     */
+    useSimulatedMouseOnTouch: boolean;
 }
 /**
- * Maps the pre-ribbon `isShowMainMenu` key onto `isShowRibbon`.
+ * Options for {@link AcApSettingManager.set} and {@link AcApSettingManager.apply}.
+ */
+export interface AcApSettingWriteOptions {
+    /**
+     * When `true` (default), the change is stored as a user preference and
+     * written to localStorage. When `false`, the change is a session-only
+     * override that does not touch localStorage (use for host layout / scene
+     * defaults such as hiding the command line on mobile).
+     */
+    persist?: boolean;
+}
+/**
+ * Options for {@link AcApSettingManager.configure}.
+ */
+export interface AcApSettingManagerConfigureOptions {
+    /**
+     * localStorage key used for user preferences. Defaults to `'settings'`.
+     * Call before the first settings read/write so products on the same origin
+     * do not share preferences.
+     */
+    storageKey?: string;
+}
+/**
+ * Maps the pre-ribbon `isShowMainMenu` key onto `isShowRibbon`, and drops
+ * obsolete keys such as `isShowFileName` (filename is always shown on the
+ * ribbon header now).
  *
  * Older builds persisted `isShowMainMenu`. After the main menu was replaced
  * by the command ribbon, that preference should keep hiding (or showing)
  * the ribbon for the same users.
  *
  * @param stored - Parsed localStorage object; not mutated.
- * @returns A copy with `isShowRibbon` filled in and `isShowMainMenu` removed.
+ * @returns A copy with `isShowRibbon` filled in and obsolete keys removed.
  */
 export declare function migrateStoredSettings(stored: Record<string, unknown>): {
     settings: Record<string, unknown>;
@@ -72,44 +111,58 @@ export interface AcApSettingManagerEventArgs<T extends AcApSettings = AcApSettin
 /**
  * Singleton settings manager for the CAD application.
  *
- * This class manages application-wide settings with:
- * - Persistent storage using localStorage
- * - Event notification when settings change
- * - Type-safe setting access
- * - Default value fallbacks
+ * Settings resolve in three layers (later wins):
+ * 1. Built-in defaults
+ * 2. User preferences from localStorage
+ * 3. Session overrides (host layout; not persisted)
  *
- * The settings are automatically saved to localStorage and restored on application start.
+ * Only the user layer is written to localStorage. Use
+ * `{ persist: false }` for scene-specific layout so it does not leak into
+ * other products or later visits on the same origin.
  *
  * @template T - The settings interface type, defaults to AcApSettings
  *
  * @example
  * ```typescript
- * // Get the singleton instance
- * const settings = AcApSettingManager.instance;
- *
- * // Set a setting value
- * settings.set('isShowToolbar', false);
+ * // Isolate this product's preferences on a shared origin
+ * AcApSettingManager.configure({
+ *   storageKey: 'mlightcad.settings.mobile-embed'
+ * })
  *
- * // Get a setting value
- * const showToolbar = settings.get('isShowToolbar');
+ * // Host layout: hide command line for this session only
+ * AcApSettingManager.instance.apply(
+ *   { isShowCommandLine: false },
+ *   { persist: false }
+ * )
  *
- * // Toggle a boolean setting
- * settings.toggle('isDebug');
- *
- * // Listen for setting changes
- * settings.events.modified.addEventListener(args => {
- *   console.log(`Setting ${args.key} changed to:`, args.value);
- * });
+ * // User preference: persists across visits
+ * AcApSettingManager.instance.set('isShowToolbar', false)
  * ```
  */
 export declare class AcApSettingManager<T extends AcApSettings = AcApSettings> {
     /** Singleton instance */
     private static _instance?;
+    /** localStorage key for the user preference layer */
+    private static _storageKey;
     /** Events fired when settings are modified */
     readonly events: {
         /** Fired when any setting is modified */
         modified: AcCmEventManager<AcApSettingManagerEventArgs<T>>;
     };
+    /** User preferences loaded from / written to localStorage */
+    private _user;
+    /** Session-only overrides (host layout); never written to localStorage */
+    private _session;
+    /**
+     * Configures the settings manager before the first read/write.
+     *
+     * Prefer calling this at host startup so each product on the same origin
+     * can use its own localStorage key. If an instance already exists, user
+     * prefs are reloaded from the new key and session overrides are cleared.
+     *
+     * @param options - Configuration options
+     */
+    static configure(options: AcApSettingManagerConfigureOptions): void;
     /**
      * Gets the singleton instance of the settings manager.
      *
@@ -119,25 +172,84 @@ export declare class AcApSettingManager<T extends AcApSettings = AcApSettings> {
      */
     static get instance(): AcApSettingManager<AcApSettings>;
     /**
-     * Sets a setting value and persists it to localStorage.
+     * Resets singleton state for unit tests.
+     *
+     * @internal
+     */
+    static resetInstanceForTesting(): void;
+    private constructor();
+    /**
+     * Reloads the user preference layer from localStorage and clears session
+     * overrides.
+     */
+    private reloadFromStorage;
+    /**
+     * Reads and migrates user preferences from the configured storage key.
+     *
+     * @returns Partial user settings (may be empty)
+     */
+    private readUserFromStorage;
+    /**
+     * Writes only the user preference layer to localStorage.
+     */
+    private persistUser;
+    /**
+     * Merges defaults, user prefs, and session overrides into effective settings.
+     *
+     * @returns A new effective settings object
+     */
+    private computeEffective;
+    /**
+     * Sets a setting value.
      *
-     * Fires a modified event after the setting is saved.
+     * By default the change is persisted as a user preference. Pass
+     * `{ persist: false }` for a session-only override that does not touch
+     * localStorage.
+     *
+     * Fires a modified event after the setting is updated.
      *
      * @template K - The setting key type
      * @param key - The setting key to modify
      * @param value - The new value for the setting
+     * @param options - Optional write options (`persist` defaults to `true`)
      *
      * @example
      * ```typescript
      * settings.set('isShowToolbar', false);
-     * settings.set('fontMapping', { 'Arial': 'Helvetica' });
+     * settings.set('isShowCommandLine', false, { persist: false });
      * ```
      */
-    set<K extends keyof T>(key: K, value: T[K]): void;
+    set<K extends keyof T>(key: K, value: T[K], options?: AcApSettingWriteOptions): void;
+    /**
+     * Applies multiple setting values at once.
+     *
+     * Each changed key fires a separate `modified` event so existing listeners
+     * keep working without a batch API.
+     *
+     * @param partial - Settings to update
+     * @param options - Optional write options (`persist` defaults to `true`)
+     *
+     * @example
+     * ```typescript
+     * settings.apply(
+     *   { isShowCommandLine: false, isShowCoordinate: false },
+     *   { persist: false }
+     * )
+     * ```
+     */
+    apply(partial: Partial<T>, options?: AcApSettingWriteOptions): void;
+    /**
+     * Removes a session-only override so the effective value falls back to
+     * user preferences / defaults.
+     *
+     * @template K - The setting key type
+     * @param key - The setting key whose session override should be cleared
+     */
+    clearSessionOverride<K extends keyof T>(key: K): void;
     /**
      * Gets a setting value.
      *
-     * Returns the stored value or the default value if not set.
+     * Returns the effective value (defaults ← user ← session).
      *
      * @template K - The setting key type
      * @param key - The setting key to retrieve
@@ -154,6 +266,7 @@ export declare class AcApSettingManager<T extends AcApSettings = AcApSettings> {
      * Toggles a boolean setting value.
      *
      * Only works with boolean settings. The caller should ensure the setting is boolean.
+     * The toggle is persisted as a user preference.
      *
      * @template K - The setting key type
      * @param key - The boolean setting key to toggle
@@ -213,18 +326,6 @@ export declare class AcApSettingManager<T extends AcApSettings = AcApSettings> {
      * @param value - True to show entity info card
      */
     set isShowEntityInfo(value: boolean);
-    /**
-     * Gets whether file name is visible.
-     *
-     * @returns True if file name should be displayed
-     */
-    get isShowFileName(): boolean;
-    /**
-     * Sets whether file name is visible.
-     *
-     * @param value - True to show file name
-     */
-    set isShowFileName(value: boolean);
     /**
      * Gets whether language selector is visible.
      *
@@ -261,6 +362,18 @@ export declare class AcApSettingManager<T extends AcApSettings = AcApSettings> {
      * @param value - True to show the toolbar
      */
     set isShowToolbar(value: boolean);
+    /**
+     * Gets whether the floating shortcut toolbar is visible.
+     *
+     * @returns True if the shortcut toolbar should be shown
+     */
+    get isShowShortCutToolbar(): boolean;
+    /**
+     * Sets whether the floating shortcut toolbar is visible.
+     *
+     * @param value - True to show the shortcut toolbar
+     */
+    set isShowShortCutToolbar(value: boolean);
     /**
      * Gets whether performance statistics are displayed.
      *
@@ -305,9 +418,9 @@ export declare class AcApSettingManager<T extends AcApSettings = AcApSettings> {
      */
     set osnapModes(value: number);
     /**
-     * Gets the current settings object.
+     * Gets the current effective settings object.
      *
-     * This method combines localStorage values with default values.
+     * Merges built-in defaults, user preferences, and session overrides.
      *
      * @returns The current settings object
      */

package/lib/app/AcApSettingManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcApSettingManager.d.ts","sourceRoot":"","sources":["../../src/app/AcApSettingManager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAGjB,MAAM,uBAAuB,CAAA;AAG9B;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAA;IAChB,oDAAoD;IACpD,iBAAiB,EAAE,OAAO,CAAA;IAC1B,4CAA4C;IAC5C,gBAAgB,EAAE,OAAO,CAAA;IACzB,0CAA0C;IAC1C,gBAAgB,EAAE,OAAO,CAAA;IACzB,mCAAmC;IACnC,cAAc,EAAE,OAAO,CAAA;IACvB,2CAA2C;IAC3C,sBAAsB,EAAE,OAAO,CAAA;IAC/B,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAA;IACrB,qCAAqC;IACrC,aAAa,EAAE,OAAO,CAAA;IACtB,mDAAmD;IACnD,WAAW,EAAE,OAAO,CAAA;IACpB,oDAAoD;IACpD,WAAW,EAAE,eAAe,CAAA;IAC5B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAA;CACnB;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAY1D;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B,CAC1C,CAAC,SAAS,YAAY,GAAG,YAAY;IAErC,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC,CAAA;IACZ,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY;IACnE,yBAAyB;IACzB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAoB;IAE7C,8CAA8C;IAC9C,SAAgB,MAAM;QACpB,yCAAyC;;MAE1C;IAED;;;;;;OAMG;IACH,MAAM,KAAK,QAAQ,qCAKlB;IAED;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAU1C;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAI7B;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;IAMhC;;;;OAIG;IACH,IAAI,OAAO,IASQ,OAAO,CAPzB;IAED;;;;OAIG;IACH,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAEzB;IAED;;;;OAIG;IACH,IAAI,iBAAiB,IASQ,OAAO,CAPnC;IAED;;;;OAIG;IACH,IAAI,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAEnC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IASQ,OAAO,CAPlC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IASQ,OAAO,CAPlC;IAED;;;;OAIG;IACH,IAAI,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAElC;IAED;;;;OAIG;IACH,IAAI,cAAc,IASQ,OAAO,CAPhC;IAED;;;;OAIG;IACH,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,EAEhC;IAED;;;;OAIG;IACH,IAAI,sBAAsB,IASQ,OAAO,CAPxC;IAED;;;;OAIG;IACH,IAAI,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAExC;IAED;;;;OAIG;IACH,IAAI,YAAY,IASQ,OAAO,CAP9B;IAED;;;;OAIG;IACH,IAAI,YAAY,CAAC,KAAK,EAAE,OAAO,EAE9B;IAED;;;;OAIG;IACH,IAAI,aAAa,IASQ,OAAO,CAP/B;IAED;;;;OAIG;IACH,IAAI,aAAa,CAAC,KAAK,EAAE,OAAO,EAE/B;IAED;;;;OAIG;IACH,IAAI,WAAW,IASQ,OAAO,CAP7B;IAED;;;;OAIG;IACH,IAAI,WAAW,CAAC,KAAK,EAAE,OAAO,EAE7B;IAED;;;;OAIG;IACH,IAAI,WAAW,IASQ,eAAe,CAPrC;IAED;;;;OAIG;IACH,IAAI,WAAW,CAAC,KAAK,EAAE,eAAe,EAErC;IAED;;;;;OAKG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAMvD;;;;OAIG;IACH,IAAI,UAAU,IASQ,MAAM,CAP3B;IAED;;;;OAIG;IACH,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,EAE3B;IAED;;;;;;OAMG;IACH,IAAI,QAAQ,MAaX;CACF"}
+{"version":3,"file":"AcApSettingManager.d.ts","sourceRoot":"","sources":["../../src/app/AcApSettingManager.ts"],"names":[],"mappings":"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"}