@comitor/ui 2.0.0 → 3.0.0

package/dist/components/ui/mention.js

@@ -0,0 +1,126 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import * as MentionPrimitive from "@diceui/mention";
+import { useDirection } from "@radix-ui/react-direction";
+import * as React from "react";
+import { useComitorMessages } from "../../i18n/locale-provider.js";
+import { cn } from "../../lib/cn.js";
+const MentionListIdContext = React.createContext(void 0);
+function Mention({ className, dir: dirProp, ...props }) {
+  const dir = useDirection(dirProp);
+  const listId = React.useId();
+  return /* @__PURE__ */ jsx(MentionListIdContext.Provider, { value: listId, children: /* @__PURE__ */ jsx(
+    MentionPrimitive.Root,
+    {
+      "data-slot": "mention",
+      dir,
+      className: cn(
+        /*
+         * Khối `@Tên` đã chèn. Gói vẽ nó bằng một lớp phủ (`MentionHighlighter`) định vị TUYỆT
+         * ĐỐI nằm ĐÈ LÊN ô nhập: chữ thường của lớp phủ trong suốt để lộ chữ của ô bên dưới,
+         * chỉ đoạn `[data-tag]` là có nền.
+         *
+         * ⚠ Khác thượng nguồn: bản gốc tô `bg-blue-200 text-blue-950` / `dark:bg-blue-800
+         * dark:text-blue-50` (bảng màu mặc định của Tailwind). Đổi sang cặp tonal của gói
+         * (`info` = teal — bậc "xanh" của Comitor), và CHỮ là `text-foreground` chứ không phải
+         * `text-info-ink`: nền tint `/15` trong suốt nên chữ của ô nhập vẫn lộ ra dưới khối,
+         * chữ khối vẽ đè đúng chỗ đó — hai lớp chữ phải CÙNG MÀU, lệch màu là thành viền răng
+         * cưa quanh từng nét. (Bản gốc cũng chọn chữ gần như trùng màu chữ thường ở cả hai theme.)
+         * Khối không chỉ nói bằng màu: nó luôn mang ký tự kích hoạt `@` ở đầu.
+         *     chữ ⇄ khối: 15,69:1 (light, trên nền trắng) · 15,15:1 (dark) · tệ nhất 13,44:1
+         *     (dark tương phản cao, `--teal` #2DD4BF). Khối ⇄ nền trang 1,21:1 — cố ý nhạt.
+         */
+        "**:data-tag:rounded **:data-tag:bg-info/15 **:data-tag:py-px **:data-tag:text-foreground",
+        className
+      ),
+      ...props
+    }
+  ) });
+}
+function MentionLabel({ className, ...props }) {
+  return /* @__PURE__ */ jsx(
+    MentionPrimitive.Label,
+    {
+      "data-slot": "mention-label",
+      className: cn("px-0.5 py-1.5 text-sm font-semibold", className),
+      ...props
+    }
+  );
+}
+function MentionInput({ className, ...props }) {
+  const listId = React.useContext(MentionListIdContext);
+  return /* @__PURE__ */ jsx(
+    MentionPrimitive.Input,
+    {
+      "data-slot": "mention-input",
+      "aria-controls": listId,
+      className: cn(
+        /*
+         * Khuôn viền/focus của `Input`: `border-input` lúc nghỉ, `--control-edge-strong` khi rê,
+         * `--primary-ink` + `ring-2 ring/50` khi focus. Nền theo `Textarea` (ô soạn tin thường là
+         * `asChild` + `<textarea>`): trong suốt, ở dark tô `--input-fill` — không `bg-input/30`,
+         * xem chú thích đầu textarea.tsx.
+         * ⚠ Khác thượng nguồn: `focus-visible:ring-1 ring-ring` → khuôn focus của `Input`; bỏ
+         * `shadow-xs` (bóng của gói chỉ đi qua `--elevation-*`, `Input` không có bóng).
+         */
+        "flex w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm text-foreground transition-colors duration-150 ease-out placeholder:text-muted-foreground hover:border-control-edge-strong focus:border-primary-ink focus:outline-none focus:ring-2 focus:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 dark:bg-input-fill",
+        className
+      ),
+      ...props
+    }
+  );
+}
+function MentionContent({ className, children, "aria-label": ariaLabelProp, ...props }) {
+  const listId = React.useContext(MentionListIdContext);
+  const t = useComitorMessages("mention");
+  const ariaLabel = ariaLabelProp ?? t.listLabel;
+  return /* @__PURE__ */ jsx(MentionPrimitive.Portal, { children: /* @__PURE__ */ jsx(
+    MentionPrimitive.Content,
+    {
+      "data-slot": "mention-content",
+      id: listId,
+      "aria-label": ariaLabel,
+      className: cn(
+        /*
+         * Mặt nổi cùng bộ với `PopoverContent`/`Command`: `bg-popover text-popover-foreground`,
+         * bóng `shadow-overlay` (đổi theo theme qua `--elevation-*`).
+         * ⚠ Khác thượng nguồn: `shadow-md` → `shadow-overlay`; thêm `origin-(--dice-transform-origin)`
+         * — biến gói headless tính sẵn theo cạnh bám, để hiệu ứng `zoom-in-95` nở ra TỪ phía con
+         * trỏ như `PopoverContent` (bản gốc nở từ tâm).
+         */
+        "relative z-50 min-w-32 origin-(--dice-transform-origin) overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-overlay 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 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95",
+        className
+      ),
+      ...props,
+      children
+    }
+  ) });
+}
+function MentionItem({ className, children, ...props }) {
+  return /* @__PURE__ */ jsx(
+    MentionPrimitive.Item,
+    {
+      "data-slot": "mention-item",
+      className: cn(
+        /*
+         * ⚠ Khác thượng nguồn: bộ lớp của `CommandItem` (mục đang sáng `bg-accent`/`text-accent-
+         * foreground`, khoảng đệm theo trục mật độ `--menu-item-py`, icon con mặc định
+         * `text-muted-foreground` cỡ 4) — chỉ đổi thuộc tính trạng thái sang dạng của gói headless
+         * (`data-highlighted` / `data-disabled` là thuộc tính CÓ MẶT, không phải `="true"`).
+         */
+        "relative mt-1 flex w-full cursor-default items-center gap-2 rounded-sm px-2 py-(--menu-item-py) text-sm outline-hidden select-none first:mt-0 data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-muted-foreground",
+        className
+      ),
+      ...props,
+      children
+    }
+  );
+}
+export {
+  Mention,
+  MentionContent,
+  MentionInput,
+  MentionItem,
+  MentionLabel
+};
+//# sourceMappingURL=mention.js.map

package/dist/components/ui/mention.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/ui/mention.tsx"],"sourcesContent":["\"use client\";\n\n/*\n * Port từ Dice UI (https://diceui.com/docs/components/mention) — MIT, © 2024 Sadman Sakib.\n * Giữ nguyên cấu trúc thượng nguồn để còn đối chiếu ngược được; mọi chỗ đổi đều có chú thích.\n */\n\nimport * as MentionPrimitive from \"@diceui/mention\";\nimport { useDirection } from \"@radix-ui/react-direction\";\nimport * as React from \"react\";\nimport { useComitorMessages } from \"../../i18n/locale-provider.js\";\nimport { cn } from \"../../lib/cn.js\";\n\n/*\n * ⚠ Khác thượng nguồn: context RIÊNG của lớp bọc, chỉ mang một id — xem chú thích ở `MentionInput`.\n */\nconst MentionListIdContext = React.createContext<string | undefined>(undefined);\n\n/**\n * Mention — ô nhập có gợi ý `@nhắc tên`: gõ ký tự kích hoạt (mặc định `@`) là mở danh sách, chọn\n * một mục thì chèn `@Tên` vào ô và đánh dấu nó thành một khối (xoá là xoá cả khối).\n * Dùng cho ô soạn tin của Chat và bình luận trong task.\n *\n * Phần lõi (dò ký tự kích hoạt, lọc, điều hướng bàn phím, định vị danh sách theo con trỏ) là gói\n * headless `@diceui/mention`; file này chỉ phủ style theo token của Comitor.\n */\ntype MentionProps = React.ComponentProps<typeof MentionPrimitive.Root>;\n\nfunction Mention({ className, dir: dirProp, ...props }: MentionProps) {\n  /*\n   * ⚠ Khác thượng nguồn: `@diceui/shared` có `useDirection` RIÊNG, đọc một `DirectionContext` mà\n   * gói không xuất ra — nên `DirectionProvider` của Radix (nguồn hướng chữ của mọi component khác\n   * trong gói) không tới được nó. Đọc hướng từ Radix rồi truyền xuống bằng prop `dir`.\n   */\n  const dir = useDirection(dirProp);\n  const listId = React.useId();\n\n  return (\n    <MentionListIdContext.Provider value={listId}>\n      <MentionPrimitive.Root\n        data-slot=\"mention\"\n        dir={dir}\n        className={cn(\n          /*\n           * Khối `@Tên` đã chèn. Gói vẽ nó bằng một lớp phủ (`MentionHighlighter`) định vị TUYỆT\n           * ĐỐI nằm ĐÈ LÊN ô nhập: chữ thường của lớp phủ trong suốt để lộ chữ của ô bên dưới,\n           * chỉ đoạn `[data-tag]` là có nền.\n           *\n           * ⚠ Khác thượng nguồn: bản gốc tô `bg-blue-200 text-blue-950` / `dark:bg-blue-800\n           * dark:text-blue-50` (bảng màu mặc định của Tailwind). Đổi sang cặp tonal của gói\n           * (`info` = teal — bậc \"xanh\" của Comitor), và CHỮ là `text-foreground` chứ không phải\n           * `text-info-ink`: nền tint `/15` trong suốt nên chữ của ô nhập vẫn lộ ra dưới khối,\n           * chữ khối vẽ đè đúng chỗ đó — hai lớp chữ phải CÙNG MÀU, lệch màu là thành viền răng\n           * cưa quanh từng nét. (Bản gốc cũng chọn chữ gần như trùng màu chữ thường ở cả hai theme.)\n           * Khối không chỉ nói bằng màu: nó luôn mang ký tự kích hoạt `@` ở đầu.\n           *     chữ ⇄ khối: 15,69:1 (light, trên nền trắng) · 15,15:1 (dark) · tệ nhất 13,44:1\n           *     (dark tương phản cao, `--teal` #2DD4BF). Khối ⇄ nền trang 1,21:1 — cố ý nhạt.\n           */\n          \"**:data-tag:rounded **:data-tag:bg-info/15 **:data-tag:py-px **:data-tag:text-foreground\",\n          className\n        )}\n        {...props}\n      />\n    </MentionListIdContext.Provider>\n  );\n}\n\ntype MentionLabelProps = React.ComponentProps<typeof MentionPrimitive.Label>;\n\nfunction MentionLabel({ className, ...props }: MentionLabelProps) {\n  return (\n    <MentionPrimitive.Label\n      data-slot=\"mention-label\"\n      className={cn(\"px-0.5 py-1.5 text-sm font-semibold\", className)}\n      {...props}\n    />\n  );\n}\n\ntype MentionInputProps = React.ComponentProps<typeof MentionPrimitive.Input>;\n\n/**\n * Ô nhập của `Mention`. Muốn nhiều dòng (ô soạn tin) thì `asChild` với một `<textarea />`.\n * Không có `MentionLabel` thì PHẢI truyền `aria-label`.\n */\nfunction MentionInput({ className, ...props }: MentionInputProps) {\n  const listId = React.useContext(MentionListIdContext);\n\n  return (\n    <MentionPrimitive.Input\n      data-slot=\"mention-input\"\n      /*\n       * ⚠ Khác thượng nguồn (a11y): ô nhập là `role=\"combobox\"` và gói đặt `aria-controls` trỏ tới\n       * một id sinh trong gốc — nhưng `MentionContent` của gói KHÔNG gắn id đó lên `role=\"listbox\"`,\n       * nên quan hệ combobox → listbox trỏ vào hư không. Lớp bọc tự sinh một id, gắn ở CẢ HAI đầu\n       * (props của ta được trải SAU props của gói nên thắng).\n       */\n      aria-controls={listId}\n      className={cn(\n        /*\n         * Khuôn viền/focus của `Input`: `border-input` lúc nghỉ, `--control-edge-strong` khi rê,\n         * `--primary-ink` + `ring-2 ring/50` khi focus. Nền theo `Textarea` (ô soạn tin thường là\n         * `asChild` + `<textarea>`): trong suốt, ở dark tô `--input-fill` — không `bg-input/30`,\n         * xem chú thích đầu textarea.tsx.\n         * ⚠ Khác thượng nguồn: `focus-visible:ring-1 ring-ring` → khuôn focus của `Input`; bỏ\n         * `shadow-xs` (bóng của gói chỉ đi qua `--elevation-*`, `Input` không có bóng).\n         */\n        \"flex w-full rounded-md border border-input bg-transparent px-3 py-2 text-sm text-foreground transition-colors duration-150 ease-out placeholder:text-muted-foreground hover:border-control-edge-strong focus:border-primary-ink focus:outline-none focus:ring-2 focus:ring-ring/50 disabled:cursor-not-allowed disabled:opacity-50 dark:bg-input-fill\",\n        className\n      )}\n      {...props}\n    />\n  );\n}\n\ntype MentionContentProps = React.ComponentProps<typeof MentionPrimitive.Content>;\n\n/**\n * Danh sách gợi ý (`role=\"listbox\"`), render qua portal.\n * Tên cho trình đọc màn hình mặc định là khoá `listLabel` của namespace `mention`\n * (`ComitorLocaleProvider`) — đổi bằng `aria-label`.\n */\nfunction MentionContent({ className, children, \"aria-label\": ariaLabelProp, ...props }: MentionContentProps) {\n  const listId = React.useContext(MentionListIdContext);\n  const t = useComitorMessages(\"mention\");\n  const ariaLabel = ariaLabelProp ?? t.listLabel;\n\n  return (\n    <MentionPrimitive.Portal>\n      <MentionPrimitive.Content\n        data-slot=\"mention-content\"\n        // ⚠ Khác thượng nguồn (a11y): id để `aria-controls` của ô nhập trỏ tới được — xem\n        // `MentionInput`. Và `role=\"listbox\"` BẮT BUỘC có tên (ARIA 1.2); bản gốc không đặt.\n        id={listId}\n        aria-label={ariaLabel}\n        className={cn(\n          /*\n           * Mặt nổi cùng bộ với `PopoverContent`/`Command`: `bg-popover text-popover-foreground`,\n           * bóng `shadow-overlay` (đổi theo theme qua `--elevation-*`).\n           * ⚠ Khác thượng nguồn: `shadow-md` → `shadow-overlay`; thêm `origin-(--dice-transform-origin)`\n           * — biến gói headless tính sẵn theo cạnh bám, để hiệu ứng `zoom-in-95` nở ra TỪ phía con\n           * trỏ như `PopoverContent` (bản gốc nở từ tâm).\n           */\n          \"relative z-50 min-w-32 origin-(--dice-transform-origin) overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-overlay 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 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95\",\n          className\n        )}\n        {...props}\n      >\n        {children}\n      </MentionPrimitive.Content>\n    </MentionPrimitive.Portal>\n  );\n}\n\ntype MentionItemProps = React.ComponentProps<typeof MentionPrimitive.Item>;\n\nfunction MentionItem({ className, children, ...props }: MentionItemProps) {\n  return (\n    <MentionPrimitive.Item\n      data-slot=\"mention-item\"\n      className={cn(\n        /*\n         * ⚠ Khác thượng nguồn: bộ lớp của `CommandItem` (mục đang sáng `bg-accent`/`text-accent-\n         * foreground`, khoảng đệm theo trục mật độ `--menu-item-py`, icon con mặc định\n         * `text-muted-foreground` cỡ 4) — chỉ đổi thuộc tính trạng thái sang dạng của gói headless\n         * (`data-highlighted` / `data-disabled` là thuộc tính CÓ MẶT, không phải `=\"true\"`).\n         */\n        \"relative mt-1 flex w-full cursor-default items-center gap-2 rounded-sm px-2 py-(--menu-item-py) text-sm outline-hidden select-none first:mt-0 data-disabled:pointer-events-none data-disabled:opacity-50 data-highlighted:bg-accent data-highlighted:text-accent-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-muted-foreground\",\n        className\n      )}\n      {...props}\n    >\n      {children}\n    </MentionPrimitive.Item>\n  );\n}\n\nexport {\n  Mention,\n  MentionContent,\n  type MentionContentProps,\n  MentionInput,\n  type MentionInputProps,\n  MentionItem,\n  type MentionItemProps,\n  MentionLabel,\n  type MentionLabelProps,\n  type MentionProps\n};\n"],"mappings":";AAuCM;AAhCN,YAAY,sBAAsB;AAClC,SAAS,oBAAoB;AAC7B,YAAY,WAAW;AACvB,SAAS,0BAA0B;AACnC,SAAS,UAAU;AAKnB,MAAM,uBAAuB,MAAM,cAAkC,MAAS;AAY9E,SAAS,QAAQ,EAAE,WAAW,KAAK,SAAS,GAAG,MAAM,GAAiB;AAMpE,QAAM,MAAM,aAAa,OAAO;AAChC,QAAM,SAAS,MAAM,MAAM;AAE3B,SACE,oBAAC,qBAAqB,UAArB,EAA8B,OAAO,QACpC;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MACV;AAAA,MACA,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAgBT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN,GACF;AAEJ;AAIA,SAAS,aAAa,EAAE,WAAW,GAAG,MAAM,GAAsB;AAChE,SACE;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MACV,WAAW,GAAG,uCAAuC,SAAS;AAAA,MAC7D,GAAG;AAAA;AAAA,EACN;AAEJ;AAQA,SAAS,aAAa,EAAE,WAAW,GAAG,MAAM,GAAsB;AAChE,QAAM,SAAS,MAAM,WAAW,oBAAoB;AAEpD,SACE;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MAOV,iBAAe;AAAA,MACf,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAST;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AASA,SAAS,eAAe,EAAE,WAAW,UAAU,cAAc,eAAe,GAAG,MAAM,GAAwB;AAC3G,QAAM,SAAS,MAAM,WAAW,oBAAoB;AACpD,QAAM,IAAI,mBAAmB,SAAS;AACtC,QAAM,YAAY,iBAAiB,EAAE;AAErC,SACE,oBAAC,iBAAiB,QAAjB,EACC;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MAGV,IAAI;AAAA,MACJ,cAAY;AAAA,MACZ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAQT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH,GACF;AAEJ;AAIA,SAAS,YAAY,EAAE,WAAW,UAAU,GAAG,MAAM,GAAqB;AACxE,SACE;AAAA,IAAC,iBAAiB;AAAA,IAAjB;AAAA,MACC,aAAU;AAAA,MACV,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAOT;AAAA,QACA;AAAA,MACF;AAAA,MACC,GAAG;AAAA,MAEH;AAAA;AAAA,EACH;AAEJ;","names":[]}

package/dist/components/ui/pagination.d.ts

@@ -4,10 +4,14 @@ import 'class-variance-authority/types';
 import 'class-variance-authority';
 
 /**
- * Pagination — primitive tĩnh (không "use client", dùng được trong RSC).
- * Đây là bộ khung thẻ `<a>`; bản "biết đếm trang" là composite `TablePagination`.
+ * Pagination — bộ khung thẻ `<a>`; bản "biết đếm trang" là composite `TablePagination`.
  *
- * Chuỗi hiển thị mặc định tiếng Việt, override qua prop `label` / `srLabel`.
+ * Chuỗi hiển thị theo `ComitorLocaleProvider` (namespace `pagination`, mặc định tiếng Anh);
+ * override từng chỗ qua prop `label` / `srLabel` / `aria-label`.
+ *
+ * `"use client"` từ `3.0.0`: chữ và tên cho trình đọc màn hình đọc từ provider, mà context chỉ
+ * đọc được ở client. Trước đó file này tĩnh và ghim cứng tiếng Việt. Không prop nào là
+ * hàm/component nên Server Component vẫn render được nó.
  * Muốn dùng `next/link`: `<PaginationLink asChild>` chưa có ở primitive này —
  * truyền `href` trực tiếp hoặc bọc bằng composite ở tầng app.
  */
@@ -18,23 +22,23 @@ type PaginationLinkProps = {
     isActive?: boolean;
 } & Pick<ButtonProps, "size"> & React.ComponentProps<"a">;
 type PaginationPreviousProps = PaginationLinkProps & {
-    /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định "Trước". */
+    /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định: khoá `previousLabel` của namespace `pagination`. */
     label?: React.ReactNode;
 };
 type PaginationNextProps = PaginationLinkProps & {
-    /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định "Sau". */
+    /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định: khoá `nextLabel` của namespace `pagination`. */
     label?: React.ReactNode;
 };
 type PaginationEllipsisProps = React.ComponentProps<"span"> & {
-    /** Nhãn chỉ dành cho trình đọc màn hình. */
+    /** Nhãn chỉ dành cho trình đọc màn hình. Mặc định: khoá `ellipsisLabel` của namespace `pagination`. */
     srLabel?: string;
 };
 declare function Pagination({ className, ...props }: PaginationProps): React.JSX.Element;
 declare function PaginationContent({ className, ...props }: PaginationContentProps): React.JSX.Element;
 declare function PaginationItem({ ...props }: PaginationItemProps): React.JSX.Element;
 declare function PaginationLink({ className, isActive, size, ...props }: PaginationLinkProps): React.JSX.Element;
-declare function PaginationPrevious({ className, label, ...props }: PaginationPreviousProps): React.JSX.Element;
-declare function PaginationNext({ className, label, ...props }: PaginationNextProps): React.JSX.Element;
-declare function PaginationEllipsis({ className, srLabel, ...props }: PaginationEllipsisProps): React.JSX.Element;
+declare function PaginationPrevious({ className, label: labelProp, ...props }: PaginationPreviousProps): React.JSX.Element;
+declare function PaginationNext({ className, label: labelProp, ...props }: PaginationNextProps): React.JSX.Element;
+declare function PaginationEllipsis({ className, srLabel: srLabelProp, ...props }: PaginationEllipsisProps): React.JSX.Element;
 
 export { Pagination, PaginationContent, type PaginationContentProps, PaginationEllipsis, type PaginationEllipsisProps, PaginationItem, type PaginationItemProps, PaginationLink, type PaginationLinkProps, PaginationNext, type PaginationNextProps, PaginationPrevious, type PaginationPreviousProps, type PaginationProps };

package/dist/components/ui/pagination.js

@@ -1,14 +1,17 @@
+"use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ChevronLeftIcon, ChevronRightIcon, MoreHorizontalIcon } from "lucide-react";
+import { useComitorMessages } from "../../i18n/locale-provider.js";
 import { cn } from "../../lib/cn.js";
 import { buttonVariants } from "./button.js";
 function Pagination({ className, ...props }) {
+  const t = useComitorMessages("pagination");
   return (
     // Thẻ <nav> đã ngầm mang role="navigation" — bản comitor-ds khai lại là thừa, bỏ đi.
     /* @__PURE__ */ jsx(
       "nav",
       {
-        "aria-label": "Ph\xE2n trang",
+        "aria-label": t.navLabel,
         "data-slot": "pagination",
         className: cn("mx-auto flex w-full justify-center", className),
         ...props
@@ -38,11 +41,13 @@ function PaginationLink({ className, isActive, size = "icon", ...props }) {
     }
   );
 }
-function PaginationPrevious({ className, label = "Tr\u01B0\u1EDBc", ...props }) {
+function PaginationPrevious({ className, label: labelProp, ...props }) {
+  const t = useComitorMessages("pagination");
+  const label = labelProp === void 0 ? t.previousLabel : labelProp;
   return /* @__PURE__ */ jsxs(
     PaginationLink,
     {
-      "aria-label": "V\u1EC1 trang tr\u01B0\u1EDBc",
+      "aria-label": t.previousAriaLabel,
       size: "default",
       className: cn("gap-1 px-2.5 sm:pl-2.5", className),
       ...props,
@@ -53,11 +58,13 @@ function PaginationPrevious({ className, label = "Tr\u01B0\u1EDBc", ...props })
     }
   );
 }
-function PaginationNext({ className, label = "Sau", ...props }) {
+function PaginationNext({ className, label: labelProp, ...props }) {
+  const t = useComitorMessages("pagination");
+  const label = labelProp === void 0 ? t.nextLabel : labelProp;
   return /* @__PURE__ */ jsxs(
     PaginationLink,
     {
-      "aria-label": "T\u1EDBi trang sau",
+      "aria-label": t.nextAriaLabel,
       size: "default",
       className: cn("gap-1 px-2.5 sm:pr-2.5", className),
       ...props,
@@ -68,7 +75,9 @@ function PaginationNext({ className, label = "Sau", ...props }) {
     }
   );
 }
-function PaginationEllipsis({ className, srLabel = "Th\xEAm trang", ...props }) {
+function PaginationEllipsis({ className, srLabel: srLabelProp, ...props }) {
+  const t = useComitorMessages("pagination");
+  const srLabel = srLabelProp ?? t.ellipsisLabel;
   return /* @__PURE__ */ jsxs(
     "span",
     {

package/dist/components/ui/pagination.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/ui/pagination.tsx"],"sourcesContent":["import { ChevronLeftIcon, ChevronRightIcon, MoreHorizontalIcon } from \"lucide-react\";\nimport type * as React from \"react\";\nimport { cn } from \"../../lib/cn.js\";\nimport { type ButtonProps, buttonVariants } from \"./button.js\";\n\n/**\n * Pagination — primitive tĩnh (không \"use client\", dùng được trong RSC).\n * Đây là bộ khung thẻ `<a>`; bản \"biết đếm trang\" là composite `TablePagination`.\n *\n * Chuỗi hiển thị mặc định tiếng Việt, override qua prop `label` / `srLabel`.\n * Muốn dùng `next/link`: `<PaginationLink asChild>` chưa có ở primitive này —\n * truyền `href` trực tiếp hoặc bọc bằng composite ở tầng app.\n */\n\nexport type PaginationProps = React.ComponentProps<\"nav\">;\nexport type PaginationContentProps = React.ComponentProps<\"ul\">;\nexport type PaginationItemProps = React.ComponentProps<\"li\">;\nexport type PaginationLinkProps = {\n  isActive?: boolean;\n} & Pick<ButtonProps, \"size\"> &\n  React.ComponentProps<\"a\">;\nexport type PaginationPreviousProps = PaginationLinkProps & {\n  /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định \"Trước\". */\n  label?: React.ReactNode;\n};\nexport type PaginationNextProps = PaginationLinkProps & {\n  /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định \"Sau\". */\n  label?: React.ReactNode;\n};\nexport type PaginationEllipsisProps = React.ComponentProps<\"span\"> & {\n  /** Nhãn chỉ dành cho trình đọc màn hình. */\n  srLabel?: string;\n};\n\nfunction Pagination({ className, ...props }: PaginationProps) {\n  return (\n    // Thẻ <nav> đã ngầm mang role=\"navigation\" — bản comitor-ds khai lại là thừa, bỏ đi.\n    <nav\n      aria-label=\"Phân trang\"\n      data-slot=\"pagination\"\n      className={cn(\"mx-auto flex w-full justify-center\", className)}\n      {...props}\n    />\n  );\n}\n\nfunction PaginationContent({ className, ...props }: PaginationContentProps) {\n  return <ul data-slot=\"pagination-content\" className={cn(\"flex flex-row items-center gap-1\", className)} {...props} />;\n}\n\nfunction PaginationItem({ ...props }: PaginationItemProps) {\n  return <li data-slot=\"pagination-item\" {...props} />;\n}\n\n/*\n * Trang ĐANG XEM: viền là `border-primary-ink`, không phải `border-gold-300`. Nền `bg-gold-50`\n * chỉ 1,09:1 so với nền trang, nên VIỀN mới là thứ mang tín hiệu \"đang ở trang này\" — ngưỡng\n * 3:1. gold-300 #E8B824 trên nền trắng chỉ **1,86:1** ✗ (dark 10,19:1 nên chỉ light hỏng).\n * `--primary-ink`: 6,51:1 với nền trang · 5,96:1 với chính nền `gold-50` (light); 12,67:1 ·\n * 11,91:1 (dark) ✓. `aria-current=\"page\"` vẫn giữ nguyên cho phần trợ năng phi thị giác.\n */\nfunction PaginationLink({ className, isActive, size = \"icon\", ...props }: PaginationLinkProps) {\n  return (\n    <a\n      aria-current={isActive ? \"page\" : undefined}\n      data-slot=\"pagination-link\"\n      data-active={isActive}\n      className={cn(\n        buttonVariants({ variant: \"ghost\", size }),\n        isActive &&\n          \"border-primary-ink bg-gold-50 font-semibold text-foreground hover:bg-gold-50 dark:bg-gold-500/10 dark:hover:bg-gold-500/10\",\n        className\n      )}\n      {...props}\n    />\n  );\n}\n\nfunction PaginationPrevious({ className, label = \"Trước\", ...props }: PaginationPreviousProps) {\n  return (\n    <PaginationLink\n      aria-label=\"Về trang trước\"\n      size=\"default\"\n      className={cn(\"gap-1 px-2.5 sm:pl-2.5\", className)}\n      {...props}\n    >\n      <ChevronLeftIcon />\n      <span className=\"hidden sm:block\">{label}</span>\n    </PaginationLink>\n  );\n}\n\nfunction PaginationNext({ className, label = \"Sau\", ...props }: PaginationNextProps) {\n  return (\n    <PaginationLink\n      aria-label=\"Tới trang sau\"\n      size=\"default\"\n      className={cn(\"gap-1 px-2.5 sm:pr-2.5\", className)}\n      {...props}\n    >\n      <span className=\"hidden sm:block\">{label}</span>\n      <ChevronRightIcon />\n    </PaginationLink>\n  );\n}\n\nfunction PaginationEllipsis({ className, srLabel = \"Thêm trang\", ...props }: PaginationEllipsisProps) {\n  return (\n    <span\n      aria-hidden\n      data-slot=\"pagination-ellipsis\"\n      className={cn(\"flex size-9 items-center justify-center\", className)}\n      {...props}\n    >\n      <MoreHorizontalIcon className=\"size-4\" />\n      <span className=\"sr-only\">{srLabel}</span>\n    </span>\n  );\n}\n\nexport {\n  Pagination,\n  PaginationContent,\n  PaginationEllipsis,\n  PaginationItem,\n  PaginationLink,\n  PaginationNext,\n  PaginationPrevious\n};\n"],"mappings":"AAqCI,cA2CA,YA3CA;AArCJ,SAAS,iBAAiB,kBAAkB,0BAA0B;AAEtE,SAAS,UAAU;AACnB,SAA2B,sBAAsB;AA+BjD,SAAS,WAAW,EAAE,WAAW,GAAG,MAAM,GAAoB;AAC5D;AAAA;AAAA,IAEE;AAAA,MAAC;AAAA;AAAA,QACC,cAAW;AAAA,QACX,aAAU;AAAA,QACV,WAAW,GAAG,sCAAsC,SAAS;AAAA,QAC5D,GAAG;AAAA;AAAA,IACN;AAAA;AAEJ;AAEA,SAAS,kBAAkB,EAAE,WAAW,GAAG,MAAM,GAA2B;AAC1E,SAAO,oBAAC,QAAG,aAAU,sBAAqB,WAAW,GAAG,oCAAoC,SAAS,GAAI,GAAG,OAAO;AACrH;AAEA,SAAS,eAAe,EAAE,GAAG,MAAM,GAAwB;AACzD,SAAO,oBAAC,QAAG,aAAU,mBAAmB,GAAG,OAAO;AACpD;AASA,SAAS,eAAe,EAAE,WAAW,UAAU,OAAO,QAAQ,GAAG,MAAM,GAAwB;AAC7F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,gBAAc,WAAW,SAAS;AAAA,MAClC,aAAU;AAAA,MACV,eAAa;AAAA,MACb,WAAW;AAAA,QACT,eAAe,EAAE,SAAS,SAAS,KAAK,CAAC;AAAA,QACzC,YACE;AAAA,QACF;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AAEA,SAAS,mBAAmB,EAAE,WAAW,QAAQ,mBAAS,GAAG,MAAM,GAA4B;AAC7F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAW;AAAA,MACX,MAAK;AAAA,MACL,WAAW,GAAG,0BAA0B,SAAS;AAAA,MAChD,GAAG;AAAA,MAEJ;AAAA,4BAAC,mBAAgB;AAAA,QACjB,oBAAC,UAAK,WAAU,mBAAmB,iBAAM;AAAA;AAAA;AAAA,EAC3C;AAEJ;AAEA,SAAS,eAAe,EAAE,WAAW,QAAQ,OAAO,GAAG,MAAM,GAAwB;AACnF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAW;AAAA,MACX,MAAK;AAAA,MACL,WAAW,GAAG,0BAA0B,SAAS;AAAA,MAChD,GAAG;AAAA,MAEJ;AAAA,4BAAC,UAAK,WAAU,mBAAmB,iBAAM;AAAA,QACzC,oBAAC,oBAAiB;AAAA;AAAA;AAAA,EACpB;AAEJ;AAEA,SAAS,mBAAmB,EAAE,WAAW,UAAU,iBAAc,GAAG,MAAM,GAA4B;AACpG,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAW;AAAA,MACX,aAAU;AAAA,MACV,WAAW,GAAG,2CAA2C,SAAS;AAAA,MACjE,GAAG;AAAA,MAEJ;AAAA,4BAAC,sBAAmB,WAAU,UAAS;AAAA,QACvC,oBAAC,UAAK,WAAU,WAAW,mBAAQ;AAAA;AAAA;AAAA,EACrC;AAEJ;","names":[]}
+{"version":3,"sources":["../../../src/components/ui/pagination.tsx"],"sourcesContent":["\"use client\";\n\nimport { ChevronLeftIcon, ChevronRightIcon, MoreHorizontalIcon } from \"lucide-react\";\nimport type * as React from \"react\";\nimport { useComitorMessages } from \"../../i18n/locale-provider.js\";\nimport { cn } from \"../../lib/cn.js\";\nimport { type ButtonProps, buttonVariants } from \"./button.js\";\n\n/**\n * Pagination — bộ khung thẻ `<a>`; bản \"biết đếm trang\" là composite `TablePagination`.\n *\n * Chuỗi hiển thị theo `ComitorLocaleProvider` (namespace `pagination`, mặc định tiếng Anh);\n * override từng chỗ qua prop `label` / `srLabel` / `aria-label`.\n *\n * `\"use client\"` từ `3.0.0`: chữ và tên cho trình đọc màn hình đọc từ provider, mà context chỉ\n * đọc được ở client. Trước đó file này tĩnh và ghim cứng tiếng Việt. Không prop nào là\n * hàm/component nên Server Component vẫn render được nó.\n * Muốn dùng `next/link`: `<PaginationLink asChild>` chưa có ở primitive này —\n * truyền `href` trực tiếp hoặc bọc bằng composite ở tầng app.\n */\n\nexport type PaginationProps = React.ComponentProps<\"nav\">;\nexport type PaginationContentProps = React.ComponentProps<\"ul\">;\nexport type PaginationItemProps = React.ComponentProps<\"li\">;\nexport type PaginationLinkProps = {\n  isActive?: boolean;\n} & Pick<ButtonProps, \"size\"> &\n  React.ComponentProps<\"a\">;\nexport type PaginationPreviousProps = PaginationLinkProps & {\n  /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định: khoá `previousLabel` của namespace `pagination`. */\n  label?: React.ReactNode;\n};\nexport type PaginationNextProps = PaginationLinkProps & {\n  /** Nhãn hiển thị (ẩn ở màn hình nhỏ). Mặc định: khoá `nextLabel` của namespace `pagination`. */\n  label?: React.ReactNode;\n};\nexport type PaginationEllipsisProps = React.ComponentProps<\"span\"> & {\n  /** Nhãn chỉ dành cho trình đọc màn hình. Mặc định: khoá `ellipsisLabel` của namespace `pagination`. */\n  srLabel?: string;\n};\n\nfunction Pagination({ className, ...props }: PaginationProps) {\n  const t = useComitorMessages(\"pagination\");\n  return (\n    // Thẻ <nav> đã ngầm mang role=\"navigation\" — bản comitor-ds khai lại là thừa, bỏ đi.\n    <nav\n      aria-label={t.navLabel}\n      data-slot=\"pagination\"\n      className={cn(\"mx-auto flex w-full justify-center\", className)}\n      {...props}\n    />\n  );\n}\n\nfunction PaginationContent({ className, ...props }: PaginationContentProps) {\n  return <ul data-slot=\"pagination-content\" className={cn(\"flex flex-row items-center gap-1\", className)} {...props} />;\n}\n\nfunction PaginationItem({ ...props }: PaginationItemProps) {\n  return <li data-slot=\"pagination-item\" {...props} />;\n}\n\n/*\n * Trang ĐANG XEM: viền là `border-primary-ink`, không phải `border-gold-300`. Nền `bg-gold-50`\n * chỉ 1,09:1 so với nền trang, nên VIỀN mới là thứ mang tín hiệu \"đang ở trang này\" — ngưỡng\n * 3:1. gold-300 #E8B824 trên nền trắng chỉ **1,86:1** ✗ (dark 10,19:1 nên chỉ light hỏng).\n * `--primary-ink`: 6,51:1 với nền trang · 5,96:1 với chính nền `gold-50` (light); 12,67:1 ·\n * 11,91:1 (dark) ✓. `aria-current=\"page\"` vẫn giữ nguyên cho phần trợ năng phi thị giác.\n */\nfunction PaginationLink({ className, isActive, size = \"icon\", ...props }: PaginationLinkProps) {\n  return (\n    <a\n      aria-current={isActive ? \"page\" : undefined}\n      data-slot=\"pagination-link\"\n      data-active={isActive}\n      className={cn(\n        buttonVariants({ variant: \"ghost\", size }),\n        isActive &&\n          \"border-primary-ink bg-gold-50 font-semibold text-foreground hover:bg-gold-50 dark:bg-gold-500/10 dark:hover:bg-gold-500/10\",\n        className\n      )}\n      {...props}\n    />\n  );\n}\n\nfunction PaginationPrevious({ className, label: labelProp, ...props }: PaginationPreviousProps) {\n  const t = useComitorMessages(\"pagination\");\n  // `=== undefined` chứ không `??`: `label` là ReactNode, `null` vẫn nghĩa là \"không hiện chữ\".\n  const label = labelProp === undefined ? t.previousLabel : labelProp;\n  return (\n    <PaginationLink\n      aria-label={t.previousAriaLabel}\n      size=\"default\"\n      className={cn(\"gap-1 px-2.5 sm:pl-2.5\", className)}\n      {...props}\n    >\n      <ChevronLeftIcon />\n      <span className=\"hidden sm:block\">{label}</span>\n    </PaginationLink>\n  );\n}\n\nfunction PaginationNext({ className, label: labelProp, ...props }: PaginationNextProps) {\n  const t = useComitorMessages(\"pagination\");\n  const label = labelProp === undefined ? t.nextLabel : labelProp;\n  return (\n    <PaginationLink\n      aria-label={t.nextAriaLabel}\n      size=\"default\"\n      className={cn(\"gap-1 px-2.5 sm:pr-2.5\", className)}\n      {...props}\n    >\n      <span className=\"hidden sm:block\">{label}</span>\n      <ChevronRightIcon />\n    </PaginationLink>\n  );\n}\n\nfunction PaginationEllipsis({ className, srLabel: srLabelProp, ...props }: PaginationEllipsisProps) {\n  const t = useComitorMessages(\"pagination\");\n  const srLabel = srLabelProp ?? t.ellipsisLabel;\n  return (\n    <span\n      aria-hidden\n      data-slot=\"pagination-ellipsis\"\n      className={cn(\"flex size-9 items-center justify-center\", className)}\n      {...props}\n    >\n      <MoreHorizontalIcon className=\"size-4\" />\n      <span className=\"sr-only\">{srLabel}</span>\n    </span>\n  );\n}\n\nexport {\n  Pagination,\n  PaginationContent,\n  PaginationEllipsis,\n  PaginationItem,\n  PaginationLink,\n  PaginationNext,\n  PaginationPrevious\n};\n"],"mappings":";AA6CI,cA8CA,YA9CA;AA3CJ,SAAS,iBAAiB,kBAAkB,0BAA0B;AAEtE,SAAS,0BAA0B;AACnC,SAAS,UAAU;AACnB,SAA2B,sBAAsB;AAmCjD,SAAS,WAAW,EAAE,WAAW,GAAG,MAAM,GAAoB;AAC5D,QAAM,IAAI,mBAAmB,YAAY;AACzC;AAAA;AAAA,IAEE;AAAA,MAAC;AAAA;AAAA,QACC,cAAY,EAAE;AAAA,QACd,aAAU;AAAA,QACV,WAAW,GAAG,sCAAsC,SAAS;AAAA,QAC5D,GAAG;AAAA;AAAA,IACN;AAAA;AAEJ;AAEA,SAAS,kBAAkB,EAAE,WAAW,GAAG,MAAM,GAA2B;AAC1E,SAAO,oBAAC,QAAG,aAAU,sBAAqB,WAAW,GAAG,oCAAoC,SAAS,GAAI,GAAG,OAAO;AACrH;AAEA,SAAS,eAAe,EAAE,GAAG,MAAM,GAAwB;AACzD,SAAO,oBAAC,QAAG,aAAU,mBAAmB,GAAG,OAAO;AACpD;AASA,SAAS,eAAe,EAAE,WAAW,UAAU,OAAO,QAAQ,GAAG,MAAM,GAAwB;AAC7F,SACE;AAAA,IAAC;AAAA;AAAA,MACC,gBAAc,WAAW,SAAS;AAAA,MAClC,aAAU;AAAA,MACV,eAAa;AAAA,MACb,WAAW;AAAA,QACT,eAAe,EAAE,SAAS,SAAS,KAAK,CAAC;AAAA,QACzC,YACE;AAAA,QACF;AAAA,MACF;AAAA,MACC,GAAG;AAAA;AAAA,EACN;AAEJ;AAEA,SAAS,mBAAmB,EAAE,WAAW,OAAO,WAAW,GAAG,MAAM,GAA4B;AAC9F,QAAM,IAAI,mBAAmB,YAAY;AAEzC,QAAM,QAAQ,cAAc,SAAY,EAAE,gBAAgB;AAC1D,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,EAAE;AAAA,MACd,MAAK;AAAA,MACL,WAAW,GAAG,0BAA0B,SAAS;AAAA,MAChD,GAAG;AAAA,MAEJ;AAAA,4BAAC,mBAAgB;AAAA,QACjB,oBAAC,UAAK,WAAU,mBAAmB,iBAAM;AAAA;AAAA;AAAA,EAC3C;AAEJ;AAEA,SAAS,eAAe,EAAE,WAAW,OAAO,WAAW,GAAG,MAAM,GAAwB;AACtF,QAAM,IAAI,mBAAmB,YAAY;AACzC,QAAM,QAAQ,cAAc,SAAY,EAAE,YAAY;AACtD,SACE;AAAA,IAAC;AAAA;AAAA,MACC,cAAY,EAAE;AAAA,MACd,MAAK;AAAA,MACL,WAAW,GAAG,0BAA0B,SAAS;AAAA,MAChD,GAAG;AAAA,MAEJ;AAAA,4BAAC,UAAK,WAAU,mBAAmB,iBAAM;AAAA,QACzC,oBAAC,oBAAiB;AAAA;AAAA;AAAA,EACpB;AAEJ;AAEA,SAAS,mBAAmB,EAAE,WAAW,SAAS,aAAa,GAAG,MAAM,GAA4B;AAClG,QAAM,IAAI,mBAAmB,YAAY;AACzC,QAAM,UAAU,eAAe,EAAE;AACjC,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAW;AAAA,MACX,aAAU;AAAA,MACV,WAAW,GAAG,2CAA2C,SAAS;AAAA,MACjE,GAAG;AAAA,MAEJ;AAAA,4BAAC,sBAAmB,WAAU,UAAS;AAAA,QACvC,oBAAC,UAAK,WAAU,WAAW,mBAAQ;AAAA;AAAA;AAAA,EACrC;AAEJ;","names":[]}

package/dist/components/ui/phone-input-constants.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Kiểu quốc gia và nhãn mặc định của `PhoneInput`.
+ *
+ * Module **CỐ Ý không có `"use client"`** — xem `src/chart/chart-colors.ts` để biết lý do đầy
+ * đủ: mọi export của một file `"use client"` đến tay Server Component dưới dạng
+ * client-reference proxy, đọc ra `undefined` mà KHÔNG throw, KHÔNG warning. Hằng dữ liệu thuần
+ * (nhãn mặc định) phải sống ngoài ranh giới client để app spread/override được ở cả hai phía.
+ *
+ * ⚠ Barrel `src/index.ts` xuất module này TRỰC TIẾP. `phone-input.tsx` chỉ được `import`,
+ * KHÔNG được `export` lại (re-export qua file client là vô hiệu, và đụng tên với `export *`).
+ */
+/**
+ * Một quốc gia trong danh sách chọn của `PhoneInput` — cũng là hình dạng của prop `countries`
+ * khi app muốn tự giới hạn danh sách.
+ *
+ * ⚠ Khác thượng nguồn: thượng nguồn khai kiểu này dưới tên `Country` và KHÔNG export (app phải
+ * viết `PhoneInputProps["countries"]`). Ở đây export dưới tên có tiền tố — `Country` trần là tên
+ * quá chung cho entry chính.
+ */
+interface PhoneInputCountry {
+    /** Mã ISO 3166-1 alpha-2, viết HOA — `"VN"`. */
+    code: string;
+    /** Tên hiển thị trong danh sách và trong nhãn của nút chọn — `"Vietnam"` (theo `locale`). */
+    name: string;
+    /** Mã quay số quốc tế, có dấu `+` — `"+84"`. */
+    dialCode: string;
+    /** Cờ emoji — `"🇻🇳"`. Bỏ trống thì không vẽ cờ. */
+    flag?: string;
+}
+/**
+ * Chuỗi hiển thị của `PhoneInput` (kể cả chuỗi chỉ dành cho trình đọc màn hình). Theo
+ * `ComitorLocaleProvider` (mặc định tiếng Anh, bảng tiếng Việt dựng sẵn); override từng khoá qua
+ * prop `labels`.
+ *
+ * Tên quốc gia KHÔNG nằm ở đây — `Intl.DisplayNames` gọi theo `locale` (prop `locale` của
+ * `PhoneInput`, không truyền thì `locale` của provider).
+ */
+interface PhoneInputLabels {
+    /**
+     * Tên cho trình đọc màn hình của nút chọn quốc gia. Nhận quốc gia đang chọn (`undefined` khi
+     * chưa chọn) vì tên phải nói được GIÁ TRỊ hiện tại — nút chỉ chứa một lá cờ emoji.
+     *
+     * ⚠ Thêm so với thượng nguồn: ở bản gốc nút này KHÔNG có tên (lá cờ + mũi tên, hoặc một ô xám
+     * trống khi chưa chọn). Là HÀM chứ không phải chuỗi mẫu vì có giá trị chèn vào giữa câu.
+     */
+    countrySelect: (country: PhoneInputCountry | undefined) => string;
+    /** Placeholder ô tìm kiếm trong danh sách quốc gia. */
+    searchPlaceholder: string;
+    /** Dòng báo khi không quốc gia nào khớp từ khoá. */
+    empty: string;
+    /**
+     * Placeholder của ô nhập số. Prop `placeholder` rời (tên của thượng nguồn — trên `PhoneInput`,
+     * hoặc trên chính `PhoneInputField`) thắng khoá này nếu có. Thêm ở `3.0.0`: trước đó placeholder
+     * chỉ là mặc định viết thẳng trong component.
+     */
+    placeholder: string;
+}
+/**
+ * Nhãn TIẾNG ANH mặc định (từ `3.0.0`; trước đó là tiếng Việt). Bảng tiếng Việt:
+ * `comitorMessagesVi.phoneInput`. Component không đọc thẳng hằng này — nó đọc bảng của
+ * `ComitorLocaleProvider`; hằng ở đây để app trải ra khi tự dựng nhãn.
+ */
+declare const DEFAULT_PHONE_INPUT_LABELS: PhoneInputLabels;
+
+export { DEFAULT_PHONE_INPUT_LABELS, type PhoneInputCountry, type PhoneInputLabels };

package/dist/components/ui/phone-input-constants.js

@@ -0,0 +1,6 @@
+import { phoneInputEn } from "../../i18n/namespaces/phone-input.js";
+const DEFAULT_PHONE_INPUT_LABELS = { ...phoneInputEn };
+export {
+  DEFAULT_PHONE_INPUT_LABELS
+};
+//# sourceMappingURL=phone-input-constants.js.map

package/dist/components/ui/phone-input-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/components/ui/phone-input-constants.ts"],"sourcesContent":["/**\n * Kiểu quốc gia và nhãn mặc định của `PhoneInput`.\n *\n * Module **CỐ Ý không có `\"use client\"`** — xem `src/chart/chart-colors.ts` để biết lý do đầy\n * đủ: mọi export của một file `\"use client\"` đến tay Server Component dưới dạng\n * client-reference proxy, đọc ra `undefined` mà KHÔNG throw, KHÔNG warning. Hằng dữ liệu thuần\n * (nhãn mặc định) phải sống ngoài ranh giới client để app spread/override được ở cả hai phía.\n *\n * ⚠ Barrel `src/index.ts` xuất module này TRỰC TIẾP. `phone-input.tsx` chỉ được `import`,\n * KHÔNG được `export` lại (re-export qua file client là vô hiệu, và đụng tên với `export *`).\n */\n\nimport { phoneInputEn } from \"../../i18n/namespaces/phone-input.js\";\n\n/**\n * Một quốc gia trong danh sách chọn của `PhoneInput` — cũng là hình dạng của prop `countries`\n * khi app muốn tự giới hạn danh sách.\n *\n * ⚠ Khác thượng nguồn: thượng nguồn khai kiểu này dưới tên `Country` và KHÔNG export (app phải\n * viết `PhoneInputProps[\"countries\"]`). Ở đây export dưới tên có tiền tố — `Country` trần là tên\n * quá chung cho entry chính.\n */\nexport interface PhoneInputCountry {\n  /** Mã ISO 3166-1 alpha-2, viết HOA — `\"VN\"`. */\n  code: string;\n  /** Tên hiển thị trong danh sách và trong nhãn của nút chọn — `\"Vietnam\"` (theo `locale`). */\n  name: string;\n  /** Mã quay số quốc tế, có dấu `+` — `\"+84\"`. */\n  dialCode: string;\n  /** Cờ emoji — `\"🇻🇳\"`. Bỏ trống thì không vẽ cờ. */\n  flag?: string;\n}\n\n/**\n * Chuỗi hiển thị của `PhoneInput` (kể cả chuỗi chỉ dành cho trình đọc màn hình). Theo\n * `ComitorLocaleProvider` (mặc định tiếng Anh, bảng tiếng Việt dựng sẵn); override từng khoá qua\n * prop `labels`.\n *\n * Tên quốc gia KHÔNG nằm ở đây — `Intl.DisplayNames` gọi theo `locale` (prop `locale` của\n * `PhoneInput`, không truyền thì `locale` của provider).\n */\nexport interface PhoneInputLabels {\n  /**\n   * Tên cho trình đọc màn hình của nút chọn quốc gia. Nhận quốc gia đang chọn (`undefined` khi\n   * chưa chọn) vì tên phải nói được GIÁ TRỊ hiện tại — nút chỉ chứa một lá cờ emoji.\n   *\n   * ⚠ Thêm so với thượng nguồn: ở bản gốc nút này KHÔNG có tên (lá cờ + mũi tên, hoặc một ô xám\n   * trống khi chưa chọn). Là HÀM chứ không phải chuỗi mẫu vì có giá trị chèn vào giữa câu.\n   */\n  countrySelect: (country: PhoneInputCountry | undefined) => string;\n  /** Placeholder ô tìm kiếm trong danh sách quốc gia. */\n  searchPlaceholder: string;\n  /** Dòng báo khi không quốc gia nào khớp từ khoá. */\n  empty: string;\n  /**\n   * Placeholder của ô nhập số. Prop `placeholder` rời (tên của thượng nguồn — trên `PhoneInput`,\n   * hoặc trên chính `PhoneInputField`) thắng khoá này nếu có. Thêm ở `3.0.0`: trước đó placeholder\n   * chỉ là mặc định viết thẳng trong component.\n   */\n  placeholder: string;\n}\n\n/**\n * Nhãn TIẾNG ANH mặc định (từ `3.0.0`; trước đó là tiếng Việt). Bảng tiếng Việt:\n * `comitorMessagesVi.phoneInput`. Component không đọc thẳng hằng này — nó đọc bảng của\n * `ComitorLocaleProvider`; hằng ở đây để app trải ra khi tự dựng nhãn.\n */\nexport const DEFAULT_PHONE_INPUT_LABELS: PhoneInputLabels = { ...phoneInputEn };\n"],"mappings":"AAYA,SAAS,oBAAoB;AAuDtB,MAAM,6BAA+C,EAAE,GAAG,aAAa;","names":[]}

package/dist/components/ui/phone-input.d.ts

@@ -0,0 +1,92 @@
+import * as React from 'react';
+import { PhoneInputCountry, PhoneInputLabels } from './phone-input-constants.js';
+import { Popover, PopoverTrigger } from './popover.js';
+import '@radix-ui/react-popover';
+
+interface StoreState {
+    value: string;
+    country: string;
+    open: boolean;
+    startsWithPlus: boolean;
+    /**
+     * ⚠ Thêm so với thượng nguồn: chữ người dùng gõ ở chế độ số nội địa, đúng như gõ (đã gạt ký tự
+     * lạ), để ô hiện lại nguyên văn thay vì dạng `+84 …`. `null` = chế độ quốc tế của thượng nguồn.
+     */
+    nationalInput: string | null;
+}
+interface Store {
+    subscribe: (callback: () => void) => () => void;
+    getState: () => StoreState;
+    setState: <K extends keyof StoreState>(key: K, value: StoreState[K]) => void;
+    notify: () => void;
+}
+declare function useStore<T>(selector: (state: StoreState) => T, ogStore?: Store | null): T;
+/**
+ * Ô nhập số điện thoại quốc tế: nút chọn quốc gia (`PhoneInputCountrySelect`) + ô số
+ * (`PhoneInputField`). Giá trị (`value` / `onValueChange` / input ẩn khi submit form) luôn là E.164
+ * chỉ gồm chữ số: `"+84912345678"`. Người dùng gõ được theo HAI cách:
+ *
+ * - **Số nội địa** — chuỗi KHÔNG bắt đầu bằng `+`, và đang có quốc gia được chọn (`defaultCountry`
+ *   / `country`, hoặc người dùng chọn): bỏ một số 0 đầu rồi ghép mã quay số của nước đang chọn. Ô hiện NGUYÊN VĂN chữ đã gõ
+ *   (chỉ gạt ký tự không phải số hay `space ( ) . -`), con trỏ không nhảy; đổi quốc gia thì giá trị
+ *   ghép lại theo mã mới, còn chữ trên ô giữ nguyên.
+ *   Nước là Việt Nam, gõ `0912 345 678` → ô hiện `0912 345 678`, `onValueChange("+84912345678")`.
+ *   ⚠ Khác thượng nguồn — bản gốc ra `+0912345678`. Ý, San Marino, Vatican giữ số 0 đầu (máy bàn
+ *   `06 …` → `+39 06 …`).
+ * - **Số quốc tế** — chuỗi bắt đầu bằng `+` (như thượng nguồn): ô hiện tách nhóm
+ *   (`+84 912 345 678`), quốc gia tự nhận theo mã quay số.
+ *   Gõ `+84 912 345 678` → `onValueChange("+84912345678")`, cờ chuyển sang Việt Nam.
+ *
+ * Giá trị nạp từ ngoài (`value`/`defaultValue`) luôn hiện ở dạng quốc tế. Không có quốc gia nào
+ * được chọn — MẶC ĐỊNH từ `3.0.0` — thì mọi chữ số đầu bị coi là mã quốc gia, như thượng nguồn:
+ * gõ `0912 345 678` ra `+0912345678`, gõ `84 912 345 678` ra `+84912345678` và cờ tự nhận Việt Nam.
+ *
+ * Gốc là `role="group"` chưa có tên: đặt `aria-label` (vd "Phone number") hoặc `aria-labelledby`
+ * cho chính `PhoneInput`.
+ */
+interface PhoneInputProps extends React.ComponentProps<"div"> {
+    defaultValue?: string;
+    value?: string;
+    onValueChange?: (value: string) => void;
+    /**
+     * Quốc gia ban đầu (mã ISO alpha-2, viết HOA). Mặc định: KHÔNG CÓ, như thượng nguồn — nước là
+     * thiết lập VÙNG, không suy từ ngôn ngữ; app Comitor truyền từ cài đặt workspace.
+     *
+     * ⚠ Không có quốc gia thì chế độ số NỘI ĐỊA tắt (xem JSDoc của `PhoneInput`). Trước `3.0.0`
+     * mặc định cứng là `"VN"`.
+     */
+    defaultCountry?: string;
+    country?: string;
+    onCountryChange?: (country: string) => void;
+    countries?: PhoneInputCountry[];
+    name?: string;
+    /** Placeholder ô nhập số — thắng khoá `labels.placeholder` (namespace `phoneInput`). */
+    placeholder?: string;
+    /**
+     * Locale BCP 47 để gọi tên quốc gia (`Intl.DisplayNames`) và sắp xếp danh sách. Không truyền thì
+     * theo `locale` của `ComitorLocaleProvider` (không có provider → `"en"`; trước `3.0.0` mặc định
+     * cứng là `"vi"`). Bỏ qua khi app truyền `countries` riêng (tên lấy nguyên từ đó).
+     *
+     * ⚠ Thêm so với thượng nguồn — bản gốc ghim tên tiếng Anh.
+     */
+    locale?: string;
+    /**
+     * Chuỗi hiển thị/đọc màn hình (phần chọn quốc gia + placeholder ô số) — override từng khoá. Không
+     * truyền thì theo namespace `phoneInput` của `ComitorLocaleProvider` (mặc định tiếng Anh).
+     */
+    labels?: Partial<PhoneInputLabels>;
+    asChild?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    required?: boolean;
+    invalid?: boolean;
+    showFlag?: boolean;
+}
+declare function PhoneInput(props: PhoneInputProps): React.JSX.Element;
+interface PhoneInputCountrySelectProps extends React.ComponentProps<typeof Popover>, Pick<React.ComponentProps<typeof PopoverTrigger>, "disabled" | "className"> {
+}
+declare function PhoneInputCountrySelect(props: PhoneInputCountrySelectProps): React.JSX.Element;
+type PhoneInputFieldProps = React.ComponentProps<"input">;
+declare function PhoneInputField(props: PhoneInputFieldProps): React.JSX.Element;
+
+export { PhoneInput, PhoneInputCountrySelect, type PhoneInputCountrySelectProps, PhoneInputField, type PhoneInputFieldProps, type PhoneInputProps, useStore as usePhoneInput };