mates 0.3.2 → 0.4.0-beta.1

package/dist/ssr/ssrFlag.d.ts

@@ -1,29 +1,22 @@
 /**
- * mates — SSR mode flag
+ * mates — SSR mode flag + async completion tracking
  *
- * A simple global boolean that browser-only hooks check before doing work.
- * When `setSSRMode(true)` is called (by mates-ssr's renderer before rendering),
- * hooks like onBlur, onFocus, onResize, onInterval, etc. skip their work
- * entirely — no event listeners, no timers, no observers.
+ * SSR mode flag:
+ *   A simple global boolean that browser-only hooks check before doing work.
+ *   When `setSSRMode(true)` is called (by mates-ssr's renderer before rendering),
+ *   hooks like onBlur, onFocus, onResize, onInterval, etc. skip their work
+ *   entirely — no event listeners, no timers, no observers.
  *
- * This is the lightest possible SSR guard: one boolean check per hook call.
+ * SSR async completion tracking:
+ *   Tracks in-flight asyncAction and Fetch calls during SSR.
+ *   When all async work completes (counter hits 0), a 5ms debounce fires
+ *   the registered done callback so the renderer knows it's safe to serialize.
  *
- * Usage (inside mates-ssr renderer):
+ *   asyncAction and Fetch call incrementSsrAsyncCounter() on start and
+ *   decrementSsrAsyncCounter() on finish (success or error).
  *
- *   import { setSSRMode } from "mates";
- *
- *   setSSRMode(true);
- *   // ... render components ...
- *   setSSRMode(false);
- *
- * Usage (inside a hook):
- *
- *   import { isSSR } from "../ssr/ssrFlag";
- *
- *   export const onBlur = (fn) => {
- *     if (isSSR()) return;
- *     // ... browser-only work ...
- *   };
+ *   The renderer registers a callback via setSsrDoneCallback() before rendering.
+ *   Users can also call done() explicitly to signal early completion.
  */
 /**
  * Enable or disable SSR mode.
@@ -35,4 +28,46 @@ export declare function setSSRMode(value: boolean): void;
  * Hooks should check this and bail early if true.
  */
 export declare function isSSR(): boolean;
+/**
+ * Register the callback the renderer will invoke when all async work is done.
+ * Called by the renderer once per render pass, before setup runs.
+ * @internal
+ */
+export declare function setSsrDoneCallback(cb: () => void): void;
+/**
+ * Increment the in-flight counter.
+ * Called by asyncAction and Fetch when they start an async operation during SSR.
+ * @internal
+ */
+export declare function incrementSsrAsyncCounter(): void;
+/**
+ * Decrement the in-flight counter.
+ * Called by asyncAction and Fetch when they finish (success or error).
+ * When counter hits 0, schedules the done callback with a 5ms debounce.
+ * @internal
+ */
+export declare function decrementSsrAsyncCounter(): void;
+/**
+ * Explicitly signal that the component is done with all async work.
+ * Call this if you have async work that happens outside asyncAction/Fetch
+ * and the renderer should not wait longer.
+ *
+ * @example
+ * export default (_: Props<{}>) => {
+ *   const data = asyncAction(fetchData);
+ *   data();
+ *
+ *   // If you have additional async work tracked manually:
+ *   done();
+ *
+ *   return () => html`...`;
+ * };
+ */
+export declare function done(): void;
+/**
+ * Returns the current number of in-flight SSR async operations.
+ * Useful for debugging and tests.
+ */
+export declare function getSsrAsyncCounter(): number;
+export declare function isDev(): boolean;
 //# sourceMappingURL=ssrFlag.d.ts.map

package/dist/ssr/ssrFlag.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssrFlag.d.ts","sourceRoot":"","sources":["../../lib/ssr/ssrFlag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAIH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE/C;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B"}
+{"version":3,"file":"ssrFlag.d.ts","sourceRoot":"","sources":["../../lib/ssr/ssrFlag.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAQ/C;AAED;;;GAGG;AACH,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAgBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAOvD;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAQ/C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAS3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAqBD,wBAAgB,KAAK,IAAI,OAAO,CAQ/B"}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "mates",
-  "version": "0.3.2",
+  "version": "0.4.0-beta.1",
   "type": "module",
   "description": "Mates is a front end framework for building web applications",
-  "main": "dist/index.esm.js",
+  "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
   "exports": {