bookcover-3d-web 0.3.0 → 0.5.0

package/README.md

@@ -113,10 +113,13 @@ background image, with a shadow derived from the light direction. It returns an
 
 ![Example photo](./README_mockup.webp)
 
-The library ships a set of built-in background photos via `BACKGROUNDS`. Each entry has
-an `id` (to identify which image to load) and pre-tuned camera/lighting options that
-make the book look natural in that scene. Pass the background entry directly as the
-`options` argument — it extends `PhotoCompositeOptions`.
+The library describes a set of background photos via `BACKGROUNDS` (metadata only — the
+JPGs themselves are not bundled in the npm package; they live in the repo's
+[assets tree](https://github.com/gracious-tech/bookcover/tree/main/assets/3d/backgrounds)
+for you to host alongside your other static assets). Each entry has an `id` (to identify
+which image to load) and pre-tuned camera/lighting options that make the book look
+natural in that scene. Pass the background entry directly as the `options` argument — it
+extends `PhotoCompositeOptions`.
 
 ```ts
 import {Book3DRenderer, BACKGROUNDS} from 'bookcover-3d-web'
@@ -126,7 +129,7 @@ import type {Background} from 'bookcover-3d-web'
 const bg: Background = BACKGROUNDS.find(b => b.id === 'coffee_table')!
 
 // Load the image however you serve your assets
-const img = await fetch(`/assets/backgrounds/${bg.id}.webp`)
+const img = await fetch(`/assets/3d/backgrounds/${bg.id}.jpg`)
 const blob = await img.blob()
 const bitmap = await createImageBitmap(blob)
 

package/dist/photo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../src/photo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAI1C,eAAO,MAAM,aAAa,MAAM,CAAA;AAChC,eAAO,MAAM,eAAe,KAAK,CAAA;AAGjC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAIpC,eAAO,MAAM,WAAW,EAAE,UAAU,EA6DnC,CAAA"}
+{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../src/photo.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,YAAY,CAAA;AAI1C,eAAO,MAAM,aAAa,MAAM,CAAA;AAChC,eAAO,MAAM,eAAe,KAAK,CAAA;AAGjC,eAAO,MAAM,gBAAgB,OAAO,CAAA;AAKpC,eAAO,MAAM,WAAW,EAAE,UAAU,EA6DnC,CAAA"}

package/dist/photo.js

@@ -5,8 +5,9 @@ export const PHOTO_AZIMUTH = -15;
 export const PHOTO_ELEVATION = 35;
 // Book render width as a fraction of the background image width
 export const PHOTO_BOOK_SCALE = 0.55;
-// Available background photos (images live in src/backgrounds/).
-// Each entry can override azimuth, elevation, and book_scale for a natural fit.
+// Available background photos — metadata only; the JPGs themselves live in the repo's shared
+// assets tree (assets/3d/backgrounds/<id>.jpg) and consumers fetch them from wherever they
+// serve that tree. Each entry can override azimuth, elevation, and book_scale for a natural fit.
 export const BACKGROUNDS = [
     {
         id: 'table_with_book',

package/dist/photo.js.map

@@ -1 +1 @@
-{"version":3,"file":"photo.js","sourceRoot":"","sources":["../src/photo.ts"],"names":[],"mappings":"AACA,6EAA6E;AAI7E,qFAAqF;AACrF,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,CAAA;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAA;AAEjC,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC,iEAAiE;AACjE,gFAAgF;AAChF,MAAM,CAAC,MAAM,WAAW,GAAiB;IACrC;QACI,EAAE,EAAE,iBAAiB;QACrB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,EAAE;QACd,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC,GAAG;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,CAAC;KACb;IACD;QACI,EAAE,EAAE,MAAM;QACV,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,CAAC;KACb;IACD;QACI,EAAE,EAAE,cAAc;QAClB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,EAAE;QACd,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,IAAI;KAChB;IACD;QACI,EAAE,EAAE,mBAAmB;QACvB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,EAAE;QACd,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,CAAC,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,GAAG;KACf;IACD;QACI,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,CAAC,EAAE;QACZ,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,CAAC,KAAK;QAChB,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,CAAC;KACb;CACJ,CAAA"}
+{"version":3,"file":"photo.js","sourceRoot":"","sources":["../src/photo.ts"],"names":[],"mappings":"AACA,6EAA6E;AAI7E,qFAAqF;AACrF,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAAE,CAAA;AAChC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAA;AAEjC,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAA;AAEpC,6FAA6F;AAC7F,2FAA2F;AAC3F,iGAAiG;AACjG,MAAM,CAAC,MAAM,WAAW,GAAiB;IACrC;QACI,EAAE,EAAE,iBAAiB;QACrB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,EAAE;QACd,UAAU,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC,GAAG;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,CAAC;KACb;IACD;QACI,EAAE,EAAE,MAAM;QACV,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,CAAC;KACb;IACD;QACI,EAAE,EAAE,cAAc;QAClB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,EAAE;QACd,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC,EAAE;QACT,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,IAAI;KAChB;IACD;QACI,EAAE,EAAE,mBAAmB;QACvB,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC,EAAE;QACd,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,EAAE;QACR,QAAQ,EAAE,CAAC,EAAE;QACb,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,GAAG;KACf;IACD;QACI,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,CAAC,EAAE;QACZ,SAAS,EAAE,CAAC;QACZ,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,CAAC,KAAK;QAChB,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,CAAC;QACP,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,CAAC;KACb;CACJ,CAAA"}

package/package.json

@@ -1,7 +1,7 @@
 
 {
     "name": "bookcover-3d-web",
-    "version": "0.3.0",
+    "version": "0.5.0",
     "license": "MIT-0",
     "repository": {"type": "git", "url": "https://github.com/gracious-tech/bookcover.git", "directory": "3d"},
     "homepage": "https://github.com/gracious-tech/bookcover/tree/main/3d#readme",
@@ -9,6 +9,9 @@
     "type": "module",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
+    "files": [
+        "dist/"
+    ],
     "scripts": {
         "build": "tsc",
         "dev": "tsc --watch"

package/src/geometry.ts

@@ -1,513 +0,0 @@
-
-// Book box geometry — builds the vertex/index data for a given cover size
-
-import type {CoverType} from './types.js'
-
-// Hardback board overhang (how much cover extends beyond pages on top/bottom/fore-edge)
-// and board thickness (depth each board consumes from total spine width), in normalised units (h=1.0)
-const BOARD_EXTEND    = 0.02
-const BOARD_THICKNESS = 0.007
-
-// Cream colour for page-edge faces (fore-edge, top, bottom)
-const PAGE_COLOR:[number,number,number] = [0.94, 0.91, 0.86]
-
-// Hole colour: same warm cream as page edges but darkened
-const HOLE_COLOR:[number,number,number] = [0.38, 0.36, 0.33]
-
-// Hole spacing (centre-to-centre) and size in normalised units (h=1.0 = cover height)
-const HOLE_PITCH    = 0.032  // tighter spacing, roughly twice as many holes
-const HOLE_W        = 0.010  // rectangle half-width (along Z / spine depth axis)
-const HOLE_H        = 0.008  // rectangle half-height (along Y / book height axis)
-const HOLE_CORNER   = 0.003  // corner radius for rounded rect
-const HOLE_MARGIN   = 0.025  // inset from spine edge to hole centre on cover faces
-const HOLE_EDGE_GAP = 0.018  // margin from top/bottom cover edge to first/last hole centre
-const HOLE_SEGS     = 4      // segments per rounded corner (quarter-circle)
-const HOLE_EPSILON  = 0.001  // z nudge to prevent z-fighting with underlying face
-
-/** A single face ready for GPU upload: interleaved [xyz, uv, normal] × 4 verts + 6 indices */
-export interface FaceData {
-    vertices:number[]             // 4 × 8 floats
-    indices:number[]              // 6 ints (two triangles, zero-based within this face)
-    texture:WebGLTexture | null
-    color:[number,number,number]
-}
-
-/** Build a filled rounded-rectangle on a cover face for coil/wire hole rendering.
- *  The shape sits in the XY plane at a fixed z; nx/ny/nz is the face normal.
- *  Corners are approximated with HOLE_SEGS arc segments each. */
-function make_hole_rect(
-    cx:number, cy:number, cz:number,
-    nx:number, ny:number, nz:number,
-):FaceData {
-    const verts:number[] = []
-    const indices:number[] = []
-
-    // Inner rect extents (full half-extents minus corner radius)
-    const iw = HOLE_W - HOLE_CORNER
-    const ih = HOLE_H - HOLE_CORNER
-
-    // Corner centres (dx, dy) and starting angle for each of the 4 corners
-    const corners:[number, number, number][] = [
-        [ iw,  ih,  0],              // top-right,    0° → 90°
-        [-iw,  ih,  Math.PI / 2],    // top-left,    90° → 180°
-        [-iw, -ih,  Math.PI],        // bottom-left, 180° → 270°
-        [ iw, -ih,  Math.PI * 1.5],  // bottom-right,270° → 360°
-    ]
-
-    // Center vertex (index 0)
-    verts.push(cx, cy, cz, 0.5, 0.5, nx, ny, nz)
-
-    // Perimeter vertices — HOLE_SEGS+1 points per corner arc
-    for (const [ox, oy, start_a] of corners) {
-        for (let s = 0; s <= HOLE_SEGS; s++) {
-            const a = start_a + (s / HOLE_SEGS) * (Math.PI / 2)
-            verts.push(
-                cx + ox + Math.cos(a) * HOLE_CORNER,
-                cy + oy + Math.sin(a) * HOLE_CORNER,
-                cz, 0.5, 0.5, nx, ny, nz,
-            )
-        }
-    }
-
-    // Fan triangles from center to each consecutive pair of perimeter verts
-    const perimeter = corners.length * (HOLE_SEGS + 1)
-    for (let i = 0; i < perimeter; i++)
-        indices.push(0, 1 + i, 1 + (i + 1) % perimeter)
-
-    return {vertices: verts, indices, texture: null, color: HOLE_COLOR}
-}
-
-/** Build painted-on binding holes on front and back cover faces for coil/wire bindings */
-function build_holes(hw:number, hh:number, hd:number):FaceData[] {
-    const faces:FaceData[] = []
-
-    // Fill from near the top edge to near the bottom edge
-    const usable = hh * 2 - HOLE_EDGE_GAP * 2
-    const hole_count = Math.max(1, Math.round(usable / HOLE_PITCH) + 1)
-    const span = (hole_count - 1) * HOLE_PITCH
-    const y0 = span / 2
-
-    for (let i = 0; i < hole_count; i++) {
-        const cy = y0 - i * HOLE_PITCH
-        const cx = -hw + HOLE_MARGIN
-
-        // Front cover (+z normal), nudged forward to avoid z-fighting
-        faces.push(make_hole_rect(cx, cy, hd + HOLE_EPSILON,  0, 0,  1))
-        // Back cover (-z normal), nudged backward
-        faces.push(make_hole_rect(cx, cy, -(hd + HOLE_EPSILON), 0, 0, -1))
-    }
-
-    return faces
-}
-
-/** Build a quad face from 4 [x,y,z,u,v] vertices + a flat normal */
-function make_face(
-    verts:[[number,number,number,number,number],[number,number,number,number,number],
-           [number,number,number,number,number],[number,number,number,number,number]],
-    nx:number, ny:number, nz:number,
-    tex:WebGLTexture | null,
-    color:[number,number,number] = [1,1,1],
-):FaceData {
-    const vertices:number[] = []
-    for (const [x,y,z,u,v] of verts)
-        vertices.push(x, y, z, u, v, nx, ny, nz)
-    return {vertices, indices: [0,1,2, 0,2,3], texture: tex, color}
-}
-
-// Saddle-stitch curve: how far from the spine edge the covers bend, and subdivision count
-const STITCH_CURVE_W    = 0.011  // ~2.5mm normalised (h=1.0 = cover height ~229mm)
-const STITCH_CURVE_SEGS = 5      // strip columns across the curved region
-
-/** Build the top or bottom edge face for saddle-stitch: flat across most of the width,
- *  curving to a point only in the STITCH_CURVE_W region near the spine, matching the covers. */
-function make_stitch_edge(
-    hw:number, y:number, vhd:number,
-    ny:number, page_tex:WebGLTexture,
-):FaceData {
-    const verts:number[] = []
-    const idx:number[]   = []
-    const cw = Math.min(STITCH_CURVE_W, hw)
-    const flip = ny < 0
-
-    // Columns from fore-edge to spine: [x, z_front, z_back]
-    const cols:[number, number, number][] = [
-        [hw,       vhd, -vhd],   // fore-edge
-        [-hw + cw, vhd, -vhd],   // start of curve
-    ]
-    // Curve region — mirrors make_stitch_cover: t=0 at spine (z=0), t=1 at curve end (z=±vhd)
-    for (let i = STITCH_CURVE_SEGS - 1; i >= 0; i--) {
-        const t = i / STITCH_CURVE_SEGS
-        const z = vhd * (1 - Math.cos(t * Math.PI / 2))
-        cols.push([-hw + t * cw, z, -z])
-    }
-
-    for (let c = 0; c < cols.length - 1; c++) {
-        const [x0, zf0, zb0] = cols[c]
-        const [x1, zf1, zb1] = cols[c + 1]
-        const u0 = (x0 + hw) / (2 * hw)
-        const u1 = (x1 + hw) / (2 * hw)
-        const base = (verts.length / 8)
-
-        // Top (ny>0): spine-front, fore-front, fore-back, spine-back
-        // Bottom (ny<0): spine-back, fore-back, fore-front, spine-front
-        if (!flip) {
-            verts.push(x1, y, zf1, u1, 0, 0, ny, 0)
-            verts.push(x0, y, zf0, u0, 0, 0, ny, 0)
-            verts.push(x0, y, zb0, u0, 1, 0, ny, 0)
-            verts.push(x1, y, zb1, u1, 1, 0, ny, 0)
-        } else {
-            verts.push(x1, y, zb1, u1, 1, 0, ny, 0)
-            verts.push(x0, y, zb0, u0, 1, 0, ny, 0)
-            verts.push(x0, y, zf0, u0, 0, 0, ny, 0)
-            verts.push(x1, y, zf1, u1, 0, 0, ny, 0)
-        }
-        idx.push(base, base+1, base+2,  base, base+2, base+3)
-    }
-
-    return {vertices: verts, indices: idx, texture: page_tex, color: [1, 1, 1]}
-}
-
-/** Build one curved cover panel for saddle-stitch binding.
- *  sign = +1 for front (normal points +z), -1 for back (-z).
- *  The spine edge (x = -hw) bends inward to z = 0 over STITCH_CURVE_W. */
-function make_stitch_cover(
-    hw:number, hh:number, hd:number,
-    sign:number, tex:WebGLTexture,
-):FaceData {
-    const verts:number[] = []
-    const idx:number[]   = []
-    const cw = Math.min(STITCH_CURVE_W, hw)
-
-    // Columns from spine edge to fore-edge, each with (x, z, u)
-    const cols:{x:number, z:number, u:number}[] = []
-
-    // Curved region: cosine ease from z=0 at spine to z=±hd at curve end
-    for (let i = 0; i <= STITCH_CURVE_SEGS; i++) {
-        const t = i / STITCH_CURVE_SEGS
-        cols.push({
-            x: -hw + t * cw,
-            z: sign * hd * (1 - Math.cos(t * Math.PI / 2)),
-            u: (-hw + t * cw + hw) / (2 * hw),
-        })
-    }
-    // Flat region: single column at fore-edge
-    cols.push({x: hw, z: sign * hd, u: 1.0})
-
-    // Back face UVs are mirrored horizontally (u=0 at fore-edge, u=1 at spine)
-    if (sign < 0) {
-        for (const c of cols) c.u = 1 - c.u
-    }
-
-    // Vertex strip: top and bottom vert per column
-    for (const {x, z, u} of cols) {
-        verts.push(x,  hh, z,  u, 0,  0, 0, sign)
-        verts.push(x, -hh, z,  u, 1,  0, 0, sign)
-    }
-
-    // Quads between adjacent column pairs
-    for (let c = 0; c < cols.length - 1; c++) {
-        const tl = c * 2, bl = c * 2 + 1
-        const tr = (c + 1) * 2, br = (c + 1) * 2 + 1
-        idx.push(tl, tr, br,  tl, br, bl)
-    }
-
-    return {vertices: verts, indices: idx, texture: tex, color: [1, 1, 1]}
-}
-
-/** Build faces for a saddle-stitch binding: covers curve inward to meet at the spine fold */
-function build_stitch(
-    hw:number, hh:number, hd:number,
-    front_tex:WebGLTexture, back_tex:WebGLTexture,
-    _spine_tex:WebGLTexture | null, page_tex:WebGLTexture,
-):FaceData[] {
-    const vhd = hd
-    return [
-        make_stitch_cover(hw, hh, vhd,  1, front_tex),
-        make_stitch_cover(hw, hh, vhd, -1, back_tex),
-
-        // Spine fold edge — covers meet at z=0 here so this is a zero-width seam;
-        // render a thin sliver of page color as a visual hint of the fold
-        make_face([
-            [-hw,  hh, -0.001,  0, 0],
-            [-hw,  hh,  0.001,  1, 0],
-            [-hw, -hh,  0.001,  1, 1],
-            [-hw, -hh, -0.001,  0, 1],
-        ], -1, 0, 0, null, PAGE_COLOR),
-
-        // Fore-edge (x = +hw)
-        make_face([
-            [ hw,  hh,  vhd,  0, 0],
-            [ hw,  hh, -vhd,  0, 1],
-            [ hw, -hh, -vhd,  1, 1],
-            [ hw, -hh,  vhd,  1, 0],
-        ], 1, 0, 0, page_tex),
-
-        // Top and bottom — curved strip matching the cover profile
-        make_stitch_edge(hw,  hh, vhd,  1, page_tex),
-        make_stitch_edge(hw, -hh, vhd, -1, page_tex),
-    ]
-}
-
-/** Build faces for a paperback (simple box, no overhang or board thickness) */
-function build_paperback(
-    hw:number, hh:number, hd:number,
-    front_tex:WebGLTexture, back_tex:WebGLTexture,
-    spine_tex:WebGLTexture | null, page_tex:WebGLTexture,
-):FaceData[] {
-    return [
-        // Front (z = +hd)
-        make_face([
-            [-hw,  hh, hd,  0, 0],
-            [ hw,  hh, hd,  1, 0],
-            [ hw, -hh, hd,  1, 1],
-            [-hw, -hh, hd,  0, 1],
-        ], 0, 0, 1, front_tex),
-
-        // Back (z = -hd)
-        make_face([
-            [ hw,  hh,-hd,  0, 0],
-            [-hw,  hh,-hd,  1, 0],
-            [-hw, -hh,-hd,  1, 1],
-            [ hw, -hh,-hd,  0, 1],
-        ], 0, 0,-1, back_tex),
-
-        // Spine (x = -hw)
-        make_face([
-            [-hw,  hh,-hd,  0, 0],
-            [-hw,  hh, hd,  1, 0],
-            [-hw, -hh, hd,  1, 1],
-            [-hw, -hh,-hd,  0, 1],
-        ],-1, 0, 0, spine_tex, PAGE_COLOR),
-
-        // Fore-edge (x = +hw)
-        make_face([
-            [ hw,  hh, hd,  0, 0],
-            [ hw,  hh,-hd,  0, 1],
-            [ hw, -hh,-hd,  1, 1],
-            [ hw, -hh, hd,  1, 0],
-        ], 1, 0, 0, page_tex),
-
-        // Top (y = +hh)
-        make_face([
-            [-hw,  hh, hd,  0, 0],
-            [ hw,  hh, hd,  1, 0],
-            [ hw,  hh,-hd,  1, 1],
-            [-hw,  hh,-hd,  0, 1],
-        ], 0, 1, 0, page_tex),
-
-        // Bottom (y = -hh)
-        make_face([
-            [-hw, -hh,-hd,  0, 0],
-            [ hw, -hh,-hd,  1, 0],
-            [ hw, -hh, hd,  1, 1],
-            [-hw, -hh, hd,  0, 1],
-        ], 0,-1, 0, page_tex),
-    ]
-}
-
-/** Build faces for a hardcover book with accurate interior trim vs cover trim.
- *  Cover panels use full SVG dimensions; page block is inset by board overhang/thickness.
- *  Front and back boards are separate (not connected at the fore-edge).
- *  Board edge colour is sampled from the cover textures (material wraps around). */
-function build_hardcover(
-    hw:number, hh:number, hd:number,
-    front_tex:WebGLTexture, back_tex:WebGLTexture,
-    spine_tex:WebGLTexture | null, page_tex:WebGLTexture,
-):FaceData[] {
-
-    // Page block extents — all four boards consume BOARD_THICKNESS, interior shifts/moves intact
-    const py = hh - BOARD_EXTEND     // page half-height (top/bottom inset)
-    const pz = hd - BOARD_THICKNESS  // page half-depth (front/back boards consume thickness)
-    const sx = -hw + BOARD_THICKNESS  // page block left edge (spine board pushes it right)
-    const fx =  hw - BOARD_EXTEND    // page block right edge (fore-edge inset)
-
-    // UV sample points for board edges — sample near corners of the cover textures
-    // where solid background colour is most likely.
-    // Front cover: u=0 is spine, u=1 is fore-edge, v=0 is top, v=1 is bottom
-    const f_uv:[number,number] = [0.98, 0.98]
-    // Back cover: u=0 is fore-edge, u=1 is spine
-    const b_uv:[number,number] = [0.02, 0.98]
-    // Spine board surfaces — sample spine texture center, fall back to front cover spine edge
-    const cloth_tex = spine_tex ?? front_tex
-    const s_uv:[number,number] = spine_tex ? [0.5, 0.5] : [0.02, 0.5]
-
-    const faces:FaceData[] = []
-
-    // -- Cover panels (full size from SVG) --
-
-    // Front cover (z = +hd)
-    faces.push(make_face([
-        [-hw,  hh, hd,  0, 0],
-        [ hw,  hh, hd,  1, 0],
-        [ hw, -hh, hd,  1, 1],
-        [-hw, -hh, hd,  0, 1],
-    ], 0, 0, 1, front_tex))
-
-    // Back cover (z = -hd)
-    faces.push(make_face([
-        [ hw,  hh,-hd,  0, 0],
-        [-hw,  hh,-hd,  1, 0],
-        [-hw, -hh,-hd,  1, 1],
-        [ hw, -hh,-hd,  0, 1],
-    ], 0, 0,-1, back_tex))
-
-    // Spine (x = -hw) — full cover height and depth
-    faces.push(make_face([
-        [-hw,  hh,-hd,  0, 0],
-        [-hw,  hh, hd,  1, 0],
-        [-hw, -hh, hd,  1, 1],
-        [-hw, -hh,-hd,  0, 1],
-    ],-1, 0, 0, spine_tex, PAGE_COLOR))
-
-    // -- Page block (inset from cover) --
-
-    // Page fore-edge (x = +fx) — page block right edge
-    faces.push(make_face([
-        [ fx,  py, pz,  0, 0],
-        [ fx,  py,-pz,  0, 1],
-        [ fx, -py,-pz,  1, 1],
-        [ fx, -py, pz,  1, 0],
-    ], 1, 0, 0, page_tex))
-
-    // Page top (y = +py) — spine board inner edge to page fore-edge
-    faces.push(make_face([
-        [ sx,  py, pz,  0, 0],
-        [ fx,  py, pz,  1, 0],
-        [ fx,  py,-pz,  1, 1],
-        [ sx,  py,-pz,  0, 1],
-    ], 0, 1, 0, page_tex))
-
-    // Page bottom (y = -py) — spine board inner edge to page fore-edge
-    faces.push(make_face([
-        [ sx, -py,-pz,  0, 0],
-        [ fx, -py,-pz,  1, 0],
-        [ fx, -py, pz,  1, 1],
-        [ sx, -py, pz,  0, 1],
-    ], 0,-1, 0, page_tex))
-
-    // -- Fore-edge board strips (at x = +hw, facing +x) --
-    // Front and back boards are independent — gap between them is open (no connection)
-
-    // Front board edge (full height, z from +pz to +hd)
-    faces.push(make_face([
-        [ hw,  hh, hd,   f_uv[0], f_uv[1]],
-        [ hw,  hh, pz,   f_uv[0], f_uv[1]],
-        [ hw, -hh, pz,   f_uv[0], f_uv[1]],
-        [ hw, -hh, hd,   f_uv[0], f_uv[1]],
-    ], 1, 0, 0, front_tex))
-
-    // Back board edge (full height, z from -hd to -pz)
-    faces.push(make_face([
-        [ hw,  hh,-pz,   b_uv[0], b_uv[1]],
-        [ hw,  hh,-hd,   b_uv[0], b_uv[1]],
-        [ hw, -hh,-hd,   b_uv[0], b_uv[1]],
-        [ hw, -hh,-pz,   b_uv[0], b_uv[1]],
-    ], 1, 0, 0, back_tex))
-
-    // -- Top board strips (at y = +hh, facing +y) --
-
-    // Front board top (full width, z from +pz to +hd)
-    faces.push(make_face([
-        [-hw,  hh, hd,   f_uv[0], f_uv[1]],
-        [ hw,  hh, hd,   f_uv[0], f_uv[1]],
-        [ hw,  hh, pz,   f_uv[0], f_uv[1]],
-        [-hw,  hh, pz,   f_uv[0], f_uv[1]],
-    ], 0, 1, 0, front_tex))
-
-    // Back board top (full width, z from -hd to -pz)
-    faces.push(make_face([
-        [-hw,  hh,-pz,   b_uv[0], b_uv[1]],
-        [ hw,  hh,-pz,   b_uv[0], b_uv[1]],
-        [ hw,  hh,-hd,   b_uv[0], b_uv[1]],
-        [-hw,  hh,-hd,   b_uv[0], b_uv[1]],
-    ], 0, 1, 0, back_tex))
-
-
-    // -- Bottom board strips (at y = -hh, facing -y) --
-
-    // Front board bottom (full width, z from +pz to +hd)
-    faces.push(make_face([
-        [-hw, -hh, pz,   f_uv[0], f_uv[1]],
-        [ hw, -hh, pz,   f_uv[0], f_uv[1]],
-        [ hw, -hh, hd,   f_uv[0], f_uv[1]],
-        [-hw, -hh, hd,   f_uv[0], f_uv[1]],
-    ], 0,-1, 0, front_tex))
-
-    // Back board bottom (full width, z from -hd to -pz)
-    faces.push(make_face([
-        [-hw, -hh,-hd,   b_uv[0], b_uv[1]],
-        [ hw, -hh,-hd,   b_uv[0], b_uv[1]],
-        [ hw, -hh,-pz,   b_uv[0], b_uv[1]],
-        [-hw, -hh,-pz,   b_uv[0], b_uv[1]],
-    ], 0,-1, 0, back_tex))
-
-    // -- Spine board surfaces --
-    // The spine board has thickness BOARD_THICKNESS (sx - (-hw)).
-    // Its outer face is the spine panel already rendered above.
-    // These faces close the top, bottom, and inner ledges of the spine board.
-
-    // Spine board top (y = +hh, x from -hw to sx, z from -pz to +pz)
-    faces.push(make_face([
-        [-hw,  hh, pz,   s_uv[0], s_uv[1]],
-        [ sx,  hh, pz,   s_uv[0], s_uv[1]],
-        [ sx,  hh,-pz,   s_uv[0], s_uv[1]],
-        [-hw,  hh,-pz,   s_uv[0], s_uv[1]],
-    ], 0, 1, 0, cloth_tex))
-
-    // Spine board bottom (y = -hh, x from -hw to sx, z from -pz to +pz)
-    faces.push(make_face([
-        [-hw, -hh,-pz,   s_uv[0], s_uv[1]],
-        [ sx, -hh,-pz,   s_uv[0], s_uv[1]],
-        [ sx, -hh, pz,   s_uv[0], s_uv[1]],
-        [-hw, -hh, pz,   s_uv[0], s_uv[1]],
-    ], 0,-1, 0, cloth_tex))
-
-    // Spine board inner ledge top (y = +py, x from -hw to sx) — closes gap at page level
-    faces.push(make_face([
-        [-hw,  py, pz,   s_uv[0], s_uv[1]],
-        [ sx,  py, pz,   s_uv[0], s_uv[1]],
-        [ sx,  py,-pz,   s_uv[0], s_uv[1]],
-        [-hw,  py,-pz,   s_uv[0], s_uv[1]],
-    ], 0, 1, 0, cloth_tex))
-
-    // Spine board inner ledge bottom (y = -py, x from -hw to sx)
-    faces.push(make_face([
-        [-hw, -py,-pz,   s_uv[0], s_uv[1]],
-        [ sx, -py,-pz,   s_uv[0], s_uv[1]],
-        [ sx, -py, pz,   s_uv[0], s_uv[1]],
-        [-hw, -py, pz,   s_uv[0], s_uv[1]],
-    ], 0,-1, 0, cloth_tex))
-
-    return faces
-}
-
-/** Build all faces of the book using normalised dimensions (h = 1).
- *  w = cover_width / cover_height, d = spine_width / cover_height. */
-export function build_faces(
-    w:number,
-    h:number,
-    d:number,
-    front_tex:WebGLTexture,
-    back_tex:WebGLTexture,
-    spine_tex:WebGLTexture | null,
-    cover_type:CoverType,
-    page_tex:WebGLTexture,
-):FaceData[] {
-
-    // Half-extents
-    const hw = w / 2, hh = h / 2, hd = d / 2
-
-    if (cover_type === 'hardcover' || cover_type === 'hardcover_jacket')
-        return build_hardcover(hw, hh, hd, front_tex, back_tex, spine_tex, page_tex)
-
-    if (cover_type === 'paperback_stitch')
-        return build_stitch(hw, hh, hd, front_tex, back_tex, spine_tex, page_tex)
-
-    const faces = build_paperback(hw, hh, hd, front_tex, back_tex, spine_tex, page_tex)
-
-    // Coil and wire bindings get painted-on holes near the spine edge
-    if (cover_type === 'paperback_coil' || cover_type === 'paperback_wire')
-        faces.push(...build_holes(hw, hh, hd))
-
-    return faces
-}