@pyreon/compiler 0.4.0 → 0.5.0

package/lib/types/index2.d.ts

@@ -53,5 +53,62 @@ interface TransformResult {
 }
 declare function transformJSX(code: string, filename?: string): TransformResult;
 //#endregion
-export { type CompilerWarning, type TransformResult, transformJSX };
+//#region src/react-intercept.d.ts
+/**
+ * React Pattern Interceptor — detects React/Vue patterns in code and provides
+ * structured diagnostics with exact fix suggestions for AI-assisted migration.
+ *
+ * Two modes:
+ *  - `detectReactPatterns(code)` — returns diagnostics only (non-destructive)
+ *  - `migrateReactCode(code)` — applies auto-fixes and returns transformed code
+ *
+ * Designed for three consumers:
+ *  1. Compiler pre-pass (warnings during build)
+ *  2. CLI `pyreon doctor` (project-wide scanning)
+ *  3. MCP server `migrate_react` / `validate` tools (AI agent integration)
+ */
+type ReactDiagnosticCode = "react-import" | "react-dom-import" | "react-router-import" | "use-state" | "use-effect-mount" | "use-effect-deps" | "use-effect-no-deps" | "use-memo" | "use-callback" | "use-ref-dom" | "use-ref-box" | "use-reducer" | "use-layout-effect" | "memo-wrapper" | "forward-ref" | "class-name-prop" | "html-for-prop" | "on-change-input" | "dangerously-set-inner-html" | "dot-value-signal" | "array-map-jsx" | "key-on-for-child" | "create-context-import" | "use-context-import";
+interface ReactDiagnostic {
+  /** Machine-readable code for filtering and programmatic handling */
+  code: ReactDiagnosticCode;
+  /** Human-readable message explaining the issue */
+  message: string;
+  /** 1-based line number */
+  line: number;
+  /** 0-based column */
+  column: number;
+  /** The code as written */
+  current: string;
+  /** The suggested Pyreon equivalent */
+  suggested: string;
+  /** Whether migrateReactCode can auto-fix this */
+  fixable: boolean;
+}
+interface MigrationChange {
+  type: "replace" | "remove" | "add";
+  line: number;
+  description: string;
+}
+interface MigrationResult {
+  /** Transformed source code */
+  code: string;
+  /** All detected patterns (including unfixable ones) */
+  diagnostics: ReactDiagnostic[];
+  /** Description of changes applied */
+  changes: MigrationChange[];
+}
+declare function detectReactPatterns(code: string, filename?: string): ReactDiagnostic[];
+declare function migrateReactCode(code: string, filename?: string): MigrationResult;
+/** Fast regex check — returns true if code likely contains React patterns worth analyzing */
+declare function hasReactPatterns(code: string): boolean;
+interface ErrorDiagnosis {
+  cause: string;
+  fix: string;
+  fixCode?: string | undefined;
+  related?: string | undefined;
+}
+/** Diagnose an error message and return structured fix information */
+declare function diagnoseError(error: string): ErrorDiagnosis | null;
+//#endregion
+export { type CompilerWarning, type ErrorDiagnosis, type MigrationChange, type MigrationResult, type ReactDiagnostic, type ReactDiagnosticCode, type TransformResult, detectReactPatterns, diagnoseError, hasReactPatterns, migrateReactCode, transformJSX };
 //# sourceMappingURL=index2.d.ts.map

package/lib/types/index2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/jsx.ts"],"mappings":";;AAqCA;;;;;;;;;;AAWA;;;;;;;;;;AAwCA;;;;;;;;;;;;;UAnDiB,eAAA;;EAEf,OAAA;;EAEA,IAAA;;EAEA,MAAA;;EAEA,IAAA;AAAA;AAAA,UAGe,eAAA;;EAEf,IAAA;;EAEA,aAAA;;EAEA,QAAA,EAAU,eAAA;AAAA;AAAA,iBAkCI,YAAA,CAAa,IAAA,UAAc,QAAA,YAAyB,eAAA"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../src/jsx.ts","../../src/react-intercept.ts"],"mappings":";;AAqCA;;;;;;;;;;AAWA;;;;;;;;;;AAwCA;;;;;;;;;;;;ACpEA;UDiBiB,eAAA;;EAEf,OAAA;ECnB6B;EDqB7B,IAAA;ECK8B;EDH9B,MAAA;ECKyB;EDHzB,IAAA;AAAA;AAAA,UAGe,eAAA;ECIf;EDFA,IAAA;ECMA;EDJA,aAAA;ECQA;EDNA,QAAA,EAAU,eAAA;AAAA;AAAA,iBAkCI,YAAA,CAAa,IAAA,UAAc,QAAA,YAAyB,eAAA;;;;AAnDpE;;;;;;;;;;AAWA;;KC5BY,mBAAA;AAAA,UA0BK,eAAA;EDIf;ECFA,IAAA,EAAM,mBAAA;EDMN;ECJA,OAAA;EDIyB;ECFzB,IAAA;EDoCc;EClCd,MAAA;;EAEA,OAAA;EDgC2B;EC9B3B,SAAA;ED8BkE;EC5BlE,OAAA;AAAA;AAAA,UAGe,eAAA;EACf,IAAA;EACA,IAAA;EACA,WAAA;AAAA;AAAA,UAGe,eAAA;EAjDc;EAmD7B,IAAA;EAzBe;EA2Bf,WAAA,EAAa,eAAA;;EAEb,OAAA,EAAS,eAAA;AAAA;AAAA,iBAsgBK,mBAAA,CAAoB,IAAA,UAAc,QAAA,YAAyB,eAAA;AAAA,iBA+V3D,gBAAA,CAAiB,IAAA,UAAc,QAAA,YAAyB,eAAA;;iBA0ExD,gBAAA,CAAiB,IAAA;AAAA,UAuBhB,cAAA;EACf,KAAA;EACA,GAAA;EACA,OAAA;EACA,OAAA;AAAA;;iBAkGc,aAAA,CAAc,KAAA,WAAgB,cAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/compiler",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Template and JSX compiler for Pyreon",
   "license": "MIT",
   "repository": {

package/src/index.ts

@@ -2,3 +2,17 @@
 
 export type { CompilerWarning, TransformResult } from "./jsx"
 export { transformJSX } from "./jsx"
+
+export type {
+  ErrorDiagnosis,
+  MigrationChange,
+  MigrationResult,
+  ReactDiagnostic,
+  ReactDiagnosticCode,
+} from "./react-intercept"
+export {
+  detectReactPatterns,
+  diagnoseError,
+  hasReactPatterns,
+  migrateReactCode,
+} from "./react-intercept"