@grafema/core 0.1.0-alpha.5 → 0.2.0-beta

package/dist/core/nodes/ExternalModuleNode.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ExternalModuleNode - contract for EXTERNAL_MODULE node
+ *
+ * Represents external npm packages or Node.js built-in modules
+ * that are imported but not analyzed.
+ *
+ * ID format: EXTERNAL_MODULE:{source}
+ * Example: EXTERNAL_MODULE:lodash, EXTERNAL_MODULE:@tanstack/react-query
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface ExternalModuleNodeRecord extends BaseNodeRecord {
+    type: 'EXTERNAL_MODULE';
+}
+export declare class ExternalModuleNode {
+    static readonly TYPE: "EXTERNAL_MODULE";
+    static readonly REQUIRED: readonly ["name"];
+    static readonly OPTIONAL: readonly [];
+    /**
+     * Create EXTERNAL_MODULE node
+     *
+     * Normalizes node: prefix for Node.js builtins:
+     * - 'node:fs' -> 'fs'
+     * - 'node:path' -> 'path'
+     *
+     * @param source - Module name (e.g., 'lodash', '@tanstack/react-query', 'node:fs')
+     * @returns ExternalModuleNodeRecord
+     */
+    static create(source: string): ExternalModuleNodeRecord;
+    static validate(node: ExternalModuleNodeRecord): string[];
+}
+export type { ExternalModuleNodeRecord };
+//# sourceMappingURL=ExternalModuleNode.d.ts.map

package/dist/core/nodes/ExternalModuleNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExternalModuleNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExternalModuleNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,wBAAyB,SAAQ,cAAc;IACvD,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,iBAAiB,CAAU;IAElD,MAAM,CAAC,QAAQ,CAAC,QAAQ,oBAAqB;IAC7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAe;IAEvC;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,wBAAwB;IAiBvD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,EAAE;CAa1D;AAED,YAAY,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/core/nodes/ExternalModuleNode.js

@@ -0,0 +1,49 @@
+/**
+ * ExternalModuleNode - contract for EXTERNAL_MODULE node
+ *
+ * Represents external npm packages or Node.js built-in modules
+ * that are imported but not analyzed.
+ *
+ * ID format: EXTERNAL_MODULE:{source}
+ * Example: EXTERNAL_MODULE:lodash, EXTERNAL_MODULE:@tanstack/react-query
+ */
+export class ExternalModuleNode {
+    static TYPE = 'EXTERNAL_MODULE';
+    static REQUIRED = ['name'];
+    static OPTIONAL = [];
+    /**
+     * Create EXTERNAL_MODULE node
+     *
+     * Normalizes node: prefix for Node.js builtins:
+     * - 'node:fs' -> 'fs'
+     * - 'node:path' -> 'path'
+     *
+     * @param source - Module name (e.g., 'lodash', '@tanstack/react-query', 'node:fs')
+     * @returns ExternalModuleNodeRecord
+     */
+    static create(source) {
+        if (!source)
+            throw new Error('ExternalModuleNode.create: source is required');
+        // Normalize node: prefix for Node.js builtins
+        const normalizedSource = source.startsWith('node:')
+            ? source.slice(5)
+            : source;
+        return {
+            id: `EXTERNAL_MODULE:${normalizedSource}`,
+            type: this.TYPE,
+            name: normalizedSource,
+            file: '',
+            line: 0
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        if (!node.name) {
+            errors.push('Missing required field: name');
+        }
+        return errors;
+    }
+}

package/dist/core/nodes/ExternalStdioNode.d.ts

@@ -1,15 +1,22 @@
 /**
- * ExternalStdioNode - contract for EXTERNAL_STDIO node (singleton)
+ * ExternalStdioNode - contract for net:stdio node (singleton)
+ *
+ * Represents standard I/O streams (console.log, console.error, etc.)
+ * Singleton node - only one instance per graph.
+ *
+ * Uses namespaced type 'net:stdio' for semantic grouping - AI agents
+ * can query all I/O-related nodes via 'net:*' pattern.
  */
 import type { BaseNodeRecord } from '@grafema/types';
 interface ExternalStdioNodeRecord extends BaseNodeRecord {
-    type: 'EXTERNAL_STDIO';
+    type: 'net:stdio';
+    description?: string;
 }
 export declare class ExternalStdioNode {
-    static readonly TYPE: "EXTERNAL_STDIO";
-    static readonly SINGLETON_ID = "EXTERNAL_STDIO:__stdio__";
-    static readonly REQUIRED: readonly ["name", "file"];
-    static readonly OPTIONAL: readonly [];
+    static readonly TYPE: "net:stdio";
+    static readonly SINGLETON_ID = "net:stdio#__stdio__";
+    static readonly REQUIRED: readonly ["name"];
+    static readonly OPTIONAL: readonly ["description"];
     static create(): ExternalStdioNodeRecord;
     static validate(node: ExternalStdioNodeRecord): string[];
 }

package/dist/core/nodes/ExternalStdioNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExternalStdioNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExternalStdioNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,uBAAwB,SAAQ,cAAc;IACtD,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IACjD,MAAM,CAAC,QAAQ,CAAC,YAAY,8BAA8B;IAE1D,MAAM,CAAC,QAAQ,CAAC,QAAQ,4BAA6B;IACrD,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAe;IAEvC,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAUxC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,EAAE;CAMzD;AAED,YAAY,EAAE,uBAAuB,EAAE,CAAC"}
+{"version":3,"file":"ExternalStdioNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ExternalStdioNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,uBAAwB,SAAQ,cAAc;IACtD,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAC5C,MAAM,CAAC,QAAQ,CAAC,YAAY,yBAAyB;IAErD,MAAM,CAAC,QAAQ,CAAC,QAAQ,oBAAqB;IAC7C,MAAM,CAAC,QAAQ,CAAC,QAAQ,2BAA4B;IAEpD,MAAM,CAAC,MAAM,IAAI,uBAAuB;IAWxC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,EAAE;CAMzD;AAED,YAAY,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/core/nodes/ExternalStdioNode.js

@@ -1,26 +1,33 @@
 /**
- * ExternalStdioNode - contract for EXTERNAL_STDIO node (singleton)
+ * ExternalStdioNode - contract for net:stdio node (singleton)
+ *
+ * Represents standard I/O streams (console.log, console.error, etc.)
+ * Singleton node - only one instance per graph.
+ *
+ * Uses namespaced type 'net:stdio' for semantic grouping - AI agents
+ * can query all I/O-related nodes via 'net:*' pattern.
  */
 export class ExternalStdioNode {
-    static TYPE = 'EXTERNAL_STDIO';
-    static SINGLETON_ID = 'EXTERNAL_STDIO:__stdio__';
-    static REQUIRED = ['name', 'file'];
-    static OPTIONAL = [];
+    static TYPE = 'net:stdio';
+    static SINGLETON_ID = 'net:stdio#__stdio__';
+    static REQUIRED = ['name'];
+    static OPTIONAL = ['description'];
     static create() {
         return {
             id: this.SINGLETON_ID,
             type: this.TYPE,
             name: '__stdio__',
             file: '__builtin__',
-            line: 0
+            line: 0,
+            description: 'Standard input/output stream'
         };
     }
     static validate(node) {
         const errors = [];
         if (node.type !== this.TYPE)
-            errors.push(`Expected type ${this.TYPE}`);
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
         if (node.id !== this.SINGLETON_ID)
-            errors.push(`Invalid singleton ID`);
+            errors.push(`Invalid singleton ID: ${node.id}, expected ${this.SINGLETON_ID}`);
         return errors;
     }
 }

package/dist/core/nodes/FunctionNode.d.ts

@@ -1,7 +1,18 @@
 /**
  * FunctionNode - contract for FUNCTION node
+ *
+ * Supports two creation modes:
+ * 1. createWithContext() - NEW: Uses ScopeContext + Location for semantic IDs
+ * 2. create() - LEGACY: Uses line-based IDs for backward compatibility
+ *
+ * Semantic ID format: {file}->{scope_path}->FUNCTION->{name}
+ * Example: src/app.js->global->FUNCTION->processData
  */
 import type { FunctionNodeRecord } from '@grafema/types';
+import { type ScopeContext, type Location } from '../SemanticId.js';
+/**
+ * Options for function node creation
+ */
 interface FunctionNodeOptions {
     async?: boolean;
     generator?: boolean;
@@ -13,6 +24,18 @@ interface FunctionNodeOptions {
     params?: string[];
     counter?: number;
 }
+/**
+ * Options specific to createWithContext
+ */
+interface FunctionNodeContextOptions {
+    async?: boolean;
+    generator?: boolean;
+    exported?: boolean;
+    arrowFunction?: boolean;
+    isClassMethod?: boolean;
+    className?: string;
+    params?: string[];
+}
 export declare class FunctionNode {
     static readonly TYPE: "FUNCTION";
     static readonly REQUIRED: readonly ["name", "file", "line", "column"];
@@ -21,6 +44,19 @@ export declare class FunctionNode {
      * Create FUNCTION node
      */
     static create(name: string, file: string, line: number, column: number, options?: FunctionNodeOptions): FunctionNodeRecord;
+    /**
+     * Create FUNCTION node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers that
+     * don't change when unrelated code is added/removed.
+     *
+     * @param name - Function name (or 'anonymous[N]' for anonymous functions)
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Optional function properties
+     * @returns FunctionNodeRecord with semantic ID
+     */
+    static createWithContext(name: string, context: ScopeContext, location: Partial<Location>, options?: FunctionNodeContextOptions): FunctionNodeRecord;
     static validate(node: FunctionNodeRecord): string[];
 }
 export {};

package/dist/core/nodes/FunctionNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FunctionNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/FunctionNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAE3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,wHAAyH;IAEjJ;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,kBAAkB;IA4BrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;CAgBpD"}
+{"version":3,"file":"FunctionNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/FunctionNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvF;;GAEG;AACH,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,0BAA0B;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAE3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,wHAAyH;IAEjJ;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,kBAAkB;IA2BrB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC3B,OAAO,GAAE,0BAA+B,GACvC,kBAAkB;IA4DrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;CAgBpD"}

package/dist/core/nodes/FunctionNode.js

@@ -1,6 +1,14 @@
 /**
  * FunctionNode - contract for FUNCTION node
+ *
+ * Supports two creation modes:
+ * 1. createWithContext() - NEW: Uses ScopeContext + Location for semantic IDs
+ * 2. create() - LEGACY: Uses line-based IDs for backward compatibility
+ *
+ * Semantic ID format: {file}->{scope_path}->FUNCTION->{name}
+ * Example: src/app.js->global->FUNCTION->processData
  */
+import { computeSemanticId } from '../SemanticId.js';
 export class FunctionNode {
     static TYPE = 'FUNCTION';
     static REQUIRED = ['name', 'file', 'line', 'column'];
@@ -21,7 +29,6 @@ export class FunctionNode {
         const id = `${file}:FUNCTION:${name}:${line}:${column}${counter}`;
         return {
             id,
-            stableId: id,
             type: this.TYPE,
             name,
             file,
@@ -37,6 +44,78 @@ export class FunctionNode {
             params: options.params || []
         };
     }
+    /**
+     * Create FUNCTION node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers that
+     * don't change when unrelated code is added/removed.
+     *
+     * @param name - Function name (or 'anonymous[N]' for anonymous functions)
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Optional function properties
+     * @returns FunctionNodeRecord with semantic ID
+     */
+    static createWithContext(name, context, location, options = {}) {
+        // Validate required fields
+        if (!name)
+            throw new Error('FunctionNode.createWithContext: name is required');
+        if (!context.file)
+            throw new Error('FunctionNode.createWithContext: file is required');
+        if (location.line === undefined)
+            throw new Error('FunctionNode.createWithContext: line is required');
+        if (location.column === undefined)
+            throw new Error('FunctionNode.createWithContext: column is required');
+        // Compute semantic ID
+        const id = computeSemanticId(this.TYPE, name, context);
+        // Compute parentScopeId from context
+        // If we have a scope path, the parent is the last scope in the path
+        let parentScopeId;
+        if (context.scopePath.length > 0) {
+            // Find the most recent function/method scope to use as parent
+            // For now, we construct the parent's semantic ID from the scope path
+            const parentContext = {
+                file: context.file,
+                scopePath: context.scopePath.slice(0, -1) // Remove last scope
+            };
+            const parentScopeName = context.scopePath[context.scopePath.length - 1];
+            // Check if parent is a function/method scope (not a control flow scope)
+            if (!parentScopeName.includes('#')) {
+                // Named scope - likely a function or class
+                parentScopeId = computeSemanticId('FUNCTION', parentScopeName, parentContext);
+            }
+            else {
+                // Control flow scope - find the nearest function ancestor
+                // For simplicity, take the first non-control-flow scope from the path
+                const nonControlFlowScopes = context.scopePath.filter(s => !s.includes('#'));
+                if (nonControlFlowScopes.length > 0) {
+                    const parentName = nonControlFlowScopes[nonControlFlowScopes.length - 1];
+                    const idx = context.scopePath.indexOf(parentName);
+                    const ancestorContext = {
+                        file: context.file,
+                        scopePath: context.scopePath.slice(0, idx)
+                    };
+                    parentScopeId = computeSemanticId('FUNCTION', parentName, ancestorContext);
+                }
+            }
+        }
+        return {
+            id,
+            type: this.TYPE,
+            name,
+            file: context.file,
+            line: location.line,
+            column: location.column,
+            async: options.async || false,
+            generator: options.generator || false,
+            exported: options.exported || false,
+            arrowFunction: options.arrowFunction || false,
+            parentScopeId,
+            isClassMethod: options.isClassMethod || false,
+            className: options.className,
+            params: options.params || []
+        };
+    }
     static validate(node) {
         const errors = [];
         if (node.type !== this.TYPE) {

package/dist/core/nodes/HttpRequestNode.d.ts

@@ -4,20 +4,20 @@
 import type { BaseNodeRecord } from '@grafema/types';
 interface HttpRequestNodeRecord extends BaseNodeRecord {
     type: 'HTTP_REQUEST';
+    column: number;
     url?: string;
     method: string;
     parentScopeId?: string;
 }
 interface HttpRequestNodeOptions {
-    column?: number;
     parentScopeId?: string;
     counter?: number;
 }
 export declare class HttpRequestNode {
     static readonly TYPE: "HTTP_REQUEST";
-    static readonly REQUIRED: readonly ["name", "file", "line"];
-    static readonly OPTIONAL: readonly ["url", "method", "column", "parentScopeId"];
-    static create(url: string | undefined, method: string | undefined, file: string, line: number, options?: HttpRequestNodeOptions): HttpRequestNodeRecord;
+    static readonly REQUIRED: readonly ["name", "file", "line", "column"];
+    static readonly OPTIONAL: readonly ["url", "method", "parentScopeId"];
+    static create(url: string | undefined, method: string | undefined, file: string, line: number, column: number, options?: HttpRequestNodeOptions): HttpRequestNodeRecord;
     static validate(node: HttpRequestNodeRecord): string[];
 }
 export type { HttpRequestNodeRecord };

package/dist/core/nodes/HttpRequestNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HttpRequestNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/HttpRequestNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,qBAAsB,SAAQ,cAAc;IACpD,IAAI,EAAE,cAAc,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,sBAAsB;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAE/C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,wDAAyD;IAEjF,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,qBAAqB;IAoBxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,EAAE;CASvD;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"HttpRequestNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/HttpRequestNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,qBAAsB,SAAQ,cAAc;IACpD,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,sBAAsB;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IAE/C,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IAEvE,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,sBAA2B,GACnC,qBAAqB;IAsBxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,EAAE;CASvD;AAED,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/core/nodes/HttpRequestNode.js

@@ -3,16 +3,18 @@
  */
 export class HttpRequestNode {
     static TYPE = 'HTTP_REQUEST';
-    static REQUIRED = ['name', 'file', 'line'];
-    static OPTIONAL = ['url', 'method', 'column', 'parentScopeId'];
-    static create(url, method, file, line, options = {}) {
+    static REQUIRED = ['name', 'file', 'line', 'column'];
+    static OPTIONAL = ['url', 'method', 'parentScopeId'];
+    static create(url, method, file, line, column, options = {}) {
         if (!file)
             throw new Error('HttpRequestNode.create: file is required');
         if (line === undefined)
             throw new Error('HttpRequestNode.create: line is required');
+        if (column === undefined)
+            throw new Error('HttpRequestNode.create: column is required');
         const httpMethod = method || 'GET';
         const counter = options.counter !== undefined ? `:${options.counter}` : '';
-        const id = `${file}:HTTP_REQUEST:${httpMethod}:${line}:${options.column || 0}${counter}`;
+        const id = `${file}:HTTP_REQUEST:${httpMethod}:${line}:${column}${counter}`;
         return {
             id,
             type: this.TYPE,
@@ -21,6 +23,7 @@ export class HttpRequestNode {
             method: httpMethod,
             file,
             line,
+            column,
             parentScopeId: options.parentScopeId
         };
     }

package/dist/core/nodes/ImportNode.d.ts

@@ -2,26 +2,48 @@
  * ImportNode - contract for IMPORT node
  */
 import type { BaseNodeRecord } from '@grafema/types';
-type ImportKind = 'value' | 'type' | 'typeof';
+type ImportBinding = 'value' | 'type' | 'typeof';
+type ImportType = 'default' | 'named' | 'namespace';
 interface ImportNodeRecord extends BaseNodeRecord {
     type: 'IMPORT';
     column: number;
     source: string;
-    importKind: ImportKind;
+    importType: ImportType;
+    importBinding: ImportBinding;
     imported: string;
     local: string;
+    isDynamic?: boolean;
+    isResolvable?: boolean;
+    dynamicPath?: string;
+    sideEffect?: boolean;
 }
 interface ImportNodeOptions {
-    importKind?: ImportKind;
+    importType?: ImportType;
+    importBinding?: ImportBinding;
     imported?: string;
     local?: string;
+    isDynamic?: boolean;
+    isResolvable?: boolean;
+    dynamicPath?: string;
+    sideEffect?: boolean;
 }
 export declare class ImportNode {
     static readonly TYPE: "IMPORT";
-    static readonly REQUIRED: readonly ["name", "file", "line", "source"];
-    static readonly OPTIONAL: readonly ["column", "importKind", "imported", "local"];
+    static readonly REQUIRED: readonly ["name", "file", "line", "column", "source"];
+    static readonly OPTIONAL: readonly ["importType", "importBinding", "imported", "local", "isDynamic", "isResolvable", "dynamicPath", "sideEffect"];
+    /**
+     * Create IMPORT node
+     *
+     * @param name - The local binding name (what the import is called in this module)
+     * @param file - Absolute file path
+     * @param line - Line number (for debugging only, not part of ID)
+     * @param column - Column position (pass 0 if unavailable - JSASTAnalyzer limitation)
+     * @param source - Module source (e.g., 'react', './utils')
+     * @param options - Optional fields
+     * @returns ImportNodeRecord
+     */
     static create(name: string, file: string, line: number, column: number, source: string, options?: ImportNodeOptions): ImportNodeRecord;
     static validate(node: ImportNodeRecord): string[];
 }
-export type { ImportNodeRecord, ImportKind };
+export type { ImportNodeRecord, ImportBinding, ImportType };
 //# sourceMappingURL=ImportNode.d.ts.map

package/dist/core/nodes/ImportNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImportNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ImportNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,KAAK,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE9C,UAAU,gBAAiB,SAAQ,cAAc;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,UAAU;IACrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAEzC,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,yDAA0D;IAElF,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB;IAoBnB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE;CAgBlD;AAED,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"ImportNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ImportNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AACjD,KAAK,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAEpD,UAAU,gBAAiB,SAAQ,cAAc;IAC/C,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,iBAAiB;IACzB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,UAAU;IACrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAEzC,MAAM,CAAC,QAAQ,CAAC,QAAQ,wDAAyD;IACjF,MAAM,CAAC,QAAQ,CAAC,QAAQ,0HAA2H;IAEnJ;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB;IA+CnB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE;CAgBlD;AAED,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC"}

package/dist/core/nodes/ImportNode.js

@@ -3,29 +3,64 @@
  */
 export class ImportNode {
     static TYPE = 'IMPORT';
-    static REQUIRED = ['name', 'file', 'line', 'source'];
-    static OPTIONAL = ['column', 'importKind', 'imported', 'local'];
+    static REQUIRED = ['name', 'file', 'line', 'column', 'source'];
+    static OPTIONAL = ['importType', 'importBinding', 'imported', 'local', 'isDynamic', 'isResolvable', 'dynamicPath', 'sideEffect'];
+    /**
+     * Create IMPORT node
+     *
+     * @param name - The local binding name (what the import is called in this module)
+     * @param file - Absolute file path
+     * @param line - Line number (for debugging only, not part of ID)
+     * @param column - Column position (pass 0 if unavailable - JSASTAnalyzer limitation)
+     * @param source - Module source (e.g., 'react', './utils')
+     * @param options - Optional fields
+     * @returns ImportNodeRecord
+     */
     static create(name, file, line, column, source, options = {}) {
         if (!name)
             throw new Error('ImportNode.create: name is required');
         if (!file)
             throw new Error('ImportNode.create: file is required');
-        if (!line)
+        if (line === undefined)
             throw new Error('ImportNode.create: line is required');
+        if (column === undefined)
+            throw new Error('ImportNode.create: column is required');
         if (!source)
             throw new Error('ImportNode.create: source is required');
-        return {
-            id: `${file}:IMPORT:${name}:${line}`,
+        // Auto-detect importType from imported field if not explicitly provided
+        let importType = options.importType;
+        if (!importType && options.imported) {
+            importType = options.imported === 'default' ? 'default' :
+                options.imported === '*' ? 'namespace' : 'named';
+        }
+        const record = {
+            id: `${file}:IMPORT:${source}:${name}`, // SEMANTIC ID: no line number
             type: this.TYPE,
             name,
             file,
-            line,
-            column: column || 0,
+            line, // Stored as field, not in ID
+            column,
             source,
-            importKind: options.importKind || 'value',
+            importType: importType || 'named', // NEW field with auto-detection
+            importBinding: options.importBinding || 'value', // RENAMED field
             imported: options.imported || name,
             local: options.local || name
         };
+        // Add dynamic import fields if provided
+        if (options.isDynamic !== undefined) {
+            record.isDynamic = options.isDynamic;
+        }
+        if (options.isResolvable !== undefined) {
+            record.isResolvable = options.isResolvable;
+        }
+        if (options.dynamicPath !== undefined) {
+            record.dynamicPath = options.dynamicPath;
+        }
+        // REG-273: Add sideEffect field if provided
+        if (options.sideEffect !== undefined) {
+            record.sideEffect = options.sideEffect;
+        }
+        return record;
     }
     static validate(node) {
         const errors = [];

package/dist/core/nodes/InterfaceNode.d.ts

@@ -0,0 +1,46 @@
+/**
+ * InterfaceNode - contract for INTERFACE node
+ *
+ * Represents TypeScript interface declarations.
+ *
+ * ID format: {file}:INTERFACE:{name}:{line}
+ * Example: /src/types.ts:INTERFACE:IUser:5
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface InterfacePropertyRecord {
+    name: string;
+    type?: string;
+    optional?: boolean;
+    readonly?: boolean;
+}
+interface InterfaceNodeRecord extends BaseNodeRecord {
+    type: 'INTERFACE';
+    column: number;
+    extends: string[];
+    properties: InterfacePropertyRecord[];
+    isExternal?: boolean;
+}
+interface InterfaceNodeOptions {
+    extends?: string[];
+    properties?: InterfacePropertyRecord[];
+    isExternal?: boolean;
+}
+export declare class InterfaceNode {
+    static readonly TYPE: "INTERFACE";
+    static readonly REQUIRED: readonly ["name", "file", "line", "column"];
+    static readonly OPTIONAL: readonly ["extends", "properties", "isExternal"];
+    /**
+     * Create INTERFACE node
+     *
+     * @param name - Interface name
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Optional interface properties
+     * @returns InterfaceNodeRecord
+     */
+    static create(name: string, file: string, line: number, column: number, options?: InterfaceNodeOptions): InterfaceNodeRecord;
+    static validate(node: InterfaceNodeRecord): string[];
+}
+export type { InterfaceNodeRecord, InterfacePropertyRecord };
+//# sourceMappingURL=InterfaceNode.d.ts.map

package/dist/core/nodes/InterfaceNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/InterfaceNode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,mBAAoB,SAAQ,cAAc;IAClD,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,oBAAoB;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAE5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,mDAAoD;IAE5E;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;IAmBtB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE;CAgBrD;AAED,YAAY,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/core/nodes/InterfaceNode.js

@@ -0,0 +1,57 @@
+/**
+ * InterfaceNode - contract for INTERFACE node
+ *
+ * Represents TypeScript interface declarations.
+ *
+ * ID format: {file}:INTERFACE:{name}:{line}
+ * Example: /src/types.ts:INTERFACE:IUser:5
+ */
+export class InterfaceNode {
+    static TYPE = 'INTERFACE';
+    static REQUIRED = ['name', 'file', 'line', 'column'];
+    static OPTIONAL = ['extends', 'properties', 'isExternal'];
+    /**
+     * Create INTERFACE node
+     *
+     * @param name - Interface name
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Optional interface properties
+     * @returns InterfaceNodeRecord
+     */
+    static create(name, file, line, column, options = {}) {
+        if (!name)
+            throw new Error('InterfaceNode.create: name is required');
+        if (!file)
+            throw new Error('InterfaceNode.create: file is required');
+        if (!line)
+            throw new Error('InterfaceNode.create: line is required');
+        if (column === undefined)
+            throw new Error('InterfaceNode.create: column is required');
+        return {
+            id: `${file}:INTERFACE:${name}:${line}`,
+            type: this.TYPE,
+            name,
+            file,
+            line,
+            column,
+            extends: options.extends || [],
+            properties: options.properties || [],
+            ...(options.isExternal !== undefined && { isExternal: options.isExternal })
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        const nodeRecord = node;
+        for (const field of this.REQUIRED) {
+            if (!nodeRecord[field]) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        return errors;
+    }
+}