@almadar/shell 2.16.1 → 2.16.4

package/.env.example

@@ -0,0 +1,17 @@
+# Server
+PORT=3030
+NODE_ENV=production
+# Comma-separated allowlist of browser origins permitted to call the API.
+CORS_ORIGIN=http://localhost:5173,http://localhost:5174
+# LOCAL DEV ONLY — set to true to skip Firebase auth when no Bearer token is sent.
+# Leave unset/false in any deployed environment (fail closed).
+# ALLOW_DEV_AUTH_BYPASS=true
+
+# Firebase (required for auth — use emulator for local dev)
+FIRESTORE_EMULATOR_HOST=localhost:8080
+# FIREBASE_PROJECT_ID=
+# FIREBASE_CLIENT_EMAIL=
+# FIREBASE_PRIVATE_KEY=
+
+# Client (set in packages/client/.env)
+# VITE_API_URL=http://localhost:3030

package/.gitignore

@@ -0,0 +1,31 @@
+# Turbo
+.turbo/
+
+# Node
+node_modules/
+*.log
+
+# Build output
+dist/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Editor
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test coverage
+coverage/
+.nyc_output/
+
+# Lock files (regenerated on install)
+package-lock.json

package/locales/en.json

@@ -0,0 +1,120 @@
+{
+  "$meta": { "locale": "en", "direction": "ltr" },
+
+  "common.save": "Save",
+  "common.cancel": "Cancel",
+  "common.delete": "Delete",
+  "common.close": "Close",
+  "common.confirm": "Are you sure?",
+  "common.create": "Create",
+  "common.edit": "Edit",
+  "common.view": "View",
+  "common.add": "Add",
+  "common.remove": "Remove",
+  "common.search": "Search...",
+  "common.filter": "Filter",
+  "common.actions": "Actions",
+  "common.yes": "Yes",
+  "common.no": "No",
+  "common.ok": "OK",
+  "common.done": "Done",
+  "common.apply": "Apply",
+  "common.reset": "Reset",
+  "common.refresh": "Refresh",
+  "common.export": "Export",
+  "common.import": "Import",
+  "common.copy": "Copy",
+  "common.settings": "Settings",
+
+  "nav.previous": "Previous",
+  "nav.next": "Next",
+  "nav.back": "Back",
+  "nav.home": "Home",
+
+  "form.submit": "Submit",
+  "form.saving": "Saving...",
+  "form.required": "This field is required",
+  "form.invalidEmail": "Enter a valid email address",
+  "form.selectPlaceholder": "Select {{label}}...",
+  "form.searchPlaceholder": "Search {{entity}}...",
+
+  "table.empty.title": "No items found",
+  "table.empty.description": "No items to display.",
+  "table.search.placeholder": "Search...",
+  "table.pagination.showing": "Showing {{start}} to {{end}} of {{total}} results",
+  "table.pagination.page": "Page {{page}} of {{totalPages}}",
+  "table.bulk.selected": "{{count}} selected",
+  "table.loading": "Loading...",
+
+  "status.loading": "Loading...",
+  "status.scheduled": "Scheduled",
+  "status.inProgress": "In Progress",
+  "status.completed": "Completed",
+  "status.cancelled": "Cancelled",
+  "status.pending": "Pending",
+  "status.active": "Active",
+  "status.inactive": "Inactive",
+  "status.draft": "Draft",
+  "status.archived": "Archived",
+
+  "error.generic": "Something went wrong",
+  "error.retry": "Try again",
+  "error.notFound": "Not found",
+  "error.loadFailed": "Failed to load: {{message}}",
+  "error.configMissing": "Configuration not found for: {{id}}",
+
+  "common.loading": "Loading...",
+  "common.showMore": "Show More",
+  "common.showLess": "Show Less",
+  "common.noResults": "No results found",
+  "common.saveChanges": "Save Changes",
+  "common.retry": "Retry",
+  "common.open": "Open",
+  "common.back": "Back",
+
+  "empty.noItems": "No items",
+  "empty.noData": "No data available",
+  "empty.noItemsYet": "No items yet",
+  "empty.noItemsAdded": "No items added yet",
+  "empty.noOptionsFound": "No options found",
+
+  "list.addItemPlaceholder": "Add new item...",
+
+  "error.occurred": "An error occurred",
+  "error.failedToLoad": "Failed to load data",
+
+  "wizard.back": "Back",
+  "wizard.next": "Next",
+  "wizard.complete": "Complete",
+  "wizard.stepOf": "Step {{current}} of {{total}}",
+
+  "pagination.previous": "Previous",
+  "pagination.next": "Next",
+  "pagination.total": "Total:",
+  "pagination.show": "Show:",
+  "pagination.goTo": "Go to:",
+  "pagination.go": "Go",
+
+  "auth.signIn": "Sign in",
+  "auth.signOut": "Sign out",
+
+  "dialog.confirm": "Confirm",
+  "dialog.cancel": "Cancel",
+  "dialog.loading": "Loading...",
+  "dialog.delete.title": "Delete {{item}}?",
+  "dialog.delete.message": "This action cannot be undone.",
+
+  "trait.availableActions": "Available Actions",
+  "trait.transitions": "Transitions",
+  "trait.availableNow": "Available now",
+
+  "book.startReading": "Start Reading",
+  "book.tableOfContents": "Table of Contents",
+  "book.partNumber": "Part {{number}}",
+  "book.print": "Print",
+  "book.previousPage": "Previous page",
+  "book.nextPage": "Next page",
+
+  "quiz.showAnswer": "Show answer",
+  "quiz.hideAnswer": "Hide answer"
+}

package/package.json

@@ -1,14 +1,42 @@
 {
   "name": "@almadar/shell",
-  "version": "2.16.1",
+  "version": "2.16.4",
   "private": false,
   "description": "Minimal full-stack shell template for Almadar applications",
+  "packageManager": "pnpm@10.30.3",
+  "scripts": {
+    "dev": "npx concurrently -n client,server -c blue,green \"pnpm --filter @almadar/shell-client dev\" \"pnpm --filter @almadar/shell-server dev\"",
+    "build": "pnpm run -r build",
+    "typecheck": "turbo run typecheck",
+    "lint": "turbo run lint",
+    "prepare": "git rev-parse --git-dir > /dev/null 2>&1 && git config core.hooksPath .githooks || true"
+  },
   "devDependencies": {
     "concurrently": "^9.2.1",
     "turbo": "^2.8.17"
   },
+  "pnpm": {
+    "overrides": {
+      "@tootallnate/once": "^3.0.1",
+      "esbuild": "^0.25.0",
+      "flatted": "^3.4.1",
+      "protobufjs": ">=7.5.8 <8",
+      "node-forge": "^1.4.0",
+      "fast-xml-parser": "^5.7.0",
+      "fast-xml-builder": ">=1.1.7",
+      "express>path-to-regexp": "0.1.13",
+      "qs": "^6.15.2",
+      "lodash-es": "^4.18.0"
+    }
+  },
   "files": [
-    "dist"
+    "packages",
+    "locales",
+    "pnpm-workspace.yaml",
+    "turbo.json",
+    "pnpm-lock.yaml",
+    ".env.example",
+    ".gitignore"
   ],
   "repository": {
     "type": "git",
@@ -16,11 +44,5 @@
   },
   "publishConfig": {
     "access": "public"
-  },
-  "scripts": {
-    "dev": "npx concurrently -n client,server -c blue,green \"pnpm --filter @almadar/shell-client dev\" \"pnpm --filter @almadar/shell-server dev\"",
-    "build": "pnpm run -r build",
-    "typecheck": "turbo run typecheck",
-    "lint": "turbo run lint"
   }
-}
+}

package/packages/client/eslint.config.cjs

@@ -0,0 +1,56 @@
+"use strict";
+const tsParser = require("@typescript-eslint/parser");
+const almadarPlugin = require("@almadar/eslint-plugin");
+// react-hooks plugin registered so the codegen-emitted
+// `// eslint-disable-next-line react-hooks/exhaustive-deps` comments are
+// well-formed (eslint errors on disable directives that reference
+// unknown rules). The actual rules are left off — enabling them would
+// surface a backlog of dep-array warnings the codegen knows are
+// intentional. Tightening is a separate codegen-fix pass.
+let reactHooksPlugin;
+try {
+  reactHooksPlugin = require("eslint-plugin-react-hooks");
+} catch (_) {
+  reactHooksPlugin = { rules: { "exhaustive-deps": { meta: {}, create: () => ({}) }, "rules-of-hooks": { meta: {}, create: () => ({}) } } };
+}
+
+module.exports = [
+  { ignores: ["dist/**", "node_modules/**", "**/*.test.ts", "**/*.test.tsx"] },
+  {
+    files: ["src/**/*.ts", "src/**/*.tsx"],
+    // The codegen emits `// eslint-disable-next-line react-hooks/exhaustive-deps`
+    // ahead of every mount-only effect's `[]` dep array. Until the real
+    // `eslint-plugin-react-hooks` is wired (it would fire the rule and
+    // make these directives meaningful), the shim's no-op create() means
+    // the rule never reports — so ESLint flags the directives as
+    // "Unused eslint-disable directive". That's a false alarm at this
+    // stage; suppress it so the strict-error rule set still hard-fails.
+    linterOptions: { reportUnusedDisableDirectives: "off" },
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+        ecmaVersion: "latest",
+        sourceType: "module",
+      },
+    },
+    plugins: { almadar: almadarPlugin, "react-hooks": reactHooksPlugin },
+    rules: {
+      // Zero escape hatches in emitted shell code. Each rule pairs with a
+      // codegen-template fix in orbital-rust (see docs/Almadar_Compiler_Gaps.md):
+      // - no-as-any:           catches `as any` casts.
+      // - no-unknown-type:     catches `: unknown` annotations.
+      //                        Service results are typed via the integrations
+      //                        contract; every other "unknown" is a typed
+      //                        shape the codegen knows.
+      // - no-record-string-unknown: catches `as Record<string, unknown>` casts
+      //                        the codegen used to index into entity rows by
+      //                        string key. The entity has a typed interface
+      //                        — emit against that.
+      "almadar/no-as-any": "error",
+      "almadar/no-unknown-type": "error",
+      "almadar/no-record-string-unknown": "error",
+      "almadar/no-import-generated": "error",
+    },
+  },
+];

package/packages/client/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Almadar App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/packages/client/node_modules/.bin/autoprefixer

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/autoprefixer@10.4.27_postcss@8.5.8/node_modules/autoprefixer/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/autoprefixer@10.4.27_postcss@8.5.8/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/autoprefixer@10.4.27_postcss@8.5.8/node_modules/autoprefixer/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/autoprefixer@10.4.27_postcss@8.5.8/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../autoprefixer/bin/autoprefixer" "$@"
+else
+  exec node  "$basedir/../autoprefixer/bin/autoprefixer" "$@"
+fi

package/packages/client/node_modules/.bin/eslint

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/eslint@10.0.0_jiti@1.21.7/node_modules/eslint/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/eslint@10.0.0_jiti@1.21.7/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/eslint@10.0.0_jiti@1.21.7/node_modules/eslint/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/eslint@10.0.0_jiti@1.21.7/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../eslint/bin/eslint.js" "$@"
+else
+  exec node  "$basedir/../eslint/bin/eslint.js" "$@"
+fi

package/packages/client/node_modules/.bin/tailwind

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules/tailwindcss/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules/tailwindcss/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tailwindcss/lib/cli.js" "$@"
+else
+  exec node  "$basedir/../tailwindcss/lib/cli.js" "$@"
+fi

package/packages/client/node_modules/.bin/tailwindcss

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules/tailwindcss/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules/tailwindcss/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/tailwindcss@3.4.19_tsx@4.21.0/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../tailwindcss/lib/cli.js" "$@"
+else
+  exec node  "$basedir/../tailwindcss/lib/cli.js" "$@"
+fi

package/packages/client/node_modules/.bin/tsc

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsc" "$@"
+fi

package/packages/client/node_modules/.bin/tsserver

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
+else
+  exec node  "$basedir/../typescript/bin/tsserver" "$@"
+fi

package/packages/client/node_modules/.bin/vite

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vite@6.4.1_@types+node@22.19.15_jiti@1.21.7_tsx@4.21.0/node_modules/vite/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vite@6.4.1_@types+node@22.19.15_jiti@1.21.7_tsx@4.21.0/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vite@6.4.1_@types+node@22.19.15_jiti@1.21.7_tsx@4.21.0/node_modules/vite/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vite@6.4.1_@types+node@22.19.15_jiti@1.21.7_tsx@4.21.0/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vite/bin/vite.js" "$@"
+else
+  exec node  "$basedir/../vite/bin/vite.js" "$@"
+fi

package/packages/client/node_modules/.bin/vitest

@@ -0,0 +1,21 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vitest@2.1.9_@types+node@22.19.15_jsdom@25.0.1/node_modules/vitest/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vitest@2.1.9_@types+node@22.19.15_jsdom@25.0.1/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vitest@2.1.9_@types+node@22.19.15_jsdom@25.0.1/node_modules/vitest/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/vitest@2.1.9_@types+node@22.19.15_jsdom@25.0.1/node_modules:/home/osamah/kflow.ai.builder/orbital-rust/packages/almadar-shell/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../vitest/vitest.mjs" "$@"
+else
+  exec node  "$basedir/../vitest/vitest.mjs" "$@"
+fi

package/packages/client/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@almadar/shell-client",
+  "version": "2.13.15",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint --max-warnings 0 src/",
+    "preview": "vite preview",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@almadar/core": "^7.14.3",
+    "@almadar/evaluator": "^2.11.2",
+    "@almadar/logger": "^1.3.0",
+    "@almadar/patterns": "^2.30.2",
+    "@almadar/syntax": "^1.4.0",
+    "@almadar/ui": "^4.55.0",
+    "@monaco-editor/react": "^4.7.0",
+    "@react-three/drei": "^9.92.0",
+    "@react-three/fiber": "^9.0.0",
+    "@react-three/postprocessing": "^3.0.0",
+    "@tanstack/react-query": "^5.67.3",
+    "firebase": "^11.4.0",
+    "leaflet": "^1.9.4",
+    "lucide-react": "^0.344.0",
+    "monaco-editor": "^0.52.2",
+    "postprocessing": "^6.39.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-force-graph-2d": "^1.25.5",
+    "react-leaflet": "^4.2.1",
+    "react-markdown": "^9.0.1",
+    "react-router-dom": "^7.3.0",
+    "rehype-katex": "^7.0.1",
+    "rehype-raw": "^7.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "three": "^0.160.0",
+    "zustand": "^5.0.3"
+  },
+  "devDependencies": {
+    "@almadar/eslint-plugin": "^2.8.1",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@typescript-eslint/parser": "8.56.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.20",
+    "eslint": "10.0.0",
+    "jsdom": "^25.0.1",
+    "postcss": "^8.5.3",
+    "tailwindcss": "^3.4.17",
+    "@tailwindcss/container-queries": "^0.1.1",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.1",
+    "vitest": "^2.1.9"
+  }
+}

package/packages/client/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

package/packages/client/src/App.tsx

@@ -0,0 +1,81 @@
+/**
+ * App Entry Point
+ *
+ * Main application component with compiler-generated content placeholders.
+ * The Rust compiler replaces {{PLACEHOLDERS}} with generated code.
+ *
+ * Navigation works via schema-driven NavigationProvider:
+ * - NavigationProvider holds active page state
+ * - navigateTo() switches pages and fires INIT with payload
+ * - No dependency on react-router for internal navigation
+ * - react-router is optional for URL bookmarkability
+ */
+
+import { BrowserRouter, Routes, Route } from 'react-router-dom';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ThemeProvider, UISlotProvider } from '@almadar/ui/context';
+import { UISlotComponent, NotifyListener } from '@almadar/ui/components';
+import {
+  EventBusProvider,
+  VerificationProvider,
+} from '@almadar/ui/providers';
+import { NavigationProvider } from '@almadar/ui/renderer';
+import { I18nProvider, createTranslate } from '@almadar/ui/hooks';
+import defaultLocale from '@almadar/ui/locales/en.json';
+
+// {{GENERATED_I18N_IMPORT}}
+// {{GENERATED_IMPORTS}}
+
+// Generated schema import (compiler fills this in)
+// {{GENERATED_SCHEMA_IMPORT}}
+const schema = { name: 'app', orbitals: [] }; // Placeholder - replaced by compiler
+
+// {{GENERATED_I18N_VALUE}}
+const { $meta: defaultMeta, ...defaultMessages } = defaultLocale;
+const i18nValue = { locale: defaultMeta?.locale ?? 'en', direction: (defaultMeta?.direction ?? 'ltr') as 'ltr' | 'rtl', t: createTranslate(defaultMessages) };
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      staleTime: 1000 * 60,
+      refetchOnWindowFocus: false,
+    },
+  },
+});
+
+function App() {
+  return (
+    <I18nProvider value={i18nValue}>
+    <QueryClientProvider client={queryClient}>
+      <ThemeProvider defaultTheme="minimalist">
+        <EventBusProvider>
+          <VerificationProvider>
+            <UISlotProvider>
+              <NavigationProvider
+                schema={schema}
+                updateUrl={true}
+                onNavigate={(pageName, path, payload) => {
+                  console.log('[App] Navigation:', { pageName, path, payload });
+                }}
+              >
+                <BrowserRouter>
+                  <Routes>
+                    {/* {{GENERATED_ROUTES}} */}
+                    <Route path="/" element={<div>Welcome to Almadar</div>} />
+                  </Routes>
+                  {/* Portal slots rendered by compiled trait views via CompiledPortal */}
+                  {/* Toast notifications (non-overlapping, always safe to render here) */}
+                  <UISlotComponent slot="toast" portal />
+                  <NotifyListener />
+                </BrowserRouter>
+              </NavigationProvider>
+            </UISlotProvider>
+          </VerificationProvider>
+        </EventBusProvider>
+      </ThemeProvider>
+    </QueryClientProvider>
+    </I18nProvider>
+  );
+}
+
+export default App;