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

package/dist/types/lib/indexdb/types.d.ts.map

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

package/dist/types/lib/minidb/index.d.ts

@@ -0,0 +1,3 @@
+export type { MiniDBInstance, MiniDBList, MiniDBMigrateFn, MiniDBMigrator, } from "./minidb";
+export { miniDB } from "./minidb";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/minidb/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/minidb/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/lib/minidb/minidb.d.ts

@@ -0,0 +1,105 @@
+export type MiniDBMigrator = {
+    /** Wipe all records from a list during migration. */
+    clear(listName: string): void;
+};
+export type MiniDBMigrateFn = (oldVersion: number, newVersion: number, migrator: MiniDBMigrator) => void;
+/**
+ * A reactive list backed by an IndexedDB object store.
+ *
+ * Calling `list()` returns a plain `T[]` and registers the list as a reactive
+ * dependency — components and effects re-run automatically when any item
+ * changes.  The returned array is a normal JS array so `.filter()`, `.sort()`,
+ * `.map()` etc. work directly.
+ *
+ * All write methods (`add`, `set`, `update`, `deleteRow`, `clear`) are async
+ * and persist to IndexedDB before resolving.  Every write is also broadcast to
+ * other tabs via `BroadcastChannel` so their atoms stay in sync.
+ */
+export type MiniDBList<T> = {
+    /** Reactive — returns all items as `T[]`. Tracks as a dependency. */
+    (): T[];
+    /** Reactive point lookup by id. */
+    get(id: string): T | undefined;
+    /** Reactive existence check by id. */
+    has(id: string): boolean;
+    /** Reactive item count. */
+    readonly size: number;
+    /**
+     * Add an item. Uses the item's `id` field as the key when present,
+     * otherwise auto-generates a UUID and assigns it.
+     * @returns The id used.
+     */
+    add(item: T): Promise<string>;
+    /** Upsert — insert if absent, replace if present. */
+    set(id: string, item: T): Promise<void>;
+    /** Draft-style mutation — modify the item in-place, then persist. */
+    update(id: string, fn: (item: T) => void): Promise<void>;
+    /** Delete one item by id. */
+    deleteRow(id: string): Promise<void>;
+    /** Remove all items from the list. */
+    clear(): Promise<void>;
+};
+export type MiniDBInstance = {
+    /**
+     * Returns a reactive list for the given name.
+     * The underlying IDB object store is created automatically on first call.
+     *
+     * Await calls sequentially when requesting multiple new lists — each new
+     * list may internally close and reopen the database to add the store.
+     */
+    list<T>(name: string): Promise<MiniDBList<T>>;
+};
+/**
+ * Opens (or creates) the opinionated `"mini-db"` IndexedDB database.
+ *
+ * - **Fixed name** — always `"mini-db"`, cannot be changed.
+ * - **No schema** — object stores are created automatically on first
+ *   `db.list()` call.
+ * - **Designed for ≤ 1 000 records per list** — all data is held in memory
+ *   as a reactive `mapAtom`.  Components re-render automatically on any write.
+ * - **No cursors, no indexes, no query builder** — use plain JS array methods
+ *   (`filter`, `sort`, `map`, …) on the result of `list()`.
+ * - **Cross-tab sync** — writes broadcast via `BroadcastChannel` so every
+ *   open tab's atoms reflect changes immediately without polling.
+ *
+ * @param version    App-level data version (default `1`).  Increment to
+ *                   trigger the `onMigrate` callback.
+ * @param onMigrate  Called once when `version` changes.  Use
+ *                   `migrator.clear("listName")` to wipe stale data.
+ *
+ * @example
+ * ```ts
+ * interface User { id: string; name: string; role: string }
+ *
+ * // One shared instance — open at module level, export and reuse everywhere.
+ * export const db = await miniDB(2, (oldV, newV, m) => {
+ *   if (oldV < 2) m.clear("users");
+ * });
+ *
+ * const users = await db.list<User>("users");
+ *
+ * // ── Reactive template ─────────────────────────────────────────────────────
+ * html`
+ *   ${users()
+ *     .filter(u => u.role === "admin")
+ *     .sort((a, b) => a.name.localeCompare(b.name))
+ *     .map(u => html`<li>${u.name}</li>`)}
+ * `
+ *
+ * // ── Writes (IDB + atom + broadcast to other tabs) ─────────────────────────
+ * await users.add({ id: "u1", name: "Alice", role: "admin" });
+ * await users.add({ name: "Bob", role: "user" });      // auto-generates id
+ * await users.set("u1", { id: "u1", name: "Alice B.", role: "admin" });
+ * await users.update("u1", u => { u.role = "mod"; });
+ * await users.deleteRow("u1");
+ * await users.clear();
+ *
+ * // ── Reactive reads ────────────────────────────────────────────────────────
+ * users();           // User[]
+ * users.get("u1");   // User | undefined
+ * users.has("u1");   // boolean
+ * users.size;        // number
+ * ```
+ */
+export declare function miniDB(version?: number, onMigrate?: MiniDBMigrateFn): Promise<MiniDBInstance>;
+//# sourceMappingURL=minidb.d.ts.map

package/dist/types/lib/minidb/minidb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minidb.d.ts","sourceRoot":"","sources":["../../../../../lib/minidb/minidb.ts"],"names":[],"mappings":"AAgDA,MAAM,MAAM,cAAc,GAAG;IAC3B,qDAAqD;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,cAAc,KACrB,IAAI,CAAC;AAEV;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC;IACR,mCAAmC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/B,sCAAsC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,qDAAqD;IACrD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,qEAAqE;IACrE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,6BAA6B;IAC7B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,sCAAsC;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;OAMG;IACH,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/C,CAAC;AAwNF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAsB,MAAM,CAC1B,OAAO,SAAI,EACX,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,cAAc,CAAC,CAqDzB"}

package/dist/types/lib/on/hooks.d.ts.map

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

package/dist/types/lib/portals/floating-container.d.ts

@@ -0,0 +1,129 @@
+/**
+ * floating-container.ts
+ *
+ * Shared low-level utility for creating a `position:fixed` container element
+ * that lives on `document.body` (or a custom target).
+ *
+ * All portal-style primitives in this library (`portal`, `popup`,
+ * `cascading-popup-list`, etc.) ultimately need the same three operations:
+ *   1. Create a fixed-position div with a z-index above everything else.
+ *   2. Lazily attach it to the DOM exactly once — only when content needs to
+ *      be shown, never eagerly on component mount.
+ *   3. Remove it cleanly when the component unmounts or the panel closes.
+ *
+ * Centralising this here ensures every floating surface shares identical
+ * defaults, avoids the "orphaned div" bug that comes from eagerly calling
+ * `document.body.appendChild` at mount time, and gives one place to tweak
+ * z-index, default styles, or target element logic across the whole library.
+ *
+ * ─── Usage ────────────────────────────────────────────────────────────────────
+ *
+ * ```ts
+ * // Create (not yet in DOM)
+ * const { el, attach, detach, isAttached } = createFloatingContainer();
+ *
+ * // Lazily attach when you actually need to show something
+ * attach();
+ * el.style.top = "100px";
+ * el.style.left = "200px";
+ * litRender(myTemplate, el);
+ *
+ * // Detach when done
+ * detach();
+ * ```
+ *
+ * Apply extra styles at creation time:
+ * ```ts
+ * const { el, attach, detach } = createFloatingContainer({
+ *   style: {
+ *     minWidth: "10rem",
+ *     background: "var(--md-color-surface)",
+ *     border: "0.06rem solid var(--md-color-border)",
+ *     borderRadius: "var(--md-radius-sm)",
+ *     boxShadow: "var(--md-shadow-dropdown)",
+ *     overflow: "hidden",
+ *   },
+ * });
+ * ```
+ */
+export interface FloatingContainerOptions {
+    /**
+     * Extra CSS properties merged onto the container element at creation time.
+     * These are applied on top of the mandatory base styles
+     * (`position:fixed`, `z-index`, `display:none`).
+     */
+    style?: Partial<CSSStyleDeclaration>;
+    /**
+     * Where to mount the container.
+     * Accepts an `Element` directly, a CSS selector string, or omit/`null` to
+     * default to `document.body`.
+     *
+     * @default document.body
+     */
+    target?: Element | string | null;
+    /**
+     * Override the default `z-index` value.
+     *
+     * @default "9999"
+     */
+    zIndex?: string | number;
+}
+export interface FloatingContainer {
+    /**
+     * The raw `<div>` element.  You can read/write styles, measure, and render
+     * lit-html templates into this element directly.  It is NOT in the DOM until
+     * `attach()` is called.
+     */
+    readonly el: HTMLDivElement;
+    /**
+     * Append `el` to the target (default: `document.body`) if it is not already
+     * attached.  Safe to call multiple times — subsequent calls are no-ops.
+     */
+    attach(): void;
+    /**
+     * Remove `el` from the DOM.  Safe to call when already detached — it is a
+     * no-op in that case.  After calling `detach()` you may call `attach()`
+     * again to re-insert the same element.
+     */
+    detach(): void;
+    /**
+     * Returns `true` when `el` is currently in the DOM (i.e. `attach()` has
+     * been called and `detach()` has not been called since).
+     */
+    isAttached(): boolean;
+}
+/**
+ * Create a reusable floating container element.
+ *
+ * The element is created synchronously but is **not** appended to the DOM.
+ * Call `attach()` exactly when you need to make it visible or measure it.
+ * Call `detach()` (or `el.remove()`) to clean up.
+ *
+ * This function is intentionally pure — it does NOT call `onCleanup()` or
+ * any other framework hook.  The caller is responsible for calling `detach()`
+ * at the right time (e.g. inside `onCleanup` / `onCleanup` of an `eleHook`
+ * or `htmlHook` lifecycle).
+ *
+ * @example
+ * // Inside an eleHook mountFn:
+ * const fc = createFloatingContainer({ style: { minWidth: "160px" } });
+ *
+ * const open = () => {
+ *   fc.attach();
+ *   litRender(content, fc.el);
+ *   position(anchor, fc.el);
+ *   fc.el.style.display = "block";
+ * };
+ *
+ * const close = () => {
+ *   fc.el.style.display = "none";
+ * };
+ *
+ * return {
+ *   onCleanup() {
+ *     fc.detach();
+ *   },
+ * };
+ */
+export declare function createFloatingContainer(opts?: FloatingContainerOptions): FloatingContainer;
+//# sourceMappingURL=floating-container.d.ts.map

package/dist/types/lib/portals/floating-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floating-container.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/floating-container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAE5B;;;OAGG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAC;IAEf;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC;CACvB;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,GAAE,wBAA6B,GAClC,iBAAiB,CAsCnB"}

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

@@ -1,9 +1,11 @@
 export type { DialogOptions } from "./dialog";
 export { dialog } from "./dialog";
-export type { PopupOptions, PopupPlacement } from "./popup";
+export type { FloatingContainer, FloatingContainerOptions, } from "./floating-container";
+export { createFloatingContainer } from "./floating-container";
+export type { PopupOpenAtom, PopupOptions, PopupPlacement } from "./popup";
 export { popup } from "./popup";
+export type { ResolvedPlacement } from "./popupPlacement";
+export { applyCoords, fits, flip, getScrollParent, resolvePlacement, } from "./popupPlacement";
 export type { Placement, PortalOptions } from "./portal";
 export { computeAutoPlacement, getCoords, placementTransform, portal, } from "./portal";
-export type { TipContent, TipStyle } from "./tip";
-export { tip, tooltip } from "./tip";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,kBAAkB,EAClB,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EACV,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,WAAW,EACX,IAAI,EACJ,IAAI,EACJ,eAAe,EACf,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,kBAAkB,EAClB,MAAM,GACP,MAAM,UAAU,CAAC"}

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

@@ -1,6 +1,18 @@
 import { type TemplateResult } from "lit-html";
 import type { DirectiveResult } from "lit-html/directive.js";
-export type PopupPlacement = "auto" | "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end";
+import type { PopupPlacement } from "./popupPlacement";
+/**
+ * A readable boolean atom — any callable that returns a boolean and also
+ * exposes a `get()` method (compatible with mates `atom(false)`).
+ * Used by the `open` option of `popup()` to drive controlled mode.
+ */
+export interface PopupOpenAtom {
+    (): boolean;
+    get(): boolean;
+}
+/** Accepted value for `PopupOptions.open` — an atom or a plain boolean. */
+export type PopupOpenValue = PopupOpenAtom | boolean;
+export type { PopupPlacement } from "./popupPlacement";
 export interface PopupOptions {
     /** default "bottom-start" */
     position?: PopupPlacement;
@@ -9,6 +21,13 @@ export interface PopupOptions {
     style?: Record<string, string>;
     /** Set the floating panel's width to exactly match the anchor element's width. */
     matchAnchorWidth?: boolean;
+    /**
+     * When true, the floating element is removed from `document.body` on close
+     * and re-appended on open. This keeps the DOM clean when the panel content
+     * is expensive (e.g. a calendar with 42 day cells).
+     * Default: false (legacy behaviour — panel stays in DOM, display:none).
+     */
+    destroyOnClose?: boolean;
     /**
      * Called after the panel is shown and positioned (each time it opens).
      * Use to move focus into the panel for keyboard navigation.
@@ -16,22 +35,67 @@ export interface PopupOptions {
     onOpen?: (panel: HTMLElement) => void;
     /**
      * Called when the panel closes (outside click, Escape, or toggle).
-     * Receives the anchor element — typical use is `anchor.focus()`.
+     * Receives the anchor element and the floating panel element.
+     * With `destroyOnClose: true`, the floating element is passed so the
+     * consumer can remove it after any exit animation completes.
+     * If the consumer calls `floating.remove()` itself, `popup()` will NOT
+     * call it again — it checks `floating.isConnected` before removing.
+     */
+    onClose?: (anchor: HTMLElement, floating: HTMLElement) => void;
+    /**
+     * **Controlled mode** — pass a boolean atom to take full control of
+     * open/close state.  When provided:
+     * - No `click` listener is attached to the anchor element.
+     * - The panel opens when `open()` becomes `true` and closes when it
+     *   becomes `false` (evaluated on every render update).
+     * - Outside-click and Escape are **not** wired automatically; the caller
+     *   is responsible for setting the atom to `false` when appropriate.
+     *
+     * @example
+     * const isOpen = atom(false);
+     * html`<div ${popup(listEl, { open: isOpen, position: "bottom-start" })}>
+     *   <input @focusin=${() => isOpen.set(true)}
+     *          @focusout=${() => isOpen.set(false)} />
+     * </div>`
      */
-    onClose?: (anchor: HTMLElement) => void;
+    open?: PopupOpenValue;
+    /**
+     * Override the z-index of the floating panel.
+     * Use `600` (or `--md-z-popup-above-modal`) when the popup must appear
+     * above an open dialog. Defaults to the floating-container default (9999).
+     */
+    zIndex?: number | string;
+    /**
+     * When true, suppresses any CSS animations on the floating panel element.
+     * Useful for tour cards and other cases where you want instant appearance.
+     */
+    disableAnimation?: boolean;
 }
 /**
- * `popup(content, positionOrOptions?)` — attach a click-toggle anchored
- * floating panel to any element.
+ * `popup(content, options?)` — attach an anchored floating panel to any element.
  *
- * Pure `position:fixed` — no Popover API. Each element gets its own floating
- * `<div>` appended to `<body>`, so multiple popups can coexist. Clicking
- * outside or pressing Escape closes it. Repositions on scroll and resize.
- * Optional `onOpen` / `onClose` run when the panel opens or closes (e.g. focus management).
+ * **Toggle mode** (default) — clicking the anchor opens/closes the panel.
+ * Outside-click and Escape close it automatically.
  *
- * @example
+ * **Controlled mode** — pass `options.open` with a boolean atom to take full
+ * control.  No click listener is attached; the panel opens/closes whenever
+ * the atom value changes.  Outside-click and Escape are NOT wired automatically —
+ * the caller is responsible for setting the atom to `false`.
+ *
+ * Pure `position:fixed` — no Popover API, no portal wrapper needed.
+ * Repositions on scroll and resize.
+ *
+ * @example — toggle (default)
  * html`<button ${popup(html`<ul>...</ul>`, "bottom-start")}>Menu ▾</button>`
- * html`<button ${popup(html`<div>...</div>`, { position: "top", gap: 8 })}>Open</button>`
+ *
+ * @example — controlled (combo-box / autocomplete)
+ * const isOpen = atom(false);
+ * html`
+ *   <div ${popup(listEl, { open: isOpen, position: "bottom-start", matchAnchorWidth: true })}>
+ *     <input @focusin=${() => isOpen.set(true)}
+ *            @focusout=${() => isOpen.set(false)} />
+ *   </div>
+ * `
  */
 export declare function popup(content: TemplateResult, positionOrOptions?: PopupPlacement | PopupOptions): DirectiveResult;
 //# sourceMappingURL=popup.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/popup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACzC;AAoPD;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,cAAc,EACvB,iBAAiB,CAAC,EAAE,cAAc,GAAG,YAAY,GAChD,eAAe,CAMjB"}
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/popup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,OAAO,CAAC;IACZ,GAAG,IAAI,OAAO,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;AAErD,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/D;;;;;;;;;;;;;;;OAeG;IACH,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAgQD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,KAAK,CACnB,OAAO,EAAE,cAAc,EACvB,iBAAiB,CAAC,EAAE,cAAc,GAAG,YAAY,GAChD,eAAe,CAMjB"}

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

@@ -0,0 +1,52 @@
+/**
+ * popupPlacement.ts
+ *
+ * Shared placement types and coordinate utilities used by `popup()` and any
+ * other portal-style floating surface that needs anchor-aware, flip-capable
+ * positioning (e.g. cascading menus, date-pickers, combobox panels).
+ *
+ * Centralising here means every floating surface gets:
+ *   • Scroll-parent awareness (room measured against the scrollable ancestor,
+ *     not just the viewport).
+ *   • Automatic flip when the preferred side has insufficient space.
+ *   • Viewport-edge clamping so the panel never overflows by more than 4 px.
+ */
+export type PopupPlacement = "auto" | "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end";
+/** Every placement value except the virtual `"auto"` sentinel. */
+export type ResolvedPlacement = Exclude<PopupPlacement, "auto">;
+/**
+ * Returns `true` when placement `p` fits within the available room on each
+ * side of the anchor.
+ */
+export declare function fits(p: PopupPlacement, fW: number, fH: number, roomTop: number, roomBottom: number, roomLeft: number, roomRight: number): boolean;
+/**
+ * Return the opposite placement axis (top ↔ bottom, left ↔ right).
+ * Sub-positions (`-start` / `-end`) are preserved.
+ */
+export declare function flip(p: PopupPlacement): ResolvedPlacement;
+/**
+ * Walk up the DOM from `el` and return the first ancestor that scrolls
+ * vertically, or `null` if none is found (i.e. the document scrolls).
+ */
+export declare function getScrollParent(el: HTMLElement): HTMLElement | null;
+/**
+ * Resolve the best concrete placement for a floating element given the
+ * anchor's bounding rect, the floating element's dimensions, and the
+ * preferred placement.
+ *
+ * - For `"auto"` the function tries a fixed priority list and falls back to
+ *   `"bottom-start"`.
+ * - For any other placement it tries the preferred side, then its opposite
+ *   (flip), and finally falls back to the original preference when neither
+ *   side has enough room.
+ * - Scroll-parent aware: available space is measured against the nearest
+ *   scrollable ancestor when one exists.
+ */
+export declare function resolvePlacement(anchor: HTMLElement, anchorRect: DOMRect, fW: number, fH: number, gap: number, preferred: PopupPlacement): ResolvedPlacement;
+/**
+ * Apply `top` / `left` CSS coordinates to a fixed-position floating element
+ * so it is anchored to the given placement.  Clamps to 4 px inside the
+ * viewport edges.
+ */
+export declare function applyCoords(el: HTMLElement, anchorRect: DOMRect, placement: ResolvedPlacement, fW: number, fH: number, gap: number): void;
+//# sourceMappingURL=popupPlacement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"popupPlacement.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/popupPlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;AAIhE;;;GAGG;AACH,wBAAgB,IAAI,CAClB,CAAC,EAAE,cAAc,EACjB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,cAAc,GAAG,iBAAiB,CAUzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,GAAG,IAAI,CAUnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,OAAO,EACnB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,cAAc,GACxB,iBAAiB,CAmDnB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,WAAW,EACf,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,iBAAiB,EAC5B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,MAAM,GACV,IAAI,CAgDN"}

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

@@ -3,14 +3,21 @@ import type { DirectiveResult } from "lit-html/directive.js";
 export type Placement = "auto" | "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end";
 export interface PortalOptions {
     /**
-     * Inline styles merged onto the wrapper div.
-     * Use this to position the portal (e.g. `{ top: "100px", left: "200px" }`)
-     * or to style corner-positioned portals like toasts.
+     * Optional inline styles applied to the wrapper `<div>`.
+     *
+     * In most cases you should style your own rendered content rather than the
+     * wrapper — the wrapper is just a lit-html render root with no default
+     * styles.  Use this only when you specifically need the wrapper element
+     * itself to carry styles (e.g. a transparent full-screen scrim).
      */
     style?: Record<string, string>;
     /** Event listeners attached directly to the wrapper div. */
     on?: Record<string, EventListener>;
-    /** Where to mount the portal wrapper. Default: `document.body` */
+    /**
+     * Where to mount the portal wrapper.
+     * Accepts an `Element` or a CSS selector string.
+     * Default: `document.body`
+     */
     target?: Element | string;
 }
 /**
@@ -32,25 +39,42 @@ export declare function placementTransform(placement: Placement): string;
  */
 export declare function computeAutoPlacement(anchorRect: DOMRect, contentWidth: number, contentHeight: number, gap: number): "top" | "bottom" | "left" | "right";
 /**
- * `portal(content, options?)` — renders a `TemplateResult` into a
- * `position:fixed` wrapper div appended to `document.body` (or a custom
- * `target`), outside the normal DOM tree.
+ * `portal(content, options?)` — renders a `TemplateResult` into a plain
+ * `<div>` appended to `document.body` (or a custom `target`), outside the
+ * normal component DOM tree.
+ *
+ * The wrapper `<div>` has **no default styles** — your rendered content is
+ * fully responsible for its own positioning, z-index, and sizing.  This makes
+ * `portal` work cleanly for every use-case without conflicting defaults.
  *
  * Nothing renders at the call site. The wrapper is removed automatically when
- * the directive disconnects (component unmounts or condition becomes false).
+ * the directive disconnects (component unmounts or the condition becomes false).
  *
- * Use `options.style` to position the portal:
+ * @example
+ * // Toast — the toast element itself carries position:fixed
+ * html`${showToast && portal(html`
+ *   <div style="position:fixed;bottom:16px;right:16px;z-index:9999;">
+ *     Saved ✓
+ *   </div>
+ * `)}`
  *
  * @example
- * // Toast — corner positioned
- * html`${isOpen && portal(html`<div class="toast">Saved ✓</div>`, {
- *   style: { bottom: "16px", right: "16px", top: "auto", left: "auto" },
- * })}`
+ * // Full-screen modal scrim
+ * html`${isOpen && portal(html`
+ *   <div style="position:fixed;inset:0;z-index:9999;background:rgba(0,0,0,.5);"
+ *        @click=${close}>
+ *     <div class="modal" @click=${stopPropagation}>...</div>
+ *   </div>
+ * `)}`
+ *
+ * @example
+ * // Mount into a custom target instead of body
+ * html`${portal(html`<span>...</span>`, { target: "#overlay-root" })}`
  *
  * @example
- * // Context menu — cursor positioned
- * html`${pos && portal(html`<ul>...</ul>`, {
- *   style: { top: `${pos.y}px`, left: `${pos.x}px` },
+ * // Apply styles to the wrapper itself (rare — prefer styling your content)
+ * html`${portal(html`<ul class="menu">...</ul>`, {
+ *   style: { position: "fixed", top: `${y}px`, left: `${x}px` },
  * })}`
  */
 export declare function portal(content: TemplateResult, options?: PortalOptions): DirectiveResult;

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

@@ -1 +1 @@
-{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/portal.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,SAAS,GACjB,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEnC,kEAAkE;IAClE,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAMD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,SAAS,EACnB,GAAG,EAAE,MAAM,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAyB/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAgB/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,OAAO,EACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAoBrC;AA+CD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,CAEjB"}
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/portal.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,SAAS,GACjB,MAAM,GACN,KAAK,GACL,WAAW,GACX,SAAS,GACT,QAAQ,GACR,cAAc,GACd,YAAY,GACZ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,OAAO,GACP,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,4DAA4D;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAKD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,SAAS,EACnB,GAAG,EAAE,MAAM,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA2B/B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAgB/D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,OAAO,EACnB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,GACV,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAoBrC;AAiDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,CAEjB"}

package/dist/types/lib/socket/ws.d.ts

@@ -59,7 +59,7 @@ export type WsConnection<T = unknown> = {
  * ```ts
  * // ✅ correct — inside a component's outer function
  * const MyComponent = () => {
- *   const sock = ws<ChatMessage>("wss://api.example.com/chat", {
+ *   const sock = ws<ChatMessage>("wss://<your-server>/chat", {
  *     reconnect: true,
  *   });
  *   onSocket((msg) => { messages.update(d => { d.push(msg); }); }, [sock]);
@@ -67,7 +67,7 @@ export type WsConnection<T = unknown> = {
  * };
  *
  * // ❌ wrong — module level, no host, cleanup is never registered
- * const chatSocket = ws<ChatMessage>("wss://api.example.com/chat");
+ * const chatSocket = ws<ChatMessage>("wss://<your-server>/chat");
  *
  * // ❌ wrong — inner function, outer function has already returned
  * const MyComponent = () => {

package/dist/types/lib/ssr/index.d.ts

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

package/dist/types/lib/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"}
+{"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"}