@craft-ts/core 0.7.0-beta.13

package/src/lib/to-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-source.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/to-source.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqUG;AACH,MAAM,UAAU,QAAQ,CACtB,YAA+D,EAC/D,OAIC;IAID,MAAM,WAAW,GAAG,YAAY,CAA0B,YAAY,EAAE;QACtE,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,uFAAuF;QACzI,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI;YACxB,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,cAAc;SAC/C,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,CAAC,eAAgD,EAAE,EAAE,CACpE,YAAY,CAAmB;QAC7B,MAAM,EAAE,WAAkC;QAC1C,WAAW,EAAE,CAAC,kBAAkB,EAAE,YAAY,EAAE,EAAE;YAChD,8CAA8C;YAC9C,IAAI,CAAC,YAAY,IAAI,eAAe,EAAE,iBAAiB,KAAK,KAAK,EAAE,CAAC;gBAClE,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,kGAAkG;YAClG,OAAO,SAAS,CAAC,GAAG,EAAE,CACpB,OAAO,EAAE,QAAQ;gBACf,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,kBAAkB,CAAC;gBACzC,CAAC,CAAC,kBAAkB,CACvB,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAChD,GAAG,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;KAC7D,CAAC,CAAC;IACL,OAAO,MAAM,CAAC,MAAM,CAClB,QAAQ,CAAC;QACP,iBAAiB,EAAE,IAAI;KACxB,CAAC,EACF;QACE,iBAAiB,EAAE,QAAQ,CAAC;YAC1B,iBAAiB,EAAE,KAAK;SACzB,CAAC;KACH,EACD,aAAa,CACS,CAAC;AAC3B,CAAC","sourcesContent":["import {\n  linkedSignal,\n  Signal,\n  untracked,\n  ValueEqualityFn,\n  WritableSignal,\n} from './host/craft-compat';\nimport { IsUnknown } from './util/util.type';\nimport { ReadonlySource } from './util/source.type';\nimport { SourceBranded } from './util/util';\n\n/**\n * Converts an Angular signal into a readonly source with lazy emission semantics.\n *\n * This function bridges the gap between signals and sources by:\n * - Converting continuous signal values into discrete source emissions\n * - Implementing lazy emission (only emits on signal changes, not on first read)\n * - Supporting optional value transformation via computed function\n * - Providing both standard and value-preserving listener variants\n * - Enabling signal-to-source conversions for event-driven architectures\n *\n * @remarks\n * **Signal vs Source Semantics:**\n * - **Signals**: Continuously readable, always have a value, recompute on access\n * - **Sources**: Emit only on explicit changes, lazy by default (undefined on first read)\n * - toSource converts continuous signal behavior to discrete source emissions\n *\n * **Emission Behavior:**\n * - First read returns `undefined` by default (maintains source lazy semantics)\n * - Subsequent reads return new values only when the origin signal changes\n * - Use `preserveLastValue` variant to get immediate value on first read\n *\n * **Use Cases:**\n * - **Event-driven patterns**: Convert signals to sources for reactive chains\n * - **Debounced signals**: Wrap debounced signals as sources for queries/mutations\n * - **External state**: Convert RxJS signals (toSignal) to sources\n * - **Form signals**: Convert form control signals to sources for automatic submission\n * - **Route params**: Convert router param signals to sources for automatic queries\n * - **Filtering**: Transform signal values while converting to source\n *\n * **Transformation:**\n * - Without `computed`: Passes signal values through unchanged\n * - With `computed`: Applies transformation before emitting to source\n * - Useful for extracting fields, formatting, or type narrowing\n *\n * **Comparison with computedSource:**\n * - `toSource`: Converts signals to sources (signal → source)\n * - `computedSource`: Transforms sources to sources (source → source)\n * - Use toSource when bridging from signal world to source world\n *\n * @template SourceState - The type of values from the origin signal\n * @template ComputedValue - The type of values after optional computation\n *\n * @param signalOrigin - The signal or writable signal to convert.\n *   Changes to this signal trigger source emissions.\n *\n * @param options - Optional configuration:\n *   - `computed`: Function to transform signal values before emission\n *   - `equal`: Custom equality function for change detection\n *   - `debugName`: Name for debugging purposes\n *\n * @returns A readonly source that emits when the signal changes with:\n *   - Standard behavior: First read returns `undefined`, subsequent reads return values after signal changes\n *   - `preserveLastValue` property: Returns current value immediately on first read\n *\n * @example\n * Basic signal to source conversion\n * ```ts\n * const countSignal = signal(0);\n * const countSource = toSource(countSignal);\n *\n * // Use in query for automatic execution\n * const fetchData = craftUse(query({\n *   method: afterRecomputation(countSource, (count) => count),\n *   loader: async ({ params }) => {\n *     const response = await fetch(`/api/data/${params}`);\n *     return response.json();\n *   },\n * }));\n *\n * // Query executes when signal changes\n * countSignal.set(1);\n * // -> countSource emits 1\n * // -> fetchData executes with params 1\n *\n * countSignal.set(2);\n * // -> countSource emits 2\n * // -> fetchData executes with params 2\n * ```\n *\n * @example\n * Converting route params to source\n * ```ts\n * @Component({\n *   selector: 'app-user-detail',\n *   template: `...`,\n * })\n * export class UserDetailComponent {\n *   route = inject(ActivatedRoute);\n *\n *   // Convert route param to signal\n *   userIdSignal = toSignal(\n *     this.route.params.pipe(map(p => p['userId']))\n *   );\n *\n *   // Convert signal to source\n *   userIdSource = toSource(this.userIdSignal);\n *\n *   // Use source in query\n *   { injectCraft } = craft(\n *     { name: '', providedIn: 'root' },\n *     craftQuery('user', () =>\n *       query({\n *         method: afterRecomputation(this.userIdSource, (id) => id),\n *         loader: async ({ params }) => {\n *           if (!params) return null;\n *           const response = await fetch(`/api/users/${params}`);\n *           return response.json();\n *         },\n *       })\n *     )\n *   );\n *\n *   store = this.injectCraft();\n *\n *   // Query automatically updates when route changes\n * }\n * ```\n *\n * @example\n * Transforming signal values during conversion\n * ```ts\n * type FormData = {\n *   name: string;\n *   email: string;\n *   preferences: { newsletter: boolean };\n * };\n *\n * const formSignal = signal<FormData>({\n *   name: '',\n *   email: '',\n *   preferences: { newsletter: false },\n * });\n *\n * // Extract only email for validation\n * const emailSource = toSource(formSignal, {\n *   computed: (form) => form.email,\n * });\n *\n * // Use in async method\n * const validateEmail = craftUse(asyncProcess({\n *   method: afterRecomputation(emailSource, (email) => email),\n *   loader: async ({ params }) => {\n *     if (!params) return null;\n *     const response = await fetch('/api/validate-email', {\n *       method: 'POST',\n *       body: JSON.stringify({ email: params }),\n *     });\n *     return response.json();\n *   },\n * }));\n *\n * // Email validation triggers when form email changes\n * formSignal.update(form => ({ ...form, email: 'john@example.com' }));\n * // -> emailSource emits 'john@example.com'\n * // -> validateEmail executes\n * ```\n *\n * @example\n * Debounced signal to source\n * ```ts\n * const searchInputSignal = signal('');\n *\n * // Create debounced signal (using custom debounce logic)\n * const debouncedSearchSignal = computed(() => {\n *   const input = searchInputSignal();\n *   // Debounce logic would go here\n *   return input;\n * });\n *\n * // Convert to source\n * const debouncedSearchSource = toSource(debouncedSearchSignal);\n *\n * // Use in query\n * const searchResults = craftUse(query({\n *   method: afterRecomputation(debouncedSearchSource, (term) => term),\n *   loader: async ({ params }) => {\n *     if (!params) return [];\n *     const response = await fetch(`/api/search?q=${params}`);\n *     return response.json();\n *   },\n * }));\n *\n * // Query executes only after debounce\n * searchInputSignal.set('ang');\n * searchInputSignal.set('angu');\n * searchInputSignal.set('angular');\n * // -> Eventually debouncedSearchSource emits 'angular'\n * // -> searchResults query executes once\n * ```\n *\n * @example\n * Form control signal to source\n * ```ts\n * @Component({\n *   selector: 'app-search',\n *   template: `\n *     <input [formControl]=\"searchControl\" />\n *   `,\n * })\n * export class SearchComponent {\n *   searchControl = new FormControl('');\n *\n *   // Convert form control value to signal\n *   searchSignal = toSignal(\n *     this.searchControl.valueChanges.pipe(\n *       debounceTime(300),\n *       distinctUntilChanged()\n *     ),\n *     { initialValue: '' }\n *   );\n *\n *   // Convert signal to source\n *   searchSource = toSource(this.searchSignal);\n *\n *   // Use in store\n *   { injectCraft } = craft(\n *     { name: '', providedIn: 'root' },\n *     craftQuery('results', () =>\n *       query({\n *         method: afterRecomputation(this.searchSource, (term) => term),\n *         loader: async ({ params }) => {\n *           const response = await fetch(`/api/search?q=${params}`);\n *           return response.json();\n *         },\n *       })\n *     )\n *   );\n *\n *   store = this.injectCraft();\n * }\n * ```\n *\n * @example\n * Custom equality for change detection\n * ```ts\n * type SearchParams = { query: string; timestamp: number };\n *\n * const paramsSignal = signal<SearchParams>({\n *   query: '',\n *   timestamp: Date.now(),\n * });\n *\n * // Only emit when query changes, ignore timestamp\n * const querySource = toSource(paramsSignal, {\n *   computed: (params) => params.query,\n *   equal: (a, b) => a === b, // Compare strings only\n * });\n *\n * // Update with same query but different timestamp\n * paramsSignal.set({ query: 'test', timestamp: Date.now() });\n * // -> querySource emits 'test'\n *\n * paramsSignal.set({ query: 'test', timestamp: Date.now() });\n * // -> querySource does NOT emit (same query)\n *\n * paramsSignal.set({ query: 'new', timestamp: Date.now() });\n * // -> querySource emits 'new'\n * ```\n *\n * @example\n * Using preserveLastValue for immediate access\n * ```ts\n * const countSignal = signal(5);\n * const countSource = toSource(countSignal);\n *\n * // Standard behavior - first read is undefined\n * console.log(countSource()); // undefined\n *\n * countSignal.set(10);\n * console.log(countSource()); // 10\n *\n * // Using preserveLastValue - gets current value immediately\n * const immediateCount = countSource.preserveLastValue;\n * console.log(immediateCount()); // 10\n *\n * countSignal.set(15);\n * console.log(immediateCount()); // 15\n * ```\n *\n * @example\n * Complex transformation with validation\n * ```ts\n * type RawInput = { text: string; valid?: boolean };\n *\n * const inputSignal = signal<RawInput>({ text: '' });\n *\n * // Transform and validate during conversion\n * const validInputSource = toSource(inputSignal, {\n *   computed: (input) => {\n *     const trimmed = input.text.trim();\n *     if (trimmed.length < 3) {\n *       return null; // Invalid input\n *     }\n *     return {\n *       text: trimmed.toLowerCase(),\n *       length: trimmed.length,\n *     };\n *   },\n * });\n *\n * // Use in mutation\n * const submitInput = craftUse(mutation({\n *   method: afterRecomputation(validInputSource, (data) => data),\n *   loader: async ({ params }) => {\n *     if (!params) {\n *       throw new Error('Invalid input');\n *     }\n *     const response = await fetch('/api/submit', {\n *       method: 'POST',\n *       body: JSON.stringify(params),\n *     });\n *     return response.json();\n *   },\n * }));\n *\n * // Invalid input\n * inputSignal.set({ text: 'ab' });\n * // -> validInputSource emits null\n * // -> submitInput throws error\n *\n * // Valid input\n * inputSignal.set({ text: 'Valid Input' });\n * // -> validInputSource emits { text: 'valid input', length: 11 }\n * // -> submitInput executes with transformed data\n * ```\n */\nexport function toSource<SourceState, ComputedValue>(\n  signalOrigin: Signal<SourceState> | WritableSignal<SourceState>,\n  options?: {\n    computed?: (sourceValue: NoInfer<SourceState>) => ComputedValue;\n    equal?: ValueEqualityFn<NoInfer<SourceState> | undefined>;\n    debugName?: string;\n  },\n): ReadonlySource<\n  IsUnknown<ComputedValue> extends true ? SourceState : ComputedValue\n> {\n  const sourceState = linkedSignal<SourceState | undefined>(signalOrigin, {\n    ...(options?.equal && { equal: options?.equal }), // add the equal function here, it may helps to detect changes when using scalar values\n    ...(options?.debugName && {\n      debugName: options?.debugName + '_sourceState',\n    }),\n  });\n\n  const listener = (listenerOptions: { nullishFirstValue?: boolean }) =>\n    linkedSignal<SourceState, any>({\n      source: sourceState as Signal<SourceState>,\n      computation: (currentSourceState, previousData) => {\n        // always when first listened return undefined\n        if (!previousData && listenerOptions?.nullishFirstValue !== false) {\n          return undefined;\n        }\n        //! use untracked to avoid computation to be re-evaluated when used inside another effect/computed\n        return untracked(() =>\n          options?.computed\n            ? options?.computed?.(currentSourceState)\n            : currentSourceState,\n        );\n      },\n      ...(options?.equal && { equal: options?.equal }),\n      ...(options?.debugName && { debugName: options?.debugName }),\n    });\n  return Object.assign(\n    listener({\n      nullishFirstValue: true,\n    }),\n    {\n      preserveLastValue: listener({\n        nullishFirstValue: false,\n      }),\n    },\n    SourceBranded,\n  ) as ReadonlySource<any>;\n}\n"]}

package/src/lib/util/craft-resource-ref.d.ts

@@ -0,0 +1,29 @@
+import type { ResourceSnapshot, ResourceStatus, Signal } from '../host/craft-compat';
+import type { CraftSettledSignal } from '../craft-settled';
+export type CraftResourceRefSpecificState<Value, Params> = {
+    paramSrc: Signal<Params | undefined>;
+    state: Signal<Value | undefined>;
+};
+/**
+ * Angular's `error` signal is excluded from the craft surface: business failures
+ * are exposed through the `exceptions()`/`hasException()` API instead. The raw
+ * signal still exists on the ref at runtime as an internal channel (see
+ * `craftUntilSettled`, which rethrows a residual technical failure through it).
+ */
+export type CraftResourceRef<Value, Params, Source extends string = string, Exceptions = never> = {
+    /**
+     * Returns undefined when the resource has no resolved value or an exception.
+     */
+    value: Signal<Value | undefined>;
+    status: Signal<ResourceStatus>;
+    isLoading: Signal<boolean>;
+    snapshot: Signal<ResourceSnapshot<Value | undefined>>;
+    hasValue(): boolean;
+    reload(): boolean;
+    destroy(): void;
+    set(value: Value | undefined): void;
+    update(update: (value: Value | undefined) => Value | undefined): void;
+    asReadonly(): Omit<CraftResourceRef<Value, Params, Source, Exceptions>, 'set' | 'update' | 'destroy'>;
+    readonly settledValue: CraftSettledSignal<Exclude<Value, undefined>, Source, Exceptions>;
+} & CraftResourceRefSpecificState<Value, Params>;
+//# sourceMappingURL=craft-resource-ref.d.ts.map

package/src/lib/util/craft-resource-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resource-ref.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/craft-resource-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,MAAM,6BAA6B,CAAC,KAAK,EAAE,MAAM,IAAI;IACzD,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;CAClC,CAAC;AACF;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,CAC1B,KAAK,EACL,MAAM,EACN,MAAM,SAAS,MAAM,GAAG,MAAM,EAC9B,UAAU,GAAG,KAAK,IAChB;IACF;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,gBAAgB,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;IACtD,QAAQ,IAAI,OAAO,CAAC;IACpB,MAAM,IAAI,OAAO,CAAC;IAClB,OAAO,IAAI,IAAI,CAAC;IAChB,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,KAAK,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IACtE,UAAU,IAAI,IAAI,CAChB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EACnD,KAAK,GAAG,QAAQ,GAAG,SAAS,CAC7B,CAAC;IACF,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CACvC,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,EACzB,MAAM,EACN,UAAU,CACX,CAAC;CACH,GAAG,6BAA6B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC"}

package/src/lib/util/craft-resource-ref.js

@@ -0,0 +1 @@
+//# sourceMappingURL=craft-resource-ref.js.map

package/src/lib/util/craft-resource-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resource-ref.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/craft-resource-ref.ts"],"names":[],"mappings":"","sourcesContent":["import type { ResourceSnapshot, ResourceStatus, Signal } from '../host/craft-compat';\nimport type { CraftSettledSignal } from '../craft-settled';\n\nexport type CraftResourceRefSpecificState<Value, Params> = {\n  paramSrc: Signal<Params | undefined>;\n  state: Signal<Value | undefined>;\n};\n/**\n * Angular's `error` signal is excluded from the craft surface: business failures\n * are exposed through the `exceptions()`/`hasException()` API instead. The raw\n * signal still exists on the ref at runtime as an internal channel (see\n * `craftUntilSettled`, which rethrows a residual technical failure through it).\n */\nexport type CraftResourceRef<\n  Value,\n  Params,\n  Source extends string = string,\n  Exceptions = never,\n> = {\n  /**\n   * Returns undefined when the resource has no resolved value or an exception.\n   */\n  value: Signal<Value | undefined>;\n  status: Signal<ResourceStatus>;\n  isLoading: Signal<boolean>;\n  snapshot: Signal<ResourceSnapshot<Value | undefined>>;\n  hasValue(): boolean;\n  reload(): boolean;\n  destroy(): void;\n  set(value: Value | undefined): void;\n  update(update: (value: Value | undefined) => Value | undefined): void;\n  asReadonly(): Omit<\n    CraftResourceRef<Value, Params, Source, Exceptions>,\n    'set' | 'update' | 'destroy'\n  >;\n  readonly settledValue: CraftSettledSignal<\n    Exclude<Value, undefined>,\n    Source,\n    Exceptions\n  >;\n} & CraftResourceRefSpecificState<Value, Params>;\n"]}

package/src/lib/util/craft-resource-status.d.ts

@@ -0,0 +1,17 @@
+import type { ResourceStatus } from '../host/craft-compat';
+/**
+ * The status a craft primitive (`query` / `mutation` / `asyncProcess`) exposes
+ * on its public façade. Mirrors Angular's {@link ResourceStatus} but replaces the
+ * technical `'error'` state with the craft-business `'exception'` state: a
+ * resource reaches `'exception'` when a loader/params `craftException` is present.
+ */
+export type CraftResourceStatus = 'idle' | 'loading' | 'reloading' | 'resolved' | 'local' | 'exception';
+/**
+ * Maps a raw Angular {@link ResourceStatus} to the craft-facing
+ * {@link CraftResourceStatus}. `hasException` is the business discriminant and is
+ * checked first; a residual technical `'error'` is also surfaced as `'exception'`
+ * to keep the public type sound (in the expected craft model errors are left to
+ * throw, so that case does not occur).
+ */
+export declare function toCraftStatus(raw: ResourceStatus, hasException: boolean): CraftResourceStatus;
+//# sourceMappingURL=craft-resource-status.d.ts.map

package/src/lib/util/craft-resource-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resource-status.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/craft-resource-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,SAAS,GACT,WAAW,GACX,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAEhB;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,OAAO,GACpB,mBAAmB,CAKrB"}

package/src/lib/util/craft-resource-status.js

@@ -0,0 +1,14 @@
+/**
+ * Maps a raw Angular {@link ResourceStatus} to the craft-facing
+ * {@link CraftResourceStatus}. `hasException` is the business discriminant and is
+ * checked first; a residual technical `'error'` is also surfaced as `'exception'`
+ * to keep the public type sound (in the expected craft model errors are left to
+ * throw, so that case does not occur).
+ */
+export function toCraftStatus(raw, hasException) {
+    if (hasException || raw === 'error') {
+        return 'exception';
+    }
+    return raw;
+}
+//# sourceMappingURL=craft-resource-status.js.map

package/src/lib/util/craft-resource-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"craft-resource-status.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/craft-resource-status.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAmB,EACnB,YAAqB;IAErB,IAAI,YAAY,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,GAA0B,CAAC;AACpC,CAAC","sourcesContent":["import type { ResourceStatus } from '../host/craft-compat';\n\n/**\n * The status a craft primitive (`query` / `mutation` / `asyncProcess`) exposes\n * on its public façade. Mirrors Angular's {@link ResourceStatus} but replaces the\n * technical `'error'` state with the craft-business `'exception'` state: a\n * resource reaches `'exception'` when a loader/params `craftException` is present.\n */\nexport type CraftResourceStatus =\n  | 'idle'\n  | 'loading'\n  | 'reloading'\n  | 'resolved'\n  | 'local'\n  | 'exception';\n\n/**\n * Maps a raw Angular {@link ResourceStatus} to the craft-facing\n * {@link CraftResourceStatus}. `hasException` is the business discriminant and is\n * checked first; a residual technical `'error'` is also surfaced as `'exception'`\n * to keep the public type sound (in the expected craft model errors are left to\n * throw, so that case does not occur).\n */\nexport function toCraftStatus(\n  raw: ResourceStatus,\n  hasException: boolean,\n): CraftResourceStatus {\n  if (hasException || raw === 'error') {\n    return 'exception';\n  }\n  return raw as CraftResourceStatus;\n}\n"]}

package/src/lib/util/entities-util.d.ts

@@ -0,0 +1,340 @@
+/**
+ * Type to extract the identifier from an entity
+ */
+export type IdSelector<Entity, Key = string | number> = (entity: Entity) => Key;
+/**
+ * Type for partial updates
+ */
+export type Update<T, K = string | number> = {
+    id: K;
+    changes: Partial<T>;
+};
+export type EntitiesUtilBrand<Name> = {
+    __brand: Name;
+};
+/**
+ * Removes all elements from the list
+ */
+export declare function removeAll<T>(): T[] & EntitiesUtilBrand<'removeAll'>;
+/**
+ * Adds an element to the end of the list
+ */
+export declare function addOne<T>({ entity, entities, }: {
+    entity: T;
+    entities: T[];
+}): T[] & EntitiesUtilBrand<'addOne'>;
+/**
+ * Adds multiple elements to the end of the list
+ */
+export declare function addMany<T>({ newEntities, entities, }: {
+    newEntities: T[];
+    entities: T[];
+}): T[] & EntitiesUtilBrand<'addMany'>;
+/**
+ * Replaces the entire list with new elements
+ */
+export declare function setAll<T>({ newEntities, }: {
+    newEntities: T[];
+}): T[] & EntitiesUtilBrand<'setAll'>;
+/**
+ * Replaces or adds an element (based on id).
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function setOne<T extends string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'setOne'>;
+export declare function setOne<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'setOne'>;
+export declare function setOne<T, K = string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'setOne'>;
+/**
+ * Replaces or adds multiple elements (based on id).
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function setMany<T extends string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'setMany'>;
+export declare function setMany<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'setMany'>;
+export declare function setMany<T, K = string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'setMany'>;
+/**
+ * Partially updates an existing element.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function updateOne<T extends string | number>(params: {
+    update: Update<T, T>;
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'updateOne'>;
+export declare function updateOne<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    update: Update<T, K>;
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'updateOne'>;
+export declare function updateOne<T, K = string | number>(params: {
+    update: Update<T, K>;
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'updateOne'>;
+/**
+ * Partially updates multiple existing elements.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function updateMany<T extends string | number>(params: {
+    updates: Update<T, T>[];
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'updateMany'>;
+export declare function updateMany<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    updates: Update<T, K>[];
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'updateMany'>;
+export declare function updateMany<T, K = string | number>(params: {
+    updates: Update<T, K>[];
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'updateMany'>;
+/**
+ * Updates an element if it exists, otherwise adds it.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function upsertOne<T extends string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'upsertOne'>;
+export declare function upsertOne<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'upsertOne'>;
+export declare function upsertOne<T, K = string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'upsertOne'>;
+/**
+ * Updates multiple elements if they exist, otherwise adds them.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function upsertMany<T extends string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'upsertMany'>;
+export declare function upsertMany<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'upsertMany'>;
+export declare function upsertMany<T, K = string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'upsertMany'>;
+/**
+ * Removes an element by its id.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function removeOne<T extends string | number>(params: {
+    id: T;
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'removeOne'>;
+export declare function removeOne<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    id: K;
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'removeOne'>;
+export declare function removeOne<T, K = string | number>(params: {
+    id: K;
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'removeOne'>;
+/**
+ * Removes multiple elements by their ids.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function removeMany<T extends string | number>(params: {
+    ids: T[];
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'removeMany'>;
+export declare function removeMany<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    ids: K[];
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'removeMany'>;
+export declare function removeMany<T, K = string | number>(params: {
+    ids: K[];
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'removeMany'>;
+/**
+ * Toggles an element: removes it if it exists, adds it if it doesn't.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function toggleOne<T extends string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'toggleOne'>;
+export declare function toggleOne<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'toggleOne'>;
+export declare function toggleOne<T, K = string | number>(params: {
+    entity: T;
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'toggleOne'>;
+/**
+ * Toggles multiple elements: removes them if they exist, adds them if they don't.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function toggleMany<T extends string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'toggleMany'>;
+export declare function toggleMany<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'toggleMany'>;
+export declare function toggleMany<T, K = string | number>(params: {
+    newEntities: T[];
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'toggleMany'>;
+/**
+ * Applies a transformation function to all elements
+ */
+export declare function map<T>({ mapFn, entities, }: {
+    mapFn: (entity: T) => T;
+    entities: T[];
+}): T[] & EntitiesUtilBrand<'map'>;
+/**
+ * Applies a transformation function to a single element by its id.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function mapOne<T extends string | number>(params: {
+    id: T;
+    mapFn: (entity: T) => T;
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'mapOne'>;
+export declare function mapOne<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    id: K;
+    mapFn: (entity: T) => T;
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'mapOne'>;
+export declare function mapOne<T, K = string | number>(params: {
+    id: K;
+    mapFn: (entity: T) => T;
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): T[] & EntitiesUtilBrand<'mapOne'>;
+/**
+ * Returns the total count of entities
+ */
+export declare function computedTotal<T>({ entities }: {
+    entities: T[];
+}): number;
+/**
+ * Returns all ids from the entities list.
+ * If the entity has an `id` property, the identifier is optional.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ */
+export declare function computedIds<T extends string | number>(params: {
+    entities: T[];
+    identifier?: IdSelector<T, T>;
+}): T[] & EntitiesUtilBrand<'computedIds'>;
+export declare function computedIds<T extends {
+    id: K;
+}, K = T extends {
+    id: infer I;
+} ? I : string | number>(params: {
+    entities: T[];
+    identifier?: IdSelector<T, K>;
+}): K[] & EntitiesUtilBrand<'computedIds'>;
+export declare function computedIds<T, K = string | number>(params: {
+    entities: T[];
+    identifier: IdSelector<T, K>;
+}): K[] & EntitiesUtilBrand<'computedIds'>;
+//# sourceMappingURL=entities-util.d.ts.map

package/src/lib/util/entities-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities-util.d.ts","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/util/entities-util.ts"],"names":[],"mappings":"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"}

package/src/lib/util/entities-util.js

@@ -0,0 +1,136 @@
+/**
+ * Helper function to get the default identifier.
+ * For primitives (string | number), the entity itself is used as the identifier.
+ * For objects with an `id` property, the `id` property is used.
+ */
+function getDefaultIdentifier() {
+    return (e) => {
+        if (typeof e === 'string' || typeof e === 'number') {
+            return e;
+        }
+        return e.id;
+    };
+}
+/**
+ * Removes all elements from the list
+ */
+export function removeAll() {
+    return [];
+}
+/**
+ * Adds an element to the end of the list
+ */
+export function addOne({ entity, entities, }) {
+    return [...entities, entity];
+}
+/**
+ * Adds multiple elements to the end of the list
+ */
+export function addMany({ newEntities, entities, }) {
+    return [...entities, ...newEntities];
+}
+/**
+ * Replaces the entire list with new elements
+ */
+export function setAll({ newEntities, }) {
+    return [...newEntities];
+}
+export function setOne({ entity, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    const id = getId(entity);
+    const index = entities.findIndex((e) => getId(e) === id);
+    if (index === -1) {
+        return [...entities, entity];
+    }
+    return entities.map((e, i) => (i === index ? entity : e));
+}
+export function setMany({ newEntities, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    let result = [...entities];
+    for (const entity of newEntities) {
+        result = setOne({ entity, entities: result, identifier: getId });
+    }
+    return result;
+}
+export function updateOne({ update, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    const index = entities.findIndex((e) => getId(e) === update.id);
+    if (index === -1) {
+        return entities;
+    }
+    return entities.map((e, i) => i === index ? { ...e, ...update.changes } : e);
+}
+export function updateMany({ updates, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    let result = [...entities];
+    for (const update of updates) {
+        result = updateOne({ update, entities: result, identifier: getId });
+    }
+    return result;
+}
+export function upsertOne({ entity, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    const id = getId(entity);
+    const index = entities.findIndex((e) => getId(e) === id);
+    if (index === -1) {
+        return [...entities, entity];
+    }
+    // For primitives, just replace; for objects, merge
+    const isPrimitive = typeof entity === 'string' || typeof entity === 'number';
+    return entities.map((e, i) => i === index ? (isPrimitive ? entity : { ...e, ...entity }) : e);
+}
+export function upsertMany({ newEntities, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    let result = [...entities];
+    for (const entity of newEntities) {
+        result = upsertOne({ entity, entities: result, identifier: getId });
+    }
+    return result;
+}
+export function removeOne({ id, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    return entities.filter((e) => getId(e) !== id);
+}
+export function removeMany({ ids, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    const idSet = new Set(ids);
+    return entities.filter((e) => !idSet.has(getId(e)));
+}
+export function toggleOne({ entity, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    const id = getId(entity);
+    const exists = entities.some((e) => getId(e) === id);
+    if (exists) {
+        return entities.filter((e) => getId(e) !== id);
+    }
+    return [...entities, entity];
+}
+export function toggleMany({ newEntities, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    let result = [...entities];
+    for (const entity of newEntities) {
+        result = toggleOne({ entity, entities: result, identifier: getId });
+    }
+    return result;
+}
+/**
+ * Applies a transformation function to all elements
+ */
+export function map({ mapFn, entities, }) {
+    return entities.map(mapFn);
+}
+export function mapOne({ id, mapFn, entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    return entities.map((e) => (getId(e) === id ? mapFn(e) : e));
+}
+/**
+ * Returns the total count of entities
+ */
+export function computedTotal({ entities }) {
+    return entities.length;
+}
+export function computedIds({ entities, identifier, }) {
+    const getId = identifier ?? getDefaultIdentifier();
+    return entities.map(getId);
+}
+//# sourceMappingURL=entities-util.js.map