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

package/dist/core/nodes/CaseNode.js

@@ -0,0 +1,81 @@
+/**
+ * CaseNode - contract for CASE node
+ *
+ * Represents a case clause in a switch statement.
+ *
+ * ID format (legacy): {file}:CASE:{value}:{line}:{counter}
+ * Semantic ID format: {file}->{scope_path}->CASE->{value}#N
+ */
+import { computeSemanticId } from '../SemanticId.js';
+export class CaseNode {
+    static TYPE = 'CASE';
+    static REQUIRED = ['file', 'line', 'column'];
+    static OPTIONAL = ['value', 'isDefault', 'fallsThrough', 'isEmpty', 'parentBranchId'];
+    /**
+     * Create CASE node (legacy ID)
+     */
+    static create(value, isDefault, fallsThrough, isEmpty, file, line, column, options = {}) {
+        if (!file)
+            throw new Error('CaseNode.create: file is required');
+        if (line === undefined)
+            throw new Error('CaseNode.create: line is required');
+        if (column === undefined)
+            throw new Error('CaseNode.create: column is required');
+        const valueName = isDefault ? 'default' : String(value);
+        const counter = options.counter !== undefined ? `:${options.counter}` : '';
+        const id = `${file}:CASE:${valueName}:${line}${counter}`;
+        return {
+            id,
+            type: this.TYPE,
+            name: isDefault ? 'default' : `case ${String(value)}`,
+            file,
+            line,
+            column,
+            value,
+            isDefault,
+            fallsThrough,
+            isEmpty,
+            parentBranchId: options.parentBranchId
+        };
+    }
+    /**
+     * Create CASE node with semantic ID (NEW API)
+     */
+    static createWithContext(value, isDefault, fallsThrough, isEmpty, context, location, options) {
+        if (!context.file)
+            throw new Error('CaseNode.createWithContext: file is required');
+        if (location.line === undefined)
+            throw new Error('CaseNode.createWithContext: line is required');
+        if (location.column === undefined)
+            throw new Error('CaseNode.createWithContext: column is required');
+        if (options.discriminator === undefined)
+            throw new Error('CaseNode.createWithContext: discriminator is required');
+        const valueName = isDefault ? 'default' : String(value);
+        const id = computeSemanticId('CASE', valueName, context, {
+            discriminator: options.discriminator
+        });
+        return {
+            id,
+            type: this.TYPE,
+            name: isDefault ? 'default' : `case ${String(value)}`,
+            file: context.file,
+            line: location.line,
+            column: location.column,
+            value,
+            isDefault,
+            fallsThrough,
+            isEmpty,
+            parentBranchId: options.parentBranchId
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE) {
+            errors.push(`Expected type ${this.TYPE}, got ${node.type}`);
+        }
+        if (!node.file) {
+            errors.push('Missing required field: file');
+        }
+        return errors;
+    }
+}

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

@@ -1,24 +1,56 @@
 /**
  * ClassNode - contract for CLASS 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}->CLASS->{name}
+ * Example: src/models/User.js->global->CLASS->User
  */
 import type { BaseNodeRecord } from '@grafema/types';
+import { type ScopeContext, type Location } from '../SemanticId.js';
 interface ClassNodeRecord extends BaseNodeRecord {
     type: 'CLASS';
     column: number;
     exported: boolean;
     superClass?: string;
     methods: string[];
+    isInstantiationRef?: boolean;
 }
 interface ClassNodeOptions {
     exported?: boolean;
     superClass?: string;
     methods?: string[];
+    isInstantiationRef?: boolean;
+}
+/**
+ * Options for createWithContext
+ */
+interface ClassContextOptions {
+    exported?: boolean;
+    superClass?: string;
+    methods?: string[];
+    isInstantiationRef?: boolean;
 }
 export declare class ClassNode {
     static readonly TYPE: "CLASS";
-    static readonly REQUIRED: readonly ["name", "file", "line"];
-    static readonly OPTIONAL: readonly ["column", "exported", "superClass", "methods"];
+    static readonly REQUIRED: readonly ["name", "file", "line", "column"];
+    static readonly OPTIONAL: readonly ["exported", "superClass", "methods", "isInstantiationRef"];
     static create(name: string, file: string, line: number, column: number, options?: ClassNodeOptions): ClassNodeRecord;
+    /**
+     * Create CLASS node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers.
+     * Class names are unique within scope, so no discriminator needed.
+     *
+     * @param name - Class name
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Optional class properties
+     * @returns ClassNodeRecord with semantic ID
+     */
+    static createWithContext(name: string, context: ScopeContext, location: Partial<Location>, options?: ClassContextOptions): ClassNodeRecord;
     static validate(node: ClassNodeRecord): string[];
 }
 export type { ClassNodeRecord };

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

@@ -1 +1 @@
-{"version":3,"file":"ClassNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ClassNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,eAAgB,SAAQ,cAAc;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAExC,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,2DAA4D;IAEpF,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IAkBlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE;CAgBjD;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"ClassNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ClassNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvF,UAAU,eAAgB,SAAQ,cAAc;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAExC,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,uEAAwE;IAEhG,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IAoBlB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC3B,OAAO,GAAE,mBAAwB,GAChC,eAAe;IAwBlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE;CAgBjD;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/core/nodes/ClassNode.js

@@ -1,10 +1,18 @@
 /**
  * ClassNode - contract for CLASS 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}->CLASS->{name}
+ * Example: src/models/User.js->global->CLASS->User
  */
+import { computeSemanticId } from '../SemanticId.js';
 export class ClassNode {
     static TYPE = 'CLASS';
-    static REQUIRED = ['name', 'file', 'line'];
-    static OPTIONAL = ['column', 'exported', 'superClass', 'methods'];
+    static REQUIRED = ['name', 'file', 'line', 'column'];
+    static OPTIONAL = ['exported', 'superClass', 'methods', 'isInstantiationRef'];
     static create(name, file, line, column, options = {}) {
         if (!name)
             throw new Error('ClassNode.create: name is required');
@@ -12,16 +20,56 @@ export class ClassNode {
             throw new Error('ClassNode.create: file is required');
         if (!line)
             throw new Error('ClassNode.create: line is required');
+        if (column === undefined)
+            throw new Error('ClassNode.create: column is required');
         return {
             id: `${file}:CLASS:${name}:${line}`,
             type: this.TYPE,
             name,
             file,
             line,
-            column: column || 0,
+            column,
             exported: options.exported || false,
             superClass: options.superClass,
-            methods: options.methods || []
+            methods: options.methods || [],
+            ...(options.isInstantiationRef !== undefined && { isInstantiationRef: options.isInstantiationRef })
+        };
+    }
+    /**
+     * Create CLASS node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers.
+     * Class names are unique within scope, so no discriminator needed.
+     *
+     * @param name - Class name
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Optional class properties
+     * @returns ClassNodeRecord with semantic ID
+     */
+    static createWithContext(name, context, location, options = {}) {
+        // Validate required fields
+        if (!name)
+            throw new Error('ClassNode.createWithContext: name is required');
+        if (!context.file)
+            throw new Error('ClassNode.createWithContext: file is required');
+        if (location.line === undefined)
+            throw new Error('ClassNode.createWithContext: line is required');
+        if (location.column === undefined)
+            throw new Error('ClassNode.createWithContext: column is required');
+        // Compute semantic ID
+        const id = computeSemanticId(this.TYPE, name, context);
+        return {
+            id,
+            type: this.TYPE,
+            name,
+            file: context.file,
+            line: location.line,
+            column: location.column,
+            exported: options.exported || false,
+            superClass: options.superClass,
+            methods: options.methods || [],
+            ...(options.isInstantiationRef !== undefined && { isInstantiationRef: options.isInstantiationRef })
         };
     }
     static validate(node) {

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

@@ -15,8 +15,8 @@ interface ConstantNodeOptions {
 }
 export declare class ConstantNode {
     static readonly TYPE: "CONSTANT";
-    static readonly REQUIRED: readonly ["name", "file", "line"];
-    static readonly OPTIONAL: readonly ["column", "value", "parentScopeId"];
+    static readonly REQUIRED: readonly ["name", "file", "line", "column"];
+    static readonly OPTIONAL: readonly ["value", "parentScopeId"];
     static create(name: string, file: string, line: number, column: number, options?: ConstantNodeOptions): ConstantNodeRecord;
     static validate(node: ConstantNodeRecord): string[];
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ConstantNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ConstantNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,kBAAmB,SAAQ,cAAc;IACjD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAE3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,gDAAiD;IAEzE,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;IAoBrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;CASpD;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"ConstantNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ConstantNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,kBAAmB,SAAQ,cAAc;IACjD,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,mBAAmB;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,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,sCAAuC;IAE/D,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;IAqBrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;CASpD;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/nodes/ConstantNode.js

@@ -3,8 +3,8 @@
  */
 export class ConstantNode {
     static TYPE = 'CONSTANT';
-    static REQUIRED = ['name', 'file', 'line'];
-    static OPTIONAL = ['column', 'value', 'parentScopeId'];
+    static REQUIRED = ['name', 'file', 'line', 'column'];
+    static OPTIONAL = ['value', 'parentScopeId'];
     static create(name, file, line, column, options = {}) {
         if (!name)
             throw new Error('ConstantNode.create: name is required');
@@ -12,15 +12,17 @@ export class ConstantNode {
             throw new Error('ConstantNode.create: file is required');
         if (line === undefined)
             throw new Error('ConstantNode.create: line is required');
+        if (column === undefined)
+            throw new Error('ConstantNode.create: column is required');
         const counter = options.counter !== undefined ? `:${options.counter}` : '';
-        const id = `${file}:CONSTANT:${name}:${line}:${column || 0}${counter}`;
+        const id = `${file}:CONSTANT:${name}:${line}:${column}${counter}`;
         return {
             id,
             type: this.TYPE,
             name,
             file,
             line,
-            column: column || 0,
+            column,
             value: options.value,
             parentScopeId: options.parentScopeId
         };

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

@@ -0,0 +1,51 @@
+/**
+ * ConstructorCallNode - contract for CONSTRUCTOR_CALL node
+ *
+ * Represents a `new ClassName()` expression in code.
+ * Used for data flow: VARIABLE --ASSIGNED_FROM--> CONSTRUCTOR_CALL
+ *
+ * ID format: {file}:CONSTRUCTOR_CALL:{className}:{line}:{column}
+ * Example: src/app.js:CONSTRUCTOR_CALL:Date:42:10
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface ConstructorCallNodeRecord extends BaseNodeRecord {
+    type: 'CONSTRUCTOR_CALL';
+    className: string;
+    isBuiltin: boolean;
+    column: number;
+}
+interface ConstructorCallNodeOptions {
+    counter?: number;
+}
+export declare class ConstructorCallNode {
+    static readonly TYPE: "CONSTRUCTOR_CALL";
+    static readonly REQUIRED: readonly ["name", "file", "line", "column", "className", "isBuiltin"];
+    static readonly OPTIONAL: readonly [];
+    /**
+     * Check if a class name is a built-in JavaScript constructor
+     */
+    static isBuiltinConstructor(className: string): boolean;
+    /**
+     * Generate ID for CONSTRUCTOR_CALL node
+     *
+     * @param className - Name of the constructor
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Optional counter for disambiguation
+     */
+    static generateId(className: string, file: string, line: number, column: number, options?: ConstructorCallNodeOptions): string;
+    /**
+     * Create CONSTRUCTOR_CALL node
+     *
+     * @param className - Name of the constructor (e.g., 'Date', 'MyClass')
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Optional counter for disambiguation
+     */
+    static create(className: string, file: string, line: number, column: number, options?: ConstructorCallNodeOptions): ConstructorCallNodeRecord;
+    static validate(node: ConstructorCallNodeRecord): string[];
+}
+export type { ConstructorCallNodeRecord };
+//# sourceMappingURL=ConstructorCallNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConstructorCallNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ConstructorCallNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,yBAA0B,SAAQ,cAAc;IACxD,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,0BAA0B;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAwGD,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,kBAAkB,CAAU;IAEnD,MAAM,CAAC,QAAQ,CAAC,QAAQ,wEAAyE;IACjG,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAe;IAEvC;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvD;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,0BAA+B,GACvC,MAAM;IAKT;;;;;;;;OAQG;IACH,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,0BAA+B,GACvC,yBAAyB;IAqB5B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,EAAE;CAoB3D;AAED,YAAY,EAAE,yBAAyB,EAAE,CAAC"}

package/dist/core/nodes/ConstructorCallNode.js

@@ -0,0 +1,171 @@
+/**
+ * ConstructorCallNode - contract for CONSTRUCTOR_CALL node
+ *
+ * Represents a `new ClassName()` expression in code.
+ * Used for data flow: VARIABLE --ASSIGNED_FROM--> CONSTRUCTOR_CALL
+ *
+ * ID format: {file}:CONSTRUCTOR_CALL:{className}:{line}:{column}
+ * Example: src/app.js:CONSTRUCTOR_CALL:Date:42:10
+ */
+/**
+ * List of built-in JavaScript constructors
+ * These are globally available and don't require imports
+ */
+const BUILTIN_CONSTRUCTORS = new Set([
+    // Fundamental objects
+    'Object',
+    'Function',
+    'Boolean',
+    'Symbol',
+    // Error types
+    'Error',
+    'EvalError',
+    'RangeError',
+    'ReferenceError',
+    'SyntaxError',
+    'TypeError',
+    'URIError',
+    'AggregateError',
+    // Numbers and dates
+    'Number',
+    'BigInt',
+    'Math',
+    'Date',
+    // Text processing
+    'String',
+    'RegExp',
+    // Indexed collections
+    'Array',
+    'Int8Array',
+    'Uint8Array',
+    'Uint8ClampedArray',
+    'Int16Array',
+    'Uint16Array',
+    'Int32Array',
+    'Uint32Array',
+    'Float32Array',
+    'Float64Array',
+    'BigInt64Array',
+    'BigUint64Array',
+    // Keyed collections
+    'Map',
+    'Set',
+    'WeakMap',
+    'WeakSet',
+    'WeakRef',
+    // Structured data
+    'ArrayBuffer',
+    'SharedArrayBuffer',
+    'DataView',
+    'Atomics',
+    'JSON',
+    // Control abstraction
+    'Promise',
+    'Generator',
+    'GeneratorFunction',
+    'AsyncFunction',
+    'AsyncGenerator',
+    'AsyncGeneratorFunction',
+    // Reflection
+    'Reflect',
+    'Proxy',
+    // Internationalization
+    'Intl',
+    // Web APIs (commonly used)
+    'URL',
+    'URLSearchParams',
+    'Headers',
+    'Request',
+    'Response',
+    'FormData',
+    'Blob',
+    'File',
+    'FileReader',
+    'AbortController',
+    'TextEncoder',
+    'TextDecoder',
+    'Event',
+    'CustomEvent',
+    'EventTarget',
+    'WebSocket',
+    'Worker',
+    'MessageChannel',
+    'MessagePort',
+    'BroadcastChannel',
+    'ReadableStream',
+    'WritableStream',
+    'TransformStream',
+    'CompressionStream',
+    'DecompressionStream',
+]);
+export class ConstructorCallNode {
+    static TYPE = 'CONSTRUCTOR_CALL';
+    static REQUIRED = ['name', 'file', 'line', 'column', 'className', 'isBuiltin'];
+    static OPTIONAL = [];
+    /**
+     * Check if a class name is a built-in JavaScript constructor
+     */
+    static isBuiltinConstructor(className) {
+        return BUILTIN_CONSTRUCTORS.has(className);
+    }
+    /**
+     * Generate ID for CONSTRUCTOR_CALL node
+     *
+     * @param className - Name of the constructor
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Optional counter for disambiguation
+     */
+    static generateId(className, file, line, column, options = {}) {
+        const counter = options.counter !== undefined ? `:${options.counter}` : '';
+        return `${file}:CONSTRUCTOR_CALL:${className}:${line}:${column}${counter}`;
+    }
+    /**
+     * Create CONSTRUCTOR_CALL node
+     *
+     * @param className - Name of the constructor (e.g., 'Date', 'MyClass')
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Optional counter for disambiguation
+     */
+    static create(className, file, line, column, options = {}) {
+        if (!className)
+            throw new Error('ConstructorCallNode.create: className is required');
+        if (!file)
+            throw new Error('ConstructorCallNode.create: file is required');
+        if (line === undefined)
+            throw new Error('ConstructorCallNode.create: line is required');
+        if (column === undefined)
+            throw new Error('ConstructorCallNode.create: column is required');
+        const id = this.generateId(className, file, line, column, options);
+        const isBuiltin = this.isBuiltinConstructor(className);
+        return {
+            id,
+            type: this.TYPE,
+            name: `new ${className}()`,
+            className,
+            isBuiltin,
+            file,
+            line,
+            column
+        };
+    }
+    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] === undefined || nodeRecord[field] === null) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        if (typeof node.isBuiltin !== 'boolean') {
+            errors.push('isBuiltin must be a boolean');
+        }
+        return errors;
+    }
+}

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

@@ -4,6 +4,7 @@
 import type { BaseNodeRecord } from '@grafema/types';
 interface DatabaseQueryNodeRecord extends BaseNodeRecord {
     type: 'DATABASE_QUERY';
+    column: number;
     query?: string;
     operation: string;
     parentScopeId?: string;
@@ -13,9 +14,9 @@ interface DatabaseQueryNodeOptions {
 }
 export declare class DatabaseQueryNode {
     static readonly TYPE: "DATABASE_QUERY";
-    static readonly REQUIRED: readonly ["name", "file", "line"];
+    static readonly REQUIRED: readonly ["name", "file", "line", "column"];
     static readonly OPTIONAL: readonly ["query", "operation", "parentScopeId"];
-    static create(query: string | undefined, operation: string | undefined, file: string, line: number, options?: DatabaseQueryNodeOptions): DatabaseQueryNodeRecord;
+    static create(query: string | undefined, operation: string | undefined, file: string, line: number, column: number, options?: DatabaseQueryNodeOptions): DatabaseQueryNodeRecord;
     static validate(node: DatabaseQueryNodeRecord): string[];
 }
 export type { DatabaseQueryNodeRecord };

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

@@ -1 +1 @@
-{"version":3,"file":"DatabaseQueryNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/DatabaseQueryNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,uBAAwB,SAAQ,cAAc;IACtD,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,wBAAwB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAEjD,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,mDAAoD;IAE5E,MAAM,CAAC,MAAM,CACX,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,uBAAuB;IAmB1B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,EAAE;CASzD;AAED,YAAY,EAAE,uBAAuB,EAAE,CAAC"}
+{"version":3,"file":"DatabaseQueryNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/DatabaseQueryNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,uBAAwB,SAAQ,cAAc;IACtD,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,wBAAwB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAEjD,MAAM,CAAC,QAAQ,CAAC,QAAQ,8CAA+C;IACvE,MAAM,CAAC,QAAQ,CAAC,QAAQ,mDAAoD;IAE5E,MAAM,CAAC,MAAM,CACX,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,uBAAuB;IAqB1B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,EAAE;CASzD;AAED,YAAY,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/core/nodes/DatabaseQueryNode.js

@@ -3,13 +3,15 @@
  */
 export class DatabaseQueryNode {
     static TYPE = 'DATABASE_QUERY';
-    static REQUIRED = ['name', 'file', 'line'];
+    static REQUIRED = ['name', 'file', 'line', 'column'];
     static OPTIONAL = ['query', 'operation', 'parentScopeId'];
-    static create(query, operation, file, line, options = {}) {
+    static create(query, operation, file, line, column, options = {}) {
         if (!file)
             throw new Error('DatabaseQueryNode.create: file is required');
         if (line === undefined)
             throw new Error('DatabaseQueryNode.create: line is required');
+        if (column === undefined)
+            throw new Error('DatabaseQueryNode.create: column is required');
         const name = query || `${operation || 'QUERY'}`;
         const id = `${file}:DATABASE_QUERY:${name}:${line}`;
         return {
@@ -20,6 +22,7 @@ export class DatabaseQueryNode {
             operation: operation || 'UNKNOWN',
             file,
             line,
+            column,
             parentScopeId: options.parentScopeId
         };
     }

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

@@ -0,0 +1,42 @@
+/**
+ * DecoratorNode - contract for DECORATOR node
+ *
+ * Represents TypeScript/JavaScript decorators applied to
+ * classes, methods, properties, or parameters.
+ *
+ * ID format: {file}:DECORATOR:{name}:{line}:{column}
+ * Example: /src/services/UserService.ts:DECORATOR:Injectable:5:0
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+type DecoratorTargetType = 'CLASS' | 'METHOD' | 'PROPERTY' | 'PARAMETER';
+interface DecoratorNodeRecord extends BaseNodeRecord {
+    type: 'DECORATOR';
+    column: number;
+    arguments: unknown[];
+    targetId: string;
+    targetType: DecoratorTargetType;
+}
+interface DecoratorNodeOptions {
+    arguments?: unknown[];
+}
+export declare class DecoratorNode {
+    static readonly TYPE: "DECORATOR";
+    static readonly REQUIRED: readonly ["name", "file", "line", "column", "targetId", "targetType"];
+    static readonly OPTIONAL: readonly ["arguments"];
+    /**
+     * Create DECORATOR node
+     *
+     * @param name - Decorator name
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param targetId - ID of decorated element
+     * @param targetType - Type of decorated element
+     * @param options - Optional decorator properties
+     * @returns DecoratorNodeRecord
+     */
+    static create(name: string, file: string, line: number, column: number, targetId: string, targetType: DecoratorTargetType, options?: DecoratorNodeOptions): DecoratorNodeRecord;
+    static validate(node: DecoratorNodeRecord): string[];
+}
+export type { DecoratorNodeRecord, DecoratorTargetType };
+//# sourceMappingURL=DecoratorNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DecoratorNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/DecoratorNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,KAAK,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzE,UAAU,mBAAoB,SAAQ,cAAc;IAClD,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAE5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,wEAAyE;IACjG,MAAM,CAAC,QAAQ,CAAC,QAAQ,yBAA0B;IAElD;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;IAqBtB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE;CAgBrD;AAED,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC"}