@iwsdk/core 0.1.0

package/dist/environment/ibl-gradient.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Types } from '../ecs/index.js';
+/**
+ * Image-based lighting from a procedural gradient (PMREM of a gradient scene).
+ *
+ * @remarks
+ * - Only affects `scene.environment`.
+ *
+ * @category Environment & Lighting
+ */
+export declare const IBLGradient: import("elics").Component<{
+    sky: {
+        type: Types.Color;
+        default: [number, number, number, number];
+    };
+    equator: {
+        type: Types.Color;
+        default: [number, number, number, number];
+    };
+    ground: {
+        type: Types.Color;
+        default: [number, number, number, number];
+    };
+    intensity: {
+        type: Types.Float32;
+        default: number;
+    };
+    _needsUpdate: {
+        type: Types.Boolean;
+        default: true;
+    };
+}>;
+//# sourceMappingURL=ibl-gradient.d.ts.map

package/dist/environment/ibl-gradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-gradient.d.ts","sourceRoot":"","sources":["../../src/environment/ibl-gradient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAC"}

package/dist/environment/ibl-gradient.js

@@ -0,0 +1,29 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Image-based lighting from a procedural gradient (PMREM of a gradient scene).
+ *
+ * @remarks
+ * - Only affects `scene.environment`.
+ *
+ * @category Environment & Lighting
+ */
+const IBLGradient = createComponent('IBLGradient', {
+    sky: { type: Types.Color, default: [0.6902, 0.749, 0.7843, 1.0] },
+    equator: { type: Types.Color, default: [0.6584, 0.7084, 0.7913, 1.0] },
+    ground: { type: Types.Color, default: [0.807, 0.7758, 0.7454, 1.0] },
+    intensity: { type: Types.Float32, default: 1.0 },
+    _needsUpdate: { type: Types.Boolean, default: true },
+}, 'IBL from a gradient scene');
+
+export { IBLGradient };
+//# sourceMappingURL=ibl-gradient.js.map

package/dist/environment/ibl-gradient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-gradient.js","sources":["../../src/environment/ibl-gradient.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAIH;;;;;;;AAOG;AACI,MAAM,WAAW,GAAG,eAAe,CACxC,aAAa,EACb;AACE,IAAA,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;AACjE,IAAA,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;AACtE,IAAA,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;IACpE,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;IAChD,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;CACrD,EACD,2BAA2B;;;;"}

package/dist/environment/ibl-texture.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { Types } from '../ecs/index.js';
+/**
+ * Image‑based lighting from a texture or the built‑in Room environment.
+ *
+ * @remarks
+ * - `src`: "room" | HDR/EXR equirect | LDR equirect. PMREM processed to `scene.environment`.
+ * - `rotation` controls `scene.environmentRotation` in radians.
+ * - Does not set `scene.background`.
+ *
+ * @category Environment & Lighting
+ */
+export declare const IBLTexture: import("elics").Component<{
+    src: {
+        type: Types.String;
+        default: string;
+    };
+    intensity: {
+        type: Types.Float32;
+        default: number;
+    };
+    rotation: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    _needsUpdate: {
+        type: Types.Boolean;
+        default: true;
+    };
+}>;
+//# sourceMappingURL=ibl-texture.d.ts.map

package/dist/environment/ibl-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-texture.d.ts","sourceRoot":"","sources":["../../src/environment/ibl-texture.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;EAStB,CAAC"}

package/dist/environment/ibl-texture.js

@@ -0,0 +1,30 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Image‑based lighting from a texture or the built‑in Room environment.
+ *
+ * @remarks
+ * - `src`: "room" | HDR/EXR equirect | LDR equirect. PMREM processed to `scene.environment`.
+ * - `rotation` controls `scene.environmentRotation` in radians.
+ * - Does not set `scene.background`.
+ *
+ * @category Environment & Lighting
+ */
+const IBLTexture = createComponent('IBLTexture', {
+    src: { type: Types.String, default: 'room' },
+    intensity: { type: Types.Float32, default: 1.0 },
+    rotation: { type: Types.Vec3, default: [0, 0, 0] },
+    _needsUpdate: { type: Types.Boolean, default: true },
+}, 'Image‑based lighting from texture or Room environment');
+
+export { IBLTexture };
+//# sourceMappingURL=ibl-texture.js.map

package/dist/environment/ibl-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-texture.js","sources":["../../src/environment/ibl-texture.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AAIH;;;;;;;;;AASG;AACI,MAAM,UAAU,GAAG,eAAe,CACvC,YAAY,EACZ;IACE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;IAC5C,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;AAChD,IAAA,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAClD,YAAY,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;CACrD,EACD,uDAAuD;;;;"}

package/dist/environment/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export { DomeTexture } from './dome-texture.js';
+export { DomeGradient } from './dome-gradient.js';
+export { IBLTexture } from './ibl-texture.js';
+export { IBLGradient } from './ibl-gradient.js';
+export { EnvironmentSystem } from './environment-system.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/environment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/environment/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/grab/distance-grabbable.d.ts

@@ -0,0 +1,115 @@
+import { Types } from '../ecs/index.js';
+/**
+ * Component for enabling distance‑based object grabbing and manipulation.
+ *
+ * @remarks
+ * - Allows users to grab and manipulate objects from a distance through ray casting.
+ * - Supports three movement modes: MoveTowardsTarget, MoveAtSource, and RotateAtSource.
+ * - **MoveTowardsTarget**: Object smoothly moves toward the input source that's grabbing.
+ * - **MoveAtSource**: Object moves relative to hand movement while maintaining distance.
+ * - **RotateAtSource**: Object rotates in place without translation or scaling.
+ * - Optional `returnToOrigin` makes objects snap back to their original position when released.
+ * - Supports rotation, translation, and scaling with per‑axis constraints.
+ * - Works with the {@link GrabSystem} to create specialized distance grab handles.
+ * - Perfect for telekinetic‑style interactions and remote object manipulation.
+ *
+ * @example Basic distance grabbable object
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   movementMode: MovementMode.MoveTowardsTarget,
+ * })
+ * ```
+ *
+ * @example Telekinetic manipulation that returns to origin
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   rotate: true,
+ *   translate: true,
+ *   scale: false,
+ *   movementMode: MovementMode.MoveAtSource,
+ *   returnToOrigin: true
+ * })
+ * ```
+ *
+ * @example Rotation‑only distance interaction
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   movementMode: MovementMode.RotateAtSource,
+ * })
+ * ```
+ *
+ * @category Grab
+ * @see {@link GrabSystem}
+ * @see {@link OneHandGrabbable}
+ * @see {@link TwoHandsGrabbable}
+ * @see {@link MovementMode}
+ */
+export declare const DistanceGrabbable: import("elics").Component<{
+    /** A boolean value to set whether rotating the object is allowed. */
+    rotate: {
+        type: Types.Boolean;
+        default: true;
+    };
+    /** An optional vector to define the maximum angle of the allowed rotation in [x, y, z] axes. */
+    rotateMax: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** An optional vector to define the minimum angle of the allowed rotation in [x, y, z] axes. */
+    rotateMin: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** A boolean value to set whether moving the object's position is allowed. */
+    translate: {
+        type: Types.Boolean;
+        default: true;
+    };
+    /** An optional vector to define the maximum allowed position in [x, y, z] axes. */
+    translateMax: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** An optional vector to define the minimum allowed position in [x, y, z] axes. */
+    translateMin: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** A boolean value to set whether scaling the object up and down is allowed. */
+    scale: {
+        type: Types.Boolean;
+        default: true;
+    };
+    /** An optional vector to define the maximum allowed scaling in [x, y, z] axes. */
+    scaleMax: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** An optional vector to define the minimum allowed scaling in [x, y, z] axes. */
+    scaleMin: {
+        type: Types.Vec3;
+        default: [number, number, number];
+    };
+    /** The movement mode of the grabbable. More details in {@link MovementMode}. */
+    movementMode: {
+        type: Types.Enum;
+        enum: {
+            MoveFromTarget: string;
+            MoveTowardsTarget: string;
+            MoveAtSource: string;
+            RotateAtSource: string;
+        };
+        default: string;
+    };
+    /** A boolean value to set whether the object snap back to its original position and rotation. */
+    returnToOrigin: {
+        type: Types.Boolean;
+        default: false;
+    };
+    /** Object movement speed for the MoveTowardsTarget movement mode. */
+    moveSpeed: {
+        type: Types.Float32;
+        default: number;
+    };
+}>;
+//# sourceMappingURL=distance-grabbable.d.ts.map

package/dist/grab/distance-grabbable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance-grabbable.d.ts","sourceRoot":"","sources":["../../src/grab/distance-grabbable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,iBAAiB,CAAC;AAGzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,iBAAiB;IAG1B,qEAAqE;;;;;IAErE,gGAAgG;;;;;IAKhG,gGAAgG;;;;;IAKhG,8EAA8E;;;;;IAE9E,mFAAmF;;;;;IAKnF,mFAAmF;;;;;IAKnF,gFAAgF;;;;;IAEhF,kFAAkF;;;;;IAKlF,kFAAkF;;;;;IAKlF,gFAAgF;;;;;;;;;;;IAMhF,iGAAiG;;;;;IAEjG,qEAAqE;;;;;EAIxE,CAAC"}

package/dist/grab/distance-grabbable.js

@@ -0,0 +1,102 @@
+import '@preact/signals-core';
+import '../ecs/world.js';
+import { createComponent, Types } from 'elics';
+import '../ecs/component-registry.js';
+import { MovementMode } from './handles.js';
+
+/**
+ * Component for enabling distance‑based object grabbing and manipulation.
+ *
+ * @remarks
+ * - Allows users to grab and manipulate objects from a distance through ray casting.
+ * - Supports three movement modes: MoveTowardsTarget, MoveAtSource, and RotateAtSource.
+ * - **MoveTowardsTarget**: Object smoothly moves toward the input source that's grabbing.
+ * - **MoveAtSource**: Object moves relative to hand movement while maintaining distance.
+ * - **RotateAtSource**: Object rotates in place without translation or scaling.
+ * - Optional `returnToOrigin` makes objects snap back to their original position when released.
+ * - Supports rotation, translation, and scaling with per‑axis constraints.
+ * - Works with the {@link GrabSystem} to create specialized distance grab handles.
+ * - Perfect for telekinetic‑style interactions and remote object manipulation.
+ *
+ * @example Basic distance grabbable object
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   movementMode: MovementMode.MoveTowardsTarget,
+ * })
+ * ```
+ *
+ * @example Telekinetic manipulation that returns to origin
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   rotate: true,
+ *   translate: true,
+ *   scale: false,
+ *   movementMode: MovementMode.MoveAtSource,
+ *   returnToOrigin: true
+ * })
+ * ```
+ *
+ * @example Rotation‑only distance interaction
+ * ```ts
+ * entity.addComponent(DistanceGrabbable, {
+ *   movementMode: MovementMode.RotateAtSource,
+ * })
+ * ```
+ *
+ * @category Grab
+ * @see {@link GrabSystem}
+ * @see {@link OneHandGrabbable}
+ * @see {@link TwoHandsGrabbable}
+ * @see {@link MovementMode}
+ */
+const DistanceGrabbable = createComponent('DistanceGrabbable', {
+    /** A boolean value to set whether rotating the object is allowed. */
+    rotate: { type: Types.Boolean, default: true },
+    /** An optional vector to define the maximum angle of the allowed rotation in [x, y, z] axes. */
+    rotateMax: {
+        type: Types.Vec3,
+        default: [Infinity, Infinity, Infinity],
+    },
+    /** An optional vector to define the minimum angle of the allowed rotation in [x, y, z] axes. */
+    rotateMin: {
+        type: Types.Vec3,
+        default: [-Infinity, -Infinity, -Infinity],
+    },
+    /** A boolean value to set whether moving the object's position is allowed. */
+    translate: { type: Types.Boolean, default: true },
+    /** An optional vector to define the maximum allowed position in [x, y, z] axes. */
+    translateMax: {
+        type: Types.Vec3,
+        default: [Infinity, Infinity, Infinity],
+    },
+    /** An optional vector to define the minimum allowed position in [x, y, z] axes. */
+    translateMin: {
+        type: Types.Vec3,
+        default: [-Infinity, -Infinity, -Infinity],
+    },
+    /** A boolean value to set whether scaling the object up and down is allowed. */
+    scale: { type: Types.Boolean, default: true },
+    /** An optional vector to define the maximum allowed scaling in [x, y, z] axes. */
+    scaleMax: {
+        type: Types.Vec3,
+        default: [Infinity, Infinity, Infinity],
+    },
+    /** An optional vector to define the minimum allowed scaling in [x, y, z] axes. */
+    scaleMin: {
+        type: Types.Vec3,
+        default: [-Infinity, -Infinity, -Infinity],
+    },
+    /** The movement mode of the grabbable. More details in {@link MovementMode}. */
+    movementMode: {
+        type: Types.Enum,
+        enum: MovementMode,
+        default: MovementMode.MoveTowardsTarget,
+    },
+    /** A boolean value to set whether the object snap back to its original position and rotation. */
+    returnToOrigin: { type: Types.Boolean, default: false },
+    /** Object movement speed for the MoveTowardsTarget movement mode. */
+    moveSpeed: { type: Types.Float32, default: 0.1 },
+}, 'Component for distance-based object grabbing and manipulation');
+
+export { DistanceGrabbable };
+//# sourceMappingURL=distance-grabbable.js.map

package/dist/grab/distance-grabbable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance-grabbable.js","sources":["../../src/grab/distance-grabbable.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CG;AACI,MAAM,iBAAiB,GAAG,eAAe,CAC9C,mBAAmB,EACnB;;IAEE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;;AAE9C,IAAA,SAAS,EAAE;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;AACxC,KAAA;;AAED,IAAA,SAAS,EAAE;QACT,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;AAC3C,KAAA;;IAED,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;;AAEjD,IAAA,YAAY,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;AACxC,KAAA;;AAED,IAAA,YAAY,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;AAC3C,KAAA;;IAED,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE;;AAE7C,IAAA,QAAQ,EAAE;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;AACxC,KAAA;;AAED,IAAA,QAAQ,EAAE;QACR,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;AAC3C,KAAA;;AAED,IAAA,YAAY,EAAE;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;AAChB,QAAA,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,YAAY,CAAC,iBAAiB;AACxC,KAAA;;IAED,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE;;IAEvD,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE;CACjD,EACD,+DAA+D;;;;"}