mordoc 0.1.1 → 0.1.3

package/package.json

@@ -4,13 +4,14 @@
         "type": "git",
         "url": "https://github.com/shiva-varanasi/mordoc.git"
     },
-    "version": "0.1.1",
+    "version": "0.1.3",
     "description": "A static site generator for documentation with SSG + SPA capabilities",
     "bin": {
         "mordoc": "./bin/cli.js"
     },
     "files": [
-        "dist"
+        "dist",
+        "templates"
     ],
     "scripts": {
         "compile": "tsc",
@@ -38,7 +39,8 @@
         "react-dom": "^19.2.3",
         "react-router-dom": "^7.9.3",
         "sirv-cli": "^2.0.2",
-        "ws": "^8.18.3"
+        "ws": "^8.18.3",       
+        "esbuild": "^0.25.10"
     },
     "devDependencies": {
         "@types/js-yaml": "^4.0.9",

package/templates/default/config/sidenav.yaml

@@ -0,0 +1,36 @@
+- label: Home
+  path: /
+
+- label: Flight School
+  path: /flight-school
+  children:
+    - label: Primer — What “Lightspeed” Means Here
+      path: /flight-school/primer
+    - label: Navigation — Folding a Straight Line
+      path: /flight-school/navigation
+
+- label: Field Manual
+  path: /field-manual
+  children:
+    - label: Engines — The Photoniuum Core
+      path: /field-manual/engines
+    - label: Relativity — A Friendly Lie
+      path: /field-manual/relativity
+    - label: Safety — The Ten-Meter Rule
+      path: /field-manual/safety
+
+- label: Ship Systems
+  path: /ship-systems
+  children:
+    - label: Photonic Core
+      path: /ship-systems/photonic-core
+    - label: Flux Sails
+      path: /ship-systems/flux-sails
+
+- label: FAQ
+  path: /faq
+
+- label: Changelog
+  path: /changelog
+
+

package/templates/default/config/site.json

@@ -0,0 +1,16 @@
+{
+  "title": "Photoniuum Flight Notes",
+  "description": "Fantasy documentation for lightspeed travel, photonic engines, and the etiquette of outrunning causality.",
+  "keywords": [
+    "photoniuum",
+    "lightspeed",
+    "ftl",
+    "photonic drive",
+    "navigation",
+    "field manual",
+    "fictional docs"
+  ],
+  "baseUrl": ""
+}
+
+

package/templates/default/config/styles/main.json

@@ -0,0 +1,6 @@
+{
+  "fontFamilyHeading": "\"Inter\", -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, \"Helvetica Neue\", Arial, sans-serif",
+  "fontFamilyMono": "\"SF Mono\", Monaco, \"Cascadia Code\", \"Roboto Mono\", Consolas, \"Courier New\", monospace"
+}
+
+

package/templates/default/config/styles/typography.json

@@ -0,0 +1,6 @@
+{
+  "linkColor": "#0665c4",
+  "linkColorDark": "#0665c4",
+  "linkHoverColor": "#0a0b66",
+  "linkHoverColorDark": "#61b1f2"
+}

package/templates/default/content/en/changelog.md

@@ -0,0 +1,35 @@
+---
+title: Changelog
+description: Drive bulletins and public notices from Photoniuum (fictional, but written like real releases).
+---
+
+# Drive Bulletins
+
+Photoniuum publishes bulletins for two reasons:
+
+1. To keep crews alive.
+2. To keep lawyers employed.
+
+## Unreleased
+
+- Added: Return clause now printed in **large, friendly font**
+- Fixed: starwake meter rounding error at intensity 3 (it was rounding *optimistically*)
+- Changed: “warp” replaced with “placement” in all passenger materials (engineering won)
+
+## 1.0.0 — First Launch
+
+- Added: Edgeward itineraries
+- Added: Photonic core limiters
+- Added: Etiquette daemon (beta)
+
+---
+
+## Bulletin excerpt (archival format)
+
+```markdown
+## Bulletin 1.0.1
+- Fixed: “earth guaranteed” typo (it was not supposed to be there)
+- Added: additional tea to the galley manifest
+```
+
+

package/templates/default/content/en/faq.md

@@ -0,0 +1,50 @@
+---
+title: FAQ
+description: Common questions about Photoniuum lightspeed travel — answered with alarming honesty.
+---
+
+# FAQ
+
+## Is this real physics?
+
+Photoniuum travel is engineered fiction. Our internal models are consistent enough to fly a ship, but not consistent enough to settle arguments on Earth.
+
+## Why “Photoniuum”?
+
+Because it sounds like a material you shouldn’t lick, and because the core behaves like one.
+
+## Will I age during the voyage?
+
+Not in any meaningful way. Your body experiences **ship time**.
+
+Your homeworld experiences **home time**.
+
+## Will Earth be there when I come back?
+
+We can route you back to the coordinates Earth once occupied.
+
+We do not guarantee the planet, the species, the language, or the parking rules will still exist.
+
+## Is return travel possible?
+
+Often, yes. Always, no.
+
+Some voyages return into a sky that has learned new constellations.
+
+## What is “starwake”?
+
+Starwake is the luminous residue of a jump — the corridor remembers you for a while.
+
+## What if I change my mind mid-voyage?
+
+That is normal. Tell the crew. We carry:
+
+- a counselor,
+- a kettle,
+- and three emergency playlists labeled **DO NOT USE**.
+
+## Can I link within a page?
+
+Yes. Example: [Jump windows](/flight-school/navigation#jump-windows).
+
+

package/templates/default/content/en/field-manual/engines.md

@@ -0,0 +1,59 @@
+---
+title: Engines — The Photoniuum Core
+description: The heart of lightspeed travel: how it spools, what it wants, and what it refuses to forgive.
+---
+
+# Engines — The Photoniuum Core
+
+The Photoniuum core is sometimes described as *“a lantern that remembers being a star.”*
+
+Engineers prefer: **“Do not tap the casing.”**
+
+![A simplified photonic core schematic](/images/photonic-core.svg "Photoniuum core (stylized)")
+
+## Spooling sequence (conceptual)
+
+```text
+1) Verify window lock
+2) Prime flux channels
+3) Begin spool (listen for the choir)
+4) Confirm starwake limiters
+5) Commit the jump
+```
+
+## Markdown showcase: inline code + emphasis
+
+If the status panel reads `CHOIR: DISPLEASED`, do **not** interpret it as “maybe.”
+
+## A tiny pseudo-API (code fence)
+
+```typescript
+type WindowId = string;
+
+interface JumpPlan {
+  window: WindowId;
+  maxStarwake: 1 | 2 | 3 | 4 | 5;
+  apology: string;
+}
+
+export function commitJump(plan: JumpPlan) {
+  if (!plan.apology || plan.apology.length < 12) {
+    throw new Error("Apology too short. The universe has standards.");
+  }
+  return { ok: true, event: "jump_committed", window: plan.window };
+}
+```
+
+## Custom components: cards
+
+{% cardGrid cols="2" %}
+{% card title="Safety — The Ten-Meter Rule" href="/field-manual/safety" icon="/icons/warning.svg" %}
+How to keep your ship, crew, and narrative arc intact during spool.
+{% /card %}
+
+{% card title="Relativity — A Friendly Lie" href="/field-manual/relativity" icon="/icons/relativity.svg" %}
+Why clocks argue, and why Photoniuum politely ignores them.
+{% /card %}
+{% /cardGrid %}
+
+

package/templates/default/content/en/field-manual/relativity.md

@@ -0,0 +1,46 @@
+---
+title: Relativity — A Friendly Lie
+description: A practical guide to time dilation, instrument disagreement, and why your tea tastes “later.”
+---
+
+# Relativity — A Friendly Lie
+
+Relativity is a correct theory.
+
+It is also, at high velocities, a **social problem**.
+
+## The three clocks
+
+Every Photoniuum craft carries:
+
+- **Ship clock** (what the crew agrees to live by)
+- **Nav clock** (what the windows demand)
+- **Core clock** (what the core thinks is funny)
+
+## What you can rely on
+
+| Item | Reliable? | Notes |
+|---|:---:|---|
+| A stopwatch | ✓ | As long as you don’t ask *when* it started |
+| “Now” | ✗ | “Now” is an opinion |
+| The core’s lullaby | ✓ | It’s always on time. It’s just not always *your* time. |
+
+## Markdown showcase: quote with emphasis
+
+> **Note:** If a crew member says *“I’m experiencing my childhood in reverse,”*  
+> escort them to the galley and give them something crunchy.
+
+## A compact “math” section (without depending on custom variables)
+
+If you *must* explain it, do it like this:
+
+- Velocity approaches \(c\)
+- Time dilation becomes significant
+- Your logs should record **proper time** and **ship time**
+
+## See also
+
+- [Navigation — Folding a Straight Line](/flight-school/navigation)
+- [Safety — The Ten-Meter Rule](/field-manual/safety)
+
+

package/templates/default/content/en/field-manual/safety.md

@@ -0,0 +1,44 @@
+---
+title: Safety — The Ten-Meter Rule
+description: Safety practices for spooling, jumping, and living near things that glow with intent.
+---
+
+# Safety — The Ten-Meter Rule
+
+The Photoniuum core is safe.
+
+It is also **dramatic**.
+
+## The Ten-Meter Rule
+
+When the core begins to spool:
+
+1. No one stands within **ten meters** of the casing.
+2. No one argues with the instruments.
+3. No one tells a *funny story* about the last jump.
+
+## Pre-jump checklist
+
+{% list type="checkmark" %}
+* No unsecured tools
+* No open cups
+* No unclaimed emotions
+* Window lock confirmed
+* Starwake limiters armed
+{% /list %}
+
+## Common hazards (table)
+
+| Hazard | What it looks like | What to do |
+|---|---|---|
+| Starwake spill | Light “leaks” along the corridor | Reduce spool; return to origin |
+| Window shear | Your map “tears” at the edges | Do not force it; wait for a new window |
+| Etiquette fault | Crew becomes unreasonably rude | Reboot the daemon (politely) |
+
+## Hazard notice
+
+> **Warning:** Do not attempt “micro-jumps” inside an atmosphere.  
+> The atmosphere will follow you. Briefly.  
+> Then it will become a weather event with your name.
+
+

package/templates/default/content/en/field-manual.md

@@ -0,0 +1,22 @@
+---
+title: Field Manual
+description: Practical notes for operating Photoniuum craft: engines, relativity, and safety.
+---
+
+# Field Manual
+
+This section is written for people who **touch the ship**.
+
+If Flight School is the poem, the Field Manual is the margin notes that keep the poem from exploding.
+
+## Contents
+
+- [Engines — The Photoniuum Core](/field-manual/engines)
+- [Relativity — A Friendly Lie](/field-manual/relativity)
+- [Safety — The Ten-Meter Rule](/field-manual/safety)
+
+## One sentence that fits on a sticker
+
+> **If the core is quiet, it’s either safe or preparing to do something historic.**
+
+

package/templates/default/content/en/flight-school/navigation.md

@@ -0,0 +1,61 @@
+---
+title: Navigation — Folding a Straight Line
+description: How Photoniuum charts a jump: constraints, windows, and the ritual of the last checkpoint.
+---
+
+# Navigation — Folding a Straight Line
+
+Navigation is not a map.  
+It’s a *contract*.
+
+## The plan
+
+Every jump plan has four parts:
+
+1. **Origin** (where you promise you started)
+2. **Destination** (where you promise you intend to be)
+3. **Window** (the corridor where the universe will cooperate)
+4. **Apology** (for what you’re about to do to starlight)
+
+## Constraints as code
+
+Write constraints as if another pilot must review them at 3 a.m.
+
+```json
+{
+  "window": "Sable-Tangent-12",
+  "maxStarwake": 3,
+  "avoid": ["inhabited-wells", "named-comets", "poetry-archives"],
+  "fallback": "return-to-origin"
+}
+```
+
+## Navigator’s note
+
+> **Tip:** If your destination is “somewhere near that bright one,” you are not navigating.  
+> You are sightseeing.
+
+## Pre-commit checklist
+
+{% list type="checkmark" %}
+* Window confirmed by two instruments
+* Crew briefed (including the cook)
+* Loose items secured (including opinions)
+* Apology drafted and signed
+{% /list %}
+
+## Internal anchors
+
+You can link to headings like this: [Jump windows](#jump-windows).
+
+### Jump windows
+
+Windows drift. Names do not.
+
+| Window name | Typical duration | Notes |
+|---|---:|---|
+| Sable-Tangent-12 | 9 min | Smells like ozone and old coins |
+| Glass-Choir | 4 min | Very stable. Everyone hears music. Nobody agrees on the song. |
+| Meridian Bite | 2 min | Do not blink |
+
+

package/templates/default/content/en/flight-school/primer.md

@@ -0,0 +1,64 @@
+---
+title: Primer — What “Lightspeed” Means Here
+description: Photoniuum’s plain-language definition of lightspeed travel, driftspace, and the price of coming home late.
+---
+
+# Primer — What “Lightspeed” Means Here
+
+Photoniuum does not “break” physics.
+
+We simply **persuade** it.
+
+## The two-speed model
+
+Photoniuum-certified navigation divides motion into two regimes:
+
+- **Normal space**: you move through distance.
+- **Driftspace**: you move through *agreement*.
+
+## Definitions (table)
+
+| Name | What it is | What it is not |
+|---|---|---|
+| Photonic core | A light-mass engine that can “spool” reality | A reactor you should stare into |
+| Jump window | A stable corridor where driftspace and normal space overlap | A door you can kick open |
+| Starwake | The luminous residue of a jump | “Exhaust” (please don’t say exhaust in front of engineers) |
+
+## What the instruments will say (and what they mean)
+
+{% table %}
+* Instrument
+* What it says
+* What you should do
+---
+* Drift compass
+* “NORTH IS A METAPHOR”
+* Reduce throttle and re-check your window
+---
+* Starwake meter
+* “BRIGHT ENOUGH TO BE A RELIGION”
+* Abort jump and apologize to astronomy
+---
+* Etiquette daemon
+* “SAY THANK YOU”
+* Say thank you
+{% /table %}
+
+## The single sentence you must memorize
+
+> **Lightspeed travel is not speed. It is placement.**
+
+## The clause passengers remember later
+
+You will experience the journey as days.
+
+Home may experience the journey as **millennia**.
+
+Photoniuum can offer a return vector. We cannot offer a return **world**.
+
+## Where to go next
+
+- [Navigation — Folding a Straight Line](/flight-school/navigation)
+- [Field Manual](/field-manual)
+
+

package/templates/default/content/en/flight-school.md

@@ -0,0 +1,48 @@
+---
+title: Flight School
+description: Orientation for new pilots and curious readers. We teach theory, etiquette, and survivable shortcuts.
+---
+
+# Flight School
+
+Welcome, cadet.
+
+You are here because you asked a forbidden question: **“What if space is just… negotiable?”**  
+Photoniuum’s answer is a handbook, a hull, and a gentle waiver.
+
+## Your first rule
+
+> **Rule 0:** If your instruments say *“impossible”*, check whether you’re still in the same universe.
+
+## Course map
+
+- Read the [Primer](/flight-school/primer) to learn what “lightspeed” means *in this setting*.
+- Practice with [Navigation](/flight-school/navigation): plotting a line through driftspace.
+- Then graduate into the [Field Manual](/field-manual) and learn what breaks first.
+
+## Enrollment tracks
+
+1. Choose your ship class:
+   - Courier (fast)
+   - Skiff (quiet)
+   - Lantern (for people who like to bring libraries)
+2. Choose your navigation style:
+   - “Math”
+   - “Vibes”
+   - A *carefully documented blend of both*
+
+## Standard jump plan format
+
+Your jump plan is basically a structured document. If you can read `YAML`, you can fly:
+
+```yaml
+pilot: "Cadet Zhen"
+ship: "Lantern-class"
+intent: "Demonstration jump"
+constraints:
+  - "Do not exceed starwake intensity level 3"
+  - "Avoid inhabited gravity wells"
+notes: "Bring tea. The kettle always knows."
+```
+
+

package/templates/default/content/en/index.md

@@ -0,0 +1,83 @@
+---
+title: Photoniuum Flight Notes
+description: Photoniuum corporate guidance for lightspeed travel: what we do, what it costs, and what it can’t promise.
+---
+
+# Welcome to Photoniuum
+
+Photoniuum builds craft that **treat distance as a suggestion**.
+
+We help passengers travel to the edge of the observable universe.
+
+> **Important (Time & Return):** Our drives preserve **you**. They do not preserve **your era**.  
+> Return journeys are offered on a *best-effort* basis. Photoniuum makes **no guarantee that Earth will still be present** (or recognizable) at the time of return.
+
+![A stylized “starwake” trail](/images/starwake.svg "Photoniuum starwake")
+
+## Start here
+
+{% cardGrid cols="3" %}
+{% card title="Flight School" href="/flight-school" icon="/icons/academy.svg" %}
+How to read a jump window, plot a line through vacuum, and keep your hands inside causality.
+{% /card %}
+
+{% card title="Field Manual" href="/field-manual" icon="/icons/manual.svg" %}
+Engines, relativity, and safety rules we wrote in ink because pencil drifts at \(0.97c\).
+{% /card %}
+
+{% card title="Ship Systems" href="/ship-systems" icon="/icons/systems.svg" %}
+Photonic cores, flux sails, and the tiny etiquette daemon that keeps the crew polite at lightspeed.
+{% /card %}
+{% /cardGrid %}
+
+## Mission brief
+
+Photoniuum travel is a trade:
+
+- **Passengers**: age almost not at all.
+- **Home**: continues aging at full speed.
+- **Maps**: change while you’re not looking.
+- **Language**: struggles to describe what you’re doing.
+
+---
+
+## Passenger-facing overview
+
+### What you’ll feel
+
+- The cabin stays calm.
+- Outside the viewport, starfields become **threads**.
+- Your stomach insists you are still.
+- Your logbook insists you are not.
+
+### What we disclose (table)
+
+| Disclosure | What it means |
+|---|---|
+| “Edgeward” itinerary | You may not return to the same sky |
+| “Chronal offset” | Your calendar and Earth’s calendar diverge |
+| “Starwake visibility” | Your passage may be detectable for a very long time |
+
+### A typical itinerary (example)
+
+```yaml
+voyage: "EDGEWARD-ALBIREO"
+duration_ship_time: "11 days"
+estimated_home_time: "≈ 3,200 years"
+return_clause: "Earth not guaranteed to exist"
+comfort: "high"
+```
+
+{% callout type="note" title="Navigation Tip" %}
+Always verify your coordinates before engaging the drive. Time dilation effects are non-refundable.
+{% /callout %}
+
+{% callout type="warning" %}
+Temporal paradoxes may occur if you attempt to return before you left.
+{% /callout %}
+
+{% callout type="danger" title="Critical Safety Notice" %}
+Do not attempt to exit the vessel during a jump. The vacuum of causality is not forgiving.
+{% /callout %}
+
+

package/templates/default/content/en/ship-systems/flux-sails.md

@@ -0,0 +1,33 @@
+---
+title: Flux Sails
+description: How Photoniuum shapes starwake: the sails that turn turbulence into a signature.
+---
+
+# Flux Sails
+
+Flux sails are not “wings.”
+
+They are **a conversation** between your ship and the geometry of the jump.
+
+![Flux sails in starlight](/images/flux-sails.svg "Flux sails (stylized)")
+
+## What they do
+
+- **Shape starwake** so it doesn’t slap the hull
+- **Dampen shear** at the edge of a window
+- **Broadcast a signature** (sometimes on purpose)
+
+## Operating modes
+
+| Mode | Best for | Tradeoff |
+|---|---|---|
+| Veil | stealth-ish travel | higher heat load |
+| Banner | long stable corridors | very visible wakes |
+| Needle | narrow windows | less forgiving |
+
+## A practical note
+
+> **Tip:** If the sails “flutter,” you’re hearing window turbulence.  
+> Reduce spool; don’t fight it. The universe has more leverage than you do.
+
+

package/templates/default/content/en/ship-systems/photonic-core.md

@@ -0,0 +1,39 @@
+---
+title: Photonic Core
+description: A deeper look at Photoniuum’s core: channels, limiters, and the “choir” effect.
+---
+
+# Photonic Core
+
+The core is a **light-mass engine** that can temporarily convince space to accept a different “here.”
+
+## Components
+
+- **Flux channels**: guide the spool
+- **Limiters**: keep starwake below your legal obligations
+- **Choir coils**: the part you *hear* (yes, really)
+
+## Configuration example (JSON)
+
+```json
+{
+  "limiters": {
+    "starwake": 3,
+    "shear": "conservative"
+  },
+  "choir": {
+    "enabled": true,
+    "mode": "soft"
+  }
+}
+```
+
+## Troubleshooting
+
+| Symptom | Likely cause | Fix |
+|---|---|---|
+| Choir becomes a “scream” | Window instability | Reduce spool, re-acquire window |
+| Starwake spikes | Limiter drift | Recalibrate; replace fuses (and ego) |
+| Core goes silent | It’s thinking | Give it time. If it’s still silent, *run diagnostics from outside the ship* |
+
+

package/templates/default/content/en/ship-systems.md

@@ -0,0 +1,25 @@
+---
+title: Ship Systems
+description: A tour of Photoniuum ship subsystems — what they do, how they fail, and how to talk to them.
+---
+
+# Ship Systems
+
+Photoniuum ships are built with two assumptions:
+
+1. You will try something ambitious.
+2. The universe will notice.
+
+## Contents
+
+- [Photonic Core](/ship-systems/photonic-core)
+- [Flux Sails](/ship-systems/flux-sails)
+
+## Quick reference (table)
+
+| System | Primary job | Secondary job |
+|---|---|---|
+| Photonic core | Place the ship where it promised to be | Hum, judge, and occasionally sing |
+| Flux sails | Shape starwake, reduce turbulence | Look gorgeous in starlight |
+
+

package/templates/default/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "my-documentation",
+  "version": "1.0.0",
+  "description": "Photoniuum Flight Notes — corporate documentation for lightspeed travel (fictional starter site)",
+  "private": true,
+  "scripts": {
+    "dev": "mordoc dev",
+    "build": "mordoc build",
+    "build:verbose": "mordoc build --verbose",
+    "build:drafts": "mordoc build --drafts"
+  },
+  "keywords": [
+    "photoniuum",
+    "lightspeed",
+    "ftl",
+    "documentation"
+  ],
+  "dependencies": {
+    "mordoc": "^0.1.3"
+  }
+}

package/templates/default/public/icons/academy.svg

@@ -0,0 +1,15 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Photoniuum Academy icon">
+  <defs>
+    <linearGradient id="g" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#93c5fd"/>
+      <stop offset="1" stop-color="#1d4ed8"/>
+    </linearGradient>
+  </defs>
+  <rect x="10" y="14" width="108" height="100" rx="18" fill="#0b1020"/>
+  <path d="M64 28 102 46 64 64 26 46 64 28Z" fill="url(#g)"/>
+  <path d="M34 56v22c0 16 60 16 60 0V56l-30 14-30-14Z" fill="#eaf0ff" opacity="0.9"/>
+  <path d="M102 46v36" stroke="#93c5fd" stroke-width="6" stroke-linecap="round"/>
+  <circle cx="102" cy="86" r="6" fill="#93c5fd"/>
+</svg>
+
+

package/templates/default/public/icons/manual.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Photoniuum Manual icon">
+  <defs>
+    <linearGradient id="g2" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#a5b4fc"/>
+      <stop offset="1" stop-color="#60a5fa"/>
+    </linearGradient>
+  </defs>
+  <rect x="18" y="14" width="92" height="100" rx="14" fill="#0b1020"/>
+  <path d="M38 28h52a10 10 0 0 1 10 10v64a8 8 0 0 0-8-8H38a10 10 0 0 0-10 10V38a10 10 0 0 1 10-10Z" fill="url(#g2)"/>
+  <path d="M40 44h44" stroke="#0b1020" stroke-width="6" stroke-linecap="round" opacity="0.55"/>
+  <path d="M40 60h36" stroke="#0b1020" stroke-width="6" stroke-linecap="round" opacity="0.55"/>
+  <path d="M40 76h40" stroke="#0b1020" stroke-width="6" stroke-linecap="round" opacity="0.55"/>
+  <path d="M40 92h28" stroke="#0b1020" stroke-width="6" stroke-linecap="round" opacity="0.55"/>
+</svg>
+
+

package/templates/default/public/icons/relativity.svg

@@ -0,0 +1,16 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Photoniuum Relativity icon">
+  <defs>
+    <linearGradient id="g5" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#a5b4fc"/>
+      <stop offset="1" stop-color="#38bdf8"/>
+    </linearGradient>
+  </defs>
+  <rect x="14" y="14" width="100" height="100" rx="22" fill="#0b1020"/>
+  <ellipse cx="64" cy="64" rx="42" ry="18" fill="none" stroke="url(#g5)" stroke-width="6"/>
+  <ellipse cx="64" cy="64" rx="18" ry="42" fill="none" stroke="url(#g5)" stroke-width="6" opacity="0.85"/>
+  <circle cx="64" cy="64" r="6" fill="#eaf0ff"/>
+  <path d="M26 64h18" stroke="#eaf0ff" stroke-width="6" stroke-linecap="round" opacity="0.8"/>
+  <path d="M84 64h18" stroke="#eaf0ff" stroke-width="6" stroke-linecap="round" opacity="0.8"/>
+</svg>
+
+

package/templates/default/public/icons/systems.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Photoniuum Systems icon">
+  <defs>
+    <linearGradient id="g3" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#93c5fd"/>
+      <stop offset="1" stop-color="#a5b4fc"/>
+    </linearGradient>
+  </defs>
+  <rect x="14" y="14" width="100" height="100" rx="22" fill="#0b1020"/>
+  <circle cx="64" cy="64" r="18" fill="url(#g3)"/>
+  <path d="M64 26v14M64 88v14M26 64h14M88 64h14" stroke="#eaf0ff" stroke-width="6" stroke-linecap="round" opacity="0.9"/>
+  <path d="M42 42l10 10M76 76l10 10M86 42l-10 10M52 76 42 86" stroke="#93c5fd" stroke-width="6" stroke-linecap="round" opacity="0.9"/>
+</svg>
+
+

package/templates/default/public/icons/warning.svg

@@ -0,0 +1,14 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128" role="img" aria-label="Photoniuum Warning icon">
+  <defs>
+    <linearGradient id="g4" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#fbbf24"/>
+      <stop offset="1" stop-color="#f59e0b"/>
+    </linearGradient>
+  </defs>
+  <rect x="12" y="12" width="104" height="104" rx="24" fill="#0b1020"/>
+  <path d="M64 24 110 104H18L64 24Z" fill="url(#g4)"/>
+  <path d="M64 46v30" stroke="#0b1020" stroke-width="10" stroke-linecap="round"/>
+  <circle cx="64" cy="88" r="6" fill="#0b1020"/>
+</svg>
+
+

package/templates/default/public/images/flux-sails.svg

@@ -0,0 +1,33 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 520" width="1200" height="520" role="img" aria-label="Photoniuum flux sails illustration (stylized)">
+  <defs>
+    <linearGradient id="bg3" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#070a12"/>
+      <stop offset="1" stop-color="#0b1020"/>
+    </linearGradient>
+    <linearGradient id="sail" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#93c5fd" stop-opacity="0.15"/>
+      <stop offset="1" stop-color="#a5b4fc" stop-opacity="0.65"/>
+    </linearGradient>
+    <filter id="blur3" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="10"/>
+    </filter>
+  </defs>
+
+  <rect width="1200" height="520" fill="url(#bg3)"/>
+
+  <!-- ship body -->
+  <rect x="520" y="230" width="160" height="60" rx="30" fill="#111827" stroke="#1f2a44" stroke-width="6"/>
+  <circle cx="520" cy="260" r="18" fill="#0b1020" stroke="#1f2a44" stroke-width="6"/>
+  <circle cx="680" cy="260" r="18" fill="#0b1020" stroke="#1f2a44" stroke-width="6"/>
+
+  <!-- sails -->
+  <path d="M600 260 C 420 120, 260 120, 140 180 C 270 220, 360 300, 460 390 C 520 340, 560 300, 600 260Z"
+        fill="url(#sail)" stroke="#93c5fd" stroke-opacity="0.45" stroke-width="4"/>
+  <path d="M600 260 C 780 120, 940 120, 1060 180 C 930 220, 840 300, 740 390 C 680 340, 640 300, 600 260Z"
+        fill="url(#sail)" stroke="#a5b4fc" stroke-opacity="0.45" stroke-width="4"/>
+
+  <!-- wake shimmer -->
+  <path d="M600 260 C 600 260, 780 300, 1080 360" fill="none" stroke="#eaf0ff" stroke-opacity="0.18" stroke-width="22" stroke-linecap="round" filter="url(#blur3)"/>
+</svg>
+
+

package/templates/default/public/images/photonic-core.svg

@@ -0,0 +1,44 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 520" width="1200" height="520" role="img" aria-label="Photoniuum photonic core schematic (stylized)">
+  <defs>
+    <linearGradient id="bg2" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#070a12"/>
+      <stop offset="1" stop-color="#0b1020"/>
+    </linearGradient>
+    <linearGradient id="glow" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#93c5fd"/>
+      <stop offset="1" stop-color="#a5b4fc"/>
+    </linearGradient>
+    <filter id="blur2" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="8"/>
+    </filter>
+  </defs>
+
+  <rect width="1200" height="520" fill="url(#bg2)"/>
+
+  <!-- outer casing -->
+  <rect x="220" y="120" width="760" height="280" rx="28" fill="#0f172a" stroke="#1f2a44" stroke-width="6"/>
+
+  <!-- core chamber -->
+  <rect x="420" y="160" width="360" height="200" rx="22" fill="#0b1020" stroke="#1f2a44" stroke-width="6"/>
+  <circle cx="600" cy="260" r="70" fill="url(#glow)" opacity="0.18" filter="url(#blur2)"/>
+  <circle cx="600" cy="260" r="28" fill="#eaf0ff"/>
+  <circle cx="600" cy="260" r="52" fill="none" stroke="url(#glow)" stroke-width="6" opacity="0.9"/>
+
+  <!-- flux channels -->
+  <path d="M420 200H300" stroke="#93c5fd" stroke-width="10" stroke-linecap="round" opacity="0.8"/>
+  <path d="M420 320H300" stroke="#a5b4fc" stroke-width="10" stroke-linecap="round" opacity="0.8"/>
+  <path d="M780 200H900" stroke="#a5b4fc" stroke-width="10" stroke-linecap="round" opacity="0.8"/>
+  <path d="M780 320H900" stroke="#93c5fd" stroke-width="10" stroke-linecap="round" opacity="0.8"/>
+
+  <!-- small labels -->
+  <g fill="#eaf0ff" opacity="0.75" font-family="Arial, sans-serif" font-size="20">
+    <text x="260" y="110">CASING</text>
+    <text x="470" y="150">CORE CHAMBER</text>
+    <text x="265" y="220">FLUX IN</text>
+    <text x="265" y="340">FLUX IN</text>
+    <text x="875" y="220">FLUX OUT</text>
+    <text x="875" y="340">FLUX OUT</text>
+  </g>
+</svg>
+
+

package/templates/default/public/images/starwake.svg

@@ -0,0 +1,49 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 520" width="1200" height="520" role="img" aria-label="Photoniuum starwake illustration">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0" stop-color="#070a12"/>
+      <stop offset="1" stop-color="#0b1020"/>
+    </linearGradient>
+    <linearGradient id="wake" x1="0" y1="0" x2="1" y2="0">
+      <stop offset="0" stop-color="#93c5fd" stop-opacity="0"/>
+      <stop offset="0.35" stop-color="#93c5fd" stop-opacity="0.75"/>
+      <stop offset="1" stop-color="#a5b4fc" stop-opacity="0.95"/>
+    </linearGradient>
+    <radialGradient id="star" cx="50%" cy="50%" r="50%">
+      <stop offset="0" stop-color="#eaf0ff"/>
+      <stop offset="1" stop-color="#eaf0ff" stop-opacity="0"/>
+    </radialGradient>
+    <filter id="blur" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="6"/>
+    </filter>
+  </defs>
+
+  <rect width="1200" height="520" fill="url(#bg)"/>
+
+  <!-- stars -->
+  <g opacity="0.85">
+    <circle cx="120" cy="90" r="2" fill="#eaf0ff"/>
+    <circle cx="220" cy="140" r="1.5" fill="#eaf0ff"/>
+    <circle cx="340" cy="70" r="1.2" fill="#eaf0ff"/>
+    <circle cx="520" cy="110" r="1.8" fill="#eaf0ff"/>
+    <circle cx="760" cy="80" r="1.4" fill="#eaf0ff"/>
+    <circle cx="980" cy="160" r="1.6" fill="#eaf0ff"/>
+    <circle cx="1060" cy="90" r="1.1" fill="#eaf0ff"/>
+    <circle cx="900" cy="60" r="1.0" fill="#eaf0ff"/>
+    <circle cx="640" cy="170" r="1.0" fill="#eaf0ff"/>
+    <circle cx="420" cy="190" r="1.1" fill="#eaf0ff"/>
+  </g>
+
+  <!-- starwake -->
+  <path d="M120 350 C 300 260, 520 310, 720 230 S 1100 170, 1160 140"
+        fill="none" stroke="url(#wake)" stroke-width="46" stroke-linecap="round" filter="url(#blur)"/>
+  <path d="M140 352 C 320 270, 520 322, 740 244 S 1090 182, 1166 150"
+        fill="none" stroke="#eaf0ff" stroke-opacity="0.22" stroke-width="10" stroke-linecap="round"/>
+
+  <!-- jump point -->
+  <circle cx="1080" cy="190" r="70" fill="url(#star)" opacity="0.9"/>
+  <circle cx="1080" cy="190" r="10" fill="#eaf0ff"/>
+  <circle cx="1080" cy="190" r="24" fill="none" stroke="#93c5fd" stroke-opacity="0.6" stroke-width="3"/>
+</svg>
+
+