@ecopages/core 0.2.0-beta.26 → 0.2.0-beta.28

package/src/watchers/project-watcher.js

@@ -5,6 +5,8 @@ import { appLogger } from "../global/app-logger.js";
 import {
   DevelopmentInvalidationService
 } from "../services/invalidation/development-invalidation.service.js";
+import { prepareHmrFileChange } from "../hmr/hmr-file-change-prep.js";
+import { getAppPageBrowserGraphSession } from "../route-renderer/orchestration/page-browser-graph/page-browser-graph-session.js";
 import { isRegisteredScriptEntrypoint } from "../hmr/hmr-entrypoint-output.js";
 import { resolveInternalExecutionDir } from "../utils/resolve-work-dir.js";
 import { createProjectWatcherIgnorePredicate } from "./project-watcher-ignore.js";
@@ -150,6 +152,10 @@ class ProjectWatcher {
       }
       this.uncacheModules();
       const resolvedFilePath = path.resolve(filePath);
+      const graphPreparation = this.hmrManager.isEnabled() ? prepareHmrFileChange(this.appConfig, resolvedFilePath) : void 0;
+      if (plan.refreshRoutes && (event === "unlink" || event === "add")) {
+        getAppPageBrowserGraphSession(this.appConfig).invalidateByRouteFile(resolvedFilePath);
+      }
       const isRegisteredScriptEdit = isRegisteredScriptEntrypoint(
         this.hmrManager.getWatchedFiles(),
         resolvedFilePath
@@ -167,7 +173,9 @@ class ProjectWatcher {
       const deferProcessorNotifications = plan.category === "include-source" || plan.category === "explicit-server-view" || isRegisteredScriptEdit;
       if (deferProcessorNotifications && plan.delegateToHmr) {
         await this.prewarmBeforeHmr(resolvedFilePath, plan);
-        await this.hmrManager.handleFileChange(filePath);
+        await this.hmrManager.handleFileChange(filePath, {
+          graphIdentities: graphPreparation?.affectedGraphIdentities
+        });
         await this.notifyProcessors(filePath, event);
         return;
       }
@@ -176,7 +184,9 @@ class ProjectWatcher {
         return;
       }
       if (plan.delegateToHmr) {
-        await this.hmrManager.handleFileChange(filePath);
+        await this.hmrManager.handleFileChange(filePath, {
+          graphIdentities: graphPreparation?.affectedGraphIdentities
+        });
       }
     } catch (error) {
       if (error instanceof Error) {
@@ -265,9 +275,9 @@ class ProjectWatcher {
     return this.invalidationService.matchesAdditionalWatchPaths(filePath);
   }
   /**
-   * Checks if a file is handled by a processor.
-   * Processors that declare asset capabilities own those file types.
-   * Processors without capabilities fall back to checking watch extensions.
+   * Checks if a file is owned by a processor as an asset input.
+   * Ownership requires declared asset capabilities; watch config only drives
+   * {@link notifyProcessors} notifications.
    */
   isHandledByProcessor(filePath) {
     return this.invalidationService.isProcessorOwnedAsset(filePath);

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/deduping-build-executor.js

@@ -1,56 +0,0 @@
-import path from "node:path";
-import { createJsxCacheKey, createPluginCacheKey } from "../services/module-loading/route-module-build-manifest.js";
-function createBuildOptionsDedupeKey(options) {
-  return [
-    normalizeEntrypoints(options.entrypoints),
-    options.root ? path.resolve(options.root) : "root:default",
-    options.outdir ? path.resolve(options.outdir) : "outdir:default",
-    options.splitting ?? "splitting:default",
-    options.externalPackages ?? "externalPackages:default",
-    options.target ?? "target:default",
-    options.format ?? "format:default",
-    options.sourcemap ?? "sourcemap:default",
-    options.minify ?? "minify:default",
-    options.treeshaking ?? "treeshaking:default",
-    options.naming ?? "naming:default",
-    createJsxCacheKey(options.jsx),
-    createPluginCacheKey(options.plugins)
-  ].join("::");
-}
-function normalizeEntrypoints(entrypoints) {
-  if (Array.isArray(entrypoints)) {
-    return entrypoints.map((entrypoint) => path.resolve(entrypoint)).sort().join("|");
-  }
-  return Object.entries(entrypoints).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}:${path.resolve(value)}`).join("|");
-}
-class DedupingBuildExecutor {
-  inner;
-  inFlight = /* @__PURE__ */ new Map();
-  constructor(inner) {
-    this.inner = inner;
-  }
-  build(options) {
-    const key = createBuildOptionsDedupeKey(options);
-    const existing = this.inFlight.get(key);
-    if (existing) {
-      return existing;
-    }
-    const buildPromise = this.inner.build(options).finally(() => {
-      if (this.inFlight.get(key) === buildPromise) {
-        this.inFlight.delete(key);
-      }
-    });
-    this.inFlight.set(key, buildPromise);
-    return buildPromise;
-  }
-  unwrap() {
-    return this.inner;
-  }
-  getInFlightCountForTests() {
-    return this.inFlight.size;
-  }
-}
-export {
-  DedupingBuildExecutor,
-  createBuildOptionsDedupeKey
-};

package/src/build/runtime-build-executor.d.ts

@@ -1,14 +0,0 @@
-import type { EcoPagesAppConfig } from '../types/internal-types.js';
-import type { BuildExecutor } from './build-adapter.js';
-export type { BuildProfile, BuildRuntime } from './build-runtime.js';
-export { disposeAppBuildRuntime, getBuildRuntime, installBuildRuntime, requireBuildRuntime } from './build-runtime.js';
-/**
- * Installs the app-owned runtime build executors for one app instance.
- *
- * @remarks
- * Delegates to {@link installBuildRuntime}. Route-module and HMR browser builds
- * use parallel one-shot Rolldown. Server-entry bundling stays serialized
- * single-flight.
- */
-export declare function installAppRuntimeBuildExecutor(appConfig: EcoPagesAppConfig): BuildExecutor;
-export declare function getInstalledServerEntryBuildExecutor(appConfig: EcoPagesAppConfig): BuildExecutor;

package/src/build/runtime-build-executor.js

@@ -1,16 +0,0 @@
-import { installBuildRuntime, requireBuildRuntime } from "./build-runtime.js";
-import { disposeAppBuildRuntime, getBuildRuntime, installBuildRuntime as installBuildRuntime2, requireBuildRuntime as requireBuildRuntime2 } from "./build-runtime.js";
-function installAppRuntimeBuildExecutor(appConfig) {
-  return installBuildRuntime(appConfig).getProfile("route-module");
-}
-function getInstalledServerEntryBuildExecutor(appConfig) {
-  return requireBuildRuntime(appConfig).getProfile("server-entry");
-}
-export {
-  disposeAppBuildRuntime,
-  getBuildRuntime,
-  getInstalledServerEntryBuildExecutor,
-  installAppRuntimeBuildExecutor,
-  installBuildRuntime2 as installBuildRuntime,
-  requireBuildRuntime2 as requireBuildRuntime
-};

package/src/route-renderer/orchestration/declared-ownership-graph.d.ts

@@ -1 +0,0 @@
-export { mapComponentGraph, mapDeclaredOwnershipGraph, type ComponentGraphRoot, type ComponentGraphWalkInput, type DeclaredOwnershipNodeInput, type DeclaredOwnershipRoot, } from './component-graph.js';

package/src/route-renderer/orchestration/declared-ownership-graph.js

@@ -1,8 +0,0 @@
-import {
-  mapComponentGraph,
-  mapDeclaredOwnershipGraph
-} from "./component-graph.js";
-export {
-  mapComponentGraph,
-  mapDeclaredOwnershipGraph
-};

package/src/route-renderer/orchestration/route-html-finalization.service.js

@@ -1,26 +0,0 @@
-function buildRouteHtmlFinalization(context) {
-  const { renderOptions } = context;
-  const componentRootAttributes = renderOptions.componentRender?.canAttachAttributes && renderOptions.componentRender.rootAttributes && Object.keys(renderOptions.componentRender.rootAttributes).length > 0 ? renderOptions.componentRender.rootAttributes : void 0;
-  const documentAttributes = context.getDocumentAttributes(renderOptions);
-  const htmlContributions = context.getHtmlDocumentContributions({ renderOptions, partial: false });
-  const hasStructuralFinalization = componentRootAttributes && Object.keys(componentRootAttributes).length > 0 || documentAttributes && Object.keys(documentAttributes).length > 0;
-  if (!hasStructuralFinalization && (!htmlContributions || htmlContributions.length === 0)) {
-    return {};
-  }
-  return {
-    htmlContributions,
-    finalizeHtml: (html) => {
-      let renderedHtml = html;
-      if (componentRootAttributes) {
-        renderedHtml = context.applyAttributesToFirstBodyElement(renderedHtml, componentRootAttributes);
-      }
-      if (documentAttributes) {
-        renderedHtml = context.applyAttributesToHtmlElement(renderedHtml, documentAttributes);
-      }
-      return renderedHtml;
-    }
-  };
-}
-export {
-  buildRouteHtmlFinalization
-};

package/src/route-renderer/orchestration/template-serialization.d.ts

@@ -1,38 +0,0 @@
-/**
- * Minimal template-result shape that core can serialize generically.
- *
- * @remarks
- * Core intentionally models only the transport shape used during deferred
- * cross-integration child passing: alternating static string segments plus
- * interpolated runtime values. Concrete runtime markers that identify a given
- * framework's template payload must stay outside core and be registered by the
- * owning integration package.
- */
-export type SerializableTemplateShape = {
-    strings: readonly string[];
-    values?: readonly unknown[];
-};
-/**
- * Integration-owned adapter that teaches core how to serialize one deferred
- * template payload shape.
- *
- * @remarks
- * The separation here is intentional: core owns the HTML serialization logic,
- * but integrations own runtime-shape detection. That keeps package-specific
- * markers such as framework template sentinels out of core while still letting
- * deferred children round-trip through mixed renderer boundaries.
- */
-export type DeferredTemplateSerializer<TTemplate extends SerializableTemplateShape = SerializableTemplateShape> = {
-    matches(value: unknown): value is TTemplate;
-    serialize(template: TTemplate, serializeValue: (value: unknown) => string | undefined): string;
-};
-/**
- * Serializes a generic template shape into HTML.
- *
- * @remarks
- * This handles only HTML reconstruction semantics: quoted attribute values,
- * boolean attributes, and omission of client-only event or property bindings.
- * It does not decide whether an arbitrary value belongs to a framework-specific
- * template runtime; integrations must make that decision before delegating here.
- */
-export declare function serializeTemplateShape(template: SerializableTemplateShape, serializeValue: (value: unknown) => string | undefined): string;

package/src/route-renderer/orchestration/template-serialization.js

@@ -1,45 +0,0 @@
-import { escapeHtmlAttribute } from "../../utils/html-escaping.js";
-const ATTRIBUTE_TAIL_PATTERN = /(\s+)([@.?!]?)([^\s"'<>/=`@.?!]+)=$/;
-function getSerializableTemplateAttribute(stringPart) {
-  const match = ATTRIBUTE_TAIL_PATTERN.exec(stringPart);
-  if (!match) return void 0;
-  return {
-    leading: stringPart.slice(0, match.index),
-    whitespace: match[1],
-    prefix: match[2],
-    name: match[3]
-  };
-}
-function serializeTemplateShape(template, serializeValue) {
-  const values = template.values ?? [];
-  let html = "";
-  for (let index = 0; index < values.length; index += 1) {
-    const stringPart = template.strings[index] ?? "";
-    const serializedValue = serializeValue(values[index]);
-    const attribute = getSerializableTemplateAttribute(stringPart);
-    if (!attribute) {
-      html += stringPart;
-      html += serializedValue ?? "";
-      continue;
-    }
-    html += attribute.leading;
-    if (attribute.prefix === "@" || attribute.prefix === "!" || attribute.prefix === ".") {
-      continue;
-    }
-    if (attribute.prefix === "?") {
-      if (serializedValue) {
-        html += `${attribute.whitespace}${attribute.name}`;
-      }
-      continue;
-    }
-    if (serializedValue === void 0) {
-      continue;
-    }
-    html += `${attribute.whitespace}${attribute.name}="${escapeHtmlAttribute(serializedValue)}"`;
-  }
-  html += template.strings[values.length] ?? "";
-  return html;
-}
-export {
-  serializeTemplateShape
-};