@ecopages/core 0.2.0-beta.3 → 0.2.0-beta.31

package/src/adapters/shared/server-static-builder.js

@@ -1,162 +0,0 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import { DEFAULT_ECOPAGES_HOSTNAME, DEFAULT_ECOPAGES_PORT } from "../../config/constants.js";
-import { StaticContentServer } from "../../dev/sc-server.js";
-import { appLogger } from "../../global/app-logger.js";
-import { getAppBuildAdapter } from "../../build/build-adapter.js";
-import { resolveEntryFile, SERVER_BUNDLE_DIR, SERVER_BUNDLE_FILENAME } from "../../utils/resolve-entry-file.js";
-class ServerStaticBuilder {
-  appConfig;
-  staticSiteGenerator;
-  serveOptions;
-  apiHandlers;
-  logger;
-  previewServerFactory;
-  entryFile;
-  constructor({
-    appConfig,
-    staticSiteGenerator,
-    serveOptions,
-    apiHandlers,
-    logger,
-    previewServerFactory,
-    entryFile
-  }) {
-    this.appConfig = appConfig;
-    this.staticSiteGenerator = staticSiteGenerator;
-    this.serveOptions = serveOptions;
-    this.apiHandlers = apiHandlers ?? [];
-    this.logger = logger ?? appLogger;
-    this.previewServerFactory = previewServerFactory ?? StaticContentServer;
-    this.entryFile = resolveEntryFile({ entryFile });
-  }
-  warnApiHandlersUnavailableInStaticMode() {
-    if (this.apiHandlers.length === 0) {
-      return;
-    }
-    const uniqueHandlers = Array.from(
-      new Set(this.apiHandlers.map((handler) => `${handler.method} ${handler.path}`))
-    );
-    const visibleHandlers = uniqueHandlers.slice(0, 5).join(", ");
-    const remainingCount = uniqueHandlers.length - Math.min(uniqueHandlers.length, 5);
-    const summary = remainingCount > 0 ? `${visibleHandlers}, +${remainingCount} more` : visibleHandlers;
-    this.logger.warn(
-      "Registered API endpoints are not available in static build or preview modes because no server runtime is started. They are excluded from the generated output.\n",
-      `\u27A4 ${summary}`
-    );
-  }
-  prepareExportDirectory() {
-    const exportDir = this.appConfig.absolutePaths?.distDir ?? path.join(this.appConfig.rootDir, this.appConfig.distDir);
-    fileSystem.ensureDir(exportDir, true);
-    const srcPublicDir = path.join(
-      this.appConfig.rootDir,
-      this.appConfig.srcDir ?? "src",
-      this.appConfig.publicDir ?? "public"
-    );
-    if (fileSystem.exists(srcPublicDir)) {
-      fileSystem.copyDir(srcPublicDir, exportDir);
-    }
-  }
-  async refreshRuntimeAssets() {
-    for (const processor of this.appConfig.processors.values()) {
-      await processor.setup();
-    }
-    for (const integration of this.appConfig.integrations) {
-      await integration.setup();
-    }
-  }
-  /**
-   * Bundles the server entry file for production use.
-   *
-   * @remarks
-   * When the project has API endpoints, the entry file must be bundled
-   * into a single JS file so the production server can start without
-   * on-the-fly TypeScript transpilation. The bundle is output to
-   * `dist/{SERVER_BUNDLE_DIR}/{SERVER_BUNDLE_FILENAME}` and used by
-   * `ecopages start` in production.
-   *
-   * Package imports remain external so native addons and runtime-owned
-   * dependencies continue to load through the app's installed
-   * `node_modules` tree. Only the app entry graph is bundled.
-   *
-   * Skips silently when no API endpoints are registered (static-only site).
-   * Throws if the build adapter is unavailable, is owned by a host
-   * runtime, or bundling fails.
-   *
-   * @throws If the build adapter is unavailable, is host-owned, or bundling fails.
-   */
-  async bundleServerEntry() {
-    if (this.apiHandlers.length === 0) {
-      return;
-    }
-    const buildAdapter = getAppBuildAdapter(this.appConfig);
-    if (buildAdapter.ownership === "vite-host") {
-      throw new Error(
-        'Cannot bundle the server entry file: build ownership is "vite-host". The host runtime is expected to produce its own server bundle.'
-      );
-    }
-    const entryPath = path.isAbsolute(this.entryFile) ? this.entryFile : path.join(this.appConfig.rootDir, this.entryFile);
-    if (!fileSystem.exists(entryPath)) {
-      throw new Error(
-        `Cannot bundle server entry: file "${this.entryFile}" not found in "${this.appConfig.rootDir}".`
-      );
-    }
-    const distDir = this.appConfig.absolutePaths?.distDir ?? path.join(this.appConfig.rootDir, this.appConfig.distDir);
-    const serverOutdir = path.join(distDir, SERVER_BUNDLE_DIR);
-    this.logger.info("Bundling server entry file...");
-    const result = await buildAdapter.build({
-      entrypoints: [entryPath],
-      outdir: serverOutdir,
-      naming: SERVER_BUNDLE_FILENAME,
-      target: "node",
-      format: "esm",
-      sourcemap: "hidden",
-      externalPackages: true,
-      root: this.appConfig.rootDir
-    });
-    if (!result.success) {
-      const errorMessages = result.logs.map((log) => log.message).join("\n");
-      throw new Error(`Failed to bundle server entry file:
-${errorMessages}`);
-    }
-    this.logger.info("Server entry file bundled successfully");
-  }
-  /**
-   * Generates a static build of the site for deployment.
-   * @param options.preview - If true, starts a preview server after build
-   * @param dependencies.router - The initialized router
-   * @param dependencies.routeRendererFactory - The route renderer factory
-   * @param dependencies.staticRoutes - Explicit static routes registered via app.static()
-   */
-  async build(options, dependencies) {
-    const { preview = false, baseUrl: explicitBaseUrl } = options ?? {};
-    const baseUrl = explicitBaseUrl ?? `http://${this.serveOptions.hostname || DEFAULT_ECOPAGES_HOSTNAME}:${this.serveOptions.port || DEFAULT_ECOPAGES_PORT}`;
-    this.warnApiHandlersUnavailableInStaticMode();
-    this.prepareExportDirectory();
-    await this.refreshRuntimeAssets();
-    await this.bundleServerEntry();
-    await this.staticSiteGenerator.run({
-      router: dependencies.router,
-      baseUrl,
-      routeRendererFactory: dependencies.routeRendererFactory,
-      staticRoutes: dependencies.staticRoutes
-    });
-    if (!preview) {
-      this.logger.info("Build completed");
-      return;
-    }
-    const previewPort = this.serveOptions.port || DEFAULT_ECOPAGES_PORT;
-    const { server } = this.previewServerFactory.createServer({
-      appConfig: this.appConfig,
-      options: { port: Number(previewPort) }
-    });
-    if (server?.port) {
-      this.logger.info(`Preview running at http://localhost:${server.port}`);
-    } else {
-      this.logger.error("Failed to start preview server");
-    }
-  }
-}
-export {
-  ServerStaticBuilder
-};

package/src/adapters/shared/shared-hmr-manager.d.ts

@@ -1,59 +0,0 @@
-import fs from 'node:fs';
-import type { DefaultHmrContext, EcoPagesAppConfig, IHmrManager, IClientBridge } from '../../types/internal-types.js';
-import type { EcoBuildPlugin } from '../../build/build-types.js';
-import { type HmrStrategy } from '../../hmr/hmr-strategy.js';
-import type { ClientBridgeEvent } from '../../types/public-types.js';
-import { HmrEntrypointRegistrar } from './hmr-entrypoint-registrar.js';
-import { BrowserBundleService } from '../../services/assets/browser-bundle.service.js';
-import { type EntrypointDependencyGraph } from '../../services/runtime-state/entrypoint-dependency-graph.service.js';
-import type { ServerModuleTranspiler } from '../../services/module-loading/server-module-transpiler.service.js';
-type HandleFileChangeOptions = {
-    broadcast?: boolean;
-};
-type SharedHmrManagerParams = {
-    appConfig: EcoPagesAppConfig;
-    bridge: IClientBridge;
-    registrationTimeoutMs?: number;
-};
-export declare abstract class SharedHmrManager implements IHmrManager {
-    readonly appConfig: EcoPagesAppConfig;
-    protected readonly bridge: IClientBridge;
-    protected watchers: Map<string, fs.FSWatcher>;
-    protected watchedFiles: Map<string, string>;
-    protected entrypointRegistrations: Map<string, Promise<string>>;
-    protected distDir: string;
-    protected plugins: EcoBuildPlugin[];
-    protected enabled: boolean;
-    protected strategies: HmrStrategy[];
-    protected readonly entrypointRegistrar: HmrEntrypointRegistrar;
-    protected readonly browserBundleService: BrowserBundleService;
-    protected readonly entrypointDependencyGraph: EntrypointDependencyGraph;
-    protected readonly serverModuleTranspiler: ServerModuleTranspiler;
-    constructor({ appConfig, bridge, registrationTimeoutMs }: SharedHmrManagerParams);
-    protected abstract createEntrypointDependencyGraph(existingEntrypointDependencyGraph: EntrypointDependencyGraph): EntrypointDependencyGraph;
-    protected shouldSkipMissingFileChange(_filePath: string): boolean;
-    protected onRuntimeBundleFailure(error: unknown): void;
-    protected ensureDistDir(): void;
-    protected shouldJsStrategyProcessEntrypoint(entrypointPath: string): boolean;
-    protected initializeStrategies(): void;
-    registerStrategy(strategy: HmrStrategy): void;
-    setPlugins(plugins: EcoBuildPlugin[]): void;
-    setEnabled(enabled: boolean): void;
-    isEnabled(): boolean;
-    buildRuntime(): Promise<void>;
-    getRuntimePath(): string;
-    broadcast(event: ClientBridgeEvent): void;
-    handleFileChange(filePath: string, options?: HandleFileChangeOptions): Promise<void>;
-    getOutputUrl(entrypointPath: string): string | undefined;
-    getWatchedFiles(): Map<string, string>;
-    getDistDir(): string;
-    getPlugins(): EcoBuildPlugin[];
-    getDefaultContext(): DefaultHmrContext;
-    protected clearFailedEntrypointRegistration(entrypointPath: string): void;
-    registerEntrypoint(entrypointPath: string): Promise<string>;
-    registerScriptEntrypoint(entrypointPath: string): Promise<string>;
-    protected emitStrictEntrypoint(entrypointPath: string): Promise<void>;
-    protected emitScriptEntrypoint(entrypointPath: string, outputPath: string): Promise<void>;
-    stop(): void;
-}
-export {};

package/src/adapters/shared/shared-hmr-manager.js

@@ -1,241 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { RESOLVED_ASSETS_DIR } from "../../config/constants.js";
-import { getAppBuildExecutor } from "../../build/build-adapter.js";
-import { fileSystem } from "@ecopages/file-system";
-import { HmrStrategyType } from "../../hmr/hmr-strategy.js";
-import { DefaultHmrStrategy } from "../../hmr/strategies/default-hmr-strategy.js";
-import { JsHmrStrategy } from "../../hmr/strategies/js-hmr-strategy.js";
-import { appLogger } from "../../global/app-logger.js";
-import { HmrEntrypointRegistrar } from "./hmr-entrypoint-registrar.js";
-import { BrowserBundleService } from "../../services/assets/browser-bundle.service.js";
-import { getAppServerModuleTranspiler } from "../../services/module-loading/app-server-module-transpiler.service.js";
-import {
-  getAppEntrypointDependencyGraph,
-  setAppEntrypointDependencyGraph
-} from "../../services/runtime-state/entrypoint-dependency-graph.service.js";
-import { resolveInternalExecutionDir, resolveInternalWorkDir } from "../../utils/resolve-work-dir.js";
-class SharedHmrManager {
-  appConfig;
-  bridge;
-  watchers = /* @__PURE__ */ new Map();
-  watchedFiles = /* @__PURE__ */ new Map();
-  entrypointRegistrations = /* @__PURE__ */ new Map();
-  distDir;
-  plugins = [];
-  enabled = true;
-  strategies = [];
-  entrypointRegistrar;
-  browserBundleService;
-  entrypointDependencyGraph;
-  serverModuleTranspiler;
-  constructor({ appConfig, bridge, registrationTimeoutMs = 4e3 }) {
-    this.appConfig = appConfig;
-    this.bridge = bridge;
-    this.distDir = path.join(resolveInternalWorkDir(this.appConfig), RESOLVED_ASSETS_DIR, "_hmr");
-    this.entrypointRegistrar = new HmrEntrypointRegistrar({
-      srcDir: this.appConfig.absolutePaths.srcDir,
-      distDir: this.distDir,
-      entrypointRegistrations: this.entrypointRegistrations,
-      watchedFiles: this.watchedFiles,
-      clearFailedRegistration: (entrypointPath) => this.clearFailedEntrypointRegistration(entrypointPath),
-      registrationTimeoutMs
-    });
-    this.browserBundleService = new BrowserBundleService(appConfig);
-    this.entrypointDependencyGraph = this.createEntrypointDependencyGraph(
-      getAppEntrypointDependencyGraph(appConfig)
-    );
-    setAppEntrypointDependencyGraph(this.appConfig, this.entrypointDependencyGraph);
-    this.serverModuleTranspiler = getAppServerModuleTranspiler(this.appConfig);
-    this.ensureDistDir();
-    this.initializeStrategies();
-  }
-  shouldSkipMissingFileChange(_filePath) {
-    return false;
-  }
-  onRuntimeBundleFailure(error) {
-    appLogger.error("[HMR] Failed to build runtime script:", error);
-  }
-  ensureDistDir() {
-    fileSystem.ensureDir(this.distDir);
-  }
-  shouldJsStrategyProcessEntrypoint(entrypointPath) {
-    return !this.strategies.some((strategy) => {
-      if (strategy.type !== HmrStrategyType.INTEGRATION || strategy.priority <= HmrStrategyType.SCRIPT) {
-        return false;
-      }
-      try {
-        return strategy.matches(entrypointPath);
-      } catch (error) {
-        appLogger.error(error);
-        return false;
-      }
-    });
-  }
-  initializeStrategies() {
-    const jsContext = {
-      getWatchedFiles: () => this.watchedFiles,
-      getDistDir: () => this.distDir,
-      getPlugins: () => this.plugins,
-      getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-      getPagesDir: () => this.appConfig.absolutePaths.pagesDir,
-      getLayoutsDir: () => this.appConfig.absolutePaths.layoutsDir,
-      getTemplateExtensions: () => this.appConfig.templatesExt,
-      getBrowserBundleService: () => this.browserBundleService,
-      getEntrypointDependencyGraph: () => this.entrypointDependencyGraph,
-      shouldProcessEntrypoint: (entrypointPath) => this.shouldJsStrategyProcessEntrypoint(entrypointPath)
-    };
-    this.strategies = [new JsHmrStrategy(jsContext), new DefaultHmrStrategy()];
-  }
-  registerStrategy(strategy) {
-    this.strategies.push(strategy);
-  }
-  setPlugins(plugins) {
-    this.plugins = [...plugins];
-  }
-  setEnabled(enabled) {
-    this.enabled = enabled;
-  }
-  isEnabled() {
-    return this.enabled;
-  }
-  async buildRuntime() {
-    const runtimeSource = fileURLToPath(import.meta.resolve("@ecopages/core/hmr/client/hmr-runtime"));
-    try {
-      const result = await this.browserBundleService.bundle({
-        profile: "hmr-runtime",
-        entrypoints: [runtimeSource],
-        outdir: this.distDir,
-        naming: "_hmr_runtime.js",
-        minify: false,
-        plugins: this.plugins
-      });
-      if (!result.success) {
-        this.onRuntimeBundleFailure(result.logs);
-      }
-    } catch (error) {
-      this.onRuntimeBundleFailure(error);
-    }
-  }
-  getRuntimePath() {
-    return path.join(this.distDir, "_hmr_runtime.js");
-  }
-  broadcast(event) {
-    appLogger.debug(
-      `[HMR] Broadcasting ${event.type} event, path=${event.path || "all"}, subscribers=${this.bridge.subscriberCount}`
-    );
-    this.bridge.broadcast(event);
-  }
-  async handleFileChange(filePath, options = {}) {
-    if (this.shouldSkipMissingFileChange(filePath) && !fileSystem.exists(filePath)) {
-      appLogger.debug(`[${this.constructor.name}] Skipping missing file change: ${filePath}`);
-      this.clearFailedEntrypointRegistration(filePath);
-      return;
-    }
-    const sorted = [...this.strategies].sort((a, b) => b.priority - a.priority);
-    const strategy = sorted.find((candidate) => {
-      try {
-        return candidate.matches(filePath);
-      } catch (error) {
-        appLogger.error(error);
-        return false;
-      }
-    });
-    if (!strategy) {
-      appLogger.warn(`[HMR] No strategy found for ${filePath}`);
-      return;
-    }
-    appLogger.debug(`[${this.constructor.name}] Selected strategy: ${strategy.constructor.name}`);
-    const action = await strategy.process(filePath);
-    const shouldBroadcast = options.broadcast ?? true;
-    if (shouldBroadcast && action.type === "broadcast" && action.events) {
-      for (const event of action.events) {
-        this.broadcast(event);
-      }
-    }
-  }
-  getOutputUrl(entrypointPath) {
-    return this.watchedFiles.get(entrypointPath);
-  }
-  getWatchedFiles() {
-    return this.watchedFiles;
-  }
-  getDistDir() {
-    return this.distDir;
-  }
-  getPlugins() {
-    return this.plugins;
-  }
-  getDefaultContext() {
-    return {
-      getWatchedFiles: () => this.watchedFiles,
-      getDistDir: () => this.distDir,
-      getPlugins: () => this.plugins,
-      getSrcDir: () => this.appConfig.absolutePaths.srcDir,
-      getLayoutsDir: () => this.appConfig.absolutePaths.layoutsDir,
-      getPagesDir: () => this.appConfig.absolutePaths.pagesDir,
-      getBuildExecutor: () => getAppBuildExecutor(this.appConfig),
-      getBrowserBundleService: () => this.browserBundleService,
-      getEntrypointDependencyGraph: () => this.entrypointDependencyGraph,
-      importServerModule: async (filePath) => await this.serverModuleTranspiler.importModule({
-        filePath,
-        outdir: path.join(resolveInternalExecutionDir(this.appConfig), ".server-modules"),
-        externalPackages: true
-      })
-    };
-  }
-  clearFailedEntrypointRegistration(entrypointPath) {
-    this.watchedFiles.delete(entrypointPath);
-    this.entrypointDependencyGraph.clearEntrypointDependencies(entrypointPath);
-  }
-  async registerEntrypoint(entrypointPath) {
-    return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-      emit: async (normalizedEntrypoint) => await this.emitStrictEntrypoint(normalizedEntrypoint),
-      getMissingOutputError: (normalizedEntrypoint, outputPath) => new Error(
-        `[HMR] Integration failed to emit entrypoint ${normalizedEntrypoint} to ${outputPath}. Page entrypoints must be produced by their owning integration.`
-      )
-    });
-  }
-  async registerScriptEntrypoint(entrypointPath) {
-    return await this.entrypointRegistrar.registerEntrypoint(entrypointPath, {
-      emit: async (normalizedEntrypoint, outputPath) => await this.emitScriptEntrypoint(normalizedEntrypoint, outputPath),
-      getMissingOutputError: (normalizedEntrypoint) => new Error(`[HMR] Failed to register script entrypoint: ${normalizedEntrypoint}`)
-    });
-  }
-  async emitStrictEntrypoint(entrypointPath) {
-    await this.handleFileChange(entrypointPath, { broadcast: false });
-  }
-  async emitScriptEntrypoint(entrypointPath, outputPath) {
-    const naming = path.relative(this.distDir, outputPath).split(path.sep).join("/");
-    const buildResult = await this.browserBundleService.bundle({
-      profile: "hmr-entrypoint",
-      entrypoints: [entrypointPath],
-      outdir: this.distDir,
-      naming,
-      minify: false,
-      plugins: this.plugins
-    });
-    if (!buildResult.success) {
-      appLogger.error(`[HMR] Generic script entrypoint build failed for ${entrypointPath}:`, buildResult.logs);
-      return;
-    }
-    const entrypointDependencies = buildResult.dependencyGraph?.entrypoints?.[entrypointPath];
-    if (entrypointDependencies) {
-      this.entrypointDependencyGraph.setEntrypointDependencies(entrypointPath, entrypointDependencies);
-    }
-  }
-  stop() {
-    this.entrypointRegistrations.clear();
-    for (const watcher of this.watchers.values()) {
-      watcher.close();
-    }
-    this.watchers.clear();
-    this.watchedFiles.clear();
-    this.entrypointDependencyGraph.reset();
-    this.plugins = [];
-  }
-}
-export {
-  SharedHmrManager
-};

package/src/build/build-manifest.d.ts

@@ -1,33 +0,0 @@
-import type { EcoBuildPlugin } from './build-types.js';
-import { type BrowserRuntimeManifest } from './browser-runtime-manifest.js';
-export interface AppBuildManifest {
-    loaderPlugins: EcoBuildPlugin[];
-    runtimePlugins: EcoBuildPlugin[];
-    browserBundlePlugins: EcoBuildPlugin[];
-    browserRuntimeManifest: BrowserRuntimeManifest;
-}
-/**
- * Merges plugin lists while preserving first-registration precedence by name.
- *
- * @remarks
- * Build manifests treat plugin names as stable identities. The first plugin
- * with a given name wins so config-time assembly stays deterministic across
- * loader, runtime, and browser buckets.
- */
-export declare function mergeEcoBuildPlugins(...pluginLists: Array<EcoBuildPlugin[] | undefined>): EcoBuildPlugin[];
-/**
- * Creates one app-owned build manifest from the supplied plugin buckets.
- */
-export declare function createAppBuildManifest(input?: Partial<AppBuildManifest>): AppBuildManifest;
-/**
- * Returns the shared browser runtime asset manifest sealed into the app build manifest.
- */
-export declare function getBrowserRuntimeManifest(manifest: AppBuildManifest): BrowserRuntimeManifest;
-/**
- * Returns the plugin list used for server-oriented builds.
- */
-export declare function getServerBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[];
-/**
- * Returns the plugin list used for browser-oriented builds.
- */
-export declare function getBrowserBuildPlugins(manifest: AppBuildManifest): EcoBuildPlugin[];

package/src/build/rolldown-dev-build-adapter.d.ts

@@ -1,82 +0,0 @@
-/**
- * DevEngine-backed build adapter for cached incremental rebuilds.
- *
- * @remarks
- * Wraps Rolldown's experimental `DevEngine` to provide cached incremental
- * rebuilds. Unlike the standard `RolldownBuildAdapter` which creates a new
- * bundler for every build, this adapter keeps a `DevEngine` instance alive
- * and reuses the internal module graph, resolver cache, and transform cache
- * across builds.
- *
- * The adapter is designed for the HMR rebuild path where the same entrypoints
- * are rebuilt repeatedly with small changes. For one-off production builds,
- * use `RolldownBuildAdapter` instead.
- *
- * The first build creates the engine and runs it. Subsequent builds with the
- * same plugin/target/format triple reuse the cached engine and call
- * `triggerFullBuild()`. The cache key incorporates the context root, plugin
- * names, target, and format; when any of those change, the cached engine is
- * closed and a new one is created.
- *
- * Call `close()` to release the cached engine and free resources.
- *
- * @module
- */
-import type { BuildAdapter, BuildOptions, BuildResult, BuildTranspileOptions, BuildTranspileProfile } from './build-adapter.js';
-/**
- * Build adapter backed by Rolldown's DevEngine for cached incremental rebuilds.
- */
-export declare class RolldownDevBuildAdapter implements BuildAdapter {
-    /**
-     * `'rolldown-dev'` (not `'rolldown'`) so {@link getBuildAdapterOwnership}
-     * round-trips correctly and `createBuildAdapter({ ownership })` can
-     * re-select this class.
-     */
-    readonly ownership: "rolldown-dev";
-    private cachedEngine;
-    private engineInstanceCount;
-    private readonly pendingBuilds;
-    private readonly appRootRequireCache;
-    /**
-     * Stable key over the inputs that affect the engine configuration.
-     * Plugin order is intentionally not part of the key: two plugin
-     * sets with the same names are interchangeable for caching.
-     */
-    private getCacheKey;
-    /**
-     * Returns the cached engine, creating a new one when the cache
-     * key changes. On a cache miss the prior engine is closed and
-     * {@link engineInstanceCount} is incremented.
-     */
-    private getOrCreateEngine;
-    /**
-     * Triggers a build on the cached engine and returns the next
-     * `RolldownOutput` delivered to `onOutput`.
-     *
-     * First call after engine creation invokes `engine.run`; subsequent
-     * calls invoke `engine.triggerFullBuild` and reuse the cached
-     * module graph, resolver, and transform caches.
-     *
-     * If the trigger itself throws, the queued build is removed so
-     * the next `build()` does not consume a stale slot.
-     */
-    private runBuild;
-    /** Throws on error; see {@link build} for the no-throw variant. */
-    buildOrThrow(options: BuildOptions): Promise<BuildResult>;
-    build(options: BuildOptions): Promise<BuildResult>;
-    resolve(importPath: string, rootDir: string): string;
-    getTranspileOptions(profile: BuildTranspileProfile): BuildTranspileOptions;
-    /**
-     * Closes the cached DevEngine and rejects any in-flight builds
-     * with `'DevBuildAdapter closed'`.
-     *
-     * @remarks
-     * Not on the {@link BuildAdapter} interface, so it is only
-     * reachable through the concrete class. The adapter is meant to
-     * live for the process lifetime; this is for explicit teardown.
-     */
-    close(): Promise<void>;
-    /** Test-only: number of engines created over the adapter's lifetime. */
-    getEngineInstanceCountForTests(): number;
-}
-export declare function createRolldownDevBuildAdapter(): RolldownDevBuildAdapter;