@lapis-notes/workspace 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @lapis-notes/workspace
 
+## 0.2.1
+
+### Patch Changes
+
+- [#15](https://github.com/lapismd/lapis-notes/pull/15) [`57996c6`](https://github.com/lapismd/lapis-notes/commit/57996c6d26c1e7ed723df1291b415ee94d3a58e5) Thanks [@stevejuma](https://github.com/stevejuma)! - Retain selected plugin releases in navigation and persisted Plugins views so
+  application links can open a specific version. Fail closed for unavailable
+  versions and keep historical installation bound to the selected release.
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/plugin-management/PluginBrowser.svelte

@@ -94,7 +94,9 @@
         sidebarMaxWidth: 440,
       }),
   );
-  let selectedVersion = $state<string>();
+  const selectedVersion = $derived(
+    navigation.route.page === "plugin" ? navigation.route.version : undefined,
+  );
   const resolved = $derived(
     selected && session.detail
       ? communityDetail(selected, session.detail)
@@ -128,12 +130,30 @@
       return { state: "rejected", reason: feedback.message };
     if (bundledIds.has(selected.id))
       return { state: "installed", label: "Bundled" };
-    if (update?.canUpdate) return { state: "available", label: "Update" };
-    if (installedIds.has(selected.id)) return { state: "installed" };
+    const installed = registry.installed.find(
+      (record) => record.pluginId === selected.id,
+    );
+    const requestedVersion = selectedVersion ?? selected.latestVersion;
+    if (installed?.installedVersion === requestedVersion)
+      return {
+        state: "installed",
+        installedVersion: installed.installedVersion,
+      };
+    if (update?.canUpdate && requestedVersion === selected.latestVersion)
+      return {
+        state: "available",
+        label: "Update",
+        installedVersion: installed?.installedVersion,
+      };
+    if (installed && requestedVersion === selected.latestVersion)
+      return {
+        state: "installed",
+        installedVersion: installed.installedVersion,
+      };
     const disabled = reason(selected);
     return disabled
       ? { state: "disabled", reason: disabled }
-      : { state: "available" };
+      : { state: "available", installedVersion: installed?.installedVersion };
   });
   const downloads = (id: string) =>
     registry.downloadStats?.periods["30d"].plugins[id]?.total ?? 0;
@@ -171,7 +191,6 @@
   $effect(() => {
     if (selected && previousDetail !== selected.id) {
       previousDetail = selected.id;
-      selectedVersion = undefined;
       void session.select(selected);
     }
     if (navigation.route.page !== "plugin") {
@@ -412,6 +431,19 @@
                       onOpenPlugin={open}
                       onOpenCategory={(category) => go("directory", category)}
                     />
+                   {:else if selected && resolved && selectedVersion !== undefined && !Object.hasOwn(resolved.detail.versions, selectedVersion)}<PluginRegistryContentState
+                      kind="empty"
+                      heading="Plugin version unavailable"
+                      description={`Version ${selectedVersion} is not available from your enabled registry.`}
+                      actionLabel="View latest release"
+                      onaction={() => {
+                        navigation.route = {
+                          page: "plugin",
+                          pluginId: selected.id,
+                        };
+                        persist();
+                      }}
+                    />
                   {:else if selected && resolved}<PluginBrowserDetail
                       {resolved}
                       downloadSummary={registry.downloadStats
@@ -430,14 +462,23 @@
                         ? changelogContent
                         : undefined}
                       onInstall={(request) =>
-                        update?.canUpdate
+                        update?.canUpdate &&
+                        request.version === update.targetVersion &&
+                        request.version === selected.latestVersion
                           ? registry.update(update)
                           : registry.install(selected, request.version)}
                       onOpenPlugin={open}
                       onOpenCategory={(category) => go("directory", category)}
                       onOpenPlatform={(platform) =>
                         go("directory", undefined, platform)}
-                      onSelectVersion={(version) => (selectedVersion = version)}
+                      onSelectVersion={(version) => {
+                        navigation.route = {
+                          page: "plugin",
+                          pluginId: selected.id,
+                          version,
+                        };
+                        persist();
+                      }}
                     />
                   {:else if selected && session.loading}<PluginRegistryContentState
                       kind="loading"

package/dist/plugin-management/plugin-browser-model.d.ts

@@ -4,6 +4,7 @@ export type PluginBrowserRoute = {
 } | {
     page: "plugin";
     pluginId: string;
+    version?: string;
 };
 export interface PluginDirectoryState {
     query: string;

package/dist/plugin-management/plugin-browser-model.js

@@ -67,8 +67,17 @@ export function restoreBrowserState(value) {
     const routeValue = value.route;
     const route = routeValue?.page === "plugin" &&
         typeof routeValue.pluginId === "string" &&
-        routeValue.pluginId.length > 0
-        ? { page: "plugin", pluginId: routeValue.pluginId }
+        routeValue.pluginId.length > 0 &&
+        (routeValue.version === undefined ||
+            (typeof routeValue.version === "string" &&
+                /^[A-Za-z0-9][A-Za-z0-9.+-]{0,127}$/u.test(routeValue.version)))
+        ? {
+            page: "plugin",
+            pluginId: routeValue.pluginId,
+            ...(routeValue.version !== undefined
+                ? { version: routeValue.version }
+                : {}),
+        }
         : { page: routeValue?.page === "directory" ? "directory" : "landing" };
     const directory = defaultDirectoryState();
     const input = value.directory;

package/dist/plugin-management/plugin-browser-navigation.d.ts

@@ -1,3 +1,3 @@
 import type { App } from "@lapis-notes/api";
 /** Reveal the registered singleton browser, preserving its workspace placement. */
-export declare function openPluginBrowser(app: App, pluginId?: string, isActive?: () => boolean): Promise<void>;
+export declare function openPluginBrowser(app: App, pluginId?: string, isActive?: () => boolean, version?: string): Promise<void>;

package/dist/plugin-management/plugin-browser-navigation.js

@@ -1,7 +1,7 @@
 import { PluginsView } from "./plugins-view.svelte";
 const pending = new WeakMap();
 /** Reveal the registered singleton browser, preserving its workspace placement. */
-export function openPluginBrowser(app, pluginId, isActive = () => true) {
+export function openPluginBrowser(app, pluginId, isActive = () => true, version) {
     const previous = pending.get(app) ?? Promise.resolve();
     const next = previous
         .catch(() => { })
@@ -19,7 +19,9 @@ export function openPluginBrowser(app, pluginId, isActive = () => true) {
             return;
         if (!(leaf.view instanceof PluginsView))
             throw new Error("The Plugins view is not registered in this workspace.");
-        if (pluginId)
+        if (pluginId && version !== undefined)
+            leaf.view.showPlugin(pluginId, version);
+        else if (pluginId)
             leaf.view.showPlugin(pluginId);
         else
             leaf.view.home();

package/dist/plugin-management/plugins-view.svelte.d.ts

@@ -15,6 +15,7 @@ export declare class PluginsView extends ItemView {
         } | {
             page: "plugin";
             pluginId: string;
+            version?: string;
         };
         directory: {
             query: string;
@@ -31,7 +32,7 @@ export declare class PluginsView extends ItemView {
         scrollTop: number;
     };
     setState(state: Record<string, unknown>): Promise<void>;
-    showPlugin(pluginId: string): void;
+    showPlugin(pluginId: string, version?: string): void;
     home(): void;
     load(): void;
     unload(): void;

package/dist/plugin-management/plugins-view.svelte.js

@@ -61,10 +61,14 @@ export class PluginsView extends ItemView {
                 ? Math.max(0, state.scrollTop)
                 : 0;
     }
-    showPlugin(pluginId) {
+    showPlugin(pluginId, version) {
         if (this.navigation.route.page !== "plugin")
             this.navigation.returnPage = this.navigation.route.page;
-        this.navigation.route = { page: "plugin", pluginId };
+        this.navigation.route = {
+            page: "plugin",
+            pluginId,
+            ...(version !== undefined ? { version } : {}),
+        };
         this.app.workspace.requestSaveLayout();
     }
     home() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lapis-notes/workspace",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Lapis Notes workspace shell backed by design-core",
   "license": "Apache-2.0",
   "repository": {