ngx-task 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mahmoud Adel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# ngx-task
+
+> **Signal-first controlled asynchronous actions for Angular with cancellation, lifecycle cleanup, and explicit concurrency policies.**
+
+[![Documentation](https://img.shields.io/badge/docs-Starlight-e0234e.svg)](https://MahmoudAdelJR.github.io/ngx-task-suite/)
+[![npm version](https://img.shields.io/npm/v/ngx-task.svg)](https://www.npmjs.com/package/ngx-task)
+[![license](https://img.shields.io/npm/l/ngx-task.svg)](LICENSE)
+[![bundle size](https://img.shields.io/bundlephobia/minzip/ngx-task)](https://bundlephobia.com/result?p=ngx-task)
+
+Stop rewriting loading flags, cancellation controllers, duplicate submission guards, and queue mechanics for every Angular action. `ngx-task` provides a single reactive primitive that explicitly answers the question:
+
+> **"What should happen when this asynchronous operation is invoked again before it finishes?"**
+
+---
+
+## 📖 Full Interactive Documentation
+
+Explore our complete Astro Starlight documentation site online:
+
+👉 **[https://MahmoudAdelJR.github.io/ngx-task-suite/](https://MahmoudAdelJR.github.io/ngx-task-suite/)**
+
+| Section | Description & Link |
+| :--- | :--- |
+| 🚀 **Getting Started** | [Installation](https://MahmoudAdelJR.github.io/ngx-task-suite/getting-started/installation/) & [Quick Start Guide](https://MahmoudAdelJR.github.io/ngx-task-suite/getting-started/quick-start/) |
+| 🧠 **Concepts** | [Architecture](https://MahmoudAdelJR.github.io/ngx-task-suite/concepts/architecture/) & [Task vs Resource / RxJS](https://MahmoudAdelJR.github.io/ngx-task-suite/concepts/task-vs-resource/) |
+| 🛠️ **Core API Reference** | [`createTask()`](https://MahmoudAdelJR.github.io/ngx-task-suite/api-reference/create-task/), [Task Signals](https://MahmoudAdelJR.github.io/ngx-task-suite/api-reference/task-signals/), [TaskExecution](https://MahmoudAdelJR.github.io/ngx-task-suite/api-reference/task-execution/), [TaskContext](https://MahmoudAdelJR.github.io/ngx-task-suite/api-reference/task-context/) |
+| 🚦 **Concurrency Policies** | [Overview](https://MahmoudAdelJR.github.io/ngx-task-suite/concurrency/overview/), [`drop`](https://MahmoudAdelJR.github.io/ngx-task-suite/concurrency/drop/), [`restart`](https://MahmoudAdelJR.github.io/ngx-task-suite/concurrency/restart/), [`enqueue`](https://MahmoudAdelJR.github.io/ngx-task-suite/concurrency/enqueue/), [`latest`](https://MahmoudAdelJR.github.io/ngx-task-suite/concurrency/latest/), [`parallel`](https://MahmoudAdelJR.github.io/ngx-task-suite/concurrency/parallel/) |
+| 🔌 **Handlers & Adapters** | [Promise Async/Await](https://MahmoudAdelJR.github.io/ngx-task-suite/handlers/promises/) & [RxJS HttpClient](https://MahmoudAdelJR.github.io/ngx-task-suite/handlers/observables/) |
+| ⚡ **Production Features** | [Timeouts](https://MahmoudAdelJR.github.io/ngx-task-suite/advanced/timeouts/), [Anti-Flicker](https://MahmoudAdelJR.github.io/ngx-task-suite/advanced/anti-flicker/), [Error Classification](https://MahmoudAdelJR.github.io/ngx-task-suite/advanced/error-handling/), [Progress & Retries](https://MahmoudAdelJR.github.io/ngx-task-suite/advanced/progress-retries/), [Lifecycle](https://MahmoudAdelJR.github.io/ngx-task-suite/advanced/lifecycle/) |
+| 🎨 **Template Directives** | [Directives Overview](https://MahmoudAdelJR.github.io/ngx-task-suite/directives/overview/) (`[taskTrigger]`, `[taskDisableWhilePending]`, `[taskBusy]`) |
+| 🧪 **Testing Utilities** | [Testing Guide](https://MahmoudAdelJR.github.io/ngx-task-suite/testing/overview/) (`createTaskHarness`, `createControlledTaskHandler`) |
+| ⚡ **Advanced** | [Zoneless Angular Integration](https://MahmoudAdelJR.github.io/ngx-task-suite/advanced/zoneless/) |
+
+---
+
+## ⚡ Quick Start
+
+```ts
+import { Component, inject } from '@angular/core';
+import { createTask, TaskTriggerDirective, TaskDisableWhilePendingDirective } from 'ngx-task';
+import { TaskTriggerDirective, TaskDisableWhilePendingDirective } from 'ngx-task/directives';
+
+@Component({
+  selector: 'app-profile-editor',
+  standalone: true,
+  imports: [TaskTriggerDirective, TaskDisableWhilePendingDirective],
+  template: `
+    <button
+      type="button"
+      [taskTrigger]="saveProfile"
+      [taskArgs]="userForm"
+      taskDisableWhilePending
+    >
+      @if (saveProfile.pending()) {
+        Saving…
+      } @else {
+        Save Profile
+      }
+    </button>
+
+    @if (saveProfile.error(); as err) {
+      <p class="error">{{ err.message }}</p>
+    }
+  `,
+})
+export class ProfileEditorComponent {
+  private api = inject(ProfileApiService);
+  readonly userForm = { name: 'Alice', email: 'alice@example.com' };
+
+  readonly saveProfile = createTask(
+    async (profile, { signal }) => {
+      return this.api.saveProfile(profile, { signal });
+    },
+    {
+      concurrency: 'drop', // Prevent duplicate submissions while active
+      timeout: 15_000,     // 15 seconds timeout
+      pendingDelay: 150,   // Prevent visual flicker on fast requests
+    },
+  );
+}
+```
+
+---
+
+## 🚦 Concurrency Policies Comparison
+
+| Policy | Behavior | Typical Use Case |
+| :--- | :--- | :--- |
+| **`drop`** | Ignores new invocations while an execution is running. | Form submission, Login, Payment checkout, Destructive actions |
+| **`restart`** | Supersedes active execution and runs the newest invocation immediately. | Search suggestions, Live form validation, Tab switching |
+| **`enqueue`** | Executes invocations sequentially in FIFO order. | Ordered audit logs, Sequential file uploads, Document patches |
+| **`latest`** | Finishes active execution, but keeps only the newest queued invocation (superseding intermediate ones). | Autosave document, Canvas/Slider sync, Editor autosave |
+| **`parallel`** | Runs up to `limit` executions simultaneously, queueing excess invocations. | Bulk file uploads, Preloading independent assets, Batch jobs |
+
+---
+
+## 🧠 Conceptual Reference
+
+### 1. Task vs Resource
+- **`Resource` (e.g. `rxResource` / `resource`):** Reactive value loading bound to dependency signals (declarative data fetching).
+- **`Task` (`ngx-task`):** Explicit command triggered imperatively by user interaction (form submit, button click, file upload) with explicit concurrency rules.
+
+### 2. Task vs RxJS Flattening Operators
+RxJS flattening operators (`exhaustMap`, `switchMap`, `concatMap`, `mergeMap`) operate on stream transformations. `ngx-task` exposes execution handles, signals (`pending`, `running`, `result`, `error`), progress, anti-flicker timing, and component `DestroyRef` cleanup as a high-level Angular primitive.
+
+### 3. Cooperative Cancellation Contract
+`ngx-task` provides an `AbortSignal` for Promise handlers and automatically calls `unsubscribe()` for RxJS Observables. Handlers must observe `context.signal` (or pass it to `fetch` / `HttpClient`) to stop ongoing network I/O.
+
+---
+
+## 📦 Package Entry Points
+
+- `ngx-task` — Core `createTask`, signals, schedulers, state machines, and adapters.
+- `ngx-task/directives` — Optional template directives (`[taskTrigger]`, `[taskDisableWhilePending]`, `[taskBusy]`).
+- `ngx-task/testing` — Test utilities (`createTaskHarness`, `createControlledTaskHandler`, `createDeferred`, `createTaskTestClock`).
+
+---
+
+## ⚖️ License
+MIT © Antigravity Team

package/lib/adapters/observable-adapter.d.ts

@@ -0,0 +1,20 @@
+import type { Observable } from 'rxjs';
+import type { ExecutionStateMachine } from '../core/execution-state-machine.js';
+import type { TaskContext } from '../core/task-context.js';
+import type { TaskError } from '../core/types.js';
+export type ObservableResultPolicy = 'latest' | 'first' | 'last' | 'forbid-multiple';
+export declare function isObservable(value: unknown): value is Observable<unknown>;
+export interface ObservableAdapterOptions {
+    observableResult?: ObservableResultPolicy;
+    classifyError?: (error: unknown) => TaskError;
+}
+export type ObservableTaskHandler<TArgs, TResult> = (args: TArgs, context: TaskContext) => Observable<TResult>;
+export declare class ObservableOperationAdapter<TArgs, TResult> {
+    private readonly handler;
+    private readonly policy;
+    private readonly classifyError;
+    constructor(handler: ObservableTaskHandler<TArgs, TResult>, options?: ObservableAdapterOptions);
+    runWithObservable(execution: ExecutionStateMachine<TArgs, TResult>, observable: Observable<TResult>): void;
+    run(execution: ExecutionStateMachine<TArgs, TResult>): void;
+}
+//# sourceMappingURL=observable-adapter.d.ts.map

package/lib/adapters/observable-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable-adapter.d.ts","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/adapters/observable-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,MAAM,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAErF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAAC,OAAO,CAAC,CAMzE;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC;CAC/C;AAED,MAAM,MAAM,qBAAqB,CAAC,KAAK,EAAE,OAAO,IAAI,CAClD,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,WAAW,KACjB,UAAU,CAAC,OAAO,CAAC,CAAC;AAEzB,qBAAa,0BAA0B,CAAC,KAAK,EAAE,OAAO;IAKlD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;gBAG3C,OAAO,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,EAC/D,OAAO,CAAC,EAAE,wBAAwB;IAMpC,iBAAiB,CACf,SAAS,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,EAChD,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,GAC9B,IAAI;IA4EP,GAAG,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI;CAW5D"}

package/lib/adapters/observable-adapter.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObservableOperationAdapter = void 0;
+exports.isObservable = isObservable;
+const promise_adapter_js_1 = require("./promise-adapter.js");
+function isObservable(value) {
+    return (value !== null &&
+        (typeof value === 'object' || typeof value === 'function') &&
+        typeof value.subscribe === 'function');
+}
+class ObservableOperationAdapter {
+    handler;
+    policy;
+    classifyError;
+    constructor(handler, options) {
+        this.handler = handler;
+        this.policy = options?.observableResult ?? 'latest';
+        this.classifyError = options?.classifyError ?? promise_adapter_js_1.defaultClassifyError;
+    }
+    runWithObservable(execution, observable) {
+        const context = execution.createContext();
+        let subscription = null;
+        let lastValue;
+        let emissionCount = 0;
+        const onAbort = () => {
+            if (subscription && !subscription.closed) {
+                subscription.unsubscribe();
+            }
+        };
+        if (execution.signal.aborted) {
+            execution.cancel(execution.signal.reason);
+            return;
+        }
+        execution.signal.addEventListener('abort', onAbort, { once: true });
+        try {
+            subscription = observable.subscribe({
+                next: (value) => {
+                    if (execution.isSettled || execution.signal.aborted)
+                        return;
+                    emissionCount++;
+                    if (this.policy === 'first') {
+                        if (emissionCount === 1) {
+                            lastValue = value;
+                            execution.succeed(value);
+                            subscription?.unsubscribe();
+                        }
+                        return;
+                    }
+                    if (this.policy === 'forbid-multiple' && emissionCount > 1) {
+                        const err = {
+                            cause: new Error(`Observable emitted multiple values when policy was forbid-multiple.`),
+                            kind: 'application',
+                            message: `Observable emitted multiple values when policy was forbid-multiple.`,
+                            retryable: false,
+                        };
+                        execution.fail(err);
+                        subscription?.unsubscribe();
+                        return;
+                    }
+                    lastValue = value;
+                    execution.reportProgress({ current: emissionCount, message: `Emitted ${emissionCount} values` });
+                },
+                error: (error) => {
+                    execution.signal.removeEventListener('abort', onAbort);
+                    if (execution.isSettled || execution.signal.aborted)
+                        return;
+                    const taskError = this.classifyError(error);
+                    execution.fail(taskError);
+                },
+                complete: () => {
+                    execution.signal.removeEventListener('abort', onAbort);
+                    if (execution.isSettled || execution.signal.aborted)
+                        return;
+                    if (lastValue !== undefined) {
+                        execution.succeed(lastValue);
+                    }
+                    else {
+                        execution.succeed(undefined);
+                    }
+                },
+            });
+        }
+        catch (syncError) {
+            execution.signal.removeEventListener('abort', onAbort);
+            if (execution.isSettled || execution.signal.aborted)
+                return;
+            const taskError = this.classifyError(syncError);
+            execution.fail(taskError);
+        }
+    }
+    run(execution) {
+        const context = execution.createContext();
+        try {
+            const observable = this.handler(execution.args, context);
+            this.runWithObservable(execution, observable);
+        }
+        catch (syncError) {
+            if (execution.isSettled || execution.signal.aborted)
+                return;
+            const taskError = this.classifyError(syncError);
+            execution.fail(taskError);
+        }
+    }
+}
+exports.ObservableOperationAdapter = ObservableOperationAdapter;
+//# sourceMappingURL=observable-adapter.js.map

package/lib/adapters/observable-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observable-adapter.js","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/adapters/observable-adapter.ts"],"names":[],"mappings":"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"}

package/lib/adapters/promise-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { ExecutionStateMachine } from '../core/execution-state-machine.js';
+import type { TaskContext } from '../core/task-context.js';
+import type { TaskError } from '../core/types.js';
+export declare function defaultClassifyError(error: unknown): TaskError;
+export type PromiseTaskHandler<TArgs, TResult> = (args: TArgs, context: TaskContext) => PromiseLike<TResult>;
+export declare class PromiseOperationAdapter<TArgs, TResult> {
+    private readonly handler;
+    private readonly classifyError;
+    constructor(handler: PromiseTaskHandler<TArgs, TResult>, classifyError?: (error: unknown) => TaskError);
+    run(execution: ExecutionStateMachine<TArgs, TResult>): void;
+}
+//# sourceMappingURL=promise-adapter.d.ts.map

package/lib/adapters/promise-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-adapter.d.ts","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/adapters/promise-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAW9D;AAED,MAAM,MAAM,kBAAkB,CAAC,KAAK,EAAE,OAAO,IAAI,CAC/C,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,WAAW,KACjB,WAAW,CAAC,OAAO,CAAC,CAAC;AAE1B,qBAAa,uBAAuB,CAAC,KAAK,EAAE,OAAO;IAI/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;gBAG3C,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,EAC5D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS;IAK/C,GAAG,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI;CA2B5D"}

package/lib/adapters/promise-adapter.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromiseOperationAdapter = void 0;
+exports.defaultClassifyError = defaultClassifyError;
+function defaultClassifyError(error) {
+    if (error && typeof error === 'object' && 'kind' in error && 'message' in error) {
+        return error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        cause: error,
+        kind: 'application',
+        message: message || 'An error occurred during task execution',
+        retryable: false,
+    };
+}
+class PromiseOperationAdapter {
+    handler;
+    classifyError;
+    constructor(handler, classifyError) {
+        this.handler = handler;
+        this.classifyError = classifyError ?? defaultClassifyError;
+    }
+    run(execution) {
+        const context = execution.createContext();
+        try {
+            const resultPromise = this.handler(execution.args, context);
+            Promise.resolve(resultPromise).then((value) => {
+                execution.succeed(value);
+            }, (error) => {
+                if (execution.signal.aborted) {
+                    execution.cancel(error);
+                    return;
+                }
+                const taskError = this.classifyError(error);
+                execution.fail(taskError);
+            });
+        }
+        catch (syncError) {
+            if (execution.signal.aborted) {
+                execution.cancel(syncError);
+                return;
+            }
+            const taskError = this.classifyError(syncError);
+            execution.fail(taskError);
+        }
+    }
+}
+exports.PromiseOperationAdapter = PromiseOperationAdapter;
+//# sourceMappingURL=promise-adapter.js.map

package/lib/adapters/promise-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-adapter.js","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/adapters/promise-adapter.ts"],"names":[],"mappings":";;;AAIA,oDAWC;AAXD,SAAgB,oBAAoB,CAAC,KAAc;IACjD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,SAAS,IAAI,KAAK,EAAE,CAAC;QAChF,OAAO,KAAkB,CAAC;IAC5B,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO,IAAI,yCAAyC;QAC7D,SAAS,EAAE,KAAK;KACjB,CAAC;AACJ,CAAC;AAOD,MAAa,uBAAuB;IAIf;IAHF,aAAa,CAAgC;IAE9D,YACmB,OAA2C,EAC5D,aAA6C;QAD5B,YAAO,GAAP,OAAO,CAAoC;QAG5D,IAAI,CAAC,aAAa,GAAG,aAAa,IAAI,oBAAoB,CAAC;IAC7D,CAAC;IAED,GAAG,CAAC,SAAgD;QAClD,MAAM,OAAO,GAAG,SAAS,CAAC,aAAa,EAAE,CAAC;QAE1C,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5D,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CACjC,CAAC,KAAK,EAAE,EAAE;gBACR,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC3B,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACR,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC7B,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACxB,OAAO;gBACT,CAAC;gBACD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC5C,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5B,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC7B,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;YAChD,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF;AArCD,0DAqCC"}

package/lib/angular/create-task.d.ts

@@ -0,0 +1,3 @@
+import type { Task, TaskHandler, CreateTaskOptions } from './task.interface.js';
+export declare function createTask<TArgs, TResult>(handler: TaskHandler<TArgs, TResult>, options?: CreateTaskOptions<TArgs, TResult>): Task<TArgs, TResult>;
+//# sourceMappingURL=create-task.d.ts.map

package/lib/angular/create-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-task.d.ts","sourceRoot":"","sources":["../../../projects/ngx-task/src/lib/angular/create-task.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,IAAI,EAEJ,WAAW,EACX,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAsV7B,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EACvC,OAAO,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,EACpC,OAAO,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,GAC1C,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAEtB"}