@petit-kit/scoped 0.0.6 → 0.0.7

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/pointer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AACzE,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAW3D,+CAA+C;AAC/C,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;;;;;;OAaG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACrD,0EAA0E;IAC1E,WAAW,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC3C,CAAC;AAoCF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,aAAa,QAAO,eAAe,CAAC,eAAe,CAsD9D,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { ComponentPlugin } from '../../index';
+import { spring } from '@petit-kit/animate';
+type SpringValue = number | number[] | Record<string, number>;
+type SpringOptions<T extends SpringValue = number> = Parameters<typeof spring<T>>[0];
+type SpringController<T extends SpringValue = number> = ReturnType<typeof spring<T>>;
+export type SpringControls = {
+    /**
+     * Create an independent spring controller.
+     *
+     * @example
+     * const springX = createSpring({ from: 0, to: 1, stiffness: 200 });
+     * springX.setTarget(1);
+     */
+    createSpring: <T extends SpringValue>(options?: SpringOptions<T>) => SpringController<T>;
+    /**
+     * Drive a spring controller on the scoped timer RAF.
+     *
+     * @example
+     * const scale = createSpring({ from: 0, to: 1 });
+     * const stop = runSpring(scale, (value) => {
+     *   host.updateState({ scale: value });
+     * });
+     */
+    runSpring: <T extends SpringValue>(controller: SpringController<T>, onUpdate: (value: T, controller: SpringController<T>) => void, options?: {
+        fps?: number;
+        immediate?: boolean;
+        stopWhenDone?: boolean;
+    }) => () => void;
+};
+/**
+ * Scoped spring plugin built on top of the timer plugin.
+ *
+ * @example
+ * define("my-component", { plugins: [springPlugin()] }, ({ createSpring, runSpring, host }) => {
+ *   const scale = createSpring({ from: 0.8, to: 1 });
+ *   runSpring(scale, (value) => host.updateState({ scale: value }));
+ *   return () => `<div bind:style="transform: scale({scale})"></div>`;
+ * });
+ */
+export declare const springPlugin: () => ComponentPlugin<SpringControls>;
+export {};
+//# 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":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI5C,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9D,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,MAAM,IAAI,UAAU,CAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,CACjB,CAAC,CAAC,CAAC,CAAC;AACL,KAAK,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,MAAM,IAAI,UAAU,CAChE,OAAO,MAAM,CAAC,CAAC,CAAC,CACjB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;;OAMG;IACH,YAAY,EAAE,CAAC,CAAC,SAAS,WAAW,EAClC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,KACvB,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACzB;;;;;;;;OAQG;IACH,SAAS,EAAE,CAAC,CAAC,SAAS,WAAW,EAC/B,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC/B,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7D,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KACpE,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,QAAO,eAAe,CAAC,cAAc,CAyE5D,CAAC"}

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,14 @@
+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;
+    onWindowScroll: (handler: (scrollX: number, scrollY: number, event: Event) => 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;IAQhB,cAAc,EAAE,CACd,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,EACjE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAC9B,MAAM,IAAI,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,YAAY,QAAO,eAAe,CAAC,cAAc,CAuG5D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@petit-kit/scoped",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "A lightweight, reactive web component framework with built-in plugins for modern web development.",
   "keywords": [
     "web-components",
@@ -32,6 +32,17 @@
     "dist"
   ],
   "sideEffects": false,
+  "scripts": {
+    "build": "pnpm run version:patch && pnpm run build:doc && pnpm run clean && pnpm run format && rollup -c && pnpm run build:types",
+    "version:patch": "node version/patch.js",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "build:doc": "node doc/index.js",
+    "dev": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "publish": "pnpm build && pnpm publish --access public"
+  },
   "author": "",
   "license": "MIT",
   "devDependencies": {
@@ -46,14 +57,5 @@
   },
   "dependencies": {
     "@petit-kit/animate": "^0.0.1"
-  },
-  "scripts": {
-    "build": "pnpm run build:doc && pnpm run clean && pnpm run format && rollup -c && pnpm run build:types",
-    "build:types": "tsc -p tsconfig.declarations.json",
-    "build:doc": "node doc/index.js",
-    "dev": "rollup -c -w",
-    "clean": "rm -rf dist",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
   }
-}
+}