release: WRNexusJS 0.3.0

packages/compiler/src/index.ts

@@ -1,74 +1,102 @@
 /**
  * @wrnexus/compiler — the `.wrn` language compiler.
  *
- * Pipeline:  source ──▶ Lexer ──▶ parse() ──▶ AST ──▶ generate() ──▶ TypeScript
- *
- * See VISION.md for the language design. The MVP supports `page` with `state`,
- * `view`, `api`, and `realtime` blocks, lowering to the framework's primitives.
+ * Parsing and language diagnostics are provided by the canonical
+ * `@wrnexus/syntax` package. This package owns platform-specific codegen.
  */
 
-import { parse, ParseError, type PageAst } from "./parser.ts";
+import {
+  assertValidAst,
+  diagnose,
+  diagnosticFromError,
+  formatDiagnostic,
+  parse,
+  ParseError,
+  type PageAst,
+  type WrnDiagnostic,
+} from "@wrnexus/syntax";
 import { generate } from "./codegen.ts";
 import { generateNative } from "./native-codegen.ts";
 
-export { parse, ParseError } from "./parser.ts";
+export {
+  assertValidAst,
+  diagnose,
+  diagnosticFromError,
+  formatDiagnostic,
+  parse,
+  ParseError,
+} from "@wrnexus/syntax";
 export { generate } from "./codegen.ts";
 export { generateNative, NativeCompileError } from "./native-codegen.ts";
-export { Lexer, LexError } from "./tokenizer.ts";
-export { eraseFunctionTypes, inferredRuntimeType, runtimeTypeOf } from "./types.ts";
+export { Lexer, LexError } from "@wrnexus/syntax";
+export { eraseFunctionTypes, inferredRuntimeType, runtimeTypeOf } from "@wrnexus/syntax";
 export type {
-  PageAst,
-  SeoBlock,
-  ViewNode,
-  Attr,
-  StateDecl,
-  PropDecl,
+  ActionBlock,
   ApiBlock,
+  Attr,
+  ComputedDecl,
   DataApiBlock,
   DataMode,
+  EffectBlock,
+  LoadBlock,
   ModeFunctionsBlock,
+  PageAst,
+  PropDecl,
   RealtimeBlock,
-} from "./parser.ts";
+  SeoBlock,
+  StateDecl,
+  ViewNode,
+  WrnDiagnostic,
+} from "@wrnexus/syntax";
 
 export interface CompileResult {
   code: string;
   ast: PageAst;
+  /** Backward-compatible plain diagnostic messages. */
   diagnostics: string[];
+  /** Structured diagnostics for editors, CI, and the DevToolbar. */
+  richDiagnostics: WrnDiagnostic[];
 }
 
 /** Compile `.wrn` source into an Expo Router React Native screen. */
 export function compileNativeWireFile(source: string): string {
-  return generateNative(parse(source));
+  const ast = parse(source);
+  assertValidAst(ast);
+  return generateNative(ast);
 }
 
 /**
- * Compile `.wrn` source into TypeScript source. Throws `ParseError` on invalid
- * input (the dev loader surfaces this as a readable error page).
+ * Compile `.wrn` source into TypeScript source. Errors include a stable code,
+ * source location, code frame, and actionable hint whenever available.
  */
 export function compileWireFile(source: string, filePath = "<inline .wrn>"): string {
-  let ast;
-
   try {
-    ast = parse(source);
+    const ast = parse(source);
+    assertValidAst(ast, { file: filePath, accessibility: true });
+    return `// compiled from .wrn\n${generate(ast)}`;
   } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-
-    throw new Error(`Failed to parse ${filePath}: ${message}`, {
+    const diagnostic = diagnosticFromError(source, error, { file: filePath });
+    throw new Error(`Failed to parse ${filePath}:\n\n${formatDiagnostic(source, diagnostic)}`, {
       cause: error,
     });
   }
-
-  return `// compiled from .wrn\n${generate(ast)}`;
 }
 
-/** Richer entry point returning the AST and diagnostics alongside the code. */
-export function compile(source: string): CompileResult {
-  const diagnostics: string[] = [];
-  try {
-    const ast = parse(source);
-    return { code: `// compiled from .wrn\n${generate(ast)}`, ast, diagnostics };
-  } catch (err) {
-    if (err instanceof ParseError) diagnostics.push(err.message);
-    throw err;
+/** Richer entry point returning the AST and structured diagnostics. */
+export function compile(source: string, filePath = "<inline .wrn>"): CompileResult {
+  const richDiagnostics = diagnose(source, { file: filePath, accessibility: true });
+  const errors = richDiagnostics.filter((diagnostic) => diagnostic.severity === "error");
+  if (errors.length > 0) {
+    throw new ParseError(
+      errors.map((diagnostic) => diagnostic.message).join("\n"),
+      errors[0]!.code,
+    );
   }
+  const ast = parse(source);
+  return {
+    code: `// compiled from .wrn\n${generate(ast)}`,
+    ast,
+    diagnostics: richDiagnostics.map((diagnostic) => `${diagnostic.code}: ${diagnostic.message}`),
+    richDiagnostics,
+  };
 }