@mlightcad/cad-simple-viewer 1.6.3 → 1.7.1

package/lib/ui/toolbar/toolbarItemUtils.d.ts

@@ -0,0 +1,62 @@
+import type { AcUiToolbarChildrenUi, AcUiToolbarItem, AcUiToolbarItemConfig, AcUiToolbarPresetRef, AcUiToolbarSeparator } from './types';
+/**
+ * Resolves how nested children are presented. Defaults to `'menu'`.
+ *
+ * @param item - Parent toolbar item.
+ */
+export declare function acuiResolveToolbarChildrenUi(item: AcUiToolbarItem): AcUiToolbarChildrenUi;
+/** Returns whether {@link childrenUi} is an icon sub-toolbar (sticky or dismissible). */
+export declare function acuiIsToolbarChildrenStrip(childrenUi: AcUiToolbarChildrenUi): boolean;
+/** Returns whether a toolbar config entry is a visual separator. */
+export declare function acuiIsToolbarSeparatorItem(item: AcUiToolbarItemConfig): item is AcUiToolbarSeparator;
+/** Returns whether a toolbar config entry references a built-in preset button. */
+export declare function acuiIsToolbarPresetRef(item: AcUiToolbarItemConfig): item is AcUiToolbarPresetRef;
+/**
+ * Returns whether {@link children} is supplied by a getter rather than a static array.
+ *
+ * Dynamic children (for example drawing layouts) must not be snapshotted when
+ * cloning or expanding toolbar items.
+ *
+ * @param item - Toolbar item to inspect.
+ */
+export declare function acuiIsDynamicToolbarChildren(item: AcUiToolbarItem): boolean;
+/**
+ * Attaches a getter that rebuilds submenu children each time they are read.
+ *
+ * @param item - Parent toolbar item.
+ * @param getChildren - Factory invoked on each `children` access.
+ * @returns `item` with a live `children` getter.
+ */
+export declare function acuiCopyDynamicToolbarChildren(item: AcUiToolbarItem, getChildren: () => AcUiToolbarItem[]): AcUiToolbarItem;
+/**
+ * Copies a live `children` getter from `source` onto `target` when present.
+ *
+ * @param target - Clone that should keep dynamic children.
+ * @param source - Original item that may define a children getter.
+ * @returns Whether a getter was copied.
+ */
+export declare function acuiPreserveDynamicToolbarChildren(target: AcUiToolbarItem, source: AcUiToolbarItem): boolean;
+/**
+ * Creates a toolbar separator entry.
+ *
+ * @param id - Optional stable id for debugging.
+ */
+export declare function acuiCreateToolbarSeparator(id?: string): AcUiToolbarSeparator;
+/**
+ * References a built-in toolbar button by id when composing a custom layout.
+ *
+ * @param preset - Preset id such as `'pan'` or `'measure'`.
+ */
+export declare function acuiToolbarPreset(preset: string): AcUiToolbarPresetRef;
+/** Returns whether a resolved toolbar item list includes the given button id. */
+export declare function acuiToolbarItemsIncludeItem(items: AcUiToolbarItem[], itemId: string): boolean;
+/** Registers button items (and nested children) in a preset lookup map. */
+export declare function acuiIndexToolbarItems(items: AcUiToolbarItem[], map: Map<string, AcUiToolbarItem>): void;
+/**
+ * Resolves preset references and nested children in a toolbar config list.
+ *
+ * @param items - Raw toolbar configuration entries.
+ * @param presets - Built-in items keyed by id.
+ */
+export declare function acuiExpandToolbarItemConfigs(items: AcUiToolbarItemConfig[], presets: Map<string, AcUiToolbarItem>): AcUiToolbarItem[];
+//# sourceMappingURL=toolbarItemUtils.d.ts.map

package/lib/ui/toolbar/toolbarItemUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbarItemUtils.d.ts","sourceRoot":"","sources":["../../../src/ui/toolbar/toolbarItemUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAEhB;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,eAAe,GACpB,qBAAqB,CAEvB;AAED,yFAAyF;AACzF,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAET;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,qBAAqB,GAC1B,IAAI,IAAI,oBAAoB,CAE9B;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,qBAAqB,GAC1B,IAAI,IAAI,oBAAoB,CAE9B;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAI3E;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,eAAe,EAAE,GACnC,eAAe,CAOjB;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,eAAe,GACtB,OAAO,CAKT;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAEtE;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,eAAe,EAAE,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAQT;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EAAE,EACxB,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAChC,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,qBAAqB,EAAE,EAC9B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GACpC,eAAe,EAAE,CAKnB"}

package/lib/ui/toolbar/toolbarItemUtils.js

@@ -0,0 +1,184 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+/**
+ * Resolves how nested children are presented. Defaults to `'menu'`.
+ *
+ * @param item - Parent toolbar item.
+ */
+export function acuiResolveToolbarChildrenUi(item) {
+    var _a;
+    return (_a = item.childrenUi) !== null && _a !== void 0 ? _a : 'menu';
+}
+/** Returns whether {@link childrenUi} is an icon sub-toolbar (sticky or dismissible). */
+export function acuiIsToolbarChildrenStrip(childrenUi) {
+    return childrenUi === 'toolbar' || childrenUi === 'sticky-toolbar';
+}
+/** Returns whether a toolbar config entry is a visual separator. */
+export function acuiIsToolbarSeparatorItem(item) {
+    return 'type' in item && item.type === 'separator';
+}
+/** Returns whether a toolbar config entry references a built-in preset button. */
+export function acuiIsToolbarPresetRef(item) {
+    return 'preset' in item && typeof item.preset === 'string';
+}
+/**
+ * Returns whether {@link children} is supplied by a getter rather than a static array.
+ *
+ * Dynamic children (for example drawing layouts) must not be snapshotted when
+ * cloning or expanding toolbar items.
+ *
+ * @param item - Toolbar item to inspect.
+ */
+export function acuiIsDynamicToolbarChildren(item) {
+    var _a;
+    return (typeof ((_a = Object.getOwnPropertyDescriptor(item, 'children')) === null || _a === void 0 ? void 0 : _a.get) === 'function');
+}
+/**
+ * Attaches a getter that rebuilds submenu children each time they are read.
+ *
+ * @param item - Parent toolbar item.
+ * @param getChildren - Factory invoked on each `children` access.
+ * @returns `item` with a live `children` getter.
+ */
+export function acuiCopyDynamicToolbarChildren(item, getChildren) {
+    Object.defineProperty(item, 'children', {
+        configurable: true,
+        enumerable: true,
+        get: getChildren
+    });
+    return item;
+}
+/**
+ * Copies a live `children` getter from `source` onto `target` when present.
+ *
+ * @param target - Clone that should keep dynamic children.
+ * @param source - Original item that may define a children getter.
+ * @returns Whether a getter was copied.
+ */
+export function acuiPreserveDynamicToolbarChildren(target, source) {
+    var descriptor = Object.getOwnPropertyDescriptor(source, 'children');
+    if (typeof (descriptor === null || descriptor === void 0 ? void 0 : descriptor.get) !== 'function')
+        return false;
+    acuiCopyDynamicToolbarChildren(target, descriptor.get);
+    return true;
+}
+/**
+ * Creates a toolbar separator entry.
+ *
+ * @param id - Optional stable id for debugging.
+ */
+export function acuiCreateToolbarSeparator(id) {
+    return { type: 'separator', id: id };
+}
+/**
+ * References a built-in toolbar button by id when composing a custom layout.
+ *
+ * @param preset - Preset id such as `'pan'` or `'measure'`.
+ */
+export function acuiToolbarPreset(preset) {
+    return { preset: preset };
+}
+/** Returns whether a resolved toolbar item list includes the given button id. */
+export function acuiToolbarItemsIncludeItem(items, itemId) {
+    return items.some(function (item) {
+        if (acuiIsToolbarSeparatorItem(item))
+            return false;
+        if (item.id === itemId)
+            return true;
+        return item.children
+            ? acuiToolbarItemsIncludeItem(item.children, itemId)
+            : false;
+    });
+}
+/** Registers button items (and nested children) in a preset lookup map. */
+export function acuiIndexToolbarItems(items, map) {
+    var e_1, _a;
+    var _b;
+    try {
+        for (var items_1 = __values(items), items_1_1 = items_1.next(); !items_1_1.done; items_1_1 = items_1.next()) {
+            var item = items_1_1.value;
+            if (acuiIsToolbarSeparatorItem(item))
+                continue;
+            map.set(item.id, item);
+            if (!acuiIsDynamicToolbarChildren(item) && ((_b = item.children) === null || _b === void 0 ? void 0 : _b.length)) {
+                acuiIndexToolbarItems(item.children, map);
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (items_1_1 && !items_1_1.done && (_a = items_1.return)) _a.call(items_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+}
+/**
+ * Resolves preset references and nested children in a toolbar config list.
+ *
+ * @param items - Raw toolbar configuration entries.
+ * @param presets - Built-in items keyed by id.
+ */
+export function acuiExpandToolbarItemConfigs(items, presets) {
+    return items.flatMap(function (item) {
+        var expanded = acuiExpandToolbarItemConfig(item, presets);
+        return expanded ? [expanded] : [];
+    });
+}
+function acuiExpandToolbarItemConfig(item, presets) {
+    var _a, _b;
+    if (acuiIsToolbarSeparatorItem(item)) {
+        return {
+            type: 'separator',
+            id: (_a = item.id) !== null && _a !== void 0 ? _a : "separator-".concat(Math.random().toString(36).slice(2, 9))
+        };
+    }
+    if (acuiIsToolbarPresetRef(item)) {
+        var preset = presets.get(item.preset);
+        if (!preset) {
+            console.warn("[cad-simple-viewer] Unknown toolbar preset \"".concat(item.preset, "\"."));
+            return null;
+        }
+        return acuiCloneToolbarItem(preset);
+    }
+    var buttonItem = item;
+    if (acuiIsDynamicToolbarChildren(buttonItem)) {
+        return acuiCloneToolbarItem(buttonItem);
+    }
+    if ((_b = buttonItem.children) === null || _b === void 0 ? void 0 : _b.length) {
+        return __assign(__assign({}, buttonItem), { children: acuiExpandToolbarItemConfigs(buttonItem.children, presets) });
+    }
+    return buttonItem;
+}
+function acuiCloneToolbarItem(item) {
+    var _a;
+    var clone = __assign(__assign({}, item), { children: item.children });
+    if (acuiPreserveDynamicToolbarChildren(clone, item)) {
+        return clone;
+    }
+    if (!((_a = item.children) === null || _a === void 0 ? void 0 : _a.length)) {
+        return clone;
+    }
+    return __assign(__assign({}, clone), { children: item.children.map(function (child) { return acuiCloneToolbarItem(child); }) });
+}
+//# sourceMappingURL=toolbarItemUtils.js.map

package/lib/ui/toolbar/toolbarItemUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbarItemUtils.js","sourceRoot":"","sources":["../../../src/ui/toolbar/toolbarItemUtils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAQA;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAqB;;IAErB,OAAO,MAAA,IAAI,CAAC,UAAU,mCAAI,MAAM,CAAA;AAClC,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,0BAA0B,CACxC,UAAiC;IAEjC,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,gBAAgB,CAAA;AACpE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CACxC,IAA2B;IAE3B,OAAO,MAAM,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAA;AACpD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,sBAAsB,CACpC,IAA2B;IAE3B,OAAO,QAAQ,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAA;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAqB;;IAChE,OAAO,CACL,OAAO,CAAA,MAAA,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,0CAAE,GAAG,CAAA,KAAK,UAAU,CAC7E,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,8BAA8B,CAC5C,IAAqB,EACrB,WAAoC;IAEpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE;QACtC,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,GAAG,EAAE,WAAW;KACjB,CAAC,CAAA;IACF,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAAuB,EACvB,MAAuB;IAEvB,IAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACtE,IAAI,OAAO,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,GAAG,CAAA,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IACvD,8BAA8B,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAA;IACtD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,EAAW;IACpD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,IAAA,EAAE,CAAA;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,EAAE,MAAM,QAAA,EAAE,CAAA;AACnB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,2BAA2B,CACzC,KAAwB,EACxB,MAAc;IAEd,OAAO,KAAK,CAAC,IAAI,CAAC,UAAA,IAAI;QACpB,IAAI,0BAA0B,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QAClD,IAAI,IAAI,CAAC,EAAE,KAAK,MAAM;YAAE,OAAO,IAAI,CAAA;QACnC,OAAO,IAAI,CAAC,QAAQ;YAClB,CAAC,CAAC,2BAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC;YACpD,CAAC,CAAC,KAAK,CAAA;IACX,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CACnC,KAAwB,EACxB,GAAiC;;;;QAEjC,KAAmB,IAAA,UAAA,SAAA,KAAK,CAAA,4BAAA,+CAAE,CAAC;YAAtB,IAAM,IAAI,kBAAA;YACb,IAAI,0BAA0B,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC9C,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;YACtB,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAI,MAAA,IAAI,CAAC,QAAQ,0CAAE,MAAM,CAAA,EAAE,CAAC;gBACjE,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;YAC3C,CAAC;QACH,CAAC;;;;;;;;;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,KAA8B,EAC9B,OAAqC;IAErC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAA,IAAI;QACvB,IAAM,QAAQ,GAAG,2BAA2B,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC3D,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IACnC,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,IAA2B,EAC3B,OAAqC;;IAErC,IAAI,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,EAAE,EAAE,MAAA,IAAI,CAAC,EAAE,mCAAI,oBAAa,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE;SACrE,CAAA;IACH,CAAC;IAED,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,IAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CACV,uDAA+C,IAAI,CAAC,MAAM,QAAI,CAC/D,CAAA;YACD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,IAAM,UAAU,GAAG,IAAuB,CAAA;IAC1C,IAAI,4BAA4B,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7C,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC;IACD,IAAI,MAAA,UAAU,CAAC,QAAQ,0CAAE,MAAM,EAAE,CAAC;QAChC,6BACK,UAAU,KACb,QAAQ,EAAE,4BAA4B,CACpC,UAAU,CAAC,QAAmC,EAC9C,OAAO,CACR,IACF;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAqB;;IACjD,IAAM,KAAK,yBAAyB,IAAI,KAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,GAAE,CAAA;IACnE,IAAI,kCAAkC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,CAAC,CAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,MAAM,CAAA,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,6BACK,KAAK,KACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAA,KAAK,IAAI,OAAA,oBAAoB,CAAC,KAAK,CAAC,EAA3B,CAA2B,CAAC,IAClE;AACH,CAAC"}

package/lib/ui/toolbar/types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Shared toolbar item and chrome types for {@link AcUiToolbar}.
+ *
+ * @module toolbar/types
+ * @packageDocumentation
+ */
+import type { AcEdOpenMode } from '../../editor/view/AcEdOpenMode';
+/** Toolbar edge placement relative to the viewer host element. */
+export type AcUiToolbarPlacement = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Overflow behavior when toolbar buttons exceed the host bounds.
+ *
+ * - `'menu'`: show a ⋯ button; overflow items open in a dropdown menu.
+ * - `'wrap'`: continue on additional rows (horizontal) or columns (vertical).
+ */
+export type AcUiToolbarOverflow = 'menu' | 'wrap';
+/**
+ * Sizing along the toolbar layout axis: width for horizontal bars, height for vertical bars.
+ *
+ * - `'auto'`: natural size from button content (default).
+ * - `'stretch'`: fill the available host width or height and space buttons evenly.
+ */
+export type AcUiToolbarSize = 'auto' | 'stretch';
+/**
+ * How a sub-toolbar aligns along the parent toolbar's main axis.
+ *
+ * - `'front'`: first sub-toolbar button aligns with the first toolbar button
+ *   (default)
+ * - `'end'`: last sub-toolbar button aligns with the last toolbar button
+ * - `'center'`: centers the sub-toolbar on the parent toolbar
+ * - `'auto'`: align to the parent button
+ *
+ * Ignored when the sub-toolbar {@link AcUiToolbarChromeOptions.size} is
+ * `'stretch'`.
+ */
+export type AcUiSubToolbarPosition = 'front' | 'end' | 'center' | 'auto';
+/**
+ * Shared layout and chrome options for the main toolbar and sub-toolbars.
+ *
+ * Sub-toolbars inherit unset fields from the main toolbar unless overridden via
+ * {@link AcUiToolbarOptions.subToolbar}.
+ */
+export interface AcUiToolbarChromeOptions {
+    /**
+     * Inset from the host edge where the toolbar is anchored in px.
+     * Top/bottom placement uses top or bottom; left/right uses left or right.
+     * @default 8
+     */
+    edgeOffset?: number;
+    /**
+     * Minimum inset from the host edges orthogonal to {@link edgeOffset} in px.
+     *
+     * - Horizontal toolbar (top/bottom): spacing from the top and bottom edges.
+     * - Vertical toolbar (left/right): spacing from the left and right edges.
+     *
+     * Used when the toolbar is at its maximum cross-axis size (for example wrap
+     * overflow) and for cross-axis positioning clamps.
+     * @default 0
+     */
+    sideOffset?: number;
+    /** When true, render button labels below icons on icon toolbars. */
+    showLabels?: boolean;
+    /**
+     * Sizing along the toolbar layout axis: width for horizontal bars, height for
+     * vertical bars.
+     * @default 'auto'
+     */
+    size?: AcUiToolbarSize;
+    /** Overflow behavior when buttons exceed the host bounds. */
+    overflow?: AcUiToolbarOverflow;
+    /**
+     * When false, hides the toolbar container border line.
+     * @default true
+     */
+    showBorder?: boolean;
+    /**
+     * When true, each toolbar button draws a permanent outer border.
+     * When false, buttons stay frameless until hover / active.
+     * @default false
+     */
+    showButtonBorder?: boolean;
+    /**
+     * When false, omits visual separators between toolbar button groups.
+     * @default true
+     */
+    showSeparators?: boolean;
+    /**
+     * When true, parent buttons with children show a small corner triangle.
+     * Phone layouts typically set this to false.
+     * @default true
+     */
+    showChildrenIndicator?: boolean;
+}
+/**
+ * Sub-toolbar overrides: chrome fields plus optional axis alignment.
+ *
+ * Unset chrome fields inherit from the main toolbar.
+ */
+export interface AcUiSubToolbarOptions extends Partial<AcUiToolbarChromeOptions> {
+    /**
+     * Aligns the strip along the parent toolbar axis.
+     * @default 'front'
+     */
+    position?: AcUiSubToolbarPosition;
+    /**
+     * When true, opening a nested sub-toolbar hides the ancestor strip so only
+     * the new strip is visible (saves vertical space on phone). When false,
+     * nested strips stack beside/above the ancestor (pad/desktop).
+     *
+     * Also, when true, layers / measurements / review dock panels, sub-toolbars,
+     * and menus are mutually exclusive: opening one closes the others.
+     * @default false
+     */
+    replaceOnNested?: boolean;
+}
+/**
+ * Controls how a parent button icon relates to its submenu selection.
+ *
+ * - `'fixed'`: parent keeps its own `icon` (default).
+ * - `'selected'`: parent shows the selected child's `icon`.
+ */
+export type AcUiToolbarChildIconMode = 'fixed' | 'selected';
+/**
+ * How nested `children` are presented when the parent button is clicked.
+ *
+ * - `'menu'`: popover dropdown with icon + label (default). Closes on outside click.
+ * - `'toolbar'`: icon sub-toolbar beside the parent. Closes when a child button
+ *   is clicked, or on canvas / outside click.
+ * - `'sticky-toolbar'`: icon sub-toolbar that stays open until the parent button
+ *   is clicked again, or another parent opens a different strip. Child and
+ *   canvas clicks do not dismiss it.
+ */
+export type AcUiToolbarChildrenUi = 'menu' | 'toolbar' | 'sticky-toolbar';
+/** Visual separator between toolbar button groups. */
+export interface AcUiToolbarSeparator {
+    type: 'separator';
+    /** Optional stable id for debugging. */
+    id?: string;
+}
+/** Reference to a built-in toolbar button when composing a custom layout. */
+export interface AcUiToolbarPresetRef {
+    preset: string;
+}
+/**
+ * Minimal i18n surface used by the toolbar engine.
+ *
+ * Hosts adapt their own locale tables (plugin `AcUiI18n`, HTML `AcExHtmlI18n`,
+ * vue-i18n) to this shape.
+ */
+export interface AcUiToolbarI18n {
+    t(key: string, params?: Record<string, string>): string;
+}
+/**
+ * Document-related toolbar state. Driven by the host or
+ * {@link acapBindToolbarDocState} — the UI never imports DocManager.
+ */
+export interface AcUiToolbarDocState {
+    /** Whether an active document is loaded. */
+    hasDocument: boolean;
+    /** True while a document is opening (disables command buttons). */
+    isOpening: boolean;
+    /** Current document open mode used for {@link AcUiToolbarItem.minOpenMode}. */
+    openMode: AcEdOpenMode;
+}
+/**
+ * Configuration for a single toolbar button or submenu entry.
+ */
+export interface AcUiToolbarItem {
+    /** Stable identifier used for DOM attributes and debugging. */
+    id: string;
+    /** When `'separator'`, renders a divider instead of a button. */
+    type?: 'button' | 'separator';
+    /** i18n key resolved via {@link AcUiToolbarI18n.t}. */
+    label?: string;
+    /** Inline SVG string, DOM element, or factory that produces an icon element. */
+    icon?: string | HTMLElement | (() => HTMLElement);
+    /** CAD command string forwarded to {@link AcUiToolbarMountOptions.onCommand}. */
+    command?: string;
+    /** Custom click handler. Used when no command is set (e.g. theme toggle). */
+    action?: () => void;
+    /**
+     * Popover-style click handler that receives the anchor button element.
+     * When set, takes precedence over `command` and `action`.
+     */
+    anchorAction?: (anchor: HTMLElement) => void;
+    /**
+     * When false, the button stays enabled without an open document.
+     * Defaults to true when `command` is set, otherwise false.
+     */
+    requiresDocument?: boolean;
+    /** Minimum open mode required to show this item (Review shows in Review+Write). */
+    minOpenMode?: AcEdOpenMode;
+    /** Static or dynamic disabled state evaluated at render time. */
+    disabled?: boolean | (() => boolean);
+    /** Nested submenu items shown when the button is clicked.
+     * May be a live getter so the list can depend on the active document. */
+    children?: AcUiToolbarItem[];
+    /**
+     * Presentation of {@link children}. Defaults to `'menu'` (popover dropdown).
+     */
+    childrenUi?: AcUiToolbarChildrenUi;
+    /**
+     * When the button has `children`, controls whether the parent icon follows the
+     * selected submenu item. Defaults to `'fixed'`.
+     */
+    childIcon?: AcUiToolbarChildIconMode;
+    /** Initial submenu selection when {@link childIcon} is `'selected'`. */
+    selectedChildId?: string;
+    /** Two-state button that merges `on` or `off` branch fields based on `getValue`. */
+    toggle?: {
+        /** Returns whether the toggle is in the "on" branch. */
+        getValue: () => boolean;
+        /** Fields applied when `getValue` returns true. */
+        on: Partial<AcUiToolbarItem>;
+        /** Fields applied when `getValue` returns false. */
+        off: Partial<AcUiToolbarItem>;
+    };
+}
+/** Resolved toolbar entry: button, separator, or preset reference in config. */
+export type AcUiToolbarItemConfig = AcUiToolbarItem | AcUiToolbarSeparator | AcUiToolbarPresetRef;
+/**
+ * Standalone toolbar configuration shared by hosts that compose item lists.
+ */
+export interface AcUiToolbarOptions extends AcUiToolbarChromeOptions {
+    /** When false, the toolbar is not created. */
+    enabled?: boolean;
+    /** Edge placement relative to `host`. */
+    placement?: AcUiToolbarPlacement;
+    /** Toolbar items, `'default'`, or a custom list (may include presets and separators). */
+    items?: AcUiToolbarItemConfig[] | 'default';
+    /**
+     * Root toolbar item ids to omit after resolving {@link items} and
+     * {@link appendItems}. Does not recurse into submenu children.
+     */
+    excludeItems?: string[];
+    /** Extra items merged into `items` (default: appended at the end). */
+    appendItems?: AcUiToolbarItemConfig[];
+    /**
+     * Insert `appendItems` after the root toolbar item with this id.
+     * Ignored when {@link appendItemsBefore} is set.
+     */
+    appendItemsAfter?: string;
+    /**
+     * Insert `appendItems` before the root toolbar item with this id.
+     * Takes precedence over {@link appendItemsAfter}.
+     */
+    appendItemsBefore?: string;
+    /** When true, show a collapse/expand toggle at the end of the toolbar. */
+    collapsible?: boolean;
+    /** Initial collapsed state when {@link collapsible} is true. */
+    defaultCollapsed?: boolean;
+    /**
+     * Canvas element that receives the floating toolbar.
+     */
+    mountTarget?: HTMLElement;
+    /**
+     * When true, the toolbar is laid out as a flex sibling of the canvas inside
+     * the canvas parent instead of floating over the drawing.
+     * @default false
+     */
+    inCanvasParent?: boolean;
+    /**
+     * Sub-toolbar chrome and position overrides. Unset chrome fields inherit from
+     * the main toolbar.
+     */
+    subToolbar?: AcUiSubToolbarOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/ui/toolbar/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ui/toolbar/types.ts"],"names":[],"mappings":"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"}

package/lib/ui/toolbar/types.js

@@ -0,0 +1,8 @@
+/**
+ * Shared toolbar item and chrome types for {@link AcUiToolbar}.
+ *
+ * @module toolbar/types
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/lib/ui/toolbar/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/ui/toolbar/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/lib/ui/touch-point-tutorial.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Portable precise point-pick tutorial dialog (DOM + CSS animation only).
+ *
+ * Re-exported from `@mlightcad/cad-simple-viewer` for the live viewer and
+ * offline HTML viewer (via {@link AcExHtmlSimpleViewerUi}).
+ */
+import type { AcEdUiTheme } from '../editor/global/AcEdUiTheme';
+import { AcUiDialog } from './AcUiDialog';
+/** Localized strings for the tutorial dialog. */
+export interface AcUiTouchPointTutorialLabels {
+    title: string;
+    description: string;
+    snoozeToday: string;
+    hideForever: string;
+    ok: string;
+}
+/** Persisted snooze / dismiss preferences. */
+export interface AcUiTouchPointTutorialPrefs {
+    hideForever: boolean;
+    snoozeDate: string | null;
+}
+/** Runtime configuration for {@link AcUiTouchPointTutorial.maybeShow}. */
+export interface AcUiTouchPointTutorialConfig {
+    /** Backdrop host; defaults to `document.body`. */
+    host?: HTMLElement;
+    /** Theme tokens; defaults to {@link resolveUiTheme} from the host. */
+    theme?: AcEdUiTheme;
+    labels: AcUiTouchPointTutorialLabels;
+    /** Long-press delay shown in the demo animation (ms). */
+    longPressMs: number;
+    /** When false, {@link AcUiTouchPointTutorial.maybeShow} is a no-op. */
+    shouldShow: () => boolean;
+    readPrefs: () => AcUiTouchPointTutorialPrefs;
+    writePrefs: (prefs: AcUiTouchPointTutorialPrefs) => void;
+}
+/**
+ * Returns today's date as `YYYY-MM-DD` in local time.
+ */
+export declare function acuiLocalIsoDate(date?: Date): string;
+/**
+ * Whether the tutorial should be shown from layout + preference state.
+ */
+export declare function acuiShouldShowTouchPointTutorialFromPrefs(shouldShowOnMobile: () => boolean, prefs: AcUiTouchPointTutorialPrefs): boolean;
+/**
+ * Modal tutorial explaining long-press precise point picking on mobile.
+ */
+export declare class AcUiTouchPointTutorial extends AcUiDialog {
+    private static openInstance;
+    private readonly config;
+    private readonly snoozeTodayCheckbox;
+    private readonly hideForeverCheckbox;
+    private constructor();
+    /**
+     * Opens the tutorial when {@link AcUiTouchPointTutorialConfig.shouldShow} is true.
+     */
+    static maybeShow(config: AcUiTouchPointTutorialConfig): Promise<void>;
+    close(): void;
+    private dismiss;
+    private static createDemo;
+    private static pct;
+    private static pctAfter;
+    private static ensureTutorialStyles;
+}
+//# sourceMappingURL=touch-point-tutorial.d.ts.map

package/lib/ui/touch-point-tutorial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touch-point-tutorial.d.ts","sourceRoot":"","sources":["../../src/ui/touch-point-tutorial.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAsDzC,iDAAiD;AACjD,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,EAAE,EAAE,MAAM,CAAA;CACX;AAED,8CAA8C;AAC9C,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,OAAO,CAAA;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,0EAA0E;AAC1E,MAAM,WAAW,4BAA4B;IAC3C,kDAAkD;IAClD,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,MAAM,EAAE,4BAA4B,CAAA;IACpC,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,UAAU,EAAE,MAAM,OAAO,CAAA;IACzB,SAAS,EAAE,MAAM,2BAA2B,CAAA;IAC5C,UAAU,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,CAAA;CACzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAKhE;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,kBAAkB,EAAE,MAAM,OAAO,EACjC,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAOT;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,OAAO,CAAC,MAAM,CAAC,YAAY,CAAsC;IAEjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkB;IAEtD,OAAO;IAkEP;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5D,KAAK,IAAI,IAAI;IAOtB,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,MAAM,CAAC,UAAU;IAyCzB,OAAO,CAAC,MAAM,CAAC,GAAG;IAIlB,OAAO,CAAC,MAAM,CAAC,QAAQ;IAIvB,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAiTpC"}