@found-in-space/skykit 0.2.0-dev.20260527.0 → 0.2.0

package/src/browser.d.ts

@@ -32,6 +32,7 @@ export type SkykitBrowserHost = string | {
 export type SkykitBrowserStatusTarget = string | { textContent?: string | null };
 export type SkykitBrowserMouseMode = 'grab' | 'look' | 'strafe' | 'none';
 export type SkykitConstellationArtMode = 'off' | 'lazy' | 'preload';
+export type SkykitPersistentCacheMode = 'on' | 'off';
 
 export interface SkykitBrowserAddonContext {
   id?: string;
@@ -58,24 +59,6 @@ export interface SkykitBrowserGlobal {
   getBrowsers(): SkykitBrowser[];
 }
 
-export interface SkykitBrowserJourneyFacade {
-  transitionTo(viewOrScene: unknown, options?: Record<string, unknown>): Promise<PromiseSettledResult<unknown>[]>;
-  applyScene(sceneSpec: unknown): Promise<unknown>;
-  load(input: string | Record<string, unknown>, options?: Record<string, unknown>): Promise<SkykitBrowserJourneyInstance>;
-  getSnapshot(): unknown | Promise<unknown>;
-}
-
-export interface SkykitBrowserJourneyInstance {
-  goTo(sceneId: string): Promise<unknown>;
-  next(): Promise<unknown>;
-  previous(): Promise<unknown>;
-  play(payload?: unknown): number;
-  pause(): number;
-  seek(timeSecs: number): number;
-  getSnapshot(): unknown;
-  dispose(): void;
-}
-
 export interface SkykitBrowserConstellationsOptions {
   skyculture?: string;
   manifest?: Record<string, unknown>;
@@ -111,6 +94,7 @@ export interface SkykitBrowserOptions {
   provider?: StarOctreeProviderService;
   starField?: ThreeStarField;
   octreeUrl?: string;
+  persistentCache?: SkykitPersistentCacheMode | string;
   strategy?: StarCellStrategy;
   session?: StarOctreeSessionOptions;
   keyboard?: false | SkykitKeyboardNavigationOptions;
@@ -144,7 +128,6 @@ export interface SkykitBrowser {
   starField: ThreeStarField;
   loop: SkykitAnimationLoop;
   capabilities: Set<string>;
-  journey: SkykitBrowserJourneyFacade;
   constellations: SkykitBrowserConstellationsFacade;
   install(input: SkykitBrowserInstallInput): Promise<SkykitPluginTeardown>;
   addObject(

package/src/browser.js

@@ -6,6 +6,12 @@ import {
 } from '@found-in-space/star-octree-provider';
 import { createObserverShellStrategy } from '@found-in-space/star-trees';
 import { createThreeStarField } from '@found-in-space/three-star-field';
+import {
+  createRaDecLookAt,
+  parseDeclination,
+  parseRightAscension,
+  parseSpatialLookAtText,
+} from '@found-in-space/spatial';
 
 import { createSkykitAnimationLoop } from './animation-loop.js';
 import { SKYKIT_ACTIONS, SKYKIT_CONTROLS } from './actions.js';
@@ -13,7 +19,6 @@ import {
   createKeyboardNavigationPlugin,
   createObject3dPlugin,
   createMouseLookPlugin,
-  createSkykitJourneyPlugin,
   createSkykitNavigationPlugin,
   createSkyGrabPlugin,
   createSkykitStatusPlugin,
@@ -52,6 +57,7 @@ export async function createSkykitBrowser(input = {}) {
   );
   const provider = options.provider ?? createStarOctreeProviderService({
     url: options.octreeUrl ?? OCTREE_DEFAULT,
+    persistentCache: normalizePersistentCacheMode(options.persistentCache),
   });
   const starField = options.starField ?? createThreeStarField({
     limitingMagnitude,
@@ -113,7 +119,6 @@ export async function createSkykitBrowser(input = {}) {
     resize,
     dispose,
   };
-  browser.journey = createLazyJourneyFacade(browser);
   browser.constellations = createLazyConstellationsFacade(browser, host);
 
   function resize() {
@@ -182,9 +187,12 @@ export async function createSkykitBrowser(input = {}) {
       skykit: {
         SKYKIT_ACTIONS,
         SKYKIT_CONTROLS,
+        createRaDecLookAt,
         createObject3dPlugin,
-        createSkykitJourneyPlugin,
         createSkykitNavigationPlugin,
+        parseDeclination,
+        parseRightAscension,
+        parseSpatialLookAtText,
       },
     };
   }
@@ -226,34 +234,6 @@ function isBrowserAddon(input) {
   return Boolean(input && typeof input === 'object' && typeof /** @type {{ install?: unknown }} */ (input).install === 'function');
 }
 
-/**
- * @param {import('./browser.d.ts').SkykitBrowser} browser
- * @returns {import('./browser.d.ts').SkykitBrowserJourneyFacade}
- */
-function createLazyJourneyFacade(browser) {
-  /** @type {Promise<import('./browser.d.ts').SkykitBrowserJourneyFacade> | null} */
-  let loaded = null;
-  const loadCapability = () => {
-    loaded ??= import('./browser-journey.js')
-      .then((module) => module.installSkykitJourneyBrowserCapability({ browser }));
-    return loaded;
-  };
-  return {
-    async transitionTo(viewOrScene, options) {
-      return (await loadCapability()).transitionTo(viewOrScene, options);
-    },
-    async applyScene(sceneSpec) {
-      return (await loadCapability()).applyScene(sceneSpec);
-    },
-    async load(input, options) {
-      return (await loadCapability()).load(input, options);
-    },
-    async getSnapshot() {
-      return (await loadCapability()).getSnapshot();
-    },
-  };
-}
-
 /**
  * @param {import('./browser.d.ts').SkykitBrowser} browser
  * @param {Element | import('./browser.d.ts').SkykitBrowserHost} host
@@ -317,6 +297,13 @@ function normalizeMouseMode(value) {
   return 'grab';
 }
 
+function normalizePersistentCacheMode(value) {
+  const mode = String(value ?? 'on').trim().toLowerCase();
+  return mode === 'off' || mode === 'false' || mode === 'no' || mode === '0' || mode === 'disabled'
+    ? 'off'
+    : 'on';
+}
+
 function createStatusPlugin(target) {
   return createSkykitStatusPlugin({
     intervalSeconds: 0.5,

package/src/embed.js

@@ -1,4 +1,7 @@
-import { parseSpatialLookAtText } from '@found-in-space/spatial';
+import {
+  parseSpatialLookAtText,
+  resolveSpatialTarget,
+} from '@found-in-space/spatial';
 
 import {
   installSkykitBrowserGlobal,
@@ -59,7 +62,14 @@ async function installRequestedCapabilities(host, browser) {
 /** @param {Element} host */
 function readOptions(host) {
   const data = isHtmlElement(host) ? host.dataset : {};
+  const observerPc = data.skykitObserver ? parseSpatialTargetText(data.skykitObserver) : null;
   const lookAt = data.skykitLookAt ? parseSpatialLookAtText(data.skykitLookAt) : null;
+  const view = observerPc || lookAt
+    ? {
+      ...(observerPc ? { observerPc } : {}),
+      ...(lookAt ? { lookAt } : {}),
+    }
+    : null;
   return {
     host,
     ...(data.skykitStatus ? { status: data.skykitStatus } : {}),
@@ -67,10 +77,20 @@ function readOptions(host) {
     ...(data.skykitSpeed ? { speedPcPerSec: Number(data.skykitSpeed) } : {}),
     ...(data.skykitExposure ? { exposure: Number(data.skykitExposure) } : {}),
     ...(data.skykitMouseMode ? { mouseMode: data.skykitMouseMode } : {}),
-    ...(lookAt ? { view: { lookAt } } : {}),
+    ...(data.skykitPersistentCache ? { persistentCache: data.skykitPersistentCache } : {}),
+    ...(view ? { view } : {}),
   };
 }
 
+/** @param {string} text */
+function parseSpatialTargetText(text) {
+  const targetSpec = parseSpatialLookAtText(text);
+  const target = resolveSpatialTarget(targetSpec);
+  return target && typeof /** @type {Promise<unknown>} */ (target).then !== 'function'
+    ? target
+    : null;
+}
+
 /**
  * @param {Element} host
  * @param {import('./browser.d.ts').SkykitBrowser} browser

package/src/hr-diagram.js

@@ -393,7 +393,9 @@ function cloneViewState(view) {
     ...view,
     observerPc: clonePoint(view.observerPc),
     renderObserverPosition: clonePoint(view.renderObserverPosition),
-    ...(view.lookAt ? { lookAt: { ...view.lookAt } } : {}),
+    ...(view.lookAt
+      ? { lookAt: typeof view.lookAt === 'object' ? { ...view.lookAt } : view.lookAt }
+      : {}),
     ...(view.targetPc ? { targetPc: clonePoint(view.targetPc) } : {}),
     ...(view.motion
       ? {

package/src/index.d.ts

@@ -11,17 +11,6 @@ import type {
   SpatialTargetInput,
   SpatialVector3,
 } from '@found-in-space/spatial';
-import type {
-  CreateTimedJourneyEvaluatorOptions,
-  JourneyController,
-  JourneyDefinition,
-  JourneyGraph,
-  JourneySceneSpec,
-  TimedJourney,
-  TimedJourneyCue,
-  TimedJourneyEvaluator,
-  TimedJourneyFrame,
-} from '@found-in-space/journey';
 import type {
   StarCellDelta,
   StarCellStore,
@@ -67,7 +56,9 @@ export interface QuaternionLike {
   w: number;
 }
 
-export interface SkykitLookAtInput {
+export type SkykitLookAtInput = string | SkykitLookAtSpecInput;
+
+export interface SkykitLookAtSpecInput {
   targetPc?: Vector3Like | [number, number, number];
   raDeg?: number;
   raHours?: number;
@@ -79,6 +70,13 @@ export interface SkykitLookAtInput {
   [key: string]: unknown;
 }
 
+export {
+  createRaDecLookAt,
+  parseDeclination,
+  parseRightAscension,
+  parseSpatialLookAtText,
+} from '@found-in-space/spatial';
+
 export interface SkykitObserverMotion {
   velocityPcPerSec: Vector3Like;
   speedPcPerSec: number;
@@ -908,63 +906,6 @@ export interface SkykitNavigationPluginOptions extends SpatialNavigationAutomati
   ) => SpatialTargetInput | Promise<SpatialTargetInput | null> | null;
 }
 
-export interface SkykitJourneyPluginOptions {
-  id?: string;
-  priority?: number;
-  journey?: JourneyDefinition;
-  controller?: JourneyController | null;
-  graph?: JourneyGraph;
-  scenes?: Record<string, JourneySceneSpec>;
-  transitions?: Iterable<Record<string, unknown>>;
-  initialSceneId?: string | null;
-  timedJourney?: TimedJourney | Record<string, unknown>;
-  evaluator?: TimedJourneyEvaluator | null;
-  evaluatorOptions?: CreateTimedJourneyEvaluatorOptions;
-  autoPlay?: boolean;
-  loop?: boolean;
-  startTimeSecs?: number;
-  disposeController?: boolean;
-  applyFrame?: (
-    frame: TimedJourneyFrame,
-    context: SkykitThreePluginContext | null,
-    skykitFrame: { viewer: SkykitViewer; view: SkykitViewState }
-  ) => boolean | void;
-  onScene?: (
-    scene: JourneySceneSpec | Record<string, unknown> | null,
-    context: SkykitThreePluginContext,
-    event: unknown
-  ) => void;
-  onSceneArrive?: (
-    scene: JourneySceneSpec | Record<string, unknown>,
-    context: SkykitThreePluginContext,
-    event: unknown
-  ) => void | Promise<void>;
-  onCue?: (
-    cue: TimedJourneyCue,
-    frame: TimedJourneyFrame,
-    context: SkykitThreePluginContext | null
-  ) => void;
-  onPreloadHints?: (
-    hints: SpatialPreloadHint[],
-    source: TimedJourneyFrame | JourneySceneSpec | Record<string, unknown>,
-    context: SkykitThreePluginContext | null
-  ) => void;
-  onLayerState?: (
-    scene: JourneySceneSpec | Record<string, unknown>,
-    context: SkykitThreePluginContext
-  ) => void;
-}
-
-export interface SkykitJourneyPlugin extends SkykitPlugin {
-  goTo(payload: unknown): Promise<JourneySceneSpec | null>;
-  next(): Promise<JourneySceneSpec | null>;
-  previous(): Promise<JourneySceneSpec | null>;
-  seek(payload: unknown): number;
-  play(payload?: unknown): number;
-  pause(): number;
-  getSnapshot(): unknown;
-}
-
 export interface SkykitSpatialPreloadStrategyOptions {
   combine?: boolean;
   baseStrategy?: StarCellStrategy;
@@ -1134,14 +1075,6 @@ export declare const SKYKIT_ACTIONS: {
     readonly flyToSelected: 'skykit:selection.flyToSelected';
     readonly openExternal: 'skykit:selection.openExternal';
   };
-  readonly journey: {
-    readonly goToChapter: 'skykit:journey.goToChapter';
-    readonly next: 'skykit:journey.next';
-    readonly previous: 'skykit:journey.previous';
-    readonly seek: 'skykit:journey.seek';
-    readonly play: 'skykit:journey.play';
-    readonly pause: 'skykit:journey.pause';
-  };
   readonly xr: {
     readonly enter: 'skykit:xr.enter';
     readonly exit: 'skykit:xr.exit';
@@ -1197,7 +1130,6 @@ export declare function createKeyboardNavigationPlugin(options?: SkykitKeyboardN
 export declare function createSkykitNavigationPlugin(options?: SkykitNavigationPluginOptions): SkykitPlugin & {
   getSnapshot(): unknown;
 };
-export declare function createSkykitJourneyPlugin(options?: SkykitJourneyPluginOptions): SkykitJourneyPlugin;
 export declare function createSkykitStarPreloadRequestsFromSpatialHints(
   hints: Iterable<SpatialPreloadHint>,
   options?: SkykitSpatialPreloadStrategyOptions

package/src/index.js

@@ -12,6 +12,12 @@ export {
 } from './actions.js';
 export { createSkykitAnimationLoop } from './animation-loop.js';
 export { createSkykitDebugBridge, installSkykitDebugGlobal } from './debug.js';
+export {
+  createRaDecLookAt,
+  parseDeclination,
+  parseRightAscension,
+  parseSpatialLookAtText,
+} from '@found-in-space/spatial';
 export { createSkykitHrDiagramPlugin } from './hr-diagram.js';
 export { createObject3dLayer } from './layers.js';
 export { createDesktopSkykitObserverRig } from './observer-rig.js';
@@ -21,7 +27,6 @@ export {
   createKeyboardNavigationPlugin,
   createMouseLookPlugin,
   createObject3dPlugin,
-  createSkykitJourneyPlugin,
   createSkykitNavigationPlugin,
   createSkykitStarPreloadRequestsFromSpatialHints,
   createSkykitStarStrategiesFromSpatialHints,