@shival99/z-ui 2.6.6 → 2.6.8

package/assets/css/base.css

@@ -86,46 +86,46 @@ body {
 /* ==================== Utility Classes ==================== */
 
 @layer utilities {
-  .shadow-0,
-  .shadow-1,
-  .shadow-2,
-  .shadow-3,
-  .shadow-card,
-  .shadow-card-md,
-  .shadow-card-lg,
-  .shadow-card-soft {
+  :where(.shadow-0),
+  :where(.shadow-1),
+  :where(.shadow-2),
+  :where(.shadow-3),
+  :where(.shadow-card),
+  :where(.shadow-card-md),
+  :where(.shadow-card-lg),
+  :where(.shadow-card-soft) {
     --tw-shadow-color: initial;
   }
 
-  .shadow-0 {
+  :where(.shadow-0) {
     box-shadow: var(--shadow-0);
   }
 
-  .shadow-1 {
+  :where(.shadow-1) {
     box-shadow: var(--shadow-1);
   }
 
-  .shadow-2 {
+  :where(.shadow-2) {
     box-shadow: var(--shadow-2);
   }
 
-  .shadow-3 {
+  :where(.shadow-3) {
     box-shadow: var(--shadow-3);
   }
 
-  .shadow-card {
+  :where(.shadow-card) {
     box-shadow: var(--shadow-card);
   }
 
-  .shadow-card-md {
+  :where(.shadow-card-md) {
     box-shadow: var(--shadow-card-md);
   }
 
-  .shadow-card-lg {
+  :where(.shadow-card-lg) {
     box-shadow: var(--shadow-card-lg);
   }
 
-  .shadow-card-soft {
+  :where(.shadow-card-soft) {
     box-shadow: var(--shadow-card-soft);
   }
 }

package/fesm2022/shival99-z-ui-components-z-button-group.mjs

@@ -9,7 +9,7 @@ class ZButtonGroupItemDirective {
     _group = inject(Z_BUTTON_GROUP, { optional: true });
     _index = signal(-1, /* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "_index" }] : /* istanbul ignore next */ []));
-    /** Khóa ổn định tùy chọn, ưu tiên hơn index khi xác định active. */
+    /** Stable option key; takes precedence over the index when resolving the active item. */
     zValue = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "zValue" }] : /* istanbul ignore next */ []));
     _value = computed(() => this.zValue() ?? this._index(), /* @ts-ignore */

package/fesm2022/shival99-z-ui-components-z-button-group.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"shival99-z-ui-components-z-button-group.mjs","sources":["../../../../libs/core-ui/components/z-button-group/z-button-group.define.ts","../../../../libs/core-ui/components/z-button-group/z-button-group-item.directive.ts","../../../../libs/core-ui/components/z-button-group/z-button-group.variants.ts","../../../../libs/core-ui/components/z-button-group/z-button-group-separator.component.ts","../../../../libs/core-ui/components/z-button-group/z-button-group.component.ts","../../../../libs/core-ui/components/z-button-group/shival99-z-ui-components-z-button-group.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\nimport type { ZButtonGroupHost } from './z-button-group.types';\n\nexport const Z_BUTTON_GROUP = new InjectionToken<ZButtonGroupHost>('Z_BUTTON_GROUP');\n","import { computed, Directive, inject, input, signal } from '@angular/core';\nimport { Z_BUTTON_GROUP } from './z-button-group.define';\nimport type { ZButtonGroupValue } from './z-button-group.types';\n\n@Directive({\n  selector: '[z-button-group-item]',\n  standalone: true,\n  host: {\n    '[class.z-button-group-item-active]': 'isActive()',\n    '(click)': 'onClick()',\n  },\n  exportAs: 'zButtonGroupItem',\n})\nexport class ZButtonGroupItemDirective {\n  private readonly _group = inject(Z_BUTTON_GROUP, { optional: true });\n  private readonly _index = signal<number>(-1);\n\n  /** Khóa ổn định tùy chọn, ưu tiên hơn index khi xác định active. */\n  public readonly zValue = input<ZButtonGroupValue>();\n\n  private readonly _value = computed<ZButtonGroupValue>(() => this.zValue() ?? this._index());\n\n  public readonly isActive = computed(() => {\n    if (!this._group) {\n      return false;\n    }\n    return this._group._isItemActive(this._value());\n  });\n\n  public readonly index = this._index.asReadonly();\n  public _setIndex(index: number): void {\n    this._index.set(index);\n  }\n\n  protected onClick(): void {\n    if (!this._group) {\n      return;\n    }\n    this._group._selectItem(this._value(), this._index());\n  }\n}\n","import { cva } from 'class-variance-authority';\n\nexport const zButtonGroupVariants = cva('inline-flex h-fit', {\n  variants: {\n    zOrientation: {\n      horizontal: [\n        'flex-row',\n        'items-center',\n        // First child - only left border radius\n        '[&>*:first-child]:rounded-r-none!',\n        // Last child - only right border radius\n        '[&>*:last-child]:rounded-l-none!',\n        // Middle children - no border radius\n        '[&>*:not(:first-child):not(:last-child)]:rounded-none!',\n        // Remove double borders between buttons\n        '[&>*:not(:first-child)]:border-l-0!',\n        // Handle single child\n        '[&>*:only-child]:rounded-lg!',\n        '[&>*:only-child]:border-l!',\n        // Active item styling - use primary color from theme\n        '[&>*.z-button-group-item-active]:bg-primary',\n        '[&>*.z-button-group-item-active]:text-primary-foreground',\n        '[&>*.z-button-group-item-active]:border-primary',\n        '[&>*.z-button-group-item-active]:z-[1]',\n      ],\n      vertical: [\n        'flex-col',\n        'items-stretch',\n        // First child - only top border radius\n        '[&>*:first-child]:rounded-b-none!',\n        // Last child - only bottom border radius\n        '[&>*:last-child]:rounded-t-none!',\n        // Middle children - no border radius\n        '[&>*:not(:first-child):not(:last-child)]:rounded-none!',\n        // Remove double borders between buttons\n        '[&>*:not(:first-child)]:border-t-0!',\n        // Handle single child\n        '[&>*:only-child]:rounded-lg!',\n        '[&>*:only-child]:border-t!',\n        // Active item styling - use primary color from theme\n        '[&>*.z-button-group-item-active]:bg-primary',\n        '[&>*.z-button-group-item-active]:text-primary-foreground',\n        '[&>*.z-button-group-item-active]:border-primary',\n        '[&>*.z-button-group-item-active]:z-[1]',\n      ],\n    },\n  },\n  defaultVariants: {\n    zOrientation: 'horizontal',\n  },\n});\n\nexport const zButtonGroupSeparatorVariants = cva('shrink-0 bg-border', {\n  variants: {\n    zOrientation: {\n      horizontal: 'h-full w-px',\n      vertical: 'w-full h-px',\n    },\n  },\n  defaultVariants: {\n    zOrientation: 'horizontal',\n  },\n});\n","import { ChangeDetectionStrategy, Component, computed, input, ViewEncapsulation } from '@angular/core';\nimport { zMergeClasses } from '@shival99/z-ui/utils';\nimport type { ClassValue } from 'clsx';\nimport type { ZButtonGroupSeparatorVariants } from './z-button-group.types';\nimport { zButtonGroupSeparatorVariants } from './z-button-group.variants';\n\n@Component({\n  selector: 'z-button-group-separator',\n  standalone: true,\n  template: ``,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  encapsulation: ViewEncapsulation.None,\n  host: {\n    role: 'separator',\n    '[class]': 'zClasses()',\n  },\n  exportAs: 'zButtonGroupSeparator',\n})\nexport class ZButtonGroupSeparatorComponent {\n  public readonly zClass = input<ClassValue>('');\n  public readonly zOrientation = input<ZButtonGroupSeparatorVariants['zOrientation']>('horizontal');\n\n  protected readonly zClasses = computed(() =>\n    zMergeClasses(\n      zButtonGroupSeparatorVariants({\n        zOrientation: this.zOrientation(),\n      }),\n      this.zClass()\n    )\n  );\n}\n","import {\n  ChangeDetectionStrategy,\n  Component,\n  computed,\n  contentChildren,\n  effect,\n  input,\n  model,\n  output,\n  ViewEncapsulation,\n} from '@angular/core';\nimport { zMergeClasses } from '@shival99/z-ui/utils';\nimport type { ClassValue } from 'clsx';\nimport { ZButtonGroupItemDirective } from './z-button-group-item.directive';\nimport { Z_BUTTON_GROUP } from './z-button-group.define';\nimport { type ZButtonGroupHost, type ZButtonGroupValue, type ZButtonGroupVariants } from './z-button-group.types';\nimport { zButtonGroupVariants } from './z-button-group.variants';\n\n@Component({\n  selector: 'z-button-group',\n  standalone: true,\n  template: `\n    <ng-content />\n  `,\n  providers: [\n    {\n      provide: Z_BUTTON_GROUP,\n      useExisting: ZButtonGroupComponent,\n    },\n  ],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  encapsulation: ViewEncapsulation.None,\n  host: {\n    role: 'group',\n    '[class]': 'zClasses()',\n  },\n  exportAs: 'zButtonGroup',\n})\nexport class ZButtonGroupComponent implements ZButtonGroupHost {\n  public readonly zClass = input<ClassValue>('');\n  public readonly zOrientation = input<ZButtonGroupVariants['zOrientation']>('horizontal');\n\n  public readonly zActive = model<ZButtonGroupValue | null>(null);\n  public readonly zActiveIndexChange = output<number | null>();\n  public readonly zActiveValueChange = output<ZButtonGroupValue | null>();\n  private readonly _items = contentChildren(ZButtonGroupItemDirective);\n\n  protected readonly zClasses = computed(() =>\n    zMergeClasses(\n      zButtonGroupVariants({\n        zOrientation: this.zOrientation(),\n      }),\n      this.zClass()\n    )\n  );\n\n  constructor() {\n    effect(() => {\n      const items = this._items();\n      items.forEach((item, index) => {\n        item._setIndex(index);\n      });\n    });\n  }\n\n  public _selectItem(value: ZButtonGroupValue, index: number): void {\n    const newValue = this.zActive() === value ? null : value;\n    this.zActive.set(newValue);\n    this.zActiveIndexChange.emit(newValue === null ? null : index);\n    this.zActiveValueChange.emit(newValue);\n  }\n\n  public _isItemActive(value: ZButtonGroupValue): boolean {\n    return this.zActive() === value;\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"shival99-z-ui-components-z-button-group.mjs","sources":["../../../../libs/core-ui/components/z-button-group/z-button-group.define.ts","../../../../libs/core-ui/components/z-button-group/z-button-group-item.directive.ts","../../../../libs/core-ui/components/z-button-group/z-button-group.variants.ts","../../../../libs/core-ui/components/z-button-group/z-button-group-separator.component.ts","../../../../libs/core-ui/components/z-button-group/z-button-group.component.ts","../../../../libs/core-ui/components/z-button-group/shival99-z-ui-components-z-button-group.ts"],"sourcesContent":["import { InjectionToken } from '@angular/core';\nimport type { ZButtonGroupHost } from './z-button-group.types';\n\nexport const Z_BUTTON_GROUP = new InjectionToken<ZButtonGroupHost>('Z_BUTTON_GROUP');\n","import { computed, Directive, inject, input, signal } from '@angular/core';\nimport { Z_BUTTON_GROUP } from './z-button-group.define';\nimport type { ZButtonGroupValue } from './z-button-group.types';\n\n@Directive({\n  selector: '[z-button-group-item]',\n  standalone: true,\n  host: {\n    '[class.z-button-group-item-active]': 'isActive()',\n    '(click)': 'onClick()',\n  },\n  exportAs: 'zButtonGroupItem',\n})\nexport class ZButtonGroupItemDirective {\n  private readonly _group = inject(Z_BUTTON_GROUP, { optional: true });\n  private readonly _index = signal<number>(-1);\n\n  /** Stable option key; takes precedence over the index when resolving the active item. */\n  public readonly zValue = input<ZButtonGroupValue>();\n\n  private readonly _value = computed<ZButtonGroupValue>(() => this.zValue() ?? this._index());\n\n  public readonly isActive = computed(() => {\n    if (!this._group) {\n      return false;\n    }\n    return this._group._isItemActive(this._value());\n  });\n\n  public readonly index = this._index.asReadonly();\n  public _setIndex(index: number): void {\n    this._index.set(index);\n  }\n\n  protected onClick(): void {\n    if (!this._group) {\n      return;\n    }\n    this._group._selectItem(this._value(), this._index());\n  }\n}\n","import { cva } from 'class-variance-authority';\n\nexport const zButtonGroupVariants = cva('inline-flex h-fit', {\n  variants: {\n    zOrientation: {\n      horizontal: [\n        'flex-row',\n        'items-center',\n        // First child - only left border radius\n        '[&>*:first-child]:rounded-r-none!',\n        // Last child - only right border radius\n        '[&>*:last-child]:rounded-l-none!',\n        // Middle children - no border radius\n        '[&>*:not(:first-child):not(:last-child)]:rounded-none!',\n        // Remove double borders between buttons\n        '[&>*:not(:first-child)]:border-l-0!',\n        // Handle single child\n        '[&>*:only-child]:rounded-lg!',\n        '[&>*:only-child]:border-l!',\n        // Active item styling - use primary color from theme\n        '[&>*.z-button-group-item-active]:bg-primary',\n        '[&>*.z-button-group-item-active]:text-primary-foreground',\n        '[&>*.z-button-group-item-active]:border-primary',\n        '[&>*.z-button-group-item-active]:z-[1]',\n      ],\n      vertical: [\n        'flex-col',\n        'items-stretch',\n        // First child - only top border radius\n        '[&>*:first-child]:rounded-b-none!',\n        // Last child - only bottom border radius\n        '[&>*:last-child]:rounded-t-none!',\n        // Middle children - no border radius\n        '[&>*:not(:first-child):not(:last-child)]:rounded-none!',\n        // Remove double borders between buttons\n        '[&>*:not(:first-child)]:border-t-0!',\n        // Handle single child\n        '[&>*:only-child]:rounded-lg!',\n        '[&>*:only-child]:border-t!',\n        // Active item styling - use primary color from theme\n        '[&>*.z-button-group-item-active]:bg-primary',\n        '[&>*.z-button-group-item-active]:text-primary-foreground',\n        '[&>*.z-button-group-item-active]:border-primary',\n        '[&>*.z-button-group-item-active]:z-[1]',\n      ],\n    },\n  },\n  defaultVariants: {\n    zOrientation: 'horizontal',\n  },\n});\n\nexport const zButtonGroupSeparatorVariants = cva('shrink-0 bg-border', {\n  variants: {\n    zOrientation: {\n      horizontal: 'h-full w-px',\n      vertical: 'w-full h-px',\n    },\n  },\n  defaultVariants: {\n    zOrientation: 'horizontal',\n  },\n});\n","import { ChangeDetectionStrategy, Component, computed, input, ViewEncapsulation } from '@angular/core';\nimport { zMergeClasses } from '@shival99/z-ui/utils';\nimport type { ClassValue } from 'clsx';\nimport type { ZButtonGroupSeparatorVariants } from './z-button-group.types';\nimport { zButtonGroupSeparatorVariants } from './z-button-group.variants';\n\n@Component({\n  selector: 'z-button-group-separator',\n  standalone: true,\n  template: ``,\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  encapsulation: ViewEncapsulation.None,\n  host: {\n    role: 'separator',\n    '[class]': 'zClasses()',\n  },\n  exportAs: 'zButtonGroupSeparator',\n})\nexport class ZButtonGroupSeparatorComponent {\n  public readonly zClass = input<ClassValue>('');\n  public readonly zOrientation = input<ZButtonGroupSeparatorVariants['zOrientation']>('horizontal');\n\n  protected readonly zClasses = computed(() =>\n    zMergeClasses(\n      zButtonGroupSeparatorVariants({\n        zOrientation: this.zOrientation(),\n      }),\n      this.zClass()\n    )\n  );\n}\n","import {\n  ChangeDetectionStrategy,\n  Component,\n  computed,\n  contentChildren,\n  effect,\n  input,\n  model,\n  output,\n  ViewEncapsulation,\n} from '@angular/core';\nimport { zMergeClasses } from '@shival99/z-ui/utils';\nimport type { ClassValue } from 'clsx';\nimport { ZButtonGroupItemDirective } from './z-button-group-item.directive';\nimport { Z_BUTTON_GROUP } from './z-button-group.define';\nimport { type ZButtonGroupHost, type ZButtonGroupValue, type ZButtonGroupVariants } from './z-button-group.types';\nimport { zButtonGroupVariants } from './z-button-group.variants';\n\n@Component({\n  selector: 'z-button-group',\n  standalone: true,\n  template: `\n    <ng-content />\n  `,\n  providers: [\n    {\n      provide: Z_BUTTON_GROUP,\n      useExisting: ZButtonGroupComponent,\n    },\n  ],\n  changeDetection: ChangeDetectionStrategy.OnPush,\n  encapsulation: ViewEncapsulation.None,\n  host: {\n    role: 'group',\n    '[class]': 'zClasses()',\n  },\n  exportAs: 'zButtonGroup',\n})\nexport class ZButtonGroupComponent implements ZButtonGroupHost {\n  public readonly zClass = input<ClassValue>('');\n  public readonly zOrientation = input<ZButtonGroupVariants['zOrientation']>('horizontal');\n\n  public readonly zActive = model<ZButtonGroupValue | null>(null);\n  public readonly zActiveIndexChange = output<number | null>();\n  public readonly zActiveValueChange = output<ZButtonGroupValue | null>();\n  private readonly _items = contentChildren(ZButtonGroupItemDirective);\n\n  protected readonly zClasses = computed(() =>\n    zMergeClasses(\n      zButtonGroupVariants({\n        zOrientation: this.zOrientation(),\n      }),\n      this.zClass()\n    )\n  );\n\n  constructor() {\n    effect(() => {\n      const items = this._items();\n      items.forEach((item, index) => {\n        item._setIndex(index);\n      });\n    });\n  }\n\n  public _selectItem(value: ZButtonGroupValue, index: number): void {\n    const newValue = this.zActive() === value ? null : value;\n    this.zActive.set(newValue);\n    this.zActiveIndexChange.emit(newValue === null ? null : index);\n    this.zActiveValueChange.emit(newValue);\n  }\n\n  public _isItemActive(value: ZButtonGroupValue): boolean {\n    return this.zActive() === value;\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/fesm2022/shival99-z-ui-components-z-calendar.mjs

@@ -1711,7 +1711,7 @@ class ZCalendarComponent {
                 let end = null;
                 const valStart = range['start'];
                 const valEnd = range['end'];
-                // Tự động phân tích giá trị start nếu là chuỗi ISO hoặc định dạng thông thường
+                // Parse the start value when it is an ISO string or a supported date format.
                 if (valStart instanceof Date) {
                     start = valStart;
                 }
@@ -1725,7 +1725,7 @@ class ZCalendarComponent {
                         start = parseDate(valStart, this.zFormat(), this.zLocale());
                     }
                 }
-                // Tự động phân tích giá trị end nếu là chuỗi ISO hoặc định dạng thông thường
+                // Parse the end value when it is an ISO string or a supported date format.
                 if (valEnd instanceof Date) {
                     end = valEnd;
                 }
@@ -1765,7 +1765,7 @@ class ZCalendarComponent {
         if (value instanceof Date) {
             date = value;
         }
-        // Tự động phân tích chuỗi ISO của single mode (hữu ích khi nhận giá trị thô từ API)
+        // Parse ISO strings in single mode when values come directly from an API.
         if (!date && typeof value === 'string') {
             const isIsoLike = /^\d{4}-\d{2}-\d{2}/.test(value);
             date = valueType === 'iso' || isIsoLike ? fromISOString(value) : parseDate(value, this.zFormat(), this.zLocale());
@@ -2106,7 +2106,7 @@ class ZCalendarComponent {
                 }
             }
             if (matchedToken) {
-                // Tách các token thành các loại tương ứng
+                // Classify each format token.
                 if (matchedToken === 'A' || matchedToken === 'a') {
                     segments.push({ type: 'period', value: matchedToken });
                 }
@@ -2129,12 +2129,12 @@ class ZCalendarComponent {
         return segments;
     }
     _formatValueOnTyping(value, format) {
-        // Không tự động format cho các định dạng tên tháng (như Tháng 6, June)
+        // Do not auto-format formats that contain month names.
         if (format.includes('MMM') || format.includes('MMMM')) {
             return value;
         }
         const digitsCount = value.replace(/\D/g, '').length;
-        // Nếu không có chữ số nào (ví dụ đang nhập chữ 'invalid-date'), trả về giá trị gốc để không xóa trắng textbox
+        // Keep non-numeric input intact so validation can report it instead of clearing the field.
         if (digitsCount === 0) {
             return value;
         }
@@ -2147,7 +2147,7 @@ class ZCalendarComponent {
             if (seg.type === 'digit') {
                 let group = userGroups[groupIndex] || '';
                 groupIndex++;
-                // Bỏ qua các nhóm không phải là chữ số khi cần khớp với segment dạng số
+                // Skip non-numeric groups when matching a numeric segment.
                 while (group && !/^\d+$/.test(group)) {
                     group = userGroups[groupIndex] || '';
                     groupIndex++;
@@ -2155,17 +2155,17 @@ class ZCalendarComponent {
                 if (!group) {
                     break;
                 }
-                // Giới hạn chiều dài của nhóm số theo định nghĩa segment
+                // Limit the numeric group to the segment length.
                 const len = seg.value.length;
                 const clampedGroup = group.slice(0, len);
                 result += clampedGroup;
-                // Nếu nhóm số đã nhập đủ độ dài segment, tự động chèn separator tiếp theo
+                // Insert the next separator once the numeric segment is complete.
                 if (clampedGroup.length === len) {
                     const nextSeg = segments[i + 1];
                     if (nextSeg && nextSeg.type === 'literal') {
                         result += nextSeg.value;
                         i++;
-                        // Nếu người dùng đã gõ separator này rồi thì bỏ qua không lặp lại
+                        // Do not duplicate a separator the user already typed.
                         const nextGroup = userGroups[groupIndex];
                         if (nextGroup && !/^[a-zA-Z0-9]+$/.test(nextGroup)) {
                             groupIndex++;
@@ -2282,13 +2282,13 @@ class ZCalendarComponent {
         return false;
     }
     _clampInputDateString(value, format) {
-        // Không tự động clamp đối với các định dạng chữ chứa tên tháng
+        // Do not clamp formats that contain month names.
         if (format.includes('MMM') || format.includes('MMMM')) {
             return value;
         }
         const trimmed = value.trim();
         const digitsCount = trimmed.replace(/\D/g, '').length;
-        // Nếu không có chữ số nào, trả về giá trị gốc để validation phát hiện lỗi và revert
+        // Keep non-numeric input intact so validation can report and revert it.
         if (digitsCount === 0) {
             return value;
         }
@@ -2407,7 +2407,7 @@ class ZCalendarComponent {
             }
             result += seg.value;
         }
-        // Khôi phục AM/PM ở đuôi chuỗi nếu bị mất sau khi clamp
+        // Restore a trailing AM/PM marker if clamping removed it.
         const isPM = /PM/i.test(trimmed);
         const isAM = /AM/i.test(trimmed);
         if ((isPM || isAM) && !/am|pm/i.test(result)) {