@wire-dsl/engine 0.0.2

package/LICENSE

@@ -0,0 +1,36 @@
+MIT License
+
+Copyright (c) 2026 WireDSL Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+## Third-Party Components & Assets
+
+### Feather Icons
+
+This project includes icons from Feather Icons (https://feathericons.com), created by Cole Bemis and contributors.
+
+- **License**: MIT License
+- **Repository**: https://github.com/feathericons/feather
+- **Location in project**: `packages/core/src/renderer/icons/`
+- **Full details**: See `packages/core/src/renderer/icons/ICONS-LICENSE.md`
+
+Feather Icons are used under the terms of the MIT License, which is fully compatible with this project's MIT License.

package/README.md

@@ -0,0 +1,102 @@
+# @wire-dsl/engine
+
+Pure JavaScript/TypeScript engine for Wire-DSL. Provides the parser, IR generator, layout engine, and SVG renderer for transforming `.wire` files into interactive wireframes. **Browser-safe - no Node.js dependencies.**
+
+## Installation
+
+```bash
+npm install @wire-dsl/engine
+```
+
+## Quick Start
+
+```typescript
+import { parseWire, generateIR, computeLayout, renderSVG } from '@wire-dsl/engine';
+
+// Parse .wire DSL file
+const ast = parseWire(`
+  screen "Home" {
+    heading "Welcome"
+    button "Click me"
+  }
+`);
+
+// Generate Intermediate Representation
+const ir = generateIR(ast);
+
+// Compute layout
+const layout = computeLayout(ir);
+
+console.log(layout);
+```
+
+## Core Modules
+
+### Parser
+Transforms `.wire` DSL syntax into an Abstract Syntax Tree (AST) using Chevrotain.
+
+```typescript
+import { parseWire } from '@wire-dsl/engine';
+const ast = parseWire(wireCode);
+```
+
+### IR (Intermediate Representation)
+Converts AST into a structured IR contract that describes components, properties, and relationships.
+
+```typescript
+import { generateIR } from '@wire-dsl/engine';
+const ir = generateIR(ast);
+```
+
+### Layout Engine
+Computes positions and dimensions for all components based on container types and constraints.
+
+```typescript
+import { computeLayout } from '@wire-dsl/engine';
+const layout = computeLayout(ir);
+```
+
+### Validators
+Schema-based validation using Zod to ensure IR correctness.
+
+```typescript
+import { validateIR } from '@wire-dsl/engine';
+validateIR(ir); // Throws if invalid
+```
+
+### Components
+23 built-in UI components including:
+
+**Basic:**
+- Text, Heading, Button, Link
+
+**Forms:**
+- Input, TextArea, Select, Checkbox, Radio
+
+**Containers:**
+- Stack, Grid, Split, Panel, Card
+
+**Interactive:**
+- Modal, Dialog, Tabs, Accordion
+
+**Advanced:**
+- Form, Embed, Icon, Badge, Tooltip
+
+## Features
+
+- 🎯 **Type-safe** - Full TypeScript support
+- ✅ **Validated** - Zod-based schema validation
+- 📐 **Layout Engine** - Automatic responsive positioning
+- 🔧 **Extensible** - Add custom components
+- ⚡ **Performance** - Optimized parsing and computation
+- 📦 **ESM + CJS** - Works in Node.js and browsers
+
+## Documentation
+
+- [IR Contract Specification](https://github.com/Wire-DSL/wire-dsl/blob/main/specs/IR-CONTRACT-EN.md)
+- [Layout Engine Algorithm](https://github.com/Wire-DSL/wire-dsl/blob/main/specs/LAYOUT-ENGINE-EN.md)
+- [Validation Rules](https://github.com/Wire-DSL/wire-dsl/blob/main/specs/VALIDATION-RULES-EN.md)
+
+## License
+
+MIT