@invisibleloop/pulse 0.20.57 → 0.20.58

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invisibleloop/pulse",
-  "version": "0.20.57",
+  "version": "0.20.58",
   "type": "module",
   "description": "AI-first frontend framework. The spec is the source of truth.",
   "license": "MIT",
@@ -76,7 +76,7 @@
   "scripts": {
     "dev": "node --watch src/cli/dev.js",
     "build": "node scripts/build.js",
-    "test": "node src/spec/schema.test.js && node src/runtime/runtime.test.js && node src/runtime/navigate.test.js && node src/runtime/morph.test.js && node src/runtime/ssr.test.js && node src/runtime/image.test.js && node src/server/server.test.js && node src/cli/cli.test.js && node src/cli/validate.test.js && node src/cli/diagnose.test.js && node src/cli/check-bundles.test.js && node src/cli/review.test.js && node src/cli/process-utils.test.js && node src/cli/stamp.test.js && node src/cli/feedback.test.js && node src/cli/update.test.js && node src/cli/dev-host.test.js && node src/ui/ui.test.js && node src/testing/testing.test.js && node src/store/store.test.js && node src/md/md.test.js && node scripts/strip-server.test.js && node scripts/css-purge.test.js && node scripts/release-version.test.js && node src/mcp/mcp.test.js && node src/mcp/guards.test.js",
+    "test": "node src/spec/schema.test.js && node src/runtime/runtime.test.js && node src/runtime/navigate.test.js && node src/runtime/morph.test.js && node src/runtime/ssr.test.js && node src/runtime/image.test.js && node src/server/server.test.js && node src/cli/cli.test.js && node src/cli/validate.test.js && node src/cli/diagnose.test.js && node src/cli/check-bundles.test.js && node src/cli/review.test.js && node src/cli/process-utils.test.js && node src/cli/stamp.test.js && node src/cli/feedback.test.js && node src/cli/update.test.js && node src/cli/dev-host.test.js && node src/cli/dev-reload.test.js && node src/ui/ui.test.js && node src/testing/testing.test.js && node src/store/store.test.js && node src/md/md.test.js && node scripts/strip-server.test.js && node scripts/css-purge.test.js && node scripts/release-version.test.js && node src/mcp/mcp.test.js && node src/mcp/guards.test.js",
     "typecheck": "tsc --noEmit",
     "docs": "node --watch src/cli/dev.js --root ../../docs --port 4000",
     "docs:start": "node ../../docs/server.js"

package/public/.pulse-ui-version

@@ -1 +1 @@
-0.20.57
+0.20.58

package/src/cli/dev.js

@@ -10,6 +10,8 @@
 
 import path    from 'path'
 import fs      from 'fs'
+import { register } from 'node:module'
+import { pathToFileURL } from 'node:url'
 import { createServer } from '../server/index.js'
 import { loadPages, loadStore } from './discover.js'
 import * as log         from './logger.js'
@@ -31,6 +33,14 @@ const ROOT = rootArg !== -1
 // resolve to the project root, not wherever the parent process was launched from.
 if (process.cwd() !== ROOT) process.chdir(ROOT)
 
+// Hot reload re-imports each page with a cache-busting stamp; this hook passes the stamp on
+// to the project modules the page imports, so editing src/lib or src/components takes
+// effect too (see reload-hooks.js). realpath: Node reports resolved URLs without symlinks.
+register('./reload-hooks.js', {
+  parentURL: import.meta.url,
+  data: { rootUrl: pathToFileURL(fs.realpathSync(ROOT)).href + '/' },
+})
+
 let _config = {}
 const configPath = path.join(ROOT, 'pulse.config.js')
 if (fs.existsSync(configPath)) {

package/src/cli/discover.js

@@ -14,6 +14,7 @@
 
 import fs   from 'fs'
 import path from 'path'
+import { pathToFileURL } from 'url'
 
 /**
  * Derive a route from a file path relative to the pages directory.
@@ -136,7 +137,7 @@ export async function loadStore(projectRoot, cacheBust = null) {
   const storePath = path.join(projectRoot, 'pulse.store.js')
   if (!fs.existsSync(storePath)) return null
 
-  const url = 'file://' + storePath + (cacheBust ? `?t=${cacheBust}` : '')
+  const url = pathToFileURL(storePath).href + (cacheBust ? `?t=${cacheBust}` : '')
   const mod = await import(url)
   const def = mod.default
   if (!def || typeof def !== 'object') {

package/src/cli/reload-hooks.js

@@ -0,0 +1,35 @@
+/**
+ * Pulse — module-loader hook for dev hot reload
+ *
+ * `pulse dev` re-imports each page with `?t=<stamp>` to dodge Node's ESM cache, but that
+ * only refreshes the page file: everything the page imports (src/lib, src/components, ...)
+ * resolves to the same URL as before and comes back stale from the cache. This hook gives
+ * a project module imported by a stamped module the same stamp, so the whole project
+ * graph is re-evaluated on a reload.
+ *
+ * Only the project's own files are stamped. Anything in node_modules, the framework
+ * itself, and `node:` builtins keep their URL, so packages (and framework singletons)
+ * are evaluated once rather than once per edit.
+ *
+ * Limits: CommonJS files (.cjs) are cached by path, so the stamp cannot refresh them, and
+ * modules outside the project root (e.g. a sibling workspace package) are neither stamped
+ * nor watched.
+ */
+
+let rootUrl = ''
+
+export function initialize(data) {
+  rootUrl = data.rootUrl
+}
+
+export async function resolve(specifier, context, nextResolve) {
+  const result = await nextResolve(specifier, context)
+  const url = result.url
+  if (!rootUrl || !url.startsWith(rootUrl) || url.includes('?')) return result
+  if (url.slice(rootUrl.length).includes('node_modules/')) return result // below the root: a project may itself live under a node_modules folder
+  if (!context.parentURL?.startsWith(rootUrl)) return result
+
+  const stamp = new URL(context.parentURL).searchParams.get('t')
+  if (!stamp || !/^\d+$/.test(stamp)) return result
+  return { ...result, url: `${url}?t=${stamp}` }
+}