3d-spinner 0.9.4 → 0.9.5

package/dist/engines/little-3d-engine/shapes/primitives/octahedron.d.ts

@@ -1,8 +1,9 @@
-import type { Mesh } from "../../core/mesh.js";
+import { type Material, type Mesh } from "../../core/mesh.js";
 /**
  * Build a regular octahedron mesh centered on the origin.
  *
  * @param size Distance between opposite vertices. Defaults to `1`.
  * @param colors Eight CSS colors, one per triangular face. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function octahedron(size?: number, colors?: string[]): Mesh;
+export declare function octahedron(size?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/octahedron.js

@@ -1,3 +1,4 @@
+import { attachMaterial } from "../../core/mesh.js";
 const DEFAULT_COLORS = [
     "#3b82f6",
     "#8b5cf6",
@@ -13,8 +14,9 @@ const DEFAULT_COLORS = [
  *
  * @param size Distance between opposite vertices. Defaults to `1`.
  * @param colors Eight CSS colors, one per triangular face. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function octahedron(size = 1, colors = DEFAULT_COLORS) {
+export function octahedron(size = 1, colors = DEFAULT_COLORS, material) {
     const r = size / 2;
     const vertices = [
         { x: r, y: 0, z: 0 },
@@ -34,5 +36,5 @@ export function octahedron(size = 1, colors = DEFAULT_COLORS) {
         { indices: [5, 3, 1], color: colors[6 % colors.length] },
         { indices: [5, 0, 3], color: colors[7 % colors.length] },
     ];
-    return { vertices, faces };
+    return attachMaterial({ vertices, faces }, material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/pyramid.d.ts

@@ -1,9 +1,10 @@
-import type { Mesh } from "../../core/mesh.js";
+import { type Material, type Mesh } from "../../core/mesh.js";
 /**
  * Build a square pyramid mesh centered on the origin, base down.
  *
  * @param size Base edge length (also the height). Defaults to `1`.
  * @param colors Five CSS colors: the square base, then the four triangular sides.
  *   Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function pyramid(size?: number, colors?: string[]): Mesh;
+export declare function pyramid(size?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/pyramid.js

@@ -1,3 +1,4 @@
+import { attachMaterial } from "../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981"];
 /**
  * Build a square pyramid mesh centered on the origin, base down.
@@ -5,8 +6,9 @@ const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981"];
  * @param size Base edge length (also the height). Defaults to `1`.
  * @param colors Five CSS colors: the square base, then the four triangular sides.
  *   Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function pyramid(size = 1, colors = DEFAULT_COLORS) {
+export function pyramid(size = 1, colors = DEFAULT_COLORS, material) {
     const h = size / 2;
     const vertices = [
         { x: -h, y: -h, z: h },
@@ -22,5 +24,5 @@ export function pyramid(size = 1, colors = DEFAULT_COLORS) {
         { indices: [4, 2, 3], color: colors[3 % colors.length] },
         { indices: [4, 3, 0], color: colors[4 % colors.length] },
     ];
-    return { vertices, faces };
+    return attachMaterial({ vertices, faces }, material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/quad.d.ts

@@ -1,9 +1,10 @@
-import type { Mesh } from "../../core/mesh.js";
+import { type Material, type Mesh } from "../../core/mesh.js";
 /**
  * Build a flat square in the XY plane, facing +Z, as a single four-vertex
  * face. Useful as a billboard when kept facing the camera.
  *
  * @param size Edge length. Defaults to `1`.
  * @param colors CSS color for the face. Defaults to a built-in blue.
+ * @param material Optional surface material applied to every face.
  */
-export declare function quad(size?: number, colors?: string[]): Mesh;
+export declare function quad(size?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/quad.js

@@ -1,3 +1,4 @@
+import { attachMaterial } from "../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6"];
 /**
  * Build a flat square in the XY plane, facing +Z, as a single four-vertex
@@ -5,8 +6,9 @@ const DEFAULT_COLORS = ["#3b82f6"];
  *
  * @param size Edge length. Defaults to `1`.
  * @param colors CSS color for the face. Defaults to a built-in blue.
+ * @param material Optional surface material applied to every face.
  */
-export function quad(size = 1, colors = DEFAULT_COLORS) {
+export function quad(size = 1, colors = DEFAULT_COLORS, material) {
     const s = size / 2;
     const vertices = [
         { x: -s, y: -s, z: 0 },
@@ -14,5 +16,5 @@ export function quad(size = 1, colors = DEFAULT_COLORS) {
         { x: s, y: s, z: 0 },
         { x: -s, y: s, z: 0 },
     ];
-    return { vertices, faces: [{ indices: [0, 1, 2, 3], color: colors[0] }] };
+    return attachMaterial({ vertices, faces: [{ indices: [0, 1, 2, 3], color: colors[0] }] }, material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/spheres/cube-sphere.d.ts

@@ -1,4 +1,4 @@
-import type { Mesh } from "../../../core/mesh.js";
+import { type Material, type Mesh } from "../../../core/mesh.js";
 /**
  * Build a cube-sphere (spherified cube) centered on the origin: each cube face
  * is gridded and projected onto the sphere. Even, all-quad, no poles.
@@ -7,5 +7,6 @@ import type { Mesh } from "../../../core/mesh.js";
  * @param detail Subdivisions per cube face edge, `1` = simplest (6 quads).
  *   Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function cubeSphere(size?: number, detail?: number, colors?: string[]): Mesh;
+export declare function cubeSphere(size?: number, detail?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/spheres/cube-sphere.js

@@ -1,3 +1,4 @@
+import { attachMaterial } from "../../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981", "#ef4444"];
 // right x up == normal for each face, so generated quads wind CCW outward.
 const CUBE_FACES = [
@@ -16,8 +17,9 @@ const CUBE_FACES = [
  * @param detail Subdivisions per cube face edge, `1` = simplest (6 quads).
  *   Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function cubeSphere(size = 1, detail = 1, colors = DEFAULT_COLORS) {
+export function cubeSphere(size = 1, detail = 1, colors = DEFAULT_COLORS, material) {
     const r = size / 2;
     const n = Math.max(1, Math.floor(detail));
     const vertices = [];
@@ -46,5 +48,5 @@ export function cubeSphere(size = 1, detail = 1, colors = DEFAULT_COLORS) {
             }
         }
     }
-    return { vertices, faces };
+    return attachMaterial({ vertices, faces }, material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/spheres/icosphere.d.ts

@@ -1,4 +1,4 @@
-import type { Mesh } from "../../../core/mesh.js";
+import { type Material, type Mesh } from "../../../core/mesh.js";
 /**
  * Build an icosphere (subdivided icosahedron) centered on the origin. Gives the
  * most uniform triangle distribution of the sphere types.
@@ -7,5 +7,6 @@ import type { Mesh } from "../../../core/mesh.js";
  * @param detail Subdivision level, `1` = base icosahedron (20 faces). Each level
  *   splits every triangle into four. Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function icosphere(size?: number, detail?: number, colors?: string[]): Mesh;
+export declare function icosphere(size?: number, detail?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/spheres/icosphere.js

@@ -1,4 +1,5 @@
 import { sphereFromTriangles } from "../../../core/geometry.js";
+import { attachMaterial } from "../../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981", "#ef4444"];
 const T = (1 + Math.sqrt(5)) / 2;
 const SEED_VERTICES = [
@@ -45,7 +46,8 @@ const SEED_FACES = [
  * @param detail Subdivision level, `1` = base icosahedron (20 faces). Each level
  *   splits every triangle into four. Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function icosphere(size = 1, detail = 1, colors = DEFAULT_COLORS) {
-    return sphereFromTriangles(SEED_VERTICES, SEED_FACES, size, detail, colors);
+export function icosphere(size = 1, detail = 1, colors = DEFAULT_COLORS, material) {
+    return attachMaterial(sphereFromTriangles(SEED_VERTICES, SEED_FACES, size, detail, colors), material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/spheres/octa-sphere.d.ts

@@ -1,4 +1,4 @@
-import type { Mesh } from "../../../core/mesh.js";
+import { type Material, type Mesh } from "../../../core/mesh.js";
 /**
  * Build an octa-sphere (subdivided octahedron) centered on the origin.
  *
@@ -6,5 +6,6 @@ import type { Mesh } from "../../../core/mesh.js";
  * @param detail Subdivision level, `1` = base octahedron (8 faces). Each level
  *   splits every triangle into four. Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function octaSphere(size?: number, detail?: number, colors?: string[]): Mesh;
+export declare function octaSphere(size?: number, detail?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/spheres/octa-sphere.js

@@ -1,4 +1,5 @@
 import { sphereFromTriangles } from "../../../core/geometry.js";
+import { attachMaterial } from "../../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981", "#ef4444"];
 const SEED_VERTICES = [
     { x: 1, y: 0, z: 0 },
@@ -25,7 +26,8 @@ const SEED_FACES = [
  * @param detail Subdivision level, `1` = base octahedron (8 faces). Each level
  *   splits every triangle into four. Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function octaSphere(size = 1, detail = 1, colors = DEFAULT_COLORS) {
-    return sphereFromTriangles(SEED_VERTICES, SEED_FACES, size, detail, colors);
+export function octaSphere(size = 1, detail = 1, colors = DEFAULT_COLORS, material) {
+    return attachMaterial(sphereFromTriangles(SEED_VERTICES, SEED_FACES, size, detail, colors), material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/spheres/uv-sphere.d.ts

@@ -1,4 +1,4 @@
-import type { Mesh } from "../../../core/mesh.js";
+import { type Material, type Mesh } from "../../../core/mesh.js";
 /**
  * Build a UV (latitude/longitude) sphere centered on the origin.
  *
@@ -6,5 +6,6 @@ import type { Mesh } from "../../../core/mesh.js";
  * @param detail Tessellation level, `1` = simplest. Higher values add rings and
  *   segments. Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function uvSphere(size?: number, detail?: number, colors?: string[]): Mesh;
+export declare function uvSphere(size?: number, detail?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/spheres/uv-sphere.js

@@ -1,3 +1,4 @@
+import { attachMaterial } from "../../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981", "#ef4444"];
 /**
  * Build a UV (latitude/longitude) sphere centered on the origin.
@@ -6,8 +7,9 @@ const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b", "#10b981", "
  * @param detail Tessellation level, `1` = simplest. Higher values add rings and
  *   segments. Defaults to `1`.
  * @param colors CSS colors cycled across faces. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function uvSphere(size = 1, detail = 1, colors = DEFAULT_COLORS) {
+export function uvSphere(size = 1, detail = 1, colors = DEFAULT_COLORS, material) {
     const r = size / 2;
     const d = Math.max(1, Math.floor(detail));
     const slices = Math.max(4, d * 4);
@@ -46,5 +48,5 @@ export function uvSphere(size = 1, detail = 1, colors = DEFAULT_COLORS) {
             color: color(),
         });
     }
-    return { vertices, faces };
+    return attachMaterial({ vertices, faces }, material);
 }

package/dist/engines/little-3d-engine/shapes/primitives/tetrahedron.d.ts

@@ -1,8 +1,9 @@
-import type { Mesh } from "../../core/mesh.js";
+import { type Material, type Mesh } from "../../core/mesh.js";
 /**
  * Build a regular tetrahedron mesh centered on the origin.
  *
  * @param size Approximate diameter. Defaults to `1`.
  * @param colors Four CSS colors, one per triangular face. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export declare function tetrahedron(size?: number, colors?: string[]): Mesh;
+export declare function tetrahedron(size?: number, colors?: string[], material?: Material): Mesh;

package/dist/engines/little-3d-engine/shapes/primitives/tetrahedron.js

@@ -1,11 +1,13 @@
+import { attachMaterial } from "../../core/mesh.js";
 const DEFAULT_COLORS = ["#3b82f6", "#8b5cf6", "#ec4899", "#f59e0b"];
 /**
  * Build a regular tetrahedron mesh centered on the origin.
  *
  * @param size Approximate diameter. Defaults to `1`.
  * @param colors Four CSS colors, one per triangular face. Defaults to a built-in palette.
+ * @param material Optional surface material applied to every face.
  */
-export function tetrahedron(size = 1, colors = DEFAULT_COLORS) {
+export function tetrahedron(size = 1, colors = DEFAULT_COLORS, material) {
     const s = size / 2;
     const vertices = [
         { x: s, y: s, z: s },
@@ -19,5 +21,5 @@ export function tetrahedron(size = 1, colors = DEFAULT_COLORS) {
         { indices: [0, 2, 3], color: colors[2 % colors.length] },
         { indices: [1, 3, 2], color: colors[3 % colors.length] },
     ];
-    return { vertices, faces };
+    return attachMaterial({ vertices, faces }, material);
 }