@bendyline/squisq-formats 2.6.19 → 2.6.21

package/README.md

@@ -87,7 +87,7 @@ const imported = await pdfToMarkdownDoc(pdfBuffer);
 const container = await pdfToContainer(pdfBuffer);
 ```
 
-**Fidelity:** export uses pdf-lib's standard 14 fonts (`themeId` affects colors only). Pass `images` (keyed by the markdown URL, as for DOCX) to draw PNG and JPEG images that stand alone in a paragraph; other images print as an `[Image: alt]` note. PDF has no semantic structure, so import is heuristic and best-effort: headings are detected by font size, and tables / code blocks / blockquotes / links via the `detectTables` / `detectCodeBlocks` / `detectBlockquotes` / `detectLinks` options (all default true). `pdfToMarkdownDoc` is text-only; `pdfToContainer` also extracts embedded XObject and inline raster images in browsers and Node, placed **by page** — each image is inserted after the last content block from its page (image-only pages fall back to the nearest preceding page with content, else the document end). Placement is page-level only; masks, vector artwork, and images that PDF.js cannot expose as decoded pixels are not emitted.
+**Fidelity:** export uses pdf-lib's standard 14 fonts (`themeId` affects colors only). Pages stay white for printing. Theme text, heading, and link colors are retained when they meet 4.5:1 contrast against both white paper and the shaded table header; otherwise the exporter uses its default dark ink for that role. This also applies to inherited and custom themes. Pass `images` (keyed by the markdown URL, as for DOCX) to draw PNG and JPEG images that stand alone in a paragraph; other images print as an `[Image: alt]` note. PDF has no semantic structure, so import is heuristic and best-effort: headings are detected by font size, and tables / code blocks / blockquotes / links via the `detectTables` / `detectCodeBlocks` / `detectBlockquotes` / `detectLinks` options (all default true). `pdfToMarkdownDoc` is text-only; `pdfToContainer` also extracts embedded XObject and inline raster images in browsers and Node, placed **by page** — each image is inserted after the last content block from its page (image-only pages fall back to the nearest preceding page with content, else the document end). Placement is page-level only; masks, vector artwork, and images that PDF.js cannot expose as decoded pixels are not emitted.
 
 ### Diagrams as pictures
 

package/dist/{chunk-5ULLXI4B.js → chunk-4GAVHDHU.js}

@@ -20,6 +20,7 @@ import {
 // src/pdf/export.ts
 import { PDFDocument, StandardFonts, rgb, PDFString } from "pdf-lib";
 import fontkit from "@pdf-lib/fontkit";
+import { contrastRatio } from "@bendyline/squisq/schemas";
 import { docToMarkdown, resolveThemeForDoc } from "@bendyline/squisq/doc";
 import { readFrontmatterThemeId, sanitizeUrl } from "@bendyline/squisq/markdown";
 
@@ -477,9 +478,9 @@ async function createExportContext(pdfDoc, options, doc) {
   if (themeId) {
     const theme = resolveThemeForDoc(doc, themeId, options.themeRegistry);
     if (theme.colors) {
-      colorText = hexToRgb(theme.colors.text) ?? COLOR_TEXT;
-      colorHeading = hexToRgb(theme.colors.primary) ?? COLOR_HEADING;
-      colorLink = hexToRgb(theme.colors.highlight || theme.colors.secondary) ?? COLOR_LINK;
+      colorText = paperInk(theme.colors.text, COLOR_TEXT);
+      colorHeading = paperInk(theme.colors.primary, COLOR_HEADING);
+      colorLink = paperInk(theme.colors.highlight || theme.colors.secondary, COLOR_LINK);
     }
   }
   return {
@@ -1172,6 +1173,14 @@ function renderFallbackBlock(node, ctx, extraIndent) {
     ctx.y -= lineH + PARAGRAPH_SPACING;
   }
 }
+function paperInk(hex, fallback) {
+  const color = hexToRgb(hex);
+  if (!color) return fallback;
+  const tableHeader = "#" + [COLOR_TABLE_HEADER_BG.r, COLOR_TABLE_HEADER_BG.g, COLOR_TABLE_HEADER_BG.b].map(
+    (channel) => Math.round(channel * 255).toString(16).padStart(2, "0")
+  ).join("");
+  return contrastRatio(hex, "#ffffff") >= 4.5 && contrastRatio(hex, tableHeader) >= 4.5 ? color : fallback;
+}
 function hexToRgb(hex) {
   const h = hex.startsWith("#") ? hex.slice(1) : hex;
   if (h.length !== 6) return void 0;

package/dist/{chunk-ZEWBALT5.js → chunk-JXPZEP7D.js}

@@ -1,7 +1,7 @@
 import {
   convert,
   defaultRegistry
-} from "./chunk-OHR6V4EE.js";
+} from "./chunk-YEV3P7PN.js";
 import {
   ConversionError
 } from "./chunk-KXOZMWBS.js";

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   renderOutsideInDocument,
   withOutsideInMarkdownEditing,
   withOutsideInMetadata
-} from "./chunk-ZEWBALT5.js";
+} from "./chunk-JXPZEP7D.js";
 import {
   DEFAULT_CONVERSION_LIMITS,
   convert,
@@ -37,7 +37,7 @@ import {
   defaultRegistry,
   prepareConversion,
   resolveConversionLimits
-} from "./chunk-OHR6V4EE.js";
+} from "./chunk-YEV3P7PN.js";
 import {
   ConversionError
 } from "./chunk-KXOZMWBS.js";
@@ -93,7 +93,7 @@ import {
   markdownDocToPdf,
   pdfToDoc,
   pdfToMarkdownDoc
-} from "./chunk-5ULLXI4B.js";
+} from "./chunk-4GAVHDHU.js";
 import "./chunk-34KECNZO.js";
 import "./chunk-BXWNU4T5.js";
 import "./chunk-IIQYS2YH.js";

package/dist/outside-in/index.js

@@ -6,8 +6,8 @@ import {
   renderOutsideInDocument,
   withOutsideInMarkdownEditing,
   withOutsideInMetadata
-} from "../chunk-ZEWBALT5.js";
-import "../chunk-OHR6V4EE.js";
+} from "../chunk-JXPZEP7D.js";
+import "../chunk-YEV3P7PN.js";
 import "../chunk-KXOZMWBS.js";
 import {
   OUTSIDE_IN_FORMAT_IDS,

package/dist/pdf/index.d.ts

@@ -43,7 +43,8 @@ interface PdfExportOptions {
     defaultFontSize?: number;
     /**
      * Squisq theme ID to apply (e.g., 'documentary', 'cinematic').
-     * When set, overrides heading, text, and link colors with the theme palette.
+     * Uses readable heading, text, and link colors from the theme palette on
+     * white paper. Colors with insufficient contrast use the default PDF ink.
      * Font changes are not supported (pdf-lib uses standard 14 PDF fonts only).
      */
     themeId?: string;

package/dist/pdf/index.js

@@ -5,7 +5,7 @@ import {
   pdfToContainer,
   pdfToDoc,
   pdfToMarkdownDoc
-} from "../chunk-5ULLXI4B.js";
+} from "../chunk-4GAVHDHU.js";
 import "../chunk-34KECNZO.js";
 import "../chunk-BXWNU4T5.js";
 import "../chunk-IIQYS2YH.js";

package/dist/registry/index.js

@@ -9,7 +9,7 @@ import {
   defaultRegistry,
   prepareConversion,
   resolveConversionLimits
-} from "../chunk-OHR6V4EE.js";
+} from "../chunk-YEV3P7PN.js";
 import {
   ConversionError
 } from "../chunk-KXOZMWBS.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq-formats",
-  "version": "2.6.19",
+  "version": "2.6.21",
   "description": "Document format converters — DOCX, PDF, OOXML import/export",
   "license": "MIT",
   "author": "Bendyline",
@@ -125,7 +125,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.11.19",
+    "@bendyline/squisq": "2.11.20",
     "@pdf-lib/fontkit": "1.1.1",
     "@pdf-lib/upng": "1.0.1",
     "@xmldom/xmldom": "0.9.12",