@ecopages/core 0.2.0-beta.4 → 0.2.0-beta.40

package/src/types/internal-types.d.ts

@@ -1,18 +1,23 @@
-import type { EcoBuildPlugin } from '../build/build-types.js';
-import type { AppBuildManifest } from '../build/build-manifest.js';
-import type { BuildAdapter, BuildExecutor, BuildOwnership } from '../build/build-adapter.js';
+import type { EcoBuildPlugin } from '../build/contracts/build-types.js';
+import type { AppBuildManifest } from '../build/contracts/build-manifest.js';
+import type { BuildAdapter, BuildOwnership } from '../build/build-adapter.js';
+import type { BuildRuntime } from '../build/runtime/build-runtime.js';
 import type { AnyIntegrationPlugin } from '../plugins/integration-plugin.js';
 import type { Processor } from '../plugins/processor.js';
 import type { EcoSourceTransform } from '../plugins/source-transform.js';
-import type { PageMetadataProps } from './public-types.js';
+import type { PageMetadataProps, SitemapConfig } from './public-types.js';
 import type { RouteRegistry } from '../router/server/route-registry.js';
 import type { CacheConfig } from '../services/cache/cache.types.js';
 import type { DevGraphService } from '../services/runtime-state/dev-graph.service.js';
 import type { AppModuleLoader } from '../services/module-loading/app-module-loader.service.js';
 import type { SourceModuleLoader } from '../services/module-loading/module-loading-types.js';
 import type { EntrypointDependencyGraph } from '../services/runtime-state/entrypoint-dependency-graph.service.js';
+import type { SessionPageBrowserGraphCache } from '../route-renderer/orchestration/page-browser-graph/page-browser-graph-session.js';
 import type { ServerInvalidationState } from '../services/runtime-state/server-invalidation-state.service.js';
 import type { ServerModuleTranspiler } from '../services/module-loading/server-module-transpiler.service.js';
+import type { RouteModuleBuildCache } from '../services/module-loading/route-module-build-cache.store.js';
+/** Integration hook for registered `dependencies.scripts` entrypoint changes in dev. */
+export type RegisteredScriptEntrypointChangeHandler = (filePath: string) => void | boolean | Promise<void | boolean>;
 export interface RobotsPreference {
     /**
      * The user agent
@@ -94,8 +99,18 @@ export type EcoPagesAppConfig = {
          */
         preferences: RobotsPreference;
     };
+    /**
+     * Automatic sitemap.xml generation during static export.
+     *
+     * @default { enabled: false, fileName: 'sitemap.xml', extraUrls: [], exclude: [] }
+     */
+    sitemap: SitemapConfig;
     /** Additional paths to watch. Use this to monitor extra files. It is relative to the rootDir */
     additionalWatchPaths: string[];
+    /** Static paths to SSR-prewarm in development before user navigation. */
+    devPrewarmPaths?: string[];
+    /** Static paths to SSR-prewarm before the development server reports ready. */
+    devPrewarmBeforeReadyPaths?: string[];
     /**
      * @default { title: 'Ecopages', description: 'Ecopages' }
      */
@@ -118,6 +133,7 @@ export type EcoPagesAppConfig = {
         srcDir: string;
         htmlTemplatePath: string;
         error404TemplatePath: string;
+        error500TemplatePath: string;
     };
     /**
      * The processors to be used in the app
@@ -149,13 +165,50 @@ export type EcoPagesAppConfig = {
         buildOwnership?: BuildOwnership;
         buildAdapter?: BuildAdapter;
         buildManifest?: AppBuildManifest;
-        buildExecutor?: BuildExecutor;
         devGraphService?: DevGraphService;
         entrypointDependencyGraph?: EntrypointDependencyGraph;
+        pageBrowserGraphSession?: SessionPageBrowserGraphCache;
         hostModuleLoader?: SourceModuleLoader;
         rendererModuleContext?: unknown;
         serverInvalidationState?: ServerInvalidationState;
         serverModuleTranspiler?: ServerModuleTranspiler;
+        routeModuleBuildCaches?: Map<string, RouteModuleBuildCache>;
+        /** Profile-based build runtime installed by {@link installBuildRuntime}. */
+        buildRuntime?: BuildRuntime;
+        /** Set after {@link setupAppRuntimePlugins} runs processor/integration setup once per process. */
+        runtimeAssetsPrepared?: boolean;
+        /** Registers integration runtime plugins when lazy activation completes. */
+        onRuntimePlugin?: (plugin: import('../build/contracts/build-types.js').EcoBuildPlugin) => void;
+        /**
+         * In-flight or completed lazy integration activation promises, keyed by integration name.
+         *
+         * @remarks
+         * Concurrent callers (background prewarm + first render) share the same promise.
+         * Failed activations are removed so a later caller can retry.
+         */
+        integrationActivations?: Map<string, Promise<void>>;
+        /** When `'host'`, the embedded dev server owns browser dev-client bootstrap. */
+        devClientOwner?: 'core' | 'host';
+        /** Integration hooks run when a registered `dependencies.scripts` entrypoint changes. */
+        registeredScriptEntrypointChangeHandlers?: RegisteredScriptEntrypointChangeHandler[];
+    };
+    /**
+     * Development-only in-browser toolbar configuration.
+     */
+    devToolbar?: {
+        /**
+         * Whether the dev toolbar is enabled during watch mode.
+         *
+         * @default true when `package` is configured
+         */
+        enabled?: boolean;
+        /**
+         * Client package resolved from the application project and bundled to
+         * `/_dev_toolbar.js` during watch mode.
+         *
+         * @example '@ecopages/dev-toolbar'
+         */
+        package?: string;
     };
     /**
      * Experimental features.
@@ -222,11 +275,4 @@ export interface EcoPagesFileSystemServerAdapter<ServerInstanceOptions = unknown
         server: unknown;
     }>;
 }
-export interface ProcessorPlugin {
-    name: string;
-    description?: string;
-    setup(): Promise<void>;
-    process<T = unknown>(input: T): Promise<T>;
-    teardown?(): Promise<void>;
-}
-export type { ClientBridgeEvent, DefaultHmrContext, IHmrManager, IClientBridge } from './public-types.js';
+export type { ClientBridgeEvent, DefaultHmrContext, HmrFileChangeOptions, IHmrManager, IClientBridge, } from './public-types.js';

package/src/types/internal-types.js

@@ -0,0 +1 @@
+export {};