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

package/lib/service/AcApGroup.js

@@ -0,0 +1,421 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        if (typeof b !== "function" && b !== null)
+            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+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.");
+};
+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));
+};
+import { AcDbGroup, AcDbSystemVariables, AcDbSysVarManager } from '@mlightcad/data-model';
+import { isEntityOnLockedLayer } from './AcApLockedLayer';
+/** Max length of a named group (AutoCAD). */
+export var ACAP_GROUP_NAME_MAX_LENGTH = 31;
+/** Max length of a group description (AutoCAD). */
+export var ACAP_GROUP_DESCRIPTION_MAX_LENGTH = 64;
+var ANONYMOUS_GROUP_RE = /^\*A(\d+)$/i;
+var NAMED_GROUP_RE = /^[A-Z0-9$_-]{1,31}$/;
+/**
+ * Returns whether group selection is enabled for the current `PICKSTYLE`.
+ *
+ * AutoCAD values `1` and `3` enable group selection. Associative-hatch
+ * co-selection (`2` / `3`) is registered but not expanded here because hatch
+ * boundary soft-pointers are not yet modeled on `AcDbHatch`.
+ */
+export function acapIsGroupSelectionEnabled(database) {
+    var raw = AcDbSysVarManager.instance().getVar(AcDbSystemVariables.PICKSTYLE, database);
+    var value = typeof raw === 'number' ? raw : Number(raw);
+    if (!Number.isFinite(value))
+        return true;
+    return (Math.trunc(value) & 1) !== 0;
+}
+/**
+ * Returns whether `PICKSTYLE` requests associative hatch co-selection.
+ *
+ * Currently unused for expansion (no boundary refs); kept for ribbon/sysvar UI.
+ */
+export function acapIsAssociativeHatchSelectionEnabled(database) {
+    var raw = AcDbSysVarManager.instance().getVar(AcDbSystemVariables.PICKSTYLE, database);
+    var value = typeof raw === 'number' ? raw : Number(raw);
+    if (!Number.isFinite(value))
+        return false;
+    return (Math.trunc(value) & 2) !== 0;
+}
+/**
+ * Normalizes a user-entered group name (trim + uppercase).
+ */
+export function acapNormalizeGroupName(name) {
+    return String(name !== null && name !== void 0 ? name : '')
+        .trim()
+        .toUpperCase();
+}
+/**
+ * Validates a named (non-anonymous) group name per AutoCAD rules.
+ *
+ * @returns Normalized name, or `undefined` when invalid.
+ */
+export function acapValidateGroupName(name) {
+    var normalized = acapNormalizeGroupName(name);
+    if (!normalized || normalized.startsWith('*'))
+        return undefined;
+    if (normalized.length > ACAP_GROUP_NAME_MAX_LENGTH)
+        return undefined;
+    if (!NAMED_GROUP_RE.test(normalized))
+        return undefined;
+    return normalized;
+}
+/**
+ * Returns the next unused anonymous group name (`*A1`, `*A2`, …).
+ */
+export function acapNextAnonymousGroupName(db) {
+    var e_1, _a;
+    var max = 0;
+    try {
+        for (var _b = __values(db.objects.group.entries()), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 1), key = _d[0];
+            var match = ANONYMOUS_GROUP_RE.exec(key);
+            if (!match)
+                continue;
+            var n = Number(match[1]);
+            if (Number.isFinite(n) && n > max)
+                max = n;
+        }
+    }
+    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; }
+    }
+    return "*A".concat(max + 1);
+}
+/**
+ * Returns whether a group is unnamed / anonymous (`*A…`), matching AutoCAD's
+ * "Include Unnamed" filter (flag and/or `*` name prefix).
+ */
+export function acapIsUnnamedGroup(group) {
+    var _a;
+    if (group.isAnonymous())
+        return true;
+    var name = (_a = group.name) !== null && _a !== void 0 ? _a : '';
+    return name.startsWith('*');
+}
+/**
+ * Lists all groups in the dictionary (optionally including anonymous).
+ */
+export function acapListGroups(db, includeUnnamed) {
+    var e_2, _a;
+    if (includeUnnamed === void 0) { includeUnnamed = true; }
+    var groups = [];
+    try {
+        for (var _b = __values(db.objects.group.entries()), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 2), group = _d[1];
+            if (!includeUnnamed && acapIsUnnamedGroup(group))
+                continue;
+            groups.push(group);
+        }
+    }
+    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; }
+    }
+    groups.sort(function (a, b) { return a.name.localeCompare(b.name); });
+    return groups;
+}
+/**
+ * Finds groups that contain the given entity id.
+ */
+export function acapFindGroupsContaining(db, entityId) {
+    var e_3, _a;
+    if (!entityId)
+        return [];
+    var result = [];
+    try {
+        for (var _b = __values(db.objects.group.entries()), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 2), group = _d[1];
+            if (group.has(entityId))
+                result.push(group);
+        }
+    }
+    catch (e_3_1) { e_3 = { error: e_3_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_3) throw e_3.error; }
+    }
+    return result;
+}
+/**
+ * Unique groups that contain any of the given entity ids (selection order).
+ */
+export function acapFindGroupsContainingAny(db, entityIds) {
+    var e_4, _a, e_5, _b;
+    var seen = new Set();
+    var result = [];
+    try {
+        for (var entityIds_1 = __values(entityIds), entityIds_1_1 = entityIds_1.next(); !entityIds_1_1.done; entityIds_1_1 = entityIds_1.next()) {
+            var id = entityIds_1_1.value;
+            try {
+                for (var _c = (e_5 = void 0, __values(acapFindGroupsContaining(db, id))), _d = _c.next(); !_d.done; _d = _c.next()) {
+                    var group = _d.value;
+                    var key = group.name || group.objectId;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    result.push(group);
+                }
+            }
+            catch (e_5_1) { e_5 = { error: e_5_1 }; }
+            finally {
+                try {
+                    if (_d && !_d.done && (_b = _c.return)) _b.call(_c);
+                }
+                finally { if (e_5) throw e_5.error; }
+            }
+        }
+    }
+    catch (e_4_1) { e_4 = { error: e_4_1 }; }
+    finally {
+        try {
+            if (entityIds_1_1 && !entityIds_1_1.done && (_a = entityIds_1.return)) _a.call(entityIds_1);
+        }
+        finally { if (e_4) throw e_4.error; }
+    }
+    return result;
+}
+/**
+ * Resolves a group by dictionary name (case-insensitive).
+ */
+export function acapGetGroupByName(db, name) {
+    var e_6, _a;
+    var normalized = acapNormalizeGroupName(name);
+    if (!normalized)
+        return undefined;
+    var direct = db.objects.group.getAt(normalized);
+    if (direct)
+        return direct;
+    try {
+        for (var _b = __values(db.objects.group.entries()), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var _d = __read(_c.value, 2), key = _d[0], group = _d[1];
+            if (key.toUpperCase() === normalized)
+                return group;
+        }
+    }
+    catch (e_6_1) { e_6 = { error: e_6_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_6) throw e_6.error; }
+    }
+    return undefined;
+}
+/**
+ * Returns whether an entity's layer is locked or frozen (not selectable with group).
+ */
+function isMemberSelectable(db, entityId) {
+    var entity = db.tables.blockTable.getEntityById(entityId);
+    if (!entity)
+        return false;
+    if (isEntityOnLockedLayer(db, entity))
+        return false;
+    var layer = db.tables.layerTable.getAt(entity.layer);
+    if ((layer === null || layer === void 0 ? void 0 : layer.isFrozen) || (layer === null || layer === void 0 ? void 0 : layer.isOff))
+        return false;
+    return true;
+}
+/**
+ * Expands picked entity ids by selectable groups when group selection is on.
+ *
+ * When an object belongs to multiple selectable groups, all of those groups'
+ * members are included. Locked / frozen / off-layer members are skipped.
+ */
+export function acapExpandSelectionByGroups(db, ids) {
+    var e_7, _a, e_8, _b, e_9, _c;
+    if (!acapIsGroupSelectionEnabled(db) || ids.length === 0) {
+        return __spreadArray([], __read(ids), false);
+    }
+    var out = new Set();
+    try {
+        for (var ids_1 = __values(ids), ids_1_1 = ids_1.next(); !ids_1_1.done; ids_1_1 = ids_1.next()) {
+            var id = ids_1_1.value;
+            out.add(id);
+            var groups = acapFindGroupsContaining(db, id);
+            try {
+                for (var groups_1 = (e_8 = void 0, __values(groups)), groups_1_1 = groups_1.next(); !groups_1_1.done; groups_1_1 = groups_1.next()) {
+                    var group = groups_1_1.value;
+                    if (!group.selectable)
+                        continue;
+                    try {
+                        for (var _d = (e_9 = void 0, __values(group.entityIds)), _e = _d.next(); !_e.done; _e = _d.next()) {
+                            var memberId = _e.value;
+                            if (isMemberSelectable(db, memberId))
+                                out.add(memberId);
+                        }
+                    }
+                    catch (e_9_1) { e_9 = { error: e_9_1 }; }
+                    finally {
+                        try {
+                            if (_e && !_e.done && (_c = _d.return)) _c.call(_d);
+                        }
+                        finally { if (e_9) throw e_9.error; }
+                    }
+                }
+            }
+            catch (e_8_1) { e_8 = { error: e_8_1 }; }
+            finally {
+                try {
+                    if (groups_1_1 && !groups_1_1.done && (_b = groups_1.return)) _b.call(groups_1);
+                }
+                finally { if (e_8) throw e_8.error; }
+            }
+        }
+    }
+    catch (e_7_1) { e_7 = { error: e_7_1 }; }
+    finally {
+        try {
+            if (ids_1_1 && !ids_1_1.done && (_a = ids_1.return)) _a.call(ids_1);
+        }
+        finally { if (e_7) throw e_7.error; }
+    }
+    return __spreadArray([], __read(out), false);
+}
+/**
+ * Thrown by {@link acapCreateGroup} for invalid or colliding names.
+ */
+var AcApGroupCreateError = /** @class */ (function (_super) {
+    __extends(AcApGroupCreateError, _super);
+    function AcApGroupCreateError(code) {
+        var _this = _super.call(this, code) || this;
+        _this.name = 'AcApGroupCreateError';
+        _this.code = code;
+        return _this;
+    }
+    return AcApGroupCreateError;
+}(Error));
+export { AcApGroupCreateError };
+/**
+ * Creates a group, adds it to `ACAD_GROUP`, and appends members.
+ */
+export function acapCreateGroup(db, options) {
+    var _a, _b;
+    var unnamed = options.unnamed === true || !options.name;
+    var name;
+    if (unnamed) {
+        name = acapNextAnonymousGroupName(db);
+    }
+    else {
+        var validated = acapValidateGroupName((_a = options.name) !== null && _a !== void 0 ? _a : '');
+        if (!validated) {
+            throw new AcApGroupCreateError('invalidName');
+        }
+        if (db.objects.group.getAt(validated)) {
+            throw new AcApGroupCreateError('nameExists');
+        }
+        name = validated;
+    }
+    var description = String((_b = options.description) !== null && _b !== void 0 ? _b : '').slice(0, ACAP_GROUP_DESCRIPTION_MAX_LENGTH);
+    var selectable = options.selectable !== false;
+    var group = new AcDbGroup(description, selectable);
+    if (unnamed)
+        group.setAnonymous();
+    group.name = name;
+    group.database = db;
+    db.objects.group.setAt(name, group);
+    group.append(__spreadArray([], __read(options.entityIds), false));
+    return group;
+}
+/**
+ * Removes a group definition from the dictionary (entities remain).
+ */
+export function acapExplodeGroup(db, group) {
+    var name = group.name;
+    if (!name)
+        return;
+    db.objects.group.remove(name);
+}
+/**
+ * Explodes every group in the drawing.
+ */
+export function acapExplodeAllGroups(db) {
+    var e_10, _a;
+    var names = __spreadArray([], __read(db.objects.group.entries()), false).map(function (_a) {
+        var _b = __read(_a, 1), key = _b[0];
+        return key;
+    });
+    try {
+        for (var names_1 = __values(names), names_1_1 = names_1.next(); !names_1_1.done; names_1_1 = names_1.next()) {
+            var name_1 = names_1_1.value;
+            db.objects.group.remove(name_1);
+        }
+    }
+    catch (e_10_1) { e_10 = { error: e_10_1 }; }
+    finally {
+        try {
+            if (names_1_1 && !names_1_1.done && (_a = names_1.return)) _a.call(names_1);
+        }
+        finally { if (e_10) throw e_10.error; }
+    }
+    return names.length;
+}
+/**
+ * Reads `GROUPDISPLAYMODE` (0–2); defaults to `2`.
+ */
+export function acapGetGroupDisplayMode(database) {
+    var raw = AcDbSysVarManager.instance().getVar(AcDbSystemVariables.GROUPDISPLAYMODE, database);
+    var value = typeof raw === 'number' ? raw : Number(raw);
+    if (!Number.isFinite(value))
+        return 2;
+    var truncated = Math.trunc(value);
+    if (truncated < 0 || truncated > 2)
+        return 2;
+    return truncated;
+}
+//# sourceMappingURL=AcApGroup.js.map

package/lib/service/AcApGroup.js.map

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

package/lib/service/AcApLlmSettingsService.d.ts

@@ -0,0 +1,74 @@
+/**
+ * What the configured AI models can do, as reported by an
+ * {@link AcApLlmSettingsProvider}.
+ */
+export interface AcApLlmStatus {
+    /** True when at least one provider has an API key. */
+    configured: boolean;
+    /**
+     * True when a configured model accepts image input, which features such as
+     * text recognition (OCR) need.
+     */
+    vision: boolean;
+}
+/**
+ * Options for {@link AcApLlmSettingsService.open}.
+ */
+export interface AcApLlmSettingsOpenOptions {
+    /**
+     * Element that receives the dialog backdrop. Defaults to the provider's
+     * choice, typically the canvas container.
+     */
+    host?: HTMLElement;
+}
+/**
+ * Owner of the AI model settings, typically `@mlightcad/cad-llm-plugin`.
+ */
+export interface AcApLlmSettingsProvider {
+    /** Unique id, e.g. `'cad-llm'`. */
+    id: string;
+    /**
+     * Opens the settings UI.
+     *
+     * @returns A promise that resolves when the UI is closed.
+     */
+    open(options?: AcApLlmSettingsOpenOptions): Promise<void>;
+    /** Reports whether a model is configured and whether one accepts images. */
+    getStatus(): Promise<AcApLlmStatus>;
+}
+/**
+ * Registry for the AI model settings UI.
+ *
+ * Lets any feature that relies on an LLM (the CAD agent, PDF text
+ * recognition, ...) send the user to the one shared settings dialog, or check
+ * whether a model is configured, without depending on the package that
+ * implements it. Only the last registered provider is used.
+ */
+export declare class AcApLlmSettingsService {
+    private static provider?;
+    /**
+     * Registers (or replaces) the settings provider.
+     *
+     * @returns A function that unregisters it.
+     */
+    static register(provider: AcApLlmSettingsProvider): () => void;
+    /** Removes the provider with `id`. */
+    static unregister(id: string): void;
+    /** True when a settings provider is registered. */
+    static get isAvailable(): boolean;
+    /**
+     * Opens the settings UI.
+     *
+     * @returns `true` once the UI was shown and closed again, `false` when no
+     *   provider is registered.
+     */
+    static open(options?: AcApLlmSettingsOpenOptions): Promise<boolean>;
+    /**
+     * Reports the configured models' capabilities.
+     *
+     * @returns The status, or `undefined` when no provider is registered or it
+     *   failed to answer.
+     */
+    static getStatus(): Promise<AcApLlmStatus | undefined>;
+}
+//# sourceMappingURL=AcApLlmSettingsService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcApLlmSettingsService.d.ts","sourceRoot":"","sources":["../../src/service/AcApLlmSettingsService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;IACV;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,4EAA4E;IAC5E,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAyB;IAEjD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;IAO9D,sCAAsC;IACtC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAInC,mDAAmD;IACnD,MAAM,KAAK,WAAW,IAAI,OAAO,CAEhC;IAED;;;;;OAKG;WACU,IAAI,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzE;;;;;OAKG;WACU,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;CAQ7D"}

package/lib/service/AcApLlmSettingsService.js

@@ -0,0 +1,126 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+/**
+ * Registry for the AI model settings UI.
+ *
+ * Lets any feature that relies on an LLM (the CAD agent, PDF text
+ * recognition, ...) send the user to the one shared settings dialog, or check
+ * whether a model is configured, without depending on the package that
+ * implements it. Only the last registered provider is used.
+ */
+var AcApLlmSettingsService = /** @class */ (function () {
+    function AcApLlmSettingsService() {
+    }
+    /**
+     * Registers (or replaces) the settings provider.
+     *
+     * @returns A function that unregisters it.
+     */
+    AcApLlmSettingsService.register = function (provider) {
+        var _this = this;
+        this.provider = provider;
+        return function () {
+            if (_this.provider === provider)
+                _this.provider = undefined;
+        };
+    };
+    /** Removes the provider with `id`. */
+    AcApLlmSettingsService.unregister = function (id) {
+        var _a;
+        if (((_a = this.provider) === null || _a === void 0 ? void 0 : _a.id) === id)
+            this.provider = undefined;
+    };
+    Object.defineProperty(AcApLlmSettingsService, "isAvailable", {
+        /** True when a settings provider is registered. */
+        get: function () {
+            return this.provider !== undefined;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    /**
+     * Opens the settings UI.
+     *
+     * @returns `true` once the UI was shown and closed again, `false` when no
+     *   provider is registered.
+     */
+    AcApLlmSettingsService.open = function (options) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        if (!this.provider)
+                            return [2 /*return*/, false];
+                        return [4 /*yield*/, this.provider.open(options)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/, true];
+                }
+            });
+        });
+    };
+    /**
+     * Reports the configured models' capabilities.
+     *
+     * @returns The status, or `undefined` when no provider is registered or it
+     *   failed to answer.
+     */
+    AcApLlmSettingsService.getStatus = function () {
+        return __awaiter(this, void 0, void 0, function () {
+            var _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        if (!this.provider)
+                            return [2 /*return*/, undefined];
+                        _b.label = 1;
+                    case 1:
+                        _b.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.provider.getStatus()];
+                    case 2: return [2 /*return*/, _b.sent()];
+                    case 3:
+                        _a = _b.sent();
+                        return [2 /*return*/, undefined];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
+    return AcApLlmSettingsService;
+}());
+export { AcApLlmSettingsService };
+//# sourceMappingURL=AcApLlmSettingsService.js.map

package/lib/service/AcApLlmSettingsService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcApLlmSettingsService.js","sourceRoot":"","sources":["../../src/service/AcApLlmSettingsService.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyCA;;;;;;;GAOG;AACH;IAAA;IAmDA,CAAC;IAhDC;;;;OAIG;IACI,+BAAQ,GAAf,UAAgB,QAAiC;QAAjD,iBAKC;QAJC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,OAAO;YACL,IAAI,KAAI,CAAC,QAAQ,KAAK,QAAQ;gBAAE,KAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;QAC3D,CAAC,CAAA;IACH,CAAC;IAED,sCAAsC;IAC/B,iCAAU,GAAjB,UAAkB,EAAU;;QAC1B,IAAI,CAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,EAAE,MAAK,EAAE;YAAE,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAA;IACzD,CAAC;IAGD,sBAAW,qCAAW;QADtB,mDAAmD;aACnD;YACE,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAA;QACpC,CAAC;;;OAAA;IAED;;;;;OAKG;IACU,2BAAI,GAAjB,UAAkB,OAAoC;;;;;wBACpD,IAAI,CAAC,IAAI,CAAC,QAAQ;4BAAE,sBAAO,KAAK,EAAA;wBAChC,qBAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAA;;wBAAjC,SAAiC,CAAA;wBACjC,sBAAO,IAAI,EAAA;;;;KACZ;IAED;;;;;OAKG;IACU,gCAAS,GAAtB;;;;;;wBACE,IAAI,CAAC,IAAI,CAAC,QAAQ;4BAAE,sBAAO,SAAS,EAAA;;;;wBAE3B,qBAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAA;4BAAtC,sBAAO,SAA+B,EAAA;;;wBAEtC,sBAAO,SAAS,EAAA;;;;;KAEnB;IACH,6BAAC;AAAD,CAAC,AAnDD,IAmDC"}