@aexol/spectral 0.9.89 → 0.9.91

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,CAuG/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,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"}

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

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { createDocumentPaths, ensureDir, 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";
@@ -23,6 +23,7 @@ export function registerGenerateTool(ext, config) {
             "For polished PDFs, use designer_list_systems and designer_get_system before writing the HTML.",
             "Keep the saved HTML source as the editable artifact; refine it and call pdf_render again for updates.",
             "Use print CSS with @page, fixed margins, break-inside avoidance, and print-color-adjust: exact.",
+            "Write print-native HTML designed for the page format (e.g. A4 landscape = 297x210mm). Do NOT write interactive slide-deck HTML with position:absolute + JS scale() transforms — those break in headless PDF rendering.",
         ],
         parameters: {
             type: "object",
@@ -34,6 +35,9 @@ export function registerGenerateTool(ext, config) {
                 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." },
                 margin: {
                     type: "object",
                     properties: {
@@ -77,6 +81,9 @@ export function registerGenerateTool(ext, config) {
                     margin,
                     printBackground: p.printBackground ?? true,
                     allowRemoteAssets,
+                    viewport: p.viewport,
+                    width: p.width,
+                    height: p.height,
                     waitUntil: allowRemoteAssets ? "networkidle" : "load",
                 });
                 writeManifest(paths.manifestPath, { ...manifest, updatedAt: new Date().toISOString() });
@@ -95,6 +102,7 @@ export function registerGenerateTool(ext, config) {
                     id: paths.id,
                     htmlPath: toDisplayPath(ctx.cwd, paths.htmlPath),
                     pdfPath: toDisplayPath(ctx.cwd, paths.pdfPath),
+                    pdfUrl: pathToFileHref(paths.pdfPath),
                     manifestPath: toDisplayPath(ctx.cwd, paths.manifestPath),
                     bytes: rendered.bytes,
                     warning,

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,CAsG7E"}
+{"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"}

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, 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";
@@ -31,6 +31,9 @@ export function registerRenderTool(ext, config) {
                 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." },
                 margin: {
                     type: "object",
                     properties: {
@@ -67,6 +70,9 @@ export function registerRenderTool(ext, config) {
                     margin,
                     printBackground: p.printBackground ?? true,
                     allowRemoteAssets,
+                    viewport: p.viewport,
+                    width: p.width,
+                    height: p.height,
                     waitUntil: allowRemoteAssets ? "networkidle" : "load",
                 });
                 const now = new Date().toISOString();
@@ -97,6 +103,7 @@ export function registerRenderTool(ext, config) {
                     isError: false,
                     htmlPath: toDisplayPath(ctx.cwd, htmlPath),
                     pdfPath: toDisplayPath(ctx.cwd, outputPath),
+                    pdfUrl: pathToFileHref(outputPath),
                     manifestPath: toDisplayPath(ctx.cwd, manifestPath),
                     bytes: rendered.bytes,
                     warning,

package/dist/extensions/pdf/types.d.ts

@@ -25,6 +25,8 @@ export interface PdfManifest {
     page: {
         format: PdfFormat;
         orientation: PdfOrientation;
+        width?: number;
+        height?: number;
         margin: Required<PdfMargin>;
     };
     source: "generated" | "rendered";

package/dist/extensions/pdf/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/pdf/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;AACxC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,SAAS,CAAC;IACzB,kBAAkB,EAAE,cAAc,CAAC;IACnC,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,MAAM,EAAE,SAAS,CAAC;QAClB,WAAW,EAAE,cAAc,CAAC;QAC5B,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KAC7B,CAAC;IACF,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;CAClC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/extensions/pdf/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;AACxC,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,SAAS,CAAC;IACzB,kBAAkB,EAAE,cAAc,CAAC;IACnC,aAAa,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,MAAM,EAAE,SAAS,CAAC;QAClB,WAAW,EAAE,cAAc,CAAC;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;KAC7B,CAAC;IACF,MAAM,EAAE,WAAW,GAAG,UAAU,CAAC;CAClC"}

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

@@ -4,6 +4,12 @@ export interface RenderPdfOptions {
     pdfPath: string;
     format: PdfFormat;
     orientation: PdfOrientation;
+    width?: number;
+    height?: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
     margin: Required<PdfMargin>;
     printBackground: boolean;
     allowRemoteAssets: boolean;

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,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,CA8BnG;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,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"}

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

@@ -5,6 +5,9 @@ export async function renderPdf(config, opts) {
     const browser = await chromium.launch({ headless: true });
     try {
         const page = await browser.newPage();
+        if (opts.viewport) {
+            await page.setViewportSize(opts.viewport);
+        }
         page.setDefaultTimeout(config.renderTimeoutMs);
         if (!opts.allowRemoteAssets) {
             await page.route("**/*", (route) => {
@@ -24,6 +27,8 @@ 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 } : {}),
             margin: opts.margin,
         });
         if (!existsSync(opts.pdfPath))

package/package.json

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