@ng-cn/core 1.0.17 → 1.0.20

package/src/app/lib/components/ui/field/field-title.component.ts

@@ -0,0 +1,30 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+
+/**
+ * FieldTitle component - title text inside FieldContent.
+ *
+ * @example
+ * <FieldContent>
+ *   <FieldTitle>Two-factor authentication</FieldTitle>
+ *   <FieldDescription>Add an extra layer of security.</FieldDescription>
+ * </FieldContent>
+ */
+@Component({
+  selector: 'FieldTitle',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"field-title"',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class FieldTitle {
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn('flex w-fit items-center gap-2 text-sm leading-snug font-medium', this.class()),
+  );
+}

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

@@ -0,0 +1,66 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+import { cva, type VariantProps } from 'class-variance-authority';
+
+/**
+ * Field variants using class-variance-authority.
+ * Matches shadcn/ui React field exactly.
+ */
+export const fieldVariants = cva('group/field flex w-full gap-3 data-[invalid=true]:text-destructive', {
+  variants: {
+    orientation: {
+      vertical: 'flex-col [&>*]:w-full [&>.sr-only]:w-auto',
+      horizontal: 'flex-row items-center [&>[data-slot=field-label]]:flex-auto',
+      responsive:
+        'flex-col [&>*]:w-full @md/field-group:flex-row @md/field-group:items-center @md/field-group:[&>*]:w-auto',
+    },
+  },
+  defaultVariants: {
+    orientation: 'vertical',
+  },
+});
+
+export type FieldVariants = VariantProps<typeof fieldVariants>;
+export type FieldOrientation = 'vertical' | 'horizontal' | 'responsive';
+
+/**
+ * Field component - wraps a single form field with its label,
+ * control, description and error message.
+ *
+ * @example
+ * <!-- Vertical (default) -->
+ * <Field>
+ *   <FieldLabel htmlFor="email">Email</FieldLabel>
+ *   <input Input id="email" type="email" />
+ *   <FieldDescription>We never share your email.</FieldDescription>
+ * </Field>
+ *
+ * <!-- Horizontal -->
+ * <Field orientation="horizontal">
+ *   <FieldLabel htmlFor="newsletter">Subscribe to newsletter</FieldLabel>
+ *   <Switch id="newsletter" />
+ * </Field>
+ */
+@Component({
+  selector: 'Field',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"field"',
+    role: 'group',
+    '[attr.data-orientation]': 'orientation()',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class Field {
+  /** Layout orientation of the field */
+  readonly orientation = input<FieldOrientation>('vertical');
+
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles, variants and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn(fieldVariants({ orientation: this.orientation() }), this.class()),
+  );
+}

package/src/app/lib/components/ui/field/index.ts

@@ -0,0 +1,15 @@
+export { FieldContent } from './field-content.component';
+export { FieldDescription } from './field-description.component';
+export { FieldError } from './field-error.component';
+export { FieldGroup } from './field-group.component';
+export { FieldLabel } from './field-label.component';
+export { FieldLegend, type FieldLegendVariant } from './field-legend.component';
+export { FieldSeparator } from './field-separator.component';
+export { FieldSet } from './field-set.component';
+export { FieldTitle } from './field-title.component';
+export {
+  Field,
+  fieldVariants,
+  type FieldOrientation,
+  type FieldVariants,
+} from './field.component';

package/src/app/lib/components/ui/form/form-description.component.ts

@@ -14,7 +14,7 @@ import { FORM_FIELD_CONTEXT } from './form-context';
   host: {
     '[class]': 'computedClass()',
     '[attr.id]': 'fieldContext?.formDescriptionId()',
-    'data-slot': 'form-description',
+    'attr.data-slot': '"form-description"',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
@@ -26,6 +26,6 @@ export class FormDescription {
 
   /** Computed class combining base styles and custom classes */
   protected readonly computedClass = computed(() =>
-    cn('text-muted-foreground text-[0.8rem]', this.class()),
+    cn('text-muted-foreground text-[length:var(--font-size-description)]', this.class()),
   );
 }

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

@@ -1,12 +1,16 @@
-import { cn, Presence } from '@/lib/utils';
+import { Align, cn, computePosition, getTransformOrigin, Presence, Side } from '@/lib/utils';
 import {
+  afterNextRender,
   ChangeDetectionStrategy,
   Component,
   computed,
+  effect,
   ElementRef,
   inject,
+  Injector,
   input,
   OnDestroy,
+  signal,
 } from '@angular/core';
 import { HOVER_CARD_CONTEXT, HoverCardAlign, HoverCardSide } from './hover-card-context';
 
@@ -38,31 +42,6 @@ export interface HoverCardContentProps {
  * HoverCardContent displays the preview content. It stays open when
  * hovered, allowing users to interact with the content.
  *
- * ## Features
- * - Stays open when content is hovered
- * - Configurable side and alignment
- * - Smooth animations
- * - Escape key to dismiss
- *
- * ## Accessibility
- * - `role="dialog"` on the content
- * - Focusable content items
- * - Escape returns focus to trigger
- *
- * @example Basic usage
- * ```html
- * <HoverCardContent>
- *   <p>Preview content</p>
- * </HoverCardContent>
- * ```
- *
- * @example With positioning
- * ```html
- * <HoverCardContent side="right" align="start">
- *   <p>Right-aligned content</p>
- * </HoverCardContent>
- * ```
- *
  * @data-attributes
  * - `data-state` - 'open' | 'closed'
  * - `data-side` - 'top' | 'right' | 'bottom' | 'left'
@@ -78,9 +57,10 @@ export interface HoverCardContentProps {
         [attr.aria-modal]="false"
         tabindex="-1"
         [class]="computedClass()"
+        [style]="positionStyles()"
         [attr.data-state]="state()"
-        [attr.data-side]="side()"
-        [attr.data-align]="align()"
+        [attr.data-side]="computedSide()"
+        [attr.data-align]="computedAlign()"
         data-slot="hover-card-content"
         (mouseenter)="onMouseEnter()"
         (mouseleave)="onMouseLeave()"
@@ -99,6 +79,25 @@ export interface HoverCardContentProps {
   changeDetection: ChangeDetectionStrategy.OnPush,
 })
 export class HoverCardContent implements OnDestroy {
+  constructor() {
+    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<HoverCardSide>('bottom');
   /** The distance in pixels from the trigger */
@@ -109,80 +108,129 @@ export class HoverCardContent implements OnDestroy {
   readonly class = input<string>('');
 
   private readonly _elementRef = inject(ElementRef<HTMLElement>);
+  private readonly _injector = inject(Injector);
 
   protected readonly context = inject(HOVER_CARD_CONTEXT);
 
-  protected readonly computedClass = computed(() => {
-    const sideClasses = {
-      top: 'bottom-full mb-2',
-      bottom: 'top-full mt-2',
-      left: 'right-full mr-2',
-      right: 'left-full ml-2',
-    };
-
-    const alignClasses = {
-      start: 'left-0',
-      center: 'left-1/2 -translate-x-1/2',
-      end: 'right-0',
-    };
-
-    return cn(
-      'absolute z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none',
+  protected readonly computedClass = computed(() =>
+    cn(
+      'fixed z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none',
       '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.side() === 'top' || this.side() === 'bottom' ? alignClasses[this.align()] : '',
+      !this.isPositioned() && 'pointer-events-none opacity-0',
       this.class(),
-    );
+    ),
+  );
+
+  protected readonly positionStyles = signal<Record<string, string>>({
+    position: 'fixed',
+    top: '-9999px',
+    left: '-9999px',
   });
+  protected readonly isPositioned = signal(false);
+  protected readonly computedSide = signal<Side>('bottom');
+  protected readonly computedAlign = signal<Align>('center');
 
-  private closeTimeout: ReturnType<typeof setTimeout> | null = null;
   /** Current state: open or closed */
   protected readonly state = computed<HoverCardContentState>(() =>
     this.context.open() ? 'open' : 'closed',
   );
 
+  private closeTimeout: ReturnType<typeof setTimeout> | null = null;
+  private positionFrameId: number | null = null;
+
   ngOnDestroy(): void {
-    this.clearTimeout();
+    this.clearCloseTimeout();
+    this.cancelScheduledPositionUpdate();
   }
 
   onMouseEnter(): void {
-    this.clearTimeout();
+    this.clearCloseTimeout();
   }
   onMouseLeave(): void {
     this.closeTimeout = setTimeout(() => {
       this.context.setOpen(false);
-    }, this.context.closeDelay);
+    }, this.context.closeDelay());
   }
   onFocusIn(): void {
-    this.clearTimeout();
+    this.clearCloseTimeout();
   }
   onFocusOut(event: FocusEvent): void {
     const relatedTarget = event.relatedTarget as HTMLElement | null;
-    const trigger = this._elementRef.nativeElement.parentElement?.querySelector('[data-state]');
+    const trigger = this.context.triggerRef();
 
-    // Check if focus moved to trigger or stayed within content
     if (relatedTarget && (trigger === relatedTarget || trigger?.contains(relatedTarget))) {
       return;
     }
 
     this.closeTimeout = setTimeout(() => {
       this.context.setOpen(false);
-    }, this.context.closeDelay);
+    }, this.context.closeDelay());
   }
   onEscape(): void {
     this.context.setOpen(false);
-    // Return focus to trigger
-    const trigger = this._elementRef.nativeElement.parentElement?.querySelector(
-      '[data-state]',
+    this.context.triggerRef()?.focus();
+  }
+
+  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="dialog"]',
     ) as HTMLElement;
-    trigger?.focus();
+
+    if (!triggerElement || !contentElement) return;
+
+    const triggerRect = triggerElement.getBoundingClientRect();
+    const contentRect = contentElement.getBoundingClientRect();
+    const overlayWidth = Math.round(contentRect.width || 256);
+    const overlayHeight = Math.round(contentRect.height || 100);
+
+    const result = computePosition(
+      triggerRect,
+      { width: overlayWidth, height: overlayHeight },
+      {
+        side: this.side(),
+        align: this.align(),
+        sideOffset: this.sideOffset(),
+        alignOffset: 0,
+        avoidCollisions: true,
+        collisionPadding: 8,
+      },
+    );
+
+    this.computedSide.set(result.side);
+    this.computedAlign.set(result.align);
+
+    const transformOrigin = getTransformOrigin(result.side, result.align);
+    this.positionStyles.set({
+      position: 'fixed',
+      top: result.styles.top || '',
+      left: result.styles.left || '',
+      '--radix-hover-card-content-transform-origin': transformOrigin,
+    });
+    this.isPositioned.set(true);
   }
 
-  private clearTimeout(): void {
+  private clearCloseTimeout(): void {
     if (this.closeTimeout) {
       clearTimeout(this.closeTimeout);
       this.closeTimeout = null;

package/src/app/lib/components/ui/hover-card/hover-card-context.ts

@@ -9,9 +9,11 @@ export interface HoverCardContextValue {
   /** Set open state */
   setOpen: (open: boolean) => void;
   /** The duration from when the pointer enters the trigger until the hover card opens (ms) */
-  openDelay: number;
+  openDelay: () => number;
   /** The duration from when the pointer leaves the trigger/content until the hover card closes (ms) */
-  closeDelay: number;
+  closeDelay: () => number;
+  /** Reference to the trigger element for fixed positioning */
+  triggerRef: WritableSignal<HTMLElement | null>;
 }
 
 export const HOVER_CARD_CONTEXT = new InjectionToken<HoverCardContextValue>('HOVER_CARD_CONTEXT');

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

@@ -96,18 +96,20 @@ export class HoverCardTrigger implements OnDestroy {
   }
 
   onMouseEnter(): void {
+    this.context.triggerRef.set(this._elementRef.nativeElement);
     this.clearTimeouts();
     this.openTimeout = setTimeout(() => {
       this.context.setOpen(true);
-    }, this.context.openDelay);
+    }, this.context.openDelay());
   }
   onMouseLeave(): void {
     this.clearTimeouts();
     this.closeTimeout = setTimeout(() => {
       this.context.setOpen(false);
-    }, this.context.closeDelay);
+    }, this.context.closeDelay());
   }
   onFocus(): void {
+    this.context.triggerRef.set(this._elementRef.nativeElement);
     this.clearTimeouts();
     // Open immediately on focus for keyboard users
     this.context.setOpen(true);
@@ -127,7 +129,7 @@ export class HoverCardTrigger implements OnDestroy {
     this.clearTimeouts();
     this.closeTimeout = setTimeout(() => {
       this.context.setOpen(false);
-    }, this.context.closeDelay);
+    }, this.context.closeDelay());
   }
   onKeyDown(event: Event): void {
     event.preventDefault();

package/src/app/lib/components/ui/hover-card/hover-card.component.ts

@@ -5,6 +5,8 @@ import {
   input,
   output,
   signal,
+  Signal,
+  WritableSignal,
 } from '@angular/core';
 import { HOVER_CARD_CONTEXT, type HoverCardContextValue } from './hover-card-context';
 
@@ -93,7 +95,7 @@ export interface HoverCardProps {
   template: `<ng-content />`,
   host: {
     'attr.data-slot': '"hover-card"',
-    class: 'relative inline-block',
+    class: 'inline-block',
   },
   providers: [
     {
@@ -120,10 +122,13 @@ export class HoverCard implements HoverCardContextValue {
 
   readonly open = signal(false);
 
+  /** Reference to the trigger element for fixed positioning */
+  readonly triggerRef: WritableSignal<HTMLElement | null> = signal<HTMLElement | null>(null);
+
   /** The duration from when the pointer enters the trigger until the hover card opens (ms) */
-  readonly openDelay = 700;
+  readonly openDelay = input<number>(700);
   /** The duration from when the pointer leaves the trigger/content until the hover card closes (ms) */
-  readonly closeDelay = 300;
+  readonly closeDelay = input<number>(300);
 
   setOpen(open: boolean): void {
     if (this.controlledOpen() === undefined) {

package/src/app/lib/components/ui/input-group/input-group-addon.component.ts

@@ -14,6 +14,7 @@ import { ChangeDetectionStrategy, Component, computed, input } from '@angular/co
   selector: 'InputGroupAddon',
   template: `<ng-content />`,
   host: {
+    'attr.data-slot': '"input-group-addon"',
     '[class]': 'computedClass()',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,

package/src/app/lib/components/ui/input-group/input-group-input.component.ts

@@ -10,6 +10,7 @@ import { ChangeDetectionStrategy, Component, computed, input } from '@angular/co
   selector: 'InputGroupInput',
   template: ``,
   host: {
+    'attr.data-slot': '"input-group-input"',
     '[class]': 'computedClass()',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,

package/src/app/lib/components/ui/input-group/input-group.component.ts

@@ -30,6 +30,7 @@ import { ChangeDetectionStrategy, Component, computed, input } from '@angular/co
   selector: 'InputGroup',
   template: `<ng-content />`,
   host: {
+    'attr.data-slot': '"input-group"',
     '[class]': 'computedClass()',
   },
   changeDetection: ChangeDetectionStrategy.OnPush,

package/src/app/lib/components/ui/item/index.ts

@@ -0,0 +1,21 @@
+export { ItemActions } from './item-actions.component';
+export { ItemContent } from './item-content.component';
+export { ItemDescription } from './item-description.component';
+export { ItemFooter } from './item-footer.component';
+export { ItemGroup } from './item-group.component';
+export { ItemHeader } from './item-header.component';
+export {
+  ItemMedia,
+  itemMediaVariants,
+  type ItemMediaVariant,
+  type ItemMediaVariants,
+} from './item-media.component';
+export { ItemSeparator } from './item-separator.component';
+export { ItemTitle } from './item-title.component';
+export {
+  Item,
+  itemVariants,
+  type ItemSize,
+  type ItemVariant,
+  type ItemVariants,
+} from './item.component';

package/src/app/lib/components/ui/item/item-actions.component.ts

@@ -0,0 +1,29 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+
+/**
+ * ItemActions component - trailing actions (buttons, icons) for an Item.
+ *
+ * @example
+ * <ItemActions>
+ *   <Button variant="outline" size="sm">Open</Button>
+ * </ItemActions>
+ */
+@Component({
+  selector: 'ItemActions',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"item-actions"',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ItemActions {
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn('flex items-center gap-2', this.class()),
+  );
+}

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

@@ -0,0 +1,31 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+
+/**
+ * ItemContent component - main content area of an Item, holding
+ * the title and description.
+ *
+ * @example
+ * <ItemContent>
+ *   <ItemTitle>Title</ItemTitle>
+ *   <ItemDescription>Description</ItemDescription>
+ * </ItemContent>
+ */
+@Component({
+  selector: 'ItemContent',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"item-content"',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ItemContent {
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn('flex flex-1 flex-col gap-1 [&+[data-slot=item-content]]:flex-none', this.class()),
+  );
+}

package/src/app/lib/components/ui/item/item-description.component.ts

@@ -0,0 +1,30 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+
+/**
+ * ItemDescription component - secondary description text for an Item.
+ *
+ * @example
+ * <ItemDescription>A short summary of the item.</ItemDescription>
+ */
+@Component({
+  selector: 'ItemDescription',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"item-description"',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ItemDescription {
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn(
+      'text-muted-foreground line-clamp-2 text-sm leading-normal font-normal text-balance',
+      this.class(),
+    ),
+  );
+}

package/src/app/lib/components/ui/item/item-footer.component.ts

@@ -0,0 +1,30 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+
+/**
+ * ItemFooter component - full-width footer row inside an Item.
+ *
+ * @example
+ * <Item>
+ *   <ItemContent>...</ItemContent>
+ *   <ItemFooter>Footer content</ItemFooter>
+ * </Item>
+ */
+@Component({
+  selector: 'ItemFooter',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"item-footer"',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ItemFooter {
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn('flex basis-full items-center justify-between gap-2', this.class()),
+  );
+}

package/src/app/lib/components/ui/item/item-group.component.ts

@@ -0,0 +1,32 @@
+import { cn } from '@/lib/utils';
+import { ChangeDetectionStrategy, Component, computed, input } from '@angular/core';
+
+/**
+ * ItemGroup component - container that stacks multiple Item components.
+ *
+ * @example
+ * <ItemGroup>
+ *   <Item>...</Item>
+ *   <ItemSeparator />
+ *   <Item>...</Item>
+ * </ItemGroup>
+ */
+@Component({
+  selector: 'ItemGroup',
+  template: `<ng-content />`,
+  host: {
+    'attr.data-slot': '"item-group"',
+    role: 'list',
+    '[class]': 'computedClass()',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ItemGroup {
+  /** Additional CSS classes to apply */
+  readonly class = input<string>('');
+
+  /** Computed class combining base styles and custom classes */
+  protected readonly computedClass = computed(() =>
+    cn('group/item-group flex flex-col', this.class()),
+  );
+}