@angular-architects/ngrx-toolkit 0.0.2 → 0.0.4

package/lib/with-data-service.d.ts

@@ -0,0 +1,115 @@
+import { ProviderToken, Signal } from "@angular/core";
+import { SignalStoreFeature } from "@ngrx/signals";
+import { CallState } from "./with-call-state";
+import { EntityId } from "@ngrx/signals/entities";
+import { EntityState, NamedEntitySignals } from "@ngrx/signals/entities/src/models";
+import { Emtpy } from "./shared/empty";
+export type Filter = Record<string, unknown>;
+export type Entity = {
+    id: EntityId;
+};
+export interface DataService<E extends Entity, F extends Filter> {
+    load(filter: F): Promise<E[]>;
+    loadById(id: EntityId): Promise<E>;
+    create(entity: E): Promise<E>;
+    update(entity: E): Promise<E>;
+    updateAll(entity: E[]): Promise<E[]>;
+    delete(entity: E): Promise<void>;
+}
+export declare function capitalize(str: string): string;
+export declare function getDataServiceKeys(options: {
+    collection?: string;
+}): {
+    filterKey: string;
+    selectedIdsKey: string;
+    selectedEntitiesKey: string;
+    updateFilterKey: string;
+    updateSelectedKey: string;
+    loadKey: string;
+    entitiesKey: string;
+    entityMapKey: string;
+    idsKey: string;
+    currentKey: string;
+    loadByIdKey: string;
+    setCurrentKey: string;
+    createKey: string;
+    updateKey: string;
+    updateAllKey: string;
+    deleteKey: string;
+};
+export type NamedDataServiceState<E extends Entity, F extends Filter, Collection extends string> = {
+    [K in Collection as `${K}Filter`]: F;
+} & {
+    [K in Collection as `selected${Capitalize<K>}Ids`]: Record<EntityId, boolean>;
+} & {
+    [K in Collection as `current${Capitalize<K>}`]: E;
+};
+export type DataServiceState<E extends Entity, F extends Filter> = {
+    filter: F;
+    selectedIds: Record<EntityId, boolean>;
+    current: E;
+};
+export type NamedDataServiceSignals<E extends Entity, Collection extends string> = {
+    [K in Collection as `selected${Capitalize<K>}Entities`]: Signal<E[]>;
+};
+export type DataServiceSignals<E extends Entity> = {
+    selectedEntities: Signal<E[]>;
+};
+export type NamedDataServiceMethods<E extends Entity, F extends Filter, Collection extends string> = {
+    [K in Collection as `update${Capitalize<K>}Filter`]: (filter: F) => void;
+} & {
+    [K in Collection as `updateSelected${Capitalize<K>}Entities`]: (id: EntityId, selected: boolean) => void;
+} & {
+    [K in Collection as `load${Capitalize<K>}Entities`]: () => Promise<void>;
+} & {
+    [K in Collection as `setCurrent${Capitalize<K>}`]: (entity: E) => void;
+} & {
+    [K in Collection as `load${Capitalize<K>}ById`]: (id: EntityId) => Promise<void>;
+} & {
+    [K in Collection as `create${Capitalize<K>}`]: (entity: E) => Promise<void>;
+} & {
+    [K in Collection as `update${Capitalize<K>}`]: (entity: E) => Promise<void>;
+} & {
+    [K in Collection as `updateAll${Capitalize<K>}`]: (entity: E[]) => Promise<void>;
+} & {
+    [K in Collection as `delete${Capitalize<K>}`]: (entity: E) => Promise<void>;
+};
+export type DataServiceMethods<E extends Entity, F extends Filter> = {
+    updateFilter: (filter: F) => void;
+    updateSelected: (id: EntityId, selected: boolean) => void;
+    load: () => Promise<void>;
+    setCurrent(entity: E): void;
+    loadById(id: EntityId): Promise<void>;
+    create(entity: E): Promise<void>;
+    update(entity: E): Promise<void>;
+    updateAll(entities: E[]): Promise<void>;
+    delete(entity: E): Promise<void>;
+};
+export type Empty = Record<string, never>;
+export declare function withDataService<E extends Entity, F extends Filter, Collection extends string>(options: {
+    dataServiceType: ProviderToken<DataService<E, F>>;
+    filter: F;
+    collection: Collection;
+}): SignalStoreFeature<{
+    state: Emtpy;
+    signals: NamedEntitySignals<E, Collection>;
+    methods: Emtpy;
+}, {
+    state: NamedDataServiceState<E, F, Collection>;
+    signals: NamedDataServiceSignals<E, Collection>;
+    methods: NamedDataServiceMethods<E, F, Collection>;
+}>;
+export declare function withDataService<E extends Entity, F extends Filter>(options: {
+    dataServiceType: ProviderToken<DataService<E, F>>;
+    filter: F;
+}): SignalStoreFeature<{
+    state: {
+        callState: CallState;
+    } & EntityState<E>;
+    signals: Emtpy;
+    methods: Emtpy;
+}, {
+    state: DataServiceState<E, F>;
+    signals: DataServiceSignals<E>;
+    methods: DataServiceMethods<E, F>;
+}>;

package/lib/with-undo-redo.d.ts

@@ -0,0 +1,55 @@
+import { SignalStoreFeature } from "@ngrx/signals";
+import { EntityId, EntityMap, EntityState } from "@ngrx/signals/entities";
+import { Signal } from "@angular/core";
+import { EntitySignals, NamedEntitySignals } from "@ngrx/signals/entities/src/models";
+import { Entity } from "./with-data-service";
+import { Emtpy } from "./shared/empty";
+export type StackItem = Record<string, unknown>;
+export type NormalizedUndoRedoOptions = {
+    maxStackSize: number;
+    collections?: string[];
+};
+export type NamedUndoRedoState<Collection extends string> = {
+    [K in Collection as `${K}EntityMap`]: EntityMap<Entity>;
+} & {
+    [K in Collection as `${K}Ids`]: EntityId[];
+};
+export type NamedUndoRedoSignals<Collection extends string> = {
+    [K in Collection as `${K}Entities`]: Signal<Entity[]>;
+};
+export declare function getUndoRedoKeys(collections?: string[]): string[];
+export declare function withUndoRedo<Collection extends string>(options?: {
+    maxStackSize?: number;
+    collections: Collection[];
+}): SignalStoreFeature<{
+    state: Emtpy;
+    signals: NamedEntitySignals<Entity, Collection>;
+    methods: Emtpy;
+}, {
+    state: Emtpy;
+    signals: {
+        canUndo: Signal<boolean>;
+        canRedo: Signal<boolean>;
+    };
+    methods: {
+        undo: () => void;
+        redo: () => void;
+    };
+}>;
+export declare function withUndoRedo(options?: {
+    maxStackSize?: number;
+}): SignalStoreFeature<{
+    state: EntityState<Entity>;
+    signals: EntitySignals<Entity>;
+    methods: Emtpy;
+}, {
+    state: Emtpy;
+    signals: {
+        canUndo: Signal<boolean>;
+        canRedo: Signal<boolean>;
+    };
+    methods: {
+        undo: () => void;
+        redo: () => void;
+    };
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@angular-architects/ngrx-toolkit",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "peerDependencies": {
     "@angular/common": "^17.0.0",
     "@angular/core": "^17.0.0",
@@ -23,4 +23,4 @@
       "default": "./fesm2022/angular-architects-ngrx-toolkit.mjs"
     }
   }
-}
+}