@craft-ts/core 0.7.0-beta.13

package/src/lib/query-params.js

@@ -0,0 +1,324 @@
+import { assertInInjectionContext, computed, DestroyRef, inject, Injector, isSignal, runInInjectionContext, signal, } from './host/craft-compat';
+import { takeUntilDestroyed } from './host/craft-compat';
+import { isGenerator, runCraftGenerator } from './craft-generator-runtime';
+import { injectFnWrapper } from './fn-wrapper';
+import { craftException, isCraftException, } from './craft-exception';
+import { ɵcreateHostTaggedInjector, ɵHOST_TAG_LIST } from './craft-service';
+import { createNamedPrimitiveGen, } from './craft-primitive-gen';
+import { APP_SNAPSHOT_REGISTRY, INSERTION_SNAPSHOT_REGISTRY, InsertionSnapshotRegistry, triggerAndCollectInsertions, } from './take-app-snapshot';
+import { ɵprovidePrimitiveMethodRuntimeContext } from './primitive-method-runtime-context';
+import { ɵcreatePrimitiveResourceRuntimeContext, ɵobservePrimitiveResourceRuntimeContext, } from './primitive-resource-runtime-context';
+import { createYieldableInsertionMethod, isNonYieldableInsertionMethod, yieldableInvocation, } from './yieldable';
+import { CRAFT_HISTORY, CRAFT_LOCATION } from './craft-router-tokens';
+import { parseSearchParams, serializeSearchParams, } from './host/craft-router-runtime';
+import { craftWatch } from './host/craft-signal';
+import { createYieldableReactiveFacade, createYieldableReactiveValue, deepYieldable, hasDeepYieldableInsertion, isYieldableReactiveValue, nameInsertedReactiveValue, } from './reactive-read';
+function enrichQueryParamsParseException(exception, key) {
+    return {
+        ...exception,
+        scope: 'parse',
+        identifier: key,
+        [exception._tag]: exception.payload,
+    };
+}
+function createQueryParamDecodeError(key, value, error) {
+    return craftException({
+        _tag: 'QueryParamDecodeError',
+        scope: 'parse',
+        identifier: key,
+    }, { key, value, error });
+}
+function createQueryParamEncodeError(key, value, error) {
+    return craftException({
+        _tag: 'QueryParamEncodeError',
+        scope: 'serialize',
+    }, { key, value, error });
+}
+const QUERY_PARAM_INVALID_YIELD_ERROR_MESSAGE = 'queryParams generators can only yield craftService dependencies or exposed dependency helpers.';
+const QUERY_PARAM_APP_START_ERROR_MESSAGE = 'queryParams generators do not support onAppStart(...).';
+function executeQueryParamsFactory(injector, factory, thisArg, ...args) {
+    return runInInjectionContext(injector, () => {
+        const result = factory.apply(thisArg, args);
+        if (!isGenerator(result)) {
+            return result;
+        }
+        return runCraftGenerator({
+            iterator: result,
+            injector,
+            hostScope: 'function',
+            invalidYieldErrorMessage: QUERY_PARAM_INVALID_YIELD_ERROR_MESSAGE,
+            multipleAppStartErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,
+            onAppStartNotSupportedErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,
+        }).value;
+    });
+}
+export function queryParams(name, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+config, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+...insertions
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    return createNamedPrimitiveGen(name, createQueryParamsRef(name, config, ...insertions));
+}
+/**
+ *
+ * If it is not called in an injection context, it returns the config under _config.
+ */
+function createQueryParamsRef(name, config, ...insertions) {
+    try {
+        assertInInjectionContext(queryParams);
+    }
+    catch (e) {
+        return {
+            _config: config,
+        };
+    }
+    const insertionSnapshotRegistry = new InsertionSnapshotRegistry();
+    const injector = ɵcreateHostTaggedInjector(inject(Injector), `queryParams:${name}`, [
+        {
+            provide: INSERTION_SNAPSHOT_REGISTRY,
+            useValue: insertionSnapshotRegistry,
+        },
+    ]);
+    const history = inject(CRAFT_HISTORY);
+    const location = inject(CRAFT_LOCATION);
+    const { state: queryParamsConfig, ...options } = config;
+    const decodeQueryParamsState = (rawParams) => Object.entries(queryParamsConfig).reduce((acc, [key, config]) => {
+        const rawValue = rawParams[key];
+        if (rawValue === undefined || rawValue === null) {
+            acc[key] = config.fallbackValue;
+            return acc;
+        }
+        try {
+            const decoded = config.codec.decode(rawValue);
+            acc[key] = isCraftException(decoded) ? config.fallbackValue : decoded;
+            return acc;
+        }
+        catch {
+            acc[key] = config.fallbackValue;
+            return acc;
+        }
+    }, {});
+    // URL state is updated by the router watch; the public state is a separate
+    // writable Craft signal so a local set is visible synchronously and is not
+    // accidentally reset by a new object returned while parsing the URL.
+    const queryParamsFromUrl = signal(parseSearchParams(location().search));
+    const queryParamsState = signal(decodeQueryParamsState(queryParamsFromUrl()));
+    const locationWatch = craftWatch(() => {
+        const rawParams = parseSearchParams(location().search);
+        queryParamsFromUrl.set(rawParams);
+        queryParamsState.set(decodeQueryParamsState(rawParams));
+    });
+    inject(DestroyRef).onDestroy(() => locationWatch.destroy());
+    const parseExceptions = computed(() => Object.entries(queryParamsConfig).reduce((acc, [key, config]) => {
+        const rawValue = queryParamsFromUrl()?.[key];
+        if (rawValue === undefined || rawValue === null) {
+            return acc;
+        }
+        try {
+            const decoded = config.codec.decode(rawValue);
+            if (isCraftException(decoded)) {
+                acc[key] = enrichQueryParamsParseException(decoded, key);
+            }
+            return acc;
+        }
+        catch (error) {
+            acc[key] = enrichQueryParamsParseException(createQueryParamDecodeError(key, rawValue, error), key);
+            return acc;
+        }
+    }, {}));
+    const exceptions = computed(() => {
+        const parse = parseExceptions();
+        return {
+            list: Object.values(parse),
+            parse,
+        };
+    });
+    const hasException = computed(() => exceptions().list.length > 0);
+    // Get initial values from the url or use the fallback values
+    const getDefaultState = () => Object.entries(queryParamsConfig).reduce((acc, [key, config]) => {
+        acc[key] = config.fallbackValue;
+        return acc;
+    }, {});
+    // Save the original set method before we override it
+    const originalSet = queryParamsState.set.bind(queryParamsState);
+    // Navigation helper
+    const navigate = (newState, navOptions) => {
+        // Only include params that differ from their fallback values (SEO optimization)
+        const serializedParams = Object.entries(queryParamsConfig).reduce((acc, [key, config]) => {
+            const currentValue = newState[key];
+            // Skip if value equals fallback value
+            if (currentValue !== config.fallbackValue) {
+                try {
+                    const encoded = config.codec.encode(currentValue);
+                    if (isCraftException(encoded)) {
+                        throw createQueryParamEncodeError(key, currentValue, encoded);
+                    }
+                    acc[key] = encoded;
+                }
+                catch (error) {
+                    throw createQueryParamEncodeError(key, currentValue, error);
+                }
+            }
+            return acc;
+        }, {});
+        // Update the local state only after all codecs have encoded successfully.
+        originalSet(newState);
+        const mergedOptions = { ...options, ...navOptions };
+        queueMicrotask(() => {
+            const current = history.get();
+            let nextParams = serializedParams;
+            if (mergedOptions.queryParamsHandling === 'preserve') {
+                nextParams = parseSearchParams(current.search);
+            }
+            else if (mergedOptions.queryParamsHandling === 'merge') {
+                nextParams = {
+                    ...parseSearchParams(current.search),
+                    ...nextParams,
+                };
+            }
+            const search = serializeSearchParams(nextParams);
+            const url = `${current.pathname}${search}${mergedOptions.preserveFragment === false ? '' : current.hash}`;
+            if (mergedOptions.skipLocationChange) {
+                history.skip(url, null);
+                return;
+            }
+            if (mergedOptions.replaceUrl) {
+                history.replace(url);
+                return;
+            }
+            history.push(url);
+        });
+    };
+    // Create individual property signals
+    const props = Object.entries(queryParamsConfig).reduce((acc, [key, config]) => {
+        acc[key] = computed(() => queryParamsState()[key]);
+        return acc;
+    }, {});
+    // Create methods
+    const methods = {
+        set: (params, navOptions) => {
+            navigate(params, navOptions);
+            return params;
+        },
+        update: (updateFn, navOptions) => {
+            const newState = updateFn(queryParamsState());
+            navigate(newState, navOptions);
+            return newState;
+        },
+        patch: (paramsOrPatchFn, navOptions) => {
+            const params = typeof paramsOrPatchFn === 'function'
+                ? paramsOrPatchFn(queryParamsState())
+                : paramsOrPatchFn;
+            const newState = { ...queryParamsState(), ...params };
+            navigate(newState, navOptions);
+            return newState;
+        },
+        reset: (navOptions) => {
+            const defaultState = getDefaultState();
+            navigate(defaultState, navOptions);
+        },
+    };
+    const insertionMethods = {
+        set: (params, navOptions) => yieldableInvocation(methods.set(params, navOptions)),
+        update: (updateFn, navOptions) => yieldableInvocation(methods.update(updateFn, navOptions)),
+        patch: (paramsOrPatchFn, navOptions) => yieldableInvocation(methods.patch(paramsOrPatchFn, navOptions)),
+        reset: (navOptions) => yieldableInvocation(methods.reset(navOptions)),
+    };
+    runInInjectionContext(injector, () => ɵobservePrimitiveResourceRuntimeContext(ɵcreatePrimitiveResourceRuntimeContext('queryParams', {
+        state: queryParamsState.asReadonly(),
+        set: (value) => methods.set(value),
+        update: (updater) => methods.update((current) => updater(current)),
+    }), name));
+    // Process insertions
+    const readonlyQueryParamsState = queryParamsState.asReadonly();
+    const publicStateReader = createYieldableReactiveValue(readonlyQueryParamsState, 'state', { primitive: 'queryParams', path: `${name}.state` });
+    const publicHasException = createYieldableReactiveValue(hasException, 'hasException', { primitive: 'queryParams', path: `${name}.hasException` });
+    const publicExceptions = createYieldableReactiveValue(exceptions, 'exceptions', { primitive: 'queryParams', path: `${name}.exceptions` });
+    const insertionResults = insertions?.reduce((acc, insert) => {
+        const newInsertions = executeQueryParamsFactory(injector, insert, undefined, {
+            state: publicStateReader,
+            config: queryParamsConfig,
+            hasException: publicHasException,
+            exceptions: publicExceptions,
+            ...insertionMethods,
+            insertions: acc,
+        });
+        const wrappedInsertions = Object.entries(newInsertions).reduce((wrappedAcc, [key, value]) => {
+            if (typeof value !== 'function' ||
+                isSignal(value) ||
+                isNonYieldableInsertionMethod(value)) {
+                wrappedAcc[key] = nameInsertedReactiveValue(value, key, 'queryParams', `${name}.${key}`);
+                return wrappedAcc;
+            }
+            if (isYieldableReactiveValue(value)) {
+                wrappedAcc[key] = nameInsertedReactiveValue(value, key, 'queryParams', `${name}.${key}`);
+                return wrappedAcc;
+            }
+            const methodInjector = ɵcreateHostTaggedInjector(injector, `method:${key}`, [
+                ɵprovidePrimitiveMethodRuntimeContext('queryParams', {
+                    state: queryParamsState.asReadonly(),
+                    set: (next) => methods.set(next),
+                    update: (updater) => methods.update((current) => updater(current)),
+                    patch: (patchFn) => methods.patch((current) => patchFn(current)),
+                }, value),
+            ]);
+            const wrappedFn = runInInjectionContext(methodInjector, () => injectFnWrapper()(value));
+            wrappedAcc[key] = createYieldableInsertionMethod(wrappedFn, {
+                injector: methodInjector,
+                invalidYieldErrorMessage: QUERY_PARAM_INVALID_YIELD_ERROR_MESSAGE,
+                multipleAppStartErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,
+                onAppStartNotSupportedErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,
+            });
+            return wrappedAcc;
+        }, {});
+        return {
+            ...acc,
+            ...wrappedInsertions,
+        };
+    }, {}) || {};
+    const queryParamsCallable = readonlyQueryParamsState;
+    Object.defineProperty(queryParamsCallable, 'name', {
+        configurable: true,
+        writable: true,
+        value: undefined,
+    });
+    const queryParamsOutput = Object.assign(queryParamsCallable, props, insertionResults, { hasException, exceptions, _config: config });
+    const snapshotRegistry = injector.get(APP_SNAPSHOT_REGISTRY, null);
+    const hostTagList = injector.get(ɵHOST_TAG_LIST, null) ?? [];
+    const destroyRefParam = injector.get(DestroyRef, null);
+    if (snapshotRegistry && destroyRefParam) {
+        snapshotRegistry.triggerSnapshot$
+            .pipe(takeUntilDestroyed(destroyRefParam))
+            .subscribe(() => {
+            const insertionSnapshots = triggerAndCollectInsertions(insertionSnapshotRegistry);
+            let stateSnapshot;
+            try {
+                stateSnapshot = {
+                    value: queryParamsState(),
+                    ...(insertionSnapshots ? { insertions: insertionSnapshots } : {}),
+                };
+            }
+            catch (error) {
+                stateSnapshot = {
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+            snapshotRegistry.allSnapShot$.next({
+                source: 'queryParams',
+                from: hostTagList,
+                state: stateSnapshot,
+            });
+        });
+    }
+    const publicQueryParams = createYieldableReactiveFacade(queryParamsOutput, {
+        name,
+        primitive: 'queryParams',
+        path: name,
+    });
+    return (hasDeepYieldableInsertion(insertions)
+        ? deepYieldable(publicQueryParams)
+        : publicQueryParams);
+}
+//# sourceMappingURL=query-params.js.map

package/src/lib/query-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-params.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/query-params.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  assertInInjectionContext,\n  computed,\n  DestroyRef,\n  inject,\n  Injector,\n  isSignal,\n  runInInjectionContext,\n  Signal,\n  signal,\n  WritableSignal,\n} from './host/craft-compat';\nimport { takeUntilDestroyed } from './host/craft-compat';\nimport {\n  InsertionsQueryParamsFactory,\n  InsertionQueryParamsFactoryContext,\n  QueryParamsMethods,\n} from './query.core';\nimport { MergeObjects } from './util/types/util.type';\nimport { FilterSource, IsEmptyObject } from './util/util.type';\nimport { Prettify } from './util/util.type';\nimport { isGenerator, runCraftGenerator } from './craft-generator-runtime';\nimport { injectFnWrapper } from './fn-wrapper';\nimport {\n  AnyCraftException,\n  craftException,\n  isCraftException,\n} from './craft-exception';\nimport { ɵcreateHostTaggedInjector, ɵHOST_TAG_LIST } from './craft-service';\nimport {\n  createNamedPrimitiveGen,\n  type CraftPrimitiveGen,\n  type NamedCraftPrimitiveGen,\n} from './craft-primitive-gen';\nimport type {\n  SERVICE_HELPER_DEPENDENCIES,\n  ServiceDependencyMapFromYieldedAndValues,\n} from './craft-service';\nimport {\n  APP_SNAPSHOT_REGISTRY,\n  INSERTION_SNAPSHOT_REGISTRY,\n  InsertionSnapshotRegistry,\n  triggerAndCollectInsertions,\n} from './take-app-snapshot';\nimport { ɵprovidePrimitiveMethodRuntimeContext } from './primitive-method-runtime-context';\nimport {\n  ɵcreatePrimitiveResourceRuntimeContext,\n  ɵobservePrimitiveResourceRuntimeContext,\n} from './primitive-resource-runtime-context';\nimport {\n  createYieldableInsertionMethod,\n  isNonYieldableInsertionMethod,\n  yieldableInvocation,\n} from './yieldable';\nimport { CRAFT_HISTORY, CRAFT_LOCATION } from './craft-router-tokens';\nimport {\n  parseSearchParams,\n  serializeSearchParams,\n} from './host/craft-router-runtime';\nimport { craftWatch } from './host/craft-signal';\nimport {\n  createYieldableReactiveFacade,\n  createYieldableReactiveValue,\n  deepYieldable,\n  hasDeepYieldableInsertion,\n  isYieldableReactiveValue,\n  nameInsertedReactiveValue,\n  type YieldableReactiveProperties,\n  type YieldableReactiveValue,\n} from './reactive-read';\nimport type { YieldableInsertionMethods } from './yieldable';\n\nexport interface QueryParamsNavigationOptions {\n  queryParamsHandling?: 'merge' | 'preserve' | '';\n  onSameUrlNavigation?: 'reload' | 'ignore';\n  replaceUrl?: boolean;\n  skipLocationChange?: boolean;\n  preserveFragment?: boolean;\n}\n\ntype ResolveGeneratorResult<Result> =\n  Result extends Generator<any, infer Output, unknown> ? Output : Result;\n\ntype QueryParamsTrackedDependencies<\n  QueryParamsType,\n  InsertionsYielded = never,\n  Insertions = never,\n> = ServiceDependencyMapFromYieldedAndValues<InsertionsYielded, Insertions>;\n\ntype AnyQueryParamsConfig = {\n  codec: QueryParamsCodec<any, any>;\n  fallbackValue: any;\n};\n\nexport type QueryParamsToState<QueryParamsConfigs> = {\n  [K in keyof QueryParamsConfigs]: QueryParamsConfigs[K] extends {\n    codec: { decode: (input: any) => infer Decoded };\n  }\n    ? Exclude<Decoded, AnyCraftException>\n    : never;\n};\n\nexport type QueryParamDecodeErrorPayload = {\n  key: string;\n  value: unknown;\n  error: unknown;\n};\n\nexport type QueryParamDecodeError<Key extends string = string> =\n  import('./craft-exception').CraftExceptionResult<\n    {\n      _tag: 'QueryParamDecodeError';\n      scope: 'parse';\n      identifier: Key;\n    },\n    QueryParamDecodeErrorPayload & { key: Key }\n  >;\n\nexport type QueryParamEncodeErrorPayload = {\n  key: string;\n  value: unknown;\n  error: unknown;\n};\n\nexport type QueryParamEncodeError =\n  import('./craft-exception').CraftExceptionResult<\n    {\n      _tag: 'QueryParamEncodeError';\n      scope: 'serialize';\n    },\n    QueryParamEncodeErrorPayload\n  >;\n\ntype QueryParamsParseExceptionsByKey<QueryParamsType> =\n  QueryParamsType extends Record<string, AnyQueryParamsConfig>\n    ? {\n        [K in keyof QueryParamsType]: QueryParamDecodeError<K & string>;\n      }\n    : Record<string, never>;\n\ntype QueryParamsParseExceptionUnion<QueryParamsType> =\n  QueryParamsParseExceptionsByKey<QueryParamsType>[keyof QueryParamsParseExceptionsByKey<QueryParamsType>];\n\nexport type QueryParamsExceptions<QueryParamsType> = {\n  list: QueryParamsParseExceptionUnion<QueryParamsType>[];\n  parse: Partial<QueryParamsParseExceptionsByKey<QueryParamsType>>;\n};\n\nexport type QueryParamsOutput<\n  QueryParamsType,\n  Insertions,\n  QueryParamsState,\n  Dependencies = QueryParamsTrackedDependencies<QueryParamsType>,\n> = YieldableReactiveValue<QueryParamsState> &\n  YieldableReactiveProperties<\n    MergeObjects<\n      [\n        {\n          [K in keyof QueryParamsState]: Signal<QueryParamsState[K]>;\n        },\n        IsEmptyObject<Insertions> extends true\n          ? {}\n          : YieldableInsertionMethods<FilterSource<Insertions>>,\n        {\n          hasException: Signal<boolean>;\n          exceptions: Signal<QueryParamsExceptions<QueryParamsType>>;\n        },\n        {\n          _config: QueryParamsType;\n          readonly [SERVICE_HELPER_DEPENDENCIES]?: Dependencies;\n        },\n      ]\n    >\n  >;\n\nfunction enrichQueryParamsParseException(\n  exception: AnyCraftException,\n  key: string,\n): AnyCraftException {\n  return {\n    ...exception,\n    scope: 'parse',\n    identifier: key,\n    [exception._tag]: exception.payload,\n  };\n}\n\nfunction createQueryParamDecodeError(\n  key: string,\n  value: unknown,\n  error: unknown,\n): AnyCraftException {\n  return craftException(\n    {\n      _tag: 'QueryParamDecodeError',\n      scope: 'parse',\n      identifier: key,\n    },\n    { key, value, error },\n  );\n}\n\nfunction createQueryParamEncodeError(\n  key: string,\n  value: unknown,\n  error: unknown,\n): AnyCraftException {\n  return craftException(\n    {\n      _tag: 'QueryParamEncodeError',\n      scope: 'serialize',\n    },\n    { key, value, error },\n  );\n}\n\nconst QUERY_PARAM_INVALID_YIELD_ERROR_MESSAGE =\n  'queryParams generators can only yield craftService dependencies or exposed dependency helpers.';\nconst QUERY_PARAM_APP_START_ERROR_MESSAGE =\n  'queryParams generators do not support onAppStart(...).';\n\nfunction executeQueryParamsFactory<This, Args extends unknown[], Result>(\n  injector: Injector,\n  factory: (this: This, ...args: Args) => Result,\n  thisArg: This,\n  ...args: Args\n): ResolveGeneratorResult<Result> {\n  return runInInjectionContext(injector, () => {\n    const result = factory.apply(thisArg, args);\n\n    if (!isGenerator(result)) {\n      return result as ResolveGeneratorResult<Result>;\n    }\n\n    return runCraftGenerator({\n      iterator: result,\n      injector,\n      hostScope: 'function',\n      invalidYieldErrorMessage: QUERY_PARAM_INVALID_YIELD_ERROR_MESSAGE,\n      multipleAppStartErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,\n      onAppStartNotSupportedErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,\n    }).value as ResolveGeneratorResult<Result>;\n  });\n}\n\nexport interface QueryParamsCodecConfig<\n  T = unknown,\n  Encoded = unknown,\n  Codec extends QueryParamsCodec<Encoded, T> = QueryParamsCodec<Encoded, T>,\n> {\n  codec: Codec;\n  fallbackValue: NoInfer<T>;\n}\n\ntype QueryParamsCodec<Encoded, Decoded> = {\n  decode(input: Encoded): Decoded | AnyCraftException;\n  encode(value: Decoded): Encoded | AnyCraftException;\n};\n\nexport type QueryParamsConfig<\n  T = unknown,\n  Encoded = unknown,\n> = QueryParamsCodecConfig<T, Encoded>;\n\n/**\n * Creates a reactive query parameter manager that synchronizes state with URL query parameters.\n *\n * This function manages query parameter state by:\n * - Reading initial values from the URL or using default values\n * - Decoding URL values into typed values using the provided `codec`\n * - Encoding typed values back to URL values using the provided `codec`\n * - Providing reactive signals for each query parameter\n *\n * @remarks\n * **Important:** This function must be called within an injection context.\n * If called outside an injection context, it will only return an object containing the configuration under `_config`.\n *\n * @param name - The query params manager name. Used to key the returned record\n *   (`const pagination = yield* queryParams('pagination', config)`) and as the\n *   injector host tag (`queryParams:pagination`), so the primitive is precisely\n *   locatable in snapshots and logs.\n * @param config - Configuration object containing:\n *   - `state`: Record of query parameter configurations, each with `fallbackValue` and `codec`\n *   - `queryParamsHandling` (optional): How to handle existing query params ('merge' | 'preserve' | '')\n *   - `onSameUrlNavigation` (optional): Behavior on same URL navigation ('reload' | 'ignore')\n *   - `replaceUrl` (optional): Whether to replace the URL in browser history\n *   - `skipLocationChange` (optional): Whether to skip updating the browser's location\n * @param insertion1 - Optional single insertion factory to add custom methods, computed values or side effects to the query param manager.\n *   The insertion receives a context with `state`, `config`, `set`, `update`, `patch` and `reset`.\n *   To attach several insertions, compose them with `insertQueryParamsPipe`:\n *   `queryParams('name', config, insertQueryParamsPipe(insertion1, insertion2))` —\n *   each member then also sees the previous members' outputs on `context.insertions`.\n *   Methods bound to a source using `afterRecomputation` (effectRef-like) are not exposed in the output.\n * @returns A single-use primitive generator resolving to a signal returning\n *   the current query parameter state,\n *   extended with:\n *   - Individual signals for each query parameter (e.g., `pagination.page()`)\n *   - Custom methods from insertions (excluding methods bound to sources)\n *   - `_config`: The original configuration\n *\n *   Consume it with `yield*` inside a generator host (craftService factory,\n *   craftGen, …).\n *\n * @example\n * Basic usage\n * ```ts\n * const myQueryParams = yield* queryParams(\n *   'myQueryParams',\n *   {\n *     state: {\n *       page: {\n *         fallbackValue: 1,\n *         codec: {\n *           decode: (value) => parseInt(value, 10),\n *           encode: (value) => String(value),\n *         },\n *       },\n *       pageSize: {\n *         fallbackValue: 10,\n *         codec: {\n *           decode: (value) => parseInt(value, 10),\n *           encode: (value) => String(value),\n *         },\n *       },\n *     },\n *   },\n *   ({ set, update, patch, reset }) => ({ set, update, patch, reset })\n * );\n *\n * // Access state\n * console.log(yield* myQueryParams()); // { page: 1, pageSize: 10 }\n * console.log(yield* myQueryParams.page()); // 1\n *\n * // Update state (also updates URL)\n * yield* myQueryParams.set({ page: 2, pageSize: 20 });\n * yield* myQueryParams.update(current => ({ ...current, page: current.page + 1 }));\n * yield* myQueryParams.patch({ pageSize: 50 });\n * yield* myQueryParams.reset();\n * ```\n *\n * @example\n * With custom methods via insertions\n * ```ts\n * const myQueryParams = yield* queryParams(\n *   'myQueryParams',\n *   {\n *     state: {\n *       page: {\n *         fallbackValue: 1,\n *         codec: { decode: parseInt, encode: String },\n *       },\n *     },\n *   },\n *   ({ state, patch }) => ({\n *     goTo: function* (newPage: number) {\n *       const current = yield* state();\n *       return yield* patch({ ...current, page: newPage });\n *     },\n *   })\n * );\n *\n * yield* myQueryParams.goTo(5); // Custom method from insertion\n * ```\n *\n * @example\n * Parse exceptions with `craftException`\n * ```ts\n * import { craftException, queryParams } from '@craft-ts/core';\n *\n * const mode = yield* queryParams('mode', {\n *   state: {\n *     mode: {\n *       fallbackValue: 'success' as const,\n *       codec: {\n *         decode: (value: string) => {\n *           if (value !== 'success') {\n *             throw new Error(`Invalid mode: ${value}`);\n *           }\n *           return 'success' as const;\n *         },\n *         encode: (value) => String(value),\n *       },\n *     },\n *   },\n * });\n *\n * console.log(yield* mode.mode()); // fallbackValue when parse exception occurs\n * console.log(yield* mode.hasException()); // true/false\n * console.log((yield* mode.exceptions()).parse.mode?.INVALID_MODE_FROM_URL);\n * ```\n */\nexport function queryParams<\n  Name extends string,\n  QueryParamsType extends Record<string, AnyQueryParamsConfig>,\n  QueryParamsState = Prettify<QueryParamsToState<QueryParamsType>>,\n>(\n  name: Name,\n  config: { state: QueryParamsType } & QueryParamsNavigationOptions,\n): NamedCraftPrimitiveGen<\n  Name,\n  QueryParamsOutput<QueryParamsType, {}, QueryParamsState>\n>;\nexport function queryParams<\n  Name extends string,\n  QueryParamsType extends Record<string, AnyQueryParamsConfig>,\n  Insertion1,\n  Insertion1Yielded = never,\n  QueryParamsState = Prettify<QueryParamsToState<QueryParamsType>>,\n>(\n  name: Name,\n  config: { state: QueryParamsType } & QueryParamsNavigationOptions,\n  insertion1: InsertionsQueryParamsFactory<\n    NoInfer<QueryParamsType>,\n    Insertion1,\n    {},\n    Insertion1Yielded\n  >,\n): NamedCraftPrimitiveGen<\n  Name,\n  QueryParamsOutput<\n    QueryParamsType,\n    Insertion1,\n    QueryParamsState,\n    QueryParamsTrackedDependencies<\n      QueryParamsType,\n      Insertion1Yielded,\n      Insertion1\n    >\n  >\n>;\n\nexport function queryParams(\n  name: string,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  config: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ...insertions: any[]\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n): any {\n  return createNamedPrimitiveGen(\n    name,\n    createQueryParamsRef(name, config, ...insertions),\n  );\n}\n\n/**\n *\n * If it is not called in an injection context, it returns the config under _config.\n */\nfunction createQueryParamsRef<\n  QueryParamsType extends Record<string, AnyQueryParamsConfig>,\n  QueryParamsState = Prettify<QueryParamsToState<QueryParamsType>>,\n>(\n  name: string,\n  config: { state: QueryParamsType } & QueryParamsNavigationOptions,\n  ...insertions: any[]\n): QueryParamsOutput<QueryParamsType, {}, QueryParamsState> {\n  try {\n    assertInInjectionContext(queryParams);\n  } catch (e) {\n    return {\n      _config: config,\n    } as any;\n  }\n\n  const insertionSnapshotRegistry = new InsertionSnapshotRegistry();\n  const injector = ɵcreateHostTaggedInjector(\n    inject(Injector),\n    `queryParams:${name}`,\n    [\n      {\n        provide: INSERTION_SNAPSHOT_REGISTRY,\n        useValue: insertionSnapshotRegistry,\n      },\n    ],\n  );\n  const history = inject(CRAFT_HISTORY);\n  const location = inject(CRAFT_LOCATION);\n\n  const { state: queryParamsConfig, ...options } = config;\n\n  const decodeQueryParamsState = (rawParams: Record<string, string>) =>\n    Object.entries(queryParamsConfig).reduce(\n      (acc, [key, config]) => {\n        const rawValue = rawParams[key];\n        if (rawValue === undefined || rawValue === null) {\n          acc[key] = config.fallbackValue;\n          return acc;\n        }\n        try {\n          const decoded = config.codec.decode(rawValue);\n          acc[key] = isCraftException(decoded) ? config.fallbackValue : decoded;\n          return acc;\n        } catch {\n          acc[key] = config.fallbackValue;\n          return acc;\n        }\n      },\n      {} as Record<string, unknown>,\n    ) as QueryParamsToState<QueryParamsType>;\n\n  // URL state is updated by the router watch; the public state is a separate\n  // writable Craft signal so a local set is visible synchronously and is not\n  // accidentally reset by a new object returned while parsing the URL.\n  const queryParamsFromUrl = signal(parseSearchParams(location().search));\n  const queryParamsState = signal(\n    decodeQueryParamsState(queryParamsFromUrl()),\n  ) as WritableSignal<QueryParamsToState<QueryParamsType>>;\n  const locationWatch = craftWatch(() => {\n    const rawParams = parseSearchParams(location().search);\n    queryParamsFromUrl.set(rawParams);\n    queryParamsState.set(decodeQueryParamsState(rawParams));\n  });\n  inject(DestroyRef).onDestroy(() => locationWatch.destroy());\n\n  const parseExceptions = computed(() =>\n    Object.entries(queryParamsConfig).reduce(\n      (acc, [key, config]) => {\n        const rawValue = queryParamsFromUrl()?.[key];\n        if (rawValue === undefined || rawValue === null) {\n          return acc;\n        }\n\n        try {\n          const decoded = config.codec.decode(rawValue);\n          if (isCraftException(decoded)) {\n            acc[key] = enrichQueryParamsParseException(decoded, key);\n          }\n          return acc;\n        } catch (error) {\n          acc[key] = enrichQueryParamsParseException(\n            createQueryParamDecodeError(key, rawValue, error),\n            key,\n          );\n          return acc;\n        }\n      },\n      {} as Record<string, AnyCraftException>,\n    ),\n  );\n\n  const exceptions = computed(() => {\n    const parse = parseExceptions();\n    return {\n      list: Object.values(parse),\n      parse,\n    };\n  }) as Signal<QueryParamsExceptions<QueryParamsType>>;\n\n  const hasException = computed(() => exceptions().list.length > 0);\n\n  // Get initial values from the url or use the fallback values\n  const getDefaultState = () =>\n    Object.entries(queryParamsConfig).reduce(\n      (acc, [key, config]) => {\n        acc[key] = config.fallbackValue;\n        return acc;\n      },\n      {} as Record<string, unknown>,\n    ) as QueryParamsToState<QueryParamsType>;\n\n  // Save the original set method before we override it\n  const originalSet = queryParamsState.set.bind(queryParamsState);\n\n  // Navigation helper\n  const navigate = (\n    newState: QueryParamsToState<QueryParamsType>,\n    navOptions?: QueryParamsNavigationOptions,\n  ) => {\n    // Only include params that differ from their fallback values (SEO optimization)\n    const serializedParams = Object.entries(queryParamsConfig).reduce(\n      (acc, [key, config]) => {\n        const currentValue = newState[key];\n        // Skip if value equals fallback value\n        if (currentValue !== config.fallbackValue) {\n          try {\n            const encoded = config.codec.encode(currentValue);\n            if (isCraftException(encoded)) {\n              throw createQueryParamEncodeError(key, currentValue, encoded);\n            }\n            acc[key] = encoded as string | string[];\n          } catch (error) {\n            throw createQueryParamEncodeError(key, currentValue, error);\n          }\n        }\n        return acc;\n      },\n      {} as Record<string, string | string[]>,\n    );\n\n    // Update the local state only after all codecs have encoded successfully.\n    originalSet(newState);\n\n    const mergedOptions = { ...options, ...navOptions };\n\n    queueMicrotask(() => {\n      const current = history.get();\n      let nextParams = serializedParams as Record<string, string>;\n      if (mergedOptions.queryParamsHandling === 'preserve') {\n        nextParams = parseSearchParams(current.search);\n      } else if (mergedOptions.queryParamsHandling === 'merge') {\n        nextParams = {\n          ...parseSearchParams(current.search),\n          ...nextParams,\n        };\n      }\n      const search = serializeSearchParams(nextParams);\n      const url = `${current.pathname}${search}${\n        mergedOptions.preserveFragment === false ? '' : current.hash\n      }`;\n      if (mergedOptions.skipLocationChange) {\n        history.skip(url, null);\n        return;\n      }\n      if (mergedOptions.replaceUrl) {\n        history.replace(url);\n        return;\n      }\n      history.push(url);\n    });\n  };\n\n  // Create individual property signals\n  const props = Object.entries(queryParamsConfig).reduce(\n    (acc, [key, config]) => {\n      acc[key] = computed(() => queryParamsState()[key]);\n      return acc;\n    },\n    {} as Record<string, Signal<unknown>>,\n  );\n\n  // Create methods\n  const methods = {\n    set: (\n      params: QueryParamsToState<QueryParamsType>,\n      navOptions?: QueryParamsNavigationOptions,\n    ) => {\n      navigate(params, navOptions);\n      return params;\n    },\n    update: (\n      updateFn: (\n        currentParams: QueryParamsToState<QueryParamsType>,\n      ) => QueryParamsToState<QueryParamsType>,\n      navOptions?: QueryParamsNavigationOptions,\n    ) => {\n      const newState = updateFn(queryParamsState());\n      navigate(newState, navOptions);\n      return newState;\n    },\n    patch: (\n      paramsOrPatchFn:\n        | Partial<QueryParamsToState<QueryParamsType>>\n        | ((\n            currentParams: QueryParamsToState<QueryParamsType>,\n          ) => Partial<QueryParamsToState<QueryParamsType>>),\n      navOptions?: QueryParamsNavigationOptions,\n    ) => {\n      const params =\n        typeof paramsOrPatchFn === 'function'\n          ? paramsOrPatchFn(queryParamsState())\n          : paramsOrPatchFn;\n      const newState = { ...queryParamsState(), ...params };\n      navigate(newState, navOptions);\n      return newState;\n    },\n    reset: (navOptions?: QueryParamsNavigationOptions) => {\n      const defaultState = getDefaultState();\n      navigate(defaultState, navOptions);\n    },\n  };\n\n  const insertionMethods = {\n    set: (\n      params: QueryParamsToState<QueryParamsType>,\n      navOptions?: QueryParamsNavigationOptions,\n    ) =>\n      yieldableInvocation(methods.set(params, navOptions)),\n    update: (\n      updateFn: (\n        currentParams: QueryParamsToState<QueryParamsType>,\n      ) => QueryParamsToState<QueryParamsType>,\n      navOptions?: QueryParamsNavigationOptions,\n    ) =>\n      yieldableInvocation(methods.update(updateFn, navOptions)),\n    patch: (\n      paramsOrPatchFn:\n        | Partial<QueryParamsToState<QueryParamsType>>\n        | ((\n            currentParams: QueryParamsToState<QueryParamsType>,\n          ) => Partial<QueryParamsToState<QueryParamsType>>),\n      navOptions?: QueryParamsNavigationOptions,\n    ) =>\n      yieldableInvocation(methods.patch(paramsOrPatchFn, navOptions)),\n    reset: (navOptions?: QueryParamsNavigationOptions) =>\n      yieldableInvocation(methods.reset(navOptions)),\n  } as unknown as QueryParamsMethods<QueryParamsToState<QueryParamsType>>;\n\n  runInInjectionContext(injector, () =>\n    ɵobservePrimitiveResourceRuntimeContext(\n      ɵcreatePrimitiveResourceRuntimeContext('queryParams', {\n        state: queryParamsState.asReadonly(),\n        set: (value) =>\n          methods.set(value as QueryParamsToState<QueryParamsType>),\n        update: (updater) =>\n          methods.update(\n            (current) =>\n              updater(current) as QueryParamsToState<QueryParamsType>,\n          ),\n      }),\n      name,\n    ),\n  );\n\n  // Process insertions\n  const readonlyQueryParamsState = queryParamsState.asReadonly();\n  const publicStateReader = createYieldableReactiveValue(\n    readonlyQueryParamsState,\n    'state',\n    { primitive: 'queryParams', path: `${name}.state` },\n  );\n  const publicHasException = createYieldableReactiveValue(\n    hasException,\n    'hasException',\n    { primitive: 'queryParams', path: `${name}.hasException` },\n  );\n  const publicExceptions = createYieldableReactiveValue(\n    exceptions,\n    'exceptions',\n    { primitive: 'queryParams', path: `${name}.exceptions` },\n  );\n  const insertionResults =\n    (insertions as InsertionsQueryParamsFactory<QueryParamsType, {}>[])?.reduce(\n      (acc, insert) => {\n        const newInsertions = executeQueryParamsFactory(\n          injector,\n          insert,\n          undefined,\n          {\n            state: publicStateReader,\n            config: queryParamsConfig,\n            hasException: publicHasException,\n            exceptions: publicExceptions,\n            ...insertionMethods,\n            insertions: acc as {},\n          } as InsertionQueryParamsFactoryContext<QueryParamsType, {}>,\n        );\n        const wrappedInsertions = Object.entries(newInsertions).reduce(\n          (wrappedAcc, [key, value]) => {\n            if (\n              typeof value !== 'function' ||\n              isSignal(value) ||\n              isNonYieldableInsertionMethod(value)\n            ) {\n              wrappedAcc[key] = nameInsertedReactiveValue(\n                value,\n                key,\n                'queryParams',\n                `${name}.${key}`,\n              );\n              return wrappedAcc;\n            }\n            if (isYieldableReactiveValue(value)) {\n              wrappedAcc[key] = nameInsertedReactiveValue(\n                value,\n                key,\n                'queryParams',\n                `${name}.${key}`,\n              );\n              return wrappedAcc;\n            }\n            const methodInjector = ɵcreateHostTaggedInjector(\n              injector,\n              `method:${key}`,\n              [\n                ɵprovidePrimitiveMethodRuntimeContext(\n                  'queryParams',\n                  {\n                    state: queryParamsState.asReadonly(),\n                    set: (next) =>\n                      methods.set(next as QueryParamsToState<QueryParamsType>),\n                    update: (updater) =>\n                      methods.update(\n                        (current) =>\n                          updater(\n                            current,\n                          ) as QueryParamsToState<QueryParamsType>,\n                      ),\n                    patch: (patchFn) =>\n                      methods.patch(\n                        (current) =>\n                          patchFn(current) as Partial<\n                            QueryParamsToState<QueryParamsType>\n                          >,\n                      ),\n                  },\n                  value as (...args: never[]) => unknown,\n                ),\n              ],\n            );\n            const wrappedFn = runInInjectionContext(methodInjector, () =>\n              injectFnWrapper()(value as (...args: unknown[]) => unknown),\n            );\n            wrappedAcc[key] = createYieldableInsertionMethod(wrappedFn, {\n              injector: methodInjector,\n              invalidYieldErrorMessage: QUERY_PARAM_INVALID_YIELD_ERROR_MESSAGE,\n              multipleAppStartErrorMessage: QUERY_PARAM_APP_START_ERROR_MESSAGE,\n              onAppStartNotSupportedErrorMessage:\n                QUERY_PARAM_APP_START_ERROR_MESSAGE,\n            });\n            return wrappedAcc;\n          },\n          {} as Record<string, unknown>,\n        );\n        return {\n          ...acc,\n          ...wrappedInsertions,\n        };\n      },\n      {} as Record<string, unknown>,\n    ) || {};\n\n  const queryParamsCallable = readonlyQueryParamsState;\n  Object.defineProperty(queryParamsCallable, 'name', {\n    configurable: true,\n    writable: true,\n    value: undefined,\n  });\n  const queryParamsOutput = Object.assign(\n    queryParamsCallable,\n    props,\n    insertionResults,\n    { hasException, exceptions, _config: config },\n  ) as unknown as QueryParamsOutput<QueryParamsType, {}, QueryParamsState>;\n\n  const snapshotRegistry = injector.get(APP_SNAPSHOT_REGISTRY, null);\n  const hostTagList: readonly string[] =\n    injector.get(ɵHOST_TAG_LIST, null) ?? [];\n\n  const destroyRefParam = injector.get(DestroyRef, null);\n\n  if (snapshotRegistry && destroyRefParam) {\n    snapshotRegistry.triggerSnapshot$\n      .pipe(takeUntilDestroyed(destroyRefParam))\n      .subscribe(() => {\n        const insertionSnapshots = triggerAndCollectInsertions(\n          insertionSnapshotRegistry,\n        );\n        let stateSnapshot: unknown;\n        try {\n          stateSnapshot = {\n            value: queryParamsState(),\n            ...(insertionSnapshots ? { insertions: insertionSnapshots } : {}),\n          };\n        } catch (error) {\n          stateSnapshot = {\n            error: error instanceof Error ? error.message : String(error),\n          };\n        }\n        snapshotRegistry.allSnapShot$.next({\n          source: 'queryParams',\n          from: hostTagList,\n          state: stateSnapshot,\n        });\n      });\n  }\n\n  const publicQueryParams = createYieldableReactiveFacade(queryParamsOutput, {\n    name,\n    primitive: 'queryParams',\n    path: name,\n  });\n  return (hasDeepYieldableInsertion(insertions)\n    ? deepYieldable(publicQueryParams)\n    : publicQueryParams) as QueryParamsOutput<QueryParamsType, {}, QueryParamsState>;\n}\n"]}

package/src/lib/query.core.d.ts

@@ -0,0 +1,214 @@
+import { Signal, WritableSignal } from './host/craft-compat';
+import { CustomReloadOnSpecificMutationStatus, FilterQueryById, PatchMutationQuery, QueryAndMutationRecordConstraints, ReloadQueriesConfig } from './util/types/shared.type';
+import { ResourceByIdRef } from './resource-by-id';
+import { MergeObjects } from './util//types/util.type';
+import { ResourceByIdLikeMutationRef, ResourceLikeMutationRef } from './mutation';
+import { CraftResourceRef } from './util/craft-resource-ref';
+import { QueryParamsExceptions, QueryParamsToState } from './query-params';
+import { Prettify } from './util/util.type';
+import { InsertMetaInCraftExceptionIfExists } from './craft-exception';
+import type { YieldableInsertionMethods, YieldableInvocation } from './yieldable';
+import type { DeepYieldableReactiveValue, YieldableReactiveProperties, YieldableReactiveSignal, YieldableReactiveValue } from './reactive-read';
+import type { CraftSettledYieldableValue } from './craft-settled';
+export interface QueryParamsNavigationOptions {
+    queryParamsHandling?: 'merge' | 'preserve' | '';
+    onSameUrlNavigation?: 'reload' | 'ignore';
+    replaceUrl?: boolean;
+    skipLocationChange?: boolean;
+}
+export type MutationResourceRefHelper<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = ResourceLikeMutationRef<QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params'], QueryAndMutationRecord['mutation']['isMethod'], QueryAndMutationRecord['mutation']['args'], QueryAndMutationRecord['mutation']['sourceParams'], QueryAndMutationRecord['mutation']['insertions'], QueryAndMutationRecord['mutation']['exceptions']>;
+export type MutationResourceByIdRefHelper<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = ResourceByIdLikeMutationRef<QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params'], QueryAndMutationRecord['mutation']['isMethod'], QueryAndMutationRecord['mutation']['args'], QueryAndMutationRecord['mutation']['sourceParams'], QueryAndMutationRecord['mutation']['insertions'], QueryAndMutationRecord['mutation']['groupIdentifier'], QueryAndMutationRecord['mutation']['exceptions']>;
+type UpdateData<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = MergeObjects<[
+    {
+        queryResource: CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+        mutationResource: CraftResourceRef<NoInfer<QueryAndMutationRecord['mutation']['state']>, NoInfer<QueryAndMutationRecord['mutation']['params']>>;
+        mutationParams: NonNullable<NoInfer<QueryAndMutationRecord['mutation']['params']>>;
+    },
+    QueryAndMutationRecord['query']['isGroupedResource'] extends true ? {
+        queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];
+        queryResources: ResourceByIdRef<string, QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    } : {},
+    QueryAndMutationRecord['mutation']['groupIdentifier'] extends string | number ? {
+        mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];
+        mutationResources: ResourceByIdRef<string, QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']>;
+    } : {}
+]>;
+export type QueryDeclarativeEffect<QueryAndMutationRecord extends QueryAndMutationRecordConstraints> = MergeObjects<[
+    {
+        /**
+         * Run when the mutation is in loading state.
+         */
+        optimisticUpdate?: (data: UpdateData<QueryAndMutationRecord>) => QueryAndMutationRecord['query']['state'];
+        /**
+         * Run when the mutation is in loaded state.
+         */
+        update?: (data: UpdateData<QueryAndMutationRecord>) => QueryAndMutationRecord['query']['state'];
+        reload?: ReloadQueriesConfig<QueryAndMutationRecord>;
+        /**
+         * Run when the mutation is in loading state.
+         * Will patch the query specific state with the mutation data.
+         * If the query is loading, it will not patch.
+         * If the mutation data is not compatible with the query state, it will not patch.
+         * Be careful! If the mutation is already in a loading state, trigger the mutation again will cancelled the previous mutation loader and will patch with the new value.
+         */
+        optimisticPatch?: PatchMutationQuery<QueryAndMutationRecord>;
+        /**
+         * Run when the mutation is in loaded state.
+         * Will patch the query specific state with the mutation data.
+         * If the query is loading, it will not patch.
+         * If the mutation data is not compatible with the query state, it will not patch.
+         * Be careful! If the mutation is already in a loading state, trigger the mutation again will cancelled the previous mutation loader and will patch with the new value.
+         */
+        patch?: PatchMutationQuery<QueryAndMutationRecord>;
+    },
+    QueryAndMutationRecord['mutation']['isGroupedResource'] extends true ? {
+        filter: FilterQueryById<QueryAndMutationRecord>;
+    } : QueryAndMutationRecord['query']['isGroupedResource'] extends true ? {
+        filter: FilterQueryById<QueryAndMutationRecord>;
+    } : {}
+]>;
+export declare function triggerQueryReloadFromMutationChange<QueryAndMutationRecord extends QueryAndMutationRecordConstraints>({ reload, mutationStatus, queryResource, mutationResource, mutationParamsSrc, queryIdentifier, queryResources, mutationIdentifier, mutationResources, }: {
+    reload: ReloadQueriesConfig<QueryAndMutationRecord>;
+    mutationStatus: string;
+    queryResource: CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    queryResources: ResourceByIdRef<string, QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']> | undefined;
+    mutationResource: CraftResourceRef<any, any>;
+    mutationParamsSrc: Signal<QueryAndMutationRecord['mutation']['params'] | undefined>;
+    queryIdentifier: QueryAndMutationRecord['query']['groupIdentifier'];
+    mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'];
+    mutationResources: ResourceByIdRef<string, any, unknown> | undefined;
+}): void;
+export declare function triggerQueryReloadOnMutationStatusChange<QueryAndMutationRecord extends QueryAndMutationRecordConstraints>({ mutationStatus, queryResourceTarget, mutationEffectOptions, mutationResource, mutationParamsSrc, reloadCConfig, mutationIdentifier, mutationResources, }: {
+    mutationStatus: string;
+    queryResourceTarget: ResourceByIdRef<string, QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']> | CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    mutationEffectOptions: QueryDeclarativeEffect<QueryAndMutationRecord>;
+    mutationResource: CraftResourceRef<any, any>;
+    mutationParamsSrc: Signal<QueryAndMutationRecord['mutation']['params']>;
+    reloadCConfig: {
+        onMutationException?: boolean | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;
+        onMutationResolved?: boolean | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;
+        onMutationLoading?: boolean | CustomReloadOnSpecificMutationStatus<QueryAndMutationRecord>;
+    };
+    mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'] | undefined;
+    mutationResources: ResourceByIdRef<string, QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']> | undefined;
+}): void;
+export declare function setAllPatchFromMutationOnQueryValue<QueryAndMutationRecord extends QueryAndMutationRecordConstraints>({ mutationStatus, queryResourceTarget, mutationEffectOptions, mutationResource, mutationParamsSrc, mutationIdentifier, mutationResources, }: {
+    mutationStatus: string;
+    queryResourceTarget: ResourceByIdRef<string, QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']> | CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    mutationEffectOptions: QueryDeclarativeEffect<QueryAndMutationRecord>;
+    mutationResource: CraftResourceRef<any, any>;
+    mutationParamsSrc: Signal<QueryAndMutationRecord['mutation']['params']>;
+    mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'] | undefined;
+    mutationResources: MutationResourceByIdRefHelper<QueryAndMutationRecord> | undefined;
+}): void;
+export declare function setAllUpdatesFromMutationOnQueryValue<QueryAndMutationRecord extends QueryAndMutationRecordConstraints>({ mutationStatus, queryResourceTarget, mutationEffectOptions, mutationResource, mutationParamsSrc, mutationIdentifier, mutationResources, }: {
+    mutationStatus: string;
+    queryResourceTarget: ResourceByIdRef<string, QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']> | CraftResourceRef<QueryAndMutationRecord['query']['state'], QueryAndMutationRecord['query']['params']>;
+    mutationEffectOptions: QueryDeclarativeEffect<QueryAndMutationRecord>;
+    mutationResource: CraftResourceRef<any, any> | undefined;
+    mutationParamsSrc: Signal<QueryAndMutationRecord['mutation']['params']>;
+    mutationIdentifier: QueryAndMutationRecord['mutation']['groupIdentifier'] | undefined;
+    mutationResources: ResourceByIdRef<string, QueryAndMutationRecord['mutation']['state'], QueryAndMutationRecord['mutation']['params']> | undefined;
+}): void;
+export type ResourceExceptionConstraints = {
+    params: unknown;
+    loader: unknown;
+};
+/**
+ * A mutation exposed to insertion factories.
+ *
+ * The authored contract is an invocation consumed with `yield*`. The
+ * synchronous mutation itself remains internal to the primitive runtime; the
+ * returned invocation is what insertion methods expose to callers.
+ */
+export type YieldableInsertionWrite<Args extends unknown[], Result> = {
+    (...args: Args): YieldableInvocation<never, Result>;
+};
+export type InsertionParams<ResourceState extends object | undefined, ResourceParams, Exceptions extends ResourceExceptionConstraints, PreviousInsertionsOutputs, PrimitiveName extends string = string> = {
+    test: ResourceState;
+    state: YieldableReactiveValue<ResourceState, 'state'>;
+    settledState: CraftSettledYieldableValue<NonNullable<ResourceState>, PrimitiveName, Exceptions['params'] | Exceptions['loader']>;
+    set: YieldableInsertionWrite<[newState: ResourceState], ResourceState>;
+    update: YieldableInsertionWrite<[
+        updateFn: (currentState: ResourceState) => ResourceState
+    ], ResourceState>;
+    patch: YieldableInsertionWrite<[
+        patchFn: (currentState: ResourceState) => Partial<ResourceState>
+    ], ResourceState>;
+    insertions: keyof PreviousInsertionsOutputs extends string ? YieldableInsertionMethods<PreviousInsertionsOutputs> : never;
+    resource: YieldableReactiveProperties<CraftResourceRef<ResourceState, ResourceParams>>;
+    resourceParamsSrc: YieldableReactiveSignal<WritableSignal<ResourceParams | undefined>, 'resourceParamsSrc'>;
+    hasException: YieldableReactiveValue<boolean, 'hasException'>;
+    exceptions: DeepYieldableReactiveValue<{
+        list: (InsertMetaInCraftExceptionIfExists<Exceptions['params'], 'params', unknown> | InsertMetaInCraftExceptionIfExists<Exceptions['loader'], 'loader', unknown>)[];
+        params?: InsertMetaInCraftExceptionIfExists<Exceptions['params'], 'params', unknown>;
+        loader?: InsertMetaInCraftExceptionIfExists<Exceptions['loader'], 'loader', unknown>;
+    }, 'exceptions'>;
+    resourceById: never;
+    identifier: never;
+};
+export type InsertionsFactory<ResourceState extends object | undefined, ResourceParams, InsertsOutputs, Exceptions extends ResourceExceptionConstraints, PreviousInsertionsOutputs = {}, Yielded = never, PrimitiveName extends string = string> = (context: InsertionParams<ResourceState, ResourceParams, Exceptions, PreviousInsertionsOutputs, PrimitiveName>) => InsertsOutputs | Generator<Yielded, InsertsOutputs, unknown>;
+export type InsertionByIdParams<GroupIdentifier extends string, ResourceState extends object | undefined, ResourceParams, Exceptions extends ResourceExceptionConstraints, PreviousInsertionsOutputs, PrimitiveName extends string = string> = {
+    state: YieldableReactiveValue<ResourceState, 'state'>;
+    settledState: CraftSettledYieldableValue<NonNullable<ResourceState>, PrimitiveName, Exceptions['params'] | Exceptions['loader']>;
+    set: YieldableInsertionWrite<[newState: ResourceState], ResourceState>;
+    update: YieldableInsertionWrite<[
+        updateFn: (currentState: ResourceState) => ResourceState
+    ], ResourceState>;
+    patch: YieldableInsertionWrite<[
+        patchFn: (currentState: ResourceState) => Partial<ResourceState>
+    ], ResourceState>;
+    insertions: keyof PreviousInsertionsOutputs extends string ? YieldableInsertionMethods<PreviousInsertionsOutputs> : never;
+    resourceById: YieldableReactiveSignal<ResourceByIdRef<GroupIdentifier, ResourceState, ResourceParams>, 'resourceById'>;
+    resource: never;
+    resourceParamsSrc: YieldableReactiveSignal<WritableSignal<ResourceParams | undefined>, 'resourceParamsSrc'>;
+    hasException: YieldableReactiveValue<boolean, 'hasException'>;
+    exceptions: DeepYieldableReactiveValue<{
+        list: (InsertMetaInCraftExceptionIfExists<Exceptions['params'], 'params', unknown> | InsertMetaInCraftExceptionIfExists<Exceptions['loader'], 'loader', GroupIdentifier>)[];
+        params?: InsertMetaInCraftExceptionIfExists<Exceptions['params'], 'params', unknown>;
+        loader: Partial<Record<GroupIdentifier, InsertMetaInCraftExceptionIfExists<Exceptions['loader'], 'loader', GroupIdentifier>>>;
+    }, 'exceptions'>;
+    identifier: (params: NonNullable<ResourceParams>) => GroupIdentifier;
+};
+export type InsertionStateFactoryContext<StateType, PreviousInsertionsOutputs> = {
+    state: YieldableReactiveValue<StateType, 'state'>;
+    set: YieldableInsertionWrite<[newState: StateType], StateType>;
+    update: YieldableInsertionWrite<[
+        updateFn: (currentState: StateType) => StateType
+    ], StateType>;
+    patch: YieldableInsertionWrite<[
+        patchFn: (currentState: StateType) => Partial<StateType>
+    ], StateType>;
+    insertions: keyof PreviousInsertionsOutputs extends string ? YieldableInsertionMethods<PreviousInsertionsOutputs> : never;
+};
+export type QueryParamsMethods<QueryParamsState> = {
+    patch: {
+        (patchFn: (currentParams: QueryParamsState) => Partial<QueryParamsState>, options?: QueryParamsNavigationOptions): YieldableInvocation<never, QueryParamsState>;
+        (params: Partial<QueryParamsState>, options?: QueryParamsNavigationOptions): YieldableInvocation<never, QueryParamsState>;
+    };
+    reset: {
+        (options?: QueryParamsNavigationOptions): YieldableInvocation<never, void>;
+    };
+    set: {
+        (params: QueryParamsState, options?: QueryParamsNavigationOptions): YieldableInvocation<never, QueryParamsState>;
+    };
+    update: {
+        (updateFn: (currentParams: QueryParamsState) => QueryParamsState, options?: QueryParamsNavigationOptions): YieldableInvocation<never, QueryParamsState>;
+    };
+};
+export type InsertionQueryParamsFactoryContext<QueryParamsType, PreviousInsertionsOutputs, QueryParamsState = Prettify<QueryParamsToState<QueryParamsType>>> = QueryParamsMethods<QueryParamsState> & {
+    state: YieldableReactiveValue<QueryParamsState, 'state'>;
+    config: QueryParamsType;
+    hasException: YieldableReactiveValue<boolean, 'hasException'>;
+    exceptions: YieldableReactiveValue<QueryParamsExceptions<QueryParamsType>, 'exceptions'>;
+    insertions: keyof PreviousInsertionsOutputs extends string ? YieldableInsertionMethods<PreviousInsertionsOutputs> : never;
+};
+export type InsertionsByIdFactory<ResourceState extends object | undefined, ResourceParams, GroupIdentifier extends string, Exceptions extends ResourceExceptionConstraints, InsertionsOutputs, PreviousInsertionsOutputs = {}, Yielded = never, PrimitiveName extends string = string> = (context: InsertionByIdParams<GroupIdentifier, ResourceState, ResourceParams, Exceptions, PreviousInsertionsOutputs, PrimitiveName>) => InsertionsOutputs | Generator<Yielded, InsertionsOutputs, unknown>;
+export type InsertionResourceFactoryContext<GroupIdentifier, ResourceState extends object | undefined, ResourceParams, Exceptions extends ResourceExceptionConstraints, PreviousInsertionsOutputs, PrimitiveName extends string = string> = [unknown] extends [GroupIdentifier] ? InsertionParams<ResourceState, ResourceParams, Exceptions, PreviousInsertionsOutputs, PrimitiveName> : InsertionByIdParams<GroupIdentifier & string, ResourceState, ResourceParams, Exceptions, PreviousInsertionsOutputs, PrimitiveName>;
+export type InsertionsResourcesFactory<GroupIdentifier, ResourceState extends object | undefined, ResourceParams, Exceptions extends ResourceExceptionConstraints, InsertionsOutputs, PreviousInsertionsOutputs = {}, Yielded = never, PrimitiveName extends string = string> = (context: InsertionResourceFactoryContext<GroupIdentifier, ResourceState, ResourceParams, Exceptions, PreviousInsertionsOutputs, PrimitiveName>) => InsertionsOutputs | Generator<Yielded, InsertionsOutputs, unknown>;
+export type InsertionsStateFactory<State, InsertionsOutputs, PreviousInsertionsOutputs = {}, Yielded = never> = (context: InsertionStateFactoryContext<State, PreviousInsertionsOutputs>) => InsertionsOutputs | Generator<Yielded, InsertionsOutputs, unknown>;
+export type InsertionsQueryParamsFactory<QueryParamsType, InsertionsOutputs, PreviousInsertionsOutputs = {}, Yielded = never> = (context: InsertionQueryParamsFactoryContext<QueryParamsType, PreviousInsertionsOutputs>) => InsertionsOutputs | Generator<Yielded, InsertionsOutputs, unknown>;
+export type DefaultInsertionByIdParams = InsertionByIdParams<string, {}, unknown, ResourceExceptionConstraints, {}>;
+export type DefaultInsertionParams = InsertionParams<{}, unknown, ResourceExceptionConstraints, unknown>;
+export {};
+//# sourceMappingURL=query.core.d.ts.map