worldorbit 3.2.2 → 5.0.0

package/dist/browser/editor/dist/types.d.ts

@@ -9,6 +9,7 @@ export interface WorldOrbitEditorSnapshot {
     diagnostics: AtlasResolvedDiagnostic[];
     selection: WorldOrbitEditorSelection | null;
 }
+export type WorldOrbitEditorObjectType = WorldOrbitObject["type"] | "craft";
 export interface WorldOrbitEditorOptions {
     source?: string;
     atlasDocument?: WorldOrbitAtlasDocument;
@@ -40,7 +41,7 @@ export interface WorldOrbitEditor {
     canRedo(): boolean;
     undo(): boolean;
     redo(): boolean;
-    addObject(type?: WorldOrbitObject["type"]): string;
+    addObject(type?: WorldOrbitEditorObjectType): string;
     addEvent(): string;
     addViewpoint(): string;
     addAnnotation(): string;

package/dist/browser/viewer/dist/minimap.js

@@ -28,13 +28,13 @@ export function renderViewerMinimap(scene, state, visibleObjects) {
         return `<circle cx="${formatNumber(x)}" cy="${formatNumber(y)}" r="${formatNumber(radius)}" fill="${fill}" fill-opacity="0.92" />`;
     })
         .join("");
-    return `<div data-worldorbit-minimap="true" style="position:absolute;right:16px;bottom:16px;width:${MINIMAP_WIDTH}px;height:${MINIMAP_HEIGHT}px;padding:8px;border-radius:16px;background:rgba(5, 14, 22, 0.78);border:1px solid rgba(179, 216, 255, 0.16);box-shadow:0 14px 28px rgba(0, 0, 0, 0.24);backdrop-filter:blur(8px);pointer-events:none;">
-  <svg width="${MINIMAP_WIDTH}" height="${MINIMAP_HEIGHT}" viewBox="0 0 ${MINIMAP_WIDTH} ${MINIMAP_HEIGHT}" role="presentation" aria-hidden="true">
-    <rect x="0.5" y="0.5" width="${MINIMAP_WIDTH - 1}" height="${MINIMAP_HEIGHT - 1}" rx="12" ry="12" fill="rgba(7, 17, 27, 0.85)" stroke="rgba(179, 216, 255, 0.18)" />
-    <rect x="${formatNumber(bounds.minX * scale + translateX)}" y="${formatNumber(bounds.minY * scale + translateY)}" width="${formatNumber(bounds.width * scale)}" height="${formatNumber(bounds.height * scale)}" rx="10" ry="10" fill="rgba(163, 209, 255, 0.04)" stroke="rgba(163, 209, 255, 0.16)" />
-    ${objectsMarkup}
-    <rect x="${formatNumber(viewport.minX * scale + translateX)}" y="${formatNumber(viewport.minY * scale + translateY)}" width="${formatNumber(viewport.width * scale)}" height="${formatNumber(viewport.height * scale)}" rx="8" ry="8" fill="rgba(255, 180, 100, 0.09)" stroke="rgba(255, 180, 100, 0.88)" stroke-width="1.4" />
-  </svg>
+    return `<div data-worldorbit-minimap="true" style="position:absolute;right:16px;bottom:16px;width:${MINIMAP_WIDTH}px;height:${MINIMAP_HEIGHT}px;padding:8px;border-radius:16px;background:rgba(5, 14, 22, 0.78);border:1px solid rgba(179, 216, 255, 0.16);box-shadow:0 14px 28px rgba(0, 0, 0, 0.24);backdrop-filter:blur(8px);pointer-events:none;">
+  <svg width="${MINIMAP_WIDTH}" height="${MINIMAP_HEIGHT}" viewBox="0 0 ${MINIMAP_WIDTH} ${MINIMAP_HEIGHT}" role="presentation" aria-hidden="true">
+    <rect x="0.5" y="0.5" width="${MINIMAP_WIDTH - 1}" height="${MINIMAP_HEIGHT - 1}" rx="12" ry="12" fill="rgba(7, 17, 27, 0.85)" stroke="rgba(179, 216, 255, 0.18)" />
+    <rect x="${formatNumber(bounds.minX * scale + translateX)}" y="${formatNumber(bounds.minY * scale + translateY)}" width="${formatNumber(bounds.width * scale)}" height="${formatNumber(bounds.height * scale)}" rx="10" ry="10" fill="rgba(163, 209, 255, 0.04)" stroke="rgba(163, 209, 255, 0.16)" />
+    ${objectsMarkup}
+    <rect x="${formatNumber(viewport.minX * scale + translateX)}" y="${formatNumber(viewport.minY * scale + translateY)}" width="${formatNumber(viewport.width * scale)}" height="${formatNumber(viewport.height * scale)}" rx="8" ry="8" fill="rgba(255, 180, 100, 0.09)" stroke="rgba(255, 180, 100, 0.88)" stroke-width="1.4" />
+  </svg>
 </div>`;
 }
 function minimapColorForObject(type) {
@@ -52,6 +52,8 @@ function minimapColorForObject(type) {
             return "#a7a5b8";
         case "comet":
             return "#9ce7ff";
+        case "craft":
+            return "#ffb47f";
         case "structure":
             return "#ff7f5f";
         case "phenomenon":

package/dist/browser/viewer/dist/render.js

@@ -40,6 +40,13 @@ export function renderSceneToSvg(scene, options = {}) {
             .map((relation) => `<line class="wo-relation" x1="${relation.x1}" y1="${relation.y1}" x2="${relation.x2}" y2="${relation.y2}" data-render-id="${escapeXml(relation.renderId)}" data-relation-id="${escapeAttribute(relation.relationId)}" />`)
             .join("")
         : "";
+    const trajectoryMarkup = layers.trajectories
+        ? renderTrajectoryLayer(scene, visibleObjectIds, {
+            showLabels: options.showTrajectoryLabels ?? true,
+            showWaypoints: options.showTrajectoryWaypoints ?? true,
+            includeStructures: layers.structures,
+        })
+        : "";
     const eventMarkup = layers.events
         ? scene.events
             .filter((event) => !event.hidden)
@@ -78,25 +85,32 @@ export function renderSceneToSvg(scene, options = {}) {
       <stop offset="0%" stop-color="${theme.starGlow}" stop-opacity="0.95" />
       <stop offset="100%" stop-color="${theme.starCore}" stop-opacity="0" />
     </radialGradient>
-    <radialGradient id="wo-bg-glow" cx="20%" cy="10%" r="90%">
-      <stop offset="0%" stop-color="${theme.backgroundGlow}" />
-      <stop offset="100%" stop-color="transparent" />
-    </radialGradient>
-    ${imageDefinitions}
-  </defs>
+    <radialGradient id="wo-bg-glow" cx="20%" cy="10%" r="90%">
+      <stop offset="0%" stop-color="${theme.backgroundGlow}" />
+      <stop offset="100%" stop-color="transparent" />
+    </radialGradient>
+    <marker id="wo-trajectory-arrow" markerWidth="12" markerHeight="12" refX="10" refY="6" orient="auto" markerUnits="strokeWidth">
+      <path d="M 0 0 L 12 6 L 0 12 z" fill="${theme.accent}" />
+    </marker>
+    ${imageDefinitions}
+  </defs>
   <style>
     .wo-bg { fill: url(#wo-bg); }
     .wo-bg-glow { fill: url(#wo-bg-glow); }
     .wo-grid { fill: none; stroke: ${theme.guide}; stroke-width: 1; }
     .wo-orbit { fill: none; stroke: ${theme.orbit}; stroke-width: 1.5; }
-    .wo-orbit-back { opacity: 0.38; stroke-dasharray: 8 6; }
-    .wo-orbit-front { opacity: 0.9; }
+    .wo-orbit-back { opacity: 0.38; stroke-dasharray: 8 6; }
+    .wo-orbit-front { opacity: 0.9; }
     .wo-orbit-band { stroke: ${theme.orbitBand}; stroke-linecap: round; }
     .wo-relation { stroke: ${theme.relation}; stroke-width: 2; stroke-dasharray: 10 6; }
+    .wo-trajectory { fill: none; stroke: ${theme.accent}; stroke-width: 2.4; stroke-linecap: round; stroke-linejoin: round; opacity: 0.92; }
+    .wo-trajectory-waypoint { fill: ${theme.spaceFog}; stroke: ${theme.selected}; stroke-width: 1.4; }
+    .wo-trajectory-label { fill: ${theme.accent}; font-family: ${theme.fontFamily}; font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; }
+    .wo-trajectory-date { fill: ${theme.muted}; font-family: ${theme.fontFamily}; font-weight: 500; }
     .wo-event-line { stroke: ${theme.accent}; stroke-width: 1.6; stroke-dasharray: 5 5; opacity: 0.72; }
-    .wo-event-node { fill: ${theme.accent}; stroke: ${theme.selected}; stroke-width: 1.4; opacity: 0.92; }
-    .wo-event-label { fill: ${theme.accent}; font-family: ${theme.fontFamily}; font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; }
-    .wo-leader { stroke: ${theme.leader}; stroke-width: 1.5; stroke-dasharray: 6 5; }
+    .wo-event-node { fill: ${theme.accent}; stroke: ${theme.selected}; stroke-width: 1.4; opacity: 0.92; }
+    .wo-event-label { fill: ${theme.accent}; font-family: ${theme.fontFamily}; font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; }
+    .wo-leader { stroke: ${theme.leader}; stroke-width: 1.5; stroke-dasharray: 6 5; }
     .wo-label { fill: ${theme.ink}; font-family: ${theme.fontFamily}; font-weight: 600; letter-spacing: 0.02em; }
     .wo-label-secondary { fill: ${theme.muted}; font-family: ${theme.fontFamily}; font-weight: 500; }
     .wo-title { fill: ${theme.ink}; font: 700 24px ${theme.displayFont}; letter-spacing: 0.06em; text-transform: uppercase; }
@@ -127,14 +141,15 @@ export function renderSceneToSvg(scene, options = {}) {
   <g data-worldorbit-world="true">
     <g data-worldorbit-camera-root="${WORLD_LAYER_ID}" id="${WORLD_LAYER_ID}">
       <g data-worldorbit-world-content="true">
-        ${layers.orbits ? `<g data-layer-id="orbits-back">${orbitMarkup.back}</g>` : ""}
-        ${layers.guides ? `<g data-layer-id="guides">${leaderMarkup}</g>` : ""}
+        ${layers.orbits ? `<g data-layer-id="orbits-back">${orbitMarkup.back}</g>` : ""}
+        ${layers.guides ? `<g data-layer-id="guides">${leaderMarkup}</g>` : ""}
         ${layers.relations ? `<g data-layer-id="relations">${relationMarkup}</g>` : ""}
         ${layers.events ? `<g data-layer-id="events">${eventMarkup}</g>` : ""}
         ${layers.objects ? `<g data-layer-id="objects">${objectMarkup}</g>` : ""}
         ${layers.orbits ? `<g data-layer-id="orbits-front">${orbitMarkup.front}</g>` : ""}
+        ${layers.trajectories ? `<g data-layer-id="trajectories">${trajectoryMarkup}</g>` : ""}
         ${layers.labels ? `<g data-layer-id="labels">${labelMarkup}</g>` : ""}
-      </g>
+      </g>
     </g>
   </g>
 </svg>`;
@@ -152,10 +167,51 @@ function renderSceneEventOverlay(scene, event, visibleObjectIds, theme) {
     const lineMarkup = participants
         .map((object) => `<line class="wo-event-line" x1="${event.x}" y1="${event.y}" x2="${object.x}" y2="${object.y}" stroke="${escapeAttribute(stroke)}" data-event-id="${escapeAttribute(event.eventId)}" data-object-id="${escapeAttribute(object.objectId)}" />`)
         .join("");
-    return `<g class="wo-event" data-render-id="${escapeXml(event.renderId)}" data-event-id="${escapeAttribute(event.eventId)}">
-    ${lineMarkup}
-    <circle class="wo-event-node" cx="${event.x}" cy="${event.y}" r="5" fill="${escapeAttribute(stroke)}" />
-    <text class="wo-event-label" x="${event.x}" y="${event.y - 10}" text-anchor="middle" font-size="10">${escapeXml(label)}</text>
+    return `<g class="wo-event" data-render-id="${escapeXml(event.renderId)}" data-event-id="${escapeAttribute(event.eventId)}">
+    ${lineMarkup}
+    <circle class="wo-event-node" cx="${event.x}" cy="${event.y}" r="5" fill="${escapeAttribute(stroke)}" />
+    <text class="wo-event-label" x="${event.x}" y="${event.y - 10}" text-anchor="middle" font-size="10">${escapeXml(label)}</text>
+  </g>`;
+}
+function renderTrajectoryLayer(scene, visibleObjectIds, options) {
+    return scene.trajectories
+        .filter((trajectory) => !trajectory.hidden)
+        .filter((trajectory) => trajectory.objectIds.length === 0 || trajectory.objectIds.some((objectId) => visibleObjectIds.has(objectId)))
+        .filter((trajectory) => options.includeStructures ||
+        !trajectory.objectIds.some((objectId) => {
+            const object = scene.objects.find((entry) => entry.objectId === objectId)?.object;
+            return object ? isStructureLike(object) : false;
+        }))
+        .map((trajectory) => {
+        const stroke = trajectory.stroke ?? "#f0b464";
+        const markerEnd = trajectory.marker === "none" ? "" : ` marker-end="url(#wo-trajectory-arrow)"`;
+        const waypointMarkup = trajectory.showWaypoints && options.showWaypoints
+            ? trajectory.waypoints
+                .filter((waypoint) => !waypoint.hidden)
+                .map((waypoint) => renderTrajectoryWaypoint(trajectory, waypoint, options.showLabels))
+                .join("")
+            : "";
+        return `<g class="wo-trajectory-group" data-render-id="${escapeXml(trajectory.renderId)}" data-trajectory-id="${escapeAttribute(trajectory.trajectoryId)}">
+    <path class="wo-trajectory wo-trajectory-${trajectory.mode}" d="${trajectory.path}" stroke="${escapeAttribute(stroke)}" stroke-width="${trajectory.strokeWidth}"${markerEnd} />
+    ${waypointMarkup}
+  </g>`;
+    })
+        .join("");
+}
+function renderTrajectoryWaypoint(trajectory, waypoint, showLabels) {
+    const labelMarkup = showLabels && trajectory.labelMode !== "hidden"
+        ? [
+            waypoint.label
+                ? `<text class="wo-trajectory-label" x="${waypoint.x + 10}" y="${waypoint.y - 10}" font-size="10">${escapeXml(waypoint.label)}</text>`
+                : "",
+            waypoint.dateLabel
+                ? `<text class="wo-trajectory-date" x="${waypoint.x + 10}" y="${waypoint.y + 4}" font-size="9">${escapeXml(waypoint.dateLabel)}</text>`
+                : "",
+        ].join("")
+        : "";
+    return `<g class="wo-trajectory-waypoint-group" data-render-id="${escapeXml(waypoint.renderId)}" data-trajectory-id="${escapeAttribute(waypoint.trajectoryId)}">
+    <circle class="wo-trajectory-waypoint" cx="${waypoint.x}" cy="${waypoint.y}" r="4.5" />
+    ${labelMarkup}
   </g>`;
 }
 export function renderDocumentToSvg(document, options = {}) {
@@ -259,6 +315,8 @@ function renderObjectBody(object, x, y, radius, palette, options = {}) {
                 ? `<circle cx="${x}" cy="${y}" r="${radius}" fill="transparent" stroke="${palette.stroke}" stroke-width="1.4" />`
                 : `<path d="M ${x - radius * 2} ${y + radius * 1.3} Q ${x - radius * 0.7} ${y + radius * 0.3} ${x - radius * 0.45} ${y}" fill="none" stroke="${tail}" stroke-width="${Math.max(2, radius * 0.8)}" stroke-linecap="round" opacity="0.85" />
 <circle cx="${x}" cy="${y}" r="${radius}" fill="${fill}" stroke="${palette.stroke}" stroke-width="1.4" />`;
+        case "craft":
+            return `<polygon points="${diamondPoints(x, y, radius * 0.85)}" fill="${fill}" stroke="${palette.stroke}" stroke-width="1.4" />`;
         case "structure":
             return `<polygon points="${diamondPoints(x, y, radius)}" fill="${fill}" stroke="${palette.stroke}" stroke-width="1.4" />`;
         case "phenomenon": {
@@ -443,6 +501,8 @@ function basePaletteForType(type, kind, theme) {
             return { fill: "#9ce7ff", stroke: "#e7fbff" };
         case "ring":
             return { fill: "#e59f7d", stroke: "#fff0d3" };
+        case "craft":
+            return { fill: "#ffb47f", stroke: "#fff0d3" };
         case "structure":
             return { fill: theme.accentStrong, stroke: "#fff2ea" };
         case "phenomenon":

package/dist/browser/viewer/dist/runtime-3d.js

@@ -686,6 +686,8 @@ function colorForObject(object) {
             return "#b8926a";
         case "ring":
             return "#cdbf9a";
+        case "craft":
+            return "#ffce8a";
         case "structure":
             return "#ffce8a";
         case "phenomenon":

package/dist/browser/viewer/dist/theme.js

@@ -4,6 +4,7 @@ const DEFAULT_LAYERS = {
     relations: true,
     events: true,
     orbits: true,
+    trajectories: true,
     objects: true,
     labels: true,
     structures: true,

package/dist/browser/viewer/dist/types.d.ts

@@ -43,6 +43,7 @@ export interface ViewerLayerOptions {
     relations?: boolean;
     events?: boolean;
     orbits?: boolean;
+    trajectories?: boolean;
     objects?: boolean;
     labels?: boolean;
     structures?: boolean;
@@ -77,6 +78,9 @@ export interface ViewerRenderOptions extends Omit<SvgRenderOptions, "selectedObj
     viewMode?: WorldOrbitViewMode;
     quality?: WorldOrbit3DQuality;
     style3d?: WorldOrbit3DStyle;
+    trajectoryMode?: "illustrative" | "solver" | "auto";
+    showTrajectoryWaypoints?: boolean;
+    showTrajectoryLabels?: boolean;
 }
 export interface ViewerState {
     scale: number;
@@ -130,6 +134,9 @@ export interface ViewerAtlasState {
         layers?: ViewerLayerOptions;
         scaleModel?: Partial<RenderScaleModel>;
         bodyScaleMode?: SceneRenderOptions["bodyScaleMode"];
+        trajectoryMode?: SceneRenderOptions["trajectoryMode"];
+        showTrajectoryWaypoints?: boolean;
+        showTrajectoryLabels?: boolean;
         activeEventId?: string | null;
         viewMode?: WorldOrbitViewMode;
         quality?: WorldOrbit3DQuality;

package/dist/browser/viewer/dist/viewer.js

@@ -1086,7 +1086,7 @@ export function createInteractiveViewer(container, options) {
         tooltipRoot.hidden = false;
         tooltipRoot.dataset.mode = resolved.mode;
         tooltipRoot.classList.toggle("is-pinned", resolved.mode === "pinned");
-        tooltipRoot.style.pointerEvents = "auto";
+        tooltipRoot.style.pointerEvents = resolved.mode === "pinned" ? "auto" : "none";
         tooltipRoot.style.visibility = "hidden";
         renderTooltipContent(tooltipRoot, tooltipDetails, resolved.mode);
         positionTooltip(tooltipRoot, details.renderObject);
@@ -1691,6 +1691,33 @@ function fallbackSpatialSceneFromRenderScene(scene) {
             hidden: orbit.hidden,
             motion: null,
         })),
+        trajectories: scene.trajectories.map((trajectory) => ({
+            trajectoryId: trajectory.trajectoryId,
+            trajectory: trajectory.trajectory,
+            craftObjectId: trajectory.craftObjectId,
+            mode: trajectory.mode,
+            stroke: trajectory.stroke,
+            strokeWidth: trajectory.strokeWidth,
+            marker: trajectory.marker,
+            labelMode: trajectory.labelMode,
+            showWaypoints: trajectory.showWaypoints,
+            samples: [],
+            waypoints: trajectory.waypoints.map((waypoint) => ({
+                trajectoryId: waypoint.trajectoryId,
+                segmentId: waypoint.segmentId,
+                maneuverId: waypoint.maneuverId,
+                objectId: waypoint.objectId,
+                position: {
+                    x: waypoint.x - scene.contentBounds.centerX,
+                    y: 0,
+                    z: waypoint.y - scene.contentBounds.centerY,
+                },
+                label: waypoint.label,
+                dateLabel: waypoint.dateLabel,
+                hidden: waypoint.hidden,
+            })),
+            hidden: trajectory.hidden,
+        })),
         focusTargets: scene.objects.map((object) => ({
             objectId: object.objectId,
             center: {
@@ -1732,7 +1759,11 @@ function getClosestObjectId(target) {
     if (!(target instanceof Element)) {
         return null;
     }
-    return target.closest("[data-object-id]")?.dataset.objectId ?? null;
+    const selectionTarget = target.closest("[data-object-id], [data-orbit-object-id]");
+    if (!selectionTarget) {
+        return null;
+    }
+    return selectionTarget.dataset.objectId ?? selectionTarget.dataset.orbitObjectId ?? null;
 }
 function ensureBrowserEnvironment(container) {
     if (typeof window === "undefined" || typeof document === "undefined") {
@@ -1864,7 +1895,7 @@ function installViewerOverlayStyles() {
       backdrop-filter: blur(12px);
       font: 500 13px/1.5 "Segoe UI Variable", "Segoe UI", sans-serif;
     }
-    .wo-viewer-tooltip-root[data-mode="hover"] { pointer-events: auto; }
+    .wo-viewer-tooltip-root[data-mode="hover"] { pointer-events: none; }
     .wo-viewer-tooltip-root[data-mode="pinned"] { pointer-events: auto; }
     .wo-tooltip-card { display: grid; gap: 10px; }
     .wo-tooltip-head { display: grid; grid-template-columns: 52px minmax(0, 1fr); gap: 12px; align-items: center; }

package/dist/obsidian-plugin/README.md

@@ -1,124 +1,141 @@
-
-
- Treat your Obsidian Vault as a stellar atlas. WorldOrbit provides a text-first DSL (Domain Specific Language) to render fictional star systems, orbital mechanics, and space infrastructure directly inside your notes.
-
-See the **Examples** section below for a quick start, or the [full reference](https://github.com/negurvulkan/worldorbit) for all the details.
-
-## Examples
-
-Render a basic star system with a star and a planet:
-
-Code-Snippet
-
-```
-schema 2.6
-system Sol
-
-object star Sun
-  radius 695700km
-
-object planet Earth
-  orbit Sun
-  semiMajor 1au
-  color #6fa8ff
-```
-
-  
-*Visualisierung eines einfachen Sternensystems in der Obsidian Live-Vorschau.*
-
-Visualize complex orbital hierarchies including moons and rings:
-
-Code-Snippet
-
-```
-schema 2.6
-system Sol
-
-object star Sun
-  radius 695700km
-
-object planet Earth
-  orbit Sun
-  semiMajor 1au
-  color #6fa8ff
-
-object planet Saturn
-  orbit Sun
-  semiMajor 9.58au
-
-object ring Saturn-Rings
-  orbit Saturn
-  inner 67000km
-  outer 140000km
-
-object moon Titan
-  orbit Saturn
-  distance 1221870km
-```
-
-  
-*Darstellung komplexer orbitaler Hierarchien mit Ringen und Monden.*
-
-## Usage
-
-WorldOrbit consists of two major aspects: **Data (DSL)** and **Visualizing**.
-
-### Data
-
-WorldOrbit generates diagrams from fenced code blocks using the `.ks` (KeplerScript) syntax. It is designed for fictional worldbuilding, focusing on readability and logic rather than strict astrophysical simulation.
-
-- **Objects**: Define stars, planets, moons, or space stations.
-- **Placement**: Use `orbit`, `at` (for Lagrange points or anchors), or `surface` to position objects.
-- **Physical Traits**: Assign `mass`, `radius`, `color`, and `atmosphere` to enrich the simulation.
-
-### Visualizing
-
-Once you've defined your system, the plugin renders it using three modes:
-
-1. **Reading View & Live Preview**: Automatically turns code blocks into interactive 2D diagrams.
-2. **Lazy Loading**: Previews are only rendered when they become visible, keeping your Obsidian vault fast and responsive.
-3. **Locked Mode**: By default, diagrams are locked to allow safe scrolling. Click "Activate Interaction" to enable pan and zoom.
-
-## Features
-
-- **2D Interactive Viewer**: Pan, zoom, and explore your systems.
-- **Diagnostics**: Real-time validation of your orbital data. If a planet's period doesn't match its mass (Kepler's Laws), the plugin will tell you.
-- **Command Palette**: Use `WorldOrbit: Insert Solar System Example` to quickly bootstrap a new system.
-- **Fullscreen Mode**: Open any diagram in a high-resolution modal view for detailed inspection.
-
-## Installation
-
-### Community Plugin
-
-Search for **WorldOrbit** in the Obsidian Community Plugins settings and click Install. (Note: Submission pending).
-
-### Manual Installation
-
-1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/negurvulkan/worldorbit/releases).
-2. Create a folder `.obsidian/plugins/worldorbit` in your vault.
-3. Move the files into that folder and enable the plugin in Obsidian.
-
-## Contributing
-
-Contributions via bug reports, documentation, and improvements are welcome.
-
-### Local Development
-
-The codebase is part of a TypeScript monorepo. To set up locally:
-
-Bash
-
-```
-git clone https://github.com/negurvulkan/worldorbit.git
-cd worldorbit
-npm install
-npm run build
-```
-
-## License
-
-Licensed under the **MIT License**.
-
-NPM Version|97
-Downloads
-GitHub stars
+# WorldOrbit for Obsidian
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-1.0.0-gold?style=for-the-badge" alt="Version 1.0.0">
+  <img src="https://img.shields.io/badge/license-MIT-blue?style=for-the-badge" alt="License MIT">
+  <img src="https://img.shields.io/badge/Obsidian-v1.5.0+-purple?style=for-the-badge&logo=obsidian" alt="Obsidian v1.5.0+">
+</p>
+
+---
+
+Treat your Obsidian Vault as a stellar atlas. WorldOrbit provides a text-first DSL (Domain Specific Language) to render fictional star systems, orbital mechanics, and space infrastructure directly inside your notes.
+
+See the **Examples** section below for a quick start, or the [full reference](https://github.com/negurvulkan/worldorbit) for all the details.
+
+## Examples
+
+Render a basic star system with a star and a planet:
+
+Code-Snippet
+
+```
+schema 2.6
+system Sol
+
+object star Sun
+  radius 695700km
+
+object planet Earth
+  orbit Sun
+  semiMajor 1au
+  color #6fa8ff
+```
+
+  
+*.*
+<p align="center">
+  <img src="https://negurvulkan.github.io/worldorbit/obsidian_scsh_1.png" width="700" alt="WorldOrbit Simple System Preview">
+  <br>
+  <em>WorldOrbit Simple System Preview</em>
+</p>
+
+Visualize complex orbital hierarchies including moons and rings:
+
+Code-Snippet
+
+```
+schema 2.6
+system Sol
+
+object star Sun
+  radius 695700km
+
+object planet Earth
+  orbit Sun
+  semiMajor 1au
+  color #6fa8ff
+
+object planet Saturn
+  orbit Sun
+  semiMajor 9.58au
+
+object ring Saturn-Rings
+  orbit Saturn
+  inner 67000km
+  outer 140000km
+
+object moon Titan
+  orbit Saturn
+  distance 1221870km
+```
+
+
+<p align="center">
+  <img src="https://negurvulkan.github.io/worldorbit/obsidian_scsh_2.png" width="700" alt="WorldOrbit Advanced System Preview">
+  <br>
+  <em>WorldOrbit Advanced System</em>
+</p>
+
+## Usage
+
+WorldOrbit consists of two major aspects: **Data (DSL)** and **Visualizing**.
+
+### Data
+
+WorldOrbit generates diagrams from fenced code blocks using the `.ks` (KeplerScript) syntax. It is designed for fictional worldbuilding, focusing on readability and logic rather than strict astrophysical simulation.
+
+- **Objects**: Define stars, planets, moons, or space stations.
+- **Placement**: Use `orbit`, `at` (for Lagrange points or anchors), or `surface` to position objects.
+- **Physical Traits**: Assign `mass`, `radius`, `color`, and `atmosphere` to enrich the simulation.
+
+### Visualizing
+
+Once you've defined your system, the plugin renders it using three modes:
+
+1. **Reading View & Live Preview**: Automatically turns code blocks into interactive 2D diagrams.
+2. **Lazy Loading**: Previews are only rendered when they become visible, keeping your Obsidian vault fast and responsive.
+3. **Locked Mode**: By default, diagrams are locked to allow safe scrolling. Click "Activate Interaction" to enable pan and zoom.
+
+## Features
+
+- **2D Interactive Viewer**: Pan, zoom, and explore your systems.
+- **Diagnostics**: Real-time validation of your orbital data. If a planet's period doesn't match its mass (Kepler's Laws), the plugin will tell you.
+- **Command Palette**: Use `WorldOrbit: Insert Solar System Example` to quickly bootstrap a new system.
+- **Fullscreen Mode**: Open any diagram in a high-resolution modal view for detailed inspection.
+
+## Installation
+
+### Community Plugin
+
+Search for **WorldOrbit** in the Obsidian Community Plugins settings and click Install. (Note: Submission pending).
+
+### Manual Installation
+
+1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/negurvulkan/worldorbit/releases).
+2. Create a folder `.obsidian/plugins/worldorbit` in your vault.
+3. Move the files into that folder and enable the plugin in Obsidian.
+
+## Contributing
+
+Contributions via bug reports, documentation, and improvements are welcome.
+
+### Local Development
+
+The codebase is part of a TypeScript monorepo. To set up locally:
+
+Bash
+
+```
+git clone https://github.com/negurvulkan/worldorbit.git
+cd worldorbit
+npm install
+npm run build
+```
+
+## License
+
+Licensed under the **MIT License**.
+
+![NPM Version](https://img.shields.io/npm/v/worldorbit?style=flat-square&color=cb3837&logo=npm)
+![Downloads](https://img.shields.io/npm/dm/worldorbit?style=flat-square&color=blue)
+![GitHub stars](https://img.shields.io/github/stars/negurvulkan/worldorbit?style=flat-square&color=gold)