wozie 3.0.0

package/DOCS.md

@@ -0,0 +1,191 @@
+# Woozie — The Easiest Web Framework Ever 🚀
+
+**Built by Woozlit 2026 — v2.0**
+
+Write simple tags. Get beautiful, responsive websites. No HTML, no CSS, no JavaScript required.
+
+## What is Woozie?
+
+Woozie is a declarative UI language that compiles to modern HTML/CSS/JS. It has **40+ built-in components**, a **plugin system**, **dark mode**, **style files**, and **multi-file output** — all with zero configuration.
+
+```woozie
+app "My App":
+    hero "Hello World":
+        text "Built with Woozie"
+        button "Get Started"
+```
+
+That's a full website. Seriously.
+
+## Quick Start
+
+```bash
+git clone <repo-url>
+cd woozie
+npm install
+npm link
+
+woozie init MyProject
+cd MyProject
+woozie run
+```
+
+Open http://localhost:3000 and see your app with live reload.
+
+## Features
+
+| Feature | Description |
+|---------|-------------|
+| **40+ Components** | Buttons, cards, forms, modals, tabs, accordions, alerts, stats, and more |
+| **Style Files** | Customize any component via `style.woozie` |
+| **Dark Mode** | Set `theme: dark` in `woozie.rules` |
+| **Plugins** | Drop a `.woozie` file in `plugins/` — it becomes a tag |
+| **Live Reload** | Dev server watches files and reloads instantly |
+| **Multi-File Output** | Generates separate HTML, CSS, JS files |
+| **Responsive** | Every component is mobile-friendly |
+| **Animations** | Scroll animations, hover effects, transitions |
+| **Attributes** | `button "Click" [variant=outline, color=success]` |
+| **Comments** | `// This is a comment` |
+| **Zero Config** | No webpack, no babel, no config files |
+
+## Project Structure
+
+```
+my-project/
+    main.woozie         <- entry point (your app)
+    woozie.rules        <- config (NO COMMENTS allowed)
+    style.woozie        <- custom style overrides (optional)
+    plugins/            <- custom components (optional)
+        navbar.woozie
+        sidebar.woozie
+```
+
+## Syntax
+
+Woozie is indentation-based. Tags can have string arguments and attributes:
+
+```woozie
+tagname "argument" [attr1=value1, attr2=value2]:
+    child_tag "child argument"
+```
+
+A colon `:` at the end means the tag has children (indent them below).
+
+## Components
+
+### Layout
+`column` `row` `grid [cols=N]` `center` `container` `section` `spacer` `divider` `wrap`
+
+### Typography
+`heading` `subheading` `text` `small` `bold` `italic` `label` `link [href=URL]` `code` `quote`
+
+### Interactive
+`button [variant=solid|outline|ghost, color=primary|success|warning|danger, size=sm|md|lg]`
+`input [type=text|email|password]` `textarea [rows=N]` `select`/`option` `toggle` `checkbox` `radio [name=group]` `slider [min=0, max=100]` `dropdown`
+
+### Media
+`image "url"` `video "url"` `audio "url"` `icon "emoji"` `avatar "url"`
+
+### Feedback
+`alert "msg" [type=info|success|warning|error]` `badge "text" [color=X]` `progress "75"` `spinner` `tooltip [text=X]`
+
+### Navigation
+`nav` `navlink "text" [href=URL]` `tabs`/`tab "Label"` `breadcrumb` `menu`
+
+### Data
+`table` `list [type=ordered]` `listitem "text"` `stat "value" [label=Label]`
+
+### Containers
+`card` `modal [id=X]` `accordion`/`accordion_item "Title"` `hero "Title"` `header` `footer`
+
+## Rules File (woozie.rules)
+
+Configuration file. **NO COMMENTS ALLOWED.**
+
+```
+version: 2.0
+theme: light
+title: My App
+font: Inter
+color: #6366f1
+lang: en
+favicon: icon.png
+```
+
+| Key | Values | Default |
+|-----|--------|---------|
+| `version` | Any | `2.0` |
+| `theme` | `light`, `dark` | `light` |
+| `title` | Any string | `Woozie App` |
+| `font` | Google Font name | `Inter` |
+| `color` | Hex color | `#6366f1` |
+| `lang` | Language code | `en` |
+| `favicon` | Path or URL | (none) |
+
+## Style File (style.woozie)
+
+Override any component's CSS:
+
+```woozie
+// Comments ARE allowed in style.woozie
+button:
+    border-radius: 8px
+    font-size: 1rem
+
+card:
+    border: 2px solid #e2e8f0
+    padding: 3rem
+
+hero:
+    padding: 8rem 2rem
+    background: linear-gradient(135deg, #667eea 0%, #764ba2 100%)
+```
+
+Selector names match Woozie element names. Properties are standard CSS.
+
+## Plugins
+
+Create `plugins/pricing.woozie`:
+```woozie
+card:
+    subheading "Pro Plan"
+    text "$9/month"
+    list:
+        listitem "Unlimited projects"
+        listitem "Priority support"
+    button "Subscribe" [variant=solid]
+```
+
+Use it in `main.woozie`:
+```woozie
+app "My App":
+    pricing:
+```
+
+## CLI Commands
+
+```
+woozie init <name>    Create a new project
+woozie run            Start dev server with live reload
+woozie dev            Alias for run
+woozie build          Compile to static dist/ folder
+  --port <n>          Custom port (default: 3000)
+  --output <path>     Custom output path
+  --help              Show help
+```
+
+## Documentation
+
+- [Element Reference](docs/elements.md) — Every component with examples
+- [Installation Guide](docs/install.md) — How to install and set up
+- [Hosting Guide](docs/hosting.md) — How to deploy your Woozie app
+
+## VS Code Extension
+
+Install syntax highlighting from `editor/woozie-syntax/`:
+```bash
+cd editor/woozie-syntax
+# Install in VS Code via Extensions > Install from VSIX
+```
+
+Features: syntax highlighting, auto-indent, comment toggling, bracket matching.

package/README.md

@@ -0,0 +1,53 @@
+# Woozie 2.0 🚀
+
+The easiest web framework ever - now powered by Node.js.
+
+## Installation
+
+### From NPM
+```bash
+npm install -g woozie
+```
+
+### From URL (Simulated)
+```bash
+./scripts/install.sh
+```
+
+## Usage
+
+### Create a Project
+```bash
+woozie init my-app
+cd my-app
+```
+
+### Run Dev Server
+```bash
+woozie run
+```
+Starts server at `http://localhost:3000`.
+
+### Build for Production
+```bash
+woozie build
+```
+Creates `dist/index.html`.
+
+## New Features
+- **No Python**: Pure Node.js.
+- **Modern UI**: Glassmorphism, gradients, and sleek typography out of the box.
+- **TailwindCSS**: Use `tailwindcss:` tag to enable.
+- **Workers**: Use `worker "script.js"` to spawn Web Workers.
+- **URL Plugins**: Import plugins from URLs in `woozie.imports`.
+
+## Example `main.woozie`
+
+```woozie
+app "My Modern App":
+    tailwindcss:
+    column:
+        card:
+            text "Hello Woozie 2.0"
+            button "Click Me"
+```

package/bin/woozie.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+
+import arg from 'arg';
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+import { WoozieCompiler } from '../src/core/compiler.js';
+import { WoozieServer } from '../src/core/server.js';
+import { CometRegistry } from '../src/comet/registry.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const args = arg({
+    '--port': Number,
+    '--output': String,
+    '--help': Boolean
+});
+
+const command = args._[0];
+
+if (!command || args['--help']) {
+    console.log(`
+Woozie CLI v3.0 — The easiest web framework 🚀
+Usage: woozie <command> [options]
+
+Commands:
+  init <name>         Create a new project (with syntax highlighting)
+  run                 Start dev server (alias: dev)
+  build               Compile to static files
+  syntax              Install VS Code syntax highlighting
+
+  comet init <name>   Create a new CometUI package
+  comet add <path>    Install a local CometUI package
+  comet list          List installed CometUI packages
+  comet remove <name> Remove a CometUI package
+
+Options:
+  --port <n>          Port for dev server (default: 3000)
+  --output <f>        Output dir for build (default: dist/index.html)
+    `);
+    process.exit(0);
+}
+
+const cwd = process.cwd();
+
+async function main() {
+    if (command === 'init') {
+        const name = args._[1];
+        if (!name) { console.error("Please specify a project name."); process.exit(1); }
+
+        console.log(`✨ Creating Woozie project: ${name}...`);
+        const projectDir = path.join(cwd, name);
+        fs.mkdirSync(path.join(projectDir, 'plugins'), { recursive: true });
+        fs.mkdirSync(path.join(projectDir, 'pages'), { recursive: true });
+
+        fs.writeFileSync(path.join(projectDir, 'main.woozie'),
+`app "${name}":
+    nav:
+        navlink "Home" [page=index]
+        navlink "About" [page=about]
+        navlink "Contact" [page=contact]
+
+    hero "Welcome to ${name}":
+        text "Built with Woozie — the easiest web framework"
+        row:
+            button "Get Started" [variant=solid]
+            button "About Us" [variant=outline, page=about]
+
+    section:
+        heading "Features"
+        grid [cols=3]:
+            card:
+                icon "⚡"
+                subheading "Fast"
+                text "Compiles in milliseconds"
+            card:
+                icon "🎨"
+                subheading "Beautiful"
+                text "Stunning UI out of the box"
+            card:
+                icon "🔌"
+                subheading "Extensible"
+                text "CometUI plugin system for community libraries"
+
+    footer:
+        text "Built with Woozie 3.0"
+`);
+
+        fs.writeFileSync(path.join(projectDir, 'pages', 'about.woozie'),
+`app "${name} — About":
+    nav:
+        navlink "Home" [page=index]
+        navlink "About" [page=about]
+        navlink "Contact" [page=contact]
+
+    section:
+        heading "About"
+        text "This project was built with Woozie, the easiest web framework."
+
+    footer:
+        text "Built with Woozie 3.0"
+`);
+
+        fs.writeFileSync(path.join(projectDir, 'pages', 'contact.woozie'),
+`app "${name} — Contact":
+    nav:
+        navlink "Home" [page=index]
+        navlink "About" [page=about]
+        navlink "Contact" [page=contact]
+
+    section:
+        heading "Contact Us"
+        column:
+            input "Your name" [type=text]
+            input "Your email" [type=email]
+            textarea "Your message"
+            button "Send Message" [variant=solid]
+
+    footer:
+        text "Built with Woozie 3.0"
+`);
+
+        fs.writeFileSync(path.join(projectDir, 'woozie.rules'),
+`version: 3.0
+theme: light
+title: ${name}
+font: Inter
+`);
+
+        fs.writeFileSync(path.join(projectDir, 'style.woozie'),
+`// Custom styles for ${name}
+hero:
+    padding: 6rem 2rem
+
+card:
+    text-align: center
+`);
+
+        // Create .vscode workspace config with extension recommendation
+        fs.mkdirSync(path.join(projectDir, '.vscode'), { recursive: true });
+        fs.writeFileSync(path.join(projectDir, '.vscode', 'extensions.json'),
+JSON.stringify({
+    recommendations: ['woozlit.woozie-syntax']
+}, null, 4) + '\n');
+        fs.writeFileSync(path.join(projectDir, '.vscode', 'settings.json'),
+JSON.stringify({
+    'files.associations': { '*.woozie': 'woozie' },
+    'editor.tabSize': 4,
+    'editor.insertSpaces': true
+}, null, 4) + '\n');
+
+        // Auto-install syntax extension
+        installSyntax(true);
+
+        console.log(`\n✅ Project created! Next steps:\n`);
+        console.log(`   cd ${name}`);
+        console.log(`   woozie run\n`);
+
+    } else if (command === 'run' || command === 'dev') {
+        const port = args['--port'] || 3000;
+        const server = new WoozieServer(port);
+        await server.start(cwd);
+
+    } else if (command === 'build') {
+        const output = args['--output'] || 'dist/index.html';
+        const compiler = new WoozieCompiler();
+        try {
+            await compiler.loadPlugins(cwd);
+            await compiler.loadComet(cwd);
+            compiler.compile(cwd, output);
+            console.log(`📦 Built to ${path.dirname(output)}/`);
+        } catch (e) {
+            console.error("Build error:", e.message);
+            process.exit(1);
+        }
+
+    } else if (command === 'comet') {
+        const subCmd = args._[1];
+        const registry = new CometRegistry();
+
+        if (subCmd === 'init') {
+            const name = args._[2];
+            if (!name) { console.error("Usage: woozie comet init <name>"); process.exit(1); }
+            const pkgDir = registry.init(cwd, name);
+            console.log(`🌠 CometUI package created: ${pkgDir}`);
+            console.log(`  Edit components/ to add .woozie plugins`);
+
+        } else if (subCmd === 'add') {
+            const source = args._[2];
+            if (!source) { console.error("Usage: woozie comet add <path>"); process.exit(1); }
+            const sourcePath = path.resolve(cwd, source);
+            const name = registry.add(cwd, sourcePath);
+            console.log(`🌠 Installed CometUI package: ${name}`);
+
+        } else if (subCmd === 'list') {
+            const pkgs = registry.list(cwd);
+            if (pkgs.length === 0) { console.log('No CometUI packages installed.'); }
+            else {
+                console.log('🌠 Installed CometUI packages:\n');
+                for (const p of pkgs) {
+                    console.log(`  ${p.name}@${p.version || '?'} — ${p.description || ''}`);
+                }
+            }
+
+        } else if (subCmd === 'remove') {
+            const name = args._[2];
+            if (!name) { console.error("Usage: woozie comet remove <name>"); process.exit(1); }
+            registry.remove(cwd, name);
+            console.log(`🌠 Removed: ${name}`);
+
+        } else {
+            console.log('CometUI commands: init, add, list, remove');
+        }
+
+    } else if (command === 'syntax') {
+        installSyntax(false);
+
+    } else {
+        console.error("Unknown command:", command);
+        process.exit(1);
+    }
+}
+
+function installSyntax(silent) {
+    const extSrc = path.join(__dirname, '..', 'editor', 'woozie-syntax');
+    const home = process.env.USERPROFILE || process.env.HOME;
+    const extDest = path.join(home, '.vscode', 'extensions', 'woozlit.woozie-syntax-3.0.0');
+    try {
+        // Copy extension folder into VS Code extensions directory
+        _copyDirSync(extSrc, extDest);
+        if (!silent) console.log('✅ Woozie syntax highlighting installed in VS Code');
+        if (!silent) console.log('   Restart or reload VS Code to activate.');
+    } catch (e) {
+        if (!silent) {
+            console.log('⚠️  Could not auto-install syntax extension.');
+            console.log('   To install manually, copy this folder:');
+            console.log(`   ${extSrc}`);
+            console.log(`   → ${path.join(home, '.vscode', 'extensions', 'woozlit.woozie-syntax-3.0.0')}`);
+        }
+    }
+}
+
+function _copyDirSync(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const s = path.join(src, entry.name);
+        const d = path.join(dest, entry.name);
+        if (entry.isDirectory()) _copyDirSync(s, d);
+        else fs.copyFileSync(s, d);
+    }
+}
+
+main();