mates 0.4.1 → 0.4.2

package/dist/ssr/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./ssr-bridge";
 export * from "./ssrFlag";
+export * from "./ssr-render-store";
 export * from "./useCtx";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/ssr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/ssr/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC"}

package/dist/ssr/ssr-bridge.d.ts

@@ -1,42 +1,8 @@
 /**
  * mates — ssr/ssr-bridge.ts
  *
- * A tiny, zero-dependency module that holds two pieces of shared state
- * needed for the Fetch SSR shortcut:
- *
- *   _ssrApiLookup  — a function wired in by mates-ssr at server startup.
- *                    When set, FetchClient.fetch() calls API handlers
- *                    directly instead of making real HTTP requests.
- *
- *   _ssrRequest    — the original HTTP Request for the current SSR render
- *                    pass. Set by mates-ssr's server before each renderPage()
- *                    call so that Fetch can forward cookies / auth headers
- *                    to directly-called API handlers.
- *
- * Why a separate file?
- *
- *   mates-ssr's server.ts needs to import these setters at the top level.
- *   server.ts is re-exported through mates-ssr's index.ts, which is imported
- *   by the user's mates.config.ts — BEFORE bootRenderer() has been called
- *   and BEFORE happy-dom has patched globalThis.document.
- *
- *   If the setters lived in Fetch.ts, importing them would pull in the entire
- *   mates bundle (lit-html, x-view custom element, etc.) at config-load time,
- *   triggering "document is not defined" before the DOM shim is ready.
- *
- *   This file has NO imports whatsoever. It is safe to import at any point
- *   in the process lifecycle, including before bootRenderer().
- *
- * Consumers:
- *   - mates/lib/Fetch/Fetch.ts        reads _ssrApiLookup and _ssrRequest
- *   - mates-ssr/src/server.ts         writes both via the exported setters
- *   - mates/lib/index.ts              re-exports the setters as public API
- */
-/**
- * The shape of the API handler lookup function supplied by mates-ssr.
- *
- * Takes a method ("GET", "POST", …) and a pathname ("/api/users") and
- * returns the matching handler + route context, or null when nothing matches.
+ * API lookup + request for Fetch SSR shortcut.
+ * Per-render values come from AsyncLocalStorage when mates-ssr is active.
  */
 export type ApiLookupFn = (method: string, pathname: string) => {
     handler: (req: Request, ctx: {
@@ -46,44 +12,8 @@ export type ApiLookupFn = (method: string, pathname: string) => {
         params: Record<string, string>;
     };
 } | null;
-/**
- * Wire in the API handler registry from mates-ssr.
- *
- * Called once by mates-ssr's startServer() after scanning src/api/.
- * Pass null on server shutdown to unregister.
- *
- * @example
- * // mates-ssr/src/server.ts
- * import { setSSRApiLookup } from "mates";
- * setSSRApiLookup(lookupApiHandler);   // startup
- * setSSRApiLookup(null);               // shutdown
- */
 export declare function setSSRApiLookup(fn: ApiLookupFn | null): void;
-/**
- * Store the original HTTP Request for the current SSR render pass.
- *
- * Called by mates-ssr's renderPage() immediately before the component
- * outer function runs, and cleared (null) in the finally block.
- *
- * Fetch.ts reads this to forward cookies and auth headers to directly-
- * called API handlers so the handler sees real auth state.
- *
- * @example
- * // mates-ssr/src/server.ts
- * import { setSSRRequest } from "mates";
- * setSSRRequest(req);      // before render
- * setSSRRequest(null);     // after render (finally block)
- */
 export declare function setSSRRequest(req: Request | null): void;
-/**
- * Returns the currently wired API lookup function, or null when not set.
- * Called on every FetchClient.fetch() call during SSR.
- */
 export declare function getSSRApiLookup(): ApiLookupFn | null;
-/**
- * Returns the original HTTP Request for the current SSR render pass,
- * or null when called outside an SSR context.
- * Called by FetchClient.fetch() to forward auth headers.
- */
 export declare function getSSRRequest(): Request | null;
 //# sourceMappingURL=ssr-bridge.d.ts.map

package/dist/ssr/ssr-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-bridge.d.ts","sourceRoot":"","sources":["../../lib/ssr/ssr-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb;IACH,OAAO,EAAE,CACP,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KACpC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACzC,GAAG,IAAI,CAAC;AAST;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAEvD;AAID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,GAAG,IAAI,CAE9C"}
+{"version":3,"file":"ssr-bridge.d.ts","sourceRoot":"","sources":["../../lib/ssr/ssr-bridge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,KACb;IACH,OAAO,EAAE,CACP,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KACpC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,GAAG,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CACzC,GAAG,IAAI,CAAC;AAMT,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAG5D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,CAGvD;AAED,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAIpD;AAED,wBAAgB,aAAa,IAAI,OAAO,GAAG,IAAI,CAI9C"}

package/dist/ssr/ssr-render-store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * mates — ssr-render-store.ts
+ *
+ * Per-render SSR state accessor (AsyncLocalStorage-backed in mates-ssr).
+ * Browser-safe: no node:async_hooks import here.
+ */
+import type { ApiLookupFn } from "./ssr-bridge.js";
+export interface SsrRenderStore {
+    /** Nesting depth for nested render calls within one request. */
+    depth: number;
+    asyncCounter: number;
+    doneCallback: (() => void) | null;
+    doneTimer: ReturnType<typeof setTimeout> | null;
+    request: Request | null;
+    apiLookup: ApiLookupFn | null;
+}
+export interface SsrRenderAccessor {
+    getStore(): SsrRenderStore | undefined;
+}
+/** @internal Registered by mates-ssr at startup. */
+export declare function registerSsrRenderAccessor(accessor: SsrRenderAccessor | null): void;
+export declare function getActiveSsrRenderStore(): SsrRenderStore | undefined;
+//# sourceMappingURL=ssr-render-store.d.ts.map

package/dist/ssr/ssr-render-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-render-store.d.ts","sourceRoot":"","sources":["../../lib/ssr/ssr-render-store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,IAAI,CAAC;IAChD,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,IAAI,cAAc,GAAG,SAAS,CAAC;CACxC;AAID,oDAAoD;AACpD,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,GACjC,IAAI,CAGN;AAED,wBAAgB,uBAAuB,IAAI,cAAc,GAAG,SAAS,CAKpE"}

package/dist/ssr/ssrFlag.d.ts

@@ -1,73 +1,25 @@
 /**
  * mates — SSR mode flag + async completion tracking
  *
- * 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.
- *
- * 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.
- *
- *   asyncAction and Fetch call incrementSsrAsyncCounter() on start and
- *   decrementSsrAsyncCounter() on finish (success or error).
- *
- *   The renderer registers a callback via setSsrDoneCallback() before rendering.
- *   Users can also call done() explicitly to signal early completion.
+ * Per-render state lives in AsyncLocalStorage when mates-ssr is loaded
+ * (via registerSsrRenderAccessor). Legacy module-level fallbacks remain for
+ * tests and direct renderToString() without a render context.
  */
 /**
- * Enable or disable SSR mode.
- * When enabled, browser-only hooks become no-ops.
+ * Enable or disable SSR mode (legacy / standalone renders).
+ * When mates-ssr wraps a render in AsyncLocalStorage, this is a no-op.
  */
 export declare function setSSRMode(value: boolean): void;
-/**
- * Returns true when the framework is running inside an SSR render pass.
- * Hooks should check this and bail early if true.
- */
+/** Returns true during an SSR render pass. */
 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
- */
+/** @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
- */
+/** @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
- */
+/** @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`...`;
- * };
- */
+/** Signal early completion for custom async outside asyncAction/Fetch. */
 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;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"ssrFlag.d.ts","sourceRoot":"","sources":["../../lib/ssr/ssrFlag.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6FH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAI/C;AAED,8CAA8C;AAC9C,wBAAgB,KAAK,IAAI,OAAO,CAE/B;AAED,gBAAgB;AAChB,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAIvD;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,gBAAgB;AAChB,wBAAgB,wBAAwB,IAAI,IAAI,CAI/C;AAED,0EAA0E;AAC1E,wBAAgB,IAAI,IAAI,IAAI,CAO3B;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAmBD,wBAAgB,KAAK,IAAI,OAAO,CAQ/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mates",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Mates is a front end framework for building web applications",
   "main": "dist/index.js",