@ecomcx/nexus-admin-sdk 0.0.0-stage → 1.24.1

package/dist/host.d.ts

@@ -0,0 +1,3 @@
+import type { CmsAdmin } from "./types.js";
+/** Admin host đặt object này vào globalThis.__CMS_ADMIN__ trước khi nạp bundle của plugin. */
+export declare function host(): CmsAdmin;

package/dist/host.js

@@ -0,0 +1,7 @@
+/** Admin host đặt object này vào globalThis.__CMS_ADMIN__ trước khi nạp bundle của plugin. */
+export function host() {
+    const h = globalThis.__CMS_ADMIN__;
+    if (!h)
+        throw new Error("@ecomcx/nexus-admin-sdk: chỉ chạy được bên trong trang quản trị CMS");
+    return h;
+}

package/dist/index.d.ts

@@ -0,0 +1,406 @@
+import type { AdminPage, AskOptions, DashboardWidget, Density, MetaBox, TableSettings } from "./types.js";
+export * from "./types.js";
+export declare const registerPage: (page: AdminPage) => void;
+export declare const registerMetaBox: (box: MetaBox) => void;
+/** Sidebar riêng trong trình soạn bài, kèm nút trên thanh hành động (CMS cũ chưa hỗ trợ thì bỏ qua). */
+export declare const registerEditorSidebar: (s: import("./types.js").EditorSidebar) => void | undefined;
+export declare const registerDashboardWidget: (w: DashboardWidget) => void;
+/** Thêm cột vào danh sách bài viết/trang (vd điểm SEO). */
+export declare const registerPostListColumn: (c: import("./types.js").PostListColumn) => void;
+/** Thêm hộp vào form sửa chuyên mục/thẻ (dữ liệu lưu trong term.meta). */
+export declare const registerTermMetaBox: (b: import("./types.js").TermMetaBox) => void;
+/** Lấy các MetaBox đã đăng ký trong hệ thống (tùy chọn lọc theo postType). */
+export declare const getMetaBoxes: (postType?: string) => MetaBox[];
+/** Hook lấy toàn bộ state plugin UI trong host. */
+export declare const usePluginUi: () => any;
+export declare const useApi: <T = any>(path: string | null) => {
+    data: T | undefined;
+    loading: boolean;
+    error: Error | null;
+    reload(): void;
+};
+export declare const can: (capability: string) => boolean;
+/**
+ * Khối cho trình soạn nội dung, khai báo bằng defineBlock (file dùng chung với phần website của plugin):
+ * trình soạn tự có mục slash menu, khung khối và form cài đặt sinh từ attributes. Nhãn "%khoá%" dịch theo
+ * locales của plugin khi tên khối có tiền tố "slug/" (vd "lien-he/callout").
+ */
+export declare const registerBlock: (def: import("@ecomcx/nexus-content").BlockDefinition, options?: import("./types.js").RegisterBlockOptions) => void;
+/**
+ * Thêm panel vào tab "Khối" của trình soạn cho một số loại khối (kể cả khối lõi như "image", "button") hoặc mọi khối:
+ *   registerBlockPanel({ id: "seo/link-rel", title: "%link.title%", blocks: ["button"], attributes: { sponsored: { default: false } }, component: Panel })
+ * CMS cũ (chưa có tab "Khối") → bỏ qua, không lỗi.
+ */
+export declare const registerBlockPanel: (panel: import("./types.js").BlockPanel) => void | undefined;
+/**
+ * Thêm mẫu (đoạn dựng sẵn) vào tab "Mẫu" của trình chèn:
+ *   registerPattern({ name: "shop/product-hero", title: "%pattern.hero%", category: "hero", content: { type: "doc", content: [...] } })
+ * CMS cũ (chưa có tab Mẫu) → bỏ qua, không lỗi.
+ */
+export declare const registerPattern: (pattern: import("./types.js").EditorPattern) => void | undefined;
+export { defineBlock, type BlockDefinition, type BlockDefinitionInput, type BlockAttrSpec } from "@ecomcx/nexus-content";
+/** Thêm node/mark TipTap cho trình soạn (cấp thấp — khối thường dùng registerBlock). */
+export declare const registerEditorExtension: (pack: import("./types.js").EditorExtensionPack) => void;
+/** Lớp TipTap dùng chung với admin (không cần cài @tiptap/core trong plugin). */
+export declare const tiptap: {
+    Node: any;
+    Mark: any;
+    Extension: any;
+    mergeAttributes: (...attrs: any[]) => Record<string, any>;
+};
+export declare const currentUser: () => {
+    id: number;
+    displayName: string;
+    capabilities: string[];
+} | null;
+/**
+ * Công bố hàm cho plugin khác dùng trong admin (gọi ở đầu bundle):  exposeApi({ openCartDrawer, formatPrice })
+ * Bên dùng:  const shop = await waitForPluginApi<ShopAdminApi>("shop");  shop?.formatPrice(1000)
+ */
+export declare const exposeApi: (api: Record<string, unknown>) => void | undefined;
+/** Hàm plugin khác đã công bố (undefined nếu plugin chưa bật hoặc bundle chưa nạp xong). */
+export declare const getPluginApi: <T = Record<string, unknown>>(slug: string) => T | undefined;
+/** Chờ plugin khác nạp xong rồi lấy hàm (undefined nếu plugin không bật). */
+export declare const waitForPluginApi: <T = Record<string, unknown>>(slug: string, timeoutMs?: number) => Promise<T | undefined>;
+/**
+ * Dịch chuỗi giao diện theo khoá (ICU MessageFormat). Bản dịch của plugin đặt trong gói: locales/vi.json, locales/en.json
+ * — CMS tự nạp với namespace = slug plugin:
+ *   locales/en.json: { "form.title": "Contact", "form.count": "{count, plural, one {# message} other {# messages}}" }
+ *   const t = createT("lien-he");  t("form.title") → "Contact";  t("form.count", { count: 3 }) → "3 messages"
+ * Khoá có ":" là khoá đầy đủ ("core:common.save" — nhãn chung của lõi, "plugin-khac:x").
+ */
+export declare const t: (key: string, values?: Record<string, unknown>) => string;
+/** Hàm dịch gắn sẵn namespace của plugin. */
+export declare const createT: (namespace: string) => (key: string, values?: Record<string, unknown>) => string;
+/** Thêm bản dịch bằng mã (ngoài locales/*.json), vd bản dịch tải từ API. */
+export declare const registerMessages: (namespace: string, locale: string, dict: Record<string, string>) => void | undefined;
+/** @deprecated Chuỗi gốc tiếng Việt làm khoá — dùng t()/createT() với locales/*.json. */
+export declare const __: (text: string, ...args: unknown[]) => string;
+/** @deprecated Dùng locales/*.json hoặc registerMessages(). */
+export declare const registerTranslations: (locale: string, dict: Record<string, string>) => void;
+export declare const adminLocale: () => string;
+export declare const api: {
+    get: <T = any>(p: string) => Promise<T>;
+    post: <T = any>(p: string, b?: unknown) => Promise<T>;
+    put: <T = any>(p: string, b?: unknown) => Promise<T>;
+    del: <T = any>(p: string) => Promise<T>;
+    upload: <T = any>(p: string, f: File, field?: string) => Promise<T>;
+};
+export declare const notify: {
+    success: (m: string) => void;
+    error: (m: string) => void;
+    info: (m: string) => void;
+};
+export declare const registerSlot: (slot: import("./types.js").AdminSlotItem) => void;
+export declare const getSlots: (slot: string, postType?: string) => import("./types.js").AdminSlotItem[];
+export declare const registerPostRowAction: (a: import("./types.js").PostRowAction) => void;
+/** Thao tác hàng loạt trên danh sách bài (CMS ≥ 1.2.0). */
+export declare const registerPostBulkAction: (a: import("./types.js").PostBulkAction) => void | undefined;
+/** Bộ lọc theo meta trên danh sách bài (CMS ≥ 1.2.0). */
+export declare const registerPostListFilter: (f: import("./types.js").PostListFilter) => void | undefined;
+/** Hộp trong trang sửa thành viên / hồ sơ, lưu vào user meta (CMS ≥ 1.2.0). */
+export declare const registerUserProfileBox: (b: import("./types.js").UserProfileBox) => void | undefined;
+/** Cột / nút trên dòng / thao tác hàng loạt cho danh sách người dùng, bình luận, media (list: "users" | "comments" | "media"). */
+export declare const registerListColumn: (c: import("./types.js").ListColumn) => void | undefined;
+export declare const registerListRowAction: (a: import("./types.js").ListRowAction) => void | undefined;
+export declare const registerListBulkAction: (a: import("./types.js").ListBulkAction) => void | undefined;
+export declare const getPostRowActions: (postType?: string) => import("./types.js").PostRowAction[];
+export declare const hooks: import("./types.js").AdminHookRegistry;
+export declare const addAction: (hook: string, namespace: string, cb: (...args: any[]) => void, priority?: number) => void;
+export declare const doAction: (hook: string, ...args: any[]) => void;
+export declare const addFilter: <T = any>(filter: string, namespace: string, cb: (v: T, ...args: any[]) => T, priority?: number) => void;
+export declare const applyFilters: <T = any>(filter: string, value: T, ...args: any[]) => T;
+export declare const removeAction: (hook: string, namespace: string) => void;
+export declare const removeFilter: (filter: string, namespace: string) => void;
+export declare const hasAction: (hook: string, namespace?: string) => boolean;
+export declare const hasFilter: (filter: string, namespace?: string) => boolean;
+export declare const Button: NonNullable<import("react").ComponentType<{
+    variant?: "primary" | "secondary" | "danger" | "ghost";
+    size?: "sm" | "md";
+    loading?: boolean;
+    icon?: import("react").ReactNode;
+} & import("react").ButtonHTMLAttributes<HTMLButtonElement>>>;
+export declare const Input: NonNullable<import("react").ComponentType<import("react").InputHTMLAttributes<HTMLInputElement> & {
+    ref?: React.Ref<HTMLInputElement>;
+}>>;
+export declare const Textarea: NonNullable<import("react").ComponentType<import("react").TextareaHTMLAttributes<HTMLTextAreaElement> & {
+    ref?: React.Ref<HTMLTextAreaElement>;
+}>>;
+export declare const Select: NonNullable<import("react").ComponentType<import("react").SelectHTMLAttributes<HTMLSelectElement> & {
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+}>>;
+export declare const Checkbox: NonNullable<import("react").ComponentType<{
+    checked: boolean;
+    onChange(checked: boolean): void;
+    label?: import("react").ReactNode;
+    disabled?: boolean;
+    description?: import("react").ReactNode;
+    ariaLabel?: string;
+    indeterminate?: boolean;
+}>>;
+export declare const Field: NonNullable<import("react").ComponentType<{
+    label: import("react").ReactNode;
+    help?: import("react").ReactNode;
+    error?: import("react").ReactNode;
+    children: import("react").ReactNode;
+    className?: string;
+}>>;
+export declare const Card: NonNullable<import("react").ComponentType<{
+    title?: import("react").ReactNode;
+    description?: import("react").ReactNode;
+    actions?: import("react").ReactNode;
+    children: import("react").ReactNode;
+    className?: string;
+    padded?: boolean;
+}>>;
+export declare const PageHeader: NonNullable<import("react").ComponentType<{
+    title: import("react").ReactNode;
+    description?: import("react").ReactNode;
+    actions?: import("react").ReactNode;
+}>>;
+export declare const Table: NonNullable<import("react").ComponentType<{
+    columns: import("./types.js").Column<any>[];
+    rows: any[];
+    rowKey?: (row: any) => string | number;
+    empty?: import("react").ReactNode;
+    loading?: boolean;
+    selectable?: boolean;
+    selected?: Set<string | number>;
+    onSelect?(s: Set<string | number>): void;
+    onRowClick?(row: any): void;
+    sort?: import("./types.js").SortState;
+    onSort?(s: import("./types.js").SortState): void;
+    hiddenColumns?: string[];
+    density?: Density;
+    ariaLabel?: string;
+}>>;
+export declare const Badge: NonNullable<import("react").ComponentType<{
+    tone?: "gray" | "green" | "yellow" | "red" | "blue" | "purple";
+    children: import("react").ReactNode;
+    dot?: boolean;
+}>>;
+export declare const Modal: NonNullable<import("react").ComponentType<{
+    open: boolean;
+    title: import("react").ReactNode;
+    onClose(): void;
+    children: import("react").ReactNode;
+    footer?: import("react").ReactNode;
+    width?: number;
+    description?: import("react").ReactNode;
+    dismissOnBackdrop?: boolean;
+}>>;
+export declare const Spinner: NonNullable<import("react").ComponentType<{
+    className?: string;
+}>>;
+export declare const EmptyState: NonNullable<import("react").ComponentType<{
+    title: import("react").ReactNode;
+    description?: import("react").ReactNode;
+    action?: import("react").ReactNode;
+    icon?: import("react").ReactNode;
+}>>;
+export declare const MediaPicker: NonNullable<import("react").ComponentType<{
+    value?: {
+        id: number;
+        url: string;
+    } | null;
+    onChange(value: {
+        id: number;
+        url: string;
+    } | null): void;
+    accept?: string;
+}>>;
+export declare const Switch: NonNullable<import("react").ComponentType<{
+    checked: boolean;
+    onChange(v: boolean): void;
+    disabled?: boolean;
+    label?: string;
+    children?: import("react").ReactNode;
+    description?: import("react").ReactNode;
+}>>;
+export declare const IconButton: NonNullable<import("react").ComponentType<{
+    label: string;
+    active?: boolean;
+    children: import("react").ReactNode;
+} & import("react").ButtonHTMLAttributes<HTMLButtonElement>>>;
+export declare const Section: NonNullable<import("react").ComponentType<{
+    title: import("react").ReactNode;
+    children: import("react").ReactNode;
+    defaultOpen?: boolean;
+    actions?: import("react").ReactNode;
+}>>;
+export declare const Tabs: NonNullable<import("react").ComponentType<{
+    value: string;
+    onChange(v: string): void;
+    items: Array<{
+        value: string;
+        label: import("react").ReactNode;
+        count?: number;
+    }>;
+}>>;
+export declare const MetaBoxes: NonNullable<import("react").ComponentType<import("./types.js").MetaBoxesProps>>;
+export declare const Slot: NonNullable<import("react").ComponentType<{
+    name: string;
+    props?: any;
+    fallback?: import("react").ReactNode;
+    postType?: string;
+    className?: string;
+}>>;
+export declare const Fill: NonNullable<import("react").ComponentType<{
+    name: string;
+    priority?: number;
+    children: import("react").ReactNode;
+}>>;
+export declare const Dialog: NonNullable<import("react").ComponentType<{
+    open: boolean;
+    title: import("react").ReactNode;
+    onClose(): void;
+    children: import("react").ReactNode;
+    footer?: import("react").ReactNode;
+    width?: number;
+    description?: import("react").ReactNode;
+    dismissOnBackdrop?: boolean;
+}> | undefined>;
+export declare const Drawer: NonNullable<import("react").ComponentType<{
+    open: boolean;
+    title: import("react").ReactNode;
+    onClose(): void;
+    children: import("react").ReactNode;
+    footer?: import("react").ReactNode;
+    width?: number;
+    side?: "left" | "right";
+    description?: import("react").ReactNode;
+}> | undefined>;
+export declare const Popover: NonNullable<import("react").ComponentType<{
+    trigger: (p: {
+        open: boolean;
+        toggle(): void;
+    }) => import("react").ReactNode;
+    children: (close: () => void) => import("react").ReactNode;
+    align?: "start" | "end";
+    className?: string;
+    placement?: "left" | "right" | "top" | "bottom" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+}> | undefined>;
+export declare const DropdownMenu: NonNullable<import("react").ComponentType<{
+    trigger: React.ReactElement;
+    children: import("react").ReactNode;
+    align?: "start" | "end";
+    className?: string;
+    placement?: "left" | "right" | "top" | "bottom" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+}> | undefined>;
+export declare const MenuItem: NonNullable<import("react").ComponentType<{
+    icon?: import("react").ReactNode;
+    children: import("react").ReactNode;
+    onClick?(): void;
+    danger?: boolean;
+    shortcut?: import("react").ReactNode;
+    disabled?: boolean;
+    keepOpen?: boolean;
+}> | undefined>;
+export declare const MenuSeparator: NonNullable<import("react").ComponentType<{}> | undefined>;
+export declare const MenuLabel: NonNullable<import("react").ComponentType<{
+    children: import("react").ReactNode;
+}> | undefined>;
+export declare const Tooltip: NonNullable<import("react").ComponentType<{
+    content: import("react").ReactNode;
+    children: React.ReactElement;
+    placement?: "left" | "right" | "top" | "bottom" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+    delay?: number;
+}> | undefined>;
+export declare const Skeleton: NonNullable<import("react").ComponentType<{
+    className?: string;
+}> | undefined>;
+export declare const Combobox: NonNullable<import("react").ComponentType<{
+    value: string | null;
+    onChange(v: string | null): void;
+    options: import("./types.js").UiOption[];
+    placeholder?: string;
+    disabled?: boolean;
+    ariaLabel?: string;
+    onSearch?(q: string): void;
+    clearable?: boolean;
+    className?: string;
+    emptyText?: import("react").ReactNode;
+}> | undefined>;
+export declare const TagInput: NonNullable<import("react").ComponentType<{
+    value: string[];
+    onChange(v: string[]): void;
+    options?: import("./types.js").UiOption[];
+    creatable?: boolean;
+    placeholder?: string;
+    ariaLabel?: string;
+    disabled?: boolean;
+    max?: number;
+    onSearch?(q: string): void;
+}> | undefined>;
+export declare const DatePicker: NonNullable<import("react").ComponentType<{
+    value: string | null;
+    onChange(v: string | null): void;
+    withTime?: boolean;
+    placeholder?: string;
+    ariaLabel?: string;
+    disabled?: boolean;
+    min?: string;
+    max?: string;
+    clearable?: boolean;
+}> | undefined>;
+export declare const RadioGroup: NonNullable<import("react").ComponentType<{
+    value: string;
+    onChange(v: string): void;
+    options: Array<{
+        value: string;
+        label: import("react").ReactNode;
+        description?: import("react").ReactNode;
+        disabled?: boolean;
+    }>;
+    ariaLabel?: string;
+    variant?: "list" | "cards" | "segmented";
+    disabled?: boolean;
+}> | undefined>;
+export declare const TreeView: NonNullable<import("react").ComponentType<{
+    nodes: import("./types.js").TreeNode[];
+    ariaLabel: string;
+    checkable?: boolean;
+    checked?: Array<string | number>;
+    onCheck?(id: string | number, value: boolean): void;
+    selected?: string | number | null;
+    onSelect?(id: string | number): void;
+    defaultExpanded?: "all" | "none" | Array<string | number>;
+    className?: string;
+}> | undefined>;
+export declare const Pagination: NonNullable<import("react").ComponentType<{
+    page: number;
+    totalPages: number;
+    onPage(p: number): void;
+    total?: number;
+    pageSize?: number;
+    onPageSize?(n: number): void;
+    pageSizes?: number[];
+}> | undefined>;
+export declare const TableSettingsMenu: NonNullable<import("react").ComponentType<{
+    columns: Array<{
+        key: string;
+        title: import("react").ReactNode;
+    }>;
+    settings: TableSettings;
+}> | undefined>;
+/** Cột ẩn + mật độ của một bảng, nhớ theo `key` (vd "my-plugin:orders"). CMS cũ: không lưu, mọi cột hiện. */
+export declare function useTableSettings(key: string, defaults?: {
+    hidden?: string[];
+    density?: Density;
+}): TableSettings;
+/** ISO (UTC) → giá trị cho `DatePicker withTime` (giờ địa phương). */
+export declare const isoToLocal: (iso?: string | null) => string | null;
+/** Giá trị của `DatePicker withTime` → ISO (UTC). */
+export declare const localToIso: (v: string | null) => string | null;
+/** Hỏi xác nhận bằng hộp thoại của admin (CMS cũ: window.confirm). `danger` = nút đỏ, focus mặc định ở "Huỷ". */
+export declare const confirmDialog: (message: string, opts?: AskOptions) => Promise<boolean>;
+/** Hỏi một chuỗi; null khi huỷ (CMS cũ: window.prompt). */
+export declare const promptDialog: (message: string, opts?: AskOptions & {
+    defaultValue?: string;
+    placeholder?: string;
+}) => Promise<string | null>;
+/** Báo một thông điệp, chờ người dùng bấm OK (CMS cũ: window.alert). */
+export declare const alertDialog: (message: string, opts?: AskOptions) => Promise<void>;

package/dist/index.js

@@ -0,0 +1,193 @@
+import { host } from "./host.js";
+export * from "./types.js";
+export const registerPage = (page) => host().registerPage(page);
+export const registerMetaBox = (box) => host().registerMetaBox(box);
+/** Sidebar riêng trong trình soạn bài, kèm nút trên thanh hành động (CMS cũ chưa hỗ trợ thì bỏ qua). */
+export const registerEditorSidebar = (s) => host().registerEditorSidebar?.(s);
+export const registerDashboardWidget = (w) => host().registerDashboardWidget(w);
+/** Thêm cột vào danh sách bài viết/trang (vd điểm SEO). */
+export const registerPostListColumn = (c) => host().registerPostListColumn(c);
+/** Thêm hộp vào form sửa chuyên mục/thẻ (dữ liệu lưu trong term.meta). */
+export const registerTermMetaBox = (b) => host().registerTermMetaBox(b);
+/** Lấy các MetaBox đã đăng ký trong hệ thống (tùy chọn lọc theo postType). */
+export const getMetaBoxes = (postType) => (host().getMetaBoxes ? host().getMetaBoxes(postType) : []);
+/** Hook lấy toàn bộ state plugin UI trong host. */
+export const usePluginUi = () => (host().usePluginUi ? host().usePluginUi() : { metaBoxes: [], pages: {}, dashboardWidgets: [], postListColumns: [], termMetaBoxes: [], loaded: true, errors: [] });
+export const useApi = (path) => host().useApi(path);
+export const can = (capability) => host().can(capability);
+/**
+ * Khối cho trình soạn nội dung, khai báo bằng defineBlock (file dùng chung với phần website của plugin):
+ * trình soạn tự có mục slash menu, khung khối và form cài đặt sinh từ attributes. Nhãn "%khoá%" dịch theo
+ * locales của plugin khi tên khối có tiền tố "slug/" (vd "lien-he/callout").
+ */
+export const registerBlock = (def, options) => {
+    const editor = host().editor;
+    if (!editor.registerBlock)
+        throw new Error("registerBlock cần CMS ≥ 1.8.0 (trình soạn hỗ trợ defineBlock)");
+    editor.registerBlock(def, options);
+};
+/**
+ * Thêm panel vào tab "Khối" của trình soạn cho một số loại khối (kể cả khối lõi như "image", "button") hoặc mọi khối:
+ *   registerBlockPanel({ id: "seo/link-rel", title: "%link.title%", blocks: ["button"], attributes: { sponsored: { default: false } }, component: Panel })
+ * CMS cũ (chưa có tab "Khối") → bỏ qua, không lỗi.
+ */
+export const registerBlockPanel = (panel) => host().editor.registerBlockPanel?.(panel);
+/**
+ * Thêm mẫu (đoạn dựng sẵn) vào tab "Mẫu" của trình chèn:
+ *   registerPattern({ name: "shop/product-hero", title: "%pattern.hero%", category: "hero", content: { type: "doc", content: [...] } })
+ * CMS cũ (chưa có tab Mẫu) → bỏ qua, không lỗi.
+ */
+export const registerPattern = (pattern) => host().editor.registerPattern?.(pattern);
+export { defineBlock } from "@ecomcx/nexus-content";
+/** Thêm node/mark TipTap cho trình soạn (cấp thấp — khối thường dùng registerBlock). */
+export const registerEditorExtension = (pack) => host().editor.register(pack);
+/** Lớp TipTap dùng chung với admin (không cần cài @tiptap/core trong plugin). */
+export const tiptap = new Proxy({}, { get: (_t, k) => host().editor.tiptap[k] });
+export const currentUser = () => host().currentUser();
+/**
+ * Công bố hàm cho plugin khác dùng trong admin (gọi ở đầu bundle):  exposeApi({ openCartDrawer, formatPrice })
+ * Bên dùng:  const shop = await waitForPluginApi<ShopAdminApi>("shop");  shop?.formatPrice(1000)
+ */
+export const exposeApi = (api) => host().plugins?.expose("", api);
+/** Hàm plugin khác đã công bố (undefined nếu plugin chưa bật hoặc bundle chưa nạp xong). */
+export const getPluginApi = (slug) => host().plugins?.get(slug);
+/** Chờ plugin khác nạp xong rồi lấy hàm (undefined nếu plugin không bật). */
+export const waitForPluginApi = (slug, timeoutMs) => host().plugins ? host().plugins.wait(slug, timeoutMs) : Promise.resolve(undefined);
+/**
+ * Dịch chuỗi giao diện theo khoá (ICU MessageFormat). Bản dịch của plugin đặt trong gói: locales/vi.json, locales/en.json
+ * — CMS tự nạp với namespace = slug plugin:
+ *   locales/en.json: { "form.title": "Contact", "form.count": "{count, plural, one {# message} other {# messages}}" }
+ *   const t = createT("lien-he");  t("form.title") → "Contact";  t("form.count", { count: 3 }) → "3 messages"
+ * Khoá có ":" là khoá đầy đủ ("core:common.save" — nhãn chung của lõi, "plugin-khac:x").
+ */
+export const t = (key, values) => (host().i18n.t ? host().i18n.t(key, values) : key);
+/** Hàm dịch gắn sẵn namespace của plugin. */
+export const createT = (namespace) => (key, values) => t(key.includes(":") ? key : `${namespace}:${key}`, values);
+/** Thêm bản dịch bằng mã (ngoài locales/*.json), vd bản dịch tải từ API. */
+export const registerMessages = (namespace, locale, dict) => host().i18n.registerMessages?.(namespace, locale, dict);
+/** @deprecated Chuỗi gốc tiếng Việt làm khoá — dùng t()/createT() với locales/*.json. */
+export const __ = (text, ...args) => host().i18n.__(text, ...args);
+/** @deprecated Dùng locales/*.json hoặc registerMessages(). */
+export const registerTranslations = (locale, dict) => host().i18n.registerTranslations(locale, dict);
+export const adminLocale = () => host().i18n.locale;
+export const api = {
+    get: (p) => host().api.get(p),
+    post: (p, b) => host().api.post(p, b),
+    put: (p, b) => host().api.put(p, b),
+    del: (p) => host().api.del(p),
+    upload: (p, f, field) => host().api.upload(p, f, field),
+};
+export const notify = {
+    success: (m) => host().notify.success(m),
+    error: (m) => host().notify.error(m),
+    info: (m) => host().notify.info(m),
+};
+// Component UI: lấy lười từ host để module plugin có thể được import trước khi render.
+// `fallback`: dùng khi CMS cũ chưa có component đó (UI kit v2) — plugin vẫn chạy, chỉ giản dị hơn.
+const ui = (name, fallback) => ((props) => {
+    const C = host().ui[name] ?? fallback;
+    if (!C) {
+        console.warn(`[admin-sdk] CMS chưa có ui.${String(name)} — cần bản CMS mới hơn`);
+        return null;
+    }
+    return host().React.createElement(C, props);
+});
+const h = (...a) => host().React.createElement(...a);
+export const registerSlot = (slot) => host().registerSlot(slot);
+export const getSlots = (slot, postType) => (host().getSlots ? host().getSlots(slot, postType) : []);
+export const registerPostRowAction = (a) => host().registerPostRowAction(a);
+/** Thao tác hàng loạt trên danh sách bài (CMS ≥ 1.2.0). */
+export const registerPostBulkAction = (a) => host().registerPostBulkAction?.(a);
+/** Bộ lọc theo meta trên danh sách bài (CMS ≥ 1.2.0). */
+export const registerPostListFilter = (f) => host().registerPostListFilter?.(f);
+/** Hộp trong trang sửa thành viên / hồ sơ, lưu vào user meta (CMS ≥ 1.2.0). */
+export const registerUserProfileBox = (b) => host().registerUserProfileBox?.(b);
+/** Cột / nút trên dòng / thao tác hàng loạt cho danh sách người dùng, bình luận, media (list: "users" | "comments" | "media"). */
+export const registerListColumn = (c) => host().registerListColumn?.(c);
+export const registerListRowAction = (a) => host().registerListRowAction?.(a);
+export const registerListBulkAction = (a) => host().registerListBulkAction?.(a);
+export const getPostRowActions = (postType) => (host().getPostRowActions ? host().getPostRowActions(postType) : []);
+export const hooks = new Proxy({}, {
+    get: (_t, k) => host().hooks?.[k] ?? (() => { }),
+});
+export const addAction = (hook, namespace, cb, priority) => host().hooks.addAction(hook, namespace, cb, priority);
+export const doAction = (hook, ...args) => host().hooks.doAction(hook, ...args);
+export const addFilter = (filter, namespace, cb, priority) => host().hooks.addFilter(filter, namespace, cb, priority);
+export const applyFilters = (filter, value, ...args) => host().hooks.applyFilters(filter, value, ...args);
+export const removeAction = (hook, namespace) => host().hooks.removeAction(hook, namespace);
+export const removeFilter = (filter, namespace) => host().hooks.removeFilter(filter, namespace);
+export const hasAction = (hook, namespace) => host().hooks.hasAction(hook, namespace);
+export const hasFilter = (filter, namespace) => host().hooks.hasFilter(filter, namespace);
+export const Button = ui("Button");
+export const Input = ui("Input");
+export const Textarea = ui("Textarea");
+export const Select = ui("Select");
+export const Checkbox = ui("Checkbox");
+export const Field = ui("Field");
+export const Card = ui("Card");
+export const PageHeader = ui("PageHeader");
+export const Table = ui("Table");
+export const Badge = ui("Badge");
+export const Modal = ui("Modal");
+export const Spinner = ui("Spinner");
+export const EmptyState = ui("EmptyState");
+export const MediaPicker = ui("MediaPicker");
+export const Switch = ui("Switch");
+export const IconButton = ui("IconButton");
+export const Section = ui("Section");
+export const Tabs = ui("Tabs");
+export const MetaBoxes = ui("MetaBoxes");
+export const Slot = ui("Slot");
+export const Fill = ui("Fill");
+// ----- UI kit v2 (xem trang /ui-kit trong admin) -----
+export const Dialog = ui("Dialog", (p) => h(host().ui.Modal, p));
+export const Drawer = ui("Drawer", (p) => h(host().ui.Modal, p));
+export const Popover = ui("Popover");
+export const DropdownMenu = ui("DropdownMenu");
+export const MenuItem = ui("MenuItem");
+export const MenuSeparator = ui("MenuSeparator", () => null);
+export const MenuLabel = ui("MenuLabel");
+export const Tooltip = ui("Tooltip", (p) => p.children);
+export const Skeleton = ui("Skeleton", (p) => h("div", { className: p.className }));
+export const Combobox = ui("Combobox", (p) => h(host().ui.Select, {
+    value: p.value ?? "", disabled: p.disabled, "aria-label": p.ariaLabel, onChange: (e) => p.onChange(e.target.value || null),
+    options: [{ value: "", label: p.placeholder ?? "—" }, ...p.options],
+}));
+export const TagInput = ui("TagInput", (p) => h(host().ui.Input, {
+    defaultValue: p.value.join(", "), placeholder: p.placeholder, "aria-label": p.ariaLabel, disabled: p.disabled,
+    onBlur: (e) => p.onChange(String(e.target.value).split(",").map((x) => x.trim()).filter(Boolean)),
+}));
+export const DatePicker = ui("DatePicker", (p) => h(host().ui.Input, {
+    type: p.withTime ? "datetime-local" : "date", value: p.value ?? "", min: p.min, max: p.max, disabled: p.disabled, "aria-label": p.ariaLabel,
+    onChange: (e) => p.onChange(e.target.value || null),
+}));
+export const RadioGroup = ui("RadioGroup", (p) => h(host().ui.Select, {
+    value: p.value, disabled: p.disabled, "aria-label": p.ariaLabel, onChange: (e) => p.onChange(e.target.value),
+    options: p.options.map((o) => ({ value: o.value, label: typeof o.label === "string" ? o.label : o.value })),
+}));
+export const TreeView = ui("TreeView");
+export const Pagination = ui("Pagination");
+export const TableSettingsMenu = ui("TableSettingsMenu", () => null);
+/** Cột ẩn + mật độ của một bảng, nhớ theo `key` (vd "my-plugin:orders"). CMS cũ: không lưu, mọi cột hiện. */
+export function useTableSettings(key, defaults) {
+    const fn = host().ui.useTableSettings;
+    if (fn)
+        return fn(key, defaults);
+    return { hidden: defaults?.hidden ?? [], density: defaults?.density ?? "comfortable", toggleColumn: () => { }, setDensity: () => { } };
+}
+const pad = (n) => String(n).padStart(2, "0");
+/** ISO (UTC) → giá trị cho `DatePicker withTime` (giờ địa phương). */
+export const isoToLocal = (iso) => {
+    if (!iso)
+        return null;
+    const d = new Date(iso);
+    return isNaN(d.getTime()) ? null : `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}T${pad(d.getHours())}:${pad(d.getMinutes())}`;
+};
+/** Giá trị của `DatePicker withTime` → ISO (UTC). */
+export const localToIso = (v) => (v ? new Date(v).toISOString() : null);
+/** Hỏi xác nhận bằng hộp thoại của admin (CMS cũ: window.confirm). `danger` = nút đỏ, focus mặc định ở "Huỷ". */
+export const confirmDialog = (message, opts) => host().ui.confirmDialog ? host().ui.confirmDialog(message, opts) : Promise.resolve(window.confirm(message));
+/** Hỏi một chuỗi; null khi huỷ (CMS cũ: window.prompt). */
+export const promptDialog = (message, opts) => host().ui.promptDialog ? host().ui.promptDialog(message, opts) : Promise.resolve(window.prompt(message, opts?.defaultValue ?? ""));
+/** Báo một thông điệp, chờ người dùng bấm OK (CMS cũ: window.alert). */
+export const alertDialog = (message, opts) => host().ui.alertDialog ? host().ui.alertDialog(message, opts) : Promise.resolve(window.alert(message));

package/dist/jsx-runtime.d.ts

@@ -0,0 +1,4 @@
+export declare const jsx: typeof import("react/jsx-runtime").jsx;
+export declare const jsxs: typeof import("react/jsx-runtime").jsxs;
+export declare const Fragment: import("react").ExoticComponent<import("react").FragmentProps>;
+export declare const jsxDEV: typeof import("react/jsx-runtime").jsx;

package/dist/jsx-runtime.js

@@ -0,0 +1,6 @@
+import { host } from "./host.js";
+const rt = host().jsxRuntime;
+export const jsx = rt.jsx;
+export const jsxs = rt.jsxs;
+export const Fragment = rt.Fragment;
+export const jsxDEV = rt.jsx;

package/dist/react.d.ts

@@ -0,0 +1,11 @@
+declare const React: typeof import("react");
+export default React;
+export declare const Children: {
+    map<T, C>(children: C | readonly C[], fn: (child: C, index: number) => T): C extends null | undefined ? C : Array<Exclude<T, boolean | null | undefined>>;
+    forEach<C>(children: C | readonly C[], fn: (child: C, index: number) => void): void;
+    count(children: any): number;
+    only<C>(children: C): C extends any[] ? never : C;
+    toArray(children: import("react").ReactNode | import("react").ReactNode[]): Array<Exclude<import("react").ReactNode, boolean | null | undefined>>;
+}, Component: typeof import("react").Component, Fragment: import("react").ExoticComponent<import("react").FragmentProps>, PureComponent: typeof import("react").PureComponent, StrictMode: import("react").ExoticComponent<{
+    children?: import("react").ReactNode | undefined;
+}>, Suspense: import("react").ExoticComponent<import("react").SuspenseProps>, cloneElement: typeof import("react").cloneElement, createContext: typeof import("react").createContext, createElement: typeof import("react").createElement, createRef: typeof import("react").createRef, forwardRef: typeof import("react").forwardRef, isValidElement: typeof import("react").isValidElement, lazy: typeof import("react").lazy, memo: typeof import("react").memo, startTransition: typeof import("react").startTransition, use: typeof import("react").use, useActionState: typeof import("react").useActionState, useCallback: typeof import("react").useCallback, useContext: typeof import("react").useContext, useDebugValue: typeof import("react").useDebugValue, useDeferredValue: typeof import("react").useDeferredValue, useEffect: typeof import("react").useEffect, useId: typeof import("react").useId, useImperativeHandle: typeof import("react").useImperativeHandle, useInsertionEffect: typeof import("react").useInsertionEffect, useLayoutEffect: typeof import("react").useLayoutEffect, useMemo: typeof import("react").useMemo, useOptimistic: typeof import("react").useOptimistic, useReducer: typeof import("react").useReducer, useRef: typeof import("react").useRef, useState: typeof import("react").useState, useSyncExternalStore: typeof import("react").useSyncExternalStore, useTransition: typeof import("react").useTransition;

package/dist/react.js

@@ -0,0 +1,5 @@
+// Shim: plugin import "react" → dùng chung React của admin (không bundle React thứ hai).
+import { host } from "./host.js";
+const React = host().React;
+export default React;
+export const { Children, Component, Fragment, PureComponent, StrictMode, Suspense, cloneElement, createContext, createElement, createRef, forwardRef, isValidElement, lazy, memo, startTransition, use, useActionState, useCallback, useContext, useDebugValue, useDeferredValue, useEffect, useId, useImperativeHandle, useInsertionEffect, useLayoutEffect, useMemo, useOptimistic, useReducer, useRef, useState, useSyncExternalStore, useTransition, } = React;