@mlightcad/cad-simple-viewer 1.8.0-preview.3 → 1.8.0-preview.4

package/lib/service/AcApNamedViewService.d.ts

@@ -0,0 +1,139 @@
+import { AcDbDatabase, AcDbViewTableRecord, AcGeBox2d, AcGePoint2d } from '@mlightcad/data-model';
+import type { AcEdBaseView } from '../editor/view/AcEdBaseView';
+/** XDATA AppId for named-view layer On/Off + Freeze/Thaw snapshots. */
+export declare const MLIGHT_VIEW_LAYER_SNAP_APPID = "MLIGHT_VIEW_LAYER_SNAP";
+/** Bit 0 of VIEW `standardFlags`: paperspace / layout view. */
+export declare const VIEW_PAPERSPACE_FLAG = 1;
+/** Undo label for named-view table edits. */
+export declare const NAMED_VIEW_EDIT_LABEL = "View";
+/**
+ * Layer On/Off + Freeze/Thaw captured with a named view (no Locked).
+ */
+export interface AcApNamedViewLayerSnapshot {
+    states: Array<{
+        name: string;
+        isOn: boolean;
+        isFrozen: boolean;
+    }>;
+}
+/**
+ * Camera box derived from a named view record (DCS center + width/height).
+ */
+export interface AcApNamedViewCamera {
+    center: AcGePoint2d;
+    viewHeight: number;
+    viewWidth: number;
+    viewTwistAngle: number;
+    isPaperSpace: boolean;
+    hasLayerSnapshot: boolean;
+}
+export type AcApNamedViewGroup = 'model' | 'layout';
+/**
+ * Summary row for View Manager / Restore View lists.
+ */
+export interface AcApNamedViewListItem {
+    name: string;
+    group: AcApNamedViewGroup;
+    hasLayerSnapshot: boolean;
+}
+export interface AcApCreateNamedViewOptions {
+    name: string;
+    /** World box to store; when omitted, captured from `view`. */
+    box?: AcGeBox2d;
+    saveLayerSnapshot?: boolean;
+    /** Force paperspace flag; default from `isModelSpaceDatabase(db)`. */
+    isPaperSpace?: boolean;
+}
+/**
+ * Named-view helpers: capture/restore camera boxes, CRUD on `viewTable`,
+ * and optional layer snapshots stored as XDATA on the view record.
+ */
+export declare class AcApNamedViewService {
+    /**
+     * Returns whether `name` is a safe AutoCAD-like symbol-table name.
+     *
+     * Rejects empty names and characters that break command scripting (`\n`) or
+     * AutoCAD symbol naming.
+     */
+    static isValidViewName(name: string): boolean;
+    /**
+     * Ensures the layer-snapshot AppId exists in the REGAPP table.
+     *
+     * When already inside an undoable edit, registers the AppId in-place so it
+     * shares the same undo group as the caller.
+     */
+    static ensureLayerSnapAppId(db: AcDbDatabase): void;
+    /**
+     * Captures the current visible world box from the active view.
+     */
+    static captureViewBox(view: AcEdBaseView): AcGeBox2d;
+    /**
+     * Builds a DCS box from a view table record's center / height / width.
+     */
+    static boxFromRecord(record: AcDbViewTableRecord): AcGeBox2d;
+    /**
+     * Applies a world box onto a view table record's camera fields.
+     */
+    static applyBoxToRecord(record: AcDbViewTableRecord, box: AcGeBox2d): void;
+    /**
+     * Captures On/Off + Freeze/Thaw for every layer in the database.
+     */
+    static captureLayerSnapshot(db: AcDbDatabase): AcApNamedViewLayerSnapshot;
+    /**
+     * Writes a layer snapshot into the view record's XDATA.
+     */
+    static writeLayerSnapshot(record: AcDbViewTableRecord, snapshot: AcApNamedViewLayerSnapshot): void;
+    /**
+     * Reads a layer snapshot from the view record's XDATA, if present.
+     */
+    static readLayerSnapshot(record: AcDbViewTableRecord): AcApNamedViewLayerSnapshot | undefined;
+    /**
+     * Removes the layer-snapshot XDATA from a view record.
+     */
+    static clearLayerSnapshot(record: AcDbViewTableRecord): void;
+    /**
+     * Applies a named-view layer snapshot (On/Off + Freeze only).
+     */
+    static applyLayerSnapshot(db: AcDbDatabase, snapshot: AcApNamedViewLayerSnapshot): void;
+    /**
+     * Lists named views grouped as model vs layout.
+     */
+    static listViews(db: AcDbDatabase): AcApNamedViewListItem[];
+    /**
+     * Returns camera metadata for a named view, or `undefined` if missing.
+     */
+    static getCamera(db: AcDbDatabase, name: string): AcApNamedViewCamera | undefined;
+    static isPaperSpaceView(record: AcDbViewTableRecord): boolean;
+    /**
+     * Creates (or replaces) a named view from the current display or a box.
+     *
+     * @returns `false` when the name is empty.
+     */
+    static createView(db: AcDbDatabase, view: AcEdBaseView, options: AcApCreateNamedViewOptions): boolean;
+    /**
+     * Applies camera box, paperspace flag, and optional layer snapshot to a record.
+     *
+     * Call before {@link AcDbViewTable.add} for new records, or on a record opened
+     * via {@link AcDbDatabase.openObjectForWrite} for existing ones.
+     */
+    private static applyCameraAndSnapshot;
+    /**
+     * Updates the layer snapshot on an existing named view to the current layers.
+     */
+    static updateLayerSnapshot(db: AcDbDatabase, name: string): boolean;
+    /**
+     * Replaces the camera box of an existing named view (Edit Boundaries).
+     */
+    static updateBoundaries(db: AcDbDatabase, name: string, box: AcGeBox2d): boolean;
+    /**
+     * Deletes a named view.
+     */
+    static deleteView(db: AcDbDatabase, name: string): boolean;
+    /**
+     * Restores a named view onto the active camera and optionally layers.
+     *
+     * @param applyLayers - When true, restores the layer snapshot if present.
+     */
+    static restoreView(db: AcDbDatabase, view: AcEdBaseView, name: string, applyLayers?: boolean): boolean;
+}
+//# sourceMappingURL=AcApNamedViewService.d.ts.map

package/lib/service/AcApNamedViewService.d.ts.map

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

package/lib/service/AcApNamedViewService.js

@@ -0,0 +1,407 @@
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+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.");
+};
+import { AcDbDxfCode, AcDbRegAppTableRecord, AcDbResultBuffer, AcDbViewTableRecord, AcGeBox2d, AcGePoint2d, AcGePoint3d } from '@mlightcad/data-model';
+import { isModelSpaceDatabase } from '../editor/global/AcEdUiColor';
+import { AcApLayerService } from './AcApLayerService';
+import { acapRunServiceEdit } from './AcApServiceEdit';
+/** XDATA AppId for named-view layer On/Off + Freeze/Thaw snapshots. */
+export var MLIGHT_VIEW_LAYER_SNAP_APPID = 'MLIGHT_VIEW_LAYER_SNAP';
+/** Bit 0 of VIEW `standardFlags`: paperspace / layout view. */
+export var VIEW_PAPERSPACE_FLAG = 0x01;
+/** Undo label for named-view table edits. */
+export var NAMED_VIEW_EDIT_LABEL = 'View';
+/**
+ * Named-view helpers: capture/restore camera boxes, CRUD on `viewTable`,
+ * and optional layer snapshots stored as XDATA on the view record.
+ */
+var AcApNamedViewService = /** @class */ (function () {
+    function AcApNamedViewService() {
+    }
+    /**
+     * Returns whether `name` is a safe AutoCAD-like symbol-table name.
+     *
+     * Rejects empty names and characters that break command scripting (`\n`) or
+     * AutoCAD symbol naming.
+     */
+    AcApNamedViewService.isValidViewName = function (name) {
+        var trimmed = name.trim();
+        if (!trimmed)
+            return false;
+        if (/[\n\r<>/\\":;?*|,=`]/.test(trimmed))
+            return false;
+        return true;
+    };
+    /**
+     * Ensures the layer-snapshot AppId exists in the REGAPP table.
+     *
+     * When already inside an undoable edit, registers the AppId in-place so it
+     * shares the same undo group as the caller.
+     */
+    AcApNamedViewService.ensureLayerSnapAppId = function (db) {
+        var _a, _b;
+        if (db.tables.appIdTable.has(MLIGHT_VIEW_LAYER_SNAP_APPID))
+            return;
+        var addAppId = function () {
+            if (db.tables.appIdTable.has(MLIGHT_VIEW_LAYER_SNAP_APPID))
+                return;
+            db.tables.appIdTable.add(new AcDbRegAppTableRecord(MLIGHT_VIEW_LAYER_SNAP_APPID));
+        };
+        if ((_b = (_a = db.transactionManager) === null || _a === void 0 ? void 0 : _a.hasTransaction) === null || _b === void 0 ? void 0 : _b.call(_a)) {
+            addAppId();
+            return;
+        }
+        acapRunServiceEdit(db, NAMED_VIEW_EDIT_LABEL, addAppId);
+    };
+    /**
+     * Captures the current visible world box from the active view.
+     */
+    AcApNamedViewService.captureViewBox = function (view) {
+        var topLeft = view.screenToWorld({ x: 0, y: 0 });
+        var bottomRight = view.screenToWorld({
+            x: view.width,
+            y: view.height
+        });
+        return new AcGeBox2d().expandByPoint(topLeft).expandByPoint(bottomRight);
+    };
+    /**
+     * Builds a DCS box from a view table record's center / height / width.
+     */
+    AcApNamedViewService.boxFromRecord = function (record) {
+        var halfW = Math.max(record.viewWidth, Number.EPSILON) / 2;
+        var halfH = Math.max(record.viewHeight, Number.EPSILON) / 2;
+        var cx = record.centerPoint.x;
+        var cy = record.centerPoint.y;
+        return new AcGeBox2d(new AcGePoint2d(cx - halfW, cy - halfH), new AcGePoint2d(cx + halfW, cy + halfH));
+    };
+    /**
+     * Applies a world box onto a view table record's camera fields.
+     */
+    AcApNamedViewService.applyBoxToRecord = function (record, box) {
+        var min = box.min;
+        var max = box.max;
+        var width = Math.max(max.x - min.x, Number.EPSILON);
+        var height = Math.max(max.y - min.y, Number.EPSILON);
+        record.centerPoint = new AcGePoint2d((min.x + max.x) / 2, (min.y + max.y) / 2);
+        record.viewWidth = width;
+        record.viewHeight = height;
+        record.viewDirectionFromTarget = new AcGePoint3d(0, 0, 1);
+        record.viewTarget = new AcGePoint3d(0, 0, 0);
+    };
+    /**
+     * Captures On/Off + Freeze/Thaw for every layer in the database.
+     */
+    AcApNamedViewService.captureLayerSnapshot = function (db) {
+        return {
+            states: __spreadArray([], __read(db.tables.layerTable.newIterator()), false).map(function (layer) { return ({
+                name: layer.name,
+                isOn: !layer.isOff,
+                isFrozen: layer.isFrozen
+            }); })
+        };
+    };
+    /**
+     * Writes a layer snapshot into the view record's XDATA.
+     */
+    AcApNamedViewService.writeLayerSnapshot = function (record, snapshot) {
+        var e_1, _a;
+        var rb = new AcDbResultBuffer([
+            {
+                code: AcDbDxfCode.ExtendedDataRegAppName,
+                value: MLIGHT_VIEW_LAYER_SNAP_APPID
+            },
+            { code: AcDbDxfCode.ExtendedDataInteger16, value: 1 }
+        ]);
+        try {
+            for (var _b = __values(snapshot.states), _c = _b.next(); !_c.done; _c = _b.next()) {
+                var state = _c.value;
+                rb.add({
+                    code: AcDbDxfCode.ExtendedDataAsciiString,
+                    value: state.name
+                });
+                rb.add({
+                    code: AcDbDxfCode.ExtendedDataInteger16,
+                    value: state.isOn ? 1 : 0
+                });
+                rb.add({
+                    code: AcDbDxfCode.ExtendedDataInteger16,
+                    value: state.isFrozen ? 1 : 0
+                });
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+        record.setXData(rb);
+    };
+    /**
+     * Reads a layer snapshot from the view record's XDATA, if present.
+     */
+    AcApNamedViewService.readLayerSnapshot = function (record) {
+        var rb = record.getXData(MLIGHT_VIEW_LAYER_SNAP_APPID);
+        if (!rb || rb.length < 2)
+            return undefined;
+        var states = [];
+        var i = 1;
+        // Skip version integer if present
+        var first = rb.at(i);
+        if (first && first.code === AcDbDxfCode.ExtendedDataInteger16) {
+            i++;
+        }
+        while (i + 2 < rb.length) {
+            var nameItem = rb.at(i);
+            var onItem = rb.at(i + 1);
+            var frozenItem = rb.at(i + 2);
+            if (!nameItem ||
+                nameItem.code !== AcDbDxfCode.ExtendedDataAsciiString ||
+                !onItem ||
+                onItem.code !== AcDbDxfCode.ExtendedDataInteger16 ||
+                !frozenItem ||
+                frozenItem.code !== AcDbDxfCode.ExtendedDataInteger16) {
+                break;
+            }
+            states.push({
+                name: String(nameItem.value),
+                isOn: Number(onItem.value) !== 0,
+                isFrozen: Number(frozenItem.value) !== 0
+            });
+            i += 3;
+        }
+        return states.length > 0 ? { states: states } : undefined;
+    };
+    /**
+     * Removes the layer-snapshot XDATA from a view record.
+     */
+    AcApNamedViewService.clearLayerSnapshot = function (record) {
+        record.removeXData(MLIGHT_VIEW_LAYER_SNAP_APPID);
+    };
+    /**
+     * Applies a named-view layer snapshot (On/Off + Freeze only).
+     */
+    AcApNamedViewService.applyLayerSnapshot = function (db, snapshot) {
+        acapRunServiceEdit(db, NAMED_VIEW_EDIT_LABEL, function () {
+            var e_2, _a;
+            try {
+                for (var _b = __values(snapshot.states), _c = _b.next(); !_c.done; _c = _b.next()) {
+                    var state = _c.value;
+                    var layer = AcApLayerService.openLayerForWrite(db, state.name);
+                    if (!layer)
+                        continue;
+                    layer.isOff = !state.isOn;
+                    AcApLayerService.setLayerFrozenState(layer, state.isFrozen);
+                }
+            }
+            catch (e_2_1) { e_2 = { error: e_2_1 }; }
+            finally {
+                try {
+                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+                }
+                finally { if (e_2) throw e_2.error; }
+            }
+        });
+    };
+    /**
+     * Lists named views grouped as model vs layout.
+     */
+    AcApNamedViewService.listViews = function (db) {
+        var e_3, _a;
+        var _b;
+        var items = [];
+        try {
+            for (var _c = __values(db.tables.viewTable.newIterator()), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var record = _d.value;
+                var name_1 = (_b = record.name) === null || _b === void 0 ? void 0 : _b.trim();
+                if (!name_1)
+                    continue;
+                items.push({
+                    name: name_1,
+                    group: AcApNamedViewService.isPaperSpaceView(record)
+                        ? 'layout'
+                        : 'model',
+                    hasLayerSnapshot: AcApNamedViewService.readLayerSnapshot(record) != null
+                });
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
+        items.sort(function (a, b) { return a.name.localeCompare(b.name); });
+        return items;
+    };
+    /**
+     * Returns camera metadata for a named view, or `undefined` if missing.
+     */
+    AcApNamedViewService.getCamera = function (db, name) {
+        var record = db.tables.viewTable.getAt(name);
+        if (!record)
+            return undefined;
+        return {
+            center: new AcGePoint2d(record.centerPoint.x, record.centerPoint.y),
+            viewHeight: record.viewHeight,
+            viewWidth: record.viewWidth,
+            viewTwistAngle: record.viewTwistAngle,
+            isPaperSpace: AcApNamedViewService.isPaperSpaceView(record),
+            hasLayerSnapshot: AcApNamedViewService.readLayerSnapshot(record) != null
+        };
+    };
+    AcApNamedViewService.isPaperSpaceView = function (record) {
+        var _a;
+        return (((_a = record.standardFlags) !== null && _a !== void 0 ? _a : 0) & VIEW_PAPERSPACE_FLAG) !== 0;
+    };
+    /**
+     * Creates (or replaces) a named view from the current display or a box.
+     *
+     * @returns `false` when the name is empty.
+     */
+    AcApNamedViewService.createView = function (db, view, options) {
+        var _a, _b;
+        var name = options.name.trim();
+        if (!AcApNamedViewService.isValidViewName(name))
+            return false;
+        var box = (_a = options.box) !== null && _a !== void 0 ? _a : AcApNamedViewService.captureViewBox(view);
+        var isPaperSpace = (_b = options.isPaperSpace) !== null && _b !== void 0 ? _b : !isModelSpaceDatabase(db);
+        var saveLayerSnapshot = options.saveLayerSnapshot !== false;
+        return acapRunServiceEdit(db, NAMED_VIEW_EDIT_LABEL, function () {
+            AcApNamedViewService.ensureLayerSnapAppId(db);
+            var existing = db.tables.viewTable.getAt(name);
+            var record = existing
+                ? db.openObjectForWrite(existing.objectId)
+                : new AcDbViewTableRecord({ name: name });
+            if (!record)
+                return false;
+            AcApNamedViewService.applyCameraAndSnapshot(db, record, box, isPaperSpace, saveLayerSnapshot);
+            if (!existing) {
+                db.tables.viewTable.add(record);
+            }
+            return true;
+        });
+    };
+    /**
+     * Applies camera box, paperspace flag, and optional layer snapshot to a record.
+     *
+     * Call before {@link AcDbViewTable.add} for new records, or on a record opened
+     * via {@link AcDbDatabase.openObjectForWrite} for existing ones.
+     */
+    AcApNamedViewService.applyCameraAndSnapshot = function (db, record, box, isPaperSpace, saveLayerSnapshot) {
+        var _a, _b;
+        AcApNamedViewService.applyBoxToRecord(record, box);
+        record.standardFlags = isPaperSpace
+            ? ((_a = record.standardFlags) !== null && _a !== void 0 ? _a : 0) | VIEW_PAPERSPACE_FLAG
+            : ((_b = record.standardFlags) !== null && _b !== void 0 ? _b : 0) & ~VIEW_PAPERSPACE_FLAG;
+        if (saveLayerSnapshot) {
+            AcApNamedViewService.writeLayerSnapshot(record, AcApNamedViewService.captureLayerSnapshot(db));
+        }
+        else {
+            AcApNamedViewService.clearLayerSnapshot(record);
+        }
+    };
+    /**
+     * Updates the layer snapshot on an existing named view to the current layers.
+     */
+    AcApNamedViewService.updateLayerSnapshot = function (db, name) {
+        if (!db.tables.viewTable.has(name))
+            return false;
+        return acapRunServiceEdit(db, NAMED_VIEW_EDIT_LABEL, function () {
+            AcApNamedViewService.ensureLayerSnapAppId(db);
+            var existing = db.tables.viewTable.getAt(name);
+            if (!existing)
+                return false;
+            var opened = db.openObjectForWrite(existing.objectId);
+            if (!opened)
+                return false;
+            AcApNamedViewService.writeLayerSnapshot(opened, AcApNamedViewService.captureLayerSnapshot(db));
+            return true;
+        });
+    };
+    /**
+     * Replaces the camera box of an existing named view (Edit Boundaries).
+     */
+    AcApNamedViewService.updateBoundaries = function (db, name, box) {
+        if (!db.tables.viewTable.has(name))
+            return false;
+        return acapRunServiceEdit(db, NAMED_VIEW_EDIT_LABEL, function () {
+            var existing = db.tables.viewTable.getAt(name);
+            if (!existing)
+                return false;
+            var record = db.openObjectForWrite(existing.objectId);
+            if (!record)
+                return false;
+            AcApNamedViewService.applyBoxToRecord(record, box);
+            return true;
+        });
+    };
+    /**
+     * Deletes a named view.
+     */
+    AcApNamedViewService.deleteView = function (db, name) {
+        if (!db.tables.viewTable.has(name))
+            return false;
+        return acapRunServiceEdit(db, NAMED_VIEW_EDIT_LABEL, function () {
+            return db.tables.viewTable.remove(name);
+        });
+    };
+    /**
+     * Restores a named view onto the active camera and optionally layers.
+     *
+     * @param applyLayers - When true, restores the layer snapshot if present.
+     */
+    AcApNamedViewService.restoreView = function (db, view, name, applyLayers) {
+        if (applyLayers === void 0) { applyLayers = true; }
+        var record = db.tables.viewTable.getAt(name);
+        if (!record)
+            return false;
+        var box = AcApNamedViewService.boxFromRecord(record);
+        view.zoomTo(box, 1);
+        if (applyLayers) {
+            var snapshot = AcApNamedViewService.readLayerSnapshot(record);
+            if (snapshot) {
+                AcApNamedViewService.applyLayerSnapshot(db, snapshot);
+            }
+        }
+        return true;
+    };
+    return AcApNamedViewService;
+}());
+export { AcApNamedViewService };
+//# sourceMappingURL=AcApNamedViewService.js.map

package/lib/service/AcApNamedViewService.js.map

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

package/lib/service/AcApTextRecognitionService.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Request passed to an {@link AcApTextRecognizer}.
+ */
+export interface AcApTextRecognitionRequest {
+    /** PNG data URL of the strokes to read: dark ink, white background, upright. */
+    image: string;
+    /** Optional context, e.g. the text recognized for a neighboring line. */
+    hint?: string;
+    /** UI locale, so the recognizer can bias toward the user's language. */
+    locale?: string;
+    /** Cancels the request when the user stops the command. */
+    signal?: AbortSignal;
+}
+/**
+ * Request passed to {@link AcApTextRecognizer.recognizeBatch}: several images
+ * read in one go.
+ */
+export interface AcApTextBatchRecognitionRequest {
+    /** PNG data URLs, one text line each: dark ink, white background, upright. */
+    images: string[];
+    /** UI locale, so the recognizer can bias toward the user's language. */
+    locale?: string;
+    /** Cancels the request when the user stops the command. */
+    signal?: AbortSignal;
+}
+/**
+ * Options of {@link AcApTextRecognitionService.recognize} and
+ * {@link AcApTextRecognitionService.recognizeBatch}.
+ */
+export interface AcApTextRecognitionOptions {
+    /**
+     * Called for each recognizer that throws (bad API key, network error,
+     * quota, ...), so the caller can tell the user why no suggestion came.
+     * Not called for requests cancelled through the request `signal`.
+     *
+     * @param error - The thrown error.
+     * @param recognizerId - Id of the recognizer that failed.
+     */
+    onError?: (error: unknown, recognizerId: string) => void;
+}
+/**
+ * Optical text recognizer, typically backed by a vision-capable LLM.
+ *
+ * Implementations return `undefined` when they cannot help (not configured,
+ * no vision model, request failed) so callers fall back to manual input.
+ */
+export interface AcApTextRecognizer {
+    /** Unique id, e.g. `'cad-agent'`. */
+    id: string;
+    /**
+     * Reads the text shown in the image.
+     *
+     * @returns Recognized text, or `undefined` when unavailable.
+     */
+    recognize(request: AcApTextRecognitionRequest): Promise<string | undefined>;
+    /**
+     * Optional: reads several images in as few requests as possible (for an
+     * LLM, one prompt instead of one per image, which is faster and spends
+     * fewer tokens).
+     *
+     * @returns One entry per image, in order; `undefined` or empty for images
+     * it could not read.
+     */
+    recognizeBatch?(request: AcApTextBatchRecognitionRequest): Promise<Array<string | undefined>>;
+}
+/**
+ * Registry of optional text recognizers.
+ *
+ * Lets features that need OCR (for example PDF text recovery) use whatever
+ * recognizer the host installed, without depending on the package that
+ * provides it.
+ */
+export declare class AcApTextRecognitionService {
+    private static readonly recognizers;
+    /**
+     * Registers (or replaces) a recognizer.
+     *
+     * @returns A function that unregisters it.
+     */
+    static register(recognizer: AcApTextRecognizer): () => void;
+    /** Removes the recognizer with `id`. */
+    static unregister(id: string): void;
+    /** True when at least one recognizer is registered. */
+    static get hasRecognizer(): boolean;
+    /**
+     * Asks registered recognizers in registration order and returns the first
+     * non-empty answer. Errors never break the command: they go to
+     * `options.onError` and the next recognizer is tried.
+     *
+     * @param request - Image and context to recognize.
+     * @param options - Error callback.
+     */
+    static recognize(request: AcApTextRecognitionRequest, options?: AcApTextRecognitionOptions): Promise<string | undefined>;
+    /**
+     * Reads several images at once. Each recognizer in registration order gets
+     * the images still unread: in one {@link AcApTextRecognizer.recognizeBatch}
+     * call when it has one, otherwise as parallel single-image requests.
+     * Errors never break the command: they go to `options.onError` and the
+     * affected images stay unread.
+     *
+     * @param request - Images and context to recognize.
+     * @param options - Error callback.
+     * @returns One entry per image, in order; `undefined` when unread.
+     */
+    static recognizeBatch(request: AcApTextBatchRecognitionRequest, options?: AcApTextRecognitionOptions): Promise<Array<string | undefined>>;
+}
+//# sourceMappingURL=AcApTextRecognitionService.d.ts.map