@lucca-front/ng 22.0.3 → 22.0.4

package/types/lucca-front-ng-core-select-api.d.ts

@@ -51,13 +51,31 @@ declare abstract class ALuCoreSelectApiDirective<TOption, TParams = Record<strin
      */
     protected getGroupOptions?: (group: unknown) => Observable<TOption[]>;
     ngOnInit(): void;
+    /**
+     * Emits whenever something *other than the clue* changed in {@link params$}, so the option stream
+     * resets and reloads from page 0 — a panel header toggle, a filter bound to an input…
+     *
+     * Clue changes are already the select's own business (debounce included), and every directive folds
+     * the clue into its params under its own key — sometimes driving the sort along with it — so there
+     * is no clue key to strip generically. They are recognized here by comparing the clue of two
+     * consecutive params emissions instead: same clue but different params means a real params change.
+     */
+    protected buildParamsChange(): Observable<TParams>;
     /**
      * Post-process the whole list of loaded options (all pages accumulated). Override it for
      * decorations that can't be computed page by page, eg. flagging homonyms across pages.
      */
     protected transformOptions(options: readonly TOption[]): Observable<readonly TOption[]>;
     protected buildParamsFromClue(clue: string): Observable<TParams>;
-    abstract totalCount$: Observable<number>;
+    /**
+     * Total number of options matching the current params, ignoring pagination. Only the select-all
+     * feature of `lu-multi-select` needs it, so it is optional: a directive that has no cheap way to
+     * count — or whose select never offers a select-all — simply leaves it undefined.
+     *
+     * Being a property of this class, it has to be implemented as a field: TypeScript rejects an
+     * accessor overriding a property (TS2611).
+     */
+    totalCount$: Observable<number> | undefined;
     protected clearLastPageByClue(): void;
     protected getOptionsPage(params: TParams, page: number): Observable<{
         items: TOption[];

package/types/lucca-front-ng-core-select.d.ts

@@ -16,6 +16,13 @@ interface SelectDataSourceParams {
     page: number;
 }
 interface SelectDataSource<TOption, TGroup = never> {
+    /**
+     * Emits when the params behind `getOptions` changed, so the select resets and reloads from page 0
+     * with the current clue — a panel header toggle, a filter bound to an input…
+     *
+     * It must not emit on clue changes: those are the select's own business, debounce included, and an
+     * emission here would load the same page a second time.
+     */
     paramsChange?: Observable<unknown>;
     /** Optional debounce in ms for clue-based re-queries (useful for API data sources) */
     clueDebounceMs?: number;
@@ -56,6 +63,11 @@ type CoreSelectAddOptionStrategy = 'never' | 'always' | 'if-empty-clue' | 'if-no
 declare const SELECT_ID: InjectionToken<number>;
 declare const SELECT_LABEL: InjectionToken<HTMLLabelElement>;
 declare const SELECT_LABEL_ID: InjectionToken<string>;
+/**
+ * Contract behind {@link CORE_SELECT_API_TOTAL_COUNT_PROVIDER}: a directive fulfills it by declaring
+ * a `totalCount$`, which the select-all of `lu-multi-select` then reads through the token. Providing
+ * a count stays optional — see `ALuCoreSelectApiDirective.totalCount$`.
+ */
 interface CoreSelectApiTotalCountProvider {
     totalCount$: Observable<number>;
 }

package/types/lucca-front-ng-option.d.ts

@@ -133,8 +133,8 @@ type LuOptionComparer<T> = (option1: T, option2: T) => boolean;
 declare abstract class ALuOptionPicker<T, O extends ILuOptionItem<T> = ILuOptionItem<T>> extends ALuPickerPanel<T> implements ILuOptionPickerPanel<T> {
     protected _subs: Subscription;
     onSelectValue: Observable<T | T[]>;
-    protected _value: T | T[];
-    setValue(value: T | T[]): void;
+    protected _value: T | T[] | undefined;
+    setValue(value: T | T[] | undefined): void;
     private __options$;
     protected get _options$(): Observable<O[]>;
     protected set _options$(options$: Observable<O[]>);
@@ -430,12 +430,12 @@ declare class LuTreeOptionOperatorModule {
 interface ILuOptionSelector<T> {
     multiple: boolean;
     onSelectValue: Observable<T | T[]>;
-    setValue(value: T | T[]): void;
+    setValue(value: T | T[] | undefined): void;
 }
 declare abstract class ALuOptionSelector<T> implements ILuOptionSelector<T> {
     multiple: boolean;
     abstract onSelectValue: Observable<T | T[]>;
-    abstract setValue(value: T | T[]): void;
+    abstract setValue(value: T | T[] | undefined): void;
 }
 
 type ILuTreeOptionSelector<T> = ILuOptionSelector<T>;
@@ -456,7 +456,7 @@ declare class LuOptionSelectAllComponent<T> extends ALuOptionOperator<T> impleme
     readonly intl: i0.InputSignalWithTransform<_lucca_front_ng_option.ILuOptionSelectAllLabel, Partial<_lucca_front_ng_option.ILuOptionSelectAllLabel>>;
     selectAll(): void;
     deselectAll(): void;
-    setValue(values: T | T[]): void;
+    setValue(values: T | T[] | undefined): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<LuOptionSelectAllComponent<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LuOptionSelectAllComponent<any>, "lu-option-select-all", never, { "intl": { "alias": "intl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -491,7 +491,7 @@ declare class LuTreeOptionSelectAllComponent<T> extends ALuTreeOptionOperator<T>
     readonly intl: i0.InputSignalWithTransform<_lucca_front_ng_option.ILuOptionSelectAllLabel, Partial<_lucca_front_ng_option.ILuOptionSelectAllLabel>>;
     selectAll(): void;
     deselectAll(): void;
-    setValue(values: T | T[]): void;
+    setValue(values: T | T[] | undefined): void;
     private flattenTree;
     static ɵfac: i0.ɵɵFactoryDeclaration<LuTreeOptionSelectAllComponent<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<LuTreeOptionSelectAllComponent<any>, "lu-tree-option-select-all", never, { "intl": { "alias": "intl"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
@@ -518,7 +518,7 @@ declare abstract class ALuOptionPickerAdvancedComponent<T, O extends ILuOptionIt
     onScrollBottom(): void;
     onOpen(): void;
     onClose(): void;
-    setValue(value: T | T[]): void;
+    setValue(value: T | T[] | undefined): void;
     protected initOperators(): void;
     protected initSelectors(): void;
     ngAfterViewInit(): void;
@@ -603,7 +603,7 @@ declare abstract class ALuTreeOptionPickerAdvancedComponent<T, O extends ILuTree
     onScrollBottom(): void;
     onOpen(): void;
     onClose(): void;
-    setValue(value: T | T[]): void;
+    setValue(value: T | T[] | undefined): void;
     protected initOperators(): void;
     protected initSelectors(): void;
     ngAfterViewInit(): void;

package/types/lucca-front-ng-picker.d.ts

@@ -15,12 +15,12 @@ declare interface ILuPickerPanel<T> extends ILuPopoverPanel {
      * called to tell the picker what's the current value
      * @param value
      */
-    setValue(value: T | T[]): void;
+    setValue(value: T | T[] | undefined): void;
 }
 declare abstract class ALuPickerPanel<T> extends ALuPopoverPanel implements ILuPickerPanel<T> {
     multiple: boolean;
     onSelectValue: Observable<T | T[]>;
-    abstract setValue(value: T | T[]): void;
+    abstract setValue(value: T | T[] | undefined): void;
 }
 declare interface ILuInputWithPicker<TValue> extends ILuInput, ILuPopoverTrigger<ILuPickerPanel<TValue>> {
 }

package/types/lucca-front-ng-select.d.ts

@@ -23,13 +23,13 @@ declare abstract class ALuSelectInput<T, TPicker extends ILuPickerPanel<T> = ILu
     /**
      * contriol value accessor interface implementation
      */
-    protected _value: T | T[];
+    protected _value: T | T[] | undefined;
     setValue(value: T | T[] | undefined): void;
-    get value(): T | T[];
-    set value(value: T | T[]);
-    writeValue(value: T | T[]): void;
-    protected _cvaOnChange: (v: T | T[]) => unknown;
-    registerOnChange(fn: (v: T | T[]) => unknown): void;
+    get value(): T | T[] | undefined;
+    set value(value: T | T[] | undefined);
+    writeValue(value: T | T[] | undefined): void;
+    protected _cvaOnChange: (v: T | T[] | undefined) => unknown;
+    registerOnChange(fn: (v: T | T[] | undefined) => unknown): void;
     protected _onTouched: () => unknown;
     registerOnTouched(fn: () => unknown): void;
     set disabled(d: boolean);

package/types/lucca-front-ng-simple-select.d.ts

@@ -50,7 +50,7 @@ declare class LuSelectPanelComponent<T> implements AfterViewInit, CoreSelectPane
     readonly optionComparer: _angular_core.WritableSignal<_lucca_front_ng_core_select.LuOptionComparer<T>>;
     readonly optionKey: _angular_core.WritableSignal<(option: T) => unknown>;
     colorPanel: _angular_core.InputSignalWithTransform<boolean, boolean | "" | "false" | "true">;
-    initialValue: T | null;
+    initialValue: T | null | undefined;
     readonly optionTpl: _angular_core.ModelSignal<_angular_core.Type<unknown> | _angular_core.TemplateRef<_lucca_front_ng_core_select.LuOptionContext<T>>>;
     readonly options: _angular_core.WritableSignal<_CoreSelectPanelElement<T>[]>;
     readonly pointerNavigation: _angular_core.Signal<boolean>;