@lapis-notes/file-explorer 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -1,12 +1,127 @@
 # @lapis-notes/file-explorer
 
+## 0.2.0
+
+### Minor Changes
+
+- [`55be8dc`](https://github.com/lapismd/lapis-notes/commit/55be8dce6f7b19b0e8036be86a3cf5305db25317)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Let file-view plugins
+  contribute a fileIcon ID for their filename patterns or registered extensions.
+  Add App-owned SVG and icon-pack registration with plugin lifecycle cleanup,
+  preserve legacy icon registrations, and refresh Explorer artwork on editor,
+  plugin and file changes.
+
+  Release the scoped Design Core resolver first and raise the dependent minimum
+  ranges to the releases containing these contracts before publishing consumers.
+
+  Upgrade API-owned Zod to the patched package while retaining its public v3
+  schema entry for compatibility.
+
+### Patch Changes
+
+- [`fbba8d4`](https://github.com/lapismd/lapis-notes/commit/fbba8d48498c34939fec475e6bed67a682045820)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Retain plugin-state and
+  compatibility-file drafts through close and conflict recovery, drain admitted
+  plugin/file operations before teardown, and preserve Properties mutations
+  after initial read failures.
+
+- [`d8946b9`](https://github.com/lapismd/lapis-notes/commit/d8946b941569484b813eb0c1e8b1c5729fffc1a7)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Add owned
+  diagnostic-resource navigation and themed recovery-banner actions. Accept
+  Design Core 0.5.1 alongside the existing 0.4 range.
+
+- [`023259d`](https://github.com/lapismd/lapis-notes/commit/023259d96d4ff0414fec6427924ed917f89405a3)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Add an optional exclusive
+  file-creation transport and route Explorer new-note actions through the
+  FileManager creation intent. Preserve existing destinations on collisions and
+  keep legacy Vault creation semantics explicit.
+
+- [`717f0ff`](https://github.com/lapismd/lapis-notes/commit/717f0ff3956a5d33cba10311fca9c41a06e53b21)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Connect the existing
+  Explorer file-drop surface to FileManager new-file creation. Preserve binary
+  bytes and existing destinations, validate bounded input before reading it, and
+  retain App admission through asynchronous import and projection.
+
+- Require released Design Core 0.6 for the close-guard, plugin-flush and
+  centered panel contracts used by current source. Retain portable registry
+  dependency ranges for the shared application runtime.
+
+- [`bac3e5e`](https://github.com/lapismd/lapis-notes/commit/bac3e5eda6f467dbc86ec88c9f27a275f2b27953)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Expose optional
+  implemented system trash through the neutral native adapter with explicit
+  unsupported fallback and validated acknowledgements. Attribute Explorer
+  native/copy feedback to its owning App and reject unavailable clipboard
+  support without reporting success.
+
+- [`501c50e`](https://github.com/lapismd/lapis-notes/commit/501c50e049264560e13e29c75a74c089922c7297)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Project owned App notices
+  through the existing workspace notification UI and retire their subscription
+  on host disposal. Pass the explicit Explorer App when reporting file-action
+  failures.
+
+- [`98b333f`](https://github.com/lapismd/lapis-notes/commit/98b333f73ff5ba8d5f28c52e4e3a2ceaa5ade0fb)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Protect and flush
+  registered file writers before FileManager trash or deletion, including folder
+  descendants. Route Explorer deletion through that guard so failed writes
+  retain the file and dirty draft until explicit recovery.
+- Updated dependencies
+  [[`bdd4923`](https://github.com/lapismd/lapis-notes/commit/bdd492357135de2cc0175fa42413709b2a38cd63),
+  [`86e85f6`](https://github.com/lapismd/lapis-notes/commit/86e85f6e814430c1755147c913eb91090a439bf4),
+  [`631aeec`](https://github.com/lapismd/lapis-notes/commit/631aeec539e2fb061dc80c5c3a30a248ee15c529),
+  [`fdee7e4`](https://github.com/lapismd/lapis-notes/commit/fdee7e4defde17a1009e16138d78c93c3ead8e2f),
+  [`a91d5e2`](https://github.com/lapismd/lapis-notes/commit/a91d5e2eb5ec037029f6a7a2df316a9bd9440af7),
+  [`fbba8d4`](https://github.com/lapismd/lapis-notes/commit/fbba8d48498c34939fec475e6bed67a682045820),
+  [`d8946b9`](https://github.com/lapismd/lapis-notes/commit/d8946b941569484b813eb0c1e8b1c5729fffc1a7),
+  [`ebf033a`](https://github.com/lapismd/lapis-notes/commit/ebf033af0fc0752be5ce5ffa7d55784163d291b4),
+  [`023259d`](https://github.com/lapismd/lapis-notes/commit/023259d96d4ff0414fec6427924ed917f89405a3),
+  [`63a5e7f`](https://github.com/lapismd/lapis-notes/commit/63a5e7fe40eea45762b5842b588c742076c7dd1d),
+  [`2bffe48`](https://github.com/lapismd/lapis-notes/commit/2bffe484b38761af197afe7ab9b0d7b3affb50d7),
+  [`86f6316`](https://github.com/lapismd/lapis-notes/commit/86f63166c3d5be648c595ef4e230ea6c4081bc48),
+  [`edf1d76`](https://github.com/lapismd/lapis-notes/commit/edf1d76f4f3aa0442c1d9153d812f29b7d14e5c2),
+  [`b3be91d`](https://github.com/lapismd/lapis-notes/commit/b3be91daecbd43187bacf8cfdc39f8311d700720),
+  [`5ef0a63`](https://github.com/lapismd/lapis-notes/commit/5ef0a6331c1b846b70357f990d919977a561112c),
+  [`bac3e5e`](https://github.com/lapismd/lapis-notes/commit/bac3e5eda6f467dbc86ec88c9f27a275f2b27953),
+  [`978b987`](https://github.com/lapismd/lapis-notes/commit/978b987ba4c95408a63e49fad11bc44bab020758),
+  [`ad4490c`](https://github.com/lapismd/lapis-notes/commit/ad4490ca1cd808002765582a17a5c81fa5335e0d),
+  [`74f544e`](https://github.com/lapismd/lapis-notes/commit/74f544e2aa8a967524c0c218f3db7e1a495a1a17),
+  [`55be8dc`](https://github.com/lapismd/lapis-notes/commit/55be8dce6f7b19b0e8036be86a3cf5305db25317),
+  [`501c50e`](https://github.com/lapismd/lapis-notes/commit/501c50e049264560e13e29c75a74c089922c7297),
+  [`98b333f`](https://github.com/lapismd/lapis-notes/commit/98b333f73ff5ba8d5f28c52e4e3a2ceaa5ade0fb),
+  [`535a6cc`](https://github.com/lapismd/lapis-notes/commit/535a6cc7b39f397cf8761a06db7b831386121928),
+  [`8a27bc3`](https://github.com/lapismd/lapis-notes/commit/8a27bc36a7a7fa81594e517908a6f5ed8ca77313),
+  [`109e208`](https://github.com/lapismd/lapis-notes/commit/109e208a63253dcc1a7abad3fd5a9b13c39d3def),
+  [`1e64589`](https://github.com/lapismd/lapis-notes/commit/1e6458922b486c07f36a5bc7d85d020b5805cd49),
+  [`f828eae`](https://github.com/lapismd/lapis-notes/commit/f828eaeba8411aa342d7ab4954393e84612af2f3)]:
+  - @lapis-notes/api@0.2.0
+
+## 0.1.3
+
+### Patch Changes
+
+- [#36](https://github.com/lapismd/lapis-notes/pull/36)
+  [`17060a1`](https://github.com/lapismd/lapis-notes/commit/17060a1df152c9fc2302c93767cd7172868ff030)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Consume published Design
+  Core 0.5.0 with prepared browser CSS and bundled font assets through normal
+  npm ranges.
+- Updated dependencies
+  [[`17060a1`](https://github.com/lapismd/lapis-notes/commit/17060a1df152c9fc2302c93767cd7172868ff030)]:
+  - @lapis-notes/api@0.1.5
+
 ## 0.1.2
 
 ### Patch Changes
 
-- [#4](https://github.com/lapismd/lapis-notes/pull/4) [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2) Thanks [@stevejuma](https://github.com/stevejuma)! - Require published Design Core 0.3.2 for native window-controls spacing, bold settings headings, selected-tab indicators and mobile shell teardown. Consume the npm release through portable semver ranges and lockfile integrity.
+- [#4](https://github.com/lapismd/lapis-notes/pull/4)
+  [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2)
+  Thanks [@stevejuma](https://github.com/stevejuma)! - Require published Design
+  Core 0.3.2 for native window-controls spacing, bold settings headings,
+  selected-tab indicators and mobile shell teardown. Consume the npm release
+  through portable semver ranges and lockfile integrity.
 
-- Updated dependencies [[`39f886d`](https://github.com/lapismd/lapis-notes/commit/39f886d017a28d916b3f6cac7d08b7723a04f45b), [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2), [`1e949fc`](https://github.com/lapismd/lapis-notes/commit/1e949fc9d51b795a50760e1146a9599602746c6b)]:
+- Updated dependencies
+  [[`39f886d`](https://github.com/lapismd/lapis-notes/commit/39f886d017a28d916b3f6cac7d08b7723a04f45b),
+  [`c1ad3c4`](https://github.com/lapismd/lapis-notes/commit/c1ad3c4acee2eac1ae87c22f66e946d2e0db3bf2),
+  [`1e949fc`](https://github.com/lapismd/lapis-notes/commit/1e949fc9d51b795a50760e1146a9599602746c6b)]:
   - @lapis-notes/api@0.1.2
 
 ## 0.1.1

package/README.md

@@ -30,3 +30,9 @@ pnpm --filter @lapis-notes/file-explorer build
 pnpm --filter @lapis-notes/file-explorer check
 pnpm --filter @lapis-notes/file-explorer test
 ```
+
+Plugin-contributed file icons resolve through the owning App's editor-view and
+icon registries. Contributions can reference built-in names, registered custom
+SVG IDs or icon-pack entries. Registration, plugin enablement, editor
+associations and rename refresh rows while Design Core retains filename
+fallback, row accessibility and rename presentation.

package/dist/ArtworkIcon.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import type { HTMLAttributes } from "svelte/elements";
+
+  let {
+    svg,
+    class: className = "",
+    ...rest
+  }: { svg: string; class?: string } & HTMLAttributes<HTMLSpanElement> =
+    $props();
+</script>
+
+<span
+  {...rest}
+  class={["ui-workspace-icon", className].filter(Boolean).join(" ")}
+  data-ui-component="workspace-icon"
+>
+  {@html svg}
+</span>

package/dist/ArtworkIcon.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { HTMLAttributes } from "svelte/elements";
+type $$ComponentProps = {
+    svg: string;
+    class?: string;
+} & HTMLAttributes<HTMLSpanElement>;
+declare const ArtworkIcon: import("svelte").Component<$$ComponentProps, {}, "">;
+type ArtworkIcon = ReturnType<typeof ArtworkIcon>;
+export default ArtworkIcon;

package/dist/explorer-file-icons.d.ts

@@ -0,0 +1,7 @@
+import type { App } from "@lapis-notes/api";
+/** Publish the selected file-view artwork through Design Core's scoped resolver. */
+export declare function createExplorerFileIcons(app: App): {
+    nameForPath(path: string): string | undefined;
+    publish(): Promise<void>;
+    release(): void;
+};

package/dist/explorer-file-icons.js

@@ -0,0 +1,55 @@
+import { registerWorkspaceIcon } from "@lapismd/design-core/workspace/icon";
+import ArtworkIcon from "./ArtworkIcon.svelte";
+import { listExplorerVaultEntries } from "./explorer-vault-entries";
+function artworkComponent(svg) {
+    const Icon = (anchor, props) => ArtworkIcon(anchor, { ...props, svg });
+    return Icon;
+}
+/** Publish the selected file-view artwork through Design Core's scoped resolver. */
+export function createExplorerFileIcons(app) {
+    const disposers = new Map();
+    const published = new Map();
+    let generation = 0;
+    function names() {
+        return new Set(listExplorerVaultEntries(app.vault.getAllLoadedFiles()).flatMap((node) => {
+            if (node.kind !== "file")
+                return [];
+            const name = app.workspace.getFileIconForPath(node.path);
+            return name ? [name] : [];
+        }));
+    }
+    return {
+        nameForPath(path) {
+            const name = app.workspace.getFileIconForPath(path);
+            return name && published.has(name) ? name : undefined;
+        },
+        async publish() {
+            const current = ++generation;
+            const selected = names();
+            const artwork = await Promise.all([...selected].map(async (name) => [name, await app.icons.resolve(name)]));
+            if (current !== generation)
+                return;
+            for (const [name, svg] of artwork) {
+                if (!svg || published.get(name) === svg)
+                    continue;
+                disposers.get(name)?.();
+                published.set(name, svg);
+                disposers.set(name, registerWorkspaceIcon(name, artworkComponent(svg)));
+            }
+            for (const name of [...disposers.keys()]) {
+                if (selected.has(name))
+                    continue;
+                disposers.get(name)?.();
+                disposers.delete(name);
+                published.delete(name);
+            }
+        },
+        release() {
+            generation += 1;
+            for (const dispose of disposers.values())
+                dispose();
+            disposers.clear();
+            published.clear();
+        },
+    };
+}

package/dist/explorer-imports.d.ts

@@ -0,0 +1,3 @@
+import type { App } from "@lapis-notes/api";
+/** Reuse the Explorer drop surface and App-owned exclusive new-file intent. */
+export declare function importExplorerFiles(app: App, folder: string, files: readonly File[]): Promise<void>;

package/dist/explorer-imports.js

@@ -0,0 +1,24 @@
+const MAX_IMPORT_BYTES = 64 * 1024 * 1024;
+/** Reuse the Explorer drop surface and App-owned exclusive new-file intent. */
+export function importExplorerFiles(app, folder, files) {
+    return app.fileEditingSessions.track(async () => {
+        const imports = files.map((file) => {
+            const name = file.name;
+            if (!name || name === "." || name === ".." || /[\\/\0]/u.test(name))
+                throw new Error("Import requires a single valid filename");
+            if (!Number.isFinite(file.size) ||
+                file.size < 0 ||
+                file.size > MAX_IMPORT_BYTES)
+                throw new Error("Imported files must be at most 64 MiB");
+            return { file, path: folder ? `${folder}/${name}` : name };
+        });
+        for (const { file, path } of imports) {
+            const bytes = await file.arrayBuffer();
+            if (bytes.byteLength > MAX_IMPORT_BYTES)
+                throw new Error("Imported files must be at most 64 MiB");
+            await app.fileManager.createFile(path, bytes, {
+                mtime: file.lastModified,
+            });
+        }
+    });
+}

package/dist/index.js

@@ -1,17 +1,18 @@
 import { Notice, Plugin, TFile, View, basename, dirname, joinPath, } from "@lapis-notes/api";
-import { getWorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
 import { ExplorerController } from "@lapismd/design-core/workspace/explorer";
 import { mount, unmount } from "svelte";
 import ExplorerPanel from "./LapisExplorerView.svelte";
 import LapisLanding from "./LapisLandingView.svelte";
 import { appendNativeExplorerMenu, copyExplorerText, } from "./native-explorer-actions";
 import { openExplorerFile } from "./open-explorer-file";
+import { importExplorerFiles } from "./explorer-imports";
 import { DEFAULT_VAULT_PALETTE_FILE_EXTENSIONS, EXPLORER_SETTING_IDS, } from "./explorer-settings";
 import { listExplorerVaultEntries } from "./explorer-vault-entries";
-import { registerExplorerSettings } from "./register-explorer-settings";
+import { readWorkspaceHostBinding, registerExplorerSettings, } from "./register-explorer-settings";
 import { subscribeExplorerVaultTreeChanges } from "./explorer-tree-subscription";
 import { listVaultPaletteFiles, VAULT_PALETTE_FILES_TAB, VAULT_PALETTE_RECENT_GROUP, } from "./vault-palette-files";
 import { bindExplorerSelectionNotifications } from "./explorer-selection";
+import { createExplorerFileIcons } from "./explorer-file-icons";
 const EXPLORER_MANIFEST = {
     id: "lapis-file-explorer",
     name: "Explorer",
@@ -69,21 +70,37 @@ async function uniquePath(app, parent, requestedName) {
             return path;
     }
 }
-async function withNotice(operation) {
+async function withNotice(app, operation) {
     try {
-        return await operation();
+        return await (app.vault.supportsConditionalTextWrites
+            ? app.fileEditingSessions.track(operation)
+            : operation());
     }
     catch (error) {
-        new Notice(displayError(error));
+        new Notice(displayError(error), undefined, app);
         throw error;
     }
 }
 function createExplorerController(app, loading) {
+    const fileIcons = createExplorerFileIcons(app);
     const controller = new ExplorerController({
         loading,
+        getIcon: (node) => node.kind === "file" ? fileIcons.nameForPath(node.path) : undefined,
         tree: {
             listEntries: () => listExplorerVaultEntries(app.vault.getAllLoadedFiles()),
-            subscribe: (onChange) => subscribeExplorerVaultTreeChanges(app, onChange),
+            subscribe: (onChange) => {
+                const refreshIcons = () => {
+                    void fileIcons.publish().then(onChange);
+                };
+                const stopTree = subscribeExplorerVaultTreeChanges(app, onChange);
+                const stopIcons = app.workspace.onFileIconsChanged(refreshIcons);
+                refreshIcons();
+                return () => {
+                    stopTree();
+                    stopIcons();
+                    fileIcons.release();
+                };
+            },
         },
         selection: {
             subscribe: (onActivePath) => {
@@ -111,24 +128,25 @@ function createExplorerController(app, loading) {
             setShowHiddenFiles: (value) => app.configuration.updateConfigurationOption(EXPLORER_SETTING_IDS.showHiddenFiles, value),
         },
         actions: {
-            openFile: (path, options) => withNotice(async () => {
+            importExternalFiles: (folder, files) => withNotice(app, () => importExplorerFiles(app, folder, files)),
+            openFile: (path, options) => withNotice(app, async () => {
                 const file = app.vault.getFileByPath(path);
                 if (!file)
                     throw new Error(`Unable to find file: ${path}`);
                 await openExplorerFile(app, file, options?.disposition ?? "current");
             }),
-            createFile: (parent) => withNotice(async () => {
+            createFile: (parent) => withNotice(app, async () => {
                 const path = await uniquePath(app, parent, "Untitled.md");
-                const file = await app.vault.create(path, "");
+                const file = await app.fileManager.createFile(path, "");
                 await app.openFile(file);
                 return path;
             }),
-            createFolder: (parent) => withNotice(async () => {
+            createFolder: (parent) => withNotice(app, async () => {
                 const path = await uniquePath(app, parent, "New folder");
                 await app.vault.createFolder(path);
                 return path;
             }),
-            rename: (path, nextName) => withNotice(async () => {
+            rename: (path, nextName) => withNotice(app, async () => {
                 const file = app.vault.getAbstractFileByPath(path);
                 if (!file)
                     throw new Error(`Unable to find path: ${path}`);
@@ -139,7 +157,7 @@ function createExplorerController(app, loading) {
                 await app.fileManager.renameFile(file, nextPath);
                 return nextPath;
             }),
-            move: (path, destinationFolderPath) => withNotice(async () => {
+            move: (path, destinationFolderPath) => withNotice(app, async () => {
                 const file = app.vault.getAbstractFileByPath(path);
                 if (!file)
                     throw new Error(`Unable to find path: ${path}`);
@@ -150,13 +168,13 @@ function createExplorerController(app, loading) {
                 await app.fileManager.renameFile(file, nextPath);
                 return nextPath;
             }),
-            delete: (path) => withNotice(async () => {
+            delete: (path) => withNotice(app, async () => {
                 const file = app.vault.getAbstractFileByPath(path);
                 if (!file)
                     throw new Error(`Unable to find path: ${path}`);
-                await app.vault.trash(file, false);
+                await app.fileManager.trashFile(file);
             }),
-            copyText: copyExplorerText,
+            copyText: (label, value) => withNotice(app, () => copyExplorerText(app, label, value)),
         },
         buildItemMenu: (menu, node) => {
             appendNativeExplorerMenu(menu, node, app);
@@ -227,11 +245,11 @@ export class LapisLandingView extends View {
                 id: "create-note",
                 label: "Create new note",
                 icon: "square-pen",
-                onSelect: async () => {
+                onSelect: () => withNotice(this.app, async () => {
                     const path = await uniquePath(this.app, "", "Untitled.md");
-                    const file = await this.app.vault.create(path, "");
+                    const file = await this.app.fileManager.createFile(path, "");
                     await this.app.openFile(file);
-                },
+                }),
             },
             {
                 id: "go-to-file",
@@ -277,7 +295,7 @@ export function createFileExplorerPlugin(options = {}) {
             this.register(() => {
                 this.app.configuration.schema.unregister(EXPLORER_SCHEMA);
             });
-            registerExplorerSettings(this);
+            const settingsRegistered = registerExplorerSettings(this);
             const configurationRef = this.app.configuration.on("updated", ({ key, value }) => {
                 if (key !== EXPLORER_SETTING_IDS.showHiddenFiles)
                     return;
@@ -321,32 +339,52 @@ export function createFileExplorerPlugin(options = {}) {
                     void this.app.configuration.updateConfigurationOption(EXPLORER_SETTING_IDS.showHiddenFiles, !readShowHiddenFiles(this.app));
                 },
             });
-            const { controller } = getWorkspaceHostBinding(this.app.workspace);
-            this.register(controller.commands.registerPaletteProvider({
-                id: "lapis-vault-files",
-                tab: VAULT_PALETTE_FILES_TAB,
-                emptyQueryLimit: 5,
-                search: (query) => {
-                    const starterFiles = query.trim().length === 0;
-                    const recentPaths = starterFiles
-                        ? new Set(this.app.workspace
-                            .getRecentFiles()
-                            .map((recent) => recent.path))
-                        : null;
-                    return listVaultPaletteFiles(this.app, query).map((file) => ({
-                        id: `vault-file:${file.path}`,
-                        title: file.name,
-                        subtitle: file.path,
-                        icon: "file",
-                        providerId: "lapis-vault-files",
-                        tab: VAULT_PALETTE_FILES_TAB.id,
-                        group: recentPaths?.has(file.path)
-                            ? VAULT_PALETTE_RECENT_GROUP
-                            : undefined,
-                        run: () => this.app.openFile(file),
-                    }));
-                },
-            }));
+            let paletteAttached = false;
+            let paletteDisposed = false;
+            this.register(() => {
+                paletteDisposed = true;
+            });
+            const attachVaultPalette = () => {
+                if (paletteDisposed || paletteAttached)
+                    return;
+                const binding = readWorkspaceHostBinding(this.app.workspace);
+                if (!binding)
+                    return;
+                paletteAttached = true;
+                this.register(binding.controller.commands.registerPaletteProvider({
+                    id: "lapis-vault-files",
+                    tab: VAULT_PALETTE_FILES_TAB,
+                    emptyQueryLimit: 5,
+                    search: (query) => {
+                        const starterFiles = query.trim().length === 0;
+                        const recentPaths = starterFiles
+                            ? new Set(this.app.workspace
+                                .getRecentFiles()
+                                .map((recent) => recent.path))
+                            : null;
+                        return listVaultPaletteFiles(this.app, query).map((file) => ({
+                            id: `vault-file:${file.path}`,
+                            title: file.name,
+                            subtitle: file.path,
+                            icon: "file",
+                            providerId: "lapis-vault-files",
+                            tab: VAULT_PALETTE_FILES_TAB.id,
+                            group: recentPaths?.has(file.path)
+                                ? VAULT_PALETTE_RECENT_GROUP
+                                : undefined,
+                            run: () => this.app.openFile(file),
+                        }));
+                    },
+                }));
+            };
+            attachVaultPalette();
+            if (!paletteAttached || !settingsRegistered) {
+                this.app.workspace.onLayoutReady(() => {
+                    if (!settingsRegistered)
+                        registerExplorerSettings(this);
+                    attachVaultPalette();
+                });
+            }
             await this.app.configuration.materializeSchemaDefaults();
         }
         syncShowHiddenFiles(value) {

package/dist/native-explorer-actions.d.ts

@@ -4,5 +4,5 @@ import type { ExplorerNode } from "@lapismd/design-core/workspace/explorer";
 import type { WorkspaceMenu } from "@lapismd/design-core/workspace/core";
 export declare function hasNativeExplorerActions(adapter: App["vault"]["adapter"]): adapter is NativeDesktopVaultAdapter;
 export declare function revealInFileManagerLabel(os: NativeDesktopPlatformOs | undefined): string;
-export declare function copyExplorerText(label: string, value: string): Promise<void>;
+export declare function copyExplorerText(app: App, label: string, value: string): Promise<void>;
 export declare function appendNativeExplorerMenu(menu: WorkspaceMenu, node: ExplorerNode, app: App): void;

package/dist/native-explorer-actions.js

@@ -11,11 +11,11 @@ export function revealInFileManagerLabel(os) {
         return "Reveal in File Explorer";
     return "Reveal in file manager";
 }
-export async function copyExplorerText(label, value) {
-    if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
-        await navigator.clipboard.writeText(value);
-    }
-    new Notice(`Copied ${label}`);
+export async function copyExplorerText(app, label, value) {
+    if (typeof navigator === "undefined" || !navigator.clipboard?.writeText)
+        throw new Error("Clipboard is unavailable");
+    await navigator.clipboard.writeText(value);
+    new Notice(`Copied ${label}`, undefined, app);
 }
 function vaultPath(node) {
     return node.path === "/" ? "/" : node.path;
@@ -26,49 +26,52 @@ export function appendNativeExplorerMenu(menu, node, app) {
         return;
     const copyPath = menu.entries.find((entry) => entry.kind === "submenu" && entry.title === "Copy Path");
     if (copyPath?.kind === "submenu") {
-        copyPath.menu.addItem((item) => item.setTitle("From system root").onClick(() => {
-            void copySystemRootPath(adapter, node);
-        }));
+        copyPath.menu.addItem((item) => item
+            .setTitle("From system root")
+            .onClick(() => copySystemRootPath(app, adapter, node)));
         if (node.kind === "file") {
             copyPath.menu.addItem((item) => item.setTitle("As Lapis URL").onClick(() => {
-                void copyExplorerText("Lapis URL", createLapisFileUrl(app.vault.getName(), vaultPath(node)));
+                return copyExplorerText(app, "Lapis URL", createLapisFileUrl(app.vault.getName(), vaultPath(node))).catch((error) => {
+                    report(app, error);
+                });
             }));
         }
     }
     menu.addSeparator();
-    menu.addItem((item) => item.setTitle("Open in default app").onClick(() => {
-        void openVaultPath(adapter, node);
-    }));
+    menu.addItem((item) => item
+        .setTitle("Open in default app")
+        .onClick(() => openVaultPath(app, adapter, node)));
     menu.addItem((item) => item
         .setTitle(revealInFileManagerLabel(getNativeDesktopPlatform()?.os))
-        .onClick(() => {
-        void revealVaultPath(adapter, node);
-    }));
+        .onClick(() => revealVaultPath(app, adapter, node)));
 }
-async function copySystemRootPath(adapter, node) {
+async function copySystemRootPath(app, adapter, node) {
     try {
         const absolute = await resolveNativeDesktopVaultPath(adapter.rootPath, vaultPath(node));
         if (!absolute)
             throw new Error("Unable to resolve the system path");
-        await copyExplorerText("system path", absolute);
+        await copyExplorerText(app, "system path", absolute);
     }
     catch (error) {
-        new Notice(error instanceof Error ? error.message : String(error));
+        report(app, error);
     }
 }
-async function openVaultPath(adapter, node) {
+async function openVaultPath(app, adapter, node) {
     try {
         await openNativeDesktopVaultPath(adapter.rootPath, vaultPath(node));
     }
     catch (error) {
-        new Notice(error instanceof Error ? error.message : String(error));
+        report(app, error);
     }
 }
-async function revealVaultPath(adapter, node) {
+async function revealVaultPath(app, adapter, node) {
     try {
         await revealNativeDesktopVaultPath(adapter.rootPath, vaultPath(node));
     }
     catch (error) {
-        new Notice(error instanceof Error ? error.message : String(error));
+        report(app, error);
     }
 }
+function report(app, error) {
+    new Notice(error instanceof Error ? error.message : String(error), undefined, app);
+}

package/dist/register-explorer-settings.d.ts

@@ -1,4 +1,5 @@
 import type { Plugin } from "@lapis-notes/api";
+import { getWorkspaceHostBinding, type WorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
 export declare function createExplorerSettingsSection(): {
     id: string;
     title: string;
@@ -27,7 +28,8 @@ export declare function createExplorerSettingsSection(): {
         itemType: "string";
         title: string;
         description: string;
-        default: ("md" | "markdown" | "txt" | "text" | "json" | "data" | "yaml" | "yml")[];
+        default: ("text" | "md" | "markdown" | "txt" | "json" | "data" | "yaml" | "yml")[];
     })[];
 };
-export declare function registerExplorerSettings(plugin: Plugin): void;
+export declare function readWorkspaceHostBinding(workspace: Parameters<typeof getWorkspaceHostBinding>[0]): WorkspaceHostBinding | null;
+export declare function registerExplorerSettings(plugin: Plugin): boolean;

package/dist/register-explorer-settings.js

@@ -1,4 +1,4 @@
-import { getWorkspaceHostBinding } from "@lapis-notes/api/workspace-host";
+import { getWorkspaceHostBinding, } from "@lapis-notes/api/workspace-host";
 import { DEFAULT_VAULT_PALETTE_FILE_EXTENSIONS, EXPLORER_SETTING_IDS, EXPLORER_SETTINGS_SECTION_ID, } from "./explorer-settings";
 export function createExplorerSettingsSection() {
     return {
@@ -35,11 +35,24 @@ export function createExplorerSettingsSection() {
         ],
     };
 }
+export function readWorkspaceHostBinding(workspace) {
+    try {
+        return getWorkspaceHostBinding(workspace);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            error.message === "Workspace host binding is not initialized") {
+            return null;
+        }
+        throw error;
+    }
+}
 export function registerExplorerSettings(plugin) {
     if (!plugin.app.workspace)
-        return;
-    const binding = getWorkspaceHostBinding(plugin.app.workspace);
+        return false;
+    const binding = readWorkspaceHostBinding(plugin.app.workspace);
     if (!binding)
-        return;
+        return false;
     plugin.register(binding.controller.registerSettingsSection(createExplorerSettingsSection()));
+    return true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lapis-notes/file-explorer",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Reusable Lapis Notes file explorer plugin",
   "license": "Apache-2.0",
   "repository": {
@@ -38,8 +38,8 @@
     }
   },
   "dependencies": {
-    "@lapis-notes/api": "^0.1.2",
-    "@lapismd/design-core": "^0.3.2"
+    "@lapis-notes/api": "^0.2.0",
+    "@lapismd/design-core": "^0.7.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"