@almadar/orb 6.3.0 → 6.4.0

package/shells/almadar-shell/packages/client/tailwind-preset.cjs

@@ -0,0 +1,259 @@
+/**
+ * @almadar/ui Tailwind Preset
+ *
+ * Provides the complete Almadar design token system as a Tailwind preset.
+ * Includes a safelist for CSS-variable-based arbitrary classes that use
+ * bracket notation (Tailwind can't extract these from source scanning).
+ *
+ * Note: @almadar/ui dist content scanning is handled by tailwind.config.js
+ * in the shell template, not here. The config resolves the dist path via
+ * require.resolve('@almadar/ui') which works regardless of hoisting.
+ *
+ * Usage in tailwind.config.js:
+ *   presets: [require('@almadar/ui/tailwind-preset')]
+ */
+
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: 'class',
+  safelist: [
+  // Standard utilities used via dynamic className from .orb schemas
+  'p-4', 'p-6', 'p-8',
+  'px-4', 'px-6', 'py-4', 'py-6',
+  'mx-auto',
+  'w-full',
+  'max-w-sm', 'max-w-md', 'max-w-lg', 'max-w-xl', 'max-w-2xl', 'max-w-3xl', 'max-w-4xl', 'max-w-5xl', 'max-w-6xl', 'max-w-7xl',
+  'min-h-screen',
+  'gap-1', 'gap-2', 'gap-3', 'gap-4', 'gap-6', 'gap-8',
+  'grid-cols-1', 'grid-cols-2', 'grid-cols-3', 'grid-cols-4',
+  'sm:grid-cols-2', 'md:grid-cols-2', 'md:grid-cols-3', 'lg:grid-cols-3', 'lg:grid-cols-4',
+  'text-center', 'text-left', 'text-right',
+  // CSS variable-based classes from @almadar/ui components
+  'accent-[var(--color-foreground)]',
+  'accent-[var(--color-primary)]',
+  'active:bg-[var(--color-muted)]',
+  'active:bg-[var(--color-primary)]',
+  'active:scale-[var(--active-scale)]',
+  'active:shadow-[var(--shadow-active)]',
+  'active:text-[var(--color-primary-foreground)]',
+  'bg-[var(--color-accent)]',
+  'bg-[var(--color-background)]',
+  'bg-[var(--color-border)]',
+  'bg-[var(--color-card)]',
+  'bg-[var(--color-error)]',
+  'bg-[var(--color-foreground)]',
+  'bg-[var(--color-info)]',
+  'bg-[var(--color-muted)]',
+  'bg-[var(--color-muted-foreground)]',
+  ':bg-[var(--color-primary)]',
+  'bg-[var(--color-primary)]',
+  'bg-[var(--color-primary-foreground)]',
+  'bg-[var(--color-secondary)]',
+  'bg-[var(--color-success)]',
+  'bg-[var(--color-surface)]',
+  'bg-[var(--color-table-header)]',
+  'bg-[var(--color-warning)]',
+  'border-b-[length:var(--border-width)]',
+  'border-b-[var(--color-foreground)]',
+  'border-b-[var(--color-primary)]',
+  'border-[length:var(--border-width)]',
+  'border-[length:var(--border-width-thin)]',
+  'border-l-[length:var(--border-width)]',
+  'border-l-[var(--color-foreground)]',
+  'border-l-[var(--color-primary)]',
+  'border-r-[length:var(--border-width)]',
+  'border-r-[var(--color-foreground)]',
+  'border-r-[var(--color-primary)]',
+  'border-t-[length:var(--border-width)]',
+  'border-t-[var(--color-foreground)]',
+  'border-t-[var(--color-primary)]',
+  'border-[var(--color-accent)]',
+  ':border-[var(--color-border)]',
+  'border-[var(--color-border)]',
+  'border-[var(--color-card)]',
+  'border-[var(--color-error)]',
+  'border-[var(--color-foreground)]',
+  'border-[var(--color-info)]',
+  ':border-[var(--color-primary)]',
+  'border-[var(--color-primary)]',
+  'border-[var(--color-success)]',
+  'border-[var(--color-table-border)]',
+  'border-[var(--color-warning)]',
+  'border-x-[length:var(--border-width)]',
+  'checked:bg-[var(--color-primary)]',
+  'dark:bg-[var(--color-background)]',
+  'dark:bg-[var(--color-card)]',
+  'dark:bg-[var(--color-foreground)]',
+  'dark:bg-[var(--color-muted)]',
+  'dark:border-[var(--color-border)]',
+  'dark:hover:bg-[var(--color-error)]',
+  'dark:hover:bg-[var(--color-muted)]',
+  'dark:text-[var(--color-error)]',
+  'dark:text-[var(--color-foreground)]',
+  'dark:text-[var(--color-muted-foreground)]',
+  'disabled:bg-[var(--color-muted)]',
+  'disabled:text-[var(--color-muted-foreground)]',
+  'duration-[var(--transition-fast)]',
+  'duration-[var(--transition-normal)]',
+  'fill-[var(--color-warning)]',
+  'focus:bg-[var(--color-card)]',
+  'focus:bg-[var(--color-muted)]',
+  'focus:border-[var(--color-error)]',
+  'focus:border-[var(--color-primary)]',
+  'focus:border-[var(--color-ring)]',
+  'focus:ring-[length:var(--focus-ring-width)]',
+  'focus:ring-offset-[length:var(--focus-ring-offset)]',
+  'focus:ring-[var(--color-error)]',
+  'focus:ring-[var(--color-ring)]',
+  'font-[var(--font-weight-bold)]',
+  'font-[var(--font-weight-medium)]',
+  'from-[var(--color-muted)]',
+  'group-hover:bg-[var(--color-foreground)]',
+  'group-hover:text-[var(--color-foreground)]',
+  'group-hover:text-[var(--color-muted-foreground)]',
+  'hover:bg-[var(--color-error)]',
+  'hover:bg-[var(--color-muted)]',
+  'hover:bg-[var(--color-muted-foreground)]',
+  'hover:bg-[var(--color-primary)]',
+  'hover:bg-[var(--color-primary-hover)]',
+  'hover:bg-[var(--color-secondary-hover)]',
+  'hover:bg-[var(--color-success)]',
+  'hover:bg-[var(--color-surface)]',
+  'hover:bg-[var(--color-surface-hover)]',
+  'hover:bg-[var(--color-table-row-hover)]',
+  'hover:bg-[var(--color-warning)]',
+  'hover:border-[var(--color-border)]',
+  'hover:border-[var(--color-border-hover)]',
+  'hover:border-[var(--color-muted-foreground)]',
+  'hover:border-[var(--color-primary)]',
+  'hover:ring-[var(--color-ring)]',
+  'hover:shadow-[var(--shadow-hover)]',
+  'hover:shadow-[var(--shadow-sm)]',
+  'hover:text-[var(--color-error)]',
+  'hover:text-[var(--color-error-foreground)]',
+  'hover:text-[var(--color-foreground)]',
+  'hover:text-[var(--color-primary)]',
+  'hover:text-[var(--color-success-foreground)]',
+  'hover:text-[var(--color-warning-foreground)]',
+  'peer-focus:ring-[var(--color-error)]',
+  'peer-focus:ring-[var(--color-ring)]',
+  'placeholder:text-[var(--color-muted-foreground)]',
+  'placeholder:text-[var(--color-placeholder)]',
+  'ring-[var(--color-accent)]',
+  'ring-[var(--color-error)]',
+  'ring-[var(--color-info)]',
+  'ring-[var(--color-muted-foreground)]',
+  'ring-[var(--color-primary)]',
+  'ring-[var(--color-success)]',
+  'ring-[var(--color-warning)]',
+  'rounded-l-[var(--radius-sm)]',
+  'rounded-r-[var(--radius-sm)]',
+  'rounded-t-[var(--radius-lg)]',
+  'rounded-t-[var(--radius-sm)]',
+  'rounded-[var(--radius-full)]',
+  'rounded-[var(--radius-lg)]',
+  'rounded-[var(--radius-md)]',
+  'rounded-[var(--radius-sm)]',
+  'rounded-[var(--radius-xl)]',
+  'shadow-[var(--shadow-lg)]',
+  'shadow-[var(--shadow-main)]',
+  'shadow-[var(--shadow-sm)]',
+  'text-[var(--color-accent)]',
+  'text-[var(--color-accent-foreground)]',
+  'text-[var(--color-background)]',
+  'text-[var(--color-card-foreground)]',
+  'text-[var(--color-error)]',
+  'text-[var(--color-error-foreground)]',
+  'text-[var(--color-foreground)]',
+  'text-[var(--color-info)]',
+  'text-[var(--color-info-foreground)]',
+  'text-[var(--color-muted)]',
+  'text-[var(--color-muted-foreground)]',
+  'text-[var(--color-primary)]',
+  ':text-[var(--color-primary-foreground)]',
+  'text-[var(--color-primary-foreground)]',
+  'text-[var(--color-secondary-foreground)]',
+  'text-[var(--color-success)]',
+  'text-[var(--color-warning)]',
+  'text-[var(--color-warning-foreground)]',
+  'to-[var(--color-accent)]',
+  ],
+  theme: {
+    fontFamily: {
+      sans: ['var(--font-family)', 'ui-sans-serif', 'system-ui', 'sans-serif'],
+      mono: ['var(--font-family-mono, ui-monospace)', 'SFMono-Regular', 'Menlo', 'Monaco', 'Consolas', 'monospace'],
+    },
+    extend: {
+      colors: {
+        primary: {
+          DEFAULT: 'var(--color-primary)',
+          foreground: 'var(--color-primary-foreground)',
+          hover: 'var(--color-primary-hover)',
+        },
+        secondary: {
+          DEFAULT: 'var(--color-secondary)',
+          foreground: 'var(--color-secondary-foreground)',
+          hover: 'var(--color-secondary-hover)',
+        },
+        muted: {
+          DEFAULT: 'var(--color-muted)',
+          foreground: 'var(--color-muted-foreground)',
+        },
+        accent: {
+          DEFAULT: 'var(--color-accent)',
+          foreground: 'var(--color-accent-foreground)',
+        },
+        background: 'var(--color-background)',
+        foreground: 'var(--color-foreground)',
+        card: {
+          DEFAULT: 'var(--color-card)',
+          foreground: 'var(--color-card-foreground)',
+        },
+        surface: 'var(--color-surface)',
+        border: 'var(--color-border)',
+        input: 'var(--color-input)',
+        ring: 'var(--color-ring)',
+        error: {
+          DEFAULT: 'var(--color-error)',
+          foreground: 'var(--color-error-foreground)',
+        },
+        success: {
+          DEFAULT: 'var(--color-success)',
+          foreground: 'var(--color-success-foreground)',
+        },
+        warning: {
+          DEFAULT: 'var(--color-warning)',
+          foreground: 'var(--color-warning-foreground)',
+        },
+        info: {
+          DEFAULT: 'var(--color-info)',
+          foreground: 'var(--color-info-foreground)',
+        },
+      },
+      borderRadius: {
+        none: 'var(--radius-none, 0)',
+        sm: 'var(--radius-sm)',
+        md: 'var(--radius-md)',
+        lg: 'var(--radius-lg)',
+        xl: 'var(--radius-xl)',
+        full: 'var(--radius-full)',
+      },
+      boxShadow: {
+        sm: 'var(--shadow-sm)',
+        DEFAULT: 'var(--shadow-main)',
+        lg: 'var(--shadow-lg)',
+        inner: 'var(--shadow-inner)',
+      },
+      fontWeight: {
+        normal: 'var(--font-weight-normal, 400)',
+        medium: 'var(--font-weight-medium, 500)',
+        bold: 'var(--font-weight-bold, 600)',
+      },
+      transitionDuration: {
+        fast: 'var(--transition-fast, 150ms)',
+        normal: 'var(--transition-normal, 250ms)',
+        slow: 'var(--transition-slow, 400ms)',
+      },
+    },
+  },
+};

package/shells/almadar-shell/packages/client/tailwind.config.js

@@ -0,0 +1,21 @@
+import { createRequire } from 'module';
+import { dirname, join } from 'path';
+const require = createRequire(import.meta.url);
+
+// Resolve @almadar/ui dist regardless of node_modules hoisting
+const uiEntry = require.resolve('@almadar/ui');
+const uiDist = join(dirname(uiEntry), '..', '**', '*.js');
+
+/** @type {import('tailwindcss').Config} */
+export default {
+  presets: [require('./tailwind-preset.cjs')],
+  content: [
+    "./index.html",
+    "./src/**/*.{js,ts,jsx,tsx}",
+    uiDist,
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+}

package/shells/almadar-shell/packages/client/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "useDefineForClassFields": true,
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "types": ["vite/client"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@generated/*": ["./src/generated/*"],
+      "@pages/*": ["./src/pages/*"],
+      "@app/shared": ["../shared/src/index.ts"],
+      "@app/shared/*": ["../shared/src/*"],
+      "@shared/*": ["../shared/src/*"],
+      "@design-system": ["../../../design-system/index.ts"],
+      "@design-system/*": ["../../../design-system/*"]
+    }
+  },
+  "include": ["src", "../../../design-system/types"],
+  "exclude": ["node_modules", "dist", "src/**/__tests__", "src/**/*.stories.ts", "src/**/*.stories.tsx"]
+}

package/shells/almadar-shell/packages/client/vite.config.ts

@@ -0,0 +1,50 @@
+import { defineConfig, loadEnv } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, process.cwd(), '');
+  const backendUrl = env.VITE_API_URL || 'http://localhost:3030';
+  const wsUrl = backendUrl.replace('http://', 'ws://').replace('https://', 'wss://');
+
+  return {
+    plugins: [react()],
+
+    resolve: {
+      alias: {
+        '@design-system': path.resolve(__dirname, '../../../design-system'),
+        '@': path.resolve(__dirname, './src'),
+        '@generated': path.resolve(__dirname, './src/generated'),
+        '@pages': path.resolve(__dirname, './src/pages'),
+        '@app/shared': path.resolve(__dirname, '../shared/src'),
+        '@shared': path.resolve(__dirname, '../shared/src'),
+      },
+      dedupe: ['react', 'react-dom', '@almadar/ui'],
+    },
+
+    server: {
+      host: true,
+      port: 5173,
+      proxy: {
+        '/api': {
+          target: backendUrl,
+          changeOrigin: true,
+        },
+        '/ws': {
+          target: wsUrl,
+          ws: true,
+        },
+      },
+    },
+
+    build: {
+      outDir: 'dist',
+      sourcemap: true,
+    },
+
+    test: {
+      environment: 'jsdom',
+      globals: true,
+    },
+  };
+});

package/shells/almadar-shell/packages/server/eslint.config.cjs

@@ -0,0 +1,19 @@
+"use strict";
+const tsParser = require("@typescript-eslint/parser");
+const almadarPlugin = require("@almadar/eslint-plugin");
+
+module.exports = [
+  { ignores: ["dist/**", "node_modules/**", "**/*.test.ts"] },
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: { ecmaVersion: "latest", sourceType: "module" },
+    },
+    plugins: { almadar: almadarPlugin },
+    rules: {
+      "almadar/no-as-any": "error",
+      "almadar/no-import-generated": "error",
+    },
+  },
+];

package/shells/almadar-shell/packages/server/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@almadar/shell-server",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "esbuild src/index.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/index.js",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@almadar/server": ">=2.2.0",
+    "@almadar/evaluator": ">=2.6.0",
+    "@almadar/core": ">=2.9.0",
+    "@almadar/integrations": ">=2.3.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "firebase-admin": "^12.7.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "@almadar/eslint-plugin": ">=2.3.0",
+    "@typescript-eslint/parser": "8.56.0",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/node": "^20.17.19",
+    "eslint": "10.0.0",
+    "esbuild": "^0.25.0",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
+  }
+}

package/shells/almadar-shell/packages/server/src/app.ts

@@ -0,0 +1,36 @@
+/**
+ * Express Application Setup
+ */
+
+import express, { type Express } from 'express';
+import cors from 'cors';
+import {
+  env,
+  logger,
+  errorHandler,
+  notFoundHandler,
+  debugEventsRouter,
+} from '@almadar/server';
+import { registerRoutes } from './routes.js';
+
+export const app: Express = express();
+
+// Middleware
+app.use(cors({ origin: true, credentials: true }));
+app.use(express.json());
+app.use(express.urlencoded({ extended: true }));
+
+// Health check
+app.get('/health', (_req, res) => {
+  res.json({ status: 'ok' });
+});
+
+// Debug event bus endpoints (dev-only, no-op in production)
+app.use('/api/debug', debugEventsRouter());
+
+// Register generated routes
+registerRoutes(app);
+
+// Error handling
+app.use(notFoundHandler);
+app.use(errorHandler);

package/shells/almadar-shell/packages/server/src/index.ts

@@ -0,0 +1,30 @@
+/**
+ * Server Entry Point
+ */
+
+import { initializeFirebase, env, logger } from '@almadar/server';
+
+// Initialize Firebase before anything else uses it
+initializeFirebase();
+
+import { app } from './app.js';
+
+const PORT = env.PORT || 3030;
+
+async function start(): Promise<void> {
+  // Seed mock data when USE_MOCK_DATA is enabled
+  if (env.USE_MOCK_DATA) {
+    try {
+      const { initializeMockData } = await import(/* @vite-ignore */ './seedMockData.js' as string);
+      await initializeMockData();
+    } catch {
+      logger.warn('seedMockData.ts not found — skipping mock data seeding');
+    }
+  }
+
+  app.listen(PORT, () => {
+    logger.info(`Server running on port ${PORT}`);
+  });
+}
+
+start();

package/shells/almadar-shell/packages/server/src/routes.ts

@@ -0,0 +1,11 @@
+/**
+ * Route Registration
+ *
+ * Compiler generates route registration code here.
+ */
+
+import type { Express } from 'express';
+
+export function registerRoutes(app: Express): void {
+  // {{GENERATED_ROUTE_REGISTRATION}}
+}

package/shells/almadar-shell/packages/server/src/types/express.d.ts

@@ -0,0 +1,15 @@
+declare global {
+  namespace Express {
+    interface Request {
+      firebaseUser?: {
+        uid: string;
+        email?: string;
+        name?: string;
+        picture?: string;
+        [key: string]: unknown;
+      };
+    }
+  }
+}
+
+export {};

package/shells/almadar-shell/packages/server/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./dist",
+    "strict": true,
+    "strictNullChecks": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"],
+      "@app/shared": ["../shared/src/index.ts"],
+      "@app/shared/*": ["../shared/src/*"]
+    }
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "src/**/__tests__/**", "src/**/*.test.ts", "src/**/*.spec.ts"]
+}

package/shells/almadar-shell/packages/shared/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@app/shared",
+  "version": "1.0.0",
+  "private": true,
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "dependencies": {
+    "zod": "^3.22.0"
+  }
+}

package/shells/almadar-shell/packages/shared/pnpm-lock.yaml

@@ -0,0 +1,22 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      zod:
+        specifier: ^3.22.0
+        version: 3.25.76
+
+packages:
+
+  zod@3.25.76:
+    resolution: {integrity: sha512-gzUt/qt81nXsFGKIFcC3YnfEAx5NkunCfnDlvuBSSFS02bcXu4Lmea0AFIUwbLWxWPx3d9p8S5QoaujKcNQxcQ==}
+
+snapshots:
+
+  zod@3.25.76: {}

package/shells/almadar-shell/packages/shared/src/index.ts

@@ -0,0 +1,2 @@
+// Placeholder — the compiler generates actual shared types here.
+export {};