@lapis-notes/api 0.1.0 → 0.1.3

package/dist/plugin.js

@@ -1,4 +1,5 @@
 import { matchesProjectionSource } from "./storage/index-projection";
+import { resolveWorkspaceHostBinding } from "./workspace-host-internal";
 import { dirname, joinPath } from "./storage";
 import { Component } from "./view.svelte";
 function isPromiseLike(value) {
@@ -48,6 +49,10 @@ export class Plugin extends Component {
     #registeredViewTypes = new Set();
     #requestedCapabilities = [];
     #grantedCapabilities = [];
+    #runtimeConfigured = false;
+    #syncHostCapabilities = null;
+    #createSyncHostCapabilities = null;
+    #revokeSyncHostCapabilities = null;
     constructor(app, manifest) {
         super();
         this.app = app;
@@ -66,6 +71,7 @@ export class Plugin extends Component {
      * @public
      */
     configureRuntime(options = {}) {
+        this.#runtimeConfigured = true;
         if (options.basePath !== undefined) {
             this.basePath = options.basePath;
         }
@@ -88,6 +94,12 @@ export class Plugin extends Component {
         if (options.grantedCapabilities !== undefined) {
             this.#grantedCapabilities = [...options.grantedCapabilities];
         }
+        if (options.createSyncHostCapabilities !== undefined) {
+            this.#createSyncHostCapabilities = options.createSyncHostCapabilities;
+        }
+        if (options.revokeSyncHostCapabilities !== undefined) {
+            this.#revokeSyncHostCapabilities = options.revokeSyncHostCapabilities;
+        }
     }
     /**
      * Enable the plugin and run its `onload()` lifecycle.
@@ -161,6 +173,13 @@ export class Plugin extends Component {
     get id() {
         return this.manifest.id;
     }
+    /** Host-authenticated durable capabilities for sync and similar plugins. */
+    get syncHost() {
+        if (!this.#createSyncHostCapabilities) {
+            throw new Error(`Plugin ${this.id} has no host capability runtime`);
+        }
+        return (this.#syncHostCapabilities ??= this.#createSyncHostCapabilities());
+    }
     getDataPath() {
         return resolvePluginDataPath(this.manifest.id, this.source, this.basePath);
     }
@@ -217,6 +236,8 @@ export class Plugin extends Component {
     }
     async disable() {
         if (!this.loaded) {
+            this.#revokeSyncHostCapabilities?.();
+            this.#syncHostCapabilities = null;
             this.#runtimeState = "disabled";
             this.#failureMessage = null;
             return;
@@ -224,6 +245,8 @@ export class Plugin extends Component {
         this.#runtimeState = "disabling";
         try {
             await this.unloadAsync();
+            this.#revokeSyncHostCapabilities?.();
+            this.#syncHostCapabilities = null;
             this.#runtimeState = "disabled";
             this.#failureMessage = null;
             this.emit("disable");
@@ -740,6 +763,39 @@ export class Plugin extends Component {
             setting.removeItem(settingTab.plugin.manifest.id);
         });
     }
+    /**
+     * Register one controlled declarative settings definition with Workspace
+     * Settings. Source-backed values remain owned by the plugin.
+     *
+     * @public
+     */
+    registerSettingsSection(definition) {
+        if (this.source === "community" && !this.app.workspaceTrust.trusted) {
+            throw new Error(`Plugin ${this.manifest.id} cannot register settings while the workspace is untrusted`);
+        }
+        const binding = resolveWorkspaceHostBinding(this.app.workspace);
+        if (!binding) {
+            throw new Error("Workspace host binding is not initialized");
+        }
+        const unregister = binding.controller.settings.registerDefinition(definition);
+        let disposed = false;
+        const registration = {
+            definition,
+            open: (fieldId) => !disposed &&
+                binding.controller.settings.open({
+                    sectionId: definition.section.id,
+                    fieldId,
+                }),
+            dispose: () => {
+                if (disposed)
+                    return;
+                disposed = true;
+                unregister();
+            },
+        };
+        this.register(() => registration.dispose());
+        return registration;
+    }
 }
 function defaultPluginProvenance(source) {
     switch (source) {