# Oro en caliente sobre una cubierta azul

> El oro en caliente como tinta plana con acabado: plancha propia en el PDF, brillo en Folio, y cartulina azul y papel crema sin tinta.

- Versión HTML: https://postext.dev/es/cookbook/gold-foil-poetry-cover
- Receta N.º 188 · Salida e integración · Nivel 3 (Avanzado) · Salidas: Canvas, PDF
- Géneros: Poesía
- Requiere postext ≥ 1.85.1, postext-pdf ≥ 1.85.1 · probada con 1.85.1, postext-pdf 1.85.1 el 2026-11-13
- Páginas: [1](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p01.webp?v=dcf0e3b7), [2](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p02.webp?v=dcf0e3b7), [3](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p03.webp?v=dcf0e3b7), [4](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p04.webp?v=dcf0e3b7), [5](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p05.webp?v=dcf0e3b7), [6](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p06.webp?v=dcf0e3b7), [7](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p07.webp?v=dcf0e3b7), [8](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p08.webp?v=dcf0e3b7), [9](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p09.webp?v=dcf0e3b7), [10](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p10.webp?v=dcf0e3b7), [11](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p11.webp?v=dcf0e3b7), [12](https://postext.dev/cookbook/gold-foil-poetry-cover/es/p12.webp?v=dcf0e3b7)
- PDF: https://postext.dev/cookbook/gold-foil-poetry-cover/es/gold-foil-poetry-cover.pdf?v=dcf0e3b7
- Abrir en el Sandbox: https://postext.dev/es/sandbox#recipe=gold-foil-poetry-cover&lang=es (.postext: https://postext.dev/cookbook/gold-foil-poetry-cover/es/gold-foil-poetry-cover.postext)
- Última actualización: 2026-11-13
- Otros idiomas: [en](https://postext.dev/en/cookbook/gold-foil-poetry-cover.md), [ca](https://postext.dev/ca/cookbook/gold-foil-poetry-cover.md), [de](https://postext.dev/de/cookbook/gold-foil-poetry-cover.md), [fr](https://postext.dev/fr/cookbook/gold-foil-poetry-cover.md), [it](https://postext.dev/it/cookbook/gold-foil-poetry-cover.md), [pt](https://postext.dev/pt/cookbook/gold-foil-poetry-cover.md), [zh](https://postext.dev/zh/cookbook/gold-foil-poetry-cover.md), [ja](https://postext.dev/ja/cookbook/gold-foil-poetry-cover.md), [ar](https://postext.dev/ar/cookbook/gold-foil-poetry-cover.md)

## En pocas palabras

Un librito de poemas con la cubierta azul oscuro y las letras estampadas en oro. Dentro, todos los filetes y marcos son de oro también. La vista 3D enseña el brillo del oro, y el archivo de imprenta lo separa para el impresor.

## Lo que vas a componer

Un cuaderno con siete rimas de Bécquer, de 140 × 216 mm y encuadernado en rústica. La cubierta y la hoja que la sigue son cartulina azul oscuro estampada en oro y nada más: un doble marco, el título en versales de Cinzel, el nombre del poeta y el índice. Dentro, en papel verjurado crema, las rimas se imprimen a cuatro tintas, un nocturno pintado da frente a la segunda, y cada filete de la página es oro: el doble filete bajo la cabecera, el filete corto bajo cada título y el que acompaña al folio. En Folio el libro cerrado gira hacia la luz y el oro se lee como metal.

**Esta receta responde a:**

- ¿Cómo estampo en oro una cubierta y los filetes de un libro, y mando el oro al impresor en una plancha aparte?
- ¿Cómo veo la encuadernación, la cubierta, el papel y la luz de un libro antes de mandarlo a imprenta?

## La respuesta corta

```js
// script.js, líneas 21–46
// Gold foil: a spot ink whose finish says what it is. The canvas paints its hex, Folio lights
// it as metal, and a CMYK or PDF/X file puts it on a Separation of its own named 'Gold foil',
// the artwork the foil block is etched from.
const foil = { hex: '#c9a24a', model: 'spot', spot: { name: 'Gold foil',
  cmyk: { c: 15, m: 30, y: 75, k: 10 }, finish: { kind: 'foil', sheen: 'gloss' } } };
// The two stocks are the paper's own colours, not inks: authored in CMYK at 0 % they paint
// on screen and put nothing on any plate. The blue card is a palette value of its own, so a
// section can turn the page blue (palette: { paper: … } in its heading style).
const stock = (hex) => ({ hex, model: 'cmyk', cmyk: { c: 0, m: 0, y: 0, k: 0 } });
const palette = {
  ink: { hex: '#232530', model: 'hex' }, // the poems: a warm near-black in process
  muted: { hex: '#6c6558', model: 'hex' }, // the attributions and the colophon
  foil,
  paper: stock('#f6f0e3'), // cream wove, inside
  card: stock('#1d2a4d'), // deep-blue card, the cover and the opener leaf
};
const col = (id) => ({ ...palette[id], paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, value]) => ({ id, name: id, value })),
  { id: 'main-color', name: 'foil (defaults)', value: foil },
];
// Every blue page takes this: the paper turns to the card, and the head and foot go.
const onCard = { numbered: false, toc: false, palette: { paper: palette.card.hex },
  header: { elements: [] }, footer: { elements: [] } };
// The press file: PDF/X-4, the foil on its plate, the cream and the blue on none.
const PRINT = { standard: 'pdfx4', outputProfile: 'fogra51' };
```

## Ingredientes

**Enseña**

- [Tintas especiales](https://postext.dev/es/docs/special-inks-die-cuts.md#acabados): Una tinta plana con acabado: metálica, oro en caliente, fluorescente, blanco opaco o barniz. Se imprime en su propia plancha, el canvas puede mostrar su brillo o un mapa de acabados, y Folio la ilumina.
- [PDF en CMYK y en escala de grises](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#generación-de-pdf-configuración): Los colores llevan su modelo (hex, rgb, cmyk, hsl) y el PDF puede forzarse a CMYK o a escala de grises para la imprenta o una prueba.

**También usa**

- [Visor de libro en 3D (Folio)](https://postext.dev/es/docs/configuration-html-folio-epub.md#un-libro-en-3d-postext-folio)
- [Papel, encuadernación, mesa y luz (Folio)](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#visor-folio-configuración)
- [Otro papel para una tanda de páginas](https://postext.dev/es/docs/document-format-directives.md#paper)
- [Paleta de color semántica](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#paleta-de-colores)
- [Verso línea a línea](https://postext.dev/es/docs/document-format-directives.md#verse)
- [Índice general](https://postext.dev/es/docs/configuration-notes-references.md#índice-general)
- [Estilos de título](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)
- [Cubiertas, portadas y colofones](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)
- [Aperturas diseñadas](https://postext.dev/es/docs/configuration-headings.md#apertura-a-toda-página-y-diseño-avanzado)
- [Textos, filetes y cajas en los diseños de página](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies)
- [Imágenes en los diseños de página](https://postext.dev/es/docs/configuration-headers-footers.md#elementos-de-imagen)
- [Cabeceras y folios](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies)
- [Exportación a PDF](https://postext.dev/es/docs/configuration-pdf-output.md#generación-de-pdf)
- [Páginas en un canvas](https://postext.dev/es/docs/configuration-programmatic-usage.md#renderizar-una-página-como-mapa-de-bits)
- [Atributos de título](https://postext.dev/es/docs/document-format.md#atributos-de-encabezado)
- [Color del papel](https://postext.dev/es/docs/configuration-page-layout.md#página)
- [Estilos de párrafo](https://postext.dev/es/docs/configuration-styles.md#estilos-de-párrafo)
- [Colores por parte](https://postext.dev/es/docs/configuration-styles.md#el-contenedor-part)
- [Fuentes incrustadas en el PDF](https://postext.dev/es/docs/configuration-pdf-output.md#por-qué-un-proveedor-de-fuentes)
- [Figuras y tablas como recursos](https://postext.dev/es/docs/document-format-resources.md#recursos)
- [Geometría por sección](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)
- [Cabeceras por sección](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)
- [Tintas planas y tabla de tintas](https://postext.dev/es/docs/configuration-pdf-output.md#tintas-planas)
- [Capítulos sin número](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado)

**La configuración de un vistazo**

- [`bodyText`](https://postext.dev/es/docs/configuration-text.md#texto-base), [`colorPalette`](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#paleta-de-colores), [`folio`](https://postext.dev/es/docs/configuration-html-folio-epub.md#aspecto), [`footer`](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies), [`header`](https://postext.dev/es/docs/configuration-headers-footers.md#cabeceras-y-pies), [`headingStyles`](https://postext.dev/es/docs/configuration-styles.md#estilos-de-encabezado), [`headings`](https://postext.dev/es/docs/configuration-headings.md#encabezados), [`layout`](https://postext.dev/es/docs/configuration-page-layout.md#disposición), [`locale`](https://postext.dev/es/docs/configuration-language.md#separación-silábica), [`page`](https://postext.dev/es/docs/configuration-page-layout.md#página), [`paragraphStyles`](https://postext.dev/es/docs/configuration-styles.md#estilos-de-párrafo), [`print`](https://postext.dev/es/docs/configuration-fonts-colors-viewers.md#producción-para-imprenta-configuración), [`toc`](https://postext.dev/es/docs/configuration-notes-references.md#índice-general)

**API**

- [`buildDocumentWithFonts`](https://postext.dev/es/docs/configuration-programmatic-usage.md#cargar-las-fuentes-antes-de-componer), [`createFolioFromDocument`](https://postext.dev/es/docs/configuration-html-folio-epub.md#un-libro-en-3d-postext-folio), [`decompressWoff2`](https://postext.dev/es/docs/configuration-pdf-output.md#proveedor-de-fuentes-en-el-navegador-fontsource--woff2), [`registerResourceImage`](https://postext.dev/es/docs/architecture.md#api-pública), [`renderPageToCanvas`](https://postext.dev/es/docs/configuration-programmatic-usage.md#renderizar-una-página-como-mapa-de-bits), [`renderToPdf`](https://postext.dev/es/docs/configuration-pdf-output.md#generación-de-pdf)

**Tipografías**

- Cormorant Garamond (OFL-1.1), Cinzel (OFL-1.1), Cormorant SC (OFL-1.1)

## Elaboración

### 1 · El oro es una tinta plana con acabado

El código es [la respuesta corta](https://postext.dev/es/cookbook/gold-foil-poetry-cover.md#la-respuesta-corta) de arriba. `finish: { kind: 'foil' }` convierte la tinta plana en una tinta especial ([acabados](https://postext.dev/es/docs/special-inks-die-cuts.md#acabados)). La maquetación ve un color y no se mueve nada; el canvas pinta su hex, Folio lo ilumina como metal y el PDF/X-4 pone cada elemento dorado en una sola `Separation` llamada `Gold foil`, de la que el grabador saca el clisé de latón. El oro reserva lo que tiene debajo, como en la máquina de estampar.

### 2 · Los papeles son colores que no llevan tinta

```js
// script.js, líneas 190–322
// :::paper{type=cardStock grammage=300}     pages 1–4: the cover leaf and the opener leaf
// # Shook Foil {style="cover"}  # Shook Foil {style="opener"}  # Contents {style="contents"}
// :::
// # God's Grandeur  …  # Spring             pages 5–10: cream wove, the poems
// :::paper{type=cardStock grammage=300}     pages 11–12: the back cover leaf
// # Colophon {style="colophon"}  # Shook Foil {style="back"}
// :::
const markdown = String.raw`---
title: "Rimas"
author: "Gustavo Adolfo Bécquer"
---

:::paper{type=cardStock grammage=300}
# Rimas {style="cover" kicker="Siete poemas" years="1868 · 1871"}

# Rimas {style="opener" note="Siete rimas del cuaderno que Bécquer rehízo de memoria después de 1868, impresas en 1871, un año después de su muerte"}

# Índice {style="contents"}

:::toc
:::

# Rima VII {sub="Del salón en el ángulo oscuro"}

:::verse{style="verse"}
Del salón en el ángulo oscuro,
de su dueña tal vez olvidada,
silenciosa y cubierta de polvo,
  veíase el arpa.

¡Cuánta nota dormía en sus cuerdas,
como el pájaro duerme en las ramas,
esperando la mano de nieve
  que sabe arrancarlas!

¡Ay! —pensé—, ¡cuántas veces el genio
así duerme en el fondo del alma,
y una voz como Lázaro espera
  que le diga «Levántate y anda»!
:::

# Nocturno {style="plate"}

# Rima X {sub="Los invisibles átomos del aire"}

:::verse{style="verse"}
Los invisibles átomos del aire
en derredor palpitan y se inflaman;
el cielo se deshace en rayos de oro;
la tierra se estremece alborozada;
oigo flotando en olas de armonía
rumor de besos y batir de alas;
mis párpados se cierran... ¿Qué sucede?
¿Dime?... ¡Silencio! ¡Es el amor que pasa!
:::

# Rima XXI {style="run-on" sub="¿Qué es poesía?"}

:::verse{style="verse"}
¿Qué es poesía?, dices mientras clavas
en mi pupila tu pupila azul.
¿Qué es poesía? ¿Y tú me lo preguntas?
  Poesía... eres tú.
:::

# Rima XXX {sub="Asomaba a sus ojos una lágrima"}

:::verse{style="verse"}
Asomaba a sus ojos una lágrima
y a mi labio una frase de perdón;
habló el orgullo y se enjugó su llanto,
y la frase en mis labios expiró.

Yo voy por un camino, ella por otro;
pero al pensar en nuestro mutuo amor,
yo digo aún: ¿Por qué callé aquel día?
Y ella dirá: ¿Por qué no lloré yo?
:::

# Rima XXXVIII {style="run-on" sub="Los suspiros son aire"}

:::verse{style="verse"}
¡Los suspiros son aire y van al aire!
¡Las lágrimas son agua y van al mar!
Dime, mujer: cuando el amor se olvida,
  ¿sabes tú adónde va?
:::

# Rima LII {sub="Olas gigantes que os rompéis bramando"}

:::verse{style="verse"}
Olas gigantes que os rompéis bramando
en las playas desiertas y remotas,
envuelto entre la sábana de espumas,
  ¡llevadme con vosotras!

Ráfagas de huracán que arrebatáis
del alto bosque las marchitas hojas,
arrastrado en el ciego torbellino,
  ¡llevadme con vosotras!

Nubes de tempestad que rompe el rayo
y en fuego ornáis las desprendidas orlas,
arrebatado entre la niebla oscura,
  ¡llevadme con vosotras!

Llevadme, por piedad, adonde el vértigo
con la razón me arranque la memoria.
¡Por piedad! ¡Tengo miedo de quedarme
  con mi dolor a solas!
:::

# Rima XXIII {sub="Por una mirada, un mundo"}

:::verse{style="verse"}
Por una mirada, un mundo;
por una sonrisa, un cielo;
por un beso... ¡yo no sé
qué te diera por un beso!
:::

:::paper{type=cardStock grammage=300}
# Colofón {style="colophon"}

:::paragraphs{style="colophon"}
Las rimas siguen el texto de las *Obras* de Gustavo Adolfo Bécquer (Madrid, 1871); son de dominio público.

Compuesto en Cormorant Garamond, Cinzel y Cormorant SC (SIL Open Font License). El nocturno se generó con modelos de difusión. Cubierta, apertura y filetes estampados en oro en caliente.
:::

# Rimas {style="back"}
:::
`; // content.<lang>.md, inlined by the Cookbook
```

La cartulina azul y el verjurado crema son colores de la paleta definidos en CMYK al 0 % en todos los canales: la pantalla y Folio pintan el papel y ninguna plancha recibe un punto, así que el PDF de la cubierta tiene la plancha del oro y cuatro planchas de cuatricromía vacías. Cada página azul toma la cartulina de su estilo de título (`palette: { paper: … }` en `onCard`), y los dos bloques `:::paper` dan a Folio el gramaje y la rigidez de la cartulina en la hoja de cubierta y en la que la sigue.

### 3 · La cubierta es un marco y cuatro líneas

```js
// script.js, líneas 63–78
// Two frames, a hairline inside a heavier rule: foil holds a 0.3 pt line on smooth card.
const frame = (id, inset, thickness) => ({ kind: 'box', id, style: { borderColor: col('foil'),
  borderWidth: pt(thickness) }, placement: at('page', 'top-left', inset, inset,
  { width: mm(TRIM_W - 2 * inset), height: mm(TRIM_H - 2 * inset) }) });
const flush = { span: 'page', margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = { ...onCard, ...flush, id: 'cover', advancedDesign: { enabled: true,
  minHeight: mm(TRIM_H), slot: { elements: [
    frame('outer', 9, 1.6), frame('inner', 11.5, 0.4),
    text('kicker', '{attr.kicker}', caps(8.5), at('page', 'top', 0, 46)),
    text('title', '{titleText}', { ...caps(40, col('foil'), 0.06), lineHeight: 1.05 },
      at('page', 'top', 0, 62, { width: mm(100) })),
    rule('rule', 112, 22, 0.8),
    text('poet', '{author}', { fontFamily: 'Cormorant SC', fontSize: pt(15), fontWeight: 500,
      letterSpacing: pt(1.5), color: col('foil') }, at('page', 'top', 0, 120)),
    text('years', '{attr.years}', caps(8), at('page', 'top', 0, 186)),
  ] } } };
```

El oro aguanta una línea fina, así que el marco es un filete de 1,6 pt con otro de 0,4 pt 2,5 mm por dentro, cada uno el borde de una caja en el color del oro. Todo lo de la cubierta es oro: ninguna otra tinta toca la cartulina, que es como se encarga una cubierta estampada al taller.

### 4 · Dentro, los filetes son oro y los versos tinta

```js
// script.js, líneas 104–127
const poem = { enabled: true, minHeight: mm(23), slot: { elements: [
  text('title', '{titleText}', { ...caps(13, col('ink'), 0.1), lineHeight: 1.2 },
    at('container', 'top', 0, 6, { width: mm(90) })),
  { ...rule('rule', 3.5, 12, 0.8, '#title', 'below') },
  text('sub', '{attr.sub}', { fontFamily: 'Cormorant Garamond', italic: true, fontSize: pt(11),
    color: col('muted') }, at('#rule', 'below', 0, 3)),
] } };
const HEAD_Y = 12; // mm from the top edge to the running heads
const headText = (id, content, parity, edge, x) => text(id, content, { ...caps(7.5,
  col('muted'), 0.18), align: edge.endsWith('left') ? 'left' : 'right', parity },
at('page', edge, x, HEAD_Y));
const header = { elements: [
  // The double rule across the text block, a thick and a thin line 1 mm apart.
  { ...rule('head-a', HEAD_Y + 5.5, TRIM_W - INNER - OUTER, 0.9, 'container', 'top'),
    placement: at('page', 'top', 0, HEAD_Y + 5, { width: mm(TRIM_W - INNER - OUTER) }) },
  { ...rule('head-b', 0, 0, 0.3), placement: at('page', 'top', 0, HEAD_Y + 6.2,
    { width: mm(TRIM_W - INNER - OUTER) }) },
  headText('verso', '{title}', 'even', 'top-left', OUTER),
  headText('recto', '{chapterTitle}', 'odd', 'top-right', -OUTER),
] };
const footer = { elements: [
  text('folio', '{pageNumber}', caps(9, col('ink'), 0.05), at('page', 'bottom', 0, -13)),
  rule('folio-l', -12, 6, 0.6, 'page', 'bottom'), // a short foil rule under the folio
] };
```

La cabecera va sobre un doble filete, uno de 0,9 pt y otro de 0,3 pt 1,2 mm por debajo, del ancho de la caja de texto. El diseño del título del poema añade un filete de 12 mm bajo el título, y el pie otro de 6 mm bajo el folio. El texto queda en el negro cálido: la letra pequeña en oro se empasta en la máquina.

### 5 · Folio pone la cubierta a la luz

```js
// script.js, líneas 152–158
const folio = {
  tilt: 24, yaw: -16,
  paper: { type: 'bookWove', grammage: 100, shade: '#ffffff' }, // the colour is the page's
  binding: { type: 'paperback', cover: 'pages' },
  surface: { type: 'walnut' },
  lighting: { environment: 'studio', intensity: 1.1 },
};
```

El oro solo parece oro cuando refleja algo. El entorno `studio` tiene focos difusos y claros, y una inclinación de 24° con el libro girado 16° lleva su reflejo sobre el título. Con la luz de lámpara, más tenue, el mismo oro se queda en un ocre mate.

## La receta completa

Un solo archivo, compuesto a partir de la carpeta de la receta con el texto de ejemplo y el kit común del Recetario ya incluidos; construye su propia página. Para ejecutarlo, ponlo en un `<script type="module">` de una página vacía o pégalo en el panel JS de un pen nuevo de CodePen (como módulo). Importa postext desde esm.sh, así que no hay nada que instalar ni compilar.

- Carpeta de la receta: https://github.com/drnachio/postext/tree/main/cookbook/gold-foil-poetry-cover

### script.js

```js
// ═══ Postext Cookbook · Nº 188 · Gold foil on a deep-blue cover ═══════════════════════
// https://postext.dev/en/cookbook/gold-foil-poetry-cover
// Code: MIT · Text: Hopkins, Bécquer (public domain) · Nocturne: diffusion models
// Fonts: Cormorant Garamond, Cinzel, Cormorant SC (SIL OFL 1.1) · Needs postext ≥ 1.85.1
//
// A poetry chapbook with a hot-foil cover. The cover, the opener and the contents are set
// in gold foil alone on deep-blue card; inside, on cream paper, the poems print in four
// colours and every rule of the page is foil. Folio lights the foil; the PDF gives it a
// plate of its own for the block-maker.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createFolioFromDocument } from 'https://esm.sh/postext-folio';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'gold-foil-poetry-cover';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region answer: the foil is a spot colour with a finish; the stocks print no ink at all
// Gold foil: a spot ink whose finish says what it is. The canvas paints its hex, Folio lights
// it as metal, and a CMYK or PDF/X file puts it on a Separation of its own named 'Gold foil',
// the artwork the foil block is etched from.
const foil = { hex: '#c9a24a', model: 'spot', spot: { name: 'Gold foil',
  cmyk: { c: 15, m: 30, y: 75, k: 10 }, finish: { kind: 'foil', sheen: 'gloss' } } };
// The two stocks are the paper's own colours, not inks: authored in CMYK at 0 % they paint
// on screen and put nothing on any plate. The blue card is a palette value of its own, so a
// section can turn the page blue (palette: { paper: … } in its heading style).
const stock = (hex) => ({ hex, model: 'cmyk', cmyk: { c: 0, m: 0, y: 0, k: 0 } });
const palette = {
  ink: { hex: '#232530', model: 'hex' }, // the poems: a warm near-black in process
  muted: { hex: '#6c6558', model: 'hex' }, // the attributions and the colophon
  foil,
  paper: stock('#f6f0e3'), // cream wove, inside
  card: stock('#1d2a4d'), // deep-blue card, the cover and the opener leaf
};
const col = (id) => ({ ...palette[id], paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, value]) => ({ id, name: id, value })),
  { id: 'main-color', name: 'foil (defaults)', value: foil },
];
// Every blue page takes this: the paper turns to the card, and the head and foot go.
const onCard = { numbered: false, toc: false, palette: { paper: palette.card.hex },
  header: { elements: [] }, footer: { elements: [] } };
// The press file: PDF/X-4, the foil on its plate, the cream and the blue on none.
const PRINT = { standard: 'pdfx4', outputProfile: 'fogra51' };
// #endregion

const [TRIM_W, TRIM_H] = [140, 216]; // mm: a chapbook
const [TOP, FOOT, INNER, OUTER] = [24, 24, 18, 18]; // mm, mirrored
const LEAD = 14.2; // pt
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
  align: 'center', placement, ...look });
const caps = (size, color = col('foil'), spacing = 0.2) => ({ fontFamily: 'Cinzel',
  fontSize: pt(size), letterSpacing: pt(size * spacing), color });
const rule = (id, y, width, thickness = 0.6, to = 'page', edge = 'top') => ({ kind: 'rule', id,
  direction: 'horizontal', color: col('foil'), thickness: pt(thickness),
  placement: at(to, edge, 0, y, { width: mm(width) }) });

// #region cover: a frame of foil rules, the title and a rule between the names
// Two frames, a hairline inside a heavier rule: foil holds a 0.3 pt line on smooth card.
const frame = (id, inset, thickness) => ({ kind: 'box', id, style: { borderColor: col('foil'),
  borderWidth: pt(thickness) }, placement: at('page', 'top-left', inset, inset,
  { width: mm(TRIM_W - 2 * inset), height: mm(TRIM_H - 2 * inset) }) });
const flush = { span: 'page', margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = { ...onCard, ...flush, id: 'cover', advancedDesign: { enabled: true,
  minHeight: mm(TRIM_H), slot: { elements: [
    frame('outer', 9, 1.6), frame('inner', 11.5, 0.4),
    text('kicker', '{attr.kicker}', caps(8.5), at('page', 'top', 0, 46)),
    text('title', '{titleText}', { ...caps(40, col('foil'), 0.06), lineHeight: 1.05 },
      at('page', 'top', 0, 62, { width: mm(100) })),
    rule('rule', 112, 22, 0.8),
    text('poet', '{author}', { fontFamily: 'Cormorant SC', fontSize: pt(15), fontWeight: 500,
      letterSpacing: pt(1.5), color: col('foil') }, at('page', 'top', 0, 120)),
    text('years', '{attr.years}', caps(8), at('page', 'top', 0, 186)),
  ] } } };
// #endregion

// #region opener: the opener leaf and the contents, in foil on the blue card
const opener = { ...onCard, id: 'opener', breakBefore: { enabled: true, parity: 'odd' },
  advancedDesign: { enabled: true, minHeight: mm(120), slot: { elements: [
    rule('top', 52, 60, 0.4, 'page'),
    text('title', '{titleText}', { ...caps(24, col('foil'), 0.08) }, at('page', 'top', 0, 66)),
    text('note', '{attr.note}', { fontFamily: 'Cormorant Garamond', italic: true,
      fontSize: pt(12.5), lineHeight: 1.3, color: col('foil') },
    at('page', 'top', 0, 84, { width: mm(80) })),
    rule('foot', 108, 60, 0.4, 'page'),
  ] } } };
const contentsPage = { ...onCard, id: 'contents', breakBefore: { enabled: true, parity: 'any' },
  advancedDesign: { enabled: true, minHeight: mm(30), slot: { elements: [
    text('title', '{titleText}', caps(10), at('container', 'top', 0, 8)),
    rule('rule', 16, 14, 0.6, 'container'),
  ] } } };
// The contents in foil: its entries, leaders and page numbers from the poems' headings.
const toc = { levels: [{ level: 1, fontFamily: 'Cormorant Garamond', fontSize: pt(12.5),
  color: col('foil'), marginBottom: pt(LEAD * 0.6) }],
pageNumber: { fontFamily: 'Cinzel', fontSize: pt(9), color: col('foil'), width: mm(8) },
leader: { char: '. ', gap: mm(2) } };
// #endregion

// #region rules: inside, every rule is foil: a double rule over the head, a rule per poem
const poem = { enabled: true, minHeight: mm(23), slot: { elements: [
  text('title', '{titleText}', { ...caps(13, col('ink'), 0.1), lineHeight: 1.2 },
    at('container', 'top', 0, 6, { width: mm(90) })),
  { ...rule('rule', 3.5, 12, 0.8, '#title', 'below') },
  text('sub', '{attr.sub}', { fontFamily: 'Cormorant Garamond', italic: true, fontSize: pt(11),
    color: col('muted') }, at('#rule', 'below', 0, 3)),
] } };
const HEAD_Y = 12; // mm from the top edge to the running heads
const headText = (id, content, parity, edge, x) => text(id, content, { ...caps(7.5,
  col('muted'), 0.18), align: edge.endsWith('left') ? 'left' : 'right', parity },
at('page', edge, x, HEAD_Y));
const header = { elements: [
  // The double rule across the text block, a thick and a thin line 1 mm apart.
  { ...rule('head-a', HEAD_Y + 5.5, TRIM_W - INNER - OUTER, 0.9, 'container', 'top'),
    placement: at('page', 'top', 0, HEAD_Y + 5, { width: mm(TRIM_W - INNER - OUTER) }) },
  { ...rule('head-b', 0, 0, 0.3), placement: at('page', 'top', 0, HEAD_Y + 6.2,
    { width: mm(TRIM_W - INNER - OUTER) }) },
  headText('verso', '{title}', 'even', 'top-left', OUTER),
  headText('recto', '{chapterTitle}', 'odd', 'top-right', -OUTER),
] };
const footer = { elements: [
  text('folio', '{pageNumber}', caps(9, col('ink'), 0.05), at('page', 'bottom', 0, -13)),
  rule('folio-l', -12, 6, 0.6, 'page', 'bottom'), // a short foil rule under the folio
] };
// #endregion

// The nocturne on its own page, in a foil frame.
const plate = { id: 'plate', numbered: false, toc: false, header: { elements: [] },
  footer: { elements: [] }, advancedDesign: { enabled: true,
    minHeight: mm(TRIM_H - TOP - FOOT), slot: { elements: [
      { kind: 'image', id: 'art', resourceId: 'nocturne',
        placement: at('page', 'top', 0, 30, { width: mm(92), height: mm(144.9) }) },
      { kind: 'box', id: 'frame', style: { borderColor: col('foil'), borderWidth: pt(1.2) },
        placement: at('page', 'top', 0, 27, { width: mm(98), height: mm(150.9) }) },
    ] } } };

// The colophon and the back cover go back to the blue card.
const colophon = { ...onCard, id: 'colophon', breakBefore: { enabled: true, parity: 'odd' },
  advancedDesign: { enabled: true, minHeight: mm(118), slot: { elements: [
    rule('rule', 112, 14, 0.6) ] } } };
const back = { ...onCard, ...flush, id: 'back', breakBefore: { enabled: true, parity: 'even' },
  advancedDesign: { enabled: true, minHeight: mm(TRIM_H), slot: { elements: [
    frame('outer', 9, 1.6), frame('inner', 11.5, 0.4),
    text('title', '{titleText}', caps(10), at('page', 'top', 0, 98)),
    rule('rule', 106, 10, 0.6),
  ] } } };

// #region folio: a paperback in the hand, under studio lights that catch the foil
const folio = {
  tilt: 24, yaw: -16,
  paper: { type: 'bookWove', grammage: 100, shade: '#ffffff' }, // the colour is the page's
  binding: { type: 'paperback', cover: 'pages' },
  surface: { type: 'walnut' },
  lighting: { environment: 'studio', intensity: 1.1 },
};
// #endregion

const config = () => ({
  locale: t({ en: 'en-gb', es: 'es' }),
  colorPalette,
  page: { sizePreset: 'custom', width: mm(TRIM_W), height: mm(TRIM_H), dpi: 300,
    backgroundColor: col('paper'),
    margins: { top: mm(TOP), bottom: mm(FOOT), left: mm(INNER), right: mm(OUTER), mirror: true } },
  layout: { layoutType: 'single' },
  bodyText: { fontFamily: 'Cormorant Garamond', fontSize: pt(12.2), lineHeight: pt(LEAD),
    color: col('ink'), boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
    textAlign: 'left', firstLineIndent: pt(0), hyphenation: { enabled: true },
    avoidWidows: true, avoidOrphans: true },
  headings: { fontFamily: 'Cinzel', fontWeight: 400, color: col('ink'), levels: [
    { level: 1, breakBefore: { enabled: true, parity: 'any' }, advancedDesign: poem }] },
  headingStyles: [cover, opener, contentsPage, plate, colophon, back,
    // A short poem runs on under the one before it.
    { id: 'run-on', breakBefore: { enabled: false }, marginTop: pt(LEAD) }],
  paragraphStyles: [
    { id: 'verse', fontFamily: 'Cormorant Garamond', fontSize: pt(12.2), lineHeight: pt(LEAD) },
    { id: 'colophon', fontFamily: 'Cormorant Garamond', italic: true, fontSize: pt(10.5),
      lineHeight: pt(13.5), color: col('foil'), italicColor: col('foil'), textAlign: 'center',
      firstLineIndent: pt(0) },
  ],
  toc,
  print: PRINT,
  header, footer, folio,
});

// ─── 2 · Content ────────────────────────────────────────────────────────────
// #region content: blue card around the cream leaves, as the binder gathers them
// :::paper{type=cardStock grammage=300}     pages 1–4: the cover leaf and the opener leaf
// # Shook Foil {style="cover"}  # Shook Foil {style="opener"}  # Contents {style="contents"}
// :::
// # God's Grandeur  …  # Spring             pages 5–10: cream wove, the poems
// :::paper{type=cardStock grammage=300}     pages 11–12: the back cover leaf
// # Colophon {style="colophon"}  # Shook Foil {style="back"}
// :::
const markdown = String.raw`---
title: "Rimas"
author: "Gustavo Adolfo Bécquer"
---

:::paper{type=cardStock grammage=300}
# Rimas {style="cover" kicker="Siete poemas" years="1868 · 1871"}

# Rimas {style="opener" note="Siete rimas del cuaderno que Bécquer rehízo de memoria después de 1868, impresas en 1871, un año después de su muerte"}

# Índice {style="contents"}

:::toc
:::

# Rima VII {sub="Del salón en el ángulo oscuro"}

:::verse{style="verse"}
Del salón en el ángulo oscuro,
de su dueña tal vez olvidada,
silenciosa y cubierta de polvo,
  veíase el arpa.

¡Cuánta nota dormía en sus cuerdas,
como el pájaro duerme en las ramas,
esperando la mano de nieve
  que sabe arrancarlas!

¡Ay! —pensé—, ¡cuántas veces el genio
así duerme en el fondo del alma,
y una voz como Lázaro espera
  que le diga «Levántate y anda»!
:::

# Nocturno {style="plate"}

# Rima X {sub="Los invisibles átomos del aire"}

:::verse{style="verse"}
Los invisibles átomos del aire
en derredor palpitan y se inflaman;
el cielo se deshace en rayos de oro;
la tierra se estremece alborozada;
oigo flotando en olas de armonía
rumor de besos y batir de alas;
mis párpados se cierran... ¿Qué sucede?
¿Dime?... ¡Silencio! ¡Es el amor que pasa!
:::

# Rima XXI {style="run-on" sub="¿Qué es poesía?"}

:::verse{style="verse"}
¿Qué es poesía?, dices mientras clavas
en mi pupila tu pupila azul.
¿Qué es poesía? ¿Y tú me lo preguntas?
  Poesía... eres tú.
:::

# Rima XXX {sub="Asomaba a sus ojos una lágrima"}

:::verse{style="verse"}
Asomaba a sus ojos una lágrima
y a mi labio una frase de perdón;
habló el orgullo y se enjugó su llanto,
y la frase en mis labios expiró.

Yo voy por un camino, ella por otro;
pero al pensar en nuestro mutuo amor,
yo digo aún: ¿Por qué callé aquel día?
Y ella dirá: ¿Por qué no lloré yo?
:::

# Rima XXXVIII {style="run-on" sub="Los suspiros son aire"}

:::verse{style="verse"}
¡Los suspiros son aire y van al aire!
¡Las lágrimas son agua y van al mar!
Dime, mujer: cuando el amor se olvida,
  ¿sabes tú adónde va?
:::

# Rima LII {sub="Olas gigantes que os rompéis bramando"}

:::verse{style="verse"}
Olas gigantes que os rompéis bramando
en las playas desiertas y remotas,
envuelto entre la sábana de espumas,
  ¡llevadme con vosotras!

Ráfagas de huracán que arrebatáis
del alto bosque las marchitas hojas,
arrastrado en el ciego torbellino,
  ¡llevadme con vosotras!

Nubes de tempestad que rompe el rayo
y en fuego ornáis las desprendidas orlas,
arrebatado entre la niebla oscura,
  ¡llevadme con vosotras!

Llevadme, por piedad, adonde el vértigo
con la razón me arranque la memoria.
¡Por piedad! ¡Tengo miedo de quedarme
  con mi dolor a solas!
:::

# Rima XXIII {sub="Por una mirada, un mundo"}

:::verse{style="verse"}
Por una mirada, un mundo;
por una sonrisa, un cielo;
por un beso... ¡yo no sé
qué te diera por un beso!
:::

:::paper{type=cardStock grammage=300}
# Colofón {style="colophon"}

:::paragraphs{style="colophon"}
Las rimas siguen el texto de las *Obras* de Gustavo Adolfo Bécquer (Madrid, 1871); son de dominio público.

Compuesto en Cormorant Garamond, Cinzel y Cormorant SC (SIL Open Font License). El nocturno se generó con modelos de difusión. Cubierta, apertura y filetes estampados en oro en caliente.
:::

# Rimas {style="back"}
:::
`; // content.<lang>.md, inlined by the Cookbook
// #endregion
const resources = [{ id: 'nocturne', typeId: 'figure', kind: 'bitmap', createdAt: 0,
  updatedAt: 0, bitmap: { fileId: 'nocturne.jpg', format: 'jpeg', width: 600, height: 945 },
  altText: t({ en: 'A night meadow under a sky of stars: tall poplars, a stone wall, a thin '
    + 'moon over the hills and a lit window in the valley.',
  es: 'Un prado de noche bajo un cielo de estrellas: chopos altos, una tapia de piedra, una '
    + 'luna fina sobre los montes y una ventana encendida en el valle.' }) }];
await loadImage('nocturne.jpg', asset('nocturne-600.jpg'));

// ─── 3 · Fonts ──────────────────────────────────────────────────────────────
const FONTS = {
  'Cormorant Garamond': ['400', '400i'],
  Cinzel: ['400'],
  'Cormorant SC': ['500'],
};

// ─── 4 · Build & show ───────────────────────────────────────────────────────
const doc = await buildDocumentWithFonts({ markdown, resources }, config(), kitFonts(FONTS));
showPages(doc, { title: t({ en: 'Shook Foil · a chapbook with a gold-foil cover',
  es: 'Rimas · un cuaderno con portada en oro en caliente' }) });
offerPdf(() => renderToPdf(doc, { fontProvider: fontsourceProvider, resourceBytes: imageBytes,
  profileBaseUrl: 'https://postext.dev/icc/' }), `${RECIPE}.pdf`);

// The book in the hand: the cover, closed, turning its foil to the lamp.
const stage = document.createElement('section');
stage.id = 'folio';
stage.ariaLabel = t({ en: 'The chapbook in 3D', es: 'El cuaderno en 3D' });
stage.style.cssText = 'height: min(78vh, 720px); margin: 0 auto; max-width: 1280px';
document.getElementById('pages').before(stage);
createFolioFromDocument(stage, doc, {
  appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' } });

// ─── Kit ── helpers shared by every Cookbook recipe · postext.dev/cookbook ─────

// ─── Kit · core v1 ── the same in every recipe · postext.dev/cookbook
function mm(value) { return { value, unit: 'mm' }; }
function pt(value) { return { value, unit: 'pt' }; }
function em(value) { return { value, unit: 'em' }; }
/** The sample language's string: t({ en: 'Figure', es: 'Figura' }). */
function t(strings) { return strings[LANG] ?? Object.values(strings)[0]; }
/** A file in this recipe's assets folder, served from the Postext repo by jsDelivr. */
function asset(file) { return `https://cdn.jsdelivr.net/gh/drnachio/postext@main/cookbook/${RECIPE}/assets/${file}`; }

// ─── Kit · fonts v3 ── the same in every recipe · postext.dev/cookbook
// Postext loads the faces a config asks for before layout and asks the kit
// for Fontsource's files, the ones the PDF embeds too.

/** buildDocumentWithFonts' options: the resolver, and FONTS' faces loaded
 *  with the config's. FONTS = { 'Family Name': ['400', '400i', '700'] }. */
function kitFonts(FONTS = {}) {
  const faces = Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) =>
    ({ family, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' })));
  return { resolve: fontsourceResolver, faces };
}

/** A face's files with their ranges: latin, then latin-ext and greek when
 *  `text` needs them (kitSubsetsFor). Null for a face Fontsource lacks. */
async function fontsourceResolver(family, weight, style, { text = '' } = {}) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  if (meta && !(await fontsourceWeights(family, style)).includes(weight)) return null;
  kitStatus('Loading fonts…');
  const at = await fontsourceAt(id);
  return ['latin', ...kitSubsetsFor(text, meta)].map((subset) => ({
    source: `${at}files/${id}-${subset}-${weight}-${style}.woff2`,
    unicodeRange: kitRanges()[subset],
  }));
}

/** Each file's unicode-range (a function: the kit runs after the pen's code). */
function kitRanges() {
  return {
    latin: 'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,'
      + 'U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
    'latin-ext': 'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,'
      + 'U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF',
    greek: 'U+0370-03FF',
  };
}

/** For the cjk, arabic and comics blocks: loads `faces` (as FONTS) for the
 *  sample `text`; `optional` skips a face Fontsource lacks. Files are added in
 *  the order asked, the last winning a shared character. Resolves to the count. */
async function loadFonts(faces, text = '', { optional = false } = {}) {
  kitStatus('Loading fonts…');
  const ranges = kitRanges();
  const jobs = [];
  for (const [family, specs] of Object.entries(faces)) {
    const id = fontsourceId(family);
    const todo = [...new Set(specs)].map((spec) => [parseInt(spec, 10), spec.endsWith('i') ? 'italic' : 'normal'])
      .filter(([weight, style]) => !hasFace(family, weight, style)); // before any await
    const at = fontsourceAt(id);
    const meta = optional || /[^\0-ÿ]/u.test(text) ? await fontsourceMeta(family) : null;
    const subsets = ['latin', ...kitSubsetsFor(text, meta)];
    for (const [weight, style] of todo) {
      if (optional && !(meta && (await fontsourceWeights(family, style)).includes(weight))) continue;
      for (const subset of subsets) {
        const url = `${await at}files/${id}-${subset}-${weight}-${style}.woff2`;
        const face = new FontFace(family, `url(${url}) format('woff2')`,
          { weight: String(weight), style, unicodeRange: ranges[subset] });
        jobs.push(face.load().catch(() => {
          if (subset === 'latin' && !optional) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
        }));
      }
    }
  }
  const ready = await Promise.all(jobs).catch((error) => { kitFail(error); throw error; });
  return ready.filter((face) => face && document.fonts.add(face)).length;
}

/** A loaded FontFace covers this face (fonts.check() says yes to any family). */
function hasFace(family, weight, style) {
  for (const face of document.fonts) {
    if (face.status !== 'loaded' || face.style !== style) continue;
    if (face.family.replace(/^["']|["']$/g, '') !== family) continue;
    const [low, high = low] = face.weight.split(' ').map(Number);
    if (weight >= low && weight <= high) return true;
  }
  return false;
}

/** The files beyond latin `text` needs that `meta`'s family ships. */
function kitSubsetsFor(text, meta) {
  return [[/[Ā-˿ᴀ-ᶿḀ-ỿ†ℓⱠ-Ɀ꜠-ꟿ]/u, 'latin-ext'], [/[Ͱ-Ͽ]/u, 'greek']]
    .filter(([re, x]) => re.test(text) && meta?.subsets?.includes(x)).map(([, x]) => x);
}

/** Fontsource's id for a family: 'Source Serif 4' → 'source-serif-4'. */
function fontsourceId(family) { return family.toLowerCase().replace(/\s+/g, '-'); }

/** A package's folder at the one version @5 names now (#766). */
function fontsourceAt(id, u = `https://cdn.jsdelivr.net/npm/@fontsource/${id}@`) {
  return (fontsourceAt.c ??= {})[id] ??= fetch(u + '5/package.json').then((r) => r.json())
    .then((p) => p.version || 5, () => 5).then((v) => `${u}${v}/`);
}

/** The family's Fontsource metadata (weights, styles, subsets), or null. */
function fontsourceMeta(family, id = fontsourceId(family)) {
  return (fontsourceMeta.c ??= {})[id] ??= fetch(`https://api.fontsource.org/v1/fonts/${id}`)
    .then((res) => (res.ok ? res.json() : null), () => null);
}

/** The weights the package ships in `style`: the API pairs none (no Libre
 *  Caslon 700 italic file), so italics are read from latin-italic.css. */
function fontsourceWeights(family, style, id = fontsourceId(family)) {
  return (fontsourceWeights.c ??= {})[id + style] ??= fontsourceMeta(family).then(async (m) => {
    if (!m?.styles.includes(style)) return m ? [] : [400, 700];
    const css = style === 'italic' ? await fetch(`${await fontsourceAt(id)}latin-italic.css`).then((r) => (r.ok ? r.text() : ''), () => '') : '';
    const w = [...css.matchAll(/weight: (\d+)/g)].map((x) => +x[1]);
    return w.length ? w : m.weights;
  });
}

// ─── Kit · viewer v2 ── the same in every recipe · postext.dev/cookbook
/** The pages as spreads on a dark desk, page 1 alone, then verso | recto,
 *  each painted when it scrolls near. Other options go to renderPageToCanvas. */
function showPages(docs, { title, width = 460, ...render } = {}) {
  const root = viewer(title);
  const pages = [docs].flat().flatMap((doc) =>
    doc.pages.map((page) => ({ doc, page, n: (doc.pageIndexOffset ?? 0) + page.index })));
  const spreads = [];
  let verso = null;
  for (const p of pages) {
    if (p.n % 2 === 1) { if (verso) spreads.push([verso, null]); verso = p; }
    else { spreads.push([verso, p]); verso = null; }
  }
  if (verso) spreads.push([verso, null]);
  const density = Math.min(window.devicePixelRatio || 1, 2);
  showPages.painter?.disconnect();
  const painter = new IntersectionObserver((entries) => {
    for (const { isIntersecting, target } of entries) {
      if (!isIntersecting) continue;
      painter.unobserve(target);
      const { doc, page } = target.postext;
      renderPageToCanvas(page, doc, target, { ...render, scale: (width * density) / page.width });
    }
  }, { rootMargin: '800px' });
  showPages.painter = painter;
  root.replaceChildren(...spreads.map((pair) => {
    const spread = document.createElement('div');
    spread.className = 'pt-spread';
    for (const p of pair) {
      const figure = document.createElement('figure');
      if (p) {
        const label = p.page.pageLabel || String(p.n + 1);
        const canvas = document.createElement('canvas');
        canvas.postext = p;
        canvas.style.aspectRatio = `${p.page.width} / ${p.page.height}`;
        canvas.setAttribute('role', 'img');
        canvas.setAttribute('aria-label', `Page ${label}`);
        const folio = document.createElement('figcaption');
        folio.textContent = label;
        figure.append(canvas, folio);
        painter.observe(canvas);
      } else figure.className = 'pt-blank';
      spread.append(figure);
    }
    return spread;
  }));
  kitStatus(`${pages.length} ${pages.length === 1 ? 'page' : 'pages'}`);
  document.documentElement.dataset.postext = 'ready';
  return pages.length;
}

/** The desk, the bar and the error reporting, created once. */
function viewer(title) {
  if (!document.getElementById('pt-kit')) {
    document.head.insertAdjacentHTML('beforeend', `<style id="pt-kit">
      :root { color-scheme: dark; }
      body { margin: 0; background: #0e1014; color: #b9bcc4; font: 13px/1.45 system-ui, sans-serif; }
      #pt-bar { position: sticky; top: 0; z-index: 1; display: flex; flex-wrap: wrap; align-items: center;
        gap: 6px 16px; padding: 10px 16px; background: rgb(14 16 20 / .92); backdrop-filter: blur(6px);
        border-bottom: 1px solid #23262d; }
      #pt-bar strong { color: #f4f1ea; font-weight: 600; }
      #pt-actions { display: flex; gap: 12px; margin-left: auto; }
      #pt-actions a, #pt-actions button { color: #d8a21a; font: inherit; background: none; border: 0; padding: 0; cursor: pointer; }
      #pages { display: grid; justify-items: center; gap: 48px; padding: 32px 16px 72px; }
      .pt-spread { display: flex; }
      .pt-spread figure { margin: 0; width: min(460px, 44vw); }
      .pt-spread canvas { display: block; width: 100%; background: #fff;
        box-shadow: 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figure:first-child canvas { box-shadow: inset -14px 0 14px -14px rgb(0 0 0 / .18), 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figcaption { margin-top: 10px; text-align: center; font: 600 10px/1 system-ui, sans-serif;
        letter-spacing: .18em; text-transform: uppercase; color: #6c7079; }
      .pt-blank { visibility: hidden; }
      @media (max-width: 760px) {
        .pt-spread { flex-direction: column; gap: 32px; }
        .pt-spread figure { width: min(460px, 92vw); }
        .pt-blank { display: none; }
      }
    </style>`);
    document.body.insertAdjacentHTML('afterbegin',
      '<header id="pt-bar"><strong id="pt-title"></strong><span id="pt-status" role="status"></span><span id="pt-actions"></span></header>');
    document.getElementById('pt-title').textContent = document.title || 'Postext';
    addEventListener('error', (event) => kitFail(event.error ?? event.message));
    addEventListener('unhandledrejection', (event) => kitFail(event.reason));
  }
  if (title) document.getElementById('pt-title').textContent = title;
  return document.getElementById('pages')
    ?? document.body.appendChild(Object.assign(document.createElement('main'), { id: 'pages' }));
}

function kitStatus(text) {
  viewer();
  document.getElementById('pt-status').textContent = text;
}

function kitFail(error) {
  document.documentElement.dataset.postext = 'error';
  kitStatus(`Error: ${error?.message ?? error}`);
}

// ─── Kit · pdf v3 ── the same in every recipe that exports a PDF
/** The Fontsource files the screen used, as TrueType, with their range and
 *  place: the nearest weight the family ships in that style, upright with no italic;
 *  latin, then what its letters need (kitSubsetsFor). */
async function fontsourceProvider(family, weight, style, request) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  const s = style === 'italic' && meta && !meta.styles.includes('italic') ? 'normal' : style;
  const shipped = meta ? await fontsourceWeights(family, s) : [];
  const weights = shipped.length ? shipped : [400, 700];
  const w = weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a));
  const text = String.fromCodePoint(...(request?.codePoints ?? []));
  const files = await Promise.all(['latin', ...kitSubsetsFor(text, meta)].map(async (subset, order) => {
    const res = await fetch(`${await fontsourceAt(id)}files/${id}-${subset}-${w}-${s}.woff2`);
    if (!res.ok) throw new Error(`Fontsource has no ${family} ${w} ${s} ${subset}`);
    return Object.assign(await decompressWoff2(new Uint8Array(await res.arrayBuffer())),
      { unicodeRange: kitRanges()[subset], order });
  }));
  return files.length === 1 ? files[0] : files;
}

/** A "Build the PDF" button; then "Open the PDF" (a new tab: CodePen's frame
 *  shows no PDFs) and a download link. */
function offerPdf(makePdf, filename) {
  viewer();
  const button = Object.assign(document.createElement('button'), { type: 'button', textContent: 'Build the PDF' });
  button.dataset.postextPdf = filename;
  button.addEventListener('click', async () => {
    button.disabled = true;
    button.textContent = 'Building the PDF…';
    try {
      const bytes = await makePdf();
      const url = URL.createObjectURL(new Blob([bytes], { type: 'application/pdf' }));
      const size = `${Math.max(1, Math.round(bytes.length / 1024))} KB`;
      button.replaceWith(
        Object.assign(document.createElement('a'), { href: url, target: '_blank', rel: 'noopener', textContent: 'Open the PDF ↗' }),
        Object.assign(document.createElement('a'), { href: url, download: filename, textContent: `Download ${filename} · ${size}` }));
    } catch (error) {
      button.disabled = false;
      button.textContent = 'Build the PDF';
      kitFail(error);
    }
  });
  document.getElementById('pt-actions').append(button);
}

// ─── Kit · images v3 ── recipes with pictures · postext.dev/cookbook
/** Registers a photo or PNG for the canvas and keeps its bytes for the PDF.
 *  fetch → ImageBitmap never taints the canvas (a plain cross-origin <img> would). */
async function loadImage(fileId, url) {
  const res = await fetch(url);
  if (!res.ok) throw new Error(`Image not found (${res.status}): ${url}`);
  const bytes = new Uint8Array(await res.arrayBuffer());
  registerResourceImage(fileId, await createImageBitmap(new Blob([bytes])));
  (loadImage.bytes ??= new Map()).set(fileId, bytes);
}

/** Registers SVG markup as a vector image, its fonts inside (inlineSvgFonts, ≥ 1.25).
 *  `options` go to registerResourceImage: { singleInk: true } tints it on the canvas. */
async function loadSvg(fileId, svg, options) {
  if (typeof inlineSvgFonts === 'function') svg = await inlineSvgFonts(svg, svgFaces);
  const img = new Image();
  img.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
  await img.decode();
  registerResourceImage(fileId, img, options);
  (loadImage.bytes ??= new Map()).set(fileId, new TextEncoder().encode(svg));
}

/** A face's Fontsource files: nearest weight; latin + what the SVG sets. */
async function svgFaces(family, weight, style, { codePoints = [] } = {}) {
  const [id, m] = [fontsourceId(family), await fontsourceMeta(family)];
  const w = m?.weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a)) ?? weight;
  const s = m?.styles.includes(style) === false ? 'normal' : style;
  return Promise.all(['latin', ...kitSubsetsFor(String.fromCodePoint(...codePoints), m)].map(async (x) => new Uint8Array(
    await (await fetch(`${await fontsourceAt(id)}files/${id}-${x}-${w}-${s}.woff2`)).arrayBuffer())));
}

/** renderToPdf({ resourceBytes: imageBytes }) */
function imageBytes(fileId) { return loadImage.bytes?.get(fileId); }

/** renderToHtml({ resourceImageUrl: imageUrl }) */
function imageUrl(fileId) {
  const bytes = imageBytes(fileId);
  if (!bytes) return undefined;
  imageUrl.urls ??= new Map();
  if (!imageUrl.urls.has(fileId)) {
    const type = /\.svg$/i.test(fileId) ? 'image/svg+xml' : /\.png$/i.test(fileId) ? 'image/png' : 'image/jpeg';
    imageUrl.urls.set(fileId, URL.createObjectURL(new Blob([bytes], { type })));
  }
  return imageUrl.urls.get(fileId);
}

// ─── /Kit ───────────────────────────────────────────────────────────────────────
```

## Variantes

### Estampa en plata

Cambia el hex y el CMYK de referencia; el acabado y la plancha se quedan.

```diff
-const foil = { hex: '#c9a24a', model: 'spot', spot: { name: 'Gold foil',
-  cmyk: { c: 15, m: 30, y: 75, k: 10 }, finish: { kind: 'foil', sheen: 'gloss' } } };
+const foil = { hex: '#b8bcc2', model: 'spot', spot: { name: 'Silver foil',
+  cmyk: { c: 20, m: 12, y: 10, k: 25 }, finish: { kind: 'foil', sheen: 'gloss' } } };
```

### Imprime el oro como tinta metálica

Una tinta metálica sale más barata que un clisé y se imprime con las demás tintas; Folio la muestra satinada.

```diff
-  cmyk: { c: 15, m: 30, y: 75, k: 10 }, finish: { kind: 'foil', sheen: 'gloss' } } };
+  cmyk: { c: 15, m: 30, y: 75, k: 10 }, finish: { kind: 'metallic' } } };
```

## Errores frecuentes

- Un papel de color puesto en `page.backgroundColor` con un hex corriente se imprime como una mancha de cuatricromía sobre toda la página. Define el papel en CMYK al 0 %, como aquí, cuando el color es el del soporte.
- Los filetes de menos de 0,25 pt y la letra de menos de 8 pt se empastan al estampar. Deja el oro para filetes y titulares.

## Créditos

- Receta: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- Texto: Seis poemas de Gerard Manley Hopkins, de Poems (1918), libro electrónico n.º 22403 del Proyecto Gutenberg: Gerard Manley Hopkins ([fuente](https://www.gutenberg.org/ebooks/22403)), dominio público
- Texto: Siete rimas de Gustavo Adolfo Bécquer, de sus Obras (1871): Gustavo Adolfo Bécquer, dominio público
- Imágenes: El nocturno frente al segundo poema, un gouache: Generated With Diffusion Models, original
- Tipografías: Cormorant Garamond (OFL-1.1), Cinzel (OFL-1.1), Cormorant SC (OFL-1.1)
- Código: MIT · Contenido de ejemplo: CC-BY-4.0

## Relacionadas

- [N.º 102 · Un fanzine grapado con pliego de cubierta de cartulina](https://postext.dev/es/cookbook/saddle-stitched-card-cover.md): Dos bloques :::paper ponen una cartulina salmón en el pliego exterior de un fanzine de ocho páginas, y postext-folio lo grapa a caballete con papel prensa. · Nivel 2 (Intermedio) · Revistas y fanzines
- [N.º 101 · Un muestrario con cada hoja en su papel](https://postext.dev/es/cookbook/paper-swatch-book.md): Cada hoja del muestrario de un almacén de papel va en un bloque :::paper, y postext-folio la dibuja con el tono, el gramaje y la rigidez de ese papel. · Nivel 2 (Intermedio) · Catálogos
- [N.º 024 · PDF listo para imprenta: sangrado, marcas de corte y PDF/X](https://postext.dev/es/cookbook/print-ready-pdf.md): Un folleto de exposición con 3 mm de sangrado y marcas de corte, exportado a PDF/X-4 sobre FOGRA51 con másteres de impresión y un preflight limpio. · Nivel 3 (Avanzado) · Hojas sueltas y efímeros
