@srfnstack/fntags 1.2.4 → 1.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@srfnstack/fntags",
-  "version": "1.2.4",
+  "version": "1.2.6",
   "author": "Robert Kempton <r@snow87.com>",
   "private": false,
   "homepage": "https://github.com/srfnstack/fntags",

package/src/fntags.d.mts

@@ -92,6 +92,16 @@ export function getAttrs(children: any): object;
  * @return {T} The styled element
  */
 export function styled<T extends HTMLElement | SVGElement>(style: object | string, tag: string, children: object[] | Node[]): T;
+/**
+ * Register a component function for HMR. Returns a stable proxy that always delegates
+ * to the latest registered implementation. When a module re-executes after HMR, the
+ * proxy's target is updated so callers holding stale import bindings get the new code.
+ *
+ * @param {string} id A stable identifier for this component (typically 'filepath:exportName')
+ * @param {Function} fn The component function
+ * @returns {Function} A stable proxy function
+ */
+export function registeredComponent(id: string, fn: Function): Function;
 /**
  * Get or create a state instance from the global HMR registry.
  * During development with HMR, the Vite plugin rewrites fnstate() calls to use this function,
@@ -104,18 +114,15 @@ export function styled<T extends HTMLElement | SVGElement>(style: object | strin
  */
 export function registeredState(id: string, initialValue: any, mapKey?: (v: any) => string): any;
 /**
- * Create an HMR-aware root mount point. Call this in your entry file to mount your app.
- * The returned `rerender` function can be called from an HMR accept callback to re-render
- * the app with new code while preserving state (via registeredState).
+ * Create an HMR-aware root mount point. Renders the app into the container and
+ * registers a global rerender callback so the vite plugin can trigger re-renders
+ * automatically when modules are hot-updated.
  *
  * @param {HTMLElement} container The DOM element to mount into
  * @param {(()=>Node)|Node} appFn A function that returns the app's root element, or the element itself
- * @returns {{ container: HTMLElement, rerender: () => void }}
+ * @returns {HTMLElement} The container element
  */
-export function hmrRoot(container: HTMLElement, appFn: (() => Node) | Node): {
-    container: HTMLElement;
-    rerender: () => void;
-};
+export function hmrRoot(container: HTMLElement, appFn: (() => Node) | Node): HTMLElement;
 /**
  * Create a compiled template function. The returned function takes a single object that contains the properties
  * defined in the template.

package/src/fntags.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"fntags.d.mts","sourceRoot":"","sources":["fntags.mjs"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,2DALW,MAAM,eACH,CAAC,IAAI,MAAO,CAAC,OA6C1B;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH,iEAPgB,GAAG,cAqIlB;AAqfD;;;;GAIG;AACH,iCAHW,GAAG,GACD,IAAI,CAuBhB;AAqFD;;;;GAIG;AACH,6BAHW,GAAG,GACD,OAAO,CAInB;AAED;;;;GAIG;AACH,mCAHW,GAAG,GACF,MAAM,CAIjB;AAED;;;;;;;;;;GAUG;AACH,kEALW,MAAM,GAAC,MAAM,OACb,MAAM,YACN,MAAM,EAAE,GAAC,IAAI,EAAE,KAezB;AAOD;;;;;;;;;GASG;AACH,oCALW,MAAM,gBACN,GAAG,eACE,GAAG,KAAK,MAAM,OAc7B;AAED;;;;;;;;GAQG;AACH,mCAJW,WAAW,SACX,CAAC,MAAI,IAAI,CAAC,GAAC,IAAI,GACb;IAAE,SAAS,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;CAAE,CAU5D;AAED;;;;;;;;;;;;;;;GAeG;AACH,qDAJkB,IAAI,iBACH,IAAI,CA+DtB;;;;;;;;;kCAj7BmC,CAAC,YAAY,CAAC,KAAG,CAAC,IAAI,GAAC,GAAG,CAAC,KAAG,IAAI;;;;;;2BAE/C,CAAC,MAAI,CAAC,IAAI,GAAC,GAAG,CAAC,CAAC,GAAC,GAAG,GAAC,IAAI,gCAAkC,CAAC,IAAI,GAAC,GAAG,CAAC,KAAG,IAAI;;;;;qBAG9E,MAAM,KAAG,IAAI;;;;sCAEI,CAAC,YAAY,CAAC,KAAG,CAAC,MAAM,GAAC,GAAG,CAAC,KAAG,GAAG;;;;mCACvC,CAAC,YAAY,CAAC,KAAG,MAAM,KAAK,MAAM;;;;yCAC7B,GAAG,KAAG,CAAC,IAAI,GAAC,GAAG,CAAC,KAAG,IAAI;;;;+CACrB,GAAG,KAAG,CAAC,MAAM,GAAC,GAAG,CAAC,KAAG,GAAG;;;;;;kBAC7C,GAAG,KAAG,IAAI;;;;cAGhB,MAAK,GAAG;;;;;qBACC,CAAC,KAAG,IAAI;;;;;;oBAEV,MAAM,KAAG,GAAG;;;;oBAGZ,MAAM,SAAS,GAAG,mBAAmB,OAAO,KAAG,IAAI;;;;uCAClC,CAAC,YAAY,CAAC,KAAG,IAAI,KAAK,IAAI;;;;eACtD,OAAO;;;;;sDAKqB,CAAC,KAAG,CAAC"}
+{"version":3,"file":"fntags.d.mts","sourceRoot":"","sources":["fntags.mjs"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,2DALW,MAAM,eACH,CAAC,IAAI,MAAO,CAAC,OA6C1B;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH,iEAPgB,GAAG,cAqIlB;AAqfD;;;;GAIG;AACH,iCAHW,GAAG,GACD,IAAI,CAuBhB;AAqFD;;;;GAIG;AACH,6BAHW,GAAG,GACD,OAAO,CAInB;AAED;;;;GAIG;AACH,mCAHW,GAAG,GACF,MAAM,CAIjB;AAED;;;;;;;;;;GAUG;AACH,kEALW,MAAM,GAAC,MAAM,OACb,MAAM,YACN,MAAM,EAAE,GAAC,IAAI,EAAE,KAezB;AAOD;;;;;;;;GAQG;AACH,wCAJW,MAAM,0BAiBhB;AAED;;;;;;;;;GASG;AACH,oCALW,MAAM,gBACN,GAAG,eACE,GAAG,KAAK,MAAM,OAc7B;AAED;;;;;;;;GAQG;AACH,mCAJW,WAAW,SACX,CAAC,MAAI,IAAI,CAAC,GAAC,IAAI,GACb,WAAW,CAWvB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qDAJkB,IAAI,iBACH,IAAI,CA+DtB;;;;;;;;;kCA18BmC,CAAC,YAAY,CAAC,KAAG,CAAC,IAAI,GAAC,GAAG,CAAC,KAAG,IAAI;;;;;;2BAE/C,CAAC,MAAI,CAAC,IAAI,GAAC,GAAG,CAAC,CAAC,GAAC,GAAG,GAAC,IAAI,gCAAkC,CAAC,IAAI,GAAC,GAAG,CAAC,KAAG,IAAI;;;;;qBAG9E,MAAM,KAAG,IAAI;;;;sCAEI,CAAC,YAAY,CAAC,KAAG,CAAC,MAAM,GAAC,GAAG,CAAC,KAAG,GAAG;;;;mCACvC,CAAC,YAAY,CAAC,KAAG,MAAM,KAAK,MAAM;;;;yCAC7B,GAAG,KAAG,CAAC,IAAI,GAAC,GAAG,CAAC,KAAG,IAAI;;;;+CACrB,GAAG,KAAG,CAAC,MAAM,GAAC,GAAG,CAAC,KAAG,GAAG;;;;;;kBAC7C,GAAG,KAAG,IAAI;;;;cAGhB,MAAK,GAAG;;;;;qBACC,CAAC,KAAG,IAAI;;;;;;oBAEV,MAAM,KAAG,GAAG;;;;oBAGZ,MAAM,SAAS,GAAG,mBAAmB,OAAO,KAAG,IAAI;;;;uCAClC,CAAC,YAAY,CAAC,KAAG,IAAI,KAAK,IAAI;;;;eACtD,OAAO;;;;;sDAKqB,CAAC,KAAG,CAAC"}

package/src/fntags.mjs

@@ -913,6 +913,30 @@ const stringifyStyle = style =>
     ? style
     : Object.keys(style).map(prop => `${prop}:${style[prop]}`).join(';')
 
+/**
+ * Register a component function for HMR. Returns a stable proxy that always delegates
+ * to the latest registered implementation. When a module re-executes after HMR, the
+ * proxy's target is updated so callers holding stale import bindings get the new code.
+ *
+ * @param {string} id A stable identifier for this component (typically 'filepath:exportName')
+ * @param {Function} fn The component function
+ * @returns {Function} A stable proxy function
+ */
+export function registeredComponent (id, fn) {
+  if (!globalThis.__fntags_components) {
+    globalThis.__fntags_components = new Map()
+  }
+  const reg = globalThis.__fntags_components
+  reg.set(id, fn)
+  if (!reg.has(id + '$proxy')) {
+    const proxy = function (...args) {
+      return reg.get(id).apply(this, args)
+    }
+    reg.set(id + '$proxy', proxy)
+  }
+  return reg.get(id + '$proxy')
+}
+
 /**
  * Get or create a state instance from the global HMR registry.
  * During development with HMR, the Vite plugin rewrites fnstate() calls to use this function,
@@ -937,13 +961,13 @@ export function registeredState (id, initialValue, mapKey) {
 }
 
 /**
- * Create an HMR-aware root mount point. Call this in your entry file to mount your app.
- * The returned `rerender` function can be called from an HMR accept callback to re-render
- * the app with new code while preserving state (via registeredState).
+ * Create an HMR-aware root mount point. Renders the app into the container and
+ * registers a global rerender callback so the vite plugin can trigger re-renders
+ * automatically when modules are hot-updated.
  *
  * @param {HTMLElement} container The DOM element to mount into
  * @param {(()=>Node)|Node} appFn A function that returns the app's root element, or the element itself
- * @returns {{ container: HTMLElement, rerender: () => void }}
+ * @returns {HTMLElement} The container element
  */
 export function hmrRoot (container, appFn) {
   const render = () => {
@@ -952,7 +976,8 @@ export function hmrRoot (container, appFn) {
     container.appendChild(renderNode(result))
   }
   render()
-  return { container, rerender: render }
+  globalThis.__fntags_hmr_rerender = render
+  return container
 }
 
 /**