@mlightcad/cad-simple-viewer 1.6.3 → 1.7.0

package/lib/editor/command/AcEdSessionAccessory.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Widget mounted while a command is prompting, or while a selection-driven
+ * session UI is active. Desktop layouts show accessories at the top center of
+ * the canvas; phone/pad layouts show them at the top of the bottom session panel.
+ *
+ * Kept as a types-only module so the command layer does not import chrome DOM.
+ */
+import type { AcEdBaseView } from '../view/AcEdBaseView';
+import type { AcEdCommand } from './AcEdCommand';
+/** Desktop top-center slot vs mobile session panel. */
+export type AcEdSessionAccessorySlot = 'desktop' | 'mobile';
+/** Arguments passed to {@link AcEdSessionAccessory.mount}. */
+export interface AcEdSessionAccessoryOptions {
+    /** Mount row for the accessory controls. */
+    host: HTMLElement;
+    /** Which chrome slot owns {@link host}. */
+    type: AcEdSessionAccessorySlot;
+    /** View that owns the chrome / session accessory host. */
+    view: AcEdBaseView;
+}
+/**
+ * Mount target resolved by the view for the current layout / mobile prompt state.
+ */
+export interface AcEdSessionAccessoryHostInfo {
+    /** DOM row that receives accessory controls. */
+    host: HTMLElement;
+    /** Which chrome slot owns {@link host}. */
+    type: AcEdSessionAccessorySlot;
+}
+/**
+ * Registry id for the draw-style session provider on a view.
+ *
+ * @see {@link AcEdDrawStyleSessionHost}
+ * @see {@link AcEdSessionProviderRegistry}
+ */
+export declare const ACED_DRAW_STYLE_SESSION_PROVIDER_ID = "draw-style";
+/**
+ * Draw-style controls provider registered under
+ * {@link ACED_DRAW_STYLE_SESSION_PROVIDER_ID}.
+ *
+ * Long-lived owner of color / font-size controls; mints mountable session
+ * accessories via {@link createSessionAccessory}.
+ */
+export interface AcEdDrawStyleSessionHost {
+    /**
+     * Updates the active measure/markup session before controls mount.
+     *
+     * @param kind - `'measure'`, `'markup'`, or `undefined` when inactive.
+     */
+    setActiveKind(kind: 'measure' | 'markup' | undefined): void;
+    /** Builds the session accessory that reparents draw-style controls. */
+    createSessionAccessory(): AcEdSessionAccessory;
+}
+/**
+ * Session UI widget with a stable id and mount/unmount lifecycle.
+ */
+export interface AcEdSessionAccessory {
+    /** Stable id so a re-show can replace rather than stack. */
+    id: string;
+    /**
+     * Called when the accessory slot is shown.
+     *
+     * @param options - Host element, slot type, and owning view.
+     */
+    mount(options: AcEdSessionAccessoryOptions): void;
+    /** Called on hide or when a different accessory replaces this one. */
+    unmount(): void;
+}
+/**
+ * Payload for session-accessory mount / unmount editor events.
+ */
+export interface AcEdSessionAccessoryEventArgs {
+    /** Command that owns the accessory, or `null` for selection-driven mounts. */
+    command: AcEdCommand | null;
+    /** Accessory being mounted or unmounted. */
+    accessory: AcEdSessionAccessory;
+    /** Mount options; present on mount events and usually on unmount. */
+    options?: AcEdSessionAccessoryOptions;
+    /** Whether this lifecycle is driven by a command or by selection. */
+    source: 'command' | 'selection';
+}
+//# sourceMappingURL=AcEdSessionAccessory.d.ts.map

package/lib/editor/command/AcEdSessionAccessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSessionAccessory.d.ts","sourceRoot":"","sources":["../../../src/editor/command/AcEdSessionAccessory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,uDAAuD;AACvD,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE3D,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,4CAA4C;IAC5C,IAAI,EAAE,WAAW,CAAA;IACjB,2CAA2C;IAC3C,IAAI,EAAE,wBAAwB,CAAA;IAC9B,0DAA0D;IAC1D,IAAI,EAAE,YAAY,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,gDAAgD;IAChD,IAAI,EAAE,WAAW,CAAA;IACjB,2CAA2C;IAC3C,IAAI,EAAE,wBAAwB,CAAA;CAC/B;AAED;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC,eAAe,CAAA;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAA;IAC3D,uEAAuE;IACvE,sBAAsB,IAAI,oBAAoB,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAA;IACjD,sEAAsE;IACtE,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,8EAA8E;IAC9E,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,4CAA4C;IAC5C,SAAS,EAAE,oBAAoB,CAAA;IAC/B,qEAAqE;IACrE,OAAO,CAAC,EAAE,2BAA2B,CAAA;IACrC,qEAAqE;IACrE,MAAM,EAAE,SAAS,GAAG,WAAW,CAAA;CAChC"}

package/lib/editor/command/AcEdSessionAccessory.js

@@ -0,0 +1,15 @@
+/**
+ * Widget mounted while a command is prompting, or while a selection-driven
+ * session UI is active. Desktop layouts show accessories at the top center of
+ * the canvas; phone/pad layouts show them at the top of the bottom session panel.
+ *
+ * Kept as a types-only module so the command layer does not import chrome DOM.
+ */
+/**
+ * Registry id for the draw-style session provider on a view.
+ *
+ * @see {@link AcEdDrawStyleSessionHost}
+ * @see {@link AcEdSessionProviderRegistry}
+ */
+export var ACED_DRAW_STYLE_SESSION_PROVIDER_ID = 'draw-style';
+//# sourceMappingURL=AcEdSessionAccessory.js.map

package/lib/editor/command/AcEdSessionAccessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSessionAccessory.js","sourceRoot":"","sources":["../../../src/editor/command/AcEdSessionAccessory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4BH;;;;;GAKG;AACH,MAAM,CAAC,IAAM,mCAAmC,GAAG,YAAY,CAAA"}

package/lib/editor/command/AcEdSessionProviderRegistry.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Per-view registry of long-lived session UI providers.
+ *
+ * A provider is not a mounted {@link AcEdSessionAccessory}; it is the object
+ * that owns controls and can mint accessories (for example draw-style color /
+ * font-size UI). Multiple features register under stable string ids.
+ */
+/**
+ * Map of session provider id → provider instance for one view.
+ */
+export declare class AcEdSessionProviderRegistry {
+    /** Installed providers keyed by stable id. */
+    private readonly providers;
+    /**
+     * Registers or replaces a provider.
+     *
+     * @param id - Stable provider id (e.g. {@link ACED_DRAW_STYLE_SESSION_PROVIDER_ID}).
+     * @param provider - Provider instance.
+     */
+    set(id: string, provider: unknown): void;
+    /**
+     * Returns the provider for {@link id}, if registered.
+     *
+     * @param id - Stable provider id.
+     * @returns The provider cast to {@link T}, or `undefined`.
+     */
+    get<T>(id: string): T | undefined;
+    /**
+     * Whether a provider is registered under {@link id}.
+     *
+     * @param id - Stable provider id.
+     */
+    has(id: string): boolean;
+    /**
+     * Removes the provider registered under {@link id}.
+     *
+     * @param id - Stable provider id.
+     * @returns `true` when an entry was removed.
+     */
+    delete(id: string): boolean;
+}
+//# sourceMappingURL=AcEdSessionProviderRegistry.d.ts.map

package/lib/editor/command/AcEdSessionProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSessionProviderRegistry.d.ts","sourceRoot":"","sources":["../../../src/editor/command/AcEdSessionProviderRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,qBAAa,2BAA2B;IACtC,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIxC;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIjC;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAG5B"}

package/lib/editor/command/AcEdSessionProviderRegistry.js

@@ -0,0 +1,54 @@
+/**
+ * Per-view registry of long-lived session UI providers.
+ *
+ * A provider is not a mounted {@link AcEdSessionAccessory}; it is the object
+ * that owns controls and can mint accessories (for example draw-style color /
+ * font-size UI). Multiple features register under stable string ids.
+ */
+/**
+ * Map of session provider id → provider instance for one view.
+ */
+var AcEdSessionProviderRegistry = /** @class */ (function () {
+    function AcEdSessionProviderRegistry() {
+        /** Installed providers keyed by stable id. */
+        this.providers = new Map();
+    }
+    /**
+     * Registers or replaces a provider.
+     *
+     * @param id - Stable provider id (e.g. {@link ACED_DRAW_STYLE_SESSION_PROVIDER_ID}).
+     * @param provider - Provider instance.
+     */
+    AcEdSessionProviderRegistry.prototype.set = function (id, provider) {
+        this.providers.set(id, provider);
+    };
+    /**
+     * Returns the provider for {@link id}, if registered.
+     *
+     * @param id - Stable provider id.
+     * @returns The provider cast to {@link T}, or `undefined`.
+     */
+    AcEdSessionProviderRegistry.prototype.get = function (id) {
+        return this.providers.get(id);
+    };
+    /**
+     * Whether a provider is registered under {@link id}.
+     *
+     * @param id - Stable provider id.
+     */
+    AcEdSessionProviderRegistry.prototype.has = function (id) {
+        return this.providers.has(id);
+    };
+    /**
+     * Removes the provider registered under {@link id}.
+     *
+     * @param id - Stable provider id.
+     * @returns `true` when an entry was removed.
+     */
+    AcEdSessionProviderRegistry.prototype.delete = function (id) {
+        return this.providers.delete(id);
+    };
+    return AcEdSessionProviderRegistry;
+}());
+export { AcEdSessionProviderRegistry };
+//# sourceMappingURL=AcEdSessionProviderRegistry.js.map

package/lib/editor/command/AcEdSessionProviderRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcEdSessionProviderRegistry.js","sourceRoot":"","sources":["../../../src/editor/command/AcEdSessionProviderRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH;IAAA;QACE,8CAA8C;QAC7B,cAAS,GAAG,IAAI,GAAG,EAAmB,CAAA;IAwCzD,CAAC;IAtCC;;;;;OAKG;IACH,yCAAG,GAAH,UAAI,EAAU,EAAE,QAAiB;QAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAClC,CAAC;IAED;;;;;OAKG;IACH,yCAAG,GAAH,UAAO,EAAU;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAkB,CAAA;IAChD,CAAC;IAED;;;;OAIG;IACH,yCAAG,GAAH,UAAI,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;OAKG;IACH,4CAAM,GAAN,UAAO,EAAU;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAClC,CAAC;IACH,kCAAC;AAAD,CAAC,AA1CD,IA0CC"}

package/lib/editor/command/index.d.ts

@@ -1,3 +1,7 @@
 export * from './AcEdCommand';
 export * from './AcEdCommandStack';
+export type { AcEdDrawStyleSessionHost, AcEdSessionAccessory, AcEdSessionAccessoryEventArgs, AcEdSessionAccessoryHostInfo, AcEdSessionAccessoryOptions, AcEdSessionAccessorySlot } from './AcEdSessionAccessory';
+export { ACED_DRAW_STYLE_SESSION_PROVIDER_ID } from './AcEdSessionAccessory';
+export { AcEdSessionProviderRegistry } from './AcEdSessionProviderRegistry';
+export { AcEdSessionAccessoryMountSkippedError } from './AcEdCommand';
 //# sourceMappingURL=index.d.ts.map

package/lib/editor/command/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/command/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/command/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,6BAA6B,EAC7B,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACzB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,EAAE,qCAAqC,EAAE,MAAM,eAAe,CAAA"}

package/lib/editor/command/index.js

@@ -1,3 +1,6 @@
 export * from './AcEdCommand';
 export * from './AcEdCommandStack';
+export { ACED_DRAW_STYLE_SESSION_PROVIDER_ID } from './AcEdSessionAccessory';
+export { AcEdSessionProviderRegistry } from './AcEdSessionProviderRegistry';
+export { AcEdSessionAccessoryMountSkippedError } from './AcEdCommand';
 //# sourceMappingURL=index.js.map

package/lib/editor/command/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/command/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/editor/command/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AASlC,OAAO,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,EAAE,qCAAqC,EAAE,MAAM,eAAe,CAAA"}

package/lib/editor/global/AcEdUiColor.d.ts

@@ -160,6 +160,16 @@ export declare function readLayoutBackgroundColor(database: AcDbDatabase, isMode
  * @see {@link AcApSwitchBgCmd}
  */
 export declare function toggleBlackWhiteBackgroundColor(color: AcCmColor): AcCmColor;
+/**
+ * Builds an {@link AcCmColor} for a packed 24-bit RGB layout background.
+ *
+ * Used when open options or hosts set `MODELBKCOLOR` / `PAPERBKCOLOR` from a
+ * numeric clear colour (e.g. `0xffffff`).
+ *
+ * @param rgb - Packed `0xRRGGBB` colour; only the low 24 bits are used.
+ * @returns `AcCmColor` with `ByColor` method and the given RGB.
+ */
+export declare function layoutBackgroundColorFromRgb(rgb: number): AcCmColor;
 /**
  * Chooses a CSS cursor colour that contrasts with the canvas background.
  *

package/lib/editor/global/AcEdUiColor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdUiColor.d.ts","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiColor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,gCAAgC,EAChC,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,SAAS,EAET,YAAY,EAOb,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAE3E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAIpE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAIpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,YAAY,EAAE,OAAO,GACpB,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,OAAO,GACpB,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAS3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,GACtB,OAAO,GAAG,OAAO,CAEnB"}
+{"version":3,"file":"AcEdUiColor.d.ts","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiColor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,gCAAgC,EAChC,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,SAAS,EAET,YAAY,EAOb,MAAM,uBAAuB,CAAA;AAE9B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAE3E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CASzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAIpE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAIpE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,YAAY,EAAE,OAAO,GACpB,MAAM,CAQR;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,OAAO,GACpB,MAAM,CAOR;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAS3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAInE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,eAAe,EAAE,MAAM,GACtB,OAAO,GAAG,OAAO,CAEnB"}

package/lib/editor/global/AcEdUiColor.js

@@ -200,6 +200,20 @@ export function toggleBlackWhiteBackgroundColor(color) {
     }
     return next;
 }
+/**
+ * Builds an {@link AcCmColor} for a packed 24-bit RGB layout background.
+ *
+ * Used when open options or hosts set `MODELBKCOLOR` / `PAPERBKCOLOR` from a
+ * numeric clear colour (e.g. `0xffffff`).
+ *
+ * @param rgb - Packed `0xRRGGBB` colour; only the low 24 bits are used.
+ * @returns `AcCmColor` with `ByColor` method and the given RGB.
+ */
+export function layoutBackgroundColorFromRgb(rgb) {
+    var color = new AcCmColor(AcCmColorMethod.ByColor);
+    color.setRGBValue(rgb & 0xffffff);
+    return color;
+}
 /**
  * Chooses a CSS cursor colour that contrasts with the canvas background.
  *

package/lib/editor/global/AcEdUiColor.js.map

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

package/lib/editor/global/AcEdUiLayout.d.ts

@@ -1,7 +1,57 @@
+/**
+ * Viewport-based UI layout detection for responsive viewer chrome.
+ *
+ * Breakpoints: phone ≤ {@link ML_UI_MOBILE_MAX_WIDTH}px, pad up to
+ * {@link ML_UI_COMPACT_MAX_WIDTH}px, desktop above compact max.
+ */
 /** Max viewport width (px) treated as mobile/narrow UI layout (phones). */
 export declare const ML_UI_MOBILE_MAX_WIDTH = 600;
 /** Media query matching {@link ML_UI_MOBILE_MAX_WIDTH}. */
 export declare const ML_UI_MOBILE_MEDIA_QUERY = "(max-width: 600px)";
+/**
+ * Width (px) of the bottom command/session panel on pad layouts.
+ * Phone uses full viewport width (`left: 0; right: 0`).
+ *
+ * Keep in sync with `.ml-mobile-cmd-panel` in {@link AcUiMobileSessionPanel}.
+ */
+export declare const ML_UI_SESSION_PANEL_WIDTH = 440;
+/**
+ * Horizontal inset (px) so the pad session panel does not touch the
+ * viewport edges (`max-width: calc(100vw - inset)`).
+ */
+export declare const ML_UI_SESSION_PANEL_INSET = 24;
+/** CSS `max-width` for the pad session panel and layout-width dialogs. */
+export declare const ML_UI_SESSION_PANEL_MAX_WIDTH = "calc(100vw - 24px)";
+/**
+ * Z-index for screen-space stroke canvases (measure / markup lines, arcs,
+ * fills). Kept below capsule labels; see {@link ML_UI_Z_CANVAS_HTML_OVERLAY}.
+ *
+ * Must match `.ml-html-canvas` in `@mlightcad/three-renderer`.
+ */
+export declare const ML_UI_Z_CANVAS_HTML_STROKE = 1;
+/**
+ * Z-index for world-anchored HTML labels (CSS2D measure / markup capsules).
+ *
+ * Above stroke canvases ({@link ML_UI_Z_CANVAS_HTML_STROKE}); below command
+ * line, mobile chrome, draw-style toolbar, and modal dialogs.
+ */
+export declare const ML_UI_Z_CANVAS_HTML_OVERLAY = 2;
+/**
+ * Z-index for the desktop draw-style toolbar overlay.
+ *
+ * Above mobile command chrome (`40`); below modal dialogs (`10050`).
+ */
+export declare const ML_UI_Z_DRAW_STYLE_TOOLBAR = 45;
+/**
+ * Z-index for the floating shortcut toolbar (undo/redo/erase + selection extensions).
+ *
+ * Above draw-style session chrome; below modal dialogs.
+ */
+export declare const ML_UI_Z_SHORTCUT_TOOLBAR = 46;
+/**
+ * Z-index for the mobile entity-pick cancel button (below message / status bar).
+ */
+export declare const ML_UI_Z_ENTITY_PICK_CANCEL = 47;
 /** Whether the current viewport matches the narrow mobile UI layout. */
 export declare function acedIsMobileUiLayout(): boolean;
 /** Max viewport width (px) for compact app-shell layout (e.g. collapsible sidebars). */
@@ -10,4 +60,56 @@ export declare const ML_UI_COMPACT_MAX_WIDTH = 960;
 export declare const ML_UI_COMPACT_MEDIA_QUERY = "(max-width: 960px)";
 /** Whether the current viewport matches the compact app-shell layout. */
 export declare function acedIsCompactUiLayout(): boolean;
+/**
+ * Media query matching a coarse *primary* pointer (typical phones and pads).
+ *
+ * Uses `pointer`, not `any-pointer`, so a mouse-first laptop with a touch
+ * screen (`pointer: fine` + `any-pointer: coarse`) stays desktop.
+ */
+export declare const ML_UI_COARSE_POINTER_MEDIA_QUERY = "(pointer: coarse)";
+/**
+ * Whether the browser looks like a phone or pad, independent of viewport width.
+ *
+ * Covers landscape / wide tablets that exceed {@link ML_UI_COMPACT_MAX_WIDTH},
+ * including iPadOS which reports as Macintosh with a touch screen.
+ * Coarse-pointer detection uses the primary pointer only; see
+ * {@link ML_UI_COARSE_POINTER_MEDIA_QUERY}.
+ */
+export declare function acedIsHandheldDevice(): boolean;
+/**
+ * Coarse UI layout kind derived from viewport width.
+ *
+ * - `phone`: {@link ML_UI_MOBILE_MAX_WIDTH} and below
+ * - `pad`: between mobile and {@link ML_UI_COMPACT_MAX_WIDTH}
+ * - `desktop`: above compact max width
+ */
+export type AcEdUiLayoutKind = 'phone' | 'pad' | 'desktop';
+/**
+ * Returns the current UI layout kind from viewport width media queries.
+ *
+ * @returns `'phone'`, `'pad'`, or `'desktop'`.
+ */
+export declare function acedGetUiLayout(): AcEdUiLayoutKind;
+/**
+ * Whether the UI should behave as phone or pad: compact viewport, or a
+ * handheld / touch device at any width (including landscape).
+ */
+export declare function acedIsMobileOrPadUi(): boolean;
+/**
+ * Whether the desktop floating command line should be hidden.
+ *
+ * Phone layouts always hide it (commands start from the toolbar). Pad and
+ * other handheld UIs hide it only while an input session is active so the
+ * mobile command chrome can replace Enter/Esc and keyword chips.
+ *
+ * @param sessionActive - True while {@link AcEdInputManager} is acquiring input.
+ */
+export declare function acedShouldHideDesktopCommandLine(sessionActive: boolean): boolean;
+/**
+ * Subscribes to viewport layout-kind changes (mobile + compact media queries).
+ *
+ * @param listener - Invoked whenever {@link acedGetUiLayout} would return a new kind.
+ * @returns Unsubscribe function; no-op when `matchMedia` is unavailable.
+ */
+export declare function acedSubscribeUiLayout(listener: (kind: AcEdUiLayoutKind) => void): () => void;
 //# sourceMappingURL=AcEdUiLayout.d.ts.map

package/lib/editor/global/AcEdUiLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdUiLayout.d.ts","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiLayout.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,MAAM,CAAA;AAEzC,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,uBAA6C,CAAA;AAElF,wEAAwE;AACxE,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,uBAA8C,CAAA;AAEpF,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C"}
+{"version":3,"file":"AcEdUiLayout.d.ts","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiLayout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,MAAM,CAAA;AACzC,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,uBAA6C,CAAA;AAElF;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAE5C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAE3C,0EAA0E;AAC1E,eAAO,MAAM,6BAA6B,uBAAiD,CAAA;AAE3F;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,KAAK,CAAA;AAE1C;;GAEG;AACH,eAAO,MAAM,0BAA0B,KAAK,CAAA;AAE5C,wEAAwE;AACxE,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wFAAwF;AACxF,eAAO,MAAM,uBAAuB,MAAM,CAAA;AAE1C,8DAA8D;AAC9D,eAAO,MAAM,yBAAyB,uBAA8C,CAAA;AAEpF,yEAAyE;AACzE,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,sBAAsB,CAAA;AAKnE;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C;AAED;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAA;AAE1D;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAIlD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,aAAa,EAAE,OAAO,GACrB,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GACzC,MAAM,IAAI,CAuBZ"}

package/lib/editor/global/AcEdUiLayout.js

@@ -1,7 +1,57 @@
+/**
+ * Viewport-based UI layout detection for responsive viewer chrome.
+ *
+ * Breakpoints: phone ≤ {@link ML_UI_MOBILE_MAX_WIDTH}px, pad up to
+ * {@link ML_UI_COMPACT_MAX_WIDTH}px, desktop above compact max.
+ */
 /** Max viewport width (px) treated as mobile/narrow UI layout (phones). */
 export var ML_UI_MOBILE_MAX_WIDTH = 600;
 /** Media query matching {@link ML_UI_MOBILE_MAX_WIDTH}. */
 export var ML_UI_MOBILE_MEDIA_QUERY = "(max-width: ".concat(ML_UI_MOBILE_MAX_WIDTH, "px)");
+/**
+ * Width (px) of the bottom command/session panel on pad layouts.
+ * Phone uses full viewport width (`left: 0; right: 0`).
+ *
+ * Keep in sync with `.ml-mobile-cmd-panel` in {@link AcUiMobileSessionPanel}.
+ */
+export var ML_UI_SESSION_PANEL_WIDTH = 440;
+/**
+ * Horizontal inset (px) so the pad session panel does not touch the
+ * viewport edges (`max-width: calc(100vw - inset)`).
+ */
+export var ML_UI_SESSION_PANEL_INSET = 24;
+/** CSS `max-width` for the pad session panel and layout-width dialogs. */
+export var ML_UI_SESSION_PANEL_MAX_WIDTH = "calc(100vw - ".concat(ML_UI_SESSION_PANEL_INSET, "px)");
+/**
+ * Z-index for screen-space stroke canvases (measure / markup lines, arcs,
+ * fills). Kept below capsule labels; see {@link ML_UI_Z_CANVAS_HTML_OVERLAY}.
+ *
+ * Must match `.ml-html-canvas` in `@mlightcad/three-renderer`.
+ */
+export var ML_UI_Z_CANVAS_HTML_STROKE = 1;
+/**
+ * Z-index for world-anchored HTML labels (CSS2D measure / markup capsules).
+ *
+ * Above stroke canvases ({@link ML_UI_Z_CANVAS_HTML_STROKE}); below command
+ * line, mobile chrome, draw-style toolbar, and modal dialogs.
+ */
+export var ML_UI_Z_CANVAS_HTML_OVERLAY = 2;
+/**
+ * Z-index for the desktop draw-style toolbar overlay.
+ *
+ * Above mobile command chrome (`40`); below modal dialogs (`10050`).
+ */
+export var ML_UI_Z_DRAW_STYLE_TOOLBAR = 45;
+/**
+ * Z-index for the floating shortcut toolbar (undo/redo/erase + selection extensions).
+ *
+ * Above draw-style session chrome; below modal dialogs.
+ */
+export var ML_UI_Z_SHORTCUT_TOOLBAR = 46;
+/**
+ * Z-index for the mobile entity-pick cancel button (below message / status bar).
+ */
+export var ML_UI_Z_ENTITY_PICK_CANCEL = 47;
 /** Whether the current viewport matches the narrow mobile UI layout. */
 export function acedIsMobileUiLayout() {
     var _a, _b;
@@ -16,4 +66,91 @@ export function acedIsCompactUiLayout() {
     var _a, _b;
     return (_b = (_a = window.matchMedia) === null || _a === void 0 ? void 0 : _a.call(window, ML_UI_COMPACT_MEDIA_QUERY).matches) !== null && _b !== void 0 ? _b : false;
 }
+/**
+ * Media query matching a coarse *primary* pointer (typical phones and pads).
+ *
+ * Uses `pointer`, not `any-pointer`, so a mouse-first laptop with a touch
+ * screen (`pointer: fine` + `any-pointer: coarse`) stays desktop.
+ */
+export var ML_UI_COARSE_POINTER_MEDIA_QUERY = '(pointer: coarse)';
+var MOBILE_OR_PAD_UA = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;
+/**
+ * Whether the browser looks like a phone or pad, independent of viewport width.
+ *
+ * Covers landscape / wide tablets that exceed {@link ML_UI_COMPACT_MAX_WIDTH},
+ * including iPadOS which reports as Macintosh with a touch screen.
+ * Coarse-pointer detection uses the primary pointer only; see
+ * {@link ML_UI_COARSE_POINTER_MEDIA_QUERY}.
+ */
+export function acedIsHandheldDevice() {
+    var _a, _b, _c;
+    if (typeof navigator === 'undefined')
+        return false;
+    var nav = navigator;
+    if (MOBILE_OR_PAD_UA.test(nav.userAgent || ''))
+        return true;
+    if (nav.platform === 'MacIntel' && ((_a = nav.maxTouchPoints) !== null && _a !== void 0 ? _a : 0) > 1)
+        return true;
+    return (_c = (_b = window.matchMedia) === null || _b === void 0 ? void 0 : _b.call(window, ML_UI_COARSE_POINTER_MEDIA_QUERY).matches) !== null && _c !== void 0 ? _c : false;
+}
+/**
+ * Returns the current UI layout kind from viewport width media queries.
+ *
+ * @returns `'phone'`, `'pad'`, or `'desktop'`.
+ */
+export function acedGetUiLayout() {
+    if (acedIsMobileUiLayout())
+        return 'phone';
+    if (acedIsCompactUiLayout())
+        return 'pad';
+    return 'desktop';
+}
+/**
+ * Whether the UI should behave as phone or pad: compact viewport, or a
+ * handheld / touch device at any width (including landscape).
+ */
+export function acedIsMobileOrPadUi() {
+    return acedGetUiLayout() !== 'desktop' || acedIsHandheldDevice();
+}
+/**
+ * Whether the desktop floating command line should be hidden.
+ *
+ * Phone layouts always hide it (commands start from the toolbar). Pad and
+ * other handheld UIs hide it only while an input session is active so the
+ * mobile command chrome can replace Enter/Esc and keyword chips.
+ *
+ * @param sessionActive - True while {@link AcEdInputManager} is acquiring input.
+ */
+export function acedShouldHideDesktopCommandLine(sessionActive) {
+    if (acedIsMobileUiLayout())
+        return true;
+    return sessionActive && acedIsMobileOrPadUi();
+}
+/**
+ * Subscribes to viewport layout-kind changes (mobile + compact media queries).
+ *
+ * @param listener - Invoked whenever {@link acedGetUiLayout} would return a new kind.
+ * @returns Unsubscribe function; no-op when `matchMedia` is unavailable.
+ */
+export function acedSubscribeUiLayout(listener) {
+    if (typeof window.matchMedia !== 'function') {
+        return function () { return undefined; };
+    }
+    var mobileQuery = window.matchMedia(ML_UI_MOBILE_MEDIA_QUERY);
+    var compactQuery = window.matchMedia(ML_UI_COMPACT_MEDIA_QUERY);
+    var current = acedGetUiLayout();
+    var notify = function () {
+        var next = acedGetUiLayout();
+        if (next === current)
+            return;
+        current = next;
+        listener(next);
+    };
+    mobileQuery.addEventListener('change', notify);
+    compactQuery.addEventListener('change', notify);
+    return function () {
+        mobileQuery.removeEventListener('change', notify);
+        compactQuery.removeEventListener('change', notify);
+    };
+}
 //# sourceMappingURL=AcEdUiLayout.js.map

package/lib/editor/global/AcEdUiLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdUiLayout.js","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiLayout.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,IAAM,sBAAsB,GAAG,GAAG,CAAA;AAEzC,2DAA2D;AAC3D,MAAM,CAAC,IAAM,wBAAwB,GAAG,sBAAe,sBAAsB,QAAK,CAAA;AAElF,wEAAwE;AACxE,MAAM,UAAU,oBAAoB;;IAClC,OAAO,MAAA,MAAA,MAAM,CAAC,UAAU,uDAAG,wBAAwB,EAAE,OAAO,mCAAI,KAAK,CAAA;AACvE,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,IAAM,uBAAuB,GAAG,GAAG,CAAA;AAE1C,8DAA8D;AAC9D,MAAM,CAAC,IAAM,yBAAyB,GAAG,sBAAe,uBAAuB,QAAK,CAAA;AAEpF,yEAAyE;AACzE,MAAM,UAAU,qBAAqB;;IACnC,OAAO,MAAA,MAAA,MAAM,CAAC,UAAU,uDAAG,yBAAyB,EAAE,OAAO,mCAAI,KAAK,CAAA;AACxE,CAAC"}
+{"version":3,"file":"AcEdUiLayout.js","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiLayout.ts"],"names":[],"mappings":"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"}

package/lib/editor/global/AcEdUiTheme.d.ts

@@ -1,15 +1,27 @@
 export type AcEdUiTheme = 'light' | 'dark';
+type AcEdUiThemeListener = (theme: AcEdUiTheme) => void;
+/**
+ * Subscribes to UI theme changes triggered by {@link acedApplyUiTheme}
+ * on the document root (or an explicit root target).
+ *
+ * @param listener - Called with the newly applied theme.
+ * @returns Unsubscribe function.
+ */
+export declare function acedSubscribeUiTheme(listener: AcEdUiThemeListener): () => void;
 export declare function acedApplyUiTheme(theme: AcEdUiTheme, target?: HTMLElement): void;
 /**
  * Resolves the active UI theme from a host element or the document.
  *
  * Lookup order:
  * 1. Nearest ancestor with `data-ml-ui-theme`
- * 2. `document.documentElement` attribute
- * 3. `html.dark` class (Element Plus / cad-viewer)
- * 4. Defaults to `'light'`
+ * 2. Nearest ancestor with `ml-theme-dark` / `ml-theme-light` (cad-viewer)
+ * 3. `document.documentElement` `data-ml-ui-theme`
+ * 4. `document.documentElement` `data-mlcad-theme` (offline HTML viewer)
+ * 5. `html.dark` / `html.ml-theme-dark` class (Element Plus / cad-viewer)
+ * 6. Defaults to `'dark'` (matches cad-viewer default)
  *
  * @param from - Optional element to start ancestor walk from
  */
 export declare function resolveUiTheme(from?: HTMLElement | null): AcEdUiTheme;
+export {};
 //# sourceMappingURL=AcEdUiTheme.d.ts.map

package/lib/editor/global/AcEdUiTheme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AcEdUiTheme.d.ts","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiTheme.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;AAuC1C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,MAAM,GAAE,WAAsC,QAO/C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,CAarE"}
+{"version":3,"file":"AcEdUiTheme.d.ts","sourceRoot":"","sources":["../../../src/editor/global/AcEdUiTheme.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,CAAA;AAuC1C,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;AAKvD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,GAC5B,MAAM,IAAI,CAKZ;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,MAAM,GAAE,WAAsC,QA0B/C;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,WAAW,CAoBrE"}