@srfnstack/fntags 1.2.3 → 1.2.4

package/package.json

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

package/src/fntags.d.mts

@@ -92,6 +92,30 @@ 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;
+/**
+ * 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,
+ * ensuring state instances survive module reloads.
+ *
+ * @param {string} id A stable identifier for this state instance (typically 'filepath:varName')
+ * @param {any} initialValue The initial value, used only when creating a new state
+ * @param {((v: any) => string)?} [mapKey] Optional key function, used only when creating a new state
+ * @returns {FnState} The state instance from the registry
+ */
+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).
+ *
+ * @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 }}
+ */
+export function hmrRoot(container: HTMLElement, appFn: (() => Node) | Node): {
+    container: HTMLElement;
+    rerender: () => void;
+};
 /**
  * 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;;;;;;;;;;;;;;;GAeG;AACH,qDAJkB,IAAI,iBACH,IAAI,CA+DtB;;;;;;;;;kCAv4BmC,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;;;;;;;;;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"}

package/src/fntags.mjs

@@ -913,6 +913,48 @@ const stringifyStyle = style =>
     ? style
     : Object.keys(style).map(prop => `${prop}:${style[prop]}`).join(';')
 
+/**
+ * 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,
+ * ensuring state instances survive module reloads.
+ *
+ * @param {string} id A stable identifier for this state instance (typically 'filepath:varName')
+ * @param {any} initialValue The initial value, used only when creating a new state
+ * @param {((v: any) => string)?} [mapKey] Optional key function, used only when creating a new state
+ * @returns {FnState} The state instance from the registry
+ */
+export function registeredState (id, initialValue, mapKey) {
+  if (!globalThis.__fntags_registry) {
+    globalThis.__fntags_registry = new Map()
+  }
+  const registry = globalThis.__fntags_registry
+  if (registry.has(id)) {
+    return registry.get(id)
+  }
+  const state = fnstate(initialValue, mapKey)
+  registry.set(id, state)
+  return state
+}
+
+/**
+ * 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).
+ *
+ * @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 }}
+ */
+export function hmrRoot (container, appFn) {
+  const render = () => {
+    container.innerHTML = ''
+    const result = typeof appFn === 'function' ? appFn() : appFn
+    container.appendChild(renderNode(result))
+  }
+  render()
+  return { container, rerender: render }
+}
+
 /**
  * Create a compiled template function. The returned function takes a single object that contains the properties
  * defined in the template.