@craft-ng/core 0.0.1 → 0.0.2

package/fesm2022/craft-ng-core.mjs

@@ -7580,6 +7580,74 @@ function reactiveWritableSignal(initialValue, reactionBuilder) {
     return sig;
 }
 
+/**
+ * Creates an event emitter with automatic cleanup and signal-based value tracking.
+ *
+ * `source$` provides a lightweight event streaming solution that combines event emission,
+ * automatic subscription cleanup via `DestroyRef`, and signal-based reactive value tracking.
+ *
+ * @template T - The type of values emitted by the source
+ *
+ * @returns {Source$<T>} An object with the following methods and properties:
+ * - `emit(value: T)` - Emits a value to all subscribers and updates the internal signal
+ * - `subscribe(callback: (value: T) => void)` - Subscribes to emissions with automatic cleanup
+ * - `value: Signal<T | undefined>` - A read-only signal containing the last emitted value
+ * - `asReadonly()` - Returns a read-only version (only `subscribe` and `value`)
+ * - `preserveLastValue()` - Returns a variant that immediately emits the last value to new subscribers
+ *
+ * @example
+ * Basic usage with state coordination
+ * ```typescript
+ * import { source$, state, on$ } from '@craft-ng/core';
+ *
+ * @Component({
+ *   selector: 'app-counter',
+ *   template: `
+ *     <p>Count: {{ counter() }}</p>
+ *     <button (click)="counter.increment()">+1</button>
+ *     <button (click)="reset$.emit()">Reset</button>
+ *   `,
+ * })
+ * export class CounterComponent {
+ *   reset$ = source$<void>();
+ *
+ *   counter = state(0, ({ set, update }) => ({
+ *     increment: () => update((v) => v + 1),
+ *     reset: on$(this.reset$, () => set(0)),
+ *   }));
+ * }
+ * ```
+ *
+ *
+ * @example
+ * Late subscriber with preserved last value
+ * ```typescript
+ * const notifications$ = source$<string>().preserveLastValue();
+ *
+ * notifications$.emit('Server started');
+ * notifications$.emit('Database connected');
+ *
+ * // Late subscriber receives the last value immediately
+ * notifications$.subscribe((msg) => {
+ *   console.log(msg); // 'Database connected'
+ * });
+ * ```
+ *
+ * @example
+ * Read-only access pattern
+ * ```typescript
+ * class DataService {
+ *   private dataUpdated$ = source$<Data>();
+ *   readonly dataUpdated = this.dataUpdated$.asReadonly();
+ *
+ *   updateData(data: Data) {
+ *     this.dataUpdated$.emit(data);
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link https://ng-craft.dev/utils/source$ | source$ documentation}
+ */
 function source$() {
     const sourceRef$ = new EventEmitter();
     const destroyRef = inject(DestroyRef);
@@ -7623,9 +7691,42 @@ function source$() {
     };
 }
 
+function fromEventToSource$(target, eventName, options) {
+    assertInInjectionContext(fromEventToSource$);
+    const eventSource$ = source$();
+    const listener = (event) => {
+        if (options?.computedValue) {
+            const computed = options.computedValue(event);
+            eventSource$.emit(computed);
+            return;
+        }
+        eventSource$.emit(event);
+    };
+    target.addEventListener(eventName, listener, options?.event);
+    const destroyRef = inject(DestroyRef);
+    const dispose = () => {
+        target.removeEventListener(eventName, listener, options?.event);
+    };
+    destroyRef.onDestroy(() => {
+        dispose();
+    });
+    return Object.assign(eventSource$.asReadonly(), {
+        dispose,
+    });
+}
+
+function on$(_source, callback) {
+    const sub = _source.subscribe((value) => {
+        callback(value);
+    });
+    const destroyRef = inject(DestroyRef);
+    destroyRef.onDestroy(() => sub.unsubscribe());
+    return SourceBranded;
+}
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { EXTERNALLY_PROVIDED, EmptyContext, GlobalPersisterHandlerService, STORE_CONFIG_TOKEN, SourceBrand, SourceBranded, addMany, addOne, afterRecomputation, asyncProcess, capitalize, computedIds, computedSource, computedTotal, contract, craft, craftAsyncProcesses, craftComputedStates, craftFactoryEntries, craftInject, craftInputs, craftMutations, craftQuery, craftQueryParam, craftQueryParams, craftSetAllQueriesParamsStandalone, craftSources, craftState, createMethodHandlers, insertLocalStoragePersister, insertPaginationPlaceholderData, insertReactOnMutation, isSource, linkedSource, localStoragePersister, map, mapOne, mutation, partialContext, query, queryParam, reactiveWritableSignal, removeAll, removeMany, removeOne, resourceById, serializeQueryParams, serializedQueryParamsObjectToString, setAll, setMany, setOne, signalSource, source$, sourceFromEvent, stackedSource, state, toSource, toggleMany, toggleOne, updateMany, updateOne, upsertMany, upsertOne };
+export { EXTERNALLY_PROVIDED, EmptyContext, GlobalPersisterHandlerService, STORE_CONFIG_TOKEN, SourceBrand, SourceBranded, addMany, addOne, afterRecomputation, asyncProcess, capitalize, computedIds, computedSource, computedTotal, contract, craft, craftAsyncProcesses, craftComputedStates, craftFactoryEntries, craftInject, craftInputs, craftMutations, craftQuery, craftQueryParam, craftQueryParams, craftSetAllQueriesParamsStandalone, craftSources, craftState, createMethodHandlers, fromEventToSource$, insertLocalStoragePersister, insertPaginationPlaceholderData, insertReactOnMutation, isSource, linkedSource, localStoragePersister, map, mapOne, mutation, on$, partialContext, query, queryParam, reactiveWritableSignal, removeAll, removeMany, removeOne, resourceById, serializeQueryParams, serializedQueryParamsObjectToString, setAll, setMany, setOne, signalSource, source$, sourceFromEvent, stackedSource, state, toSource, toggleMany, toggleOne, updateMany, updateOne, upsertMany, upsertOne };
 //# sourceMappingURL=craft-ng-core.mjs.map