Ether's Almanac

.gitignore

@@ -2,9 +2,9 @@
 ./external
 
 # orbitmines.com
+orbitmines.com/.next
 orbitmines.com/node_modules
 orbitmines.com/build
-orbitmines.com/.next
 
 # Environment
 **/.idea

README.md

@@ -33,7 +33,7 @@ git clone git@github.com:orbitmines/orbitmines.com.git # Website to the internet
     npm install
     ```
   - ```
-    npm start
+    npm run dev
     ```
 
 ---

orbitmines.com.ray/Almanac.ray

@@ -0,0 +1 @@
+Almanac = Book("almanac")

orbitmines.com.ray/Article.ray

@@ -0,0 +1,8 @@
+class Article (name: String) < name
+
+class Book < Article
+
+class Profile < Article
+
+class Author
+

orbitmines.com.ray/archive/2025.TowardsAUniversalLanguage.ray

@@ -0,0 +1 @@
+Article("towards-a-universal-language")

orbitmines.com.ray/index.ray

@@ -0,0 +1,35 @@
+orbitmines.com() if &entrypoint
+
+class orbitmines.com < Interface
+  { url } = Browser
+
+  url.path.match
+    ⊢"/profiles/", x: Profile$, "/"? =>
+    ⊢"/archive/", x: Article$, "/"? =>
+    "/almanac" => Almanac()
+    "/thumbnail" =>
+
+    ⊢"/papers/", x => url.path = "/archive/", x
+
+    * => Index()
+
+class Index
+  articles: Article[] =
+    "towards-a-universal-language",
+    "2024-02-orbitmines-as-a-game-project",
+    "on-orbits-equivalence-and-inconsistencies",
+    "on-intelligibility"
+
+  Center
+    100% * Center{width <= 1240px}(
+      End(DownloadButton(), LoginButton()).map(& px 5)
+    )
+    100% * Center Image{width <= 400px}(./lib/organizations/orbitmines/logo.png, width: 90%)
+    100% * Center
+      (xl 4/12 lg 6/12 md 8/12 sm 10/12 xs 12/12) * Center "Once a Minecraft server, now the building of a world where engineering, science, education are all an exploratory videogame.".italic
+    100% * Center + pt 5 (@orbitmines.avatars.map => Link .location{: URL} => .platform.profile_picture).map(& px 2)
+    100% * Center Image{height == 120px} ./archive/on-orbits-equivalence-and-inconsistencies/images/header.png
+    100% * Center
+      X{width <= 500px}
+      X{width <= 500px}
+    100% * Author(@fadi, margin.top: 5%)

orbitmines.com.ray/organizations.ray

@@ -0,0 +1,19 @@
+
+@orbitmines = Organization(
+  avatars:
+    // These two would have to be registered under the orbitmines organization
+    | @"fadi.shawki@orbitmines.com" = Avatar()
+    | @"discord.orbitmines.com" = Avatar(@: "https://discord.orbitmines.com")
+
+    | @github.@orbitmines = Avatar(@: "https://github.com/orbitmines")
+    | @x.@OrbitMines = Avatar(@: "https://x.com/OrbitMines")
+    | @instagram.@orbitmines = Avatar(@: "https://www.instagram.com/orbitmines/")
+    | @youtube.@OrbitMines = Avatar(@: "https://www.youtube.com/@OrbitMines")
+    | @twitch.@orbitmines = Avatar(@: "https://www.twitch.tv/orbitmines")
+    | @linkedin.@orbitmines = Avatar(@: "https://www.linkedin.com/company/orbitmines/")
+    //| @gitlab.@orbitmines = Avatar(@: "https://gitlab.com/orbitmines") //TODO This would be set to private since it's not in use
+    | @facebook.@OrbitMines = Avatar(@: "https://www.facebook.com/profile.php?id=61550528503885")
+  profile_picture: ./lib/organizations/orbitmines/icon/orbitmines.icon.650x650.png
+)
+
+// TODO All the organizations

orbitmines.com.ray/profiles/fadi-shawki.ray

@@ -0,0 +1 @@
+Profile("fadi-shawki")

orbitmines.com/app/Providers.tsx

@@ -0,0 +1,38 @@
+'use client';
+
+import React from 'react';
+import { HotkeysProvider } from '@blueprintjs/core';
+import { EtherOverlay } from '../src/@ether/UI';
+import IEventListener from '../src/@orbitmines/js/react/IEventListener';
+import Modules from '../src/@orbitmines/js/react/Modules';
+
+const Metadata: React.FC<{ children?: React.ReactNode }> = ({ children }) => (
+  <>
+    <meta property="og:site_name" content="OrbitMines" />
+    {/* https://developer.twitter.com/en/docs/twitter-for-websites/cards/overview/abouts-cards */}
+    <meta property="twitter:site" content="@OrbitMines" />
+    {children}
+  </>
+);
+
+const Providers: React.FC<{ children?: React.ReactNode }> = ({ children }) => {
+  const listener: IEventListener<any> = {
+    onKeyDown: (event): void => {
+      console.log(event.key);
+    },
+  };
+
+  return (
+    <Metadata>
+      {/* HotkeysProvider: https://blueprintjs.com/docs/#core/context/hotkeys-provider */}
+      <HotkeysProvider>
+        <Modules className="bp5-dark" listeners={[listener]}>
+          {children}
+          <EtherOverlay />
+        </Modules>
+      </HotkeysProvider>
+    </Metadata>
+  );
+};
+
+export default Providers;

orbitmines.com/app/[...path]/CatchAllClient.tsx

@@ -0,0 +1,7 @@
+'use client';
+
+import EtherOrMinimap from '../../src/@ether/UI/router/EtherOrMinimap';
+
+export default function CatchAllClient() {
+  return <EtherOrMinimap />;
+}

orbitmines.com/app/[...path]/page.tsx

@@ -0,0 +1,14 @@
+import CatchAllClient from './CatchAllClient';
+import { PROFILE_NAMES } from '../profiles/[profile]/page';
+export function generateStaticParams() {
+  return [
+    { path: ['_catchall'] },
+    ...Object.keys(PROFILE_NAMES).map((handle) => ({ path: [`@${handle}`] })),
+  ];
+}
+
+export const dynamicParams = false;
+
+export default function Page() {
+  return <CatchAllClient />;
+}

orbitmines.com/app/almanac/[[...section]]/AlmanacClient.tsx

@@ -0,0 +1,7 @@
+'use client';
+
+import Almanac from '../../../src/routes/Almanac';
+
+export default function AlmanacClient() {
+  return <Almanac />;
+}

orbitmines.com/app/almanac/[[...section]]/page.tsx

@@ -0,0 +1,53 @@
+import type {Metadata} from 'next';
+import fs from 'fs';
+import path from 'path';
+import {sectionSlug} from '../../../src/lib/post/sectionSlug';
+import AlmanacClient from './AlmanacClient';
+
+const BOOK_TITLE = "Ether's Almanac";
+
+// Sections live in the path (/almanac/<section-slug>) as client-side shallow
+// routes within the book. Every section is prerendered as its own URL so that
+// dev (next dev) and the production static export both serve them — and direct
+// loads / refreshes don't 404.
+//
+// The section list is derived from the Almanac source at build time (string
+// `head="..."` props are exactly the navigable sections, matching BookUtil), so
+// it stays in sync automatically rather than via a hand-kept manifest. We keep
+// the heading text too, so generateMetadata can title each section URL as
+// "Ether's Almanac - <Section>" for search engines.
+export function almanacSections(): {slug: string; head: string}[] {
+  const src = fs.readFileSync(
+    path.join(process.cwd(), 'src/routes/Almanac.tsx'),
+    'utf8',
+  );
+  const heads = [...src.matchAll(/<(?:Arc|Section)\s+head="([^"]+)"/g)].map((m) => m[1]);
+  const bySlug = new Map<string, string>();
+  for (const head of heads) {
+    const slug = sectionSlug(head);
+    if (slug && !bySlug.has(slug)) bySlug.set(slug, head);
+  }
+  return [...bySlug].map(([slug, head]) => ({slug, head}));
+}
+
+export function generateStaticParams() {
+  return [
+    {section: [] as string[]},
+    ...almanacSections().map(({slug}) => ({section: [slug]})),
+  ];
+}
+
+export const dynamicParams = false;
+
+export async function generateMetadata(
+  {params}: {params: Promise<{section?: string[]}>},
+): Promise<Metadata> {
+  const slug = (await params).section?.[0];
+  if (!slug) return {title: BOOK_TITLE};
+  const head = almanacSections().find((s) => s.slug === slug)?.head;
+  return {title: head ? `${BOOK_TITLE} - ${head.trim()}` : BOOK_TITLE};
+}
+
+export default function Page() {
+  return <AlmanacClient />;
+}

orbitmines.com/app/archive/[item]/ArchiveClient.tsx

@@ -0,0 +1,7 @@
+'use client';
+
+import Archive from '../../../src/routes/Archive';
+
+export default function ArchiveClient() {
+  return <Archive />;
+}

orbitmines.com/app/archive/[item]/page.tsx

@@ -0,0 +1,43 @@
+import type { Metadata } from 'next';
+import fs from 'fs';
+import path from 'path';
+import ArchiveClient from './ArchiveClient';
+
+// Each archive slug maps to its source component (mirrors ITEMS in
+// src/routes/Archive.tsx). The page title is read from that file's first
+// `title: "..."` literal at build time, so titles stay in sync with the source
+// rather than being hand-duplicated here.
+export const ITEM_SOURCES: Record<string, string> = {
+  '2024-02-orbitmines-as-a-game-project': 'src/routes/archive/2024.02.OrbitMines_as_a_Game_Project.tsx',
+  'on-intelligibility': 'src/routes/archive/2022.OnIntelligibility.tsx',
+  'on-orbits-equivalence-and-inconsistencies': 'src/routes/archive/2023.OnOrbits.tsx',
+  'towards-a-universal-language': 'src/routes/archive/2025.TowardsAUniversalLanguage.tsx',
+  'the-orbitmines-minecraft-server': 'src/routes/archive/2026.MinecraftArchive.tsx',
+};
+
+// Reads the reference object's `title` literal so the static <title> is owned
+// by Next metadata. The description is rendered by the paper itself (Post),
+// so it isn't duplicated here.
+function itemTitle(item: string): string | undefined {
+  const source = ITEM_SOURCES[item];
+  if (!source) return undefined;
+  const src = fs.readFileSync(path.join(process.cwd(), source), 'utf8');
+  return src.match(/title:\s*"((?:[^"\\]|\\.)*)"/)?.[1];
+}
+
+export function generateStaticParams() {
+  return Object.keys(ITEM_SOURCES).map((item) => ({ item }));
+}
+
+export const dynamicParams = false;
+
+export async function generateMetadata(
+  { params }: { params: Promise<{ item: string }> },
+): Promise<Metadata> {
+  const title = itemTitle((await params).item);
+  return title ? { title } : {};
+}
+
+export default function Page() {
+  return <ArchiveClient />;
+}

orbitmines.com/app/layout.tsx

@@ -0,0 +1,36 @@
+import type { Metadata, Viewport } from 'next';
+import '../src/lib/blueprintjs/css/blueprint.css';
+import '../src/lib/blueprintjs/css/blueprint-icons.css';
+import '../src/lib/index.scss';
+import Providers from './Providers';
+
+export const metadata: Metadata = {
+  // Per-page <meta name="description"> is rendered by each page's content
+  // (Post/Minimap/profile) so it can be section/paper-specific; no global
+  // default here, which would otherwise duplicate or override those.
+  title: 'OrbitMines Research',
+  manifest: '/manifest.json',
+  icons: {
+    icon: [{ url: '/favicon.png', type: 'image/png', sizes: '64x64' }],
+    apple: '/logo192.png',
+  },
+};
+
+export const viewport: Viewport = {
+  width: 'device-width',
+  initialScale: 1,
+  themeColor: '#000000',
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body suppressHydrationWarning>
+        <noscript>You need to enable JavaScript to run this app.</noscript>
+        <div id="root">
+          <Providers>{children}</Providers>
+        </div>
+      </body>
+    </html>
+  );
+}

orbitmines.com/app/not-found.tsx

@@ -0,0 +1,10 @@
+'use client';
+
+import EtherOrMinimap from '../src/@ether/UI/router/EtherOrMinimap';
+
+// Cloudflare Pages routes unknown URLs to /index.html with 200 via the
+// _redirects rule, so this 404.html is rarely hit. We still wire it up to
+// the same SPA-routing component as a defensive fallback.
+export default function NotFound() {
+  return <EtherOrMinimap />;
+}

orbitmines.com/app/page.tsx

@@ -0,0 +1,10 @@
+'use client';
+
+import EtherOrMinimap from '../src/@ether/UI/router/EtherOrMinimap';
+
+// Root + SPA-fallback target (Cloudflare _redirects sends unknown URLs here
+// with HTTP 200). EtherOrMinimap inspects the path and renders EtherRoutes for
+// /@user, /$lang and Minimap otherwise.
+export default function Page() {
+  return <EtherOrMinimap />;
+}

orbitmines.com/app/papers/[[...slug]]/PapersRedirect.tsx

@@ -0,0 +1,16 @@
+'use client';
+
+import { useEffect } from 'react';
+import { useRouter } from 'next/navigation';
+
+// Legacy /papers/* URL space — redirect into /archive/* keeping the suffix.
+export default function PapersRedirect() {
+  const router = useRouter();
+
+  useEffect(() => {
+    const suffix = window.location.pathname.replace(/^\/papers\/?/, '');
+    router.replace(`/archive/${suffix}`);
+  }, [router]);
+
+  return null;
+}

orbitmines.com/app/papers/[[...slug]]/page.tsx

@@ -0,0 +1,16 @@
+import type { Metadata } from 'next';
+import PapersRedirect from './PapersRedirect';
+
+export const metadata: Metadata = { title: 'Papers' };
+
+export function generateStaticParams() {
+  // Generate the bare /papers entry; deep `/papers/...` paths fall back to
+  // the 404 page which also renders this redirect logic from the URL.
+  return [{ slug: [] as string[] }];
+}
+
+export const dynamicParams = false;
+
+export default function Page() {
+  return <PapersRedirect />;
+}

orbitmines.com/app/profiles/[profile]/ProfileRedirect.tsx

@@ -0,0 +1,18 @@
+'use client';
+
+import { useEffect } from 'react';
+import { useParams, useRouter } from 'next/navigation';
+
+// /profiles/:profile redirects to /@:profile. Server-side redirect would be
+// nicer, but `output: 'export'` has no server, so we do it on the client
+// immediately on mount.
+export default function ProfileRedirect() {
+  const params = useParams<{ profile: string }>();
+  const router = useRouter();
+
+  useEffect(() => {
+    if (params?.profile) router.replace(`/@${params.profile}`);
+  }, [params, router]);
+
+  return null;
+}