@noego/forge 0.0.26 → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/forge.js +98 -0
- package/dist/plugins-cjs/routing/html_render/html_render.js +2 -2
- package/dist/plugins-cjs/routing/html_render/html_render.js.map +1 -1
- package/dist/plugins-es/routing/html_render/html_render.js +3 -3
- package/dist/plugins-es/routing/html_render/html_render.js.map +1 -1
- package/dist/routing/html_render/html_render.js +3 -3
- package/dist/routing/html_render/html_render.js.map +1 -1
- package/dist-ssr/server.cjs +24 -381
- package/dist-ssr/server.cjs.map +1 -1
- package/dist-ssr/server.js +42 -399
- package/dist-ssr/server.js.map +1 -1
- package/dist-ssr/static.cjs +107 -0
- package/dist-ssr/static.cjs.map +1 -0
- package/dist-ssr/static.d.ts +151 -0
- package/dist-ssr/static.js +107 -0
- package/dist-ssr/static.js.map +1 -0
- package/dist-ssr/test.cjs +223 -0
- package/dist-ssr/test.cjs.map +1 -0
- package/dist-ssr/test.d.ts +239 -0
- package/dist-ssr/test.js +184 -0
- package/dist-ssr/test.js.map +1 -0
- package/dist-ssr/url_parser-CsBTlLeJ.cjs +418 -0
- package/dist-ssr/url_parser-CsBTlLeJ.cjs.map +1 -0
- package/dist-ssr/url_parser-DRWHePkU.js +398 -0
- package/dist-ssr/url_parser-DRWHePkU.js.map +1 -0
- package/package.json +39 -2
|
@@ -0,0 +1,239 @@
|
|
|
1
|
+
import { SvelteComponent } from 'svelte';
|
|
2
|
+
import { SvelteImport as SvelteImport_2 } from '../base';
|
|
3
|
+
import { SvelteModuleComponent as SvelteModuleComponent_2 } from '../base';
|
|
4
|
+
|
|
5
|
+
declare interface Body_2 {
|
|
6
|
+
description: string;
|
|
7
|
+
required?: boolean;
|
|
8
|
+
content: any;
|
|
9
|
+
}
|
|
10
|
+
|
|
11
|
+
export declare class BrowserLaunchError extends Error {
|
|
12
|
+
cause?: Error | undefined;
|
|
13
|
+
name: "BrowserLaunchError";
|
|
14
|
+
constructor(message: string, cause?: Error | undefined);
|
|
15
|
+
}
|
|
16
|
+
|
|
17
|
+
export declare interface CaptureHtmlOptions {
|
|
18
|
+
/** Override width */
|
|
19
|
+
width?: number;
|
|
20
|
+
/** Override height */
|
|
21
|
+
height?: number;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
export declare interface CaptureOptions {
|
|
25
|
+
/** View component data */
|
|
26
|
+
view?: any;
|
|
27
|
+
/** Layout data (one object per layout) */
|
|
28
|
+
layout?: any[];
|
|
29
|
+
/** Override width */
|
|
30
|
+
width?: number;
|
|
31
|
+
/** Override height */
|
|
32
|
+
height?: number;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
declare interface CaptureResult {
|
|
36
|
+
/** Raw image buffer */
|
|
37
|
+
buffer: Buffer;
|
|
38
|
+
/** Path where image was saved */
|
|
39
|
+
path: string;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
declare class ComponentManager {
|
|
43
|
+
private componentLoader;
|
|
44
|
+
constructor(componentLoader: IComponentLoader);
|
|
45
|
+
getLayoutComponents(route: IRoute): Promise<(SvelteImport_2<SvelteComponent<Record<string, any>, any, any>> & SvelteModuleComponent_2)[]>;
|
|
46
|
+
getLayouts(route: IRoute): Promise<SvelteComponent<Record<string, any>, any, any>[]>;
|
|
47
|
+
getLayoutLoaders(route: IRoute): Promise<(((...args: any[]) => any) | null)[]>;
|
|
48
|
+
getViewComponent(route: IRoute): Promise<SvelteImport_2<SvelteComponent<Record<string, any>, any, any>> & SvelteModuleComponent_2>;
|
|
49
|
+
hasLoaders(route: IRoute): Promise<boolean>;
|
|
50
|
+
getLoaders(route: IRoute): Promise<{
|
|
51
|
+
layouts: (((...args: any[]) => any) | null)[];
|
|
52
|
+
view: ((...args: any[]) => any) | null;
|
|
53
|
+
}>;
|
|
54
|
+
private getLoaderFilePath;
|
|
55
|
+
private resolveLoader;
|
|
56
|
+
getView(route: IRoute): Promise<SvelteComponent<Record<string, any>, any, any>>;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export declare function createImageRenderer(config: ImageRendererConfig): Promise<ImageRenderer>;
|
|
60
|
+
|
|
61
|
+
declare interface IComponentLoader {
|
|
62
|
+
load(component: string, options?: any): Promise<SvelteResource<SvelteComponent>>;
|
|
63
|
+
getComponentFullPath(component: string, options?: any): string;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export declare class ImageRenderer {
|
|
67
|
+
private browser;
|
|
68
|
+
private staticRenderer;
|
|
69
|
+
private config;
|
|
70
|
+
constructor(browser: any, staticRenderer: StaticRenderer, config: ImageRendererConfig);
|
|
71
|
+
/**
|
|
72
|
+
* Capture a route and save to outputDir
|
|
73
|
+
*/
|
|
74
|
+
capture(name: string, route: string, options?: CaptureOptions): Promise<CaptureResult>;
|
|
75
|
+
/**
|
|
76
|
+
* Capture raw HTML and save to outputDir
|
|
77
|
+
*/
|
|
78
|
+
captureHtml(name: string, html: string, options?: CaptureHtmlOptions): Promise<CaptureResult>;
|
|
79
|
+
/**
|
|
80
|
+
* Internal method to capture HTML to image
|
|
81
|
+
*/
|
|
82
|
+
private captureHtmlInternal;
|
|
83
|
+
/**
|
|
84
|
+
* Close browser and clean up resources
|
|
85
|
+
*/
|
|
86
|
+
close(): Promise<void>;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export declare interface ImageRendererConfig {
|
|
90
|
+
/** Output directory for screenshots */
|
|
91
|
+
outputDir: string;
|
|
92
|
+
/** Default width (default: 1920) */
|
|
93
|
+
width?: number;
|
|
94
|
+
/** Default height (default: 1080) */
|
|
95
|
+
height?: number;
|
|
96
|
+
/** Device scale factor for retina (default: 1) */
|
|
97
|
+
deviceScaleFactor?: number;
|
|
98
|
+
/** Image format (default: 'png') */
|
|
99
|
+
format?: 'png' | 'jpeg';
|
|
100
|
+
/** JPEG quality 0-100 (default: 80) */
|
|
101
|
+
quality?: number;
|
|
102
|
+
/** Wait condition (default: 'networkidle') */
|
|
103
|
+
waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
|
|
104
|
+
/** Timeout in ms (default: 10000) */
|
|
105
|
+
timeoutMs?: number;
|
|
106
|
+
/** Custom HTML template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */
|
|
107
|
+
template?: string;
|
|
108
|
+
/** Pre-created StaticRenderer instance */
|
|
109
|
+
staticRenderer?: StaticRenderer;
|
|
110
|
+
/** OR: Path to stitch.yaml */
|
|
111
|
+
stitchConfig?: string;
|
|
112
|
+
/** Component directory (required if stitchConfig provided) */
|
|
113
|
+
componentDir?: string;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
declare interface IRoute {
|
|
117
|
+
path: string;
|
|
118
|
+
summary?: string;
|
|
119
|
+
description?: string;
|
|
120
|
+
method: string;
|
|
121
|
+
layout?: string[];
|
|
122
|
+
middleware?: string[];
|
|
123
|
+
view: string;
|
|
124
|
+
responses?: Response_2;
|
|
125
|
+
parameters?: Parameter[];
|
|
126
|
+
query?: Parameter[];
|
|
127
|
+
body?: Body_2;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
declare type Middleware = (req: any, reply: any, next: any) => void;
|
|
131
|
+
|
|
132
|
+
declare type Parameter = any;
|
|
133
|
+
|
|
134
|
+
export declare class PlaywrightNotInstalledError extends Error {
|
|
135
|
+
name: "PlaywrightNotInstalledError";
|
|
136
|
+
constructor();
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
export declare class RenderError extends Error {
|
|
140
|
+
cause?: Error | undefined;
|
|
141
|
+
name: "RenderError";
|
|
142
|
+
constructor(message: string, cause?: Error | undefined);
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
declare interface RenderOptions {
|
|
146
|
+
/** The URL to render (e.g., '/admin/clients/42?tab=invoices') */
|
|
147
|
+
route: string;
|
|
148
|
+
/** HTTP method (default: 'get') */
|
|
149
|
+
method?: string;
|
|
150
|
+
/** Mock data for layouts and view */
|
|
151
|
+
data?: {
|
|
152
|
+
layout?: any[];
|
|
153
|
+
view?: any;
|
|
154
|
+
};
|
|
155
|
+
/** Override: manually specify view component */
|
|
156
|
+
view?: any;
|
|
157
|
+
/** Override: manually specify layout components */
|
|
158
|
+
layouts?: any[];
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
declare interface RenderResult {
|
|
162
|
+
/** Rendered component HTML */
|
|
163
|
+
html: string;
|
|
164
|
+
/** Content from <svelte:head> tags */
|
|
165
|
+
head: string;
|
|
166
|
+
/** Component CSS */
|
|
167
|
+
css: string;
|
|
168
|
+
/** Parsed path parameters */
|
|
169
|
+
params: Record<string, string>;
|
|
170
|
+
/** Parsed query parameters */
|
|
171
|
+
query: Record<string, string | string[]>;
|
|
172
|
+
/** The matched route (if auto-resolved) */
|
|
173
|
+
route: IRoute | null;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
export declare class RenderTimeoutError extends Error {
|
|
177
|
+
name: "RenderTimeoutError";
|
|
178
|
+
constructor(timeoutMs: number);
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
declare interface RenderToPageOptions extends RenderOptions {
|
|
182
|
+
/** Custom HTML template. Use {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */
|
|
183
|
+
template?: string;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
declare type Response_2 = Record<number, ResponseData>;
|
|
187
|
+
|
|
188
|
+
declare type ResponseData = {
|
|
189
|
+
description: string;
|
|
190
|
+
};
|
|
191
|
+
|
|
192
|
+
declare class StaticRenderer {
|
|
193
|
+
private routes;
|
|
194
|
+
private matchers;
|
|
195
|
+
private componentManager;
|
|
196
|
+
constructor(routes: IRoute[], componentManager: ComponentManager);
|
|
197
|
+
render(options: RenderOptions): Promise<RenderResult>;
|
|
198
|
+
/**
|
|
199
|
+
* Render to a full HTML document.
|
|
200
|
+
* Uses default template or custom template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders.
|
|
201
|
+
*/
|
|
202
|
+
renderToPage(options: RenderToPageOptions): Promise<string>;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
declare type SvelteImport<K> = {
|
|
206
|
+
default: K;
|
|
207
|
+
};
|
|
208
|
+
|
|
209
|
+
declare type SvelteModuleComponent = {
|
|
210
|
+
load?: (data: any) => any;
|
|
211
|
+
middleware?: Middleware[];
|
|
212
|
+
middlewares?: Middleware[];
|
|
213
|
+
};
|
|
214
|
+
|
|
215
|
+
declare type SvelteResource<K> = SvelteImport<K> & SvelteModuleComponent;
|
|
216
|
+
|
|
217
|
+
export { }
|
|
218
|
+
|
|
219
|
+
/// <reference types="vite/client" />
|
|
220
|
+
|
|
221
|
+
declare module '@noego/stitch/browser' {
|
|
222
|
+
export function stitchFromViteImports(modules: Record<string, string>): Promise<{
|
|
223
|
+
success: boolean;
|
|
224
|
+
data?: any;
|
|
225
|
+
error?: string;
|
|
226
|
+
}>;
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
|
|
230
|
+
|
|
231
|
+
declare module '@noego/stitch' {
|
|
232
|
+
export class StitchEngine {
|
|
233
|
+
buildSync(filePath: string, options?: { format?: string }): {
|
|
234
|
+
success: boolean;
|
|
235
|
+
data?: any;
|
|
236
|
+
error?: string;
|
|
237
|
+
};
|
|
238
|
+
}
|
|
239
|
+
}
|
package/dist-ssr/test.js
ADDED
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
var __defProp = Object.defineProperty;
|
|
2
|
+
var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
|
|
3
|
+
var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
|
|
4
|
+
import { createStaticRenderer } from "./static.js";
|
|
5
|
+
import * as fs from "fs";
|
|
6
|
+
import * as path from "path";
|
|
7
|
+
class PlaywrightNotInstalledError extends Error {
|
|
8
|
+
constructor() {
|
|
9
|
+
super(
|
|
10
|
+
"ImageRenderer requires Playwright. Install it with:\n npm install playwright\n npx playwright install chromium"
|
|
11
|
+
);
|
|
12
|
+
__publicField(this, "name", "PlaywrightNotInstalledError");
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
class BrowserLaunchError extends Error {
|
|
16
|
+
constructor(message, cause) {
|
|
17
|
+
super(message);
|
|
18
|
+
__publicField(this, "name", "BrowserLaunchError");
|
|
19
|
+
this.cause = cause;
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
class RenderTimeoutError extends Error {
|
|
23
|
+
constructor(timeoutMs) {
|
|
24
|
+
super(`Render timed out after ${timeoutMs}ms`);
|
|
25
|
+
__publicField(this, "name", "RenderTimeoutError");
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
class RenderError extends Error {
|
|
29
|
+
constructor(message, cause) {
|
|
30
|
+
super(message);
|
|
31
|
+
__publicField(this, "name", "RenderError");
|
|
32
|
+
this.cause = cause;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
async function loadPlaywright() {
|
|
36
|
+
try {
|
|
37
|
+
const playwright = await import("playwright");
|
|
38
|
+
return playwright;
|
|
39
|
+
} catch {
|
|
40
|
+
throw new PlaywrightNotInstalledError();
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
class ImageRenderer {
|
|
44
|
+
constructor(browser, staticRenderer, config) {
|
|
45
|
+
__publicField(this, "browser");
|
|
46
|
+
__publicField(this, "staticRenderer");
|
|
47
|
+
__publicField(this, "config");
|
|
48
|
+
this.browser = browser;
|
|
49
|
+
this.staticRenderer = staticRenderer;
|
|
50
|
+
this.config = {
|
|
51
|
+
outputDir: config.outputDir,
|
|
52
|
+
width: config.width ?? 1920,
|
|
53
|
+
height: config.height ?? 1080,
|
|
54
|
+
deviceScaleFactor: config.deviceScaleFactor ?? 1,
|
|
55
|
+
format: config.format ?? "png",
|
|
56
|
+
quality: config.quality ?? 80,
|
|
57
|
+
waitUntil: config.waitUntil ?? "networkidle",
|
|
58
|
+
timeoutMs: config.timeoutMs ?? 1e4,
|
|
59
|
+
template: config.template
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
/**
|
|
63
|
+
* Capture a route and save to outputDir
|
|
64
|
+
*/
|
|
65
|
+
async capture(name, route, options) {
|
|
66
|
+
const { view, layout } = options ?? {};
|
|
67
|
+
const renderResult = await this.staticRenderer.renderToPage({
|
|
68
|
+
route,
|
|
69
|
+
data: { view, layout },
|
|
70
|
+
template: this.config.template
|
|
71
|
+
});
|
|
72
|
+
return this.captureHtmlInternal(name, renderResult, options);
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Capture raw HTML and save to outputDir
|
|
76
|
+
*/
|
|
77
|
+
async captureHtml(name, html, options) {
|
|
78
|
+
return this.captureHtmlInternal(name, html, options);
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Internal method to capture HTML to image
|
|
82
|
+
*/
|
|
83
|
+
async captureHtmlInternal(name, html, options) {
|
|
84
|
+
const width = (options == null ? void 0 : options.width) ?? this.config.width;
|
|
85
|
+
const height = (options == null ? void 0 : options.height) ?? this.config.height;
|
|
86
|
+
let context;
|
|
87
|
+
let page;
|
|
88
|
+
try {
|
|
89
|
+
context = await this.browser.newContext({
|
|
90
|
+
viewport: { width, height },
|
|
91
|
+
deviceScaleFactor: this.config.deviceScaleFactor
|
|
92
|
+
});
|
|
93
|
+
page = await context.newPage();
|
|
94
|
+
const waitUntilMapping = {
|
|
95
|
+
"load": "load",
|
|
96
|
+
"domcontentloaded": "domcontentloaded",
|
|
97
|
+
"networkidle": "networkidle"
|
|
98
|
+
};
|
|
99
|
+
try {
|
|
100
|
+
await page.setContent(html, {
|
|
101
|
+
waitUntil: waitUntilMapping[this.config.waitUntil],
|
|
102
|
+
timeout: this.config.timeoutMs
|
|
103
|
+
});
|
|
104
|
+
} catch (error) {
|
|
105
|
+
if (error instanceof Error && error.message.includes("timeout")) {
|
|
106
|
+
throw new RenderTimeoutError(this.config.timeoutMs);
|
|
107
|
+
}
|
|
108
|
+
throw new RenderError(
|
|
109
|
+
"Failed to render HTML content",
|
|
110
|
+
error instanceof Error ? error : void 0
|
|
111
|
+
);
|
|
112
|
+
}
|
|
113
|
+
const screenshotOptions = {
|
|
114
|
+
type: this.config.format,
|
|
115
|
+
fullPage: false
|
|
116
|
+
};
|
|
117
|
+
if (this.config.format === "jpeg") {
|
|
118
|
+
screenshotOptions.quality = this.config.quality;
|
|
119
|
+
}
|
|
120
|
+
const screenshot = await page.screenshot(screenshotOptions);
|
|
121
|
+
const buffer = Buffer.from(screenshot);
|
|
122
|
+
const filename = `${name}@${width}x${height}.${this.config.format}`;
|
|
123
|
+
const outputPath = path.join(this.config.outputDir, filename);
|
|
124
|
+
await fs.promises.mkdir(this.config.outputDir, { recursive: true });
|
|
125
|
+
await fs.promises.writeFile(outputPath, buffer);
|
|
126
|
+
return { buffer, path: outputPath };
|
|
127
|
+
} finally {
|
|
128
|
+
if (page) {
|
|
129
|
+
await page.close().catch(() => {
|
|
130
|
+
});
|
|
131
|
+
}
|
|
132
|
+
if (context) {
|
|
133
|
+
await context.close().catch(() => {
|
|
134
|
+
});
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
/**
|
|
139
|
+
* Close browser and clean up resources
|
|
140
|
+
*/
|
|
141
|
+
async close() {
|
|
142
|
+
if (this.browser) {
|
|
143
|
+
await this.browser.close().catch(() => {
|
|
144
|
+
});
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
async function createImageRenderer(config) {
|
|
149
|
+
const playwright = await loadPlaywright();
|
|
150
|
+
let browser;
|
|
151
|
+
try {
|
|
152
|
+
browser = await playwright.chromium.launch({
|
|
153
|
+
headless: true
|
|
154
|
+
});
|
|
155
|
+
} catch (error) {
|
|
156
|
+
throw new BrowserLaunchError(
|
|
157
|
+
"Failed to launch Chromium. Ensure it is installed with: npx playwright install chromium",
|
|
158
|
+
error instanceof Error ? error : void 0
|
|
159
|
+
);
|
|
160
|
+
}
|
|
161
|
+
let staticRenderer;
|
|
162
|
+
if (config.staticRenderer) {
|
|
163
|
+
staticRenderer = config.staticRenderer;
|
|
164
|
+
} else if (config.stitchConfig && config.componentDir) {
|
|
165
|
+
staticRenderer = await createStaticRenderer({
|
|
166
|
+
stitchConfig: config.stitchConfig,
|
|
167
|
+
componentDir: config.componentDir
|
|
168
|
+
});
|
|
169
|
+
} else {
|
|
170
|
+
throw new Error(
|
|
171
|
+
"ImageRendererConfig requires either staticRenderer or both stitchConfig and componentDir"
|
|
172
|
+
);
|
|
173
|
+
}
|
|
174
|
+
return new ImageRenderer(browser, staticRenderer, config);
|
|
175
|
+
}
|
|
176
|
+
export {
|
|
177
|
+
BrowserLaunchError,
|
|
178
|
+
ImageRenderer,
|
|
179
|
+
PlaywrightNotInstalledError,
|
|
180
|
+
RenderError,
|
|
181
|
+
RenderTimeoutError,
|
|
182
|
+
createImageRenderer
|
|
183
|
+
};
|
|
184
|
+
//# sourceMappingURL=test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"test.js","sources":["../src/test/index.ts"],"sourcesContent":["import { createStaticRenderer, type StaticRenderer } from '../static/index';\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n// ─────────────────────────────────────────────────────────────\n// Error Classes\n// ─────────────────────────────────────────────────────────────\n\nexport class PlaywrightNotInstalledError extends Error {\n name = 'PlaywrightNotInstalledError' as const;\n constructor() {\n super(\n 'ImageRenderer requires Playwright. Install it with:\\n' +\n ' npm install playwright\\n' +\n ' npx playwright install chromium'\n );\n }\n}\n\nexport class BrowserLaunchError extends Error {\n name = 'BrowserLaunchError' as const;\n constructor(message: string, public cause?: Error) {\n super(message);\n }\n}\n\nexport class RenderTimeoutError extends Error {\n name = 'RenderTimeoutError' as const;\n constructor(timeoutMs: number) {\n super(`Render timed out after ${timeoutMs}ms`);\n }\n}\n\nexport class RenderError extends Error {\n name = 'RenderError' as const;\n constructor(message: string, public cause?: Error) {\n super(message);\n }\n}\n\n// ─────────────────────────────────────────────────────────────\n// Types\n// ─────────────────────────────────────────────────────────────\n\nexport interface ImageRendererConfig {\n /** Output directory for screenshots */\n outputDir: string;\n /** Default width (default: 1920) */\n width?: number;\n /** Default height (default: 1080) */\n height?: number;\n /** Device scale factor for retina (default: 1) */\n deviceScaleFactor?: number;\n /** Image format (default: 'png') */\n format?: 'png' | 'jpeg';\n /** JPEG quality 0-100 (default: 80) */\n quality?: number;\n /** Wait condition (default: 'networkidle') */\n waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';\n /** Timeout in ms (default: 10000) */\n timeoutMs?: number;\n /** Custom HTML template with {{{HEAD}}}, {{{CSS}}}, {{{APP}}} placeholders */\n template?: string;\n\n // Static renderer config (one of these)\n /** Pre-created StaticRenderer instance */\n staticRenderer?: StaticRenderer;\n /** OR: Path to stitch.yaml */\n stitchConfig?: string;\n /** Component directory (required if stitchConfig provided) */\n componentDir?: string;\n}\n\nexport interface CaptureOptions {\n /** View component data */\n view?: any;\n /** Layout data (one object per layout) */\n layout?: any[];\n /** Override width */\n width?: number;\n /** Override height */\n height?: number;\n}\n\nexport interface CaptureHtmlOptions {\n /** Override width */\n width?: number;\n /** Override height */\n height?: number;\n}\n\ninterface CaptureResult {\n /** Raw image buffer */\n buffer: Buffer;\n /** Path where image was saved */\n path: string;\n}\n\n// ─────────────────────────────────────────────────────────────\n// Playwright Loader\n// ─────────────────────────────────────────────────────────────\n\ntype PlaywrightModule = typeof import('playwright');\n\nasync function loadPlaywright(): Promise<PlaywrightModule> {\n try {\n const playwright = await import('playwright');\n return playwright;\n } catch {\n throw new PlaywrightNotInstalledError();\n }\n}\n\n// ─────────────────────────────────────────────────────────────\n// ImageRenderer Class\n// ─────────────────────────────────────────────────────────────\n\nexport class ImageRenderer {\n private browser: any;\n private staticRenderer: StaticRenderer;\n private config: Required<Omit<ImageRendererConfig, 'staticRenderer' | 'stitchConfig' | 'componentDir' | 'template'>> & {\n outputDir: string;\n template?: string;\n };\n\n constructor(\n browser: any,\n staticRenderer: StaticRenderer,\n config: ImageRendererConfig\n ) {\n this.browser = browser;\n this.staticRenderer = staticRenderer;\n this.config = {\n outputDir: config.outputDir,\n width: config.width ?? 1920,\n height: config.height ?? 1080,\n deviceScaleFactor: config.deviceScaleFactor ?? 1,\n format: config.format ?? 'png',\n quality: config.quality ?? 80,\n waitUntil: config.waitUntil ?? 'networkidle',\n timeoutMs: config.timeoutMs ?? 10000,\n template: config.template,\n };\n }\n\n /**\n * Capture a route and save to outputDir\n */\n async capture(\n name: string,\n route: string,\n options?: CaptureOptions\n ): Promise<CaptureResult> {\n // Render route to HTML using StaticRenderer\n const { view, layout } = options ?? {};\n const renderResult = await this.staticRenderer.renderToPage({\n route,\n data: { view, layout },\n template: this.config.template,\n });\n\n // Capture the HTML\n return this.captureHtmlInternal(name, renderResult, options);\n }\n\n /**\n * Capture raw HTML and save to outputDir\n */\n async captureHtml(\n name: string,\n html: string,\n options?: CaptureHtmlOptions\n ): Promise<CaptureResult> {\n return this.captureHtmlInternal(name, html, options);\n }\n\n /**\n * Internal method to capture HTML to image\n */\n private async captureHtmlInternal(\n name: string,\n html: string,\n options?: CaptureHtmlOptions\n ): Promise<CaptureResult> {\n const width = options?.width ?? this.config.width;\n const height = options?.height ?? this.config.height;\n\n let context: any;\n let page: any;\n\n try {\n // Create new context with viewport\n context = await this.browser.newContext({\n viewport: { width, height },\n deviceScaleFactor: this.config.deviceScaleFactor,\n });\n\n // Create page\n page = await context.newPage();\n\n // Set content with timeout\n const waitUntilMapping = {\n 'load': 'load',\n 'domcontentloaded': 'domcontentloaded',\n 'networkidle': 'networkidle',\n } as const;\n\n try {\n await page.setContent(html, {\n waitUntil: waitUntilMapping[this.config.waitUntil],\n timeout: this.config.timeoutMs,\n });\n } catch (error) {\n if (error instanceof Error && error.message.includes('timeout')) {\n throw new RenderTimeoutError(this.config.timeoutMs);\n }\n throw new RenderError(\n 'Failed to render HTML content',\n error instanceof Error ? error : undefined\n );\n }\n\n // Take screenshot\n const screenshotOptions: {\n type: 'png' | 'jpeg';\n quality?: number;\n fullPage: boolean;\n } = {\n type: this.config.format,\n fullPage: false,\n };\n\n // Quality only applies to JPEG\n if (this.config.format === 'jpeg') {\n screenshotOptions.quality = this.config.quality;\n }\n\n const screenshot = await page.screenshot(screenshotOptions);\n const buffer = Buffer.from(screenshot);\n\n // Generate filename: {name}@{width}x{height}.{format}\n const filename = `${name}@${width}x${height}.${this.config.format}`;\n const outputPath = path.join(this.config.outputDir, filename);\n\n // Ensure output directory exists\n await fs.promises.mkdir(this.config.outputDir, { recursive: true });\n\n // Write file\n await fs.promises.writeFile(outputPath, buffer);\n\n return { buffer, path: outputPath };\n\n } finally {\n // Cleanup context and page (browser stays open)\n if (page) {\n await page.close().catch(() => {});\n }\n if (context) {\n await context.close().catch(() => {});\n }\n }\n }\n\n /**\n * Close browser and clean up resources\n */\n async close(): Promise<void> {\n if (this.browser) {\n await this.browser.close().catch(() => {});\n }\n }\n}\n\n// ─────────────────────────────────────────────────────────────\n// Factory Function\n// ─────────────────────────────────────────────────────────────\n\nexport async function createImageRenderer(\n config: ImageRendererConfig\n): Promise<ImageRenderer> {\n // Load Playwright dynamically\n const playwright = await loadPlaywright();\n\n // Launch browser\n let browser: any;\n try {\n browser = await playwright.chromium.launch({\n headless: true,\n });\n } catch (error) {\n throw new BrowserLaunchError(\n 'Failed to launch Chromium. Ensure it is installed with: npx playwright install chromium',\n error instanceof Error ? error : undefined\n );\n }\n\n // Get or create StaticRenderer\n let staticRenderer: StaticRenderer;\n if (config.staticRenderer) {\n staticRenderer = config.staticRenderer;\n } else if (config.stitchConfig && config.componentDir) {\n staticRenderer = await createStaticRenderer({\n stitchConfig: config.stitchConfig,\n componentDir: config.componentDir,\n });\n } else {\n throw new Error(\n 'ImageRendererConfig requires either staticRenderer or both stitchConfig and componentDir'\n );\n }\n\n return new ImageRenderer(browser, staticRenderer, config);\n}\n"],"names":[],"mappings":"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"}
|