@lapis-notes/api 0.1.4 → 0.2.0

package/dist/workspace-close-guard.js

@@ -0,0 +1,35 @@
+import { tick } from "svelte";
+/** Keep the App's persistence barrier held through destructive shell changes. */
+export function workspaceCloseGuard(workspace, hostDocuments = () => []) {
+    return async (ids, remove) => {
+        const targets = ids.map((id) => {
+            const leaf = workspace.getLeafById(id);
+            const view = leaf?.view;
+            return { id, leaf, view, scope: view?.getClosePersistenceScope?.() };
+        });
+        const documents = new Set(ids.map((id) => workspace.getCommandHostDocument(workspace.getCommandHostIdForLeaf(workspace.getLeafById(id)))));
+        for (const doc of hostDocuments())
+            documents.add(doc);
+        for (const doc of documents) {
+            const active = doc?.activeElement;
+            active?.blur?.();
+        }
+        await tick();
+        const registry = workspace.app.fileEditingSessions;
+        await registry.settleOperations();
+        await workspace.flushLayout();
+        const layoutOnly = targets.length > 0 &&
+            targets.every(({ id, leaf, view, scope }) => scope === "layout" &&
+                leaf &&
+                workspace.getLeafById(id) === leaf &&
+                leaf.view === view &&
+                view?.getClosePersistenceScope?.() === "layout");
+        if (layoutOnly) {
+            remove();
+            return;
+        }
+        await registry.guard(undefined, async () => {
+            remove();
+        });
+    };
+}

package/dist/workspace-host-internal.js

@@ -1,7 +1,15 @@
+const HOST_BINDING = Symbol.for("lapis.workspaceHostBinding");
 const workspaceHostBindings = new WeakMap();
 export function setWorkspaceHostBinding(workspace, binding) {
-    workspaceHostBindings.set(workspace, Object.freeze(binding));
+    const frozen = Object.freeze(binding);
+    workspaceHostBindings.set(workspace, frozen);
+    Object.defineProperty(workspace, HOST_BINDING, {
+        configurable: true,
+        enumerable: false,
+        value: frozen,
+    });
 }
 export function resolveWorkspaceHostBinding(workspace) {
-    return workspaceHostBindings.get(workspace);
+    return (workspaceHostBindings.get(workspace) ??
+        workspace[HOST_BINDING]);
 }

package/dist/workspace-layout-normalizer.d.ts

@@ -62,7 +62,7 @@ type WorkspaceBottomPanelJson = WorkspaceTabsJson & {
 type WorkspaceWindowJson = {
     id: string;
     type: "floating";
-    mode?: "floating";
+    mode?: "floating" | "popout";
     displayState?: "collapsed" | "minimized";
     direction: "horizontal" | "vertical";
     sizes: number[];
@@ -88,5 +88,7 @@ export type WorkspaceJson = {
  * Always returns a structurally valid {@link WorkspaceJson} even when the input
  * is `null`, empty, partial, or corrupted.
  */
-export declare function normalizeWorkspaceJson(raw: unknown): WorkspaceJson;
+export declare function normalizeWorkspaceJson(raw: unknown, options?: {
+    preservePopouts?: boolean;
+}): WorkspaceJson;
 export {};

package/dist/workspace-layout-normalizer.js

@@ -226,14 +226,14 @@ function normalizeBottomPanel(raw) {
             : "0px",
     };
 }
-function normalizeFloatingWindow(raw) {
+function normalizeFloatingWindow(raw, preservePopouts = false) {
     if (!raw || typeof raw !== "object")
         return null;
     const r = raw;
     if (r.type !== "floating")
         return null;
     // Popout windows cannot be restored across sessions — drop them.
-    if (r.mode === "popout")
+    if (r.mode === "popout" && !preservePopouts)
         return null;
     const children = (Array.isArray(r.children) ? r.children : [])
         .map(normalizeSplitChild)
@@ -249,7 +249,7 @@ function normalizeFloatingWindow(raw) {
     return {
         id: ensureId(r.id),
         type: "floating",
-        mode: "floating",
+        mode: r.mode === "popout" ? "popout" : "floating",
         ...(displayState !== undefined ? { displayState } : {}),
         direction: ensureDirection(r.direction),
         sizes: repairSizes(r.sizes, children.length),
@@ -283,11 +283,11 @@ function hasAnyLeaf(nodes) {
  * Always returns a structurally valid {@link WorkspaceJson} even when the input
  * is `null`, empty, partial, or corrupted.
  */
-export function normalizeWorkspaceJson(raw) {
+export function normalizeWorkspaceJson(raw, options = {}) {
     const r = raw && typeof raw === "object" ? raw : {};
     const floating = Array.isArray(r.floating)
         ? r.floating
-            .map(normalizeFloatingWindow)
+            .map((window) => normalizeFloatingWindow(window, options.preservePopouts))
             .filter((w) => w !== null)
         : [];
     return {

package/dist/workspace-view-document.d.ts

@@ -0,0 +1,3 @@
+import type { WorkspaceLeaf } from "./workspace.svelte";
+/** Retarget a retained editor's DOM services when its view changes document. */
+export declare function attachWorkspaceView(target: HTMLElement, leaf: WorkspaceLeaf): void;

package/dist/workspace-view-document.js

@@ -0,0 +1,12 @@
+/** Retarget a retained editor's DOM services when its view changes document. */
+export function attachWorkspaceView(target, leaf) {
+    target.replaceChildren(leaf.containerEl);
+    const editor = leaf.view.editor;
+    const node = target.getRootNode();
+    const root = node.nodeType === 9 || node.nodeType === 11
+        ? node
+        : target.ownerDocument;
+    if (editor?.view && editor.view.root !== root) {
+        editor.view.setRoot(root);
+    }
+}

package/dist/workspace.svelte.d.ts

@@ -7,7 +7,8 @@ import { SidebarState, type SidebarStateProps } from "@lapis-notes/ui/sidebar-cu
 import { HistoryManager } from "./history.svelte";
 import type { TransactionSpec } from "@codemirror/state";
 import type { App } from "./context.svelte";
-import { EditorViewRegistry, type EditorViewContribution, type RegisteredEditorViewContribution } from "./editor-view-registry";
+import type { DiagnosticLocation, DiagnosticsManager } from "./diagnostics";
+import { EditorViewRegistry, type EditorViewContribution, type ExtensionRegistrationOptions, type RegisteredEditorViewContribution } from "./editor-view-registry";
 /** @public */
 export type Constructor<T> = abstract new (...args: any[]) => T;
 /**
@@ -472,6 +473,10 @@ export declare class Workspace extends EventDispatcher<{
     containerEl: HTMLElement;
     private saveLayoutDebounced;
     requestSaveLayout(event?: WorkspaceLayoutChangeEvent): void;
+    /** Await serialized layout persistence before the owning host tears down. */
+    flushLayout(): Promise<void>;
+    /** Await admitted App Shell plugin transitions and their persistence. */
+    flushPluginChanges(): Promise<void>;
     private withoutLayoutPersistence;
     private dispatchLayoutDropEvent;
     willShowLayoutDropOverlay(options: Omit<WorkspaceLayoutDropEvent, "defaultPrevented" | "preventDefault">): WorkspaceLayoutDropEvent;
@@ -533,6 +538,9 @@ export declare class Workspace extends EventDispatcher<{
     bindConfiguration(): void;
     /** Dispose the API-owned shell controller and its compatibility bridges. */
     disposeWorkspaceHost(): Promise<void>;
+    readonly diagnostics: DiagnosticsManager;
+    /** Register an owned opener for application-specific diagnostic resources. */
+    registerDiagnosticOpener(opener: (location: DiagnosticLocation) => boolean | Promise<boolean>): () => void;
     getMostRecentLeaf(): WorkspaceLeaf | null;
     getVisibleHintTargets(): WorkspaceHintTarget[];
     changeLayout(workspace: WorkspaceJson | any): Promise<void>;
@@ -571,7 +579,9 @@ export declare class Workspace extends EventDispatcher<{
         view?: RegisteredEditorViewContribution;
     } | undefined;
     private resolveEditorAssociationViewType;
-    registerExtensions(extensions: string[], viewType: string): void;
+    getFileIconForPath(path: string): string | undefined;
+    onFileIconsChanged(listener: () => void): () => void;
+    registerExtensions(extensions: string[], viewType: string, options?: ExtensionRegistrationOptions): () => void;
     unregisterExtensions(extensions: string[], viewType: string): void;
     determineViewType(type: string): string | undefined;
     determineViewTypeForPath(path: string): string | undefined;
@@ -607,6 +617,7 @@ export declare class Workspace extends EventDispatcher<{
      * @public
      */
     getActiveFile(): TFile | null;
+    reconcileFileReference(oldPath: string, file: TFile | null): void;
     /**
      * Iterate through all leaves, including main area leaves, floating leaves,
      * and sidebar leaves.