@ng-cn/core 1.0.17 → 1.0.20

package/src/app/lib/components/ui/textarea/textarea.component.ts

@@ -1,31 +1,91 @@
 import { cn } from '@/lib/utils';
-import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+import {
+  AfterViewInit,
+  ChangeDetectionStrategy,
+  Component,
+  computed,
+  ElementRef,
+  forwardRef,
+  inject,
+  input,
+  signal,
+} from '@angular/core';
+import { ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
 
 /**
  * Textarea component that applies shadcn textarea styles.
+ * Implements ControlValueAccessor for Angular Forms integration.
+ * Applied as an attribute on a native <textarea> element.
  *
  * @example
  * <!-- Basic textarea -->
- * <Textarea placeholder="Enter your message"></Textarea>
- *
- * <!-- With rows -->
- * <Textarea rows="5" placeholder="Description"></Textarea>
+ * <textarea Textarea placeholder="Type your message here."></textarea>
  *
  * <!-- Disabled -->
- * <Textarea disabled placeholder="Disabled"></Textarea>
+ * <textarea Textarea disabled placeholder="Disabled"></textarea>
+ *
+ * <!-- Auto-resize -->
+ * <textarea Textarea [autoResize]="true" placeholder="Grows as you type..."></textarea>
+ *
+ * <!-- With reactive forms -->
+ * <textarea Textarea formControlName="message" placeholder="Enter message"></textarea>
  */
 @Component({
-  selector: 'Textarea',
-  template: `<ng-content />`,
+  selector: 'textarea[Textarea]',
+  template: '',
   host: {
     '[class]': 'computedClass()',
-    'data-slot': 'textarea',
+    '[disabled]': 'isDisabled()',
+    '[id]': 'id()',
+    '[name]': 'name()',
+    '[placeholder]': 'placeholder()',
+    '[rows]': 'rows()',
+    '[attr.data-slot]': '"textarea"',
+    '[attr.data-auto-resize]': 'autoResize() || null',
+    '[attr.aria-invalid]': 'ariaInvalid() || null',
+    '[attr.aria-describedby]': 'ariaDescribedBy() || null',
+    '(input)': 'onInput($event)',
+    '(blur)': 'onTouched()',
   },
+  providers: [
+    {
+      provide: NG_VALUE_ACCESSOR,
+      useExisting: forwardRef(() => Textarea),
+      multi: true,
+    },
+  ],
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
-export class Textarea {
+export class Textarea implements ControlValueAccessor, AfterViewInit {
+  /** Placeholder text */
+  readonly placeholder = input<string>('');
+  /** Textarea id attribute */
+  readonly id = input<string>('');
+  /** Textarea name attribute */
+  readonly name = input<string>('');
+  /** Number of visible text rows */
+  readonly rows = input<number>(3);
+  /** Whether the textarea is disabled */
+  readonly disabled = input(false, {
+    transform: (value: boolean | string) => value === '' || value === true || value === 'true',
+  });
+  /** Aria-invalid state for error display */
+  readonly ariaInvalid = input<boolean | undefined>(undefined, { alias: 'aria-invalid' });
+  /** Aria-describedby for accessibility */
+  readonly ariaDescribedBy = input<string | undefined>(undefined, { alias: 'aria-describedby' });
   /** Additional CSS classes to apply */
   readonly class = input<string>('');
+  /** When true, the textarea height adjusts automatically as the user types */
+  readonly autoResize = input<boolean>(false);
+
+  private readonly _elementRef = inject(ElementRef<HTMLTextAreaElement>);
+
+  /** Internal disabled state (set by ControlValueAccessor) */
+  protected readonly isDisabled = signal<boolean>(false);
+
+  /** ControlValueAccessor callbacks */
+  private onChange: (value: string) => void = () => {};
+  protected onTouched: () => void = () => {};
 
   /** Computed class combining base styles and custom classes */
   protected readonly computedClass = computed(() =>
@@ -33,7 +93,47 @@ export class Textarea {
       'placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm',
       'focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]',
       'aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive',
+      'resize-none data-[auto-resize=true]:resize-none',
       this.class(),
     ),
   );
+
+  ngAfterViewInit(): void {
+    // Ensure element is available after hydration
+  }
+
+  // ControlValueAccessor implementation
+  writeValue(value: string): void {
+    const el = this._elementRef.nativeElement;
+    el.value = value ?? '';
+    if (this.autoResize()) {
+      el.style.height = 'auto';
+      el.style.height = el.scrollHeight + 'px';
+    }
+  }
+  registerOnChange(fn: (value: string) => void): void {
+    this.onChange = fn;
+  }
+  registerOnTouched(fn: () => void): void {
+    this.onTouched = fn;
+  }
+  setDisabledState(isDisabled: boolean): void {
+    this.isDisabled.set(isDisabled);
+  }
+
+  /** Focus the textarea element */
+  focus(): void {
+    this._elementRef.nativeElement.focus();
+  }
+
+  /** Handle input events */
+  protected onInput(event: Event): void {
+    const target = event.target as HTMLTextAreaElement;
+    this.onChange(target.value);
+    if (this.autoResize()) {
+      const el = this._elementRef.nativeElement;
+      el.style.height = 'auto';
+      el.style.height = el.scrollHeight + 'px';
+    }
+  }
 }

package/src/app/lib/components/ui/toast/toast.service.ts

@@ -178,7 +178,7 @@ export class ToastService {
     this._toasts.update((toasts) => [...toasts, newToast]);
 
     const duration = toast.duration ?? 4000;
-    if (duration > 0) {
+    if (duration > 0 && typeof window !== 'undefined') {
       setTimeout(() => this.dismiss(id), duration);
     }
 

package/src/app/lib/components/ui/toggle/toggle.component.ts

@@ -7,6 +7,7 @@ import {
   input,
   model,
   output,
+  signal,
 } from '@angular/core';
 import { ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';
 import { toggleVariants, type ToggleVariants } from './toggle-variants';
@@ -97,8 +98,8 @@ export type ToggleProps = {
     type: 'button',
     '[attr.aria-pressed]': 'pressed()',
     '[attr.data-state]': 'state()',
-    '[attr.data-disabled]': 'disabled() ? "" : null',
-    '[attr.disabled]': 'disabled() ? "" : null',
+    '[attr.data-disabled]': 'isDisabled() ? "" : null',
+    '[attr.disabled]': 'isDisabled() ? "" : null',
     '(click)': 'toggle()',
     'data-slot': 'toggle',
   },
@@ -136,6 +137,9 @@ export class Toggle implements ControlValueAccessor {
   /** Additional CSS classes to apply */
   readonly class = input<string>('');
 
+  /** Whether the toggle is effectively disabled (input or Angular Forms) */
+  protected readonly isDisabled = computed(() => this.disabled() || this.isFormsDisabled());
+
   /** Current state for data attribute */
   protected readonly state = computed((): ToggleState => (this.pressed() ? 'on' : 'off'));
   /** Computed class combining variants and custom classes */
@@ -149,17 +153,19 @@ export class Toggle implements ControlValueAccessor {
     ),
   );
 
+  /** Tracks disabled state set by Angular Forms (.disable() / .enable()) */
+  private readonly isFormsDisabled = signal<boolean>(false);
+
   /** ControlValueAccessor callbacks */
   private onChange: (value: boolean) => void = () => {};
   private onTouched: () => void = () => {};
-  setDisabledState?(isDisabled: boolean): void {
-    // Disabled state is managed by the disabled input
-    // Angular forms will call this but we use the input binding
+  setDisabledState(isDisabled: boolean): void {
+    this.isFormsDisabled.set(isDisabled);
   }
 
   /** Toggle the pressed state */
   toggle(): void {
-    if (!this.disabled()) {
+    if (!this.isDisabled()) {
       const newValue = !this.pressed();
       this.pressed.set(newValue);
       this.onChange(newValue);

package/src/app/lib/components/ui/tooltip/tooltip-content.component.ts

@@ -1,5 +1,16 @@
-import { cn, Presence } from '@/lib/utils';
-import { ChangeDetectionStrategy, Component, computed, inject, input } from '@angular/core';
+import { Align, cn, computePosition, getTransformOrigin, Presence, Side } from '@/lib/utils';
+import {
+  afterNextRender,
+  ChangeDetectionStrategy,
+  Component,
+  computed,
+  effect,
+  ElementRef,
+  inject,
+  Injector,
+  input,
+  signal,
+} from '@angular/core';
 import { TOOLTIP_CONTEXT, TooltipAlign, TooltipSide } from './tooltip-context';
 
 export type TooltipContentState = 'open' | 'closed';
@@ -34,7 +45,8 @@ export interface TooltipContentProps {
  *
  * @description
  * TooltipContent displays the actual tooltip content. It supports positioning
- * on different sides and alignments relative to the trigger.
+ * on different sides and alignments relative to the trigger using fixed positioning
+ * via computePosition to avoid clipping inside overflow:hidden ancestors.
  *
  * ## Features
  * - Configurable side (top, right, bottom, left)
@@ -42,10 +54,14 @@ export interface TooltipContentProps {
  * - Customizable offset from trigger
  * - Smooth enter/exit animations
  * - Uses Presence for proper exit animations
+ * - Fixed positioning — not clipped by overflow:hidden ancestors
+ * - Escape key to dismiss
+ * - disableHoverableContent support
  *
  * ## Accessibility
  * - `role="tooltip"` on the element
  * - Unique ID for aria-describedby relationship with trigger
+ * - Escape key dismisses tooltip (WCAG 1.4.13)
  *
  * @example Basic usage
  * ```html
@@ -81,10 +97,12 @@ export interface TooltipContentProps {
       <div
         [class]="computedClass()"
         [attr.data-state]="state()"
-        [attr.data-side]="side()"
-        [attr.data-align]="align()"
+        [attr.data-side]="computedSide()"
+        [attr.data-align]="computedAlign()"
+        [style]="positionStyles()"
         role="tooltip"
         [id]="context.tooltipId"
+        (mouseenter)="onMouseEnter()"
       >
         <ng-content />
       </div>
@@ -93,10 +111,35 @@ export interface TooltipContentProps {
   host: {
     'attr.data-slot': '"tooltip-content"',
     class: 'contents',
+    '(document:keydown.escape)': 'onEscape()',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
 export class TooltipContent {
+  constructor() {
+    // Recalculate position when open state changes (browser-only via afterNextRender)
+    effect(() => {
+      const isOpen = this.context.open();
+      if (isOpen) {
+        this.isPositioned.set(false);
+        afterNextRender(
+          () => {
+            this.schedulePositionUpdate();
+          },
+          { injector: this._injector },
+        );
+      } else {
+        this.cancelScheduledPositionUpdate();
+        this.isPositioned.set(false);
+        this.positionStyles.set({
+          position: 'fixed',
+          top: '-9999px',
+          left: '-9999px',
+        });
+      }
+    });
+  }
+
   /** The preferred side of the trigger to render against */
   readonly side = input<TooltipSide>('top');
   /** The distance in pixels from the trigger */
@@ -108,29 +151,110 @@ export class TooltipContent {
   /** Additional CSS classes */
   readonly class = input<string>('');
 
+  private readonly _elementRef = inject(ElementRef);
+  private readonly _injector = inject(Injector);
+
   protected readonly context = inject(TOOLTIP_CONTEXT);
 
+  protected readonly isPositioned = signal(false);
+  /** Computed position after collision detection */
+  protected readonly computedSide = signal<Side>('top');
+  protected readonly computedAlign = signal<Align>('center');
+  protected readonly positionStyles = signal<Record<string, string>>({
+    position: 'fixed',
+    top: '-9999px',
+    left: '-9999px',
+  });
+
+  private positionFrameId: number | null = null;
+
   /** Current state: open or closed */
   protected readonly state = computed<TooltipContentState>(() =>
     this.context.open() ? 'open' : 'closed',
   );
-  protected readonly computedClass = computed(() => {
-    const sideClasses = {
-      top: 'bottom-full left-1/2 -translate-x-1/2 mb-2',
-      bottom: 'top-full left-1/2 -translate-x-1/2 mt-2',
-      left: 'right-full top-1/2 -translate-y-1/2 mr-2',
-      right: 'left-full top-1/2 -translate-y-1/2 ml-2',
-    };
-
-    return cn(
-      'absolute z-50 overflow-hidden rounded-md border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md',
+
+  protected readonly computedClass = computed(() =>
+    cn(
+      'z-50 overflow-hidden rounded-md border bg-popover px-3 py-1.5 text-sm text-popover-foreground shadow-md',
       'data-[state=open]:animate-in data-[state=closed]:animate-out',
       'data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',
       'data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',
       'data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2',
       'data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
-      sideClasses[this.side()],
+      !this.isPositioned() && 'opacity-0 pointer-events-none',
       this.class(),
+    ),
+  );
+
+  onMouseEnter(): void {
+    if (this.context.disableHoverableContent?.()) {
+      this.context.setOpen(false);
+    }
+  }
+
+  protected onEscape(): void {
+    if (this.context.open()) {
+      this.context.setOpen(false);
+    }
+  }
+
+  private schedulePositionUpdate(): void {
+    this.cancelScheduledPositionUpdate();
+
+    this.positionFrameId = requestAnimationFrame(() => {
+      this.updatePosition();
+
+      this.positionFrameId = requestAnimationFrame(() => {
+        this.updatePosition();
+        this.positionFrameId = null;
+      });
+    });
+  }
+
+  private cancelScheduledPositionUpdate(): void {
+    if (this.positionFrameId !== null) {
+      cancelAnimationFrame(this.positionFrameId);
+      this.positionFrameId = null;
+    }
+  }
+
+  private updatePosition(): void {
+    const triggerElement = this.context.triggerRef?.();
+    const contentElement = this._elementRef.nativeElement.querySelector(
+      '[role="tooltip"]',
+    ) as HTMLElement;
+
+    if (!triggerElement || !contentElement) return;
+
+    const triggerRect = triggerElement.getBoundingClientRect();
+    const contentRect = contentElement.getBoundingClientRect();
+    const overlayWidth = Math.round(contentRect.width || 100);
+    const overlayHeight = Math.round(contentRect.height || 32);
+
+    const result = computePosition(
+      triggerRect,
+      { width: overlayWidth, height: overlayHeight },
+      {
+        side: this.side() as Side,
+        align: this.align() as Align,
+        sideOffset: this.sideOffset(),
+        alignOffset: this.alignOffset(),
+        avoidCollisions: true,
+        collisionPadding: 8,
+      },
     );
-  });
+
+    this.computedSide.set(result.side);
+    this.computedAlign.set(result.align);
+
+    // Set position styles with transform origin for animations
+    const transformOrigin = getTransformOrigin(result.side, result.align);
+    this.positionStyles.set({
+      position: 'fixed',
+      top: result.styles.top || '',
+      left: result.styles.left || '',
+      '--radix-tooltip-content-transform-origin': transformOrigin,
+    });
+    this.isPositioned.set(true);
+  }
 }

package/src/app/lib/components/ui/tooltip/tooltip-context.ts

@@ -9,13 +9,15 @@ export interface TooltipContextValue {
   /** Set open state */
   setOpen: (open: boolean) => void;
   /** Delay before showing tooltip (ms) */
-  delayDuration: number;
+  delayDuration: () => number;
   /** Skip delay duration when quickly hovering between tooltips (ms) */
   skipDelayDuration: number;
   /** Unique ID for aria-describedby relationship */
   tooltipId: string;
   /** Whether hoverable content is disabled */
   disableHoverableContent: () => boolean;
+  /** Reference to the trigger element for fixed positioning */
+  triggerRef?: WritableSignal<HTMLElement | null>;
 }
 
 export const TOOLTIP_CONTEXT = new InjectionToken<TooltipContextValue>('TOOLTIP_CONTEXT');

package/src/app/lib/components/ui/tooltip/tooltip-provider.component.ts

@@ -73,7 +73,7 @@ export class TooltipProvider implements TooltipContextValue {
   /** Unique ID for aria-describedby relationship */
   readonly tooltipId = `tooltip-provider-${++tooltipIdCounter}`;
   /** The duration from when the pointer enters the trigger until the tooltip opens */
-  readonly delayDuration = 700;
+  readonly delayDuration = input<number>(700);
   /** How much time a user has to enter another trigger without incurring a delay again */
   readonly skipDelayDuration = 300;
 

package/src/app/lib/components/ui/tooltip/tooltip-trigger.component.ts

@@ -1,4 +1,4 @@
-import { ChangeDetectionStrategy, Component, inject, input, OnDestroy } from '@angular/core';
+import { ChangeDetectionStrategy, Component, ElementRef, inject, input, OnDestroy } from '@angular/core';
 import { TOOLTIP_CONTEXT } from './tooltip-context';
 
 /**
@@ -70,6 +70,7 @@ export class TooltipTrigger implements OnDestroy {
   readonly asChild = input<boolean>(false);
 
   protected readonly context = inject(TOOLTIP_CONTEXT);
+  private readonly _elementRef = inject(ElementRef);
 
   private showTimeout: ReturnType<typeof setTimeout> | null = null;
   private hideTimeout: ReturnType<typeof setTimeout> | null = null;
@@ -80,9 +81,10 @@ export class TooltipTrigger implements OnDestroy {
 
   onMouseEnter(): void {
     this.clearTimeouts();
+    this.context.triggerRef?.set(this._elementRef.nativeElement);
     this.showTimeout = setTimeout(() => {
       this.context.setOpen(true);
-    }, this.context.delayDuration);
+    }, this.context.delayDuration());
   }
   onMouseLeave(): void {
     this.clearTimeouts();
@@ -93,6 +95,7 @@ export class TooltipTrigger implements OnDestroy {
   }
   onFocus(): void {
     // Show immediately on focus for keyboard users
+    this.context.triggerRef?.set(this._elementRef.nativeElement);
     this.context.setOpen(true);
   }
   onBlur(): void {

package/src/app/lib/components/ui/tooltip/tooltip.component.ts

@@ -126,9 +126,11 @@ export class Tooltip implements TooltipContextValue {
   readonly disableHoverableContent = input<boolean>(false);
 
   readonly open = signal(false);
+  /** Reference to the trigger element for fixed positioning */
+  readonly triggerRef = signal<HTMLElement | null>(null);
 
   /** The duration from when the pointer enters the trigger until the tooltip opens */
-  readonly delayDuration = 700;
+  readonly delayDuration = input<number>(700);
   /** How much time a user has to enter another trigger without incurring a delay again */
   readonly skipDelayDuration = 300;
   /** Unique ID for aria-describedby relationship */