@neural-ui/core 1.2.0 → 1.3.0

package/styles/_tokens.scss

@@ -42,6 +42,8 @@
   --neu-text-muted: #64748b; // Slate-500
   --neu-text-disabled: #94a3b8; // Slate-400
   --neu-text-inverse: #ffffff;
+  --neu-knob-display-color: var(--neu-text);
+  --neu-knob-label-color: var(--neu-text-muted);
 
   --neu-font-sans: 'Inter', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
   --neu-font-mono: 'JetBrains Mono', 'Fira Code', 'Cascadia Code', monospace;
@@ -133,6 +135,17 @@
   --neu-shadow-lg: 0 10px 30px rgba(15, 23, 42, 0.1), 0 4px 8px rgba(15, 23, 42, 0.04);
   --neu-shadow-glow: 0 0 20px rgba(0, 122, 255, 0.2);
 
+  // ------------------------------------------------
+  // Focus ring — anillo de enfoque accesible
+  // Modern browsers (color-mix) auto-adapt on theme change.
+  // ------------------------------------------------
+  --neu-focus-ring: 0 0 0 3px rgba(0, 122, 255, 0.15);
+  --neu-focus-ring-strong: 0 0 0 3px rgba(0, 122, 255, 0.35);
+  @supports (color: color-mix(in srgb, red, blue)) {
+    --neu-focus-ring: 0 0 0 3px color-mix(in srgb, var(--neu-primary) 25%, transparent);
+    --neu-focus-ring-strong: 0 0 0 3px color-mix(in srgb, var(--neu-primary) 50%, transparent);
+  }
+
   // ------------------------------------------------
   // Iconos (Lucide via @ng-icons)
   // ------------------------------------------------
@@ -154,6 +167,152 @@
   --neu-toast-bg: var(--neu-surface);
   --neu-toast-radius: 10px;
   --neu-toast-shadow: 0 8px 24px rgba(15, 23, 42, 0.12), 0 2px 6px rgba(15, 23, 42, 0.06);
+
+  // ------------------------------------------------
+  // Tabla — density padding (v1.3.0)
+  // ------------------------------------------------
+  --neu-table-density-compact-padding: 0.375rem 0.625rem;
+  --neu-table-density-relaxed-padding: 1.125rem 1.25rem;
+
+  // ------------------------------------------------
+  // Alert (v1.3.0)
+  // ------------------------------------------------
+  --neu-alert-info-bg: var(--neu-info-bg);
+  --neu-alert-info-text: var(--neu-info-text);
+  --neu-alert-info-border: rgba(0, 122, 255, 0.2);
+
+  --neu-alert-success-bg: var(--neu-success-bg);
+  --neu-alert-success-text: var(--neu-success-text);
+  --neu-alert-success-border: rgba(16, 185, 129, 0.2);
+
+  --neu-alert-warning-bg: var(--neu-warning-bg);
+  --neu-alert-warning-text: var(--neu-warning-text);
+  --neu-alert-warning-border: rgba(245, 158, 11, 0.2);
+
+  --neu-alert-danger-bg: var(--neu-error-bg);
+  --neu-alert-danger-text: var(--neu-error-text);
+  --neu-alert-danger-border: rgba(239, 68, 68, 0.2);
+
+  // ------------------------------------------------
+  // Popover (v1.3.0)
+  // ------------------------------------------------
+  --neu-popover-bg: var(--neu-surface);
+  --neu-popover-border: var(--neu-border);
+  --neu-popover-shadow: var(--neu-shadow-lg);
+  --neu-popover-radius: var(--neu-radius-lg);
+
+  // ------------------------------------------------
+  // Context Menu (v1.3.0)
+  // ------------------------------------------------
+  --neu-context-menu-bg: var(--neu-surface);
+  --neu-context-menu-shadow: var(--neu-shadow-lg);
+  --neu-context-menu-hover: var(--neu-surface-2);
+  --neu-context-menu-radius: var(--neu-radius);
+
+  // ------------------------------------------------
+  // Meter Group (v1.3.0)
+  // ------------------------------------------------
+  --neu-meter-track-bg: var(--neu-surface-3);
+  --neu-meter-radius: var(--neu-radius-full);
+
+  // ------------------------------------------------
+  // Splitter (v1.3.0)
+  // ------------------------------------------------
+  --neu-splitter-handle-bg: var(--neu-surface-3);
+
+  // ------------------------------------------------
+  // Knob (v1.3.0)
+  // ------------------------------------------------
+  --neu-knob-track: var(--neu-surface-3);
+
+  // ------------------------------------------------
+  // Color Picker (v1.3.0)
+  // ------------------------------------------------
+  --neu-color-picker-bg: var(--neu-surface);
+  --neu-color-picker-shadow: var(--neu-shadow-lg);
+
+  // ------------------------------------------------
+  // Command Palette (v1.3.0)
+  // ------------------------------------------------
+  --neu-cmd-bg: var(--neu-surface);
+  --neu-cmd-highlight: var(--neu-primary-50);
+  --neu-cmd-shadow: var(--neu-shadow-lg);
+  --neu-cmd-radius: var(--neu-radius-xl);
+
+  // ------------------------------------------------
+  // Input OTP (v1.3.0)
+  // ------------------------------------------------
+  --neu-otp-cell-size: 2.75rem;
+  --neu-otp-cell-radius: var(--neu-radius);
+  --neu-otp-cell-border: var(--neu-border);
+  --neu-otp-cell-focus-border: var(--neu-primary);
+
+  // ------------------------------------------------
+  // Number Input (v1.3.0)
+  // ------------------------------------------------
+  --neu-number-input-btn-size: 2rem;
+
+  // ------------------------------------------------
+  // Block UI (v1.3.0)
+  // ------------------------------------------------
+  --neu-block-ui-bg: rgba(255, 255, 255, 0.6);
+  --neu-block-ui-radius: var(--neu-radius-lg);
+
+  // ------------------------------------------------
+  // Notification Center (v1.3.0)
+  // ------------------------------------------------
+  --neu-notification-unread-bg: rgba(0, 122, 255, 0.08);
+
+  // ------------------------------------------------
+  // Overlay / Backdrop — fondos semitransparentes de capas / semi-transparent layer backgrounds
+  // ------------------------------------------------
+  --neu-overlay-bg: rgba(15, 23, 42, 0.45);
+  --neu-overlay-bg-soft: rgba(15, 23, 42, 0.35);
+
+  // ------------------------------------------------
+  // Table — badge cell semantic colors / colores semánticos de celda badge
+  // ------------------------------------------------
+  --neu-table-badge-success-bg: rgba(16, 185, 129, 0.12);
+  --neu-table-badge-success-text: #059669;
+  --neu-table-badge-warning-bg: rgba(245, 158, 11, 0.12);
+  --neu-table-badge-warning-text: #d97706;
+  --neu-table-badge-danger-bg: rgba(239, 68, 68, 0.12);
+  --neu-table-badge-danger-text: #dc2626;
+
+  // ------------------------------------------------
+  // Alert — dismiss button hover / hover del botón de cierre
+  // ------------------------------------------------
+  --neu-alert-dismiss-hover-bg: rgb(0 0 0 / 8%);
+
+  // ------------------------------------------------
+  // Split Button — divider on primary variant / separador en variante primary
+  // ------------------------------------------------
+  --neu-split-button-primary-divider: rgba(255, 255, 255, 0.25);
+
+  // ------------------------------------------------
+  // Image Viewer — dark lightbox overlay (always dark) / overlay lightbox oscuro (siempre oscuro)
+  // ------------------------------------------------
+  --neu-image-viewer-bg: rgb(0 0 0 / 0.9);
+  --neu-image-viewer-muted: rgb(255 255 255 / 0.7);
+  --neu-image-viewer-btn-hover: rgb(255 255 255 / 0.15);
+  --neu-image-viewer-caption: rgb(255 255 255 / 0.65);
+  --neu-image-viewer-arrow-bg: rgb(255 255 255 / 0.12);
+  --neu-image-viewer-arrow-hover: rgb(255 255 255 / 0.25);
+
+  // ------------------------------------------------
+  // Code Block — Tokyo Night theme (always dark) / tema Tokyo Night (siempre oscuro)
+  // ------------------------------------------------
+  --neu-code-block-bg: #1a1b26;
+  --neu-code-block-bar-bg: #16161e;
+  --neu-code-block-border: rgba(255, 255, 255, 0.06);
+  --neu-code-block-text: #cdd6f4;
+  --neu-code-block-accent: #7aa2f7;
+  --neu-code-block-muted: #565f89;
+  --neu-code-block-copy-text: #a9b1d6;
+  --neu-code-block-copy-hover-text: #c0caf5;
+  --neu-code-block-copy-border: rgba(255, 255, 255, 0.1);
+  --neu-code-block-copy-hover-bg: rgba(255, 255, 255, 0.1);
+  --neu-code-block-copy-hover-border: rgba(255, 255, 255, 0.2);
 }
 
 // ============================================================
@@ -161,26 +320,28 @@
 // Activado con: document.documentElement.setAttribute('data-theme', 'dark')
 // ============================================================
 [data-theme='dark'] {
-  // ---- Brand (mantienen el mismo azul, se adaptan los fondos) ----
+  // ---- Brand (mismo azul / same blue, fondos adaptados / adapted backgrounds) ----
   --neu-primary-50: rgba(0, 122, 255, 0.12);
   --neu-primary-100: rgba(0, 122, 255, 0.2);
 
-  // ---- Fondos ----
+  // ---- Fondos / Backgrounds ----
   --neu-bg: #0d1117; // GitHub-dark inspired — fondo base
   --neu-surface: #161b22; // Tarjetas, paneles
   --neu-surface-2: #21262d; // Hover, fondos secundarios
   --neu-surface-3: #30363d; // Separadores, track de switch
 
-  // ---- Bordes ----
+  // ---- Bordes / Borders ----
   --neu-border: rgba(255, 255, 255, 0.08);
   --neu-border-hover: rgba(255, 255, 255, 0.16);
 
-  // ---- Texto ----
+  // ---- Texto / Text ----
   --neu-text: #e6edf3; // Casi blanco — texto principal
   --neu-text-muted: #8b949e; // Slate-400 equivalent — subtítulos
   --neu-text-disabled: #484f58; // Elementos deshabilitados
+  --neu-knob-display-color: #f8fafc;
+  --neu-knob-label-color: #8b949e;
 
-  // ---- Semánticos — fondos ajustados a dark ----
+  // ---- Semánticos — fondos ajustados a dark / Semantic — backgrounds adjusted for dark mode ----
   --neu-success-bg: rgba(16, 185, 129, 0.15);
   --neu-success-text: #6ee7b7;
 
@@ -193,18 +354,59 @@
   --neu-info-bg: rgba(0, 122, 255, 0.15);
   --neu-info-text: #93c5fd;
 
-  // ---- Sombras (desaparecen en dark, se usan bordes) ----
+  // ---- Sombras / Shadows (hidden in dark mode, borders used instead) ----
   --neu-shadow-xs: 0 1px 2px rgba(0, 0, 0, 0.4);
   --neu-shadow-sm: 0 1px 3px rgba(0, 0, 0, 0.4), 0 1px 2px rgba(0, 0, 0, 0.3);
   --neu-shadow: 0 4px 12px rgba(0, 0, 0, 0.4), 0 2px 4px rgba(0, 0, 0, 0.3);
   --neu-shadow-lg: 0 10px 30px rgba(0, 0, 0, 0.5), 0 4px 8px rgba(0, 0, 0, 0.3);
   --neu-shadow-glow: 0 0 20px rgba(0, 122, 255, 0.35);
 
-  // ---- Tooltip: fondo claro sobre dark para contraste ----
+  // ---- Tooltip: fondo claro sobre dark / light bg on dark for contrast ----
   --neu-tooltip-bg: #e6edf3;
   --neu-tooltip-fg: #0d1117;
   --neu-tooltip-shadow: 0 4px 12px rgba(0, 0, 0, 0.5);
 
   // ---- Toast ----
   --neu-toast-shadow: 0 8px 24px rgba(0, 0, 0, 0.5), 0 2px 6px rgba(0, 0, 0, 0.3);
+
+  // ---- Alert dark overrides (v1.3.0) ----
+  --neu-alert-info-bg: rgba(0, 122, 255, 0.15);
+  --neu-alert-info-text: #93c5fd;
+  --neu-alert-info-border: rgba(0, 122, 255, 0.3);
+
+  --neu-alert-success-bg: rgba(16, 185, 129, 0.15);
+  --neu-alert-success-text: #6ee7b7;
+  --neu-alert-success-border: rgba(16, 185, 129, 0.3);
+
+  --neu-alert-warning-bg: rgba(245, 158, 11, 0.15);
+  --neu-alert-warning-text: #fcd34d;
+  --neu-alert-warning-border: rgba(245, 158, 11, 0.3);
+
+  --neu-alert-danger-bg: rgba(239, 68, 68, 0.15);
+  --neu-alert-danger-text: #fca5a5;
+  --neu-alert-danger-border: rgba(239, 68, 68, 0.3);
+
+  // ---- Block UI dark override (v1.3.0) ----
+  --neu-block-ui-bg: rgba(13, 17, 23, 0.7);
+
+  // ---- Notification dark override (v1.3.0) ----
+  --neu-notification-unread-bg: rgba(0, 122, 255, 0.18);
+
+  // ---- Command Palette dark override (v1.3.0) ----
+  --neu-cmd-highlight: rgba(0, 122, 255, 0.15);
+
+  // ---- Overlay dark overrides / Overrides de overlay para modo oscuro ----
+  --neu-overlay-bg: rgba(0, 0, 0, 0.65);
+  --neu-overlay-bg-soft: rgba(0, 0, 0, 0.5);
+
+  // ---- Table badge dark overrides / Overrides de badge de tabla para modo oscuro ----
+  --neu-table-badge-success-bg: rgba(16, 185, 129, 0.18);
+  --neu-table-badge-success-text: #6ee7b7;
+  --neu-table-badge-warning-bg: rgba(245, 158, 11, 0.18);
+  --neu-table-badge-warning-text: #fcd34d;
+  --neu-table-badge-danger-bg: rgba(239, 68, 68, 0.18);
+  --neu-table-badge-danger-text: #fca5a5;
+
+  // ---- Alert dismiss dark override / Override de botón de cierre de alert en oscuro ----
+  --neu-alert-dismiss-hover-bg: rgb(255 255 255 / 12%);
 }

package/styles.scss

@@ -0,0 +1 @@
+@forward './styles/index';

package/switch/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-switch.mjs",
+  "typings": "../types/neural-ui-core-switch.d.ts"
+}

package/table/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-table.mjs",
+  "typings": "../types/neural-ui-core-table.d.ts"
+}

package/tabs/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-tabs.mjs",
+  "typings": "../types/neural-ui-core-tabs.d.ts"
+}

package/textarea/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-textarea.mjs",
+  "typings": "../types/neural-ui-core-textarea.d.ts"
+}

package/timeline/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-timeline.mjs",
+  "typings": "../types/neural-ui-core-timeline.d.ts"
+}

package/toast/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-toast.mjs",
+  "typings": "../types/neural-ui-core-toast.d.ts"
+}

package/toggle-button-group/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-toggle-button-group.mjs",
+  "typings": "../types/neural-ui-core-toggle-button-group.d.ts"
+}

package/toolbar/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-toolbar.mjs",
+  "typings": "../types/neural-ui-core-toolbar.d.ts"
+}

package/tooltip/package.json

@@ -0,0 +1,4 @@
+{
+  "module": "../fesm2022/neural-ui-core-tooltip.mjs",
+  "typings": "../types/neural-ui-core-tooltip.d.ts"
+}

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

@@ -0,0 +1,55 @@
+import * as _angular_core from '@angular/core';
+import { SafeHtml } from '@angular/platform-browser';
+
+interface NeuAccordionItem {
+    /** ID único del panel / Unique panel ID */
+    id: string;
+    /** Título del encabezado / Header title */
+    title: string;
+    /** Contenido del cuerpo (HTML o texto plano) / Body content (HTML or plain text) */
+    content: string;
+    /** Inicia expandido / Starts expanded */
+    expanded?: boolean;
+    /** Deshabilita este panel / Disables this panel */
+    disabled?: boolean;
+}
+/**
+ * NeuralUI Accordion Component
+ *
+ * Paneles expandibles / colapsables con animación suave.
+ * Soporta modo múltiple (varios abiertos a la vez) o exclusivo. / Supports multiple (several open at once) or exclusive mode.
+ *
+ * Uso:
+ *   <neu-accordion [items]="items" />
+ *   <neu-accordion [items]="items" [multiple]="true" />
+ */
+declare class NeuAccordionComponent {
+    private readonly _sanitizer;
+    /** Lista de paneles / Panel list */
+    items: _angular_core.InputSignal<NeuAccordionItem[]>;
+    /** Permite varios paneles abiertos a la vez / Allows multiple panels open at once */
+    multiple: _angular_core.InputSignal<boolean>;
+    /** Borde exterior alrededor del accordion / Outer border around the accordion */
+    bordered: _angular_core.InputSignal<boolean>;
+    /** Emite el id del panel al abrirse/cerrarse / Emits the panel id on open/close */
+    panelToggle: _angular_core.OutputEmitterRef<{
+        id: string;
+        expanded: boolean;
+    }>;
+    /**
+     * Set de IDs actualmente expandidos.
+     * Se inicializa desde los ítems con `expanded: true` en el primer render.
+     * Después se vuelve un signal mutable independiente (no se resetea al cambiar items).
+     */
+    private _expandedInit;
+    private readonly _expanded;
+    constructor();
+    readonly isExpanded: (id: string) => boolean;
+    sanitize(html: string): SafeHtml;
+    toggle(id: string): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuAccordionComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuAccordionComponent, "neu-accordion", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; }, { "panelToggle": "panelToggle"; }, never, never, true, never>;
+}
+
+export { NeuAccordionComponent };
+export type { NeuAccordionItem };

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

@@ -0,0 +1,47 @@
+import * as _angular_core from '@angular/core';
+
+type NeuAlertType = 'info' | 'success' | 'warning' | 'error';
+/**
+ * NeuralUI Alert Component
+ *
+ * Mensaje de alerta contextual con soporte de icono personalizado, slot de acciones y cierre.
+ *
+ * Uso: <neu-alert type="success">Operación completada</neu-alert>
+ *      <neu-alert type="error" [closable]="true" (closed)="onClosed()">Error de red</neu-alert>
+ */
+declare class NeuAlertComponent {
+    /** Tipo semántico / Semantic type */
+    readonly type: _angular_core.InputSignal<NeuAlertType>;
+    /** Título opcional sobre el mensaje / Optional title above message */
+    readonly title: _angular_core.InputSignal<string>;
+    /** Icono personalizado. Vacío = usa el icono por defecto del tipo / Custom icon. Empty = use default type icon */
+    readonly icon: _angular_core.InputSignal<string>;
+    /** Muestra el icono / Shows the icon */
+    readonly showIcon: _angular_core.InputSignal<boolean>;
+    /** Permite cerrarse / Can be dismissed */
+    readonly closable: _angular_core.InputSignal<boolean>;
+    /** Variante outline (sin fondo sólido) / Outline variant (no solid background) */
+    readonly outline: _angular_core.InputSignal<boolean>;
+    /** Aria-label para el botón de cierre / Aria-label for the close button */
+    readonly closeLabel: _angular_core.InputSignal<string>;
+    /** Emitido cuando se descarta la alerta / Emitted when the alert is dismissed */
+    readonly closed: _angular_core.OutputEmitterRef<void>;
+    readonly _id: string;
+    readonly _dismissed: _angular_core.WritableSignal<boolean>;
+    readonly _resolvedIcon: _angular_core.Signal<string>;
+    readonly liveRegion: _angular_core.Signal<"assertive" | "polite">;
+    readonly hostClasses: _angular_core.Signal<{
+        [x: string]: boolean;
+        'neu-alert': boolean;
+        'neu-alert--outline': boolean;
+        'neu-alert--closable': boolean;
+        'neu-alert--with-icon': boolean;
+        'neu-alert--dismissed': boolean;
+    }>;
+    dismiss(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuAlertComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuAlertComponent, "neu-alert", never, { "type": { "alias": "type"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "showIcon": { "alias": "showIcon"; "required": false; "isSignal": true; }; "closable": { "alias": "closable"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "closed": "closed"; }, never, ["*", "[neu-alert-actions]"], true, never>;
+}
+
+export { NeuAlertComponent };
+export type { NeuAlertType };

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

@@ -0,0 +1,69 @@
+import * as _angular_core from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+
+interface NeuAutocompleteOption {
+    /** Valor / Value */
+    value: unknown;
+    /** Texto visible / Display text */
+    label: string;
+    /** Desactiva la opción / Disables the option */
+    disabled?: boolean;
+}
+/**
+ * NeuralUI Autocomplete
+ *
+ * Input con lista de sugerencias filtradas y navegación por teclado.
+ * Implementa CVA para uso en formularios reactivos.
+ *
+ * Uso:
+ *   <neu-autocomplete
+ *     [options]="opts"
+ *     placeholder="Buscar…"
+ *     [formControl]="selectedCtrl"
+ *     (optionSelected)="onSelect($event)"
+ *   />
+ */
+declare class NeuAutocompleteComponent implements ControlValueAccessor {
+    readonly options: _angular_core.InputSignal<NeuAutocompleteOption[]>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string>;
+    readonly emptyLabel: _angular_core.InputSignal<string>;
+    readonly minLength: _angular_core.InputSignal<number>;
+    /** Muestra el label como flotante (true) o estático encima del campo (false) / Shows the label as floating (true) or static above the field (false) */
+    readonly floatingLabel: _angular_core.InputSignal<boolean>;
+    /** Tamaño del campo: 'sm' = 36px | 'md' = 48px | 'lg' = 56px / Field size */
+    readonly size: _angular_core.InputSignal<"sm" | "md" | "lg">;
+    /** Emitido al seleccionar una opción / Emitted when an option is selected */
+    readonly optionSelected: _angular_core.OutputEmitterRef<NeuAutocompleteOption>;
+    /** Emitido al cambiar el texto del input / Emitted on query change */
+    readonly queryChange: _angular_core.OutputEmitterRef<string>;
+    readonly _id: string;
+    readonly _listId: string;
+    readonly _query: _angular_core.WritableSignal<string>;
+    readonly _isOpen: _angular_core.WritableSignal<boolean>;
+    readonly _activeIndex: _angular_core.WritableSignal<number>;
+    readonly _cvaDisabled: _angular_core.WritableSignal<boolean>;
+    readonly _focused: _angular_core.WritableSignal<boolean>;
+    private _onChange;
+    private _onTouched;
+    readonly _filtered: _angular_core.Signal<NeuAutocompleteOption[]>;
+    readonly _activeId: _angular_core.Signal<string | null>;
+    _optionId(i: number): string;
+    private readonly _el;
+    onDocClick(e: MouseEvent): void;
+    onQueryChange(q: string): void;
+    _onFocus(): void;
+    _onBlur(): void;
+    onKeyDown(e: KeyboardEvent): void;
+    selectOption(opt: NeuAutocompleteOption): void;
+    clear(): void;
+    writeValue(val: unknown): void;
+    registerOnChange(fn: (v: unknown) => void): void;
+    registerOnTouched(fn: () => void): void;
+    setDisabledState(d: boolean): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuAutocompleteComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuAutocompleteComponent, "neu-autocomplete", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "emptyLabel": { "alias": "emptyLabel"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "floatingLabel": { "alias": "floatingLabel"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, { "optionSelected": "optionSelected"; "queryChange": "queryChange"; }, never, never, true, never>;
+}
+
+export { NeuAutocompleteComponent };
+export type { NeuAutocompleteOption };

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

@@ -0,0 +1,39 @@
+import * as _angular_core from '@angular/core';
+
+type NeuAvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+type NeuAvatarShape = 'circle' | 'square';
+type NeuAvatarColor = 'blue' | 'violet' | 'green' | 'amber' | 'red' | 'slate';
+type NeuAvatarStatus = 'online' | 'offline' | 'busy' | 'away' | '';
+/**
+ * NeuAvatar — Avatar circular o cuadrado para foto o iniciales.
+ *
+ * Uso:
+ *   <neu-avatar name="Pedro Moreno" />
+ *   <neu-avatar src="/assets/avatar.jpg" alt="Pedro" size="lg" />
+ *   <neu-avatar name="PM" size="lg" color="blue" status="online" />
+ */
+declare class NeuAvatarComponent {
+    /** URL de la imagen. Si falla la carga, muestra las iniciales. / Image URL. If loading fails, shows the initials. */
+    src: _angular_core.InputSignal<string>;
+    /** Texto alternativo de la imagen. / Image alternative text. */
+    alt: _angular_core.InputSignal<string>;
+    /** Nombre completo — se usan las iniciales como fallback. / Full name — initials are used as fallback. */
+    name: _angular_core.InputSignal<string>;
+    /** Tamaño: xs (24) | sm (32) | md (40) | lg (48) | xl (64). Por defecto 'md'. / Size: xs (24) | sm (32) | md (40) | lg (48) | xl (64). Default 'md'. */
+    size: _angular_core.InputSignal<NeuAvatarSize>;
+    /** Forma: 'circle' (default) o 'square'. / Shape: 'circle' (default) or 'square'. */
+    shape: _angular_core.InputSignal<NeuAvatarShape>;
+    /** Color de fondo para iniciales. / Background color for initials. */
+    color: _angular_core.InputSignal<NeuAvatarColor>;
+    /** Indicador de presencia. / Presence indicator. */
+    status: _angular_core.InputSignal<NeuAvatarStatus>;
+    /** @internal Imagen fallida / Failed image */
+    protected readonly imgError: _angular_core.WritableSignal<boolean>;
+    protected readonly initials: _angular_core.Signal<string>;
+    protected readonly hostClasses: _angular_core.Signal<string[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuAvatarComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuAvatarComponent, "neu-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "color": { "alias": "color"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NeuAvatarComponent };
+export type { NeuAvatarColor, NeuAvatarShape, NeuAvatarSize, NeuAvatarStatus };

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

@@ -0,0 +1,36 @@
+import * as _angular_core from '@angular/core';
+
+type NeuBadgeVariant = 'default' | 'success' | 'info' | 'warning' | 'danger';
+type NeuBadgeSize = 'sm' | 'md';
+/**
+ * NeuralUI Badge Component
+ *
+ * Etiqueta de estado compacta y semántica. / Compact and semantic status label.
+ *
+ * Uso: <neu-badge variant="success">Activo</neu-badge>
+ *      <neu-badge variant="danger" [dot]="true">Error</neu-badge>
+ */
+declare class NeuBadgeComponent {
+    /** Variante semántica / Semantic variant */
+    variant: _angular_core.InputSignal<NeuBadgeVariant>;
+    /** Tamaño / Size */
+    size: _angular_core.InputSignal<NeuBadgeSize>;
+    /** Muestra un punto de color a la izquierda / Shows a colored dot on the left */
+    dot: _angular_core.InputSignal<boolean>;
+    /** Estilo con solo borde (outline) sin relleno / Border-only style (outline) without fill */
+    outline: _angular_core.InputSignal<boolean>;
+    /** Estilo completamente redondeado (pill) / Fully rounded style (pill) */
+    pill: _angular_core.InputSignal<boolean>;
+    readonly hostClasses: _angular_core.Signal<{
+        [x: string]: boolean;
+        'neu-badge': boolean;
+        'neu-badge--outline': boolean;
+        'neu-badge--pill': boolean;
+        'neu-badge--dot': boolean;
+    }>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuBadgeComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuBadgeComponent, "neu-badge", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "dot": { "alias": "dot"; "required": false; "isSignal": true; }; "outline": { "alias": "outline"; "required": false; "isSignal": true; }; "pill": { "alias": "pill"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+
+export { NeuBadgeComponent };
+export type { NeuBadgeSize, NeuBadgeVariant };

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

@@ -0,0 +1,46 @@
+import * as _angular_core from '@angular/core';
+
+/**
+ * NeuralUI BlockUI Component
+ *
+ * Superposición que bloquea la interacción de un contenedor mientras está activa.
+ *
+ * Uso (componente):
+ *   <div style="position:relative">
+ *     <neu-block-ui [blocked]="isLoading" message="Cargando..." />
+ *     <form>...</form>
+ *   </div>
+ *
+ * Uso (directiva en el contenedor padre):
+ *   <div [neuBlockUI]="isLoading">
+ *     <form>...</form>
+ *   </div>
+ */
+declare class NeuBlockUIComponent {
+    /** Activa la superposición / Activates the overlay */
+    readonly blocked: _angular_core.InputSignal<boolean>;
+    /** Mensaje opcional bajo el spinner / Optional message below the spinner */
+    readonly message: _angular_core.InputSignal<string>;
+    /** Variante de opacidad del overlay */
+    readonly variant: _angular_core.InputSignal<"default" | "light" | "dark">;
+    readonly hostClasses: _angular_core.Signal<{
+        [x: string]: boolean;
+        'neu-block-ui': boolean;
+    }>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuBlockUIComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NeuBlockUIComponent, "neu-block-ui", never, { "blocked": { "alias": "blocked"; "required": false; "isSignal": true; }; "message": { "alias": "message"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Directive [neuBlockUI] — Aplica el efecto BlockUI al elemento host.
+ *
+ * Uso: <div [neuBlockUI]="loading$ | async">...</div>
+ */
+declare class NeuBlockUIDirective {
+    readonly neuBlockUI: _angular_core.InputSignal<boolean>;
+    private readonly _el;
+    constructor();
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NeuBlockUIDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NeuBlockUIDirective, "[neuBlockUI]", never, { "neuBlockUI": { "alias": "neuBlockUI"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { NeuBlockUIComponent, NeuBlockUIDirective };