@ecopages/core 0.2.0-alpha.5 → 0.2.0-alpha.7

package/src/hmr/strategies/js-hmr-strategy.js

@@ -1,192 +0,0 @@
-import path from "node:path";
-import { fileSystem } from "@ecopages/file-system";
-import { HmrStrategy, HmrStrategyType } from "../hmr-strategy";
-import { appLogger } from "../../global/app-logger";
-import { defaultBuildAdapter } from "../../build/build-adapter.js";
-class JsHmrStrategy extends HmrStrategy {
-  constructor(context) {
-    super();
-    this.context = context;
-  }
-  type = HmrStrategyType.SCRIPT;
-  /**
-   * Determines if the file is a JS/TS file that could affect registered entrypoints.
-   *
-   * Matches if:
-   * 1. There are registered entrypoints to rebuild
-   * 2. The changed file is a JS/TS file in the src directory
-   *
-   * @param filePath - Absolute path to the changed file
-   * @returns True if this file should trigger entrypoint rebuilds
-   */
-  matches(filePath) {
-    const watchedFiles = this.context.getWatchedFiles();
-    const isJsTs = /\.(ts|tsx|js|jsx)$/.test(filePath);
-    const isInSrc = filePath.startsWith(this.context.getSrcDir());
-    if (watchedFiles.size === 0) {
-      return false;
-    }
-    if (!isJsTs || !isInSrc) {
-      return false;
-    }
-    if (watchedFiles.has(filePath)) {
-      return true;
-    }
-    if (this.context.getDependencyEntrypoints) {
-      return this.context.getDependencyEntrypoints(filePath).size > 0;
-    }
-    return true;
-  }
-  /**
-   * Processes a file change by rebuilding affected entrypoints.
-   *
-   * @param filePath - Absolute path to the changed file
-   *
-   * @remarks
-   * If runtime-specific dependency graph hooks are unavailable, this strategy
-   * falls back to rebuilding all watched entrypoints.
-   * When multiple entrypoints are impacted they are bundled in a single esbuild
-   * invocation to share AST parsing and chunk deduplication.
-   * @returns Action to broadcast update events
-   */
-  async process(filePath) {
-    appLogger.debug(`[JsHmrStrategy] Processing ${filePath}`);
-    const watchedFiles = this.context.getWatchedFiles();
-    if (watchedFiles.size === 0) {
-      appLogger.debug(`[JsHmrStrategy] No watched files to rebuild`);
-      return { type: "none" };
-    }
-    const dependencyHits = this.context.getDependencyEntrypoints?.(filePath) ?? /* @__PURE__ */ new Set();
-    const hasDependencyHit = dependencyHits.size > 0;
-    const impactedEntrypoints = hasDependencyHit ? Array.from(dependencyHits).filter((entrypoint) => watchedFiles.has(entrypoint)) : Array.from(watchedFiles.keys());
-    if (!hasDependencyHit) {
-      appLogger.debug("[JsHmrStrategy] Dependency graph miss, rebuilding all watched entrypoints");
-    }
-    if (impactedEntrypoints.length === 0) {
-      return { type: "none" };
-    }
-    const buildResult = await this.bundleEntrypoints(impactedEntrypoints);
-    if (!buildResult.success) {
-      return { type: "none" };
-    }
-    const updates = [];
-    let reloadRequired = false;
-    for (const entrypoint of impactedEntrypoints) {
-      const outputUrl = watchedFiles.get(entrypoint);
-      if (!outputUrl) continue;
-      if (buildResult.dependencies && this.context.setEntrypointDependencies) {
-        const entrypointDeps = buildResult.dependencies.get(path.resolve(entrypoint)) ?? [];
-        this.context.setEntrypointDependencies(entrypoint, entrypointDeps);
-      }
-      const srcDir = this.context.getSrcDir();
-      const relativePath = path.relative(srcDir, entrypoint);
-      const relativePathJs = relativePath.replace(/\.(tsx?|jsx?)$/, ".js");
-      const outputPath = path.join(this.context.getDistDir(), relativePathJs);
-      const result = await this.processOutput(outputPath, outputUrl);
-      if (result.success) {
-        updates.push(outputUrl);
-        if (result.requiresReload) {
-          reloadRequired = true;
-        }
-      }
-    }
-    if (updates.length > 0) {
-      if (reloadRequired) {
-        appLogger.debug(`[JsHmrStrategy] Full reload required (no HMR accept found)`);
-        return {
-          type: "broadcast",
-          events: [{ type: "reload" }]
-        };
-      }
-      return {
-        type: "broadcast",
-        events: updates.map((p) => ({
-          type: "update",
-          path: p,
-          timestamp: Date.now()
-        }))
-      };
-    }
-    return { type: "none" };
-  }
-  /**
-   * Bundles one or more entrypoints in a single esbuild invocation.
-   * Uses the source directory as the output base so that the directory structure
-   * is preserved under the HMR dist folder.
-   */
-  async bundleEntrypoints(entrypoints) {
-    try {
-      const result = await defaultBuildAdapter.build({
-        entrypoints,
-        outdir: this.context.getDistDir(),
-        outbase: this.context.getSrcDir(),
-        naming: "[dir]/[name]",
-        ...defaultBuildAdapter.getTranspileOptions("hmr-entrypoint"),
-        plugins: this.context.getPlugins(),
-        minify: false,
-        external: ["react", "react-dom"]
-      });
-      if (!result.success) {
-        appLogger.error("[JsHmrStrategy] Batched build failed:", result.logs);
-        return { success: false };
-      }
-      const dependencies = /* @__PURE__ */ new Map();
-      if (result.dependencyGraph?.entrypoints) {
-        for (const [entrypoint, deps] of Object.entries(result.dependencyGraph.entrypoints)) {
-          dependencies.set(path.resolve(entrypoint), deps);
-        }
-      }
-      return { success: true, dependencies };
-    } catch (error) {
-      appLogger.error("[JsHmrStrategy] Error in batched build:", error);
-      return { success: false };
-    }
-  }
-  /**
-   * Processes bundled output by replacing specifiers and injecting HMR code.
-   *
-   * @param filepath - Path to the bundled output file
-   * @param url - URL path for the bundled file
-   * @returns True if processing was successful and update should be broadcast
-   */
-  async processOutput(filepath, url) {
-    try {
-      let code = await fileSystem.readFile(filepath);
-      if (code.includes("/* [ecopages] hmr */")) {
-        return { success: true, requiresReload: !code.includes("import.meta.hot.accept") };
-      }
-      code = this.replaceBareSpecifiers(code);
-      await fileSystem.writeAsync(filepath, code);
-      appLogger.debug(`[JsHmrStrategy] Processed ${url}`);
-      const hasHmrAccept = code.includes("import.meta.hot.accept");
-      return { success: true, requiresReload: !hasHmrAccept };
-    } catch (error) {
-      appLogger.error(`[JsHmrStrategy] Error processing output for ${url}:`, error);
-      return { success: false, requiresReload: false };
-    }
-  }
-  /**
-   * Replaces bare specifiers with vendor URLs.
-   *
-   * Handles both static imports and dynamic imports.
-   *
-   * @param code - The bundled code to transform
-   * @returns The transformed code with vendor URLs
-   */
-  replaceBareSpecifiers(code) {
-    const specifierMap = this.context.getSpecifierMap();
-    if (specifierMap.size === 0) {
-      return code;
-    }
-    let result = code;
-    for (const [bareSpec, vendorUrl] of specifierMap.entries()) {
-      const escaped = bareSpec.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-      result = result.replace(new RegExp(`from\\s*["']${escaped}["']`, "g"), `from "${vendorUrl}"`);
-      result = result.replace(new RegExp(`import\\(["']${escaped}["']\\)`, "g"), `import("${vendorUrl}")`);
-    }
-    return result;
-  }
-}
-export {
-  JsHmrStrategy
-};

package/src/index.browser.d.ts

@@ -1,3 +0,0 @@
-export type * from './public-types.js';
-export type * from './eco/eco.types.js';
-export { eco } from './eco/eco.js';

package/src/index.browser.js

@@ -1,4 +0,0 @@
-import { eco } from "./eco/eco.js";
-export {
-  eco
-};

package/src/index.d.ts

@@ -1,5 +0,0 @@
-export type * from './public-types.js';
-export type * from './eco/eco.types.js';
-export { eco } from './eco/eco.js';
-export { EcopagesApp, createApp, type EcopagesAppOptions } from './create-app.js';
-export { defineApiHandler, defineGroupHandler, type GroupHandler } from './define-api-handler.js';

package/src/index.js

@@ -1,10 +0,0 @@
-import { eco } from "./eco/eco.js";
-import { EcopagesApp, createApp } from "./create-app.js";
-import { defineApiHandler, defineGroupHandler } from "./define-api-handler.js";
-export {
-  EcopagesApp,
-  createApp,
-  defineApiHandler,
-  defineGroupHandler,
-  eco
-};

package/src/integrations/ghtml/ghtml-renderer.d.ts

@@ -1,15 +0,0 @@
-/**
- * This module contains the ghtml renderer
- * @module
- */
-import type { EcoComponent, EcoPagesElement, IntegrationRendererRenderOptions, RouteRendererBody } from '../../public-types.js';
-import { IntegrationRenderer, type RenderToResponseContext } from '../../route-renderer/integration-renderer.js';
-/**
- * A renderer for the ghtml integration.
- * It renders a page using the HtmlTemplate and Page components.
- */
-export declare class GhtmlRenderer extends IntegrationRenderer<EcoPagesElement> {
-    name: string;
-    render({ params, query, props, locals, pageLocals, metadata, Page, Layout, HtmlTemplate, }: IntegrationRendererRenderOptions): Promise<RouteRendererBody>;
-    renderToResponse<P = Record<string, unknown>>(view: EcoComponent<P>, props: P, ctx: RenderToResponseContext): Promise<Response>;
-}

package/src/integrations/ghtml/ghtml-renderer.js

@@ -1,60 +0,0 @@
-import { IntegrationRenderer } from "../../route-renderer/integration-renderer.js";
-import { GHTML_PLUGIN_NAME } from "./ghtml.plugin.js";
-class GhtmlRenderer extends IntegrationRenderer {
-  name = GHTML_PLUGIN_NAME;
-  async render({
-    params,
-    query,
-    props,
-    locals,
-    pageLocals,
-    metadata,
-    Page,
-    Layout,
-    HtmlTemplate
-  }) {
-    try {
-      const pageContent = await Page({ params, query, ...props, locals: pageLocals });
-      const children = Layout && typeof Layout === "function" ? await Layout({ children: pageContent, locals }) : pageContent;
-      const body = await HtmlTemplate({
-        metadata,
-        children,
-        pageProps: props || {}
-      });
-      return this.DOC_TYPE + body;
-    } catch (error) {
-      throw this.createRenderError("Error rendering page", error);
-    }
-  }
-  async renderToResponse(view, props, ctx) {
-    try {
-      const Layout = view.config?.layout;
-      const viewFn = view;
-      const pageContent = await viewFn(props);
-      let body;
-      if (ctx.partial) {
-        body = pageContent;
-      } else {
-        const children = Layout ? await Layout({ children: pageContent }) : pageContent;
-        const HtmlTemplate = await this.getHtmlTemplate();
-        const metadata = view.metadata ? await view.metadata({
-          params: {},
-          query: {},
-          props,
-          appConfig: this.appConfig
-        }) : this.appConfig.defaultMetadata;
-        body = this.DOC_TYPE + await HtmlTemplate({
-          metadata,
-          children,
-          pageProps: props
-        });
-      }
-      return this.createHtmlResponse(body, ctx);
-    } catch (error) {
-      throw this.createRenderError("Error rendering view", error);
-    }
-  }
-}
-export {
-  GhtmlRenderer
-};

package/src/integrations/ghtml/ghtml.plugin.d.ts

@@ -1,20 +0,0 @@
-import { IntegrationPlugin, type IntegrationPluginConfig } from '../../plugins/integration-plugin';
-import { GhtmlRenderer } from './ghtml-renderer';
-/**
- * The name of the ghtml plugin
- */
-export declare const GHTML_PLUGIN_NAME = "ghtml";
-/**
- * The Ghtml plugin class
- * This plugin provides support for ghtml components in Ecopages
- */
-export declare class GhtmlPlugin extends IntegrationPlugin {
-    renderer: typeof GhtmlRenderer;
-    constructor(options?: Omit<IntegrationPluginConfig, 'name'>);
-}
-/**
- * Factory function to create a Ghtml plugin instance
- * @param options Configuration options for the Ghtml plugin
- * @returns A new GhtmlPlugin instance
- */
-export declare function ghtmlPlugin(options?: Omit<IntegrationPluginConfig, 'name'>): GhtmlPlugin;

package/src/integrations/ghtml/ghtml.plugin.js

@@ -1,21 +0,0 @@
-import { IntegrationPlugin } from "../../plugins/integration-plugin";
-import { GhtmlRenderer } from "./ghtml-renderer";
-const GHTML_PLUGIN_NAME = "ghtml";
-class GhtmlPlugin extends IntegrationPlugin {
-  renderer = GhtmlRenderer;
-  constructor(options) {
-    super({
-      name: GHTML_PLUGIN_NAME,
-      extensions: [".ghtml.ts", ".ghtml.tsx", ".ghtml"],
-      ...options
-    });
-  }
-}
-function ghtmlPlugin(options) {
-  return new GhtmlPlugin(options);
-}
-export {
-  GHTML_PLUGIN_NAME,
-  GhtmlPlugin,
-  ghtmlPlugin
-};

package/src/internal-types.d.ts

@@ -1,200 +0,0 @@
-import type { EcoBuildPlugin } from './build/build-types.js';
-import type { IntegrationPlugin } from './plugins/integration-plugin.js';
-import type { Processor } from './plugins/processor.js';
-import type { PageMetadataProps } from './public-types.js';
-import type { FSRouter } from './router/fs-router.js';
-import type { CacheConfig } from './services/cache/cache.types.js';
-/**
- * The templates used to build the pages and loaded via the includes directory.
- */
-export type IncludesTemplates = {
-    head: string;
-    html: string;
-    seo: string;
-};
-export interface RobotsPreference {
-    /**
-     * The user agent
-     * If an empty array is provided, it will enable all paths for the user agent
-     * If a path is provided, it will disallow the path for the user agent
-     */
-    [key: string]: string[];
-}
-/**
- * Represents the complete configuration object for EcoPages.
- */
-export type EcoPagesAppConfig = {
-    /**
-     * The base URL of the website, localhost or the domain
-     */
-    baseUrl: string;
-    /**
-     * The root directory of the project
-     * @default "."
-     */
-    rootDir: string;
-    /**
-     * The root directory of the project
-     * @default "src"
-     */
-    srcDir: string;
-    /**
-     * The directory where the public files are located
-     * @default "public"
-     */
-    publicDir: string;
-    /**
-     * The directory where the pages are located
-     * @default "pages"
-     */
-    pagesDir: string;
-    /**
-     * The directory where the includes templates are located
-     * @default "includes"
-     */
-    includesDir: string;
-    /**
-     * The directory where the layouts are located
-     * @default "layouts"
-     */
-    layoutsDir: string;
-    /**
-     * The templates used for the pages
-     * @default "{head: 'head.kita.tsx', html: 'html.kita.tsx', seo: 'seo.kita.tsx'}"
-     */
-    includesTemplates: IncludesTemplates;
-    /** Error 404 page
-     * @default "404.kita.tsx"
-     */
-    error404Template: string;
-    /**
-     * The directory where the output will be located
-     * @default "dist"
-     */
-    distDir: string;
-    /**
-     * The templates extensions based on the integrations
-     */
-    templatesExt: string[];
-    /**
-     * The directory where the components are located
-     * @default "components"
-     */
-    componentsDir: string;
-    /**
-     * The robots.txt configuration
-     */
-    robotsTxt: {
-        /**
-         * The robots preferences. The key is the user agent and the value is the disallowed paths.
-         * @default { "*": [] }
-         */
-        preferences: RobotsPreference;
-    };
-    /** Additional paths to watch. Use this to monitor extra files. It is relative to the rootDir */
-    additionalWatchPaths: string[];
-    /**
-     * @default { title: 'Ecopages', description: 'Ecopages' }
-     */
-    defaultMetadata: PageMetadataProps;
-    /** Integrations plugins */
-    integrations: IntegrationPlugin[];
-    /** Integrations dependencies */
-    integrationsDependencies: IntegrationDependencyConfig[];
-    /** Derived Paths */
-    absolutePaths: {
-        config: string;
-        componentsDir: string;
-        distDir: string;
-        includesDir: string;
-        layoutsDir: string;
-        pagesDir: string;
-        projectDir: string;
-        publicDir: string;
-        srcDir: string;
-        htmlTemplatePath: string;
-        error404TemplatePath: string;
-    };
-    /**
-     * The processors to be used in the app
-     */
-    processors: Map<string, Processor>;
-    /**
-     * Loaders to be used in the app, these are used to process the files when importing them
-     */
-    loaders: Map<string, EcoBuildPlugin>;
-    /**
-     * Cache configuration for ISR and page caching.
-     * @default { store: 'memory', defaultStrategy: 'static', enabled: true }
-     */
-    cache?: CacheConfig;
-    /**
-     * Experimental features.
-     */
-    experimental?: {
-        /** Escape hatch for short-lived private toggles. No validation or IntelliSense. */
-        unsafe?: Record<string, unknown>;
-    };
-};
-export type IntegrationDependencyConfig = {
-    integration: string;
-    kind: 'script' | 'stylesheet';
-    position?: 'head' | 'body';
-    srcUrl: string;
-    filePath: string;
-    /** @todo inline dependencies not implemented yet */
-    inline?: boolean;
-};
-/**
- * The possible kinds of a route.
- */
-export type RouteKind = 'exact' | 'catch-all' | 'dynamic';
-/**
- * Represents the result of a route match.
- */
-export type MatchResult = {
-    filePath: string;
-    kind: RouteKind;
-    pathname: string;
-    query?: Record<string, string>;
-    params?: Record<string, string | string[]>;
-};
-/**
- * Represents a route in EcoPages.
- */
-export type Route = {
-    kind: RouteKind;
-    filePath: string;
-    pathname: string;
-};
-/**
- * Represents the routes in EcoPages.
- */
-export type Routes = Record<string, Route>;
-/**
- * Represents the options for the file system server.
- */
-export type FileSystemServerOptions = {
-    watchMode: boolean;
-    port?: number | string;
-};
-/**
- * Represents the file system server adapter.
- */
-export interface EcoPagesFileSystemServerAdapter<ServerInstanceOptions = unknown> {
-    startServer(serverOptions: ServerInstanceOptions): {
-        router: FSRouter;
-        server: unknown;
-    } | Promise<{
-        router: FSRouter;
-        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';

package/src/plugins/alias-resolver-plugin.d.ts

@@ -1,2 +0,0 @@
-import type { EcoBuildPlugin } from '../build/build-types.js';
-export declare function createAliasResolverPlugin(srcDir: string): EcoBuildPlugin;

package/src/plugins/alias-resolver-plugin.js

@@ -1,39 +0,0 @@
-import { existsSync } from "node:fs";
-import path from "node:path";
-const RESOLVABLE_EXTENSIONS = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".mdx", ".css", ".scss", ".sass", ".less"];
-function findResolvablePath(candidate) {
-  if (path.extname(candidate)) {
-    return existsSync(candidate) ? candidate : void 0;
-  }
-  for (const extension of RESOLVABLE_EXTENSIONS) {
-    const fileCandidate = `${candidate}${extension}`;
-    if (existsSync(fileCandidate)) {
-      return fileCandidate;
-    }
-  }
-  for (const extension of RESOLVABLE_EXTENSIONS) {
-    const indexCandidate = path.join(candidate, `index${extension}`);
-    if (existsSync(indexCandidate)) {
-      return indexCandidate;
-    }
-  }
-  return void 0;
-}
-function createAliasResolverPlugin(srcDir) {
-  return {
-    name: "ecopages-alias-resolver",
-    setup(build) {
-      build.onResolve({ filter: /^@\// }, (args) => {
-        const candidate = path.join(srcDir, args.path.slice(2));
-        const resolved = findResolvablePath(candidate);
-        if (resolved) {
-          return { path: resolved };
-        }
-        return {};
-      });
-    }
-  };
-}
-export {
-  createAliasResolverPlugin
-};

package/src/plugins/eco-component-meta-plugin.d.ts

@@ -1,95 +0,0 @@
-/**
- * Bun plugin that auto-injects `__eco` metadata into EcoComponent config objects.
- *
- * This plugin uses AST parsing (via oxc-parser) to reliably inject the `__eco` property
- * into EcoComponent config objects at import time. The injected metadata contains:
- * - `dir`: The directory path of the component file (used for dependency resolution)
- * - `integration`: The integration type (e.g., 'react', 'kitajs', 'ghtml', 'lit')
- *
- * The plugin intercepts file loading for all configured integration extensions and
- * transforms component configs before they are executed.
- *
- * @example
- * ```typescript
- * // Before transformation:
- * export default eco.page({
- *   render: () => '<div>Hello</div>',
- * });
- *
- * // After transformation:
- * export default eco.page({
- *   __eco: { id: "<hash>", file: "/path/to/pages/index.tsx", integration: "react" },
- *   render: () => '<div>Hello</div>',
- * });
- * ```
- *
- * @module eco-component-meta-plugin
- */
-import type { EcoBuildPlugin } from '../build/build-types.js';
-import type { EcoPagesAppConfig } from '../internal-types.js';
-/**
- * Options for creating the eco-component-meta-plugin.
- */
-export interface EcoComponentDirPluginOptions {
-    /** The EcoPages application configuration containing integration settings */
-    config: EcoPagesAppConfig;
-}
-/**
- * Creates a build plugin that auto-injects `__eco` metadata into EcoComponent config objects.
- *
- * This plugin intercepts file loading for all integration-compatible files and:
- * 1. Strips any query string from the file path (for dev mode cache-busting)
- * 2. Reads the file contents
- * 3. Parses the AST using oxc-parser to find injection points
- * 4. Injects `__eco: { id: "...", file: "...", integration: "..." }` into config objects
- * 5. Returns the transformed content with the appropriate loader
- *
- * Supported patterns:
- * - `eco.page({ ... })` - Page component declarations
- * - `eco.component({ ... })` - Reusable component declarations
- * - `Component.config = { ... }` - Config assignment pattern
- * - `config: { ... }` - Config property in object literals
- * - `export const config = { ... }` - Exported config declarations
- *
- * @param options - Plugin options containing the EcoPages config
- * @returns A build plugin instance ready for registration
- *
- * @example
- * ```typescript
- * import { createEcoComponentMetaPlugin } from '@ecopages/core';
- *
- * const plugin = createEcoComponentMetaPlugin({ config: appConfig });
- * appConfig.loaders.set(plugin.name, plugin);
- * ```
- */
-export declare function createEcoComponentMetaPlugin(options: EcoComponentDirPluginOptions): EcoBuildPlugin;
-/**
- * Injects `__eco` metadata into EcoComponent config objects in file content.
- *
- * Uses oxc-parser for robust AST-based code analysis, which handles edge cases
- * that regex-based approaches would miss (e.g., complex generics, nested objects,
- * comments, string literals containing similar patterns).
- *
- * The injection is performed by:
- * 1. Parsing the source code into an AST
- * 2. Walking the AST to find all config object patterns
- * 3. Collecting insertion points (sorted in reverse order to preserve positions)
- * 4. Inserting the `__eco` property at each point
- *
- * @param contents - The source code content to transform
- * @param filePath - Absolute path to the file (used to derive the directory)
- * @param integration - The integration identifier for this file type
- * @returns Transformed source code with `__eco` injected, or original if no patterns found
- *
- * @example
- * ```typescript
- * const result = injectEcoMeta(
- *   'export default eco.page({ render: () => "<div>Hi</div>" });',
- *   '/app/src/pages/index.tsx',
- *   'react'
- * );
- * // Result: 'export default eco.page({ __eco: { id: "<hash>", file: "/app/src/pages/index.tsx", integration: "react" }, render: () => "<div>Hi</div>" });'
- * ```
- */
-export declare function injectEcoMeta(contents: string, filePath: string, integration: string): string;
-export default createEcoComponentMetaPlugin;