@grafema/util 0.3.0-beta

package/dist/core/ResourceRegistry.d.ts

@@ -0,0 +1,17 @@
+import type { Resource, ResourceId, ResourceRegistry as IResourceRegistry } from '@grafema/types';
+/**
+ * In-memory Resource registry for a single pipeline run.
+ * Created by Orchestrator at run start, cleared at run end.
+ *
+ * Thread safety: Not needed — Grafema runs plugins sequentially within
+ * each phase. Plugins are toposorted and run one at a time.
+ */
+export declare class ResourceRegistryImpl implements IResourceRegistry {
+    private resources;
+    getOrCreate<T extends Resource>(id: ResourceId, factory: () => T): T;
+    get<T extends Resource>(id: ResourceId): T | undefined;
+    has(id: ResourceId): boolean;
+    /** Clear all Resources. Called by Orchestrator at the end of a run. */
+    clear(): void;
+}
+//# sourceMappingURL=ResourceRegistry.d.ts.map

package/dist/core/ResourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ResourceRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAElG;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAC5D,OAAO,CAAC,SAAS,CAAmC;IAEpD,WAAW,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC;IAcpE,GAAG,CAAC,CAAC,SAAS,QAAQ,EAAE,EAAE,EAAE,UAAU,GAAG,CAAC,GAAG,SAAS;IAItD,GAAG,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO;IAI5B,uEAAuE;IACvE,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/ResourceRegistry.js

@@ -0,0 +1,32 @@
+/**
+ * In-memory Resource registry for a single pipeline run.
+ * Created by Orchestrator at run start, cleared at run end.
+ *
+ * Thread safety: Not needed — Grafema runs plugins sequentially within
+ * each phase. Plugins are toposorted and run one at a time.
+ */
+export class ResourceRegistryImpl {
+    resources = new Map();
+    getOrCreate(id, factory) {
+        let resource = this.resources.get(id);
+        if (!resource) {
+            resource = factory();
+            if (resource.id !== id) {
+                throw new Error(`Resource factory returned resource with id "${resource.id}" but expected "${id}"`);
+            }
+            this.resources.set(id, resource);
+        }
+        return resource;
+    }
+    get(id) {
+        return this.resources.get(id);
+    }
+    has(id) {
+        return this.resources.has(id);
+    }
+    /** Clear all Resources. Called by Orchestrator at the end of a run. */
+    clear() {
+        this.resources.clear();
+    }
+}
+//# sourceMappingURL=ResourceRegistry.js.map

package/dist/core/ResourceRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceRegistry.js","sourceRoot":"","sources":["../../src/core/ResourceRegistry.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IACvB,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEpD,WAAW,CAAqB,EAAc,EAAE,OAAgB;QAC9D,IAAI,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,OAAO,EAAE,CAAC;YACrB,IAAI,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,+CAA+C,QAAQ,CAAC,EAAE,mBAAmB,EAAE,GAAG,CACnF,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,QAAa,CAAC;IACvB,CAAC;IAED,GAAG,CAAqB,EAAc;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAkB,CAAC;IACjD,CAAC;IAED,GAAG,CAAC,EAAc;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF"}

package/dist/core/SemanticId.d.ts

@@ -0,0 +1,159 @@
+/**
+ * SemanticId - Stable identifiers for code elements
+ *
+ * Semantic IDs provide stable identifiers for code elements that don't change
+ * when unrelated code is added/removed (no line numbers in IDs).
+ *
+ * Format: {file}->{scope_path}->{type}->{name}[#discriminator]
+ *
+ * Examples:
+ *   src/app.js->global->FUNCTION->processData
+ *   src/app.js->UserService->METHOD->login
+ *   src/app.js->getUser->if#0->CALL->console.log#0
+ *
+ * Special formats:
+ *   Singletons: net:stdio->__stdio__
+ *   External modules: EXTERNAL_MODULE->lodash
+ */
+/**
+ * Location in source file
+ */
+export interface Location {
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+}
+/**
+ * Scope context for semantic ID generation
+ */
+export interface ScopeContext {
+    /** Source file path */
+    file: string;
+    /** Array of scope names, e.g. ['MyClass', 'myMethod', 'if#1'] */
+    scopePath: string[];
+}
+/**
+ * Options for semantic ID generation
+ */
+export interface SemanticIdOptions {
+    /** Counter for disambiguation (#N) */
+    discriminator?: number;
+    /** Context string for special cases ([context]) */
+    context?: string;
+}
+/**
+ * Parsed semantic ID components
+ */
+export interface ParsedSemanticId {
+    file: string;
+    scopePath: string[];
+    type: string;
+    name: string;
+    discriminator?: number;
+    context?: string;
+}
+/**
+ * Item with name and location for discriminator computation
+ */
+export interface LocatedItem {
+    name: string;
+    location: Location;
+}
+/**
+ * Parsed v2 semantic ID components.
+ *
+ * v2 format: file->TYPE->name[in:namedParent,h:xxxx]#N
+ *
+ * Key difference from v1: no scope path in ID. Only nearest named ancestor
+ * (namedParent) is encoded. Anonymous scopes (if, for, try) are invisible.
+ */
+export interface ParsedSemanticIdV2 {
+    file: string;
+    type: string;
+    name: string;
+    namedParent?: string;
+    contentHash?: string;
+    counter?: number;
+}
+/**
+ * Content hint data for computing content hash.
+ * Each node type supplies different hints for disambiguation.
+ */
+export interface ContentHashHints {
+    /** Number of arguments (CALL) or parameters (FUNCTION) */
+    arity?: number;
+    /** First literal argument value (CALL) */
+    firstLiteralArg?: string;
+    /** First parameter name (FUNCTION) */
+    firstParamName?: string;
+    /** RHS expression type (VARIABLE/CONSTANT) */
+    rhsType?: string;
+    /** First significant token of RHS (VARIABLE/CONSTANT) */
+    rhsToken?: string;
+    /** Object expression chain (PROPERTY_ACCESS) */
+    objectChain?: string;
+}
+/**
+ * Compute semantic ID for any node type.
+ *
+ * @param type - Node type (FUNCTION, CALL, VARIABLE, etc.)
+ * @param name - Node name
+ * @param context - Scope context from ScopeTracker
+ * @param options - Optional discriminator or context
+ * @returns Semantic ID string
+ */
+export declare function computeSemanticId(type: string, name: string, context: ScopeContext, options?: SemanticIdOptions): string;
+/**
+ * Parse semantic ID back to components.
+ *
+ * @param id - Semantic ID to parse
+ * @returns Parsed components or null if invalid
+ */
+export declare function parseSemanticId(id: string): ParsedSemanticId | null;
+/**
+ * Compute discriminator for items with same name in same scope.
+ * Uses line/column for stable ordering.
+ *
+ * @param items - All items in scope
+ * @param targetName - Name to find discriminator for
+ * @param targetLocation - Location of target item
+ * @returns Discriminator (0-based index among same-named items)
+ */
+export declare function computeDiscriminator(items: LocatedItem[], targetName: string, targetLocation: Location): number;
+/**
+ * Compute v2 semantic ID.
+ *
+ * Format: file->TYPE->name                           (top-level, no collision)
+ * Format: file->TYPE->name[in:parent]                (nested, no collision)
+ * Format: file->TYPE->name[in:parent,h:xxxx]         (collision, hash disambiguates)
+ * Format: file->TYPE->name[in:parent,h:xxxx]#N       (hash collision, counter)
+ *
+ * @param type - Node type (FUNCTION, CALL, VARIABLE, etc.)
+ * @param name - Node name
+ * @param file - Source file path
+ * @param namedParent - Nearest named ancestor (undefined for top-level)
+ * @param contentHash - 4-hex content hash for disambiguation
+ * @param counter - Counter for hash collisions
+ */
+export declare function computeSemanticIdV2(type: string, name: string, file: string, namedParent?: string, contentHash?: string, counter?: number): string;
+/**
+ * Parse v2 semantic ID back to components.
+ *
+ * Handles v2 format: file->TYPE->name[in:parent,h:xxxx]#N
+ * and special formats: net:stdio->__stdio__, EXTERNAL_MODULE->lodash
+ *
+ * @returns Parsed components or null if not a valid v2 ID
+ */
+export declare function parseSemanticIdV2(id: string): ParsedSemanticIdV2 | null;
+/**
+ * FNV-1a hash function, returns 4-hex-char string.
+ *
+ * FNV-1a is simple, fast, and has good distribution for short strings.
+ * 4 hex chars = 16 bits = 65536 buckets.
+ *
+ * @param hints - Content data to hash
+ * @returns 4-char hex string (e.g., "a1b2")
+ */
+export declare function computeContentHash(hints: ContentHashHints): string;
+//# sourceMappingURL=SemanticId.d.ts.map

package/dist/core/SemanticId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemanticId.d.ts","sourceRoot":"","sources":["../../src/core/SemanticId.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,MAAM,CAaR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAiDnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,QAAQ,GACvB,MAAM,CAwBR;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA4GvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAqBlE"}

package/dist/core/SemanticId.js

@@ -0,0 +1,291 @@
+/**
+ * SemanticId - Stable identifiers for code elements
+ *
+ * Semantic IDs provide stable identifiers for code elements that don't change
+ * when unrelated code is added/removed (no line numbers in IDs).
+ *
+ * Format: {file}->{scope_path}->{type}->{name}[#discriminator]
+ *
+ * Examples:
+ *   src/app.js->global->FUNCTION->processData
+ *   src/app.js->UserService->METHOD->login
+ *   src/app.js->getUser->if#0->CALL->console.log#0
+ *
+ * Special formats:
+ *   Singletons: net:stdio->__stdio__
+ *   External modules: EXTERNAL_MODULE->lodash
+ */
+/**
+ * Compute semantic ID for any node type.
+ *
+ * @param type - Node type (FUNCTION, CALL, VARIABLE, etc.)
+ * @param name - Node name
+ * @param context - Scope context from ScopeTracker
+ * @param options - Optional discriminator or context
+ * @returns Semantic ID string
+ */
+export function computeSemanticId(type, name, context, options) {
+    const { file, scopePath } = context;
+    const scope = scopePath.length > 0 ? scopePath.join('->') : 'global';
+    let id = `${file}->${scope}->${type}->${name}`;
+    if (options?.discriminator !== undefined) {
+        id += `#${options.discriminator}`;
+    }
+    else if (options?.context) {
+        id += `[${options.context}]`;
+    }
+    return id;
+}
+/**
+ * Parse semantic ID back to components.
+ *
+ * @param id - Semantic ID to parse
+ * @returns Parsed components or null if invalid
+ */
+export function parseSemanticId(id) {
+    // Handle singletons
+    if (id.startsWith('net:stdio') || id.startsWith('net:request')) {
+        const [prefix, name] = id.split('->');
+        return {
+            file: '',
+            scopePath: [prefix],
+            type: 'SINGLETON',
+            name,
+            discriminator: undefined
+        };
+    }
+    if (id.startsWith('EXTERNAL_MODULE')) {
+        const [, name] = id.split('->');
+        return {
+            file: '',
+            scopePath: [],
+            type: 'EXTERNAL_MODULE',
+            name,
+            discriminator: undefined
+        };
+    }
+    const parts = id.split('->');
+    if (parts.length < 4)
+        return null;
+    const file = parts[0];
+    const type = parts[parts.length - 2];
+    let name = parts[parts.length - 1];
+    const scopePath = parts.slice(1, -2);
+    // Parse discriminator or context
+    let discriminator;
+    let context;
+    const hashMatch = name.match(/^(.+)#(\d+)$/);
+    if (hashMatch) {
+        name = hashMatch[1];
+        discriminator = parseInt(hashMatch[2], 10);
+    }
+    const bracketMatch = name.match(/^(.+)\[(.+)\]$/);
+    if (bracketMatch) {
+        name = bracketMatch[1];
+        context = bracketMatch[2];
+    }
+    return { file, scopePath, type, name, discriminator, context };
+}
+/**
+ * Compute discriminator for items with same name in same scope.
+ * Uses line/column for stable ordering.
+ *
+ * @param items - All items in scope
+ * @param targetName - Name to find discriminator for
+ * @param targetLocation - Location of target item
+ * @returns Discriminator (0-based index among same-named items)
+ */
+export function computeDiscriminator(items, targetName, targetLocation) {
+    // Filter items with same name
+    const sameNameItems = items.filter(item => item.name === targetName);
+    if (sameNameItems.length <= 1) {
+        return 0;
+    }
+    // Sort by line, then by column for stable ordering
+    sameNameItems.sort((a, b) => {
+        if (a.location.line !== b.location.line) {
+            return a.location.line - b.location.line;
+        }
+        return a.location.column - b.location.column;
+    });
+    // Find index of target
+    const index = sameNameItems.findIndex(item => item.location.line === targetLocation.line &&
+        item.location.column === targetLocation.column);
+    return index >= 0 ? index : 0;
+}
+// =============================================================================
+// Semantic ID v2 Functions
+// =============================================================================
+/**
+ * Compute v2 semantic ID.
+ *
+ * Format: file->TYPE->name                           (top-level, no collision)
+ * Format: file->TYPE->name[in:parent]                (nested, no collision)
+ * Format: file->TYPE->name[in:parent,h:xxxx]         (collision, hash disambiguates)
+ * Format: file->TYPE->name[in:parent,h:xxxx]#N       (hash collision, counter)
+ *
+ * @param type - Node type (FUNCTION, CALL, VARIABLE, etc.)
+ * @param name - Node name
+ * @param file - Source file path
+ * @param namedParent - Nearest named ancestor (undefined for top-level)
+ * @param contentHash - 4-hex content hash for disambiguation
+ * @param counter - Counter for hash collisions
+ */
+export function computeSemanticIdV2(type, name, file, namedParent, contentHash, counter) {
+    const brackets = [];
+    if (namedParent)
+        brackets.push(`in:${namedParent}`);
+    if (contentHash)
+        brackets.push(`h:${contentHash}`);
+    let id = `${file}->${type}->${name}`;
+    if (brackets.length > 0) {
+        id += `[${brackets.join(',')}]`;
+    }
+    if (counter !== undefined && counter > 0) {
+        id += `#${counter}`;
+    }
+    return id;
+}
+/**
+ * Parse v2 semantic ID back to components.
+ *
+ * Handles v2 format: file->TYPE->name[in:parent,h:xxxx]#N
+ * and special formats: net:stdio->__stdio__, EXTERNAL_MODULE->lodash
+ *
+ * @returns Parsed components or null if not a valid v2 ID
+ */
+export function parseSemanticIdV2(id) {
+    // Handle grafema:// URI input — convert to compact first
+    if (id.startsWith('grafema://')) {
+        const scheme = 'grafema://';
+        const rest = id.slice(scheme.length);
+        const slashUnderscore = rest.indexOf('/_/');
+        const hashPos = rest.indexOf('#');
+        if (slashUnderscore !== -1 && (hashPos === -1 || slashUnderscore < hashPos)) {
+            // Virtual node: decode and re-parse
+            const encodedId = rest.slice(slashUnderscore + 3);
+            const decoded = encodedId
+                .replaceAll('%3E', '>').replaceAll('%3e', '>')
+                .replaceAll('%5B', '[').replaceAll('%5b', '[')
+                .replaceAll('%5D', ']').replaceAll('%5d', ']')
+                .replaceAll('%23', '#');
+            return parseSemanticIdV2(decoded);
+        }
+        if (hashPos !== -1) {
+            const pathPart = rest.slice(0, hashPos);
+            const fragment = rest.slice(hashPos + 1);
+            const decoded = fragment
+                .replaceAll('%3E', '>').replaceAll('%3e', '>')
+                .replaceAll('%5B', '[').replaceAll('%5b', '[')
+                .replaceAll('%5D', ']').replaceAll('%5d', ']')
+                .replaceAll('%23', '#');
+            if (decoded === 'MODULE') {
+                const segments = pathPart.split('/');
+                const host = segments[0];
+                const skip = (host === 'github.com' || host === 'gitlab.com' || host === 'bitbucket.org') ? 3 : 2;
+                const filePath = segments.slice(skip).join('/');
+                return { file: filePath, type: 'MODULE', name: filePath };
+            }
+            // Standard node: extract file and reconstruct compact ID
+            const segments = pathPart.split('/');
+            const host = segments[0];
+            const skip = (host === 'github.com' || host === 'gitlab.com' || host === 'bitbucket.org') ? 3 : 2;
+            const filePath = segments.slice(skip).join('/');
+            const compactId = `${filePath}->${decoded}`;
+            return parseSemanticIdV2(compactId);
+        }
+        return null;
+    }
+    // Handle singletons
+    if (id.startsWith('net:stdio') || id.startsWith('net:request')) {
+        const arrowIdx = id.indexOf('->');
+        if (arrowIdx === -1)
+            return null;
+        return { file: '', type: 'SINGLETON', name: id.slice(arrowIdx + 2) };
+    }
+    if (id.startsWith('EXTERNAL_MODULE')) {
+        const arrowIdx = id.indexOf('->');
+        if (arrowIdx === -1)
+            return null;
+        return { file: '', type: 'EXTERNAL_MODULE', name: id.slice(arrowIdx + 2) };
+    }
+    // v2 format: file->TYPE->name[in:parent,h:xxxx]#N
+    // Exactly two '->' delimiters: file->TYPE->rest
+    const firstArrow = id.indexOf('->');
+    if (firstArrow === -1)
+        return null;
+    const secondArrow = id.indexOf('->', firstArrow + 2);
+    if (secondArrow === -1)
+        return null;
+    const file = id.slice(0, firstArrow);
+    const type = id.slice(firstArrow + 2, secondArrow);
+    let rest = id.slice(secondArrow + 2);
+    // Check this isn't a v1 ID (v1 has 4+ parts, meaning rest contains '->')
+    // v2 names don't contain '->' in practice
+    if (rest.includes('->'))
+        return null;
+    // Parse counter suffix: #N (only at the very end, after brackets)
+    let counter;
+    const counterMatch = rest.match(/#(\d+)$/);
+    if (counterMatch) {
+        counter = parseInt(counterMatch[1], 10);
+        rest = rest.slice(0, -counterMatch[0].length);
+    }
+    // Parse bracket content: [in:parent,h:xxxx]
+    let namedParent;
+    let contentHash;
+    let name = rest;
+    const bracketStart = rest.indexOf('[');
+    const bracketEnd = rest.lastIndexOf(']');
+    if (bracketStart !== -1 && bracketEnd === rest.length - 1) {
+        name = rest.slice(0, bracketStart);
+        const bracketContent = rest.slice(bracketStart + 1, bracketEnd);
+        for (const part of bracketContent.split(',')) {
+            const colonIdx = part.indexOf(':');
+            if (colonIdx === -1)
+                continue;
+            const key = part.slice(0, colonIdx);
+            const value = part.slice(colonIdx + 1);
+            if (key === 'in')
+                namedParent = value;
+            else if (key === 'h')
+                contentHash = value;
+        }
+    }
+    return { file, type, name, namedParent, contentHash, counter };
+}
+/**
+ * FNV-1a hash function, returns 4-hex-char string.
+ *
+ * FNV-1a is simple, fast, and has good distribution for short strings.
+ * 4 hex chars = 16 bits = 65536 buckets.
+ *
+ * @param hints - Content data to hash
+ * @returns 4-char hex string (e.g., "a1b2")
+ */
+export function computeContentHash(hints) {
+    const parts = [];
+    if (hints.arity !== undefined)
+        parts.push(`a:${hints.arity}`);
+    if (hints.firstLiteralArg !== undefined)
+        parts.push(`l:${hints.firstLiteralArg}`);
+    if (hints.firstParamName !== undefined)
+        parts.push(`p:${hints.firstParamName}`);
+    if (hints.rhsType !== undefined)
+        parts.push(`r:${hints.rhsType}`);
+    if (hints.rhsToken !== undefined)
+        parts.push(`t:${hints.rhsToken}`);
+    if (hints.objectChain !== undefined)
+        parts.push(`o:${hints.objectChain}`);
+    const input = parts.join('|');
+    // FNV-1a 32-bit
+    let hash = 0x811c9dc5; // FNV offset basis
+    for (let i = 0; i < input.length; i++) {
+        hash ^= input.charCodeAt(i);
+        hash = Math.imul(hash, 0x01000193); // FNV prime
+    }
+    // Truncate to 16 bits, format as 4-hex
+    const truncated = (hash >>> 0) & 0xffff;
+    return truncated.toString(16).padStart(4, '0');
+}
+//# sourceMappingURL=SemanticId.js.map

package/dist/core/SemanticId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SemanticId.js","sourceRoot":"","sources":["../../src/core/SemanticId.ts"],"names":[],"mappings":"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"}