@ecopages/ecopages-jsx 0.2.1 → 0.3.0

package/src/radiant-registered-script-ssr-invalidation.js

@@ -0,0 +1,49 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { CUSTOM_ELEMENT_SSR_PRELOAD_CACHE_SCOPES, invalidateCustomElementScriptPreload, } from '@ecopages/core/integration';
+const CUSTOM_ELEMENT_TAG_PATTERN = /@customElement\s*\(\s*['"`]([^'"`]+)['"`]/u;
+/**
+ * Reads the custom-element tag name from a registered script module source file.
+ */
+export function resolveRadiantCustomElementTag(scriptPath) {
+    if (!existsSync(scriptPath)) {
+        return undefined;
+    }
+    const content = readFileSync(scriptPath, 'utf8');
+    const match = content.match(CUSTOM_ELEMENT_TAG_PATTERN);
+    return match?.[1];
+}
+/**
+ * Removes one custom-element definition from the active runtime registry.
+ *
+ * @remarks
+ * Radiant's `@customElement` decorator and the SSR light-DOM shim both skip
+ * re-registration when a tag is already defined. During dev, server requests
+ * reuse the same process-global registry, so script edits would otherwise keep
+ * serving stale SSR markup until a full dev-server restart.
+ */
+export function clearRadiantCustomElementDefinition(tagName) {
+    const registry = globalThis.customElements;
+    if (!registry) {
+        return;
+    }
+    if (typeof registry.delete === 'function') {
+        registry.delete(tagName);
+        return;
+    }
+    const definitions = registry.definitions;
+    if (definitions instanceof Map && definitions.has(tagName)) {
+        definitions.delete(tagName);
+    }
+}
+/**
+ * Clears the SSR custom-element registry entry for one registered Radiant script module.
+ */
+export function invalidateRadiantRegisteredScriptSsrRegistration(preloadScopes, scriptPath) {
+    invalidateCustomElementScriptPreload(preloadScopes, scriptPath, CUSTOM_ELEMENT_SSR_PRELOAD_CACHE_SCOPES.ecopagesJsx);
+    const tagName = resolveRadiantCustomElementTag(scriptPath);
+    if (!tagName) {
+        return false;
+    }
+    clearRadiantCustomElementDefinition(tagName);
+    return true;
+}

package/src/resolve-radiant-install-hydrator.d.ts

@@ -0,0 +1,2 @@
+/** Absolute path to `@ecopages/radiant/client/install-hydrator` from this integration package. */
+export declare const RADIANT_INSTALL_HYDRATOR_FILEPATH: string;

package/src/resolve-radiant-install-hydrator.js

@@ -0,0 +1,3 @@
+import { fileURLToPath } from 'node:url';
+/** Absolute path to `@ecopages/radiant/client/install-hydrator` from this integration package. */
+export const RADIANT_INSTALL_HYDRATOR_FILEPATH = fileURLToPath(import.meta.resolve('@ecopages/radiant/client/install-hydrator'));

package/CHANGELOG.md

@@ -1,15 +0,0 @@
-# Changelog
-
-## [UNRELEASED] -- TBD
-
-### Features
-
-- Added the Ecopages JSX integration with optional Radiant runtime support and optional MDX routes compiled against `@ecopages/jsx`.
-
-### Bug Fixes
-
-- Fixed mixed-renderer JSX boundary resolution, Radiant/browser runtime asset mapping, required peer dependency wiring, Bun-only MDX loader setup, and multi-dot MDX extension matching.
-
-### Documentation
-
-- Updated the README to document JSX route extensions, Radiant defaults, MDX configuration, and mixed-renderer boundary ownership.

package/src/services/jsx-runtime-bundle.service.d.ts

@@ -1,51 +0,0 @@
-/**
- * Runtime bundle service for the JSX integration.
- *
- * Owns creation of browser runtime vendor assets, the import map specifier
- * mapping, and the build external plugin. Radiant sub-path specifiers are
- * derived at runtime from `@ecopages/radiant/package.json` exports so the
- * list stays in sync with whatever version is installed.
- *
- * @module
- */
-import type { EcoBuildPlugin } from '@ecopages/core/build/build-types';
-import { type AssetDefinition } from '@ecopages/core/services/asset-processing-service';
-export interface JsxRuntimeBundleServiceConfig {
-    radiant: boolean;
-    rootDir?: string;
-}
-export declare class JsxRuntimeBundleService {
-    private readonly config;
-    private cachedSpecifierMap;
-    private cachedRadiantEntryModulePath;
-    constructor(config: JsxRuntimeBundleServiceConfig);
-    setRootDir(rootDir: string | undefined): void;
-    /**
-     * Returns the build plugin that aliases JSX and Radiant runtime specifiers to
-     * their emitted browser vendor URLs.
-     *
-     * @remarks
-     * The returned plugin both externalizes the mapped specifiers during bundle
-     * resolution and exposes alias metadata so Ecopages can rewrite any emitted JS
-     * imports that still reference bare runtime specifiers.
-     */
-    getBuildPlugin(): EcoBuildPlugin;
-    /**
-     * Builds the bare-specifier-to-vendor-URL map for the browser import map.
-     *
-     * JSX sub-paths are always included. When `radiant` is enabled, radiant
-     * sub-paths are derived from `@ecopages/radiant/package.json` exports and
-     * the result is cached for the lifetime of this service instance.
-     */
-    getSpecifierMap(): Promise<Record<string, string>>;
-    /**
-     * Builds the full list of vendor asset definitions: the import map inline
-     * script plus one `createBrowserRuntimeScriptAsset` per vendor bundle.
-     */
-    getDependencies(): Promise<AssetDefinition[]>;
-    private getOrCreateSpecifierMap;
-    private getRadiantBrowserRuntimeSpecifiers;
-    private getRadiantBrowserRuntimeModules;
-    private resolveRadiantExportModulePath;
-    private getOrCreateRadiantEntryModulePath;
-}

package/src/services/jsx-runtime-bundle.service.js

@@ -1,206 +0,0 @@
-import path from "node:path";
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
-import { createRuntimeSpecifierAliasPlugin } from "@ecopages/core/build/runtime-specifier-alias-plugin";
-import {
-  buildBrowserRuntimeAssetUrl,
-  createBrowserRuntimeScriptAsset,
-  AssetFactory
-} from "@ecopages/core/services/asset-processing-service";
-const VENDOR_FILE_NAMES = {
-  jsx: "ecopages-jsx-esm.js",
-  radiant: "ecopages-radiant-esm.js"
-};
-function getNamedExportNamesFromModuleSource(source) {
-  const exportNames = /* @__PURE__ */ new Set();
-  for (const match of source.matchAll(/export\s*\{([^}]+)\}/g)) {
-    for (const specifier of match[1].split(",")) {
-      const trimmedSpecifier = specifier.trim();
-      if (!trimmedSpecifier) {
-        continue;
-      }
-      const aliasMatch = trimmedSpecifier.match(/(?:.+\s+as\s+)?([A-Z_a-z$][\w$]*)$/);
-      if (aliasMatch?.[1] && aliasMatch[1] !== "default") {
-        exportNames.add(aliasMatch[1]);
-      }
-    }
-  }
-  for (const match of source.matchAll(
-    /export\s+(?:async\s+)?(?:const|function|class|let|var)\s+([A-Z_a-z$][\w$]*)/g
-  )) {
-    if (match[1] !== "default") {
-      exportNames.add(match[1]);
-    }
-  }
-  return [...exportNames].sort();
-}
-function isBrowserRuntimeRadiantSpecifier(exportKey) {
-  if (exportKey === "." || exportKey.startsWith("./context/")) {
-    return true;
-  }
-  if (exportKey.startsWith("./decorators/") || exportKey.startsWith("./helpers/")) {
-    return true;
-  }
-  return exportKey === "./core/radiant-component" || exportKey === "./core/radiant-element";
-}
-function findPackageManifestPath(packageName) {
-  let currentDir = path.dirname(new URL(import.meta.url).pathname);
-  while (true) {
-    const candidatePath = path.join(currentDir, "node_modules", packageName, "package.json");
-    if (existsSync(candidatePath)) {
-      return candidatePath;
-    }
-    const parentDir = path.dirname(currentDir);
-    if (parentDir === currentDir) {
-      break;
-    }
-    currentDir = parentDir;
-  }
-  throw new Error(`Could not locate ${packageName}/package.json from ${import.meta.url}`);
-}
-class JsxRuntimeBundleService {
-  config;
-  cachedSpecifierMap;
-  cachedRadiantEntryModulePath;
-  constructor(config) {
-    this.config = config;
-  }
-  setRootDir(rootDir) {
-    this.config.rootDir = rootDir;
-  }
-  /**
-   * Returns the build plugin that aliases JSX and Radiant runtime specifiers to
-   * their emitted browser vendor URLs.
-   *
-   * @remarks
-   * The returned plugin both externalizes the mapped specifiers during bundle
-   * resolution and exposes alias metadata so Ecopages can rewrite any emitted JS
-   * imports that still reference bare runtime specifiers.
-   */
-  getBuildPlugin() {
-    return createRuntimeSpecifierAliasPlugin(this.getOrCreateSpecifierMap(), {
-      name: "ecopages-jsx-runtime-alias"
-    });
-  }
-  /**
-   * Builds the bare-specifier-to-vendor-URL map for the browser import map.
-   *
-   * JSX sub-paths are always included. When `radiant` is enabled, radiant
-   * sub-paths are derived from `@ecopages/radiant/package.json` exports and
-   * the result is cached for the lifetime of this service instance.
-   */
-  async getSpecifierMap() {
-    return this.getOrCreateSpecifierMap();
-  }
-  /**
-   * Builds the full list of vendor asset definitions: the import map inline
-   * script plus one `createBrowserRuntimeScriptAsset` per vendor bundle.
-   */
-  async getDependencies() {
-    const specifierMap = await this.getSpecifierMap();
-    const deps = [
-      AssetFactory.createInlineContentScript({
-        position: "head",
-        bundle: false,
-        content: JSON.stringify({ imports: specifierMap }, null, 2),
-        attributes: { type: "importmap" }
-      }),
-      createBrowserRuntimeScriptAsset({
-        importPath: "@ecopages/jsx",
-        name: "ecopages-jsx-esm",
-        fileName: VENDOR_FILE_NAMES.jsx
-      })
-    ];
-    if (this.config.radiant) {
-      const radiantEntryModulePath = await this.getOrCreateRadiantEntryModulePath();
-      deps.push(
-        createBrowserRuntimeScriptAsset({
-          importPath: radiantEntryModulePath,
-          name: "ecopages-radiant-esm",
-          fileName: VENDOR_FILE_NAMES.radiant
-        })
-      );
-    }
-    return deps;
-  }
-  getOrCreateSpecifierMap() {
-    if (this.cachedSpecifierMap) {
-      return this.cachedSpecifierMap;
-    }
-    const jsxVendorUrl = buildBrowserRuntimeAssetUrl(VENDOR_FILE_NAMES.jsx);
-    const specifierMap = {
-      "@ecopages/jsx": jsxVendorUrl,
-      "@ecopages/jsx/server": jsxVendorUrl,
-      "@ecopages/jsx/client": jsxVendorUrl,
-      "@ecopages/jsx/jsx-runtime": jsxVendorUrl,
-      "@ecopages/jsx/jsx-dev-runtime": jsxVendorUrl
-    };
-    if (this.config.radiant) {
-      const radiantVendorUrl = buildBrowserRuntimeAssetUrl(VENDOR_FILE_NAMES.radiant);
-      const radiantPkg = JSON.parse(
-        readFileSync(findPackageManifestPath("@ecopages/radiant"), "utf8")
-      );
-      for (const key of Object.keys(radiantPkg.exports ?? {})) {
-        if (!isBrowserRuntimeRadiantSpecifier(key)) {
-          continue;
-        }
-        const specifier = key === "." ? "@ecopages/radiant" : `@ecopages/radiant${key.slice(1)}`;
-        specifierMap[specifier] = radiantVendorUrl;
-      }
-    }
-    this.cachedSpecifierMap = specifierMap;
-    return specifierMap;
-  }
-  getRadiantBrowserRuntimeSpecifiers() {
-    return this.getRadiantBrowserRuntimeModules().map(({ exportKey }) => `@ecopages/radiant${exportKey.slice(1)}`);
-  }
-  getRadiantBrowserRuntimeModules() {
-    const manifestPath = findPackageManifestPath("@ecopages/radiant");
-    const packageDir = path.dirname(realpathSync(manifestPath));
-    const radiantPkg = JSON.parse(readFileSync(manifestPath, "utf8"));
-    return Object.entries(radiantPkg.exports ?? {}).filter(([key]) => isBrowserRuntimeRadiantSpecifier(key) && key !== ".").sort(([left], [right]) => left.localeCompare(right)).map(([exportKey, exportTarget]) => ({
-      exportKey,
-      modulePath: this.resolveRadiantExportModulePath(packageDir, exportKey, exportTarget)
-    })).filter((module) => existsSync(module.modulePath));
-  }
-  resolveRadiantExportModulePath(packageDir, exportKey, exportTarget) {
-    if (typeof exportTarget === "string") {
-      return path.resolve(packageDir, exportTarget);
-    }
-    if (exportTarget && typeof exportTarget === "object" && "import" in exportTarget) {
-      const importTarget = exportTarget.import;
-      if (typeof importTarget === "string") {
-        return path.resolve(packageDir, importTarget);
-      }
-    }
-    throw new Error(`Missing import target for @ecopages/radiant export ${exportKey}`);
-  }
-  async getOrCreateRadiantEntryModulePath() {
-    if (this.cachedRadiantEntryModulePath) {
-      return this.cachedRadiantEntryModulePath;
-    }
-    const rootDir = this.config.rootDir ?? process.cwd();
-    const artifactsDir = path.join(rootDir, "node_modules", ".cache", "ecopages-browser-runtime");
-    const filePath = path.join(artifactsDir, "ecopages-radiant-esm-entry.mjs");
-    const seenExports = /* @__PURE__ */ new Set();
-    const statements = [];
-    mkdirSync(artifactsDir, { recursive: true });
-    for (const module of this.getRadiantBrowserRuntimeModules()) {
-      const exportNames = getNamedExportNamesFromModuleSource(readFileSync(module.modulePath, "utf8")).filter((name) => !seenExports.has(name)).filter((name) => /^[$A-Z_a-z][$\w]*$/.test(name)).sort();
-      if (exportNames.length === 0) {
-        continue;
-      }
-      const relativeModulePath = path.relative(artifactsDir, module.modulePath).split(path.sep).join("/");
-      const entryImportPath = relativeModulePath.startsWith(".") ? relativeModulePath : `./${relativeModulePath}`;
-      statements.push(`export { ${exportNames.join(", ")} } from '${entryImportPath}';`);
-      for (const exportName of exportNames) {
-        seenExports.add(exportName);
-      }
-    }
-    writeFileSync(filePath, statements.join("\n"), "utf8");
-    this.cachedRadiantEntryModulePath = filePath;
-    return filePath;
-  }
-}
-export {
-  JsxRuntimeBundleService
-};