worldorbit 3.2.1 → 3.2.2

package/dist/browser/obsidian-plugin/dist/viewer-host.js

@@ -0,0 +1,110 @@
+import { createInteractiveViewer2D, renderSceneToSvg, } from "@worldorbit/viewer/interactive-2d";
+export class WorldOrbitEmbeddedView {
+    options;
+    viewer = null;
+    state;
+    constructor(options) {
+        this.options = {
+            ...options,
+            createViewer: options.createViewer ?? defaultCreateViewer,
+            renderStatic: options.renderStatic ?? defaultRenderStatic,
+        };
+        this.state = {
+            interactive: options.interactive,
+            destroyed: false,
+        };
+    }
+    getState() {
+        return { ...this.state };
+    }
+    mount() {
+        if (this.state.destroyed) {
+            return;
+        }
+        this.renderCurrent();
+    }
+    setInteractive(interactive) {
+        if (this.state.destroyed || this.state.interactive === interactive) {
+            return;
+        }
+        this.state.interactive = interactive;
+        this.renderCurrent();
+    }
+    resize() {
+        if (this.state.destroyed) {
+            return;
+        }
+        if (this.viewer) {
+            const viewport = measureViewport(this.options.container, this.options.scene);
+            this.viewer.setRenderOptions(viewport);
+            return;
+        }
+        this.renderCurrent();
+    }
+    destroy() {
+        if (this.state.destroyed) {
+            return;
+        }
+        this.state.destroyed = true;
+        this.destroyViewer();
+        clearElement(this.options.container);
+    }
+    renderCurrent() {
+        this.destroyViewer();
+        clearElement(this.options.container);
+        if (this.state.interactive) {
+            const viewport = measureViewport(this.options.container, this.options.scene);
+            this.viewer = this.options.createViewer(this.options.container, {
+                scene: this.options.scene,
+                theme: this.options.theme,
+                pointer: this.options.enablePointer,
+                touch: this.options.enableTouch,
+                ...viewport,
+            });
+            return;
+        }
+        const viewport = measureViewport(this.options.container, this.options.scene);
+        this.options.container.innerHTML = this.options.renderStatic(this.options.scene, {
+            theme: this.options.theme,
+            ...viewport,
+        });
+    }
+    destroyViewer() {
+        this.viewer?.destroy();
+        this.viewer = null;
+    }
+}
+function defaultCreateViewer(container, options) {
+    return createInteractiveViewer2D(container, options.scene, {
+        theme: options.theme,
+        pointer: options.pointer,
+        touch: options.touch,
+        selection: true,
+        width: options.width,
+        height: options.height,
+    });
+}
+function defaultRenderStatic(scene, options) {
+    return renderSceneToSvg(scene, {
+        theme: options.theme,
+        width: options.width,
+        height: options.height,
+    });
+}
+function measureViewport(container, scene) {
+    const rect = container.getBoundingClientRect();
+    const width = sanitizeDimension(container.clientWidth || rect.width) ?? scene.width;
+    const height = sanitizeDimension(container.clientHeight || rect.height) ??
+        Math.max(Math.round(width * (scene.height / Math.max(scene.width, 1))), 280);
+    return { width, height };
+}
+function sanitizeDimension(value) {
+    return Number.isFinite(value) && value > 0 ? Math.round(value) : undefined;
+}
+function clearElement(element) {
+    if (typeof element.empty === "function") {
+        element.empty();
+        return;
+    }
+    element.replaceChildren();
+}

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

@@ -8,3 +8,4 @@ export { createEmbedPayload, createWorldOrbitEmbedMarkup, deserializeWorldOrbitE
 export { defineWorldOrbitViewerElement } from "./custom-element.js";
 export { createAtlasViewer } from "./atlas-viewer.js";
 export { createInteractiveViewer } from "./viewer.js";
+export { createInteractiveViewer2D } from "./interactive-2d.js";

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

@@ -7,3 +7,4 @@ export { createEmbedPayload, createWorldOrbitEmbedMarkup, deserializeWorldOrbitE
 export { defineWorldOrbitViewerElement } from "./custom-element.js";
 export { createAtlasViewer } from "./atlas-viewer.js";
 export { createInteractiveViewer } from "./viewer.js";
+export { createInteractiveViewer2D } from "./interactive-2d.js";

package/dist/browser/viewer/dist/interactive-2d.d.ts

@@ -0,0 +1,21 @@
+import type { RenderScene } from "@worldorbit/core/types";
+import type { SvgRenderOptions, ViewerState } from "./types.js";
+export interface InteractiveViewer2DOptions extends Pick<SvgRenderOptions, "width" | "height" | "padding" | "preset" | "theme" | "layers" | "subtitle"> {
+    pointer?: boolean;
+    touch?: boolean;
+    selection?: boolean;
+    minScale?: number;
+    maxScale?: number;
+    fitPadding?: number;
+}
+export interface WorldOrbitViewer2D {
+    getState(): ViewerState;
+    setState(state: Partial<ViewerState>): void;
+    setRenderOptions(options: Partial<InteractiveViewer2DOptions>): void;
+    fitToSystem(): void;
+    destroy(): void;
+}
+export { renderSceneToSvg } from "./render.js";
+export { resolveTheme } from "./theme.js";
+export type { WorldOrbitTheme } from "./types.js";
+export declare function createInteractiveViewer2D(container: HTMLElement, scene: RenderScene, options?: InteractiveViewer2DOptions): WorldOrbitViewer2D;

package/dist/browser/viewer/dist/interactive-2d.js

@@ -0,0 +1,201 @@
+import { renderSceneToSvg, WORLD_LAYER_ID } from "./render.js";
+import { DEFAULT_VIEWER_STATE, composeViewerTransform, fitViewerState, panViewerState, zoomViewerStateAt, } from "./viewer-state.js";
+export { renderSceneToSvg } from "./render.js";
+export { resolveTheme } from "./theme.js";
+const DEFAULT_VIEWER_LIMITS = {
+    minScale: 0.2,
+    maxScale: 8,
+    fitPadding: 48,
+};
+export function createInteractiveViewer2D(container, scene, options = {}) {
+    const constraints = {
+        minScale: options.minScale ?? DEFAULT_VIEWER_LIMITS.minScale,
+        maxScale: options.maxScale ?? DEFAULT_VIEWER_LIMITS.maxScale,
+        fitPadding: options.fitPadding ?? DEFAULT_VIEWER_LIMITS.fitPadding,
+    };
+    const behavior = {
+        pointer: options.pointer ?? true,
+        touch: options.touch ?? true,
+        selection: options.selection ?? true,
+    };
+    let renderOptions = {
+        width: options.width,
+        height: options.height,
+        padding: options.padding,
+        preset: options.preset,
+        theme: options.theme,
+        layers: options.layers,
+        subtitle: options.subtitle,
+        pointer: behavior.pointer,
+        touch: behavior.touch,
+        selection: behavior.selection,
+        minScale: constraints.minScale,
+        maxScale: constraints.maxScale,
+        fitPadding: constraints.fitPadding,
+    };
+    let state = fitViewerState(scene, DEFAULT_VIEWER_STATE, constraints);
+    let svgElement = null;
+    let cameraRoot = null;
+    let destroyed = false;
+    let activePointerId = null;
+    let lastPointerClientPoint = null;
+    let dragDistance = 0;
+    const previousTabIndex = container.getAttribute("tabindex");
+    const previousTouchAction = container.style.touchAction;
+    if (previousTabIndex === null) {
+        container.tabIndex = 0;
+    }
+    container.classList.add("wo-viewer-container");
+    container.style.touchAction = behavior.touch ? "none" : previousTouchAction;
+    const handleWheel = (event) => {
+        if (!behavior.pointer || destroyed || !svgElement) {
+            return;
+        }
+        event.preventDefault();
+        container.focus();
+        const anchor = getScenePointFromClient(event.clientX, event.clientY);
+        const factor = clamp(Math.exp(-event.deltaY * 0.002), 0.6, 1.6);
+        updateState(zoomViewerStateAt(scene, state, factor, anchor, constraints));
+    };
+    const handlePointerDown = (event) => {
+        if (destroyed) {
+            return;
+        }
+        const isTouch = event.pointerType === "touch";
+        if ((isTouch && !behavior.touch) || (!isTouch && !behavior.pointer)) {
+            return;
+        }
+        if (!isTouch && event.button !== 0) {
+            return;
+        }
+        activePointerId = event.pointerId;
+        lastPointerClientPoint = { x: event.clientX, y: event.clientY };
+        dragDistance = 0;
+        container.setPointerCapture?.(event.pointerId);
+        container.focus();
+    };
+    const handlePointerMove = (event) => {
+        if (destroyed || activePointerId !== event.pointerId || !lastPointerClientPoint) {
+            return;
+        }
+        const rect = svgElement?.getBoundingClientRect();
+        if (!rect || rect.width <= 0 || rect.height <= 0) {
+            return;
+        }
+        const dx = event.clientX - lastPointerClientPoint.x;
+        const dy = event.clientY - lastPointerClientPoint.y;
+        lastPointerClientPoint = { x: event.clientX, y: event.clientY };
+        dragDistance += Math.hypot(dx, dy);
+        updateState(panViewerState(state, dx * (scene.width / rect.width), dy * (scene.height / rect.height)));
+    };
+    const stopPointer = (event) => {
+        if (activePointerId !== event.pointerId) {
+            return;
+        }
+        activePointerId = null;
+        lastPointerClientPoint = null;
+        container.releasePointerCapture?.(event.pointerId);
+    };
+    const handleClick = (event) => {
+        if (destroyed || !behavior.selection || dragDistance > 6) {
+            return;
+        }
+        const objectEl = event.target?.closest(".wo-object[data-object-id]");
+        if (!objectEl) {
+            return;
+        }
+        updateState({
+            ...state,
+            selectedObjectId: objectEl.dataset.objectId ?? null,
+        });
+        renderSvg();
+    };
+    container.addEventListener("wheel", handleWheel, { passive: false });
+    container.addEventListener("pointerdown", handlePointerDown);
+    container.addEventListener("pointermove", handlePointerMove);
+    container.addEventListener("pointerup", stopPointer);
+    container.addEventListener("pointercancel", stopPointer);
+    container.addEventListener("click", handleClick);
+    renderSvg();
+    return {
+        getState() {
+            return { ...state };
+        },
+        setState(nextState) {
+            updateState({
+                ...state,
+                ...nextState,
+            });
+            if ("selectedObjectId" in nextState) {
+                renderSvg();
+            }
+        },
+        setRenderOptions(nextOptions) {
+            renderOptions = {
+                ...renderOptions,
+                ...nextOptions,
+            };
+            renderSvg();
+        },
+        fitToSystem() {
+            updateState(fitViewerState(scene, state, constraints));
+        },
+        destroy() {
+            if (destroyed) {
+                return;
+            }
+            destroyed = true;
+            container.removeEventListener("wheel", handleWheel);
+            container.removeEventListener("pointerdown", handlePointerDown);
+            container.removeEventListener("pointermove", handlePointerMove);
+            container.removeEventListener("pointerup", stopPointer);
+            container.removeEventListener("pointercancel", stopPointer);
+            container.removeEventListener("click", handleClick);
+            if (previousTabIndex === null) {
+                container.removeAttribute("tabindex");
+            }
+            container.style.touchAction = previousTouchAction;
+            container.replaceChildren();
+            svgElement = null;
+            cameraRoot = null;
+        },
+    };
+    function renderSvg() {
+        if (destroyed) {
+            return;
+        }
+        container.innerHTML = renderSceneToSvg(scene, {
+            width: renderOptions.width,
+            height: renderOptions.height,
+            padding: renderOptions.padding,
+            preset: renderOptions.preset,
+            theme: renderOptions.theme,
+            layers: renderOptions.layers,
+            subtitle: renderOptions.subtitle,
+            selectedObjectId: state.selectedObjectId,
+        });
+        svgElement = container.querySelector("svg");
+        cameraRoot = container.querySelector(`[data-worldorbit-camera-root="${WORLD_LAYER_ID}"]`);
+        applyTransform();
+    }
+    function applyTransform() {
+        cameraRoot?.setAttribute("transform", composeViewerTransform(scene, state));
+    }
+    function updateState(nextState) {
+        state = nextState;
+        applyTransform();
+    }
+    function getScenePointFromClient(clientX, clientY) {
+        const rect = svgElement?.getBoundingClientRect();
+        if (!rect || rect.width <= 0 || rect.height <= 0) {
+            return { x: scene.width / 2, y: scene.height / 2 };
+        }
+        return {
+            x: ((clientX - rect.left) / rect.width) * scene.width,
+            y: ((clientY - rect.top) / rect.height) * scene.height,
+        };
+    }
+}
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}

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

@@ -1,4 +1,4 @@
-import { type RenderScene, type WorldOrbitDocument } from "@worldorbit/core";
+import { type RenderScene, type WorldOrbitDocument } from "@worldorbit/core/types";
 import type { SvgRenderOptions } from "./types.js";
 export declare const WORLD_LAYER_ID = "worldorbit-camera-root";
 export declare function renderSceneToSvg(scene: RenderScene, options?: SvgRenderOptions): string;

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

@@ -1,4 +1,5 @@
-import { loadWorldOrbitSource, renderDocumentToScene, } from "@worldorbit/core";
+import { loadWorldOrbitSource } from "@worldorbit/core/load";
+import { renderDocumentToScene } from "@worldorbit/core/scene";
 import { computeVisibleObjectIds } from "./atlas-state.js";
 import { resolveLayers, resolveTheme } from "./theme.js";
 export const WORLD_LAYER_ID = "worldorbit-camera-root";

package/dist/browser/viewer/dist/viewer-state.d.ts

@@ -1,4 +1,4 @@
-import { type CoordinatePoint, type RenderBounds, type RenderScene } from "@worldorbit/core";
+import { type CoordinatePoint, type RenderBounds, type RenderScene } from "@worldorbit/core/types";
 import type { ViewerState } from "./types.js";
 export interface ViewerConstraints {
     minScale: number;

package/dist/browser/viewer/dist/viewer-state.js

@@ -1,4 +1,4 @@
-import { rotatePoint, } from "@worldorbit/core";
+import { rotatePoint } from "@worldorbit/core/scene";
 export const DEFAULT_VIEWER_STATE = {
     scale: 1,
     rotationDeg: 0,

package/dist/obsidian-plugin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hanjo Winter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/obsidian-plugin/README.md

@@ -0,0 +1,124 @@
+
+
+ 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