@lapis-notes/api 0.1.0 → 0.1.3

package/dist/context.svelte.d.ts

@@ -30,6 +30,8 @@ import { DailyDocumentProviderRegistry } from "./daily-document-provider";
 import { AppToolRegistry } from "./agent-tools";
 import { MarkdownExtensionRegistry } from "./markdown-extension-registry";
 import { MarkdownFileSurfaceRegistry } from "./markdown-file-surface-registry";
+import { NostrSignerHost, type NostrSignerBroker } from "./nostr-signer";
+import { SyncHostService, type SyncHostServiceOptions } from "./sync-host";
 export interface AppWorkspaceShellApplicationProperties {
     /** Application name shown by the shell's About surface. */
     name?: string;
@@ -60,9 +62,14 @@ export type AppStateProperties = {
     createCommunityPluginDependencyResolver?: PluginDependencyResolverFactory;
     pluginAssetServer?: PluginAssetServer;
     pluginDistributionOptions?: AppPluginDistributionOptions;
+    /** Host-owned Nostr account, keychain, and remote-signer implementation. */
+    nostrSignerBroker?: NostrSignerBroker;
+    syncHost?: SyncHostServiceOptions;
     workspaceShell?: AppWorkspaceShellProperties;
     markdownRenderer: (markdown: string, el: HTMLElement, sourcePath: string, component: Component) => Promise<void>;
 };
+/** Renderer-safe application properties exposed to plugins and views. */
+export type AppPublicProperties = Pick<AppStateProperties, "version" | "configPath" | "workspaceShell" | "markdownRenderer">;
 export type AppPluginDistributionOptions = Omit<DefaultPluginDistributionManagerOptions, "adapter" | "appVersion" | "platform" | "workspaceTrusted" | "pluginManager">;
 export type ExtType = Extension | ((context: Record<string, any>) => Extension);
 /**
@@ -146,7 +153,7 @@ export declare class SecretStorage {
  * @public
  */
 export declare class App {
-    readonly props: AppStateProperties;
+    readonly props: AppPublicProperties;
     readonly i18n: LocalizationManager;
     readonly workspace: Workspace;
     readonly vault: Vault;
@@ -166,6 +173,7 @@ export declare class App {
     readonly urls: AppUrlService;
     readonly workspaceTrust: WorkspaceTrustService;
     readonly pluginDistribution: DefaultPluginDistributionManager;
+    readonly nostr: NostrSignerHost;
     mardownPostProcessor: Array<MarkdownPostProcessor>;
     mardownCodeBlockPostProcessor: Record<string, Array<MarkdownPostProcessor>>;
     markdownDirectiveRenderers: Record<string, MarkdownDirectiveRenderer>;
@@ -239,6 +247,8 @@ export declare class App {
     setting(id: "options" | "core-plugins" | "community-plugins"): import("./settings.svelte").SettingGroup;
 }
 export type AppState = App;
+/** Transfer the mounting host's sync controller exactly once. */
+export declare function takeHostSyncService(app: App): SyncHostService;
 declare global {
     var app: App;
 }

package/dist/context.svelte.js

@@ -21,6 +21,7 @@ import { bindRuntimePluginDiagnostics } from "./diagnostics";
 import { ContextKeyService } from "./context-keys.svelte";
 import { StatusBarManager } from "./status-bar.svelte";
 import { AppUrlService } from "./app-url";
+import { NostrSignerHost } from "./nostr-signer";
 import { WorkspaceTrustService } from "./workspace-trust";
 import { DefaultPluginDistributionManager, } from "./plugin-distribution";
 import { ConfigurationOptionSourceRegistry } from "./configuration-option-source-registry";
@@ -32,8 +33,21 @@ import { AppSkillRegistry, AppSlashCommandRegistry, } from "./agent-skills";
 import { AppResultViewRegistry } from "./agent-result-views";
 import { MarkdownExtensionRegistry } from "./markdown-extension-registry";
 import { MarkdownFileSurfaceRegistry } from "./markdown-file-surface-registry";
+import { SyncHostService, } from "./sync-host";
 import { installApplicationCompatibility, resolveApplication, } from "./application-compatibility";
 import { provideApplicationState, useApplicationState, } from "./application-state.svelte";
+const hostSyncServices = new WeakMap();
+/**
+ * Transfer the host-only sync controller to the mounting host exactly once.
+ * Plugins receive only their scoped capability facade through Plugin.syncHost.
+ */
+export function takeHostSyncService(app) {
+    const service = hostSyncServices.get(app);
+    if (!service)
+        throw new Error("The host sync controller is unavailable");
+    hostSyncServices.delete(app);
+    return service;
+}
 export { getApplicationCompatibility, installApplicationCompatibility, resolveApplication, } from "./application-compatibility";
 export { provideApplicationState, useApplicationState, } from "./application-state.svelte";
 /**
@@ -131,6 +145,8 @@ export class App {
     urls = new AppUrlService(this);
     workspaceTrust;
     pluginDistribution;
+    nostr;
+    #syncHost;
     mardownPostProcessor = $state([]);
     mardownCodeBlockPostProcessor = $state({});
     markdownDirectiveRenderers = $state({});
@@ -174,7 +190,13 @@ export class App {
      * @public
      */
     constructor(props) {
-        this.props = props;
+        this.props = Object.freeze({
+            version: props.version,
+            configPath: props.configPath,
+            workspaceShell: props.workspaceShell,
+            markdownRenderer: props.markdownRenderer,
+        });
+        this.nostr = new NostrSignerHost(props.nostrSignerBroker);
         const adapter = props.session?.vaultAdapter ?? props.adapter;
         if (!adapter) {
             throw new Error("App requires a vault adapter or vault session");
@@ -207,6 +229,19 @@ export class App {
         this.configuration = new Configuration(this, props.configPath);
         this.workspace.bindConfiguration();
         this.vault = new Vault(adapter);
+        this.#syncHost = new SyncHostService(this.appDatabase, this.vault, Date.now, {
+            ...props.syncHost,
+            flushOpenEditor: async (path) => {
+                const active = this.workspace.activeEditor;
+                if (!active?.editor || !active.file)
+                    return { flushed: false, path };
+                if (path && active.file.path !== path)
+                    return { flushed: false, path };
+                await active.editor.flushChanges();
+                return { flushed: true, path: active.file.path };
+            },
+        });
+        hostSyncServices.set(this, this.#syncHost);
         this.workspaceTrust = new WorkspaceTrustService(adapter);
         this.metadataCache = new MetadataCache(this);
         installVaultMaintenanceCommands(this);
@@ -216,6 +251,8 @@ export class App {
                 : undefined,
             createCommunityPluginDependencyResolver: props.createCommunityPluginDependencyResolver,
             pluginAssetServer: props.pluginAssetServer,
+            createSyncHostCapabilities: (pluginId, grants) => this.#syncHost.forPlugin(pluginId, grants),
+            revokeSyncHostCapabilities: (pluginId) => this.#syncHost.revokePlugin(pluginId),
         });
         this.workspace.bindPlugins();
         const languageServiceDiagnostics = this.workspace.diagnostics.createCollection("lapis:language-service", {

package/dist/docs-api.d.ts

@@ -10,6 +10,8 @@ export type { AppSafeModeFailure, AppSafeModeState, AppStateProperties, } from "
 export { getApplicationCompatibility, installApplicationCompatibility, resolveApplication, } from "./application-compatibility";
 export { provideApplicationState, useApplicationState, } from "./application-state.svelte";
 export { Plugin, resolvePluginDataPath } from "./plugin";
+export { DeclarativePluginSettingTab } from "./plugin-settings";
+export type { PluginSettingsDefinition, PluginSettingsRegistration, WorkspaceCustomFieldAdapter, WorkspaceCustomSetting, WorkspaceCustomSettingProps, WorkspaceObjectCollectionSetting, WorkspaceObjectProperty, WorkspaceObjectRowAction, WorkspaceOutputSetting, WorkspaceSettingField, WorkspaceSettingsSection, WorkspaceSettingsSource, } from "./plugin-settings";
 export type { PluginManifest, PluginRuntimeOptions, PluginSource, } from "./plugin";
 export type { LapisExtensionContributions, LapisExtensionKind, LapisExtensionManifest, LapisExtensionPermission, LapisExtensionRuntimeHost, LapisPluginClassification, } from "./lapis-extension";
 export { PluginManager } from "./plugin-manager";

package/dist/docs-api.js

@@ -9,6 +9,7 @@ export { App, createDefaultAppSafeModeState, RenderContext, SecretStorage, } fro
 export { getApplicationCompatibility, installApplicationCompatibility, resolveApplication, } from "./application-compatibility";
 export { provideApplicationState, useApplicationState, } from "./application-state.svelte";
 export { Plugin, resolvePluginDataPath } from "./plugin";
+export { DeclarativePluginSettingTab } from "./plugin-settings";
 export { PluginManager } from "./plugin-manager";
 export { AppUrlService } from "./app-url";
 export { FileManager } from "./file-manager";