@lapis-notes/graph 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Graph changelog
 
+## 0.1.4
+
+### Patch Changes
+
+- [#28](https://github.com/lapismd/lapis-plugins/pull/28) [`d27467e`](https://github.com/lapismd/lapis-plugins/commit/d27467ee80c273011b7eb6ae792fa8e0330a11c1) Thanks [@stevejuma](https://github.com/stevejuma)! - Align shared presentation dependencies with the Design Core 0.6 public boundary used by current Notes hosts.
+
+- [#28](https://github.com/lapismd/lapis-plugins/pull/28) [`f4b9136`](https://github.com/lapismd/lapis-plugins/commit/f4b9136e4f47965700e06f52f82e8e2bc884eb11) Thanks [@stevejuma](https://github.com/stevejuma)! - Accept Design Core 0.5.1 alongside the existing 0.4 release line so current local
+  Desktop builds can use one compatible framework graph.
+
+- [#28](https://github.com/lapismd/lapis-plugins/pull/28) [`56b5d6c`](https://github.com/lapismd/lapis-plugins/commit/56b5d6c1a016ef9bca43703b5fecf57f8234d1af) Thanks [@stevejuma](https://github.com/stevejuma)! - Consume published Design Core 0.4.0 with prepared browser CSS and bundled font assets through normal npm ranges.
+
+  Restore Bases picker input/list accessibility relationships and name property actions.
+
+- [#28](https://github.com/lapismd/lapis-plugins/pull/28) [`c9febb1`](https://github.com/lapismd/lapis-plugins/commit/c9febb1c8b431db30ecdcf7507cfff8f727bc4ed) Thanks [@stevejuma](https://github.com/stevejuma)! - Consume the published Notes next packages, Mira 0.1.2, and Design Core 0.7.0 through the existing semver floors. Markdown dependents accept ^0.2.0. History keeps its public repository entrypoints, and Bases keeps the file-icon contract on API 0.2.0.
+
+- [#28](https://github.com/lapismd/lapis-plugins/pull/28) [`fbdd341`](https://github.com/lapismd/lapis-plugins/commit/fbdd341e6df180ff4ef39b6c5091ed3e77802a3b) Thanks [@stevejuma](https://github.com/stevejuma)! - Admit debounced settings before native close and refresh open Graph views after explicit disk recovery.
+
+- Updated dependencies [[`d27467e`](https://github.com/lapismd/lapis-plugins/commit/d27467ee80c273011b7eb6ae792fa8e0330a11c1), [`f4b9136`](https://github.com/lapismd/lapis-plugins/commit/f4b9136e4f47965700e06f52f82e8e2bc884eb11), [`ae5b5d9`](https://github.com/lapismd/lapis-plugins/commit/ae5b5d9bf7d8f84296280581a8f95fd198265e62), [`ae5b5d9`](https://github.com/lapismd/lapis-plugins/commit/ae5b5d9bf7d8f84296280581a8f95fd198265e62), [`ae5b5d9`](https://github.com/lapismd/lapis-plugins/commit/ae5b5d9bf7d8f84296280581a8f95fd198265e62), [`56b5d6c`](https://github.com/lapismd/lapis-plugins/commit/56b5d6c1a016ef9bca43703b5fecf57f8234d1af)]:
+  - @lapis-notes/markdown@0.2.0
+
+## 0.1.3
+
+### Patch Changes
+
+- Add official author avatars and deterministic split, light, and dark registry media for plugin banners, overviews, and galleries.
+
+- Updated dependencies []:
+  - @lapis-notes/markdown@0.1.5
+
 ## 0.1.2
 
 - Initial independent public package extracted from Lapis Notes without changing

package/LICENSE.md

@@ -1,8 +1,4 @@
-# License
+Apache-2.0
 
-Copyright (c) LapisMD contributors.
-
-This software is licensed under the GNU Affero General Public License, version
-3 or (at your option) any later version (`AGPL-3.0-or-later`). The complete
-license text is available from the
-[GNU Project](https://www.gnu.org/licenses/agpl-3.0.html).
+This project is licensed under the Apache License 2.0.
+See <https://www.apache.org/licenses/LICENSE-2.0>.

package/README.md

@@ -13,7 +13,7 @@ Register the exported plugin class in the application's `PluginProfile`. Import
 registration so the host owns its lifecycle.
 
 The runtime plugin ID is `lapis-graph`. A matching signed
-`lapis-graph-0.1.2.lapis-plugin` archive is attached to the
+`lapis-graph-0.1.4.lapis-plugin` archive is attached to the
 package-scoped GitHub release for manual or registry installation.
 
 See the [repository README](https://github.com/lapismd/lapis-plugins#readme) for

package/dist/graph-plugin.d.ts

@@ -13,7 +13,8 @@ export declare class GraphPlugin extends Plugin {
     private readonly graphCoordinator;
     private settings;
     private settingsSaveTimer;
-    private pendingSettingsSave;
+    private releaseSettingsSave;
+    private settingsSaveTask;
     private graphProblems;
     private readonly pathQueryCache;
     constructor(app: App, manifest?: PluginManifest);
@@ -21,6 +22,7 @@ export declare class GraphPlugin extends Plugin {
     onunload(): Promise<void>;
     getSettings(): GraphSettings;
     updateSettings(nextSettings: GraphSettings): Promise<void>;
+    private applySettings;
     subscribeToGlobalGraph(listener: (state: GraphCoordinatorState) => void): () => void;
     refreshGlobalGraph(force?: boolean): Promise<void>;
     reportGraphBuildFailure(scope: GraphProblemScope, path: string | null, error: unknown): void;

package/dist/graph-plugin.js

@@ -1,4 +1,4 @@
-import { Plugin, } from "@lapis-notes/api";
+import { Plugin, Notice, } from "@lapis-notes/api";
 import { DEFAULT_GRAPH_SETTINGS, loadPersistedGraphSettings, mergeGraphSettings, serializeGraphSettings, } from "./graph-settings";
 import { GraphDataCoordinator, } from "./graph-data-coordinator";
 import { filterGraphBySettings } from "./graph-data";
@@ -11,7 +11,8 @@ export class GraphPlugin extends Plugin {
     graphCoordinator;
     settings = mergeGraphSettings(DEFAULT_GRAPH_SETTINGS);
     settingsSaveTimer = null;
-    pendingSettingsSave = null;
+    releaseSettingsSave = null;
+    settingsSaveTask = null;
     graphProblems = null;
     pathQueryCache = new Map();
     constructor(app, manifest = manifestSpec) {
@@ -20,6 +21,12 @@ export class GraphPlugin extends Plugin {
     }
     async onload() {
         await this.initializeSettings();
+        this.registerEvent(this.app.configuration.on("plugin-data-updated", (event) => {
+            if (event.pluginId !== this.manifest.id ||
+                event.origin === "plugin-save")
+                return;
+            this.applySettings(loadPersistedGraphSettings(event.value).settings);
+        }));
         this.graphProblems = createGraphProblemReporter(this);
         this.register(this.graphCoordinator.subscribe((state) => {
             if (state.status === "error") {
@@ -77,21 +84,23 @@ export class GraphPlugin extends Plugin {
         if (this.settingsSaveTimer)
             clearTimeout(this.settingsSaveTimer);
         this.settingsSaveTimer = null;
-        const pending = this.pendingSettingsSave;
-        this.pendingSettingsSave = null;
-        if (pending)
-            await this.saveData(pending);
+        this.releaseSettingsSave?.(true);
+        this.releaseSettingsSave = null;
+        await this.settingsSaveTask;
     }
     getSettings() {
         return mergeGraphSettings(this.settings);
     }
     async updateSettings(nextSettings) {
+        this.applySettings(nextSettings);
+        this.scheduleSettingsSave(this.getSettings());
+    }
+    applySettings(nextSettings) {
         this.settings = mergeGraphSettings(nextSettings);
         const snapshot = this.getSettings();
         this.views.forEach((view) => {
             view.applyGraphSettings(snapshot);
         });
-        this.scheduleSettingsSave(snapshot);
     }
     subscribeToGlobalGraph(listener) {
         return this.graphCoordinator.subscribe(listener);
@@ -127,15 +136,29 @@ export class GraphPlugin extends Plugin {
         }
     }
     scheduleSettingsSave(settings) {
-        this.pendingSettingsSave = serializeGraphSettings(settings);
         if (this.settingsSaveTimer)
             clearTimeout(this.settingsSaveTimer);
+        this.releaseSettingsSave?.(false);
+        const snapshot = serializeGraphSettings(settings);
+        let release;
+        const ready = new Promise((resolve) => {
+            release = resolve;
+        });
+        this.releaseSettingsSave = release;
+        const persist = async () => {
+            if (await ready)
+                await this.saveData(snapshot);
+        };
+        this.settingsSaveTask = this.app.vault.supportsConditionalTextWrites
+            ? this.app.fileEditingSessions.track(persist)
+            : persist();
+        void this.settingsSaveTask.catch((error) => {
+            new Notice(`Graph settings could not be saved: ${error instanceof Error ? error.message : String(error)}`, undefined, this.app);
+        });
         this.settingsSaveTimer = setTimeout(() => {
             this.settingsSaveTimer = null;
-            const pending = this.pendingSettingsSave;
-            this.pendingSettingsSave = null;
-            if (pending)
-                void this.saveData(pending);
+            this.releaseSettingsSave = null;
+            release(true);
         }, 180);
     }
     matchSearchPaths(query) {

package/manifest.json

@@ -1,11 +1,12 @@
 {
   "id": "lapis-graph",
   "name": "Graph",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "minAppVersion": "0.1.0",
   "description": "Global and local graph views powered by indexed metadata",
   "author": "Lapis Notes",
   "authorUrl": "https://app.lapis.md",
+  "authorAvatarUrl": "https://gravatar.com/avatar/f7226d5f9cf07af2a6a60d3ab11413abb9d2e2eb60f2d5cce17356845a166155?size=256&d=initials",
   "isDesktopOnly": false,
   "lapis": {
     "manifestVersion": 1,
@@ -20,7 +21,23 @@
           "sharedDependencies": [
             "@lapis-notes/api",
             "@lapis-notes/api/telemetry",
-            "@lapis-notes/markdown/embed"
+            "@lapis-notes/markdown/embed",
+            "@codemirror/autocomplete",
+            "@codemirror/commands",
+            "@codemirror/language",
+            "@codemirror/lint",
+            "@codemirror/state",
+            "@codemirror/view",
+            "@lezer/common",
+            "@lezer/highlight",
+            "@lezer/lr",
+            "svelte/renderer/5.56.10",
+            "svelte/renderer/5.56.10/attachments",
+            "svelte/renderer/5.56.10/events",
+            "svelte/renderer/5.56.10/internal/client",
+            "svelte/renderer/5.56.10/internal/disclose-version",
+            "svelte/renderer/5.56.10/internal/flags/legacy",
+            "svelte/renderer/5.56.10/reactivity"
           ],
           "requiresReloadOnUpdate": false
         }

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@lapis-notes/graph",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Lapis Notes global and local graph plugin",
-  "license": "AGPL-3.0-or-later",
+  "license": "Apache-2.0",
   "type": "module",
   "files": [
     "dist",
     "manifest.json",
     "registry.json",
+    "registry-content",
     "styles.css",
     "README.md",
     "CHANGELOG.md",
@@ -41,17 +42,26 @@
     "./registry.json": "./registry.json"
   },
   "dependencies": {
-    "@lapismd/design-core": "^0.1.0",
+    "@lapismd/design-core": "^0.7.0",
     "@lucide/svelte": "^0.523.0",
     "d3-force": "^3.0.0"
   },
   "peerDependencies": {
-    "@lapis-notes/api": "^0.1.0",
-    "@lapis-notes/markdown": "^0.1.2",
+    "@codemirror/autocomplete": "^6.18.6",
+    "@codemirror/commands": "^6.8.1",
+    "@codemirror/language": "^6.11.3",
+    "@codemirror/lint": "^6.8.5",
+    "@codemirror/state": "^6.6.0",
+    "@codemirror/view": "^6.42.1",
+    "@lapis-notes/api": "^0.2.0",
+    "@lapis-notes/markdown": "^0.2.0",
+    "@lezer/common": "^1.5.2",
+    "@lezer/highlight": "^1.2.3",
+    "@lezer/lr": "^1.4.2",
     "svelte": "^5.0.0"
   },
   "devDependencies": {
-    "@lapis-notes/markdown": "^0.1.2",
+    "@lapis-notes/markdown": "^0.2.0",
     "@sveltejs/package": "^2.5.0",
     "@sveltejs/vite-plugin-svelte": "^5.1.1",
     "@tsconfig/svelte": "^5.0.5",
@@ -60,8 +70,8 @@
     "svelte": "^5.38.2",
     "svelte-check": "^4.3.1",
     "typescript": "~5.8.3",
-    "vite": "^6.4.2",
-    "vitest": "^4.1.8"
+    "vite": "^6.4.4",
+    "vitest": "^4.1.12"
   },
   "repository": {
     "type": "git",

package/registry-content/overview.md

@@ -0,0 +1,8 @@
+# Graph
+
+Graph visualizes relationships between notes, tags, and attachments using the
+vault's indexed metadata. Global Graph shows the broader network, while Local
+Graph keeps one note and its nearby connections in focus.
+
+Open connected notes directly from the canvas and tune grouping, forces, and
+time-lapse controls to make larger vaults easier to explore.

package/registry.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://registry.lapis.md/schemas/plugin-source.schema.json",
-  "schemaVersion": 1,
+  "schemaVersion": 2,
   "categories": ["graph", "visualization"],
   "highlights": [
     "Explore global and local relationships across notes, tags, and attachments.",
@@ -8,5 +8,142 @@
     "Tune grouping, forces, and time-lapse views for large vaults."
   ],
   "documentationUrl": "https://github.com/lapismd/lapis-plugins/tree/main/packages/graph#readme",
-  "content": { "overview": "README.md", "changelog": "CHANGELOG.md" }
+  "appearance": {
+    "icon": "network",
+    "accent": "#8B5CF6"
+  },
+  "media": {
+    "banner": {
+      "alt": "Lapis Graph with Explorer on the left, a connected Global Graph in the main workspace, and Local Graph on the right.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/banner.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/banner.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/banner.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/banner.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-graph-registry-screenshots--overview",
+        "focus": "full-shell"
+      }
+    },
+    "overview": {
+      "alt": "Focused Lapis Global Graph showing connected notes, tags, attachments, and unresolved links.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/overview.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/overview.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/overview.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/overview.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-graph-registry-screenshots--global-graph",
+        "focus": "full-shell"
+      }
+    }
+  },
+  "gallery": [
+    {
+      "id": "global-graph",
+      "alt": "Focused global graph showing a richly connected project network with notes, tags, attachments, and unresolved links.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/gallery/global-graph.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/gallery/global-graph.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/gallery/global-graph.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/gallery/global-graph.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-graph-registry-screenshots--global-graph",
+        "focus": "full-shell"
+      },
+      "card": {
+        "headline": [
+          {
+            "text": "See how your vault",
+            "tone": "neutral"
+          },
+          {
+            "text": "connects",
+            "tone": "violet"
+          }
+        ],
+        "description": [
+          {
+            "text": "Explore notes, tags, attachments, and",
+            "tone": "neutral"
+          },
+          {
+            "text": "unresolved links",
+            "tone": "rose"
+          },
+          {
+            "text": "in a live global map.",
+            "tone": "cyan"
+          }
+        ]
+      }
+    },
+    {
+      "id": "local-graph",
+      "alt": "Local graph sidebar focused on the active Welcome note and its connected project notes and tags.",
+      "images": {
+        "preview": {
+          "path": "registry-assets/gallery/local-graph.preview.webp"
+        },
+        "full": {
+          "path": "registry-assets/gallery/local-graph.full.webp"
+        },
+        "light": {
+          "path": "registry-assets/gallery/local-graph.light.webp"
+        },
+        "dark": {
+          "path": "registry-assets/gallery/local-graph.dark.webp"
+        }
+      },
+      "capture": {
+        "storyId": "plugins-graph-registry-screenshots--local-graph",
+        "focus": "right-sidebar"
+      },
+      "card": {
+        "headline": [
+          {
+            "text": "Focus on what is",
+            "tone": "neutral"
+          },
+          {
+            "text": "nearby",
+            "tone": "cyan"
+          }
+        ],
+        "description": [
+          {
+            "text": "Follow the active note and its closest relationships without losing your writing context.",
+            "tone": "neutral"
+          }
+        ]
+      }
+    }
+  ]
 }