katanakit-js 4.0.2 → 4.0.3

package/README.md

@@ -250,49 +250,48 @@ await usePost("myApi", "upload", form);
 
 ### Full example
 
-See [`examples/api-manager/demo.ts`](https://github.com/senseikatana/katanakit/tree/main/examples/api-manager) for a runnable demo
+See [`examples/api-manager/demo.ts`](https://github.com/senseikatana/katanakit-js/tree/main/examples/api-manager) for a runnable demo
 covering all CRUD operations, auth injection, URL building, and error handling
 against a real API (JSONPlaceholder).
 
 ## QueryClient — Cached Data Fetching
 
-The QueryClient is a data-fetching and caching layer built on the reactive kernel.
-It integrates with the API manager — your `queryFn` typically calls `useGetApi` or
-`useFetch` and returns the Safe Result.
+The query layer is powered by **TanStack Query Core**, bundled as a dependency —
+install `katanakit-js` and the engine comes with it. KatanaKit re-exports the full
+`@tanstack/query-core` API and adds framework bindings plus a bridge for the
+Safe Result pattern.
 
 ```ts
-import { QueryClient, useQueryClient } from "katanakit-js";
+import { useQueryClient, useInitQueryClient, useSafeQueryFn } from "katanakit-js";
 import { useGetApi } from "katanakit-js";
 
-// Initialize once (global singleton).
-const qc = useQueryClient();
-
-// Fetch with cache, stale-while-revalidate, retry, and dedup.
-const pokemon = await qc.fetchQuery<Pokemon>({
-	queryKey: ["pokemon", 25],
-	queryFn: () => useGetApi<Pokemon>("pokeapi", "pokemonById", { params: { id: 25 } }),
-	staleTime: 60_000, // Cache is fresh for 60s.
-	retry: 3, // Retry 3 times on failure.
-	refetchOnWindowFocus: true,
+// Configure the shared client once (defaults for every query).
+useInitQueryClient({
+	defaultOptions: { queries: { staleTime: 60_000, retry: 2 } },
 });
+
+// Access it anywhere to invalidate, prefetch, or set data.
+const qc = useQueryClient();
+await qc.invalidateQueries({ queryKey: ["pokemon"] });
 ```
 
 ### Vue composables
 
 ```vue
 <script setup>
-import { useQuery, useMutation, useQueryClient } from "katanakit-js/adapters/vue";
+import { useQuery, useMutation, useQueryClient, useSafeQueryFn } from "katanakit-js/adapters/vue";
 import { useGetApi, usePost } from "katanakit-js";
 
 const qc = useQueryClient();
 
-const { data, isLoading, error, refetch } = useQuery({
-  queryKey: () => ["users"],
-  queryFn: () => useGetApi<User[]>("myApi", "users"),
+const query = useQuery({
+  queryKey: ["users"],
+  queryFn: useSafeQueryFn(() => useGetApi<User[]>("myApi", "users")),
   staleTime: 30_000,
 });
+// query.data, query.isPending, query.isFetching, query.error, query.status…
 
-const { mutate, isLoading: mutating } = useMutation({
+const mutation = useMutation({
   mutationFn: (name: string) => usePost("myApi", "createUser", { name }),
   onSuccess: () => qc.invalidateQueries({ queryKey: ["users"] }),
 });
@@ -436,7 +435,7 @@ Also on the main barrel:
 | `useResetSession`      | `(sessionId) => Promise<void>`        |
 | `useCreateMemoryStore` | `() => ConversationStore`             |
 
-Then start a channel (see below). Copy keys from [`.env.example`](https://github.com/senseikatana/katanakit/blob/main/.env.example):
+Then start a channel (see below). Copy keys from [`.env.example`](https://github.com/senseikatana/katanakit-js/blob/main/.env.example):
 
 ```env
 DASHSCOPE_API_KEY=
@@ -575,7 +574,7 @@ owns the database, run `prisma contract emit` then `prisma db init` in that app.
 
 ### Real use case
 
-[`examples/assistant/`](https://github.com/senseikatana/katanakit/tree/main/examples/assistant) is a generic digital assistant with two demo tools:
+[`examples/assistant/`](https://github.com/senseikatana/katanakit-js/tree/main/examples/assistant) is a generic digital assistant with two demo tools:
 `readFile` on `knowledge-base.md` and `saveNote` to `notes.jsonl`.
 
 ```bash
@@ -630,7 +629,7 @@ import { useUnwrap } from "katanakit-js/adapters/nuxt"; // Nuxt only
 </script>
 ```
 
-See [Getting Started](https://senseikatana.com/katanakit-js/docs/guides/getting-started/) for full recipes.
+See [Getting Started](https://docs.senseikatana.com/docs/guides/getting-started/) for full recipes.
 
 ## Framework Adapters
 
@@ -850,17 +849,17 @@ if (users.ok) users.data.results.forEach((u) => console.log(u.name));
 
 #### Framework examples
 
-| Framework   | Example                                                                                                                        | Description                                  |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- |
-| **Vue 3**   | [`examples/notion/vue-blog.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/vue-blog.vue)             | Blog listing with `useQuery` composable      |
-| **Vue 3**   | [`examples/notion/vue-post.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/vue-post.vue)             | Single post view                             |
-| **Nuxt 3**  | [`examples/notion/nuxt-blog.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/nuxt-blog.vue)           | SSR blog listing with `useAsyncData`         |
-| **Nuxt 3**  | [`examples/notion/nuxt-post.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/nuxt-post.vue)           | SSR single post view                         |
-| **Astro**   | [`examples/notion/astro-blog.astro`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/astro-blog.astro)     | Static blog listing                          |
-| **Astro**   | [`examples/notion/astro-[slug].astro`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/astro-[slug].astro) | Dynamic `[slug]` route                       |
-| **Next.js** | [`examples/notion/next-blog.tsx`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/next-blog.tsx)           | Server component blog listing                |
-| **Next.js** | [`examples/notion/next-[slug].tsx`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/next-[slug].tsx)       | Dynamic `[slug]` page                        |
-| **Node.js** | [`examples/notion/demo.ts`](https://github.com/senseikatana/katanakit/tree/main/examples/notion/demo.ts)                       | Runnable demo covering all Notion operations |
+| Framework   | Example                                                                                                                           | Description                                  |
+| ----------- | --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
+| **Vue 3**   | [`examples/notion/vue-blog.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/vue-blog.vue)             | Blog listing with `useQuery` composable      |
+| **Vue 3**   | [`examples/notion/vue-post.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/vue-post.vue)             | Single post view                             |
+| **Nuxt 3**  | [`examples/notion/nuxt-blog.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/nuxt-blog.vue)           | SSR blog listing with `useAsyncData`         |
+| **Nuxt 3**  | [`examples/notion/nuxt-post.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/nuxt-post.vue)           | SSR single post view                         |
+| **Astro**   | [`examples/notion/astro-blog.astro`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/astro-blog.astro)     | Static blog listing                          |
+| **Astro**   | [`examples/notion/astro-[slug].astro`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/astro-[slug].astro) | Dynamic `[slug]` route                       |
+| **Next.js** | [`examples/notion/next-blog.tsx`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/next-blog.tsx)           | Server component blog listing                |
+| **Next.js** | [`examples/notion/next-[slug].tsx`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/next-[slug].tsx)       | Dynamic `[slug]` page                        |
+| **Node.js** | [`examples/notion/demo.ts`](https://github.com/senseikatana/katanakit-js/tree/main/examples/notion/demo.ts)                       | Runnable demo covering all Notion operations |
 
 ### WordPress
 
@@ -1206,17 +1205,17 @@ const full = await useWpGetPosts({
 
 #### Framework examples
 
-| Framework   | Example                                                                                                                              | Description                                                        |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------ |
-| **Vue 3**   | [`examples/wordpress/vue-blog.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/vue-blog.vue)             | Blog listing with categories, featured images, `_embed`            |
-| **Vue 3**   | [`examples/wordpress/vue-post.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/vue-post.vue)             | Single post view with embedded author                              |
-| **Nuxt 3**  | [`examples/wordpress/nuxt-blog.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/nuxt-blog.vue)           | SSR blog listing with `useAsyncData`                               |
-| **Nuxt 3**  | [`examples/wordpress/nuxt-post.vue`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/nuxt-post.vue)           | SSR single post view                                               |
-| **Astro**   | [`examples/wordpress/astro-blog.astro`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/astro-blog.astro)     | Static blog listing                                                |
-| **Astro**   | [`examples/wordpress/astro-[slug].astro`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/astro-[slug].astro) | Dynamic `[slug]` route                                             |
-| **Next.js** | [`examples/wordpress/next-blog.tsx`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/next-blog.tsx)           | Server component blog listing                                      |
-| **Next.js** | [`examples/wordpress/next-[slug].tsx`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/next-[slug].tsx)       | Dynamic `[slug]` page                                              |
-| **Node.js** | [`examples/wordpress/demo.ts`](https://github.com/senseikatana/katanakit/tree/main/examples/wordpress/demo.ts)                       | Runnable demo covering all WP operations, `_fields`, `_embed`, ACF |
+| Framework   | Example                                                                                                                                 | Description                                                        |
+| ----------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| **Vue 3**   | [`examples/wordpress/vue-blog.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/vue-blog.vue)             | Blog listing with categories, featured images, `_embed`            |
+| **Vue 3**   | [`examples/wordpress/vue-post.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/vue-post.vue)             | Single post view with embedded author                              |
+| **Nuxt 3**  | [`examples/wordpress/nuxt-blog.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/nuxt-blog.vue)           | SSR blog listing with `useAsyncData`                               |
+| **Nuxt 3**  | [`examples/wordpress/nuxt-post.vue`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/nuxt-post.vue)           | SSR single post view                                               |
+| **Astro**   | [`examples/wordpress/astro-blog.astro`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/astro-blog.astro)     | Static blog listing                                                |
+| **Astro**   | [`examples/wordpress/astro-[slug].astro`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/astro-[slug].astro) | Dynamic `[slug]` route                                             |
+| **Next.js** | [`examples/wordpress/next-blog.tsx`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/next-blog.tsx)           | Server component blog listing                                      |
+| **Next.js** | [`examples/wordpress/next-[slug].tsx`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/next-[slug].tsx)       | Dynamic `[slug]` page                                              |
+| **Node.js** | [`examples/wordpress/demo.ts`](https://github.com/senseikatana/katanakit-js/tree/main/examples/wordpress/demo.ts)                       | Runnable demo covering all WP operations, `_fields`, `_embed`, ACF |
 
 ## Contributing
 
@@ -1227,7 +1226,7 @@ better for everyone.
 ### Quick start
 
 ```bash
-git clone https://github.com/senseikatana/katanakit.git
+git clone https://github.com/senseikatana/katanakit-js.git
 cd katanakit-js
 git checkout dev
 bun install
@@ -1236,8 +1235,8 @@ bun run check  # verify everything works
 
 ### Ways to contribute
 
-- **Report bugs** — [Open an issue](https://github.com/senseikatana/katanakit/issues) with a clear description and reproduction steps
-- **Suggest features** — [Start a discussion](https://github.com/senseikatana/katanakit/discussions) to propose new ideas
+- **Report bugs** — [Open an issue](https://github.com/senseikatana/katanakit-js/issues) with a clear description and reproduction steps
+- **Suggest features** — [Start a discussion](https://github.com/senseikatana/katanakit-js/discussions) to propose new ideas
 - **Submit a PR** — Fork the repo, create a branch from `dev`, make your changes, and open a PR
 - **Improve docs** — Fix typos, add examples, or clarify explanations
 - **Add adapters** — Build integrations for new APIs or frameworks
@@ -1254,14 +1253,14 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development contract.
 
 ## Documentation
 
-The docs site is deployed with Render at [senseikatana.com/katanakit-js](https://senseikatana.com/katanakit-js/).
+The docs site is deployed with Cloudflare Pages at [docs.senseikatana.com](https://docs.senseikatana.com/).
 
-- [Getting Started](https://senseikatana.com/katanakit-js/docs/guides/getting-started/)
-- [Architecture](https://senseikatana.com/katanakit-js/docs/guides/architecture/)
-- [UI Kit (Katana UI)](https://senseikatana.com/katanakit-js/docs/ui-kit/)
-- [API Reference](https://senseikatana.com/katanakit-js/docs/api/)
-- [Roadmap](https://senseikatana.com/katanakit-js/docs/guides/roadmap/)
-- [Changelog](https://senseikatana.com/katanakit-js/docs/changelog/)
+- [Getting Started](https://docs.senseikatana.com/docs/guides/getting-started/)
+- [Architecture](https://docs.senseikatana.com/docs/guides/architecture/)
+- [UI Kit (Katana UI)](https://docs.senseikatana.com/docs/ui-kit/)
+- [API Reference](https://docs.senseikatana.com/docs/api/)
+- [Roadmap](https://docs.senseikatana.com/docs/guides/roadmap/)
+- [Changelog](https://docs.senseikatana.com/docs/changelog/)
 
 ## License
 

package/dist/adapters/angular/index.d.ts

@@ -1,3 +1,4 @@
+export { useCreateQueryClient, useInitQueryClient, useQueryClient, useSafeQueryFn, } from "../../core/services/query.service.js";
 export * from "./fetch.js";
 export * from "./query.js";
 export * from "./watch.js";

package/dist/adapters/angular/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/angular/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/angular/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACd,MAAM,sCAAsC,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/adapters/angular/index.js

@@ -1,3 +1,4 @@
+export { useCreateQueryClient, useInitQueryClient, useQueryClient, useSafeQueryFn, } from "../../core/services/query.service.js";
 export * from "./fetch.js";
 export * from "./query.js";
 export * from "./watch.js";

package/dist/adapters/angular/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/angular/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/angular/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,GACd,MAAM,sCAAsC,CAAC;AAC9C,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}

package/dist/adapters/angular/query.d.ts

@@ -1,89 +1,71 @@
 import { type Signal } from "@angular/core";
-import { type QueryClient, type QueryKey, type QueryState } from "../../core/services/query.service.js";
-import type { ApiError, FetchResult } from "../../types/index.js";
-/** Configuration for `useQuery` (Angular signal factory). */
-export interface UseQueryConfig<T = unknown> {
-    /** Cache key (stable array). */
-    queryKey: QueryKey;
-    /** Fetcher function returning a Safe Result. */
-    queryFn: () => Promise<FetchResult<T>>;
-    /** Time in ms before cached data is stale (default: 0). */
-    staleTime?: number;
-    /** Time in ms to keep unused data (default: 5 min). */
-    cacheTime?: number;
-    /** Retry count on failure (default: 3). */
-    retry?: number;
-    /** Base delay for exponential backoff (default: 1000). */
-    retryDelay?: number;
-    /** Whether the query is enabled (default: true). */
-    enabled?: boolean;
+import { type FetchStatus, type MutationObserverOptions, type MutationStatus, type QueryClient, type QueryObserverOptions, type QueryObserverResult, type QueryStatus, type RefetchOptions } from "@tanstack/query-core";
+/** Signal-based query result returned by {@link useQuery}. */
+export interface AngularQueryResult<TData = unknown, TError = Error> {
+    readonly data: Signal<TData | undefined>;
+    readonly error: Signal<TError | null>;
+    readonly isPending: Signal<boolean>;
+    readonly isFetching: Signal<boolean>;
+    readonly isLoading: Signal<boolean>;
+    readonly isSuccess: Signal<boolean>;
+    readonly isError: Signal<boolean>;
+    readonly isStale: Signal<boolean>;
+    readonly status: Signal<QueryStatus>;
+    readonly fetchStatus: Signal<FetchStatus>;
+    readonly refetch: (options?: RefetchOptions) => Promise<QueryObserverResult<TData, TError>>;
 }
-/** Reactive return value of `useQuery` (Angular signals). */
-export interface UseQueryReturn<T = unknown> {
-    data: Signal<T | null>;
-    error: Signal<ApiError | null>;
-    isLoading: Signal<boolean>;
-    isSuccess: Signal<boolean>;
-    isError: Signal<boolean>;
-    isStale: Signal<boolean>;
-    status: Signal<QueryState<T>["status"]>;
-    /** Manually refetch the query. */
-    refetch: () => Promise<void>;
-}
-/** Configuration for `useMutation`. */
-export interface UseMutationConfig<TData = unknown, TVariables = unknown> {
-    mutationFn: (variables: TVariables) => Promise<FetchResult<TData>>;
-    onSuccess?: (data: TData, variables: TVariables) => void;
-    onError?: (error: ApiError, variables: TVariables) => void;
-    onSettled?: (data: TData | null, error: ApiError | null, variables: TVariables) => void;
-}
-/** Reactive return value of `useMutation`. */
-export interface UseMutationReturn<TData = unknown, TVariables = unknown> {
-    data: Signal<TData | null>;
-    error: Signal<ApiError | null>;
-    isLoading: Signal<boolean>;
-    isSuccess: Signal<boolean>;
-    isError: Signal<boolean>;
-    status: Signal<"idle" | "loading" | "success" | "error">;
-    /** Execute the mutation. */
-    mutate: (variables: TVariables) => Promise<void>;
-    /** Reset the mutation state. */
-    reset: () => void;
+/** Signal-based mutation result returned by {@link useMutation}. */
+export interface AngularMutationResult<TData = unknown, TError = Error, TVariables = void> {
+    readonly data: Signal<TData | undefined>;
+    readonly error: Signal<TError | null>;
+    readonly variables: Signal<TVariables | undefined>;
+    readonly isPending: Signal<boolean>;
+    readonly isSuccess: Signal<boolean>;
+    readonly isError: Signal<boolean>;
+    readonly isIdle: Signal<boolean>;
+    readonly status: Signal<MutationStatus>;
+    readonly mutate: (variables: TVariables) => Promise<TData>;
+    readonly reset: () => void;
 }
 /**
- * Angular signal factory that wraps the {@link QueryClient}.
- * Integrates with the API manager — your `queryFn` typically calls `useGetApi`
- * or `useFetch` and returns the Safe Result.
+ * Angular signal factory for a cached query, backed by TanStack Query Core.
+ *
+ * Returns one signal per field — `query.data()`, `query.isPending()`,
+ * `query.isError()`, `query.status()`, etc.
  *
- * Must be called within an injection context (component field initializer,
- * constructor, or a service) so the returned query can auto-cleanup via
- * `DestroyRef`. Requires Angular 16+ signals.
+ * Must be called within an injection context (so it auto-cleans via `DestroyRef`).
  *
- * @param config - Query configuration.
- * @param client - Optional QueryClient instance (uses global singleton by default).
- * @returns Signals `{ data, error, isLoading, isSuccess, isError, isStale, status }` plus `refetch`.
+ * @param options - TanStack query options (`queryKey`, `queryFn`, `staleTime`, …).
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns An {@link AngularQueryResult} of signals.
  *
  * @example
  * ```ts
- * import { Component, inject } from "@angular/core";
- * import { useQuery } from "katanakit-js/adapters/angular";
+ * import { Component } from "@angular/core";
+ * import { useQuery, useSafeQueryFn } from "katanakit-js/adapters/angular";
  * import { useGetApi } from "katanakit-js";
  *
- * @Component({ selector: "app-pokemon", template: `@if (isLoading()) { Loading… } @else { {{ data()?.name }} }` })
+ * @Component({
+ *   selector: "app-pokemon",
+ *   template: `@if (query.isPending()) { Loading… } @else { {{ query.data()?.name }} }`,
+ * })
  * export class PokemonComponent {
- *   readonly data = useQuery({ queryKey: ["pokemon", 25], queryFn: () => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } }) }).data;
+ *   readonly query = useQuery({
+ *     queryKey: ["pokemon", 25],
+ *     queryFn: useSafeQueryFn(() => useGetApi("pokeapi", "pokemonById", { params: { id: 25 } })),
+ *   });
  * }
  * ```
  */
-export declare function useQuery<T>(config: UseQueryConfig<T>, client?: QueryClient): UseQueryReturn<T>;
+export declare function useQuery<TQueryFnData = unknown, TError = Error, TData = TQueryFnData>(options: QueryObserverOptions<TQueryFnData, TError, TData>, client?: QueryClient): AngularQueryResult<TData, TError>;
 /**
- * Angular signal factory for mutations (POST/PUT/PATCH/DELETE).
- * Does not cache — returns a `mutate` function that executes the mutation.
+ * Angular signal factory for a mutation, backed by TanStack Query Core.
  *
- * Must be called within an injection context. Requires Angular 16+ signals.
+ * Must be called within an injection context (so it auto-cleans via `DestroyRef`).
  *
- * @param config - Mutation configuration.
- * @returns Signals plus `{ mutate, reset }`.
+ * @param options - TanStack mutation options (`mutationFn`, `onSuccess`, …).
+ * @param client - Optional {@link QueryClient} (defaults to the shared singleton).
+ * @returns An {@link AngularMutationResult} of signals.
  *
  * @example
  * ```ts
@@ -91,17 +73,18 @@ export declare function useQuery<T>(config: UseQueryConfig<T>, client?: QueryCli
  * import { useMutation, useQueryClient } from "katanakit-js/adapters/angular";
  * import { usePost } from "katanakit-js";
  *
- * @Component({ selector: "app-create", template: `<button [disabled]="isLoading()" (click)="mutate('Ada')">Create</button>` })
+ * @Component({
+ *   selector: "app-create",
+ *   template: `<button [disabled]="mutation.isPending()" (click)="mutation.mutate('Ada')">Create</button>`,
+ * })
  * export class CreateUserComponent {
  *   private readonly qc = useQueryClient();
- *   readonly result = useMutation({
+ *   readonly mutation = useMutation({
  *     mutationFn: (name: string) => usePost("api", "createUser", { name }),
  *     onSuccess: () => this.qc.invalidateQueries({ queryKey: ["users"] }),
  *   });
- *   readonly isLoading = this.result.isLoading;
- *   readonly mutate = this.result.mutate;
  * }
  * ```
  */
-export declare function useMutation<TData = unknown, TVariables = unknown>(config: UseMutationConfig<TData, TVariables>): UseMutationReturn<TData, TVariables>;
+export declare function useMutation<TData = unknown, TError = Error, TVariables = void>(options: MutationObserverOptions<TData, TError, TVariables>, client?: QueryClient): AngularMutationResult<TData, TError, TVariables>;
 //# sourceMappingURL=query.d.ts.map

package/dist/adapters/angular/query.d.ts.map

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