mates-devtools 0.1.0-beta.1

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

@@ -0,0 +1,46 @@
+export type { TemplateResult } from "lit-html";
+export { html, noChange, nothing, render, svg } from "lit-html";
+export { unsafeHTML } from "lit-html/directives/unsafe-html.js";
+export { asyncAppend } from "lit-html/directives/async-append.js";
+export { asyncReplace } from "lit-html/directives/async-replace.js";
+export { cache as litCache } from "lit-html/directives/cache.js";
+export { classMap } from "lit-html/directives/class-map.js";
+export { guard } from "lit-html/directives/guard.js";
+export { ifDefined } from "lit-html/directives/if-defined.js";
+export { join } from "lit-html/directives/join.js";
+export { keyed } from "lit-html/directives/keyed.js";
+export { live } from "lit-html/directives/live.js";
+export { range } from "lit-html/directives/range.js";
+export { repeat } from "lit-html/directives/repeat.js";
+export { styleMap } from "lit-html/directives/style-map.js";
+export { until } from "lit-html/directives/until.js";
+export { when } from "lit-html/directives/when.js";
+import "./Template/x-x";
+import "./Template/xProvider";
+import "./Directives/animationClasses";
+export { ZeroPromise } from "./ZeroPromise";
+export { componentRunningStatus, isInRestrictedContext, assertNotInRestrictedContext, assertComponentOuterContext, } from "./TrackState/componentStatus";
+export { type TrackingSnapshot, isReadTrackingEnabled, getStoresBeingRead, isEffectRunning, addStoreBeingRead, pushEffect, popEffect, saveAndEnableTracking, restoreTracking, startTracking, stopTracking, } from "./TrackState/readTracking";
+export { createManagedTimer } from "./Timers";
+export { type ActionAfterInterceptor, type ActionBeforeInterceptor, type ActionFn, type ActionReturnType, type ActionSubscriber, type AnimateDirectiveConfig, type AnimateKeyframes, type AnimateOptions, type AnimationHandle, type AnimationPreset, type AsyncActionAfterInterceptor, type AsyncActionBeforeInterceptor, type AsyncActionOptions, type AsyncActionReturnType, type AsyncActionStatus, action, asyncAction, blurInPreset, blurOutPreset, bouncePreset, type CacheManager, cache as cacheFn, createCacheManager, createPollingManager, collapseWidthPreset, debounce, deleteAction, type ElementTarget, expandWidthPreset, type FetchBody, fadeInPreset, fadeOutPreset, fetchAction, flipInPreset, flipOutPreset, getAction, type PaginatedAsyncActionReturnType, paginatedAsyncAction, patchAction, type PollingManager, postAction, pulsePreset, putAction, type SlideDirection, scaleInPreset, scaleOutPreset, shakePreset, slideInPreset, slideOutPreset, spinPreset, springInPreset, type Task, type TaskActionType, type TaskStatus, taskAction, throttle, withStaggerPreset, } from "./actions";
+export type { Cl, CSSBlock, CSSKeyframeStops, CSSNestedBlock, CSSRulesInput, CssVars, GlobalThemeResult, SerializeOptions, ThemeMode, ThemesInput, ThemeTokenMap, } from "./css-in-js";
+export { configureCSS, globalCSS, globalTheme, keyframes, rootCSS, stylesheet, } from "./css-in-js";
+export { $, type AnimatedIfConfig, type AnimatedXConfig, type AttrMap, type AttrValue, animatedIf, animatedX, attr, type ClassEntry, type ClassesInput, type ConnectCallback, classes, type DisconnectCallback, type DollarChain, type EleHookLifecycle, type EleHookMountFn, eleHook, type HtmlHookLifecycle, type HtmlHookMountFn, type HtmlHookRenderFn, htmlHook, type IntersectCallback, type IntersectOptions, type LazyLoadCallback, type LazyLoadOptions, lazyLoad, type MasonryGridOptions, type MasonryItemTemplate, type MasonryKeyFn, type MatesCustomEventMap, type MemoKeys, type MemoTemplateFn, masonryGrid, memoTemplate, type OnEventMap, type OnParentMap, on, onConnect, onDisconnect, onHidden, onIntersect, onParent, onScrolledIntoView, onVisible, removeAttr, removeClasses, removeOn, removeStyle, renderSwitch, type ScrolledIntoViewCallback, type ScrolledIntoViewOptions, type StyleMap, type StyleValue, type SwitchCase, type SwitchEntry, style, type TimerContent, timer, type UpdateCallback, type VirtualGridOptions, type VirtualListOptions, type VirtualMasonryOptions, virtualGrid, virtualList, virtualMasonry, } from "./Directives";
+export type { Measurements } from "./Directives/$";
+export { injectMatesAnimations, MA, type MatesAnimationClass, } from "./Directives/animationClasses";
+export { type DevToolsHooks, installDevToolsHooks, isDevToolsInstalled, } from "./devtools";
+export { type AfterInterceptor, type BeforeInterceptor, buildRequestUrl, clearInterceptors, Delete, type ErrorInterceptor, type ErrorType, ErrorTypes, Fetch, type FetchActionConfig, FetchClient, type FetchRequest, fetchClient, Get, interceptAfter, interceptBefore, interceptError, isApiResponseSuccess, Patch, Post, Put, setSSRApiLookup, setSSRRequest, } from "./Fetch";
+export { _, _subToView, type AtomConfig, type AtomType, atom, type CacheAtomType, cacheAtom, createTimedAtom, debouncedAtom, df, type EventType, effect, event, type FormAtom, formAtom, getCurrentHost, getParentScope, getParentScope as getScope, type IAtomType, iAtom, iAtom as signal, isEmail, isMax, isMin, isPattern, isRequired, lsAtom, mapAtom, maxLength, memo, minLength, onAllMount, onCleanup, onError, onMount, onPaint, onReferenceChange, type PaginationAtomType, paginationAtom, type Ref, ref, createReactiveRunner, trackAndSubscribe, validateReactiveFunction, type SetterReturnType, type StorageAtomType, type StorageValue, type Subscribable, type SuperAtomOptions, type SuperAtomType, safetyCheck, scope, scope as useScope, setAtom, setRef, setter, ssAtom, superAtom, type ThemeAtomType, type ThemeValue, themeAtom, throttledAtom, titleAtom, useContext, useState, useStore, type ValidateAllResult, type ValidatorFn, validateAll, withHost, on as watch, type XTabEventType, xTabEvent, } from "./Mutables";
+export { onBlur, onClickAway, onCopy, onCut, onDOMReady, onFileDrop, onFocus, onInterval, onKeyDown, onKeyUp, onNavigate, onOffline, onOnline, onPaste, onResize, onScroll, onSelectionChange, onSocket, onStorageChange, onTimeout, onUpdate, onVisibilityChange, onWindow, onWindowCapture, onWindowResize, onWindowScroll, type WheelDirectionEvent, type WindowHookEventName, type WindowHookHandler, } from "./on";
+export type { DialogOptions, Placement, PopupOptions, PopupPlacement, PortalOptions, TipContent, TipStyle, } from "./portals";
+export { computeAutoPlacement, dialog, getCoords, placementTransform, popup, portal, tip, tooltip, } from "./portals";
+export { type AnimatedRouteConfig, type AnimatedRouterOptions, animatedRouter, buildPath, hashAtom, isPathMatching, location, lockNavigation, navigateTo, navigationLocked, pathAtom, qsAtom, Router, route, unlockNavigation, } from "./Router";
+export type { WsConfig, WsConnection, WsStatus } from "./socket";
+export { ws } from "./socket";
+export { isSSR, setSSRMode } from "./ssr";
+export type { Component, ComponentElement, ComponentFn, View, ClosureComponent, ViewComponent, C, OuterFn, PropsType, RenderFn, InnerFn, TemplateComponent, X, ComponentType, HostElement, LazyComponent, Props, Setter, TemplateFn, } from "./Template";
+export { cleanupScheduler, effectScheduler, globalScheduler, isAsyncValue, resolveAsyncValue, resetComponentState, unwrapModule, renderX, x, } from "./Template";
+export { view } from "./Template/x";
+export { get, pick, omit, merge, clamp, range as arrayRange, chunk, uniqBy, groupBy, isEmpty, iterateDeeply, type IterateDeeplyCallback, isAtom, isUnit, isAction, isAsyncAction, isSetter, isEvent, isConfirmationEvent, isChannel, isGetter, isFunction, isAsyncFunction, NotificationManager, SyncNotificationManager, registerCleanup, getAllProps, Context, deepClone, deepFreeze, isDefinedAsGetter, logError, type SvgConfig, safeSVG, safeSVG as unsafeSVG, uuid, uuid as randomId, } from "./Utils";
+export { type DateInput, type DateUnit, type DateValues, date, getAllTimezones, getCalendar, getLocale, getMonths, getTimezoneOffset, type MatesDate, type MonthInfo, setLocale, setTimezone, setTimezoneOffset, type TimezoneEntry, } from "./Utils/Date";
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,319 @@
+import type { WsConnection } from "../socket/ws";
+type CleanupFn = () => void;
+/**
+ * Synthetic events derived from the `wheel` event, filtered by scroll direction.
+ *
+ * - `'wheelUp'`   fires when `deltaY < 0` (user scrolled / wheeled upward)
+ * - `'wheelDown'` fires when `deltaY > 0` (user scrolled / wheeled downward)
+ */
+export type WheelDirectionEvent = "wheelUp" | "wheelDown";
+/**
+ * All event names accepted by `onWindow` and `onWindowCapture`:
+ * every key from `WindowEventMap` plus the synthetic `wheelUp` / `wheelDown`.
+ */
+export type WindowHookEventName = keyof WindowEventMap | WheelDirectionEvent;
+/**
+ * Handler type for `onWindow` / `onWindowCapture`.
+ *
+ * - `'wheelUp'` / `'wheelDown'` → handler receives a `WheelEvent`
+ * - Any other event name        → handler receives the native event type
+ *                                 from `WindowEventMap`
+ */
+export type WindowHookHandler<K extends WindowHookEventName> = K extends WheelDirectionEvent ? (event: WheelEvent) => CleanupFn | undefined : K extends keyof WindowEventMap ? (event: WindowEventMap[K]) => CleanupFn | undefined : never;
+/**
+ * Attaches a **bubble-phase** listener on `window`, tied to the component
+ * lifecycle. The listener is automatically removed when the component unmounts.
+ *
+ * Supports all standard `WindowEventMap` events plus the synthetic
+ * `'wheelUp'` and `'wheelDown'` events.
+ *
+ * The handler may optionally return a cleanup function — it is called before
+ * the next invocation and on component unmount.
+ *
+ * @example
+ * ```ts
+ * // Close a dropdown on any click
+ * onWindow("click", () => isOpen.set(false));
+ *
+ * // Global keyboard shortcut
+ * onWindow("keydown", (e) => {
+ *   if (e.key === "Escape") closeModal();
+ * });
+ *
+ * // Wheel direction
+ * onWindow("wheelUp",   () => zoom.set(z => z + 0.1));
+ * onWindow("wheelDown", () => zoom.set(z => z - 0.1));
+ * ```
+ */
+export declare function onWindow<K extends WindowHookEventName>(eventName: K, fn: WindowHookHandler<K>): void;
+/**
+ * Attaches a **capture-phase** listener on `window`, tied to the component
+ * lifecycle. The listener is automatically removed when the component unmounts.
+ *
+ * Use capture when:
+ * - You need to intercept events before they reach their target element
+ * - The event does not bubble (`'scroll'`, `'focus'`, `'blur'`)
+ * - You want to catch scroll on nested scrollable containers
+ *
+ * Supports all standard `WindowEventMap` events plus `'wheelUp'` / `'wheelDown'`.
+ *
+ * @example
+ * ```ts
+ * // Intercept all clicks before any element handler runs
+ * onWindowCapture("click", (e) => {
+ *   if ((e.target as HTMLElement).closest(".protected")) {
+ *     e.stopPropagation();
+ *   }
+ * });
+ *
+ * // Catch scroll on any element — scroll does not bubble
+ * onWindowCapture("scroll", (e) => trackScrollDepth(e.target));
+ * ```
+ */
+export declare function onWindowCapture<K extends WindowHookEventName>(eventName: K, fn: WindowHookHandler<K>): void;
+/**
+ * Attaches a capture-phase `scroll` listener on `window`, tied to the
+ * component lifecycle.
+ *
+ * Capture is required here because `scroll` does not bubble — only capture
+ * allows intercepting scroll events from nested scrollable containers.
+ *
+ * `passive: true` is set automatically so the browser can scroll without
+ * waiting for the handler.
+ *
+ * The listener is automatically removed when the component unmounts.
+ * The handler may optionally return a cleanup function.
+ *
+ * @example
+ * ```ts
+ * onWindowScroll((e) => {
+ *   const el = e.target as Element;
+ *   scrollDepth.set(el.scrollTop ?? window.scrollY);
+ * });
+ * ```
+ */
+export declare const onWindowScroll: (fn: (e: Event) => CleanupFn | undefined) => void;
+export declare const onBlur: (fn: () => CleanupFn | undefined) => void;
+export declare const onFocus: (fn: () => CleanupFn | undefined) => void;
+export declare const onOnline: (fn: () => CleanupFn | undefined) => void;
+export declare const onOffline: (fn: () => CleanupFn | undefined) => void;
+export declare const onWindowResize: (fn: () => CleanupFn | undefined) => void;
+export declare const onWindowBeforeUnload: (fn: (e: BeforeUnloadEvent) => CleanupFn | undefined) => void;
+/**
+ * Fires whenever the user pastes inside the page (`Ctrl+V`, right-click Paste,
+ * or a programmatic paste). Receives the native `ClipboardEvent` so you can
+ * read `e.clipboardData.getData('text/plain')` or inspect `e.clipboardData.files`
+ * for images and binary content.
+ *
+ * Listener is automatically removed when the component unmounts.
+ * The handler may optionally return a cleanup function.
+ *
+ * @example
+ * ```ts
+ * onPaste((e) => {
+ *   const text = e.clipboardData?.getData('text/plain') ?? '';
+ *   content.set(text);
+ * });
+ *
+ * // Handle pasted images
+ * onPaste((e) => {
+ *   const file = e.clipboardData?.files[0];
+ *   if (file?.type.startsWith('image/')) uploadImage(file);
+ * });
+ * ```
+ */
+export declare const onPaste: (fn: (e: ClipboardEvent) => CleanupFn | undefined) => void;
+/**
+ * Fires whenever the user copies selected content inside the page.
+ * Receives the native `ClipboardEvent` — you can call `e.preventDefault()`
+ * and write custom data to the clipboard via `e.clipboardData.setData(...)`.
+ *
+ * Listener is automatically removed when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * onCopy((e) => {
+ *   const selected = window.getSelection()?.toString() ?? '';
+ *   analytics.track('copy', { chars: selected.length });
+ * });
+ * ```
+ */
+export declare const onCopy: (fn: (e: ClipboardEvent) => CleanupFn | undefined) => void;
+/**
+ * Fires whenever the user cuts selected content inside the page.
+ * Receives the native `ClipboardEvent`.
+ *
+ * Listener is automatically removed when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * onCut((e) => {
+ *   isDirty.set(true);
+ * });
+ * ```
+ */
+export declare const onCut: (fn: (e: ClipboardEvent) => CleanupFn | undefined) => void;
+/**
+ * Attaches a global `keydown` listener on `window`, tied to the component
+ * lifecycle. Ideal for keyboard shortcuts that should be active whenever
+ * this component is mounted.
+ *
+ * Listener is automatically removed when the component unmounts.
+ * The handler may optionally return a cleanup function.
+ *
+ * @example
+ * ```ts
+ * onKeyDown((e) => {
+ *   if (e.key === 'Escape')              closeModal();
+ *   if (e.ctrlKey && e.key === 's')     { e.preventDefault(); save(); }
+ *   if (e.ctrlKey && e.key === 'Enter') submit();
+ * });
+ * ```
+ */
+export declare const onKeyDown: (fn: (e: KeyboardEvent) => CleanupFn | undefined) => void;
+/**
+ * Attaches a global `keyup` listener on `window`, tied to the component
+ * lifecycle.
+ *
+ * Listener is automatically removed when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * onKeyUp((e) => {
+ *   if (e.key === 'Shift') multiSelect.set(false);
+ * });
+ * ```
+ */
+export declare const onKeyUp: (fn: (e: KeyboardEvent) => CleanupFn | undefined) => void;
+/**
+ * Fires whenever the page's visibility changes — i.e. the user switches tabs,
+ * minimises the window, or returns to the page. The handler receives a plain
+ * `boolean`: `true` when the tab is now hidden, `false` when it is visible.
+ *
+ * Uses the `visibilitychange` event on `document` (not `window`) which is the
+ * correct target per the Page Visibility API spec.
+ *
+ * Listener is automatically removed when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * onVisibilityChange((hidden) => {
+ *   if (hidden) pauseVideo();
+ *   else        resumeVideo();
+ * });
+ *
+ * // Pause a polling interval while the tab is hidden
+ * onVisibilityChange((hidden) => {
+ *   if (hidden) return startPolling(); // returns cleanup
+ * });
+ * ```
+ */
+export declare const onVisibilityChange: (fn: (hidden: boolean) => CleanupFn | undefined) => void;
+/**
+ * Fires whenever the user's text selection changes anywhere on the page.
+ * The handler receives the current `Selection` object (or `null` when nothing
+ * is selected), already fetched via `window.getSelection()`.
+ *
+ * Uses the `selectionchange` event on `document`.
+ *
+ * Listener is automatically removed when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * onSelectionChange((selection) => {
+ *   const text = selection?.toString() ?? '';
+ *   selectedText.set(text);
+ *   showToolbar.set(text.length > 0);
+ * });
+ * ```
+ */
+export declare const onSelectionChange: (fn: (selection: Selection | null) => CleanupFn | undefined) => void;
+/**
+ * Fires when `localStorage` or `sessionStorage` is mutated by **another tab
+ * or window** in the same origin. This is the standard mechanism for
+ * cross-tab state synchronisation.
+ *
+ * The handler receives the native `StorageEvent` which includes:
+ * - `e.key`         — the key that changed (`null` when `clear()` was called)
+ * - `e.oldValue`    — the previous value (or `null`)
+ * - `e.newValue`    — the new value (or `null` if the key was removed)
+ * - `e.storageArea` — the `Storage` object that was affected
+ * - `e.url`         — the URL of the document that made the change
+ *
+ * Does **not** fire for changes made by the current tab.
+ *
+ * Listener is automatically removed when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * onStorageChange((e) => {
+ *   if (e.key === 'theme') applyTheme(e.newValue ?? 'light');
+ *   if (e.key === 'auth')  revalidateSession();
+ * });
+ * ```
+ */
+export declare const onStorageChange: (fn: (e: StorageEvent) => CleanupFn | undefined) => void;
+/**
+ * Attaches a window-level file drop handler, allowing users to drop files
+ * anywhere on the page. Automatically prevents the browser's default behaviour
+ * (navigating to the dropped file) and suppresses the `dragover` visual cursor
+ * change.
+ *
+ * The handler receives the native `DragEvent` — access dropped files via
+ * `e.dataTransfer.files` or `e.dataTransfer.items`.
+ *
+ * Both the `dragover` and `drop` listeners are automatically removed when the
+ * component unmounts.
+ *
+ * @example
+ * ```ts
+ * onFileDrop((e) => {
+ *   const files = Array.from(e.dataTransfer?.files ?? []);
+ *   files.forEach(uploadFile);
+ * });
+ *
+ * // Filter by type
+ * onFileDrop((e) => {
+ *   const images = Array.from(e.dataTransfer?.files ?? [])
+ *     .filter(f => f.type.startsWith('image/'));
+ *   if (images.length) setImages(images);
+ * });
+ * ```
+ */
+export declare const onFileDrop: (fn: (e: DragEvent) => CleanupFn | undefined) => void;
+/**
+ * Calls `fn` when the user clicks outside the current component's host element.
+ * Uses mousedown so it runs before click handlers. Listener is removed on unmount.
+ */
+export declare const onClickAway: (fn: (e: MouseEvent) => void) => void;
+/**
+ * Attaches a passive `scroll` listener on a target element (defaults to
+ * `window`). Tied to the component lifecycle — removed on unmount.
+ *
+ * For intercepting scroll on nested containers at the window level, prefer
+ * `onWindowScroll` which uses capture mode.
+ */
+export declare const onScroll: (fn: (e: Event) => CleanupFn | undefined, target?: EventTarget) => void;
+/**
+ * Observes size changes on a target element (defaults to the host component
+ * element) via `ResizeObserver`. Tied to the component lifecycle.
+ */
+export declare const onResize: (fn: (entry: ResizeObserverEntry) => CleanupFn | undefined, target?: HTMLElement) => void;
+export declare const onNavigate: (fn: (path: string) => CleanupFn | undefined | void) => void;
+export declare const onInterval: (fn: () => CleanupFn | undefined, ms: number) => void;
+export declare const onTimeout: (fn: () => CleanupFn | undefined, ms: number) => void;
+/**
+ * Subscribe `handler` to one or more WebSocket connections.
+ *
+ * Registered on mount, automatically unsubscribed when the component unmounts.
+ *
+ * ```ts
+ * onSocket((msg: ChatMessage) => {
+ *   messages.update(d => { d.push(msg); });
+ * }, [chatSocket]);
+ * ```
+ */
+export declare function onSocket<T>(handler: (data: T) => void, sockets: WsConnection<T>[]): void;
+export declare const onUpdate: (fn: () => CleanupFn | undefined) => void;
+export {};
+//# sourceMappingURL=hooks.d.ts.map

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

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

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

@@ -0,0 +1,3 @@
+export * from "./hooks";
+export * from "./on";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../lib/on/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC"}

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

@@ -0,0 +1,16 @@
+type CleanupFn = () => void;
+type LifecycleHandler = () => CleanupFn | undefined;
+/**
+ * Subscribe to the DOMReady event.
+ * Called via microtask after the component renders.
+ * The handler can optionally return a cleanup function.
+ */
+export declare const onDOMReady: (handler: LifecycleHandler) => CleanupFn;
+/**
+ * Subscribe to the Paint event.
+ * Called via double RAF after the component renders (after browser paint).
+ * The handler can optionally return a cleanup function.
+ */
+export declare const onPaint: (handler: LifecycleHandler) => CleanupFn;
+export {};
+//# sourceMappingURL=on.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"on.d.ts","sourceRoot":"","sources":["../../../../../lib/on/on.ts"],"names":[],"mappings":"AAGA,KAAK,SAAS,GAAG,MAAM,IAAI,CAAC;AAC5B,KAAK,gBAAgB,GAAG,MAAM,SAAS,GAAG,SAAS,CAAC;AAEpD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,SAAS,gBAAgB,KAAG,SAQtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,gBAAgB,KAAG,SAQnD,CAAC"}

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

@@ -0,0 +1,56 @@
+import type { TemplateResult } from "lit-html";
+import type { DirectiveResult } from "lit-html/directive.js";
+export interface DialogOptions {
+    /**
+     * Called when the user clicks the backdrop — the dimmed area outside
+     * the dialog box. Typically used to close the dialog.
+     */
+    onBackdropClick?: () => void;
+    /**
+     * Inline styles merged onto the backdrop div.
+     * Use this to customise the overlay colour, blur, z-index, etc.
+     */
+    style?: Record<string, string>;
+    /**
+     * Inline styles merged onto the inner dialog box wrapper div.
+     * Use this to control width, padding, border-radius, background, etc.
+     */
+    dialogStyle?: Record<string, string>;
+}
+/**
+ * `dialog(content, options?)` — renders a full-screen backdrop with your
+ * content centred inside it. Prevents body scroll while open. Cleans up
+ * automatically when the directive disconnects.
+ *
+ * Built on `htmlHook` — lifecycle is tied to where it appears in the template.
+ * Use a condition to show / hide it:
+ *
+ * @example
+ * ```ts
+ * const isOpen = atom(false);
+ *
+ * html`
+ *   <button @click=${() => isOpen.set(true)}>Open</button>
+ *
+ *   ${isOpen.val && dialog(html`
+ *     <div class="dialog-box">
+ *       <h2>Confirm delete</h2>
+ *       <p>This action cannot be undone.</p>
+ *       <button @click=${() => isOpen.set(false)}>Cancel</button>
+ *       <button @click=${doDelete}>Delete</button>
+ *     </div>
+ *   `, {
+ *     onBackdropClick: () => isOpen.set(false),
+ *   })}
+ * `
+ *
+ * // Custom backdrop colour + dialog width
+ * ${isOpen.val && dialog(html`<div>...</div>`, {
+ *   style:       { background: 'rgba(0,0,0,0.8)' },
+ *   dialogStyle: { width: '480px', borderRadius: '12px', padding: '24px' },
+ *   onBackdropClick: () => isOpen.set(false),
+ * })}
+ * ```
+ */
+export declare function dialog(content: TemplateResult, options?: DialogOptions): DirectiveResult;
+//# sourceMappingURL=dialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../../../lib/portals/dialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AA4ED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,eAAe,CAEjB"}

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

@@ -0,0 +1,9 @@
+export type { DialogOptions } from "./dialog";
+export { dialog } from "./dialog";
+export type { PopupOptions, PopupPlacement } from "./popup";
+export { popup } from "./popup";
+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

@@ -0,0 +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"}

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

@@ -0,0 +1,37 @@
+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";
+export interface PopupOptions {
+    /** default "bottom-start" */
+    position?: PopupPlacement;
+    /** px gap between anchor and floating panel, default 4 */
+    gap?: number;
+    style?: Record<string, string>;
+    /** Set the floating panel's width to exactly match the anchor element's width. */
+    matchAnchorWidth?: boolean;
+    /**
+     * Called after the panel is shown and positioned (each time it opens).
+     * Use to move focus into the panel for keyboard navigation.
+     */
+    onOpen?: (panel: HTMLElement) => void;
+    /**
+     * Called when the panel closes (outside click, Escape, or toggle).
+     * Receives the anchor element — typical use is `anchor.focus()`.
+     */
+    onClose?: (anchor: HTMLElement) => void;
+}
+/**
+ * `popup(content, positionOrOptions?)` — attach a click-toggle 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).
+ *
+ * @example
+ * html`<button ${popup(html`<ul>...</ul>`, "bottom-start")}>Menu ▾</button>`
+ * html`<button ${popup(html`<div>...</div>`, { position: "top", gap: 8 })}>Open</button>`
+ */
+export declare function popup(content: TemplateResult, positionOrOptions?: PopupPlacement | PopupOptions): DirectiveResult;
+//# sourceMappingURL=popup.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,57 @@
+import type { TemplateResult } from "lit-html";
+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.
+     */
+    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` */
+    target?: Element | string;
+}
+/**
+ * Computes `top` / `left` for a fixed-position floating element given the
+ * anchor's bounding rect and a placement.
+ */
+export declare function getCoords(rect: DOMRect, position: Placement, gap: number): {
+    top: number;
+    left: number;
+};
+/**
+ * Returns a CSS `transform` so an element placed at `getCoords()` sits fully
+ * on the correct side of its anchor.
+ */
+export declare function placementTransform(placement: Placement): string;
+/**
+ * Picks the best cardinal placement given available viewport space.
+ * Priority: bottom → top → right → left.
+ */
+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.
+ *
+ * Nothing renders at the call site. The wrapper is removed automatically when
+ * the directive disconnects (component unmounts or condition becomes false).
+ *
+ * Use `options.style` to position the portal:
+ *
+ * @example
+ * // Toast — corner positioned
+ * html`${isOpen && portal(html`<div class="toast">Saved ✓</div>`, {
+ *   style: { bottom: "16px", right: "16px", top: "auto", left: "auto" },
+ * })}`
+ *
+ * @example
+ * // Context menu — cursor positioned
+ * html`${pos && portal(html`<ul>...</ul>`, {
+ *   style: { top: `${pos.y}px`, left: `${pos.x}px` },
+ * })}`
+ */
+export declare function portal(content: TemplateResult, options?: PortalOptions): DirectiveResult;
+//# sourceMappingURL=portal.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,38 @@
+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

@@ -0,0 +1 @@
+{"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"}