Added per node metadata cache info. Updated documentation

Author: Developer-Mike

README.md

@@ -130,6 +130,7 @@ Advanced Canvas enables .canvas files to be indexed by the metadata cache. This
 - The metadata cache is located in the `app.metadataCache` object - the same object that is used by Obsidian for markdown files
   - e.g. `app.metadataCache.getCache`/`app.metadataCache.getFileCache` now works with .canvas files
   - The `position` object which is found inside metadata cache entries now contains a new key `nodeId` for .canvas files
+  - The metadata cache entry for a .canvas file now contains a new key `nodes` which is an object of type `{ [nodeId: string]: MetadataCacheEntry }` - this allows for other plugins to access the full metadata cache for single nodes. The `MetadataCacheEntry` object is the same as for markdown files (even created with the same function - 1:1 compatibility)
 - The resolved links object now has entries for .canvas files
   - The `app.metadataCache.resolvedLinks` object values for .canvas files are implemented in the exact same way as for markdown files
 

src/@types/Obsidian.d.ts

@@ -94,6 +94,12 @@ export interface MetadataCacheEntry {
   v: number
 }
 
+export interface MetadataCacheCanvasEntry extends MetadataCacheEntry {
+  nodes: {
+    [nodeId: string]: MetadataCacheEntry
+  }
+}
+
 export interface ResolvedLinks {
   [path: string]: {
     [link: string]: number

src/patchers/metadata-cache-patcher.ts

@@ -1,6 +1,6 @@
 import { TFile } from "obsidian"
 import { CanvasData, CanvasNodeData } from "src/@types/Canvas"
-import { CanvasPos, FileCacheEntry, MetadataCacheEntry, MetadataCacheMap, ResolvedLinks } from "src/@types/Obsidian"
+import { MetadataCacheCanvasEntry, MetadataCacheEntry, MetadataCacheMap } from "src/@types/Obsidian"
 import HashHelper from "src/utils/hash-helper"
 import PatchHelper from "src/utils/patch-helper"
 import PathHelper from "src/utils/path-helper"
@@ -44,12 +44,13 @@ export default class MetadataCachePatcher extends Patcher {
         // Extract canvas file node embeds
         const fileNodesEmbeds = content.nodes
           .filter((node: CanvasNodeData) => node.type === 'file' && node.file)
-          .map((node: CanvasNodeData) => ({
-            link: node.file,
-            original: node.file,
-            displayText: node.file,
+          .map((node: CanvasNodeData) => [node.id, node.file] as [string, string])
+          .map(([nodeId, file]) => ({
+            link: file,
+            original: file,
+            displayText: file,
             position: {
-              nodeId: node.id,
+              nodeId: nodeId,
               start: { line: 0, col: 0, offset: 0 },
               end: { line: 0, col: 0, offset: 0 }
             }
@@ -99,8 +100,14 @@ export default class MetadataCachePatcher extends Patcher {
           ],
           links: [
             ...textNodesLinks
-          ]
-        } as MetadataCacheEntry
+          ],
+          nodes: {
+            ...textNodesMetadata.reduce((acc, metadata, index) => {
+              acc[textNodesIds[index]] = metadata
+              return acc
+            }, {} as Record<string, MetadataCacheEntry>)
+          }
+        } satisfies MetadataCacheCanvasEntry as MetadataCacheEntry
 
         // Trigger metadata cache change event
         this.trigger('changed', file, "", this.metadataCache[fileHash])