bookcover-core 0.19.0 → 0.20.0

package/dist/data_file.js

@@ -1,5 +1,5 @@
 // Serialise all computed cover data into a Typst _data.typ file
-import { mm_to_typst } from './utils.js';
+import { mm_to_typst, text_dir } from './utils.js';
 import { escape_typst_str } from 'typst-utils';
 import { SCHEMA_DEFAULTS } from './defaults.js';
 /** Helper: emit a Typst #let binding for a millimetre value */
@@ -30,6 +30,10 @@ function color(name, hsl_str) {
 function content_raw(name, value) {
     return `#let ${name} = [${value}]`;
 }
+/** Helper: emit a Typst #let binding for a text's base direction (ltr/rtl) */
+function dir(name, text) {
+    return `#let ${name} = ${text_dir(text)}`;
+}
 /** Helper: emit a Typst #let binding for a number */
 function num(name, value) {
     return `#let ${name} = ${value}`;
@@ -90,6 +94,19 @@ export function build_data_file(schema, dims, colors, font_body_family, font_tit
     lines.push(bool('has_author', !!(schema.author)));
     lines.push(bool('has_blurb', !!(schema.blurb)));
     lines.push('');
+    // Base text direction per field (first-strong rule), so RTL text gets RTL punctuation and
+    // number placement. The blurb sets its own per paragraph (see form_schema.ts build_blurb).
+    // The spine's title + author pair is laid out in the title's direction (author if no title).
+    lines.push('// Text direction');
+    lines.push(dir('title1_dir', schema.title1 ?? ''));
+    lines.push(dir('title2_dir', schema.title2 ?? ''));
+    lines.push(dir('title3_dir', schema.title3 ?? ''));
+    lines.push(`#let subtitle_dirs = (${subtitle_lines.map(l => `${text_dir(l)}, `).join('')})`);
+    lines.push(dir('author_dir', schema.author ?? ''));
+    lines.push(dir('spine_title_dir', schema.spine_title ?? ''));
+    lines.push(dir('spine_author_dir', schema.spine_author ?? ''));
+    lines.push(dir('spine_dir', schema.spine_title || schema.spine_author || ''));
+    lines.push('');
     // Per-text sizing (relative multipliers, default 1.0)
     lines.push('// Per-text sizing');
     lines.push(num('title1_size', schema.title1_size ?? SCHEMA_DEFAULTS.title1_size));
@@ -154,12 +171,13 @@ export function build_data_file(schema, dims, colors, font_body_family, font_tit
     lines.push(str('title_position', schema.title_position));
     lines.push(str('subtitle_position', schema.subtitle_position));
     lines.push(str('author_position', schema.author_position));
-    // Alignment emitted as raw Typst values (left/center/right)
+    // Alignment emitted as raw Typst values (left/center/right). Justified text's last line sits
+    // at the logical start, which Typst resolves per paragraph — left for LTR, right for RTL
     lines.push(`#let title_alignment = ${schema.title_alignment ?? SCHEMA_DEFAULTS.title_alignment}`);
     lines.push(`#let subtitle_alignment = ${schema.subtitle_alignment ?? SCHEMA_DEFAULTS.subtitle_alignment}`);
     lines.push(`#let author_alignment = ${schema.author_alignment ?? SCHEMA_DEFAULTS.author_alignment}`);
     const blurb_align = schema.blurb_alignment ?? SCHEMA_DEFAULTS.blurb_alignment;
-    lines.push(`#let blurb_alignment = ${blurb_align === 'justified' ? 'left' : blurb_align}`);
+    lines.push(`#let blurb_alignment = ${blurb_align === 'justified' ? 'start' : blurb_align}`);
     lines.push(bool('blurb_justify', blurb_align === 'justified'));
     lines.push('');
     // Panel margins (all 4 sides of each panel, resolved to mm)

package/dist/defaults.d.ts

@@ -7,7 +7,7 @@ export declare const SCHEMA_VERSION = 1;
  *  the bundled pattern/vector/icon data. Hosts that re-render a frozen record later should
  *  record this at freeze time (alongside the typst version their wrapper reports) so a drifted
  *  reprint is detectable instead of silent. */
-export declare const RENDER_VERSION = 2;
+export declare const RENDER_VERSION = 3;
 /** What an omitted CoverSchema field resolves to at render time. Derived fields are absent by
  *  design — see the note at the top of this file. */
 export declare const SCHEMA_DEFAULTS: {

package/dist/defaults.js

@@ -19,7 +19,7 @@ export const SCHEMA_VERSION = 1;
  *  the bundled pattern/vector/icon data. Hosts that re-render a frozen record later should
  *  record this at freeze time (alongside the typst version their wrapper reports) so a drifted
  *  reprint is detectable instead of silent. */
-export const RENDER_VERSION = 2;
+export const RENDER_VERSION = 3;
 /** What an omitted CoverSchema field resolves to at render time. Derived fields are absent by
  *  design — see the note at the top of this file. */
 export const SCHEMA_DEFAULTS = {

package/dist/form_schema.js

@@ -2,7 +2,7 @@
 import { pm_to_typst } from 'pm-to-typst';
 import { hex_override_to_hsl } from './colors.js';
 import { find_pattern } from './patterns.js';
-import { warn_unknown } from './utils.js';
+import { warn_unknown, text_dir } from './utils.js';
 /** Replace straight quotes with typographic curly quotes */
 export function curly_quotes(text) {
     return text
@@ -15,14 +15,28 @@ export function curly_quotes(text) {
         // Remaining single quotes become closing (also covers apostrophes)
         .replace(/'/g, '’');
 }
+// Collect the raw text of a ProseMirror node and its descendants
+function pm_text(node) {
+    return node.type === 'text' ? node.text ?? '' : (node.content ?? []).map(pm_text).join('');
+}
 /**
  * Render the blurb document to Typst markup. pm_to_typst escapes the text and the blurb is
  * emitted as a Typst content block (see data_file.ts), so Typst's own smartquote curls the
  * quotes — no manual curling needed here, unlike the plain-string title fields below.
+ * Each top-level block (paragraph, heading, whole list, quote) takes its base direction from
+ * its own first strong letter, so an RTL paragraph gets RTL punctuation, list markers and
+ * justified last line while its LTR neighbours are untouched. Blocks nested inside a list or
+ * quote follow the enclosing block's direction.
  * Returns undefined when the blurb is empty.
  */
 function build_blurb(doc) {
-    const typst = pm_to_typst(doc);
+    const typst = pm_to_typst(doc, { nodes: {
+            doc: (node, ctx) => (node.content ?? []).map(child => {
+                const rendered = ctx.node(child);
+                return text_dir(pm_text(child)) === 'rtl'
+                    ? `#[#set text(dir: rtl)\n${rendered}\n]` : rendered;
+            }).join('\n\n'),
+        } });
     return typst.trim() ? typst : undefined;
 }
 /** Parse a font family name from user input. Accepts:

package/dist/generated/templates_data.js

@@ -2,7 +2,7 @@
 // Edit the source .typ files instead, then rerun the generator build
 /** The cover.typ / _helpers.typ templates baked in at this package version */
 export const DEFAULT_TEMPLATES = {
-    cover: "\n// Book cover template — receives all variables from _data.typ\n#import \"_data.typ\": *\n\n// -- Page setup --\n#set page(\n    width: total_width,\n    height: total_height,\n    margin: 0mm,\n)\n\n#set text(font: font_body_family)\n#set quote(block: true)\n#show quote: set pad(x: 3em)\n\n// ============================================================\n// Helper functions\n// ============================================================\n\n#import \"_helpers.typ\": *\n\n\n// ============================================================\n// Layer 1 — Background fills\n// ============================================================\n\n#place(\n    top + left,\n    rect(\n        width: total_width,\n        height: total_height,\n        fill: if has_front_gradient {\n            gradient.linear(\n                (color_front_gradient_start, 0%),\n                (color_front_bg, 30%),\n                (color_front_bg, 45%),\n                (color_front_gradient_end, 100%),\n                angle: -40deg,\n            )\n        } else {\n            color_front_bg\n        },\n    ),\n)\n\n\n#if has_pattern {\n    let tiled = pattern(\n        size: (pattern_tile_w, pattern_tile_h),\n        image(\"pattern.svg\", width: pattern_tile_w, height: pattern_tile_h),\n    )\n    place(\n        top + left,\n        rect(width: total_width, height: total_height, fill: tiled),\n    )\n}\n\n\n// ============================================================\n// Layer 2 — Background image\n// ============================================================\n\n#if has_image {\n    if image_coverage == \"full\" {\n        // Full spread: image covers entire canvas (back + spine + front)\n        place(\n            top + left,\n            dx: 0mm,\n            dy: 0mm,\n            image(\n                image_filename,\n                width: total_width,\n                height: total_height,\n                fit: if image_is_vector { \"stretch\" } else { \"cover\" },\n            ),\n        )\n    } else if image_coverage == \"painted\" {\n        // Painted: image inset on front cover — 15mm margin horizontally and from bottom, 50% trim height\n        let painted_w = face_width - 30mm\n        let painted_h = face_height * 0.5 // sync: index.ts painted_h = face_height * 0.5\n        place(\n            top + left,\n            dx: front_x + 15mm,\n            dy: bleed + face_height * (1/3),\n            image(\n                image_filename,\n                width: painted_w,\n                height: painted_h,\n                fit: \"stretch\",  // Should be exact but just in case, ensures full frame visible\n            ),\n        )\n    } else if image_coverage == \"feature\" {\n        // Feature: same size and position as painted but with rounded corners via box clip\n        let painted_w = face_width - 30mm\n        let painted_h = face_height * 0.5\n        place(\n            top + left,\n            dx: front_x + 15mm,\n            dy: bleed + face_height * (1/3),\n            box(\n                width: painted_w,\n                height: painted_h,\n                radius: 6mm,\n                clip: true,\n                image(\n                    image_filename,\n                    width: painted_w,\n                    height: painted_h,\n                    fit: \"cover\",\n                ),\n            ),\n        )\n    } else if image_coverage == \"front_partial\" {\n        // Lower 2/3: image covers the full front face width, bottom 2/3 of height, flush to the bottom trim edge\n        let w = face_width\n        let h = face_height * (2 / 3)\n        place(\n            top + left,\n            dx: front_x,\n            dy: bleed + face_height - h,\n            image(\n                image_filename,\n                width: w,\n                height: h,\n                fit: \"cover\",\n            ),\n        )\n    } else {\n        // Front only: image covers the front panel including all bleed margins\n        place(\n            top + left,\n            dx: front_x,\n            dy: 0mm,\n            image(\n                image_filename,\n                width: face_width + bleed,\n                height: total_height,\n                fit: if image_is_vector { \"stretch\" } else { \"cover\" },\n            ),\n        )\n    }\n}\n\n\n// ============================================================\n// Layer 2b — Icon on front cover\n// ============================================================\n\n#if has_icon {\n    let icon_size = calc.min(face_height * 0.4, face_width * 0.8)\n    if icon_mode != \"center\" {\n        icon_size = calc.min(face_height * 0.5, face_width * 0.8)\n    }\n    // Apply user-controlled size multiplier (1.0 = default)\n    icon_size = icon_size * icon_size_mod\n    let offset_icon_dx = front_x + (face_width - icon_size) + (icon_size * 0.15)\n    let offset_icon_dy = bleed * -1 + (icon_size * 0.15)\n\n    // Place ghost icons first (if any) so below main one\n    if icon_mode == \"echo\" {\n        place(\n            bottom + left,\n            dx: offset_icon_dx + icon_size * 0.1,\n            dy: offset_icon_dy - icon_size * 0.15,\n            image(\"icon_ghost.svg\", width: icon_size, height: icon_size),\n        )\n        place(\n            bottom + left,\n            dx: offset_icon_dx - icon_size * 0.1,\n            dy: offset_icon_dy + icon_size * 0.1,\n            image(\"icon_ghost2.svg\", width: icon_size, height: icon_size),\n        )\n    }\n\n    if icon_mode == \"center\" {\n        // Center — large icon centered horizontally, positioned in the lower/mid section\n        place(\n            bottom + left,\n            dx: front_x + (face_width - icon_size) / 2,\n            dy: (face_height * 0.2 + bleed) * -1,\n            image(\"icon_main.svg\", width: icon_size, height: icon_size),\n        )\n    } else {\n        // Offset/echo: large icon offset towards bottom-right, slightly overflowing the trim edge\n        place(\n            bottom + left,\n            dx: offset_icon_dx,\n            dy: offset_icon_dy,\n            image(\"icon_main.svg\", width: icon_size, height: icon_size),\n        )\n    }\n}\n\n\n// ============================================================\n// Layer 2c — Spine background\n// ============================================================\n\n// Spine background (only when spread has a spine) — drawn after pattern so it covers it\n#if has_spine and color_spine_bg != none {\n    place(\n        top + left,\n        dx: spine_x,\n        dy: 0mm,\n        rect(width: spine_width, height: total_height, fill: color_spine_bg),\n    )\n}\n\n\n// ============================================================\n// Layer 3 — Back panel content\n// ============================================================\n\n// back_margin, back_content_w, spiral_margin imported from _data.typ\n\n// Blurb container box with background color and 1cm padding around the text\n// Content is scaled down if it would overflow the available back-panel height\n#if has_blurb {\n    let blurb_content = {\n        set par(justify: true) if blurb_justify\n        set par(leading: 1em * blurb_spacing)\n        // Compact heading styles for a small blurb box — size and leading are hardcoded\n        // independent of blurb_spacing, since headings rarely wrap and need tight leading\n        show heading.where(level: 1): it => {\n            set block(above: 2em, below: 1em)\n            set text(size: 1.3em)\n            set par(leading: 0.5em)\n            it\n        }\n        show heading.where(level: 2): it => {\n            set block(above: 2em, below: 1em)\n            set text(size: 1.15em)\n            set par(leading: 0.5em)\n            it\n        }\n        align(blurb_alignment, text(\n            font: font_blurb_family,\n            size: fs_back_blurb * blurb_size,\n            fill: color_blurb,\n            blurb,\n        ))\n    }\n    let blurb_max_h = back_content_h - blurb_padding * 2\n    place(\n        top + left,\n        // Centered within the safe area, not the full face — spiral_margin is 0 for other bindings\n        dx: back_x + (face_width - spiral_margin - blurb_width) / 2,\n        dy: bleed + back_margin,\n        rect(\n            width: blurb_width,\n            fill: color_blurb_bg,\n            stroke: none,\n            radius: 1.5mm,\n            inset: blurb_padding,\n            context {\n                let avail_w = blurb_width - blurb_padding * 2\n                let natural = measure(blurb_content, width: avail_w)\n                if natural.height > blurb_max_h {\n                    let ratio = blurb_max_h / natural.height\n                    scale(x: ratio * 100%, y: ratio * 100%, reflow: true, blurb_content)\n                } else {\n                    blurb_content\n                }\n            },\n        ),\n    )\n}\n\n// ISBN barcode — position and size from printing-services cover_region_barcode\n#if has_barcode {\n    place(\n        bottom + left,\n        dx: barcode_x,\n        dy: barcode_y * -1,\n        image(\"barcode.svg\", width: barcode_w, height: barcode_h),\n    )\n}\n\n// ============================================================\n// Layer 4 — Spine content\n// ============================================================\n\n#if has_spine and has_spine_text and fs_spine_title > 0mm {\n    // Title rotated along spine (bottom-to-top reading direction).\n    // place() anchors the unrotated bounding box top-left, so we subtract\n    // half the unrotated dimensions to keep the visual center on the spine.\n    place(\n        top + left,\n        dx: spine_x + spine_width * 0.5 - face_height * 0.4,\n        dy: bleed + face_height * 0.5 - spine_width * 0.5,\n        rotate(\n            90deg,\n            origin: center,\n            box(\n                width: face_height * 0.8,\n                height: spine_width,\n                align(\n                    center + horizon,\n                    // Shrink title + author together as one unit if they overflow the spine length\n                    shrink-to-width(\n                        stack(\n                            dir: ltr,\n                            spacing: spine_width * 0.3,\n                            text(\n                                font: font_spine_title_family,\n                                size: fs_spine_title * spine_title_size_mod,\n                                fill: color_spine_title,\n                                weight: spine_title_weight,\n                                style: if spine_title_italic { \"italic\" } else { \"normal\" },\n                                spine_title,\n                            ),\n                            if has_author and fs_spine_author > 0mm {\n                                text(\n                                    font: font_spine_author_family,\n                                    size: fs_spine_author * spine_author_size_mod,\n                                    fill: color_spine_author,\n                                    weight: spine_author_weight,\n                                    style: if spine_author_italic { \"italic\" } else { \"normal\" },\n                                    spine_author,\n                                )\n                            },\n                        ),\n                    ),\n                ),\n            ),\n        ),\n    )\n}\n\n// Small icon at the bottom of the spine (when spine is wide enough for text)\n#if has_spine_icon {\n    let spine_icon_size = spine_width * 0.7\n    let spine_icon_side_margin = (spine_width - spine_icon_size) / 2\n    // Bottom margin is twice the side margin\n    let spine_icon_bottom_margin = spine_icon_side_margin * 2\n    place(\n        top + left,\n        dx: spine_x + spine_icon_side_margin,\n        dy: bleed + face_height - spine_icon_size - spine_icon_bottom_margin,\n        image(\"icon_spine.svg\", width: spine_icon_size, height: spine_icon_size),\n    )\n}\n\n// ============================================================\n// Layer 5 — Front panel content\n// ============================================================\n\n// front_margin, front_content_w, spiral_margin imported from _data.typ\n\n// Base font size — proportional to trim height, multiplied by per-title size modifier\n#let fs_title_base = face_height * 0.05\n#let fs_subtitle = face_height * 0.025 * subtitle_size\n#let fs_author = face_height * 0.035 * author_size\n\n// Render a single title line with its per-title styling, shrunk to fit if too wide\n#let render_title(txt, font_family, size_mod, weight, is_italic, color) = {\n    if txt != \"\" {\n        box(\n            width: front_content_w,\n            shrink-to-width(\n                align(title_alignment, text(\n                    font: font_family,\n                    size: fs_title_base * size_mod,\n                    fill: color,\n                    weight: weight,\n                    style: if is_italic { \"italic\" } else { \"normal\" },\n                    txt,\n                )),\n            ),\n        )\n    }\n}\n\n// Render each title line, then filter out empty ones so they don't create stack spacing gaps\n#let title_lines_rendered = stack(\n    dir: ttb,\n    spacing: face_height * title_spacing / 100,\n    ..(\n        render_title(title1, font_title1_family, title1_size, title1_weight, title1_italic, color_front_title1),\n        render_title(title2, font_title2_family, title2_size, title2_weight, title2_italic, color_front_title2),\n        render_title(title3, font_title3_family, title3_size, title3_weight, title3_italic, color_front_title3),\n    ).filter(x => x != none),\n)\n\n// All subtitle lines in one container — shrink-to-width scales them all together uniformly\n// text() wraps shrink-to-width so inner content inherits the scaled size (no explicit size inside)\n#let subtitle_lines_rendered = text(\n    font: font_subtitle_family,\n    size: fs_subtitle,\n    weight: subtitle_weight,\n    style: if subtitle_italic { \"italic\" } else { \"normal\" },\n    fill: color_front_subtitle,\n    box(\n        width: front_content_w,\n        shrink-to-width(\n            stack(\n                dir: ttb,\n                spacing: face_height * subtitle_spacing / 100,\n                ..subtitle_lines.map(line => align(subtitle_alignment, line)),\n            )\n        ),\n    ),\n)\n\n// Author styled text — single line, shrunk to fit width\n#let author_rendered = box(\n    width: front_content_w,\n    shrink-to-width(\n        align(author_alignment, text(\n            font: font_author_family,\n            size: fs_author,\n            fill: color_front_author,\n            weight: author_weight,\n            style: if author_italic { \"italic\" } else { \"normal\" },\n            author,\n        )),\n    ),\n)\n\n// Title group: stacked title lines\n#let title_group = stack(\n    dir: ttb,\n    spacing: face_height * title_spacing / 100,\n    title_lines_rendered,\n)\n\n// Check which elements belong to each position box\n#let top_has_title = title_position == \"top\"\n#let top_has_subtitle = has_subtitle and subtitle_position == \"top\"\n#let top_has_author = has_author and author_position == \"top\"\n#let top_has_any = top_has_title or top_has_subtitle or top_has_author\n\n#let mid_has_title = title_position == \"middle\"\n#let mid_has_subtitle = has_subtitle and subtitle_position == \"middle\"\n#let mid_has_author = has_author and author_position == \"middle\"\n#let mid_has_any = mid_has_title or mid_has_subtitle or mid_has_author\n\n#let bot_has_title = title_position == \"bottom\"\n#let bot_has_subtitle = has_subtitle and subtitle_position == \"bottom\"\n#let bot_has_author = has_author and author_position == \"bottom\"\n#let bot_has_any = bot_has_title or bot_has_subtitle or bot_has_author\n\n// Build a content group for a position box (order within box: title | subtitle | author)\n// Each element gets its own vertical margins inside the box\n#let make_pos_box(has_t, has_s, has_a) = box(\n    width: front_content_w,\n    stack(\n        dir: ttb,\n        if has_t { v(face_height * title_margin_top / 100) },\n        if has_t { title_group },\n        if has_t { v(face_height * title_margin_bottom / 100) },\n        if has_s { v(face_height * subtitle_margin_top / 100) },\n        if has_s { subtitle_lines_rendered },\n        if has_s { v(face_height * subtitle_margin_bottom / 100) },\n        if has_a { v(face_height * author_margin_top / 100) },\n        if has_a { author_rendered },\n        if has_a { v(face_height * author_margin_bottom / 100) },\n    ),\n)\n\n// Place each non-empty position box on the front panel (within panel margin on all sides)\n#if top_has_any {\n    place(\n        top + left,\n        dx: front_x + front_margin + spiral_margin,\n        dy: bleed + front_margin,\n        make_pos_box(top_has_title, top_has_subtitle, top_has_author),\n    )\n}\n#if mid_has_any {\n    place(\n        horizon + left,\n        dx: front_x + front_margin + spiral_margin,\n        make_pos_box(mid_has_title, mid_has_subtitle, mid_has_author),\n    )\n}\n#if bot_has_any {\n    place(\n        bottom + left,\n        dx: front_x + front_margin + spiral_margin,\n        dy: (bleed + front_margin) * -1,\n        make_pos_box(bot_has_title, bot_has_subtitle, bot_has_author),\n    )\n}\n\n\n// ============================================================\n// Layer 6 — Home-print margin (white rounded borders for home inkjet printers)\n// ============================================================\n\n#if home_print {\n    // Render the back and front as two separate rounded cards, each with a white\n    // border, so a home printer that can't reach the paper edge still prints\n    // cleanly. One white matte covers the spread with two rounded windows punched\n    // out — one per trim face, each inset by `home_margin` on all sides with\n    // `home_corner`-rounded corners. Windows track the trim faces (not a spine-\n    // centre split), so the bleed and spine become white gutter and every side —\n    // including the inner/gutter edge — gets a real margin. A single matte (vs.\n    // two abutting ones) avoids a hairline seam down the gutter.\n    let m = home_margin\n    let win_w = face_width - 2 * m\n    let win_h = face_height - 2 * m\n    let win_y = bleed + m\n    let back_win = (bleed + m, win_y, win_w, win_h)\n    let front_win = (total_width - bleed - face_width + m, win_y, win_w, win_h)\n    home-print-matte(total_width, total_height, (back_win, front_win), home_corner)\n}\n",
+    cover: "\n// Book cover template — receives all variables from _data.typ\n#import \"_data.typ\": *\n\n// -- Page setup --\n#set page(\n    width: total_width,\n    height: total_height,\n    margin: 0mm,\n)\n\n#set text(font: font_body_family)\n#set quote(block: true)\n#show quote: set pad(x: 3em)\n\n// ============================================================\n// Helper functions\n// ============================================================\n\n#import \"_helpers.typ\": *\n\n\n// ============================================================\n// Layer 1 — Background fills\n// ============================================================\n\n#place(\n    top + left,\n    rect(\n        width: total_width,\n        height: total_height,\n        fill: if has_front_gradient {\n            gradient.linear(\n                (color_front_gradient_start, 0%),\n                (color_front_bg, 30%),\n                (color_front_bg, 45%),\n                (color_front_gradient_end, 100%),\n                angle: -40deg,\n            )\n        } else {\n            color_front_bg\n        },\n    ),\n)\n\n\n#if has_pattern {\n    let tiled = pattern(\n        size: (pattern_tile_w, pattern_tile_h),\n        image(\"pattern.svg\", width: pattern_tile_w, height: pattern_tile_h),\n    )\n    place(\n        top + left,\n        rect(width: total_width, height: total_height, fill: tiled),\n    )\n}\n\n\n// ============================================================\n// Layer 2 — Background image\n// ============================================================\n\n#if has_image {\n    if image_coverage == \"full\" {\n        // Full spread: image covers entire canvas (back + spine + front)\n        place(\n            top + left,\n            dx: 0mm,\n            dy: 0mm,\n            image(\n                image_filename,\n                width: total_width,\n                height: total_height,\n                fit: if image_is_vector { \"stretch\" } else { \"cover\" },\n            ),\n        )\n    } else if image_coverage == \"painted\" {\n        // Painted: image inset on front cover — 15mm margin horizontally and from bottom, 50% trim height\n        let painted_w = face_width - 30mm\n        let painted_h = face_height * 0.5 // sync: index.ts painted_h = face_height * 0.5\n        place(\n            top + left,\n            dx: front_x + 15mm,\n            dy: bleed + face_height * (1/3),\n            image(\n                image_filename,\n                width: painted_w,\n                height: painted_h,\n                fit: \"stretch\",  // Should be exact but just in case, ensures full frame visible\n            ),\n        )\n    } else if image_coverage == \"feature\" {\n        // Feature: same size and position as painted but with rounded corners via box clip\n        let painted_w = face_width - 30mm\n        let painted_h = face_height * 0.5\n        place(\n            top + left,\n            dx: front_x + 15mm,\n            dy: bleed + face_height * (1/3),\n            box(\n                width: painted_w,\n                height: painted_h,\n                radius: 6mm,\n                clip: true,\n                image(\n                    image_filename,\n                    width: painted_w,\n                    height: painted_h,\n                    fit: \"cover\",\n                ),\n            ),\n        )\n    } else if image_coverage == \"front_partial\" {\n        // Lower 2/3: image covers the full front face width, bottom 2/3 of height, flush to the bottom trim edge\n        let w = face_width\n        let h = face_height * (2 / 3)\n        place(\n            top + left,\n            dx: front_x,\n            dy: bleed + face_height - h,\n            image(\n                image_filename,\n                width: w,\n                height: h,\n                fit: \"cover\",\n            ),\n        )\n    } else {\n        // Front only: image covers the front panel including all bleed margins\n        place(\n            top + left,\n            dx: front_x,\n            dy: 0mm,\n            image(\n                image_filename,\n                width: face_width + bleed,\n                height: total_height,\n                fit: if image_is_vector { \"stretch\" } else { \"cover\" },\n            ),\n        )\n    }\n}\n\n\n// ============================================================\n// Layer 2b — Icon on front cover\n// ============================================================\n\n#if has_icon {\n    let icon_size = calc.min(face_height * 0.4, face_width * 0.8)\n    if icon_mode != \"center\" {\n        icon_size = calc.min(face_height * 0.5, face_width * 0.8)\n    }\n    // Apply user-controlled size multiplier (1.0 = default)\n    icon_size = icon_size * icon_size_mod\n    let offset_icon_dx = front_x + (face_width - icon_size) + (icon_size * 0.15)\n    let offset_icon_dy = bleed * -1 + (icon_size * 0.15)\n\n    // Place ghost icons first (if any) so below main one\n    if icon_mode == \"echo\" {\n        place(\n            bottom + left,\n            dx: offset_icon_dx + icon_size * 0.1,\n            dy: offset_icon_dy - icon_size * 0.15,\n            image(\"icon_ghost.svg\", width: icon_size, height: icon_size),\n        )\n        place(\n            bottom + left,\n            dx: offset_icon_dx - icon_size * 0.1,\n            dy: offset_icon_dy + icon_size * 0.1,\n            image(\"icon_ghost2.svg\", width: icon_size, height: icon_size),\n        )\n    }\n\n    if icon_mode == \"center\" {\n        // Center — large icon centered horizontally, positioned in the lower/mid section\n        place(\n            bottom + left,\n            dx: front_x + (face_width - icon_size) / 2,\n            dy: (face_height * 0.2 + bleed) * -1,\n            image(\"icon_main.svg\", width: icon_size, height: icon_size),\n        )\n    } else {\n        // Offset/echo: large icon offset towards bottom-right, slightly overflowing the trim edge\n        place(\n            bottom + left,\n            dx: offset_icon_dx,\n            dy: offset_icon_dy,\n            image(\"icon_main.svg\", width: icon_size, height: icon_size),\n        )\n    }\n}\n\n\n// ============================================================\n// Layer 2c — Spine background\n// ============================================================\n\n// Spine background (only when spread has a spine) — drawn after pattern so it covers it\n#if has_spine and color_spine_bg != none {\n    place(\n        top + left,\n        dx: spine_x,\n        dy: 0mm,\n        rect(width: spine_width, height: total_height, fill: color_spine_bg),\n    )\n}\n\n\n// ============================================================\n// Layer 3 — Back panel content\n// ============================================================\n\n// back_margin, back_content_w, spiral_margin imported from _data.typ\n\n// Blurb container box with background color and 1cm padding around the text\n// Content is scaled down if it would overflow the available back-panel height\n#if has_blurb {\n    let blurb_content = {\n        set par(justify: true) if blurb_justify\n        set par(leading: 1em * blurb_spacing)\n        // Compact heading styles for a small blurb box — size and leading are hardcoded\n        // independent of blurb_spacing, since headings rarely wrap and need tight leading\n        show heading.where(level: 1): it => {\n            set block(above: 2em, below: 1em)\n            set text(size: 1.3em)\n            set par(leading: 0.5em)\n            it\n        }\n        show heading.where(level: 2): it => {\n            set block(above: 2em, below: 1em)\n            set text(size: 1.15em)\n            set par(leading: 0.5em)\n            it\n        }\n        align(blurb_alignment, text(\n            font: font_blurb_family,\n            size: fs_back_blurb * blurb_size,\n            fill: color_blurb,\n            blurb,\n        ))\n    }\n    let blurb_max_h = back_content_h - blurb_padding * 2\n    place(\n        top + left,\n        // Centered within the safe area, not the full face — spiral_margin is 0 for other bindings\n        dx: back_x + (face_width - spiral_margin - blurb_width) / 2,\n        dy: bleed + back_margin,\n        rect(\n            width: blurb_width,\n            fill: color_blurb_bg,\n            stroke: none,\n            radius: 1.5mm,\n            inset: blurb_padding,\n            context {\n                let avail_w = blurb_width - blurb_padding * 2\n                let natural = measure(blurb_content, width: avail_w)\n                if natural.height > blurb_max_h {\n                    let ratio = blurb_max_h / natural.height\n                    scale(x: ratio * 100%, y: ratio * 100%, reflow: true, blurb_content)\n                } else {\n                    blurb_content\n                }\n            },\n        ),\n    )\n}\n\n// ISBN barcode — position and size from printing-services cover_region_barcode\n#if has_barcode {\n    place(\n        bottom + left,\n        dx: barcode_x,\n        dy: barcode_y * -1,\n        image(\"barcode.svg\", width: barcode_w, height: barcode_h),\n    )\n}\n\n// ============================================================\n// Layer 4 — Spine content\n// ============================================================\n\n#if has_spine and has_spine_text and fs_spine_title > 0mm {\n    // Title rotated along spine (bottom-to-top reading direction).\n    // place() anchors the unrotated bounding box top-left, so we subtract\n    // half the unrotated dimensions to keep the visual center on the spine.\n    // The title + author pair runs in the title's direction, so for RTL the title\n    // comes first reading right-to-left (bottom-to-top once rotated).\n    place(\n        top + left,\n        dx: spine_x + spine_width * 0.5 - face_height * 0.4,\n        dy: bleed + face_height * 0.5 - spine_width * 0.5,\n        rotate(\n            90deg,\n            origin: center,\n            box(\n                width: face_height * 0.8,\n                height: spine_width,\n                align(\n                    center + horizon,\n                    // Shrink title + author together as one unit if they overflow the spine length\n                    shrink-to-width(\n                        stack(\n                            dir: spine_dir,\n                            spacing: spine_width * 0.3,\n                            text(\n                                dir: spine_title_dir,\n                                font: font_spine_title_family,\n                                size: fs_spine_title * spine_title_size_mod,\n                                fill: color_spine_title,\n                                weight: spine_title_weight,\n                                style: if spine_title_italic { \"italic\" } else { \"normal\" },\n                                spine_title,\n                            ),\n                            if has_author and fs_spine_author > 0mm {\n                                text(\n                                    dir: spine_author_dir,\n                                    font: font_spine_author_family,\n                                    size: fs_spine_author * spine_author_size_mod,\n                                    fill: color_spine_author,\n                                    weight: spine_author_weight,\n                                    style: if spine_author_italic { \"italic\" } else { \"normal\" },\n                                    spine_author,\n                                )\n                            },\n                        ),\n                    ),\n                ),\n            ),\n        ),\n    )\n}\n\n// Small icon at the bottom of the spine (when spine is wide enough for text)\n#if has_spine_icon {\n    let spine_icon_size = spine_width * 0.7\n    let spine_icon_side_margin = (spine_width - spine_icon_size) / 2\n    // Bottom margin is twice the side margin\n    let spine_icon_bottom_margin = spine_icon_side_margin * 2\n    place(\n        top + left,\n        dx: spine_x + spine_icon_side_margin,\n        dy: bleed + face_height - spine_icon_size - spine_icon_bottom_margin,\n        image(\"icon_spine.svg\", width: spine_icon_size, height: spine_icon_size),\n    )\n}\n\n// ============================================================\n// Layer 5 — Front panel content\n// ============================================================\n\n// front_margin, front_content_w, spiral_margin imported from _data.typ\n\n// Base font size — proportional to trim height, multiplied by per-title size modifier\n#let fs_title_base = face_height * 0.05\n#let fs_subtitle = face_height * 0.025 * subtitle_size\n#let fs_author = face_height * 0.035 * author_size\n\n// Render a single title line with its per-title styling, shrunk to fit if too wide\n#let render_title(txt, font_family, size_mod, weight, is_italic, color, txt_dir) = {\n    if txt != \"\" {\n        box(\n            width: front_content_w,\n            shrink-to-width(\n                align(title_alignment, text(\n                    dir: txt_dir,\n                    font: font_family,\n                    size: fs_title_base * size_mod,\n                    fill: color,\n                    weight: weight,\n                    style: if is_italic { \"italic\" } else { \"normal\" },\n                    txt,\n                )),\n            ),\n        )\n    }\n}\n\n// Render each title line, then filter out empty ones so they don't create stack spacing gaps\n#let title_lines_rendered = stack(\n    dir: ttb,\n    spacing: face_height * title_spacing / 100,\n    ..(\n        render_title(title1, font_title1_family, title1_size, title1_weight, title1_italic, color_front_title1, title1_dir),\n        render_title(title2, font_title2_family, title2_size, title2_weight, title2_italic, color_front_title2, title2_dir),\n        render_title(title3, font_title3_family, title3_size, title3_weight, title3_italic, color_front_title3, title3_dir),\n    ).filter(x => x != none),\n)\n\n// All subtitle lines in one container — shrink-to-width scales them all together uniformly\n// text() wraps shrink-to-width so inner content inherits the scaled size (no explicit size inside)\n#let subtitle_lines_rendered = text(\n    font: font_subtitle_family,\n    size: fs_subtitle,\n    weight: subtitle_weight,\n    style: if subtitle_italic { \"italic\" } else { \"normal\" },\n    fill: color_front_subtitle,\n    box(\n        width: front_content_w,\n        shrink-to-width(\n            stack(\n                dir: ttb,\n                spacing: face_height * subtitle_spacing / 100,\n                ..subtitle_lines.zip(subtitle_dirs).map(((line, line_dir)) => align(\n                    subtitle_alignment, text(dir: line_dir, line),\n                )),\n            )\n        ),\n    ),\n)\n\n// Author styled text — single line, shrunk to fit width\n#let author_rendered = box(\n    width: front_content_w,\n    shrink-to-width(\n        align(author_alignment, text(\n            dir: author_dir,\n            font: font_author_family,\n            size: fs_author,\n            fill: color_front_author,\n            weight: author_weight,\n            style: if author_italic { \"italic\" } else { \"normal\" },\n            author,\n        )),\n    ),\n)\n\n// Title group: stacked title lines\n#let title_group = stack(\n    dir: ttb,\n    spacing: face_height * title_spacing / 100,\n    title_lines_rendered,\n)\n\n// Check which elements belong to each position box\n#let top_has_title = title_position == \"top\"\n#let top_has_subtitle = has_subtitle and subtitle_position == \"top\"\n#let top_has_author = has_author and author_position == \"top\"\n#let top_has_any = top_has_title or top_has_subtitle or top_has_author\n\n#let mid_has_title = title_position == \"middle\"\n#let mid_has_subtitle = has_subtitle and subtitle_position == \"middle\"\n#let mid_has_author = has_author and author_position == \"middle\"\n#let mid_has_any = mid_has_title or mid_has_subtitle or mid_has_author\n\n#let bot_has_title = title_position == \"bottom\"\n#let bot_has_subtitle = has_subtitle and subtitle_position == \"bottom\"\n#let bot_has_author = has_author and author_position == \"bottom\"\n#let bot_has_any = bot_has_title or bot_has_subtitle or bot_has_author\n\n// Build a content group for a position box (order within box: title | subtitle | author)\n// Each element gets its own vertical margins inside the box\n#let make_pos_box(has_t, has_s, has_a) = box(\n    width: front_content_w,\n    stack(\n        dir: ttb,\n        if has_t { v(face_height * title_margin_top / 100) },\n        if has_t { title_group },\n        if has_t { v(face_height * title_margin_bottom / 100) },\n        if has_s { v(face_height * subtitle_margin_top / 100) },\n        if has_s { subtitle_lines_rendered },\n        if has_s { v(face_height * subtitle_margin_bottom / 100) },\n        if has_a { v(face_height * author_margin_top / 100) },\n        if has_a { author_rendered },\n        if has_a { v(face_height * author_margin_bottom / 100) },\n    ),\n)\n\n// Place each non-empty position box on the front panel (within panel margin on all sides)\n#if top_has_any {\n    place(\n        top + left,\n        dx: front_x + front_margin + spiral_margin,\n        dy: bleed + front_margin,\n        make_pos_box(top_has_title, top_has_subtitle, top_has_author),\n    )\n}\n#if mid_has_any {\n    place(\n        horizon + left,\n        dx: front_x + front_margin + spiral_margin,\n        make_pos_box(mid_has_title, mid_has_subtitle, mid_has_author),\n    )\n}\n#if bot_has_any {\n    place(\n        bottom + left,\n        dx: front_x + front_margin + spiral_margin,\n        dy: (bleed + front_margin) * -1,\n        make_pos_box(bot_has_title, bot_has_subtitle, bot_has_author),\n    )\n}\n\n\n// ============================================================\n// Layer 6 — Home-print margin (white rounded borders for home inkjet printers)\n// ============================================================\n\n#if home_print {\n    // Render the back and front as two separate rounded cards, each with a white\n    // border, so a home printer that can't reach the paper edge still prints\n    // cleanly. One white matte covers the spread with two rounded windows punched\n    // out — one per trim face, each inset by `home_margin` on all sides with\n    // `home_corner`-rounded corners. Windows track the trim faces (not a spine-\n    // centre split), so the bleed and spine become white gutter and every side —\n    // including the inner/gutter edge — gets a real margin. A single matte (vs.\n    // two abutting ones) avoids a hairline seam down the gutter.\n    let m = home_margin\n    let win_w = face_width - 2 * m\n    let win_h = face_height - 2 * m\n    let win_y = bleed + m\n    let back_win = (bleed + m, win_y, win_w, win_h)\n    let front_win = (total_width - bleed - face_width + m, win_y, win_w, win_h)\n    home-print-matte(total_width, total_height, (back_win, front_win), home_corner)\n}\n",
     helpers: "\n// Shared helper functions for the cover template\n\n// Scale content so it fits within the container width using geometric scaling.\n// Uses scale() rather than text(size: ...) so inner explicit font sizes are also scaled.\n#let fit-to-width(max-text-size: auto, min-text-size: 2mm, it) = context {\n    let effective-max = if max-text-size == auto { text.size * 3 } else { max-text-size }\n    let effective-min = if min-text-size == auto { text.size * 0.33 } else { min-text-size }\n    // Express size limits as dimensionless ratios relative to current text size\n    let max-ratio = effective-max / text.size\n    let min-ratio = effective-min / text.size\n    let contentsize = measure(it)\n    layout(size => {\n        if contentsize.width > 0mm {\n            let ratio = calc.min(size.width / contentsize.width, size.height / contentsize.height)\n            let clamped = calc.max(calc.min(ratio, max-ratio), min-ratio)\n            if clamped != 1.0 {\n                scale(x: clamped * 100%, y: clamped * 100%, reflow: true, it)\n            } else {\n                it\n            }\n        }\n    })\n}\n\n// Variant that only shrinks (never grows beyond current text size)\n#let shrink-to-width(min-text-size: auto, it) = context {\n    fit-to-width(max-text-size: text.size, min-text-size: min-text-size, it)\n}\n\n// Curve segments tracing one rounded rectangle (absolute coords), for compositing\n// into a larger path. Corners use a cubic-bezier handle (0.5523r) to approximate arcs.\n#let rounded-subpath(x, y, w, h, r) = {\n    let k = 0.5523 * r\n    (\n        curve.move((x + r, y), relative: false),\n        curve.line((x + w - r, y), relative: false),\n        curve.cubic((x + w - r + k, y), (x + w, y + r - k), (x + w, y + r), relative: false),\n        curve.line((x + w, y + h - r), relative: false),\n        curve.cubic((x + w, y + h - r + k), (x + w - r + k, y + h), (x + w - r, y + h), relative: false),\n        curve.line((x + r, y + h), relative: false),\n        curve.cubic((x + r - k, y + h), (x, y + h - r + k), (x, y + h - r), relative: false),\n        curve.line((x, y + r), relative: false),\n        curve.cubic((x, y + r - k), (x + r - k, y), (x + r, y), relative: false),\n        curve.close(),\n    )\n}\n\n// White \"matte\" covering the whole canvas (cw × ch) with rounded-rect windows\n// punched out via even-odd fill, so the artwork shows through each window as a\n// rounded card surrounded by a white border. Used for home-print margins on\n// edge-to-edge-incapable printers. `windows` is an array of (x, y, w, h) tuples.\n#let home-print-matte(cw, ch, windows, r) = {\n    let segs = (\n        curve.move((0mm, 0mm), relative: false),\n        curve.line((cw, 0mm), relative: false),\n        curve.line((cw, ch), relative: false),\n        curve.line((0mm, ch), relative: false),\n        curve.close(),\n    )\n    for win in windows {\n        segs = segs + rounded-subpath(win.at(0), win.at(1), win.at(2), win.at(3), r)\n    }\n    place(top + left, curve(fill: white, fill-rule: \"even-odd\", ..segs))\n}\n",
 };
 //# sourceMappingURL=templates_data.js.map

package/dist/utils.d.ts

@@ -4,6 +4,10 @@ export declare function mm_to_typst(mm: number): string;
 export declare function clamp(value: number, min: number, max: number): number;
 /** Derive the default spine title by joining all the title lines */
 export declare function default_spine_title(title1?: string, title2?: string, title3?: string): string;
+/** A text's base direction by the Unicode first-strong rule (as HTML's dir="auto"): the first
+ *  letter decides, so a Hebrew sentence quoting an English word is still RTL. Text with no
+ *  letters at all (digits, punctuation) is LTR. */
+export declare function text_dir(text: string): 'ltr' | 'rtl';
 /** Report a value naming something this package version doesn't have (a pruned or renamed
  *  pattern, vector background, or background image). The feature is dropped rather than failing
  *  the whole render, but never silently — a missing ID means a stored record can no longer be

package/dist/utils.js

@@ -15,6 +15,34 @@ export function default_spine_title(title1, title2, title3) {
         .trim()
         .replace(/ +/g, ' ');
 }
+// Unicode scripts whose letters are strong right-to-left (bidi class R or AL). Built from names
+// so any the JS engine's Unicode database doesn't know yet are skipped rather than throwing
+const RTL_SCRIPTS = [
+    'Hebrew', 'Arabic', 'Syriac', 'Thaana', 'Nko', 'Samaritan', 'Mandaic', 'Adlam',
+    'Hanifi_Rohingya', 'Yezidi', 'Mende_Kikakui', 'Garay', 'Imperial_Aramaic', 'Phoenician',
+    'Kharoshthi', 'Old_South_Arabian', 'Old_North_Arabian', 'Avestan', 'Inscriptional_Parthian',
+    'Inscriptional_Pahlavi', 'Psalter_Pahlavi', 'Old_Turkic', 'Old_Hungarian', 'Nabataean',
+    'Palmyrene', 'Hatran', 'Manichaean', 'Elymaic', 'Sogdian', 'Old_Sogdian', 'Old_Uyghur',
+    'Chorasmian', 'Lydian', 'Meroitic_Cursive', 'Meroitic_Hieroglyphs', 'Cypriot',
+].filter(script => {
+    try {
+        new RegExp(`\\p{Script=${script}}`, 'u');
+        return true;
+    }
+    catch {
+        return false;
+    }
+});
+const RTL_REGEX = new RegExp(`[${RTL_SCRIPTS.map(s => `\\p{Script=${s}}`).join('')}\\u200F\\u061C]`, 'u');
+// Strong directional characters: letters, plus the LRM/RLM/ALM marks typed to force a direction
+const STRONG_REGEX = /[\p{L}‎‏؜]/u;
+/** A text's base direction by the Unicode first-strong rule (as HTML's dir="auto"): the first
+ *  letter decides, so a Hebrew sentence quoting an English word is still RTL. Text with no
+ *  letters at all (digits, punctuation) is LTR. */
+export function text_dir(text) {
+    const strong = STRONG_REGEX.exec(text);
+    return strong && RTL_REGEX.test(strong[0]) ? 'rtl' : 'ltr';
+}
 /** Report a value naming something this package version doesn't have (a pruned or renamed
  *  pattern, vector background, or background image). The feature is dropped rather than failing
  *  the whole render, but never silently — a missing ID means a stored record can no longer be

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bookcover-core",
-    "version": "0.19.0",
+    "version": "0.20.0",
     "license": "MIT-0",
     "repository": {
         "type": "git",