wyreframe 0.2.2 → 0.4.0

package/dist/index.d.ts

@@ -99,6 +99,8 @@ export interface SceneManager {
     /** Get all available scene IDs */
     getSceneIds: () => string[];
 }
+/** Scene change callback type */
+export type OnSceneChangeCallback = (fromScene: string | undefined, toScene: string) => void;
 /** Render options */
 export interface RenderOptions {
     /** Theme name */
@@ -109,6 +111,13 @@ export interface RenderOptions {
     injectStyles?: boolean;
     /** Additional CSS class for container */
     containerClass?: string;
+    /**
+     * Callback fired when navigating between scenes.
+     * Useful for implementing scene history, analytics, or state synchronization.
+     * @param fromScene - The scene ID navigating from (undefined if initial navigation)
+     * @param toScene - The scene ID navigating to
+     */
+    onSceneChange?: OnSceneChangeCallback;
 }
 /** Render result */
 export interface RenderResult {
@@ -148,6 +157,27 @@ export type CreateUIErrorResult = {
     errors: ParseError[];
 };
 export type CreateUIResult = CreateUISuccessResult | CreateUIErrorResult;
+/** Describes a single fix that was applied */
+export interface FixedIssue {
+    original: ParseError;
+    description: string;
+    line: number;
+    column: number;
+}
+/** Successful fix result */
+export type FixSuccessResult = {
+    success: true;
+    text: string;
+    fixed: FixedIssue[];
+    remaining: ParseError[];
+};
+/** Failed fix result */
+export type FixErrorResult = {
+    success: false;
+    errors: ParseError[];
+};
+/** Result of fix operation */
+export type FixResult = FixSuccessResult | FixErrorResult;
 /**
  * Parse mixed text containing wireframe and interactions.
  *
@@ -252,6 +282,48 @@ export declare function createUI(text: string, options?: RenderOptions): CreateU
 export declare function createUIOrThrow(text: string, options?: RenderOptions): RenderResult & {
     ast: AST;
 };
+/**
+ * Attempt to auto-fix errors and warnings in the wireframe text.
+ *
+ * This function analyzes the text for common issues and automatically
+ * corrects them where possible. Fixable issues include:
+ * - MisalignedPipe: Adjusts pipe positions to correct columns
+ * - MisalignedClosingBorder: Fixes closing border alignment
+ * - UnusualSpacing: Replaces tabs with spaces
+ * - UnclosedBracket: Adds missing closing brackets
+ * - MismatchedWidth: Extends shorter borders to match
+ *
+ * @param text - The wireframe markdown text
+ * @returns Fix result with fixed text and details about applied fixes
+ *
+ * @example
+ * ```typescript
+ * const result = fix(text);
+ * if (result.success) {
+ *   console.log(`Fixed ${result.fixed.length} issues`);
+ *   if (result.remaining.length > 0) {
+ *     console.warn('Some issues require manual fix:', result.remaining);
+ *   }
+ *   // Use the fixed text
+ *   const parsed = parse(result.text);
+ * }
+ * ```
+ */
+export declare function fix(text: string): FixResult;
+/**
+ * Convenience function - fix and return just the fixed text.
+ * Returns the original text if nothing was fixed or if fixing failed.
+ *
+ * @param text - The wireframe markdown text
+ * @returns The fixed text (or original if no fixes applied)
+ *
+ * @example
+ * ```typescript
+ * const fixedText = fixOnly(rawMarkdown);
+ * const result = parse(fixedText);
+ * ```
+ */
+export declare function fixOnly(text: string): string;
 export declare const version: string;
 export declare const implementation: string;
 declare const _default: {
@@ -262,6 +334,8 @@ declare const _default: {
     render: typeof render;
     createUI: typeof createUI;
     createUIOrThrow: typeof createUIOrThrow;
+    fix: typeof fix;
+    fixOnly: typeof fixOnly;
     version: string;
     implementation: string;
 };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,wCAAwC;AACxC,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,kBAAkB,GAClB,QAAQ,GACR,kBAAkB,CAAC;AAEvB,0CAA0C;AAC1C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AAE5E,qBAAqB;AACrB,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,4BAA4B;AAC5B,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE9D,oCAAoC;AACpC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC;AAEhC,uBAAuB;AACvB,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,KAAK,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,QAAQ,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,OAAO,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,UAAU,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,KAAK,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,SAAS,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,OAAO,GACf,UAAU,GACV,aAAa,GACb,YAAY,GACZ,WAAW,GACX,WAAW,GACX,eAAe,GACf,cAAc,GACd,UAAU,GACV,cAAc,CAAC;AAEnB,uBAAuB;AACvB,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,2BAA2B;AAC3B,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;CACjB;AAED,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,+BAA+B;IAC/B,eAAe,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,kCAAkC;IAClC,WAAW,EAAE,MAAM,MAAM,EAAE,CAAC;CAC7B;AAED,iCAAiC;AACjC,MAAM,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE7F,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;CACvC;AAED,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,4BAA4B;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,mCAAmC;IACnC,YAAY,EAAE,YAAY,CAAC;CAC5B;AAMD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAEhE,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,IAAI,CAAC;IACd,YAAY,EAAE,OAAO,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,GAAG,sBAAsB,CAAC;AAElF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAAG,mBAAmB,CAAC;AAMzE,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,4BAA4B;AAC5B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,EAAE,UAAU,EAAE,CAAC;CACzB,CAAC;AAEF,wBAAwB;AACxB,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAsB1D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAS/C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAW9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAS7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAQhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,CAqCtE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAgB9E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,CAK7B;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAsB3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAGD,eAAO,MAAM,OAAO,EAAE,MAAuB,CAAC;AAC9C,eAAO,MAAM,cAAc,EAAE,MAA8B,CAAC;;;;;;;;;;;;;;AAG5D,wBAYE"}

package/dist/index.js

@@ -10,6 +10,8 @@
 import * as Parser from '../src/parser/Parser.mjs';
 // @ts-ignore - ReScript generated module
 import * as Renderer from '../src/renderer/Renderer.mjs';
+// @ts-ignore - ReScript generated module
+import * as Fixer from '../src/parser/Fixer/Fixer.mjs';
 // ============================================================================
 // API Functions
 // ============================================================================
@@ -198,6 +200,84 @@ export function createUIOrThrow(text, options) {
     const { root, sceneManager } = render(ast, options);
     return { root, sceneManager, ast };
 }
+/**
+ * Convert ReScript error to ParseError
+ */
+function convertReScriptError(err) {
+    // The ReScript error has a complex structure, extract what we need
+    return {
+        message: String(err.code) || 'Unknown error',
+        line: undefined,
+        column: undefined,
+        source: undefined,
+    };
+}
+/**
+ * Attempt to auto-fix errors and warnings in the wireframe text.
+ *
+ * This function analyzes the text for common issues and automatically
+ * corrects them where possible. Fixable issues include:
+ * - MisalignedPipe: Adjusts pipe positions to correct columns
+ * - MisalignedClosingBorder: Fixes closing border alignment
+ * - UnusualSpacing: Replaces tabs with spaces
+ * - UnclosedBracket: Adds missing closing brackets
+ * - MismatchedWidth: Extends shorter borders to match
+ *
+ * @param text - The wireframe markdown text
+ * @returns Fix result with fixed text and details about applied fixes
+ *
+ * @example
+ * ```typescript
+ * const result = fix(text);
+ * if (result.success) {
+ *   console.log(`Fixed ${result.fixed.length} issues`);
+ *   if (result.remaining.length > 0) {
+ *     console.warn('Some issues require manual fix:', result.remaining);
+ *   }
+ *   // Use the fixed text
+ *   const parsed = parse(result.text);
+ * }
+ * ```
+ */
+export function fix(text) {
+    const result = Fixer.fix(text);
+    if (result.TAG === 'Ok') {
+        const success = result._0;
+        return {
+            success: true,
+            text: success.text,
+            fixed: success.fixed.map((f) => ({
+                original: convertReScriptError(f.original),
+                description: f.description,
+                line: f.line,
+                column: f.column,
+            })),
+            remaining: success.remaining.map(convertReScriptError),
+        };
+    }
+    else {
+        return {
+            success: false,
+            errors: result._0.map(convertReScriptError),
+        };
+    }
+}
+/**
+ * Convenience function - fix and return just the fixed text.
+ * Returns the original text if nothing was fixed or if fixing failed.
+ *
+ * @param text - The wireframe markdown text
+ * @returns The fixed text (or original if no fixes applied)
+ *
+ * @example
+ * ```typescript
+ * const fixedText = fixOnly(rawMarkdown);
+ * const result = parse(fixedText);
+ * ```
+ */
+export function fixOnly(text) {
+    return Fixer.fixOnly(text);
+}
 // Version info
 export const version = Parser.version;
 export const implementation = Parser.implementation;
@@ -210,6 +290,8 @@ export default {
     render,
     createUI,
     createUIOrThrow,
+    fix,
+    fixOnly,
     version,
     implementation,
 };

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wyreframe",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "description": "ASCII wireframe + interaction DSL to HTML converter with scene transitions",
   "author": "wickedev",
   "repository": {

package/src/index.test.ts

@@ -0,0 +1,252 @@
+/**
+ * Tests for TypeScript API wrapper input validation
+ *
+ * These tests verify that render() provides helpful error messages
+ * when called with incorrect arguments (Issue #1).
+ */
+
+import { describe, test, expect, vi } from 'vitest';
+import { parse, render, createUI } from './index';
+import type { AST, ParseResult, OnSceneChangeCallback } from './index';
+
+describe('render() input validation (Issue #1)', () => {
+  const validWireframe = `
+@scene: test
+
++-------+
+| Hello |
++-------+
+`;
+
+  test('throws descriptive error when passed successful ParseResult instead of AST', () => {
+    const result = parse(validWireframe);
+
+    // Verify we have a successful parse result
+    expect(result.success).toBe(true);
+
+    // This is the common mistake: passing result instead of result.ast
+    expect(() => {
+      render(result as unknown as AST);
+    }).toThrow('render() expects an AST object, but received a ParseResult');
+
+    expect(() => {
+      render(result as unknown as AST);
+    }).toThrow('Did you forget to extract .ast?');
+  });
+
+  test('throws descriptive error when passed failed ParseResult', () => {
+    // Invalid wireframe that will fail to parse
+    const invalidWireframe = '+--incomplete';
+    const result = parse(invalidWireframe);
+
+    // This should be a failed parse
+    expect(result.success).toBe(false);
+
+    expect(() => {
+      render(result as unknown as AST);
+    }).toThrow('render() received a failed ParseResult');
+
+    expect(() => {
+      render(result as unknown as AST);
+    }).toThrow('Check parse errors before calling render');
+  });
+
+  test('throws descriptive error when passed null or undefined', () => {
+    expect(() => {
+      render(null as unknown as AST);
+    }).toThrow('render() expects an AST object with a scenes array');
+
+    expect(() => {
+      render(undefined as unknown as AST);
+    }).toThrow('render() expects an AST object with a scenes array');
+  });
+
+  test('throws descriptive error when passed object without scenes array', () => {
+    const invalidAST = { foo: 'bar' };
+
+    expect(() => {
+      render(invalidAST as unknown as AST);
+    }).toThrow('render() expects an AST object with a scenes array');
+
+    expect(() => {
+      render(invalidAST as unknown as AST);
+    }).toThrow('Did you pass ParseResult instead of ParseResult.ast?');
+  });
+
+  // Note: DOM-dependent tests are skipped in Node.js environment
+  // The renderer requires a browser or jsdom environment
+  test.skip('works correctly when passed valid AST (requires DOM)', () => {
+    const result = parse(validWireframe);
+
+    expect(result.success).toBe(true);
+    if (result.success) {
+      // This is the correct usage
+      const { root, sceneManager } = render(result.ast);
+
+      expect(root).toBeDefined();
+      expect(root).toBeInstanceOf(HTMLElement);
+      expect(sceneManager).toBeDefined();
+      expect(sceneManager.getSceneIds()).toContain('test');
+    }
+  });
+});
+
+describe('createUI() convenience function', () => {
+  test('handles parse errors gracefully', () => {
+    const invalidWireframe = '+--incomplete';
+    const result = createUI(invalidWireframe);
+
+    expect(result.success).toBe(false);
+    if (!result.success) {
+      expect(result.errors).toBeDefined();
+      expect(result.errors.length).toBeGreaterThan(0);
+    }
+  });
+
+  // Note: DOM-dependent tests are skipped in Node.js environment
+  test.skip('works correctly with valid wireframe (requires DOM)', () => {
+    const validWireframe = `
+@scene: test
+
++-------+
+| Hello |
++-------+
+`;
+    const result = createUI(validWireframe);
+
+    expect(result.success).toBe(true);
+    if (result.success) {
+      expect(result.root).toBeDefined();
+      expect(result.sceneManager).toBeDefined();
+      expect(result.ast).toBeDefined();
+    }
+  });
+});
+
+describe('onSceneChange callback (Issue #2)', () => {
+  const multiSceneWireframe = `
+@scene: login
+
++---------------+
+| Login Screen  |
++---------------+
+
+---
+
+@scene: dashboard
+
++---------------+
+| Dashboard     |
++---------------+
+`;
+
+  test('OnSceneChangeCallback type is exported', () => {
+    // Verify the type is exported by using it
+    const callback: OnSceneChangeCallback = (_from, _to) => {};
+    expect(typeof callback).toBe('function');
+  });
+
+  // Note: DOM-dependent tests are skipped in Node.js environment
+  test.skip('render accepts onSceneChange option without throwing (requires DOM)', () => {
+    const result = parse(multiSceneWireframe);
+    expect(result.success).toBe(true);
+
+    if (result.success) {
+      const callback = vi.fn();
+
+      // This should not throw - just verify the API accepts the option
+      expect(() => {
+        render(result.ast, {
+          onSceneChange: callback,
+        });
+      }).not.toThrow();
+    }
+  });
+
+  test.skip('createUI accepts onSceneChange option without throwing (requires DOM)', () => {
+    const callback = vi.fn();
+
+    // Verify the API accepts the option
+    expect(() => {
+      createUI(multiSceneWireframe, {
+        onSceneChange: callback,
+      });
+    }).not.toThrow();
+  });
+
+  // Note: DOM-dependent tests are skipped in Node.js environment
+  test.skip('onSceneChange is called on initial scene load (requires DOM)', () => {
+    const result = parse(multiSceneWireframe);
+    expect(result.success).toBe(true);
+
+    if (result.success) {
+      const callback = vi.fn();
+      render(result.ast, { onSceneChange: callback });
+
+      // Should be called once for initial scene
+      expect(callback).toHaveBeenCalledTimes(1);
+      expect(callback).toHaveBeenCalledWith(undefined, 'login');
+    }
+  });
+
+  test.skip('onSceneChange is called when navigating between scenes (requires DOM)', () => {
+    const result = parse(multiSceneWireframe);
+    expect(result.success).toBe(true);
+
+    if (result.success) {
+      const callback = vi.fn();
+      const { sceneManager } = render(result.ast, { onSceneChange: callback });
+
+      // Clear mock after initial call
+      callback.mockClear();
+
+      // Navigate to dashboard
+      sceneManager.goto('dashboard');
+
+      expect(callback).toHaveBeenCalledTimes(1);
+      expect(callback).toHaveBeenCalledWith('login', 'dashboard');
+    }
+  });
+
+  test.skip('onSceneChange is not called when navigating to the same scene (requires DOM)', () => {
+    const result = parse(multiSceneWireframe);
+    expect(result.success).toBe(true);
+
+    if (result.success) {
+      const callback = vi.fn();
+      const { sceneManager } = render(result.ast, { onSceneChange: callback });
+
+      // Clear mock after initial call
+      callback.mockClear();
+
+      // Navigate to the same scene
+      sceneManager.goto('login');
+
+      expect(callback).not.toHaveBeenCalled();
+    }
+  });
+
+  test.skip('onSceneChange receives correct fromScene and toScene values (requires DOM)', () => {
+    const result = parse(multiSceneWireframe);
+    expect(result.success).toBe(true);
+
+    if (result.success) {
+      const navigationHistory: Array<{ from: string | undefined; to: string }> = [];
+      const callback: OnSceneChangeCallback = (from, to) => {
+        navigationHistory.push({ from, to });
+      };
+
+      const { sceneManager } = render(result.ast, { onSceneChange: callback });
+
+      // Navigate through scenes
+      sceneManager.goto('dashboard');
+      sceneManager.goto('login');
+
+      expect(navigationHistory).toEqual([
+        { from: undefined, to: 'login' },  // Initial
+        { from: 'login', to: 'dashboard' },
+        { from: 'dashboard', to: 'login' },
+      ]);
+    }
+  });
+});

package/src/index.ts

@@ -11,6 +11,8 @@
 import * as Parser from '../src/parser/Parser.mjs';
 // @ts-ignore - ReScript generated module
 import * as Renderer from '../src/renderer/Renderer.mjs';
+// @ts-ignore - ReScript generated module
+import * as Fixer from '../src/parser/Fixer/Fixer.mjs';
 
 // ============================================================================
 // Type Definitions
@@ -146,6 +148,9 @@ export interface SceneManager {
   getSceneIds: () => string[];
 }
 
+/** Scene change callback type */
+export type OnSceneChangeCallback = (fromScene: string | undefined, toScene: string) => void;
+
 /** Render options */
 export interface RenderOptions {
   /** Theme name */
@@ -156,6 +161,13 @@ export interface RenderOptions {
   injectStyles?: boolean;
   /** Additional CSS class for container */
   containerClass?: string;
+  /**
+   * Callback fired when navigating between scenes.
+   * Useful for implementing scene history, analytics, or state synchronization.
+   * @param fromScene - The scene ID navigating from (undefined if initial navigation)
+   * @param toScene - The scene ID navigating to
+   */
+  onSceneChange?: OnSceneChangeCallback;
 }
 
 /** Render result */
@@ -210,6 +222,35 @@ export type CreateUIErrorResult = {
 
 export type CreateUIResult = CreateUISuccessResult | CreateUIErrorResult;
 
+// ============================================================================
+// Fix Result Types
+// ============================================================================
+
+/** Describes a single fix that was applied */
+export interface FixedIssue {
+  original: ParseError;
+  description: string;
+  line: number;
+  column: number;
+}
+
+/** Successful fix result */
+export type FixSuccessResult = {
+  success: true;
+  text: string;
+  fixed: FixedIssue[];
+  remaining: ParseError[];
+};
+
+/** Failed fix result */
+export type FixErrorResult = {
+  success: false;
+  errors: ParseError[];
+};
+
+/** Result of fix operation */
+export type FixResult = FixSuccessResult | FixErrorResult;
+
 // ============================================================================
 // Internal ReScript Result Type
 // ============================================================================
@@ -437,6 +478,105 @@ export function createUIOrThrow(
   return { root, sceneManager, ast };
 }
 
+// ============================================================================
+// Fix API Functions
+// ============================================================================
+
+/**
+ * Internal ReScript Fix Result type
+ */
+interface ReScriptFixSuccess {
+  text: string;
+  fixed: Array<{
+    original: { code: unknown; severity: unknown; context: unknown };
+    description: string;
+    line: number;
+    column: number;
+  }>;
+  remaining: Array<{ code: unknown; severity: unknown; context: unknown }>;
+}
+
+/**
+ * Convert ReScript error to ParseError
+ */
+function convertReScriptError(err: { code: unknown; severity: unknown; context: unknown }): ParseError {
+  // The ReScript error has a complex structure, extract what we need
+  return {
+    message: String(err.code) || 'Unknown error',
+    line: undefined,
+    column: undefined,
+    source: undefined,
+  };
+}
+
+/**
+ * Attempt to auto-fix errors and warnings in the wireframe text.
+ *
+ * This function analyzes the text for common issues and automatically
+ * corrects them where possible. Fixable issues include:
+ * - MisalignedPipe: Adjusts pipe positions to correct columns
+ * - MisalignedClosingBorder: Fixes closing border alignment
+ * - UnusualSpacing: Replaces tabs with spaces
+ * - UnclosedBracket: Adds missing closing brackets
+ * - MismatchedWidth: Extends shorter borders to match
+ *
+ * @param text - The wireframe markdown text
+ * @returns Fix result with fixed text and details about applied fixes
+ *
+ * @example
+ * ```typescript
+ * const result = fix(text);
+ * if (result.success) {
+ *   console.log(`Fixed ${result.fixed.length} issues`);
+ *   if (result.remaining.length > 0) {
+ *     console.warn('Some issues require manual fix:', result.remaining);
+ *   }
+ *   // Use the fixed text
+ *   const parsed = parse(result.text);
+ * }
+ * ```
+ */
+export function fix(text: string): FixResult {
+  const result = Fixer.fix(text) as ReScriptResult<ReScriptFixSuccess, Array<{ code: unknown; severity: unknown; context: unknown }>>;
+
+  if (result.TAG === 'Ok') {
+    const success = result._0;
+    return {
+      success: true,
+      text: success.text,
+      fixed: success.fixed.map((f) => ({
+        original: convertReScriptError(f.original),
+        description: f.description,
+        line: f.line,
+        column: f.column,
+      })),
+      remaining: success.remaining.map(convertReScriptError),
+    };
+  } else {
+    return {
+      success: false,
+      errors: result._0.map(convertReScriptError),
+    };
+  }
+}
+
+/**
+ * Convenience function - fix and return just the fixed text.
+ * Returns the original text if nothing was fixed or if fixing failed.
+ *
+ * @param text - The wireframe markdown text
+ * @returns The fixed text (or original if no fixes applied)
+ *
+ * @example
+ * ```typescript
+ * const fixedText = fixOnly(rawMarkdown);
+ * const result = parse(fixedText);
+ * ```
+ */
+export function fixOnly(text: string): string {
+  return Fixer.fixOnly(text) as string;
+}
+
 // Version info
 export const version: string = Parser.version;
 export const implementation: string = Parser.implementation;
@@ -450,6 +590,8 @@ export default {
   render,
   createUI,
   createUIOrThrow,
+  fix,
+  fixOnly,
   version,
   implementation,
 };