pdf-codec 4.0.11 → 4.0.12

package/README.md

@@ -269,7 +269,7 @@ Dependency direction is strictly downward and checkable: `layout` imports only `
 - **The OpenType `MATH` table's `MathVariants` is parsed, stretchy-glyph assembly implemented, and the result genuinely drawable** via `MathAssembledGlyphs` (glyph-ID-addressed placements, since most construction glyphs have no Unicode code point — they draw directly because CID == GID here). An unencoded glyph gets no ToUnicode entry; the construction is wrapped in an `/ActualText` span carrying the operator's own text so it still extracts as `(`. `MathConstants` and `MathGlyphInfo` (italics correction, top-accent attachment) are parsed in full.
 - **What this package draws for a stretchy glyph is decided entirely by its caller.** Which operators a document actually stretches is a layout-engine decision — `documents.js`'s own `src/mathml/layout.ts` currently stretches vertical fences in an `mrow` and nothing else.
 - **Real per-glyph ink bounds are measured from the outline (`inkAscentPt`/`inkDescentPt`), computed by walking each glyph's Type 2 charstring.** `ascentPerEm`/`descentPerEm` remain alongside them as the uniform face-wide figure, still the right measure for anything sized against the font rather than particular characters, and the fallback for a glyph with no outline to measure. An ink box is genuinely tight, which for a math font is often _larger_ than the nominal metrics (over a tenth of STIX Two Math's repertoire draws above its nominal ascent). `inkDescentPt` is negative where the glyph's lowest ink sits above the baseline.
-- **A `LayoutLine`/`LayoutPath` `style` of `dashed`/`dotted` becomes a real dash-array (`d`) operator scaled to the stroke's own width; `double` becomes two genuinely separate offset strokes.** Dash lengths are stroke-width multiples so a hairline and a thick rule both read as recognisably dashed: `dashed` emits `[3w 3w] 0 d`, `dotted` emits `[0 2w] 0 d` with a `1 J` round cap (the zero on-length under a round cap paints a filled circle — exactly a dot; under PDF's default butt cap it paints nothing). Both are reset immediately after the paint operator (`[] 0 d`, `0 J`) since the graphics state persists for the whole content stream. `double` has no PDF operator and is drawn as geometry: width `w` splits into three equal bands, each rule `w/3` wide with centreline `w/3` offset, outer edges matching the single stroke's. Nothing on the read side recovers a stroke style — a dashed line read back comes back solid.
+- **A `LayoutLine`/`LayoutPath` `style` of `dashed`/`dotted` becomes a real dash-array (`d`) operator scaled to the stroke's own width; `double` becomes two genuinely separate offset strokes.** Dash lengths are stroke-width multiples so a hairline and a thick rule both read as recognisably dashed: `dashed` emits `[3w 3w] 0 d`, `dotted` emits `[0 2w] 0 d` with a `1 J` round cap (the zero on-length under a round cap paints a filled circle — exactly a dot; under PDF's default butt cap it paints nothing). Both are reset immediately after the paint operator (`[] 0 d`, `0 J`) since the graphics state persists for the whole content stream. `double` has no PDF operator and is drawn as geometry: width `w` splits into three equal bands, each rule `w/3` wide with centreline `w/3` offset, outer edges matching the single stroke's. The read side tracks the `d` operator's own dash array as graphics state and recovers `dashed`/`dotted` back onto a stroked `LayoutLine`/`LayoutPath` from it — a zero on-length reads as `dotted`, any other non-empty array as `dashed`, an empty array (or none at all) as `solid`. `double` has no operator of its own to recover from, so it reads back as whatever geometry its two offset strokes actually are (typically two plain solid lines or paths), not as `double`.
 - **An embedded `CIDFontType2` program needs no `cmap` table of its own**, and `sfnt-subset.ts`'s output doesn't carry one — character code → CID goes through the `Type0` font's `/Encoding` (Identity-H, so CID == character code), and CID → GID through `/CIDToGIDMap /Identity` (matching the GID-preserving design). Both happen inside the PDF's object graph, before the embedded font program is consulted (ISO 32000-1 9.7.4.2).
 - **`GPOS` pair kerning is read and applied for an embedded face; no other OpenType layout feature is.** `GSUB` (ligatures, contextual alternates, small caps) is never applied — a face's `fi` ligature is drawn as two separate glyphs. The legacy `kern` table is not read either (neither Carlito nor Caladea ships one). A kerned run is shown with `TJ`, and the sign of a `TJ` number is the opposite of the adjustment it expresses (ISO 32000-1 9.4.3: a positive number moves the next glyph closer). A run with no kerning pairs stays as one unsplit hex string with `Tj`.
 - **Kerning applies to whole shown strings, so a wrap decision does not see a pair straddling the boundary between two separately-measured words.** The width a line reports is the width the page draws; making the wrap decision itself exact would mean widening the `TextMeasurer` port for a sub-point difference that only ever errs towards breaking a line early.

package/dist/interpret.cjs

@@ -250,7 +250,11 @@ function detectEllipse(subpath, paint) {
 		stroke: paint.stroke
 	};
 }
-function detectLine(subpath, paint) {
+function strokeStyleFromDashArray(dashArray) {
+	if (dashArray.length === 0) return;
+	return dashArray.length === 2 && dashArray[0] === 0 ? "dotted" : "dashed";
+}
+function detectLine(subpath, paint, style) {
 	const segment = subpath.segments[0];
 	if (subpath.closed || subpath.segments.length !== 1 || segment?.kind !== "line") return;
 	if (paint.fill !== void 0 || paint.stroke === void 0) return;
@@ -261,13 +265,14 @@ function detectLine(subpath, paint) {
 		x2Pt: segment.xPt,
 		y2Pt: segment.yPt,
 		color: paint.stroke.color,
-		widthPt: paint.stroke.widthPt
+		widthPt: paint.stroke.widthPt,
+		...style !== void 0 ? { style } : {}
 	};
 }
-function classifyShape(subpaths, paint) {
+function classifyShape(subpaths, paint, style) {
 	const subpath = subpaths[0];
 	if (subpaths.length !== 1 || subpath === void 0) return;
-	return detectRect(subpath, paint) ?? detectEllipse(subpath, paint) ?? detectLine(subpath, paint);
+	return detectRect(subpath, paint) ?? detectEllipse(subpath, paint) ?? detectLine(subpath, paint, style);
 }
 function interpretContentStream(bytes, resources, context) {
 	const items = [];
@@ -276,6 +281,7 @@ function interpretContentStream(bytes, resources, context) {
 		fillColor: document_schema_js.COLOR_BLACK,
 		strokeColor: document_schema_js.COLOR_BLACK,
 		lineWidth: DEFAULT_LINE_WIDTH_PT,
+		dashArray: [],
 		...initialTextParameters()
 	}, context, items, 0, []);
 	return items;
@@ -402,11 +408,13 @@ function runContentStream(bytes, resources, initialState, context, items, depth,
 					widthPt: gs.lineWidth
 				} : void 0
 			};
-			pushItem(classifyShape(pathSubpaths, paint) ?? {
+			const strokeStyle = isStrokeOp ? strokeStyleFromDashArray(gs.dashArray) : void 0;
+			pushItem(classifyShape(pathSubpaths, paint, strokeStyle) ?? {
 				kind: "path",
 				subpaths: pathSubpaths,
 				fillRule: paintFillRuleFor(operator),
-				...paint
+				...paint,
+				...strokeStyle !== void 0 ? { style: strokeStyle } : {}
 			});
 		}
 		resetPath();
@@ -705,6 +713,12 @@ function runContentStream(bytes, resources, initialState, context, items, depth,
 					lineWidth: numAt(operands, 0)
 				};
 				break;
+			case "d":
+				gs = {
+					...gs,
+					dashArray: (require_objects.asArray(operands[0]) ?? []).map((entry) => require_objects.asNumber(entry) ?? 0)
+				};
+				break;
 			case "f":
 			case "F":
 			case "f*":

package/dist/interpret.d.cts

@@ -1,7 +1,7 @@
 import { PdfDiagnosticSink } from "./diagnostics.cjs";
 import { r as Matrix } from "./matrix-B7_SBKQ5.cjs";
 import { PdfDict, PdfObject } from "./objects.cjs";
-import { Color } from "document-schema.js";
+import { Color, ContentStrokeStyle } from "document-schema.js";
 //#region src/interpret.d.ts
 interface ExtractedTextRun {
   readonly kind: "text";
@@ -48,6 +48,7 @@ interface ExtractedLine {
   readonly y2Pt: number;
   readonly color: Color;
   readonly widthPt: number;
+  readonly style?: ContentStrokeStyle;
   readonly layerName?: string;
   readonly mcid?: number;
 }
@@ -74,6 +75,7 @@ interface ExtractedPath extends ExtractedPaint {
   readonly kind: "path";
   readonly subpaths: readonly ExtractedSubpath[];
   readonly fillRule: "nonzero" | "evenodd";
+  readonly style?: ContentStrokeStyle;
 }
 interface ExtractedImage {
   readonly kind: "image";

package/dist/interpret.d.ts

@@ -1,7 +1,7 @@
 import { PdfDiagnosticSink } from "./diagnostics.js";
 import { r as Matrix } from "./matrix-B7_SBKQ5.js";
 import { PdfDict, PdfObject } from "./objects.js";
-import { Color } from "document-schema.js";
+import { Color, ContentStrokeStyle } from "document-schema.js";
 //#region src/interpret.d.ts
 interface ExtractedTextRun {
   readonly kind: "text";
@@ -48,6 +48,7 @@ interface ExtractedLine {
   readonly y2Pt: number;
   readonly color: Color;
   readonly widthPt: number;
+  readonly style?: ContentStrokeStyle;
   readonly layerName?: string;
   readonly mcid?: number;
 }
@@ -74,6 +75,7 @@ interface ExtractedPath extends ExtractedPaint {
   readonly kind: "path";
   readonly subpaths: readonly ExtractedSubpath[];
   readonly fillRule: "nonzero" | "evenodd";
+  readonly style?: ContentStrokeStyle;
 }
 interface ExtractedImage {
   readonly kind: "image";

package/dist/interpret.js

@@ -249,7 +249,11 @@ function detectEllipse(subpath, paint) {
 		stroke: paint.stroke
 	};
 }
-function detectLine(subpath, paint) {
+function strokeStyleFromDashArray(dashArray) {
+	if (dashArray.length === 0) return;
+	return dashArray.length === 2 && dashArray[0] === 0 ? "dotted" : "dashed";
+}
+function detectLine(subpath, paint, style) {
 	const segment = subpath.segments[0];
 	if (subpath.closed || subpath.segments.length !== 1 || segment?.kind !== "line") return;
 	if (paint.fill !== void 0 || paint.stroke === void 0) return;
@@ -260,13 +264,14 @@ function detectLine(subpath, paint) {
 		x2Pt: segment.xPt,
 		y2Pt: segment.yPt,
 		color: paint.stroke.color,
-		widthPt: paint.stroke.widthPt
+		widthPt: paint.stroke.widthPt,
+		...style !== void 0 ? { style } : {}
 	};
 }
-function classifyShape(subpaths, paint) {
+function classifyShape(subpaths, paint, style) {
 	const subpath = subpaths[0];
 	if (subpaths.length !== 1 || subpath === void 0) return;
-	return detectRect(subpath, paint) ?? detectEllipse(subpath, paint) ?? detectLine(subpath, paint);
+	return detectRect(subpath, paint) ?? detectEllipse(subpath, paint) ?? detectLine(subpath, paint, style);
 }
 function interpretContentStream(bytes, resources, context) {
 	const items = [];
@@ -275,6 +280,7 @@ function interpretContentStream(bytes, resources, context) {
 		fillColor: COLOR_BLACK,
 		strokeColor: COLOR_BLACK,
 		lineWidth: DEFAULT_LINE_WIDTH_PT,
+		dashArray: [],
 		...initialTextParameters()
 	}, context, items, 0, []);
 	return items;
@@ -401,11 +407,13 @@ function runContentStream(bytes, resources, initialState, context, items, depth,
 					widthPt: gs.lineWidth
 				} : void 0
 			};
-			pushItem(classifyShape(pathSubpaths, paint) ?? {
+			const strokeStyle = isStrokeOp ? strokeStyleFromDashArray(gs.dashArray) : void 0;
+			pushItem(classifyShape(pathSubpaths, paint, strokeStyle) ?? {
 				kind: "path",
 				subpaths: pathSubpaths,
 				fillRule: paintFillRuleFor(operator),
-				...paint
+				...paint,
+				...strokeStyle !== void 0 ? { style: strokeStyle } : {}
 			});
 		}
 		resetPath();
@@ -704,6 +712,12 @@ function runContentStream(bytes, resources, initialState, context, items, depth,
 					lineWidth: numAt(operands, 0)
 				};
 				break;
+			case "d":
+				gs = {
+					...gs,
+					dashArray: (asArray(operands[0]) ?? []).map((entry) => asNumber(entry) ?? 0)
+				};
+				break;
 			case "f":
 			case "F":
 			case "f*":

package/dist/read.cjs

@@ -426,6 +426,7 @@ function convertLine(item, pageMatrix) {
 		y2Pt: p2.y,
 		color: item.color,
 		widthPt: item.widthPt,
+		...item.style !== void 0 ? { style: item.style } : {},
 		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
@@ -482,6 +483,7 @@ function convertPath(item, pageMatrix) {
 		...item.fill !== void 0 ? { fill: item.fill } : {},
 		...item.fill !== void 0 && item.fillRule === "evenodd" ? { fillRule: "evenodd" } : {},
 		...item.stroke !== void 0 ? { stroke: item.stroke } : {},
+		...item.style !== void 0 ? { style: item.style } : {},
 		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }

package/dist/read.js

@@ -425,6 +425,7 @@ function convertLine(item, pageMatrix) {
 		y2Pt: p2.y,
 		color: item.color,
 		widthPt: item.widthPt,
+		...item.style !== void 0 ? { style: item.style } : {},
 		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }
@@ -481,6 +482,7 @@ function convertPath(item, pageMatrix) {
 		...item.fill !== void 0 ? { fill: item.fill } : {},
 		...item.fill !== void 0 && item.fillRule === "evenodd" ? { fillRule: "evenodd" } : {},
 		...item.stroke !== void 0 ? { stroke: item.stroke } : {},
+		...item.style !== void 0 ? { style: item.style } : {},
 		...item.layerName !== void 0 ? { layer: item.layerName } : {}
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-codec",
-  "version": "4.0.11",
+  "version": "4.0.12",
   "description": "Hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs and generates new ones, built on its own codec-owned LayoutDocument item model and Zod 4 codecs.",
   "type": "module",
   "repository": {