npm - @webstir-io/webstir-frontend - Versions diffs - 0.1.40 → 0.1.41 - Mend

@webstir-io/webstir-frontend 0.1.40 → 0.1.41

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.

Files changed (138) hide show

package/README.md +124 -60
package/dist/assets/imageOptimizer.js +10 -15
package/dist/assets/precompression.js +1 -1
package/dist/builders/contentBuilder.js +102 -90
package/dist/builders/cssBuilder.js +25 -19
package/dist/builders/htmlBuilder.js +57 -42
package/dist/builders/index.js +1 -1
package/dist/builders/jsBuilder.js +219 -76
package/dist/builders/staticAssetsBuilder.js +27 -9
package/dist/builders/types.d.ts +1 -0
package/dist/cli.d.ts +1 -1
package/dist/cli.js +6 -30
package/dist/config/manifest.js +7 -6
package/dist/config/paths.js +2 -2
package/dist/config/schema.d.ts +8 -0
package/dist/config/schema.js +7 -6
package/dist/config/setup.js +1 -1
package/dist/config/workspace.js +11 -9
package/dist/core/constants.d.ts +1 -1
package/dist/core/constants.js +5 -5
package/dist/core/diagnostics.js +1 -1
package/dist/core/pages.js +4 -4
package/dist/hooks.js +3 -3
package/dist/html/criticalCss.js +6 -3
package/dist/html/htmlSecurity.d.ts +6 -1
package/dist/html/htmlSecurity.js +28 -14
package/dist/html/lazyLoad.js +1 -1
package/dist/html/pageScaffold.js +1 -1
package/dist/html/resourceHints.js +5 -2
package/dist/index.d.ts +2 -0
package/dist/index.js +2 -0
package/dist/inspect.d.ts +2 -0
package/dist/inspect.js +110 -0
package/dist/modes/ssg/metadata.js +4 -4
package/dist/modes/ssg/routing.js +2 -5
package/dist/modes/ssg/seo.js +5 -5
package/dist/modes/ssg/views.js +17 -11
package/dist/operations.js +18 -10
package/dist/pipeline.d.ts +1 -0
package/dist/pipeline.js +6 -1
package/dist/provider.js +28 -24
package/dist/runtime/boundary.d.ts +28 -0
package/dist/runtime/boundary.js +247 -0
package/dist/runtime/index.d.ts +1 -0
package/dist/runtime/index.js +1 -0
package/dist/types.d.ts +52 -0
package/dist/utils/fs.d.ts +11 -10
package/dist/utils/fs.js +48 -20
package/dist/utils/glob.d.ts +8 -0
package/dist/utils/glob.js +21 -0
package/dist/utils/hash.js +1 -2
package/dist/utils/pagePaths.js +2 -2
package/package.json +19 -14
package/scripts/publish.sh +2 -94
package/scripts/update-contract.sh +12 -10
package/src/assets/assetManifest.ts +39 -29
package/src/assets/imageOptimizer.ts +91 -82
package/src/assets/precompression.ts +22 -16
package/src/builders/contentBuilder.ts +1224 -1149
package/src/builders/cssBuilder.ts +466 -417
package/src/builders/htmlBuilder.ts +511 -448
package/src/builders/index.ts +7 -7
package/src/builders/jsBuilder.ts +538 -280
package/src/builders/staticAssetsBuilder.ts +166 -135
package/src/builders/types.ts +7 -6
package/src/cli.ts +66 -90
package/src/config/manifest.ts +16 -14
package/src/config/paths.ts +5 -5
package/src/config/schema.ts +38 -37
package/src/config/setup.ts +7 -7
package/src/config/workspace.ts +118 -116
package/src/config/workspaceManifest.ts +14 -14
package/src/core/constants.ts +62 -62
package/src/core/diagnostics.ts +26 -26
package/src/core/pages.ts +19 -19
package/src/hooks.ts +128 -118
package/src/html/criticalCss.ts +84 -77
package/src/html/htmlSecurity.ts +107 -66
package/src/html/lazyLoad.ts +22 -19
package/src/html/pageScaffold.ts +37 -28
package/src/html/resourceHints.ts +83 -74
package/src/index.ts +2 -0
package/src/inspect.ts +158 -0
package/src/modes/ssg/metadata.ts +53 -51
package/src/modes/ssg/routing.ts +177 -177
package/src/modes/ssg/seo.ts +208 -200
package/src/modes/ssg/validation.ts +31 -25
package/src/modes/ssg/views.ts +257 -238
package/src/operations.ts +105 -95
package/src/pipeline.ts +81 -69
package/src/provider.ts +184 -176
package/src/runtime/boundary.ts +325 -0
package/src/runtime/index.ts +1 -0
package/src/types.ts +107 -48
package/src/utils/changedFile.ts +22 -22
package/src/utils/fs.ts +73 -26
package/src/utils/glob.ts +38 -0
package/src/utils/hash.ts +2 -4
package/src/utils/pagePaths.ts +35 -23
package/src/utils/pathMatch.ts +26 -23
package/tests/add-page-defaults.test.js +44 -39
package/tests/bundlerParity.test.js +252 -0
package/tests/cli.contract.test.js +13 -0
package/tests/content-pages.test.js +108 -13
package/tests/css-app-imports.test.js +22 -11
package/tests/css-page-imports.test.js +26 -13
package/tests/diagnostics.test.js +39 -36
package/tests/features.test.js +48 -43
package/tests/hooks.test.js +58 -42
package/tests/htmlSecurity.test.js +66 -0
package/tests/inspect.test.js +148 -0
package/tests/provider.integration.test.js +71 -20
package/tests/runtime.test.js +493 -0
package/tests/ssg-defaults.test.js +284 -177
package/tests/ssg-guardrails.test.js +51 -51
package/tsconfig.json +3 -10
package/dist/watch/frontendFiles.d.ts +0 -3
package/dist/watch/frontendFiles.js +0 -25
package/dist/watch/hotUpdateTracker.d.ts +0 -51
package/dist/watch/hotUpdateTracker.js +0 -205
package/dist/watch/pipelineHelpers.d.ts +0 -26
package/dist/watch/pipelineHelpers.js +0 -177
package/dist/watch/types.d.ts +0 -27
package/dist/watch/types.js +0 -1
package/dist/watch/watchCoordinator.d.ts +0 -36
package/dist/watch/watchCoordinator.js +0 -551
package/dist/watch/watchDaemon.d.ts +0 -17
package/dist/watch/watchDaemon.js +0 -127
package/dist/watch/watchReporter.d.ts +0 -21
package/dist/watch/watchReporter.js +0 -64
package/scripts/smoke.mjs +0 -35
package/src/watch/frontendFiles.ts +0 -32
package/src/watch/hotUpdateTracker.ts +0 -285
package/src/watch/pipelineHelpers.ts +0 -242
package/src/watch/types.ts +0 -23
package/src/watch/watchCoordinator.ts +0 -666
package/src/watch/watchDaemon.ts +0 -144
package/src/watch/watchReporter.ts +0 -98

package/dist/watch/watchReporter.d.ts DELETED Viewed

@@ -1,21 +0,0 @@
-import type { BuildResult, Message } from 'esbuild';
-import type { DiagnosticEvent } from '../core/diagnostics.js';
-export interface WatchReporterOptions {
-    readonly verbose: boolean;
-}
-export interface SerializedMessage {
-    readonly text: string;
-    readonly location?: {
-        readonly file?: string;
-        readonly line?: number;
-        readonly column?: number;
-    };
-}
-export declare class WatchReporter {
-    private readonly verbose;
-    constructor(options: WatchReporterOptions);
-    emit(event: DiagnosticEvent): void;
-    emitVerbose(event: DiagnosticEvent): void;
-    emitJavaScriptStats(pageName: string, result: BuildResult, durationMs: number): void;
-}
-export declare function serializeMessages(messages: readonly Message[]): SerializedMessage[];

package/dist/watch/watchReporter.js DELETED Viewed

@@ -1,64 +0,0 @@
-import { emitDiagnostic } from '../core/diagnostics.js';
-export class WatchReporter {
-    verbose;
-    constructor(options) {
-        this.verbose = options.verbose;
-    }
-    emit(event) {
-        emitDiagnostic(event);
-    }
-    emitVerbose(event) {
-        if (!this.verbose) {
-            return;
-        }
-        emitDiagnostic(event);
-    }
-    emitJavaScriptStats(pageName, result, durationMs) {
-        if (!this.verbose) {
-            return;
-        }
-        const stats = extractMetafileStats(result);
-        const data = {
-            page: pageName,
-            durationMs: Number(durationMs.toFixed(1))
-        };
-        if (stats) {
-            data.inputs = stats.inputs;
-            data.outputs = stats.outputs;
-            data.bytes = stats.bytes;
-        }
-        emitDiagnostic({
-            code: 'frontend.watch.javascript.build.stats',
-            kind: 'watch-daemon',
-            stage: 'javascript',
-            severity: 'info',
-            message: `JavaScript rebuild stats for '${pageName}' (${durationMs.toFixed(1)}ms).`,
-            data
-        });
-    }
-}
-export function serializeMessages(messages) {
-    return messages.map((message) => ({
-        text: message.text,
-        location: message.location
-            ? {
-                file: message.location.file,
-                line: message.location.line,
-                column: message.location.column
-            }
-            : undefined
-    }));
-}
-function extractMetafileStats(result) {
-    if (!result.metafile) {
-        return null;
-    }
-    const inputs = Object.keys(result.metafile.inputs ?? {}).length;
-    const outputsEntries = Object.entries(result.metafile.outputs ?? {});
-    const bytes = outputsEntries.reduce((sum, [, output]) => sum + (output.bytes ?? 0), 0);
-    return {
-        inputs,
-        outputs: outputsEntries.length,
-        bytes
-    };
-}

package/scripts/smoke.mjs DELETED Viewed

@@ -1,35 +0,0 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import os from 'node:os';
-import { frontendProvider } from '../dist/index.js';
-async function createWorkspace() {
-  const root = await fs.mkdtemp(path.join(os.tmpdir(), 'webstir-frontend-smoke-'));
-  const appDir = path.join(root, 'src', 'frontend', 'app');
-  const pageDir = path.join(root, 'src', 'frontend', 'pages', 'home');
-  await fs.mkdir(appDir, { recursive: true });
-  await fs.mkdir(pageDir, { recursive: true });
-  await fs.writeFile(path.join(appDir, 'app.html'), '<!DOCTYPE html><html><head><title>App</title></head><body><main></main></body></html>', 'utf8');
-  await fs.writeFile(path.join(pageDir, 'index.html'), '<head></head><main><section>Home</section></main>', 'utf8');
-  await fs.writeFile(path.join(pageDir, 'index.ts'), 'console.log("home")', 'utf8');
-  return root;
-}
-async function main() {
-  const workspace = await createWorkspace();
-  console.info('[smoke:frontend] build mode');
-  const build = await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'build' }, incremental: false });
-  console.info('[smoke:frontend] build entries:', build.manifest.entryPoints);
-  console.info('[smoke:frontend] build diagnostics:', build.manifest.diagnostics.map(d => d.message));
-  console.info('[smoke:frontend] publish mode');
-  const publish = await frontendProvider.build({ workspaceRoot: workspace, env: { WEBSTIR_MODULE_MODE: 'publish' }, incremental: false });
-  console.info('[smoke:frontend] publish entries:', publish.manifest.entryPoints);
-  console.info('[smoke:frontend] publish diagnostics:', publish.manifest.diagnostics.map(d => d.message));
-}
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/src/watch/frontendFiles.ts DELETED Viewed

@@ -1,32 +0,0 @@
-import path from 'node:path';
-import { ensureDir, pathExists, copy } from '../utils/fs.js';
-import { FILES, EXTENSIONS } from '../core/constants.js';
-import type { EnableFlags, FrontendConfig } from '../types.js';
-export async function resolveEntryPoint(pageDirectory: string): Promise<string | null> {
-    const candidates = [`${FILES.index}${EXTENSIONS.ts}`, `${FILES.index}.tsx`, `${FILES.index}${EXTENSIONS.js}`, `${FILES.index}.jsx`];
-    for (const candidate of candidates) {
-        const file = path.join(pageDirectory, candidate);
-        if (await pathExists(file)) {
-            return file;
-        }
-    }
-    return null;
-}
-export async function copyRefreshScript(config: FrontendConfig, enable?: EnableFlags): Promise<void> {
-    const runtimeScripts: string[] = [FILES.refreshJs, FILES.hmrJs];
-    for (const scriptName of runtimeScripts) {
-        const source = path.join(config.paths.src.app, scriptName);
-        if (!(await pathExists(source))) {
-            continue;
-        }
-        const destination = path.join(config.paths.build.frontend, scriptName);
-        await ensureDir(path.dirname(destination));
-        await copy(source, destination);
-    }
-}

package/src/watch/hotUpdateTracker.ts DELETED Viewed

@@ -1,285 +0,0 @@
-import path from 'node:path';
-import { createHash } from 'node:crypto';
-import { readFile } from 'node:fs/promises';
-import type { BuildResult, Metafile } from 'esbuild';
-import { FOLDERS, FILES, EXTENSIONS } from '../core/constants.js';
-import { emitDiagnostic } from '../core/diagnostics.js';
-import type { FrontendConfig } from '../types.js';
-import type { BuilderContext } from '../builders/types.js';
-import { pathExists } from '../utils/fs.js';
-import { isPathInside } from '../utils/changedFile.js';
-import { findPageFromChangedFile } from '../utils/pathMatch.js';
-export interface HotAsset {
-    readonly type: 'js' | 'css';
-    readonly path: string;
-    readonly relativePath: string;
-    readonly url: string;
-}
-export interface HotUpdateDetails {
-    readonly modules: readonly HotAsset[];
-    readonly styles: readonly HotAsset[];
-    readonly requiresReload: boolean;
-    readonly fallbackReasons: readonly string[];
-    readonly changedFile?: string;
-    readonly stats?: HotUpdateStats;
-}
-export interface HotUpdateStats {
-    readonly hotUpdates: number;
-    readonly reloadFallbacks: number;
-}
-interface ProcessJavaScriptResult {
-    readonly modules: readonly HotAsset[];
-    readonly requiresReload: boolean;
-    readonly fallbackReasons: readonly string[];
-}
-interface CollectCssResult {
-    readonly styles: readonly HotAsset[];
-    readonly requiresReload: boolean;
-    readonly fallbackReasons: readonly string[];
-}
-interface HotUpdateTrackerOptions {
-    readonly workspaceRoot: string;
-}
-export class HotUpdateTracker {
-    private readonly workspaceRoot: string;
-    private readonly pageOutputHashes = new Map<string, Map<string, { hash: string }>>();
-    private readonly assetFingerprints = new Map<string, string>();
-    public constructor(options: HotUpdateTrackerOptions) {
-        this.workspaceRoot = options.workspaceRoot;
-    }
-    public reset(): void {
-        this.pageOutputHashes.clear();
-        this.assetFingerprints.clear();
-    }
-    public removePage(pageName: string): void {
-        this.pageOutputHashes.delete(pageName);
-    }
-    public async processJavaScriptResult(
-        pageName: string,
-        result: BuildResult,
-        config: FrontendConfig
-    ): Promise<ProcessJavaScriptResult> {
-        const modules: HotAsset[] = [];
-        let requiresReload = false;
-        const fallbackReasons: string[] = [];
-        const metafile = result.metafile as Metafile | undefined;
-        if (!metafile) {
-            fallbackReasons.push('javascript.metafile.missing');
-            return { modules, requiresReload: true, fallbackReasons };
-        }
-        const buildRoot = config.paths.build.frontend;
-        const currentOutputs = new Set<string>();
-        const previousOutputs = this.pageOutputHashes.get(pageName) ?? new Map<string, { hash: string }>();
-        for (const outputPath of Object.keys(metafile.outputs)) {
-            const extension = path.extname(outputPath).toLowerCase();
-            if (extension !== EXTENSIONS.js && extension !== '.mjs') {
-                continue;
-            }
-            const absoluteOutput = this.resolveOutputPath(outputPath);
-            currentOutputs.add(absoluteOutput);
-            const fingerprint = await this.computeAssetFingerprint(absoluteOutput, buildRoot, 'js');
-            if (!fingerprint) {
-                if (this.assetFingerprints.has(absoluteOutput)) {
-                    this.assetFingerprints.delete(absoluteOutput);
-                }
-                if (previousOutputs.has(absoluteOutput)) {
-                    previousOutputs.delete(absoluteOutput);
-                    requiresReload = true;
-                    fallbackReasons.push('javascript.output.missing');
-                }
-                continue;
-            }
-            if (fingerprint.requiresReload) {
-                requiresReload = true;
-                fallbackReasons.push('javascript.fingerprint.error');
-            }
-            if (fingerprint.changed) {
-                modules.push(fingerprint.asset);
-            }
-            if (fingerprint.hash) {
-                previousOutputs.set(absoluteOutput, { hash: fingerprint.hash });
-            } else if (previousOutputs.has(absoluteOutput)) {
-                previousOutputs.delete(absoluteOutput);
-            }
-        }
-        for (const known of Array.from(previousOutputs.keys())) {
-            if (!currentOutputs.has(known)) {
-                previousOutputs.delete(known);
-                requiresReload = true;
-                fallbackReasons.push('javascript.output.removed');
-            }
-        }
-        this.pageOutputHashes.set(pageName, previousOutputs);
-        return { modules, requiresReload, fallbackReasons: uniqueReasons(fallbackReasons) };
-    }
-    public async collectCssChanges(
-        context: BuilderContext,
-        pageNames: readonly string[]
-    ): Promise<CollectCssResult> {
-        const { config, changedFile } = context;
-        const buildRoot = config.paths.build.frontend;
-        const candidates = new Set<string>();
-        if (!changedFile) {
-            for (const page of pageNames) {
-                candidates.add(this.getPageCssOutputPath(config, page));
-            }
-            candidates.add(this.getAppCssOutputPath(config));
-        } else {
-            const normalized = path.resolve(changedFile);
-            const extension = path.extname(normalized).toLowerCase();
-            if (extension === EXTENSIONS.css) {
-                if (isPathInside(normalized, config.paths.src.app)) {
-                    for (const page of pageNames) {
-                        candidates.add(this.getPageCssOutputPath(config, page));
-                    }
-                    candidates.add(this.getAppCssOutputPath(config));
-                } else if (isPathInside(normalized, config.paths.src.pages)) {
-                    const page = findPageFromChangedFile(normalized, config.paths.src.pages);
-                    if (page) {
-                        candidates.add(this.getPageCssOutputPath(config, page));
-                    }
-                } else if (isPathInside(normalized, config.paths.src.frontend)) {
-                    for (const page of pageNames) {
-                        candidates.add(this.getPageCssOutputPath(config, page));
-                    }
-                    candidates.add(this.getAppCssOutputPath(config));
-                }
-            }
-        }
-        if (candidates.size === 0 && !changedFile) {
-            candidates.add(this.getAppCssOutputPath(config));
-            for (const page of pageNames) {
-                candidates.add(this.getPageCssOutputPath(config, page));
-            }
-        }
-        const styles: HotAsset[] = [];
-        let requiresReload = !changedFile;
-        const fallbackReasons: string[] = [];
-        if (!changedFile) {
-            fallbackReasons.push('css.full-rebuild');
-        }
-        for (const candidate of candidates) {
-            const fingerprint = await this.computeAssetFingerprint(candidate, buildRoot, 'css');
-            if (!fingerprint) {
-                if (this.assetFingerprints.has(path.resolve(candidate))) {
-                    this.assetFingerprints.delete(path.resolve(candidate));
-                    requiresReload = true;
-                    fallbackReasons.push('css.asset.missing');
-                }
-                continue;
-            }
-            if (fingerprint.requiresReload) {
-                requiresReload = true;
-                fallbackReasons.push('css.fingerprint.error');
-            }
-            if (fingerprint.changed) {
-                styles.push(fingerprint.asset);
-            }
-        }
-        return { styles, requiresReload, fallbackReasons: uniqueReasons(fallbackReasons) };
-    }
-    private async computeAssetFingerprint(
-        filePath: string,
-        buildRoot: string,
-        type: HotAsset['type']
-    ): Promise<{ asset: HotAsset; changed: boolean; requiresReload: boolean; hash?: string } | null> {
-        const absolutePath = path.resolve(filePath);
-        if (!(await pathExists(absolutePath))) {
-            return null;
-        }
-        try {
-            const contents = await readFile(absolutePath);
-            const hash = createHash('sha1').update(contents).digest('hex');
-            const previous = this.assetFingerprints.get(absolutePath);
-            const changed = previous !== hash;
-            this.assetFingerprints.set(absolutePath, hash);
-            return {
-                asset: this.createHotAsset(absolutePath, buildRoot, type),
-                changed,
-                requiresReload: false,
-                hash
-            };
-        } catch (error) {
-            emitDiagnostic({
-                code: 'frontend.watch.unexpected',
-                kind: 'watch-daemon',
-                stage: 'css-fingerprint',
-                severity: 'error',
-                message: `Failed to fingerprint asset '${absolutePath}': ${error instanceof Error ? error.message : String(error)}`
-            });
-            return {
-                asset: this.createHotAsset(absolutePath, buildRoot, type),
-                changed: false,
-                requiresReload: true
-            };
-        }
-    }
-    private getPageCssOutputPath(config: FrontendConfig, pageName: string): string {
-        return path.join(config.paths.build.frontend, FOLDERS.pages, pageName, `${FILES.index}${EXTENSIONS.css}`);
-    }
-    private getAppCssOutputPath(config: FrontendConfig): string {
-        return path.join(config.paths.build.frontend, FOLDERS.app, 'app.css');
-    }
-    private createHotAsset(filePath: string, buildRoot: string, type: HotAsset['type']): HotAsset {
-        const relativePath = path.relative(buildRoot, filePath);
-        const webPath = this.toWebPath(relativePath);
-        return {
-            type,
-            path: filePath,
-            relativePath,
-            url: webPath.startsWith('/') ? webPath : `/${webPath}`
-        };
-    }
-    private resolveOutputPath(outputPath: string): string {
-        if (path.isAbsolute(outputPath)) {
-            return outputPath;
-        }
-        return path.resolve(this.workspaceRoot, outputPath);
-    }
-    private toWebPath(relativePath: string): string {
-        return relativePath.split(path.sep).join('/') || '';
-    }
-}
-function uniqueReasons(reasons: readonly string[]): readonly string[] {
-    return Array.from(new Set(reasons.filter(Boolean)));
-}

package/src/watch/pipelineHelpers.ts DELETED Viewed

@@ -1,242 +0,0 @@
-import type { BuildFailure, Message } from 'esbuild';
-import { emitDiagnostic } from '../core/diagnostics.js';
-import type { DiagnosticSeverity } from '../core/diagnostics.js';
-import type { Builder, BuilderContext } from '../builders/types.js';
-import { WatchReporter, serializeMessages, type SerializedMessage } from './watchReporter.js';
-import type { HotAsset, HotUpdateDetails } from './hotUpdateTracker.js';
-const BUILDER_DISPLAY_NAMES: Record<string, string> = {
-    css: 'CSS',
-    html: 'HTML',
-    'static-assets': 'Static assets'
-} as const;
-export interface JavaScriptBuildSummary {
-    readonly pagesBuilt: readonly string[];
-    readonly warnings: readonly SerializedMessage[];
-    readonly modules: readonly HotAsset[];
-    readonly requiresReload: boolean;
-    readonly fallbackReasons: readonly string[];
-}
-export interface AdditionalBuildResult {
-    readonly succeeded: boolean;
-    readonly assets: readonly string[];
-    readonly styles: readonly HotAsset[];
-    readonly requiresReload: boolean;
-    readonly fallbackReasons: readonly string[];
-}
-export async function runBuilderWithDiagnostics(
-    builder: Builder,
-    reporter: WatchReporter,
-    context: BuilderContext,
-    changedFile: string | undefined,
-    relativeChange: string | undefined
-): Promise<boolean> {
-    const displayName = BUILDER_DISPLAY_NAMES[builder.name] ?? builder.name;
-    const messageContext = relativeChange ? ` (${relativeChange})` : '';
-    reporter.emitVerbose({
-        code: `frontend.watch.${builder.name}.build.start`,
-        kind: 'watch-daemon',
-        stage: builder.name,
-        severity: 'info',
-        message: `Starting ${displayName} rebuild${messageContext}.`,
-        data: changedFile ? { changedFile, builder: builder.name } : { builder: builder.name }
-    });
-    try {
-        await builder.build(context);
-        reporter.emitVerbose({
-            code: `frontend.watch.${builder.name}.build.success`,
-            kind: 'watch-daemon',
-            stage: builder.name,
-            severity: 'info',
-            message: `${displayName} rebuild completed${messageContext}.`,
-            data: changedFile ? { changedFile, builder: builder.name } : { builder: builder.name }
-        });
-        return true;
-    } catch (error) {
-        const details: Record<string, unknown> = { builder: builder.name };
-        if (changedFile) {
-            details.changedFile = changedFile;
-        }
-        if (error instanceof Error) {
-            details.error = error.message;
-        } else {
-            details.error = String(error);
-        }
-        emitDiagnostic({
-            code: `frontend.watch.${builder.name}.build.failure`,
-            kind: 'watch-daemon',
-            stage: builder.name,
-            severity: 'error',
-            message: `${displayName} rebuild failed${messageContext}.`,
-            data: details
-        });
-        return false;
-    }
-}
-export function emitPipelineSuccess(
-    summary: JavaScriptBuildSummary,
-    assetsResult: AdditionalBuildResult,
-    changedFile: string | undefined,
-    relativeChange: string | undefined,
-    hotUpdate: HotUpdateDetails
-): void {
-    const message = `Frontend rebuild pipeline completed${relativeChange ? ` (${relativeChange})` : ''}.`;
-    const data: Record<string, unknown> = {
-        pages: summary.pagesBuilt,
-        assets: assetsResult.assets,
-        hotUpdate: serializeHotUpdate(hotUpdate, relativeChange)
-    };
-    if (relativeChange) {
-        data.changedFile = relativeChange;
-    } else if (changedFile) {
-        data.changedFile = changedFile;
-    }
-    if (summary.warnings.length > 0) {
-        data.javascriptWarnings = summary.warnings;
-    }
-    emitDiagnostic({
-        code: 'frontend.watch.pipeline.success',
-        kind: 'watch-daemon',
-        stage: 'pipeline',
-        severity: 'info',
-        message,
-        data
-    });
-}
-export function serializeSummary(
-    summary: JavaScriptBuildSummary,
-    changedFile: string | undefined,
-    skipped: boolean
-): Record<string, unknown> {
-    const data: Record<string, unknown> = {
-        pages: summary.pagesBuilt
-    };
-    if (changedFile) {
-        data.changedFile = changedFile;
-    }
-    if (summary.warnings.length > 0) {
-        data.warnings = summary.warnings;
-    }
-    if (skipped) {
-        data.skipped = true;
-    }
-    if (summary.modules.length > 0) {
-        data.modules = summary.modules.map(asset => asset.url);
-    }
-    if (summary.requiresReload) {
-        data.requiresReload = true;
-    }
-    if (summary.fallbackReasons.length > 0) {
-        data.fallbackReasons = summary.fallbackReasons;
-    }
-    return data;
-}
-export function emitJavaScriptFailure(error: unknown, changedFile?: string): void {
-    let message = 'JavaScript rebuild failed.';
-    let severity: DiagnosticSeverity = 'error';
-    const data: Record<string, unknown> = changedFile ? { changedFile } : {};
-    if (error instanceof JavaScriptBuildError) {
-        message = `JavaScript rebuild failed for page '${error.pageName}'.`;
-        if (error.details.length > 0) {
-            data.errors = error.details;
-        }
-    } else if (error instanceof Error) {
-        message = `JavaScript rebuild failed: ${error.message}`;
-    }
-    emitDiagnostic({
-        code: 'frontend.watch.javascript.build.failure',
-        kind: 'watch-daemon',
-        stage: 'javascript',
-        severity,
-        message,
-        data: Object.keys(data).length > 0 ? data : undefined
-    });
-}
-export class JavaScriptBuildError extends Error {
-    public readonly pageName: string;
-    public readonly details: readonly SerializedMessage[];
-    public constructor(pageName: string, cause: unknown) {
-        const message = cause instanceof Error ? cause.message : String(cause);
-        super(message);
-        this.pageName = pageName;
-        this.details = isBuildFailure(cause) ? serializeMessages(cause.errors ?? []) : [];
-    }
-}
-function serializeHotUpdate(hotUpdate: HotUpdateDetails, relativeChange?: string): Record<string, unknown> {
-    const data: Record<string, unknown> = {
-        requiresReload: hotUpdate.requiresReload,
-        modules: hotUpdate.modules.map(asset => serializeHotAsset(asset)),
-        styles: hotUpdate.styles.map(asset => serializeHotAsset(asset))
-    };
-    if (relativeChange) {
-        data.changedFile = relativeChange;
-    } else if (hotUpdate.changedFile) {
-        data.changedFile = hotUpdate.changedFile;
-    }
-    if (hotUpdate.fallbackReasons.length > 0) {
-        data.fallbackReasons = hotUpdate.fallbackReasons;
-    }
-    if (hotUpdate.stats) {
-        data.stats = {
-            hotUpdates: hotUpdate.stats.hotUpdates,
-            reloadFallbacks: hotUpdate.stats.reloadFallbacks
-        };
-    }
-    return data;
-}
-function serializeHotAsset(asset: HotAsset): Record<string, string> {
-    return {
-        type: asset.type,
-        path: asset.path,
-        relativePath: asset.relativePath,
-        url: asset.url
-    };
-}
-function isBuildFailure(error: unknown): error is BuildFailure {
-    if (typeof error !== 'object' || error === null) {
-        return false;
-    }
-    const candidate = error as BuildFailure;
-    return Array.isArray(candidate.errors) && candidate.errors.every(isEsbuildMessage);
-}
-function isEsbuildMessage(candidate: unknown): candidate is Message {
-    if (typeof candidate !== 'object' || candidate === null) {
-        return false;
-    }
-    return typeof (candidate as Message).text === 'string';
-}