postext 1.4.2 → 1.5.0

package/dist/configWarnings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Configuration values the engine cannot use as written. The engine never
+ * fails on them — it numbers in decimal, sets a font stack in its first
+ * family, cuts the columns of a one-and-a-half layout at the nearest width
+ * both can take, ignores a heading setting it does not know — but a silent
+ * substitution is hard to spot, so every one is reported: on
+ * `VDTDocument.configWarnings`, and to any host that asks with
+ * {@link collectConfigWarnings}.
+ */
+import type { PostextConfig } from './types';
+import type { ConfigWarning } from './vdt';
+/**
+ * Walk a config for values the engine replaces: an unknown numbering
+ * format (lists, page labels, resource counters — any of their spellings
+ * is fine, see `parseNumberFormat`), a CSS font stack in a font-family
+ * field, and the `sideColumnPercent` of a one-and-a-half layout — the
+ * document's, and every heading style's own `layout` — that would leave
+ * one of the columns with no width (see `sideColumnPercentUsed`). Every
+ * nested partial config is covered (heading styles, part list overrides,
+ * `htmlViewer.overrides`, design elements). Also a key the heading
+ * settings or a paragraph style do not have (`unknownConfigKey`:
+ * `headings`, its `balancing` and `levels`, `headingStyles`,
+ * `paragraphStyles`). Pure.
+ */
+export declare function collectConfigWarnings(config: PostextConfig | undefined): ConfigWarning[];
+//# sourceMappingURL=configWarnings.d.ts.map

package/dist/configWarnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configWarnings.d.ts","sourceRoot":"","sources":["../src/configWarnings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAMV,aAAa,EAEd,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AA0B3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,aAAa,EAAE,CAGxF"}

package/dist/configWarnings.js

@@ -0,0 +1,223 @@
+/**
+ * Configuration values the engine cannot use as written. The engine never
+ * fails on them — it numbers in decimal, sets a font stack in its first
+ * family, cuts the columns of a one-and-a-half layout at the nearest width
+ * both can take, ignores a heading setting it does not know — but a silent
+ * substitution is hard to spot, so every one is reported: on
+ * `VDTDocument.configWarnings`, and to any host that asks with
+ * {@link collectConfigWarnings}.
+ */
+import { parseNumberFormat } from './numbering';
+import { isFontStack, primaryFontFamily } from './measure/font';
+import { dimensionToPx } from './units';
+import { resolveAllConfig, sideColumnPercentUsed } from './pipeline/config';
+import { computePageMetrics } from './pipeline/buildHelpers';
+import { deriveSectionGeometryConfig } from './pipeline/headingStyles';
+/** The format fields and the decimal spelling each falls back to. A
+ *  `format` is a format field only under `pageNumbering`. */
+function numberFormatFallback(key, parentKey) {
+    if (key === 'numberFormat')
+        return 'arabic';
+    if (key === 'counterFormat')
+        return 'decimal';
+    if (key === 'format' && parentKey === 'pageNumbering')
+        return 'decimal';
+    return undefined;
+}
+function isFontFamilyKey(key) {
+    return key === 'fontFamily' || key.endsWith('FontFamily');
+}
+/** A percentage as a warning prints it: at most two decimals. */
+function percentText(n) {
+    return String(Math.round(n * 100) / 100);
+}
+/**
+ * Walk a config for values the engine replaces: an unknown numbering
+ * format (lists, page labels, resource counters — any of their spellings
+ * is fine, see `parseNumberFormat`), a CSS font stack in a font-family
+ * field, and the `sideColumnPercent` of a one-and-a-half layout — the
+ * document's, and every heading style's own `layout` — that would leave
+ * one of the columns with no width (see `sideColumnPercentUsed`). Every
+ * nested partial config is covered (heading styles, part list overrides,
+ * `htmlViewer.overrides`, design elements). Also a key the heading
+ * settings or a paragraph style do not have (`unknownConfigKey`:
+ * `headings`, its `balancing` and `levels`, `headingStyles`,
+ * `paragraphStyles`). Pure.
+ */
+export function collectConfigWarnings(config) {
+    if (!config)
+        return [];
+    return [...collectValueWarnings(config), ...collectSideColumnWarnings(config), ...collectUnknownKeyWarnings(config)];
+}
+// The keys of the heading settings, checked against their types: a key
+// added to (or removed from) a type fails to compile until it is listed
+// here, so the check never flags a setting the engine reads.
+const HEADINGS_KEYS = {
+    fontFamily: true, lineHeight: true, color: true, textAlign: true, fontWeight: true,
+    marginTop: true, marginBottom: true, keepWithNext: true, keepWithNextSplit: true, snapToGrid: true, inlineMarks: true, balancing: true, levels: true,
+};
+const BALANCING_KEYS = {
+    enabled: true, maxLinesPerHeading: true, stretchAfterLists: true, maxLinesAfterList: true,
+    stretchAfterFloats: true, maxLinesAfterFloat: true, looseParagraphs: true, maxLooseParagraphs: true,
+    trackParagraphs: true, maxTracking: true, trailing: true, beforeSpan: true, closingBox: true,
+};
+const HEADING_LEVEL_KEYS = {
+    level: true, fontSize: true, lineHeight: true, fontFamily: true, color: true, fontWeight: true,
+    marginTop: true, marginBottom: true, numberingTemplate: true, italic: true, letterSpacing: true,
+    breakBefore: true, span: true, advancedDesign: true, textTransform: true, hidden: true, snapToGrid: true,
+};
+const HEADING_STYLE_KEYS = {
+    id: true, name: true, numberingTemplate: true, numbered: true, toc: true, runningChapter: true, header: true, footer: true,
+    margins: true, layout: true, bodyStyle: true, palette: true,
+    fontSize: true, lineHeight: true, fontFamily: true, color: true, fontWeight: true, marginTop: true,
+    marginBottom: true, italic: true, letterSpacing: true, breakBefore: true, span: true,
+    advancedDesign: true, textTransform: true, hidden: true, snapToGrid: true,
+};
+const PARAGRAPH_STYLE_KEYS = {
+    id: true, name: true, fontFamily: true, fontSize: true, lineHeight: true, color: true, textAlign: true,
+    boldColor: true, italicColor: true, fontWeight: true, boldFontWeight: true, italic: true, smallCaps: true,
+    hyphenation: true, indent: true, firstLineIndent: true, hangingIndent: true, spaceBetween: true,
+    marginTop: true, marginBottom: true, snapToGrid: true, textTransform: true,
+};
+/** Edit distance with transpositions (optimal string alignment), capped:
+ *  anything above `max` returns `max + 1`. */
+function editDistance(a, b, max) {
+    if (Math.abs(a.length - b.length) > max)
+        return max + 1;
+    const d = Array.from({ length: a.length + 1 }, (_, i) => [i, ...new Array(b.length).fill(0)]);
+    for (let j = 1; j <= b.length; j++)
+        d[0][j] = j;
+    for (let i = 1; i <= a.length; i++) {
+        for (let j = 1; j <= b.length; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            let v = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1])
+                v = Math.min(v, d[i - 2][j - 2] + 1);
+            d[i][j] = v;
+        }
+    }
+    return d[a.length][b.length];
+}
+/** The known key `key` is a slip of: the same letters in another case, or
+ *  one or two letters apart (a longer key allows two). */
+function closestKey(key, known) {
+    const lower = key.toLowerCase();
+    const sameCase = known.find((k) => k.toLowerCase() === lower);
+    if (sameCase)
+        return sameCase;
+    const max = key.length >= 8 ? 2 : 1;
+    let best;
+    let bestD = max + 1;
+    for (const k of known) {
+        const dist = editDistance(lower, k.toLowerCase(), max);
+        if (dist < bestD) {
+            best = k;
+            bestD = dist;
+        }
+    }
+    return best;
+}
+/**
+ * Keys the heading settings do not have (EF-83), or a paragraph style
+ * (EF-173): the engine reads the settings it knows and drops the rest, so
+ * a misspelt or invented one (`letterSpacng`, `tracking`, a paragraph
+ * style's `fontStyle`) used to change nothing without a word. The
+ * `headings` section, its `balancing` and `levels`, every heading style
+ * and every paragraph style are checked, in the document config and in
+ * `htmlViewer.overrides`.
+ */
+function collectUnknownKeyWarnings(config) {
+    const out = [];
+    const check = (node, known, path) => {
+        if (!node || typeof node !== 'object' || Array.isArray(node))
+            return;
+        const names = Object.keys(known);
+        for (const [key, value] of Object.entries(node)) {
+            // A key set to `undefined` sets nothing either way.
+            if (value === undefined || Object.prototype.hasOwnProperty.call(known, key))
+                continue;
+            const suggestion = closestKey(key, names);
+            out.push({ kind: 'unknownConfigKey', path: `${path}.${key}`, value: key, used: '', ...(suggestion ? { suggestion } : {}) });
+        }
+    };
+    const checkConfig = (c, prefix) => {
+        if (!c)
+            return;
+        const headings = c.headings;
+        if (headings && typeof headings === 'object' && !Array.isArray(headings)) {
+            const h = headings;
+            check(h, HEADINGS_KEYS, `${prefix}headings`);
+            check(h.balancing, BALANCING_KEYS, `${prefix}headings.balancing`);
+            if (Array.isArray(h.levels))
+                h.levels.forEach((l, i) => check(l, HEADING_LEVEL_KEYS, `${prefix}headings.levels[${i}]`));
+        }
+        if (Array.isArray(c.headingStyles))
+            c.headingStyles.forEach((s, i) => check(s, HEADING_STYLE_KEYS, `${prefix}headingStyles[${i}]`));
+        if (Array.isArray(c.paragraphStyles))
+            c.paragraphStyles.forEach((s, i) => check(s, PARAGRAPH_STYLE_KEYS, `${prefix}paragraphStyles[${i}]`));
+    };
+    checkConfig(config, '');
+    checkConfig(config.htmlViewer?.overrides, 'htmlViewer.overrides.');
+    return out;
+}
+/** The format and font-family values of `config`, walked field by field. */
+function collectValueWarnings(config) {
+    const out = [];
+    // The objects on the current path: a shared object is walked at every
+    // path it sits at, a cycle only once.
+    const ancestors = new Set();
+    const walk = (node, path, parentKey) => {
+        if (!node || typeof node !== 'object' || ancestors.has(node))
+            return;
+        // Font binaries (`customFonts`) and other buffers hold no settings.
+        if (node instanceof ArrayBuffer || ArrayBuffer.isView(node))
+            return;
+        ancestors.add(node);
+        if (Array.isArray(node)) {
+            node.forEach((item, i) => walk(item, `${path}[${i}]`, parentKey));
+            ancestors.delete(node);
+            return;
+        }
+        for (const [key, value] of Object.entries(node)) {
+            const at = path ? `${path}.${key}` : key;
+            if (typeof value === 'string') {
+                const fallback = numberFormatFallback(key, parentKey);
+                if (fallback !== undefined && parseNumberFormat(value) === undefined) {
+                    out.push({ kind: 'unknownNumberFormat', path: at, value, used: fallback });
+                }
+                else if (isFontFamilyKey(key) && isFontStack(value)) {
+                    out.push({ kind: 'fontFamilyStack', path: at, value, used: primaryFontFamily(value) });
+                }
+                continue;
+            }
+            walk(value, at, key);
+        }
+        ancestors.delete(node);
+    };
+    walk(config, '', undefined);
+    return out;
+}
+/** The side columns of the one-and-a-half layouts, measured on the page the
+ *  layout is cut on (a heading style's margins included). A layout of
+ *  another type never reads the value and is not reported. */
+function collectSideColumnWarnings(config) {
+    const out = [];
+    const resolved = resolveAllConfig(config);
+    const check = (geometry, layout, path) => {
+        if (layout.layoutType !== 'oneAndHalf')
+            return;
+        const contentWidth = computePageMetrics(geometry).contentArea.width;
+        const gutter = dimensionToPx(layout.gutterWidth, geometry.page.dpi);
+        const used = sideColumnPercentUsed(layout.sideColumnPercent, contentWidth, gutter);
+        if (used === Number(layout.sideColumnPercent))
+            return;
+        out.push({ kind: 'sideColumnPercentClamped', path, value: String(layout.sideColumnPercent), used: percentText(used) });
+    };
+    check(resolved, resolved.layout, 'layout.sideColumnPercent');
+    resolved.headingStyles.forEach((style, i) => {
+        if (style.layout)
+            check(deriveSectionGeometryConfig(resolved, style), style.layout, `headingStyles[${i}].layout.sideColumnPercent`);
+    });
+    return out;
+}
+//# sourceMappingURL=configWarnings.js.map

package/dist/configWarnings.js.map

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

package/dist/createLayout.d.ts

@@ -1,4 +1,19 @@
-import { type FC } from 'react';
+import type { FC } from 'react';
 import type { PostextContent, PostextConfig } from './types';
+/**
+ * A React component that lays `content` out and shows its pages as canvases.
+ *
+ * @deprecated Import `createLayout` from `postext/react`, which takes
+ * `className` / `style` props and needs no Suspense. This alias stays so
+ * existing imports keep working, and it keeps React out of the main entry:
+ * it loads the `postext/react` implementation when it is called, and the
+ * component suspends (React renders it again) until that has arrived.
+ * Rendered before then, it needs a concurrent root (`createRoot`) or a
+ * `<Suspense>` boundary above it: in a legacy `ReactDOM.render` root, or in
+ * `renderToString`, with no boundary, React reports an error instead.
+ * Planned for removal in the next major version, which also makes `react`
+ * an optional peer dependency (it stays required until then, so bundlers
+ * can resolve this alias's lazy `postext/react` chunk).
+ */
 export declare function createLayout(content: PostextContent, config?: PostextConfig): FC;
 //# sourceMappingURL=createLayout.d.ts.map

package/dist/createLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createLayout.d.ts","sourceRoot":"","sources":["../src/createLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAqB,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7D,wBAAgB,YAAY,CAC1B,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,aAAa,GACrB,EAAE,CA6BJ"}
+{"version":3,"file":"createLayout.d.ts","sourceRoot":"","sources":["../src/createLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,EAAE,CAkBhF"}

package/dist/createLayout.js

@@ -1,27 +1,30 @@
-import { useEffect, useRef } from 'react';
-import { buildDocument } from './pipeline';
-import { renderToCanvas } from './canvas-backend';
+/**
+ * A React component that lays `content` out and shows its pages as canvases.
+ *
+ * @deprecated Import `createLayout` from `postext/react`, which takes
+ * `className` / `style` props and needs no Suspense. This alias stays so
+ * existing imports keep working, and it keeps React out of the main entry:
+ * it loads the `postext/react` implementation when it is called, and the
+ * component suspends (React renders it again) until that has arrived.
+ * Rendered before then, it needs a concurrent root (`createRoot`) or a
+ * `<Suspense>` boundary above it: in a legacy `ReactDOM.render` root, or in
+ * `renderToString`, with no boundary, React reports an error instead.
+ * Planned for removal in the next major version, which also makes `react`
+ * an optional peer dependency (it stays required until then, so bundlers
+ * can resolve this alias's lazy `postext/react` chunk).
+ */
 export function createLayout(content, config) {
+    let Impl = null;
+    let failure = null;
+    const loading = import('./react/createLayout').then((m) => { Impl = m.createLayout(content, config); }, (error) => { failure = { error }; });
     const Layout = () => {
-        const containerRef = useRef(null);
-        useEffect(() => {
-            const container = containerRef.current;
-            if (!container)
-                return;
-            const doc = buildDocument(content, config);
-            const pages = renderToCanvas(doc);
-            // Clear previous content
-            container.innerHTML = '';
-            // Display all pages
-            for (const canvas of pages) {
-                canvas.style.width = '100%';
-                canvas.style.height = 'auto';
-                canvas.style.display = 'block';
-                canvas.style.marginBottom = '16px';
-                container.appendChild(canvas);
-            }
-        }, []);
-        return null;
+        if (failure)
+            throw failure.error;
+        if (!Impl)
+            throw loading;
+        // Called as a function: its hooks belong to this component, and every
+        // render from now on takes this same path.
+        return Impl({});
     };
     Layout.displayName = 'PostextLayout';
     return Layout;

package/dist/createLayout.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLayout.js","sourceRoot":"","sources":["../src/createLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,YAAY,CAC1B,OAAuB,EACvB,MAAsB;IAEtB,MAAM,MAAM,GAAO,GAAG,EAAE;QACtB,MAAM,YAAY,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;QAElD,SAAS,CAAC,GAAG,EAAE;YACb,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;YACvC,IAAI,CAAC,SAAS;gBAAE,OAAO;YAEvB,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAElC,yBAAyB;YACzB,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC;YAEzB,oBAAoB;YACpB,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;gBAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;gBAC5B,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;gBAC7B,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;gBAC/B,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,MAAM,CAAC;gBACnC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,eAAe,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"createLayout.js","sourceRoot":"","sources":["../src/createLayout.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CAAC,OAAuB,EAAE,MAAsB;IAC1E,IAAI,IAAI,GAAc,IAAI,CAAC;IAC3B,IAAI,OAAO,GAA8B,IAAI,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC,IAAI,CACjD,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAO,CAAC,CAAC,CAAC,EACxD,CAAC,KAAc,EAAE,EAAE,GAAG,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAC7C,CAAC;IAEF,MAAM,MAAM,GAAO,GAAG,EAAE;QACtB,IAAI,OAAO;YAAE,MAAM,OAAO,CAAC,KAAK,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,MAAM,OAAO,CAAC;QACzB,sEAAsE;QACtE,2CAA2C;QAC3C,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,eAAe,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cropMarks.d.ts

@@ -0,0 +1,28 @@
+import type { ResolvedPageConfig } from './types';
+/** One crop mark, in page px: a line on the prolongation of a trim edge,
+ *  from its end nearer the trim (`x1`, `y1`) outwards (`x2`, `y2`). */
+export interface CropMarkSegment {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/**
+ * The crop marks of a page laid out with `page.cutLines` on: two at each
+ * trim corner, one on each trim edge's line, `markLength` long. A mark
+ * starts `markOffset` outside the trim, or at the bleed edge when the bleed
+ * is wider, so it never lies over art that runs into the bleed. The sheet
+ * grows by `bleed + markOffset + markLength` on every side, so a mark never
+ * runs past it. Empty when cut lines are off. The canvas and PDF backends
+ * draw these.
+ *
+ * `trimOffset` is how far the trim box sits inside the sheet: pass the
+ * document's `doc.trimOffset`, which also places the PDF's `TrimBox`, so
+ * the marks and the box can never disagree. Left out, it is worked out
+ * from `cutLines` as the layout does.
+ */
+export declare function cropMarkSegments(page: {
+    width: number;
+    height: number;
+}, pageConfig: Pick<ResolvedPageConfig, 'cutLines' | 'dpi'>, trimOffset?: number): CropMarkSegment[];
+//# sourceMappingURL=cropMarks.d.ts.map

package/dist/cropMarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cropMarks.d.ts","sourceRoot":"","sources":["../src/cropMarks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD;uEACuE;AACvE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACvC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,KAAK,CAAC,EACxD,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,EAAE,CAsBnB"}

package/dist/cropMarks.js

@@ -0,0 +1,40 @@
+import { dimensionToPx } from './units';
+/**
+ * The crop marks of a page laid out with `page.cutLines` on: two at each
+ * trim corner, one on each trim edge's line, `markLength` long. A mark
+ * starts `markOffset` outside the trim, or at the bleed edge when the bleed
+ * is wider, so it never lies over art that runs into the bleed. The sheet
+ * grows by `bleed + markOffset + markLength` on every side, so a mark never
+ * runs past it. Empty when cut lines are off. The canvas and PDF backends
+ * draw these.
+ *
+ * `trimOffset` is how far the trim box sits inside the sheet: pass the
+ * document's `doc.trimOffset`, which also places the PDF's `TrimBox`, so
+ * the marks and the box can never disagree. Left out, it is worked out
+ * from `cutLines` as the layout does.
+ */
+export function cropMarkSegments(page, pageConfig, trimOffset) {
+    const { cutLines, dpi } = pageConfig;
+    if (!cutLines.enabled)
+        return [];
+    const bleed = dimensionToPx(cutLines.bleed, dpi);
+    const offset = dimensionToPx(cutLines.markOffset, dpi);
+    const length = dimensionToPx(cutLines.markLength, dpi);
+    // The trim box sits this far inside the sheet (see `computePageMetrics`).
+    const inset = trimOffset ?? bleed + offset + length;
+    const left = inset;
+    const top = inset;
+    const right = page.width - inset;
+    const bottom = page.height - inset;
+    const start = Math.max(bleed, offset);
+    const end = start + length;
+    const segments = [];
+    for (const [x, y] of [[left, top], [right, top], [left, bottom], [right, bottom]]) {
+        const h = x === left ? -1 : 1;
+        const v = y === top ? -1 : 1;
+        segments.push({ x1: x + h * start, y1: y, x2: x + h * end, y2: y });
+        segments.push({ x1: x, y1: y + v * start, x2: x, y2: y + v * end });
+    }
+    return segments;
+}
+//# sourceMappingURL=cropMarks.js.map

package/dist/cropMarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cropMarks.js","sourceRoot":"","sources":["../src/cropMarks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAWxC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAuC,EACvC,UAAwD,EACxD,UAAmB;IAEnB,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvD,0EAA0E;IAC1E,MAAM,KAAK,GAAG,UAAU,IAAI,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACpD,MAAM,IAAI,GAAG,KAAK,CAAC;IACnB,MAAM,GAAG,GAAG,KAAK,CAAC;IAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAU,EAAE,CAAC;QAC3F,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/defaults/bodyText.d.ts

@@ -1,7 +1,17 @@
-import type { BodyTextConfig, ResolvedBodyTextConfig, HyphenationConfig, HyphenationLocale } from '../types';
+import type { BlockquoteConfig, BodyTextConfig, ResolvedBlockquoteConfig, ResolvedBodyTextConfig, HyphenationConfig, LocaleTag } from '../types';
 export declare const DEFAULT_HYPHENATION_CONFIG: ResolvedBodyTextConfig['hyphenation'];
+/** Blockquotes as postext 1.4 set them: grey, italic, the body's
+ *  first-line indent, no side indent. */
+export declare const DEFAULT_BLOCKQUOTE_CONFIG: ResolvedBlockquoteConfig;
 export declare const DEFAULT_BODY_TEXT_CONFIG: ResolvedBodyTextConfig;
 export declare function hyphenationEqual(a: HyphenationConfig | undefined, b: HyphenationConfig | undefined): boolean;
-export declare function resolveBodyTextConfig(partial?: BodyTextConfig, documentLocale?: HyphenationLocale): ResolvedBodyTextConfig;
+/** A blockquote style in full: unset fields keep postext 1.4's look (see
+ *  {@link DEFAULT_BLOCKQUOTE_CONFIG}); an unset `firstLineIndent` stays
+ *  unset, the body's then applying. */
+export declare function resolveBlockquoteConfig(partial?: BlockquoteConfig): ResolvedBlockquoteConfig;
+/** `blockquote` without the fields that hold their default; undefined when
+ *  none is left. */
+export declare function stripBlockquoteDefaults(blockquote?: BlockquoteConfig): BlockquoteConfig | undefined;
+export declare function resolveBodyTextConfig(partial?: BodyTextConfig, documentLocale?: LocaleTag): ResolvedBodyTextConfig;
 export declare function stripBodyTextDefaults(bodyText?: BodyTextConfig): BodyTextConfig | undefined;
 //# sourceMappingURL=bodyText.d.ts.map

package/dist/defaults/bodyText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bodyText.d.ts","sourceRoot":"","sources":["../../src/defaults/bodyText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7G,eAAO,MAAM,0BAA0B,EAAE,sBAAsB,CAAC,aAAa,CAG5E,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,sBA8CtC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAAC,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAK5G;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,iBAAiB,GAAG,sBAAsB,CAiD1H;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAwJ3F"}
+{"version":3,"file":"bodyText.d.ts","sourceRoot":"","sources":["../../src/defaults/bodyText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAIjJ,eAAO,MAAM,0BAA0B,EAAE,sBAAsB,CAAC,aAAa,CAM5E,CAAC;AAEF;yCACyC;AACzC,eAAO,MAAM,yBAAyB,EAAE,wBAIvC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,sBAwDtC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,iBAAiB,GAAG,SAAS,EAAE,CAAC,EAAE,iBAAiB,GAAG,SAAS,GAAG,OAAO,CAS5G;AAsBD;;uCAEuC;AACvC,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CAQ5F;AAED;oBACoB;AACpB,wBAAgB,uBAAuB,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CASnG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,EAAE,SAAS,GAAG,sBAAsB,CA4DlH;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,cAAc,GAAG,SAAS,CAiM3F"}