@sumaris-net/ngx-components 18.11.0 → 18.12.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sumaris-net/ngx-components",
   "description": "SUMARiS Angular components",
-  "version": "18.11.0",
+  "version": "18.12.1",
   "author": "contact@e-is.pro",
   "license": "AGPL-3.0",
   "readmeFilename": "README.md",

package/src/app/core/services/model/entity.decorators.d.ts

@@ -1,7 +1,7 @@
 import { Entity } from './entity.model';
-declare type Constructor = new (...args: any[]) => any;
+declare type Constructor<T = any> = new (...args: any[]) => T;
 export declare class EntityClasses {
-    static CLASSES_BY_NAME: Map<string, Constructor>;
+    static CLASSES_BY_NAME: Map<string, Constructor<any>>;
     static register(typename: string, entityClass: Constructor): void;
     static get<T extends Entity<T>>(entityName: string): Constructor;
     static fromObject<T extends Entity<T>>(value: any, opts?: {
@@ -13,5 +13,5 @@ export declare class EntityClasses {
 export declare function EntityClass(opts: {
     typename: string;
     fromObjectReuseStrategy?: 'default' | 'clone';
-}): <T extends Constructor>(constructor: T) => T;
+}): <T extends Constructor<any>>(constructor: T) => T;
 export {};

package/src/app/core/services/model/filter.model.d.ts

@@ -6,7 +6,7 @@ export interface IEntityFilter<F extends IEntityFilter<F, T, ID, AO, FO>, T exte
     isEmpty(): boolean;
     countNotEmptyCriteria(): number;
 }
-export declare abstract class EntityFilter<F extends EntityFilter<F, T, ID, AO, FO>, T extends IEntity<T, any>, ID = number, AO extends EntityAsObjectOptions = EntityAsObjectOptions, FO = any> extends Entity<F, ID, AO, FO> implements IEntityFilter<F, T, ID, AO, FO> {
+export declare abstract class EntityFilter<F extends IEntityFilter<F, T, ID, AO, FO>, T extends IEntity<T, any>, ID = number, AO extends EntityAsObjectOptions = EntityAsObjectOptions, FO = any> extends Entity<F, ID, AO, FO> implements IEntityFilter<F, T, ID, AO, FO> {
     /**
      * Compose some filter functions: all should return true
      *

package/src/app/shared/rx-state/rx-state.decorators.d.ts

@@ -1,7 +1,43 @@
+import { Observable } from 'rxjs';
 import { ProjectValueReducer } from '@rx-angular/state';
 export declare function enableRxStateProdMode(): void;
+type ObservablePropertyDecorator<T> = <K extends PropertyKey>(target: any, propertyKey: K) => void;
+type StatePropertyDecorator<T> = <K extends PropertyKey>(target: any, propertyKey: K) => void;
+/**
+ * Decorator to register the RxState property in a component
+ * Must be used once per class hierarchy
+ */
 export declare function RxStateRegister(): PropertyDecorator;
-export declare function RxStateProperty<T = any, K extends keyof T = any, V extends T[K] = any>(statePropertyName?: string | K, projectValueReducer?: ProjectValueReducer<T, K, V>): PropertyDecorator;
-export declare function RxStateSelect<T = any>(statePropertyName?: string | keyof T | '$', opts?: {
+/**
+ * Decorator for RxState properties with getter/setter access
+ * Creates reactive properties that sync with RxState
+ */
+export declare function RxStateProperty<T = any, K extends keyof T = any, V extends T[K] = any>(statePropertyName?: string | K, projectValueReducer?: ProjectValueReducer<T, K, V>): StatePropertyDecorator<V>;
+/**
+ * Decorator for RxState observable selectors
+ * Creates observable properties that select from RxState
+ *
+ * ⚠️ IMPORTANT: La propriété décorée DOIT être typée comme Observable<T>
+ *
+ * @example
+ * ```typescript
+ * @RxStateSelect()
+ * protected pmfms$: Observable<IPmfm[]>; // ✅ Correct
+ *
+ * @RxStateSelect()
+ * protected badProperty: boolean; // ❌ TypeScript Error
+ * ```
+ */
+export declare function RxStateSelect<T = any, R = T[keyof T]>(statePropertyName?: string | keyof T | '$', opts?: {
     stateName?: string;
-}): PropertyDecorator;
+}): ObservablePropertyDecorator<Observable<R>>;
+/**
+ * Utility decorator to create computed observables from state
+ *
+ * ⚠️ IMPORTANT: La propriété décorée DOIT être typée comme Observable<T>
+ */
+export declare function RxStateComputed<T = any, K extends keyof T = any, R = any>(dependencies: K[], computeFn?: (slice: Pick<T, K>) => R, opts?: {
+    stateName?: string;
+    keyCompareMap?: any;
+}): ObservablePropertyDecorator<Observable<R>>;
+export {};

package/src/assets/manifest.json

@@ -2,7 +2,7 @@
   "name": "ngx-sumaris-components",
   "short_name": "ngx-sumaris-components",
   "manifest_version": 1,
-  "version": "18.11.0",
+  "version": "18.12.1",
   "default_locale": "fr",
   "description": "Angular components for building beautiful and responsive Apps",
   "icons": [{