@fui-org/fui-cli 2.1.4 → 2.2.1

package/skills/{fui-skill → fui}/references/default-function.md

@@ -1,456 +1,456 @@
-# Default Functions
-
-> Owns: **FUI utility functions usable in `FUN`/`EXE`/`script.js`** (openWindow, ajaxCALL, jsonToExcel, groupBy...). Source locations: [script-map.md](script-map.md).
-
-Globals defined in `defaultfunction.js`, auto-loaded in every FUI V2 module.
-
----
-
-## Global Variables
-
-| Variable    | Meaning                                     |
-| ----------- | ------------------------------------------- |
-| `$isMobile` | `true` if mobile user agent                 |
-| `$isPhone`  | `true` if phone (not tablet)                |
-| `$isApple`  | `true` if Apple device (iPad, iPhone, iPod) |
-
----
-
-## Dialogs & Messages
-
-### confirm(obj)
-
-Styled OK/Cancel dialog; wraps `$.confirm` (jquery-confirm).
-
-| Param     | Meaning                                                   |
-| --------- | --------------------------------------------------------- |
-| `title`   | Title                                                     |
-| `message` | Body                                                      |
-| `action`  | Function run on OK                                        |
-| `cancel`  | Function run on Cancel (optional)                         |
-| `type`    | Color: `'blue'` (default), `'red'`, `'green'`, `'orange'` |
-| `icon`    | Icon class, e.g. `'mdi mdi-delete'`                       |
-
-```js
-confirm({
-  title: "Xác nhận xóa",
-  message: "Bạn có chắc muốn xóa bản ghi này không?",
-  type: "red",
-  icon: "mdi mdi-delete",
-  action: function () {
-    CALL(vueData.actDelete);
-  },
-});
-```
-
----
-
-### showMessage(obj)
-
-Message dialog (Close button only); wraps `$.dialog`.
-
-| Param     | Meaning                             |
-| --------- | ----------------------------------- |
-| `title`   | Title                               |
-| `message` | Body                                |
-| `type`    | Color: `'blue'`, `'red'`, `'green'` |
-| `icon`    | Icon class                          |
-| `onclose` | FUI action object run after close   |
-
-```js
-showMessage({ title: "Thông báo", message: "Lưu thành công!" });
-
-showMessage({
-  title: "Lỗi",
-  message: "Không tìm thấy dữ liệu",
-  type: "red",
-  icon: "mdi mdi-alert-circle",
-});
-
-// Chạy action sau khi đóng
-showMessage({
-  title: "Hoàn tất",
-  message: "Import xong!",
-  onclose: vueData.actReload,
-});
-```
-
----
-
-## Navigation & Window
-
-### pushRouter(router)
-
-Updates the browser URL without reload — sync URL with UI state.
-
-```js
-pushRouter("/fp/don-hang/danh-sach");
-```
-
----
-
-### openWindow(obj)
-
-Opens an FUI window (`f-window`) overlay.
-
-| Param    | Meaning                                                   |
-| -------- | --------------------------------------------------------- |
-| `url`    | Content URL (required)                                    |
-| `title`  | Window title                                              |
-| `id`     | Identifier (auto if omitted) — prevents duplicate windows |
-| `width`  | Width (px or %)                                           |
-| `height` | Height                                                    |
-
-```js
-// Cách đơn giản — chỉ truyền URL
-openWindow("/fp/san-pham/chi-tiet?id=123");
-
-// Đầy đủ options
-openWindow({
-  id: "winChiTiet",
-  url: "/fp/san-pham/chi-tiet?id=" + vueData.selectedId,
-  title: "Chi tiết sản phẩm",
-  width: "80%",
-});
-```
-
-> Called inside an `f-window` (iframe) → FUI switches to `windowSendMessage('#PARENT', 'openWindow', obj)` to open in the parent.
-
----
-
-### redirect(obj, query)
-
-Navigates the current page to another URL.
-
-```js
-redirect("/fp/trang-chu");
-redirect({ url: "/fp/don-hang", query: true }); // giữ lại query params hiện tại
-```
-
----
-
-### reload()
-
-Reloads the page.
-
-```js
-reload();
-```
-
----
-
-### windowSendMessage(window, cmd, data)
-
-`postMessage` to another window/iframe — communication between `f-window`s.
-
-| Param    | Meaning                                                           |
-| -------- | ----------------------------------------------------------------- |
-| `window` | Window object, `'#PARENT'` (parent), or `'#iframeId'` (iframe ID) |
-| `cmd`    | Command name                                                      |
-| `data`   | Payload                                                           |
-
-```js
-// Gửi lên cửa sổ cha
-windowSendMessage("#PARENT", "refreshData", { id: vueData.selectedId });
-
-// Gửi đến iframe có id="iframeChild"
-windowSendMessage("#iframeChild", "loadItem", { itemId: 5 });
-```
-
----
-
-## AJAX
-
-### ajaxCALL(URL, DATA, callBack, errorCallBack, header)
-
-AJAX POST. Pass only the path — domain is added via `fixURL`.
-
-```js
-ajaxCALL("/SP_GetDonHang", { maKH: vueData.maKH }, function (res) {
-  vueData.danhSach = res.data;
-});
-
-// Với error handler
-ajaxCALL(
-  "/SP_SaveDonHang",
-  vueData.form,
-  function (res) {
-    Vue.$toast.success("Lưu thành công", { position: "top" });
-  },
-  function (err) {
-    showMessage({ title: "Lỗi", message: err.message, type: "red" });
-  },
-);
-```
-
----
-
-## File Export
-
-### jsonToExcel(Obj)
-
-Exports JSON to `.xlsx`. Auto-loads ExcelJS.
-
-**Single sheet:**
-
-```js
-jsonToExcel({
-  data: vueData.danhSach, // Array of objects
-  filename: "danh-sach.xlsx",
-  worksheet: "DanhSach",
-});
-```
-
-**Multi sheet:**
-
-```js
-jsonToExcel({
-  filename: "bao-cao.xlsx",
-  sheets: [
-    { name: "Sheet1", data: vueData.list1 },
-    { name: "Sheet2", data: vueData.list2 },
-  ],
-});
-```
-
-Without `columns`, the columns are the keys of the **first row**, headers are the key names, values are raw. A field missing from the first row is missing from the whole file.
-
-**Pick columns, headers and formats — `columns`** (`f-table excel="UI"` also uses `columns`, but only `header`/`key`, no formatting):
-
-```js
-jsonToExcel({
-  data: vueData.dsHang, // the original array of objects — no need to map each row
-  filename: "kho.xlsx",
-  worksheet: "Kho",
-  columns: [
-    { header: "Tên hàng", key: "Ten" },
-    { header: "Số lượng", key: "SoLuong", type: "number", numFmt: "#,##0", sum: true },
-    { header: "Thành tiền", key: "ThanhTien", type: "number", numFmt: "#,##0.00", sum: "#,##0" },
-    { header: "Ngày nhập", key: "NgayNhap", type: "date", numFmt: "dd/mm/yyyy" },
-    { header: "Ghi chú", key: "GhiChuHtml", type: "html", width: 40 },
-  ],
-});
-```
-
-| Field    | Meaning                                                                                                                                                                                                        |
-| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `header` | Column title. May repeat (two "Tổng" columns do not overwrite each other)                                                                                                                                      |
-| `key`    | Row field; nested paths `a.b` are supported                                                                                                                                                                    |
-| `type`   | `'number'`: numeric string → number. `'date'`: ISO/`yyyy-mm-dd` string → real date in **local time** (no one-day shift from UTC). `'html'`: strip tags, keep text. Omitted: as is (object/array → JSON string) |
-| `numFmt` | **Excel** format code (not numeral/moment): `#,##0`, `#,##0.00`, `0.0%`, `dd/mm/yyyy hh:mm`. `'#,##0;-#,##0;'` hides zeros but keeps the value                                                                 |
-| `width`  | Width in characters; omitted, it is estimated from the first 100 rows                                                                                                                                          |
-| `sum`    | `true` or a numFmt → adds a total row at the end of the sheet with a `SUM` formula over the exported rows                                                                                                      |
-
-- With `columns`, the header row is bold and frozen. Each sheet in `sheets` can have its own `columns`: `{ name, data, columns }`.
-- Only fields listed in `columns` go into the file. This is the clean export (no IDs or technical fields leak) and it is lighter than mapping to a new array of objects just to rename keys.
-
----
-
-## Data Utilities
-
-### groupBy(arrayObj, groupField, sumArr)
-
-Groups objects by a field and sums numeric columns; returns grouped array with `count`.
-
-```js
-// groupBy(data, 'Khoa', ['SLNghiHoc', 'SLTotNghiep'])
-var result = groupBy(vueData.data, "phongBan", ["soLuong", "doanhThu"]);
-// result: [{ phongBan: 'A', soLuong: 10, doanhThu: 5000, count: 3 }, ...]
-```
-
-> For complex grouping use Lodash `_.groupBy`.
-
----
-
-### findInArray(obj)
-
-Finds an element by condition.
-
-```js
-var item = findInArray({ array: vueData.list, value: { id: 5 } });
-```
-
-> Usually prefer the shorter Lodash `_.find(array, condition)`.
-
----
-
-### fillData(obj)
-
-Copies data from a source array into a target object by key and mapping.
-
-- **Parameters:** `{ src, des, key, map }` — src: source array, des: target object, key: matching value, map: field mapping
-
----
-
-### buildHeader(obj, mapCol)
-
-Builds `headers` for `f-table` from data. No `mapCol` → headers from the first record's keys (numeric columns get `el: 't-num'`); with `mapCol` → mapped from `{ text, value }`.
-
-```js
-// Tự dựng header từ dữ liệu API
-vueData.headers = buildHeader(vueData.dsData);
-```
-
-### capacityText(numb)
-
-Bytes → size string (`'1.5 Mb'`, `'320 Kb'`) for file sizes.
-
-### appCommand(cmdData)
-
-Sends a command to the native app (React Native / iOS webkit / Android) when FUI is embedded in a mobile app.
-
----
-
-## PDF
-
-### printPDF(obj)
-
-Builds and prints/downloads a PDF with `pdfMake`. Auto-loads pdfMake.
-
-```js
-printPDF({
-  data: docDefinition, // pdfMake docDefinition object
-  download: true, // true = tải file, false = mở viewer
-  callBack: function () {
-    console.log("Done");
-  },
-});
-```
-
----
-
-## Clipboard & String
-
-### copyToClipboard(textToCopy)
-
-Copies to clipboard; uses `navigator.clipboard` when available (HTTPS), else `execCommand`.
-
-```js
-copyToClipboard(vueData.maHoaDon);
-copyToClipboard(JSON.stringify(vueData.data));
-```
-
----
-
-### fileNameClear(fname)
-
-Strips special characters from a file name (keeps letters, digits, spaces, dashes).
-
-```js
-var safeName = fileNameClear(vueData.tenFile); // "report (2025)!" → "report 2025"
-```
-
----
-
-### hashCode(s)
-
-Integer hash of a string (for unique keys).
-
-```js
-var key = hashCode("unique-string-" + Date.now());
-```
-
----
-
-### generateID()
-
-Random string ID.
-
-```js
-var newId = "win_" + generateID();
-```
-
----
-
-## Cookie & Auth
-
-### getCookie(cname) / setCookie(name, value, days, domain)
-
-Read/write browser cookies.
-
-```js
-var token = getCookie("awt");
-setCookie("theme", "dark", 30); // hết hạn sau 30 ngày
-setCookie("lang", "vi", 365, ".fui.vn"); // share cookie toàn domain
-```
-
----
-
-### logout(cookiesName, domain, url)
-
-Clears the cookie and redirects to login.
-
-```js
-logout(); // xóa cookie 'awt', redirect về login mặc định
-logout("myToken", ".fui.vn", "/login");
-```
-
----
-
-## Permissions
-
-### rightTest(rightObject)
-
-Checks whether the current user has the required rights, against `vueData.user`.
-
-```js
-// Kiểm tra user có role 'admin' hoặc 'manager'
-if (rightTest({ role: ['admin', 'manager'] })) {
-    vueData.showDelete = true;
-}
-
-// Kiểm tra nhiều điều kiện cùng lúc (AND)
-if (rightTest({ dept: 'IT', level: [1, 2] })) { ... }
-```
-
----
-
-## Color Utilities
-
-### colorLib(color)
-
-Color utility (hex, rgb, hsl), mostly for charts.
-
-```js
-var c = colorLib("#4e73df");
-c.hexString(); // '#4e73df'
-c.rgbString(); // 'rgb(78, 115, 223)'
-c.lighten(0.2); // làm sáng 20%
-c.darken(0.1); // làm tối 10%
-c.alpha(0.5).rgbString(); // 'rgba(78, 115, 223, 0.5)'
-```
-
-### transparentize(value, opacity)
-
-Shortcut for a transparent color.
-
-```js
-transparentize("#4e73df", 0.5); // 'rgba(78, 115, 223, 0.5)'
-```
-
----
-
-## Script Loader
-
-### loadScripts(scriptsArray, callbackFunc)
-
-Loads scripts by URL, then runs the callback — on-demand libraries.
-
-```js
-loadScripts(["/include/pdfmake/pdfmake.min.js", "/include/pdfmake/vfs_fonts.js"], function () {
-  printPDF({ data: docDef, download: true });
-});
-```
-
----
-
-## Device Detection
-
-### extractHostname(url) / getDomainWithoutSubdomain(url)
-
-Extract hostname/domain from a URL. Internal; rarely used directly.
-
-```js
-extractHostname("https://api.fui.vn/fp/test"); // 'api.fui.vn'
-getDomainWithoutSubdomain("https://api.fui.vn"); // 'fui.vn'
-```
+# Default Functions
+
+> Owns: **FUI utility functions usable in `FUN`/`EXE`/`script.js`** (openWindow, ajaxCALL, jsonToExcel, groupBy...). Source locations: [script-map.md](script-map.md).
+
+Globals defined in `defaultfunction.js`, auto-loaded in every FUI V2 module.
+
+---
+
+## Global Variables
+
+| Variable    | Meaning                                     |
+| ----------- | ------------------------------------------- |
+| `$isMobile` | `true` if mobile user agent                 |
+| `$isPhone`  | `true` if phone (not tablet)                |
+| `$isApple`  | `true` if Apple device (iPad, iPhone, iPod) |
+
+---
+
+## Dialogs & Messages
+
+### confirm(obj)
+
+Styled OK/Cancel dialog; wraps `$.confirm` (jquery-confirm).
+
+| Param     | Meaning                                                   |
+| --------- | --------------------------------------------------------- |
+| `title`   | Title                                                     |
+| `message` | Body                                                      |
+| `action`  | Function run on OK                                        |
+| `cancel`  | Function run on Cancel (optional)                         |
+| `type`    | Color: `'blue'` (default), `'red'`, `'green'`, `'orange'` |
+| `icon`    | Icon class, e.g. `'mdi mdi-delete'`                       |
+
+```js
+confirm({
+  title: "Xác nhận xóa",
+  message: "Bạn có chắc muốn xóa bản ghi này không?",
+  type: "red",
+  icon: "mdi mdi-delete",
+  action: function () {
+    CALL(vueData.actDelete);
+  },
+});
+```
+
+---
+
+### showMessage(obj)
+
+Message dialog (Close button only); wraps `$.dialog`.
+
+| Param     | Meaning                             |
+| --------- | ----------------------------------- |
+| `title`   | Title                               |
+| `message` | Body                                |
+| `type`    | Color: `'blue'`, `'red'`, `'green'` |
+| `icon`    | Icon class                          |
+| `onclose` | FUI action object run after close   |
+
+```js
+showMessage({ title: "Thông báo", message: "Lưu thành công!" });
+
+showMessage({
+  title: "Lỗi",
+  message: "Không tìm thấy dữ liệu",
+  type: "red",
+  icon: "mdi mdi-alert-circle",
+});
+
+// Chạy action sau khi đóng
+showMessage({
+  title: "Hoàn tất",
+  message: "Import xong!",
+  onclose: vueData.actReload,
+});
+```
+
+---
+
+## Navigation & Window
+
+### pushRouter(router)
+
+Updates the browser URL without reload — sync URL with UI state.
+
+```js
+pushRouter("/fp/don-hang/danh-sach");
+```
+
+---
+
+### openWindow(obj)
+
+Opens an FUI window (`f-window`) overlay.
+
+| Param    | Meaning                                                   |
+| -------- | --------------------------------------------------------- |
+| `url`    | Content URL (required)                                    |
+| `title`  | Window title                                              |
+| `id`     | Identifier (auto if omitted) — prevents duplicate windows |
+| `width`  | Width (px or %)                                           |
+| `height` | Height                                                    |
+
+```js
+// Cách đơn giản — chỉ truyền URL
+openWindow("/fp/san-pham/chi-tiet?id=123");
+
+// Đầy đủ options
+openWindow({
+  id: "winChiTiet",
+  url: "/fp/san-pham/chi-tiet?id=" + vueData.selectedId,
+  title: "Chi tiết sản phẩm",
+  width: "80%",
+});
+```
+
+> Called inside an `f-window` (iframe) → FUI switches to `windowSendMessage('#PARENT', 'openWindow', obj)` to open in the parent.
+
+---
+
+### redirect(obj, query)
+
+Navigates the current page to another URL.
+
+```js
+redirect("/fp/trang-chu");
+redirect({ url: "/fp/don-hang", query: true }); // giữ lại query params hiện tại
+```
+
+---
+
+### reload()
+
+Reloads the page.
+
+```js
+reload();
+```
+
+---
+
+### windowSendMessage(window, cmd, data)
+
+`postMessage` to another window/iframe — communication between `f-window`s.
+
+| Param    | Meaning                                                           |
+| -------- | ----------------------------------------------------------------- |
+| `window` | Window object, `'#PARENT'` (parent), or `'#iframeId'` (iframe ID) |
+| `cmd`    | Command name                                                      |
+| `data`   | Payload                                                           |
+
+```js
+// Gửi lên cửa sổ cha
+windowSendMessage("#PARENT", "refreshData", { id: vueData.selectedId });
+
+// Gửi đến iframe có id="iframeChild"
+windowSendMessage("#iframeChild", "loadItem", { itemId: 5 });
+```
+
+---
+
+## AJAX
+
+### ajaxCALL(URL, DATA, callBack, errorCallBack, header)
+
+AJAX POST. Pass only the path — domain is added via `fixURL`.
+
+```js
+ajaxCALL("/SP_GetDonHang", { maKH: vueData.maKH }, function (res) {
+  vueData.danhSach = res.data;
+});
+
+// Với error handler
+ajaxCALL(
+  "/SP_SaveDonHang",
+  vueData.form,
+  function (res) {
+    Vue.$toast.success("Lưu thành công", { position: "top" });
+  },
+  function (err) {
+    showMessage({ title: "Lỗi", message: err.message, type: "red" });
+  },
+);
+```
+
+---
+
+## File Export
+
+### jsonToExcel(Obj)
+
+Exports JSON to `.xlsx`. Auto-loads ExcelJS.
+
+**Single sheet:**
+
+```js
+jsonToExcel({
+  data: vueData.danhSach, // Array of objects
+  filename: "danh-sach.xlsx",
+  worksheet: "DanhSach",
+});
+```
+
+**Multi sheet:**
+
+```js
+jsonToExcel({
+  filename: "bao-cao.xlsx",
+  sheets: [
+    { name: "Sheet1", data: vueData.list1 },
+    { name: "Sheet2", data: vueData.list2 },
+  ],
+});
+```
+
+Without `columns`, the columns are the keys of the **first row**, headers are the key names, values are raw. A field missing from the first row is missing from the whole file.
+
+**Pick columns, headers and formats — `columns`** (`f-table excel="UI"` also uses `columns`, but only `header`/`key`, no formatting):
+
+```js
+jsonToExcel({
+  data: vueData.dsHang, // the original array of objects — no need to map each row
+  filename: "kho.xlsx",
+  worksheet: "Kho",
+  columns: [
+    { header: "Tên hàng", key: "Ten" },
+    { header: "Số lượng", key: "SoLuong", type: "number", numFmt: "#,##0", sum: true },
+    { header: "Thành tiền", key: "ThanhTien", type: "number", numFmt: "#,##0.00", sum: "#,##0" },
+    { header: "Ngày nhập", key: "NgayNhap", type: "date", numFmt: "dd/mm/yyyy" },
+    { header: "Ghi chú", key: "GhiChuHtml", type: "html", width: 40 },
+  ],
+});
+```
+
+| Field    | Meaning                                                                                                                                                                                                        |
+| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `header` | Column title. May repeat (two "Tổng" columns do not overwrite each other)                                                                                                                                      |
+| `key`    | Row field; nested paths `a.b` are supported                                                                                                                                                                    |
+| `type`   | `'number'`: numeric string → number. `'date'`: ISO/`yyyy-mm-dd` string → real date in **local time** (no one-day shift from UTC). `'html'`: strip tags, keep text. Omitted: as is (object/array → JSON string) |
+| `numFmt` | **Excel** format code (not numeral/moment): `#,##0`, `#,##0.00`, `0.0%`, `dd/mm/yyyy hh:mm`. `'#,##0;-#,##0;'` hides zeros but keeps the value                                                                 |
+| `width`  | Width in characters; omitted, it is estimated from the first 100 rows                                                                                                                                          |
+| `sum`    | `true` or a numFmt → adds a total row at the end of the sheet with a `SUM` formula over the exported rows                                                                                                      |
+
+- With `columns`, the header row is bold and frozen. Each sheet in `sheets` can have its own `columns`: `{ name, data, columns }`.
+- Only fields listed in `columns` go into the file. This is the clean export (no IDs or technical fields leak) and it is lighter than mapping to a new array of objects just to rename keys.
+
+---
+
+## Data Utilities
+
+### groupBy(arrayObj, groupField, sumArr)
+
+Groups objects by a field and sums numeric columns; returns grouped array with `count`.
+
+```js
+// groupBy(data, 'Khoa', ['SLNghiHoc', 'SLTotNghiep'])
+var result = groupBy(vueData.data, "phongBan", ["soLuong", "doanhThu"]);
+// result: [{ phongBan: 'A', soLuong: 10, doanhThu: 5000, count: 3 }, ...]
+```
+
+> For complex grouping use Lodash `_.groupBy`.
+
+---
+
+### findInArray(obj)
+
+Finds an element by condition.
+
+```js
+var item = findInArray({ array: vueData.list, value: { id: 5 } });
+```
+
+> Usually prefer the shorter Lodash `_.find(array, condition)`.
+
+---
+
+### fillData(obj)
+
+Copies data from a source array into a target object by key and mapping.
+
+- **Parameters:** `{ src, des, key, map }` — src: source array, des: target object, key: matching value, map: field mapping
+
+---
+
+### buildHeader(obj, mapCol)
+
+Builds `headers` for `f-table` from data. No `mapCol` → headers from the first record's keys (numeric columns get `el: 't-num'`); with `mapCol` → mapped from `{ text, value }`.
+
+```js
+// Tự dựng header từ dữ liệu API
+vueData.headers = buildHeader(vueData.dsData);
+```
+
+### capacityText(numb)
+
+Bytes → size string (`'1.5 Mb'`, `'320 Kb'`) for file sizes.
+
+### appCommand(cmdData)
+
+Sends a command to the native app (React Native / iOS webkit / Android) when FUI is embedded in a mobile app.
+
+---
+
+## PDF
+
+### printPDF(obj)
+
+Builds and prints/downloads a PDF with `pdfMake`. Auto-loads pdfMake.
+
+```js
+printPDF({
+  data: docDefinition, // pdfMake docDefinition object
+  download: true, // true = tải file, false = mở viewer
+  callBack: function () {
+    console.log("Done");
+  },
+});
+```
+
+---
+
+## Clipboard & String
+
+### copyToClipboard(textToCopy)
+
+Copies to clipboard; uses `navigator.clipboard` when available (HTTPS), else `execCommand`.
+
+```js
+copyToClipboard(vueData.maHoaDon);
+copyToClipboard(JSON.stringify(vueData.data));
+```
+
+---
+
+### fileNameClear(fname)
+
+Strips special characters from a file name (keeps letters, digits, spaces, dashes).
+
+```js
+var safeName = fileNameClear(vueData.tenFile); // "report (2025)!" → "report 2025"
+```
+
+---
+
+### hashCode(s)
+
+Integer hash of a string (for unique keys).
+
+```js
+var key = hashCode("unique-string-" + Date.now());
+```
+
+---
+
+### generateID()
+
+Random string ID.
+
+```js
+var newId = "win_" + generateID();
+```
+
+---
+
+## Cookie & Auth
+
+### getCookie(cname) / setCookie(name, value, days, domain)
+
+Read/write browser cookies.
+
+```js
+var token = getCookie("awt");
+setCookie("theme", "dark", 30); // hết hạn sau 30 ngày
+setCookie("lang", "vi", 365, ".fui.vn"); // share cookie toàn domain
+```
+
+---
+
+### logout(cookiesName, domain, url)
+
+Clears the cookie and redirects to login.
+
+```js
+logout(); // xóa cookie 'awt', redirect về login mặc định
+logout("myToken", ".fui.vn", "/login");
+```
+
+---
+
+## Permissions
+
+### rightTest(rightObject)
+
+Checks whether the current user has the required rights, against `vueData.user`.
+
+```js
+// Kiểm tra user có role 'admin' hoặc 'manager'
+if (rightTest({ role: ['admin', 'manager'] })) {
+    vueData.showDelete = true;
+}
+
+// Kiểm tra nhiều điều kiện cùng lúc (AND)
+if (rightTest({ dept: 'IT', level: [1, 2] })) { ... }
+```
+
+---
+
+## Color Utilities
+
+### colorLib(color)
+
+Color utility (hex, rgb, hsl), mostly for charts.
+
+```js
+var c = colorLib("#4e73df");
+c.hexString(); // '#4e73df'
+c.rgbString(); // 'rgb(78, 115, 223)'
+c.lighten(0.2); // làm sáng 20%
+c.darken(0.1); // làm tối 10%
+c.alpha(0.5).rgbString(); // 'rgba(78, 115, 223, 0.5)'
+```
+
+### transparentize(value, opacity)
+
+Shortcut for a transparent color.
+
+```js
+transparentize("#4e73df", 0.5); // 'rgba(78, 115, 223, 0.5)'
+```
+
+---
+
+## Script Loader
+
+### loadScripts(scriptsArray, callbackFunc)
+
+Loads scripts by URL, then runs the callback — on-demand libraries.
+
+```js
+loadScripts(["/include/pdfmake/pdfmake.min.js", "/include/pdfmake/vfs_fonts.js"], function () {
+  printPDF({ data: docDef, download: true });
+});
+```
+
+---
+
+## Device Detection
+
+### extractHostname(url) / getDomainWithoutSubdomain(url)
+
+Extract hostname/domain from a URL. Internal; rarely used directly.
+
+```js
+extractHostname("https://api.fui.vn/fp/test"); // 'api.fui.vn'
+getDomainWithoutSubdomain("https://api.fui.vn"); // 'fui.vn'
+```