@petit-kit/scoped 0.0.1

package/dist/plugins/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/content/index.ts"],"names":[],"mappings":""}

package/dist/plugins/device/index.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentPlugin } from '../../index';
+export type DeviceControls = {
+    onMediaQuery: (query: string, handler: (matches: boolean, event: MediaQueryListEvent | null) => void, options?: {
+        immediate?: boolean;
+    }) => () => void;
+};
+export declare const devicePlugin: () => ComponentPlugin<DeviceControls>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/device/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/device/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG;IAS3B,YAAY,EAAE,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,EACtE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAC9B,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,YAAY,QAAO,eAAe,CAAC,cAAc,CA6C5D,CAAC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,8 @@
+export { devicePlugin, type DeviceControls } from './device';
+export { morphPlugin, type IdiomorphAPI, type IdiomorphGetter, type MorphControls, type MorphOptions, } from './morph';
+export { windowPlugin, type WindowControls } from './window';
+export { inViewPlugin, type InViewControls, type InViewHandler, type InViewOptions, } from './inview';
+export { lenisPlugin, type LenisControls, type LenisGetter, type LenisInstance, type LenisScrollEvent, type LenisScrollHandler, } from './lenis';
+export { timerPlugin, type TimerControls, type TimerIntervalHandle, type TimerRafCallback, type TimerRafUnsubscribe, type TimerTimeoutHandle, } from './timer';
+export { mousePlugin, type MouseControls, type MouseEventHandler, type MouseUnsubscribe, type MouseWheelHandler, } from './mouse';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EACL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC"}

package/dist/plugins/inview/index.d.ts

@@ -0,0 +1,63 @@
+import type { ComponentPlugin } from '../../index';
+/**
+ * In-view handler signature.
+ *
+ * @example
+ * ```ts
+ * const handler: InViewHandler = (isInView, entry) => {
+ *   if (isInView) entry.target.classList.add("is-in");
+ * };
+ * ```
+ */
+export type InViewHandler = (isInView: boolean, entry: IntersectionObserverEntry) => void;
+/**
+ * Options for IntersectionObserver plus an immediate callback toggle.
+ *
+ * `immediate` controls whether the first observer callback is skipped.
+ */
+export type InViewOptions = IntersectionObserverInit & {
+    immediate?: boolean;
+};
+/**
+ * In-view plugin controls.
+ *
+ * @example
+ * ```ts
+ * import { inViewPlugin } from "@/lib/plugins/inview";
+ *
+ * define(
+ *   "c-example",
+ *   { plugins: [inViewPlugin()] },
+ *   ({ onInView }) => {
+ *     onInView((isInView) => {
+ *       console.log("host in view:", isInView);
+ *     });
+ *     return () => "<div>...</div>";
+ *   }
+ * );
+ * ```
+ */
+export type InViewControls = {
+    /**
+     * Observe the component host element.
+     */
+    onInView: (handler: InViewHandler, options?: InViewOptions) => () => void;
+    /**
+     * Observe a specific element (ref or any Element).
+     */
+    observeInView: (element: Element, handler: InViewHandler, options?: InViewOptions) => () => void;
+};
+/**
+ * In-view plugin based on IntersectionObserver.
+ *
+ * @example
+ * ```ts
+ * const { observeInView } = inViewPlugin().extend(ctx, host);
+ * observeInView(el, (isInView) => {
+ *   el.toggleAttribute("data-inview", isInView);
+ * }, { rootMargin: "0px 0px -20% 0px" });
+ * ```
+ */
+declare const inViewPlugin: () => ComponentPlugin<InViewControls>;
+export { inViewPlugin, type InViewControls as InViewPluginControls, type InViewHandler as InViewPluginHandler, type InViewOptions as InViewPluginOptions, };
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/inview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/inview/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,yBAAyB,KAC7B,IAAI,CAAC;AAEV;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,wBAAwB,GAAG;IACrD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,MAAM,IAAI,CAAC;IAC1E;;OAEG;IACH,aAAa,EAAE,CACb,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,aAAa,KACpB,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,QAAA,MAAM,YAAY,QAAO,eAAe,CAAC,cAAc,CA4DrD,CAAC;AAEH,OAAO,EACL,YAAY,EACZ,KAAK,cAAc,IAAI,oBAAoB,EAC3C,KAAK,aAAa,IAAI,mBAAmB,EACzC,KAAK,aAAa,IAAI,mBAAmB,GAC1C,CAAC"}

package/dist/plugins/lenis/index.d.ts

@@ -0,0 +1,37 @@
+import type { ComponentPlugin } from '../../index';
+/**
+ * Minimal Lenis instance interface used by this plugin.
+ * Compatible with the Lenis smooth scroll library (lenis package).
+ */
+export interface LenisInstance {
+    on(event: 'scroll', handler: (event: LenisScrollEvent) => void): void;
+    off?(event: 'scroll', handler: (event: LenisScrollEvent) => void): void;
+}
+/**
+ * Lenis scroll event payload.
+ * Emitted on each scroll update with current scroll state.
+ */
+export interface LenisScrollEvent {
+    scroll: number;
+    limit: number;
+    velocity: number;
+    direction: number;
+    progress: number;
+}
+/** Handler called on each Lenis scroll event. */
+export type LenisScrollHandler = (event: LenisScrollEvent) => void;
+/** Controls exposed to components when the lenis plugin is used. */
+export type LenisControls = {
+    /** Subscribe to Lenis scroll events. Returns an unsubscribe function. */
+    onLenisScroll: (handler: LenisScrollHandler) => () => void;
+};
+/** Factory that returns the current Lenis instance (may be null before init). */
+export type LenisGetter = () => LenisInstance | null | undefined;
+/**
+ * Plugin that wires components to Lenis smooth scroll events.
+ *
+ * @param getLenis - Function that returns the current Lenis instance
+ * @returns A component plugin providing onLenisScroll
+ */
+export declare const lenisPlugin: (getLenis: LenisGetter) => ComponentPlugin<LenisControls>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/lenis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/lenis/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IACtE,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEnE,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,yEAAyE;IACzE,aAAa,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,MAAM,IAAI,CAAC;CAC5D,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,MAAM,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,WAAW,KACpB,eAAe,CAAC,aAAa,CAyC9B,CAAC"}

package/dist/plugins/lerp/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/lerp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/lerp/index.ts"],"names":[],"mappings":""}

package/dist/plugins/morph/index.d.ts

@@ -0,0 +1,92 @@
+import type { ComponentPlugin } from '../../index';
+/**
+ * Minimal Idiomorph API used by this plugin.
+ * Compatible with the idiomorph package.
+ */
+export interface IdiomorphAPI {
+    morph(target: Element, html: string, options?: Record<string, unknown>): void;
+}
+/** Factory that returns the Idiomorph instance to use for morphing. */
+export type IdiomorphGetter = () => IdiomorphAPI;
+/**
+ * Options for the morph plugin.
+ */
+export type MorphOptions = {
+    /**
+     * Preserve the value of the focused input element during morph.
+     * @default true
+     */
+    ignoreActiveValue?: boolean;
+    /**
+     * Additional callbacks forwarded to Idiomorph.
+     *
+     * @see https://github.com/bigskysoftware/idiomorph#callbacks
+     */
+    callbacks?: Record<string, (...args: any[]) => any>;
+};
+/**
+ * Morph plugin controls.
+ *
+ * @example
+ * ```ts
+ * import { Idiomorph } from 'idiomorph';
+ * import { morphPlugin } from "@/lib/plugins/morph";
+ *
+ * define(
+ *   "c-search",
+ *   { plugins: [morphPlugin(() => Idiomorph)] },
+ *   ({ morph, state, actions, host }) => {
+ *     state.query = "";
+ *     actions.onInput = (e: Event) => {
+ *       host.setState({ query: (e.target as HTMLInputElement).value });
+ *     };
+ *     return () => `
+ *       <input type="text" on:input="onInput" />
+ *       <p>Results for: {query}</p>
+ *     `;
+ *   }
+ * );
+ * ```
+ */
+export type MorphControls = {
+    /**
+     * Morph the component root with the given HTML string.
+     *
+     * @example
+     * ```ts
+     * morph('<div class="updated">New content</div>');
+     * ```
+     */
+    morph: (html: string) => void;
+};
+/**
+ * DOM morphing plugin powered by Idiomorph.
+ *
+ * Intercepts `innerHTML` writes on the component root so that every
+ * re-render after the initial mount patches the existing DOM in place
+ * instead of replacing it. This preserves focus, selection, scroll
+ * position and running CSS animations across re-renders.
+ *
+ * The first render always uses native `innerHTML` for speed since
+ * there is no existing DOM state to preserve.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { Idiomorph } from 'idiomorph';
+ *
+ * define("c-counter", { plugins: [morphPlugin(() => Idiomorph)] }, ({ state, actions, host }) => {
+ *   state.count = 0;
+ *   actions.increment = () => host.setState({ count: state.count + 1 });
+ *   return () => `<button on:click="increment">Count: {count}</button>`;
+ * });
+ * ```
+ *
+ * @example With options
+ * ```ts
+ * define("c-editor", { plugins: [morphPlugin(() => Idiomorph, { ignoreActiveValue: false })] }, ({ host }) => {
+ *   return () => `<textarea></textarea>`;
+ * });
+ * ```
+ */
+export declare const morphPlugin: (getIdiomorph: IdiomorphGetter, options?: MorphOptions) => ComponentPlugin<MorphControls>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/morph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/morph/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC/E;AAED,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;;;OAOG;IACH,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,WAAW,GACtB,cAAc,eAAe,EAC7B,UAAS,YAAiB,KACzB,eAAe,CAAC,aAAa,CAkD9B,CAAC"}

package/dist/plugins/mouse/index.d.ts

@@ -0,0 +1,91 @@
+import type { ComponentPlugin } from '../../index';
+/** Handler for mouse move, down, and up events. Receives client coordinates and the native event. */
+export type MouseEventHandler = (x: number, y: number, event: MouseEvent) => void;
+/** Handler for wheel events. Receives client coordinates, scroll delta, and the native event. */
+export type MouseWheelHandler = (x: number, y: number, deltaY: number, event: WheelEvent) => void;
+/** Unsubscribe function returned by each mouse listener. Call to remove the listener. */
+export type MouseUnsubscribe = () => void;
+/**
+ * Mouse plugin controls. All listeners are bound to `window` and cleaned up on component destroy.
+ *
+ * @example
+ * ```ts
+ * define("cursor-follower", { plugins: [mousePlugin()] }, ({ onMouseMove, host }) => {
+ *   const stop = onMouseMove((x, y) => {
+ *     host.updateState({ cursorX: x, cursorY: y });
+ *   });
+ *   return () => `<div style="left: {cursorX}px; top: {cursorY}px">...</div>`;
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Parallax on scroll
+ * onMouseWheel((x, y, deltaY) => {
+ *   parallaxOffset += deltaY * 0.1;
+ * });
+ * ```
+ */
+export type MouseControls = {
+    /**
+     * Subscribe to global mouse move. Returns an unsubscribe function.
+     *
+     * @example
+     * ```ts
+     * const stop = onMouseMove((x, y) => {
+     *   console.log(`cursor at ${x}, ${y}`);
+     * });
+     * // later: stop();
+     * ```
+     */
+    onMouseMove: (handler: MouseEventHandler) => MouseUnsubscribe;
+    /**
+     * Subscribe to global mouse down. Returns an unsubscribe function.
+     *
+     * @example
+     * ```ts
+     * onMouseDown((x, y, e) => {
+     *   if (e.button === 0) startDrag(x, y);
+     * });
+     * ```
+     */
+    onMouseDown: (handler: MouseEventHandler) => MouseUnsubscribe;
+    /**
+     * Subscribe to global mouse up. Returns an unsubscribe function.
+     *
+     * @example
+     * ```ts
+     * onMouseUp(() => endDrag());
+     * ```
+     */
+    onMouseUp: (handler: MouseEventHandler) => MouseUnsubscribe;
+    /**
+     * Subscribe to global wheel events. Returns an unsubscribe function.
+     *
+     * @example
+     * ```ts
+     * onMouseWheel((x, y, deltaY) => {
+     *   zoomLevel += deltaY > 0 ? -0.1 : 0.1;
+     * });
+     * ```
+     */
+    onMouseWheel: (handler: MouseWheelHandler) => MouseUnsubscribe;
+};
+/**
+ * Mouse plugin – global mouse and wheel listeners with automatic cleanup.
+ *
+ * Listeners are attached to `window`. All subscriptions are removed when the
+ * component is destroyed. Safe to use in SSR (no-op when `window` is undefined).
+ *
+ * @example
+ * ```ts
+ * define("my-component", { plugins: [mousePlugin()] }, ({ onMouseMove, onMouseDown, onMouseUp }) => {
+ *   onMouseMove((x, y) => updateCursor(x, y));
+ *   onMouseDown((x, y, e) => e.button === 0 && startDrag(x, y));
+ *   onMouseUp(() => endDrag());
+ *   return () => `<div>...</div>`;
+ * });
+ * ```
+ */
+export declare const mousePlugin: () => ComponentPlugin<MouseControls>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/mouse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/mouse/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE,qGAAqG;AACrG,MAAM,MAAM,iBAAiB,GAAG,CAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,UAAU,KACd,IAAI,CAAC;AAEV,iGAAiG;AACjG,MAAM,MAAM,iBAAiB,GAAG,CAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,UAAU,KACd,IAAI,CAAC;AAEV,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;;;;;;OAUG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;IAC9D;;;;;;;;;OASG;IACH,WAAW,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;IAC9D;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;IAC5D;;;;;;;;;OASG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,gBAAgB,CAAC;CAChE,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,QAAO,eAAe,CAAC,aAAa,CAyE1D,CAAC"}

package/dist/plugins/spring/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/spring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/spring/index.ts"],"names":[],"mappings":""}

package/dist/plugins/timer/index.d.ts

@@ -0,0 +1,82 @@
+import type { ComponentPlugin } from '../../index';
+/** Handle returned by `timer.setTimeout`. Use with `clearTimeout` if needed before destroy. */
+export type TimerTimeoutHandle = ReturnType<typeof setTimeout>;
+/** Handle returned by `timer.setInterval`. Use with `clearInterval` if needed before destroy. */
+export type TimerIntervalHandle = ReturnType<typeof setInterval>;
+/** Callback for `timer.raf`. Receives high-res timestamp and time since last frame (ms). */
+export type TimerRafCallback = (time: number, deltaTime: number) => void;
+/** Unsubscribe function returned by `timer.raf`. Call to stop the animation loop. */
+export type TimerRafUnsubscribe = () => void;
+/**
+ * Timer plugin controls. All timeouts, intervals, and RAF loops are cleared on component destroy.
+ *
+ * @example
+ * ```ts
+ * define("delayed-tooltip", { plugins: [timerPlugin()] }, ({ timer }) => {
+ *   timer.setTimeout(() => showTooltip(), 500);
+ *   timer.raf((time, dt) => updateAnimation(dt));
+ *   return () => `<div>...</div>`;
+ * });
+ * ```
+ */
+export type TimerControls = {
+    /**
+     * Scoped `setTimeout`. Cleared automatically on component destroy.
+     *
+     * @example
+     * ```ts
+     * const id = timer.setTimeout(() => doSomething(), 1000);
+     * // or with args: timer.setTimeout((a, b) => log(a, b), 500, "hello", 42);
+     * ```
+     */
+    setTimeout: (cb: (...args: unknown[]) => void, delay?: number, ...args: unknown[]) => TimerTimeoutHandle;
+    /**
+     * Scoped `setInterval`. Cleared automatically on component destroy.
+     *
+     * @example
+     * ```ts
+     * timer.setInterval(() => tick(), 1000);
+     * ```
+     */
+    setInterval: (cb: (...args: unknown[]) => void, delay?: number, ...args: unknown[]) => TimerIntervalHandle;
+    /**
+     * RequestAnimationFrame loop. Optionally throttle to a target FPS.
+     * Returns an unsubscribe function to stop the loop early.
+     *
+     * @example
+     * ```ts
+     * const stop = timer.raf((time, deltaTime) => {
+     *   position += velocity * (deltaTime / 1000);
+     * });
+     * // later: stop();
+     * ```
+     *
+     * @example
+     * ```ts
+     * // Throttle to 30 FPS
+     * timer.raf((time, dt) => update(dt), 30);
+     * ```
+     */
+    raf: (cb: TimerRafCallback, fps?: number) => TimerRafUnsubscribe;
+};
+/**
+ * Timer plugin – scoped setTimeout, setInterval, and RAF with automatic cleanup.
+ *
+ * All timers are cleared when the component is destroyed. The RAF loop supports
+ * optional FPS throttling for performance-sensitive animations.
+ *
+ * @example
+ * ```ts
+ * define("my-component", { plugins: [timerPlugin()] }, ({ timer }) => {
+ *   timer.setTimeout(() => host.updateState({ ready: true }), 2000);
+ *   const stop = timer.raf((time, dt) => {
+ *     host.updateState({ elapsed: time });
+ *   });
+ *   return () => `<div>{elapsed}</div>`;
+ * });
+ * ```
+ */
+export declare const timerPlugin: () => ComponentPlugin<{
+    timer: TimerControls;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/timer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/timer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE,+FAA+F;AAC/F,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAE/D,iGAAiG;AACjG,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAEjE,4FAA4F;AAC5F,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzE,qFAAqF;AACrF,MAAM,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC;AAE7C;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;;;;OAQG;IACH,UAAU,EAAE,CACV,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAChC,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,kBAAkB,CAAC;IACxB;;;;;;;OAOG;IACH,WAAW,EAAE,CACX,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAChC,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,IAAI,EAAE,OAAO,EAAE,KACf,mBAAmB,CAAC;IACzB;;;;;;;;;;;;;;;;;OAiBG;IACH,GAAG,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAClE,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,QAAO,eAAe,CAAC;IAAE,KAAK,EAAE,aAAa,CAAA;CAAE,CAyErE,CAAC"}

package/dist/plugins/window/index.d.ts

@@ -0,0 +1,11 @@
+import type { ComponentPlugin } from '../../index';
+export type WindowControls = {
+    onViewportResize: (handler: (width: number, height: number, event: UIEvent) => void, options?: {
+        immediate?: boolean;
+    }) => () => void;
+    onWindowResize: (handler: (width: number, height: number, event: UIEvent | ResizeObserverEntry) => void, options?: {
+        immediate?: boolean;
+    }) => () => void;
+};
+export declare const windowPlugin: () => ComponentPlugin<WindowControls>;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/window/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/window/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG;IAO3B,gBAAgB,EAAE,CAChB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,EAChE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAC9B,MAAM,IAAI,CAAC;IAShB,cAAc,EAAE,CACd,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GAAG,mBAAmB,KACjC,IAAI,EACT,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAC9B,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,YAAY,QAAO,eAAe,CAAC,cAAc,CA8E5D,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@petit-kit/scoped",
+  "version": "0.0.1",
+  "description": "A lightweight, reactive web component framework with built-in plugins for modern web development.",
+  "keywords": [
+    "web-components",
+    "custom-elements",
+    "reactive",
+    "framework-agnostic",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/petit-kit/scoped"
+  },
+  "bugs": {
+    "url": "https://github.com/petit-kit/scoped/issues"
+  },
+  "homepage": "https://github.com/petit-kit/scoped",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.0.0",
+    "prettier": "^3.8.1",
+    "rollup": "^4.28.1",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "npm run clean && npm run format && rollup -c && npm run build:types",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "dev": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  }
+}