@almadar/orb 0.2.0

package/README.md

@@ -0,0 +1,83 @@
+# @almadar/orb
+
+Orb CLI — compile .orb programs to full-stack applications.
+
+## Installation
+
+```bash
+npm install -g @almadar/orb
+```
+
+Or use the curl installer:
+
+```bash
+curl -fsSL https://orb.almadar.io/install.sh | sh
+```
+
+## Usage
+
+```bash
+# Validate an .orb file (0 errors, 0 warnings required)
+orbital validate app.orb
+
+# Lower .lolo syntax to .orb JSON IR
+orbital emit-orb app.orb
+
+# Compile to TypeScript shell
+orbital compile app.orb --shell typescript
+
+# Start development server
+orbital dev app.orb
+```
+
+## Quick Example
+
+```lolo
+orbital TaskApp {
+  entity Task [persistent: tasks] {
+    id     : string!
+    title  : string!
+    status : string = "pending"
+  }
+
+  trait TaskBrowser -> Task [interaction] {
+    state browsing {
+      INIT -> browsing
+        (fetch Task)
+        (render-ui main { type: "entity-table", entity: "Task", fields: ["title", "status"] })
+      CREATE -> creating
+        (render-ui modal { type: "modal", isOpen: true, title: "New Task",
+          children: [{ type: "form-section", entity: "Task", fields: ["title", "status"], mode: "create" }] })
+    }
+    state creating {
+      SAVE -> browsing
+        (persist create Task @payload.data)
+        (render-ui modal null)
+      CANCEL -> browsing
+        (render-ui modal null)
+    }
+  }
+
+  page "/tasks" -> TaskBrowser
+}
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `orbital validate <file>` | Validate an .orb file |
+| `orbital emit-orb <file>` | Lower .lolo to .orb JSON (stdout) |
+| `orbital compile <file>` | Compile to generated code |
+| `orbital dev <file>` | Start development server |
+| `orbital new <name>` | Create a new project |
+
+## Documentation
+
+- [Getting Started](https://orb.almadar.io/docs/getting-started/introduction)
+- [CLI Reference](https://orb.almadar.io/docs/reference/cli)
+- [Language Reference](https://orb.almadar.io/docs/core-concepts/entities)
+
+## License
+
+BSL 1.1

package/bin/orb

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const BINARY_NAME = process.platform === 'win32' ? 'orb.exe' : 'orb';
+
+function getBinaryPath() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  const platformMap = {
+    'darwin-x64': '@almadar/orb-darwin-x64',
+    'darwin-arm64': '@almadar/orb-darwin-arm64',
+    'linux-x64': '@almadar/orb-linux-x64',
+    'linux-arm64': '@almadar/orb-linux-arm64',
+    'win32-x64': '@almadar/orb-windows-x64',
+  };
+
+  const key = `${platform}-${arch}`;
+  const packageName = platformMap[key];
+
+  if (!packageName) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('Supported: darwin-x64, darwin-arm64, linux-x64, linux-arm64, win32-x64');
+    process.exit(1);
+  }
+
+  const possiblePaths = [
+    path.join(__dirname, '..', 'node_modules', packageName, BINARY_NAME),
+    path.join(__dirname, '..', '..', packageName, BINARY_NAME),
+    path.join(__dirname, '..', '..', '..', packageName, BINARY_NAME),
+  ];
+
+  for (const binaryPath of possiblePaths) {
+    if (fs.existsSync(binaryPath)) {
+      return { binaryPath, platformDir: path.dirname(binaryPath) };
+    }
+  }
+
+  console.error(`Could not find Orb binary for ${platform}-${arch}`);
+  console.error('Try reinstalling: npm install -g @almadar/orb');
+  process.exit(1);
+}
+
+function getShellsDir() {
+  if (process.env.ORBITAL_SHELLS_DIR) {
+    return process.env.ORBITAL_SHELLS_DIR;
+  }
+
+  const possiblePaths = [
+    path.join(__dirname, '..', 'shells'),
+    path.join(__dirname, '..', '..', '@almadar', 'orb', 'shells'),
+  ];
+
+  for (const shellsPath of possiblePaths) {
+    if (fs.existsSync(shellsPath) && (
+      fs.existsSync(path.join(shellsPath, 'almadar-shell')) ||
+      fs.existsSync(path.join(shellsPath, 'typescript-shell'))
+    )) {
+      return shellsPath;
+    }
+  }
+
+  return null;
+}
+
+const { binaryPath, platformDir } = getBinaryPath();
+const shellsDir = getShellsDir();
+
+const env = { ...process.env };
+
+if (shellsDir) {
+  env.ORBITAL_SHELLS_DIR = shellsDir;
+}
+
+// Bun runtime (sibling to Rust binary in platform package)
+const bunName = process.platform === 'win32' ? 'bun.exe' : 'bun';
+const bunPath = path.join(platformDir, bunName);
+if (fs.existsSync(bunPath)) {
+  env.ORB_BUN_PATH = bunPath;
+}
+
+// Agent dist (agent/ directory in platform package)
+const agentDir = path.join(platformDir, 'agent');
+if (fs.existsSync(agentDir)) {
+  env.ORB_AGENT_DIR = agentDir;
+}
+
+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": "0.2.0",
+  "description": "Orb CLI - deterministic when it can be, intelligent when it needs to be",
+  "license": "BSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/almadar-io/orb.git",
+    "directory": "cli/npm"
+  },
+  "homepage": "https://orb.almadar.io",
+  "bugs": {
+    "url": "https://github.com/almadar-io/orb/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": "0.2.0",
+    "@almadar/orb-darwin-arm64": "0.2.0",
+    "@almadar/orb-linux-x64": "0.2.0",
+    "@almadar/orb-linux-arm64": "0.2.0",
+    "@almadar/orb-windows-x64": "0.2.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,51 @@
+#!/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/orb-darwin-x64',
+  'darwin-arm64': '@almadar/orb-darwin-arm64',
+  'linux-x64': '@almadar/orb-linux-x64',
+  'linux-arm64': '@almadar/orb-linux-arm64',
+  'win32-x64': '@almadar/orb-windows-x64',
+};
+
+const key = `${platform}-${arch}`;
+const packageName = platformMap[key];
+
+if (!packageName) {
+  console.warn(`\n  Orb CLI: No pre-built binary for ${platform}-${arch}`);
+  console.warn('  Build from source: https://github.com/almadar-io/orb#building-from-source\n');
+  process.exit(0);
+}
+
+const possiblePaths = [
+  path.join(__dirname, '..', 'node_modules', packageName),
+  path.join(__dirname, '..', '..', packageName),
+  path.join(__dirname, '..', '..', '..', packageName),
+];
+
+const platformDir = possiblePaths.find(p => fs.existsSync(p));
+
+if (!platformDir) {
+  console.warn(`\n  Orb CLI: Platform package ${packageName} not found`);
+  console.warn('  Try: npm install -g @almadar/orb --include=optional\n');
+  process.exit(0);
+}
+
+// Verify components
+const binaryName = platform === 'win32' ? 'orb.exe' : 'orb';
+const bunName = platform === 'win32' ? 'bun.exe' : 'bun';
+
+const hasBinary = fs.existsSync(path.join(platformDir, binaryName));
+const hasBun = fs.existsSync(path.join(platformDir, bunName));
+const hasAgent = fs.existsSync(path.join(platformDir, 'agent', 'cli.js'));
+
+console.log(`Orb CLI installed for ${platform}-${arch}:`);
+console.log(`  Binary:  ${hasBinary ? 'ok' : 'missing'}`);
+console.log(`  Bun:     ${hasBun ? 'ok' : 'not bundled (agent features require bun on PATH)'}`);
+console.log(`  Agent:   ${hasAgent ? 'ok' : 'not bundled (agent features unavailable)'}`);

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.10.0",
+  "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": ">=4.30.0",
+    "@almadar/syntax": ">=1.4.0",
+    "@almadar/evaluator": ">=2.9.2",
+    "@almadar/patterns": ">=2.21.0",
+    "@almadar/core": ">=7.12.0",
+    "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.8.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: {},
+  },
+}