bertui 1.2.8 → 2.0.0

package/README.md

@@ -1,222 +1,71 @@
-# BertUI ⚡
+# bertui
 
-**Zero-config React framework powered by Bun. File-based routing, Server Islands, and a build system that gets out of your way.**
+Zero-config React framework powered by Bun. Minimal core, optional everything else.
 
-[![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)
-
----
-
-## Quick Start
+## Install
 
 ```bash
-bunx create-bertui my-app
-cd my-app
-bun run dev
-```
-
----
-
-## What's New in v1.2.2
-
-### Import Aliases (`importhow`)
-No more `../../../` chains. Define aliases in your config and import cleanly from anywhere.
-
-```javascript
-// bertui.config.js
-export default {
-  importhow: {
-    amani: '../components',
-    ui:    '../components/ui',
-  }
-}
-```
-
-```javascript
-// anywhere in your project
-import Button from 'amani/button';
-import Card from 'ui/card';
-```
-
-Aliases are resolved at compile time — zero runtime overhead.
-
-### Node Modules — Just Work
-Install a package, import it. That's it.
-
-```javascript
-import { format } from 'date-fns';
-import confetti from 'canvas-confetti';
-```
-
-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.
-
-### CLI — New Look
-The build and dev output is now compact and step-based instead of verbose line-by-line logs.
-
-```
-  ██████╗ ███████╗██████╗ ████████╗██╗   ██╗██╗
-  ██╔══██╗██╔════╝██╔══██╗╚══██╔══╝██║   ██║██║
-  ██████╔╝█████╗  ██████╔╝   ██║   ██║   ██║██║
-  ██╔══██╗██╔══╝  ██╔══██╗   ██║   ██║   ██║██║
-  ██████╔╝███████╗██║  ██║   ██║   ╚██████╔╝██║
-  ╚═════╝ ╚══════╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚═╝
-  by Pease Ernest  ·  BUILD
-
-  [ 1/10] ✓  Loading env
-  [ 2/10] ✓  Compiling           5 routes · 1 islands
-  [ 3/10] ⠸  Layouts             ...
-  ...
-  ✓ Done  0.54s
-  JS bundle    32.6 KB
-  Output       dist/
-```
-
-Debug logs are written silently to `.bertui/dev.log`.
-
-### 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.
-
----
-
-## Features
-
-### File-Based Routing
-
+bun add bertui
 ```
-src/pages/index.jsx          →  /
-src/pages/about.jsx          →  /about
-src/pages/blog/index.jsx     →  /blog
-src/pages/blog/[slug].jsx    →  /blog/:slug
-```
-
-### Server Islands
-
-Add one line to opt a page into static generation at build time.
-
-```jsx
-// src/pages/about.jsx
-export const render = "server";
-export const title = "About Us";
-
-export default function About() {
-  return (
-    <div>
-      <h1>About Us</h1>
-      <p>Pre-rendered as static HTML at build time.</p>
-    </div>
-  );
-}
-```
-
-- 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
 
-### TypeScript
+That's it. React + file-based routing + SSG + HMR + LightningCSS. No forms, no animations, no icons pulled in unless you ask for them.
 
-`.tsx` and `.ts` files work with no setup. Mix them freely with `.jsx`.
+## Optional packages
 
-```typescript
-// src/pages/blog/[slug].tsx
-import { useRouter } from 'bertui/router';
+Install only what you need:
 
-export default function BlogPost() {
-  const { params } = useRouter();
-  return <h1>Post: {params.slug}</h1>;
-}
+```bash
+bun add @bertui/elysia     # fullstack — Elysia server plugin
+bun add @bertui/forms      # forms (coming soon)
+bun add @bertui/animations # animations (coming soon)
+bun add @bertui/icons      # icons (coming soon)
 ```
 
-### SEO
+Then enable in `bertui.config.js`:
 
-`sitemap.xml` and `robots.txt` are generated automatically from your routes. Requires `baseUrl` in config.
-
-```javascript
+```js
 export default {
-  baseUrl: 'https://example.com',
-  robots: {
-    disallow: ['/admin'],
-    crawlDelay: 1,
-  }
+  siteName: 'My App',
+  elysia: true,      // requires bun add @bertui/elysia
+  forms: true,       // requires bun add @bertui/forms
 }
 ```
 
-### CSS
-
-Put your styles in `src/styles/`. They are combined and minified with LightningCSS into a single `bertui.min.css`.
-
----
-
-## Project Structure
-
-```
-my-app/
-├── src/
-│   ├── pages/          # File-based routing
-│   ├── components/     # Your components
-│   └── styles/         # Global CSS
-├── public/             # Static assets
-├── dist/               # Production output
-│   ├── sitemap.xml
-│   ├── robots.txt
-│   └── assets/
-└── bertui.config.js
-```
-
----
+If you enable a feature without installing its package, BertUI throws a clear error telling you exactly what to run.
 
-## Configuration
+## Quick start
 
-```javascript
-// bertui.config.js
-export default {
-  siteName: 'My Site',
-  baseUrl:  'https://example.com',
-
-  importhow: {
-    ui: '../components/ui',
-  },
-
-  robots: {
-    disallow:   ['/admin'],
-    crawlDelay: 1,
-  },
-
-  meta: {
-    title:       'My Site',
-    description: 'Built with BertUI',
-    themeColor:  '#000000',
-  },
-}
+```bash
+bunx create-bertui my-app
+cd my-app
+bun install
+bun run dev
 ```
 
----
-
-## Performance
-
-Benchmarks on an Intel i3-2348M, 7.6GB RAM.
-
-| 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   |
+## What's in the core
 
----
+| Package | What it does |
+|---|---|
+| `@bertui/core` | Types, config, utils, cache |
+| `@bertui/compiler` | JSX/TSX pipeline — dev + build unified |
+| `@bertui/router` | File-based React router, SSR-safe |
+| `@bertui/ssg` | Static/server islands, SSR renderer |
+| `@bertui/css` | LightningCSS — modules, SCSS, minify |
+| `@bertui/images` | Image copy + WASM optimization |
+| `@bertui/dev` | HMR, file watcher, import map |
+| `@bertui/cli` | The `bertui` binary |
 
-## Coming Soon
+## Imports
 
-- `bertui-elysia` — API routes, auth, database
-- `bertui-animate` — GPU-accelerated animations
+```ts
+// Core
+import { loadConfig, formatBytes } from 'bertui'
 
----
+// Router (client-side)
+import { Router, Link, useRouter } from 'bertui/router'
 
-## Credits
-
-- Runtime: [Bun](https://bun.sh)
-- CSS: [LightningCSS](https://lightningcss.dev)
-
----
+// Config types
+import type { BertuiConfig } from 'bertui/config'
+```
 
-Made by Pease Ernest
+Made by Pease Ernest

package/TYPES_PATCH.md

@@ -0,0 +1,17 @@
+// Add these fields to the BertuiConfig interface in packages/core/src/types/index.ts
+// Merge into the existing BertuiConfig — do not replace the whole file, just add the optional block
+
+// ─── Optional feature flags ───────────────────────────────────────────────────
+// These are OFF by default. Enabling them requires the matching package to be installed.
+//
+//   elysia:     true  →  requires bun add @bertui/elysia
+//   forms:      true  →  requires bun add @bertui/forms      (coming soon)
+//   animations: true  →  requires bun add @bertui/animations  (coming soon)
+//   icons:      true  →  requires bun add @bertui/icons        (coming soon)
+
+// Add to BertuiConfig:
+//
+//   elysia?:     boolean
+//   forms?:      boolean
+//   animations?: boolean
+//   icons?:      boolean

package/bin/bertui.js

@@ -1,8 +1,3 @@
 #!/usr/bin/env bun
-// bin/bertui.js
-
-// Import the CLI program from index
-import { program } from '../index.js';
-
-// Run it
-program();
+import { program } from '@bertui/cli'
+await program()

package/package.json

@@ -1,118 +1,52 @@
 {
   "name": "bertui",
-  "version": "1.2.8",
-  "description": "Lightning-fast React dev server powered by Bun - Now with Rust image optimization (WASM, no Rust required for users)",
+  "version": "2.0.0",
+  "description": "Zero-config React framework powered by Bun — minimal core, optional everything else",
   "type": "module",
-  "main": "./index.js",
-  "types": "./types/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "bin": {
     "bertui": "./bin/bertui.js"
   },
-"exports": {
-  ".": {
-    "types": "./types/index.d.ts",
-    "import": "./index.js",
-    "default": "./index.js"
+  "exports": {
+    ".": {
+      "import": "./src/index.ts"
+    },
+    "./router": {
+      "import": "./src/router.ts"
+    },
+    "./config": {
+      "import": "./src/config.ts"
+    }
   },
-  "./hmr": {
-    "import": "./src/client/hmr-runtime.js"
-  },
-  "./image-optimizer": {
-    "import": "./src/image-optimizer/index.js"
-  },
-  "./router": {
-    "types": "./types/router.d.ts",
-    "import": "./src/router/index.js"
-  },
-  "./config": {
-    "types": "./types/config.d.ts",
-    "import": "./src/config/index.js"
-  },
-  "./logger": {
-    "import": "./src/logger/logger.js"
-  },
-  "./styles": "./src/styles/bertui.css",
-  "./compiler": {
-    "import": "./src/client/compiler.js"
-  },
-  "./layouts": {
-    "import": "./src/layouts/index.js"
-  },
-  "./loading": {
-    "import": "./src/loading/index.js"
-  },
-  "./hydration": {
-    "import": "./src/hydration/index.js"
-  },
-  "./dev": {
-    "import": "./src/server/dev-server-utils.js"
-  },
-  "./build": {
-    "import": "./src/build.js"
-  }
-},
-  "files": [
-    "bin",
-    "src",
-    "dist",
-    "types",
-    "index.js",
-    "README.md",
-    "LICENSE"
-  ],
   "scripts": {
-    "dev": "bun bin/bertui.js dev",
-    "build": "bun bin/bertui.js build",
-    "serve": "bun bin/bertui.js serve",
-    "preview": "bun bin/bertui.js serve --port 5000",
-    "build:wasm": "cd src/image-optimizer-rust && wasm-pack build --target web --out-dir ../../dist/image-optimizer/wasm && bun run fix:wasm",
-    "fix:wasm": "node scripts/fix-wasm-exports.js",
-    "prepublishOnly": "echo 'Note: Ensure WASM is built via build:wasm before publishing'",
-    "test": "cd test-app && bun run dev"
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun --format esm",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "elysia": "^1.0.0",
-    "ernest-logger": "^2.0.0",
-    "lightningcss": "^1.30.2",
-    "react-refresh": "^0.14.0"
+    "@bertui/core":     "workspace:*",
+    "@bertui/compiler": "workspace:*",
+    "@bertui/router":   "workspace:*",
+    "@bertui/ssg":      "workspace:*",
+    "@bertui/css":      "workspace:*",
+    "@bertui/cli":      "workspace:*",
+    "@bertui/dev":      "workspace:*",
+    "@bertui/images":   "workspace:*"
   },
   "peerDependencies": {
-    "bun": ">=1.0.0",
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react":     ">=19.0.0",
+    "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
-    "oxipng": "^1.0.1",
-    "wasm-pack": "^0.12.1"
-  },
-  "optionalDependencies": {
-    "@bertui/image-optimizer-wasm": "0.1.0",
-    "oxipng": "^8.0.0",
-    "sass": "^1.69.5"
+    "typescript":       "^6.0.0",
+    "@types/react":     "^19.0.0",
+    "@types/react-dom": "^19.0.0"
   },
-  "keywords": [
-    "react",
-    "bun",
-    "elysia",
-    "hmr",
-    "fast-refresh",
-    "image-optimization",
-    "rust",
-    "wasm",
-    "server-islands",
-    "seo",
-    "sitemap",
-    "typescript"
-  ],
+  "keywords": ["react", "bun", "ssr", "ssg", "file-based-routing", "islands", "zero-config"],
   "author": "Pease Ernest",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/BunElysiaReact/BERTUI.git"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
+    "url": "https://github.com/BunElysiaReact/BERTUI"
   }
-}
+}

package/src/config.ts

@@ -0,0 +1,4 @@
+// packages/bertui/src/config.ts
+// Allows: import { loadConfig, defaultConfig } from 'bertui/config'
+export { loadConfig, defaultConfig } from '@bertui/core'
+export type { BertuiConfig, MetaConfig, AppShellConfig, RobotsConfig } from '@bertui/core'

package/src/index.ts

@@ -0,0 +1,32 @@
+// packages/bertui/src/index.ts
+// Main entry point for `bun add bertui`
+// Re-exports everything a user needs from the core packages.
+// Optional packages (@bertui/elysia, @bertui/forms etc) are NOT exported here —
+// users install and import them separately.
+
+// Core types + config + utils
+export * from '@bertui/core'
+
+// Compiler
+export { transform, compileFile, compileProject } from '@bertui/compiler'
+
+// SSG / server islands
+export {
+  getRenderMode,
+  validateServerIsland,
+  isServerIsland,
+  renderPageToHTML,
+  validateAllServerIslands,
+} from '@bertui/ssg'
+
+// CSS
+export { minifyCSS, minifyCSSSync, buildAllCSS, scopeCSSModule } from '@bertui/css'
+
+// Images
+export { copyImagesSync, getImageFiles, isImageFile, optimizeImage } from '@bertui/images'
+
+// Dev
+export { buildDevImportMap, setupFileWatcher } from '@bertui/dev'
+
+// Version
+export const VERSION = '2.0.0'

package/src/optional.ts

@@ -0,0 +1,49 @@
+import type { BertuiConfig } from '@bertui/core'
+
+export const OPTIONAL_FEATURES = [
+  { name: 'SSG / Static Site Generation', pkg: '@bertui/ssg', configKey: 'ssg' },
+  { name: 'Elysia Fullstack', pkg: '@bertui/elysia', configKey: 'elysia' },
+  { name: 'Animations', pkg: '@bertui/animations', configKey: 'animations' }, // Add this
+]
+
+export async function loadOptional<T = unknown>(pkg: string, configKey: string): Promise<T> {
+  try {
+    return await import(pkg) as T
+  } catch {
+    throw new Error(
+      `\n\n  [@bertui] config.${configKey} is enabled but ${pkg} is not installed.\n` +
+      `  Run:  bun add ${pkg}\n` +
+      `  Then restart the dev server.\n`
+    )
+  }
+}
+
+export async function validateOptionalFeatures(config: BertuiConfig): Promise<void> {
+  const missing: Array<{ name: string; pkg: string; configKey: string }> = []
+
+  for (const feature of OPTIONAL_FEATURES) {
+    if (!config[feature.configKey as keyof BertuiConfig]) continue
+    
+    try {
+      await import(feature.pkg)
+    } catch {
+      missing.push({ name: feature.name, pkg: feature.pkg, configKey: feature.configKey })
+    }
+  }
+
+  if (missing.length) {
+    const installCmd = missing.map(m => m.pkg).join(' ')
+    console.error(`
+╔══════════════════════════════════════════════════╗
+║  [@bertui] Missing optional packages            ║
+╚══════════════════════════════════════════════════╝
+
+${missing.map(m => `  • ${m.name} (config.${m.configKey} = true)\n    → bun add ${m.pkg}`).join('\n\n')}
+
+  Install them all at once:
+
+      bun add ${installCmd}
+`)
+    process.exit(1)
+  }
+}

package/src/router.ts

@@ -0,0 +1,3 @@
+// packages/bertui/src/router.ts
+// Allows: import { Router, Link, useRouter } from 'bertui/router'
+export * from '@bertui/router'

package/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist",
+    "paths": {
+      "@bertui/core":     ["../core/src/index.ts"],
+      "@bertui/compiler": ["../compiler/src/index.ts"],
+      "@bertui/router":   ["../router/src/index.ts"],
+      "@bertui/ssg":      ["../ssg/src/index.ts"],
+      "@bertui/css":      ["../css/src/index.ts"],
+      "@bertui/images":   ["../images/src/index.ts"],
+      "@bertui/dev":      ["../dev/src/index.ts"],
+      "@bertui/cli":      ["../cli/src/index.ts"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["dist", "node_modules"],
+  "references": [
+    { "path": "../core" },
+    { "path": "../compiler" },
+    { "path": "../router" },
+    { "path": "../ssg" },
+    { "path": "../css" },
+    { "path": "../images" },
+    { "path": "../dev" },
+    { "path": "../cli" }
+  ]
+}

package/LICENSE

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