@found-in-space/skykit 0.2.0-alpha.20260529 → 0.2.0-alpha.20260530

package/README.md

@@ -69,7 +69,7 @@ Optional attributes keep small tweaks HTML-only:
   data-skykit-magnitude="7"
   data-skykit-speed="4"
   data-skykit-exposure="2600"
-  data-skykit-look-at="ra=4.496h, dec=16.948"
+  data-skykit-look-at="05h 36m 12.81s, −01° 12′ 06.9″"
   data-skykit-mouse-mode="strafe"
   data-skykit-persistent-cache="off"
   style="width: 100%; height: 520px; background: #02040b"
@@ -77,11 +77,12 @@ Optional attributes keep small tweaks HTML-only:
 ```
 
 `data-skykit-look-at` accepts RA/Dec text such as
-`ra=4.496h, dec=16.948`, decimal degrees such as `67.447,16.948`, or a
-parsec-space `x,y,z` target for exact generated coordinates. `data-skykit-mouse-mode`
-defaults to `grab`; use `look` or `strafe` for the first-person mouse-look
-direction, or `none` to disable mouse drag controls. Persistent browser Cache API
-storage is enabled by default for octree ranges; set
+`05h 36m 12.81s, −01° 12′ 06.9″`, decimal degrees such as
+`84.053393,-1.201926`, or a parsec-space `x,y,z` target for exact generated
+coordinates. `data-skykit-mouse-mode` defaults to `grab`; use `look` or
+`strafe` for the first-person mouse-look direction, or `none` to disable mouse
+drag controls. Persistent browser Cache API storage is enabled by default for
+octree ranges; set
 `data-skykit-persistent-cache="off"` to keep caching session-only.
 
 The host dispatches `skykit-browser-ready` with `{ browser, viewer }` in
@@ -120,15 +121,17 @@ For small scripted interactions, use the browser handle:
 <script type="module">
   import {
     SKYKIT_ACTIONS,
+    createRaDecLookAt,
     createSkykitNavigationPlugin,
   } from 'https://esm.sh/@found-in-space/skykit';
 
   const browser = await Skykit.whenReady();
   await browser.install(createSkykitNavigationPlugin());
+  const alnilam = createRaDecLookAt('05h 36m 12.81s', '−01° 12′ 06.9″');
 
   document.querySelector('#orion').addEventListener('click', () => {
     browser.viewer.actions.invoke(SKYKIT_ACTIONS.navigation.transitionTo, {
-      view: { lookAt: 'ra=5.919h, dec=7.407' },
+      view: { lookAt: alnilam },
       movement: { durationSecs: 3 },
     });
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@found-in-space/skykit",
-  "version": "0.2.0-alpha.20260529",
+  "version": "0.2.0-alpha.20260530",
   "description": "Slim composition and teaching layer for Found in Space packages",
   "license": "MIT",
   "type": "module",
@@ -72,7 +72,7 @@
     "@found-in-space/anchored-image": "0.2.0-alpha.0",
     "@found-in-space/hr-diagram": "0.2.0-alpha.1",
     "@found-in-space/meta-sidecar-provider": "0.2.0-alpha.1",
-    "@found-in-space/spatial": "0.2.0-alpha.20260528",
+    "@found-in-space/spatial": "0.2.0-alpha.20260529",
     "@found-in-space/star-octree-provider": "0.2.0-alpha.1",
     "@found-in-space/star-trees": "0.2.0-alpha.0",
     "@found-in-space/three-star-field": "0.2.0-alpha.0"

package/src/__tests__/skykit.test.js

@@ -17,6 +17,7 @@ import {
   createDesktopSkykitObserverRig,
   createObject3dLayer,
   createObject3dPlugin,
+  createRaDecLookAt,
   createMouseLookPlugin,
   createSkyGrabPlugin,
   createSkykitDefaultKeyboardNavigationBindings,
@@ -313,6 +314,19 @@ test('viewer derives camera orientation from lookAt targets, sky coordinates, an
   assertVectorApprox(localVectorFromView(view, { x: 0, y: 1, z: 0 }), { x: 0, y: 1, z: 0 });
   await skyViewer.dispose();
 
+  const alnilamViewer = await createSkykitViewer({
+    renderer: createRenderer(),
+    view: {
+      lookAt: createRaDecLookAt('05h 36m 12.81s', '−01° 12′ 06.9″'),
+    },
+  });
+  view = alnilamViewer.getViewState();
+  assertVectorApprox(
+    localVectorFromView(view, { x: 0, y: 0, z: -1 }),
+    directionFromRaDec(84.053375, -1.2019166666666667),
+  );
+  await alnilamViewer.dispose();
+
   const starViewer = await createSkykitViewer({
     renderer: createRenderer(),
     view: { lookAt: { star: 'hyades' } },
@@ -1539,6 +1553,17 @@ test('navigation transition action restores pose with independent lane durations
   assert.deepEqual(viewer.getViewState().observerPc, { x: 0, y: 0, z: 0 });
   assert.deepEqual(viewer.getViewState().orientationIcrs, orientationAfterExplicitTransition);
 
+  await viewer.actions.invoke(SKYKIT_ACTIONS.navigation.transitionTo, {
+    lookAt: '05:36:12.81, −01:12:06.9',
+    orientation: { durationSecs: 1 },
+  });
+  viewer.update(1);
+  viewer.update(0);
+  assertVectorApprox(
+    localVectorFromView(viewer.getViewState(), { x: 0, y: 0, z: -1 }),
+    directionFromRaDec(84.053375, -1.2019166666666667),
+  );
+
   await viewer.dispose();
 });
 
@@ -1959,6 +1984,17 @@ function assertVectorApprox(actual, expected, epsilon = 1e-9) {
   assert.ok(Math.abs(actual.z - expected.z) < epsilon, `z ${actual.z} !== ${expected.z}`);
 }
 
+function directionFromRaDec(raDeg, decDeg) {
+  const ra = raDeg * Math.PI / 180;
+  const dec = decDeg * Math.PI / 180;
+  const cosDec = Math.cos(dec);
+  return {
+    x: Math.cos(ra) * cosDec,
+    y: Math.sin(ra) * cosDec,
+    z: Math.sin(dec),
+  };
+}
+
 function createPointerTarget() {
   const target = createEventTarget();
   target.clientWidth = 800;

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';
@@ -181,8 +187,12 @@ export async function createSkykitBrowser(input = {}) {
       skykit: {
         SKYKIT_ACTIONS,
         SKYKIT_CONTROLS,
+        createRaDecLookAt,
         createObject3dPlugin,
         createSkykitNavigationPlugin,
+        parseDeclination,
+        parseRightAscension,
+        parseSpatialLookAtText,
       },
     };
   }

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

@@ -56,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;
@@ -68,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;

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';

package/src/utils.js

@@ -211,6 +211,7 @@ function resolveViewLook(input, observerPc, options = {}) {
  * @returns {import('./index.d.ts').SkykitLookAtInput | null}
  */
 function cloneLookAt(lookAt) {
+  if (typeof lookAt === 'string') return lookAt;
   if (!lookAt || typeof lookAt !== 'object') return null;
   const source = /** @type {Record<string, unknown>} */ (lookAt);
   return {