mates-devtools 0.1.0-beta.5 → 0.1.0-beta.7

package/dist/types/lib/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/types/lib/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/dist/types/lib/ssr/useCtx.d.ts

@@ -0,0 +1,63 @@
+/**
+ * mates — useCtx
+ *
+ * Retrieves the current server-side Context (Hono-style) during SSR or
+ * RPC calls. Uses the same global AsyncLocalStorage key as mates-fullstack's
+ * ssr-context.ts, so it works inside the SSR esbuild bundle as well.
+ *
+ * Returns undefined when called outside a request context (e.g. client-side).
+ *
+ * @example
+ * // In a component outer function:
+ * const ctx = useCtx();
+ * if (ctx) {
+ *   console.log("request path:", ctx.req.path);
+ * }
+ */
+/**
+ * Minimal Ctx interface matching the Hono-style Context shape.
+ * Defined locally — mates doesn't import from mates-fullstack.
+ */
+export interface Ctx {
+    req: {
+        raw: Request;
+        method: string;
+        url: string;
+        path: string;
+        param(name: string): string | undefined;
+        query(name: string): string | undefined;
+        header(name: string): string | undefined;
+        params: Record<string, string>;
+        queries: Record<string, string>;
+    };
+    isSSR: boolean;
+    auth: Record<string, unknown> | null;
+    cookie: {
+        get(name: string): string | undefined;
+        getAll(): Record<string, string>;
+        set(name: string, value: string, options?: Record<string, unknown>): void;
+        delete(name: string, options?: Record<string, unknown>): void;
+    };
+    var: Record<string, unknown>;
+    set(key: string, value: unknown): void;
+    get(key: string): unknown;
+    [key: string]: unknown;
+}
+/**
+ * Get the current server-side Context (Hono-style).
+ *
+ * Returns `undefined` when called:
+ *  - On the client (browser)
+ *  - Outside a request handler
+ *
+ * Available when called:
+ *  - During SSR page rendering
+ *  - Inside RPC functions (both SSR and HTTP paths)
+ *  - Inside onRequest/onBeforeRPC/onAfterRPC hooks
+ */
+export declare function useCtx(): Ctx | undefined;
+/**
+ * Returns true when currently executing inside an SSR render pass.
+ */
+export declare function useIsSSR(): boolean;
+//# sourceMappingURL=useCtx.d.ts.map

package/dist/types/lib/ssr/useCtx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCtx.d.ts","sourceRoot":"","sources":["../../../../../lib/ssr/useCtx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH;;;GAGG;AACH,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE;QACH,GAAG,EAAE,OAAO,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACxC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACrC,MAAM,EAAE;QACN,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACtC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC1E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC/D,CAAC;IACF,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,IAAI,GAAG,GAAG,SAAS,CAUxC;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAUlC"}

package/dist/types/lib/virtualizer/Virtualizer.d.ts

@@ -86,6 +86,7 @@ export declare class Virtualizer {
      */
     private _childrenRO;
     private _mutationObserver;
+    private _scrollEndRafId;
     private _scrollEventListeners;
     private _scrollEventListenerOptions;
     private _loadListener;
@@ -117,7 +118,7 @@ export declare class Virtualizer {
      * Index of the last item intersecting the viewport.
      */
     private _lastVisible;
-    protected _scheduled: WeakSet<Function>;
+    protected _scheduled: Map<Function, number>;
     /**
      * Invoked at the end of each render cycle: children in the range are
      * measured, and their dimensions passed to this callback. Use it to layout
@@ -164,7 +165,7 @@ export declare class Virtualizer {
      * Returns the width, height, and margins of the given child.
      */
     _measureChild(element: Element): ItemBox;
-    protected _schedule(method: Function): Promise<void>;
+    protected _schedule(method: Function): void;
     _updateDOM(state: StateChangedMessage): Promise<void>;
     _finishDOMUpdate(): void;
     _updateLayout(): void;

package/dist/types/lib/virtualizer/Virtualizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Virtualizer.d.ts","sourceRoot":"","sources":["../../../../../lib/virtualizer/Virtualizer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Virtualizer.d.ts","sourceRoot":"","sources":["../../../../../lib/virtualizer/Virtualizer.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/virtualizer/layouts/shared/BaseLayout.d.ts

@@ -95,6 +95,14 @@ export declare abstract class BaseLayout<C extends BaseLayoutConfig> implements
      * in the active range of items.
      */
     protected _overhang: number;
+    /**
+     * Recompute _overhang whenever the viewport size changes.
+     * We use 2× the viewport's scroll-axis dimension so that
+     * the user can scroll at full speed without hitting blank rows.
+     * Minimum of 200px so tiny/zero-height viewports still pre-render
+     * a sensible buffer.
+     */
+    protected _updateOverhang(): void;
     /**
      * Call this to deliver messages (e.g. stateChanged, unpinned) to host
      */

package/dist/types/lib/virtualizer/layouts/shared/BaseLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseLayout.d.ts","sourceRoot":"","sources":["../../../../../../../lib/virtualizer/layouts/shared/BaseLayout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BaseLayout.d.ts","sourceRoot":"","sources":["../../../../../../../lib/virtualizer/layouts/shared/BaseLayout.ts"],"names":[],"mappings":"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"}

package/dist/types/lib/virtualizer/mates-adapter.d.ts

@@ -1,21 +1,17 @@
 /**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
+ * Mates adapter for the virtualizer engine.
  *
- * Mates adapter for @lit-labs/virtualizer (forked).
+ * Exposes two helpers:
+ *   - `virtualList`    — virtualised vertical list, drop-in for `repeat`.
+ *                        Supports dynamic item heights, dynamic container sizes,
+ *                        and dynamic item counts via ResizeObserver measurement.
+ *   - `virtualMasonry` — virtualised masonry grid with variable item heights.
  *
- * Exposes `virtualList`, `virtualGrid`, and `virtualMasonry` — the same
- * friendly API that mates users already know — but now backed by the
- * battle-tested lit virtualizer engine.
+ * Both are used directly in lit-html templates:
  *
- * Key improvement over the old repeatVirtual implementation:
- *   - `virtualList` no longer requires `itemHeight`. The FlowLayout uses
- *     ResizeObserver to measure each child's actual rendered height, just
- *     like the browser's native flow layout. Items can be any height and
- *     can change height dynamically.
- *   - `virtualGrid` and `virtualMasonry` still accept explicit sizes since
- *     the grid/masonry layouts need them for position pre-computation.
+ *   html`<div style="height:600px;overflow:auto">
+ *     ${virtualList(items, (item) => html`<div>${item.name}</div>`)}
+ *   </div>`
  */
 import type { TemplateResult } from "lit-html";
 import type { KeyFn } from "lit-html/directives/repeat.js";
@@ -28,7 +24,7 @@ export interface VirtualListOptions {
     direction?: "vertical" | "horizontal";
     /**
      * If true the virtualizer element itself becomes the scroller.
-     * Set an explicit height/width on the host element when using this.
+     * Give it an explicit height/width via CSS when using this.
      */
     scroller?: boolean;
     /**
@@ -41,16 +37,15 @@ export interface VirtualListOptions {
     };
 }
 /**
- * `virtualList` — virtualised single-column list backed by the lit virtualizer
- * FlowLayout.
+ * `virtualList` — virtualised list backed by the FlowLayout engine.
  *
- * Unlike the previous implementation, **no `itemHeight` is required**. Each
- * item is measured by a ResizeObserver after it renders, so items can have
- * any height — fixed, dynamic, or content-driven — and the virtualizer adapts
- * automatically.
+ * **No `itemHeight` required.** Each item is measured by a ResizeObserver
+ * after it renders, so items can have any height — fixed, dynamic, or
+ * content-driven — and the virtualizer adapts automatically. Also responds
+ * to container size changes and item count changes in real time.
  *
- * The parent element of the expression becomes the scroll container. Give it
- * a fixed height via CSS or inline style.
+ * The parent element of the expression becomes the scroll container.
+ * Give it a fixed height via CSS or inline style.
  *
  * @example
  * ```ts
@@ -77,76 +72,30 @@ export interface VirtualListOptions {
  *     { direction: 'horizontal' },
  *   )}
  * </div>`
- * ```
- */
-export declare function virtualList<T>(items: readonly T[], template: VirtualItemTemplate<T>, options?: VirtualListOptions): unknown;
-export declare function virtualList<T>(items: readonly T[], keyFn: VirtualKeyFn<T>, template: VirtualItemTemplate<T>, options?: VirtualListOptions): unknown;
-export interface VirtualGridOptions {
-    /**
-     * Item width in CSS pixel string, e.g. `'200px'`. Required.
-     */
-    itemWidth: `${number}px`;
-    /**
-     * Item height in CSS pixel string, e.g. `'200px'`. Required.
-     */
-    itemHeight: `${number}px`;
-    /**
-     * Gap between cells. Accepts any value supported by the grid layout,
-     * e.g. `'12px'`, `'12px 8px'`. Defaults to `'8px'`.
-     */
-    gap?: `${number}px` | `${number}px ${number}px`;
-    /**
-     * Scrolling direction. Defaults to `'vertical'`.
-     */
-    direction?: "vertical" | "horizontal";
-    /**
-     * If true the virtualizer element itself becomes the scroller.
-     */
-    scroller?: boolean;
-    /**
-     * Whether to flex items to fill available space. Defaults to `false`.
-     * Set to `true` to let the grid decide how many columns fit.
-     */
-    flex?: boolean;
-    /**
-     * Pin a specific item into view on first render.
-     */
-    pin?: {
-        index: number;
-        block?: ScrollLogicalPosition;
-    };
-}
-/**
- * `virtualGrid` — virtualised uniform multi-column grid.
- *
- * Pass flat items — no row-grouping needed. The grid layout computes row and
- * column positions automatically. All cells have the same size.
  *
- * @example
- * ```ts
- * html`<div style="height:600px;overflow:auto">
- *   ${virtualGrid(
- *     photos,
- *     (p) => p.id,
- *     (p) => html`<img src=${p.url} style="width:100%;height:100%;object-fit:cover" />`,
- *     { itemWidth: '220px', itemHeight: '220px', gap: '12px' },
+ * // Self-scrolling container (virtualizer is its own scroller)
+ * html`<div>
+ *   ${virtualList(
+ *     items,
+ *     (item) => html`<div>${item.name}</div>`,
+ *     { scroller: true },
  *   )}
  * </div>`
  * ```
  */
-export declare function virtualGrid<T>(items: readonly T[], template: VirtualItemTemplate<T>, options: VirtualGridOptions): unknown;
-export declare function virtualGrid<T>(items: readonly T[], keyFn: VirtualKeyFn<T>, template: VirtualItemTemplate<T>, options: VirtualGridOptions): unknown;
+export declare function virtualList<T>(items: readonly T[], template: VirtualItemTemplate<T>, options?: VirtualListOptions): unknown;
+export declare function virtualList<T>(items: readonly T[], keyFn: VirtualKeyFn<T>, template: VirtualItemTemplate<T>, options?: VirtualListOptions): unknown;
 export interface VirtualMasonryOptions {
     /**
      * A function that returns the aspect ratio (width / height) of each item.
-     * This is used by the masonry layout to compute item heights based on column
-     * width. Required.
+     * Used by the masonry layout to compute item heights from the column width.
+     * Required.
      */
     getAspectRatio: (item: unknown) => number;
     /**
-     * Item size (column width) as a CSS pixel string, e.g. `'300px'`.
-     * The masonry layout derives height from the aspect ratio, so only one
-     * dimension is needed. Defaults to `'300px'`.
+     * Column width as a CSS pixel string, e.g. `'300px'`.
+     * Height is derived from the aspect ratio.
+     * Defaults to `'300px'`.
      */
     itemSize?: `${number}px` | "0";
     /**
@@ -172,10 +121,9 @@ export interface VirtualMasonryOptions {
 /**
  * `virtualMasonry` — virtualised masonry grid with variable item heights.
  *
- * Positions are computed automatically using the lit virtualizer's MasonryLayout,
- * which places items in the shortest column (greedy algorithm). Provide
- * `getAspectRatio` to let the layout derive each item's height from its
- * column width.
+ * Items are placed into the shortest column (greedy algorithm). Provide
+ * `getAspectRatio` so the layout can derive each item's height from its
+ * column width without measuring.
  *
  * @example
  * ```ts
@@ -188,8 +136,8 @@ export interface VirtualMasonryOptions {
  *            style="width:100%;height:100%;object-fit:cover;border-radius:8px" />
  *     `,
  *     {
- *       getAspectRatio: (p) => p.width / p.height,
- *       itemWidth: '220px',
+ *       getAspectRatio: (p) => (p as Photo).width / (p as Photo).height,
+ *       itemSize: '220px',
  *       gap: '12px',
  *     },
  *   )}

package/dist/types/lib/virtualizer/mates-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mates-adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/virtualizer/mates-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mates-adapter.d.ts","sourceRoot":"","sources":["../../../../../lib/virtualizer/mates-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAS3D,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,cAAc,CAAC;AAChF,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAIvC,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,qBAAqB,CAAA;KAAE,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC;AACX,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC;AA6BX,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,GAAG,CAAC;IAC/B;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,MAAM,IAAI,GAAG,GAAG,MAAM,MAAM,MAAM,IAAI,CAAC;IAChD;;OAEG;IACH,SAAS,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACtC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,qBAAqB,CAAA;KAAE,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC;AACX,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAChC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mates-devtools",
-  "version": "0.1.0-beta.5",
+  "version": "0.1.0-beta.7",
   "description": "In-app DevTools panel for the Mates framework",
   "type": "module",
   "main": "./dist/mates-devtools.umd.js",

package/dist/types/lib/Router/pathResolver.d.ts

@@ -1,9 +0,0 @@
-export { buildPath } from "./buildPath";
-export { hashAtom } from "./hashAtom";
-export { isPathMatching } from "./isPathMatching";
-export { location } from "./location";
-export { navigateTo } from "./navigateTo";
-export { lockNavigation, navigationLocked, unlockNavigation, } from "./navigationLock";
-export { pathAtom } from "./pathAtom";
-export { qsAtom } from "./qsAtom";
-//# sourceMappingURL=pathResolver.d.ts.map

package/dist/types/lib/Router/pathResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pathResolver.d.ts","sourceRoot":"","sources":["../../../../../lib/Router/pathResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/lib/portals/tip.d.ts

@@ -1,38 +0,0 @@
-import type { TemplateResult } from "lit-html";
-import type { DirectiveResult } from "lit-html/directive.js";
-export type TipContent = string | TemplateResult;
-export interface TipStyle {
-    /** Extra inline styles applied to the tooltip element for this instance. */
-    style?: Partial<CSSStyleDeclaration>;
-    /** Override max-width (e.g. "400px", "none"). */
-    maxWidth?: string;
-    /** Override padding (e.g. "12px 20px"). */
-    padding?: string;
-    /** Override border-radius. */
-    borderRadius?: string;
-    /** Override font-size. */
-    fontSize?: string;
-    /** Override white-space (e.g. "normal" for wrapping). */
-    whiteSpace?: string;
-    /** Delay in ms before showing. Default 150. */
-    delay?: number;
-}
-/**
- * `tooltip(content, opts?)` — lightweight auto-positioning tooltip directive.
- *
- * Appends a singleton `position:fixed` div to `<body>` — escapes any
- * `overflow:hidden`, `transform`, or stacking context. Automatically places
- * above or below the trigger based on available viewport space.
- *
- * Per-instance style overrides are applied at show-time and reset at hide-time
- * so the singleton is always clean for the next tooltip.
- *
- * @example
- * html`<button ${tooltip("Save changes")}>Save</button>`
- * html`<button ${tooltip("Long text", { maxWidth: "300px", whiteSpace: "normal" })}>Info</button>`
- * html`<button ${tooltip(html`Press <kbd>Ctrl+S</kbd>`)}>Save</button>`
- */
-export declare function tooltip(content: TipContent, opts?: TipStyle): DirectiveResult;
-/** Alias — kept for backward compatibility. */
-export declare const tip: typeof tooltip;
-//# sourceMappingURL=tip.d.ts.map

package/dist/types/lib/portals/tip.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tip.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/tip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,cAAc,CAAC;AAEjD,MAAM,WAAW,QAAQ;IACvB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAwPD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,UAAU,EACnB,IAAI,GAAE,QAAa,GAClB,eAAe,CAEjB;AAED,+CAA+C;AAC/C,eAAO,MAAM,GAAG,gBAAU,CAAC"}

package/dist/types/lib/virtualizer/layouts/grid.d.ts

@@ -1,25 +0,0 @@
-/**
- * @license
- * Copyright 2021 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */
-import { GridBaseLayout, type GridBaseLayoutConfig } from "./shared/GridBaseLayout.js";
-import type { LayoutHostSink, Positions, Size } from "./shared/Layout.js";
-type GridLayoutSpecifier = GridBaseLayoutConfig & {
-    type: new (hostSink: LayoutHostSink, config?: GridBaseLayoutConfig) => GridLayout;
-};
-type GridLayoutSpecifierFactory = (config?: GridBaseLayoutConfig) => GridLayoutSpecifier;
-export declare const grid: GridLayoutSpecifierFactory;
-export declare class GridLayout extends GridBaseLayout<GridBaseLayoutConfig> {
-    /**
-     * Returns the average size (precise or estimated) of an item in the scrolling direction,
-     * including any surrounding space.
-     */
-    protected get _delta(): number;
-    protected _getItemSize(_idx: number): Size;
-    _getActiveItems(): void;
-    _getItemPosition(idx: number): Positions;
-    _updateScrollSize(): void;
-}
-export {};
-//# sourceMappingURL=grid.d.ts.map

package/dist/types/lib/virtualizer/layouts/grid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"grid.d.ts","sourceRoot":"","sources":["../../../../../../lib/virtualizer/layouts/grid.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1E,KAAK,mBAAmB,GAAG,oBAAoB,GAAG;IAChD,IAAI,EAAE,KACJ,QAAQ,EAAE,cAAc,EACxB,MAAM,CAAC,EAAE,oBAAoB,KAC1B,UAAU,CAAC;CACjB,CAAC;AAEF,KAAK,0BAA0B,GAAG,CAChC,MAAM,CAAC,EAAE,oBAAoB,KAC1B,mBAAmB,CAAC;AAEzB,eAAO,MAAM,IAAI,EAAE,0BAQhB,CAAC;AAEJ,qBAAa,UAAW,SAAQ,cAAc,CAAC,oBAAoB,CAAC;IAClE;;;OAGG;IACH,SAAS,KAAK,MAAM,WAEnB;IAED,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO1C,eAAe;IA+Bf,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAYxC,iBAAiB;CAUlB"}