@getmikk/core 1.2.0 → 1.3.1

package/src/parser/typescript/ts-parser.ts

@@ -1,41 +1,41 @@
-import { BaseParser } from '../base-parser.js'
-import { TypeScriptExtractor } from './ts-extractor.js'
-import { TypeScriptResolver } from './ts-resolver.js'
-import { hashContent } from '../../hash/file-hasher.js'
-import type { ParsedFile } from '../types.js'
-
-/**
- * TypeScript parser — uses TS Compiler API to parse .ts/.tsx files
- * and extract structured data (functions, classes, imports, exports).
- */
-export class TypeScriptParser extends BaseParser {
-    /** Parse a single TypeScript file */
-    parse(filePath: string, content: string): ParsedFile {
-        const extractor = new TypeScriptExtractor(filePath, content)
-        return {
-            path: filePath,
-            language: 'typescript',
-            functions: extractor.extractFunctions(),
-            classes: extractor.extractClasses(),
-            generics: extractor.extractGenerics(),
-            imports: extractor.extractImports(),
-            exports: extractor.extractExports(),
-            hash: hashContent(content),
-            parsedAt: Date.now(),
-        }
-    }
-
-    /** Resolve all import paths in parsed files to absolute project paths */
-    resolveImports(files: ParsedFile[], projectRoot: string): ParsedFile[] {
-        const resolver = new TypeScriptResolver(projectRoot)
-        const allFilePaths = files.map(f => f.path)
-        return files.map(file => ({
-            ...file,
-            imports: file.imports.map(imp => resolver.resolve(imp, file.path, allFilePaths)),
-        }))
-    }
-
-    getSupportedExtensions(): string[] {
-        return ['.ts', '.tsx']
-    }
-}
+import { BaseParser } from '../base-parser.js'
+import { TypeScriptExtractor } from './ts-extractor.js'
+import { TypeScriptResolver } from './ts-resolver.js'
+import { hashContent } from '../../hash/file-hasher.js'
+import type { ParsedFile } from '../types.js'
+
+/**
+ * TypeScript parser — uses TS Compiler API to parse .ts/.tsx files
+ * and extract structured data (functions, classes, imports, exports).
+ */
+export class TypeScriptParser extends BaseParser {
+    /** Parse a single TypeScript file */
+    parse(filePath: string, content: string): ParsedFile {
+        const extractor = new TypeScriptExtractor(filePath, content)
+        return {
+            path: filePath,
+            language: 'typescript',
+            functions: extractor.extractFunctions(),
+            classes: extractor.extractClasses(),
+            generics: extractor.extractGenerics(),
+            imports: extractor.extractImports(),
+            exports: extractor.extractExports(),
+            hash: hashContent(content),
+            parsedAt: Date.now(),
+        }
+    }
+
+    /** Resolve all import paths in parsed files to absolute project paths */
+    resolveImports(files: ParsedFile[], projectRoot: string): ParsedFile[] {
+        const resolver = new TypeScriptResolver(projectRoot)
+        const allFilePaths = files.map(f => f.path)
+        return files.map(file => ({
+            ...file,
+            imports: file.imports.map(imp => resolver.resolve(imp, file.path, allFilePaths)),
+        }))
+    }
+
+    getSupportedExtensions(): string[] {
+        return ['.ts', '.tsx']
+    }
+}

package/src/parser/typescript/ts-resolver.ts

@@ -1,86 +1,86 @@
-import * as path from 'node:path'
-import type { ParsedImport } from '../types.js'
-
-interface TSConfigPaths {
-    [alias: string]: string[]
-}
-
-/**
- * Resolves TypeScript import paths to absolute project-relative paths.
- * Handles: relative imports, path aliases, index files, extension inference.
- */
-export class TypeScriptResolver {
-    private aliases: TSConfigPaths
-
-    constructor(
-        private projectRoot: string,
-        tsConfigPaths?: TSConfigPaths
-    ) {
-        this.aliases = tsConfigPaths || {}
-    }
-
-    /** Resolve a single import relative to the importing file */
-    resolve(imp: ParsedImport, fromFile: string, allProjectFiles: string[] = []): ParsedImport {
-        // Skip external packages (no relative path prefix, no alias match)
-        if (!imp.source.startsWith('.') && !imp.source.startsWith('/') && !this.matchesAlias(imp.source)) {
-            return { ...imp, resolvedPath: '' }
-        }
-
-        const resolved = this.resolvePath(imp.source, fromFile, allProjectFiles)
-        return { ...imp, resolvedPath: resolved }
-    }
-
-    private resolvePath(source: string, fromFile: string, allProjectFiles: string[]): string {
-        let resolvedSource = source
-
-        // 1. Handle path aliases: @/utils/jwt → src/utils/jwt
-        for (const [alias, targets] of Object.entries(this.aliases)) {
-            const aliasPrefix = alias.replace('/*', '')
-            if (source.startsWith(aliasPrefix)) {
-                const suffix = source.slice(aliasPrefix.length)
-                const target = targets[0].replace('/*', '')
-                resolvedSource = target + suffix
-                break
-            }
-        }
-
-        // 2. Handle relative paths
-        let resolved: string
-        if (resolvedSource.startsWith('.')) {
-            const fromDir = path.dirname(fromFile)
-            resolved = path.posix.normalize(path.posix.join(fromDir, resolvedSource))
-        } else {
-            resolved = resolvedSource
-        }
-
-        // Normalize to posix
-        resolved = resolved.replace(/\\/g, '/')
-
-        // 3. Try to find exact match with extensions
-        const extensions = ['.ts', '.tsx', '/index.ts', '/index.tsx']
-
-        // If the path already has an extension, return it
-        if (resolved.endsWith('.ts') || resolved.endsWith('.tsx')) {
-            return resolved
-        }
-
-        // Try adding extensions to find matching file
-        for (const ext of extensions) {
-            const candidate = resolved + ext
-            if (allProjectFiles.length === 0 || allProjectFiles.includes(candidate)) {
-                return candidate
-            }
-        }
-
-        // Fallback: just add .ts
-        return resolved + '.ts'
-    }
-
-    private matchesAlias(source: string): boolean {
-        for (const alias of Object.keys(this.aliases)) {
-            const prefix = alias.replace('/*', '')
-            if (source.startsWith(prefix)) return true
-        }
-        return false
-    }
-}
+import * as path from 'node:path'
+import type { ParsedImport } from '../types.js'
+
+interface TSConfigPaths {
+    [alias: string]: string[]
+}
+
+/**
+ * Resolves TypeScript import paths to absolute project-relative paths.
+ * Handles: relative imports, path aliases, index files, extension inference.
+ */
+export class TypeScriptResolver {
+    private aliases: TSConfigPaths
+
+    constructor(
+        private projectRoot: string,
+        tsConfigPaths?: TSConfigPaths
+    ) {
+        this.aliases = tsConfigPaths || {}
+    }
+
+    /** Resolve a single import relative to the importing file */
+    resolve(imp: ParsedImport, fromFile: string, allProjectFiles: string[] = []): ParsedImport {
+        // Skip external packages (no relative path prefix, no alias match)
+        if (!imp.source.startsWith('.') && !imp.source.startsWith('/') && !this.matchesAlias(imp.source)) {
+            return { ...imp, resolvedPath: '' }
+        }
+
+        const resolved = this.resolvePath(imp.source, fromFile, allProjectFiles)
+        return { ...imp, resolvedPath: resolved }
+    }
+
+    private resolvePath(source: string, fromFile: string, allProjectFiles: string[]): string {
+        let resolvedSource = source
+
+        // 1. Handle path aliases: @/utils/jwt → src/utils/jwt
+        for (const [alias, targets] of Object.entries(this.aliases)) {
+            const aliasPrefix = alias.replace('/*', '')
+            if (source.startsWith(aliasPrefix)) {
+                const suffix = source.slice(aliasPrefix.length)
+                const target = targets[0].replace('/*', '')
+                resolvedSource = target + suffix
+                break
+            }
+        }
+
+        // 2. Handle relative paths
+        let resolved: string
+        if (resolvedSource.startsWith('.')) {
+            const fromDir = path.dirname(fromFile)
+            resolved = path.posix.normalize(path.posix.join(fromDir, resolvedSource))
+        } else {
+            resolved = resolvedSource
+        }
+
+        // Normalize to posix
+        resolved = resolved.replace(/\\/g, '/')
+
+        // 3. Try to find exact match with extensions
+        const extensions = ['.ts', '.tsx', '/index.ts', '/index.tsx']
+
+        // If the path already has an extension, return it
+        if (resolved.endsWith('.ts') || resolved.endsWith('.tsx')) {
+            return resolved
+        }
+
+        // Try adding extensions to find matching file
+        for (const ext of extensions) {
+            const candidate = resolved + ext
+            if (allProjectFiles.length === 0 || allProjectFiles.includes(candidate)) {
+                return candidate
+            }
+        }
+
+        // Fallback: just add .ts
+        return resolved + '.ts'
+    }
+
+    private matchesAlias(source: string): boolean {
+        for (const alias of Object.keys(this.aliases)) {
+            const prefix = alias.replace('/*', '')
+            if (source.startsWith(prefix)) return true
+        }
+        return false
+    }
+}

package/src/utils/errors.ts

@@ -1,42 +1,42 @@
-export class MikkError extends Error {
-    constructor(message: string, public code: string) {
-        super(message)
-        this.name = 'MikkError'
-    }
-}
-
-export class ParseError extends MikkError {
-    constructor(file: string, cause: string) {
-        super(`Failed to parse ${file}: ${cause}`, 'PARSE_ERROR')
-    }
-}
-
-export class ContractNotFoundError extends MikkError {
-    constructor(path: string) {
-        super(`No mikk.json found at ${path}. Run 'mikk init' first.`, 'CONTRACT_NOT_FOUND')
-    }
-}
-
-export class LockNotFoundError extends MikkError {
-    constructor() {
-        super(`No mikk.lock.json found. Run 'mikk analyze' first.`, 'LOCK_NOT_FOUND')
-    }
-}
-
-export class UnsupportedLanguageError extends MikkError {
-    constructor(ext: string) {
-        super(`Unsupported file extension: ${ext}`, 'UNSUPPORTED_LANGUAGE')
-    }
-}
-
-export class OverwritePermissionError extends MikkError {
-    constructor() {
-        super(`Overwrite mode is 'never'. Change to 'ask' or 'explicit' to allow updates.`, 'OVERWRITE_DENIED')
-    }
-}
-
-export class SyncStateError extends MikkError {
-    constructor(status: string) {
-        super(`Mikk is in ${status} state. Run 'mikk analyze' to sync.`, 'SYNC_STATE_ERROR')
-    }
-}
+export class MikkError extends Error {
+    constructor(message: string, public code: string) {
+        super(message)
+        this.name = 'MikkError'
+    }
+}
+
+export class ParseError extends MikkError {
+    constructor(file: string, cause: string) {
+        super(`Failed to parse ${file}: ${cause}`, 'PARSE_ERROR')
+    }
+}
+
+export class ContractNotFoundError extends MikkError {
+    constructor(path: string) {
+        super(`No mikk.json found at ${path}. Run 'mikk init' first.`, 'CONTRACT_NOT_FOUND')
+    }
+}
+
+export class LockNotFoundError extends MikkError {
+    constructor() {
+        super(`No mikk.lock.json found. Run 'mikk analyze' first.`, 'LOCK_NOT_FOUND')
+    }
+}
+
+export class UnsupportedLanguageError extends MikkError {
+    constructor(ext: string) {
+        super(`Unsupported file extension: ${ext}`, 'UNSUPPORTED_LANGUAGE')
+    }
+}
+
+export class OverwritePermissionError extends MikkError {
+    constructor() {
+        super(`Overwrite mode is 'never'. Change to 'ask' or 'explicit' to allow updates.`, 'OVERWRITE_DENIED')
+    }
+}
+
+export class SyncStateError extends MikkError {
+    constructor(status: string) {
+        super(`Mikk is in ${status} state. Run 'mikk analyze' to sync.`, 'SYNC_STATE_ERROR')
+    }
+}

package/src/utils/fs.ts

@@ -1,75 +1,75 @@
-import * as fs from 'node:fs/promises'
-import * as path from 'node:path'
-import fg from 'fast-glob'
-
-/**
- * Discover all source files in a project directory.
- * Respects common ignore patterns (node_modules, dist, .mikk, etc.)
- */
-export async function discoverFiles(
-    projectRoot: string,
-    patterns: string[] = ['**/*.ts', '**/*.tsx'],
-    ignore: string[] = ['**/node_modules/**', '**/dist/**', '**/.mikk/**', '**/coverage/**', '**/*.d.ts', '**/*.test.ts', '**/*.spec.ts']
-): Promise<string[]> {
-    const files = await fg(patterns, {
-        cwd: projectRoot,
-        ignore,
-        absolute: false,
-        onlyFiles: true,
-    })
-    return files.map(f => f.replace(/\\/g, '/'))
-}
-
-/**
- * Reads a file and returns its content as a UTF-8 string.
- */
-export async function readFileContent(filePath: string): Promise<string> {
-    return fs.readFile(filePath, 'utf-8')
-}
-
-/**
- * Writes content to a file, creating parent directories if needed.
- */
-export async function writeFileContent(filePath: string, content: string): Promise<void> {
-    await fs.mkdir(path.dirname(filePath), { recursive: true })
-    await fs.writeFile(filePath, content, 'utf-8')
-}
-
-/**
- * Check if a file exists.
- */
-export async function fileExists(filePath: string): Promise<boolean> {
-    try {
-        await fs.access(filePath)
-        return true
-    } catch {
-        return false
-    }
-}
-
-/**
- * Set up the .mikk directory structure in a project root.
- */
-export async function setupMikkDirectory(projectRoot: string): Promise<void> {
-    const dirs = [
-        '.mikk',
-        '.mikk/fragments',
-        '.mikk/diagrams',
-        '.mikk/diagrams/modules',
-        '.mikk/diagrams/capsules',
-        '.mikk/diagrams/flows',
-        '.mikk/diagrams/impact',
-        '.mikk/diagrams/exposure',
-        '.mikk/intent',
-        '.mikk/cache',
-    ]
-    for (const dir of dirs) {
-        await fs.mkdir(path.join(projectRoot, dir), { recursive: true })
-    }
-
-    // Create .gitkeep in impact dir
-    const impactKeep = path.join(projectRoot, '.mikk/diagrams/impact/.gitkeep')
-    if (!await fileExists(impactKeep)) {
-        await fs.writeFile(impactKeep, '', 'utf-8')
-    }
-}
+import * as fs from 'node:fs/promises'
+import * as path from 'node:path'
+import fg from 'fast-glob'
+
+/**
+ * Discover all source files in a project directory.
+ * Respects common ignore patterns (node_modules, dist, .mikk, etc.)
+ */
+export async function discoverFiles(
+    projectRoot: string,
+    patterns: string[] = ['**/*.ts', '**/*.tsx'],
+    ignore: string[] = ['**/node_modules/**', '**/dist/**', '**/.mikk/**', '**/coverage/**', '**/*.d.ts', '**/*.test.ts', '**/*.spec.ts']
+): Promise<string[]> {
+    const files = await fg(patterns, {
+        cwd: projectRoot,
+        ignore,
+        absolute: false,
+        onlyFiles: true,
+    })
+    return files.map(f => f.replace(/\\/g, '/'))
+}
+
+/**
+ * Reads a file and returns its content as a UTF-8 string.
+ */
+export async function readFileContent(filePath: string): Promise<string> {
+    return fs.readFile(filePath, 'utf-8')
+}
+
+/**
+ * Writes content to a file, creating parent directories if needed.
+ */
+export async function writeFileContent(filePath: string, content: string): Promise<void> {
+    await fs.mkdir(path.dirname(filePath), { recursive: true })
+    await fs.writeFile(filePath, content, 'utf-8')
+}
+
+/**
+ * Check if a file exists.
+ */
+export async function fileExists(filePath: string): Promise<boolean> {
+    try {
+        await fs.access(filePath)
+        return true
+    } catch {
+        return false
+    }
+}
+
+/**
+ * Set up the .mikk directory structure in a project root.
+ */
+export async function setupMikkDirectory(projectRoot: string): Promise<void> {
+    const dirs = [
+        '.mikk',
+        '.mikk/fragments',
+        '.mikk/diagrams',
+        '.mikk/diagrams/modules',
+        '.mikk/diagrams/capsules',
+        '.mikk/diagrams/flows',
+        '.mikk/diagrams/impact',
+        '.mikk/diagrams/exposure',
+        '.mikk/intent',
+        '.mikk/cache',
+    ]
+    for (const dir of dirs) {
+        await fs.mkdir(path.join(projectRoot, dir), { recursive: true })
+    }
+
+    // Create .gitkeep in impact dir
+    const impactKeep = path.join(projectRoot, '.mikk/diagrams/impact/.gitkeep')
+    if (!await fileExists(impactKeep)) {
+        await fs.writeFile(impactKeep, '', 'utf-8')
+    }
+}