@found-in-space/skykit 0.2.0-alpha.1 → 0.2.0-alpha.20260528

package/src/xr.d.ts

@@ -14,6 +14,7 @@ import type {
   SkykitEvent,
   SkykitPlugin,
   SkykitStarCellSource,
+  SkykitThreeFrame,
   SkykitViewState,
 } from './index.js';
 
@@ -105,6 +106,22 @@ export interface SkykitXrBodyTracker {
   dispose(): void;
 }
 
+export interface SkykitXrBodyPluginOptions {
+  id?: string;
+  priority?: number;
+  rig?: SkykitXrRig;
+  tracker?: SkykitXrBodyTracker;
+  hideUntrackedHands?: boolean;
+  disposeTracker?: boolean;
+  onBody?: (body: SkykitXrBodyModel, frame: SkykitThreeFrame) => void;
+}
+
+export interface SkykitXrBodyPlugin extends SkykitPlugin {
+  readonly id: string;
+  getBody(): SkykitXrBodyModel;
+  getSnapshot(): unknown;
+}
+
 export interface SkykitXrAxisBinding {
   hand?: 'left' | 'right' | 'any';
   stick?: 'primary' | 'secondary';
@@ -326,6 +343,7 @@ export interface EnterSkykitXrSessionOptions {
   referenceSpaceType?: string;
   sessionInit?: unknown;
   navigator?: unknown;
+  requestReferenceSpace?: boolean;
   onSessionStarted?: (handle: SkykitXrSessionHandle) => void;
 }
 
@@ -389,6 +407,26 @@ export interface SkykitXrNavigationPlugin extends SkykitPlugin {
   getSnapshot(): unknown;
 }
 
+export interface SkykitXrRayVisualPluginOptions {
+  id?: string;
+  priority?: number;
+  raySource: SkykitXrRaySource;
+  rig?: SkykitXrRig;
+  blockers?: Iterable<SkykitXrPickBlocker>;
+  parent?: THREE.Object3D | ((context: import('./index.js').SkykitThreePluginContext) => THREE.Object3D | null | undefined);
+  material?: THREE.Material;
+  color?: THREE.ColorRepresentation;
+  opacity?: number;
+  depthTest?: boolean;
+  renderOrder?: number;
+  length?: number;
+}
+
+export interface SkykitXrRayVisualPlugin extends SkykitPlugin {
+  readonly id: string;
+  getSnapshot(): unknown;
+}
+
 export interface SkykitXrStarPickEvent extends SkykitEvent {
   type: 'stars/xr-pick';
   id: string;
@@ -424,6 +462,7 @@ export interface SkykitXrStarPickingPluginOptions {
 
 export declare function createSkykitXrRig(options?: CreateSkykitXrRigOptions): SkykitXrRig;
 export declare function createSkykitXrBodyTracker(options?: CreateSkykitXrBodyTrackerOptions): SkykitXrBodyTracker;
+export declare function createSkykitXrBodyPlugin(options?: SkykitXrBodyPluginOptions): SkykitXrBodyPlugin;
 export declare function createSkykitXrControlBindings(options?: SkykitXrControlBindingsOptions): SkykitXrControlBindingsHandle;
 export declare function readSkykitXrAxis(inputSources: Iterable<any>, binding?: SkykitXrAxisBinding & { deadzone?: number }): SkykitXrAxisState;
 export declare function readSkykitXrButton(inputSources: Iterable<any>, binding?: SkykitXrButtonBinding, previous?: SkykitXrButtonState | null): SkykitXrButtonState;
@@ -432,6 +471,7 @@ export declare function createSkykitXrPickRouter(options?: SkykitXrPickRouterOpt
 export declare function createSkykitXrObserverRig(options: CreateSkykitXrObserverRigOptions): import('./index.js').SkykitObserverRig;
 export declare function createSkykitXrSessionPlugin(options?: SkykitXrSessionPluginOptions): SkykitXrSessionPlugin;
 export declare function createSkykitXrNavigationPlugin(options?: SkykitXrNavigationPluginOptions): SkykitXrNavigationPlugin;
+export declare function createSkykitXrRayVisualPlugin(options: SkykitXrRayVisualPluginOptions): SkykitXrRayVisualPlugin;
 export declare function createSkykitXrStarPickingPlugin(options: SkykitXrStarPickingPluginOptions): SkykitPlugin & {
   getSnapshot(): unknown;
 };

package/src/xr.js

@@ -14,8 +14,10 @@ export {
 export { createSkykitXrRaySource } from './xr/rays.js';
 export { createSkykitXrPickRouter } from './xr/pick-router.js';
 export {
+  createSkykitXrBodyPlugin,
   createSkykitXrNavigationPlugin,
   createSkykitXrObserverRig,
+  createSkykitXrRayVisualPlugin,
   createSkykitXrSessionPlugin,
   createSkykitXrStarPickingPlugin,
 } from './xr/plugins.js';