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

package/src/eco/lazy-injector-map.js

@@ -1,70 +1,100 @@
+/**
+ * Normalizes a comma-separated scripts string into absolute script URLs.
+ *
+ * @param scripts Comma-separated script paths.
+ * @returns Normalized script path list.
+ */
 function normalizeScripts(scripts) {
-  return scripts.split(",").map((scriptPath) => scriptPath.trim()).filter(Boolean).map((scriptPath) => {
-    if (scriptPath.startsWith("/")) {
-      return scriptPath;
-    }
-    const normalizedRelativePath = scriptPath.replace(/^\/+/, "").replace(/^(\.\/)+/, "");
-    return `/${normalizedRelativePath}`;
-  });
+    return scripts
+        .split(',')
+        .map((scriptPath) => scriptPath.trim())
+        .filter(Boolean)
+        .map((scriptPath) => {
+        if (scriptPath.startsWith('/')) {
+            return scriptPath;
+        }
+        const normalizedRelativePath = scriptPath.replace(/^\/+/, '').replace(/^(\.\/)+/, '');
+        return `/${normalizedRelativePath}`;
+    });
 }
+/**
+ * Deduplicates comma-separated values while preserving first-seen order.
+ *
+ * @param values CSV value list.
+ * @returns A single normalized CSV string.
+ */
 function dedupeCsvValues(values) {
-  const seen = /* @__PURE__ */ new Set();
-  for (const value of values) {
-    for (const token of value.split(",").map((part) => part.trim()).filter(Boolean)) {
-      seen.add(token);
+    const seen = new Set();
+    for (const value of values) {
+        for (const token of value
+            .split(',')
+            .map((part) => part.trim())
+            .filter(Boolean)) {
+            seen.add(token);
+        }
     }
-  }
-  return Array.from(seen).join(",");
+    return Array.from(seen).join(',');
 }
+/**
+ * Builds a scripts-injector map config from resolved lazy script groups.
+ *
+ * @param lazyGroups Lazy script groups resolved during dependency processing.
+ * @returns Injector map config keyed by lazy trigger.
+ */
 function buildInjectorMap(lazyGroups) {
-  const map = {};
-  for (const group of lazyGroups) {
-    const scripts = normalizeScripts(group.scripts);
-    const lazy = group.lazy;
-    if ("on:idle" in lazy) {
-      map["on:idle"] = {
-        scripts: [...map["on:idle"]?.scripts ?? [], ...scripts]
-      };
-      continue;
-    }
-    if ("on:interaction" in lazy) {
-      const currentValue = map["on:interaction"]?.value;
-      const nextValue = lazy["on:interaction"];
-      map["on:interaction"] = {
-        value: typeof currentValue === "string" ? dedupeCsvValues([currentValue, nextValue]) : nextValue,
-        scripts: [...map["on:interaction"]?.scripts ?? [], ...scripts]
-      };
-      continue;
-    }
-    if ("on:visible" in lazy) {
-      const currentValue = map["on:visible"]?.value;
-      const currentThreshold = typeof currentValue === "string" ? currentValue : void 0;
-      const nextValue = lazy["on:visible"];
-      map["on:visible"] = {
-        ...nextValue === true ? currentThreshold ? { value: currentThreshold } : {} : { value: String(nextValue) },
-        scripts: [...map["on:visible"]?.scripts ?? [], ...scripts]
-      };
-      continue;
+    const map = {};
+    for (const group of lazyGroups) {
+        const scripts = normalizeScripts(group.scripts);
+        const lazy = group.lazy;
+        if ('on:idle' in lazy) {
+            map['on:idle'] = {
+                scripts: [...(map['on:idle']?.scripts ?? []), ...scripts],
+            };
+            continue;
+        }
+        if ('on:interaction' in lazy) {
+            const currentValue = map['on:interaction']?.value;
+            const nextValue = lazy['on:interaction'];
+            map['on:interaction'] = {
+                value: typeof currentValue === 'string' ? dedupeCsvValues([currentValue, nextValue]) : nextValue,
+                scripts: [...(map['on:interaction']?.scripts ?? []), ...scripts],
+            };
+            continue;
+        }
+        if ('on:visible' in lazy) {
+            const currentValue = map['on:visible']?.value;
+            const currentThreshold = typeof currentValue === 'string' ? currentValue : undefined;
+            const nextValue = lazy['on:visible'];
+            map['on:visible'] = {
+                ...(nextValue === true
+                    ? currentThreshold
+                        ? { value: currentThreshold }
+                        : {}
+                    : { value: String(nextValue) }),
+                scripts: [...(map['on:visible']?.scripts ?? []), ...scripts],
+            };
+            continue;
+        }
+        throw new Error(`Invalid lazy options: must specify on:idle, on:interaction, or on:visible. Received: ${JSON.stringify(lazy)}`);
     }
-    throw new Error(
-      `Invalid lazy options: must specify on:idle, on:interaction, or on:visible. Received: ${JSON.stringify(lazy)}`
-    );
-  }
-  for (const key of Object.keys(map)) {
-    const scripts = map[key]?.scripts;
-    if (scripts) {
-      map[key] = {
-        ...map[key],
-        scripts: Array.from(new Set(scripts))
-      };
+    for (const key of Object.keys(map)) {
+        const scripts = map[key]?.scripts;
+        if (scripts) {
+            map[key] = {
+                ...map[key],
+                scripts: Array.from(new Set(scripts)),
+            };
+        }
     }
-  }
-  return map;
+    return map;
 }
-function buildInjectorMapScript(lazyGroups) {
-  const map = buildInjectorMap(lazyGroups);
-  return JSON.stringify(map).replace(/<\/script/gi, "<\\/script");
+/**
+ * Creates a safe JSON payload string for `<script type="ecopages/injector-map">`.
+ *
+ * @param lazyGroups Lazy script groups resolved during dependency processing.
+ * @returns Escaped JSON string safe for inline script embedding.
+ */
+export function buildInjectorMapScript(lazyGroups) {
+    const map = buildInjectorMap(lazyGroups);
+    return JSON.stringify(map).replace(/<\/script/gi, '<\\/script');
 }
-export {
-  buildInjectorMapScript
-};

package/src/eco/module-dependencies.js

@@ -1,49 +1,57 @@
 function normalizeImports(imports) {
-  if (!imports || imports.length === 0) {
-    return void 0;
-  }
-  const normalized = Array.from(new Set(imports.map((entry) => entry.trim()).filter((entry) => entry.length > 0)));
-  return normalized.length > 0 ? normalized : void 0;
+    if (!imports || imports.length === 0) {
+        return undefined;
+    }
+    const normalized = Array.from(new Set(imports.map((entry) => entry.trim()).filter((entry) => entry.length > 0)));
+    return normalized.length > 0 ? normalized : undefined;
 }
-function parseModuleDeclaration(value) {
-  const source = value.trim();
-  if (source.length === 0) {
-    throw new Error("Module declaration cannot be empty");
-  }
-  const openBraceIndex = source.indexOf("{");
-  if (openBraceIndex < 0) {
-    return { from: source };
-  }
-  const closeBraceIndex = source.lastIndexOf("}");
-  if (closeBraceIndex !== source.length - 1 || closeBraceIndex <= openBraceIndex) {
-    throw new Error(`Invalid module declaration '${value}'`);
-  }
-  const from = source.slice(0, openBraceIndex).trim();
-  if (from.length === 0) {
-    throw new Error(`Invalid module declaration '${value}'`);
-  }
-  const importsSlice = source.slice(openBraceIndex + 1, closeBraceIndex);
-  const imports = normalizeImports(importsSlice.split(","));
-  return {
-    from,
-    imports
-  };
+/**
+ * Parses a module grammar declaration into normalized object form.
+ *
+ * Supported input examples:
+ * - `react-aria-components`
+ * - `react-aria-components{Table,Select}`
+ */
+export function parseModuleDeclaration(value) {
+    const source = value.trim();
+    if (source.length === 0) {
+        throw new Error('Module declaration cannot be empty');
+    }
+    const openBraceIndex = source.indexOf('{');
+    if (openBraceIndex < 0) {
+        return { from: source };
+    }
+    const closeBraceIndex = source.lastIndexOf('}');
+    if (closeBraceIndex !== source.length - 1 || closeBraceIndex <= openBraceIndex) {
+        throw new Error(`Invalid module declaration '${value}'`);
+    }
+    const from = source.slice(0, openBraceIndex).trim();
+    if (from.length === 0) {
+        throw new Error(`Invalid module declaration '${value}'`);
+    }
+    const importsSlice = source.slice(openBraceIndex + 1, closeBraceIndex);
+    const imports = normalizeImports(importsSlice.split(','));
+    return {
+        from,
+        imports,
+    };
 }
-function normalizeModuleDeclarations(modules) {
-  const declarations = modules ?? [];
-  const output = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const declaration of declarations) {
-    const normalized = parseModuleDeclaration(declaration);
-    const key = `${normalized.from}::${(normalized.imports ?? []).join(",")}`;
-    if (!seen.has(key)) {
-      seen.add(key);
-      output.push(normalized);
+/**
+ * Normalizes and deduplicates module declarations from `modules`.
+ *
+ * Returns canonical object declarations suitable for downstream bundling logic.
+ */
+export function normalizeModuleDeclarations(modules) {
+    const declarations = modules ?? [];
+    const output = [];
+    const seen = new Set();
+    for (const declaration of declarations) {
+        const normalized = parseModuleDeclaration(declaration);
+        const key = `${normalized.from}::${(normalized.imports ?? []).join(',')}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            output.push(normalized);
+        }
     }
-  }
-  return output;
+    return output;
 }
-export {
-  normalizeModuleDeclarations,
-  parseModuleDeclaration
-};

package/src/eco/page-layout-normalization.js

@@ -1,59 +1,69 @@
 function isLayoutSpecObject(spec) {
-  return typeof spec === "object" && spec !== null && "component" in spec;
+    return typeof spec === 'object' && spec !== null && 'component' in spec;
 }
-function normalizePageLayouts(layout) {
-  if (!layout) {
-    return [];
-  }
-  const specs = Array.isArray(layout) ? layout : [layout];
-  return specs.map((spec) => {
-    if (isLayoutSpecObject(spec)) {
-      return {
-        component: spec.component,
-        props: spec.props
-      };
+/**
+ * Normalizes `layout` page options to an outer→inner stack of layout entries.
+ */
+export function normalizePageLayouts(layout) {
+    if (!layout) {
+        return [];
+    }
+    const specs = Array.isArray(layout) ? layout : [layout];
+    return specs.map((spec) => {
+        if (isLayoutSpecObject(spec)) {
+            return {
+                component: spec.component,
+                props: spec.props,
+            };
+        }
+        return {
+            component: spec,
+        };
+    });
+}
+/**
+ * Merges layout components into `dependencies.components` without duplicates.
+ */
+export function mergeLayoutDependencies(dependencies, layoutEntries) {
+    if (layoutEntries.length === 0) {
+        return dependencies;
+    }
+    const mergedComponents = [...(dependencies?.components ?? [])];
+    for (const entry of layoutEntries) {
+        if (!mergedComponents.includes(entry.component)) {
+            mergedComponents.push(entry.component);
+        }
     }
     return {
-      component: spec
+        ...dependencies,
+        components: mergedComponents,
     };
-  });
 }
-function mergeLayoutDependencies(dependencies, layoutEntries) {
-  if (layoutEntries.length === 0) {
-    return dependencies;
-  }
-  const mergedComponents = [...dependencies?.components ?? []];
-  for (const entry of layoutEntries) {
-    if (!mergedComponents.includes(entry.component)) {
-      mergedComponents.push(entry.component);
+/**
+ * Writes normalized layout metadata onto a page `config`.
+ */
+export function applyPageLayoutConfig(pageConfig, layoutEntries) {
+    if (layoutEntries.length === 0) {
+        return;
     }
-  }
-  return {
-    ...dependencies,
-    components: mergedComponents
-  };
-}
-function applyPageLayoutConfig(pageConfig, layoutEntries) {
-  if (layoutEntries.length === 0) {
-    return;
-  }
-  pageConfig.layouts = layoutEntries.map((entry) => entry.component);
-  pageConfig.layoutEntries = layoutEntries;
+    pageConfig.layouts = layoutEntries.map((entry) => entry.component);
+    pageConfig.layoutEntries = layoutEntries;
 }
-function ensurePageConfigLayouts(config) {
-  if (!config || config.layouts && config.layouts.length > 0) {
-    return config;
-  }
-  const legacyLayout = config.layout;
-  if (!legacyLayout) {
+/**
+ * Migrates MDX-exported `config.layout` values onto normalized layout metadata.
+ *
+ * @remarks
+ * `eco.page({ layout })` already normalizes at factory time. MDX modules that
+ * export `config.layout` directly still need this import-time migration.
+ */
+export function ensurePageConfigLayouts(config) {
+    if (!config || (config.layouts && config.layouts.length > 0)) {
+        return config;
+    }
+    const legacyLayout = config.layout;
+    if (!legacyLayout) {
+        return config;
+    }
+    applyPageLayoutConfig(config, normalizePageLayouts(legacyLayout));
     return config;
-  }
-  applyPageLayoutConfig(config, normalizePageLayouts(legacyLayout));
-  return config;
 }
-export {
-  applyPageLayoutConfig,
-  ensurePageConfigLayouts,
-  mergeLayoutDependencies,
-  normalizePageLayouts
-};

package/src/errors/http-error.js

@@ -1,50 +1,51 @@
-class HttpError extends Error {
-  status;
-  details;
-  constructor(status, message, details) {
-    super(message);
-    this.name = "HttpError";
-    this.status = status;
-    this.details = details;
-  }
-  /**
-   * Serialize error to JSON for API responses.
-   */
-  toJSON() {
-    const json = {
-      error: this.message,
-      status: this.status
-    };
-    if (this.details) {
-      json.details = this.details;
-    }
-    return json;
-  }
-  /**
-   * Create a Response object from this error.
-   */
-  toResponse() {
-    return Response.json(this.toJSON(), { status: this.status });
-  }
-  static BadRequest(message = "Bad Request", details) {
-    return new HttpError(400, message, details);
-  }
-  static Unauthorized(message = "Unauthorized") {
-    return new HttpError(401, message);
-  }
-  static Forbidden(message = "Forbidden") {
-    return new HttpError(403, message);
-  }
-  static NotFound(message = "Not Found") {
-    return new HttpError(404, message);
-  }
-  static Conflict(message = "Conflict", details) {
-    return new HttpError(409, message, details);
-  }
-  static InternalServerError(message = "Internal Server Error") {
-    return new HttpError(500, message);
-  }
+/**
+ * HTTP error class for structured error handling in route handlers.
+ * Provides static factory methods for common HTTP error responses.
+ */
+export class HttpError extends Error {
+    status;
+    details;
+    constructor(status, message, details) {
+        super(message);
+        this.name = 'HttpError';
+        this.status = status;
+        this.details = details;
+    }
+    /**
+     * Serialize error to JSON for API responses.
+     */
+    toJSON() {
+        const json = {
+            error: this.message,
+            status: this.status,
+        };
+        if (this.details) {
+            json.details = this.details;
+        }
+        return json;
+    }
+    /**
+     * Create a Response object from this error.
+     */
+    toResponse() {
+        return Response.json(this.toJSON(), { status: this.status });
+    }
+    static BadRequest(message = 'Bad Request', details) {
+        return new HttpError(400, message, details);
+    }
+    static Unauthorized(message = 'Unauthorized') {
+        return new HttpError(401, message);
+    }
+    static Forbidden(message = 'Forbidden') {
+        return new HttpError(403, message);
+    }
+    static NotFound(message = 'Not Found') {
+        return new HttpError(404, message);
+    }
+    static Conflict(message = 'Conflict', details) {
+        return new HttpError(409, message, details);
+    }
+    static InternalServerError(message = 'Internal Server Error') {
+        return new HttpError(500, message);
+    }
 }
-export {
-  HttpError
-};

package/src/errors/index.js

@@ -1,12 +1,3 @@
-import { HttpError } from "./http-error.js";
-import { LocalsAccessError } from "./locals-access-error.js";
-import {
-  UndeclaredComponentDependencyError,
-  getUndeclaredComponentDependencyMessage
-} from "./undeclared-component-dependency-error.js";
-export {
-  HttpError,
-  LocalsAccessError,
-  UndeclaredComponentDependencyError,
-  getUndeclaredComponentDependencyMessage
-};
+export { HttpError } from './http-error.js';
+export { LocalsAccessError } from './locals-access-error.js';
+export { UndeclaredComponentDependencyError, getUndeclaredComponentDependencyMessage, } from './undeclared-component-dependency-error.js';

package/src/errors/locals-access-error.js

@@ -1,9 +1,6 @@
-class LocalsAccessError extends Error {
-  name = "LocalsAccessError";
-  constructor(message) {
-    super(message);
-  }
+export class LocalsAccessError extends Error {
+    name = 'LocalsAccessError';
+    constructor(message) {
+        super(message);
+    }
 }
-export {
-  LocalsAccessError
-};

package/src/errors/undeclared-component-dependency-error.js

@@ -1,17 +1,17 @@
-function getUndeclaredComponentDependencyMessage(parentComponentFile) {
-  const parentHint = parentComponentFile ? ` (declared by ${parentComponentFile})` : "";
-  return `[ecopages] dependencies.components entries must be eco.component(), eco.layout(), or eco.html() components with __eco metadata${parentHint}. Plain functions and untyped components are not valid dependency entries.`;
+export function getUndeclaredComponentDependencyMessage(parentComponentFile) {
+    const parentHint = parentComponentFile ? ` (declared by ${parentComponentFile})` : '';
+    return `[ecopages] dependencies.components entries must be eco.component(), eco.layout(), or eco.html() components with __eco metadata${parentHint}. Plain functions and untyped components are not valid dependency entries.`;
 }
-class UndeclaredComponentDependencyError extends Error {
-  name = "UndeclaredComponentDependencyError";
-  /** Parent component file path when the invalid entry was declared. */
-  parentComponentFile;
-  constructor(parentComponentFile) {
-    super(getUndeclaredComponentDependencyMessage(parentComponentFile));
-    this.parentComponentFile = parentComponentFile;
-  }
+/**
+ * Thrown when `dependencies.components` contains a plain function or component
+ * without plugin-injected `config.__eco` metadata.
+ */
+export class UndeclaredComponentDependencyError extends Error {
+    name = 'UndeclaredComponentDependencyError';
+    /** Parent component file path when the invalid entry was declared. */
+    parentComponentFile;
+    constructor(parentComponentFile) {
+        super(getUndeclaredComponentDependencyMessage(parentComponentFile));
+        this.parentComponentFile = parentComponentFile;
+    }
 }
-export {
-  UndeclaredComponentDependencyError,
-  getUndeclaredComponentDependencyMessage
-};

package/src/global/app-logger.js

@@ -1,6 +1,3 @@
-import { Logger } from "@ecopages/logger";
-const debug = process.env.ECOPAGES_LOGGER_DEBUG === "true";
-const appLogger = new Logger("[@ecopages/core]", { debug });
-export {
-  appLogger
-};
+import { Logger } from '@ecopages/logger';
+const debug = process.env.ECOPAGES_LOGGER_DEBUG === 'true';
+export const appLogger = new Logger('[@ecopages/core]', { debug });

package/src/hmr/README.md

@@ -24,3 +24,13 @@ It is responsible for:
 Generic invalidation policy belongs in core services.
 Framework-specific update behavior belongs in HMR strategies.
 Runtime-specific WebSocket or event-stream transport belongs in adapters.
+
+## Registered entrypoints and dev transform
+
+`SharedHmrManager` in `adapters/shared/hmr/` centralizes file-change handling via `handleFileChange()`. Server invalidation, integration hooks, rebuild, and client broadcast run in one sequence.
+
+Dev client modules are served on demand through `DevTransformServer` (`src/dev/`). `DevTransformEntrypointRegistry` tracks registered entrypoints for HMR invalidation. Registration returns a stable dev-transform URL immediately; the first request (or cache miss) runs Rolldown on demand.
+
+`BrowserBundleService` is the sole browser-plugin resolver for HMR builds. HMR managers route `hmr-runtime` and `hmr-entrypoint` rebuilds through the `browser-hmr` executor profile.
+
+Hosts call `prepareHmrFileChange()` before HMR dispatch (`hmr/hmr-file-change-prep.ts`) so page browser graph sessions invalidate consistently with file changes.