tw-framework 0.3.4__tar.gz → 0.3.6__tar.gz

tw_framework-0.3.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TW
+
+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.

tw_framework-0.3.6/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: tw-framework
+Version: 0.3.6
+Summary: TW framework CLI with create, dev, build, and deploy commands
+Author: TW Framework
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="./tw-logo.svg" alt="TW logo" width="100" height="100">
+
+# TW Framework
+
+**A custom language + framework for building websites — write `.tw` / `.tss`, ship a full site.**
+
+[![PyPI version](https://img.shields.io/pypi/v/tw-framework.svg?color=22c55e)](https://pypi.org/project/tw-framework/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/tw-framework.svg?color=3b82f6)](https://pypi.org/project/tw-framework/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/ffakraj-ui/twlang?style=social)](https://github.com/ffakraj-ui/twlang/stargazers)
+
+[Getting Started](#getting-started) •
+[CLI Commands](#cli-commands) •
+[Features](#features) •
+[Deploying](#deploying) •
+[Contributing](#contributing)
+
+</div>
+
+---
+
+## What is TW?
+
+TW is both a **language** and a **framework**, in one package — comparable to TypeScript + Next.js combined:
+
+- **Language** — `.tw` files (markup + logic) and `.tss` files (styles) compile down to plain HTML, CSS, and JS. TW has its own lexer, parser, and compiler pipeline.
+- **Framework** — file-based routing, API routes, middleware, authentication helpers, a dev server with live reload, and one-command deploys to Vercel, Netlify, and Cloudflare Pages.
+
+```tw
+page {
+    title "Home"
+    layout "main"
+    render static
+}
+
+BODY {
+    h1 "Hello from TW"
+    p "Write .tw and .tss files. Run tw dev. Ship fast."
+}
+```
+
+## Getting Started
+
+```bash
+pip install tw-framework
+
+tw create my-site
+cd my-site
+tw dev
+```
+
+Open `http://127.0.0.1:3000` — you now have a live-reloading dev server.
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `tw create <name>` | Scaffold a new TW project |
+| `tw dev` | Start the dev server with live reload |
+| `tw build` | Generate a production build |
+| `tw preview` | Preview the production build locally |
+| `tw doctor` | Run project health checks |
+| `tw deploy` | Build and deploy to a hosting provider |
+| `tw check <file>` | Print diagnostics for a `.tw` file |
+
+## Features
+
+- 📄 **File-based routing** — pages and dynamic routes (`[slug].tw`) from your folder structure
+- ⚡ **Reactive bindings** — `on:click`, `bind:value` for interactivity without writing raw JS
+- 🔌 **API routes** — `.twm` server functions for GET/POST/etc., colocated with your pages
+- 🛡️ **Middleware** — auth, rate limiting, origin checks, custom headers — all declarative
+- 🎨 **`.tss` stylesheets** — CSS with a friendlier syntax, animations, and variables
+- 🔍 **Built-in search** — automatic search index generation, no extra setup
+- 🚀 **Zero-config deploys** — Vercel, Netlify, and Cloudflare Pages adapters included
+
+## Deploying
+
+**Vercel** — connect your GitHub repo, TW's `vercel.json` handles the rest.
+**GitHub Pages** — enable Pages (Source → GitHub Actions) and push; the included workflow builds and deploys automatically.
+
+See [Deploying](#deploying) in the docs for provider-specific notes.
+
+## Contributing
+
+Issues and pull requests are welcome. If you find a bug, please open an issue with a minimal reproduction.
+
+## License
+
+[MIT](./LICENSE)

tw_framework-0.3.6/README.md

@@ -0,0 +1,91 @@
+<div align="center">
+
+<img src="./tw-logo.svg" alt="TW logo" width="100" height="100">
+
+# TW Framework
+
+**A custom language + framework for building websites — write `.tw` / `.tss`, ship a full site.**
+
+[![PyPI version](https://img.shields.io/pypi/v/tw-framework.svg?color=22c55e)](https://pypi.org/project/tw-framework/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/tw-framework.svg?color=3b82f6)](https://pypi.org/project/tw-framework/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/ffakraj-ui/twlang?style=social)](https://github.com/ffakraj-ui/twlang/stargazers)
+
+[Getting Started](#getting-started) •
+[CLI Commands](#cli-commands) •
+[Features](#features) •
+[Deploying](#deploying) •
+[Contributing](#contributing)
+
+</div>
+
+---
+
+## What is TW?
+
+TW is both a **language** and a **framework**, in one package — comparable to TypeScript + Next.js combined:
+
+- **Language** — `.tw` files (markup + logic) and `.tss` files (styles) compile down to plain HTML, CSS, and JS. TW has its own lexer, parser, and compiler pipeline.
+- **Framework** — file-based routing, API routes, middleware, authentication helpers, a dev server with live reload, and one-command deploys to Vercel, Netlify, and Cloudflare Pages.
+
+```tw
+page {
+    title "Home"
+    layout "main"
+    render static
+}
+
+BODY {
+    h1 "Hello from TW"
+    p "Write .tw and .tss files. Run tw dev. Ship fast."
+}
+```
+
+## Getting Started
+
+```bash
+pip install tw-framework
+
+tw create my-site
+cd my-site
+tw dev
+```
+
+Open `http://127.0.0.1:3000` — you now have a live-reloading dev server.
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `tw create <name>` | Scaffold a new TW project |
+| `tw dev` | Start the dev server with live reload |
+| `tw build` | Generate a production build |
+| `tw preview` | Preview the production build locally |
+| `tw doctor` | Run project health checks |
+| `tw deploy` | Build and deploy to a hosting provider |
+| `tw check <file>` | Print diagnostics for a `.tw` file |
+
+## Features
+
+- 📄 **File-based routing** — pages and dynamic routes (`[slug].tw`) from your folder structure
+- ⚡ **Reactive bindings** — `on:click`, `bind:value` for interactivity without writing raw JS
+- 🔌 **API routes** — `.twm` server functions for GET/POST/etc., colocated with your pages
+- 🛡️ **Middleware** — auth, rate limiting, origin checks, custom headers — all declarative
+- 🎨 **`.tss` stylesheets** — CSS with a friendlier syntax, animations, and variables
+- 🔍 **Built-in search** — automatic search index generation, no extra setup
+- 🚀 **Zero-config deploys** — Vercel, Netlify, and Cloudflare Pages adapters included
+
+## Deploying
+
+**Vercel** — connect your GitHub repo, TW's `vercel.json` handles the rest.
+**GitHub Pages** — enable Pages (Source → GitHub Actions) and push; the included workflow builds and deploys automatically.
+
+See [Deploying](#deploying) in the docs for provider-specific notes.
+
+## Contributing
+
+Issues and pull requests are welcome. If you find a bug, please open an issue with a minimal reproduction.
+
+## License
+
+[MIT](./LICENSE)

{tw_framework-0.3.4 → tw_framework-0.3.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tw-framework"
-version = "0.3.4"
+version = "0.3.6"
 description = "TW framework CLI with create, dev, build, and deploy commands"
 readme = "README.md"
 requires-python = ">=3.9"

{tw_framework-0.3.4 → tw_framework-0.3.6}/tw_framework/framework.py

@@ -338,33 +338,51 @@ def inject_dev_client(html_text: str) -> str:
 
 
 def render_error_html(title: str, message: str, status_code: int = 500) -> bytes:
+    if status_code == 404:
+        doc = f"""<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title>{html.escape(title)}</title>
+  <style>
+    body {{ margin: 0; height: 100vh; display: flex; align-items: center; justify-content: center; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background: #fff; color: #000; }}
+    .wrap {{ text-align: center; padding: 0 24px; }}
+    h1 {{ display: inline-block; margin: 0 20px 0 0; padding-right: 20px; font-size: 24px; font-weight: 500; vertical-align: top; border-right: 1px solid rgba(0,0,0,0.3); }}
+    .msg {{ display: inline-block; text-align: left; line-height: 49px; height: 49px; }}
+    h2 {{ font-size: 14px; font-weight: 400; line-height: 49px; margin: 0; }}
+  </style>
+</head>
+<body>
+  <div class="wrap">
+    <h1>{status_code}</h1>
+    <div class="msg"><h2>{html.escape(message)}</h2></div>
+  </div>
+</body>
+</html>"""
+        return doc.encode("utf-8")
+
+    if 400 <= status_code < 500:
+        accent = "#b45309"
+    else:
+        accent = "#b91c1c"
     doc = f"""<!DOCTYPE html>
 <html>
 <head>
   <meta charset="UTF-8">
   <title>{html.escape(title)}</title>
   <style>
-    body {{ margin: 0; font-family: Inter, system-ui, sans-serif; background: #0b1020; color: #f9fafb; }}
-    .overlay {{ min-height: 100vh; padding: 32px; background:
-      radial-gradient(circle at top left, rgba(220, 38, 38, 0.25), transparent 35%),
-      linear-gradient(180deg, #130d14 0%, #0b1020 100%);
-    }}
-    .card {{ max-width: 1100px; margin: 0 auto; border: 1px solid rgba(248,113,113,0.35); background: rgba(17,24,39,0.88); border-radius: 18px; box-shadow: 0 30px 80px rgba(0,0,0,0.45); overflow: hidden; }}
-    .header {{ padding: 18px 22px; border-bottom: 1px solid rgba(248,113,113,0.18); background: rgba(127,29,29,0.22); }}
-    .status {{ color: #fca5a5; font-size: 13px; letter-spacing: 0.08em; text-transform: uppercase; margin-bottom: 8px; }}
-    h1 {{ margin: 0; font-size: 28px; }}
-    pre {{ margin: 0; white-space: pre-wrap; background: #020617; padding: 22px; overflow: auto; line-height: 1.55; }}
+    body {{ margin: 0; min-height: 100vh; display: flex; align-items: center; justify-content: center; font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; background: #fafafa; color: #111; padding: 24px; box-sizing: border-box; }}
+    .card {{ max-width: 720px; width: 100%; }}
+    .status {{ color: {accent}; font-size: 13px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; margin-bottom: 10px; }}
+    h1 {{ margin: 0 0 16px; font-size: 24px; font-weight: 600; }}
+    pre {{ margin: 0; white-space: pre-wrap; background: #111; color: #f5f5f5; padding: 20px; border-radius: 8px; overflow: auto; line-height: 1.55; font-size: 13px; }}
   </style>
 </head>
 <body>
-  <div class="overlay">
-    <div class="card">
-      <div class="header">
-        <div class="status">TW Compile Error · HTTP {status_code}</div>
-        <h1>{html.escape(title)}</h1>
-      </div>
-      <pre>{html.escape(message)}</pre>
-    </div>
+  <div class="card">
+    <div class="status">HTTP {status_code}</div>
+    <h1>{html.escape(title)}</h1>
+    <pre>{html.escape(message)}</pre>
   </div>
 </body>
 </html>"""

tw_framework-0.3.6/tw_framework.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: tw-framework
+Version: 0.3.6
+Summary: TW framework CLI with create, dev, build, and deploy commands
+Author: TW Framework
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="./tw-logo.svg" alt="TW logo" width="100" height="100">
+
+# TW Framework
+
+**A custom language + framework for building websites — write `.tw` / `.tss`, ship a full site.**
+
+[![PyPI version](https://img.shields.io/pypi/v/tw-framework.svg?color=22c55e)](https://pypi.org/project/tw-framework/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/tw-framework.svg?color=3b82f6)](https://pypi.org/project/tw-framework/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/ffakraj-ui/twlang?style=social)](https://github.com/ffakraj-ui/twlang/stargazers)
+
+[Getting Started](#getting-started) •
+[CLI Commands](#cli-commands) •
+[Features](#features) •
+[Deploying](#deploying) •
+[Contributing](#contributing)
+
+</div>
+
+---
+
+## What is TW?
+
+TW is both a **language** and a **framework**, in one package — comparable to TypeScript + Next.js combined:
+
+- **Language** — `.tw` files (markup + logic) and `.tss` files (styles) compile down to plain HTML, CSS, and JS. TW has its own lexer, parser, and compiler pipeline.
+- **Framework** — file-based routing, API routes, middleware, authentication helpers, a dev server with live reload, and one-command deploys to Vercel, Netlify, and Cloudflare Pages.
+
+```tw
+page {
+    title "Home"
+    layout "main"
+    render static
+}
+
+BODY {
+    h1 "Hello from TW"
+    p "Write .tw and .tss files. Run tw dev. Ship fast."
+}
+```
+
+## Getting Started
+
+```bash
+pip install tw-framework
+
+tw create my-site
+cd my-site
+tw dev
+```
+
+Open `http://127.0.0.1:3000` — you now have a live-reloading dev server.
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `tw create <name>` | Scaffold a new TW project |
+| `tw dev` | Start the dev server with live reload |
+| `tw build` | Generate a production build |
+| `tw preview` | Preview the production build locally |
+| `tw doctor` | Run project health checks |
+| `tw deploy` | Build and deploy to a hosting provider |
+| `tw check <file>` | Print diagnostics for a `.tw` file |
+
+## Features
+
+- 📄 **File-based routing** — pages and dynamic routes (`[slug].tw`) from your folder structure
+- ⚡ **Reactive bindings** — `on:click`, `bind:value` for interactivity without writing raw JS
+- 🔌 **API routes** — `.twm` server functions for GET/POST/etc., colocated with your pages
+- 🛡️ **Middleware** — auth, rate limiting, origin checks, custom headers — all declarative
+- 🎨 **`.tss` stylesheets** — CSS with a friendlier syntax, animations, and variables
+- 🔍 **Built-in search** — automatic search index generation, no extra setup
+- 🚀 **Zero-config deploys** — Vercel, Netlify, and Cloudflare Pages adapters included
+
+## Deploying
+
+**Vercel** — connect your GitHub repo, TW's `vercel.json` handles the rest.
+**GitHub Pages** — enable Pages (Source → GitHub Actions) and push; the included workflow builds and deploys automatically.
+
+See [Deploying](#deploying) in the docs for provider-specific notes.
+
+## Contributing
+
+Issues and pull requests are welcome. If you find a bug, please open an issue with a minimal reproduction.
+
+## License
+
+[MIT](./LICENSE)

{tw_framework-0.3.4 → tw_framework-0.3.6}/tw_framework.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 tests/test_deployment.py

tw_framework-0.3.4/PKG-INFO

@@ -1,101 +0,0 @@
-Metadata-Version: 2.4
-Name: tw-framework
-Version: 0.3.4
-Summary: TW framework CLI with create, dev, build, and deploy commands
-Author: TW Framework
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Provides-Extra: dev
-Requires-Dist: pytest>=7; extra == "dev"
-
-# TW Framework
-
-TW is a custom language + framework for building websites with a Next.js‑like developer experience.
-
-## Zero‑Config Deployment
-
-1. Create a GitHub repository with your TW project (containing `tw.config`, `pages/`, `components/`, `public/`).
-2. Connect the repository to Vercel or Netlify.
-3. The platform automatically detects `tw.config` and runs `tw build`.
-4. Your site goes live – no terminal commands required.
-
-## Quick Start
-
-```bash
-# Create a new project
-tw init my-site
-cd my-site
-
-# Development server
-tw dev
-
-# Production build
-tw build
-
-# Preview the build
-tw preview
-```
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `tw init [name]` | Create a new TW project in the current directory |
-| `tw dev` | Start the development server with live reload |
-| `tw build` | Generate a production build |
-| `tw preview` | Preview the built output |
-| `tw export` | Generate a static export |
-| `tw deploy` | Build and deploy to a hosting provider |
-| `tw doctor` | Run project health checks and deployment compatibility |
-| `tw ast file.tw` | Print the AST JSON for a TW source file |
-| `tw ir file.tw` | Print the IR JSON for a TW source file |
-| `tw run file.tw` | Interpret a TW file and output HTML |
-| `tw check file.tw` | Print diagnostics for a TW file |
-| `tw tokens file.tw` | Print the token stream JSON for a TW source file |
-| `tw clean` | Clean dist and hidden cache folders |
-| `tw info` | Show a project summary |
-| `tw login` | Save deploy provider configuration |
-
-## Deployment Metadata
-
-After a build, the file `dist/tw.deploy.json` is automatically generated. It contains:
-
-```json
-{
-  "framework": "tw",
-  "version": "1.0.0",
-  "build": "tw build",
-  "output": "dist",
-  "runtime": "ssr"
-}
-```
-
-Deployment platforms can read this file to detect the framework and configure the build.
-
-## Adapters
-
-TW Framework includes built‑in adapters for Vercel and Netlify. They provide:
-
-- Framework detection (`detect()` function)
-- Automatic generation of `vercel.json` / `netlify.toml` when missing
-- Build command, output directory, install command, and SSR handling
-
-## Documentation
-
-- [Getting Started](docs/getting-started.md)
-- [Deployment to Vercel](docs/deployment/vercel.md)
-- [Deployment to Netlify](docs/deployment/netlify.md)
-
-## Testing
-
-```bash
-python3 -m unittest discover -s tests -q
-python3 run_tests.py
-```
-
-## Debug Flags
-
-- `TW_WARN_LITERAL_PARSE=1` – warn when literal parsing falls back to string
-- `TW_STRICT_EVAL=1` – re‑raise runtime expression errors instead of warning
-
-These flags are mainly useful while debugging parser/runtime edge cases or tightening CI checks around expression handling.

tw_framework-0.3.4/README.md

@@ -1,91 +0,0 @@
-# TW Framework
-
-TW is a custom language + framework for building websites with a Next.js‑like developer experience.
-
-## Zero‑Config Deployment
-
-1. Create a GitHub repository with your TW project (containing `tw.config`, `pages/`, `components/`, `public/`).
-2. Connect the repository to Vercel or Netlify.
-3. The platform automatically detects `tw.config` and runs `tw build`.
-4. Your site goes live – no terminal commands required.
-
-## Quick Start
-
-```bash
-# Create a new project
-tw init my-site
-cd my-site
-
-# Development server
-tw dev
-
-# Production build
-tw build
-
-# Preview the build
-tw preview
-```
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `tw init [name]` | Create a new TW project in the current directory |
-| `tw dev` | Start the development server with live reload |
-| `tw build` | Generate a production build |
-| `tw preview` | Preview the built output |
-| `tw export` | Generate a static export |
-| `tw deploy` | Build and deploy to a hosting provider |
-| `tw doctor` | Run project health checks and deployment compatibility |
-| `tw ast file.tw` | Print the AST JSON for a TW source file |
-| `tw ir file.tw` | Print the IR JSON for a TW source file |
-| `tw run file.tw` | Interpret a TW file and output HTML |
-| `tw check file.tw` | Print diagnostics for a TW file |
-| `tw tokens file.tw` | Print the token stream JSON for a TW source file |
-| `tw clean` | Clean dist and hidden cache folders |
-| `tw info` | Show a project summary |
-| `tw login` | Save deploy provider configuration |
-
-## Deployment Metadata
-
-After a build, the file `dist/tw.deploy.json` is automatically generated. It contains:
-
-```json
-{
-  "framework": "tw",
-  "version": "1.0.0",
-  "build": "tw build",
-  "output": "dist",
-  "runtime": "ssr"
-}
-```
-
-Deployment platforms can read this file to detect the framework and configure the build.
-
-## Adapters
-
-TW Framework includes built‑in adapters for Vercel and Netlify. They provide:
-
-- Framework detection (`detect()` function)
-- Automatic generation of `vercel.json` / `netlify.toml` when missing
-- Build command, output directory, install command, and SSR handling
-
-## Documentation
-
-- [Getting Started](docs/getting-started.md)
-- [Deployment to Vercel](docs/deployment/vercel.md)
-- [Deployment to Netlify](docs/deployment/netlify.md)
-
-## Testing
-
-```bash
-python3 -m unittest discover -s tests -q
-python3 run_tests.py
-```
-
-## Debug Flags
-
-- `TW_WARN_LITERAL_PARSE=1` – warn when literal parsing falls back to string
-- `TW_STRICT_EVAL=1` – re‑raise runtime expression errors instead of warning
-
-These flags are mainly useful while debugging parser/runtime edge cases or tightening CI checks around expression handling.

tw_framework-0.3.4/tw_framework.egg-info/PKG-INFO

@@ -1,101 +0,0 @@
-Metadata-Version: 2.4
-Name: tw-framework
-Version: 0.3.4
-Summary: TW framework CLI with create, dev, build, and deploy commands
-Author: TW Framework
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-Provides-Extra: dev
-Requires-Dist: pytest>=7; extra == "dev"
-
-# TW Framework
-
-TW is a custom language + framework for building websites with a Next.js‑like developer experience.
-
-## Zero‑Config Deployment
-
-1. Create a GitHub repository with your TW project (containing `tw.config`, `pages/`, `components/`, `public/`).
-2. Connect the repository to Vercel or Netlify.
-3. The platform automatically detects `tw.config` and runs `tw build`.
-4. Your site goes live – no terminal commands required.
-
-## Quick Start
-
-```bash
-# Create a new project
-tw init my-site
-cd my-site
-
-# Development server
-tw dev
-
-# Production build
-tw build
-
-# Preview the build
-tw preview
-```
-
-## CLI Commands
-
-| Command | Description |
-|---------|-------------|
-| `tw init [name]` | Create a new TW project in the current directory |
-| `tw dev` | Start the development server with live reload |
-| `tw build` | Generate a production build |
-| `tw preview` | Preview the built output |
-| `tw export` | Generate a static export |
-| `tw deploy` | Build and deploy to a hosting provider |
-| `tw doctor` | Run project health checks and deployment compatibility |
-| `tw ast file.tw` | Print the AST JSON for a TW source file |
-| `tw ir file.tw` | Print the IR JSON for a TW source file |
-| `tw run file.tw` | Interpret a TW file and output HTML |
-| `tw check file.tw` | Print diagnostics for a TW file |
-| `tw tokens file.tw` | Print the token stream JSON for a TW source file |
-| `tw clean` | Clean dist and hidden cache folders |
-| `tw info` | Show a project summary |
-| `tw login` | Save deploy provider configuration |
-
-## Deployment Metadata
-
-After a build, the file `dist/tw.deploy.json` is automatically generated. It contains:
-
-```json
-{
-  "framework": "tw",
-  "version": "1.0.0",
-  "build": "tw build",
-  "output": "dist",
-  "runtime": "ssr"
-}
-```
-
-Deployment platforms can read this file to detect the framework and configure the build.
-
-## Adapters
-
-TW Framework includes built‑in adapters for Vercel and Netlify. They provide:
-
-- Framework detection (`detect()` function)
-- Automatic generation of `vercel.json` / `netlify.toml` when missing
-- Build command, output directory, install command, and SSR handling
-
-## Documentation
-
-- [Getting Started](docs/getting-started.md)
-- [Deployment to Vercel](docs/deployment/vercel.md)
-- [Deployment to Netlify](docs/deployment/netlify.md)
-
-## Testing
-
-```bash
-python3 -m unittest discover -s tests -q
-python3 run_tests.py
-```
-
-## Debug Flags
-
-- `TW_WARN_LITERAL_PARSE=1` – warn when literal parsing falls back to string
-- `TW_STRICT_EVAL=1` – re‑raise runtime expression errors instead of warning
-
-These flags are mainly useful while debugging parser/runtime edge cases or tightening CI checks around expression handling.