wyreframe 0.1.0

package/README.md

@@ -0,0 +1,123 @@
+# Wyreframe
+
+> A library that converts ASCII wireframes into working HTML/UI
+
+[![npm version](https://img.shields.io/npm/v/wyreframe.svg)](https://www.npmjs.com/package/wyreframe)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+```
++---------------------------+
+|      'WYREFRAME'          |     Draw in ASCII
+|  +---------------------+  |         ↓
+|  | #email              |  |     Convert to HTML!
+|  +---------------------+  |
+|       [ Login ]           |
++---------------------------+
+```
+
+## Installation
+
+```bash
+npm install wyreframe
+```
+
+## Quick Start
+
+```javascript
+import { createUI } from 'wyreframe';
+
+const ui = `
+@scene: login
+
++---------------------------+
+|       'WYREFRAME'         |
+|  +---------------------+  |
+|  | #email              |  |
+|  +---------------------+  |
+|       [ Login ]           |
++---------------------------+
+
+#email:
+  placeholder: "Enter your email"
+
+[Login]:
+  @click -> goto(dashboard, slide-left)
+`;
+
+const result = createUI(ui);
+
+if (result.success) {
+  document.getElementById('app').appendChild(result.root);
+  result.sceneManager.goto('login');
+}
+```
+
+## Syntax Summary
+
+| Syntax | Description | Example |
+|------|------|------|
+| `+---+` | Box/Container | `<div>` |
+| `[ Text ]` | Button | `<button>` |
+| `#id` | Input field | `<input>` |
+| `"text"` | Link | `<a>` |
+| `'text'` | Emphasis text | Title, Heading |
+| `[x]` / `[ ]` | Checkbox | `<input type="checkbox">` |
+| `---` | Scene separator | Multi-scene |
+
+## API
+
+```javascript
+import { parse, render, createUI, createUIOrThrow } from 'wyreframe';
+
+// Parse only
+const result = parse(text);
+
+// Render only
+const { root, sceneManager } = render(ast);
+
+// Parse + Render (recommended)
+const result = createUI(text);
+
+// Throw on error
+const { root, sceneManager } = createUIOrThrow(text);
+```
+
+### SceneManager
+
+```javascript
+sceneManager.goto('dashboard');           // Navigate to scene
+sceneManager.getCurrentScene();           // Get current scene
+sceneManager.getSceneIds();               // Get all scene IDs
+```
+
+## Interactions
+
+```yaml
+#email:
+  placeholder: "Email"
+
+[Login]:
+  variant: primary
+  @click -> goto(dashboard, slide-left)
+```
+
+**Transition effects:** `fade`, `slide-left`, `slide-right`, `zoom`
+
+## Documentation
+
+- [Parser Architecture](docs/PARSER_ARCHITECTURE.md)
+- [Testing Guide](docs/TESTING.md)
+- [Examples](examples/index.html)
+
+## Development
+
+```bash
+npm install
+npm run res:build    # ReScript build
+npm run dev          # Dev server (http://localhost:3000/examples)
+npm test             # Run tests
+```
+
+## License
+
+MIT License

package/dist/index.d.ts

@@ -0,0 +1,267 @@
+/**
+ * Wyreframe - ASCII Wireframe to HTML/UI Converter
+ *
+ * This module provides a TypeScript-friendly API wrapper
+ * around the ReScript parser implementation.
+ */
+/** Device type for responsive design */
+export type DeviceType = 'desktop' | 'laptop' | 'tablet' | 'tablet-landscape' | 'mobile' | 'mobile-landscape';
+/** Transition effect for scene changes */
+export type TransitionType = 'fade' | 'slide-left' | 'slide-right' | 'zoom';
+/** Text alignment */
+export type Alignment = 'left' | 'center' | 'right';
+/** Button variant styles */
+export type ButtonVariant = 'primary' | 'secondary' | 'ghost';
+/** Action types for interactions */
+export interface GotoAction {
+    type: 'goto';
+    target: string;
+    transition?: TransitionType;
+}
+export type Action = GotoAction;
+/** UI Element types */
+export interface BoxElement {
+    TAG: 'Box';
+    name?: string;
+    children: Element[];
+}
+export interface ButtonElement {
+    TAG: 'Button';
+    id: string;
+    text: string;
+    align: Alignment;
+    variant?: ButtonVariant;
+    actions: Action[];
+}
+export interface InputElement {
+    TAG: 'Input';
+    id: string;
+    placeholder?: string;
+    variant?: string;
+}
+export interface LinkElement {
+    TAG: 'Link';
+    id: string;
+    text: string;
+    align: Alignment;
+    actions: Action[];
+}
+export interface TextElement {
+    TAG: 'Text';
+    content: string;
+    emphasis: boolean;
+    align: Alignment;
+}
+export interface CheckboxElement {
+    TAG: 'Checkbox';
+    checked: boolean;
+    label: string;
+}
+export interface DividerElement {
+    TAG: 'Divider';
+}
+export interface RowElement {
+    TAG: 'Row';
+    children: Element[];
+    align: Alignment;
+}
+export interface SectionElement {
+    TAG: 'Section';
+    name: string;
+    children: Element[];
+}
+export type Element = BoxElement | ButtonElement | InputElement | LinkElement | TextElement | CheckboxElement | DividerElement | RowElement | SectionElement;
+/** Scene definition */
+export interface Scene {
+    id: string;
+    title: string;
+    device: DeviceType;
+    transition: TransitionType;
+    elements: Element[];
+}
+/** Abstract Syntax Tree */
+export interface AST {
+    scenes: Scene[];
+}
+/** Parse error information */
+export interface ParseError {
+    message: string;
+    line?: number;
+    column?: number;
+    source?: string;
+}
+/** Scene manager for programmatic navigation */
+export interface SceneManager {
+    /** Navigate to a scene by ID */
+    goto: (sceneId: string) => void;
+    /** Get the current scene ID */
+    getCurrentScene: () => string | undefined;
+    /** Get all available scene IDs */
+    getSceneIds: () => string[];
+}
+/** Render options */
+export interface RenderOptions {
+    /** Theme name */
+    theme?: string;
+    /** Enable interactions (default: true) */
+    interactive?: boolean;
+    /** Inject default styles (default: true) */
+    injectStyles?: boolean;
+    /** Additional CSS class for container */
+    containerClass?: string;
+}
+/** Render result */
+export interface RenderResult {
+    /** Rendered root element */
+    root: HTMLElement;
+    /** Scene manager for navigation */
+    sceneManager: SceneManager;
+}
+export type ParseSuccessResult = {
+    success: true;
+    ast: AST;
+};
+export type ParseErrorResult = {
+    success: false;
+    errors: ParseError[];
+};
+export type ParseResult = ParseSuccessResult | ParseErrorResult;
+export type InteractionSuccessResult = {
+    success: true;
+    interactions: unknown[];
+};
+export type InteractionErrorResult = {
+    success: false;
+    errors: ParseError[];
+};
+export type InteractionResult = InteractionSuccessResult | InteractionErrorResult;
+export type CreateUISuccessResult = {
+    success: true;
+    root: HTMLElement;
+    sceneManager: SceneManager;
+    ast: AST;
+};
+export type CreateUIErrorResult = {
+    success: false;
+    errors: ParseError[];
+};
+export type CreateUIResult = CreateUISuccessResult | CreateUIErrorResult;
+/**
+ * Parse mixed text containing wireframe and interactions.
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @returns Parse result with success flag
+ *
+ * @example
+ * ```typescript
+ * const result = parse(text);
+ * if (result.success) {
+ *   const { root, sceneManager } = render(result.ast);
+ *   document.body.appendChild(root);
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export declare function parse(text: string): ParseResult;
+/**
+ * Parse text and throw on error.
+ * Use this for simpler code when you expect parsing to succeed.
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @returns Parsed AST
+ * @throws Error if parsing fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const ast = parseOrThrow(text);
+ *   const { root } = render(ast);
+ *   document.body.appendChild(root);
+ * } catch (error) {
+ *   console.error('Parse failed:', error.message);
+ * }
+ * ```
+ */
+export declare function parseOrThrow(text: string): AST;
+/**
+ * Parse only the wireframe structure (no interactions).
+ *
+ * @param wireframe - ASCII wireframe string
+ * @returns Parse result with success flag
+ */
+export declare function parseWireframe(wireframe: string): ParseResult;
+/**
+ * Parse only the interaction DSL.
+ *
+ * @param dsl - Interaction DSL string
+ * @returns Interaction result with success flag
+ */
+export declare function parseInteractions(dsl: string): InteractionResult;
+/**
+ * Render AST to DOM elements.
+ *
+ * @param ast - Parsed AST from parse()
+ * @param options - Render options
+ * @returns Render result with root element and scene manager
+ *
+ * @example
+ * ```typescript
+ * const { root, sceneManager } = render(ast);
+ * document.getElementById('app')!.appendChild(root);
+ *
+ * // Navigate between scenes
+ * sceneManager.goto('dashboard');
+ * ```
+ */
+export declare function render(ast: AST, options?: RenderOptions): RenderResult;
+/**
+ * Parse and render in one step.
+ * Convenience function that combines parse() and render().
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @param options - Render options
+ * @returns Create UI result with success flag
+ *
+ * @example
+ * ```typescript
+ * const result = createUI(text);
+ * if (result.success) {
+ *   document.getElementById('app')!.appendChild(result.root);
+ *   result.sceneManager.goto('login');
+ * }
+ * ```
+ */
+export declare function createUI(text: string, options?: RenderOptions): CreateUIResult;
+/**
+ * Parse and render, throwing on error.
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @param options - Render options
+ * @returns Render result with root element, scene manager, and AST
+ * @throws Error if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const { root, sceneManager } = createUIOrThrow(text);
+ * document.getElementById('app')!.appendChild(root);
+ * ```
+ */
+export declare function createUIOrThrow(text: string, options?: RenderOptions): RenderResult & {
+    ast: AST;
+};
+export declare const version: string;
+export declare const implementation: string;
+declare const _default: {
+    parse: typeof parse;
+    parseOrThrow: typeof parseOrThrow;
+    parseWireframe: typeof parseWireframe;
+    parseInteractions: typeof parseInteractions;
+    render: typeof render;
+    createUI: typeof createUI;
+    createUIOrThrow: typeof createUIOrThrow;
+    version: string;
+    implementation: string;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,195 @@
+/**
+ * Wyreframe - ASCII Wireframe to HTML/UI Converter
+ *
+ * This module provides a TypeScript-friendly API wrapper
+ * around the ReScript parser implementation.
+ */
+// Note: These imports use relative paths that work when compiled to dist/
+// The ReScript .mjs files remain in src/parser/, so dist/index.js imports ../src/parser/
+// @ts-ignore - ReScript generated module
+import * as Parser from '../src/parser/Parser.mjs';
+// @ts-ignore - ReScript generated module
+import * as Renderer from '../src/renderer/Renderer.mjs';
+// ============================================================================
+// API Functions
+// ============================================================================
+/**
+ * Parse mixed text containing wireframe and interactions.
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @returns Parse result with success flag
+ *
+ * @example
+ * ```typescript
+ * const result = parse(text);
+ * if (result.success) {
+ *   const { root, sceneManager } = render(result.ast);
+ *   document.body.appendChild(root);
+ * } else {
+ *   console.error(result.errors);
+ * }
+ * ```
+ */
+export function parse(text) {
+    const result = Parser.parse(text);
+    if (result.TAG === 'Ok') {
+        return { success: true, ast: result._0 };
+    }
+    else {
+        return { success: false, errors: result._0 };
+    }
+}
+/**
+ * Parse text and throw on error.
+ * Use this for simpler code when you expect parsing to succeed.
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @returns Parsed AST
+ * @throws Error if parsing fails
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const ast = parseOrThrow(text);
+ *   const { root } = render(ast);
+ *   document.body.appendChild(root);
+ * } catch (error) {
+ *   console.error('Parse failed:', error.message);
+ * }
+ * ```
+ */
+export function parseOrThrow(text) {
+    const result = parse(text);
+    if (result.success) {
+        return result.ast;
+    }
+    else {
+        const errorMessages = result.errors
+            .map((e) => e.message || JSON.stringify(e))
+            .join('\n');
+        throw new Error(`Parse failed:\n${errorMessages}`);
+    }
+}
+/**
+ * Parse only the wireframe structure (no interactions).
+ *
+ * @param wireframe - ASCII wireframe string
+ * @returns Parse result with success flag
+ */
+export function parseWireframe(wireframe) {
+    const result = Parser.parseWireframe(wireframe);
+    if (result.TAG === 'Ok') {
+        return { success: true, ast: result._0 };
+    }
+    else {
+        return { success: false, errors: result._0 };
+    }
+}
+/**
+ * Parse only the interaction DSL.
+ *
+ * @param dsl - Interaction DSL string
+ * @returns Interaction result with success flag
+ */
+export function parseInteractions(dsl) {
+    const result = Parser.parseInteractions(dsl);
+    if (result.TAG === 'Ok') {
+        return { success: true, interactions: result._0 };
+    }
+    else {
+        return { success: false, errors: result._0 };
+    }
+}
+/**
+ * Render AST to DOM elements.
+ *
+ * @param ast - Parsed AST from parse()
+ * @param options - Render options
+ * @returns Render result with root element and scene manager
+ *
+ * @example
+ * ```typescript
+ * const { root, sceneManager } = render(ast);
+ * document.getElementById('app')!.appendChild(root);
+ *
+ * // Navigate between scenes
+ * sceneManager.goto('dashboard');
+ * ```
+ */
+export function render(ast, options) {
+    // Pass undefined if no options, so ReScript uses its defaults
+    const result = Renderer.render(ast, options);
+    return {
+        root: result.root,
+        sceneManager: {
+            goto: result.sceneManager.goto,
+            getCurrentScene: result.sceneManager.getCurrentScene,
+            getSceneIds: result.sceneManager.getSceneIds,
+        },
+    };
+}
+/**
+ * Parse and render in one step.
+ * Convenience function that combines parse() and render().
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @param options - Render options
+ * @returns Create UI result with success flag
+ *
+ * @example
+ * ```typescript
+ * const result = createUI(text);
+ * if (result.success) {
+ *   document.getElementById('app')!.appendChild(result.root);
+ *   result.sceneManager.goto('login');
+ * }
+ * ```
+ */
+export function createUI(text, options) {
+    const parseResult = parse(text);
+    if (!parseResult.success) {
+        return parseResult;
+    }
+    const { root, sceneManager } = render(parseResult.ast, options);
+    return {
+        success: true,
+        root,
+        sceneManager,
+        ast: parseResult.ast,
+    };
+}
+/**
+ * Parse and render, throwing on error.
+ *
+ * @param text - Text containing ASCII wireframe and/or interaction DSL
+ * @param options - Render options
+ * @returns Render result with root element, scene manager, and AST
+ * @throws Error if parsing fails
+ *
+ * @example
+ * ```typescript
+ * const { root, sceneManager } = createUIOrThrow(text);
+ * document.getElementById('app')!.appendChild(root);
+ * ```
+ */
+export function createUIOrThrow(text, options) {
+    const ast = parseOrThrow(text);
+    const { root, sceneManager } = render(ast, options);
+    return { root, sceneManager, ast };
+}
+// Version info
+export const version = Parser.version;
+export const implementation = Parser.implementation;
+// Default export for convenience
+export default {
+    parse,
+    parseOrThrow,
+    parseWireframe,
+    parseInteractions,
+    render,
+    createUI,
+    createUIOrThrow,
+    version,
+    implementation,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "wyreframe",
+  "version": "0.1.0",
+  "description": "ASCII wireframe + interaction DSL to HTML converter with scene transitions",
+  "author": "wickedev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wickedev/wyreframe.git"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src/parser",
+    "src/renderer",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./parser": {
+      "import": "./src/parser/Parser.mjs"
+    },
+    "./renderer": {
+      "import": "./src/renderer/Renderer.mjs"
+    }
+  },
+  "scripts": {
+    "dev": "npx serve .",
+    "build": "npm run res:build && npm run ts:build",
+    "ts:build": "tsc",
+    "ts:watch": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "res:build": "rescript",
+    "res:watch": "rescript build -w",
+    "res:clean": "rescript clean",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "wireframe",
+    "ascii",
+    "dsl",
+    "html",
+    "prototype"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@rescript/core": "^1.6.1",
+    "rescript": "12",
+    "vitest": "^3.2.4"
+  },
+  "devDependencies": {
+    "rescript-vitest": "^2.1.1",
+    "typescript": "^5.9.3"
+  }
+}