@libpdf/core 0.2.6 → 0.2.7

package/dist/index.d.mts

@@ -2675,6 +2675,8 @@ declare class EmbeddedFont extends PdfFont {
   private _subsetTag;
   /** Whether this font is used in a form field (prevents subsetting) */
   private _usedInForm;
+  /** Pre-allocated PDF reference (set by PDFFonts.embed()) */
+  private _ref;
   /** Cached descriptor */
   private _descriptor;
   private constructor();
@@ -2790,6 +2792,22 @@ declare class EmbeddedFont extends PdfFont {
    * Call this before re-encoding if you want a fresh subset.
    */
   resetUsage(): void;
+  /**
+   * Get the pre-allocated PDF reference for this font.
+   *
+   * Set by `PDFFonts.embed()`. At save time, the actual font objects
+   * (Type0 dict, CIDFont, FontDescriptor, font program, ToUnicode)
+   * are created and registered at this ref.
+   *
+   * @throws {Error} if the font was not embedded via `pdf.embedFont()`
+   */
+  get ref(): PdfRef;
+  /**
+   * Set the pre-allocated PDF reference.
+   *
+   * @internal Called by PDFFonts.embed()
+   */
+  setRef(ref: PdfRef): void;
   /**
    * Mark this font as used in a form field.
    *

package/dist/index.mjs

@@ -10,7 +10,7 @@ import { createCMSECDSASignature } from "pkijs";
 import { base64 } from "@scure/base";
 
 //#region package.json
-var version = "0.2.6";
+var version = "0.2.7";
 
 //#endregion
 //#region src/objects/pdf-array.ts
@@ -11699,6 +11699,8 @@ var EmbeddedFont = class EmbeddedFont extends PdfFont {
 	_subsetTag = null;
 	/** Whether this font is used in a form field (prevents subsetting) */
 	_usedInForm = false;
+	/** Pre-allocated PDF reference (set by PDFFonts.embed()) */
+	_ref = null;
 	/** Cached descriptor */
 	_descriptor = null;
 	constructor(fontProgram, fontData) {
@@ -11895,6 +11897,27 @@ var EmbeddedFont = class EmbeddedFont extends PdfFont {
 		this._subsetTag = null;
 	}
 	/**
+	* Get the pre-allocated PDF reference for this font.
+	*
+	* Set by `PDFFonts.embed()`. At save time, the actual font objects
+	* (Type0 dict, CIDFont, FontDescriptor, font program, ToUnicode)
+	* are created and registered at this ref.
+	*
+	* @throws {Error} if the font was not embedded via `pdf.embedFont()`
+	*/
+	get ref() {
+		if (!this._ref) throw new Error("Font has no PDF reference. Use pdf.embedFont() to embed fonts.");
+		return this._ref;
+	}
+	/**
+	* Set the pre-allocated PDF reference.
+	*
+	* @internal Called by PDFFonts.embed()
+	*/
+	setRef(ref) {
+		this._ref = ref;
+	}
+	/**
 	* Mark this font as used in a form field.
 	*
 	* Fonts used in form fields cannot be subsetted because users may type
@@ -18674,10 +18697,8 @@ function buildResources$2(ctx, font, fontName) {
 	const resources = new PdfDict();
 	const fonts = new PdfDict();
 	const cleanName = fontName.startsWith("/") ? fontName.slice(1) : fontName;
-	if (isEmbeddedFont(font)) {
-		const fontRef = ctx.registry.register(buildEmbeddedFontDict$2(font));
-		fonts.set(cleanName, fontRef);
-	} else if (isExistingFont(font) && font.ref) fonts.set(cleanName, font.ref);
+	if (isEmbeddedFont(font)) fonts.set(cleanName, font.ref);
+	else if (isExistingFont(font) && font.ref) fonts.set(cleanName, font.ref);
 	else {
 		const fontDict = new PdfDict();
 		fontDict.set("Type", PdfName.of("Font"));
@@ -18688,14 +18709,6 @@ function buildResources$2(ctx, font, fontName) {
 	resources.set("Font", fonts);
 	return resources;
 }
-function buildEmbeddedFontDict$2(font) {
-	const dict = new PdfDict();
-	dict.set("Type", PdfName.of("Font"));
-	dict.set("Subtype", PdfName.of("Type0"));
-	dict.set("BaseFont", PdfName.of(font.baseFontName));
-	dict.set("Encoding", PdfName.of("Identity-H"));
-	return dict;
-}
 
 //#endregion
 //#region src/document/forms/choice-appearance.ts
@@ -18888,10 +18901,8 @@ function buildResources$1(ctx, font, fontName) {
 	const resources = new PdfDict();
 	const fonts = new PdfDict();
 	const cleanName = fontName.startsWith("/") ? fontName.slice(1) : fontName;
-	if (isEmbeddedFont(font)) {
-		const fontRef = ctx.registry.register(buildEmbeddedFontDict$1(font));
-		fonts.set(cleanName, fontRef);
-	} else if (isExistingFont(font) && font.ref) fonts.set(cleanName, font.ref);
+	if (isEmbeddedFont(font)) fonts.set(cleanName, font.ref);
+	else if (isExistingFont(font) && font.ref) fonts.set(cleanName, font.ref);
 	else {
 		const fontDict = new PdfDict();
 		fontDict.set("Type", PdfName.of("Font"));
@@ -18902,14 +18913,6 @@ function buildResources$1(ctx, font, fontName) {
 	resources.set("Font", fonts);
 	return resources;
 }
-function buildEmbeddedFontDict$1(font) {
-	const dict = new PdfDict();
-	dict.set("Type", PdfName.of("Font"));
-	dict.set("Subtype", PdfName.of("Type0"));
-	dict.set("BaseFont", PdfName.of(font.baseFontName));
-	dict.set("Encoding", PdfName.of("Identity-H"));
-	return dict;
-}
 
 //#endregion
 //#region src/document/forms/text-appearance.ts
@@ -19211,10 +19214,8 @@ function buildResources(ctx, font, fontName) {
 	const resources = new PdfDict();
 	const fonts = new PdfDict();
 	const cleanName = fontName.startsWith("/") ? fontName.slice(1) : fontName;
-	if (isEmbeddedFont(font)) {
-		const fontRef = ctx.registry.register(buildEmbeddedFontDict(font));
-		fonts.set(cleanName, fontRef);
-	} else if (isExistingFont(font) && font.ref) fonts.set(cleanName, font.ref);
+	if (isEmbeddedFont(font)) fonts.set(cleanName, font.ref);
+	else if (isExistingFont(font) && font.ref) fonts.set(cleanName, font.ref);
 	else {
 		const fontDict = new PdfDict();
 		fontDict.set("Type", PdfName.of("Font"));
@@ -19225,14 +19226,6 @@ function buildResources(ctx, font, fontName) {
 	resources.set("Font", fonts);
 	return resources;
 }
-function buildEmbeddedFontDict(font) {
-	const dict = new PdfDict();
-	dict.set("Type", PdfName.of("Font"));
-	dict.set("Subtype", PdfName.of("Type0"));
-	dict.set("BaseFont", PdfName.of(font.baseFontName));
-	dict.set("Encoding", PdfName.of("Identity-H"));
-	return dict;
-}
 function calculateAppearanceMatrix(width, height, rotation) {
 	switch (Math.abs(rotation)) {
 		case 90: return [
@@ -36760,6 +36753,7 @@ var PDFFonts = class {
 		const font = EmbeddedFont.fromBytes(data, options);
 		const ref = this.ctx.registry.allocateRef();
 		this.embeddedFonts.set(font, ref);
+		font.setRef(ref);
 		return font;
 	}
 	/**
@@ -37419,13 +37413,7 @@ var PDFForm = class PDFForm {
 	* Register an embedded font in the form's default resources.
 	*/
 	registerFontInFormResources(font) {
-		const fontRef = this._ctx.registry.register(PdfDict.of({
-			Type: PdfName.of("Font"),
-			Subtype: PdfName.of("Type0"),
-			BaseFont: PdfName.of(font.baseFontName),
-			Encoding: PdfName.of("Identity-H")
-		}));
-		this._acroForm.addFontToResources(fontRef);
+		this._acroForm.addFontToResources(font.ref);
 	}
 	/**
 	* Store field styling metadata for appearance generation.