@ecopages/ecopages-jsx 0.2.0-beta.18 → 0.2.0-beta.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecopages/ecopages-jsx",
-  "version": "0.2.0-beta.18",
+  "version": "0.2.0-beta.19",
   "description": "JSX integration plugin for Ecopages",
   "keywords": [
     "ecopages",
@@ -31,12 +31,12 @@
     "directory": "packages/integrations/ecopages-jsx"
   },
   "dependencies": {
-    "@ecopages/mdx": "0.2.0-beta.18",
+    "@ecopages/mdx": "0.2.0-beta.19",
     "@mdx-js/mdx": "^3.1.1",
     "vfile": "^6.0.3"
   },
   "peerDependencies": {
-    "@ecopages/core": "0.2.0-beta.18",
+    "@ecopages/core": "0.2.0-beta.19",
     "@ecopages/jsx": "0.3.0-beta.0",
     "@ecopages/radiant": "0.3.0-beta.0"
   }

package/src/ecopages-jsx-hmr-strategy.js

@@ -9,10 +9,11 @@ class EcopagesJsxHmrStrategy extends HmrStrategy {
     this.context = context;
   }
   matches(filePath) {
-    if (this.context.getWatchedFiles().has(filePath)) {
+    const resolvedPath = path.resolve(filePath);
+    const watchedFiles = this.context.getWatchedFiles();
+    if (watchedFiles.has(resolvedPath) || [...watchedFiles.keys()].some((key) => path.resolve(key) === resolvedPath)) {
       return false;
     }
-    const resolvedPath = path.resolve(filePath);
     const srcDir = path.resolve(this.context.getSrcDir());
     if (!resolvedPath.startsWith(`${srcDir}${path.sep}`) && resolvedPath !== srcDir) {
       return false;

package/src/ecopages-jsx.plugin.d.ts

@@ -1,5 +1,6 @@
 import { IntegrationPlugin, type EcoBuildPlugin } from '@ecopages/core/plugins/integration-plugin';
 import type { HmrStrategy } from '@ecopages/core/hmr/hmr-strategy';
+import type { IHmrManager } from '@ecopages/core';
 import type { JsxRenderable } from '@ecopages/jsx';
 import { EcopagesJsxRenderer } from './ecopages-jsx-renderer.js';
 import type { EcopagesJsxPluginOptions } from './ecopages-jsx.types.js';
@@ -22,6 +23,8 @@ export declare class EcopagesJsxPlugin extends IntegrationPlugin<JsxRenderable>
     private getDependencies;
     /** Ensures MDX build hooks are ready before Ecopages collects contributions. */
     prepareBuildContributions(): Promise<void>;
+    /** Registers JSX HMR strategy and Radiant SSR invalidation hooks. */
+    setHmrManager(hmrManager: IHmrManager): void;
     /**
      * Returns the JSX-integration HMR strategy.
      *

package/src/ecopages-jsx.plugin.js

@@ -12,6 +12,7 @@ import {
 } from "./ecopages-jsx-mdx.js";
 import { EcopagesJsxRenderer } from "./ecopages-jsx-renderer.js";
 import { EcopagesJsxHmrStrategy } from "./ecopages-jsx-hmr-strategy.js";
+import { invalidateRadiantRegisteredScriptSsrRegistration } from "./radiant-registered-script-ssr-invalidation.js";
 const RADIANT_HYDRATOR_SCRIPT_ID = "ecopages-jsx-radiant-hydrator";
 const resolvePluginOptions = (options) => {
   const { extensions: userExtensions, radiant, mdx, ...baseConfig } = options ?? {};
@@ -86,6 +87,17 @@ class EcopagesJsxPlugin extends IntegrationPlugin {
   async prepareBuildContributions() {
     this.ensureMdxLoaderPlugin();
   }
+  /** Registers JSX HMR strategy and Radiant SSR invalidation hooks. */
+  setHmrManager(hmrManager) {
+    super.setHmrManager(hmrManager);
+    if (!this.includeRadiant || !this.appConfig) {
+      return;
+    }
+    const runtime = this.appConfig.runtime ?? {};
+    this.appConfig.runtime = runtime;
+    runtime.registeredScriptEntrypointChangeHandlers ??= [];
+    runtime.registeredScriptEntrypointChangeHandlers.push(invalidateRadiantRegisteredScriptSsrRegistration);
+  }
   /**
    * Returns the JSX-integration HMR strategy.
    *

package/src/radiant-registered-script-ssr-invalidation.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Reads the custom-element tag name from a registered script module source file.
+ */
+export declare function resolveRadiantCustomElementTag(scriptPath: string): string | undefined;
+/**
+ * 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 declare function clearRadiantCustomElementDefinition(tagName: string): void;
+/**
+ * Clears the SSR custom-element registry entry for one registered Radiant script module.
+ */
+export declare function invalidateRadiantRegisteredScriptSsrRegistration(scriptPath: string): void;

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

@@ -0,0 +1,36 @@
+import { existsSync, readFileSync } from "node:fs";
+const CUSTOM_ELEMENT_TAG_PATTERN = /@customElement\s*\(\s*['"`]([^'"`]+)['"`]/u;
+function resolveRadiantCustomElementTag(scriptPath) {
+  if (!existsSync(scriptPath)) {
+    return void 0;
+  }
+  const content = readFileSync(scriptPath, "utf8");
+  const match = content.match(CUSTOM_ELEMENT_TAG_PATTERN);
+  return match?.[1];
+}
+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);
+  }
+}
+function invalidateRadiantRegisteredScriptSsrRegistration(scriptPath) {
+  const tagName = resolveRadiantCustomElementTag(scriptPath);
+  if (!tagName) {
+    return;
+  }
+  clearRadiantCustomElementDefinition(tagName);
+}
+export {
+  clearRadiantCustomElementDefinition,
+  invalidateRadiantRegisteredScriptSsrRegistration,
+  resolveRadiantCustomElementTag
+};