legacy-modernizer 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Legacy Modernizer — Core type definitions
+ */
+/** Migration dimension — each represents a major upgrade path */
+export type MigrationDimension = 'vue2-to-vue3' | 'js-to-ts' | 'webpack-to-vite' | 'jest-to-vitest' | 'vuex-to-pinia' | 'eslint-modernize';
+/** Severity of a detected legacy pattern */
+export type PatternSeverity = 'critical' | 'warning' | 'info';
+/** Risk level for the overall migration */
+export type RiskLevel = 'low' | 'medium' | 'high';
+/** Branded line number type — ensures non-negative values */
+export type PatternLine = number & {
+    readonly __brand: unique symbol;
+};
+/** Create a PatternLine, clamping negative values to 0 */
+export declare function createPatternLine(n: number): PatternLine;
+/** A single detected legacy pattern in a file */
+export interface LegacyPattern {
+    /** Pattern identifier, e.g. "vue2-options-api" */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Which migration dimension this belongs to */
+    dimension: MigrationDimension;
+    /** Severity level */
+    severity: PatternSeverity;
+    /** File path (relative to project root) */
+    file: string;
+    /** Line number (1-based, 0 if unknown) — branded to prevent negative values */
+    line: PatternLine;
+    /** The matched text snippet */
+    snippet: string;
+    /** Suggested replacement (optional) */
+    suggestion?: string;
+}
+/** A detection rule for legacy pattern scanning (Fix #1: centralized) */
+export interface PatternRule {
+    /** Unique rule identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Which migration dimension this belongs to */
+    dimension: MigrationDimension;
+    /** Severity level */
+    severity: PatternSeverity;
+    /** Regex to detect the pattern */
+    regex: RegExp;
+    /** Suggested replacement */
+    suggestion: string;
+}
+/** Statistics grouped by dimension */
+export interface DimensionStats {
+    dimension: MigrationDimension;
+    /** Total patterns found */
+    count: number;
+    /** Unique files affected */
+    files: number;
+    /** Breakdown by severity */
+    bySeverity: Record<PatternSeverity, number>;
+}
+/** Full project analysis report */
+export interface AnalysisReport {
+    /** Project root path */
+    projectRoot: string;
+    /** Scan time */
+    scannedAt: string;
+    /** Total files scanned */
+    totalFiles: number;
+    /** Total patterns found */
+    totalPatterns: number;
+    /** All detected patterns */
+    patterns: LegacyPattern[];
+    /** Statistics by dimension */
+    dimensions: DimensionStats[];
+    /** Risk assessment */
+    risk: RiskAssessment;
+    /** Scan duration in ms */
+    duration: number;
+}
+export interface RiskAssessment {
+    /** Overall risk level */
+    level: RiskLevel;
+    /** Reasoning */
+    reason: string;
+    /** Recommended migration order (dimensions) */
+    recommendedOrder: MigrationDimension[];
+    /** Estimated effort (person-days) */
+    estimatedEffort: number;
+}
+/** Risk assessment thresholds (configurable, Fix #6) */
+export interface RiskThresholds {
+    /** Critical pattern count above which risk is high (default: 20) */
+    criticalHigh: number;
+    /** Critical pattern count above which risk is medium (default: 5) */
+    criticalMedium: number;
+    /** Warning count above which risk is medium (default: 30) */
+    warningMedium: number;
+    /** Total file count above which risk is high (default: 200) */
+    filesHigh: number;
+    /** Total file count above which risk is medium (default: 50) */
+    filesMedium: number;
+    /** Effort divisor for high-risk (default: 15) */
+    effortHigh: number;
+    /** Effort divisor for medium-risk (default: 25) */
+    effortMedium: number;
+    /** Effort divisor for low-risk (default: 40) */
+    effortLow: number;
+}
+/** Scanner options derived from ModernizerConfig + runtime params (Fix #2) */
+export interface ScannerOptions {
+    /** Project root directory (always required at runtime) */
+    root: string;
+    /** File globs to include */
+    include?: string[];
+    /** File globs to exclude */
+    exclude?: string[];
+    /** Max files to scan, 0 = unlimited */
+    maxFiles?: number;
+    /** Max matches per rule per file (default: 10) */
+    maxMatchesPerRule?: number;
+    /** Risk thresholds override */
+    riskThresholds?: Partial<RiskThresholds>;
+}
+/** Scanner configuration per dimension */
+export interface DimensionConfig {
+    /** Whether this dimension is enabled */
+    enabled: boolean;
+    /** File globs to scan */
+    include: string[];
+    /** File globs to exclude */
+    exclude: string[];
+}
+export interface ModernizerConfig {
+    /** Per-dimension configuration */
+    dimensions: Record<MigrationDimension, DimensionConfig>;
+    /** Max files to scan (0 = unlimited) */
+    maxFiles: number;
+    /** Whether to include suggestions in report */
+    includeSuggestions: boolean;
+}
+export declare const VERSION: "0.1.0";

package/dist/utils/config.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration management
+ */
+import type { ModernizerConfig } from '../types';
+/** Deep merge user config with defaults (Issue #9: guard unknown dimension keys) */
+export declare function mergeConfig(user: Partial<ModernizerConfig>): ModernizerConfig;
+/** Get default configuration */
+export declare function getDefaultConfig(): ModernizerConfig;

package/dist/utils/format.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Formatting utility functions
+ */
+import type { Locale } from '../reporters/locale';
+import type { LegacyPattern, MigrationDimension, PatternSeverity } from '../types';
+/** Format a legacy pattern as a Markdown list item */
+export declare function patternToMarkdown(p: LegacyPattern): string;
+/** Get emoji badge for severity */
+export declare function severityBadge(severity: PatternSeverity): string;
+/** Get display label for dimension (locale-aware) */
+export declare function dimensionLabel(dimension: MigrationDimension, locale?: Locale): string;
+/** Format duration in ms to human-readable */
+export declare function formatDuration(ms: number): string;

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "legacy-modernizer",
+  "description": "AI-powered legacy code modernizer for frontend projects — Vue 2→3, JS→TS, Webpack→Vite semantic migration via Claude Code Skill",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    ".claude"
+  ],
+  "devDependencies": {
+    "@eslint-sets/eslint-config": "^6.3.1",
+    "@types/node": "^26.0.0",
+    "eslint": "^9.39.4",
+    "npm-run-all": "^4.1.5",
+    "prettier": "^3.8.4",
+    "prettier-config-common": "^1.5.0",
+    "rm-all": "^1.1.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitepress": "^1.6.4",
+    "vitest": "^3.2.6"
+  },
+  "engines": {
+    "node": ">=18.20"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "legacy-modernizer",
+    "vue2-to-vue3",
+    "js-to-ts",
+    "webpack-to-vite",
+    "migration",
+    "modernization",
+    "claude-code",
+    "claude-code-skill"
+  ],
+  "license": "MIT",
+  "author": "saqqdy<https://github.com/saqqdy>",
+  "homepage": "https://github.com/saqqdy/legacy-modernizer#readme",
+  "bugs": {
+    "url": "https://github.com/saqqdy/legacy-modernizer/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/saqqdy/legacy-modernizer.git"
+  },
+  "scripts": {
+    "build": "run-s clean build:bundle build:types",
+    "build:bundle": "tsup",
+    "build:types": "tsc --emitDeclarationOnly",
+    "clean": "rm-all dist",
+    "dev": "tsup --watch",
+    "lint": "eslint --fix .",
+    "prettier": "prettier --write \"**/*.{js,ts,mjs,yml,json,md}\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "dist": "run-s lint build",
+    "typecheck": "tsc --noEmit",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "playground": "npx sirv . --dev --port 5174 --single playground/index.html"
+  }
+}