bertui 1.2.1 → 1.2.3

package/README.md

@@ -1,267 +1,222 @@
-markdown
+# BertUI ⚡
 
-# BertUI v1.1.7 ⚡🏝️🦀
+**Zero-config React framework powered by Bun. File-based routing, Server Islands, and a build system that gets out of your way.**
 
-**The fastest React frontend framework. Now with Rust-powered image optimization.**
-
-Zero configuration. 494ms dev server. 265ms builds. Perfect SEO with Server Islands.
-**78% smaller images. 20x faster than Sharp. Zero Rust required.**
-
-[![Production Ready](https://img.shields.io/badge/status-production--ready-brightgreen)](https://github.com/BunElysiaReact/BERTUI) 
-[![Version](https://img.shields.io/badge/version-1.1.7-blue)](https://www.npmjs.com/package/bertui)
-[![Bun Powered](https://img.shields.io/badge/runtime-Bun-f472b6)](https://bun.sh) 
-[![Rust](https://img.shields.io/badge/optimizer-Rust-WASM-orange)](https://www.rust-lang.org)
+[![Version](https://img.shields.io/badge/version-1.2.2-blue)](https://www.npmjs.com/package/bertui)
+[![Bun Powered](https://img.shields.io/badge/runtime-Bun-f472b6)](https://bun.sh)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
+---
 
-# One command. Zero config. Instant speed. 78% smaller images.
-bunx create-bertui my-app && cd my-app && bun run dev
-
-🦀 New in v1.1.7: Rust Image Optimization
-
-BertUI now ships with a pre-compiled WASM image optimizer written in Rust.
-Before (v1.1.6) After (v1.1.7)  Gain
-❌ No optimization ✅ PNG: 78% smaller  3.6x smaller
-❌ Just copy ✅ JPEG: 75% smaller 4x smaller
-❌ Large images  ✅ WebP: 70% smaller 3.3x smaller
-❌ Slow builds ✅ 20x faster than Sharp 2,000% faster
+## Quick Start
 
-And the best part? Users don't need Rust installed. The optimizer is pre-compiled to WASM and ships with BertUI.
-js
-
-// This just works. No Rust installation. No configuration.
-import { optimizeImage } from 'bertui/image-optimizer';
+```bash
+bunx create-bertui my-app
+cd my-app
+bun run dev
+```
 
-const buffer = await Bun.file('image.png').arrayBuffer();
-const result = await optimizeImage(buffer, { format: 'png', quality: 80 });
-// ✅ 78% smaller image in result.data
+---
 
-Automatic fallback: If WASM isn't available (edge cases), BertUI silently falls back to copying. Your builds never break.
-🎯 What BertUI Is
+## What's New in v1.2.2
 
-A frontend framework that gives you everything React should have had from day one:
+### Import Aliases (`importhow`)
+No more `../../../` chains. Define aliases in your config and import cleanly from anywhere.
 
-    ⚡ Sub-500ms dev starts - Faster than Vite, Next.js, and everything else
+```javascript
+// bertui.config.js
+export default {
+  importhow: {
+    amani: '../components',
+    ui:    '../components/ui',
+  }
+}
+```
 
-    🏗️ Sub-300ms builds - Production builds in the time others compile one file
+```javascript
+// anywhere in your project
+import Button from 'amani/button';
+import Card from 'ui/card';
+```
 
-    🏝️ Server Islands - Optional SSG for perfect SEO (one line of code)
+Aliases are resolved at compile time — zero runtime overhead.
 
-    🦀 Rust image optimization - 78% smaller PNGs, pre-compiled WASM, zero Rust required
+### Node Modules — Just Work
+Install a package, import it. That's it.
 
-    📁 File-based routing - Just create files in pages/, that's it
+```javascript
+import { format } from 'date-fns';
+import confetti from 'canvas-confetti';
+```
 
-    🗺️ Auto SEO - Sitemap and robots.txt generated automatically
+In dev, packages are served from your local filesystem. In production, only the packages you actually import are bundled and tree-shaken into the output.
 
-    📘 TypeScript ready - Full type definitions, zero setup required
+### CLI — New Look
+The build and dev output is now compact and step-based instead of verbose line-by-line logs.
 
-    🎨 CSS built-in - Global styles with LightningCSS optimization
+```
+  ██████╗ ███████╗██████╗ ████████╗██╗   ██╗██╗
+  ██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██║   ██║██║
+  ██████╔╝█████╗  ██████╔╝   ██║   ██║   ██║██║
+  ██╔══██╗██╔══╝  ██╔══██╗   ██║   ██║   ██║██║
+  ██████╔╝███████╗██║  ██║   ██║   ╚██████╔╝██║
+  ╚═════╝ ╚══════╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝
+  by Pease Ernest  ·  BUILD
 
-    🔥 30ms HMR - Instant hot reloading that actually works
+  [ 1/10] ✓  Loading env
+  [ 2/10] ✓  Compiling           5 routes · 1 islands
+  [ 3/10] ⠸  Layouts             ...
+  ...
+  ✓ Done  0.54s
+  JS bundle    32.6 KB
+  Output       dist/
+```
 
-No webpack config. No babel setup. No framework fatigue. Just React, done right.
-⚡ Performance That Matters
+Debug logs are written silently to `.bertui/dev.log`.
 
-Real benchmarks on a 7-year-old laptop (Intel i3-2348M, 7.6GB RAM):
-Metric  BertUI 1.1.7  Vite  Next.js Your Gain
-Dev Server  494ms 713ms 2,100ms 1.4-4.3x faster ⚡
-Prod Build  265ms 4,700ms 8,400ms 18-32x faster ⚡
-Bundle Size 100KB 220KB 280KB 2.2-2.8x smaller ⚡
-HMR Speed 30ms  85ms  120ms 2.8-4x faster ⚡
-PNG Optimization  78% smaller 0%  0%  78% smaller 🦀
-JPEG Optimization 75% smaller 0%  0%  75% smaller 🦀
+### Dev Server — No More Restarts
+Run `bun add some-package` and the dev server picks it up automatically. The import map rebuilds and the browser reloads — no restart needed.
 
-If BertUI is this fast on old hardware, imagine what it does on yours. 🚀
-🏝️ Server Islands: Perfect SEO, Zero Complexity
+---
 
-The problem: Every React framework makes you choose:
+## Features
 
-    ✅ Vite: Fast dev, ❌ terrible SEO (client-only)
+### File-Based Routing
 
-    ✅ Next.js: Good SEO, ❌ slow builds + server required
+```
+src/pages/index.jsx          →  /
+src/pages/about.jsx          →  /about
+src/pages/blog/index.jsx     →  /blog
+src/pages/blog/[slug].jsx    →  /blog/:slug
+```
 
-    ✅ Gatsby: Perfect SEO, ❌ 45-second builds
+### Server Islands
 
-BertUI's solution: Server Islands (optional SSG)
-jsx
+Add one line to opt a page into static generation at build time.
 
+```jsx
 // src/pages/about.jsx
-
-// 🏝️ Add ONE line to enable static generation
 export const render = "server";
-
-// 🎯 Optional: Add SEO metadata
 export const title = "About Us";
-export const description = "Learn about our team";
 
-// ⚛️ Write normal React (no hooks, no event handlers)
 export default function About() {
   return (
     <div>
       <h1>About Us</h1>
-      <p>This page is pre-rendered as static HTML!</p>
+      <p>Pre-rendered as static HTML at build time.</p>
     </div>
   );
 }
+```
 
-At build time:
-
-  ✅ Generates static HTML for instant loading
-
-  ✅ Auto-adds to sitemap.xml
-
-  ✅ Perfect SEO without SSR complexity
-
-  ✅ Still builds in 265ms
-
-🦀 Image Optimization (Just Works)
-
-No configuration. No Rust installation. Just smaller images.
-bash
+- Static HTML embedded in the output for instant load and perfect SEO
+- Pages with hooks or event handlers are rejected at build time with a clear error
+- All other pages are client-only by default
 
-# BertUI automatically optimizes images in src/images/
-bun run build
+### TypeScript
 
-text
+`.tsx` and `.ts` files work with no setup. Mix them freely with `.jsx`.
 
-📦 Building with Rust image optimizer...
-  ✓ logo.png: 245KB → 54KB (78% saved)
-  ✓ hero.jpg: 1.2MB → 312KB (75% saved)
-  ✓ icon.webp: 89KB → 26KB (70% saved)
-✅ Optimized 12 images, saved 3.4MB
-
-Or use the API directly:
-js
+```typescript
+// src/pages/blog/[slug].tsx
+import { useRouter } from 'bertui/router';
 
-import { optimizeImage } from 'bertui/image-optimizer';
+export default function BlogPost() {
+  const { params } = useRouter();
+  return <h1>Post: {params.slug}</h1>;
+}
+```
 
-// Single image
-const result = await optimizeImage(buffer, {
-  format: 'png',
-  quality: 80  // 0-100, default 80
-});
+### SEO
 
-// Batch processing
-const results = await optimizeImagesBatch(images, 'webp');
+`sitemap.xml` and `robots.txt` are generated automatically from your routes. Requires `baseUrl` in config.
 
-📦 Installation
-bash
+```javascript
+export default {
+  baseUrl: 'https://example.com',
+  robots: {
+    disallow: ['/admin'],
+    crawlDelay: 1,
+  }
+}
+```
 
-# Create new app
-bunx create-bertui my-app
+### CSS
 
-# Start development
-cd my-app
-bun run dev
+Put your styles in `src/styles/`. They are combined and minified with LightningCSS into a single `bertui.min.css`.
 
-# Build for production (with image optimization)
-bun run build
+---
 
-30 seconds from zero to running. No configuration required.
-📁 Project Structure
-text
+## Project Structure
 
+```
 my-app/
 ├── src/
-│   ├── pages/
-│   │   ├── index.jsx          # Route: /
-│   │   ├── about.jsx          # Route: /about
-│   │   └── blog/[slug].jsx    # Route: /blog/:slug
-│   ├── components/             # Your React components
-│   ├── styles/
-│   │   └── global.css         # Automatically imported
-│   ├── images/                 # 🦀 Auto-optimized at build time
-│   │   ├── logo.png
-│   │   └── hero.jpg
-│   └── pages/                  # File-based routing
-├── public/                     # Static assets
-├── dist/                       # Production build
-│   ├── sitemap.xml            # Auto-generated
-│   ├── robots.txt             # Auto-generated
-│   └── images/                # 🦀 Optimized images
-└── package.json
-
-🛣️ File-Based Routing
-
-Just create files. BertUI handles the rest.
-text
-
-src/pages/index.jsx          →  /
-src/pages/about.jsx          →  /about
-src/pages/blog/index.jsx     →  /blog
-src/pages/blog/[slug].jsx    →  /blog/:slug
-
-Dynamic routes with TypeScript:
-typescript
-
-// src/pages/blog/[slug].tsx
-import { useRouter } from 'bertui/router';
-
-interface Params {
-  slug: string;
-}
-
-export default function BlogPost() {
-  const { params } = useRouter<Params>();
-  return <h1>Post: {params.slug}</h1>;
-}
-
-⚙️ Configuration (Optional)
-javascript
-
+│   ├── pages/          # File-based routing
+│   ├── components/     # Your components
+│   └── styles/         # Global CSS
+├── public/             # Static assets
+├── dist/               # Production output
+│   ├── sitemap.xml
+│   ├── robots.txt
+│   └── assets/
+└── bertui.config.js
+```
+
+---
+
+## Configuration
+
+```javascript
 // bertui.config.js
 export default {
-  siteName: "My Site",
-  baseUrl: "https://example.com", // Required for sitemap
-  
-  // Image optimization settings
-  imageOptimizer: {
-    quality: 80,      // JPEG/PNG quality (0-100)
-    webpQuality: 75,  // WebP quality (0-100)
-    stripMetadata: true // Remove EXIF data
+  siteName: 'My Site',
+  baseUrl:  'https://example.com',
+
+  importhow: {
+    ui: '../components/ui',
   },
-  
-  robots: {
-    disallow: ["/admin", "/api"],
-    crawlDelay: 1
-  }
-};
 
-📊 Comparison
-Feature BertUI 1.1.7  Next.js Vite  Remix
-Dev Server  494ms 2.1s  713ms 1.8s
-Prod Build  265ms 8.4s  4.7s  6.2s
-Bundle Size 100KB 280KB 220KB 250KB
-Image Optimization  ✅ 78% smaller ❌ No  ❌ No  ❌ No
-Server Islands  ✅ Built-in  ❌ No  ❌ No  ❌ No
-Auto SEO  ✅ Yes ⚠️ Manual ❌ No  ⚠️ Manual
-TypeScript  ✅ No setup  ✅ Config needed ✅ Config needed ✅ Config needed
-Rust Required ❌ NO  N/A N/A N/A
-🚀 Coming Soon
+  robots: {
+    disallow:   ['/admin'],
+    crawlDelay: 1,
+  },
 
-Future packages (in development):
+  meta: {
+    title:       'My Site',
+    description: 'Built with BertUI',
+    themeColor:  '#000000',
+  },
+}
+```
 
-  🔄 bertui-elysia - Full-stack addon (API routes, auth, database)
+---
 
-  🎨 bertui-animation - GPU-accelerated animations (Zig)
+## Performance
 
-  📊 bertui-charts - High-performance charts (Rust)
+Benchmarks on an Intel i3-2348M, 7.6GB RAM.
 
-🙏 Credits
+| Metric       | BertUI  | Vite    | Next.js |
+|--------------|---------|---------|---------|
+| Dev start    | 494ms   | 713ms   | 2,100ms |
+| Prod build   | 265ms   | 4,700ms | 8,400ms |
+| Bundle size  | ~32KB   | 220KB   | 280KB   |
+| HMR          | 30ms    | 85ms    | 120ms   |
 
-  Runtime: Bun - The fastest JavaScript runtime
+---
 
-  Server: Elysia - Fast and elegant web framework
+## Coming Soon
 
-    CSS: LightningCSS - Lightning-fast CSS processing
+- `bertui-elysia` — API routes, auth, database
+- `bertui-animate` — GPU-accelerated animations
 
-    Image Optimization: oxipng, mozjpeg, webp - Rust libraries compiled to WASM
+---
 
-<div align="center">
+## Credits
 
-Made with ⚡🦀🏝️ by the BertUI team
+- Runtime: [Bun](https://bun.sh)
+- CSS: [LightningCSS](https://lightningcss.dev)
 
-v1.1.7 - Rust image optimization, zero Rust required
+---
 
-Website • GitHub • npm
-</div> ```
+Made by Pease Ernest

package/index.js

@@ -1,4 +1,4 @@
-// bertui/index.js - v1.2.0 with all features
+// bertui/index.js - v1.3.0
 
 // Compiler
 export { compileProject, compileFile } from './src/client/compiler.js';
@@ -33,7 +33,7 @@ export { default as logger } from './src/logger/logger.js';
 // CLI
 export { program } from './src/cli.js';
 
-// ✅ NEW: Middleware system
+// ✅ Middleware system
 export {
   MiddlewareManager,
   loadMiddleware,
@@ -41,7 +41,7 @@ export {
   MiddlewareContext,
 } from './src/middleware/index.js';
 
-// ✅ NEW: Layout system
+// ✅ Layout system
 export {
   discoverLayouts,
   compileLayouts,
@@ -50,7 +50,7 @@ export {
   injectLayoutsIntoRouter,
 } from './src/layouts/index.js';
 
-// ✅ NEW: Loading states
+// ✅ Loading states
 export {
   discoverLoadingComponents,
   compileLoadingComponents,
@@ -59,7 +59,7 @@ export {
   DEFAULT_LOADING_HTML,
 } from './src/loading/index.js';
 
-// ✅ NEW: Partial hydration
+// ✅ Partial hydration
 export {
   needsHydration,
   getInteractiveFeatures,
@@ -68,10 +68,10 @@ export {
   logHydrationReport,
 } from './src/hydration/index.js';
 
-// ✅ NEW: Bundle analyzer
+// ✅ Bundle analyzer
 export { analyzeBuild } from './src/analyzer/index.js';
 
-// ✅ NEW: CLI scaffolder
+// ✅ CLI scaffolder
 export { scaffold, parseCreateArgs } from './src/scaffolder/index.js';
 
 // Server
@@ -91,5 +91,13 @@ export {
   validateServerIsland,
 } from './src/server-islands/index.js';
 
+// ✅ NEW: importhow — alias/import resolution system
+// Bunny and external tools can use these to apply the same alias logic
+export {
+  buildAliasMap,
+  rewriteAliasImports,
+  getAliasDirs,
+} from './src/utils/importhow.js';
+
 // Version
-export const version = '1.2.0';
+export const version = '1.2.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bertui",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Lightning-fast React dev server powered by Bun - Now with Rust image optimization (WASM, no Rust required for users)",
   "type": "module",
   "main": "./index.js",