worldorbit 2.5.16 → 2.6.0

package/dist/unpkg/editor/dist/index.js

@@ -565,6 +565,7 @@ var WorldOrbit = (() => {
       system,
       groups: [],
       relations: [],
+      events: [],
       objects
     };
   }
@@ -944,12 +945,16 @@ var WorldOrbit = (() => {
     const height = frame.height;
     const padding = frame.padding;
     const layoutPreset = resolveLayoutPreset(document2);
-    const projection = resolveProjection(document2, options.projection);
+    const schemaProjection = resolveProjection(document2, options.projection);
+    const camera = normalizeViewCamera(options.camera ?? null);
+    const renderProjection = resolveRenderProjection(schemaProjection, camera);
     const scaleModel = resolveScaleModel(layoutPreset, options.scaleModel);
     const spacingFactor = layoutPresetSpacing(layoutPreset);
     const systemId = document2.system?.id ?? null;
-    const objectMap = new Map(document2.objects.map((object) => [object.id, object]));
-    const relationships = buildSceneRelationships(document2.objects, objectMap);
+    const activeEventId = options.activeEventId ?? null;
+    const effectiveObjects = createEffectiveObjects(document2.objects, document2.events ?? [], activeEventId);
+    const objectMap = new Map(effectiveObjects.map((object) => [object.id, object]));
+    const relationships = buildSceneRelationships(effectiveObjects, objectMap);
     const positions = /* @__PURE__ */ new Map();
     const orbitDrafts = [];
     const leaderDrafts = [];
@@ -958,7 +963,7 @@ var WorldOrbit = (() => {
     const atObjects = [];
     const surfaceChildren = /* @__PURE__ */ new Map();
     const orbitChildren = /* @__PURE__ */ new Map();
-    for (const object of document2.objects) {
+    for (const object of effectiveObjects) {
       const placement = object.placement;
       if (!placement) {
         rootObjects.push(object);
@@ -985,7 +990,7 @@ var WorldOrbit = (() => {
       surfaceChildren,
       objectMap,
       spacingFactor,
-      projection,
+      projection: renderProjection,
       scaleModel
     };
     const primaryRoot = rootObjects.find((object) => object.type === "star") ?? rootObjects[0] ?? null;
@@ -997,7 +1002,7 @@ var WorldOrbit = (() => {
       const rootRingRadius = Math.min(width, height) * 0.28 * spacingFactor * scaleModel.orbitDistanceMultiplier;
       secondaryRoots.forEach((object, index) => {
         const angle = angleForIndex(index, secondaryRoots.length, -Math.PI / 2);
-        const offset = projectPolarOffset(angle, rootRingRadius, projection, 1);
+        const offset = projectPolarOffset(angle, rootRingRadius, renderProjection, 1);
         placeObject(object, centerX + offset.x, centerY + offset.y, 0, positions, orbitDrafts, leaderDrafts, context);
       });
     }
@@ -1053,38 +1058,48 @@ var WorldOrbit = (() => {
     const objects = [...positions.values()].map((position) => createSceneObject(position, scaleModel, relationships));
     const orbitVisuals = orbitDrafts.map((draft) => createOrbitVisual(draft, relationships.groupIds.get(draft.object.id) ?? null));
     const leaders = leaderDrafts.map((draft) => createLeaderLine(draft));
-    const labels = createSceneLabels(objects, height, scaleModel.labelMultiplier);
+    const labels = createSceneLabels(objects, width, height, scaleModel.labelMultiplier);
     const relations = createSceneRelations(document2, objects);
-    const layers = createSceneLayers(orbitVisuals, relations, leaders, objects, labels);
-    const groups = createSceneGroups(objects, orbitVisuals, leaders, labels, relationships);
+    const events = createSceneEvents(document2.events ?? [], objects, activeEventId);
+    const layers = createSceneLayers(orbitVisuals, relations, events, leaders, objects, labels);
+    const groups = createSceneGroups(objects, orbitVisuals, leaders, labels, relationships, scaleModel.labelMultiplier);
     const semanticGroups = createSceneSemanticGroups(document2, objects);
-    const viewpoints = createSceneViewpoints(document2, projection, frame.preset, relationships, objectMap);
-    const contentBounds = calculateContentBounds(width, height, objects, orbitVisuals, leaders, labels);
+    const viewpoints = createSceneViewpoints(document2, schemaProjection, frame.preset, relationships, objectMap);
+    const contentBounds = calculateContentBounds(width, height, objects, orbitVisuals, leaders, labels, scaleModel.labelMultiplier);
     return {
       width,
       height,
       padding,
       renderPreset: frame.preset,
-      projection,
+      projection: schemaProjection,
+      renderProjection,
+      camera,
       scaleModel,
       title: String(document2.system?.title ?? document2.system?.properties.title ?? document2.system?.id ?? "WorldOrbit") || "WorldOrbit",
-      subtitle: `${capitalizeLabel(projection)} view - ${capitalizeLabel(layoutPreset)} layout`,
+      subtitle: buildSceneSubtitle(schemaProjection, renderProjection, layoutPreset, camera),
       systemId,
-      viewMode: projection,
+      viewMode: schemaProjection,
       layoutPreset,
       metadata: {
         format: document2.format,
         version: document2.version,
-        view: projection,
+        view: schemaProjection,
+        renderProjection,
         scale: String(document2.system?.properties.scale ?? layoutPreset),
         units: String(document2.system?.properties.units ?? "mixed"),
-        preset: frame.preset ?? "custom"
+        preset: frame.preset ?? "custom",
+        ...camera?.azimuth !== null ? { "camera.azimuth": String(camera?.azimuth) } : {},
+        ...camera?.elevation !== null ? { "camera.elevation": String(camera?.elevation) } : {},
+        ...camera?.roll !== null ? { "camera.roll": String(camera?.roll) } : {},
+        ...camera?.distance !== null ? { "camera.distance": String(camera?.distance) } : {}
       },
       contentBounds,
       layers,
       groups,
       semanticGroups,
       viewpoints,
+      events,
+      activeEventId,
       objects,
       orbitVisuals,
       relations,
@@ -1103,6 +1118,56 @@ var WorldOrbit = (() => {
       y: center.y + dx * sin + dy * cos
     };
   }
+  function createEffectiveObjects(objects, events, activeEventId) {
+    const cloned = objects.map((object) => structuredClone(object));
+    if (!activeEventId) {
+      return cloned;
+    }
+    const activeEvent = events.find((event) => event.id === activeEventId);
+    if (!activeEvent) {
+      return cloned;
+    }
+    const objectMap = new Map(cloned.map((object) => [object.id, object]));
+    const referencedIds = /* @__PURE__ */ new Set([
+      ...activeEvent.targetObjectId ? [activeEvent.targetObjectId] : [],
+      ...activeEvent.participantObjectIds,
+      ...activeEvent.positions.map((pose) => pose.objectId)
+    ]);
+    for (const objectId of referencedIds) {
+      const object = objectMap.get(objectId);
+      if (!object) {
+        continue;
+      }
+      if (activeEvent.epoch) {
+        object.epoch = activeEvent.epoch;
+      }
+      if (activeEvent.referencePlane) {
+        object.referencePlane = activeEvent.referencePlane;
+      }
+    }
+    for (const pose of activeEvent.positions) {
+      const object = objectMap.get(pose.objectId);
+      if (!object) {
+        continue;
+      }
+      if (pose.placement) {
+        object.placement = structuredClone(pose.placement);
+      }
+      if (pose.inner) {
+        object.properties.inner = { ...pose.inner };
+      }
+      if (pose.outer) {
+        object.properties.outer = { ...pose.outer };
+      }
+      if (pose.epoch) {
+        object.epoch = pose.epoch;
+      }
+      if (pose.referencePlane) {
+        object.referencePlane = pose.referencePlane;
+      }
+    }
+    return cloned;
+  }
   function resolveLayoutPreset(document2) {
     const rawScale = String(document2.system?.properties.scale ?? "balanced").toLowerCase();
     switch (rawScale) {
@@ -1139,10 +1204,59 @@ var WorldOrbit = (() => {
     }
   }
   function resolveProjection(document2, projection) {
-    if (projection === "topdown" || projection === "isometric") {
+    if (projection === "topdown" || projection === "isometric" || projection === "orthographic" || projection === "perspective") {
       return projection;
     }
-    return String(document2.system?.properties.view ?? "topdown").toLowerCase() === "isometric" ? "isometric" : "topdown";
+    const documentView = String(document2.system?.properties.view ?? "topdown").toLowerCase();
+    return parseViewProjection(documentView) ?? "topdown";
+  }
+  function resolveRenderProjection(projection, camera) {
+    switch (projection) {
+      case "topdown":
+        return "topdown";
+      case "isometric":
+        return "isometric";
+      case "orthographic":
+        return camera && (camera.azimuth !== null || camera.elevation !== null || camera.roll !== null) ? "isometric" : "topdown";
+      case "perspective":
+        return "isometric";
+    }
+  }
+  function normalizeViewCamera(camera) {
+    if (!camera) {
+      return null;
+    }
+    const normalized = {
+      azimuth: normalizeFiniteCameraValue(camera.azimuth),
+      elevation: normalizeFiniteCameraValue(camera.elevation),
+      roll: normalizeFiniteCameraValue(camera.roll),
+      distance: normalizePositiveCameraDistance(camera.distance)
+    };
+    return normalized.azimuth !== null || normalized.elevation !== null || normalized.roll !== null || normalized.distance !== null ? normalized : null;
+  }
+  function normalizeFiniteCameraValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+  }
+  function normalizePositiveCameraDistance(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : null;
+  }
+  function buildSceneSubtitle(projection, renderProjection, layoutPreset, camera) {
+    const parts = [`${capitalizeLabel(projection)} view`, `${capitalizeLabel(layoutPreset)} layout`];
+    if (projection !== renderProjection) {
+      parts.push(`2D ${renderProjection} fallback`);
+    }
+    if (camera) {
+      const cameraParts = [
+        camera.azimuth !== null ? `az ${camera.azimuth}` : null,
+        camera.elevation !== null ? `el ${camera.elevation}` : null,
+        camera.roll !== null ? `roll ${camera.roll}` : null,
+        camera.distance !== null ? `dist ${camera.distance}` : null
+      ].filter(Boolean);
+      if (cameraParts.length > 0) {
+        parts.push(`camera ${cameraParts.join(" / ")}`);
+      }
+    }
+    return parts.join(" - ");
   }
   function resolveScaleModel(layoutPreset, overrides) {
     const defaults = defaultScaleModel(layoutPreset);
@@ -1258,24 +1372,14 @@ var WorldOrbit = (() => {
       hidden: draft.object.properties.hidden === true
     };
   }
-  function createSceneLabels(objects, sceneHeight, labelMultiplier) {
+  function createSceneLabels(objects, sceneWidth, sceneHeight, labelMultiplier) {
     const labels = [];
     const occupied = [];
-    const visibleObjects = [...objects].filter((object) => !object.hidden && object.object.renderHints?.renderLabel !== false).sort((left, right) => left.sortKey - right.sortKey);
+    const objectMap = new Map(objects.map((object) => [object.objectId, object]));
+    const visibleObjects = [...objects].filter((object) => !object.hidden && object.object.renderHints?.renderLabel !== false).sort(compareLabelPlacementOrder);
     for (const object of visibleObjects) {
-      const direction = object.y > sceneHeight * 0.62 ? -1 : 1;
-      const labelHalfWidth = estimateLabelHalfWidth(object, labelMultiplier);
-      let labelY = object.y + direction * (object.radius + 18 * labelMultiplier);
-      let secondaryY = labelY + direction * (16 * labelMultiplier);
-      let bounds = createLabelRect(object.x, labelY, secondaryY, labelHalfWidth, direction);
-      let attempts = 0;
-      while (occupied.some((entry) => rectsOverlap(entry, bounds)) && attempts < 10) {
-        labelY += direction * 14 * labelMultiplier;
-        secondaryY += direction * 14 * labelMultiplier;
-        bounds = createLabelRect(object.x, labelY, secondaryY, labelHalfWidth, direction);
-        attempts += 1;
-      }
-      occupied.push(bounds);
+      const placement = selectLabelPlacement(object, objectMap, occupied, sceneWidth, sceneHeight, labelMultiplier) ?? createLabelPlacement(object, defaultVerticalDirection(object, objectMap.get(object.parentId ?? "") ?? null, sceneHeight), 0, labelMultiplier);
+      occupied.push(createLabelRect(object, placement, labelMultiplier));
       labels.push({
         renderId: `${object.renderId}-label`,
         objectId: object.objectId,
@@ -1284,17 +1388,128 @@ var WorldOrbit = (() => {
         semanticGroupIds: [...object.semanticGroupIds],
         label: object.label,
         secondaryLabel: object.secondaryLabel,
-        x: object.x,
-        y: labelY,
-        secondaryY,
-        textAnchor: "middle",
-        direction: direction < 0 ? "above" : "below",
+        x: placement.x,
+        y: placement.labelY,
+        secondaryY: placement.secondaryY,
+        textAnchor: placement.textAnchor,
+        direction: placement.direction,
         hidden: object.hidden
       });
     }
     return labels;
   }
-  function createSceneLayers(orbitVisuals, relations, leaders, objects, labels) {
+  function compareLabelPlacementOrder(left, right) {
+    const priorityDiff = labelPlacementPriority(left) - labelPlacementPriority(right);
+    if (priorityDiff !== 0) {
+      return priorityDiff;
+    }
+    const renderPriorityDiff = (right.object.renderHints?.renderPriority ?? 0) - (left.object.renderHints?.renderPriority ?? 0);
+    if (renderPriorityDiff !== 0) {
+      return renderPriorityDiff;
+    }
+    return left.sortKey - right.sortKey;
+  }
+  function labelPlacementPriority(object) {
+    switch (object.object.type) {
+      case "star":
+        return 0;
+      case "planet":
+        return 1;
+      case "moon":
+        return 2;
+      case "belt":
+      case "ring":
+        return 3;
+      case "asteroid":
+      case "comet":
+        return 4;
+      case "structure":
+      case "phenomenon":
+        return 5;
+    }
+  }
+  function selectLabelPlacement(object, objectMap, occupied, sceneWidth, sceneHeight, labelMultiplier) {
+    for (const direction of preferredLabelDirections(object, objectMap, sceneWidth, sceneHeight)) {
+      const maxAttempts = direction === "left" || direction === "right" ? 4 : 6;
+      for (let attempt = 0; attempt <= maxAttempts; attempt += 1) {
+        const placement = createLabelPlacement(object, direction, attempt, labelMultiplier);
+        const rect = createLabelRect(object, placement, labelMultiplier);
+        if (!occupied.some((entry) => rectsOverlap(entry, rect))) {
+          return placement;
+        }
+      }
+    }
+    return null;
+  }
+  function preferredLabelDirections(object, objectMap, sceneWidth, sceneHeight) {
+    const parent = object.parentId ? objectMap.get(object.parentId) ?? null : null;
+    const vertical = defaultVerticalDirection(object, parent, sceneHeight);
+    const oppositeVertical = vertical === "below" ? "above" : "below";
+    const horizontal = defaultHorizontalDirection(object, parent, sceneWidth);
+    const oppositeHorizontal = horizontal === "right" ? "left" : "right";
+    const preferHorizontal = object.object.type === "structure" || object.object.type === "phenomenon" || object.object.placement?.mode === "at" || object.object.placement?.mode === "surface" || object.object.placement?.mode === "free";
+    return preferHorizontal ? [horizontal, vertical, oppositeHorizontal, oppositeVertical] : [vertical, horizontal, oppositeVertical, oppositeHorizontal];
+  }
+  function defaultVerticalDirection(object, parent, sceneHeight) {
+    if (parent && Math.abs(object.y - parent.y) > 6) {
+      return object.y >= parent.y ? "below" : "above";
+    }
+    return object.y > sceneHeight * 0.62 ? "above" : "below";
+  }
+  function defaultHorizontalDirection(object, parent, sceneWidth) {
+    if (parent && Math.abs(object.x - parent.x) > 6) {
+      return object.x >= parent.x ? "right" : "left";
+    }
+    return object.x >= sceneWidth / 2 ? "right" : "left";
+  }
+  function createLabelPlacement(object, direction, attempt, labelMultiplier) {
+    const step = 14 * labelMultiplier;
+    switch (direction) {
+      case "above": {
+        const labelY = object.y - (object.radius + 18 * labelMultiplier + attempt * step);
+        return {
+          x: object.x,
+          labelY,
+          secondaryY: labelY - 16 * labelMultiplier,
+          textAnchor: "middle",
+          direction
+        };
+      }
+      case "below": {
+        const labelY = object.y + object.radius + 18 * labelMultiplier + attempt * step;
+        return {
+          x: object.x,
+          labelY,
+          secondaryY: labelY + 16 * labelMultiplier,
+          textAnchor: "middle",
+          direction
+        };
+      }
+      case "left": {
+        const x = object.x - (object.visualRadius + 16 * labelMultiplier + attempt * step);
+        const labelY = object.y - 4 * labelMultiplier;
+        return {
+          x,
+          labelY,
+          secondaryY: labelY + 16 * labelMultiplier,
+          textAnchor: "end",
+          direction
+        };
+      }
+      case "right": {
+        const x = object.x + object.visualRadius + 16 * labelMultiplier + attempt * step;
+        const labelY = object.y - 4 * labelMultiplier;
+        return {
+          x,
+          labelY,
+          secondaryY: labelY + 16 * labelMultiplier,
+          textAnchor: "start",
+          direction
+        };
+      }
+    }
+  }
+  function createSceneLayers(orbitVisuals, relations, events, leaders, objects, labels) {
     const backOrbitIds = orbitVisuals.filter((visual) => !visual.hidden && Boolean(visual.backArcPath)).map((visual) => visual.renderId);
     const frontOrbitIds = orbitVisuals.filter((visual) => !visual.hidden).map((visual) => visual.renderId);
     return [
@@ -1309,6 +1524,10 @@ var WorldOrbit = (() => {
         id: "relations",
         renderIds: relations.filter((relation) => !relation.hidden).map((relation) => relation.renderId)
       },
+      {
+        id: "events",
+        renderIds: events.filter((event) => !event.hidden).map((event) => event.renderId)
+      },
       {
         id: "objects",
         renderIds: objects.filter((object) => !object.hidden).map((object) => object.renderId)
@@ -1320,7 +1539,7 @@ var WorldOrbit = (() => {
       { id: "metadata", renderIds: ["wo-title", "wo-subtitle", "wo-meta"] }
     ];
   }
-  function createSceneGroups(objects, orbitVisuals, leaders, labels, relationships) {
+  function createSceneGroups(objects, orbitVisuals, leaders, labels, relationships, labelMultiplier) {
     const groups = /* @__PURE__ */ new Map();
     const ensureGroup = (groupId) => {
       if (!groupId) {
@@ -1369,7 +1588,7 @@ var WorldOrbit = (() => {
       }
     }
     for (const group of groups.values()) {
-      group.contentBounds = calculateGroupBounds(group, objects, orbitVisuals, leaders, labels);
+      group.contentBounds = calculateGroupBounds(group, objects, orbitVisuals, leaders, labels, labelMultiplier);
     }
     return [...groups.values()].sort((left, right) => left.label.localeCompare(right.label));
   }
@@ -1403,6 +1622,29 @@ var WorldOrbit = (() => {
       };
     }).sort((left, right) => left.relation.id.localeCompare(right.relation.id));
   }
+  function createSceneEvents(events, objects, activeEventId) {
+    const objectMap = new Map(objects.map((object) => [object.objectId, object]));
+    return events.map((event) => {
+      const objectIds = [.../* @__PURE__ */ new Set([
+        ...event.targetObjectId ? [event.targetObjectId] : [],
+        ...event.participantObjectIds
+      ])];
+      const positions = objectIds.map((objectId) => objectMap.get(objectId)).filter(Boolean);
+      const centroidX = positions.length > 0 ? positions.reduce((sum, object) => sum + object.x, 0) / positions.length : 0;
+      const centroidY = positions.length > 0 ? positions.reduce((sum, object) => sum + object.y, 0) / positions.length : 0;
+      return {
+        renderId: `${createRenderId(event.id)}-event`,
+        eventId: event.id,
+        event,
+        objectIds,
+        participantIds: [...event.participantObjectIds],
+        targetObjectId: event.targetObjectId,
+        x: centroidX,
+        y: centroidY,
+        hidden: event.hidden || positions.length === 0 || positions.every((object) => object.hidden) || activeEventId !== null && event.id !== activeEventId
+      };
+    }).sort((left, right) => left.event.id.localeCompare(right.event.id));
+  }
   function createSceneViewpoints(document2, projection, preset, relationships, objectMap) {
     const generatedOverview = createGeneratedOverviewViewpoint(document2, projection, preset);
     const drafts = /* @__PURE__ */ new Map();
@@ -1450,13 +1692,18 @@ var WorldOrbit = (() => {
   function createGeneratedOverviewViewpoint(document2, projection, preset) {
     const title = document2.system?.title ?? document2.system?.properties.title;
     const label = title ? `${String(title)} Overview` : "Overview";
+    const camera = normalizeViewCamera(null);
+    const renderProjection = resolveRenderProjection(projection, camera);
     return {
       id: "overview",
       label,
       summary: "Fit the whole system with the current atlas defaults.",
       objectId: null,
       selectedObjectId: null,
+      eventIds: [],
       projection,
+      renderProjection,
+      camera,
       preset,
       rotationDeg: 0,
       scale: null,
@@ -1492,6 +1739,9 @@ var WorldOrbit = (() => {
           draft.select = normalizedValue;
         }
         return;
+      case "events":
+        draft.eventIds = splitListValue(normalizedValue);
+        return;
       case "projection":
       case "view":
         draft.projection = parseViewProjection(normalizedValue) ?? projection;
@@ -1503,6 +1753,30 @@ var WorldOrbit = (() => {
       case "angle":
         draft.rotationDeg = parseFiniteNumber(normalizedValue) ?? draft.rotationDeg ?? 0;
         return;
+      case "camera.azimuth":
+        draft.camera = {
+          ...draft.camera ?? createEmptyViewCamera(),
+          azimuth: parseFiniteNumber(normalizedValue)
+        };
+        return;
+      case "camera.elevation":
+        draft.camera = {
+          ...draft.camera ?? createEmptyViewCamera(),
+          elevation: parseFiniteNumber(normalizedValue)
+        };
+        return;
+      case "camera.roll":
+        draft.camera = {
+          ...draft.camera ?? createEmptyViewCamera(),
+          roll: parseFiniteNumber(normalizedValue)
+        };
+        return;
+      case "camera.distance":
+        draft.camera = {
+          ...draft.camera ?? createEmptyViewCamera(),
+          distance: parsePositiveNumber(normalizedValue)
+        };
+        return;
       case "zoom":
       case "scale":
         draft.scale = parsePositiveNumber(normalizedValue);
@@ -1542,13 +1816,19 @@ var WorldOrbit = (() => {
     const selectedObjectId = draft.select && objectMap.has(draft.select) ? draft.select : objectId;
     const filter = normalizeViewpointFilter(draft.filter);
     const label = draft.label?.trim() || humanizeIdentifier(draft.id);
+    const resolvedProjection = draft.projection ?? projection;
+    const camera = normalizeViewCamera(draft.camera ?? null);
+    const renderProjection = resolveRenderProjection(resolvedProjection, camera);
     return {
       id: draft.id,
       label,
       summary: draft.summary?.trim() || createViewpointSummary(label, objectId, filter),
       objectId,
       selectedObjectId,
-      projection: draft.projection ?? projection,
+      eventIds: [...new Set(draft.eventIds ?? [])],
+      projection: resolvedProjection,
+      renderProjection,
+      camera,
       preset: draft.preset ?? preset,
       rotationDeg: draft.rotationDeg ?? 0,
       scale: draft.scale ?? null,
@@ -1565,6 +1845,14 @@ var WorldOrbit = (() => {
       groupIds: []
     };
   }
+  function createEmptyViewCamera() {
+    return {
+      azimuth: null,
+      elevation: null,
+      roll: null,
+      distance: null
+    };
+  }
   function normalizeViewpointFilter(filter) {
     if (!filter) {
       return null;
@@ -1578,7 +1866,18 @@ var WorldOrbit = (() => {
     return normalized.query || normalized.objectTypes.length > 0 || normalized.tags.length > 0 || normalized.groupIds.length > 0 ? normalized : null;
   }
   function parseViewProjection(value) {
-    return value.toLowerCase() === "isometric" ? "isometric" : value.toLowerCase() === "topdown" ? "topdown" : null;
+    switch (value.toLowerCase()) {
+      case "topdown":
+        return "topdown";
+      case "isometric":
+        return "isometric";
+      case "orthographic":
+        return "orthographic";
+      case "perspective":
+        return "perspective";
+      default:
+        return null;
+    }
   }
   function parseRenderPreset(value) {
     const normalized = value.toLowerCase();
@@ -1605,7 +1904,7 @@ var WorldOrbit = (() => {
         next["orbits-front"] = enabled;
         continue;
       }
-      if (rawLayer === "background" || rawLayer === "guides" || rawLayer === "orbits-back" || rawLayer === "orbits-front" || rawLayer === "relations" || rawLayer === "objects" || rawLayer === "labels" || rawLayer === "metadata") {
+      if (rawLayer === "background" || rawLayer === "guides" || rawLayer === "orbits-back" || rawLayer === "orbits-front" || rawLayer === "relations" || rawLayer === "events" || rawLayer === "objects" || rawLayer === "labels" || rawLayer === "metadata") {
         next[rawLayer] = enabled;
       }
     }
@@ -1616,7 +1915,7 @@ var WorldOrbit = (() => {
   }
   function parseViewpointGroups(value, document2, relationships, objectMap) {
     return splitListValue(value).map((entry) => {
-      if (document2.schemaVersion === "2.1" || document2.groups.some((group) => group.id === entry)) {
+      if (document2.schemaVersion === "2.1" || document2.schemaVersion === "2.5" || document2.groups.some((group) => group.id === entry)) {
         return entry;
       }
       if (entry.startsWith("wo-") && entry.endsWith("-group")) {
@@ -1653,7 +1952,7 @@ var WorldOrbit = (() => {
     }
     return parts.join(" - ");
   }
-  function calculateContentBounds(width, height, objects, orbitVisuals, leaders, labels) {
+  function calculateContentBounds(width, height, objects, orbitVisuals, leaders, labels, labelMultiplier) {
     let minX = Number.POSITIVE_INFINITY;
     let minY = Number.POSITIVE_INFINITY;
     let maxX = Number.NEGATIVE_INFINITY;
@@ -1683,7 +1982,7 @@ var WorldOrbit = (() => {
     for (const label of labels) {
       if (label.hidden)
         continue;
-      includeLabelBounds(label, include);
+      includeLabelBounds(label, include, labelMultiplier);
     }
     if (!Number.isFinite(minX) || !Number.isFinite(minY)) {
       return createBounds(0, 0, width, height);
@@ -1721,13 +2020,10 @@ var WorldOrbit = (() => {
     include(object.x - object.visualRadius - 24, object.y - object.visualRadius - 16);
     include(object.x + object.visualRadius + 24, object.y + object.visualRadius + 36);
   }
-  function includeLabelBounds(label, include) {
-    const labelScale = 1;
-    const labelHalfWidth = estimateLabelHalfWidthFromText(label.label, label.secondaryLabel, labelScale);
-    include(label.x - labelHalfWidth, label.y - 18);
-    include(label.x + labelHalfWidth, label.y + 8);
-    include(label.x - labelHalfWidth, label.secondaryY - 14);
-    include(label.x + labelHalfWidth, label.secondaryY + 8);
+  function includeLabelBounds(label, include, labelMultiplier) {
+    const bounds = createLabelRectFromText(label.x, label.y, label.secondaryY, label.textAnchor, label.direction, label.label, label.secondaryLabel, labelMultiplier);
+    include(bounds.left, bounds.top);
+    include(bounds.right, bounds.bottom);
   }
   function placeObject(object, x, y, depth, positions, orbitDrafts, leaderDrafts, context) {
     if (positions.has(object.id)) {
@@ -2117,7 +2413,7 @@ var WorldOrbit = (() => {
         return null;
     }
   }
-  function calculateGroupBounds(group, objects, orbitVisuals, leaders, labels) {
+  function calculateGroupBounds(group, objects, orbitVisuals, leaders, labels, labelMultiplier) {
     let minX = Number.POSITIVE_INFINITY;
     let minY = Number.POSITIVE_INFINITY;
     let maxX = Number.NEGATIVE_INFINITY;
@@ -2146,7 +2442,7 @@ var WorldOrbit = (() => {
     }
     for (const label of labels) {
       if (!label.hidden && group.labelIds.includes(label.objectId)) {
-        includeLabelBounds(label, include);
+        includeLabelBounds(label, include, labelMultiplier);
       }
     }
     if (!Number.isFinite(minX) || !Number.isFinite(minY)) {
@@ -2171,12 +2467,28 @@ var WorldOrbit = (() => {
     }
     return current.id;
   }
-  function createLabelRect(x, labelY, secondaryY, labelHalfWidth, direction) {
+  function createLabelRect(object, placement, labelMultiplier) {
+    return createLabelRectFromText(placement.x, placement.labelY, placement.secondaryY, placement.textAnchor, placement.direction, object.label, object.secondaryLabel, labelMultiplier);
+  }
+  function createLabelRectFromText(x, labelY, secondaryY, textAnchor, direction, label, secondaryLabel, labelMultiplier) {
+    const labelHalfWidth = estimateLabelHalfWidthFromText(label, secondaryLabel, labelMultiplier);
+    const labelWidth = labelHalfWidth * 2;
+    const topPadding = direction === "above" ? 18 : 12;
+    const bottomPadding = direction === "above" ? 8 : 12;
+    let left = x - labelHalfWidth;
+    let right = x + labelHalfWidth;
+    if (textAnchor === "start") {
+      left = x;
+      right = x + labelWidth;
+    } else if (textAnchor === "end") {
+      left = x - labelWidth;
+      right = x;
+    }
     return {
-      left: x - labelHalfWidth,
-      right: x + labelHalfWidth,
-      top: Math.min(labelY, secondaryY) - (direction < 0 ? 18 : 12),
-      bottom: Math.max(labelY, secondaryY) + (direction < 0 ? 8 : 12)
+      left,
+      right,
+      top: Math.min(labelY, secondaryY) - topPadding,
+      bottom: Math.max(labelY, secondaryY) + bottomPadding
     };
   }
   function rectsOverlap(left, right) {
@@ -2363,11 +2675,6 @@ var WorldOrbit = (() => {
   function customColorFor(value) {
     return typeof value === "string" && value.trim() ? value : void 0;
   }
-  function estimateLabelHalfWidth(object, labelMultiplier) {
-    const primaryWidth = object.label.length * 4.6 * labelMultiplier + 18;
-    const secondaryWidth = object.secondaryLabel.length * 3.9 * labelMultiplier + 18;
-    return Math.max(primaryWidth, secondaryWidth, object.visualRadius + 18);
-  }
   function estimateLabelHalfWidthFromText(label, secondaryLabel, labelMultiplier) {
     const primaryWidth = label.length * 4.6 * labelMultiplier + 18;
     const secondaryWidth = secondaryLabel.length * 3.9 * labelMultiplier + 18;
@@ -2401,12 +2708,13 @@ var WorldOrbit = (() => {
     }
     return {
       format: "worldorbit",
-      version: "2.0",
-      schemaVersion: "2.0",
+      version: "2.5",
+      schemaVersion: "2.5",
       sourceVersion: document2.version,
       system,
       groups: structuredClone(document2.groups ?? []),
       relations: structuredClone(document2.relations ?? []),
+      events: structuredClone(document2.events ?? []),
       objects: document2.objects.map(cloneWorldOrbitObject),
       diagnostics
     };
@@ -2414,7 +2722,7 @@ var WorldOrbit = (() => {
   function upgradeDocumentToDraftV2(document2, options = {}) {
     return convertAtlasDocumentToLegacyDraft(upgradeDocumentToV2(document2, options));
   }
-  function materializeAtlasDocument(document2) {
+  function materializeAtlasDocument(document2, options = {}) {
     const system = document2.system ? {
       type: "system",
       id: document2.system.id,
@@ -2425,6 +2733,8 @@ var WorldOrbit = (() => {
       properties: materializeDraftSystemProperties(document2.system),
       info: materializeDraftSystemInfo(document2.system)
     } : null;
+    const objects = document2.objects.map(cloneWorldOrbitObject);
+    applyEventPoseOverrides(objects, document2.events ?? [], options.activeEventId ?? null);
     return {
       format: "worldorbit",
       version: "1.0",
@@ -2432,7 +2742,8 @@ var WorldOrbit = (() => {
       system,
       groups: structuredClone(document2.groups ?? []),
       relations: structuredClone(document2.relations ?? []),
-      objects: document2.objects.map(cloneWorldOrbitObject)
+      events: document2.events.map(cloneWorldOrbitEvent),
+      objects
     };
   }
   function createDraftSystem(document2, defaults, atlasMetadata, annotations, diagnostics, preset) {
@@ -2454,8 +2765,9 @@ var WorldOrbit = (() => {
     };
   }
   function createDraftDefaults(document2, preset, projection) {
+    const rawView = typeof document2.system?.properties.view === "string" ? document2.system.properties.view.toLowerCase() : null;
     return {
-      view: typeof document2.system?.properties.view === "string" && document2.system.properties.view.toLowerCase() === "topdown" ? "topdown" : projection,
+      view: rawView === "topdown" || rawView === "isometric" || rawView === "orthographic" || rawView === "perspective" ? rawView : projection,
       scale: typeof document2.system?.properties.scale === "string" ? document2.system.properties.scale : null,
       units: typeof document2.system?.properties.units === "string" ? document2.system.properties.units : null,
       preset,
@@ -2557,10 +2869,12 @@ var WorldOrbit = (() => {
       summary: viewpoint.summary,
       focusObjectId: viewpoint.objectId,
       selectedObjectId: viewpoint.selectedObjectId,
+      events: [...viewpoint.eventIds],
       projection: viewpoint.projection,
       preset: viewpoint.preset,
       zoom: viewpoint.scale,
       rotationDeg: viewpoint.rotationDeg,
+      camera: viewpoint.camera ? { ...viewpoint.camera } : null,
       layers: { ...viewpoint.layers },
       filter: viewpoint.filter ? {
         query: viewpoint.filter.query,
@@ -2589,6 +2903,75 @@ var WorldOrbit = (() => {
       info: { ...object.info }
     };
   }
+  function cloneWorldOrbitEvent(event) {
+    return {
+      ...event,
+      participantObjectIds: [...event.participantObjectIds],
+      tags: [...event.tags],
+      positions: event.positions.map(cloneWorldOrbitEventPose)
+    };
+  }
+  function cloneWorldOrbitEventPose(pose) {
+    return {
+      objectId: pose.objectId,
+      placement: clonePlacement(pose.placement),
+      inner: pose.inner ? { ...pose.inner } : void 0,
+      outer: pose.outer ? { ...pose.outer } : void 0,
+      epoch: pose.epoch ?? null,
+      referencePlane: pose.referencePlane ?? null
+    };
+  }
+  function clonePlacement(placement) {
+    return placement ? structuredClone(placement) : null;
+  }
+  function applyEventPoseOverrides(objects, events, activeEventId) {
+    if (!activeEventId) {
+      return;
+    }
+    const event = events.find((entry) => entry.id === activeEventId);
+    if (!event) {
+      return;
+    }
+    const objectMap = new Map(objects.map((object) => [object.id, object]));
+    const referencedIds = /* @__PURE__ */ new Set([
+      ...event.targetObjectId ? [event.targetObjectId] : [],
+      ...event.participantObjectIds,
+      ...event.positions.map((pose) => pose.objectId)
+    ]);
+    for (const objectId of referencedIds) {
+      const object = objectMap.get(objectId);
+      if (!object) {
+        continue;
+      }
+      if (event.epoch) {
+        object.epoch = event.epoch;
+      }
+      if (event.referencePlane) {
+        object.referencePlane = event.referencePlane;
+      }
+    }
+    for (const pose of event.positions) {
+      const object = objectMap.get(pose.objectId);
+      if (!object) {
+        continue;
+      }
+      if (pose.placement) {
+        object.placement = clonePlacement(pose.placement);
+      }
+      if (pose.inner) {
+        object.properties.inner = { ...pose.inner };
+      }
+      if (pose.outer) {
+        object.properties.outer = { ...pose.outer };
+      }
+      if (pose.epoch) {
+        object.epoch = pose.epoch;
+      }
+      if (pose.referencePlane) {
+        object.referencePlane = pose.referencePlane;
+      }
+    }
+  }
   function cloneProperties(properties) {
     const next = {};
     for (const [key, value] of Object.entries(properties)) {
@@ -2670,6 +3053,18 @@ var WorldOrbit = (() => {
       if (viewpoint.rotationDeg !== 0) {
         info2[`${prefix}.rotation`] = String(viewpoint.rotationDeg);
       }
+      if (viewpoint.camera?.azimuth !== null) {
+        info2[`${prefix}.camera.azimuth`] = String(viewpoint.camera?.azimuth);
+      }
+      if (viewpoint.camera?.elevation !== null) {
+        info2[`${prefix}.camera.elevation`] = String(viewpoint.camera?.elevation);
+      }
+      if (viewpoint.camera?.roll !== null) {
+        info2[`${prefix}.camera.roll`] = String(viewpoint.camera?.roll);
+      }
+      if (viewpoint.camera?.distance !== null) {
+        info2[`${prefix}.camera.distance`] = String(viewpoint.camera?.distance);
+      }
       const serializedLayers = serializeViewpointLayers(viewpoint.layers);
       if (serializedLayers) {
         info2[`${prefix}.layers`] = serializedLayers;
@@ -2686,6 +3081,9 @@ var WorldOrbit = (() => {
       if ((viewpoint.filter?.groupIds.length ?? 0) > 0) {
         info2[`${prefix}.groups`] = viewpoint.filter?.groupIds.join(" ") ?? "";
       }
+      if (viewpoint.events.length > 0) {
+        info2[`${prefix}.events`] = viewpoint.events.join(" ");
+      }
     }
     for (const annotation of system.annotations) {
       const prefix = `annotation.${annotation.id}`;
@@ -2710,7 +3108,7 @@ var WorldOrbit = (() => {
     if (orbitFront !== void 0 || orbitBack !== void 0) {
       tokens.push(orbitFront !== false || orbitBack !== false ? "orbits" : "-orbits");
     }
-    for (const key of ["background", "guides", "relations", "objects", "labels", "metadata"]) {
+    for (const key of ["background", "guides", "relations", "events", "objects", "labels", "metadata"]) {
       if (layers[key] !== void 0) {
         tokens.push(layers[key] ? key : `-${key}`);
       }
@@ -2763,26 +3161,26 @@ var WorldOrbit = (() => {
   ];
   function formatDocument(document2, options = {}) {
     const schema = options.schema ?? "auto";
-    const useDraft = schema === "2.0" || schema === "2.1" || schema === "2.0-draft" || document2.version === "2.0" || document2.version === "2.1" || document2.version === "2.0-draft";
+    const useDraft = schema === "2.0" || schema === "2.1" || schema === "2.5" || schema === "2.0-draft" || document2.version === "2.0" || document2.version === "2.1" || document2.version === "2.5" || document2.version === "2.0-draft";
     if (useDraft) {
       if (schema === "2.0-draft") {
-        const legacyDraftDocument = document2.version === "2.0-draft" ? document2 : document2.version === "2.0" || document2.version === "2.1" ? {
+        const legacyDraftDocument = document2.version === "2.0-draft" ? document2 : document2.version === "2.0" || document2.version === "2.1" || document2.version === "2.5" ? {
           ...document2,
           version: "2.0-draft",
           schemaVersion: "2.0-draft"
         } : upgradeDocumentToDraftV2(document2);
         return formatDraftDocument(legacyDraftDocument);
       }
-      const atlasDocument = document2.version === "2.0" || document2.version === "2.1" ? document2 : document2.version === "2.0-draft" ? {
+      const atlasDocument = document2.version === "2.0" || document2.version === "2.1" || document2.version === "2.5" ? document2 : document2.version === "2.0-draft" ? {
         ...document2,
         version: "2.0",
         schemaVersion: "2.0"
       } : upgradeDocumentToV2(document2);
-      if (schema === "2.1" && atlasDocument.version !== "2.1") {
+      if ((schema === "2.0" || schema === "2.1" || schema === "2.5") && atlasDocument.version !== schema) {
         return formatAtlasDocument({
           ...atlasDocument,
-          version: "2.1",
-          schemaVersion: "2.1"
+          version: schema,
+          schemaVersion: schema
         });
       }
       return formatAtlasDocument(atlasDocument);
@@ -2814,6 +3212,10 @@ var WorldOrbit = (() => {
       lines.push("");
       lines.push(...formatAtlasRelation(relation));
     }
+    for (const event of [...document2.events].sort(compareIdLike)) {
+      lines.push("");
+      lines.push(...formatAtlasEvent(event));
+    }
     const sortedObjects = [...document2.objects].sort(compareObjects);
     if (sortedObjects.length > 0 && lines.at(-1) !== "") {
       lines.push("");
@@ -2844,6 +3246,10 @@ var WorldOrbit = (() => {
       lines.push("");
       lines.push(...formatAtlasRelation(relation));
     }
+    for (const event of [...legacy.events].sort(compareIdLike)) {
+      lines.push("");
+      lines.push(...formatAtlasEvent(event));
+    }
     const sortedObjects = [...legacy.objects].sort(compareObjects);
     if (sortedObjects.length > 0 && lines.at(-1) !== "") {
       lines.push("");
@@ -3051,10 +3457,28 @@ var WorldOrbit = (() => {
     if (viewpoint.rotationDeg !== 0) {
       lines.push(`  rotation ${viewpoint.rotationDeg}`);
     }
+    if (viewpoint.camera && hasCameraValues(viewpoint.camera)) {
+      lines.push("  camera");
+      if (viewpoint.camera.azimuth !== null) {
+        lines.push(`    azimuth ${viewpoint.camera.azimuth}`);
+      }
+      if (viewpoint.camera.elevation !== null) {
+        lines.push(`    elevation ${viewpoint.camera.elevation}`);
+      }
+      if (viewpoint.camera.roll !== null) {
+        lines.push(`    roll ${viewpoint.camera.roll}`);
+      }
+      if (viewpoint.camera.distance !== null) {
+        lines.push(`    distance ${viewpoint.camera.distance}`);
+      }
+    }
     const layerTokens = formatDraftLayers(viewpoint.layers);
     if (layerTokens.length > 0) {
       lines.push(`  layers ${layerTokens.join(" ")}`);
     }
+    if (viewpoint.events.length > 0) {
+      lines.push(`  events ${viewpoint.events.join(" ")}`);
+    }
     if (viewpoint.filter) {
       lines.push("  filter");
       if (viewpoint.filter.query) {
@@ -3127,6 +3551,65 @@ var WorldOrbit = (() => {
     }
     return lines;
   }
+  function formatAtlasEvent(event) {
+    const lines = [`event ${event.id}`, `  kind ${quoteIfNeeded(event.kind)}`];
+    if (event.label) {
+      lines.push(`  label ${quoteIfNeeded(event.label)}`);
+    }
+    if (event.summary) {
+      lines.push(`  summary ${quoteIfNeeded(event.summary)}`);
+    }
+    if (event.targetObjectId) {
+      lines.push(`  target ${event.targetObjectId}`);
+    }
+    if (event.participantObjectIds.length > 0) {
+      lines.push(`  participants ${event.participantObjectIds.join(" ")}`);
+    }
+    if (event.timing) {
+      lines.push(`  timing ${quoteIfNeeded(event.timing)}`);
+    }
+    if (event.visibility) {
+      lines.push(`  visibility ${quoteIfNeeded(event.visibility)}`);
+    }
+    if (event.epoch) {
+      lines.push(`  epoch ${quoteIfNeeded(event.epoch)}`);
+    }
+    if (event.referencePlane) {
+      lines.push(`  referencePlane ${quoteIfNeeded(event.referencePlane)}`);
+    }
+    if (event.tags.length > 0) {
+      lines.push(`  tags ${event.tags.map(quoteIfNeeded).join(" ")}`);
+    }
+    if (event.color) {
+      lines.push(`  color ${quoteIfNeeded(event.color)}`);
+    }
+    if (event.hidden) {
+      lines.push("  hidden true");
+    }
+    if (event.positions.length > 0) {
+      lines.push("");
+      lines.push("  positions");
+      for (const pose of [...event.positions].sort(comparePoseObjectId)) {
+        lines.push(`    pose ${pose.objectId}`);
+        for (const fieldLine of formatEventPoseFields(pose)) {
+          lines.push(`      ${fieldLine}`);
+        }
+      }
+    }
+    return lines;
+  }
+  function formatEventPoseFields(pose) {
+    return [
+      ...formatPlacement(pose.placement),
+      ...pose.epoch ? [`epoch ${quoteIfNeeded(pose.epoch)}`] : [],
+      ...pose.referencePlane ? [`referencePlane ${quoteIfNeeded(pose.referencePlane)}`] : [],
+      ...formatOptionalUnit("inner", pose.inner),
+      ...formatOptionalUnit("outer", pose.outer)
+    ];
+  }
+  function hasCameraValues(camera) {
+    return camera.azimuth !== null || camera.elevation !== null || camera.roll !== null || camera.distance !== null;
+  }
   function formatValue(value) {
     if (Array.isArray(value)) {
       return value.map((item) => quoteIfNeeded(item)).join(" ");
@@ -3168,7 +3651,7 @@ var WorldOrbit = (() => {
     if (orbitFront !== void 0 || orbitBack !== void 0) {
       tokens.push(orbitFront !== false || orbitBack !== false ? "orbits" : "-orbits");
     }
-    for (const key of ["background", "guides", "relations", "objects", "labels", "metadata"]) {
+    for (const key of ["background", "guides", "relations", "events", "objects", "labels", "metadata"]) {
       if (layers[key] !== void 0) {
         tokens.push(layers[key] ? key : `-${key}`);
       }
@@ -3196,6 +3679,9 @@ var WorldOrbit = (() => {
   function compareIdLike(left, right) {
     return left.id.localeCompare(right.id);
   }
+  function comparePoseObjectId(left, right) {
+    return left.objectId.localeCompare(right.objectId);
+  }
   function objectTypeIndex(objectType) {
     switch (objectType) {
       case "star":
@@ -3391,6 +3877,7 @@ var WorldOrbit = (() => {
     const diagnostics = [];
     const objectMap = new Map(document2.objects.map((object) => [object.id, object]));
     const groupIds = new Set(document2.groups.map((group) => group.id));
+    const eventIds = new Set(document2.events.map((event) => event.id));
     if (!document2.system) {
       diagnostics.push(error("validate.system.required", "Atlas documents must declare exactly one system."));
     }
@@ -3400,6 +3887,7 @@ var WorldOrbit = (() => {
       ["viewpoint", document2.system?.viewpoints.map((viewpoint) => viewpoint.id) ?? []],
       ["annotation", document2.system?.annotations.map((annotation) => annotation.id) ?? []],
       ["relation", document2.relations.map((relation) => relation.id)],
+      ["event", document2.events.map((event) => event.id)],
       ["object", document2.objects.map((object) => object.id)]
     ]) {
       for (const id of ids) {
@@ -3415,11 +3903,14 @@ var WorldOrbit = (() => {
       validateRelation(relation, objectMap, diagnostics);
     }
     for (const viewpoint of document2.system?.viewpoints ?? []) {
-      validateViewpointFilter(viewpoint.filter, groupIds, sourceSchemaVersion, diagnostics, viewpoint.id);
+      validateViewpoint(viewpoint, groupIds, eventIds, sourceSchemaVersion, diagnostics, objectMap);
     }
     for (const object of document2.objects) {
       validateObject(object, document2.system, objectMap, groupIds, diagnostics);
     }
+    for (const event of document2.events) {
+      validateEvent(event, document2.system, objectMap, diagnostics);
+    }
     return diagnostics;
   }
   function validateRelation(relation, objectMap, diagnostics) {
@@ -3437,15 +3928,24 @@ var WorldOrbit = (() => {
       diagnostics.push(error("validate.relation.kind.required", `Relation "${relation.id}" is missing a "kind" value.`));
     }
   }
-  function validateViewpointFilter(filter, groupIds, sourceSchemaVersion, diagnostics, viewpointId) {
-    if (!filter || sourceSchemaVersion !== "2.1") {
-      return;
-    }
-    for (const groupId of filter.groupIds) {
-      if (!groupIds.has(groupId)) {
-        diagnostics.push(warn("validate.viewpoint.group.unknown", `Unknown group "${groupId}" in viewpoint "${viewpointId}".`));
+  function validateViewpoint(viewpoint, groupIds, eventIds, sourceSchemaVersion, diagnostics, objectMap) {
+    const filter = viewpoint.filter;
+    if (sourceSchemaVersion === "2.1" || sourceSchemaVersion === "2.5") {
+      if (filter) {
+        for (const groupId of filter.groupIds) {
+          if (!groupIds.has(groupId)) {
+            diagnostics.push(warn("validate.viewpoint.group.unknown", `Unknown group "${groupId}" in viewpoint "${viewpoint.id}".`, void 0, `viewpoint.${viewpoint.id}.groups`));
+          }
+        }
+      }
+      for (const eventId of viewpoint.events ?? []) {
+        if (!eventIds.has(eventId)) {
+          diagnostics.push(warn("validate.viewpoint.event.unknown", `Unknown event "${eventId}" in viewpoint "${viewpoint.id}".`, void 0, `viewpoint.${viewpoint.id}.events`));
+        }
       }
     }
+    validateProjection(viewpoint.projection, diagnostics, `viewpoint.${viewpoint.id}.projection`, viewpoint.id);
+    validateCamera(viewpoint.camera, viewpoint.projection, viewpoint.rotationDeg, diagnostics, viewpoint.id, viewpoint.focusObjectId, viewpoint.selectedObjectId, filter, objectMap);
   }
   function validateObject(object, system, objectMap, groupIds, diagnostics) {
     const placement = object.placement;
@@ -3458,6 +3958,12 @@ var WorldOrbit = (() => {
         }
       }
     }
+    if (typeof object.epoch === "string" && !object.epoch.trim()) {
+      diagnostics.push(warn("validate.epoch.empty", `Object "${object.id}" defines an empty epoch string.`, object.id, "epoch"));
+    }
+    if (typeof object.referencePlane === "string" && !object.referencePlane.trim()) {
+      diagnostics.push(warn("validate.referencePlane.empty", `Object "${object.id}" defines an empty reference plane string.`, object.id, "referencePlane"));
+    }
     if (orbitPlacement) {
       if (!objectMap.has(orbitPlacement.target)) {
         diagnostics.push(error("validate.orbit.target.unknown", `Unknown placement target "${orbitPlacement.target}" on "${object.id}".`, object.id, "orbit"));
@@ -3529,6 +4035,122 @@ var WorldOrbit = (() => {
       }
     }
   }
+  function validateEvent(event, system, objectMap, diagnostics) {
+    const fieldPrefix = `event.${event.id}`;
+    const referencedIds = /* @__PURE__ */ new Set();
+    if (!event.kind.trim()) {
+      diagnostics.push(error("validate.event.kind.required", `Event "${event.id}" is missing a "kind" value.`, void 0, `${fieldPrefix}.kind`));
+    }
+    if (typeof event.epoch === "string" && !event.epoch.trim()) {
+      diagnostics.push(warn("validate.event.epoch.empty", `Event "${event.id}" defines an empty epoch string.`, void 0, `${fieldPrefix}.epoch`));
+    }
+    if (typeof event.referencePlane === "string" && !event.referencePlane.trim()) {
+      diagnostics.push(warn("validate.event.referencePlane.empty", `Event "${event.id}" defines an empty reference plane string.`, void 0, `${fieldPrefix}.referencePlane`));
+    }
+    if (!event.targetObjectId && event.participantObjectIds.length === 0) {
+      diagnostics.push(error("validate.event.references.required", `Event "${event.id}" must define a "target" or at least one participant.`, void 0, `${fieldPrefix}.participants`));
+    }
+    if (event.targetObjectId) {
+      referencedIds.add(event.targetObjectId);
+      if (!objectMap.has(event.targetObjectId)) {
+        diagnostics.push(error("validate.event.target.unknown", `Unknown event target "${event.targetObjectId}" on "${event.id}".`, void 0, `${fieldPrefix}.target`));
+      }
+    }
+    const seenParticipants = /* @__PURE__ */ new Set();
+    for (const participantId of event.participantObjectIds) {
+      referencedIds.add(participantId);
+      if (seenParticipants.has(participantId)) {
+        diagnostics.push(warn("validate.event.participants.duplicate", `Event "${event.id}" repeats participant "${participantId}".`, void 0, `${fieldPrefix}.participants`));
+        continue;
+      }
+      seenParticipants.add(participantId);
+      if (!objectMap.has(participantId)) {
+        diagnostics.push(error("validate.event.participants.unknown", `Unknown event participant "${participantId}" on "${event.id}".`, void 0, `${fieldPrefix}.participants`));
+      }
+    }
+    if (event.targetObjectId && event.participantObjectIds.length > 0 && !event.participantObjectIds.includes(event.targetObjectId)) {
+      diagnostics.push(warn("validate.event.target.notParticipant", `Event "${event.id}" defines a target outside its participants list.`, void 0, `${fieldPrefix}.target`));
+    }
+    if (event.positions.length === 0) {
+      diagnostics.push(warn("validate.event.positions.missing", `Event "${event.id}" has no positions block and cannot drive a scene snapshot.`, void 0, `${fieldPrefix}.positions`));
+    }
+    if (/(?:^|[-_])(solar-eclipse|lunar-eclipse|transit|occultation)(?:$|[-_])/.test(event.kind) && referencedIds.size < 3) {
+      diagnostics.push(warn("validate.event.kind.participants", `Event "${event.id}" looks like an eclipse or transit but references fewer than three bodies.`, void 0, `${fieldPrefix}.participants`));
+    }
+    const poseIds = /* @__PURE__ */ new Set();
+    for (const pose of event.positions) {
+      const poseFieldPrefix = `${fieldPrefix}.pose.${pose.objectId}`;
+      if (poseIds.has(pose.objectId)) {
+        diagnostics.push(error("validate.event.pose.duplicate", `Event "${event.id}" defines "${pose.objectId}" more than once in positions.`, void 0, poseFieldPrefix));
+        continue;
+      }
+      poseIds.add(pose.objectId);
+      const object = objectMap.get(pose.objectId);
+      if (!object) {
+        diagnostics.push(error("validate.event.pose.object.unknown", `Unknown event pose object "${pose.objectId}" on "${event.id}".`, void 0, poseFieldPrefix));
+        continue;
+      }
+      if (!referencedIds.has(pose.objectId)) {
+        diagnostics.push(warn("validate.event.pose.unreferenced", `Event pose "${pose.objectId}" on "${event.id}" is not listed in target/participants.`, void 0, poseFieldPrefix));
+      }
+      validateEventPose(pose, object, event, system, objectMap, diagnostics, poseFieldPrefix, event.id);
+    }
+    const missingPoseIds = [...referencedIds].filter((objectId) => !poseIds.has(objectId));
+    if (event.positions.length > 0 && missingPoseIds.length > 0) {
+      diagnostics.push(warn("validate.event.positions.partial", `Event "${event.id}" leaves ${missingPoseIds.length} referenced object(s) on their base placement.`, void 0, `${fieldPrefix}.positions`));
+    }
+  }
+  function validateEventPose(pose, object, event, system, objectMap, diagnostics, fieldPrefix, eventId) {
+    const placement = pose.placement;
+    if (!placement) {
+      diagnostics.push(error("validate.event.pose.placement.required", `Event "${eventId}" pose "${pose.objectId}" is missing a placement mode.`, void 0, fieldPrefix));
+      return;
+    }
+    if (placement.mode === "orbit") {
+      if (!objectMap.has(placement.target)) {
+        diagnostics.push(error("validate.event.pose.orbit.target.unknown", `Unknown event orbit target "${placement.target}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.orbit`));
+      }
+      if (placement.distance && placement.semiMajor) {
+        diagnostics.push(error("validate.event.pose.orbit.distanceConflict", `Event "${eventId}" pose "${pose.objectId}" cannot declare both "distance" and "semiMajor".`, void 0, `${fieldPrefix}.distance`));
+      }
+      if (placement.phase && !resolveEffectiveEpoch(system, object, event, pose)) {
+        diagnostics.push(warn("validate.event.pose.phase.epochMissing", `Event "${eventId}" pose "${pose.objectId}" sets "phase" without an effective epoch.`, void 0, `${fieldPrefix}.phase`));
+      }
+      if (placement.inclination && !resolveEffectiveReferencePlane(system, object, event, pose)) {
+        diagnostics.push(warn("validate.event.pose.inclination.referencePlaneMissing", `Event "${eventId}" pose "${pose.objectId}" sets "inclination" without an effective reference plane.`, void 0, `${fieldPrefix}.inclination`));
+      }
+      if (placement.period && !massInSolar(objectMap.get(placement.target)?.properties.mass)) {
+        diagnostics.push(warn("validate.event.pose.period.massMissing", `Event "${eventId}" pose "${pose.objectId}" sets "period" but its central mass cannot be derived.`, void 0, `${fieldPrefix}.period`));
+      }
+      return;
+    }
+    if (placement.mode === "surface") {
+      const target = objectMap.get(placement.target);
+      if (!target) {
+        diagnostics.push(error("validate.event.pose.surface.target.unknown", `Unknown event surface target "${placement.target}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.surface`));
+      } else if (!SURFACE_TARGET_TYPES2.has(target.type)) {
+        diagnostics.push(error("validate.event.pose.surface.target.invalid", `Event surface target "${placement.target}" on "${eventId}:${pose.objectId}" is not surface-capable.`, void 0, `${fieldPrefix}.surface`));
+      }
+      return;
+    }
+    if (placement.mode === "at") {
+      if (object.type !== "structure" && object.type !== "phenomenon") {
+        diagnostics.push(error("validate.event.pose.at.objectType", `Only structures and phenomena may use "at" placement in events; found "${object.type}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.at`));
+      }
+      const reference = placement.reference;
+      if (reference.kind === "named" && !objectMap.has(reference.name)) {
+        diagnostics.push(error("validate.event.pose.at.target.unknown", `Unknown event at-reference target "${placement.target}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.at`));
+      } else if (reference.kind === "anchor" && !objectMap.has(reference.objectId)) {
+        diagnostics.push(error("validate.event.pose.anchor.target.unknown", `Unknown event anchor target "${reference.objectId}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.at`));
+      } else if (reference.kind === "lagrange") {
+        if (!objectMap.has(reference.primary)) {
+          diagnostics.push(error("validate.event.pose.lagrange.primary.unknown", `Unknown event Lagrange target "${reference.primary}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.at`));
+        } else if (reference.secondary && !objectMap.has(reference.secondary)) {
+          diagnostics.push(error("validate.event.pose.lagrange.secondary.unknown", `Unknown event Lagrange target "${reference.secondary}" on "${eventId}:${pose.objectId}".`, void 0, `${fieldPrefix}.at`));
+        }
+      }
+    }
+  }
   function validateAtTarget(object, objectMap, diagnostics) {
     const reference = object.placement?.mode === "at" ? object.placement.reference : null;
     if (!reference) {
@@ -3634,6 +4256,52 @@ var WorldOrbit = (() => {
         return null;
     }
   }
+  function validateProjection(projection, diagnostics, field, viewpointId) {
+    if (projection !== "topdown" && projection !== "isometric" && projection !== "orthographic" && projection !== "perspective") {
+      diagnostics.push(error("validate.viewpoint.projection.invalid", `Unknown projection "${String(projection)}" in viewpoint "${viewpointId}".`, void 0, field));
+    }
+  }
+  function validateCamera(camera, projection, rotationDeg, diagnostics, viewpointId, focusObjectId, selectedObjectId, filter, objectMap) {
+    if (!camera) {
+      return;
+    }
+    const prefix = `viewpoint.${viewpointId}.camera`;
+    for (const [key, value] of [
+      ["azimuth", camera.azimuth],
+      ["elevation", camera.elevation],
+      ["roll", camera.roll],
+      ["distance", camera.distance]
+    ]) {
+      if (value !== null && (!Number.isFinite(value) || key === "distance" && value <= 0)) {
+        diagnostics.push(error("validate.viewpoint.camera.invalid", `Invalid camera ${key} "${String(value)}" in viewpoint "${viewpointId}".`, void 0, `${prefix}.${key}`));
+      }
+    }
+    if (camera.distance !== null && projection !== "perspective") {
+      diagnostics.push(warn("validate.viewpoint.camera.distance.partialEffect", `Camera "distance" only has a semantic effect in perspective viewpoints; "${viewpointId}" uses "${projection}".`, void 0, `${prefix}.distance`));
+    }
+    if (projection === "topdown" && (camera.elevation !== null || camera.roll !== null)) {
+      diagnostics.push(warn("validate.viewpoint.camera.topdownPartial", `Camera elevation/roll on topdown viewpoint "${viewpointId}" are currently stored for future 3D use and only partially affect 2D rendering.`, void 0, prefix));
+    }
+    if (projection === "isometric" && camera.elevation !== null) {
+      diagnostics.push(info("validate.viewpoint.camera.isometricStored", `Camera elevation on isometric viewpoint "${viewpointId}" is preserved semantically for future 3D rendering.`, void 0, `${prefix}.elevation`));
+    }
+    if (camera.azimuth !== null && camera.azimuth !== 0 && rotationDeg !== 0) {
+      diagnostics.push(warn("validate.viewpoint.rotation.cameraOverlap", `Viewpoint "${viewpointId}" uses camera.azimuth; keep "rotation" only for 2D screen rotation to avoid ambiguity.`, void 0, `${prefix}.azimuth`));
+    }
+    const hasAnchor = focusObjectId !== null && objectMap.has(focusObjectId) || selectedObjectId !== null && objectMap.has(selectedObjectId) || !!filter;
+    if (!hasAnchor) {
+      diagnostics.push(info("validate.viewpoint.camera.anchorMissing", `Viewpoint "${viewpointId}" stores camera settings without a focus object, selection, or filter anchor.`, void 0, prefix));
+    }
+  }
+  function resolveEffectiveEpoch(system, object, event, pose) {
+    return normalizeOptionalContextString(pose?.epoch) ?? normalizeOptionalContextString(event?.epoch) ?? normalizeOptionalContextString(object.epoch) ?? normalizeOptionalContextString(system?.epoch) ?? null;
+  }
+  function resolveEffectiveReferencePlane(system, object, event, pose) {
+    return normalizeOptionalContextString(pose?.referencePlane) ?? normalizeOptionalContextString(event?.referencePlane) ?? normalizeOptionalContextString(object.referencePlane) ?? normalizeOptionalContextString(system?.referencePlane) ?? null;
+  }
+  function normalizeOptionalContextString(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+  }
   function toleranceForField(object, field) {
     const tolerance = object.tolerances?.find((entry) => entry.field === field)?.value;
     if (typeof tolerance === "number") {
@@ -3729,6 +4397,23 @@ var WorldOrbit = (() => {
     });
   }
   var DRAFT_OBJECT_FIELD_KEYS = new Set(DRAFT_OBJECT_FIELD_SPECS.keys());
+  var EVENT_POSE_FIELD_KEYS = /* @__PURE__ */ new Set([
+    "orbit",
+    "distance",
+    "semiMajor",
+    "eccentricity",
+    "period",
+    "angle",
+    "inclination",
+    "phase",
+    "at",
+    "surface",
+    "free",
+    "inner",
+    "outer",
+    "epoch",
+    "referencePlane"
+  ]);
   function parseWorldOrbitAtlas(source) {
     return parseAtlasSource(source);
   }
@@ -3743,12 +4428,15 @@ var WorldOrbit = (() => {
     const objectNodes = [];
     const groups = [];
     const relations = [];
+    const events = [];
+    const eventPoseNodes = /* @__PURE__ */ new Map();
     let sawDefaults = false;
     let sawAtlas = false;
     const viewpointIds = /* @__PURE__ */ new Set();
     const annotationIds = /* @__PURE__ */ new Set();
     const groupIds = /* @__PURE__ */ new Set();
     const relationIds = /* @__PURE__ */ new Set();
+    const eventIds = /* @__PURE__ */ new Set();
     for (let index = 0; index < lines.length; index++) {
       const rawLine = lines[index];
       const lineNumber = index + 1;
@@ -3766,7 +4454,7 @@ var WorldOrbit = (() => {
       if (!sawSchemaHeader) {
         sourceSchemaVersion = assertDraftSchemaHeader(tokens, lineNumber);
         sawSchemaHeader = true;
-        if (prepared.comments.length > 0 && sourceSchemaVersion !== "2.1") {
+        if (prepared.comments.length > 0 && isSchemaOlderThan(sourceSchemaVersion, "2.1")) {
           diagnostics.push({
             code: "parse.schema21.commentCompatibility",
             severity: "warning",
@@ -3779,7 +4467,7 @@ var WorldOrbit = (() => {
         continue;
       }
       if (indent === 0) {
-        section = startTopLevelSection(tokens, lineNumber, sourceSchemaVersion, diagnostics, system, objectNodes, groups, relations, viewpointIds, annotationIds, groupIds, relationIds, { sawDefaults, sawAtlas });
+        section = startTopLevelSection(tokens, lineNumber, sourceSchemaVersion, diagnostics, system, objectNodes, groups, relations, events, eventPoseNodes, viewpointIds, annotationIds, groupIds, relationIds, eventIds, { sawDefaults, sawAtlas });
         if (section.kind === "system") {
           system = section.system;
         } else if (section.kind === "defaults") {
@@ -3798,6 +4486,7 @@ var WorldOrbit = (() => {
       throw new WorldOrbitError('Missing required atlas schema header "schema 2.0"');
     }
     const objects = objectNodes.map((node) => normalizeDraftObject(node, sourceSchemaVersion, diagnostics));
+    const normalizedEvents = events.map((event) => normalizeDraftEvent(event, eventPoseNodes.get(event.id) ?? []));
     const outputVersion = forcedOutputVersion ?? (sourceSchemaVersion === "2.0-draft" ? "2.0" : sourceSchemaVersion);
     const baseDocument = {
       format: "worldorbit",
@@ -3805,6 +4494,7 @@ var WorldOrbit = (() => {
       system,
       groups,
       relations,
+      events: normalizedEvents,
       objects,
       diagnostics
     };
@@ -3834,13 +4524,13 @@ var WorldOrbit = (() => {
     return document2;
   }
   function assertDraftSchemaHeader(tokens, line) {
-    if (tokens.length !== 2 || tokens[0].value.toLowerCase() !== "schema" || !["2.0-draft", "2.0", "2.1"].includes(tokens[1].value.toLowerCase())) {
-      throw new WorldOrbitError('Expected atlas header "schema 2.0", "schema 2.1", or legacy "schema 2.0-draft"', line, tokens[0]?.column ?? 1);
+    if (tokens.length !== 2 || tokens[0].value.toLowerCase() !== "schema" || !["2.0-draft", "2.0", "2.1", "2.5"].includes(tokens[1].value.toLowerCase())) {
+      throw new WorldOrbitError('Expected atlas header "schema 2.0", "schema 2.1", "schema 2.5", or legacy "schema 2.0-draft"', line, tokens[0]?.column ?? 1);
     }
     const version = tokens[1].value.toLowerCase();
-    return version === "2.1" ? "2.1" : version === "2.0-draft" ? "2.0-draft" : "2.0";
+    return version === "2.5" ? "2.5" : version === "2.1" ? "2.1" : version === "2.0-draft" ? "2.0-draft" : "2.0";
   }
-  function startTopLevelSection(tokens, line, sourceSchemaVersion, diagnostics, system, objectNodes, groups, relations, viewpointIds, annotationIds, groupIds, relationIds, flags) {
+  function startTopLevelSection(tokens, line, sourceSchemaVersion, diagnostics, system, objectNodes, groups, relations, events, eventPoseNodes, viewpointIds, annotationIds, groupIds, relationIds, eventIds, flags) {
     const keyword = tokens[0]?.value.toLowerCase();
     switch (keyword) {
       case "system":
@@ -3858,6 +4548,8 @@ var WorldOrbit = (() => {
         return {
           kind: "defaults",
           system,
+          sourceSchemaVersion,
+          diagnostics,
           seenFields: /* @__PURE__ */ new Set()
         };
       case "atlas":
@@ -3877,7 +4569,7 @@ var WorldOrbit = (() => {
         if (!system) {
           throw new WorldOrbitError('Atlas section "viewpoint" requires a preceding system declaration', line, tokens[0].column);
         }
-        return startViewpointSection(tokens, line, system, viewpointIds);
+        return startViewpointSection(tokens, line, system, viewpointIds, sourceSchemaVersion, diagnostics);
       case "annotation":
         if (!system) {
           throw new WorldOrbitError('Atlas section "annotation" requires a preceding system declaration', line, tokens[0].column);
@@ -3889,6 +4581,9 @@ var WorldOrbit = (() => {
       case "relation":
         warnIfSchema21Feature(sourceSchemaVersion, diagnostics, "relation", { line, column: tokens[0].column });
         return startRelationSection(tokens, line, relations, relationIds);
+      case "event":
+        warnIfSchema21Feature(sourceSchemaVersion, diagnostics, "event", { line, column: tokens[0].column });
+        return startEventSection(tokens, line, events, eventPoseNodes, eventIds, sourceSchemaVersion, diagnostics);
       case "object":
         return startObjectSection(tokens, line, sourceSchemaVersion, diagnostics, objectNodes);
       default:
@@ -3925,7 +4620,7 @@ var WorldOrbit = (() => {
       seenFields: /* @__PURE__ */ new Set()
     };
   }
-  function startViewpointSection(tokens, line, system, viewpointIds) {
+  function startViewpointSection(tokens, line, system, viewpointIds, sourceSchemaVersion, diagnostics) {
     if (tokens.length !== 2) {
       throw new WorldOrbitError("Invalid viewpoint declaration", line, tokens[0]?.column ?? 1);
     }
@@ -3942,10 +4637,12 @@ var WorldOrbit = (() => {
       summary: "",
       focusObjectId: null,
       selectedObjectId: null,
+      events: [],
       projection: system.defaults.view,
       preset: system.defaults.preset,
       zoom: null,
       rotationDeg: 0,
+      camera: null,
       layers: {},
       filter: null
     };
@@ -3954,10 +4651,15 @@ var WorldOrbit = (() => {
     return {
       kind: "viewpoint",
       viewpoint,
+      sourceSchemaVersion,
+      diagnostics,
       seenFields: /* @__PURE__ */ new Set(),
       inFilter: false,
       filterIndent: null,
-      seenFilterFields: /* @__PURE__ */ new Set()
+      seenFilterFields: /* @__PURE__ */ new Set(),
+      inCamera: false,
+      cameraIndent: null,
+      seenCameraFields: /* @__PURE__ */ new Set()
     };
   }
   function startAnnotationSection(tokens, line, system, annotationIds) {
@@ -4044,6 +4746,51 @@ var WorldOrbit = (() => {
       seenFields: /* @__PURE__ */ new Set()
     };
   }
+  function startEventSection(tokens, line, events, eventPoseNodes, eventIds, sourceSchemaVersion, diagnostics) {
+    if (tokens.length !== 2) {
+      throw new WorldOrbitError("Invalid event declaration", line, tokens[0]?.column ?? 1);
+    }
+    const id = normalizeIdentifier2(tokens[1].value);
+    if (!id) {
+      throw new WorldOrbitError("Event id must not be empty", line, tokens[1].column);
+    }
+    if (eventIds.has(id)) {
+      throw new WorldOrbitError(`Duplicate event id "${id}"`, line, tokens[1].column);
+    }
+    const event = {
+      id,
+      kind: "",
+      label: humanizeIdentifier3(id),
+      summary: null,
+      targetObjectId: null,
+      participantObjectIds: [],
+      timing: null,
+      visibility: null,
+      epoch: null,
+      referencePlane: null,
+      tags: [],
+      color: null,
+      hidden: false,
+      positions: []
+    };
+    const rawPoses = [];
+    events.push(event);
+    eventPoseNodes.set(id, rawPoses);
+    eventIds.add(id);
+    return {
+      kind: "event",
+      event,
+      sourceSchemaVersion,
+      diagnostics,
+      seenFields: /* @__PURE__ */ new Set(),
+      rawPoses,
+      inPositions: false,
+      positionsIndent: null,
+      activePose: null,
+      poseIndent: null,
+      activePoseSeenFields: /* @__PURE__ */ new Set()
+    };
+  }
   function startObjectSection(tokens, line, sourceSchemaVersion, diagnostics, objectNodes) {
     if (tokens.length < 3) {
       throw new WorldOrbitError("Invalid atlas object declaration", line, tokens[0]?.column ?? 1);
@@ -4100,6 +4847,9 @@ var WorldOrbit = (() => {
       case "relation":
         applyRelationField(section, tokens, line);
         return;
+      case "event":
+        applyEventField(section, indent, tokens, line);
+        return;
       case "object":
         applyObjectField(section, indent, tokens, line);
         return;
@@ -4142,6 +4892,12 @@ var WorldOrbit = (() => {
     const value = joinFieldValue(tokens, line);
     switch (key) {
       case "view":
+        if (isSchema25Projection(value)) {
+          warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, "defaults.view", {
+            line,
+            column: tokens[0].column
+          });
+        }
         section.system.defaults.view = parseProjectionValue(value, line, tokens[0].column);
         return;
       case "scale":
@@ -4181,14 +4937,36 @@ var WorldOrbit = (() => {
     throw new WorldOrbitError(`Unknown atlas field "${tokens[0].value}"`, line, tokens[0].column);
   }
   function applyViewpointField2(section, indent, tokens, line) {
+    if (section.inCamera && indent <= (section.cameraIndent ?? 0)) {
+      section.inCamera = false;
+      section.cameraIndent = null;
+    }
     if (section.inFilter && indent <= (section.filterIndent ?? 0)) {
       section.inFilter = false;
       section.filterIndent = null;
     }
+    if (section.inCamera) {
+      applyViewpointCameraField(section, tokens, line);
+      return;
+    }
     if (section.inFilter) {
       applyViewpointFilterField(section, tokens, line);
       return;
     }
+    if (tokens.length === 1 && tokens[0].value.toLowerCase() === "camera") {
+      warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, "viewpoint.camera", {
+        line,
+        column: tokens[0].column
+      });
+      if (section.seenFields.has("camera")) {
+        throw new WorldOrbitError('Duplicate viewpoint field "camera"', line, tokens[0].column);
+      }
+      section.seenFields.add("camera");
+      section.inCamera = true;
+      section.cameraIndent = indent;
+      section.viewpoint.camera = section.viewpoint.camera ?? createEmptyViewCamera2();
+      return;
+    }
     if (tokens.length === 1 && tokens[0].value.toLowerCase() === "filter") {
       if (section.seenFields.has("filter")) {
         throw new WorldOrbitError('Duplicate viewpoint field "filter"', line, tokens[0].column);
@@ -4214,6 +4992,12 @@ var WorldOrbit = (() => {
         section.viewpoint.selectedObjectId = value;
         return;
       case "projection":
+        if (isSchema25Projection(value)) {
+          warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, "projection", {
+            line,
+            column: tokens[0].column
+          });
+        }
         section.viewpoint.projection = parseProjectionValue(value, line, tokens[0].column);
         return;
       case "preset":
@@ -4225,13 +5009,49 @@ var WorldOrbit = (() => {
       case "rotation":
         section.viewpoint.rotationDeg = parseFiniteNumber2(value, line, tokens[0].column, "rotation");
         return;
+      case "camera":
+        warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, "viewpoint.camera", {
+          line,
+          column: tokens[0].column
+        });
+        section.viewpoint.camera = parseInlineViewCamera(tokens.slice(1), line, section.viewpoint.camera);
+        return;
       case "layers":
-        section.viewpoint.layers = parseLayerTokens(tokens.slice(1), line);
+        section.viewpoint.layers = parseLayerTokens(tokens.slice(1), line, section.sourceSchemaVersion, section.diagnostics);
+        return;
+      case "events":
+        warnIfSchema21Feature(section.sourceSchemaVersion, section.diagnostics, "viewpoint.events", {
+          line,
+          column: tokens[0].column
+        });
+        section.viewpoint.events = parseTokenList(tokens.slice(1), line, "events");
         return;
       default:
         throw new WorldOrbitError(`Unknown viewpoint field "${tokens[0].value}"`, line, tokens[0].column);
     }
   }
+  function applyViewpointCameraField(section, tokens, line) {
+    const key = requireUniqueField(tokens, section.seenCameraFields, line);
+    const value = joinFieldValue(tokens, line);
+    const camera = section.viewpoint.camera ?? createEmptyViewCamera2();
+    switch (key) {
+      case "azimuth":
+        camera.azimuth = parseFiniteNumber2(value, line, tokens[0].column, "camera.azimuth");
+        break;
+      case "elevation":
+        camera.elevation = parseFiniteNumber2(value, line, tokens[0].column, "camera.elevation");
+        break;
+      case "roll":
+        camera.roll = parseFiniteNumber2(value, line, tokens[0].column, "camera.roll");
+        break;
+      case "distance":
+        camera.distance = parsePositiveNumber2(value, line, tokens[0].column, "camera.distance");
+        break;
+      default:
+        throw new WorldOrbitError(`Unknown viewpoint camera field "${tokens[0].value}"`, line, tokens[0].column);
+    }
+    section.viewpoint.camera = camera;
+  }
   function applyViewpointFilterField(section, tokens, line) {
     const key = requireUniqueField(tokens, section.seenFilterFields, line);
     const filter = section.viewpoint.filter ?? createEmptyViewpointFilter2();
@@ -4331,6 +5151,126 @@ var WorldOrbit = (() => {
         throw new WorldOrbitError(`Unknown relation field "${tokens[0].value}"`, line, tokens[0].column);
     }
   }
+  function applyEventField(section, indent, tokens, line) {
+    if (section.activePose && indent <= (section.poseIndent ?? 0)) {
+      section.activePose = null;
+      section.poseIndent = null;
+      section.activePoseSeenFields.clear();
+    }
+    if (!section.activePose && section.inPositions && indent <= (section.positionsIndent ?? 0)) {
+      section.inPositions = false;
+      section.positionsIndent = null;
+    }
+    if (section.activePose) {
+      if (tokens[0]?.value === "epoch" || tokens[0]?.value === "referencePlane") {
+        warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, `pose.${tokens[0].value}`, {
+          line,
+          column: tokens[0]?.column ?? 1
+        });
+      }
+      section.activePose.fields.push(parseEventPoseField(tokens, line, section.activePoseSeenFields));
+      return;
+    }
+    if (section.inPositions) {
+      if (tokens.length !== 2 || tokens[0].value.toLowerCase() !== "pose") {
+        throw new WorldOrbitError(`Unknown event positions field "${tokens[0].value}"`, line, tokens[0]?.column ?? 1);
+      }
+      const objectId = tokens[1].value;
+      if (!objectId.trim()) {
+        throw new WorldOrbitError("Event pose object id must not be empty", line, tokens[1].column);
+      }
+      const rawPose = {
+        objectId,
+        fields: [],
+        location: { line, column: tokens[0].column }
+      };
+      section.rawPoses.push(rawPose);
+      section.activePose = rawPose;
+      section.poseIndent = indent;
+      section.activePoseSeenFields = /* @__PURE__ */ new Set();
+      return;
+    }
+    if (tokens.length === 1 && tokens[0].value.toLowerCase() === "positions") {
+      if (section.seenFields.has("positions")) {
+        throw new WorldOrbitError('Duplicate event field "positions"', line, tokens[0].column);
+      }
+      section.seenFields.add("positions");
+      section.inPositions = true;
+      section.positionsIndent = indent;
+      return;
+    }
+    const key = requireUniqueField(tokens, section.seenFields, line);
+    switch (key) {
+      case "kind":
+        section.event.kind = joinFieldValue(tokens, line);
+        return;
+      case "label":
+        section.event.label = joinFieldValue(tokens, line);
+        return;
+      case "summary":
+        section.event.summary = joinFieldValue(tokens, line);
+        return;
+      case "target":
+        section.event.targetObjectId = joinFieldValue(tokens, line);
+        return;
+      case "participants":
+        section.event.participantObjectIds = parseTokenList(tokens.slice(1), line, "participants");
+        return;
+      case "timing":
+        section.event.timing = joinFieldValue(tokens, line);
+        return;
+      case "visibility":
+        section.event.visibility = joinFieldValue(tokens, line);
+        return;
+      case "epoch":
+        warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, "event.epoch", {
+          line,
+          column: tokens[0].column
+        });
+        section.event.epoch = joinFieldValue(tokens, line);
+        return;
+      case "referenceplane":
+        warnIfSchema25Feature(section.sourceSchemaVersion, section.diagnostics, "event.referencePlane", {
+          line,
+          column: tokens[0].column
+        });
+        section.event.referencePlane = joinFieldValue(tokens, line);
+        return;
+      case "tags":
+        section.event.tags = parseTokenList(tokens.slice(1), line, "tags");
+        return;
+      case "color":
+        section.event.color = joinFieldValue(tokens, line);
+        return;
+      case "hidden":
+        section.event.hidden = parseAtlasBoolean(joinFieldValue(tokens, line), "hidden", {
+          line,
+          column: tokens[0].column
+        });
+        return;
+      default:
+        throw new WorldOrbitError(`Unknown event field "${tokens[0].value}"`, line, tokens[0].column);
+    }
+  }
+  function parseEventPoseField(tokens, line, seenFields) {
+    if (tokens.length < 2) {
+      throw new WorldOrbitError("Invalid event pose field line", line, tokens[0]?.column ?? 1);
+    }
+    const key = tokens[0].value;
+    if (!EVENT_POSE_FIELD_KEYS.has(key)) {
+      throw new WorldOrbitError(`Unknown event pose field "${key}"`, line, tokens[0].column);
+    }
+    if (seenFields.has(key)) {
+      throw new WorldOrbitError(`Duplicate event pose field "${key}"`, line, tokens[0].column);
+    }
+    seenFields.add(key);
+    return {
+      type: "field",
+      key,
+      values: tokens.slice(1).map((token) => token.value),
+      location: { line, column: tokens[0].column }
+    };
+  }
   function applyObjectField(section, indent, tokens, line) {
     if (section.activeBlock && indent <= (section.blockIndent ?? 0)) {
       section.activeBlock = null;
@@ -4389,7 +5329,7 @@ var WorldOrbit = (() => {
   function parseObjectTypeTokens(tokens, line) {
     return parseTokenList(tokens, line, "objectTypes").filter((value) => value === "star" || value === "planet" || value === "moon" || value === "belt" || value === "asteroid" || value === "comet" || value === "ring" || value === "structure" || value === "phenomenon");
   }
-  function parseLayerTokens(tokens, line) {
+  function parseLayerTokens(tokens, line, sourceSchemaVersion, diagnostics) {
     const layers = {};
     for (const token of parseTokenList(tokens, line, "layers")) {
       const enabled = !token.startsWith("-") && !token.startsWith("!");
@@ -4399,7 +5339,13 @@ var WorldOrbit = (() => {
         layers["orbits-front"] = enabled;
         continue;
       }
-      if (raw === "background" || raw === "guides" || raw === "orbits-back" || raw === "orbits-front" || raw === "relations" || raw === "objects" || raw === "labels" || raw === "metadata") {
+      if (raw === "background" || raw === "guides" || raw === "orbits-back" || raw === "orbits-front" || raw === "relations" || raw === "events" || raw === "objects" || raw === "labels" || raw === "metadata") {
+        if (raw === "events" && sourceSchemaVersion && diagnostics) {
+          warnIfSchema21Feature(sourceSchemaVersion, diagnostics, "layers.events", {
+            line,
+            column: tokens[0]?.column ?? 1
+          });
+        }
         layers[raw] = enabled;
       }
     }
@@ -4417,11 +5363,15 @@ var WorldOrbit = (() => {
   }
   function parseProjectionValue(value, line, column) {
     const normalized = value.toLowerCase();
-    if (normalized !== "topdown" && normalized !== "isometric") {
+    if (normalized !== "topdown" && normalized !== "isometric" && normalized !== "orthographic" && normalized !== "perspective") {
       throw new WorldOrbitError(`Unknown projection "${value}"`, line, column);
     }
     return normalized;
   }
+  function isSchema25Projection(value) {
+    const normalized = value.toLowerCase();
+    return normalized === "orthographic" || normalized === "perspective";
+  }
   function parsePresetValue(value, line, column) {
     const normalized = value.toLowerCase();
     if (normalized === "diagram" || normalized === "presentation" || normalized === "atlas-card" || normalized === "markdown") {
@@ -4451,6 +5401,48 @@ var WorldOrbit = (() => {
       groupIds: []
     };
   }
+  function createEmptyViewCamera2() {
+    return {
+      azimuth: null,
+      elevation: null,
+      roll: null,
+      distance: null
+    };
+  }
+  function parseInlineViewCamera(tokens, line, current) {
+    if (tokens.length === 0 || tokens.length % 2 !== 0) {
+      throw new WorldOrbitError('Field "camera" expects "<field> <value>" pairs', line, tokens[0]?.column ?? 1);
+    }
+    const camera = current ? { ...current } : createEmptyViewCamera2();
+    const seen = /* @__PURE__ */ new Set();
+    for (let index = 0; index < tokens.length; index += 2) {
+      const fieldToken = tokens[index];
+      const valueToken = tokens[index + 1];
+      const key = fieldToken.value.toLowerCase();
+      if (seen.has(key)) {
+        throw new WorldOrbitError(`Duplicate viewpoint camera field "${fieldToken.value}"`, line, fieldToken.column);
+      }
+      seen.add(key);
+      const value = valueToken.value;
+      switch (key) {
+        case "azimuth":
+          camera.azimuth = parseFiniteNumber2(value, line, fieldToken.column, "camera.azimuth");
+          break;
+        case "elevation":
+          camera.elevation = parseFiniteNumber2(value, line, fieldToken.column, "camera.elevation");
+          break;
+        case "roll":
+          camera.roll = parseFiniteNumber2(value, line, fieldToken.column, "camera.roll");
+          break;
+        case "distance":
+          camera.distance = parsePositiveNumber2(value, line, fieldToken.column, "camera.distance");
+          break;
+        default:
+          throw new WorldOrbitError(`Unknown viewpoint camera field "${fieldToken.value}"`, line, fieldToken.column);
+      }
+    }
+    return camera;
+  }
   function parseInlineObjectFields(tokens, line, objectType, sourceSchemaVersion, diagnostics) {
     const fields = [];
     let index = 0;
@@ -4538,7 +5530,7 @@ var WorldOrbit = (() => {
   }
   function normalizeDraftObject(node, sourceSchemaVersion, diagnostics) {
     const fieldMap = collectDraftFields(node.fields);
-    const placement = extractDraftPlacement(node.objectType, fieldMap);
+    const placement = extractPlacementFromFieldMap(fieldMap);
     const properties = normalizeDraftProperties(node.objectType, fieldMap);
     const groups = parseOptionalTokenList(fieldMap.get("groups")?.[0]);
     const epoch = parseOptionalJoinedValue(fieldMap.get("epoch")?.[0]);
@@ -4583,21 +5575,41 @@ var WorldOrbit = (() => {
       object.tolerances = tolerances;
     if (typedBlocks && Object.keys(typedBlocks).length > 0)
       object.typedBlocks = typedBlocks;
-    if (sourceSchemaVersion !== "2.1") {
+    if (isSchemaOlderThan(sourceSchemaVersion, "2.1")) {
       if (object.groups || object.epoch || object.referencePlane || object.tidalLock !== void 0 || object.resonance || object.renderHints || object.deriveRules?.length || object.validationRules?.length || object.lockedFields?.length || object.tolerances?.length || object.typedBlocks) {
         warnIfSchema21Feature(sourceSchemaVersion, diagnostics, node.id, node.location);
       }
     }
     return object;
   }
-  function collectDraftFields(fields) {
+  function normalizeDraftEvent(event, rawPoses) {
+    return {
+      ...event,
+      participantObjectIds: [...new Set(event.participantObjectIds)],
+      tags: [...new Set(event.tags)],
+      positions: rawPoses.map((pose) => normalizeDraftEventPose(pose))
+    };
+  }
+  function normalizeDraftEventPose(rawPose) {
+    const fieldMap = collectDraftFields(rawPose.fields, "event-pose");
+    const placement = extractPlacementFromFieldMap(fieldMap);
+    return {
+      objectId: rawPose.objectId,
+      placement,
+      inner: parseOptionalUnitField(fieldMap.get("inner")?.[0], "inner"),
+      outer: parseOptionalUnitField(fieldMap.get("outer")?.[0], "outer"),
+      epoch: parseOptionalJoinedValue(fieldMap.get("epoch")?.[0]),
+      referencePlane: parseOptionalJoinedValue(fieldMap.get("referencePlane")?.[0])
+    };
+  }
+  function collectDraftFields(fields, _mode = "object") {
     const grouped = /* @__PURE__ */ new Map();
     for (const field of fields) {
       const spec = getDraftObjectFieldSpec(field.key);
-      if (!spec) {
+      if (!spec && !EVENT_POSE_FIELD_KEYS.has(field.key)) {
         throw WorldOrbitError.fromLocation(`Unknown field "${field.key}"`, field.location);
       }
-      if (!spec.allowRepeat && grouped.has(field.key)) {
+      if (!spec?.allowRepeat && grouped.has(field.key)) {
         throw WorldOrbitError.fromLocation(`Duplicate field "${field.key}"`, field.location);
       }
       const existing = grouped.get(field.key) ?? [];
@@ -4606,7 +5618,7 @@ var WorldOrbit = (() => {
     }
     return grouped;
   }
-  function extractDraftPlacement(objectType, fieldMap) {
+  function extractPlacementFromFieldMap(fieldMap) {
     const orbitField = fieldMap.get("orbit")?.[0];
     const atField = fieldMap.get("at")?.[0];
     const surfaceField = fieldMap.get("surface")?.[0];
@@ -4774,7 +5786,7 @@ var WorldOrbit = (() => {
     }
   }
   function warnIfSchema21Feature(sourceSchemaVersion, diagnostics, featureName, location) {
-    if (sourceSchemaVersion === "2.1") {
+    if (!isSchemaOlderThan(sourceSchemaVersion, "2.1")) {
       return;
     }
     diagnostics.push({
@@ -4786,6 +5798,34 @@ var WorldOrbit = (() => {
       column: location.column
     });
   }
+  function warnIfSchema25Feature(sourceSchemaVersion, diagnostics, featureName, location) {
+    if (!isSchemaOlderThan(sourceSchemaVersion, "2.5")) {
+      return;
+    }
+    diagnostics.push({
+      code: "parse.schema25.featureCompatibility",
+      severity: "warning",
+      source: "parse",
+      message: `Feature "${featureName}" requires schema 2.5; parsed in compatibility mode because the document header is "schema ${sourceSchemaVersion}".`,
+      line: location.line,
+      column: location.column
+    });
+  }
+  function isSchemaOlderThan(sourceSchemaVersion, requiredVersion) {
+    return schemaVersionRank(sourceSchemaVersion) < schemaVersionRank(requiredVersion);
+  }
+  function schemaVersionRank(version) {
+    switch (version) {
+      case "2.0-draft":
+        return 0;
+      case "2.0":
+        return 1;
+      case "2.1":
+        return 2;
+      case "2.5":
+        return 3;
+    }
+  }
   function preprocessAtlasSource(source) {
     const chars = [...source];
     const comments = [];
@@ -4873,7 +5913,7 @@ var WorldOrbit = (() => {
   }
 
   // packages/core/dist/atlas-edit.js
-  function createEmptyAtlasDocument(systemId = "WorldOrbit", version = "2.0") {
+  function createEmptyAtlasDocument(systemId = "WorldOrbit", version = "2.5") {
     return {
       format: "worldorbit",
       version,
@@ -4899,6 +5939,7 @@ var WorldOrbit = (() => {
       },
       groups: [],
       relations: [],
+      events: [],
       objects: [],
       diagnostics: []
     };
@@ -4916,6 +5957,10 @@ var WorldOrbit = (() => {
         return path.key ? document2.system?.atlasMetadata[path.key] ?? null : null;
       case "group":
         return path.id ? findGroup(document2, path.id) : null;
+      case "event":
+        return path.id ? findEvent(document2, path.id) : null;
+      case "event-pose":
+        return path.id && path.key ? findEventPose(document2, path.id, path.key) : null;
       case "object":
         return path.id ? findObject(document2, path.id) : null;
       case "viewpoint":
@@ -4945,6 +5990,19 @@ var WorldOrbit = (() => {
           next.groups = next.groups.filter((group) => group.id !== path.id);
         }
         return next;
+      case "event":
+        if (path.id) {
+          next.events = next.events.filter((event) => event.id !== path.id);
+        }
+        return next;
+      case "event-pose":
+        if (path.id && path.key) {
+          const event = findEvent(next, path.id);
+          if (event) {
+            event.positions = event.positions.filter((pose) => pose.objectId !== path.key);
+          }
+        }
+        return next;
       case "viewpoint":
         if (path.id) {
           system.viewpoints = system.viewpoints.filter((viewpoint) => viewpoint.id !== path.id);
@@ -5013,6 +6071,22 @@ var WorldOrbit = (() => {
         };
       }
     }
+    if (diagnostic.field?.startsWith("event.")) {
+      const parts = diagnostic.field.split(".");
+      if (parts[1] && findEvent(document2, parts[1])) {
+        if (parts[2] === "pose" && parts[3] && findEventPose(document2, parts[1], parts[3])) {
+          return {
+            kind: "event-pose",
+            id: parts[1],
+            key: parts[3]
+          };
+        }
+        return {
+          kind: "event",
+          id: parts[1]
+        };
+      }
+    }
     if (diagnostic.field && diagnostic.field in ensureSystem(document2).atlasMetadata) {
       return {
         kind: "metadata",
@@ -5044,6 +6118,12 @@ var WorldOrbit = (() => {
   function findRelation(document2, relationId) {
     return document2.relations.find((relation) => relation.id === relationId) ?? null;
   }
+  function findEvent(document2, eventId) {
+    return document2.events.find((event) => event.id === eventId) ?? null;
+  }
+  function findEventPose(document2, eventId, objectId) {
+    return findEvent(document2, eventId)?.positions.find((pose) => pose.objectId === objectId) ?? null;
+  }
   function findViewpoint(system, viewpointId) {
     return system?.viewpoints.find((viewpoint) => viewpoint.id === viewpointId) ?? null;
   }
@@ -5052,8 +6132,9 @@ var WorldOrbit = (() => {
   }
 
   // packages/core/dist/load.js
-  var ATLAS_SCHEMA_PATTERN = /^schema\s+2(?:\.0|\.1)?$/i;
+  var ATLAS_SCHEMA_PATTERN = /^schema\s+2(?:\.0|\.1|\.5)?$/i;
   var ATLAS_SCHEMA_21_PATTERN = /^schema\s+2\.1$/i;
+  var ATLAS_SCHEMA_25_PATTERN = /^schema\s+2\.5$/i;
   var LEGACY_DRAFT_SCHEMA_PATTERN = /^schema\s+2\.0-draft$/i;
   function detectWorldOrbitSchemaVersion(source) {
     for (const line of stripCommentsForSchemaDetection(source).split(/\r?\n/)) {
@@ -5067,6 +6148,9 @@ var WorldOrbit = (() => {
       if (ATLAS_SCHEMA_21_PATTERN.test(trimmed)) {
         return "2.1";
       }
+      if (ATLAS_SCHEMA_25_PATTERN.test(trimmed)) {
+        return "2.5";
+      }
       if (ATLAS_SCHEMA_PATTERN.test(trimmed)) {
         return "2.0";
       }
@@ -5127,7 +6211,7 @@ var WorldOrbit = (() => {
   }
   function loadWorldOrbitSourceWithDiagnostics(source) {
     const schemaVersion = detectWorldOrbitSchemaVersion(source);
-    if (schemaVersion === "2.0" || schemaVersion === "2.0-draft" || schemaVersion === "2.1") {
+    if (schemaVersion === "2.0" || schemaVersion === "2.0-draft" || schemaVersion === "2.1" || schemaVersion === "2.5") {
       return loadAtlasSourceWithDiagnostics(source, schemaVersion);
     }
     let ast;
@@ -5221,6 +6305,7 @@ var WorldOrbit = (() => {
     background: true,
     guides: true,
     relations: true,
+    events: true,
     orbits: true,
     objects: true,
     labels: true,
@@ -5367,14 +6452,17 @@ var WorldOrbit = (() => {
   }
   function createAtlasStateSnapshot(viewerState, renderOptions, filter, viewpointId) {
     return {
-      version: "2.0",
+      version: "2.5",
       viewpointId,
+      activeEventId: renderOptions.activeEventId ?? null,
       viewerState: { ...viewerState },
       renderOptions: {
         preset: renderOptions.preset,
         projection: renderOptions.projection,
+        camera: renderOptions.camera ? { ...renderOptions.camera } : null,
         layers: renderOptions.layers ? { ...renderOptions.layers } : void 0,
-        scaleModel: renderOptions.scaleModel ? { ...renderOptions.scaleModel } : void 0
+        scaleModel: renderOptions.scaleModel ? { ...renderOptions.scaleModel } : void 0,
+        activeEventId: renderOptions.activeEventId ?? null
       },
       filter: normalizeViewerFilter(filter)
     };
@@ -5385,8 +6473,9 @@ var WorldOrbit = (() => {
   function deserializeViewerAtlasState(serialized) {
     const raw = JSON.parse(decodeURIComponent(serialized));
     return {
-      version: "2.0",
+      version: raw.version === "2.0" ? "2.0" : "2.5",
       viewpointId: raw.viewpointId ?? null,
+      activeEventId: raw.activeEventId ?? raw.renderOptions?.activeEventId ?? null,
       viewerState: {
         scale: raw.viewerState?.scale ?? 1,
         rotationDeg: raw.viewerState?.rotationDeg ?? 0,
@@ -5397,8 +6486,10 @@ var WorldOrbit = (() => {
       renderOptions: {
         preset: raw.renderOptions?.preset,
         projection: raw.renderOptions?.projection,
+        camera: raw.renderOptions?.camera ? { ...raw.renderOptions.camera } : null,
         layers: raw.renderOptions?.layers ? { ...raw.renderOptions.layers } : void 0,
-        scaleModel: raw.renderOptions?.scaleModel ? { ...raw.renderOptions.scaleModel } : void 0
+        scaleModel: raw.renderOptions?.scaleModel ? { ...raw.renderOptions.scaleModel } : void 0,
+        activeEventId: raw.activeEventId ?? raw.renderOptions?.activeEventId ?? null
       },
       filter: normalizeViewerFilter(raw.filter ?? null)
     };
@@ -5413,8 +6504,10 @@ var WorldOrbit = (() => {
         viewerState: { ...atlasState.viewerState },
         renderOptions: {
           ...atlasState.renderOptions,
+          camera: atlasState.renderOptions.camera ? { ...atlasState.renderOptions.camera } : null,
           layers: atlasState.renderOptions.layers ? { ...atlasState.renderOptions.layers } : void 0,
-          scaleModel: atlasState.renderOptions.scaleModel ? { ...atlasState.renderOptions.scaleModel } : void 0
+          scaleModel: atlasState.renderOptions.scaleModel ? { ...atlasState.renderOptions.scaleModel } : void 0,
+          activeEventId: atlasState.renderOptions.activeEventId ?? null
         },
         filter: atlasState.filter ? { ...atlasState.filter } : null
       }
@@ -5432,6 +6525,7 @@ var WorldOrbit = (() => {
       background: viewpoint.layers.background,
       guides: viewpoint.layers.guides,
       relations: viewpoint.layers.relations,
+      events: viewpoint.layers.events,
       orbits: viewpoint.layers["orbits-front"] === void 0 && viewpoint.layers["orbits-back"] === void 0 ? void 0 : viewpoint.layers["orbits-front"] !== false || viewpoint.layers["orbits-back"] !== false,
       objects: viewpoint.layers.objects,
       labels: viewpoint.layers.labels,
@@ -5718,6 +6812,7 @@ var WorldOrbit = (() => {
     const orbitMarkup = layers.orbits ? renderOrbitLayer(scene, visibleObjectIds, layers.structures) : { back: "", front: "" };
     const leaderMarkup = layers.guides ? scene.leaders.filter((leader) => !leader.hidden).filter((leader) => visibleObjectIds.has(leader.objectId)).filter((leader) => layers.structures || !isStructureLike(leader.object)).map((leader) => `<line class="wo-leader wo-leader-${leader.mode}" x1="${leader.x1}" y1="${leader.y1}" x2="${leader.x2}" y2="${leader.y2}" data-render-id="${escapeXml(leader.renderId)}" data-group-id="${escapeAttribute(leader.groupId ?? "")}" />`).join("") : "";
     const relationMarkup = layers.relations ? scene.relations.filter((relation) => !relation.hidden).filter((relation) => visibleObjectIds.has(relation.fromObjectId) && visibleObjectIds.has(relation.toObjectId)).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 eventMarkup = layers.events ? scene.events.filter((event) => !event.hidden).map((event) => renderSceneEventOverlay(scene, event, visibleObjectIds, theme)).join("") : "";
     const objectMarkup = layers.objects ? visibleObjects.map((object) => renderSceneObject(object, options.selectedObjectId ?? null, theme)).join("") : "";
     const labelMarkup = layers.labels ? visibleLabels.map((label) => renderSceneLabel(scene, label, options.selectedObjectId ?? null)).join("") : "";
     const metadataMarkup = layers.metadata ? `<text class="wo-title" x="56" y="64">${escapeXml(scene.title)}</text>
@@ -5753,6 +6848,9 @@ var WorldOrbit = (() => {
     .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-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-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; }
@@ -5787,6 +6885,7 @@ var WorldOrbit = (() => {
         ${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.labels ? `<g data-layer-id="labels">${labelMarkup}</g>` : ""}
@@ -5794,6 +6893,20 @@ var WorldOrbit = (() => {
     </g>
   </g>
 </svg>`;
+  }
+  function renderSceneEventOverlay(scene, event, visibleObjectIds, theme) {
+    const participants = event.objectIds.filter((objectId) => visibleObjectIds.has(objectId)).map((objectId) => scene.objects.find((object) => object.objectId === objectId && !object.hidden)).filter(Boolean);
+    if (participants.length === 0) {
+      return "";
+    }
+    const stroke = event.event.color || theme.accent;
+    const label = event.event.label || event.event.id;
+    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>
+  </g>`;
   }
   function renderOrbitLayer(scene, visibleObjectIds, includeStructures) {
     const backParts = [];
@@ -6376,6 +7489,13 @@ var WorldOrbit = (() => {
         value: `${details.object.resonance.targetObjectId} ${details.object.resonance.ratio}`
       });
     }
+    if (details.relatedEvents.length > 0) {
+      fields.set("events", {
+        key: "events",
+        label: "Events",
+        value: details.relatedEvents.map((event) => event.event.label || event.event.id).join(", ")
+      });
+    }
     if (placement?.mode === "at") {
       fields.set("placement", {
         key: "placement",
@@ -6480,6 +7600,7 @@ var WorldOrbit = (() => {
       padding: options.padding,
       preset: options.preset,
       projection: options.projection,
+      camera: options.camera ? { ...options.camera } : null,
       scaleModel: options.scaleModel ? { ...options.scaleModel } : void 0,
       theme: options.theme,
       layers: options.layers,
@@ -6768,6 +7889,11 @@ var WorldOrbit = (() => {
         if (currentInput.kind !== "scene" && viewpoint.projection !== scene.projection) {
           nextRenderOptions.projection = viewpoint.projection;
         }
+        if (viewpoint.camera) {
+          nextRenderOptions.camera = { ...viewpoint.camera };
+        } else if (renderOptions.camera) {
+          nextRenderOptions.camera = null;
+        }
         if (viewpointLayers) {
           nextRenderOptions.layers = viewpointLayers;
         }
@@ -6790,6 +7916,12 @@ var WorldOrbit = (() => {
         emitAtlasStateChange();
         return true;
       },
+      getActiveEventId() {
+        return renderOptions.activeEventId ?? null;
+      },
+      setActiveEvent(id) {
+        api.setRenderOptions({ activeEventId: id });
+      },
       search(query, limit = 12) {
         return searchSceneObjects(scene, query, limit);
       },
@@ -7054,6 +8186,7 @@ var WorldOrbit = (() => {
         orbit: scene.orbitVisuals.find((orbit) => orbit.objectId === renderObject.objectId && !orbit.hidden) ?? null,
         relatedOrbits: scene.orbitVisuals.filter((orbit) => !orbit.hidden && (orbit.objectId === renderObject.objectId || renderObject.ancestorIds.includes(orbit.objectId) || renderObject.childIds.includes(orbit.objectId))),
         relations: scene.relations.filter((relation) => !relation.hidden && (relation.fromObjectId === renderObject.objectId || relation.toObjectId === renderObject.objectId)),
+        relatedEvents: scene.events.filter((event) => !event.hidden && (event.targetObjectId === renderObject.objectId || event.objectIds.includes(renderObject.objectId))),
         parent: getObjectById(renderObject.parentId),
         children: renderObject.childIds.map((childId) => getObjectById(childId)).filter(Boolean),
         ancestors: renderObject.ancestorIds.map((ancestorId) => getObjectById(ancestorId)).filter(Boolean),
@@ -7367,16 +8500,19 @@ var WorldOrbit = (() => {
   function cloneRenderOptions(renderOptions) {
     return {
       ...renderOptions,
+      camera: renderOptions.camera ? { ...renderOptions.camera } : null,
       filter: renderOptions.filter ? { ...renderOptions.filter } : void 0,
       scaleModel: renderOptions.scaleModel ? { ...renderOptions.scaleModel } : void 0,
       layers: renderOptions.layers ? { ...renderOptions.layers } : void 0,
-      theme: renderOptions.theme && typeof renderOptions.theme === "object" ? { ...renderOptions.theme } : renderOptions.theme
+      theme: renderOptions.theme && typeof renderOptions.theme === "object" ? { ...renderOptions.theme } : renderOptions.theme,
+      activeEventId: renderOptions.activeEventId ?? null
     };
   }
   function mergeRenderOptions(current, next) {
     return {
       ...current,
       ...next,
+      camera: next.camera !== void 0 ? next.camera ? { ...next.camera } : null : current.camera ? { ...current.camera } : null,
       filter: next.filter !== void 0 ? normalizeViewerFilter(next.filter) : current.filter ? { ...current.filter } : void 0,
       scaleModel: next.scaleModel ? {
         ...current.scaleModel ?? {},
@@ -7390,7 +8526,7 @@ var WorldOrbit = (() => {
     };
   }
   function hasSceneAffectingRenderOptions(options) {
-    return options.width !== void 0 || options.height !== void 0 || options.padding !== void 0 || options.preset !== void 0 || options.projection !== void 0 || options.scaleModel !== void 0;
+    return options.width !== void 0 || options.height !== void 0 || options.padding !== void 0 || options.preset !== void 0 || options.projection !== void 0 || options.camera !== void 0 || options.scaleModel !== void 0 || options.activeEventId !== void 0;
   }
   function resolveSourceRenderOptions(loaded, renderOptions) {
     const atlasDocument = loaded.atlasDocument ?? loaded.draftDocument;
@@ -7701,7 +8837,11 @@ var WorldOrbit = (() => {
   var FIELD_HELP = {
     "defaults-view": {
       description: "Sets the default camera projection for the atlas.",
-      references: ["Topdown = map-like", "Isometric = angled overview"]
+      references: [
+        "Topdown = map-like",
+        "Isometric = angled overview",
+        "Orthographic/Perspective = 3D-ready semantic views"
+      ]
     },
     "defaults-scale": {
       description: "Chooses the overall spacing/style preset used by the renderer.",
@@ -7713,15 +8853,71 @@ var WorldOrbit = (() => {
     },
     "viewpoint-projection": {
       description: "Overrides the projection for this saved viewpoint.",
-      references: ["Topdown = flat orbital map", "Isometric = angled scene"]
+      references: [
+        "Topdown = flat orbital map",
+        "Isometric = angled scene",
+        "Orthographic/Perspective = stored with current 2D fallback"
+      ]
     },
     "viewpoint-zoom": {
       description: "Controls how closely this viewpoint frames the system.",
       references: ["1 = scene fit", "2+ = close-up"]
     },
     "viewpoint-rotation": {
-      description: "Rotates the saved camera angle in degrees.",
-      references: ["90deg = quarter turn", "180deg = flip"]
+      description: "Legacy 2D screen rotation. This is separate from the Schema 2.5 camera block.",
+      references: ["90deg = quarter turn", "Use camera.azimuth for semantic view direction"]
+    },
+    "viewpoint-camera-azimuth": {
+      description: "Horizontal camera direction in degrees for Schema 2.5 viewpoints.",
+      references: ["0 = forward/default", "90 = quarter orbit around the scene"]
+    },
+    "viewpoint-camera-elevation": {
+      description: "Vertical camera tilt in degrees for 3D-ready viewpoints.",
+      references: ["0 = level", "30 = gentle look down"]
+    },
+    "viewpoint-camera-roll": {
+      description: "Rolls the camera around its forward axis.",
+      references: ["0 = upright", "15 = slight bank"]
+    },
+    "viewpoint-camera-distance": {
+      description: "Semantic camera distance for perspective viewpoints.",
+      references: ["4 = close", "12 = wide framing"]
+    },
+    "viewpoint-events": {
+      description: "Lists event IDs that this viewpoint should feature in its detail panel.",
+      references: ["solar-eclipse-naar", "transit-window conjunction"]
+    },
+    "event-kind": {
+      description: "Short semantic event type for tooling and viewer overlays.",
+      references: ["solar-eclipse", "lunar-eclipse", "transit"]
+    },
+    "event-target": {
+      description: "Primary object this event is centered on.",
+      references: ["Naar", "Seyra"]
+    },
+    "event-participants": {
+      description: "Objects that participate in the event snapshot or description.",
+      references: ["Iyath Naar Seyra", "Naar Seyra Orun"]
+    },
+    "event-timing": {
+      description: "Free-text timing note for the event.",
+      references: ['"Every late bloom season"', '"At local midyear"']
+    },
+    "event-visibility": {
+      description: "Notes where or how the event is visible.",
+      references: ['"Visible from Naar"', '"Southern hemisphere only"']
+    },
+    "event-epoch": {
+      description: "Optional event-wide epoch that event poses inherit unless they override it.",
+      references: ['"JY-0001.0"', '"Naar bloom cycle year 18"']
+    },
+    "event-referencePlane": {
+      description: "Optional event-wide reference plane for all poses in this snapshot.",
+      references: ["ecliptic", "naar-equatorial"]
+    },
+    "event-viewpoints": {
+      description: "Viewpoint IDs that should list this event prominently.",
+      references: ["naar-system", "overview inner-system"]
     },
     "placement-target": {
       description: "Names the body or reference this object is attached to.",
@@ -7759,6 +8955,14 @@ var WorldOrbit = (() => {
       description: "Starting position of the object along its orbit.",
       references: ["0deg = start position", "180deg = opposite side"]
     },
+    "pose-epoch": {
+      description: "Overrides the effective epoch for this pose only.",
+      references: ['"JY-0001.0"', "Falls back to event, object, then system"]
+    },
+    "pose-referencePlane": {
+      description: "Overrides the effective reference plane for this pose only.",
+      references: ["naar-equatorial", "Falls back to event, object, then system"]
+    },
     "prop-radius": {
       description: "Visual body size or real-world-inspired radius value.",
       references: ["1re = Earth radius", "1sol = Sun radius"]
@@ -7841,12 +9045,23 @@ var WorldOrbit = (() => {
       minimap: true,
       tooltipMode: "hover",
       onSelectionChange(selectedObject) {
+        const activeEventId = selection ? selectionEventId(selection) : null;
         if (ignoreViewerSelection || !selectedObject) {
-          if (!ignoreViewerSelection && selection?.kind === "object") {
-            setSelection(null, false, true);
+          if (!ignoreViewerSelection) {
+            if (selection?.kind === "event-pose" && selection.id) {
+              setSelection({ kind: "event", id: selection.id }, false, true);
+            } else if (selection?.kind === "object") {
+              setSelection(activeEventId ? { kind: "event", id: activeEventId } : null, false, true);
+            } else if (selection?.kind === "event" && selection.id) {
+              setSelection({ kind: "event", id: selection.id }, false, true);
+            }
           }
           return;
         }
+        if (activeEventId && findEventPose2(atlasDocument, activeEventId, selectedObject.objectId)) {
+          setSelection({ kind: "event-pose", id: activeEventId, key: selectedObject.objectId }, false, true);
+          return;
+        }
         setSelection({ kind: "object", id: selectedObject.objectId }, false, true);
       },
       onViewChange() {
@@ -7856,6 +9071,7 @@ var WorldOrbit = (() => {
     toolbar.addEventListener("click", handleToolbarClick);
     outline.addEventListener("click", handleOutlineClick);
     overlay.addEventListener("pointerdown", handleOverlayPointerDown);
+    inspector?.addEventListener("click", handleInspectorClick);
     inspector?.addEventListener("input", handleInspectorInput);
     inspector?.addEventListener("change", handleInspectorChange);
     sourcePane?.addEventListener("input", handleSourceInput);
@@ -7930,6 +9146,30 @@ var WorldOrbit = (() => {
         replaceAtlasDocument(nextDocument, true, { kind: "object", id });
         return id;
       },
+      addEvent() {
+        const id = createUniqueId("event", atlasDocument.events.map((event) => event.id));
+        const created = {
+          id,
+          kind: "",
+          label: humanizeIdentifier4(id),
+          summary: null,
+          targetObjectId: null,
+          participantObjectIds: [],
+          timing: null,
+          visibility: null,
+          epoch: null,
+          referencePlane: null,
+          tags: [],
+          color: null,
+          hidden: false,
+          positions: []
+        };
+        const nextDocument = cloneAtlasDocument(atlasDocument);
+        nextDocument.events.push(created);
+        nextDocument.events.sort(compareEvents);
+        replaceAtlasDocument(nextDocument, true, { kind: "event", id });
+        return id;
+      },
       addViewpoint() {
         const id = createUniqueId("viewpoint", atlasDocument.system?.viewpoints.map((viewpoint) => viewpoint.id) ?? []);
         const created = {
@@ -7938,10 +9178,12 @@ var WorldOrbit = (() => {
           summary: "",
           focusObjectId: null,
           selectedObjectId: null,
+          events: [],
           projection: atlasDocument.system?.defaults.view ?? "topdown",
           preset: atlasDocument.system?.defaults.preset ?? null,
           zoom: null,
           rotationDeg: 0,
+          camera: null,
           layers: {},
           filter: null
         };
@@ -7998,6 +9240,7 @@ var WorldOrbit = (() => {
         toolbar.removeEventListener("click", handleToolbarClick);
         outline.removeEventListener("click", handleOutlineClick);
         overlay.removeEventListener("pointerdown", handleOverlayPointerDown);
+        inspector?.removeEventListener("click", handleInspectorClick);
         inspector?.removeEventListener("input", handleInspectorInput);
         inspector?.removeEventListener("change", handleInspectorChange);
         sourcePane?.removeEventListener("input", handleSourceInput);
@@ -8043,7 +9286,7 @@ var WorldOrbit = (() => {
     }
     function getCurrentSourceForExport() {
       if (dragState?.changed) {
-        return formatDocument(atlasDocument, { schema: "2.0" });
+        return formatAtlasSource(atlasDocument);
       }
       return canonicalSource;
     }
@@ -8082,7 +9325,7 @@ var WorldOrbit = (() => {
       }
       clearSourceInputTimer();
       atlasDocument = cloneAtlasDocument(nextDocument);
-      canonicalSource = formatDocument(atlasDocument, { schema: "2.0" });
+      canonicalSource = formatAtlasSource(atlasDocument);
       if (!preserveSourceText) {
         sourceText = canonicalSource;
       }
@@ -8123,10 +9366,10 @@ var WorldOrbit = (() => {
       if (commitHistory) {
         history.push(createHistoryEntry());
         future.length = 0;
-        sourceText = formatDocument(nextDocument, { schema: "2.0" });
+        sourceText = formatAtlasSource(nextDocument);
       }
       atlasDocument = cloneAtlasDocument(nextDocument);
-      canonicalSource = formatDocument(atlasDocument, { schema: "2.0" });
+      canonicalSource = formatAtlasSource(atlasDocument);
       diagnostics = mergeDiagnostics(loadedDiagnostics, collectDocumentDiagnostics(atlasDocument));
       selection = normalizeSelection(selection);
       syncViewer({
@@ -8145,11 +9388,13 @@ var WorldOrbit = (() => {
       const previousState = viewer.getState();
       const currentRenderOptions = viewer.getRenderOptions();
       const nextPreset = atlasDocument.system?.defaults.preset ?? "atlas-card";
+      const nextActiveEventId = selection ? selectionEventId(selection) : null;
       ignoreViewerSelection = true;
-      if (currentRenderOptions.preset !== nextPreset || currentRenderOptions.projection !== "document") {
+      if (currentRenderOptions.preset !== nextPreset || currentRenderOptions.projection !== "document" || (currentRenderOptions.activeEventId ?? null) !== nextActiveEventId) {
         viewer.setRenderOptions({
           preset: nextPreset,
-          projection: "document"
+          projection: "document",
+          activeEventId: nextActiveEventId
         });
       }
       viewer.setDocument(materializeAtlasDocument(atlasDocument));
@@ -8158,10 +9403,12 @@ var WorldOrbit = (() => {
       } else if (options2.preserveCamera !== false) {
         viewer.setState({
           ...previousState,
-          selectedObjectId: selection?.kind === "object" ? selection.id ?? null : null
+          selectedObjectId: selection?.kind === "object" ? selection.id ?? null : selection?.kind === "event-pose" ? selection.key ?? null : null
         });
       } else if (selection?.kind === "object" && selection.id) {
         viewer.focusObject(selection.id);
+      } else if (selection?.kind === "event-pose" && selection.key) {
+        viewer.focusObject(selection.key);
       }
       ignoreViewerSelection = false;
     }
@@ -8180,8 +9427,11 @@ var WorldOrbit = (() => {
       selection = normalizeSelection(nextSelection);
       if (syncViewerSelection) {
         ignoreViewerSelection = true;
+        viewer.setRenderOptions({ activeEventId: selection ? selectionEventId(selection) : null });
         if (selection?.kind === "object" && selection.id) {
           viewer.focusObject(selection.id);
+        } else if (selection?.kind === "event-pose" && selection.key) {
+          viewer.focusObject(selection.key);
         } else if (selection?.kind === "viewpoint" && selection.id) {
           viewer.goToViewpoint(selection.id);
         }
@@ -8231,6 +9481,7 @@ var WorldOrbit = (() => {
           ${OBJECT_TYPES.map((type) => `<option value="${escapeHtml3(type)}"${type === objectType ? " selected" : ""}>${escapeHtml3(humanizeIdentifier4(type))}</option>`).join("")}
         </select>
         <button type="button" data-editor-action="add-object">Add object</button>
+        <button type="button" data-editor-action="add-event">Add event</button>
         <button type="button" data-editor-action="add-viewpoint">Add viewpoint</button>
         <button type="button" data-editor-action="add-annotation">Add annotation</button>
         <button type="button" data-editor-action="add-metadata">Add metadata</button>
@@ -8265,6 +9516,10 @@ var WorldOrbit = (() => {
         <h3>Annotations</h3>
         ${(atlasDocument.system?.annotations.length ?? 0) > 0 ? atlasDocument.system?.annotations.map((annotation) => renderOutlineButton({ kind: "annotation", id: annotation.id }, annotation.label, activeKey, diagnosticBuckets)).join("") : `<p class="wo-editor-empty">No annotations yet.</p>`}
       </div>
+      <div class="wo-editor-outline-section">
+        <h3>Events</h3>
+        ${atlasDocument.events.length > 0 ? atlasDocument.events.map((eventEntry) => renderEventOutlineItems(eventEntry, activeKey, diagnosticBuckets)).join("") : `<p class="wo-editor-empty">No events yet.</p>`}
+      </div>
       <div class="wo-editor-outline-section">
         <h3>Objects</h3>
         ${atlasDocument.objects.length > 0 ? atlasDocument.objects.map((object) => renderOutlineButton({ kind: "object", id: object.id }, `${object.id} - ${object.type}`, activeKey, diagnosticBuckets)).join("") : `<p class="wo-editor-empty">No objects yet.</p>`}
@@ -8302,6 +9557,7 @@ var WorldOrbit = (() => {
         selection: selection ? { path: { ...selection } } : null,
         system: atlasDocument.system,
         viewpoints: atlasDocument.system?.viewpoints ?? [],
+        events: atlasDocument.events,
         objects: atlasDocument.objects
       };
       if (!selection) {
@@ -8330,6 +9586,16 @@ var WorldOrbit = (() => {
           applyInspectorSectionState(inspector, inspectorSectionState);
           decorateInspectorDiagnostics(selection, diagnostics);
           return;
+        case "event":
+          inspector.innerHTML = diagnosticSummary + renderEventInspector(formState, selection.id ?? "");
+          applyInspectorSectionState(inspector, inspectorSectionState);
+          decorateInspectorDiagnostics(selection, diagnostics);
+          return;
+        case "event-pose":
+          inspector.innerHTML = diagnosticSummary + renderEventPoseInspector(formState, selection.id ?? "", selection.key ?? "");
+          applyInspectorSectionState(inspector, inspectorSectionState);
+          decorateInspectorDiagnostics(selection, diagnostics);
+          return;
         case "annotation":
           inspector.innerHTML = diagnosticSummary + renderAnnotationInspector(formState, selection.id ?? "");
           applyInspectorSectionState(inspector, inspectorSectionState);
@@ -8362,10 +9628,11 @@ var WorldOrbit = (() => {
         return;
       }
       overlay.innerHTML = "";
-      if (selection?.kind !== "object" || !selection.id) {
+      const selectedObjectId = selection?.kind === "object" ? selection.id ?? null : selection?.kind === "event-pose" ? selection.key ?? null : null;
+      if (!selectedObjectId) {
         return;
       }
-      const details = viewer.getObjectDetails(selection.id);
+      const details = viewer.getObjectDetails(selectedObjectId);
       if (!details) {
         return;
       }
@@ -8477,6 +9744,9 @@ var WorldOrbit = (() => {
         case "add-viewpoint":
           api.addViewpoint();
           return;
+        case "add-event":
+          api.addEvent();
+          return;
         case "add-annotation":
           api.addAnnotation();
           return;
@@ -8511,6 +9781,32 @@ var WorldOrbit = (() => {
         key: button.dataset.pathKey || void 0
       }, true, true);
     }
+    function handleInspectorClick(event) {
+      const pathButton = event.target?.closest("[data-path-kind]");
+      if (pathButton) {
+        setSelection({
+          kind: pathButton.dataset.pathKind,
+          id: pathButton.dataset.pathId || void 0,
+          key: pathButton.dataset.pathKey || void 0
+        }, true, true);
+        return;
+      }
+      const actionButton = event.target?.closest("[data-editor-action]");
+      if (!actionButton) {
+        return;
+      }
+      if (actionButton.dataset.editorAction === "add-event-pose") {
+        const eventId = actionButton.dataset.editorEventId || (selection?.kind === "event" || selection?.kind === "event-pose" ? selection.id ?? "" : "");
+        if (!eventId) {
+          return;
+        }
+        const nextDocument = addEventPose(atlasDocument, eventId);
+        const createdEvent = nextDocument.events.find((entry) => entry.id === eventId);
+        const createdPose = createdEvent?.positions.at(-1) ?? createdEvent?.positions[0];
+        replaceAtlasDocument(nextDocument, true, createdPose ? { kind: "event-pose", id: eventId, key: createdPose.objectId } : { kind: "event", id: eventId });
+        return;
+      }
+    }
     function handleInspectorInput() {
       applyInspectorState(false);
     }
@@ -8534,6 +9830,12 @@ var WorldOrbit = (() => {
         case "viewpoint":
           replaceAtlasDocument(buildViewpointDocumentFromInspector(selection.id ?? ""), commitHistory, selection, false);
           return;
+        case "event":
+          replaceAtlasDocument(buildEventDocumentFromInspector(selection.id ?? ""), commitHistory, selection, false);
+          return;
+        case "event-pose":
+          replaceAtlasDocument(buildEventPoseDocumentFromInspector(selection.id ?? "", selection.key ?? ""), commitHistory, selection, false);
+          return;
         case "annotation":
           replaceAtlasDocument(buildAnnotationDocumentFromInspector(selection.id ?? ""), commitHistory, selection, false);
           return;
@@ -8602,6 +9904,7 @@ var WorldOrbit = (() => {
         kind,
         objectId,
         pointerId: event.pointerId,
+        path: selection ? { ...selection } : { kind: "object", id: objectId },
         startedFrom: createHistoryEntry(),
         changed: false,
         orbitRadiusContext: kind === "orbit-radius" && details ? createOrbitRadiusDragContext(atlasDocument, viewer.getScene(), details) : null
@@ -8610,7 +9913,7 @@ var WorldOrbit = (() => {
       event.preventDefault();
     }
     function handleWindowPointerMove(event) {
-      if (!dragState || dragState.pointerId !== event.pointerId || selection?.kind !== "object" || selection.id !== dragState.objectId) {
+      if (!dragState || dragState.pointerId !== event.pointerId || !selection || selectionKey(selection) !== selectionKey(dragState.path)) {
         return;
       }
       const details = viewer.getObjectDetails(dragState.objectId);
@@ -8622,27 +9925,27 @@ var WorldOrbit = (() => {
       switch (dragState.kind) {
         case "orbit-phase":
           if (details.object.placement?.mode === "orbit" && details.orbit) {
-            nextDocument = updateOrbitPhase(atlasDocument, dragState.objectId, details, pointer);
+            nextDocument = updateOrbitPhase(atlasDocument, dragState.path, dragState.objectId, details, pointer);
           }
           break;
         case "orbit-radius":
           if (details.object.placement?.mode === "orbit" && details.orbit) {
-            nextDocument = updateOrbitRadius(atlasDocument, dragState.objectId, details, pointer, dragState.orbitRadiusContext ?? null);
+            nextDocument = updateOrbitRadius(atlasDocument, dragState.path, dragState.objectId, details, pointer, dragState.orbitRadiusContext ?? null);
           }
           break;
         case "at-reference":
           if (details.object.placement?.mode === "at") {
-            nextDocument = updateAtReference(atlasDocument, dragState.objectId, viewer.getScene(), pointer);
+            nextDocument = updateAtReference(atlasDocument, dragState.path, dragState.objectId, viewer.getScene(), pointer);
           }
           break;
         case "surface-target":
           if (details.object.placement?.mode === "surface") {
-            nextDocument = updateSurfaceTarget(atlasDocument, dragState.objectId, viewer.getScene(), pointer);
+            nextDocument = updateSurfaceTarget(atlasDocument, dragState.path, dragState.objectId, viewer.getScene(), pointer);
           }
           break;
         case "free-distance":
           if (details.object.placement?.mode === "free") {
-            nextDocument = updateFreeDistance(atlasDocument, dragState.objectId, viewer.getScene(), details, pointer);
+            nextDocument = updateFreeDistance(atlasDocument, dragState.path, dragState.objectId, viewer.getScene(), details, pointer);
           }
           break;
       }
@@ -8674,7 +9977,7 @@ var WorldOrbit = (() => {
       }
       history.push(dragState.startedFrom);
       future.length = 0;
-      canonicalSource = formatDocument(atlasDocument, { schema: "2.0" });
+      canonicalSource = formatAtlasSource(atlasDocument);
       sourceText = canonicalSource;
       dragState = null;
       renderAll();
@@ -8772,15 +10075,18 @@ var WorldOrbit = (() => {
         preset: readOptionalTextInput(form, "viewpoint-preset") ?? null,
         zoom: parseNullableNumber(readOptionalTextInput(form, "viewpoint-zoom")),
         rotationDeg: parseNullableNumber(readOptionalTextInput(form, "viewpoint-rotation")) ?? 0,
+        camera: buildViewCameraFromForm(form),
         layers: {
           background: readCheckbox(form, "layer-background"),
           guides: readCheckbox(form, "layer-guides"),
           "orbits-back": readCheckbox(form, "layer-orbits-back"),
           "orbits-front": readCheckbox(form, "layer-orbits-front"),
+          events: readCheckbox(form, "layer-events"),
           objects: readCheckbox(form, "layer-objects"),
           labels: readCheckbox(form, "layer-labels"),
           metadata: readCheckbox(form, "layer-metadata")
         },
+        events: splitTokens(readOptionalTextInput(form, "viewpoint-events")),
         filter: {
           query: readOptionalTextInput(form, "filter-query"),
           objectTypes: parseObjectTypes(readOptionalTextInput(form, "filter-object-types")),
@@ -8794,6 +10100,70 @@ var WorldOrbit = (() => {
       }
       return nextDocument;
     }
+    function buildEventDocumentFromInspector(currentId) {
+      const nextDocument = cloneAtlasDocument(atlasDocument);
+      const form = inspector?.querySelector("form[data-editor-form='event']");
+      const current = nextDocument.events.find((entry) => entry.id === currentId);
+      if (!form || !current) {
+        return nextDocument;
+      }
+      const nextId = readTextInput(form, "event-id") || current.id;
+      const replacement = {
+        ...current,
+        id: nextId,
+        kind: readTextInput(form, "event-kind"),
+        label: readTextInput(form, "event-label") || current.label,
+        summary: readOptionalTextInput(form, "event-summary"),
+        targetObjectId: readOptionalTextInput(form, "event-target"),
+        participantObjectIds: splitTokens(readOptionalTextInput(form, "event-participants")),
+        timing: readOptionalTextInput(form, "event-timing"),
+        visibility: readOptionalTextInput(form, "event-visibility"),
+        epoch: readOptionalTextInput(form, "event-epoch"),
+        referencePlane: readOptionalTextInput(form, "event-referencePlane"),
+        tags: splitTokens(readOptionalTextInput(form, "event-tags")),
+        color: readOptionalTextInput(form, "event-color"),
+        hidden: readCheckbox(form, "event-hidden")
+      };
+      nextDocument.events = nextDocument.events.filter((entry) => entry.id !== current.id).concat(replacement).sort(compareEvents);
+      syncEventViewpointReferences(nextDocument, current.id, replacement.id, splitTokens(readOptionalTextInput(form, "event-viewpoints")));
+      if (current.id !== replacement.id) {
+        selection = { kind: "event", id: replacement.id };
+      }
+      return nextDocument;
+    }
+    function buildEventPoseDocumentFromInspector(eventId, objectId) {
+      const nextDocument = cloneAtlasDocument(atlasDocument);
+      const form = inspector?.querySelector("form[data-editor-form='event-pose']");
+      const eventEntry = nextDocument.events.find((entry) => entry.id === eventId);
+      const currentPose = eventEntry?.positions.find((entry) => entry.objectId === objectId);
+      if (!form || !eventEntry || !currentPose) {
+        return nextDocument;
+      }
+      const nextObjectId = readTextInput(form, "pose-object-id") || currentPose.objectId;
+      const replacement = {
+        objectId: nextObjectId,
+        placement: buildPlacementFromPoseForm(form, currentPose),
+        epoch: readOptionalTextInput(form, "pose-epoch"),
+        referencePlane: readOptionalTextInput(form, "pose-referencePlane")
+      };
+      const inner = parseOptionalUnit(readOptionalTextInput(form, "prop-inner"));
+      const outer = parseOptionalUnit(readOptionalTextInput(form, "prop-outer"));
+      if (inner) {
+        replacement.inner = inner;
+      }
+      if (outer) {
+        replacement.outer = outer;
+      }
+      eventEntry.positions = eventEntry.positions.filter((entry) => entry.objectId !== currentPose.objectId).concat(replacement).sort(compareEventPoses);
+      if (eventEntry.targetObjectId !== replacement.objectId && !eventEntry.participantObjectIds.includes(replacement.objectId)) {
+        eventEntry.participantObjectIds.push(replacement.objectId);
+        eventEntry.participantObjectIds.sort((left, right) => left.localeCompare(right));
+      }
+      if (currentPose.objectId !== replacement.objectId) {
+        selection = { kind: "event-pose", id: eventId, key: replacement.objectId };
+      }
+      return nextDocument;
+    }
     function buildAnnotationDocumentFromInspector(currentId) {
       const nextDocument = cloneAtlasDocument(atlasDocument);
       const form = inspector?.querySelector("form[data-editor-form='annotation']");
@@ -8986,7 +10356,7 @@ var WorldOrbit = (() => {
       const atlasDocument2 = cloneAtlasDocument(options.atlasDocument);
       return {
         atlasDocument: atlasDocument2,
-        source: formatDocument(atlasDocument2, { schema: "2.0" }),
+        source: formatAtlasSource(atlasDocument2),
         diagnostics: collectDocumentDiagnostics(atlasDocument2)
       };
     }
@@ -8996,7 +10366,7 @@ var WorldOrbit = (() => {
         const atlasDocument2 = loaded.value.atlasDocument ?? upgradeDocumentToV2(loaded.value.document);
         return {
           atlasDocument: atlasDocument2,
-          source: formatDocument(atlasDocument2, { schema: "2.0" }),
+          source: formatAtlasSource(atlasDocument2),
           diagnostics: mergeDiagnostics(resolveAtlasDiagnostics(atlasDocument2, loaded.diagnostics), collectDocumentDiagnostics(atlasDocument2))
         };
       }
@@ -9004,10 +10374,13 @@ var WorldOrbit = (() => {
     const atlasDocument = createEmptyAtlasDocument("WorldOrbit");
     return {
       atlasDocument,
-      source: formatDocument(atlasDocument, { schema: "2.0" }),
+      source: formatAtlasSource(atlasDocument),
       diagnostics: collectDocumentDiagnostics(atlasDocument)
     };
   }
+  function formatAtlasSource(document2) {
+    return formatDocument(document2, { schema: document2.version });
+  }
   function buildEditorMarkup() {
     const previewOpen = shouldPreviewSectionBeOpenByDefault();
     return `<section class="wo-editor-shell">
@@ -9122,6 +10495,12 @@ var WorldOrbit = (() => {
     const badge = bucket && (bucket.errors > 0 || bucket.warnings > 0) ? `<span class="wo-editor-outline-badge${bucket.errors > 0 ? " is-error" : " is-warning"}">${bucket.errors > 0 ? bucket.errors : bucket.warnings}</span>` : "";
     return `<button type="button" class="wo-editor-outline-item${key === activeKey ? " is-active" : ""}" data-path-kind="${escapeHtml3(path.kind)}"${path.id ? ` data-path-id="${escapeHtml3(path.id)}"` : ""}${path.key ? ` data-path-key="${escapeHtml3(path.key)}"` : ""}><span>${escapeHtml3(label)}</span>${badge}</button>`;
   }
+  function renderEventOutlineItems(eventEntry, activeKey, diagnosticBuckets) {
+    return `<div class="wo-editor-outline-group">
+    ${renderOutlineButton({ kind: "event", id: eventEntry.id }, eventEntry.label || eventEntry.id, activeKey, diagnosticBuckets)}
+    ${eventEntry.positions.length > 0 ? `<div class="wo-editor-outline-children">${[...eventEntry.positions].sort(compareEventPoses).map((pose) => renderOutlineButton({ kind: "event-pose", id: eventEntry.id, key: pose.objectId }, pose.objectId, activeKey, diagnosticBuckets)).join("")}</div>` : ""}
+  </div>`;
+  }
   function renderSystemInspector(formState) {
     return `<form class="wo-editor-form" data-editor-form="system">
     <h2>System</h2>
@@ -9135,7 +10514,9 @@ var WorldOrbit = (() => {
     <h2>Defaults</h2>
     ${renderInspectorSection("defaults", "basics", "Basics", `${renderSelectField("Projection", "defaults-view", [
       ["topdown", "Topdown"],
-      ["isometric", "Isometric"]
+      ["isometric", "Isometric"],
+      ["orthographic", "Orthographic"],
+      ["perspective", "Perspective"]
     ], defaults?.view ?? "topdown")}
       ${renderTextField("Scale preset", "defaults-scale", defaults?.scale ?? "")}
       ${renderTextField("Units", "defaults-units", defaults?.units ?? "")}
@@ -9171,7 +10552,9 @@ var WorldOrbit = (() => {
       ${renderTextField("Selected object", "viewpoint-select", viewpoint.selectedObjectId ?? "")}
       ${renderSelectField("Projection", "viewpoint-projection", [
       ["topdown", "Topdown"],
-      ["isometric", "Isometric"]
+      ["isometric", "Isometric"],
+      ["orthographic", "Orthographic"],
+      ["perspective", "Perspective"]
     ], viewpoint.projection)}
       ${renderSelectField("Preset", "viewpoint-preset", [
       ["", "Document default"],
@@ -9182,12 +10565,18 @@ var WorldOrbit = (() => {
     ], viewpoint.preset ?? "")}
       ${renderTextField("Zoom", "viewpoint-zoom", viewpoint.zoom === null ? "" : String(viewpoint.zoom))}
       ${renderTextField("Rotation", "viewpoint-rotation", String(viewpoint.rotationDeg))}`, true)}
+    ${renderInspectorSection("viewpoint", "camera", "Camera", `${renderTextField("Azimuth", "viewpoint-camera-azimuth", viewpoint.camera?.azimuth === null || viewpoint.camera?.azimuth === void 0 ? "" : String(viewpoint.camera.azimuth))}
+      ${renderTextField("Elevation", "viewpoint-camera-elevation", viewpoint.camera?.elevation === null || viewpoint.camera?.elevation === void 0 ? "" : String(viewpoint.camera.elevation))}
+      ${renderTextField("Roll", "viewpoint-camera-roll", viewpoint.camera?.roll === null || viewpoint.camera?.roll === void 0 ? "" : String(viewpoint.camera.roll))}
+      ${renderTextField("Distance", "viewpoint-camera-distance", viewpoint.camera?.distance === null || viewpoint.camera?.distance === void 0 ? "" : String(viewpoint.camera.distance))}
+      <p class="wo-editor-inline-note">Rotation stays a 2D screen-rotation hint. The camera block stores Schema 2.5 view direction and framing.</p>`)}
     ${renderInspectorSection("viewpoint", "layers", "Layers", `<fieldset class="wo-editor-fieldset">
         <legend>Layers</legend>
         ${renderCheckboxField("Background", "layer-background", viewpoint.layers.background !== false)}
         ${renderCheckboxField("Guides", "layer-guides", viewpoint.layers.guides !== false)}
         ${renderCheckboxField("Orbits back", "layer-orbits-back", viewpoint.layers["orbits-back"] !== false)}
         ${renderCheckboxField("Orbits front", "layer-orbits-front", viewpoint.layers["orbits-front"] !== false)}
+        ${renderCheckboxField("Events", "layer-events", viewpoint.layers.events !== false)}
         ${renderCheckboxField("Objects", "layer-objects", viewpoint.layers.objects !== false)}
         ${renderCheckboxField("Labels", "layer-labels", viewpoint.layers.labels !== false)}
         ${renderCheckboxField("Metadata", "layer-metadata", viewpoint.layers.metadata !== false)}
@@ -9195,7 +10584,75 @@ var WorldOrbit = (() => {
     ${renderInspectorSection("viewpoint", "filter", "Filter", `${renderTextField("Filter query", "filter-query", viewpoint.filter?.query ?? "")}
       ${renderTextField("Filter object types", "filter-object-types", viewpoint.filter?.objectTypes.join(" ") ?? "")}
       ${renderTextField("Filter tags", "filter-tags", viewpoint.filter?.tags.join(" ") ?? "")}
-      ${renderTextField("Filter groups", "filter-groups", viewpoint.filter?.groupIds.join(" ") ?? "")}`)}
+      ${renderTextField("Filter groups", "filter-groups", viewpoint.filter?.groupIds.join(" ") ?? "")}
+      ${renderTextField("Events", "viewpoint-events", viewpoint.events.join(" "))}`)}
+  </form>`;
+  }
+  function renderEventInspector(formState, id) {
+    const eventEntry = formState.events.find((entry) => entry.id === id);
+    if (!eventEntry) {
+      return `<p class="wo-editor-empty">Event not found.</p>`;
+    }
+    const linkedViewpoints = formState.viewpoints.filter((viewpoint) => viewpoint.events.includes(eventEntry.id)).map((viewpoint) => viewpoint.id).join(" ");
+    return `<form class="wo-editor-form" data-editor-form="event">
+    <h2>Event</h2>
+    ${renderInspectorSection("event", "basics", "Basics", `${renderTextField("ID", "event-id", eventEntry.id)}
+      ${renderTextField("Kind", "event-kind", eventEntry.kind)}
+      ${renderTextField("Label", "event-label", eventEntry.label)}
+      ${renderTextAreaField("Summary", "event-summary", eventEntry.summary ?? "")}
+      ${renderTextField("Target object", "event-target", eventEntry.targetObjectId ?? "")}
+      ${renderTextField("Participants", "event-participants", eventEntry.participantObjectIds.join(" "))}
+      ${renderTextField("Timing", "event-timing", eventEntry.timing ?? "")}
+      ${renderTextField("Visibility", "event-visibility", eventEntry.visibility ?? "")}
+      ${renderTextField("Epoch", "event-epoch", eventEntry.epoch ?? "")}
+      ${renderTextField("Reference plane", "event-referencePlane", eventEntry.referencePlane ?? "")}
+      ${renderTextField("Tags", "event-tags", eventEntry.tags.join(" "))}
+      ${renderTextField("Color", "event-color", eventEntry.color ?? "")}
+      ${renderCheckboxField("Hidden", "event-hidden", eventEntry.hidden === true)}`, true)}
+    ${renderInspectorSection("event", "viewpoints", "Viewpoints", `${renderTextField("Viewpoints", "event-viewpoints", linkedViewpoints)}`)}
+    ${renderInspectorSection("event", "positions", "Positions", `${eventEntry.positions.length > 0 ? `<div class="wo-editor-inline-list">${eventEntry.positions.map((pose) => renderOutlineButton({ kind: "event-pose", id: eventEntry.id, key: pose.objectId }, pose.objectId, null, /* @__PURE__ */ new Map())).join("")}</div>` : `<p class="wo-editor-empty">No event poses yet.</p>`}
+      <div class="wo-editor-inline-actions">
+        <button type="button" data-editor-action="add-event-pose" data-editor-event-id="${escapeHtml3(eventEntry.id)}">Add pose</button>
+      </div>`)}
+  </form>`;
+  }
+  function renderEventPoseInspector(formState, eventId, objectId) {
+    const eventEntry = formState.events.find((entry) => entry.id === eventId);
+    const pose = eventEntry?.positions.find((entry) => entry.objectId === objectId);
+    if (!eventEntry || !pose) {
+      return `<p class="wo-editor-empty">Event pose not found.</p>`;
+    }
+    const placementMode = pose.placement?.mode ?? "";
+    const placementTarget = pose.placement?.mode === "orbit" || pose.placement?.mode === "surface" || pose.placement?.mode === "at" ? pose.placement.target : "";
+    const freeValue = pose.placement?.mode === "free" ? pose.placement.distance ? formatUnitValue3(pose.placement.distance) : pose.placement.descriptor ?? "" : "";
+    return `<form class="wo-editor-form" data-editor-form="event-pose">
+    <h2>Event Pose</h2>
+    <p class="wo-editor-inline-note">Event <strong>${escapeHtml3(eventEntry.label || eventEntry.id)}</strong></p>
+    ${renderInspectorSection("event-pose", "identity", "Identity", `${renderTextField("Object", "pose-object-id", pose.objectId)}
+      <div class="wo-editor-inline-actions">
+        <button type="button" data-path-kind="event" data-path-id="${escapeHtml3(eventEntry.id)}">Select event</button>
+      </div>`, true)}
+    ${renderInspectorSection("event-pose", "placement", "Placement", `${renderSelectField("Placement mode", "placement-mode", [
+      ["", "None"],
+      ["orbit", "Orbit"],
+      ["at", "At"],
+      ["surface", "Surface"],
+      ["free", "Free"]
+    ], placementMode)}
+      ${renderTextField("Placement target", "placement-target", placementTarget)}
+      ${renderTextField("Free value", "placement-free", freeValue)}
+      ${renderTextField("Distance", "placement-distance", pose.placement?.mode === "orbit" && pose.placement.distance ? formatUnitValue3(pose.placement.distance) : "")}
+      ${renderTextField("Semi-major", "placement-semiMajor", pose.placement?.mode === "orbit" && pose.placement.semiMajor ? formatUnitValue3(pose.placement.semiMajor) : "")}
+      ${renderTextField("Eccentricity", "placement-eccentricity", pose.placement?.mode === "orbit" && pose.placement.eccentricity !== void 0 ? String(pose.placement.eccentricity) : "")}
+      ${renderTextField("Period", "placement-period", pose.placement?.mode === "orbit" && pose.placement.period ? formatUnitValue3(pose.placement.period) : "")}
+      ${renderTextField("Angle", "placement-angle", pose.placement?.mode === "orbit" && pose.placement.angle ? formatUnitValue3(pose.placement.angle) : "")}
+      ${renderTextField("Inclination", "placement-inclination", pose.placement?.mode === "orbit" && pose.placement.inclination ? formatUnitValue3(pose.placement.inclination) : "")}
+      ${renderTextField("Phase", "placement-phase", pose.placement?.mode === "orbit" && pose.placement.phase ? formatUnitValue3(pose.placement.phase) : "")}
+      ${renderTextField("Inner", "prop-inner", pose.inner ? formatUnitValue3(pose.inner) : "")}
+      ${renderTextField("Outer", "prop-outer", pose.outer ? formatUnitValue3(pose.outer) : "")}`, true)}
+    ${renderInspectorSection("event-pose", "context", "Context", `${renderTextField("Epoch", "pose-epoch", pose.epoch ?? "")}
+      ${renderTextField("Reference plane", "pose-referencePlane", pose.referencePlane ?? "")}
+      <p class="wo-editor-inline-note">Falls back to event, then object, then system context when left empty.</p>`)}
   </form>`;
   }
   function renderAnnotationInspector(formState, id) {
@@ -9300,13 +10757,19 @@ var WorldOrbit = (() => {
     return form.elements.namedItem(name)?.checked ?? false;
   }
   function buildPlacementFromForm(form, current) {
+    return buildPlacementFromValues(form, current.placement, current.id);
+  }
+  function buildPlacementFromPoseForm(form, current) {
+    return buildPlacementFromValues(form, current.placement, current.objectId);
+  }
+  function buildPlacementFromValues(form, currentPlacement, fallbackTarget) {
     const mode = readTextInput(form, "placement-mode");
     const target = readOptionalTextInput(form, "placement-target");
     switch (mode) {
       case "orbit":
         return {
           mode,
-          target: target ?? (current.placement?.mode === "orbit" ? current.placement.target : current.id),
+          target: target ?? (currentPlacement?.mode === "orbit" ? currentPlacement.target : fallbackTarget),
           distance: parseOptionalUnit(readOptionalTextInput(form, "placement-distance")),
           semiMajor: parseOptionalUnit(readOptionalTextInput(form, "placement-semiMajor")),
           eccentricity: parseNullableNumber(readOptionalTextInput(form, "placement-eccentricity")) ?? void 0,
@@ -9318,13 +10781,13 @@ var WorldOrbit = (() => {
       case "at":
         return {
           mode,
-          target: target ?? current.id,
-          reference: parseAtReferenceString(target ?? current.id)
+          target: target ?? fallbackTarget,
+          reference: parseAtReferenceString(target ?? fallbackTarget)
         };
       case "surface":
         return {
           mode,
-          target: target ?? current.id
+          target: target ?? fallbackTarget
         };
       case "free": {
         const freeValue = readOptionalTextInput(form, "placement-free");
@@ -9374,6 +10837,15 @@ var WorldOrbit = (() => {
     const parsed = Number(value);
     return Number.isFinite(parsed) ? parsed : null;
   }
+  function buildViewCameraFromForm(form) {
+    const camera = {
+      azimuth: parseNullableNumber(readOptionalTextInput(form, "viewpoint-camera-azimuth")),
+      elevation: parseNullableNumber(readOptionalTextInput(form, "viewpoint-camera-elevation")),
+      roll: parseNullableNumber(readOptionalTextInput(form, "viewpoint-camera-roll")),
+      distance: parseNullableNumber(readOptionalTextInput(form, "viewpoint-camera-distance"))
+    };
+    return camera.azimuth !== null || camera.elevation !== null || camera.roll !== null || camera.distance !== null ? camera : null;
+  }
   function parseObjectTypes(value) {
     const tokens = splitTokens(value);
     return tokens.filter((token) => OBJECT_TYPES.includes(token));
@@ -9455,9 +10927,48 @@ var WorldOrbit = (() => {
         annotation.sourceObjectId = toId;
       }
     }
+    for (const eventEntry of document2.events) {
+      if (eventEntry.targetObjectId === fromId) {
+        eventEntry.targetObjectId = toId;
+      }
+      eventEntry.participantObjectIds = eventEntry.participantObjectIds.map((entry) => entry === fromId ? toId : entry);
+      for (const pose of eventEntry.positions) {
+        if (pose.objectId === fromId) {
+          pose.objectId = toId;
+        }
+        if (pose.placement?.mode === "orbit" && pose.placement.target === fromId) {
+          pose.placement.target = toId;
+        }
+        if (pose.placement?.mode === "surface" && pose.placement.target === fromId) {
+          pose.placement.target = toId;
+        }
+        if (pose.placement?.mode === "at") {
+          const reference = pose.placement.reference;
+          if (reference.kind === "anchor" && reference.objectId === fromId) {
+            reference.objectId = toId;
+          }
+          if (reference.kind === "lagrange") {
+            if (reference.primary === fromId) {
+              reference.primary = toId;
+            }
+            if (reference.secondary === fromId) {
+              reference.secondary = toId;
+            }
+          }
+          pose.placement.target = formatAtReference2(reference);
+        }
+      }
+      eventEntry.positions.sort(compareEventPoses);
+    }
   }
   function removeSelectedNode(document2, selection) {
     const next = removeAtlasDocumentNode(document2, selection);
+    if (selection.kind === "event" && selection.id) {
+      for (const viewpoint of next.system?.viewpoints ?? []) {
+        viewpoint.events = viewpoint.events.filter((eventId) => eventId !== selection.id);
+      }
+      return next;
+    }
     if (selection.kind !== "object" || !selection.id) {
       return next;
     }
@@ -9492,9 +11003,45 @@ var WorldOrbit = (() => {
         annotation.sourceObjectId = null;
       }
     }
+    for (const eventEntry of next.events) {
+      if (eventEntry.targetObjectId === selection.id) {
+        eventEntry.targetObjectId = null;
+      }
+      eventEntry.participantObjectIds = eventEntry.participantObjectIds.filter((entry) => entry !== selection.id);
+      eventEntry.positions = eventEntry.positions.filter((entry) => entry.objectId !== selection.id);
+      for (const pose of eventEntry.positions) {
+        if (pose.placement?.mode === "orbit" && pose.placement.target === selection.id) {
+          pose.placement = null;
+        }
+        if (pose.placement?.mode === "surface" && pose.placement.target === selection.id) {
+          pose.placement = null;
+        }
+        if (pose.placement?.mode === "at") {
+          const reference = pose.placement.reference;
+          const touchesSelection = reference.kind === "anchor" && reference.objectId === selection.id || reference.kind === "lagrange" && (reference.primary === selection.id || reference.secondary === selection.id);
+          if (touchesSelection) {
+            pose.placement = null;
+          }
+        }
+      }
+    }
     return next;
   }
-  function updateOrbitPhase(document2, objectId, details, pointer) {
+  function findEditablePlacementOwner(document2, path, objectId) {
+    if (path.kind === "event-pose" && path.id && path.key) {
+      const pose = findEventPose2(document2, path.id, path.key);
+      if (pose?.placement) {
+        return { placement: pose.placement };
+      }
+      return null;
+    }
+    const object = findObject2(document2, objectId);
+    if (object?.placement) {
+      return { placement: object.placement };
+    }
+    return null;
+  }
+  function updateOrbitPhase(document2, path, objectId, details, pointer) {
     const orbit = details.orbit;
     if (!orbit || details.object.placement?.mode !== "orbit") {
       return document2;
@@ -9505,17 +11052,17 @@ var WorldOrbit = (() => {
     const radians = Math.atan2((unrotated.y - orbit.cy) / Math.max(ry, 1), (unrotated.x - orbit.cx) / Math.max(rx, 1));
     const phaseDeg = normalizeDegrees(radians * 180 / Math.PI);
     const next = cloneAtlasDocument(document2);
-    const object = next.objects.find((entry) => entry.id === objectId);
-    if (!object || object.placement?.mode !== "orbit") {
+    const placementOwner = findEditablePlacementOwner(next, path, objectId);
+    if (!placementOwner || placementOwner.placement.mode !== "orbit") {
       return document2;
     }
-    object.placement.phase = {
+    placementOwner.placement.phase = {
       value: roundNumber(phaseDeg, 2),
       unit: "deg"
     };
     return next;
   }
-  function updateOrbitRadius(document2, objectId, details, pointer, dragContext) {
+  function updateOrbitRadius(document2, path, objectId, details, pointer, dragContext) {
     const orbit = details.orbit;
     if (!orbit || details.object.placement?.mode !== "orbit" || !dragContext) {
       return document2;
@@ -9525,47 +11072,47 @@ var WorldOrbit = (() => {
     const nextBaseRadius = Math.max(nextDisplayedRadius - dragContext.radiusOffsetPx, dragContext.innerPx);
     const nextMetric = orbitRadiusPxToMetric(nextBaseRadius, dragContext.innerPx, dragContext.stepPx);
     const next = cloneAtlasDocument(document2);
-    const object = next.objects.find((entry) => entry.id === objectId);
-    if (!object || object.placement?.mode !== "orbit") {
+    const placementOwner = findEditablePlacementOwner(next, path, objectId);
+    if (!placementOwner || placementOwner.placement.mode !== "orbit") {
       return document2;
     }
-    const currentValue = object.placement.semiMajor ?? object.placement.distance ?? {
+    const currentValue = placementOwner.placement.semiMajor ?? placementOwner.placement.distance ?? {
       value: 1,
       unit: "au"
     };
     const scaled = distanceMetricToUnitValue(Math.max(nextMetric, 0), dragContext.preferredUnit ?? currentValue.unit);
-    if (object.placement.semiMajor) {
-      object.placement.semiMajor = scaled;
+    if (placementOwner.placement.semiMajor) {
+      placementOwner.placement.semiMajor = scaled;
     } else {
-      object.placement.distance = scaled;
+      placementOwner.placement.distance = scaled;
     }
     return next;
   }
-  function updateAtReference(document2, objectId, scene, pointer) {
+  function updateAtReference(document2, path, objectId, scene, pointer) {
     const candidate = findNearestAtCandidate(scene, objectId, pointer);
     if (!candidate) {
       return document2;
     }
     const next = cloneAtlasDocument(document2);
-    const object = next.objects.find((entry) => entry.id === objectId);
-    if (!object || object.placement?.mode !== "at") {
+    const placementOwner = findEditablePlacementOwner(next, path, objectId);
+    if (!placementOwner || placementOwner.placement.mode !== "at") {
       return document2;
     }
-    object.placement.reference = candidate.reference;
-    object.placement.target = formatAtReference2(candidate.reference);
+    placementOwner.placement.reference = candidate.reference;
+    placementOwner.placement.target = formatAtReference2(candidate.reference);
     return next;
   }
-  function updateSurfaceTarget(document2, objectId, scene, pointer) {
+  function updateSurfaceTarget(document2, path, objectId, scene, pointer) {
     const target = findNearestSceneObject(scene, objectId, pointer, (entry) => SURFACE_TARGET_TYPES3.has(entry.object.type));
     if (!target) {
       return document2;
     }
     const next = cloneAtlasDocument(document2);
-    const object = next.objects.find((entry) => entry.id === objectId);
-    if (!object || object.placement?.mode !== "surface") {
+    const placementOwner = findEditablePlacementOwner(next, path, objectId);
+    if (!placementOwner || placementOwner.placement.mode !== "surface") {
       return document2;
     }
-    object.placement.target = target.objectId;
+    placementOwner.placement.target = target.objectId;
     return next;
   }
   function createOrbitRadiusDragContext(document2, scene, details) {
@@ -9573,7 +11120,7 @@ var WorldOrbit = (() => {
       return null;
     }
     const targetId = details.object.placement.target;
-    const siblingCount = document2.objects.filter((entry) => entry.placement?.mode === "orbit" && entry.placement.target === targetId).length;
+    const siblingCount = scene.objects.filter((entry) => entry.object.placement?.mode === "orbit" && entry.object.placement.target === targetId && !entry.hidden).length;
     const spacingFactor = layoutPresetSpacingForScene(scene.layoutPreset);
     const stepPx = (siblingCount > 2 ? 54 : 64) * spacingFactor * scene.scaleModel.orbitDistanceMultiplier;
     const innerPx = details.parent.radius + 56 * spacingFactor * scene.scaleModel.orbitDistanceMultiplier;
@@ -9588,28 +11135,28 @@ var WorldOrbit = (() => {
       preferredUnit: currentValue?.unit ?? null
     };
   }
-  function updateFreeDistance(document2, objectId, scene, details, pointer) {
+  function updateFreeDistance(document2, path, objectId, scene, details, pointer) {
     if (details.object.placement?.mode !== "free") {
       return document2;
     }
     const railX = scene.width - scene.padding - 140;
     const offsetPx = Math.max(0, railX - pointer.x);
     const next = cloneAtlasDocument(document2);
-    const object = next.objects.find((entry) => entry.id === objectId);
-    if (!object || object.placement?.mode !== "free") {
+    const placementOwner = findEditablePlacementOwner(next, path, objectId);
+    if (!placementOwner || placementOwner.placement.mode !== "free") {
       return document2;
     }
-    const preferredUnit = normalizeFreeDistanceUnit(object.placement.distance?.unit ?? null);
+    const preferredUnit = normalizeFreeDistanceUnit(placementOwner.placement.distance?.unit ?? null);
     const metric = offsetPx / Math.max(FREE_DISTANCE_PIXEL_FACTOR * scene.scaleModel.freePlacementMultiplier, 1);
     if (metric < 0.01) {
-      object.placement.distance = void 0;
-      if (!object.placement.descriptor) {
-        delete object.placement.descriptor;
+      placementOwner.placement.distance = void 0;
+      if (!placementOwner.placement.descriptor) {
+        delete placementOwner.placement.descriptor;
       }
       return next;
     }
-    object.placement.distance = distanceMetricToUnitValue(metric, preferredUnit);
-    delete object.placement.descriptor;
+    placementOwner.placement.distance = distanceMetricToUnitValue(metric, preferredUnit);
+    delete placementOwner.placement.descriptor;
     return next;
   }
   function findNearestSceneObject(scene, selectedObjectId, pointer, predicate = () => true) {
@@ -9881,9 +11428,85 @@ var WorldOrbit = (() => {
             return ["viewpoint-zoom"];
           case "rotationDeg":
             return ["viewpoint-rotation"];
+          case "camera":
+            return [
+              "viewpoint-camera-azimuth",
+              "viewpoint-camera-elevation",
+              "viewpoint-camera-roll",
+              "viewpoint-camera-distance"
+            ];
+          case "camera.azimuth":
+            return ["viewpoint-camera-azimuth"];
+          case "camera.elevation":
+            return ["viewpoint-camera-elevation"];
+          case "camera.roll":
+            return ["viewpoint-camera-roll"];
+          case "camera.distance":
+            return ["viewpoint-camera-distance"];
+          case "events":
+            return ["viewpoint-events"];
+          default:
+            return [];
+        }
+      case "event":
+        switch (field) {
+          case "id":
+            return ["event-id"];
+          case "kind":
+            return ["event-kind"];
+          case "label":
+            return ["event-label"];
+          case "summary":
+            return ["event-summary"];
+          case "targetObjectId":
+          case "target":
+            return ["event-target"];
+          case "participantObjectIds":
+          case "participants":
+            return ["event-participants"];
+          case "timing":
+            return ["event-timing"];
+          case "visibility":
+            return ["event-visibility"];
+          case "epoch":
+            return ["event-epoch"];
+          case "referencePlane":
+            return ["event-referencePlane"];
+          case "tags":
+            return ["event-tags"];
+          case "color":
+            return ["event-color"];
+          case "hidden":
+            return ["event-hidden"];
           default:
             return [];
         }
+      case "event-pose":
+        if (field === "objectId") {
+          return ["pose-object-id"];
+        }
+        if (field === "placement") {
+          return ["placement-mode"];
+        }
+        if (field === "reference" || field === "target") {
+          return ["placement-target"];
+        }
+        if (field === "descriptor") {
+          return ["placement-free"];
+        }
+        if (PLACEMENT_DIAGNOSTIC_FIELDS.has(field)) {
+          return [`placement-${field}`];
+        }
+        if (field === "inner" || field === "outer") {
+          return [`prop-${field}`];
+        }
+        if (field === "epoch") {
+          return ["pose-epoch"];
+        }
+        if (field === "referencePlane") {
+          return ["pose-referencePlane"];
+        }
+        return [];
       case "annotation":
         switch (field) {
           case "id":
@@ -9969,6 +11592,10 @@ var WorldOrbit = (() => {
         return `Metadata: ${path.key ?? ""}`;
       case "group":
         return `Group: ${path.id ?? ""}`;
+      case "event":
+        return `Event: ${path.id ?? ""}`;
+      case "event-pose":
+        return `Event Pose: ${path.id ?? ""} / ${path.key ?? ""}`;
       case "object":
         return `Object: ${path.id ?? ""}`;
       case "viewpoint":
@@ -9980,11 +11607,70 @@ var WorldOrbit = (() => {
     }
   }
   function selectionKey(path) {
-    return path ? `${path.kind}:${path.id ?? path.key ?? ""}` : null;
+    return path ? `${path.kind}:${path.id ?? ""}:${path.key ?? ""}` : null;
+  }
+  function selectionEventId(path) {
+    if (!path) {
+      return null;
+    }
+    return path.kind === "event" || path.kind === "event-pose" ? path.id ?? null : null;
   }
   function compareObjects2(left, right) {
     return left.id.localeCompare(right.id);
   }
+  function compareEvents(left, right) {
+    return left.id.localeCompare(right.id);
+  }
+  function compareEventPoses(left, right) {
+    return left.objectId.localeCompare(right.objectId);
+  }
+  function findEvent2(document2, eventId) {
+    return document2.events.find((entry) => entry.id === eventId) ?? null;
+  }
+  function findEventPose2(document2, eventId, objectId) {
+    return findEvent2(document2, eventId)?.positions.find((entry) => entry.objectId === objectId) ?? null;
+  }
+  function findObject2(document2, objectId) {
+    return document2.objects.find((entry) => entry.id === objectId) ?? null;
+  }
+  function addEventPose(document2, eventId) {
+    const next = cloneAtlasDocument(document2);
+    const eventEntry = next.events.find((entry) => entry.id === eventId);
+    if (!eventEntry) {
+      return document2;
+    }
+    const baseObject = next.objects.find((object) => !eventEntry.positions.some((pose) => pose.objectId === object.id)) ?? next.objects[0];
+    if (!baseObject) {
+      return document2;
+    }
+    if (eventEntry.targetObjectId !== baseObject.id && !eventEntry.participantObjectIds.includes(baseObject.id)) {
+      eventEntry.participantObjectIds.push(baseObject.id);
+      eventEntry.participantObjectIds.sort((left, right) => left.localeCompare(right));
+    }
+    eventEntry.positions.push(createEventPoseFromObject(baseObject));
+    eventEntry.positions.sort(compareEventPoses);
+    return next;
+  }
+  function createEventPoseFromObject(object) {
+    return {
+      objectId: object.id,
+      placement: object.placement ? structuredClone(object.placement) : null,
+      inner: readUnitValue(object.properties.inner),
+      outer: readUnitValue(object.properties.outer)
+    };
+  }
+  function syncEventViewpointReferences(document2, previousEventId, nextEventId, viewpointIds) {
+    const desired = new Set(viewpointIds);
+    for (const viewpoint of document2.system?.viewpoints ?? []) {
+      const currentIds = new Set(viewpoint.events);
+      currentIds.delete(previousEventId);
+      currentIds.delete(nextEventId);
+      if (desired.has(viewpoint.id)) {
+        currentIds.add(nextEventId);
+      }
+      viewpoint.events = [...currentIds].sort((left, right) => left.localeCompare(right));
+    }
+  }
   function createUniqueId(prefix, existing) {
     const safePrefix = prefix.trim() || "item";
     let counter = 1;
@@ -10013,6 +11699,9 @@ var WorldOrbit = (() => {
   function readUnitProperty(value) {
     return value && typeof value === "object" && "value" in value ? formatUnitValue3(value) : "";
   }
+  function readUnitValue(value) {
+    return value && typeof value === "object" && "value" in value ? value : void 0;
+  }
   function readNumberProperty(value) {
     return typeof value === "number" ? String(value) : "";
   }
@@ -10318,6 +12007,12 @@ var WorldOrbit = (() => {
     .wo-editor-overlay-diagnostic-warning { border: 1px solid rgba(240, 180, 100, 0.24); }
     .wo-editor-outline { display: grid; gap: 14px; }
     .wo-editor-outline-section { display: grid; gap: 8px; }
+    .wo-editor-outline-group { display: grid; gap: 6px; }
+    .wo-editor-outline-children {
+      display: grid;
+      gap: 6px;
+      padding-left: 16px;
+    }
     .wo-editor-outline-section h3 {
       margin: 0;
       color: rgba(237,246,255,0.68);
@@ -10357,6 +12052,27 @@ var WorldOrbit = (() => {
       background: rgba(255, 120, 120, 0.18);
       color: #ffb2b2;
     }
+    .wo-editor-inline-list { display: grid; gap: 8px; }
+    .wo-editor-inline-actions {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 10px;
+      margin-top: 12px;
+    }
+    .wo-editor-inline-actions button {
+      border: 1px solid rgba(255,255,255,0.14);
+      border-radius: 999px;
+      background: rgba(255,255,255,0.06);
+      color: #edf6ff;
+      cursor: pointer;
+      font: 600 12px/1.2 "Segoe UI Variable", "Segoe UI", sans-serif;
+      padding: 8px 12px;
+    }
+    .wo-editor-inline-note {
+      margin: 0 0 12px;
+      color: rgba(237,246,255,0.72);
+      font: 500 12px/1.5 "Segoe UI Variable", "Segoe UI", sans-serif;
+    }
     .wo-editor-diagnostics { display: grid; gap: 10px; }
     .wo-editor-diagnostic {
       display: grid;