worldorbit 2.6.0 → 3.0.1

package/dist/unpkg/viewer/dist/embed.js

@@ -0,0 +1,172 @@
+import { WorldOrbit3DUnavailableError } from "./errors.js";
+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: normalizeEmbedMode(raw.mode),
+        scene: raw.scene,
+        spatialScene: raw.spatialScene ?? undefined,
+        options: raw.options
+            ? {
+                ...raw.options,
+                viewMode: raw.options.viewMode ?? embedModeToViewMode(normalizeEmbedMode(raw.mode)),
+                initialFilter: raw.options.initialFilter ?? null,
+                atlasState: raw.options.atlasState ?? null,
+            }
+            : undefined,
+    };
+}
+export function createEmbedPayload(scene, mode, options = {}) {
+    return {
+        version: "2.0",
+        mode: normalizeEmbedMode(mode),
+        scene,
+        spatialScene: options.spatialScene,
+        options: {
+            viewMode: options.viewMode ?? embedModeToViewMode(normalizeEmbedMode(mode)),
+            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,
+            viewMode: options.viewMode ?? payload.options?.viewMode ?? embedModeToViewMode(normalizeEmbedMode(payload.mode)),
+            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="${mergedPayload.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 = normalizeEmbedMode(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;
+        const viewMode = options.viewer?.viewMode ??
+            payload.options?.viewMode ??
+            embedModeToViewMode(mode);
+        if (mode === "interactive-2d" || mode === "interactive-3d") {
+            try {
+                const viewer = createInteractiveViewer(element, {
+                    ...options.viewer,
+                    scene: payload.scene,
+                    spatialScene: payload.spatialScene,
+                    width: options.width ?? payload.scene.width,
+                    height: options.height ?? payload.scene.height,
+                    padding: options.padding ?? payload.scene.padding,
+                    preset,
+                    theme,
+                    layers,
+                    subtitle,
+                    viewMode,
+                    initialFilter,
+                    initialViewpointId,
+                    initialSelectionObjectId,
+                    minimap,
+                });
+                if (payload.options?.atlasState) {
+                    viewer.setAtlasState(payload.options.atlasState);
+                }
+                viewers.set(element, viewer);
+                options.onMount?.(viewer, element);
+            }
+            catch (error) {
+                if (error instanceof WorldOrbit3DUnavailableError && mode === "interactive-3d") {
+                    element.innerHTML = render3DUnavailableMarkup(error.message);
+                    options.onMount?.(null, element);
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+        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;");
+}
+function normalizeEmbedMode(mode) {
+    if (!mode || mode === "interactive") {
+        return "interactive-2d";
+    }
+    return mode;
+}
+function embedModeToViewMode(mode) {
+    return mode === "interactive-3d" ? "3d" : "2d";
+}
+export function render3DUnavailableMarkup(message) {
+    return `<div class="worldorbit-embed-unavailable" data-worldorbit-3d-unavailable="true"><strong>3D unavailable</strong><span>${escapeAttribute(message)}</span></div>`;
+}

package/dist/unpkg/viewer/dist/errors.d.ts

@@ -0,0 +1,6 @@
+export declare class WorldOrbitViewerError extends Error {
+    constructor(message: string);
+}
+export declare class WorldOrbit3DUnavailableError extends WorldOrbitViewerError {
+    constructor(message?: string);
+}

package/dist/unpkg/viewer/dist/errors.js

@@ -0,0 +1,12 @@
+export class WorldOrbitViewerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WorldOrbitViewerError";
+    }
+}
+export class WorldOrbit3DUnavailableError extends WorldOrbitViewerError {
+    constructor(message = "WorldOrbit 3D is unavailable in this environment.") {
+        super(message);
+        this.name = "WorldOrbit3DUnavailableError";
+    }
+}

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

@@ -0,0 +1,10 @@
+export type * from "./types.js";
+export { WorldOrbit3DUnavailableError, WorldOrbitViewerError } from "./errors.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";