reamkit 1.1.0 → 1.3.0

package/dist/esm/excel/xlsx-to-pdf.js

@@ -1,7 +1,7 @@
 import { fetchFontSet } from "../core/fonts/remote-fonts.js";
 import { FontRegistry } from "../core/font/font-registry.js";
 import { signPdf } from "../pdf/signature.js";
-import { renderStyledPdf } from "../pdf/styled-page-renderer.js";
+import { renderStyledPdf, renderStyledPdfEncrypted } from "../pdf/styled-page-renderer.js";
 import "../pdf/index.js";
 import { readXlsx } from "./xlsx-reader.js";
 import { flowRenderOptions } from "../core/converter/project.js";
@@ -18,18 +18,18 @@ async function convertXlsxToPdf(xlsx, options = {}) {
 		...options,
 		signaturePlaceholder: signature
 	} : options;
-	let pdf;
-	if (renderOptions.fonts ?? renderOptions.fontBytes) pdf = convertXlsxToPdfSync(xlsx, renderOptions);
-	else {
-		const fonts = await fetchFontSet({
+	const withFonts = renderOptions.fonts ?? renderOptions.fontBytes ? renderOptions : {
+		...renderOptions,
+		fonts: await fetchFontSet({
 			...options.fontFamily ? { family: options.fontFamily } : {},
 			...options.fontFetch ? { fetch: options.fontFetch } : {}
-		});
-		pdf = convertXlsxToPdfSync(xlsx, {
-			...renderOptions,
-			fonts
-		});
+		})
+	};
+	if (withFonts.encrypt) {
+		const args = prepareXlsxStyledRender(xlsx, withFonts);
+		return renderStyledPdfEncrypted(args.body, args.styled);
 	}
+	const pdf = convertXlsxToPdfSync(xlsx, withFonts);
 	return signature ? signPdf(pdf, signature) : pdf;
 }
 /**
@@ -38,6 +38,10 @@ async function convertXlsxToPdf(xlsx, options = {}) {
 * Internal since 1.0 — see the async variant above.
 */
 function convertXlsxToPdfSync(xlsx, options) {
+	const args = prepareXlsxStyledRender(xlsx, options);
+	return renderStyledPdf(args.body, args.styled);
+}
+function prepareXlsxStyledRender(xlsx, options) {
 	const fonts = options.fonts ?? (options.fontBytes ? { regular: options.fontBytes } : void 0);
 	if (!fonts) throw new Error("convertXlsxToPdfSync requires options.fonts or options.fontBytes");
 	const registry = FontRegistry.fromBytes(fonts);
@@ -56,14 +60,17 @@ function convertXlsxToPdfSync(xlsx, options) {
 		relationship: "Source",
 		description: "Source Excel workbook"
 	});
-	return renderStyledPdf(flow.body, {
-		registry,
-		...flowRenderOptions(flow),
-		...section ? { section } : {},
-		...info ? { info } : {},
-		...attachments.length > 0 ? { attachments } : {},
-		...renderOptions
-	});
+	return {
+		body: flow.body,
+		styled: {
+			registry,
+			...flowRenderOptions(flow),
+			...section ? { section } : {},
+			...info ? { info } : {},
+			...attachments.length > 0 ? { attachments } : {},
+			...renderOptions
+		}
+	};
 }
 //#endregion
 export { convertXlsxToPdf };

package/dist/esm/html/html-writer.js

@@ -2,14 +2,23 @@ import { FEATURES } from "../core/ir/features.js";
 import { detectImageFormat } from "../core/images.js";
 import { EMPTY_STYLE_SHEET, resolveParagraphProperties, resolveRunProperties } from "../core/style-cascade/resolver.js";
 import "../core/style-cascade/index.js";
+import { PathBuilder, flipTransform, svgPathData } from "../core/vector.js";
+import { arcPoint, arcToBeziers } from "../core/arc-to-bezier.js";
+import { buildChartScene } from "../core/drawingml/chart-geometry.js";
+import { buildShapePaths, buildShapeTransform, buildStroke } from "../core/drawingml/shape-render.js";
+import { sanitizeHref } from "../core/links.js";
 import { toBase64 } from "../core/bytes.js";
 //#region src/html/html-writer.ts
 function writeHtml(flow) {
 	const losses = [];
 	const out = [];
+	const notes = collectNoteNumbers(flow);
 	const ctx = {
 		resources: flow.resources,
-		losses
+		losses,
+		notes,
+		referencedAnchors: collectReferencedAnchors(flow.body),
+		...flow.charts ? { charts: flow.charts } : {}
 	};
 	const lang = flow.language ?? "en-US";
 	const title = flow.info?.title ?? "Document";
@@ -29,6 +38,8 @@ function writeHtml(flow) {
 		detail: "headers/footers have no fixed pages to band onto in flowed HTML"
 	});
 	for (const el of flow.body) emitBlock(out, el, ctx);
+	emitNotesSection(out, flow.footnotes, ctx.notes.footnotes, "fn", ctx);
+	emitNotesSection(out, flow.endnotes, ctx.notes.endnotes, "en", ctx);
 	out.push("</article>");
 	out.push("</body>");
 	out.push("</html>");
@@ -46,6 +57,9 @@ var htmlWriter = {
 		FEATURES.tablesNested,
 		FEATURES.lists,
 		FEATURES.images,
+		FEATURES.hyperlinks,
+		FEATURES.charts,
+		FEATURES.shapes,
 		FEATURES.rtl,
 		FEATURES.trackedChanges
 	]),
@@ -59,36 +73,176 @@ var BASE_CSS = [
 	"td,th{vertical-align:top}",
 	"th{text-align:inherit}",
 	".tab{display:inline-block;min-width:18pt}",
-	"img{vertical-align:baseline}"
+	"img{vertical-align:baseline}",
+	".notes{margin-top:18pt;font-size:smaller}",
+	".notes hr{margin:0 0 6pt;border:none;border-top:0.75pt solid #000;width:144pt;margin-left:0}"
 ].join("");
+function collectReferencedAnchors(body) {
+	const out = /* @__PURE__ */ new Set();
+	const visit = (els) => {
+		for (const el of els) if (el.kind === "paragraph") {
+			for (const r of el.paragraph.runs) if (r.anchor !== void 0) out.add(r.anchor);
+		} else if (el.kind === "table") for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
+		else if (el.kind === "shape" && el.shape.text) visit(el.shape.text.content);
+	};
+	visit(body);
+	return out;
+}
+function collectNoteNumbers(flow) {
+	const footnotes = /* @__PURE__ */ new Map();
+	const endnotes = /* @__PURE__ */ new Map();
+	const visit = (els) => {
+		for (const el of els) if (el.kind === "paragraph") for (const r of el.paragraph.runs) {
+			if (r.footnoteRef !== void 0 && !footnotes.has(r.footnoteRef)) footnotes.set(r.footnoteRef, footnotes.size + 1);
+			if (r.endnoteRef !== void 0 && !endnotes.has(r.endnoteRef)) endnotes.set(r.endnoteRef, endnotes.size + 1);
+		}
+		else if (el.kind === "table") for (const row of el.table.rows) for (const cell of row.cells) visit(cell.content);
+		else if (el.kind === "shape" && el.shape.text) visit(el.shape.text.content);
+	};
+	visit(flow.body);
+	return {
+		footnotes,
+		endnotes
+	};
+}
+function emitNotesSection(out, content, numbers, prefix, ctx) {
+	if (!content || numbers.size === 0) return;
+	const ordered = [...numbers.entries()].sort((a, b) => a[1] - b[1]);
+	out.push("<section class=\"notes\"><hr/><ol>");
+	for (const [id, n] of ordered) {
+		const body = content.get(id);
+		out.push(`<li id="${prefix}-${n}">`);
+		if (body) for (const el of body) emitBlock(out, el, ctx);
+		out.push(`<a href="#${prefix}ref-${n}">\u21a9</a></li>`);
+	}
+	out.push("</ol></section>");
+}
 function emitBlock(out, el, ctx) {
 	if (el.kind === "paragraph") emitParagraph(out, el.paragraph, ctx);
 	else if (el.kind === "table") emitTable(out, el.table, ctx);
 	else if (el.kind === "image") emitImageBlock(out, el.image, ctx);
-	else if (el.kind === "chart") ctx.losses.push({
-		severity: "dropped",
-		feature: FEATURES.charts,
-		detail: "chart not rendered by the HTML writer (v0)"
-	});
-	else {
+	else if (el.kind === "chart") emitChartBlock(out, el.chart, ctx);
+	else emitShapeBlock(out, el.shape, ctx);
+}
+var approxTextWidth = (text, sizePt) => text.length * sizePt * .55;
+var blockFigureCss = (pp) => {
+	const css = [];
+	const align = pp.alignment === "center" || pp.alignment === "right" ? pp.alignment : void 0;
+	if (align) css.push(`text-align:${align}`);
+	if (pp.spacingBefore !== void 0 && pp.spacingBefore > 0) css.push(`margin-top:${fmt(pp.spacingBefore)}pt`);
+	if (pp.spacingAfter !== void 0 && pp.spacingAfter > 0) css.push(`margin-bottom:${fmt(pp.spacingAfter)}pt`);
+	return css.length > 0 ? ` style="${css.join(";")}"` : "";
+};
+var svgOpen = (w, h, label) => `<svg viewBox="0 0 ${fmt(w)} ${fmt(h)}" width="${fmt(w)}pt" height="${fmt(h)}pt" style="max-width:100%;height:auto" overflow="visible" xmlns="http://www.w3.org/2000/svg" role="img"${label ? ` aria-label="${escapeAttr(label)}"` : ""}>`;
+var strokeAttrs = (stroke) => {
+	if (!stroke) return "";
+	let out = ` stroke="#${stroke.colorHex}" stroke-width="${fmt(stroke.widthPt)}"`;
+	if (stroke.dash && stroke.dash.length > 0) out += ` stroke-dasharray="${stroke.dash.map(fmt).join(" ")}"`;
+	if (stroke.cap && stroke.cap !== "butt") out += ` stroke-linecap="${stroke.cap}"`;
+	if (stroke.join) out += ` stroke-linejoin="${stroke.join}"`;
+	return out;
+};
+function emitChartBlock(out, block, ctx) {
+	const chart = ctx.charts?.get(block.chartRelId);
+	const label = block.altText ?? chart?.title;
+	const figure = `<figure${blockFigureCss(block.paragraphProperties)}>`;
+	if (!chart) {
 		ctx.losses.push({
 			severity: "dropped",
-			feature: FEATURES.shapes,
-			detail: "shape geometry not rendered by the HTML writer (v0)"
+			feature: FEATURES.charts,
+			detail: `chart part '${block.chartRelId}' not supplied`
 		});
-		if (el.shape.text) {
-			out.push("<div>");
-			for (const child of el.shape.text.content) emitBlock(out, child, ctx);
-			out.push("</div>");
-		}
+		return;
+	}
+	const w = block.width;
+	const h = block.height;
+	const scene = buildChartScene(chart, w, h, approxTextWidth);
+	if (!scene) {
+		ctx.losses.push({
+			severity: "degraded",
+			feature: FEATURES.charts,
+			detail: `unsupported chart type '${chart.type}' — placeholder box`
+		});
+		out.push(figure + svgOpen(w, h, label) + `<rect x="0.5" y="0.5" width="${fmt(w - 1)}" height="${fmt(h - 1)}" fill="none" stroke="#D9D9D9"/></svg></figure>`);
+		return;
+	}
+	const svg = [figure, svgOpen(w, h, label)];
+	svg.push(`<g transform="matrix(1 0 0 -1 0 ${fmt(h)})">`);
+	for (const pg of scene.polygons ?? []) svg.push(polygonSvg(pg));
+	for (const r of scene.rects) svg.push(rectSvg(r));
+	for (const pl of scene.polylines) svg.push(polylineSvg(pl));
+	for (const wd of scene.wedges) svg.push(wedgeSvg(wd));
+	svg.push("</g>");
+	const anchor = {
+		left: "start",
+		center: "middle",
+		right: "end"
+	};
+	for (const l of scene.labels) svg.push(labelSvg(l, h, anchor[l.align]));
+	svg.push("</svg></figure>");
+	out.push(svg.join(""));
+}
+function rectSvg(r) {
+	const fill = r.fillHex ? `#${r.fillHex}` : "none";
+	const stroke = r.strokeHex ? ` stroke="#${r.strokeHex}" stroke-width="${fmt(r.strokeWidthPt ?? 1)}"` : "";
+	return `<rect x="${fmt(r.x)}" y="${fmt(r.y)}" width="${fmt(r.w)}" height="${fmt(r.h)}" fill="${fill}"${stroke}/>`;
+}
+var pointsAttr = (points) => points.map(([x, y]) => `${fmt(x)},${fmt(y)}`).join(" ");
+function polylineSvg(p) {
+	return `<polyline points="${pointsAttr(p.points)}" fill="none" stroke="#${p.strokeHex}" stroke-width="${fmt(p.widthPt)}"/>`;
+}
+function polygonSvg(p) {
+	const stroke = p.strokeHex ? ` stroke="#${p.strokeHex}" stroke-width="${fmt(p.widthPt ?? 1)}"` : "";
+	return `<polygon points="${pointsAttr(p.points)}" fill="#${p.fillHex}"${stroke}/>`;
+}
+function wedgeSvg(w) {
+	const start = arcPoint(w.cx, w.cy, w.r, w.r, w.startRad);
+	const b = new PathBuilder().moveTo(w.cx, w.cy).lineTo(start[0], start[1]).append(arcToBeziers(w.cx, w.cy, w.r, w.r, w.startRad, w.sweepRad)).close();
+	const stroke = w.strokeHex ? ` stroke="#${w.strokeHex}" stroke-width="1"` : "";
+	return `<path d="${svgPathData(b.build().segments, fmt)}" fill="#${w.fillHex}"${stroke}/>`;
+}
+function labelSvg(l, sceneH, anchor) {
+	return `<text x="${fmt(l.x)}" y="${fmt(sceneH - l.y)}" font-size="${fmt(l.sizePt)}" font-family="sans-serif" fill="#${l.colorHex}" text-anchor="${anchor}">${escapeText(l.text)}</text>`;
+}
+function emitShapeBlock(out, shape, ctx) {
+	const w = shape.width;
+	const h = shape.height;
+	const paths = buildShapePaths(shape.geometry, w, h);
+	const fill = shape.fill.kind === "solid" && shape.fill.colorHex ? `#${shape.fill.colorHex}` : "none";
+	const stroke = strokeAttrs(buildStroke(shape.line));
+	const t = shape.transform;
+	const transform = ` transform="matrix(${flipTransform(buildShapeTransform(0, 0, w, h, t?.rotation60k ?? 0, t?.flipH ?? false, t?.flipV ?? false), h).map(fmt).join(" ")})"`;
+	const svg = [svgOpen(w, h, shape.altText)];
+	for (const path of paths) {
+		const rule = path.fillRule === "evenodd" ? " fill-rule=\"evenodd\"" : "";
+		svg.push(`<path d="${svgPathData(path.segments, fmt)}" fill="${fill}"${rule}${stroke}${transform}/>`);
 	}
+	svg.push("</svg>");
+	const figureCss = blockFigureCss(shape.paragraphProperties);
+	const text = shape.text;
+	if (!text || text.content.length === 0) {
+		out.push(`<figure${figureCss}>${svg.join("")}</figure>`);
+		return;
+	}
+	const justify = text.anchor === "ctr" ? "center" : text.anchor === "b" ? "flex-end" : "flex-start";
+	const il = text.insetLeft ?? 7.2;
+	const ir = text.insetRight ?? 7.2;
+	const it = text.insetTop ?? 3.6;
+	const ib = text.insetBottom ?? 3.6;
+	out.push(`<figure${figureCss}><div style="position:relative;width:${fmt(w)}pt;height:${fmt(h)}pt;max-width:100%"><div style="position:absolute;left:0;top:0">${svg.join("")}</div><div style="position:absolute;left:${fmt(il)}pt;right:${fmt(ir)}pt;top:${fmt(it)}pt;bottom:${fmt(ib)}pt;display:flex;flex-direction:column;justify-content:${justify};overflow:hidden">`);
+	for (const child of text.content) emitBlock(out, child, ctx);
+	out.push("</div></div></figure>");
 }
 function emitParagraph(out, p, ctx) {
 	const resolved = resolveParagraphProperties(p.properties, EMPTY_STYLE_SHEET);
 	const lvl = resolved.outlineLevel;
 	const tag = lvl !== void 0 && lvl >= 0 && lvl <= 8 ? `h${Math.min(lvl, 5) + 1}` : "p";
 	const style = paragraphCss(resolved);
-	const open = `<${tag}${resolved.bidi ? " dir=\"rtl\"" : ""}${style ? ` style="${style}"` : ""}>`;
+	const dir = resolved.bidi ? " dir=\"rtl\"" : "";
+	const anchored = (p.bookmarks ?? []).filter((b) => ctx.referencedAnchors.has(b));
+	const idAttr = anchored.length > 0 ? ` id="bm-${encodeURIComponent(anchored[0])}"` : "";
+	const extraAnchors = anchored.slice(1).map((b) => `<span id="bm-${encodeURIComponent(b)}"></span>`).join("");
+	const open = `<${tag}${dir}${idAttr}${style ? ` style="${style}"` : ""}>${extraAnchors}`;
 	const parts = [];
 	for (const run of p.runs) parts.push(runHtml(run, p, ctx));
 	out.push(`${open}${parts.join("") || "&nbsp;"}</${tag}>`);
@@ -108,6 +262,14 @@ function paragraphCss(r) {
 	return css.join(";");
 }
 function runHtml(run, p, ctx) {
+	if (run.footnoteRef !== void 0 || run.endnoteRef !== void 0) {
+		const isFoot = run.footnoteRef !== void 0;
+		const n = isFoot ? ctx.notes.footnotes.get(run.footnoteRef) : ctx.notes.endnotes.get(run.endnoteRef);
+		if (n === void 0) return "";
+		const prefix = isFoot ? "fn" : "en";
+		return `<sup><a href="#${prefix}-${n}" id="${prefix}ref-${n}">${n}</a></sup>`;
+	}
+	if (run.noteNumber) return "";
 	if (run.math !== void 0) {
 		ctx.losses.push({
 			severity: "dropped",
@@ -128,6 +290,16 @@ function runHtml(run, p, ctx) {
 	let html = `<span${resolved.rtl ? " dir=\"rtl\"" : ""}${style ? ` style="${style}"` : ""}>${textHtml(run.text)}</span>`;
 	if (resolved.verticalAlign === "superscript") html = `<sup>${html}</sup>`;
 	else if (resolved.verticalAlign === "subscript") html = `<sub>${html}</sub>`;
+	if (run.href === void 0 && run.anchor !== void 0) return `<a href="#bm-${encodeURIComponent(run.anchor)}">${html}</a>`;
+	if (run.href !== void 0) {
+		const safe = sanitizeHref(run.href);
+		if (safe !== void 0) html = `<a href="${escapeAttr(safe)}">${html}</a>`;
+		else ctx.losses.push({
+			severity: "degraded",
+			feature: FEATURES.hyperlinks,
+			detail: `hyperlink target with a disallowed scheme rendered as plain text`
+		});
+	}
 	return html;
 }
 function runCss(r) {

package/dist/esm/index.d.ts

@@ -4,6 +4,7 @@ export { renderStyledPdf } from './pdf/index.js';
 export type { StyledRenderOptions, DocumentInfo } from './pdf/index.js';
 export { signPdf } from './pdf/index.js';
 export type { SignaturePlaceholder, SignerCredentials, SignatureOptions } from './pdf/index.js';
+export type { PdfEncryptOptions, PdfPermissions } from './pdf/index.js';
 export { FontRegistry, parseTtf, subsetTtf } from './core/font/index.js';
 export type { FontBytesByVariant, FontVariant, ParsedTtf } from './core/font/index.js';
 export { getHyphenator, createLanguageHyphenator, createHyphenator, splitPatternBundle, } from './core/hyphenation/index.js';

package/dist/esm/layout/page-doc.d.ts

@@ -13,6 +13,10 @@ export interface TextToken {
     readonly kind: 'text';
     readonly text: string;
     readonly isSpace: boolean;
+    readonly href?: string;
+    readonly footnoteRef?: string;
+    readonly anchor?: string;
+    readonly listMarker?: true;
     readonly resolvedRun: ResolvedRunProperties;
     readonly font: FontResource;
     readonly fontSizePt: number;

package/dist/esm/layout/styled-layout.d.ts

@@ -5,6 +5,7 @@ import { Hyphenator } from '../core/hyphenation/index.js';
 import { LaidOutDocument, PageItem } from './page-doc.js';
 import { AttachedFile } from '../pdf/embedded-file.js';
 import { SignaturePlaceholder } from '../pdf/signature.js';
+import { PdfEncryptOptions } from '../pdf/encryption.js';
 import { ResourceStore } from '../core/ir/index.js';
 import { StructTreeBuilder } from '../pdf/struct-tree.js';
 export type PdfALevel = 'PDF/A-1b' | 'PDF/A-1a' | 'PDF/A-2b' | 'PDF/A-2u' | 'PDF/A-2a' | 'PDF/A-3b' | 'PDF/A-3u' | 'PDF/A-3a';
@@ -23,6 +24,8 @@ export interface StyledRenderOptions {
     readonly section?: SectionProperties;
     readonly sections?: ReadonlyArray<Section>;
     readonly headersFooters?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
+    readonly footnotes?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
+    readonly endnotes?: ReadonlyMap<string, ReadonlyArray<BodyElement>>;
     readonly resources?: ResourceStore;
     readonly charts?: ReadonlyMap<string, Chart>;
     readonly pageWidth?: number;
@@ -35,18 +38,25 @@ export interface StyledRenderOptions {
     readonly info?: DocumentInfo;
     readonly pdfA?: PdfALevel;
     readonly tagged?: boolean;
+    readonly pdfUA?: boolean;
     readonly language?: string;
+    readonly encrypt?: PdfEncryptOptions;
     readonly attachments?: ReadonlyArray<AttachedFile>;
     readonly signaturePlaceholder?: SignaturePlaceholder;
 }
 export type { DocumentInfo } from '../core/document-model/index.js';
 export declare const A4_WIDTH = 595;
 export declare const A4_HEIGHT = 842;
+export interface BookmarkPosition {
+    readonly pageIdx: number;
+    readonly yTopPt: number;
+}
 export interface PdfLayoutAux {
     readonly structBuilder: StructTreeBuilder | undefined;
     readonly sectionCtxs: ReadonlyArray<SectionRenderCtx>;
     readonly pdfaProfile: PdfAProfile | undefined;
     readonly tagged: boolean;
+    readonly bookmarks: ReadonlyMap<string, BookmarkPosition>;
 }
 export interface LaidOutPdfDocument extends LaidOutDocument {
     readonly pdf: PdfLayoutAux;
@@ -72,13 +82,21 @@ export interface SectionRenderCtx {
     readonly marginBottom: number;
     readonly contentWidth: number;
     readonly pageContentHeight: number;
+    readonly columns?: ReadonlyArray<{
+        readonly xOffsetPt: number;
+        readonly widthPt: number;
+    }>;
     readonly headerSet: HeaderFooterSet;
     readonly footerSet: HeaderFooterSet;
     readonly titlePg: boolean;
     readonly evenAndOddHeaders: boolean;
 }
+interface HfBandEntry {
+    readonly commands: Array<PageItem>;
+    readonly renderDynamic?: (pageNumber: number, totalPages: number) => Array<PageItem>;
+}
 interface HeaderFooterSet {
-    readonly default: Array<PageItem>;
-    readonly first: Array<PageItem>;
-    readonly even: Array<PageItem>;
+    readonly default: HfBandEntry;
+    readonly first: HfBandEntry;
+    readonly even: HfBandEntry;
 }