@ecopages/core 0.2.0-alpha.1 → 0.2.0-alpha.11

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/base/base-script-processor.js

@@ -1,11 +1,14 @@
-import { appLogger } from "../../../../global/app-logger";
-import { defaultBuildAdapter } from "../../../../build/build-adapter.js";
+import { appLogger } from "../../../../../global/app-logger.js";
+import { getAppBrowserBuildPlugins } from "../../../../../build/build-adapter.js";
 import { fileSystem } from "@ecopages/file-system";
 import path from "node:path";
-import { BaseProcessor } from "./base-processor";
+import { BaseProcessor } from "./base-processor.js";
+import { BrowserBundleService } from "../../../browser-bundle.service.js";
 class BaseScriptProcessor extends BaseProcessor {
+  browserBundleService;
   constructor({ appConfig }) {
     super({ appConfig });
+    this.browserBundleService = new BrowserBundleService(appConfig);
   }
   shouldBundle(dep) {
     return dep.bundle !== false;
@@ -14,18 +17,7 @@ class BaseScriptProcessor extends BaseProcessor {
     return dep.bundleOptions || {};
   }
   collectBuildPlugins() {
-    const plugins = [];
-    if (this.appConfig.processors?.size) {
-      for (const processor of this.appConfig.processors.values()) {
-        if (processor.buildPlugins) {
-          plugins.push(...processor.buildPlugins);
-        }
-      }
-    }
-    if (this.appConfig.loaders?.size) {
-      plugins.push(...this.appConfig.loaders.values());
-    }
-    return plugins;
+    return getAppBrowserBuildPlugins(this.appConfig);
   }
   async bundleScript({
     entrypoint,
@@ -35,31 +27,31 @@ class BaseScriptProcessor extends BaseProcessor {
   }) {
     const buildPlugins = this.collectBuildPlugins();
     const allPlugins = additionalPlugins ? [...additionalPlugins, ...buildPlugins] : buildPlugins;
-    const build = await defaultBuildAdapter.build({
+    const buildResult = await this.browserBundleService.bundle({
+      profile: "browser-script",
       entrypoints: [entrypoint],
       outdir,
       root: this.appConfig.rootDir,
-      ...defaultBuildAdapter.getTranspileOptions("browser-script"),
       splitting: true,
       naming: "[name]-[hash].[ext]",
       plugins: allPlugins,
       ...rest
     });
-    if (!build.success) {
-      for (const log of build.logs) {
+    if (!buildResult.success) {
+      for (const log of buildResult.logs) {
         appLogger.debug(log.message, log);
       }
     }
     const entryBaseName = path.parse(entrypoint).name;
-    const entryOutput = build.outputs.map((output) => output.path).find((outputPath) => path.basename(outputPath) === `${entryBaseName}.js`);
+    const entryOutput = buildResult.outputs.map((output) => output.path).find((outputPath) => path.basename(outputPath) === `${entryBaseName}.js`);
     if (entryOutput) {
       return entryOutput;
     }
-    const nonVendorOutput = build.outputs.map((output) => output.path).find((outputPath) => !path.basename(outputPath).startsWith("vendors"));
+    const nonVendorOutput = buildResult.outputs.map((output) => output.path).find((outputPath) => !path.basename(outputPath).startsWith("vendors"));
     if (nonVendorOutput) {
       return nonVendorOutput;
     }
-    const primaryOutput = build.outputs[0]?.path;
+    const primaryOutput = buildResult.outputs[0]?.path;
     if (primaryOutput) {
       return primaryOutput;
     }
@@ -71,7 +63,7 @@ class BaseScriptProcessor extends BaseProcessor {
     if (fileSystem.exists(fallbackOutput)) {
       return fallbackOutput;
     }
-    const logMessage = build.logs.map((log) => log.message).join(" | ");
+    const logMessage = buildResult.logs.map((log) => log.message).join(" | ");
     throw new Error(`No build output generated for ${entrypoint}${logMessage ? `: ${logMessage}` : ""}`);
   }
 }

package/src/services/assets/asset-processing-service/processors/index.d.ts

@@ -0,0 +1,5 @@
+export * from './script/content-script.processor.js';
+export * from './script/file-script.processor.js';
+export * from './script/node-module-script.processor.js';
+export * from './stylesheet/content-stylesheet.processor.js';
+export * from './stylesheet/file-stylesheet.processor.js';

package/src/services/assets/asset-processing-service/processors/index.js

@@ -0,0 +1,5 @@
+export * from "./script/content-script.processor.js";
+export * from "./script/file-script.processor.js";
+export * from "./script/node-module-script.processor.js";
+export * from "./stylesheet/content-stylesheet.processor.js";
+export * from "./stylesheet/file-stylesheet.processor.js";

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.d.ts

@@ -1,5 +1,5 @@
-import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
+import type { ContentScriptAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class ContentScriptProcessor extends BaseScriptProcessor<ContentScriptAsset> {
     process(dep: ContentScriptAsset): Promise<ProcessedAsset>;
 }

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/content-script.processor.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseScriptProcessor } from "../base/base-script-processor";
+import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class ContentScriptProcessor extends BaseScriptProcessor {
   async process(dep) {
     const hash = this.generateHash(dep.content);

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.d.ts

@@ -1,8 +1,9 @@
-import type { IHmrManager } from '../../../../internal-types';
-import type { FileScriptAsset, ProcessedAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
+import type { IHmrManager } from '../../../../../types/internal-types.js';
+import type { FileScriptAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class FileScriptProcessor extends BaseScriptProcessor<FileScriptAsset> {
     private hmrManager?;
+    private resolveHmrOutputFilepath;
     setHmrManager(hmrManager: IHmrManager): void;
     process(dep: FileScriptAsset): Promise<ProcessedAsset>;
 }

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/file-script.processor.js

@@ -1,17 +1,29 @@
 import path from "node:path";
-import { RESOLVED_ASSETS_DIR } from "../../../../constants";
+import { RESOLVED_ASSETS_DIR } from "../../../../../config/constants.js";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseScriptProcessor } from "../base/base-script-processor";
+import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class FileScriptProcessor extends BaseScriptProcessor {
   hmrManager;
+  resolveHmrOutputFilepath(entrypointPath) {
+    if (!this.hmrManager || !("getDistDir" in this.hmrManager)) {
+      return void 0;
+    }
+    const getDistDir = this.hmrManager.getDistDir;
+    if (typeof getDistDir !== "function") {
+      return void 0;
+    }
+    const relativePathJs = path.relative(this.appConfig.absolutePaths.srcDir, entrypointPath).replace(/\.(tsx?|jsx?|mdx?)$/, ".js").replace(/\[([^\]]+)\]/g, "_$1_");
+    return path.join(getDistDir.call(this.hmrManager), relativePathJs);
+  }
   setHmrManager(hmrManager) {
     this.hmrManager = hmrManager;
   }
   async process(dep) {
     if (this.hmrManager?.isEnabled() && !dep.inline) {
-      const outputUrl = await this.hmrManager.registerEntrypoint(dep.filepath);
+      const outputUrl = await this.hmrManager.registerScriptEntrypoint(dep.filepath);
+      const outputFilepath = this.resolveHmrOutputFilepath(dep.filepath);
       return {
-        filepath: dep.filepath,
+        filepath: outputFilepath ?? dep.filepath,
         srcUrl: outputUrl,
         kind: "script",
         position: dep.position,

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.d.ts

@@ -1,7 +1,7 @@
-import type { NodeModuleScriptAsset } from '../../assets.types';
-import { BaseScriptProcessor } from '../base/base-script-processor';
+import type { NodeModuleScriptAsset } from '../../assets.types.js';
+import { BaseScriptProcessor } from '../base/base-script-processor.js';
 export declare class NodeModuleScriptProcessor extends BaseScriptProcessor<NodeModuleScriptAsset> {
-    process(dep: NodeModuleScriptAsset): Promise<import("../../assets.types").ProcessedAsset>;
+    process(dep: NodeModuleScriptAsset): Promise<import("../../assets.types.js").ProcessedAsset>;
     private resolveModulePath;
     private resolveModulePathFallback;
 }

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/script/node-module-script.processor.js

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { defaultBuildAdapter } from "../../../../build/build-adapter.js";
-import { BaseScriptProcessor } from "../base/base-script-processor";
+import { getAppBuildAdapter } from "../../../../../build/build-adapter.js";
+import { BaseScriptProcessor } from "../base/base-script-processor.js";
 class NodeModuleScriptProcessor extends BaseScriptProcessor {
   async process(dep) {
     const modulePath = this.resolveModulePath(dep.importPath, this.appConfig.rootDir);
@@ -24,12 +24,13 @@ class NodeModuleScriptProcessor extends BaseScriptProcessor {
         };
       }
       const outdir = path.join(this.getAssetsDir(), "vendors");
+      const bundlerOptions = this.getBundlerOptions(dep);
       const filePath = await this.bundleScript({
         entrypoint: modulePath,
         outdir,
         minify: this.isProduction,
-        naming: dep.name ? `${dep.name}-[hash].[ext]` : "[name]-[hash].[ext]",
-        ...this.getBundlerOptions(dep)
+        naming: bundlerOptions.naming ?? (dep.name ? `${dep.name}-[hash].[ext]` : "[name]-[hash].[ext]"),
+        ...bundlerOptions
       });
       return {
         filepath: filePath,
@@ -46,7 +47,7 @@ class NodeModuleScriptProcessor extends BaseScriptProcessor {
       return importPath;
     }
     try {
-      return defaultBuildAdapter.resolve(importPath, rootDir);
+      return getAppBuildAdapter(this.appConfig).resolve(importPath, rootDir);
     } catch {
       return this.resolveModulePathFallback(importPath, rootDir);
     }

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.d.ts

@@ -1,5 +1,5 @@
-import type { ContentStylesheetAsset, ProcessedAsset } from '../../assets.types';
-import { BaseProcessor } from '../base/base-processor';
+import type { ContentStylesheetAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseProcessor } from '../base/base-processor.js';
 export declare class ContentStylesheetProcessor extends BaseProcessor<ContentStylesheetAsset> {
     process(dep: ContentStylesheetAsset): Promise<ProcessedAsset>;
 }

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/content-stylesheet.processor.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseProcessor } from "../base/base-processor";
+import { BaseProcessor } from "../base/base-processor.js";
 class ContentStylesheetProcessor extends BaseProcessor {
   async process(dep) {
     const hash = this.generateHash(dep.content);

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.d.ts

@@ -1,5 +1,5 @@
-import type { FileStylesheetAsset, ProcessedAsset } from '../../assets.types';
-import { BaseProcessor } from '../base/base-processor';
+import type { FileStylesheetAsset, ProcessedAsset } from '../../assets.types.js';
+import { BaseProcessor } from '../base/base-processor.js';
 export declare class FileStylesheetProcessor extends BaseProcessor<FileStylesheetAsset> {
     private static readonly PROCESSABLE_STYLESHEET_EXTENSIONS;
     getStyleContent: (srcUrl: string) => Buffer;

package/src/services/{asset-processing-service → assets/asset-processing-service}/processors/stylesheet/file-stylesheet.processor.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileSystem } from "@ecopages/file-system";
-import { BaseProcessor } from "../base/base-processor";
+import { BaseProcessor } from "../base/base-processor.js";
 class FileStylesheetProcessor extends BaseProcessor {
   static PROCESSABLE_STYLESHEET_EXTENSIONS = /* @__PURE__ */ new Set([".css", ".scss", ".sass", ".less"]);
   getStyleContent = (srcUrl) => {
@@ -41,7 +41,10 @@ class FileStylesheetProcessor extends BaseProcessor {
     const hash = this.generateHash(processedContent);
     const cachekey = this.buildCacheKey(dep.filepath, hash, dep);
     return this.getOrProcess(cachekey, () => {
-      const filepath = path.join(this.getAssetsDir(), path.relative(this.appConfig.srcDir, dep.filepath));
+      const filepath = path.join(
+        this.getAssetsDir(),
+        path.relative(this.appConfig.absolutePaths.srcDir, dep.filepath)
+      );
       const outputBuffer = Buffer.from(processedContent);
       if (!dep.inline) {
         fileSystem.ensureDir(path.dirname(filepath));

package/src/services/assets/browser-bundle.service.d.ts

@@ -0,0 +1,32 @@
+import type { BuildOptions, BuildResult, BuildTranspileProfile } from '../../build/build-adapter.js';
+import type { EcoPagesAppConfig } from '../../types/internal-types.js';
+export type BrowserBundleOptions = Omit<BuildOptions, 'target' | 'format' | 'sourcemap'> & {
+    profile: BuildTranspileProfile;
+};
+export interface BrowserBundleExecutor {
+    bundle(options: BrowserBundleOptions): Promise<BuildResult>;
+}
+/**
+ * App-owned boundary for browser-oriented bundle work.
+ *
+ * @remarks
+ * This service owns the shared browser transpile defaults and ensures browser
+ * builds always run through the app-owned executor rather than direct backend
+ * calls scattered across HMR and asset processing paths.
+ */
+export declare class BrowserBundleService implements BrowserBundleExecutor {
+    private readonly appConfig;
+    /**
+     * Creates the browser bundle boundary for one finalized app instance.
+     */
+    constructor(appConfig: EcoPagesAppConfig);
+    /**
+     * Runs one browser-targeted build through the app-owned executor.
+     *
+     * @remarks
+     * Browser defaults and app-owned browser build plugins are applied here so HMR
+     * and runtime asset generation do not have to recreate that policy at each call
+     * site.
+     */
+    bundle(options: BrowserBundleOptions): Promise<BuildResult>;
+}

package/src/services/assets/browser-bundle.service.js

@@ -0,0 +1,33 @@
+import { getAppBrowserBuildPlugins, getAppBuildExecutor, getAppTranspileOptions } from "../../build/build-adapter.js";
+import { mergeEcoBuildPlugins } from "../../build/build-manifest.js";
+class BrowserBundleService {
+  appConfig;
+  /**
+   * Creates the browser bundle boundary for one finalized app instance.
+   */
+  constructor(appConfig) {
+    this.appConfig = appConfig;
+  }
+  /**
+   * Runs one browser-targeted build through the app-owned executor.
+   *
+   * @remarks
+   * Browser defaults and app-owned browser build plugins are applied here so HMR
+   * and runtime asset generation do not have to recreate that policy at each call
+   * site.
+   */
+  async bundle(options) {
+    const { profile, ...rawBuildOptions } = options;
+    const buildOptions = rawBuildOptions;
+    const plugins = buildOptions.plugins;
+    const request = {
+      ...buildOptions,
+      ...getAppTranspileOptions(this.appConfig, profile),
+      plugins: mergeEcoBuildPlugins(plugins, getAppBrowserBuildPlugins(this.appConfig))
+    };
+    return await getAppBuildExecutor(this.appConfig).build(request);
+  }
+}
+export {
+  BrowserBundleService
+};

package/src/services/{page-request-cache-coordinator.service.d.ts → cache/page-request-cache-coordinator.service.d.ts}

@@ -1,5 +1,5 @@
-import { type PageCacheService } from './cache/page-cache-service.js';
-import type { CacheStrategy, RenderResult } from './cache/cache.types.js';
+import { type PageCacheService } from './page-cache-service.js';
+import type { CacheStrategy, RenderResult } from './cache.types.js';
 /**
  * Coordinates request-time page caching concerns around one render invocation.
  *

package/src/services/{page-request-cache-coordinator.service.js → cache/page-request-cache-coordinator.service.js}

@@ -1,5 +1,7 @@
-import { getCacheControlHeader } from "./cache/page-cache-service.js";
+import { getCacheControlHeader } from "./page-cache-service.js";
 class PageRequestCacheCoordinator {
+  cacheService;
+  defaultCacheStrategy;
   constructor(cacheService, defaultCacheStrategy) {
     this.cacheService = cacheService;
     this.defaultCacheStrategy = defaultCacheStrategy;

package/src/services/html/html-rewriter-provider.service.d.ts

@@ -0,0 +1,37 @@
+export type HtmlRewriterElement = {
+    append(content: string, options?: {
+        html?: boolean;
+    }): void;
+};
+export type HtmlRewriterRuntime = {
+    on(selector: 'head' | 'body', handler: {
+        element: (element: HtmlRewriterElement) => void;
+    }): HtmlRewriterRuntime;
+    transform(response: Response): Response;
+};
+export type HtmlRewriterConstructor = new () => HtmlRewriterRuntime;
+export type HtmlRewriterMode = 'auto' | 'native' | 'worker-tools' | 'fallback';
+export interface HtmlRewriterProvider {
+    createHtmlRewriter(): Promise<HtmlRewriterRuntime | null>;
+    setMode(mode: HtmlRewriterMode): void;
+}
+export interface HtmlRewriterLogger {
+    warn(message: string): void;
+}
+export interface DefaultHtmlRewriterProviderOptions {
+    mode?: HtmlRewriterMode;
+    logger?: HtmlRewriterLogger;
+    getNativeHtmlRewriter?: () => HtmlRewriterConstructor | undefined;
+    loadWorkerToolsHtmlRewriter?: () => Promise<HtmlRewriterConstructor | null>;
+}
+export declare class DefaultHtmlRewriterProvider implements HtmlRewriterProvider {
+    private htmlRewriterConstructorPromise?;
+    private htmlRewriterMode;
+    private logger;
+    private getNativeHtmlRewriter;
+    private loadWorkerToolsHtmlRewriter;
+    constructor(options?: DefaultHtmlRewriterProviderOptions);
+    setMode(mode: HtmlRewriterMode): void;
+    createHtmlRewriter(): Promise<HtmlRewriterRuntime | null>;
+    private resolveHtmlRewriterConstructor;
+}

package/src/services/html/html-rewriter-provider.service.js

@@ -0,0 +1,68 @@
+import { appLogger } from "../../global/app-logger.js";
+class DefaultHtmlRewriterProvider {
+  htmlRewriterConstructorPromise;
+  htmlRewriterMode;
+  logger;
+  getNativeHtmlRewriter;
+  loadWorkerToolsHtmlRewriter;
+  constructor(options = {}) {
+    this.htmlRewriterMode = options.mode ?? "auto";
+    this.logger = options.logger ?? appLogger;
+    this.getNativeHtmlRewriter = options.getNativeHtmlRewriter ?? (() => globalThis.HTMLRewriter);
+    this.loadWorkerToolsHtmlRewriter = options.loadWorkerToolsHtmlRewriter ?? loadWorkerToolsHtmlRewriter;
+  }
+  setMode(mode) {
+    this.htmlRewriterMode = mode;
+    this.htmlRewriterConstructorPromise = void 0;
+  }
+  async createHtmlRewriter() {
+    const RuntimeHtmlRewriter = await this.resolveHtmlRewriterConstructor();
+    return RuntimeHtmlRewriter ? new RuntimeHtmlRewriter() : null;
+  }
+  async resolveHtmlRewriterConstructor() {
+    if (!this.htmlRewriterConstructorPromise) {
+      const mode = this.htmlRewriterMode;
+      const RuntimeHtmlRewriter = this.getNativeHtmlRewriter();
+      if (mode === "fallback") {
+        this.htmlRewriterConstructorPromise = Promise.resolve(null);
+      } else if (mode === "native") {
+        if (RuntimeHtmlRewriter) {
+          this.htmlRewriterConstructorPromise = Promise.resolve(RuntimeHtmlRewriter);
+        } else {
+          this.logger.warn(
+            "[HtmlTransformerService] Native HTMLRewriter was forced but is unavailable, falling back to string injection."
+          );
+          this.htmlRewriterConstructorPromise = Promise.resolve(null);
+        }
+      } else if (mode === "auto" && RuntimeHtmlRewriter) {
+        this.htmlRewriterConstructorPromise = Promise.resolve(RuntimeHtmlRewriter);
+      } else {
+        this.htmlRewriterConstructorPromise = this.loadWorkerToolsHtmlRewriter();
+      }
+    }
+    return this.htmlRewriterConstructorPromise;
+  }
+}
+async function loadWorkerToolsHtmlRewriter() {
+  try {
+    const module = await import("@worker-tools/html-rewriter/base64");
+    return module.HTMLRewriter;
+  } catch (primaryError) {
+    try {
+      const runtimeLocalModule = await import(
+        /* @vite-ignore */
+        new URL("../node_modules/@worker-tools/html-rewriter/base64.js", import.meta.url).href
+      );
+      return runtimeLocalModule.HTMLRewriter;
+    } catch {
+      const message = primaryError instanceof Error ? primaryError.message : String(primaryError);
+      appLogger.warn(
+        `[HtmlTransformerService] Failed to load @worker-tools/html-rewriter/base64, falling back to string injection: ${message}`
+      );
+      return null;
+    }
+  }
+}
+export {
+  DefaultHtmlRewriterProvider
+};

package/src/services/html/html-transformer.service.d.ts

@@ -0,0 +1,77 @@
+import type { ProcessedAsset } from '../assets/asset-processing-service/assets.types.js';
+import { type HtmlRewriterMode, type HtmlRewriterProvider } from './html-rewriter-provider.service.js';
+export interface HtmlTransformerServiceOptions {
+    htmlRewriterMode?: HtmlRewriterMode;
+    htmlRewriterProvider?: HtmlRewriterProvider;
+}
+export declare class HtmlTransformerService {
+    private processedDependencies;
+    private htmlRewriterProvider;
+    constructor(options?: HtmlTransformerServiceOptions);
+    /**
+     * Overrides the HTML rewriter runtime selection.
+     *
+     * This is intended for internal/runtime tests that need deterministic
+     * selection between native, worker-tools, and string fallback behavior.
+     *
+     * @param mode Requested runtime selection strategy.
+     */
+    setHtmlRewriterMode(mode: HtmlRewriterMode): void;
+    private formatAttributes;
+    private generateScriptTag;
+    private generateStylesheetTag;
+    private appendDependencies;
+    private buildDependencyTags;
+    /**
+     * Injects generated markup immediately before the closing HTML tag when it is
+     * present, or appends/prepends a fallback insertion otherwise.
+     */
+    private injectBeforeClosingTag;
+    /**
+     * Replaces the current processed dependency set used during HTML finalization.
+     */
+    setProcessedDependencies(processedDependencies: ProcessedAsset[]): void;
+    /**
+     * Returns the processed dependencies queued for the next transform pass.
+     */
+    getProcessedDependencies(): ProcessedAsset[];
+    /**
+     * Applies attributes to the opening `<html>` tag when present.
+     */
+    applyAttributesToHtmlElement(html: string, attributes: Record<string, string>): string;
+    /**
+     * Applies attributes to the first element nested directly under `<body>`.
+     */
+    applyAttributesToFirstBodyElement(html: string, attributes: Record<string, string>): string;
+    /**
+     * Applies attributes to the first element in a fragment or full-document HTML
+     * string.
+     */
+    applyAttributesToFirstElement(html: string, attributes: Record<string, string>): string;
+    /**
+     * Removes duplicate processed assets while preserving first-seen order.
+     *
+     * @remarks
+     * Dedupe keys include structural asset fields and HTML attributes so repeated
+     * orchestration passes can merge assets safely without collapsing distinct tag
+     * variants.
+     */
+    dedupeProcessedAssets(assets: ProcessedAsset[]): ProcessedAsset[];
+    /**
+     * Injects the currently processed dependencies into an HTML response.
+     *
+     * @remarks
+     * Native or worker-tools HTML rewriter support is preferred when available. A
+     * string-based fallback remains in place for runtimes that cannot provide one
+     * of those rewriter implementations.
+     */
+    transform(res: Response): Promise<Response>;
+    /**
+     * Splits processed assets into head and body injection groups.
+     */
+    private groupDependenciesByPosition;
+    /**
+     * Builds a serialized HTML attribute string from an attribute object.
+     */
+    private buildAttributeString;
+}