documents.js 1.72.0 → 1.74.0

package/dist/edit/pdf/item.js

@@ -0,0 +1,468 @@
+import { registerImageBytes, spliceOut } from "./util.js";
+//#region src/edit/pdf/item.ts
+var PdfItemBase = class {
+	container;
+	node;
+	typeName;
+	removed = false;
+	constructor(container, node, typeName) {
+		this.container = container;
+		this.node = node;
+		this.typeName = typeName;
+	}
+	live() {
+		if (this.removed) throw new Error(`this ${this.typeName} has been removed from its page and can no longer be used`);
+		return this.node;
+	}
+	get sourcePath() {
+		return this.live().sourcePath;
+	}
+	remove() {
+		const node = this.live();
+		spliceOut(this.container, node);
+		this.removed = true;
+	}
+};
+function requirePositive(value, field) {
+	if (!(value > 0)) throw new Error(`${field} must be a positive number, got ${value}`);
+}
+function requireNonNegative(value, field) {
+	if (!(value >= 0)) throw new Error(`${field} must be a nonnegative number, got ${value}`);
+}
+function setOrDelete(node, key, value) {
+	if (value === void 0) {
+		delete node[key];
+		return;
+	}
+	node[key] = value;
+}
+function buildTextItem(init) {
+	requirePositive(init.sizePt, "sizePt");
+	return {
+		kind: "text",
+		xPt: init.xPt,
+		yPt: init.yPt,
+		text: init.text,
+		font: init.font,
+		sizePt: init.sizePt,
+		color: init.color,
+		rotationDeg: init.rotationDeg,
+		underline: init.underline
+	};
+}
+var PdfTextItem = class extends PdfItemBase {
+	kind = "text";
+	constructor(container, node) {
+		super(container, node, "PdfTextItem");
+	}
+	get xPt() {
+		return this.live().xPt;
+	}
+	set xPt(value) {
+		this.live().xPt = value;
+	}
+	get yPt() {
+		return this.live().yPt;
+	}
+	set yPt(value) {
+		this.live().yPt = value;
+	}
+	get text() {
+		return this.live().text;
+	}
+	set text(value) {
+		this.live().text = value;
+	}
+	get font() {
+		return this.live().font;
+	}
+	set font(value) {
+		this.live().font = value;
+	}
+	get sizePt() {
+		return this.live().sizePt;
+	}
+	set sizePt(value) {
+		requirePositive(value, "sizePt");
+		this.live().sizePt = value;
+	}
+	get color() {
+		return this.live().color;
+	}
+	set color(value) {
+		this.live().color = value;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		if (value !== void 0) requireNonNegative(value, "widthPt");
+		setOrDelete(this.live(), "widthPt", value);
+	}
+	get rotationDeg() {
+		return this.live().rotationDeg;
+	}
+	set rotationDeg(value) {
+		setOrDelete(this.live(), "rotationDeg", value);
+	}
+	get underline() {
+		return this.live().underline;
+	}
+	set underline(value) {
+		setOrDelete(this.live(), "underline", value);
+	}
+};
+function requireValidStroke(stroke) {
+	if (stroke !== void 0) requirePositive(stroke.widthPt, "stroke.widthPt");
+}
+function buildRectItem(init) {
+	requireNonNegative(init.widthPt, "widthPt");
+	requireNonNegative(init.heightPt, "heightPt");
+	requireValidStroke(init.stroke);
+	return {
+		kind: "rect",
+		xPt: init.xPt,
+		yPt: init.yPt,
+		widthPt: init.widthPt,
+		heightPt: init.heightPt,
+		fill: init.fill,
+		stroke: init.stroke
+	};
+}
+function buildEllipseItem(init) {
+	requirePositive(init.widthPt, "widthPt");
+	requirePositive(init.heightPt, "heightPt");
+	requireValidStroke(init.stroke);
+	return {
+		kind: "ellipse",
+		xPt: init.xPt,
+		yPt: init.yPt,
+		widthPt: init.widthPt,
+		heightPt: init.heightPt,
+		fill: init.fill,
+		stroke: init.stroke
+	};
+}
+var PdfRectItem = class extends PdfItemBase {
+	kind = "rect";
+	constructor(container, node) {
+		super(container, node, "PdfRectItem");
+	}
+	get xPt() {
+		return this.live().xPt;
+	}
+	set xPt(value) {
+		this.live().xPt = value;
+	}
+	get yPt() {
+		return this.live().yPt;
+	}
+	set yPt(value) {
+		this.live().yPt = value;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		requireNonNegative(value, "widthPt");
+		this.live().widthPt = value;
+	}
+	get heightPt() {
+		return this.live().heightPt;
+	}
+	set heightPt(value) {
+		requireNonNegative(value, "heightPt");
+		this.live().heightPt = value;
+	}
+	get fill() {
+		return this.live().fill;
+	}
+	set fill(value) {
+		setOrDelete(this.live(), "fill", value);
+	}
+	get stroke() {
+		return this.live().stroke;
+	}
+	set stroke(value) {
+		requireValidStroke(value);
+		setOrDelete(this.live(), "stroke", value);
+	}
+};
+var PdfEllipseItem = class extends PdfItemBase {
+	kind = "ellipse";
+	constructor(container, node) {
+		super(container, node, "PdfEllipseItem");
+	}
+	get xPt() {
+		return this.live().xPt;
+	}
+	set xPt(value) {
+		this.live().xPt = value;
+	}
+	get yPt() {
+		return this.live().yPt;
+	}
+	set yPt(value) {
+		this.live().yPt = value;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		requirePositive(value, "widthPt");
+		this.live().widthPt = value;
+	}
+	get heightPt() {
+		return this.live().heightPt;
+	}
+	set heightPt(value) {
+		requirePositive(value, "heightPt");
+		this.live().heightPt = value;
+	}
+	get fill() {
+		return this.live().fill;
+	}
+	set fill(value) {
+		setOrDelete(this.live(), "fill", value);
+	}
+	get stroke() {
+		return this.live().stroke;
+	}
+	set stroke(value) {
+		requireValidStroke(value);
+		setOrDelete(this.live(), "stroke", value);
+	}
+};
+function buildLineItem(init) {
+	requirePositive(init.widthPt, "widthPt");
+	return {
+		kind: "line",
+		x1Pt: init.x1Pt,
+		y1Pt: init.y1Pt,
+		x2Pt: init.x2Pt,
+		y2Pt: init.y2Pt,
+		color: init.color,
+		widthPt: init.widthPt,
+		style: init.style
+	};
+}
+var PdfLineItem = class extends PdfItemBase {
+	kind = "line";
+	constructor(container, node) {
+		super(container, node, "PdfLineItem");
+	}
+	get x1Pt() {
+		return this.live().x1Pt;
+	}
+	set x1Pt(value) {
+		this.live().x1Pt = value;
+	}
+	get y1Pt() {
+		return this.live().y1Pt;
+	}
+	set y1Pt(value) {
+		this.live().y1Pt = value;
+	}
+	get x2Pt() {
+		return this.live().x2Pt;
+	}
+	set x2Pt(value) {
+		this.live().x2Pt = value;
+	}
+	get y2Pt() {
+		return this.live().y2Pt;
+	}
+	set y2Pt(value) {
+		this.live().y2Pt = value;
+	}
+	get color() {
+		return this.live().color;
+	}
+	set color(value) {
+		this.live().color = value;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		requirePositive(value, "widthPt");
+		this.live().widthPt = value;
+	}
+	get style() {
+		return this.live().style;
+	}
+	set style(value) {
+		setOrDelete(this.live(), "style", value);
+	}
+};
+function buildPathItem(init) {
+	requireValidStroke(init.stroke);
+	return {
+		kind: "path",
+		subpaths: [...init.subpaths],
+		fill: init.fill,
+		fillRule: init.fillRule,
+		stroke: init.stroke,
+		style: init.style
+	};
+}
+var PdfPathItem = class extends PdfItemBase {
+	kind = "path";
+	constructor(container, node) {
+		super(container, node, "PdfPathItem");
+	}
+	get subpaths() {
+		return this.live().subpaths;
+	}
+	set subpaths(value) {
+		this.live().subpaths = [...value];
+	}
+	get fill() {
+		return this.live().fill;
+	}
+	set fill(value) {
+		setOrDelete(this.live(), "fill", value);
+	}
+	get fillRule() {
+		return this.live().fillRule;
+	}
+	set fillRule(value) {
+		setOrDelete(this.live(), "fillRule", value);
+	}
+	get stroke() {
+		return this.live().stroke;
+	}
+	set stroke(value) {
+		requireValidStroke(value);
+		setOrDelete(this.live(), "stroke", value);
+	}
+	get style() {
+		return this.live().style;
+	}
+	set style(value) {
+		setOrDelete(this.live(), "style", value);
+	}
+};
+function buildImageItem(init, images) {
+	requirePositive(init.widthPt, "widthPt");
+	requirePositive(init.heightPt, "heightPt");
+	return {
+		kind: "image",
+		imageId: registerImageBytes(init.bytes, init.format, images),
+		xPt: init.xPt,
+		yPt: init.yPt,
+		widthPt: init.widthPt,
+		heightPt: init.heightPt,
+		rotationDeg: init.rotationDeg
+	};
+}
+var PdfImageItem = class extends PdfItemBase {
+	kind = "image";
+	images;
+	constructor(container, node, images) {
+		super(container, node, "PdfImageItem");
+		this.images = images;
+	}
+	get imageId() {
+		return this.live().imageId;
+	}
+	get xPt() {
+		return this.live().xPt;
+	}
+	set xPt(value) {
+		this.live().xPt = value;
+	}
+	get yPt() {
+		return this.live().yPt;
+	}
+	set yPt(value) {
+		this.live().yPt = value;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		requirePositive(value, "widthPt");
+		this.live().widthPt = value;
+	}
+	get heightPt() {
+		return this.live().heightPt;
+	}
+	set heightPt(value) {
+		requirePositive(value, "heightPt");
+		this.live().heightPt = value;
+	}
+	get rotationDeg() {
+		return this.live().rotationDeg;
+	}
+	set rotationDeg(value) {
+		setOrDelete(this.live(), "rotationDeg", value);
+	}
+	setImage(bytes, format) {
+		const node = this.live();
+		node.imageId = registerImageBytes(bytes, format, this.images);
+	}
+};
+function buildLinkItem(init) {
+	requireNonNegative(init.widthPt, "widthPt");
+	requireNonNegative(init.heightPt, "heightPt");
+	return {
+		kind: "link",
+		uri: init.uri,
+		xPt: init.xPt,
+		yPt: init.yPt,
+		widthPt: init.widthPt,
+		heightPt: init.heightPt
+	};
+}
+var PdfLinkItem = class extends PdfItemBase {
+	kind = "link";
+	constructor(container, node) {
+		super(container, node, "PdfLinkItem");
+	}
+	get uri() {
+		return this.live().uri;
+	}
+	set uri(value) {
+		this.live().uri = value;
+	}
+	get xPt() {
+		return this.live().xPt;
+	}
+	set xPt(value) {
+		this.live().xPt = value;
+	}
+	get yPt() {
+		return this.live().yPt;
+	}
+	set yPt(value) {
+		this.live().yPt = value;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		requireNonNegative(value, "widthPt");
+		this.live().widthPt = value;
+	}
+	get heightPt() {
+		return this.live().heightPt;
+	}
+	set heightPt(value) {
+		requireNonNegative(value, "heightPt");
+		this.live().heightPt = value;
+	}
+};
+function wrapItem(container, node, images) {
+	switch (node.kind) {
+		case "text": return new PdfTextItem(container, node);
+		case "image": return new PdfImageItem(container, node, images);
+		case "rect": return new PdfRectItem(container, node);
+		case "ellipse": return new PdfEllipseItem(container, node);
+		case "line": return new PdfLineItem(container, node);
+		case "path": return new PdfPathItem(container, node);
+		case "link": return new PdfLinkItem(container, node);
+	}
+}
+//#endregion
+export { PdfEllipseItem, PdfImageItem, PdfLineItem, PdfLinkItem, PdfPathItem, PdfRectItem, PdfTextItem, buildEllipseItem, buildImageItem, buildLineItem, buildLinkItem, buildPathItem, buildRectItem, buildTextItem, wrapItem };

package/dist/edit/pdf/page.cjs

@@ -0,0 +1,178 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_edit_pdf_util = require("./util.cjs");
+const require_edit_pdf_item = require("./item.cjs");
+//#region src/edit/pdf/page.ts
+const DEFAULT_PAGE_WIDTH_PT = 612;
+const DEFAULT_PAGE_HEIGHT_PT = 792;
+function buildPage(init = {}) {
+	const widthPt = init.widthPt ?? DEFAULT_PAGE_WIDTH_PT;
+	const heightPt = init.heightPt ?? DEFAULT_PAGE_HEIGHT_PT;
+	if (!(widthPt > 0)) throw new Error(`widthPt must be a positive number, got ${widthPt}`);
+	if (!(heightPt > 0)) throw new Error(`heightPt must be a positive number, got ${heightPt}`);
+	return {
+		widthPt,
+		heightPt,
+		items: [],
+		notes: init.notes
+	};
+}
+var PdfPage = class {
+	container;
+	node;
+	images;
+	removed = false;
+	constructor(container, node, images) {
+		this.container = container;
+		this.node = node;
+		this.images = images;
+	}
+	live() {
+		if (this.removed) throw new Error("this PdfPage has been removed from its document and can no longer be used");
+		return this.node;
+	}
+	get widthPt() {
+		return this.live().widthPt;
+	}
+	set widthPt(value) {
+		if (!(value > 0)) throw new Error(`widthPt must be a positive number, got ${value}`);
+		this.live().widthPt = value;
+	}
+	get heightPt() {
+		return this.live().heightPt;
+	}
+	set heightPt(value) {
+		if (!(value > 0)) throw new Error(`heightPt must be a positive number, got ${value}`);
+		this.live().heightPt = value;
+	}
+	get notes() {
+		return this.live().notes;
+	}
+	set notes(value) {
+		const node = this.live();
+		if (value === void 0) {
+			delete node.notes;
+			return;
+		}
+		node.notes = value;
+	}
+	items() {
+		const node = this.live();
+		return node.items.map((item) => require_edit_pdf_item.wrapItem(node.items, item, this.images));
+	}
+	textItems() {
+		return this.items().filter((item) => item.kind === "text");
+	}
+	imageItems() {
+		return this.items().filter((item) => item.kind === "image");
+	}
+	rectItems() {
+		return this.items().filter((item) => item.kind === "rect");
+	}
+	ellipseItems() {
+		return this.items().filter((item) => item.kind === "ellipse");
+	}
+	lineItems() {
+		return this.items().filter((item) => item.kind === "line");
+	}
+	pathItems() {
+		return this.items().filter((item) => item.kind === "path");
+	}
+	linkItems() {
+		return this.items().filter((item) => item.kind === "link");
+	}
+	clampIndex(index) {
+		return Math.min(Math.max(index, 0), this.live().items.length);
+	}
+	appendText(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildTextItem(init);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfTextItem(node.items, item);
+	}
+	insertTextAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildTextItem(init);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfTextItem(node.items, item);
+	}
+	appendRect(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildRectItem(init);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfRectItem(node.items, item);
+	}
+	insertRectAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildRectItem(init);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfRectItem(node.items, item);
+	}
+	appendEllipse(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildEllipseItem(init);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfEllipseItem(node.items, item);
+	}
+	insertEllipseAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildEllipseItem(init);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfEllipseItem(node.items, item);
+	}
+	appendLine(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildLineItem(init);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfLineItem(node.items, item);
+	}
+	insertLineAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildLineItem(init);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfLineItem(node.items, item);
+	}
+	appendPath(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildPathItem(init);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfPathItem(node.items, item);
+	}
+	insertPathAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildPathItem(init);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfPathItem(node.items, item);
+	}
+	appendImage(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildImageItem(init, this.images);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfImageItem(node.items, item, this.images);
+	}
+	insertImageAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildImageItem(init, this.images);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfImageItem(node.items, item, this.images);
+	}
+	appendLink(init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildLinkItem(init);
+		node.items.push(item);
+		return new require_edit_pdf_item.PdfLinkItem(node.items, item);
+	}
+	insertLinkAt(index, init) {
+		const node = this.live();
+		const item = require_edit_pdf_item.buildLinkItem(init);
+		node.items.splice(this.clampIndex(index), 0, item);
+		return new require_edit_pdf_item.PdfLinkItem(node.items, item);
+	}
+	remove() {
+		const node = this.live();
+		require_edit_pdf_util.spliceOut(this.container, node);
+		this.removed = true;
+	}
+};
+//#endregion
+exports.PdfPage = PdfPage;
+exports.buildPage = buildPage;

package/dist/edit/pdf/page.d.cts

@@ -0,0 +1,49 @@
+import { a as PdfItem, c as PdfLinkInit, d as PdfPathItem, f as PdfRectInit, h as PdfTextItem, i as PdfImageItem, l as PdfLinkItem, m as PdfTextInit, n as PdfEllipseItem, o as PdfLineInit, p as PdfRectItem, r as PdfImageInit, s as PdfLineItem, t as PdfEllipseInit, u as PdfPathInit } from "../../item-DhYRoAvM.cjs";
+import { LayoutImageAsset, LayoutPage } from "document-schema.js";
+//#region src/edit/pdf/page.d.ts
+interface PageInit {
+  readonly widthPt?: number;
+  readonly heightPt?: number;
+  readonly notes?: string;
+}
+declare function buildPage(init?: PageInit): LayoutPage;
+declare class PdfPage {
+  private readonly container;
+  private readonly node;
+  private readonly images;
+  private removed;
+  constructor(container: LayoutPage[], node: LayoutPage, images: Record<string, LayoutImageAsset>);
+  private live;
+  get widthPt(): number;
+  set widthPt(value: number);
+  get heightPt(): number;
+  set heightPt(value: number);
+  get notes(): string | undefined;
+  set notes(value: string | undefined);
+  items(): PdfItem[];
+  textItems(): PdfTextItem[];
+  imageItems(): PdfImageItem[];
+  rectItems(): PdfRectItem[];
+  ellipseItems(): PdfEllipseItem[];
+  lineItems(): PdfLineItem[];
+  pathItems(): PdfPathItem[];
+  linkItems(): PdfLinkItem[];
+  private clampIndex;
+  appendText(init: PdfTextInit): PdfTextItem;
+  insertTextAt(index: number, init: PdfTextInit): PdfTextItem;
+  appendRect(init: PdfRectInit): PdfRectItem;
+  insertRectAt(index: number, init: PdfRectInit): PdfRectItem;
+  appendEllipse(init: PdfEllipseInit): PdfEllipseItem;
+  insertEllipseAt(index: number, init: PdfEllipseInit): PdfEllipseItem;
+  appendLine(init: PdfLineInit): PdfLineItem;
+  insertLineAt(index: number, init: PdfLineInit): PdfLineItem;
+  appendPath(init: PdfPathInit): PdfPathItem;
+  insertPathAt(index: number, init: PdfPathInit): PdfPathItem;
+  appendImage(init: PdfImageInit): PdfImageItem;
+  insertImageAt(index: number, init: PdfImageInit): PdfImageItem;
+  appendLink(init: PdfLinkInit): PdfLinkItem;
+  insertLinkAt(index: number, init: PdfLinkInit): PdfLinkItem;
+  remove(): void;
+}
+//#endregion
+export { PageInit, PdfPage, buildPage };