postext-folio 0.1.2 → 0.2.0

package/README.md

@@ -45,6 +45,43 @@ Pages are painted with `renderPageToCanvas` at exactly the device pixels of a pa
 
 The container sets the size: the book fills it, with the ‹ › buttons and the page count in the margins. Give it a height. A resize paints the pages again at the new size.
 
+## The book on the desk
+
+The book lies open on a desk, seen from in front and a little above (the foot of the pages comes closer), lit by an environment that glossy paper reflects as a leaf curls, and by a key light that casts the shadows. The pages already read and those still to come form two blocks of real thickness: leaf count × the paper's caliper, with the book's other chapters counted in (`extraPages`). They are never painted, only counted. The open pages curve down into the gutter, and the darker gutter comes from the occlusion of that shape, not from a painted gradient. Each leaf bends according to its paper's stiffness: bible paper rolls tight, card turns in a wide arc, and board turns as a rigid plate on its hinge.
+
+All of this is set with postext's `folio` config, read from `doc.config.folio` or passed as `appearance`:
+
+```ts
+const book = createFolioFromDocument(container, doc, {
+  appearance: {
+    folio: {
+      tilt: 22, // degrees from straight above, 0 … 40
+      paper: { type: 'bookWove', grammage: 80, texture: 'laid' },
+      binding: { type: 'hardcover', coverColor: { hex: '#5a1f1f', model: 'hex' } },
+      surface: { type: 'walnut' },
+      lighting: { environment: 'lamp', intensity: 1 },
+    },
+  },
+});
+book.setAppearance({ folio: { lighting: { environment: 'daylight' } } });
+```
+
+<table>
+<thead><tr><th>Setting</th><th>Values</th></tr></thead>
+<tbody>
+<tr><td><code>paper.type</code></td><td><code>uncoated</code> (woodfree offset, 90 g/m²), <code>bookWove</code> (bulky cream, 80 g/m²), <code>coatedMatte</code>, <code>coatedSilk</code>, <code>coatedGloss</code> (115 g/m²), <code>bible</code> (40 g/m²), <code>newsprint</code>, <code>cardStock</code> (250 g/m²), <code>board</code> (rigid, about 2 mm). Each sets the defaults below.</td></tr>
+<tr><td><code>paper.grammage</code>, <code>paper.bulk</code></td><td>g/m² and cm³/g; caliper µm = grammage × bulk. Thickness, stiffness (∝ caliper^⅔ for the roll) and opacity follow.</td></tr>
+<tr><td><code>paper.finish</code></td><td><code>uncoated</code> | <code>matte</code> | <code>silk</code> | <code>gloss</code>: roughness and clear coat.</td></tr>
+<tr><td><code>paper.texture</code>, <code>paper.textureStrength</code></td><td><code>smooth</code> | <code>vellum</code> | <code>wove</code> | <code>laid</code> | <code>linen</code> | <code>felt</code>, as a normal map at physical scale; strength 0 … 2.</td></tr>
+<tr><td><code>paper.shade</code>, <code>paper.showThrough</code></td><td>The stock's colour (pages are printed on it); the reverse page showing faintly through thin paper.</td></tr>
+<tr><td><code>binding.type</code></td><td><code>hardcover</code> (boards with squares) | <code>paperback</code> (opens less flat) | <code>sewn</code> | <code>layflat</code>; plus <code>coverMaterial</code> (cloth, paper, leather) and <code>coverColor</code>.</td></tr>
+<tr><td><code>surface.type</code></td><td><code>oak</code> | <code>walnut</code> | <code>linen</code> | <code>felt</code> | <code>leather</code> | <code>marble</code> | <code>plain</code> | <code>none</code> (the host's background, with the book's shadow); <code>color</code> tints it.</td></tr>
+<tr><td><code>lighting</code></td><td><code>environment</code>: <code>studio</code> | <code>daylight</code> | <code>lamp</code> | <code>overcast</code> | <code>night</code>; <code>intensity</code> 0.25 … 2; <code>shadows</code>.</td></tr>
+</tbody>
+</table>
+
+A `:::paper{type=coatedGloss}` run in the markdown (a plate section, say) stamps its pages with their own stock; the viewer gives those leaves that paper's look, thickness and stiffness. With `createFolio`, a page may carry its own `paper` the same way: `{ src, paper: { type: 'coatedGloss' } }`.
+
 ## Page images
 
 `createFolio` takes any pages: image URLs, `<canvas>` or `<img>` elements, `""` for a blank page.
@@ -65,10 +102,11 @@ book.goToPage(2);
 <table>
 <thead><tr><th>Export</th><th>What it does</th></tr></thead>
 <tbody>
-<tr><td><code>createFolio(container, options)</code></td><td>The viewer over any pages. Options: <code>pages</code>, <code>firstPageRecto</code> (default true), <code>binding</code> (<code>'left'</code> | <code>'right'</code>), <code>at</code> (page to open on), <code>mode</code> (<code>'auto'</code> | <code>'single'</code> | <code>'double'</code>; auto shows one page at a time below 560 px), <code>paper</code> (blank-page colour), <code>animate</code>, <code>controls</code>, <code>showCount</code> (false keeps the count for screen readers only), <code>labels</code>, <code>onChange</code>, <code>onTarget</code>, <code>onLayout</code>. One page at a time the book is WebGL too: the spine runs along the page's inner edge and the leaf turns over it; a drag towards the spine turns forward, a swipe away from it goes back, a tap turns.</td></tr>
+<tr><td><code>createFolio(container, options)</code></td><td>The viewer over any pages. Options: <code>pages</code>, <code>firstPageRecto</code> (default true), <code>binding</code> (<code>'left'</code> | <code>'right'</code>), <code>at</code> (page to open on), <code>mode</code> (<code>'auto'</code> | <code>'single'</code> | <code>'double'</code>; auto shows one page at a time below 560 px), <code>paper</code> (blank-page colour), <code>animate</code>, <code>controls</code>, <code>showCount</code> (false keeps the count for screen readers only), <code>labels</code>, <code>appearance</code> (<code>folio</code>, <code>pageWidthMm</code>, <code>extraPages</code>), <code>onChange</code>, <code>onTarget</code>, <code>onLayout</code>. One page at a time the book is WebGL too: the spine runs along the page's inner edge and the leaf turns over it; a drag towards the spine turns forward, a swipe away from it goes back, a tap turns.</td></tr>
 <tr><td><code>createFolioFromDocument(container, doc, options)</code></td><td>The same over a postext <code>VDTDocument</code>, painted lazily. Spreads, binding and paper come from the document. Adds <code>scale</code>, <code>window</code>, <code>singleInk</code>, <code>pageNegative</code>, <code>alt</code>, and <code>setDocument(doc)</code> on the viewer.</td></tr>
-<tr><td>viewer</td><td><code>goToPage(i, { instant })</code>, <code>goToSpread(i, { instant })</code> (instant opens there without turning), <code>next()</code>, <code>prev()</code>, <code>setPages(pages, opts)</code>, <code>setLabels(labels)</code>, <code>state</code> (<code>{ spread, pages }</code>), <code>element</code>, <code>dispose()</code>.</td></tr>
-<tr><td><code>PageFlipper</code>, <code>canFlip()</code></td><td>The three.js engine alone, for a host that lays out its own spread DOM (as the postext Cookbook does): a canvas over the spread, <code>go(i)</code>, <code>grab</code>/<code>drag</code>/<code>release</code> for the hand, <code>setBook</code>, <code>clear</code>, <code>dispose</code>; <code>{ persistent: true }</code> draws the book at rest too, <code>turnAt</code> sets how far a leaf let go must be to turn over.</td></tr>
+<tr><td>viewer</td><td><code>goToPage(i, { instant })</code>, <code>goToSpread(i, { instant })</code> (instant opens there without turning), <code>next()</code>, <code>prev()</code>, <code>setPages(pages, opts)</code>, <code>setLabels(labels)</code>, <code>setAppearance(appearance)</code>, <code>state</code> (<code>{ spread, pages }</code>), <code>element</code>, <code>dispose()</code>.</td></tr>
+<tr><td><code>PageFlipper</code>, <code>canFlip()</code></td><td>The three.js engine alone: a canvas over a host's spread, <code>go(i)</code>, <code>grab</code>/<code>drag</code>/<code>release</code> for the hand (ray-cast onto the tilted pages), <code>hit</code>, <code>setBook</code>, <code>setAppearance</code>, <code>clear</code>, <code>dispose</code>; <code>{ persistent: true }</code> draws the book at rest too, <code>turnAt</code> sets how far a leaf let go must be to turn over.</td></tr>
+<tr><td><code>FlatPageFlipper</code></td><td>The flat page-turn that predates the 3D book, for a host whose DOM spread shows the pages at rest and must match the turning leaf pixel for pixel (the postext Cookbook's light table).</td></tr>
 <tr><td><code>spreadsOf(count, firstPageRecto)</code></td><td>The <code>[verso, recto]</code> pairs of a book.</td></tr>
 <tr><td><code>FOLIO_CSS</code></td><td>The viewer's styles (injected once on first use). Restyle with <code>--postext-folio-accent</code> and <code>--postext-folio-nav-border</code> on the container.</td></tr>
 </tbody>
@@ -76,6 +114,23 @@ book.goToPage(2);
 
 The viewer takes the keyboard when focused: ←/→ (mirrored for a right-bound book), Page Up/Down, Home and End. Its labels default to English; pass `labels` (`region`, `prev`, `next`, `count`) to translate them.
 
+## Desk textures
+
+The photographed desk surfaces served from postext.dev (`/folio/textures/`, with a `manifest.json` and a `CREDITS` file) are CC0 texture sets, resized and re-encoded for the web. No attribution is required; thanks to their authors:
+
+<table>
+<thead><tr><th>Desk</th><th>Set</th><th>Author</th><th>Source</th></tr></thead>
+<tbody>
+<tr><td>oak</td><td>Oak Veneer 01</td><td>Jenelle van Heerden</td><td><a href="https://polyhaven.com/a/oak_veneer_01">Poly Haven</a></td></tr>
+<tr><td>walnut</td><td>Wood 051</td><td>Lennart Demes</td><td><a href="https://ambientcg.com/view?id=Wood051">ambientCG</a></td></tr>
+<tr><td>linen</td><td>Fabric 036</td><td>Lennart Demes</td><td><a href="https://ambientcg.com/view?id=Fabric036">ambientCG</a></td></tr>
+<tr><td>felt</td><td>Fabric 034</td><td>Lennart Demes</td><td><a href="https://ambientcg.com/view?id=Fabric034">ambientCG</a></td></tr>
+<tr><td>leather</td><td>Brown Leather</td><td>Rob Tuytel</td><td><a href="https://polyhaven.com/a/brown_leather">Poly Haven</a></td></tr>
+<tr><td>marble</td><td>Marble 021</td><td>Lennart Demes</td><td><a href="https://ambientcg.com/view?id=Marble021">ambientCG</a></td></tr>
+<tr><td>plain</td><td>Plastic 013 A</td><td>Lennart Demes</td><td><a href="https://ambientcg.com/view?id=Plastic013A">ambientCG</a></td></tr>
+</tbody>
+</table>
+
 ## License
 
-MIT
+MIT (code). The desk textures above are CC0.

package/dist/bookGeometry.d.ts

@@ -0,0 +1,77 @@
+import { BufferGeometry } from "three";
+export type BindingKind = "hardcover" | "paperback" | "sewn" | "layflat" | "saddleStitch";
+/** How each binding opens. `gutter`: the width over which the pages bend
+ *  into the spine (a fraction of the page width, plus `perThickness` × the
+ *  block's thickness); `spine`: how near the top of the thicker stack the
+ *  top leaves meet (1: at its top); `power`: how steeply they drop at the end;
+ *  `dipMm`: how far below that a thin book's pages still sink; the case's
+ *  boards and their squares (the margin they stand out round the pages). */
+export declare const BINDINGS: Record<BindingKind, {
+    gutter: number;
+    perThickness: number;
+    spine: number;
+    power: number;
+    dipMm: number;
+    boardMm: number;
+    squareMm: number;
+    jointMm: number;
+}>;
+/** A side's top surface: `x(s)`, `z(s)` for arc length `s` from the spine
+ *  (a page keeps its width as it bends), and the slope. */
+export interface Profile {
+    /** Thickness of the stack (book units). */
+    t: number;
+    /** Height of the block's base (the top of the cover under it). */
+    zb: number;
+    /** Height the top leaf meets the spine at, above zb. */
+    meet: number;
+    /** Width of the bend. */
+    g: number;
+    power: number;
+    /** Arc-length table: x and z every `step` of s. */
+    xs: Float32Array;
+    zs: Float32Array;
+    step: number;
+}
+/**
+ * The open book's two surfaces. Every leaf is sewn at the spine, so the top
+ * leaves of both stacks meet there, at a height between the two stacks
+ * (lower for a binding that opens less freely, minus a dip so even a thin
+ * book sinks into its gutter); away from the spine each lies on its
+ * stack. A stack's lower leaves follow the same curve scaled down to the
+ * cover, so the block's head and tail show the fan of leaves.
+ */
+export declare function profiles(binding: BindingKind, W: number, pxPerMm: number, tLeft: number, tRight: number, 
+/** `flat`: a side whose top leaf is rigid (a board) lies flat, with no
+ *  gutter; `noCase`: the boards are leaves of the stacks (the document's
+ *  own cover pages), so the block rests on the desk. */
+{ flatLeft, flatRight, noCase }?: {
+    flatLeft?: boolean;
+    flatRight?: boolean;
+    noCase?: boolean;
+}): {
+    left: Profile;
+    right: Profile;
+    board: number;
+};
+/** Where arc length `s` of a profile lies: [x, z, dz/dx]. */
+export declare function along(p: Profile, s: number): [number, number, number];
+/** A lower leaf (fraction `lambda` of the way up the stack) at arc
+ *  length s, approximately: the top curve scaled down to the base. */
+export declare function alongLayer(p: Profile, s: number, lambda: number): [number, number];
+/**
+ * Ambient light reaching each point of the open pages, from the shape of
+ * the book's cross-section: the fraction of the sky (cosine weighted) the
+ * other page and the gutter leave open. This is the darkening along the
+ * gutter, found from the geometry rather than painted. `n` samples across
+ * one page, from the spine out.
+ */
+export declare function gutterOcclusion(own: Profile, other: Profile, W: number, n?: number): Float32Array;
+/**
+ * The page block's visible sides for one stack: the head and tail (the
+ * fan of leaves between the cover and the top leaf) and the fore-edge.
+ * Each vertex carries `layer`: the leaf it lies on, counted up from the
+ * cover, so the shader draws the edges of the leaves.
+ */
+export declare function stackGeometry(p: Profile, side: 1 | -1, W: number, H: number, leaves: number): BufferGeometry;
+//# sourceMappingURL=bookGeometry.d.ts.map

package/dist/bookGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookGeometry.d.ts","sourceRoot":"","sources":["../src/bookGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,cAAc,EAAE,MAAM,OAAO,CAAC;AAMxD,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,CAAC;AAE1F;;;;;4EAK4E;AAC5E,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAQnL,CAAC;AAEF;2DAC2D;AAC3D,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,EAAE,EAAE,YAAY,CAAC;IACjB,EAAE,EAAE,YAAY,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAaD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,WAAW,EACpB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;AACd;;wDAEwD;AACxD,EAAE,QAAgB,EAAE,SAAiB,EAAE,MAAc,EAAE,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1H;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6ClD;AAED,6DAA6D;AAC7D,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQrE;AAED;sEACsE;AACtE,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGlF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,SAAK,GAAG,YAAY,CA8B7F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CA+D5G"}

package/dist/bookGeometry.js

@@ -0,0 +1,204 @@
+import { BufferAttribute, BufferGeometry } from "three";
+/** How each binding opens. `gutter`: the width over which the pages bend
+ *  into the spine (a fraction of the page width, plus `perThickness` × the
+ *  block's thickness); `spine`: how near the top of the thicker stack the
+ *  top leaves meet (1: at its top); `power`: how steeply they drop at the end;
+ *  `dipMm`: how far below that a thin book's pages still sink; the case's
+ *  boards and their squares (the margin they stand out round the pages). */
+export const BINDINGS = {
+    hardcover: { gutter: 0.06, perThickness: 0.9, spine: 1, power: 2.4, dipMm: 3, boardMm: 2.6, squareMm: 3, jointMm: 7 },
+    sewn: { gutter: 0.07, perThickness: 1.0, spine: 0.95, power: 2.5, dipMm: 3.5, boardMm: 0.35, squareMm: 0, jointMm: 0 },
+    paperback: { gutter: 0.1, perThickness: 1.2, spine: 0.85, power: 3, dipMm: 5, boardMm: 0.35, squareMm: 0, jointMm: 0 },
+    layflat: { gutter: 0.025, perThickness: 0.4, spine: 1, power: 2, dipMm: 0.2, boardMm: 2.2, squareMm: 3, jointMm: 4 },
+    // Folded sheets stapled through the fold: the centre spread opens flat,
+    // the cover is a sheet like the others.
+    saddleStitch: { gutter: 0.05, perThickness: 1.4, spine: 0.9, power: 2.2, dipMm: 1.5, boardMm: 0.25, squareMm: 0, jointMm: 0 },
+};
+const SAMPLES = 256;
+/** The top leaf of a stack `t` thick at height above the base, at x. */
+function heightAt(p, x, lambda = 1) {
+    // A block's top is flat and its leaves roll over a rounded shoulder into
+    // the binding (a quarter superellipse: level where it leaves the top,
+    // steep at the spine), not a long slope across the page.
+    const shape = x < p.g ? Math.pow(1 - Math.pow(1 - x / p.g, p.power), 1 / p.power) : 1;
+    return lambda * (p.meet + (p.t - p.meet) * shape);
+}
+/**
+ * The open book's two surfaces. Every leaf is sewn at the spine, so the top
+ * leaves of both stacks meet there, at a height between the two stacks
+ * (lower for a binding that opens less freely, minus a dip so even a thin
+ * book sinks into its gutter); away from the spine each lies on its
+ * stack. A stack's lower leaves follow the same curve scaled down to the
+ * cover, so the block's head and tail show the fan of leaves.
+ */
+export function profiles(binding, W, pxPerMm, tLeft, tRight, 
+/** `flat`: a side whose top leaf is rigid (a board) lies flat, with no
+ *  gutter; `noCase`: the boards are leaves of the stacks (the document's
+ *  own cover pages), so the block rests on the desk. */
+{ flatLeft = false, flatRight = false, noCase = false } = {}) {
+    const b = BINDINGS[binding];
+    const zb = noCase ? 0 : b.boardMm * pxPerMm;
+    // Where the two top leaves meet at the spine. They are sewn next to each
+    // other on the block's back, near the top of the thicker stack: a book
+    // opened at its first page keeps its block flat and only rolls the top
+    // leaf a little into the gutter. The valley deepens as pages pile up on
+    // the other side and pull the spine down (by the binding's own dip and
+    // a share of the thinner stack).
+    const low = Math.min(tLeft, tRight);
+    const high = Math.max(tLeft, tRight);
+    const dip = (b.dipMm * pxPerMm + 0.35 * low) * (binding === "layflat" ? 0.1 : 1);
+    const meet = Math.max(0, low + (high - low) * b.spine - dip);
+    const make = (t, flat) => {
+        // The shoulder is as wide as the leaves have to drop (or rise) to the
+        // binding, plus the binding's own bend.
+        const side = Math.min(0.3 * W, b.gutter * W * 0.6 + 1.2 * Math.abs(t - meet));
+        const p = { t, meet: flat ? t : meet, g: Math.max(side, 0.02 * W), power: b.power };
+        // Arc length along x, then x and z at even steps of arc length.
+        const fine = SAMPLES * 4;
+        const dx = (1.2 * W) / fine;
+        const sx = [0];
+        const sz = [heightAt(p, 0)];
+        const ss = [0];
+        for (let i = 1; i <= fine; i++) {
+            const x = i * dx;
+            const z = heightAt(p, x);
+            ss.push(ss[i - 1] + Math.hypot(dx, z - sz[i - 1]));
+            sx.push(x);
+            sz.push(z);
+        }
+        const step = (1.1 * W) / SAMPLES;
+        const xs = new Float32Array(SAMPLES + 1);
+        const zs = new Float32Array(SAMPLES + 1);
+        let j = 0;
+        for (let i = 0; i <= SAMPLES; i++) {
+            const s = i * step;
+            while (j < fine - 1 && ss[j + 1] < s)
+                j++;
+            const f = Math.min(1, Math.max(0, (s - ss[j]) / (ss[j + 1] - ss[j] || 1)));
+            xs[i] = sx[j] + (sx[j + 1] - sx[j]) * f;
+            zs[i] = zb + sz[j] + (sz[j + 1] - sz[j]) * f;
+        }
+        return { ...p, zb, xs, zs, step };
+    };
+    return { left: make(tLeft, flatLeft), right: make(tRight, flatRight), board: zb };
+}
+/** Where arc length `s` of a profile lies: [x, z, dz/dx]. */
+export function along(p, s) {
+    const f = Math.max(0, s) / p.step;
+    const i = Math.min(p.xs.length - 2, Math.floor(f));
+    const t = Math.min(1.5, f - i);
+    const x = p.xs[i] + (p.xs[i + 1] - p.xs[i]) * t;
+    const z = p.zs[i] + (p.zs[i + 1] - p.zs[i]) * t;
+    const slope = (p.zs[i + 1] - p.zs[i]) / (p.xs[i + 1] - p.xs[i] || 1e-6);
+    return [x, z, slope];
+}
+/** A lower leaf (fraction `lambda` of the way up the stack) at arc
+ *  length s, approximately: the top curve scaled down to the base. */
+export function alongLayer(p, s, lambda) {
+    const [x] = along(p, s);
+    return [x, p.zb + heightAt(p, x, lambda)];
+}
+/**
+ * Ambient light reaching each point of the open pages, from the shape of
+ * the book's cross-section: the fraction of the sky (cosine weighted) the
+ * other page and the gutter leave open. This is the darkening along the
+ * gutter, found from the geometry rather than painted. `n` samples across
+ * one page, from the spine out.
+ */
+export function gutterOcclusion(own, other, W, n = 64) {
+    const out = new Float32Array(n + 1);
+    // Occluders: the other page's surface (at negative x) and this page's own
+    // surface between the point and the spine.
+    const pts = [];
+    for (let i = 0; i <= 96; i++) {
+        const [x, z] = along(other, (i / 96) * W);
+        pts.push([-x, z]);
+    }
+    const ownPts = [];
+    for (let i = 0; i <= 96; i++) {
+        const [x, z] = along(own, (i / 96) * W);
+        ownPts.push([x, z]);
+    }
+    for (let k = 0; k <= n; k++) {
+        const [x, z, slope] = along(own, (k / n) * W);
+        const tau = Math.atan(slope);
+        // Highest elevation (angle from +x) of an occluder towards the spine.
+        let spine = 0;
+        for (const [px, pz] of pts)
+            spine = Math.max(spine, Math.atan2(pz - z, x - px));
+        for (const [px, pz] of ownPts)
+            if (px < x - 1e-3)
+                spine = Math.max(spine, Math.atan2(pz - z, x - px));
+        // Towards the fore-edge the page's own surface, if it rises.
+        let fore = tau;
+        for (const [px, pz] of ownPts)
+            if (px > x + 1e-3)
+                fore = Math.max(fore, Math.atan2(pz - z, px - x));
+        const nAngle = tau + Math.PI / 2;
+        const a = Math.max(tau, fore);
+        const b = Math.min(tau + Math.PI, Math.PI - spine);
+        out[k] = b > a ? Math.max(0, (Math.sin(b - nAngle) - Math.sin(a - nAngle)) / 2) : 0;
+    }
+    return out;
+}
+/**
+ * The page block's visible sides for one stack: the head and tail (the
+ * fan of leaves between the cover and the top leaf) and the fore-edge.
+ * Each vertex carries `layer`: the leaf it lies on, counted up from the
+ * cover, so the shader draws the edges of the leaves.
+ */
+export function stackGeometry(p, side, W, H, leaves) {
+    const NS = 48;
+    const NL = Math.max(2, Math.min(24, leaves + 1));
+    const pos = [];
+    const nrm = [];
+    const layer = [];
+    const lam = [];
+    const idx = [];
+    const quadGrid = (cols, rows, at, normal, flip) => {
+        const base = pos.length / 3;
+        for (let r = 0; r <= rows; r++)
+            for (let c = 0; c <= cols; c++) {
+                const [x, y, z, l] = at(c, r);
+                pos.push(x, y, z);
+                nrm.push(...normal);
+                layer.push(l);
+                lam.push(leaves > 0 ? l / leaves : r / Math.max(1, rows));
+            }
+        for (let r = 0; r < rows; r++)
+            for (let c = 0; c < cols; c++) {
+                const a = base + r * (cols + 1) + c;
+                const b = a + 1;
+                const d = a + cols + 1;
+                const e = d + 1;
+                if (flip)
+                    idx.push(a, d, b, b, d, e);
+                else
+                    idx.push(a, b, d, b, e, d);
+            }
+    };
+    for (const end of [1, -1]) {
+        // Head (y = H/2, facing +y) and tail (facing −y).
+        quadGrid(NS, NL - 1, (c, r) => {
+            const lambda = r / (NL - 1);
+            const [x, z] = alongLayer(p, (c / NS) * W, lambda);
+            return [side * x, (end * H) / 2, z, lambda * leaves];
+        }, [0, end, 0], (end > 0) !== (side > 0));
+    }
+    // The fore-edge: each leaf ends where its arc length runs out.
+    quadGrid(1, NL - 1, (c, r) => {
+        const lambda = r / (NL - 1);
+        const [x, z] = alongLayer(p, W, lambda);
+        return [side * x, (c ? -1 : 1) * (H / 2), z, lambda * leaves];
+    }, [side, 0, 0], side < 0);
+    const g = new BufferGeometry();
+    g.setAttribute("position", new BufferAttribute(new Float32Array(pos), 3));
+    g.setAttribute("normal", new BufferAttribute(new Float32Array(nrm), 3));
+    g.setAttribute("layer", new BufferAttribute(new Float32Array(layer), 1));
+    // How far up the block (0 at its base, 1 at its top), for the bands a
+    // board takes in it.
+    g.setAttribute("lambda", new BufferAttribute(new Float32Array(lam), 1));
+    g.setIndex(idx);
+    return g;
+}
+//# sourceMappingURL=bookGeometry.js.map

package/dist/bookGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookGeometry.js","sourceRoot":"","sources":["../src/bookGeometry.ts"],"names":[],"mappings":"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"}

package/dist/deskTextures.d.ts

@@ -0,0 +1,24 @@
+import { type Texture } from "three";
+import type { DeskKind } from "./procedural";
+export type { DeskKind };
+/** A desk surface's image maps and the width of one tile (mm). The colour
+ *  map is sRGB, the others linear; all repeat and carry mipmaps. `tint`
+ *  is the manifest's suggested base colour (to multiply), when it has one. */
+export interface DeskMaps {
+    color: Texture;
+    normal: Texture;
+    roughness: Texture;
+    ao?: Texture;
+    tileMm: number;
+    tint?: string;
+}
+/**
+ * The image maps of a desk surface, from `${baseUrl}/manifest.json` and the
+ * files it lists (paths relative to `baseUrl`). The manifest is fetched once
+ * per `baseUrl` and the maps once per `baseUrl` + kind; every caller of the
+ * same pair shares the same textures, so do not dispose them per mesh.
+ * Anisotropy is left to the caller (it needs the renderer). Resolves null on
+ * any failure, after disposing whatever maps had loaded.
+ */
+export declare function loadDeskMaps(kind: DeskKind, baseUrl: string): Promise<DeskMaps | null>;
+//# sourceMappingURL=deskTextures.d.ts.map

package/dist/deskTextures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deskTextures.d.ts","sourceRoot":"","sources":["../src/deskTextures.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,YAAY,EAAE,QAAQ,EAAE,CAAC;AAQzB;;8EAE8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA4ED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAqBtF"}

package/dist/deskTextures.js

@@ -0,0 +1,88 @@
+import { LinearFilter, LinearMipmapLinearFilter, NoColorSpace, RepeatWrapping, SRGBColorSpace, TextureLoader, } from "three";
+const manifests = new Map();
+const deskMaps = new Map();
+const trimSlash = (url) => url.replace(/\/+$/, "");
+/** Remember a promise, but forget it if it settles on null so a later call
+ *  tries again (a dropped connection should not cost the session its desk). */
+function cached(cache, key, make) {
+    let p = cache.get(key);
+    if (!p) {
+        p = make().catch(() => null);
+        cache.set(key, p);
+        p.then((v) => {
+            if (v === null && cache.get(key) === p)
+                cache.delete(key);
+        });
+    }
+    return p;
+}
+function isManifest(json) {
+    return typeof json === "object" && json !== null && typeof json.kinds === "object" && json.kinds !== null;
+}
+function loadManifest(base) {
+    return cached(manifests, base, async () => {
+        const res = await fetch(`${base}/manifest.json`);
+        if (!res.ok)
+            return null;
+        const json = await res.json();
+        return isManifest(json) ? json : null;
+    });
+}
+function loadTexture(loader, url, srgb) {
+    return new Promise((resolve, reject) => {
+        loader.load(url, (tex) => {
+            tex.colorSpace = srgb ? SRGBColorSpace : NoColorSpace;
+            tex.wrapS = tex.wrapT = RepeatWrapping;
+            tex.generateMipmaps = true;
+            tex.minFilter = LinearMipmapLinearFilter;
+            tex.magFilter = LinearFilter;
+            tex.needsUpdate = true;
+            resolve(tex);
+        }, undefined, reject);
+    });
+}
+function validEntry(entry) {
+    return (!!entry &&
+        typeof entry.files === "object" &&
+        entry.files !== null &&
+        typeof entry.files.color === "string" &&
+        typeof entry.files.normal === "string" &&
+        typeof entry.files.roughness === "string" &&
+        typeof entry.tileMm === "number" &&
+        entry.tileMm > 0);
+}
+/**
+ * The image maps of a desk surface, from `${baseUrl}/manifest.json` and the
+ * files it lists (paths relative to `baseUrl`). The manifest is fetched once
+ * per `baseUrl` and the maps once per `baseUrl` + kind; every caller of the
+ * same pair shares the same textures, so do not dispose them per mesh.
+ * Anisotropy is left to the caller (it needs the renderer). Resolves null on
+ * any failure, after disposing whatever maps had loaded.
+ */
+export function loadDeskMaps(kind, baseUrl) {
+    const base = trimSlash(baseUrl);
+    return cached(deskMaps, `${base}\n${kind}`, async () => {
+        const manifest = await loadManifest(base);
+        const entry = manifest?.kinds[kind];
+        if (!validEntry(entry))
+            return null;
+        const loader = new TextureLoader();
+        const { files } = entry;
+        const urls = [files.color, files.normal, files.roughness, ...(typeof files.ao === "string" ? [files.ao] : [])];
+        const settled = await Promise.allSettled(urls.map((f, i) => loadTexture(loader, `${base}/${f}`, i === 0)));
+        const loaded = settled.flatMap((s) => (s.status === "fulfilled" ? [s.value] : []));
+        if (loaded.length !== urls.length) {
+            for (const t of loaded)
+                t.dispose();
+            return null;
+        }
+        const [color, normal, roughness, ao] = loaded;
+        const maps = { color, normal, roughness, tileMm: entry.tileMm };
+        if (ao)
+            maps.ao = ao;
+        if (typeof entry.tint === "string")
+            maps.tint = entry.tint;
+        return maps;
+    });
+}
+//# sourceMappingURL=deskTextures.js.map

package/dist/deskTextures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deskTextures.js","sourceRoot":"","sources":["../src/deskTextures.ts"],"names":[],"mappings":"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"}

package/dist/environments.d.ts

@@ -0,0 +1,27 @@
+import { Color, Scene, Vector3 } from "three";
+export type EnvironmentKind = "studio" | "daylight" | "lamp" | "overcast" | "night";
+/** A lighting environment: a small scene of emitters the reflections and
+ *  the soft (image-based) light are taken from, and the key light that
+ *  casts the shadows, placed where the scene's brightest emitter is. */
+export interface Environment {
+    scene: Scene;
+    /** Towards the key light (book coordinates: x right, y to the head of
+     *  the page, z up from the desk). */
+    key: Vector3;
+    keyColor: Color;
+    /** The key light's strength. */
+    keyIntensity: number;
+    /** How soft the key light's shadows are (its apparent size, 0 … 1). */
+    softness: number;
+    /** Exposure, so paper at rest reads as its own colour. */
+    exposure: number;
+}
+/**
+ * The environments: a photographer's studio (a large softbox above left,
+ * a fill on the right, a neutral grey room), daylight from a tall window
+ * on the left, a warm reading lamp in a dim room, an even overcast sky,
+ * and night (a lamp, a faint cool window). Coordinates are in book units
+ * where the book is about 2 across, centred at the origin on the desk.
+ */
+export declare function environment(kind: EnvironmentKind): Environment;
+//# sourceMappingURL=environments.d.ts.map

package/dist/environments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,EAIL,KAAK,EAEL,OAAO,EAER,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpF;;wEAEwE;AACxE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb;yCACqC;IACrC,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;IAChB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+BD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAwE9D"}