cumstack 1.0.0

package/src/app/shared/utils.js

@@ -0,0 +1,127 @@
+/**
+ * cumstack Utilities
+ * common helper functions
+ */
+
+/**
+ * class names helper (similar to clsx)
+ * @param {...any} args - Class arguments
+ * @returns {string}
+ */
+export function cn(...args) {
+  return args
+    .flat()
+    .filter(Boolean)
+    .map((arg) => {
+      if (typeof arg === 'string') return arg;
+      if (typeof arg === 'object')
+        return Object.entries(arg)
+          .filter(([, value]) => Boolean(value))
+          .map(([key]) => key)
+          .join(' ');
+      return '';
+    })
+    .join(' ')
+    .trim();
+}
+
+/**
+ * debounce function
+ * @param {Function} fn - Function to debounce
+ * @param {number} delay - Delay in ms
+ * @returns {Function}
+ */
+export function debounce(fn, delay) {
+  let timeoutId;
+  return (...args) => {
+    clearTimeout(timeoutId);
+    timeoutId = setTimeout(() => fn(...args), delay);
+  };
+}
+
+/**
+ * throttle function
+ * @param {Function} fn - Function to throttle
+ * @param {number} delay - Delay in ms
+ * @returns {Function}
+ */
+export function throttle(fn, delay) {
+  let lastCall = 0;
+  return (...args) => {
+    const now = Date.now();
+    if (now - lastCall >= delay) {
+      lastCall = now;
+      fn(...args);
+    }
+  };
+}
+
+/**
+ * sleep/delay function
+ * @param {number} ms - Milliseconds to sleep
+ * @returns {Promise<void>}
+ */
+export function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+/**
+ * generate unique id
+ * @returns {string}
+ */
+export function generateId() {
+  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+
+/**
+ * deep clone object
+ * @template T
+ * @param {T} obj - Object to clone
+ * @returns {T}
+ */
+export function deepClone(obj) {
+  if (obj === null || typeof obj !== 'object') return obj;
+  if (obj instanceof Date) return new Date(obj.getTime());
+  if (obj instanceof Array) return obj.map((item) => deepClone(item));
+  const cloned = {};
+  for (const key in obj) if (obj.hasOwnProperty(key)) cloned[key] = deepClone(obj[key]);
+  return cloned;
+}
+
+/**
+ * check if value is empty
+ * @param {any} value - Value to check
+ * @returns {boolean}
+ */
+export function isEmpty(value) {
+  if (value == null) return true;
+  if (typeof value === 'string') return value.trim().length === 0;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === 'object') return Object.keys(value).length === 0;
+  return false;
+}
+
+/**
+ * format date
+ * @param {Date|string|number} date - Date to format
+ * @param {string} locale - Locale
+ * @returns {string}
+ */
+export function formatDate(date, locale = 'en-US') {
+  const d = new Date(date);
+  return d.toLocaleDateString(locale);
+}
+
+/**
+ * format currency
+ * @param {number} amount - Amount
+ * @param {string} currency - Currency code
+ * @param {string} locale - Locale
+ * @returns {string}
+ */
+export function formatCurrency(amount, currency = 'USD', locale = 'en-US') {
+  return new Intl.NumberFormat(locale, {
+    style: 'currency',
+    currency,
+  }).format(amount);
+}

package/templates/monorepo/README.md

@@ -0,0 +1,27 @@
+# My cumstack App
+
+A monorepo project with cumstack frontend and API backend.
+
+## Structure
+
+- `app/` - cumstack frontend application
+- `api/` - API backend (to be implemented)
+
+## Getting Started
+
+1. Install dependencies:
+
+   ```bash
+   bun install
+   ```
+
+2. Start development server:
+
+   ```bash
+   bun run dev
+   ```
+
+3. Build for production:
+   ```bash
+   bun run build
+   ```

package/templates/monorepo/api/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "api",
+  "version": "1.0.0",
+  "description": "API backend (placeholder)",
+  "type": "module",
+  "scripts": {
+    "dev": "echo 'API not implemented yet'",
+    "build": "echo 'API not implemented yet'"
+  },
+  "devDependencies": {
+    "bun": "^1.0.0"
+  }
+}

package/templates/monorepo/app/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "app",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "cumstack dev",
+    "build": "cumstack build",
+    "start": "bun run dist/server.js"
+  },
+  "dependencies": {
+    "cumstack": "^"
+  },
+  "devDependencies": {
+    "bun": "^1.3.5",
+    "@tailwindcss/postcss": "^4.1.18",
+    "postcss": "^8.5.6",
+    "wrangler": "^4.54.0"
+  }
+}

package/templates/monorepo/app/src/entry.client.jsx

@@ -0,0 +1,4 @@
+import { cowgirl } from 'cumstack';
+import App from './entry.server.jsx';
+
+cowgirl(App, document.getElementById('app'));

package/templates/monorepo/app/src/entry.server.jsx

@@ -0,0 +1,14 @@
+import { FoxgirlCreampie, Router, Route } from 'cumstack';
+import Home from './pages/Home.jsx';
+import NotFound from './pages/404.jsx';
+
+export default function () {
+  return (
+    <FoxgirlCreampie>
+      <Router>
+        <Route path="/" component={Home} />
+        <Route path="/404" component={NotFound} />
+      </Router>
+    </FoxgirlCreampie>
+  );
+}

package/templates/monorepo/app/src/main.css

@@ -0,0 +1,7 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+body {
+  font-family: Arial, sans-serif;
+}

package/templates/monorepo/app/src/pages/404.jsx

@@ -0,0 +1,9 @@
+export default function NotFound() {
+  return (
+    <div>
+      <h1>404 - Page Not Found</h1>
+      <p>The page you're looking for doesn't exist.</p>
+      <a href="/">Go Home</a>
+    </div>
+  );
+}

package/templates/monorepo/app/src/pages/Home.jsx

@@ -0,0 +1,8 @@
+export default function Home() {
+  return (
+    <div>
+      <h1>Welcome to cumstack</h1>
+      <p>This is a basic cumstack app.</p>
+    </div>
+  );
+}

package/templates/monorepo/app/wrangler.toml

@@ -0,0 +1,35 @@
+name = "my-cumstack-app"
+main = "./dist/dev/server/main.server.js"
+compatibility_date = "2024-12-01"
+compatibility_flags = ["global_fetch_strictly_public"]
+
+[dev]
+port = 7277
+
+[assets]
+directory = "./dist/dev/client"
+
+[observability]
+enabled = true
+
+[vars]
+ENVIRONMENT                 = "production"
+APP_DOMAIN                  = "example.com"
+API_DOMAIN                  = "api.example.com"
+CDN_DOMAIN                  = "cdn.example.com"
+APP_NAME                    = "Example"
+STRIPE_PUBLISHABLE_KEY      = ""
+TURNSTILE_SITE_KEY          = ""
+
+[env.dev.vars]
+ENVIRONMENT                 = "development"
+APP_DOMAIN                  = "127.0.0.1:7277"
+API_DOMAIN                  = "127.0.0.1:7278"
+CDN_DOMAIN                  = "127.0.0.1:7279"
+APP_NAME                    = "Example (Local)"
+STRIPE_PUBLISHABLE_KEY      = ""
+TURNSTILE_SITE_KEY          = ""
+
+[[r2_buckets]]
+binding                     = "R2"
+bucket_name                 = "r2-example"

package/templates/monorepo/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "my-cumstack-app",
+  "version": "1.0.0",
+  "description": "A monorepo project using cumstack framework",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --cwd app dev",
+    "build": "bun run --cwd app build",
+    "start": "bun run --cwd app start"
+  },
+  "workspaces": [
+    "app",
+    "api"
+  ],
+  "devDependencies": {
+    "bun": "^1.3.5"
+  }
+}