@aseansc/ui 5.12.0 → 5.13.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aseansc/ui",
3
- "version": "5.12.0",
3
+ "version": "5.13.1",
4
4
  "description": "ASC Internal UI Component Library — Angular 22 + PrimeNG 21 + TailwindCSS 4 (PrimeNG capped at 21.x — 22.x requires a paid PrimeUI license key, xem README.md)",
5
5
  "license": "UNLICENSED",
6
6
  "author": "ASC Team",
@@ -62,6 +62,15 @@
62
62
  --asc-border-color-invalid: #{p.$asc-red-500}; // Border.error
63
63
  --asc-border-color-brand: #{p.$asc-brand-500}; // Border.brand — token trước đây chưa có
64
64
 
65
+ // ── Tiêu đề màn hình (UX SeAHolder 17/11, SEAHDR-514) — dùng qua class .asc-page-title ──────
66
+ // Khác tiêu đề khối trong card (.p-card-title 14px / 400). App ghi đè từng biến.
67
+ --asc-page-title-font-size: 18px;
68
+ --asc-page-title-line-height: 27px; // Figma title-18
69
+ --asc-page-title-font-weight: 600;
70
+ --asc-page-title-color: #{p.$asc-black};
71
+ --asc-page-title-padding-top: 12px;
72
+ --asc-page-title-padding-bottom: 16px;
73
+
65
74
  // ── Color: Text — Text.* (design-token-color.json) ───────────────────────────
66
75
  --asc-text-primary: #{p.$asc-grey-900}; // Text.primary
67
76
  --asc-text-secondary: #{p.$asc-grey-600}; // Text.secondary — sửa theo tài liệu MD gốc (file color mới bị trùng giá trị với tertiary, nghi lỗi copy)
@@ -221,6 +230,7 @@
221
230
  --asc-border-color-brand: #{p.$asc-brand-500}; // Border.brand (dark) — không đổi
222
231
 
223
232
  --asc-text-primary: #{p.$asc-grey-10}; // Text.primary (dark)
233
+ --asc-page-title-color: #{p.$asc-grey-10}; // #000 không đọc được trên nền tối → theo Text.primary (dark)
224
234
  --asc-table-header-color: #{p.$asc-grey-10}; // dark giữ như cũ (= Text.primary dark)
225
235
  // Figma chưa có dark cho Table/* — giữ nền header như cũ, kẻ/hover theo tông tối
226
236
  --asc-table-header-bg: var(--asc-surface-translucent);
@@ -4,7 +4,8 @@
4
4
  min-height: 100vh;
5
5
  justify-content: space-between;
6
6
  // padding-top = cao topbar (fixed) + khoảng topbar ↔ nội dung, để topbar không che nội dung
7
- padding: calc(var(--layout-topbar-height) + var(--layout-content-top-gap)) var(--layout-content-gap) 0
7
+ // phải: lề mép màn hình; trái: khoảng cách với sidebar (nhánh không có sidebar ở _responsive.scss)
8
+ padding: calc(var(--layout-topbar-height) + var(--layout-content-top-gap)) var(--layout-edge-gap) 0
8
9
  var(--layout-content-gap);
9
10
  transition: margin-left var(--layout-section-transition-duration);
10
11
  }
@@ -12,7 +12,7 @@
12
12
  &.layout-overlay {
13
13
  .layout-main-container {
14
14
  margin-left: 0;
15
- padding-left: var(--layout-content-gap);
15
+ padding-left: var(--layout-edge-gap); // không có sidebar bên trái → lề mép màn hình
16
16
  }
17
17
 
18
18
  .layout-sidebar {
@@ -63,7 +63,7 @@
63
63
 
64
64
  .layout-main-container {
65
65
  margin-left: 0;
66
- padding-left: var(--layout-content-gap);
66
+ padding-left: var(--layout-edge-gap); // không có sidebar bên trái → lề mép màn hình
67
67
  }
68
68
  }
69
69
 
@@ -146,7 +146,7 @@
146
146
  .layout-wrapper {
147
147
  .layout-main-container {
148
148
  margin-left: 0;
149
- padding-left: var(--layout-content-gap);
149
+ padding-left: var(--layout-edge-gap); // không có sidebar bên trái → lề mép màn hình
150
150
  }
151
151
 
152
152
  .layout-sidebar {
@@ -66,3 +66,14 @@ p {
66
66
  margin-bottom: 0;
67
67
  }
68
68
  }
69
+
70
+ // Tiêu đề màn hình (UX SeAHolder 17/11, SEAHDR-514): 18px / 600 / #000, cách trên 12px, dưới 16px.
71
+ // Gắn lên phần tử tiêu đề của màn (vd <h1 class="asc-page-title">). Chỉnh qua --asc-page-title-*.
72
+ .asc-page-title {
73
+ margin: 0;
74
+ padding: var(--asc-page-title-padding-top) 0 var(--asc-page-title-padding-bottom);
75
+ font-size: var(--asc-page-title-font-size);
76
+ line-height: var(--asc-page-title-line-height);
77
+ font-weight: var(--asc-page-title-font-weight);
78
+ color: var(--asc-page-title-color);
79
+ }
@@ -16,7 +16,8 @@
16
16
  --layout-sidebar-gap: 12px; // khoảng hở giữa sidebar nổi và mép viewport
17
17
  // Khoảng cách layout viết bằng px: html font-size 14px nên rem ra số lẻ (14, 21, 28…). App ghi đè được.
18
18
  --layout-topbar-height: 64px;
19
- --layout-content-gap: 16px; // sidebar ↔ nội dung, nội dung ↔ mép phải
19
+ --layout-content-gap: 16px; // sidebar ↔ nội dung
20
+ --layout-edge-gap: 12px; // nội dung ↔ mép màn hình (phải; trái khi không có sidebar) — UX chốt 12px 4 cạnh
20
21
  --layout-content-top-gap: 12px; // topbar ↔ nội dung
21
22
  --layout-main-padding: 24px; // padding trong card .layout-main
22
23
  --layout-main-margin-bottom: 12px; // card ↔ đáy viewport
package/tokens/preset.css CHANGED
@@ -93,6 +93,12 @@
93
93
  --asc-border-color-focus: #3b82f6;
94
94
  --asc-border-color-invalid: #ef4444;
95
95
  --asc-border-color-brand: #f74036;
96
+ --asc-page-title-font-size: 18px;
97
+ --asc-page-title-line-height: 27px;
98
+ --asc-page-title-font-weight: 600;
99
+ --asc-page-title-color: #000000;
100
+ --asc-page-title-padding-top: 12px;
101
+ --asc-page-title-padding-bottom: 16px;
96
102
  --asc-text-primary: #0f0f0f;
97
103
  --asc-text-secondary: #5b5b5c;
98
104
  --asc-text-muted: #747475;
@@ -207,6 +213,7 @@
207
213
  --asc-border-color-focus: #3b82f6;
208
214
  --asc-border-color-brand: #f74036;
209
215
  --asc-text-primary: #fafafc;
216
+ --asc-page-title-color: #fafafc;
210
217
  --asc-table-header-color: #fafafc;
211
218
  --asc-table-header-bg: var(--asc-surface-translucent);
212
219
  --asc-table-header-divider-top: #424242;
@@ -700,6 +707,7 @@
700
707
  --layout-sidebar-gap: 12px;
701
708
  --layout-topbar-height: 64px;
702
709
  --layout-content-gap: 16px;
710
+ --layout-edge-gap: 12px;
703
711
  --layout-content-top-gap: 12px;
704
712
  --layout-main-padding: 24px;
705
713
  --layout-main-margin-bottom: 12px;
@@ -804,7 +812,7 @@ a {
804
812
  flex-direction: column;
805
813
  min-height: 100vh;
806
814
  justify-content: space-between;
807
- padding: calc(var(--layout-topbar-height) + var(--layout-content-top-gap)) var(--layout-content-gap) 0 var(--layout-content-gap);
815
+ padding: calc(var(--layout-topbar-height) + var(--layout-content-top-gap)) var(--layout-edge-gap) 0 var(--layout-content-gap);
808
816
  transition: margin-left var(--layout-section-transition-duration);
809
817
  }
810
818
 
@@ -1152,7 +1160,7 @@ img {
1152
1160
  @media (min-width: 992px) {
1153
1161
  .layout-wrapper.layout-overlay .layout-main-container {
1154
1162
  margin-left: 0;
1155
- padding-left: var(--layout-content-gap);
1163
+ padding-left: var(--layout-edge-gap);
1156
1164
  }
1157
1165
  .layout-wrapper.layout-overlay .layout-sidebar {
1158
1166
  transform: translateX(-100%);
@@ -1185,7 +1193,7 @@ img {
1185
1193
  }
1186
1194
  .layout-wrapper.layout-static.layout-static-inactive .layout-main-container {
1187
1195
  margin-left: 0;
1188
- padding-left: var(--layout-content-gap);
1196
+ padding-left: var(--layout-edge-gap);
1189
1197
  }
1190
1198
  .layout-wrapper.layout-static.layout-sidebar-rail {
1191
1199
  --layout-sidebar-width: var(--layout-sidebar-rail-width);
@@ -1241,7 +1249,7 @@ img {
1241
1249
  }
1242
1250
  .layout-wrapper .layout-main-container {
1243
1251
  margin-left: 0;
1244
- padding-left: var(--layout-content-gap);
1252
+ padding-left: var(--layout-edge-gap);
1245
1253
  }
1246
1254
  .layout-wrapper .layout-sidebar {
1247
1255
  transform: translateX(-100%);
@@ -1364,6 +1372,15 @@ p {
1364
1372
  p:last-child {
1365
1373
  margin-bottom: 0;
1366
1374
  }
1375
+
1376
+ .asc-page-title {
1377
+ margin: 0;
1378
+ padding: var(--asc-page-title-padding-top) 0 var(--asc-page-title-padding-bottom);
1379
+ font-size: var(--asc-page-title-font-size);
1380
+ line-height: var(--asc-page-title-line-height);
1381
+ font-weight: var(--asc-page-title-font-weight);
1382
+ color: var(--asc-page-title-color);
1383
+ }
1367
1384
  /* 1. TailwindCSS v4 */
1368
1385
  @import "tailwindcss";
1369
1386
  @source "../fesm2022/**/*.mjs";
@@ -10,6 +10,7 @@ import { InputNumberInputEvent } from 'primeng/inputnumber';
10
10
  import { FileSelectEvent } from 'primeng/fileupload';
11
11
  import { TableLazyLoadEvent, TablePageEvent, TableRowSelectEvent, TableRowUnSelectEvent } from 'primeng/table';
12
12
  import { Menu } from 'primeng/menu';
13
+ import { Popover } from 'primeng/popover';
13
14
  import { PickListMoveToTargetEvent, PickListMoveToSourceEvent, PickListMoveAllToTargetEvent, PickListMoveAllToSourceEvent } from 'primeng/picklist';
14
15
  import * as _angular_platform_browser from '@angular/platform-browser';
15
16
  import { SafeHtml } from '@angular/platform-browser';
@@ -464,7 +465,7 @@ declare abstract class BaseControlAccessor<T> implements ControlValueAccessor, O
464
465
  * dạng text thay vì form control). AscFormFieldComponent tự đọc giá trị này
465
466
  * qua ContentChild để đồng bộ style label — không cần set mode ở cả 2 nơi.
466
467
  */
467
- readonly mode: _angular_core.InputSignal<"edit" | "view">;
468
+ readonly mode: _angular_core.InputSignal<"view" | "edit">;
468
469
  /** Giá trị hiện tại của control */
469
470
  readonly value: _angular_core.WritableSignal<T | null>;
470
471
  /** Trạng thái disabled từ FormControl/NgModel */
@@ -699,7 +700,7 @@ declare class AscButtonComponent {
699
700
  readonly icon: _angular_core.InputSignal<string>;
700
701
  /**
701
702
  * URL file SVG (vd icon Phosphor tải từ Figma) — render qua `asc-icon`, màu theo `currentColor`.
702
- * Có `iconSrc` thì bỏ qua `icon`. Cỡ icon theo size button (md/lg 20px, sm 16px).
703
+ * Có `iconSrc` thì bỏ qua `icon`. Cỡ icon theo size button (sm/md/lg 20px, xs 12px, xl 24px).
703
704
  */
704
705
  readonly iconSrc: _angular_core.InputSignal<string>;
705
706
  readonly iconPos: _angular_core.InputSignal<"left" | "right" | "top" | "bottom">;
@@ -770,7 +771,7 @@ declare class AscFormFieldComponent implements AfterContentInit {
770
771
  * 'FloatLabel' → PrimeNG FloatLabel
771
772
  * 'IftaLabel' → PrimeNG IftaLabel
772
773
  */
773
- readonly typeLabel: _angular_core.InputSignal<"default" | "FloatLabel" | "IftaLabel">;
774
+ readonly typeLabel: _angular_core.InputSignal<"FloatLabel" | "IftaLabel" | "default">;
774
775
  /** Layout tổng thể */
775
776
  readonly layout: _angular_core.InputSignal<AscFormLayout>;
776
777
  /**
@@ -813,7 +814,7 @@ declare class AscFormFieldComponent implements AfterContentInit {
813
814
  * (xem `resolvedMode`). Input này chỉ cần dùng khi muốn ép label view riêng
814
815
  * (vd: control bên trong không hỗ trợ mode, hoặc không có control nào cả).
815
816
  */
816
- readonly mode: _angular_core.InputSignal<"edit" | "view">;
817
+ readonly mode: _angular_core.InputSignal<"view" | "edit">;
817
818
  /** Đồng bộ từ control.errors — trigger CD khi form validate */
818
819
  protected readonly controlErrors: _angular_core.WritableSignal<Record<string, unknown> | null>;
819
820
  /** true khi control có validator required */
@@ -829,7 +830,7 @@ declare class AscFormFieldComponent implements AfterContentInit {
829
830
  * 'view' nếu tự set `mode="view"` HOẶC control bên trong đang mode="view".
830
831
  * → chỉ cần set ở 1 trong 2 nơi (thường là ngay trên control), không cần lặp lại.
831
832
  */
832
- protected readonly resolvedMode: _angular_core.Signal<"edit" | "view">;
833
+ protected readonly resolvedMode: _angular_core.Signal<"view" | "edit">;
833
834
  protected readonly resolvedLabelSuffixIcon: _angular_core.Signal<string>;
834
835
  /** Dấu * bắt buộc — ẩn ở mode view (chỉ đọc, không cần nhập) */
835
836
  protected readonly showRequiredMark: _angular_core.Signal<boolean>;
@@ -910,7 +911,7 @@ declare class AscSelectComponent extends BaseControlAccessor<unknown> {
910
911
  private readonly localeService;
911
912
  protected get msg(): _aseansc_ui.AscUIMessages;
912
913
  /** Danh sách options. Có thể là AscSelectOption[] hoặc object bất kỳ. */
913
- readonly options: _angular_core.InputSignal<AscSelectOption<unknown>[] | unknown[]>;
914
+ readonly options: _angular_core.InputSignal<unknown[] | AscSelectOption<unknown>[]>;
914
915
  /** Field tên hiển thị trong option object */
915
916
  readonly optionLabel: _angular_core.InputSignal<string>;
916
917
  /** Field value trong option object */
@@ -1302,7 +1303,7 @@ declare class AscRadioComponent extends BaseControlAccessor<unknown> {
1302
1303
  /** Hướng danh sách. @default 'column' */
1303
1304
  readonly layout: _angular_core.InputSignal<"column" | "row">;
1304
1305
  /** Căn theo trục ngang của item (align-items). @default 'center' */
1305
- readonly alignColumn: _angular_core.InputSignal<"start" | "center">;
1306
+ readonly alignColumn: _angular_core.InputSignal<"center" | "start">;
1306
1307
  /**
1307
1308
  * Size — cùng kiểu/mặc định với các control khác (undefined → 'md').
1308
1309
  * Hiện chỉ quyết định cỡ chữ ở mode="view" (class host `asc-radio--{size}`);
@@ -1509,6 +1510,20 @@ declare class AscUpload extends BaseControlAccessor<File | File[] | null> {
1509
1510
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<AscUpload, "asc-upload", never, { "actionEvents": { "alias": "actionEvents"; "required": false; "isSignal": true; }; "uploadMode": { "alias": "uploadMode"; "required": false; "isSignal": true; }; "maxSizePerFile": { "alias": "maxSizePerFile"; "required": false; "isSignal": true; }; "multipleUpload": { "alias": "multipleUpload"; "required": false; "isSignal": true; }; "totalSize": { "alias": "totalSize"; "required": false; "isSignal": true; }; "emptyTemplate": { "alias": "emptyTemplate"; "required": false; "isSignal": true; }; "headerStyle": { "alias": "headerStyle"; "required": false; "isSignal": true; }; "chooseLabel": { "alias": "chooseLabel"; "required": false; "isSignal": true; }; }, {}, never, ["[empty]"], true, never>;
1510
1511
  }
1511
1512
 
1513
+ /**
1514
+ * Đặt lại vị trí mũi tên popover — gọi trong `onShow` của p-popover (PrimeNG phát `onShow` ngay sau
1515
+ * `align()`, cùng một lượt).
1516
+ *
1517
+ * PrimeNG `align()`: `--p-popover-arrow-left = target.left − container.left − 2 × border-radius` khi khung
1518
+ * bị đẩy sang trái, ngược lại `0`. Mũi tên nằm ở `left: arrow-offset + arrow-left`. Bo góc lớn (preset
1519
+ * 16px) → trừ 32px → mũi tên lòi ra ngoài mép trái khung / không chỉ vào nút (SEAHDR-522 mục 12).
1520
+ *
1521
+ * Tính lại không trừ bo góc: mũi tên luôn cách mép trái phần tử bấm đúng `arrow-offset` (1.25rem), dù khung
1522
+ * thẳng mép với nút hay bị đẩy sang trái, đổi bo góc không ảnh hưởng. Giới hạn để mũi tên không vượt mép
1523
+ * phải khung.
1524
+ */
1525
+ declare function alignPopoverArrow(popover: Popover | null | undefined): void;
1526
+
1512
1527
  /** Tên icon dựng sẵn trong thư viện. */
1513
1528
  type AscBuiltinIconName = 'approve' | 'view' | 'edit' | 'delete' | 'search' | 'more' | 'caret-down' | 'caret-right' | 'calendar-dots';
1514
1529
  /** viewBox mặc định của icon dựng sẵn. */
@@ -1717,6 +1732,8 @@ type AscTableMenuItem = MenuItem & {
1717
1732
  danger?: boolean;
1718
1733
  };
1719
1734
  declare class AscTableComponent<T extends object = Record<string, unknown>> implements OnInit {
1735
+ /** Popover Quản lý cột: sửa vị trí mũi tên (PrimeNG trừ 2 × bo góc) — xem alignPopoverArrow */
1736
+ protected readonly alignPopoverArrow: typeof alignPopoverArrow;
1720
1737
  private readonly config;
1721
1738
  private readonly localeService;
1722
1739
  protected get msg(): _aseansc_ui.AscUIMessages;
@@ -2281,7 +2298,7 @@ declare class AscDialogComponent {
2281
2298
  * Kích thước dialog:
2282
2299
  * 'sm' = 28rem | 'md' = 36rem (default) | 'lg' = 48rem | 'xl' = 64rem | 'full' = 95vw
2283
2300
  */
2284
- readonly size: _angular_core.InputSignal<"sm" | "md" | "lg" | "xl" | "full">;
2301
+ readonly size: _angular_core.InputSignal<"full" | "sm" | "md" | "lg" | "xl">;
2285
2302
  /** Override width tuyệt đối — ưu tiên hơn size */
2286
2303
  readonly width: _angular_core.InputSignal<string>;
2287
2304
  readonly modal: _angular_core.InputSignal<boolean>;
@@ -2291,7 +2308,7 @@ declare class AscDialogComponent {
2291
2308
  readonly maximizable: _angular_core.InputSignal<boolean>;
2292
2309
  readonly draggable: _angular_core.InputSignal<boolean>;
2293
2310
  readonly resizable: _angular_core.InputSignal<boolean>;
2294
- readonly position: _angular_core.InputSignal<"left" | "right" | "top" | "bottom" | "center" | "topleft" | "topright" | "bottomleft" | "bottomright">;
2311
+ readonly position: _angular_core.InputSignal<"left" | "right" | "center" | "top" | "bottom" | "topleft" | "topright" | "bottomleft" | "bottomright">;
2295
2312
  /** Hiện footer mặc định với 2 nút confirm/cancel */
2296
2313
  readonly showFooter: _angular_core.InputSignal<boolean>;
2297
2314
  readonly confirmLabel: _angular_core.InputSignal<string>;
@@ -2343,6 +2360,8 @@ declare class AscPopoverComponent {
2343
2360
  toggle(event: MouseEvent, target?: HTMLElement): void;
2344
2361
  show(event: MouseEvent, target?: HTMLElement): void;
2345
2362
  hide(): void;
2363
+ /** Sửa vị trí mũi tên (PrimeNG trừ 2 × bo góc) rồi mới báo ra ngoài — xem alignPopoverArrow */
2364
+ protected handleShow(): void;
2346
2365
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<AscPopoverComponent, never>;
2347
2366
  static ɵcmp: _angular_core.ɵɵComponentDeclaration<AscPopoverComponent, "asc-popover", never, { "dismissable": { "alias": "dismissable"; "required": false; "isSignal": true; }; "appendTo": { "alias": "appendTo"; "required": false; "isSignal": true; }; "styleClass": { "alias": "styleClass"; "required": false; "isSignal": true; }; "motionOptions": { "alias": "motionOptions"; "required": false; "isSignal": true; }; }, { "onShow": "onShow"; "onHide": "onHide"; }, never, ["*"], true, never>;
2348
2367
  }
@@ -2372,7 +2391,7 @@ declare class AscSidebarComponent {
2372
2391
  protected readonly headerLabel: _angular_core.Signal<string>;
2373
2392
  readonly headerIcon: _angular_core.InputSignal<string>;
2374
2393
  readonly position: _angular_core.InputSignal<"left" | "right" | "top" | "bottom">;
2375
- readonly size: _angular_core.InputSignal<"sm" | "md" | "lg" | "xl" | "full">;
2394
+ readonly size: _angular_core.InputSignal<"full" | "sm" | "md" | "lg" | "xl">;
2376
2395
  /** Override width/height tuyệt đối */
2377
2396
  readonly customSize: _angular_core.InputSignal<string>;
2378
2397
  readonly modal: _angular_core.InputSignal<boolean>;