worldorbit 2.5.1-5.2

package/packages/viewer/dist/embed.js

@@ -0,0 +1,138 @@
+import { renderSceneToSvg } from "./render.js";
+import { createInteractiveViewer } from "./viewer.js";
+const EMBED_SELECTOR = "[data-worldorbit-embed]";
+export function serializeWorldOrbitEmbedPayload(payload) {
+    return encodeURIComponent(JSON.stringify(payload));
+}
+export function deserializeWorldOrbitEmbedPayload(serialized) {
+    const raw = JSON.parse(decodeURIComponent(serialized));
+    return {
+        version: "2.0",
+        mode: raw.mode ?? "interactive",
+        scene: raw.scene,
+        options: raw.options
+            ? {
+                ...raw.options,
+                initialFilter: raw.options.initialFilter ?? null,
+                atlasState: raw.options.atlasState ?? null,
+            }
+            : undefined,
+    };
+}
+export function createEmbedPayload(scene, mode, options = {}) {
+    return {
+        version: "2.0",
+        mode,
+        scene,
+        options: {
+            initialViewpointId: options.initialViewpointId,
+            initialSelectionObjectId: options.initialSelectionObjectId,
+            initialFilter: options.initialFilter ?? null,
+            atlasState: options.atlasState ?? null,
+            minimap: options.minimap,
+        },
+    };
+}
+export function createWorldOrbitEmbedMarkup(payload, options = {}) {
+    const mergedPayload = {
+        ...payload,
+        options: {
+            ...payload.options,
+            theme: options.theme ?? payload.options?.theme,
+            layers: options.layers ?? payload.options?.layers,
+            subtitle: options.subtitle ?? payload.options?.subtitle,
+            preset: options.preset ?? payload.options?.preset,
+            initialViewpointId: options.initialViewpointId ?? payload.options?.initialViewpointId,
+            initialSelectionObjectId: options.initialSelectionObjectId ?? payload.options?.initialSelectionObjectId,
+            initialFilter: options.initialFilter ?? payload.options?.initialFilter ?? null,
+            atlasState: options.atlasState ?? payload.options?.atlasState ?? null,
+            minimap: options.minimap ?? payload.options?.minimap,
+        },
+    };
+    const html = renderSceneToSvg(payload.scene, {
+        theme: mergedPayload.options?.theme,
+        layers: mergedPayload.options?.layers,
+        filter: mergedPayload.options?.initialFilter ?? null,
+        selectedObjectId: mergedPayload.options?.initialSelectionObjectId ?? null,
+        subtitle: mergedPayload.options?.subtitle,
+        preset: mergedPayload.options?.preset,
+    });
+    return `<div class="${escapeAttribute(options.className ?? "worldorbit-embed")}" data-worldorbit-embed="true" data-worldorbit-mode="${payload.mode}" data-worldorbit-preset="${escapeAttribute(mergedPayload.options?.preset ?? payload.scene.renderPreset ?? "custom")}" data-worldorbit-viewpoint="${escapeAttribute(mergedPayload.options?.initialViewpointId ?? "")}" data-worldorbit-payload="${escapeAttribute(serializeWorldOrbitEmbedPayload(mergedPayload))}">${html}</div>`;
+}
+export function mountWorldOrbitEmbeds(root = document, options = {}) {
+    const viewers = new Map();
+    const elements = [...root.querySelectorAll(EMBED_SELECTOR)];
+    for (const element of elements) {
+        const payload = deserializePayloadFromElement(element);
+        const mode = options.mode ?? payload.mode;
+        const theme = options.theme ?? payload.options?.theme;
+        const layers = options.layers ?? payload.options?.layers;
+        const subtitle = options.subtitle ?? payload.options?.subtitle;
+        const preset = options.preset ?? payload.options?.preset ?? payload.scene.renderPreset ?? undefined;
+        const initialFilter = options.viewer?.initialFilter ?? payload.options?.initialFilter ?? null;
+        const initialViewpointId = options.viewer?.initialViewpointId ?? payload.options?.initialViewpointId;
+        const initialSelectionObjectId = options.viewer?.initialSelectionObjectId ?? payload.options?.initialSelectionObjectId;
+        const minimap = options.viewer?.minimap ?? payload.options?.minimap;
+        if (mode === "interactive") {
+            const viewer = createInteractiveViewer(element, {
+                ...options.viewer,
+                scene: payload.scene,
+                width: options.width ?? payload.scene.width,
+                height: options.height ?? payload.scene.height,
+                padding: options.padding ?? payload.scene.padding,
+                preset,
+                theme,
+                layers,
+                subtitle,
+                initialFilter,
+                initialViewpointId,
+                initialSelectionObjectId,
+                minimap,
+            });
+            if (payload.options?.atlasState) {
+                viewer.setAtlasState(payload.options.atlasState);
+            }
+            viewers.set(element, viewer);
+            options.onMount?.(viewer, element);
+        }
+        else {
+            element.innerHTML = renderSceneToSvg(payload.scene, {
+                width: options.width ?? payload.scene.width,
+                height: options.height ?? payload.scene.height,
+                padding: options.padding ?? payload.scene.padding,
+                preset,
+                theme,
+                layers,
+                filter: initialFilter,
+                selectedObjectId: initialSelectionObjectId ?? null,
+                subtitle,
+            });
+            options.onMount?.(null, element);
+        }
+        element.dataset.worldorbitMounted = "true";
+    }
+    return {
+        viewers: [...viewers.values()],
+        destroy() {
+            for (const [element, viewer] of viewers.entries()) {
+                viewer.destroy();
+                element.removeAttribute("data-worldorbit-mounted");
+            }
+            viewers.clear();
+        },
+    };
+}
+function deserializePayloadFromElement(element) {
+    const serialized = element.dataset.worldorbitPayload;
+    if (!serialized) {
+        throw new Error("WorldOrbit embed is missing data-worldorbit-payload.");
+    }
+    return deserializeWorldOrbitEmbedPayload(serialized);
+}
+function escapeAttribute(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll("\"", "&quot;");
+}

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

@@ -0,0 +1,9 @@
+export type * from "./types.js";
+export { getThemePreset, resolveLayers, resolveTheme } from "./theme.js";
+export { deserializeViewerAtlasState, normalizeViewerFilter, sceneViewpointToLayerOptions, searchSceneObjects, serializeViewerAtlasState, viewpointToViewerFilter, } from "./atlas-state.js";
+export { DEFAULT_VIEWER_STATE, clampScale, composeViewerTransform, fitViewerState, focusViewerState, getViewerVisibleBounds, invertViewerPoint, getSceneCenter, normalizeRotation, panViewerState, rotateViewerState, zoomViewerStateAt, } from "./viewer-state.js";
+export { WORLD_LAYER_ID, renderDocumentToSvg, renderSceneToSvg, renderSourceToSvg, } from "./render.js";
+export { createEmbedPayload, createWorldOrbitEmbedMarkup, deserializeWorldOrbitEmbedPayload, mountWorldOrbitEmbeds, serializeWorldOrbitEmbedPayload, } from "./embed.js";
+export { defineWorldOrbitViewerElement } from "./custom-element.js";
+export { createAtlasViewer } from "./atlas-viewer.js";
+export { createInteractiveViewer } from "./viewer.js";

package/packages/viewer/dist/index.js

@@ -0,0 +1,8 @@
+export { getThemePreset, resolveLayers, resolveTheme } from "./theme.js";
+export { deserializeViewerAtlasState, normalizeViewerFilter, sceneViewpointToLayerOptions, searchSceneObjects, serializeViewerAtlasState, viewpointToViewerFilter, } from "./atlas-state.js";
+export { DEFAULT_VIEWER_STATE, clampScale, composeViewerTransform, fitViewerState, focusViewerState, getViewerVisibleBounds, invertViewerPoint, getSceneCenter, normalizeRotation, panViewerState, rotateViewerState, zoomViewerStateAt, } from "./viewer-state.js";
+export { WORLD_LAYER_ID, renderDocumentToSvg, renderSceneToSvg, renderSourceToSvg, } from "./render.js";
+export { createEmbedPayload, createWorldOrbitEmbedMarkup, deserializeWorldOrbitEmbedPayload, mountWorldOrbitEmbeds, serializeWorldOrbitEmbedPayload, } from "./embed.js";
+export { defineWorldOrbitViewerElement } from "./custom-element.js";
+export { createAtlasViewer } from "./atlas-viewer.js";
+export { createInteractiveViewer } from "./viewer.js";

package/packages/viewer/dist/minimap.d.ts

@@ -0,0 +1,3 @@
+import type { RenderScene, RenderSceneObject } from "@worldorbit/core";
+import type { ViewerState } from "./types.js";
+export declare function renderViewerMinimap(scene: RenderScene, state: ViewerState, visibleObjects: RenderSceneObject[]): string;

package/packages/viewer/dist/minimap.js

@@ -0,0 +1,63 @@
+import { getViewerVisibleBounds } from "./viewer-state.js";
+const MINIMAP_WIDTH = 180;
+const MINIMAP_HEIGHT = 120;
+const MINIMAP_PADDING = 10;
+export function renderViewerMinimap(scene, state, visibleObjects) {
+    const bounds = scene.contentBounds.width > 0 && scene.contentBounds.height > 0
+        ? scene.contentBounds
+        : {
+            minX: 0,
+            minY: 0,
+            maxX: scene.width,
+            maxY: scene.height,
+            width: scene.width,
+            height: scene.height,
+            centerX: scene.width / 2,
+            centerY: scene.height / 2,
+        };
+    const scale = Math.min((MINIMAP_WIDTH - MINIMAP_PADDING * 2) / Math.max(bounds.width, 1), (MINIMAP_HEIGHT - MINIMAP_PADDING * 2) / Math.max(bounds.height, 1));
+    const translateX = (MINIMAP_WIDTH - bounds.width * scale) / 2 - bounds.minX * scale;
+    const translateY = (MINIMAP_HEIGHT - bounds.height * scale) / 2 - bounds.minY * scale;
+    const viewport = getViewerVisibleBounds(scene, state);
+    const objectsMarkup = visibleObjects
+        .map((object) => {
+        const x = object.x * scale + translateX;
+        const y = object.y * scale + translateY;
+        const radius = Math.max(1.4, Math.min(object.visualRadius * scale, 5.2));
+        const fill = object.fillColor ?? minimapColorForObject(object.object.type);
+        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>
+</div>`;
+}
+function minimapColorForObject(type) {
+    switch (type) {
+        case "star":
+            return "#ffcc67";
+        case "planet":
+            return "#72b7ff";
+        case "moon":
+            return "#c7d7ea";
+        case "belt":
+        case "ring":
+            return "#d9aa74";
+        case "asteroid":
+            return "#a7a5b8";
+        case "comet":
+            return "#9ce7ff";
+        case "structure":
+            return "#ff7f5f";
+        case "phenomenon":
+            return "#78ffd7";
+    }
+}
+function formatNumber(value) {
+    return Number.isInteger(value) ? String(value) : value.toFixed(2);
+}

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

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