@segnavia/render 0.4.0 → 0.6.0

package/dist/press/report.js

@@ -1,9 +1,9 @@
 import { RenderRefusedError } from "../errors.js";
 import { groupAction, shadingAction } from "./policy.js";
 import { inspectContent } from "./content.js";
-import { decodeContent, dictionaryOf, nameOf, numberOf, resolvedColorSpace } from "./pdf-objects.js";
+import { decodeContent, dictionaryOf, nameOf, numberOf, rawStreamOf, resolvedColorSpace } from "./pdf-objects.js";
 import { walkPressGraph } from "./visitor.js";
-import { PDFDict, PDFDocument, PDFName, PDFRef } from "pdf-lib";
+import { PDFArray, PDFDict, PDFDocument, PDFName, PDFRef } from "pdf-lib";
 //#region src/press/report.ts
 const key = (name) => PDFName.of(name);
 const refuse = (found, supported) => {
@@ -15,6 +15,7 @@ function inspectImage(state, image) {
 	if (state.images.has(image)) return;
 	state.images.add(image);
 	const space = resolvedColorSpace(state.document, resolved(state, image.dict.get(key("ColorSpace"))));
+	if (state.report.destination === "gray" && (space.kind === "rgb" || space.kind === "cmyk")) refuse(`image color space ${space.label}`, "DeviceGray or Indexed over DeviceGray");
 	if (space.kind !== "rgb") return;
 	const width = requiredDimension(numberOf(image.dict, "Width"), "Width");
 	const height = requiredDimension(numberOf(image.dict, "Height"), "Height");
@@ -24,18 +25,19 @@ function inspectImage(state, image) {
 		colorSpace: space.label
 	});
 }
-function inspectFunction(state, fn, policy) {
+function inspectFunction(state, fn, policy, _mask) {
 	if (policy.action === "refuse") refuse(policy.found, policy.supported);
 	if (fn && numberOf(fn, "FunctionType") === 2) state.report.gradientStops += 2;
 }
-function inspectShading(state, shading) {
+function inspectShading(state, shading, _mask) {
 	if (state.shadings.has(shading)) return false;
 	state.shadings.add(shading);
 	const type = numberOf(shading, "ShadingType");
 	const fn = dictionaryOf(resolved(state, shading.get(key("Function"))));
 	const functionType = fn ? numberOf(fn, "FunctionType") : void 0;
 	const space = resolvedColorSpace(state.document, resolved(state, shading.get(key("ColorSpace"))));
-	const policy = shadingAction(space.kind, type, functionType);
+	const destination = state.report.destination;
+	const policy = shadingAction(space.kind, type, functionType, destination);
 	if (policy.action !== "keep") {
 		if (type === 1) refuse(`ShadingType 1 FunctionType ${functionType ?? "missing"} color space ${space.label}`, policy.supported);
 		refuse(`ShadingType ${type ?? "missing"} color space ${space.label}`, policy.supported);
@@ -46,42 +48,52 @@ function inspectShading(state, shading) {
 	}
 	return true;
 }
-function inspectGroup(state, owner, maskSource) {
+function inspectGroup(state, owner, mask) {
 	const group = owner.lookupMaybe(key("Group"), PDFDict);
 	if (!group || nameOf(group.get(key("S"))) !== "Transparency" || state.groups.has(group)) return;
 	state.groups.add(group);
 	const space = resolvedColorSpace(state.document, resolved(state, group.get(key("CS"))));
-	const policy = groupAction(space.kind, space.label, maskSource);
+	const destination = state.report.destination;
+	const policy = groupAction(space.kind, space.label, mask !== "none", destination);
 	if (policy.action !== "keep") refuse(`transparency group color space ${space.label}`, policy.supported);
-	if (space.kind === "cmyk") state.report.groups++;
+	if (space.kind === destination) state.report.groups++;
 }
-async function inspectPressPdf(bytes) {
+function outputDestination(document) {
+	const intent = document.catalog.lookupMaybe(key("OutputIntents"), PDFArray)?.lookup(0, PDFDict);
+	const profile = rawStreamOf(intent?.get(key("DestOutputProfile")) ? document.context.lookup(intent.get(key("DestOutputProfile"))) : void 0);
+	return profile && numberOf(profile.dict, "N") === 1 ? "gray" : "cmyk";
+}
+async function inspectPressPdf(bytes, requested) {
 	const document = await PDFDocument.load(bytes, { updateMetadata: false });
+	const destination = requested ?? outputDestination(document);
 	const state = {
 		budget: { decodedBytes: 0 },
 		document,
 		groups: /* @__PURE__ */ new WeakSet(),
 		images: /* @__PURE__ */ new WeakSet(),
 		report: {
+			destination,
 			images: [],
+			convertedImages: 0,
 			fills: 0,
 			strokes: 0,
 			gradientStops: 0,
 			sampledShadings: 0,
-			groups: 0
+			groups: 0,
+			neutralColors: 0
 		},
 		shadings: /* @__PURE__ */ new WeakSet()
 	};
 	walkPressGraph(document, {
 		content: (_object, stream) => {
-			const counts = inspectContent(decodeContent(stream, state.budget));
+			const counts = inspectContent(decodeContent(stream, state.budget), destination);
 			state.report.fills += counts.fills;
 			state.report.strokes += counts.strokes;
 		},
-		function: (fn, decision) => inspectFunction(state, fn, decision),
-		group: (owner, _stream, maskSource) => inspectGroup(state, owner, maskSource),
+		function: (fn, decision, mask) => inspectFunction(state, fn, decision, mask),
+		group: (owner, _stream, mask) => inspectGroup(state, owner, mask),
 		image: (image) => inspectImage(state, image),
-		shading: (shading) => inspectShading(state, shading)
+		shading: (shading, _pattern, mask) => inspectShading(state, shading, mask)
 	});
 	return state.report;
 }

package/dist/press/sample-shading.js

@@ -10,7 +10,6 @@ const MAX_SHADING_SAMPLES = 1048576;
 const MAX_DOCUMENT_SHADING_SAMPLES = 4 * MAX_SHADING_SAMPLES;
 const MAX_DOCUMENT_CALCULATOR_OPERATIONS = 8 * MAX_SHADING_SAMPLES * 52;
 const MAX_SAMPLING_COLOR_CACHE = 4096;
-const SAMPLE_CHANNELS = 4;
 const SAMPLE_BYTES = 1;
 function refuse(found, supported) {
 	throw new RenderRefusedError(`The PDF has unsupported ${found}; supported: ${supported}.`);
@@ -186,12 +185,12 @@ function domainValue(min, max, index, size) {
 	if (size <= 1) return min;
 	return min + (max - min) * index / (size - 1);
 }
-function sampleShadingToCmyk(program, domain, size, convert) {
+function sampleShading(program, domain, size, convert, channels) {
 	const x0 = domain[0] ?? 0;
 	const x1 = domain[1] ?? 0;
 	const y0 = domain[2] ?? 0;
 	const y1 = domain[3] ?? 0;
-	const samples = new Uint8Array(size.n * size.m * SAMPLE_CHANNELS * SAMPLE_BYTES);
+	const samples = new Uint8Array(size.n * size.m * channels * SAMPLE_BYTES);
 	const toCmyk = createSamplingColorConverter(convert).convert;
 	let offset = 0;
 	for (let j = 0; j < size.m; j++) {
@@ -213,8 +212,8 @@ function sampleShadingToCmyk(program, domain, size, convert) {
 	}
 	return samples;
 }
-function chargeShadingSamples(budget, samples, operations) {
-	const bytes = samples * SAMPLE_CHANNELS * SAMPLE_BYTES;
+function chargeShadingSamples(budget, samples, operations, channels = 4) {
+	const bytes = samples * channels * SAMPLE_BYTES;
 	if (!Number.isFinite(samples) || samples < 0 || !Number.isFinite(bytes) || bytes < 0) refuse(`document shading samples ${samples}`, "a finite non-negative sample count and byte charge");
 	if (!Number.isFinite(operations) || operations < 0) refuse(`document calculator operations ${operations}`, "a finite non-negative operator count");
 	const totalSamples = (budget.shadingSamples ?? 0) + samples;
@@ -228,7 +227,7 @@ function chargeShadingSamples(budget, samples, operations) {
 	budget.calculatorOperations = totalOperations;
 }
 const resolved = (document, object) => object instanceof PDFRef ? document.context.lookup(object) : object;
-function replaceType1Function(document, shading, pattern, convert, budget, painted, sampleDomain, sampleSize) {
+function replaceType1Function(document, shading, pattern, convert, budget, painted, sampleDomain, sampleSize, channels = 4) {
 	const existing = shading.get(PDFName.of("Function"));
 	const stream = rawStreamOf(resolved(document, existing));
 	if (!stream) return refuse("shading FunctionType 4 stream", "a FunctionType 4 stream");
@@ -239,21 +238,12 @@ function replaceType1Function(document, shading, pattern, convert, budget, paint
 	const size = sampleSize ?? shadingSampleGrid(domain, matrix);
 	const program = parseCalculator(new TextDecoder("latin1").decode(decodeContent(stream, budget)));
 	const samples = size.n * size.m;
-	chargeShadingSamples(budget, samples, samples * staticOperatorCount(program));
-	const data = sampleShadingToCmyk(program, domain, size, convert);
+	chargeShadingSamples(budget, samples, samples * staticOperatorCount(program), channels);
+	const data = sampleShading(program, domain, size, convert, channels);
 	const replacement = document.context.stream(deflateSync(data), {
 		FunctionType: 0,
 		Domain: domain,
-		Range: [
-			0,
-			1,
-			0,
-			1,
-			0,
-			1,
-			0,
-			1
-		],
+		Range: Array.from({ length: channels }, () => [0, 1]).flat(),
 		Size: [size.n, size.m],
 		BitsPerSample: 8,
 		Order: 1,
@@ -263,4 +253,4 @@ function replaceType1Function(document, shading, pattern, convert, budget, paint
 	return size;
 }
 //#endregion
-export { MAX_DOCUMENT_CALCULATOR_OPERATIONS, MAX_DOCUMENT_SHADING_SAMPLES, MAX_SAMPLING_COLOR_CACHE, MAX_SHADING_SAMPLES, SHADING_SAMPLE_SPACING_PT, chargeShadingSamples, createSamplingColorConverter, domainValue, matrixOf, packedRgb8, replaceType1Function, sampleDomainForPainted, sampleDomainForUses, sampleShadingToCmyk, shadingDeviceMatrix, shadingDomainOf, shadingSampleGrid, shadingSampleGridForUses, unionSampleDomain, unpackRgb8 };
+export { MAX_DOCUMENT_CALCULATOR_OPERATIONS, MAX_DOCUMENT_SHADING_SAMPLES, MAX_SAMPLING_COLOR_CACHE, MAX_SHADING_SAMPLES, SHADING_SAMPLE_SPACING_PT, chargeShadingSamples, createSamplingColorConverter, domainValue, matrixOf, packedRgb8, replaceType1Function, sampleDomainForPainted, sampleDomainForUses, sampleShading, shadingDeviceMatrix, shadingDomainOf, shadingSampleGrid, shadingSampleGridForUses, unionSampleDomain, unpackRgb8 };

package/dist/press/types.d.ts

@@ -4,15 +4,22 @@ export interface PressImage {
   height: number;
   colorSpace: 'DeviceRGB' | 'CalRGB' | 'ICCBased' | 'Indexed';
 }
+export type PressDestination = 'cmyk' | 'gray';
 export interface PressReport {
+  /** Device color space written for press-ready vector and generated-image output. */
+  destination: PressDestination;
   /** Authored raster images left in RGB, read back from the finished PDF. */
   images: PressImage[];
-  /** CMYK painting and group counts read back from the finished PDF. */
+  /** Supplied raster image objects converted to DeviceGray. */
+  convertedImages: number;
+  /** Destination-space painting and group counts read back from the finished PDF. */
   fills: number;
   strokes: number;
   gradientStops: number;
-  /** Function-based shadings rewritten as DeviceCMYK sampled functions. */
+  /** Function-based shadings rewritten as sampled functions in the destination space. */
   sampledShadings: number;
   groups: number;
+  /** Color conversions snapped to black ink by the configured tolerance but not by the exact-neutral rule. */
+  neutralColors: number;
 }
 //#endregion

package/dist/press/visitor.js

@@ -13,7 +13,7 @@ function rememberRef(state, object) {
 	state.references.add(label);
 	return false;
 }
-function visitContent(state, object, replace, enclosing, replay = false, nestResources = true) {
+function visitContent(state, object, replace, enclosing, replay = false, nestResources = true, context = "none") {
 	if (!object) return;
 	const seenRef = rememberRef(state, object);
 	const found = stream(state, object);
@@ -23,9 +23,10 @@ function visitContent(state, object, replace, enclosing, replay = false, nestRes
 	const seen = seenRef || seenStream;
 	if (seen && !replay) return;
 	const own = found.dict.lookupMaybe(key("Resources"), PDFDict);
-	if (!seen) state.actions?.group(found.dict, found, state.maskSources.has(found));
-	state.actions?.content(object, found, replace, own ?? enclosing);
-	if (nestResources && !seen) visitResources(state, own);
+	const mask = state.maskSources.get(found) ?? context;
+	if (!seen) state.actions?.group(found.dict, found, mask);
+	state.actions?.content(object, found, replace, own ?? enclosing, mask);
+	if (nestResources && !seen) visitResources(state, own, mask);
 }
 function visitSoftMask(state, object, enclosing) {
 	const graphicsState = dictionary(state, object);
@@ -34,8 +35,9 @@ function visitSoftMask(state, object, enclosing) {
 	const source = stream(state, sourceObject);
 	if (!graphicsState || !mask || !source || !sourceObject) return;
 	state.actions?.softMask?.(graphicsState, mask, source, source.dict.lookupMaybe(key("Resources"), PDFDict) ?? enclosing);
-	state.maskSources.add(source);
-	visitContent(state, sourceObject, (replacement) => mask?.set(key("G"), replacement), enclosing);
+	const context = nameOf(mask.get(key("S"))) === "Alpha" ? "alpha" : "luminosity";
+	state.maskSources.set(source, context);
+	visitContent(state, sourceObject, (replacement) => mask?.set(key("G"), replacement), enclosing, false, true, context);
 }
 function visitAppearances(state, page, enclosing) {
 	const annotations = resolved(state, page.get(key("Annots")));
@@ -57,69 +59,69 @@ function visitAppearances(state, page, enclosing) {
 		}
 	}
 }
-function visitFunction(state, object) {
+function visitFunction(state, object, context) {
 	const fn = dictionary(state, object);
 	if (fn && state.functions.has(fn)) return;
 	if (fn) state.functions.add(fn);
 	const type = fn ? numberOf(fn, "FunctionType") : void 0;
 	const functions = type === 3 ? fn?.lookupMaybe(key("Functions"), PDFArray) : void 0;
 	const decision = shadingFunctionAction(type, Boolean(fn), type !== 3 || Boolean(functions));
-	state.actions?.function(fn, decision);
-	for (let index = 0; index < (functions?.size() ?? 0); index++) visitFunction(state, functions?.get(index));
+	state.actions?.function(fn, decision, context);
+	for (let index = 0; index < (functions?.size() ?? 0); index++) visitFunction(state, functions?.get(index), context);
 }
-function visitShading(state, shading, pattern) {
-	if (state.actions?.shading(shading, pattern)) visitFunction(state, shading.get(key("Function")));
+function visitShading(state, shading, pattern, context) {
+	if (state.actions?.shading(shading, pattern, context)) visitFunction(state, shading.get(key("Function")), context);
 }
-function visitShadings(state, resources) {
+function visitShadings(state, resources, context) {
 	const shadings = resources.lookupMaybe(key("Shading"), PDFDict);
 	for (const [, object] of shadings?.entries() ?? []) {
 		const found = dictionary(state, object);
-		if (found) visitShading(state, found);
+		if (found) visitShading(state, found, void 0, context);
 	}
 }
-function visitPatterns(state, resources) {
+function visitPatterns(state, resources, context) {
 	const patterns = resources.lookupMaybe(key("Pattern"), PDFDict);
 	for (const [name, object] of patterns?.entries() ?? []) {
 		const found = dictionary(state, object);
 		if (!found) continue;
 		if (numberOf(found, "PatternType") === 2) {
 			const shading = dictionary(state, found.get(key("Shading")));
-			if (shading) visitShading(state, shading, found);
-		} else visitContent(state, object, (replacement) => patterns?.set(name, replacement), found.lookupMaybe(key("Resources"), PDFDict) ?? resources);
-		visitResources(state, found.lookupMaybe(key("Resources"), PDFDict));
+			if (shading) visitShading(state, shading, found, context);
+		} else visitContent(state, object, (replacement) => patterns?.set(name, replacement), found.lookupMaybe(key("Resources"), PDFDict) ?? resources, false, true, context);
+		visitResources(state, found.lookupMaybe(key("Resources"), PDFDict), context);
 	}
 }
 function visitGraphicsStates(state, resources) {
 	const graphicsStates = resources.lookupMaybe(key("ExtGState"), PDFDict);
 	for (const [, object] of graphicsStates?.entries() ?? []) visitSoftMask(state, object, resources);
 }
-function visitXObjects(state, resources) {
+function visitXObjects(state, resources, context) {
 	const xObjects = resources.lookupMaybe(key("XObject"), PDFDict);
 	for (const [name, object] of xObjects?.entries() ?? []) {
 		const found = stream(state, object);
 		if (!found) continue;
-		if (nameOf(found.dict.get(key("Subtype"))) === "Image") state.actions?.image(found);
-		else visitContent(state, object, (replacement) => xObjects?.set(name, replacement), found.dict.lookupMaybe(key("Resources"), PDFDict) ?? resources);
+		if (nameOf(found.dict.get(key("Subtype"))) === "Image") state.actions?.image(found, context, (replacement) => xObjects?.set(name, replacement));
+		else visitContent(state, object, (replacement) => xObjects?.set(name, replacement), found.dict.lookupMaybe(key("Resources"), PDFDict) ?? resources, false, true, context);
 	}
 }
-function visitFonts(state, resources) {
+function visitFonts(state, resources, context) {
 	const fonts = resources.lookupMaybe(key("Font"), PDFDict);
 	for (const [, object] of fonts?.entries() ?? []) {
 		const font = dictionary(state, object);
 		if (!font || nameOf(font.get(key("Subtype"))) !== "Type3") continue;
 		const charProcs = font.lookupMaybe(key("CharProcs"), PDFDict);
-		for (const [name, glyph] of charProcs?.entries() ?? []) visitContent(state, glyph, (replacement) => charProcs?.set(name, replacement), font.lookupMaybe(key("Resources"), PDFDict) ?? resources);
-		visitResources(state, font.lookupMaybe(key("Resources"), PDFDict));
+		for (const [name, glyph] of charProcs?.entries() ?? []) visitContent(state, glyph, (replacement) => charProcs?.set(name, replacement), font.lookupMaybe(key("Resources"), PDFDict) ?? resources, false, true, context);
+		visitResources(state, font.lookupMaybe(key("Resources"), PDFDict), context);
 	}
 }
-function visitResources(state, resources) {
+function visitResources(state, resources, context = "none") {
 	if (!resources || state.resources.has(resources)) return;
 	state.resources.add(resources);
 	visitGraphicsStates(state, resources);
-	visitXObjects(state, resources);
-	visitFonts(state, resources);
-	visitShadings(state, resources);
-	visitPatterns(state, resources);
+	visitXObjects(state, resources, context);
+	visitFonts(state, resources, context);
+	visitShadings(state, resources, context);
+	visitPatterns(state, resources, context);
 }
 function visitPageContents(state, page, contents, pageResources) {
 	const replay = Boolean(state.actions?.replayPageContents);
@@ -147,7 +149,7 @@ function traverse(document, maskSources, actions) {
 		streams: /* @__PURE__ */ new WeakSet()
 	};
 	for (const page of document.getPages()) {
-		actions?.group(page.node, void 0, false);
+		actions?.group(page.node, void 0, "none");
 		const pageResources = page.node.Resources();
 		visitPageContents(state, page.node, page.node.Contents(), pageResources);
 		visitResources(state, pageResources);
@@ -155,7 +157,7 @@ function traverse(document, maskSources, actions) {
 	}
 }
 function walkPressGraph(document, actions) {
-	const maskSources = /* @__PURE__ */ new WeakSet();
+	const maskSources = /* @__PURE__ */ new WeakMap();
 	traverse(document, maskSources);
 	traverse(document, maskSources, actions);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segnavia/render",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -26,8 +26,9 @@
     }
   },
   "dependencies": {
-    "@segnavia/format": "0.4.0",
-    "@segnavia/frame": "0.4.0",
+    "@segnavia/format": "0.6.0",
+    "@segnavia/frame": "0.6.0",
+    "@segnavia/html": "0.6.0",
     "playwright-core": "1.55.1",
     "pdf-lib": "^1.17.1"
   }