@aexol/spectral 0.9.103 → 0.9.104

package/dist/extensions/pdf/tools/generate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/tools/generate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,oCAAoC,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAa,WAAW,EAA6B,MAAM,aAAa,CAAC;AAiBhG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAkH/E;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAO7E"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/tools/generate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,SAAS,EAET,WAAW,EAGZ,MAAM,aAAa,CAAC;AAyBrB,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CA2KN;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAO7E"}

package/dist/extensions/pdf/tools/generate.js

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { createDocumentPaths, ensureDir, pathToFileHref, toDisplayPath } from "../utils/paths.js";
+import { createDocumentPaths, ensureDir, pathToFileHref, toDisplayPath, } from "../utils/paths.js";
 import { printCssWarning, validateHtmlDocument } from "../utils/html.js";
 import { renderPdf } from "../utils/renderer.js";
 import { errorResult, textResult } from "./helpers.js";
@@ -29,15 +29,45 @@ export function registerGenerateTool(ext, config) {
             type: "object",
             properties: {
                 title: { type: "string", description: "Document title." },
-                html: { type: "string", description: "Complete HTML document. Must include doctype, html, head, and body." },
-                outputName: { type: "string", description: "Optional stable filename/folder slug." },
-                format: { type: "string", enum: [...formatEnum], description: "Page format. Default from config: A4." },
-                orientation: { type: "string", enum: [...orientationEnum], description: "Page orientation. Default: portrait." },
-                printBackground: { type: "boolean", description: "Render CSS backgrounds. Default: true." },
-                allowRemoteAssets: { type: "boolean", description: "Allow http/https assets during validation/render. Default: false." },
-                viewport: { type: "object", properties: { width: { type: "number" }, height: { type: "number" } }, description: "Override the browser viewport before rendering (useful for slide decks). Default: auto." },
-                width: { type: "number", description: "Override PDF page width in pixels. Default: auto from format." },
-                height: { type: "number", description: "Override PDF page height in pixels. Default: auto from format." },
+                html: {
+                    type: "string",
+                    description: "Complete HTML document. Must include doctype, html, head, and body.",
+                },
+                outputName: {
+                    type: "string",
+                    description: "Optional stable filename/folder slug.",
+                },
+                format: {
+                    type: "string",
+                    enum: [...formatEnum],
+                    description: "Page format. Default from config: A4.",
+                },
+                orientation: {
+                    type: "string",
+                    enum: [...orientationEnum],
+                    description: "Page orientation. Default: portrait.",
+                },
+                printBackground: {
+                    type: "boolean",
+                    description: "Render CSS backgrounds. Default: true.",
+                },
+                allowRemoteAssets: {
+                    type: "boolean",
+                    description: "Allow http/https assets during validation/render. Default: false.",
+                },
+                viewport: {
+                    type: "object",
+                    properties: { width: { type: "number" }, height: { type: "number" } },
+                    description: "Override the browser viewport before rendering (useful for slide decks). Default: auto.",
+                },
+                width: {
+                    type: "number",
+                    description: "Custom PDF page width in millimetres. Omit for format-based sizing.",
+                },
+                height: {
+                    type: "number",
+                    description: "Custom PDF page height in millimetres. Omit for format-based sizing.",
+                },
                 margin: {
                     type: "object",
                     properties: {
@@ -69,7 +99,13 @@ export function registerGenerateTool(ext, config) {
                     pdfPath: toDisplayPath(ctx.cwd, paths.pdfPath),
                     createdAt: now,
                     updatedAt: now,
-                    page: { format, orientation, margin },
+                    page: {
+                        format,
+                        orientation,
+                        width: p.width,
+                        height: p.height,
+                        margin,
+                    },
                     source: "generated",
                 };
                 writeManifest(paths.manifestPath, manifest);
@@ -86,7 +122,10 @@ export function registerGenerateTool(ext, config) {
                     height: p.height,
                     waitUntil: allowRemoteAssets ? "networkidle" : "load",
                 });
-                writeManifest(paths.manifestPath, { ...manifest, updatedAt: new Date().toISOString() });
+                writeManifest(paths.manifestPath, {
+                    ...manifest,
+                    updatedAt: new Date().toISOString(),
+                });
                 const warning = printCssWarning(p.html);
                 const lines = [
                     "✓ PDF generated from editable HTML",

package/dist/extensions/pdf/tools/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/tools/preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,oCAAoC,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA+C9E"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/tools/preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW7C,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,SAAS,GAChB,IAAI,CAuFN"}

package/dist/extensions/pdf/tools/preview.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { assertInsideWorkspace, ensureParent, resolveWorkspacePath, toDisplayPath } from "../utils/paths.js";
+import { assertInsideWorkspace, ensureParent, resolveWorkspacePath, toDisplayPath, } from "../utils/paths.js";
 import { validateHtmlDocument } from "../utils/html.js";
 import { renderPreview } from "../utils/renderer.js";
 import { errorResult, textResult } from "./helpers.js";
@@ -13,9 +13,23 @@ export function registerPreviewTool(ext, config) {
         parameters: {
             type: "object",
             properties: {
-                htmlPath: { type: "string", description: "Path to an HTML file inside the workspace." },
-                outputPath: { type: "string", description: "Optional PNG output path inside the workspace." },
-                allowRemoteAssets: { type: "boolean", description: "Allow http/https assets during preview. Default: false." },
+                htmlPath: {
+                    type: "string",
+                    description: "Path to an HTML file inside the workspace.",
+                },
+                outputPath: {
+                    type: "string",
+                    description: "Optional PNG output path inside the workspace.",
+                },
+                orientation: {
+                    type: "string",
+                    enum: ["portrait", "landscape"],
+                    description: "Preview orientation. Default from PDF config.",
+                },
+                allowRemoteAssets: {
+                    type: "boolean",
+                    description: "Allow http/https assets during preview. Default: false.",
+                },
             },
             required: ["htmlPath"],
         },
@@ -26,12 +40,16 @@ export function registerPreviewTool(ext, config) {
                 assertInsideWorkspace(ctx.cwd, htmlPath);
                 if (!existsSync(htmlPath))
                     throw new Error(`HTML file not found: ${p.htmlPath}`);
-                const previewPath = p.outputPath ? resolveWorkspacePath(ctx.cwd, p.outputPath) : join(dirname(htmlPath), "preview.png");
+                const previewPath = p.outputPath
+                    ? resolveWorkspacePath(ctx.cwd, p.outputPath)
+                    : join(dirname(htmlPath), "preview.png");
                 assertInsideWorkspace(ctx.cwd, previewPath);
                 ensureParent(previewPath);
                 const allowRemoteAssets = p.allowRemoteAssets ?? config.allowRemoteAssets;
-                validateHtmlDocument(readFileSync(htmlPath, "utf-8"), { allowRemoteAssets });
-                const preview = await renderPreview(config, htmlPath, previewPath, allowRemoteAssets);
+                validateHtmlDocument(readFileSync(htmlPath, "utf-8"), {
+                    allowRemoteAssets,
+                });
+                const preview = await renderPreview(config, htmlPath, previewPath, allowRemoteAssets, p.orientation);
                 return textResult([
                     "✓ HTML preview rendered",
                     `HTML: ${toDisplayPath(ctx.cwd, htmlPath)}`,

package/dist/extensions/pdf/tools/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/tools/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAoC,MAAM,oCAAoC,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAqD,MAAM,aAAa,CAAC;AAgBhG,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAgH7E"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/tools/render.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,SAAS,EAKV,MAAM,aAAa,CAAC;AAyBrB,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAqK7E"}

package/dist/extensions/pdf/tools/render.js

@@ -1,6 +1,6 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, join } from "node:path";
-import { assertInsideWorkspace, ensureParent, pathToFileHref, resolveWorkspacePath, toDisplayPath } from "../utils/paths.js";
+import { assertInsideWorkspace, ensureParent, pathToFileHref, resolveWorkspacePath, toDisplayPath, } from "../utils/paths.js";
 import { printCssWarning, validateHtmlDocument } from "../utils/html.js";
 import { renderPdf } from "../utils/renderer.js";
 import { errorResult, textResult } from "./helpers.js";
@@ -25,15 +25,45 @@ export function registerRenderTool(ext, config) {
         parameters: {
             type: "object",
             properties: {
-                htmlPath: { type: "string", description: "Path to the existing HTML file, relative to workspace or absolute inside workspace." },
-                outputPath: { type: "string", description: "Optional PDF output path, relative to workspace or absolute inside workspace." },
-                format: { type: "string", enum: ["A4", "Letter"], description: "Page format. Default: A4." },
-                orientation: { type: "string", enum: ["portrait", "landscape"], description: "Page orientation. Default: portrait." },
-                printBackground: { type: "boolean", description: "Render CSS backgrounds. Default: true." },
-                allowRemoteAssets: { type: "boolean", description: "Allow http/https assets during validation/render. Default: false." },
-                viewport: { type: "object", properties: { width: { type: "number" }, height: { type: "number" } }, description: "Override the browser viewport before rendering. Default: auto." },
-                width: { type: "number", description: "Override PDF page width in pixels. Default: auto from format." },
-                height: { type: "number", description: "Override PDF page height in pixels. Default: auto from format." },
+                htmlPath: {
+                    type: "string",
+                    description: "Path to the existing HTML file, relative to workspace or absolute inside workspace.",
+                },
+                outputPath: {
+                    type: "string",
+                    description: "Optional PDF output path, relative to workspace or absolute inside workspace.",
+                },
+                format: {
+                    type: "string",
+                    enum: ["A4", "Letter"],
+                    description: "Page format. Default: A4.",
+                },
+                orientation: {
+                    type: "string",
+                    enum: ["portrait", "landscape"],
+                    description: "Page orientation. Default: portrait.",
+                },
+                printBackground: {
+                    type: "boolean",
+                    description: "Render CSS backgrounds. Default: true.",
+                },
+                allowRemoteAssets: {
+                    type: "boolean",
+                    description: "Allow http/https assets during validation/render. Default: false.",
+                },
+                viewport: {
+                    type: "object",
+                    properties: { width: { type: "number" }, height: { type: "number" } },
+                    description: "Override the browser viewport before rendering. Default: auto.",
+                },
+                width: {
+                    type: "number",
+                    description: "Custom PDF page width in millimetres. Omit for format-based sizing.",
+                },
+                height: {
+                    type: "number",
+                    description: "Custom PDF page height in millimetres. Omit for format-based sizing.",
+                },
                 margin: {
                     type: "object",
                     properties: {
@@ -53,7 +83,9 @@ export function registerRenderTool(ext, config) {
                 assertInsideWorkspace(ctx.cwd, htmlPath);
                 if (!existsSync(htmlPath))
                     throw new Error(`HTML file not found: ${p.htmlPath}`);
-                const outputPath = p.outputPath ? resolveWorkspacePath(ctx.cwd, p.outputPath) : defaultPdfPath(htmlPath);
+                const outputPath = p.outputPath
+                    ? resolveWorkspacePath(ctx.cwd, p.outputPath)
+                    : defaultPdfPath(htmlPath);
                 assertInsideWorkspace(ctx.cwd, outputPath);
                 ensureParent(outputPath);
                 const html = readFileSync(htmlPath, "utf-8");
@@ -84,7 +116,13 @@ export function registerRenderTool(ext, config) {
                     pdfPath: toDisplayPath(ctx.cwd, outputPath),
                     createdAt: now,
                     updatedAt: now,
-                    page: { format, orientation, margin },
+                    page: {
+                        format,
+                        orientation,
+                        width: p.width,
+                        height: p.height,
+                        margin,
+                    },
                     source: "rendered",
                 };
                 const manifestPath = join(dirname(htmlPath), "manifest.json");

package/dist/extensions/pdf/utils/renderer.d.ts

@@ -20,7 +20,7 @@ export interface RenderPdfResult {
     bytes: number;
 }
 export declare function renderPdf(config: PdfConfig, opts: RenderPdfOptions): Promise<RenderPdfResult>;
-export declare function renderPreview(config: PdfConfig, htmlPath: string, previewPath: string, allowRemoteAssets: boolean): Promise<{
+export declare function renderPreview(config: PdfConfig, htmlPath: string, previewPath: string, allowRemoteAssets: boolean, orientation?: PdfOrientation): Promise<{
     previewPath: string;
     bytes: number;
 }>;

package/dist/extensions/pdf/utils/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/utils/renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmCnG;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAkBzK"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/utils/renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,SAAS,EACT,SAAS,EACT,cAAc,EACf,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,cAAc,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,CAAC,CAuD1B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,OAAO,EAC1B,WAAW,GAAE,cAA0C,GACtD,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCjD"}

package/dist/extensions/pdf/utils/renderer.js

@@ -2,6 +2,17 @@ import { existsSync, statSync } from "node:fs";
 import { chromium } from "playwright";
 import { pathToFileHref } from "./paths.js";
 export async function renderPdf(config, opts) {
+    for (const [name, value] of [
+        ["width", opts.width],
+        ["height", opts.height],
+    ]) {
+        if (value !== undefined && (!Number.isFinite(value) || value <= 0)) {
+            throw new Error(`Custom PDF ${name} must be a positive number of millimetres.`);
+        }
+    }
+    if ((opts.width === undefined) !== (opts.height === undefined)) {
+        throw new Error("Custom PDF width and height must be provided together.");
+    }
     const browser = await chromium.launch({ headless: true });
     try {
         const page = await browser.newPage();
@@ -12,7 +23,9 @@ export async function renderPdf(config, opts) {
         if (!opts.allowRemoteAssets) {
             await page.route("**/*", (route) => {
                 const url = route.request().url();
-                if (url.startsWith("file://") || url.startsWith("data:") || url === "about:blank") {
+                if (url.startsWith("file://") ||
+                    url.startsWith("data:") ||
+                    url === "about:blank") {
                     return route.continue();
                 }
                 return route.abort();
@@ -27,8 +40,10 @@ export async function renderPdf(config, opts) {
             format: opts.format,
             landscape: opts.orientation === "landscape",
             printBackground: opts.printBackground,
-            ...(opts.width ? { width: opts.width } : {}),
-            ...(opts.height ? { height: opts.height } : {}),
+            // Chromium expects PDF dimensions as strings with units. Numeric values
+            // are CSS pixels and can accidentally make a paper-sized page tiny.
+            ...(opts.width !== undefined ? { width: `${opts.width}mm` } : {}),
+            ...(opts.height !== undefined ? { height: `${opts.height}mm` } : {}),
             margin: opts.margin,
         });
         if (!existsSync(opts.pdfPath))
@@ -39,20 +54,30 @@ export async function renderPdf(config, opts) {
         await browser.close();
     }
 }
-export async function renderPreview(config, htmlPath, previewPath, allowRemoteAssets) {
+export async function renderPreview(config, htmlPath, previewPath, allowRemoteAssets, orientation = config.defaultOrientation) {
     const browser = await chromium.launch({ headless: true });
     try {
-        const page = await browser.newPage({ viewport: { width: 1240, height: 1754 }, deviceScaleFactor: 1 });
+        // Keep the preview in the same aspect ratio as the configured paper. This is
+        // intentionally a CSS viewport, not a page.pdf width/height override.
+        const viewport = orientation === "landscape"
+            ? { width: 1754, height: 1240 }
+            : { width: 1240, height: 1754 };
+        const page = await browser.newPage({ viewport, deviceScaleFactor: 1 });
         page.setDefaultTimeout(config.renderTimeoutMs);
         if (!allowRemoteAssets) {
             await page.route("**/*", (route) => {
                 const url = route.request().url();
-                if (url.startsWith("file://") || url.startsWith("data:") || url === "about:blank")
+                if (url.startsWith("file://") ||
+                    url.startsWith("data:") ||
+                    url === "about:blank")
                     return route.continue();
                 return route.abort();
             });
         }
-        await page.goto(pathToFileHref(htmlPath), { waitUntil: "load", timeout: config.renderTimeoutMs });
+        await page.goto(pathToFileHref(htmlPath), {
+            waitUntil: "load",
+            timeout: config.renderTimeoutMs,
+        });
         await page.screenshot({ path: previewPath, fullPage: true, type: "png" });
         return { previewPath, bytes: statSync(previewPath).size };
     }

package/dist/extensions/pdf/utils/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/utils/validate.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,EAAE,CA8HzG;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAE9E"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/pdf/utils/validate.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2CD,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GACrC,kBAAkB,EAAE,CAkMtB;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,OAAO,CAET"}

package/dist/extensions/pdf/utils/validate.js

@@ -15,6 +15,23 @@ const WIDE_WIDTH_RE = /(?:width|min-width)\s*:\s*(?:[1-9]\d{3,}px|(?:8[5-9]|9\d|
 const IMAGE_RE = /<img\b[^>]*>/gi;
 const WIDTH_ATTR_RE = /\bwidth\s*=\s*["'][^"']+["']/i;
 const HEIGHT_ATTR_RE = /\bheight\s*=\s*["'][^"']+["']/i;
+const TRANSFORM_SCALE_RE = /transform\s*:[^;{}]*scale\s*\(/i;
+const ZOOM_RE = /zoom\s*:\s*(?!1(?:\.0+)?\b)(?:0?\.)?\d+/i;
+const FIXED_VIEWPORT_RE = /(?:width|height)\s*:\s*100vw|(?:width|height)\s*:\s*100vh|(?:width|min-width|height|min-height)\s*:\s*\d{4,}px/i;
+const PAGE_SIZE_RE = /@page\s*{[^}]*size\s*:\s*([^;}]*)/is;
+function normalizePageSize(size) {
+    const value = size.trim().toLowerCase();
+    const orientation = value.includes("landscape")
+        ? "landscape"
+        : value.includes("portrait")
+            ? "portrait"
+            : undefined;
+    if (value.includes("a4"))
+        return { format: "A4", orientation };
+    if (value.includes("letter"))
+        return { format: "Letter", orientation };
+    return { orientation };
+}
 export function analyzePdfHtml(html, opts) {
     const issues = [];
     if (html.length > 5_000_000) {
@@ -34,13 +51,25 @@ export function analyzePdfHtml(html, opts) {
         });
     }
     if (!HTML_RE.test(html)) {
-        issues.push({ severity: "error", code: "missing_html", message: "HTML must include <html>." });
+        issues.push({
+            severity: "error",
+            code: "missing_html",
+            message: "HTML must include <html>.",
+        });
     }
     if (!HEAD_RE.test(html)) {
-        issues.push({ severity: "error", code: "missing_head", message: "HTML must include <head>." });
+        issues.push({
+            severity: "error",
+            code: "missing_head",
+            message: "HTML must include <head>.",
+        });
     }
     if (!BODY_RE.test(html)) {
-        issues.push({ severity: "error", code: "missing_body", message: "HTML must include <body>." });
+        issues.push({
+            severity: "error",
+            code: "missing_body",
+            message: "HTML must include <body>.",
+        });
     }
     if (!TITLE_RE.test(html)) {
         issues.push({
@@ -55,7 +84,7 @@ export function analyzePdfHtml(html, opts) {
             severity: "info",
             code: "missing_viewport",
             message: "HTML has no viewport meta tag.",
-            suggestion: "Add <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">.",
+            suggestion: 'Add <meta name="viewport" content="width=device-width, initial-scale=1">.',
         });
     }
     if (!PAGE_RE.test(html)) {
@@ -123,6 +152,42 @@ export function analyzePdfHtml(html, opts) {
             suggestion: "Check pagination carefully; absolute elements can overlap page breaks.",
         });
     }
+    if (TRANSFORM_SCALE_RE.test(html)) {
+        issues.push({
+            severity: "warning",
+            code: "transform_scale",
+            message: "CSS uses transform: scale(), which can shrink or clip PDF content.",
+            suggestion: "Use print-native dimensions and layout instead of scaling the whole document.",
+        });
+    }
+    if (ZOOM_RE.test(html)) {
+        issues.push({
+            severity: "warning",
+            code: "css_zoom",
+            message: "CSS uses zoom other than 1, which can change PDF pagination and scale.",
+            suggestion: "Remove zoom for print output or scope it to an intentional print layout.",
+        });
+    }
+    if (FIXED_VIEWPORT_RE.test(html)) {
+        issues.push({
+            severity: "warning",
+            code: "fixed_or_viewport_layout",
+            message: "A viewport-sized or fixed oversized layout may not fit the selected paper.",
+            suggestion: "Use responsive width: 100% with print margins and avoid fixed pixel canvases.",
+        });
+    }
+    const pageSizeMatch = html.match(PAGE_SIZE_RE);
+    if (pageSizeMatch) {
+        const pageSize = normalizePageSize(pageSizeMatch[1]);
+        if (pageSize.orientation && pageSize.format) {
+            issues.push({
+                severity: "info",
+                code: "page_size_orientation",
+                message: `@page explicitly requests ${pageSize.format} ${pageSize.orientation}.`,
+                suggestion: "Keep @page size aligned with the PDF format and orientation options.",
+            });
+        }
+    }
     if (WIDE_WIDTH_RE.test(html)) {
         issues.push({
             severity: "warning",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.103",
+  "version": "0.9.104",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,