worldorbit 2.5.16 → 2.6.0

package/packages/core/dist/types.d.ts

@@ -2,10 +2,11 @@ export type WorldOrbitObjectType = "system" | "star" | "planet" | "moon" | "belt
 export type PlacementMode = "orbit" | "at" | "surface" | "free";
 export type Unit = "au" | "km" | "m" | "ly" | "pc" | "kpc" | "re" | "rj" | "sol" | "me" | "mj" | "s" | "min" | "h" | "d" | "y" | "ky" | "my" | "gy" | "K" | "deg";
 export type WorldOrbitDocumentVersion = "1.0";
-export type WorldOrbitAtlasDocumentVersion = "2.0" | "2.1";
+export type WorldOrbitAtlasDocumentVersion = "2.0" | "2.1" | "2.5";
 export type WorldOrbitDraftDocumentVersion = "2.0-draft";
 export type WorldOrbitAnyDocumentVersion = WorldOrbitDocumentVersion | WorldOrbitAtlasDocumentVersion | WorldOrbitDraftDocumentVersion;
-export type ViewProjection = "topdown" | "isometric";
+export type ViewProjection = "topdown" | "isometric" | "orthographic" | "perspective";
+export type RenderProjectionFallback = "topdown" | "isometric";
 export type RenderPresetName = "diagram" | "presentation" | "atlas-card" | "markdown";
 export interface CoordinatePoint {
     x: number;
@@ -60,6 +61,7 @@ export interface WorldOrbitDocument {
     system: WorldOrbitSystem | null;
     groups: WorldOrbitGroup[];
     relations: WorldOrbitRelation[];
+    events: WorldOrbitEvent[];
     objects: WorldOrbitObject[];
 }
 export interface WorldOrbitAtlasDocument {
@@ -70,6 +72,7 @@ export interface WorldOrbitAtlasDocument {
     system: WorldOrbitAtlasSystem | null;
     groups: WorldOrbitGroup[];
     relations: WorldOrbitRelation[];
+    events: WorldOrbitEvent[];
     objects: WorldOrbitObject[];
     diagnostics: WorldOrbitDiagnostic[];
 }
@@ -81,6 +84,7 @@ export interface WorldOrbitDraftDocument {
     system: WorldOrbitAtlasSystem | null;
     groups: WorldOrbitGroup[];
     relations: WorldOrbitRelation[];
+    events: WorldOrbitEvent[];
     objects: WorldOrbitObject[];
     diagnostics: WorldOrbitDiagnostic[];
 }
@@ -132,6 +136,30 @@ export interface WorldOrbitRelation {
     color: string | null;
     hidden: boolean;
 }
+export interface WorldOrbitEvent {
+    id: string;
+    kind: string;
+    label: string;
+    summary: string | null;
+    targetObjectId: string | null;
+    participantObjectIds: string[];
+    timing: string | null;
+    visibility: string | null;
+    epoch?: string | null;
+    referencePlane?: string | null;
+    tags: string[];
+    color: string | null;
+    hidden: boolean;
+    positions: WorldOrbitEventPose[];
+}
+export interface WorldOrbitEventPose {
+    objectId: string;
+    placement: Placement | null;
+    inner?: UnitValue;
+    outer?: UnitValue;
+    epoch?: string | null;
+    referencePlane?: string | null;
+}
 export interface WorldOrbitResonance {
     targetObjectId: string;
     ratio: string;
@@ -152,6 +180,12 @@ export interface WorldOrbitToleranceRule {
     field: string;
     value: NormalizedValue;
 }
+export interface WorldOrbitViewCamera {
+    azimuth: number | null;
+    elevation: number | null;
+    roll: number | null;
+    distance: number | null;
+}
 export type NormalizedValue = string | number | boolean | string[] | UnitValue;
 export type Placement = OrbitPlacement | AtPlacement | SurfacePlacement | FreePlacement;
 export interface OrbitPlacement {
@@ -211,7 +245,9 @@ export interface SceneRenderOptions {
     padding?: number;
     preset?: RenderPresetName;
     projection?: "document" | ViewProjection;
+    camera?: WorldOrbitViewCamera | null;
     scaleModel?: Partial<RenderScaleModel>;
+    activeEventId?: string | null;
 }
 export interface RenderBounds {
     minX: number;
@@ -294,7 +330,18 @@ export interface RenderSceneLabel {
     direction: "above" | "below" | "left" | "right";
     hidden: boolean;
 }
-export type SceneLayerId = "background" | "guides" | "orbits-back" | "orbits-front" | "relations" | "objects" | "labels" | "metadata";
+export interface RenderSceneEvent {
+    renderId: string;
+    eventId: string;
+    event: WorldOrbitEvent;
+    objectIds: string[];
+    participantIds: string[];
+    targetObjectId: string | null;
+    x: number;
+    y: number;
+    hidden: boolean;
+}
+export type SceneLayerId = "background" | "guides" | "orbits-back" | "orbits-front" | "relations" | "events" | "objects" | "labels" | "metadata";
 export interface RenderSceneViewpointFilter {
     query: string | null;
     objectTypes: Array<Exclude<WorldOrbitObjectType, "system">>;
@@ -307,9 +354,12 @@ export interface RenderSceneViewpoint {
     summary: string;
     objectId: string | null;
     selectedObjectId: string | null;
+    eventIds: string[];
     projection: ViewProjection;
+    renderProjection: RenderProjectionFallback;
     preset: RenderPresetName | null;
     rotationDeg: number;
+    camera: WorldOrbitViewCamera | null;
     scale: number | null;
     layers: Partial<Record<SceneLayerId, boolean>>;
     filter: RenderSceneViewpointFilter | null;
@@ -356,6 +406,8 @@ export interface RenderScene {
     padding: number;
     renderPreset: RenderPresetName | null;
     projection: ViewProjection;
+    renderProjection: RenderProjectionFallback;
+    camera: WorldOrbitViewCamera | null;
     scaleModel: RenderScaleModel;
     title: string;
     subtitle: string;
@@ -368,6 +420,8 @@ export interface RenderScene {
     groups: RenderSceneGroup[];
     semanticGroups: RenderSceneSemanticGroup[];
     viewpoints: RenderSceneViewpoint[];
+    events: RenderSceneEvent[];
+    activeEventId: string | null;
     objects: RenderSceneObject[];
     orbitVisuals: RenderOrbitVisual[];
     relations: RenderSceneRelation[];
@@ -421,10 +475,12 @@ export interface WorldOrbitAtlasViewpoint {
     summary: string;
     focusObjectId: string | null;
     selectedObjectId: string | null;
+    events: string[];
     projection: ViewProjection;
     preset: RenderPresetName | null;
     zoom: number | null;
     rotationDeg: number;
+    camera: WorldOrbitViewCamera | null;
     layers: Partial<Record<SceneLayerId, boolean>>;
     filter: RenderSceneViewpointFilter | null;
 }
@@ -448,7 +504,7 @@ export interface WorldOrbitAtlasSystem {
     viewpoints: WorldOrbitAtlasViewpoint[];
     annotations: WorldOrbitAtlasAnnotation[];
 }
-export type AtlasDocumentPathKind = "system" | "defaults" | "metadata" | "group" | "object" | "viewpoint" | "annotation" | "relation";
+export type AtlasDocumentPathKind = "system" | "defaults" | "metadata" | "group" | "event" | "event-pose" | "object" | "viewpoint" | "annotation" | "relation";
 export interface AtlasDocumentPath {
     kind: AtlasDocumentPathKind;
     id?: string;