baraqex 1.0.50 → 1.0.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baraqex",
-  "version": "1.0.50",
+  "version": "1.0.51",
   "description": "A powerful server-side framework built on Frontend Hamroun",
   "type": "module",
   "main": "./dist/index.js",

package/templates/basic-app/.eslintignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+coverage
+*.config.js
+*.config.ts

package/templates/basic-app/.eslintrc.json

@@ -0,0 +1,25 @@
+{
+  "root": true,
+  "env": {
+    "browser": true,
+    "es2020": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "ignorePatterns": ["dist", ".eslintrc.json"],
+  "parser": "@typescript-eslint/parser",
+  "plugins": [
+    "@typescript-eslint",
+    "react-refresh"
+  ],
+  "rules": {
+    "react-refresh/only-export-components": [
+      "warn",
+      { "allowConstantExport": true }
+    ],
+    "@typescript-eslint/no-explicit-any": "off",
+    "@typescript-eslint/ban-ts-comment": "off"
+  }
+}

package/templates/basic-app/README.md

@@ -0,0 +1,166 @@
+# Baraqex Basic App Template
+
+A comprehensive demonstration of the Baraqex framework featuring all major capabilities and beautiful Tailwind CSS styling.
+
+## 🚀 What's Included
+
+This template showcases:
+
+- **State Management**: useState, useEffect, useMemo, useRef hooks
+- **Error Boundaries**: useErrorBoundary for graceful error handling  
+- **Context API**: createContext and useContext for state sharing
+- **Interactive Components**: Counter, Todo List, Error Testing
+- **Responsive Design**: Tailwind CSS with dark/light mode
+- **Performance Optimizations**: Memoization and efficient re-rendering
+
+## 🎯 Features Demo
+
+### Counter Component
+- State management with useState
+- Effect tracking with useEffect  
+- Performance optimization with useMemo
+- Render counting with useRef
+
+### Todo List Component
+- Complex state operations (add, toggle, delete)
+- Form handling and validation
+- Progress tracking
+- List rendering optimization
+
+### Error Boundary Test
+- Error boundary implementation
+- Graceful error recovery
+- User-friendly error messages
+
+### Context API Demo
+- Theme switching across components
+- Global state management
+- Provider/Consumer pattern
+
+## 🎨 Styling
+
+- **Tailwind CSS**: Utility-first CSS framework
+- **Custom Components**: Reusable button, card, and input styles
+- **Responsive Design**: Mobile-first approach
+- **Dark Mode**: Full theme switching support
+- **Animations**: Smooth transitions and hover effects
+
+## 📁 Project Structure
+
+```
+src/
+├── main.tsx         # Main application component
+├── main.css         # Tailwind CSS imports and custom styles
+└── App.jsx          # Alternative app component structure
+
+public/
+├── logo.png         # Baraqex logo (add your own)
+└── index.html       # HTML template
+
+dist/
+├── bundle.js        # Compiled JavaScript
+└── main.css         # Compiled CSS
+```
+
+## 🛠️ Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server with hot reload
+npm run dev
+
+# Build for production
+npm run build
+
+# Preview production build
+npm run preview
+```
+
+## 📖 About Baraqex
+
+Baraqex is a powerful full-stack framework built on Frontend Hamroun that provides:
+
+- ⚡ **Reactive State Management**: Intuitive hooks API
+- 🌐 **Server-Side Rendering**: SEO-friendly and fast loading
+- 🔄 **WebAssembly Support**: High-performance computing
+- 🛡️ **Built-in Security**: Authentication and validation
+- 📦 **Zero Configuration**: Works out of the box
+- 🎯 **TypeScript Ready**: Full type safety support
+
+## 🔧 Customization
+
+### Adding Components
+
+Create new components following the established pattern:
+
+```tsx
+import { jsx, useState } from 'baraqex';
+
+function MyComponent() {
+  const [state, setState] = useState('initial');
+  
+  return (
+    <div className="card">
+      <h3>My Component</h3>
+      <p>State: {state}</p>
+    </div>
+  );
+}
+```
+
+### Styling Guidelines
+
+Use the established Tailwind classes and custom components:
+
+```tsx
+// Buttons
+<button className="btn btn-primary">Primary Action</button>
+<button className="btn btn-secondary">Secondary Action</button>
+
+// Cards
+<div className="card">Content here</div>
+
+// Inputs
+<input className="input" placeholder="Enter text..." />
+```
+
+### Adding New Features
+
+1. Create component in `src/`
+2. Import and use in `main.tsx`
+3. Add to navigation if needed
+4. Test error boundaries
+5. Ensure responsive design
+
+## 🚀 Deployment
+
+The built application can be deployed to any static hosting service:
+
+```bash
+# Build production files
+npm run build
+
+# Deploy the dist/ folder contents
+```
+
+**Deployment Options:**
+- Vercel: `vercel --prod`
+- Netlify: Drag & drop the project folder
+- GitHub Pages: Push to `gh-pages` branch
+- Any static host: Upload `dist/` contents
+
+## 📚 Learn More
+
+- [Baraqex Documentation](https://www.baraqex.tech/docs)
+- [Frontend Hamroun Hooks](https://frontend-hamroun.com/hooks)  
+- [Tailwind CSS Docs](https://tailwindcss.com/docs)
+
+## 🤝 Contributing
+
+This template is part of the Baraqex framework. Contributions welcome!
+
+---
+
+**Happy coding with Baraqex! 🚀**

package/templates/basic-app/esbuild.config.js

@@ -0,0 +1,37 @@
+import * as esbuild from 'esbuild';
+
+const isWatch = process.argv.includes('--watch');
+
+const config = {
+  entryPoints: ['src/main.tsx'],
+  bundle: true,
+  outfile: 'dist/bundle.js',
+  format: 'esm',
+  platform: 'browser',
+  target: 'es2020',
+  minify: !isWatch,
+  sourcemap: isWatch,
+  define: {
+    'process.env.NODE_ENV': isWatch ? '"development"' : '"production"'
+  },
+  external: [],
+  loader: {
+    '.tsx': 'tsx',
+    '.ts': 'tsx',
+    '.jsx': 'jsx',
+    '.js': 'jsx',
+    '.css': 'css'
+  },
+  // Don't transform JSX since we're using jsx() function calls
+  jsx: 'preserve'
+};
+
+if (isWatch) {
+  const ctx = await esbuild.context(config);
+  await ctx.watch();
+  console.log('👀 Watching for changes...');
+  console.log('📦 Bundle will be rebuilt automatically');
+} else {
+  await esbuild.build(config);
+  console.log('✅ Build complete');
+}

package/templates/basic-app/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <link rel="icon" type="image/x-icon" href="/favicon.ico">
+    <title>My Frontend App</title>
+</head>
+<body class="bg-gray-100 min-h-screen">
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+</body>
+</html>

package/templates/basic-app/main.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;