@jotx-labs/core 2.2.0 → 2.4.82

package/dist/types/nodeManager.d.ts

@@ -0,0 +1,86 @@
+/**
+ * NodeManager - Core types and interfaces
+ * Platform-agnostic definitions for node management
+ */
+/**
+ * Represents a single node (block) in the knowledge graph
+ */
+export interface NodeEntry {
+    /** Unique identifier (shortUUID) - MUST be unique across entire workspace */
+    id: string;
+    /** Block type (def, mermaid, heading, paragraph, etc.) */
+    type: string;
+    /** Absolute path to the .jot file containing this node */
+    filePath: string;
+    /** Display label (def name, heading text, etc.) */
+    label: string;
+    /** Block properties from AST */
+    properties: Record<string, any>;
+    /** Content for preview (text/src/json) */
+    content?: string;
+    /** Parent node ID (for def hierarchy) */
+    parentId?: string;
+    /** Child node IDs (for def hierarchy) */
+    children: string[];
+}
+/**
+ * Represents a def block in the hierarchy tree
+ */
+export interface DefTreeNode {
+    /** ID of the NodeEntry */
+    nodeId: string;
+    /** Child def nodes */
+    children: DefTreeNode[];
+}
+/**
+ * Platform-agnostic NodeManager interface
+ * Implemented by VSCodeNodeManager, BrowserNodeManager, etc.
+ */
+export interface INodeManager {
+    /**
+     * Get node by ID - O(1)
+     */
+    getNode(id: string): NodeEntry | undefined;
+    /**
+     * Get all nodes in a file - O(1)
+     */
+    getNodesByFile(filePath: string): NodeEntry[];
+    /**
+     * Get all nodes of a type - O(1)
+     */
+    getNodesByType(type: string): NodeEntry[];
+    /**
+     * Get def tree for a document
+     */
+    getDefTree(filePath: string): DefTreeNode | undefined;
+    /**
+     * Get nodes this node links to
+     */
+    getLinkedNodes(nodeId: string): NodeEntry[];
+    /**
+     * Get nodes that link to this node (backlinks)
+     */
+    getBacklinks(nodeId: string): NodeEntry[];
+    /**
+     * Validate unique IDs across workspace
+     * @returns Map of duplicate IDs to file paths
+     */
+    validateUniqueIds(): Map<string, string[]>;
+    /**
+     * Re-index a specific file
+     */
+    reindexFile(filePath: string): Promise<void>;
+    /**
+     * Full workspace reindex
+     */
+    fullReindex(): Promise<void>;
+}
+/**
+ * Event emitted when graph changes
+ */
+export interface NodeManagerChangeEvent {
+    type: 'add' | 'update' | 'delete';
+    nodeIds: string[];
+    filePath: string;
+}
+//# sourceMappingURL=nodeManager.d.ts.map

package/dist/types/nodeManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeManager.d.ts","sourceRoot":"","sources":["../../src/types/nodeManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAA;IAEV,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IAEZ,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAA;IAEhB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAA;IAEb,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE/B,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IAEd,sBAAsB;IACtB,QAAQ,EAAE,WAAW,EAAE,CAAA;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAA;IAE1C;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;IAE7C;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;IAEzC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAA;IAErD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;IAE3C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAAA;IAEzC;;;OAGG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IAE1C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACjC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACnB"}

package/dist/types/nodeManager.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * NodeManager - Core types and interfaces
+ * Platform-agnostic definitions for node management
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=nodeManager.js.map

package/dist/types/nodeManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodeManager.js","sourceRoot":"","sources":["../../src/types/nodeManager.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jotx-labs/core",
-  "version": "2.2.0",
+  "version": "2.4.82",
   "files": [
     "dist"
   ],
@@ -25,7 +25,7 @@
     "jotx"
   ],
   "author": "jotx",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
@@ -36,6 +36,6 @@
   "dependencies": {
     "@types/marked": "^6.0.0",
     "marked": "^17.0.1",
-    "@jotx/registry": "file:../registry"
+    "@jotx-labs/registry": "file:../registry"
   }
-}
+}