rask-ui 0.10.1 → 0.10.3

package/README.md

@@ -328,7 +328,7 @@ function Example() {
 
 #### `assignState<T>(state, newState)`
 
-Merges properties from a new state object into an existing reactive state object. This is a convenience function that uses `Object.assign` internally.
+Merges properties from a new state object into an existing reactive state object. Returns the updated state object.
 
 ```tsx
 import { assignState, createState } from "rask-ui";
@@ -341,7 +341,7 @@ function Example() {
   });
 
   const updateProfile = (updates) => {
-    assignState(state, updates);
+    return assignState(state, updates);
   };
 
   return () => (
@@ -360,9 +360,11 @@ function Example() {
 - `state: T` - The reactive state object to update
 - `newState: T` - Object with properties to merge into the state
 
+**Returns:** The updated state object (same reference as input state)
+
 **Notes:**
 
-- Equivalent to `Object.assign(state, newState)`
+- Equivalent to `Object.assign(state, newState)` - returns the state for chaining
 - Triggers reactivity for all updated properties
 - Useful for bulk state updates from form data or API responses
 
@@ -724,10 +726,12 @@ function Child() {
 
 ### Async Data Management
 
-#### `createTask<T, P>(task)`
+#### `createTask<P, T>(task)`
 
 A low-level reactive primitive for managing any async operation. `createTask` provides the foundation for building data fetching, mutations, polling, debouncing, and any other async pattern you need. It gives you full control without prescribing specific patterns.
 
+The `Task<P, T>` type is also exported for type annotations. When used with one type parameter, it represents a task with no parameters. With two type parameters, the first is the params type and the second is the return type.
+
 ```tsx
 import { createTask, createState } from "rask-ui";
 
@@ -864,18 +868,35 @@ function TodoList() {
 
 ```tsx
 // Task without parameters - auto-runs on creation
-createTask<T>(task: () => Promise<T>): Task<T, never> & {
+createTask<T>(task: () => Promise<T>): Task<T> & {
   run(): Promise<T>;
   rerun(): Promise<T>;
 }
 
 // Task with parameters - manual control
-createTask<T, P>(task: (params: P) => Promise<T>): Task<T, P> & {
+createTask<P, T>(task: (params: P) => Promise<T>): Task<P, T> & {
   run(params: P): Promise<T>;
   rerun(params: P): Promise<T>;
 }
 ```
 
+**Task Type:**
+
+The `Task` type is exported and can be used for type annotations:
+
+```tsx
+import { Task } from "rask-ui";
+
+// Task that returns a string, no parameters
+const myTask: Task<string>;
+
+// Task that accepts string parameters and returns a string
+const myTask: Task<string, string>;
+
+// Task that accepts a number parameter and returns a User object
+const myTask: Task<number, User>;
+```
+
 **Returns:** Task object with reactive state and methods:
 
 **State Properties:**

package/dist/createState.d.ts

@@ -1,4 +1,4 @@
-export declare function assignState<T extends object>(state: T, newState: T): void;
+export declare function assignState<T extends object>(state: T, newState: T): T;
 /**
  * Creates a reactive state object that tracks property access and notifies observers on changes.
  *

package/dist/createState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createState.d.ts","sourceRoot":"","sources":["../src/createState.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,QAElE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzD;AAGD,eAAO,MAAM,YAAY,eAAoB,CAAC"}
+{"version":3,"file":"createState.d.ts","sourceRoot":"","sources":["../src/createState.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAElE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEzD;AAGD,eAAO,MAAM,YAAY,eAAoB,CAAC"}

package/dist/createState.js

@@ -1,7 +1,7 @@
 import { INSPECT_MARKER, INSPECTOR_ENABLED } from "./inspect";
 import { getCurrentObserver, Signal } from "./observation";
 export function assignState(state, newState) {
-    Object.assign(state, newState);
+    return Object.assign(state, newState);
 }
 /**
  * Creates a reactive state object that tracks property access and notifies observers on changes.

package/dist/createTask.d.ts

@@ -1,4 +1,4 @@
-export type Task<T, P> = {
+export type TaskState<P, T> = {
     isRunning: false;
     params: null;
     result: null;
@@ -19,12 +19,13 @@ export type Task<T, P> = {
     result: null;
     error: string;
 };
-export declare function createTask<T>(task: () => Promise<T>): Task<T, never> & {
-    run(): Promise<T>;
-    rerun(): Promise<T>;
-};
-export declare function createTask<T, P>(task: (params: P) => Promise<T>): Task<T, P> & {
-    run(params: P): Promise<T>;
-    rerun(params: P): Promise<T>;
+export type Task<A, B = never> = [B] extends [never] ? TaskState<null, A> & {
+    run(): Promise<A>;
+    rerun(): Promise<A>;
+} : TaskState<A, B> & {
+    run(params: A): Promise<B>;
+    rerun(params: A): Promise<B>;
 };
+export declare function createTask<T>(task: () => Promise<T>): Task<T>;
+export declare function createTask<P, T>(task: (params: P) => Promise<T>): Task<P, T>;
 //# sourceMappingURL=createTask.d.ts.map

package/dist/createTask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createTask.d.ts","sourceRoot":"","sources":["../src/createTask.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,IACjB;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG;IACtE,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IAClB,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;CACrB,CAAC;AACF,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9B,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IACd,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAC"}
+{"version":3,"file":"createTask.d.ts","sourceRoot":"","sources":["../src/createTask.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,IACtB;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IACE,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,IAAI,CAAC;CACb,GACD;IACE,SAAS,EAAE,KAAK,CAAC;IACjB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEN,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAChD,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG;IACnB,GAAG,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IAClB,KAAK,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;CACrB,GACD,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAChB,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAC;AAEN,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/D,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/createTask.js

@@ -1,4 +1,4 @@
-import { createState } from "./createState";
+import { assignState, createState } from "./createState";
 export function createTask(task) {
     const state = createState({
         isRunning: false,
@@ -6,9 +6,6 @@ export function createTask(task) {
         error: null,
         params: null,
     });
-    const assign = (newState) => {
-        Object.assign(state, newState);
-    };
     let currentAbortController;
     const fetch = (params) => {
         currentAbortController?.abort();
@@ -19,7 +16,7 @@ export function createTask(task) {
             if (abortController.signal.aborted) {
                 return;
             }
-            assign({
+            assignState(state, {
                 isRunning: false,
                 result,
                 error: null,
@@ -30,7 +27,7 @@ export function createTask(task) {
             if (abortController.signal.aborted) {
                 return;
             }
-            assign({
+            assignState(state, {
                 isRunning: false,
                 result: null,
                 error: String(error),
@@ -54,7 +51,7 @@ export function createTask(task) {
         },
         run(params) {
             const promise = fetch(params);
-            assign({
+            assignState(state, {
                 isRunning: true,
                 result: null,
                 error: null,
@@ -64,7 +61,7 @@ export function createTask(task) {
         },
         rerun(params) {
             const promise = fetch(params);
-            assign({
+            assignState(state, {
                 isRunning: true,
                 result: state.result,
                 error: null,

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export { render } from "./render";
 export { createCleanup, createMountEffect, RaskStatefulComponent, RaskStatelessComponent, } from "./component";
 export { createContext } from "./createContext";
 export { createState, assignState } from "./createState";
-export { createTask, Task } from "./createTask";
+export { createTask, TaskState as Task } from "./createTask";
 export { ErrorBoundary } from "./error";
 export { createRef } from "inferno";
 export { createView } from "./createView";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,SAAS,IAAI,IAAI,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,cAAc,EACd,SAAS,GACV,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rask-ui",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",