@almadar/orb 6.3.0 → 6.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/orb",
-  "version": "6.3.0",
+  "version": "6.4.0",
   "description": "Orb CLI - deterministic when it can be, intelligent when it needs to be",
   "license": "BSL-1.1",
   "repository": {
@@ -49,10 +49,10 @@
     "node": ">=16.0.0"
   },
   "optionalDependencies": {
-    "@almadar/orb-darwin-x64": "6.3.0",
-    "@almadar/orb-darwin-arm64": "6.3.0",
-    "@almadar/orb-linux-x64": "6.3.0",
-    "@almadar/orb-linux-arm64": "6.3.0",
-    "@almadar/orb-windows-x64": "6.3.0"
+    "@almadar/orb-darwin-x64": "6.4.0",
+    "@almadar/orb-darwin-arm64": "6.4.0",
+    "@almadar/orb-linux-x64": "6.4.0",
+    "@almadar/orb-linux-arm64": "6.4.0",
+    "@almadar/orb-windows-x64": "6.4.0"
   }
 }

package/shells/almadar-shell/LICENSE

@@ -0,0 +1,72 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Almadar FZE
+Licensed Work:        KFlow Builder / Almadar
+                      The Licensed Work is (c) 2025-2026 Almadar FZE.
+Additional Use Grant: You may make production use of the Licensed Work for
+                      non-commercial purposes and for internal evaluation.
+                      Production use for commercial purposes requires a
+                      commercial license from the Licensor.
+Change Date:          2030-02-01
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+---
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+ADDITIONAL TERMS:
+
+Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
+
+TRADEMARKS:
+
+"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
+Almadar FZE. You may not use these trademarks without prior written
+permission from Almadar FZE.
+
+For licensing inquiries: licensing@almadar.io

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
+
+BSL 1.1 (Business Source License). Converts to Apache 2.0 on 2030-02-01. Non-production use is free.

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,35 @@
+{
+  "name": "@almadar/shell",
+  "version": "2.6.2",
+  "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"
+    }
+  },
+  "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,61 @@
+{
+  "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.47.0",
+    "@almadar/syntax": ">=1.2.1",
+    "@almadar/evaluator": ">=2.6.0",
+    "@almadar/patterns": ">=2.10.0",
+    "@almadar/core": ">=2.9.1",
+    "firebase": "^11.4.0",
+    "@tanstack/react-query": "^5.67.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "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",
+    "three": "^0.160.0",
+    "@react-three/fiber": "^9.0.0",
+    "@react-three/drei": "^9.92.0",
+    "@react-three/postprocessing": "^3.0.0",
+    "postprocessing": "^6.39.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": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@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,84 @@
+/**
+ * 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 {
+  EntityStoreProvider,
+  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>
+        <EntityStoreProvider>
+        <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>
+        </EntityStoreProvider>
+      </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 };

package/shells/almadar-shell/packages/client/src/features/auth/AuthContext.tsx

@@ -0,0 +1,139 @@
+import React, { createContext, useContext, useEffect, useState } from 'react';
+import { User } from 'firebase/auth';
+import { auth, initializeFirebase } from '../../config/firebase';
+import { authService } from './authService';
+import { AuthContextType } from './types';
+
+const AuthContext = createContext<AuthContextType | undefined>(undefined);
+
+export const useAuthContext = () => {
+  const context = useContext(AuthContext);
+  if (context === undefined) {
+    throw new Error('useAuthContext must be used within an AuthProvider');
+  }
+  return context;
+};
+
+interface AuthProviderProps {
+  children: React.ReactNode;
+}
+
+export const AuthProvider: React.FC<AuthProviderProps> = ({ children }) => {
+  const [user, setUser] = useState<User | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let unsubscribe: (() => void) | undefined;
+
+    initializeFirebase().then(() => {
+      unsubscribe = auth.onAuthStateChanged((firebaseUser) => {
+        setUser(firebaseUser);
+        setLoading(false);
+      });
+    });
+
+    return () => unsubscribe?.();
+  }, []);
+
+  const clearError = () => setError(null);
+
+  const signInWithGoogle = async () => {
+    try {
+      setLoading(true);
+      clearError();
+      await authService.signInWithGoogle();
+    } catch (err: unknown) {
+      setLoading(false);
+      const firebaseErr = err as { code?: string; message?: string };
+      const isCancel =
+        firebaseErr.code === 'auth/popup-closed-by-user' ||
+        firebaseErr.code === 'auth/cancelled-popup-request' ||
+        firebaseErr.code === 'auth/popup-blocked';
+      if (!isCancel) {
+        setError(firebaseErr.message ?? 'Google sign-in failed');
+      }
+    }
+  };
+
+  const signInWithEmail = async (email: string, password: string) => {
+    try {
+      setLoading(true);
+      clearError();
+      await authService.signInWithEmail(email, password);
+    } catch (err: unknown) {
+      setLoading(false);
+      setError((err as { message?: string }).message ?? 'Sign-in failed');
+    }
+  };
+
+  const signUpWithEmail = async (email: string, password: string, displayName?: string) => {
+    try {
+      setLoading(true);
+      clearError();
+      await authService.signUpWithEmail(email, password, displayName);
+    } catch (err: unknown) {
+      setLoading(false);
+      setError((err as { message?: string }).message ?? 'Sign-up failed');
+    }
+  };
+
+  const sendSignInLinkToEmail = async (email: string) => {
+    try {
+      setLoading(true);
+      clearError();
+      const actionCodeSettings = {
+        url: `${window.location.origin}/login`,
+        handleCodeInApp: true,
+      };
+      await authService.sendSignInLinkToEmail(email, actionCodeSettings);
+      setLoading(false);
+    } catch (err: unknown) {
+      setLoading(false);
+      setError((err as { message?: string }).message ?? 'Failed to send sign-in link');
+    }
+  };
+
+  const signInWithEmailLink = async (email: string, emailLink: string) => {
+    try {
+      setLoading(true);
+      clearError();
+      await authService.signInWithEmailLink(email, emailLink);
+    } catch (err: unknown) {
+      setLoading(false);
+      setError((err as { message?: string }).message ?? 'Email link sign-in failed');
+    }
+  };
+
+  const isSignInWithEmailLink = (emailLink: string): boolean => {
+    return authService.isSignInWithEmailLink(emailLink);
+  };
+
+  const signOut = async () => {
+    try {
+      setLoading(true);
+      await authService.signOut();
+      setUser(null);
+      setLoading(false);
+    } catch (err: unknown) {
+      setLoading(false);
+      setError((err as { message?: string }).message ?? 'Sign-out failed');
+    }
+  };
+
+  const value: AuthContextType = {
+    user,
+    loading,
+    error,
+    signInWithGoogle,
+    signOut,
+    signInWithEmail,
+    signUpWithEmail,
+    sendSignInLinkToEmail,
+    signInWithEmailLink,
+    isSignInWithEmailLink,
+    clearError,
+  };
+
+  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
+};