@almadar/orb 1.9.4

package/README.md

@@ -0,0 +1,45 @@
+# @almadar/cli
+
+Almadar CLI - Compile Almadar schemas to full-stack applications.
+
+## Installation
+
+```bash
+npm install -g @almadar/cli
+```
+
+## Usage
+
+```bash
+# Validate a schema
+almadar validate schema.orb
+
+# Compile to TypeScript (React + Express)
+almadar compile schema.orb --shell typescript
+
+# Compile to Python (FastAPI + PyTorch)
+almadar compile schema.orb --shell python
+
+# Start development server
+almadar dev schema.orb
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `almadar validate <file>` | Validate an Almadar schema |
+| `almadar parse <file>` | Parse and display schema information |
+| `almadar compile <file>` | Compile schema to generated code |
+| `almadar serve <file>` | Start the Almadar server runtime |
+| `almadar gui <file>` | Start the Almadar desktop GUI |
+| `almadar dev <file>` | Start both server and client (dev mode) |
+
+## Documentation
+
+- [Getting Started](https://almadar.io/docs/en/getting-started)
+- [CLI Reference](https://almadar.io/docs/en/reference/cli)
+
+## License
+
+MIT

package/bin/almadar

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const BINARY_NAME = process.platform === 'win32' ? 'almadar.exe' : 'almadar';
+
+function getBinaryPath() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  // Map Node.js platform/arch to package names
+  const platformMap = {
+    'darwin-x64': '@almadar/cli-darwin-x64',
+    'darwin-arm64': '@almadar/cli-darwin-arm64',
+    'linux-x64': '@almadar/cli-linux-x64',
+    'linux-arm64': '@almadar/cli-linux-arm64',
+    'win32-x64': '@almadar/cli-windows-x64',
+  };
+
+  const key = `${platform}-${arch}`;
+  const packageName = platformMap[key];
+
+  if (!packageName) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('Supported platforms: darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64');
+    process.exit(1);
+  }
+
+  // Try to find the binary in node_modules
+  const possiblePaths = [
+    // Installed as dependency
+    path.join(__dirname, '..', 'node_modules', packageName, BINARY_NAME),
+    // Hoisted to parent node_modules
+    path.join(__dirname, '..', '..', packageName, BINARY_NAME),
+    // Global install
+    path.join(__dirname, '..', '..', '..', packageName, BINARY_NAME),
+  ];
+
+  for (const binaryPath of possiblePaths) {
+    if (fs.existsSync(binaryPath)) {
+      return binaryPath;
+    }
+  }
+
+  console.error(`Could not find Almadar binary for ${platform}-${arch}`);
+  console.error('Please try reinstalling: npm install -g @almadar/cli');
+  process.exit(1);
+}
+
+function getShellsDir() {
+  // If user has set ORBITAL_SHELLS_DIR, respect it
+  if (process.env.ORBITAL_SHELLS_DIR) {
+    return process.env.ORBITAL_SHELLS_DIR;
+  }
+
+  // Look for shells bundled with this package
+  const possiblePaths = [
+    // Shells in same package
+    path.join(__dirname, '..', 'shells'),
+    // Global install - shells might be one level up
+    path.join(__dirname, '..', '..', '@almadar', 'cli', 'shells'),
+  ];
+
+  for (const shellsPath of possiblePaths) {
+    if (fs.existsSync(shellsPath) && fs.existsSync(path.join(shellsPath, 'typescript-shell'))) {
+      return shellsPath;
+    }
+  }
+
+  // No bundled shells found - binary will use its fallback or error
+  return null;
+}
+
+const binaryPath = getBinaryPath();
+const shellsDir = getShellsDir();
+
+// Build environment with ORBITAL_SHELLS_DIR if we found shells
+const env = { ...process.env };
+if (shellsDir) {
+  env.ORBITAL_SHELLS_DIR = shellsDir;
+}
+
+try {
+  execFileSync(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    env: env,
+  });
+} catch (error) {
+  if (error.status !== undefined) {
+    process.exit(error.status);
+  }
+  throw error;
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@almadar/orb",
+  "version": "1.9.4",
+  "description": "Orb CLI - Compile Orbital schemas to full-stack applications",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/almadar-io/almadar.git",
+    "directory": "cli/npm"
+  },
+  "homepage": "https://orb.almadar.io",
+  "bugs": {
+    "url": "https://github.com/almadar-io/almadar/issues"
+  },
+  "keywords": [
+    "orb",
+    "orbital",
+    "cli",
+    "compiler",
+    "codegen",
+    "full-stack",
+    "react",
+    "typescript",
+    "python",
+    "fastapi"
+  ],
+  "bin": {
+    "orb": "bin/orb"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "shells",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "optionalDependencies": {
+    "@almadar/orb-darwin-x64": "1.9.4",
+    "@almadar/orb-darwin-arm64": "1.9.4",
+    "@almadar/orb-linux-x64": "1.9.4",
+    "@almadar/orb-linux-arm64": "1.9.4",
+    "@almadar/orb-windows-x64": "1.9.4"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const platform = process.platform;
+const arch = process.arch;
+
+const platformMap = {
+  'darwin-x64': '@almadar/cli-darwin-x64',
+  'darwin-arm64': '@almadar/cli-darwin-arm64',
+  'linux-x64': '@almadar/cli-linux-x64',
+  'linux-arm64': '@almadar/cli-linux-arm64',
+  'win32-x64': '@almadar/cli-windows-x64',
+};
+
+const key = `${platform}-${arch}`;
+const packageName = platformMap[key];
+
+if (!packageName) {
+  console.warn(`\n⚠️  Almadar CLI: No pre-built binary for ${platform}-${arch}`);
+  console.warn('   You can build from source: https://github.com/almadar-io/almadar#building-from-source\n');
+  process.exit(0);
+}
+
+// Check if the platform-specific package was installed
+const possiblePaths = [
+  path.join(__dirname, '..', 'node_modules', packageName),
+  path.join(__dirname, '..', '..', packageName),
+  path.join(__dirname, '..', '..', '..', packageName),
+];
+
+const found = possiblePaths.some(p => fs.existsSync(p));
+
+if (found) {
+  console.log(`✅ Almadar CLI installed for ${platform}-${arch}`);
+} else {
+  console.warn(`\n⚠️  Almadar CLI: Platform package ${packageName} not found`);
+  console.warn('   This may happen if optional dependencies were skipped.');
+  console.warn('   Try: npm install -g @almadar/cli --include=optional\n');
+}

package/shells/almadar-shell/LICENSE

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

package/shells/almadar-shell/README.md

@@ -0,0 +1,25 @@
+# @almadar/shell
+
+> Minimal full-stack shell template for Almadar applications
+
+Part of the [Almadar](https://github.com/almadar-io/almadar) platform.
+
+## Installation
+
+```bash
+npm install @almadar/shell
+```
+
+## Usage
+
+```typescript
+import { /* ... */ } from '@almadar/shell';
+```
+
+## API
+
+<!-- Document public exports here -->
+
+## License
+
+MIT

package/shells/almadar-shell/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/shells/almadar-shell/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@almadar/shell",
+  "version": "2.1.3",
+  "private": true,
+  "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 config core.hooksPath .githooks"
+  },
+  "devDependencies": {
+    "concurrently": "^8.2.0",
+    "turbo": "^2.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/almadar-io/almadar-shell.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

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

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

package/shells/almadar-shell/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/shells/almadar-shell/packages/client/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@almadar/shell-client",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc && vite build",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/",
+    "preview": "vite preview",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@almadar/ui": "^2.6.0",
+    "@almadar/evaluator": "^2.0.0",
+    "@almadar/patterns": "^2.0.0",
+    "@almadar/core": "^2.1.0",
+    "firebase": "^11.4.0",
+    "@tanstack/react-query": "^5.67.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-router-dom": "^7.3.0",
+    "zustand": "^5.0.3",
+    "react-markdown": "^9.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "rehype-katex": "^7.0.1",
+    "rehype-raw": "^7.0.0",
+    "react-force-graph-2d": "^1.25.5",
+    "@monaco-editor/react": "^4.7.0",
+    "monaco-editor": "^0.52.2",
+    "leaflet": "^1.9.4",
+    "react-leaflet": "^4.2.1",
+    "lucide-react": "^0.344.0"
+  },
+  "devDependencies": {
+    "@almadar/eslint-plugin": ">=2.3.0",
+    "@typescript-eslint/parser": "8.56.0",
+    "eslint": "10.0.0",
+    "@testing-library/react": "^16.1.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@types/react": "^18.3.18",
+    "@types/react-dom": "^18.3.5",
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.20",
+    "jsdom": "^25.0.1",
+    "postcss": "^8.5.3",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.1",
+    "vitest": "^2.1.9"
+  }
+}

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

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

package/shells/almadar-shell/packages/client/src/App.tsx

@@ -0,0 +1,79 @@
+/**
+ * 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';
+
+// {{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 i18nValue = { locale: 'en', direction: 'ltr' as const, t: createTranslate({}) };
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      staleTime: 1000 * 60,
+      refetchOnWindowFocus: false,
+    },
+  },
+});
+
+function App() {
+  return (
+    <I18nProvider value={i18nValue}>
+    <QueryClientProvider client={queryClient}>
+      <ThemeProvider>
+        <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;

package/shells/almadar-shell/packages/client/src/config/firebase.ts

@@ -0,0 +1,37 @@
+import { initializeApp, getApps, getApp, FirebaseApp } from 'firebase/app';
+import { getAuth, Auth } from 'firebase/auth';
+
+let app: FirebaseApp;
+let auth: Auth;
+
+export async function initializeFirebase(): Promise<void> {
+  if (getApps().length > 0) {
+    app = getApp();
+    auth = getAuth(app);
+    return;
+  }
+
+  let config;
+  try {
+    // On Firebase Hosting, fetch auto-config from reserved URL
+    const res = await fetch('/__/firebase/init.json');
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    config = await res.json();
+  } catch {
+    // Fall back to env vars for local development
+    config = {
+      apiKey: import.meta.env.VITE_APP_FIREBASE_API_KEY,
+      authDomain: import.meta.env.VITE_APP_FIREBASE_AUTH_DOMAIN,
+      projectId: import.meta.env.VITE_APP_FIREBASE_PROJECT_ID,
+      storageBucket: import.meta.env.VITE_APP_FIREBASE_STORAGE_BUCKET,
+      messagingSenderId: import.meta.env.VITE_APP_FIREBASE_MESSAGING_SENDER_ID,
+      appId: import.meta.env.VITE_APP_FIREBASE_APP_ID,
+      measurementId: import.meta.env.VITE_APP_FIREBASE_MEASUREMENT_ID,
+    };
+  }
+
+  app = initializeApp(config);
+  auth = getAuth(app);
+}
+
+export { auth, app };