bookcover-core 0.13.0 → 0.15.0

package/dist/barcode.d.ts

@@ -1,7 +1,13 @@
 /**
  * Generate an ISBN-13 barcode as SVG bytes sized to the given region.
- * Uses toSVG() which is platform-independent (no canvas / Node Buffer required).
  * width_mm/height_mm are from printing-services cover_region_barcode (mm).
+ *
+ * Calls the isbn encoder directly rather than bwip-js's toSVG(). toSVG() dispatches on the
+ * bcid string, and that lookup table references all ~110 symbologies, so none of them can be
+ * dropped — the dispatch alone costs ~1.5MB of encoders we never use. Naming the encoder
+ * leaves only its own code reachable. The 'generic' entry point also avoids the canvas/DOM
+ * path, which is dead weight here on both platforms. Output is unchanged: this is the same
+ * encoder and the same SVG drawing backend toSVG() would have reached.
  */
 export declare function generate_isbn_barcode(isbn: string, width_mm: number, height_mm: number): Uint8Array;
 //# sourceMappingURL=barcode.d.ts.map

package/dist/barcode.js

@@ -1,16 +1,22 @@
 // ISBN barcode generation using bwip-js (SVG output — works in both Node and browser)
-import * as bwipjs from 'bwip-js';
+import { isbn as bwipp_isbn, drawingSVG } from 'bwip-js/generic';
 const encoder = new TextEncoder();
 /**
  * Generate an ISBN-13 barcode as SVG bytes sized to the given region.
- * Uses toSVG() which is platform-independent (no canvas / Node Buffer required).
  * width_mm/height_mm are from printing-services cover_region_barcode (mm).
+ *
+ * Calls the isbn encoder directly rather than bwip-js's toSVG(). toSVG() dispatches on the
+ * bcid string, and that lookup table references all ~110 symbologies, so none of them can be
+ * dropped — the dispatch alone costs ~1.5MB of encoders we never use. Naming the encoder
+ * leaves only its own code reachable. The 'generic' entry point also avoids the canvas/DOM
+ * path, which is dead weight here on both platforms. Output is unchanged: this is the same
+ * encoder and the same SVG drawing backend toSVG() would have reached.
  */
 export function generate_isbn_barcode(isbn, width_mm, height_mm) {
     // Trim surrounding whitespace but preserve internal dashes —
     // bwip-js requires dashes for ISBN grouping validation
     // bwip-js width/height are in mm
-    const svg = bwipjs.toSVG({
+    const svg = bwipp_isbn({
         bcid: 'isbn',
         text: isbn.trim(),
         includetext: true,
@@ -19,7 +25,7 @@ export function generate_isbn_barcode(isbn, width_mm, height_mm) {
         paddingwidth: 10, // 1cm seems reasonable (not set according to any spec though)
         paddingheight: 10, // 1cm seems reasonable (not set according to any spec though)
         backgroundcolor: 'ffffff', // KDP and others are picky and insist on black/white
-    });
+    }, drawingSVG());
     return encoder.encode(svg);
 }
 //# sourceMappingURL=barcode.js.map

package/dist/colors.d.ts

@@ -1,6 +1,7 @@
 /** Convert a hex color string to an HSL tuple [h, s, l] */
 export declare function hex_to_hsl(hex: string): [number, number, number];
-/** Return true when white text has better contrast than black text against this color (WCAG) */
+/** Return true when white text has better contrast against this color than the near-black
+ *  text it pairs with (see DARK_TEXT_LUMINANCE) */
 export declare function is_dark_color(hex: string): boolean;
 /** Color values derived from the form's bg_color and spine_color */
 export interface DerivedColors {

package/dist/colors.js

@@ -27,13 +27,18 @@ function relative_luminance(hex) {
     const b = to_linear(parseInt(hex.slice(5, 7), 16) / 255);
     return 0.2126 * r + 0.7152 * g + 0.0722 * b;
 }
-/** Return true when white text has better contrast than black text against this color (WCAG) */
+// Luminance of the near-black (#1a1a1a = hsl(0deg, 0%, 10%)) that pairs with white as this
+// module's auto text color — a printable K90 gray rather than pure black. The choice below is
+// made against THIS, not pure black: near-black has less contrast than black does, so
+// comparing against black picks it on mid-gray backgrounds where white actually reads better
+const DARK_TEXT_LUMINANCE = relative_luminance('#1a1a1a');
+/** Return true when white text has better contrast against this color than the near-black
+ *  text it pairs with (see DARK_TEXT_LUMINANCE) */
 export function is_dark_color(hex) {
     const L = relative_luminance(hex);
-    // Contrast ratio with white (L=1) vs black (L=0)
     const contrast_white = 1.05 / (L + 0.05);
-    const contrast_black = (L + 0.05) / 0.05;
-    return contrast_white > contrast_black;
+    const contrast_dark = (L + 0.05) / (DARK_TEXT_LUMINANCE + 0.05);
+    return contrast_white > contrast_dark;
 }
 /** Format HSL components as hsl(Hdeg, S%, L%) — compatible with CSS4 and Typst's color.hsl() */
 function fmt_hsl(h, s, l) {

package/dist/design.js

@@ -108,18 +108,23 @@ export function generate_palette(base, count, scheme) {
     }
     return colors;
 }
-/** True when white text has more WCAG contrast than black against this color */
+// The two colors auto text falls back to. The dark one is a near-black (K90% for print, see
+// COLOR_DEFAULTS) rather than pure black, and its luminance is what the choice below is made
+// against — comparing against PURE black instead picks it on mid-gray backgrounds where white
+// actually reads better, since near-black's own contrast is lower than black's
+const AUTO_TEXT_LIGHT = 'hsl(0deg, 0%, 100%)';
+const AUTO_TEXT_DARK = 'hsl(0deg, 0%, 10%)';
+const AUTO_TEXT_DARK_LUMINANCE = chroma.hsl(0, 0, 0.1).luminance();
+/** True when the light auto text reads better than the dark one against this color */
 function is_dark(c) {
     const L = c.luminance();
-    const contrast_white = 1.05 / (L + 0.05);
-    const contrast_black = (L + 0.05) / 0.05;
-    return contrast_white >= contrast_black;
+    const contrast_light = 1.05 / (L + 0.05);
+    const contrast_dark = (L + 0.05) / (AUTO_TEXT_DARK_LUMINANCE + 0.05);
+    return contrast_light >= contrast_dark;
 }
 /** Return white or near-black, whichever has more WCAG contrast against the given background */
 function auto_contrast_text(bg) {
-    return is_dark(from_hsl(bg))
-        ? 'hsl(0deg, 0%, 100%)' // white — better on dark backgrounds
-        : 'hsl(0deg, 0%, 10%)'; // near-black (K90% for print)
+    return is_dark(from_hsl(bg)) ? AUTO_TEXT_LIGHT : AUTO_TEXT_DARK;
 }
 /** Same contrast choice as auto_contrast_text, but hex-in/hex-out — for callers (pick_vivid_tint)
  *  that need to stay in hex rather than the hsl(Hdeg, S%, L%) string format */

package/dist/form_state.d.ts

@@ -112,6 +112,19 @@ export interface EmbedFormState {
 /** Live form values — adds the background image File, which is held only in the browser and
  *  never serialized with the rest of the form */
 export interface FormState extends EmbedFormState {
+    /** The background image, held byte-for-byte.
+     *
+     *  BYTES ROUND-TRIP UNMODIFIED. A File put in this slot — whether the user uploaded it, a
+     *  host handed it over the embed protocol, or it was fetched from the built-in backgrounds
+     *  — is the exact File handed back out again: never re-encoded, resized, recompressed or
+     *  stripped of metadata. So any host may use the bytes themselves as the image's identity
+     *  (hashing them to recognise an image it already stores), and that identity survives a
+     *  round trip through the editor.
+     *
+     *  Everything the editor derives FROM the pixels — crop/coverage choices, sampled colors,
+     *  region analysis — lives in the form values or is recomputed at render time, never by
+     *  rewriting this file. Downscaling for preview rendering is fine, but the result is a
+     *  separate Blob that must not be written back here. */
     bg_image: File | null;
 }
 /** Plain object with blank/empty values — no demo content, white background, no icon or

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { collect_fonts, collect_all_fonts, collect_fallback_fonts, all_fonts_bun
 export { asset_path, FRAMES_DIR, BACKGROUNDS_DIR } from './assets.js';
 export { DEFAULT_TEMPLATES } from './generated/templates_data.js';
 export { list_patterns, find_pattern } from './patterns.js';
-export type { PatternDef } from './patterns.js';
+export type { PatternDef, PatternId } from './patterns.js';
 export { list_vector_backgrounds, find_vector_background } from './vector_backgrounds.js';
 export { list_builtin_icons, find_builtin_icon } from './builtin_icons.js';
 export type { VectorBackgroundDef } from './vector_backgrounds.js';

package/dist/index.js

@@ -7,7 +7,7 @@ import { resolve_colors, resolve_font_configs, darken_hsl, mix_hsl, generate_pal
 import { build_cover_files } from './build_files.js';
 import { DEFAULT_TEMPLATES } from './generated/templates_data.js';
 import { resolve_icon } from './icon_cache.js';
-import { find_pattern } from './patterns.js';
+import { find_pattern_svg } from './patterns_svg.js';
 import { find_vector_background } from './vector_backgrounds.js';
 import { resolve_fallback_chain, cjk_segments, cjk_family, font_style } from 'typst-fonts';
 import { resolve_field_cjk_variant, collect_fallback_fonts } from './fonts.js';
@@ -16,6 +16,9 @@ export { default_spine_title } from './utils.js';
 export { collect_fonts, collect_all_fonts, collect_fallback_fonts, all_fonts_bundled, resolve_cjk_variant, resolve_field_cjk_variant } from './fonts.js';
 export { asset_path, FRAMES_DIR, BACKGROUNDS_DIR } from './assets.js';
 export { DEFAULT_TEMPLATES } from './generated/templates_data.js';
+// Pattern metadata only — the SVG payload is deliberately NOT re-exported here, so importing
+// this barrel (as the widget's main thread does) never pulls it in. Reach it via the
+// 'bookcover-core/patterns-svg' subpath instead
 export { list_patterns, find_pattern } from './patterns.js';
 export { list_vector_backgrounds, find_vector_background } from './vector_backgrounds.js';
 export { list_builtin_icons, find_builtin_icon } from './builtin_icons.js';
@@ -158,8 +161,8 @@ export async function build(schema, image, frame_fn, frame_data, templates = DEF
             ?? (schema_resolved.bg_color_gradient
                 ? colors.front_background
                 : darken_hsl(colors.front_background, 0.05));
-        const pat = find_pattern(schema_resolved.pattern);
-        const svg = await resolve_icon(pat ? pat.svg : schema_resolved.pattern, color_pattern);
+        const pat_svg = find_pattern_svg(schema_resolved.pattern);
+        const svg = await resolve_icon(pat_svg ?? schema_resolved.pattern, color_pattern);
         // Parse natural SVG dimensions to preserve aspect ratio when tiling
         const svg_w = parseFloat(svg.match(/\bwidth="([0-9.]+)"/)?.[1] ?? '1');
         const svg_h = parseFloat(svg.match(/\bheight="([0-9.]+)"/)?.[1] ?? '1');

package/dist/patterns.d.ts

@@ -1,8 +1,11 @@
+/** Union of every built-in pattern ID — keeps PATTERN_SVGS in patterns_svg.ts exhaustive,
+  * so adding a pattern here without its SVG (or vice versa) is a type error */
+export type PatternId = 'anchors-away' | 'architect' | 'autumn' | 'aztec' | 'bamboo' | 'bank-note' | 'bathroom-floor' | 'bevel-circle' | 'boxes' | 'brick-wall' | 'bubbles' | 'cage' | 'charlie-brown' | 'church-on-sunday' | 'circles-and-squares' | 'circuit-board' | 'connections' | 'cork-screw' | 'current' | 'curtain' | 'cutout' | 'death-star' | 'diagonal-lines' | 'diagonal-stripes' | 'dominos' | 'endless-clouds' | 'eyes' | 'falling-triangles' | 'fancy-rectangles' | 'flipped-diamonds' | 'floating-cogs' | 'floor-tile' | 'formal-invitation' | 'four-point-stars' | 'glamorous' | 'graph-paper' | 'groovy' | 'happy-intersection' | 'heavy-rain' | 'hexagons' | 'hideout' | 'houndstooth' | 'i-like-food' | 'intersecting-circles' | 'jigsaw' | 'jupiter' | 'kiwi' | 'leaf' | 'lines-in-motion' | 'lips' | 'lisbon' | 'melt' | 'moroccan' | 'morphing-diamonds' | 'overcast' | 'overlapping-circles' | 'overlapping-diamonds' | 'overlapping-hexagons' | 'parkay-floor' | 'piano-man' | 'pie-factory' | 'pixel-dots' | 'plus' | 'polka-dots' | 'rails' | 'rain' | 'random-shapes' | 'rounded-plus-connected' | 'signal' | 'skulls' | 'slanted-stars' | 'squares-in-squares' | 'squares' | 'stamp-collection' | 'steel-beams' | 'stripes' | 'temple' | 'texture' | 'tic-tac-toe' | 'tiny-checkers' | 'topography' | 'volcano-lamp' | 'wallpaper' | 'wiggle' | 'x-equals' | 'yyy' | 'zig-zag';
 export interface PatternDef {
     id: string;
     name: string;
-    svg: string;
     tile_mm: number;
+    aspect_ratio: number;
 }
 /** Look up a pattern by ID — internal use only */
 export declare function find_pattern(id: string): PatternDef | undefined;