@objectifthunes/three-book 0.1.0

package/dist/utils/BezierUtility.d.ts

@@ -0,0 +1,8 @@
+import * as THREE from 'three';
+/**
+ * Evaluates a quadratic Bezier curve at parameter t.
+ *
+ * B(t) = (1-t)^2 * p0 + 2*(1-t)*t * p1 + t^2 * p2
+ */
+export declare function evaluate(p0: THREE.Vector3, p1: THREE.Vector3, p2: THREE.Vector3, t: number): THREE.Vector3;
+//# sourceMappingURL=BezierUtility.d.ts.map

package/dist/utils/BezierUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BezierUtility.d.ts","sourceRoot":"","sources":["../../src/utils/BezierUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,KAAK,CAAC,OAAO,EACjB,EAAE,EAAE,KAAK,CAAC,OAAO,EACjB,EAAE,EAAE,KAAK,CAAC,OAAO,EACjB,CAAC,EAAE,MAAM,GACR,KAAK,CAAC,OAAO,CAQf"}

package/dist/utils/EllipseUtility.d.ts

@@ -0,0 +1,8 @@
+import * as THREE from 'three';
+/**
+ * Clamps a point to the surface of an ellipse if it lies outside.
+ * (Note: the original C# method was named "Calmp" -- a typo preserved here
+ * in the comment but corrected in the exported function name.)
+ */
+export declare function clamp(point: THREE.Vector2, ellipseCenter: THREE.Vector2, ellipseSize: THREE.Vector2): THREE.Vector2;
+//# sourceMappingURL=EllipseUtility.d.ts.map

package/dist/utils/EllipseUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EllipseUtility.d.ts","sourceRoot":"","sources":["../../src/utils/EllipseUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuC/B;;;;GAIG;AACH,wBAAgB,KAAK,CACnB,KAAK,EAAE,KAAK,CAAC,OAAO,EACpB,aAAa,EAAE,KAAK,CAAC,OAAO,EAC5B,WAAW,EAAE,KAAK,CAAC,OAAO,GACzB,KAAK,CAAC,OAAO,CASf"}

package/dist/utils/LoopUtility.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Returns the next index in a circular array, wrapping from the end to 0.
+ */
+export declare function nextIndex(index: number, arrayLength: number): number;
+/**
+ * Returns the previous index in a circular array, wrapping from 0 to the end.
+ */
+export declare function prevIndex(index: number, arrayLength: number): number;
+/**
+ * Wraps an index into the valid range [0, arrayLength) using floor-based modulo.
+ * Handles negative indices correctly (unlike the JS % operator).
+ */
+export declare function loopIndex(index: number, arrayLength: number): number;
+//# sourceMappingURL=LoopUtility.d.ts.map

package/dist/utils/LoopUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoopUtility.d.ts","sourceRoot":"","sources":["../../src/utils/LoopUtility.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAGpE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/utils/MatrixUtility.d.ts

@@ -0,0 +1,13 @@
+import * as THREE from 'three';
+/**
+ * Transforms a ray by a matrix.
+ *
+ * The original C# uses Matrix4x4.MultiplyPoint3x4 which applies the full
+ * affine transform (rotation + scale + translation) but ignores the
+ * projective row. THREE.Vector3.applyMatrix4 does the same for affine
+ * matrices (w is assumed 1 and the perspective divide is a no-op).
+ *
+ * Returns a new THREE.Ray with the transformed origin and direction.
+ */
+export declare function transformRay(ray: THREE.Ray, matrix: THREE.Matrix4): THREE.Ray;
+//# sourceMappingURL=MatrixUtility.d.ts.map

package/dist/utils/MatrixUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MatrixUtility.d.ts","sourceRoot":"","sources":["../../src/utils/MatrixUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,KAAK,CAAC,GAAG,EACd,MAAM,EAAE,KAAK,CAAC,OAAO,GACpB,KAAK,CAAC,GAAG,CAIX"}

package/dist/utils/TextureUtility.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Minimal TextureUtility — ported from the portions of TextureUtility.cs
+ * that are used by the Paper class (ST flip operations).
+ * Unity-specific texture creation is omitted.
+ */
+import * as THREE from 'three';
+/**
+ * Flip the X axis of a texture ST vector.
+ * ST format: (scaleX, scaleY, offsetX, offsetY)
+ */
+export declare function xFlipST(st: THREE.Vector4): THREE.Vector4;
+/**
+ * Flip the Y axis of a texture ST vector.
+ */
+export declare function yFlipST(st: THREE.Vector4): THREE.Vector4;
+export declare function fixNull(texture: THREE.Texture | null): THREE.Texture;
+//# sourceMappingURL=TextureUtility.d.ts.map

package/dist/utils/TextureUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureUtility.d.ts","sourceRoot":"","sources":["../../src/utils/TextureUtility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAExD;AAQD,wBAAgB,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC,OAAO,CAWpE"}

package/dist/utils/TriangleUtility.d.ts

@@ -0,0 +1,11 @@
+import * as THREE from 'three';
+/**
+ * Computes the normal of a triangle defined by vertices a, b, c.
+ *
+ * This is a faithful port of the original C# implementation which manually
+ * normalises the edge vectors before computing the cross product, then
+ * normalises the result. This differs from a simple (b-a).cross(c-a).normalize()
+ * and is preserved exactly.
+ */
+export declare function getNormal(a: THREE.Vector3, b: THREE.Vector3, c: THREE.Vector3, out?: THREE.Vector3): THREE.Vector3;
+//# sourceMappingURL=TriangleUtility.d.ts.map

package/dist/utils/TriangleUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriangleUtility.d.ts","sourceRoot":"","sources":["../../src/utils/TriangleUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,CAAC,EAAE,KAAK,CAAC,OAAO,EAChB,CAAC,EAAE,KAAK,CAAC,OAAO,EAChB,CAAC,EAAE,KAAK,CAAC,OAAO,EAChB,GAAG,GAAE,KAAK,CAAC,OAA6B,GACvC,KAAK,CAAC,OAAO,CAuBf"}

package/dist/utils/VectorUtility.d.ts

@@ -0,0 +1,29 @@
+import * as THREE from 'three';
+/**
+ * Per-component SmoothDamp for Vector3 using per-component smooth times.
+ *
+ * `currentVelocity` is mutated in-place (mirrors the C# `ref` semantics).
+ * Returns the new smoothed position.
+ */
+export declare function smoothDamp(current: THREE.Vector3, target: THREE.Vector3, currentVelocity: THREE.Vector3, smoothTime: THREE.Vector3, maxSpeed?: number, deltaTime?: number): THREE.Vector3;
+/**
+ * Per-component SmoothStep for Vector3.
+ */
+export declare function smoothStep(from: THREE.Vector3, to: THREE.Vector3, smoothStepT: THREE.Vector3): THREE.Vector3;
+/**
+ * Per-component MoveTowards for Vector3.
+ */
+export declare function moveTowards(current: THREE.Vector3, target: THREE.Vector3, maxDistanceDelta: THREE.Vector3): THREE.Vector3;
+/**
+ * Returns a perpendicular vector in the XZ plane (swaps x and z, negates z).
+ */
+export declare function getPerpendicularXZ2(vector: THREE.Vector3): THREE.Vector3;
+/**
+ * Converts an XY vector to XZ (y -> z, y set to 0).
+ */
+export declare function xy2xz(v: THREE.Vector3): THREE.Vector3;
+/**
+ * Converts an XZ vector to XY (z -> y, z set to 0).
+ */
+export declare function xz2xy(v: THREE.Vector3): THREE.Vector3;
+//# sourceMappingURL=VectorUtility.d.ts.map

package/dist/utils/VectorUtility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorUtility.d.ts","sourceRoot":"","sources":["../../src/utils/VectorUtility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmF/B;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,MAAM,EAAE,KAAK,CAAC,OAAO,EACrB,eAAe,EAAE,KAAK,CAAC,OAAO,EAC9B,UAAU,EAAE,KAAK,CAAC,OAAO,EACzB,QAAQ,GAAE,MAAiB,EAC3B,SAAS,GAAE,MAAe,GACzB,KAAK,CAAC,OAAO,CA8Bf;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,KAAK,CAAC,OAAO,EACnB,EAAE,EAAE,KAAK,CAAC,OAAO,EACjB,WAAW,EAAE,KAAK,CAAC,OAAO,GACzB,KAAK,CAAC,OAAO,CAMf;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,KAAK,CAAC,OAAO,EACtB,MAAM,EAAE,KAAK,CAAC,OAAO,EACrB,gBAAgB,EAAE,KAAK,CAAC,OAAO,GAC9B,KAAK,CAAC,OAAO,CAMf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAErD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * as VectorUtility from './VectorUtility';
+export * as BezierUtility from './BezierUtility';
+export * as EllipseUtility from './EllipseUtility';
+export * as TriangleUtility from './TriangleUtility';
+export * as LoopUtility from './LoopUtility';
+export * as MatrixUtility from './MatrixUtility';
+export * as TextureUtility from './TextureUtility';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,eAAe,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,cAAc,MAAM,kBAAkB,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@objectifthunes/three-book",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "three": ">=0.150.0"
+  },
+  "devDependencies": {
+    "three": "^0.172.0",
+    "@types/three": "^0.172.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "vite-plugin-dts": "^4.0.0"
+  },
+  "scripts": {
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  }
+}