@neural-ui/core 1.1.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neural-ui/core",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Modern Angular UI component library built with signals, standalone components, and OnPush change detection.",
   "author": "PedroMorenoTrujillo",
   "keywords": [

package/types/neural-ui-core.d.ts

@@ -323,6 +323,8 @@ interface NeuSelectOption {
     label: string;
     disabled?: boolean;
     group?: string;
+    /** Objeto de origen para adjuntar sin transformación (p.ej. entidad de la API). Accesible vía (selectionChange). */
+    data?: unknown;
 }
 interface NeuSelectGroup {
     label: string;
@@ -361,6 +363,8 @@ declare class NeuMultiselectItemDirective {
  */
 declare class NeuMultiselectComponent implements ControlValueAccessor {
     private readonly elementRef;
+    private readonly _urlState;
+    constructor();
     /** @internal */
     readonly _triggerId: string;
     /** Template personalizado para cada opción del dropdown */
@@ -389,6 +393,18 @@ declare class NeuMultiselectComponent implements ControlValueAccessor {
     clearable: _angular_core.InputSignal<boolean>;
     /** Aria-label del botón clear que aparece en el trigger */
     clearAriaLabel: _angular_core.InputSignal<string>;
+    /**
+     * Sincroniza los valores seleccionados con este query param de la URL.
+     * Los valores se codifican como lista separada por comas: `?{urlParam}=a,b,c`.
+     * Pasar `null` (default) deshabilita la sincronización.
+     */
+    urlParam: _angular_core.InputSignal<string | null>;
+    /**
+     * Emite el array de NeuSelectOption completo (incluyendo data) al cambiar la selección.
+     * Emite [] al limpiar toda la selección.
+     * Los valores de ngModel / formControl siguen siendo string[].
+     */
+    readonly selectionChange: _angular_core.OutputEmitterRef<NeuSelectOption[]>;
     protected readonly _values: _angular_core.WritableSignal<string[]>;
     readonly isOpen: _angular_core.WritableSignal<boolean>;
     readonly searchQuery: _angular_core.WritableSignal<string>;
@@ -418,7 +434,7 @@ declare class NeuMultiselectComponent implements ControlValueAccessor {
     protected toggleChipMode(event: MouseEvent): void;
     protected onDocumentClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuMultiselectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuMultiselectComponent, "neu-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "noResultsMessage": { "alias": "noResultsMessage"; "required": false; "isSignal": true; }; "clearAllLabel": { "alias": "clearAllLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; }, {}, ["itemTpl"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuMultiselectComponent, "neu-multiselect", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "noResultsMessage": { "alias": "noResultsMessage"; "required": false; "isSignal": true; }; "clearAllLabel": { "alias": "clearAllLabel"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["itemTpl"], never, true, never>;
 }
 
 /** Token para que neu-radio encuentre a su grupo padre */
@@ -520,6 +536,8 @@ declare class NeuSelectSelectedDirective {
  */
 declare class NeuSelectComponent implements ControlValueAccessor {
     private readonly elementRef;
+    private readonly _urlState;
+    constructor();
     /** @internal — ID \u00fanico para asociar label con trigger */
     readonly _triggerId: string;
     /** Template personalizado para cada opción del dropdown */
@@ -548,6 +566,18 @@ declare class NeuSelectComponent implements ControlValueAccessor {
     noResultsMessage: _angular_core.InputSignal<string>;
     /** Aria-label del botón de limpiar */
     clearAriaLabel: _angular_core.InputSignal<string>;
+    /**
+     * Sincroniza el valor seleccionado con este query param de la URL.
+     * Al seleccionar una opción se añade `?{urlParam}=value` a la URL.
+     * Pasar `null` (default) deshabilita la sincronización.
+     */
+    urlParam: _angular_core.InputSignal<string | null>;
+    /**
+     * Emite el objeto NeuSelectOption completo (incluyendo data) al seleccionar una opción.
+     * Emite null al limpiar la selección.
+     * El valor de ngModel / formControl sigue siendo string.
+     */
+    readonly selectionChange: _angular_core.OutputEmitterRef<NeuSelectOption | null>;
     protected readonly _value: _angular_core.WritableSignal<string | null>;
     readonly isOpen: _angular_core.WritableSignal<boolean>;
     readonly searchQuery: _angular_core.WritableSignal<string>;
@@ -573,7 +603,7 @@ declare class NeuSelectComponent implements ControlValueAccessor {
     selectOption(option: NeuSelectOption): void;
     onDocumentClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuSelectComponent, "neu-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "noResultsMessage": { "alias": "noResultsMessage"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; }, {}, ["itemTpl", "selectedItemTpl"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuSelectComponent, "neu-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "errorMessage": { "alias": "errorMessage"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "noResultsMessage": { "alias": "noResultsMessage"; "required": false; "isSignal": true; }; "clearAriaLabel": { "alias": "clearAriaLabel"; "required": false; "isSignal": true; }; "urlParam": { "alias": "urlParam"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; }, ["itemTpl", "selectedItemTpl"], never, true, never>;
 }
 
 /**