@ecomcx/ecomweb-theme-sdk 1.29.0 → 1.31.0

package/dist/api.d.ts

@@ -203,6 +203,8 @@ export interface MediaQuery {
 /** Danh sách media (thư viện ảnh, tài liệu tải về) — plugin giới hạn / mở rộng qua filter media.query. */
 export declare const getMedia: ({ params, ...q }?: MediaQuery) => Promise<ListPage<Media>>;
 export declare const getPost: (type: string, slug: string, locale?: string) => Promise<Post | null>;
+/** Bài đã đăng theo id (core ≥ 1.20.0 có hàm này; endpoint có từ trước). Không có / chưa đăng → null. */
+export declare const getPostById: (id: number) => Promise<Post | null>;
 export declare const getTerms: (taxonomy: string, hideEmpty?: boolean, locale?: string) => Promise<Term[]>;
 /** Cookie giữ token bản nháp của Trình dựng (website đang ở chế độ xem trước). */
 export declare const TEMPLATE_DRAFT_COOKIE = "cms-template-draft";

package/dist/api.js

@@ -161,6 +161,8 @@ export const getAuthors = async ({ params, ...q } = {}) => cmsFetch("/authors",
 /** Danh sách media (thư viện ảnh, tài liệu tải về) — plugin giới hạn / mở rộng qua filter media.query. */
 export const getMedia = async ({ params, ...q } = {}) => cmsFetch("/media", { tags: ["media"], query: clean({ ...params, ...q }) });
 export const getPost = async (type, slug, locale) => cmsFetch(`/posts/${type}/${encodeURIComponent(slug)}`, { tags: ["posts"], query: clean({ locale: await loc(locale) }) }).catch(() => null);
+/** Bài đã đăng theo id (core ≥ 1.20.0 có hàm này; endpoint có từ trước). Không có / chưa đăng → null. */
+export const getPostById = async (id) => cmsFetch(`/posts/id/${id}`, { tags: ["posts", `post:${id}`] }).catch(() => null);
 export const getTerms = async (taxonomy, hideEmpty = true, locale) => cmsFetch(`/terms/${taxonomy}`, { tags: ["terms"], query: clean({ hideEmpty, locale: await loc(locale) }) });
 /** Cookie giữ token bản nháp của Trình dựng (website đang ở chế độ xem trước). */
 export const TEMPLATE_DRAFT_COOKIE = "cms-template-draft";

package/dist/auth-forms.d.ts

@@ -28,6 +28,15 @@ export declare const AUTH_LABELS: {
     login2: string;
     registerClosed: string;
     missingToken: string;
+    bio: string;
+    currentPassword: string;
+    currentPasswordForEmail: string;
+    submitProfile: string;
+    submitPassword: string;
+    notSignedIn: string;
+    deleteWarning: string;
+    deleteConfirm: string;
+    submitDelete: string;
 };
 export type AuthLabels = typeof AUTH_LABELS;
 /**
@@ -52,6 +61,13 @@ export declare function LoginForm({ redirectTo, labels, links, paths, fields }:
     paths?: Partial<AuthPaths>;
     fields?: ReactNode;
 }): import("react").JSX.Element;
+/** Nút "Đăng nhập bằng …" của plugin (ISignInProvider, core ≥ 1.20.0). Core cũ không trả providers → không có nút. */
+export interface SignInProvider {
+    id: string;
+    label: string;
+    iconUrl?: string | null;
+    url: string;
+}
 /** Đăng ký thành viên (chỉ khi quản trị viên bật "Ai cũng có thể đăng ký"). Vai trò = vai trò mặc định trong Cài đặt. */
 export declare function RegisterForm({ labels, links, paths, fields }: {
     labels?: Partial<AuthLabels>;
@@ -81,3 +97,24 @@ export declare function LogoutButton({ redirectTo, className, children }: {
  * Server Component nên dùng getCurrentUser() để khỏi tốn thêm một request.
  */
 export declare function useCurrentUser(): CurrentUser | null | undefined;
+/**
+ * Sửa hồ sơ của thành viên đang đăng nhập (core ≥ 1.20.0): tên hiển thị, giới thiệu, email. Đổi email cần mật khẩu hiện tại.
+ * Đặt trong trang tài khoản của theme (vd template "account"); khách chưa đăng nhập thấy lời nhắn.
+ */
+export declare function ProfileForm({ labels, fields, onSaved }: {
+    labels?: Partial<AuthLabels>;
+    fields?: ReactNode;
+    onSaved?(user: CurrentUser): void;
+}): import("react").JSX.Element | null;
+/** Đổi mật khẩu của thành viên đang đăng nhập (core ≥ 1.20.0); các thiết bị khác bị đăng xuất. */
+export declare function ChangePasswordForm({ labels }: {
+    labels?: Partial<AuthLabels>;
+}): import("react").JSX.Element;
+/**
+ * Thành viên tự xoá tài khoản (core ≥ 1.20.0): nhập lại mật khẩu và đánh dấu xác nhận. Tài khoản quản trị không xoá được ở đây.
+ * Xong thì đăng xuất và chuyển về <paramref name="redirectTo"/>.
+ */
+export declare function DeleteAccountForm({ labels, redirectTo }: {
+    labels?: Partial<AuthLabels>;
+    redirectTo?: string;
+}): import("react").JSX.Element;

package/dist/auth-forms.js

@@ -42,6 +42,11 @@ export const AUTH_LABELS = {
     sending: "Đang xử lý…", error: "Có lỗi xảy ra, vui lòng thử lại", logout: "Đăng xuất",
     noAccount: "Chưa có tài khoản?", register: "Đăng ký", forgot: "Quên mật khẩu?", haveAccount: "Đã có tài khoản?", login2: "Đăng nhập",
     registerClosed: "Website hiện không mở đăng ký thành viên.", missingToken: "Liên kết không hợp lệ — hãy yêu cầu đặt lại mật khẩu lần nữa.",
+    // Hồ sơ (core ≥ 1.20)
+    bio: "Giới thiệu", currentPassword: "Mật khẩu hiện tại", currentPasswordForEmail: "Mật khẩu hiện tại (cần khi đổi email)",
+    submitProfile: "Lưu hồ sơ", submitPassword: "Đổi mật khẩu", notSignedIn: "Bạn cần đăng nhập để xem trang này.",
+    deleteWarning: "Xoá tài khoản là vĩnh viễn: bạn không đăng nhập được nữa, bài viết của bạn không còn tác giả.",
+    deleteConfirm: "Tôi hiểu, xoá tài khoản của tôi", submitDelete: "Xoá tài khoản",
 };
 export const AUTH_PATHS = { login: "/login", register: "/register", forgotPassword: "/forgot-password", home: "/" };
 function Field({ label, children }) {
@@ -65,6 +70,7 @@ export function LoginForm({ redirectTo, labels, links = true, paths, fields }) {
     const [challenge, setChallenge] = useState(null);
     const [busy, setBusy] = useState(false);
     const [error, setError] = useState("");
+    const providers = useSignInProviders();
     async function onSubmit(e) {
         e.preventDefault();
         const fd = new FormData(e.currentTarget);
@@ -87,7 +93,14 @@ export function LoginForm({ redirectTo, labels, links = true, paths, fields }) {
             setBusy(false);
         }
     }
-    return (_jsxs("form", { className: "auth-form login-form", onSubmit: onSubmit, children: [challenge ? (_jsx(Field, { label: L.code, children: _jsx("input", { name: "code", inputMode: "numeric", autoComplete: "one-time-code", required: true, maxLength: 12, autoFocus: true }) })) : (_jsxs(_Fragment, { children: [_jsx(Field, { label: L.login, children: _jsx("input", { name: "login", autoComplete: "username", required: true, maxLength: 200 }) }), _jsx(Field, { label: L.password, children: _jsx("input", { name: "password", type: "password", autoComplete: "current-password", required: true }) }), fields] })), _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy, children: busy ? L.sending : challenge ? L.verify : L.submitLogin }) }), _jsx(Status, { error: error }), links && !challenge && (_jsxs("p", { className: "auth-links", children: [_jsx("a", { href: P.forgotPassword, children: L.forgot }), " \u00B7 ", L.noAccount, " ", _jsx("a", { href: P.register, children: L.register })] }))] }));
+    return (_jsxs("form", { className: "auth-form login-form", onSubmit: onSubmit, children: [challenge ? (_jsx(Field, { label: L.code, children: _jsx("input", { name: "code", inputMode: "numeric", autoComplete: "one-time-code", required: true, maxLength: 12, autoFocus: true }) })) : (_jsxs(_Fragment, { children: [_jsx(Field, { label: L.login, children: _jsx("input", { name: "login", autoComplete: "username", required: true, maxLength: 200 }) }), _jsx(Field, { label: L.password, children: _jsx("input", { name: "password", type: "password", autoComplete: "current-password", required: true }) }), fields] })), _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy, children: busy ? L.sending : challenge ? L.verify : L.submitLogin }) }), _jsx(Status, { error: error }), !challenge && providers.length > 0 && (_jsx("p", { className: "auth-providers", children: providers.map((p) => (_jsxs("a", { className: `auth-provider auth-provider-${p.id}`, href: `${p.url}&returnTo=${encodeURIComponent(safeRedirect(redirectParam, redirectTo ?? P.home))}`, children: [p.iconUrl && _jsx("img", { src: p.iconUrl, alt: "", width: 18, height: 18 }), p.label] }, p.id))) })), links && !challenge && (_jsxs("p", { className: "auth-links", children: [_jsx("a", { href: P.forgotPassword, children: L.forgot }), " \u00B7 ", L.noAccount, " ", _jsx("a", { href: P.register, children: L.register })] }))] }));
+}
+function useSignInProviders() {
+    const [list, setList] = useState([]);
+    useEffect(() => {
+        authApi.get("/options").then(({ data }) => setList(data.providers ?? [])).catch(() => setList([]));
+    }, []);
+    return list;
 }
 /** Đăng ký thành viên (chỉ khi quản trị viên bật "Ai cũng có thể đăng ký"). Vai trò = vai trò mặc định trong Cài đặt. */
 export function RegisterForm({ labels, links = true, paths, fields }) {
@@ -204,3 +217,105 @@ export function useCurrentUser() {
     }, []);
     return user;
 }
+/**
+ * Sửa hồ sơ của thành viên đang đăng nhập (core ≥ 1.20.0): tên hiển thị, giới thiệu, email. Đổi email cần mật khẩu hiện tại.
+ * Đặt trong trang tài khoản của theme (vd template "account"); khách chưa đăng nhập thấy lời nhắn.
+ */
+export function ProfileForm({ labels, fields, onSaved }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const loaded = useCurrentUser();
+    // Bản đã lưu gần nhất: so email với bản này (không phải bản lúc mở trang) để lần lưu sau không đòi mật khẩu lại
+    const [saved, setSaved] = useState(null);
+    const user = saved ?? loaded;
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    const [message, setMessage] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const fd = new FormData(form);
+        const email = String(fd.get("email") ?? "").trim();
+        const bio = String(fd.get("bio") ?? "");
+        setBusy(true);
+        setError("");
+        setMessage("");
+        try {
+            const { data } = await authApi.post("/profile", {
+                body: {
+                    displayName: fd.get("displayName"),
+                    // Core không trả bio (cũ) và ô để trống → không gửi, tránh xoá giới thiệu đang có
+                    bio: user?.bio === undefined && !bio ? null : bio,
+                    email: email && email !== user?.email ? email : null, currentPassword: fd.get("currentPassword") || null,
+                },
+            });
+            const pw = form.elements.namedItem("currentPassword");
+            if (pw instanceof HTMLInputElement)
+                pw.value = "";
+            setSaved(data.user);
+            setMessage(data.message);
+            onSaved?.(data.user);
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    if (user === undefined)
+        return null;
+    if (user === null)
+        return _jsx("p", { className: "auth-form profile-signed-out", children: L.notSignedIn });
+    return (_jsxs("form", { className: "auth-form profile-form", onSubmit: onSubmit, children: [_jsx(Field, { label: L.displayName, children: _jsx("input", { name: "displayName", autoComplete: "name", required: true, maxLength: 100, defaultValue: user.displayName }) }), _jsx(Field, { label: L.bio, children: _jsx("textarea", { name: "bio", rows: 3, maxLength: 2000, defaultValue: user.bio ?? "" }) }), _jsx(Field, { label: L.email, children: _jsx("input", { name: "email", type: "email", autoComplete: "email", required: true, maxLength: 200, defaultValue: user.email }) }), _jsx(Field, { label: L.currentPasswordForEmail, children: _jsx("input", { name: "currentPassword", type: "password", autoComplete: "current-password" }) }), fields, _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy, children: busy ? L.sending : L.submitProfile }) }), _jsx(Status, { error: error, message: message })] }));
+}
+/** Đổi mật khẩu của thành viên đang đăng nhập (core ≥ 1.20.0); các thiết bị khác bị đăng xuất. */
+export function ChangePasswordForm({ labels }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    const [message, setMessage] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const fd = new FormData(form);
+        setBusy(true);
+        setError("");
+        setMessage("");
+        try {
+            const { data } = await authApi.post("/password", { body: { currentPassword: fd.get("currentPassword"), password: fd.get("password") } });
+            form.reset();
+            setMessage(data.message);
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+        }
+        finally {
+            setBusy(false);
+        }
+    }
+    return (_jsxs("form", { className: "auth-form password-form", onSubmit: onSubmit, children: [_jsx(Field, { label: L.currentPassword, children: _jsx("input", { name: "currentPassword", type: "password", autoComplete: "current-password", required: true }) }), _jsx(Field, { label: L.newPassword, children: _jsx("input", { name: "password", type: "password", autoComplete: "new-password", required: true, minLength: 10 }) }), _jsx("p", { children: _jsx("button", { type: "submit", disabled: busy, children: busy ? L.sending : L.submitPassword }) }), _jsx(Status, { error: error, message: message })] }));
+}
+/**
+ * Thành viên tự xoá tài khoản (core ≥ 1.20.0): nhập lại mật khẩu và đánh dấu xác nhận. Tài khoản quản trị không xoá được ở đây.
+ * Xong thì đăng xuất và chuyển về <paramref name="redirectTo"/>.
+ */
+export function DeleteAccountForm({ labels, redirectTo = "/" }) {
+    const L = { ...AUTH_LABELS, ...labels };
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const fd = new FormData(e.currentTarget);
+        setBusy(true);
+        setError("");
+        try {
+            await authApi.post("/delete-account", { body: { password: fd.get("password") } });
+            window.location.assign(safeRedirect(redirectTo));
+        }
+        catch (err) {
+            setError(errorMessage(err, L.error));
+            setBusy(false);
+        }
+    }
+    return (_jsxs("form", { className: "auth-form delete-account-form", onSubmit: onSubmit, children: [_jsx("p", { className: "delete-account-warning", children: L.deleteWarning }), _jsx(Field, { label: L.password, children: _jsx("input", { name: "password", type: "password", autoComplete: "current-password", required: true }) }), _jsx("p", { className: "auth-field", children: _jsxs("label", { children: [_jsx("input", { name: "confirm", type: "checkbox", required: true }), " ", L.deleteConfirm] }) }), _jsx("p", { children: _jsx("button", { type: "submit", className: "danger", disabled: busy, children: busy ? L.sending : L.submitDelete }) }), _jsx(Status, { error: error })] }));
+}

package/dist/auth-pages.js

@@ -30,4 +30,7 @@ const LABEL_KEYS = {
     submitForgot: "auth.submitForgot", newPassword: "auth.newPassword", submitReset: "auth.submitReset", sending: "auth.sending",
     error: "auth.error", logout: "auth.logout", noAccount: "auth.noAccount", register: "auth.register", forgot: "auth.forgot",
     haveAccount: "auth.haveAccount", login2: "auth.login2", registerClosed: "auth.registerClosed", missingToken: "auth.missingToken",
+    bio: "auth.bio", currentPassword: "auth.currentPassword", currentPasswordForEmail: "auth.currentPasswordForEmail", submitProfile: "auth.submitProfile",
+    submitPassword: "auth.submitPassword", notSignedIn: "auth.notSignedIn", deleteWarning: "auth.deleteWarning", deleteConfirm: "auth.deleteConfirm",
+    submitDelete: "auth.submitDelete",
 };

package/dist/auth-shared.d.ts

@@ -9,6 +9,12 @@ export interface CurrentUser {
     displayName: string;
     roles: string[];
     capabilities: string[];
+    /** Giới thiệu (core ≥ 1.20.0). */
+    bio?: string | null;
 }
-/** Chỉ nhận đường dẫn nội bộ ("/account") — chặn chuyển hướng ra trang ngoài (?redirect=https://lừa-đảo). */
+/**
+ * Chỉ nhận đường dẫn nội bộ ("/account") — chặn chuyển hướng ra trang ngoài (?redirect=https://lừa-đảo).
+ * Trình duyệt bỏ tab / xuống dòng và coi "\" như "/" khi phân tích URL, nên "/<TAB>/evil.com" hay "/\evil.com" thành "//evil.com":
+ * chặn mọi ký tự điều khiển và dấu "\" ở bất kỳ vị trí nào, không chỉ ở đầu.
+ */
 export declare function safeRedirect(target: string | null | undefined, fallback?: string): string;

package/dist/auth-shared.js

@@ -1,7 +1,14 @@
 /** Tên cookie phiên đăng nhập của website (httpOnly, do frontend core đặt). Dùng chung cho proxy và SDK. */
 export const ACCESS_COOKIE = "cms_at";
 export const REFRESH_COOKIE = "cms_rt";
-/** Chỉ nhận đường dẫn nội bộ ("/account") — chặn chuyển hướng ra trang ngoài (?redirect=https://lừa-đảo). */
+/**
+ * Chỉ nhận đường dẫn nội bộ ("/account") — chặn chuyển hướng ra trang ngoài (?redirect=https://lừa-đảo).
+ * Trình duyệt bỏ tab / xuống dòng và coi "\" như "/" khi phân tích URL, nên "/<TAB>/evil.com" hay "/\evil.com" thành "//evil.com":
+ * chặn mọi ký tự điều khiển và dấu "\" ở bất kỳ vị trí nào, không chỉ ở đầu.
+ */
 export function safeRedirect(target, fallback = "/") {
-    return target && target.startsWith("/") && !target.startsWith("//") && !target.startsWith("/\\") ? target : fallback;
+    // eslint-disable-next-line no-control-regex
+    if (!target || !target.startsWith("/") || /[\u0000-\u001f\u007f\\]/.test(target))
+        return fallback;
+    return target.startsWith("//") ? fallback : target;
 }

package/dist/bindings.d.ts

@@ -0,0 +1,15 @@
+import type { Post, ResolveResult, Site } from "./types.js";
+/**
+ * Gắn dữ liệu (@ecomcx/ecomweb-content 1.15 — `attrs.bindings`): thuộc tính của khối lấy giá trị lúc hiển thị.
+ * Nguồn lõi: core/post (trường của bài đang vẽ / bài trong vòng lặp), core/post-meta (trường meta), core/site.
+ * Plugin thêm nguồn: definePlugin({ bindingSources: { "shop/product": async (args, ctx) => … } }).
+ */
+export interface BindingContext {
+    site: Site;
+    post?: Post | null;
+    data?: ResolveResult | null;
+}
+export type BindingSource = (args: Record<string, string | number | boolean>, ctx: BindingContext) => unknown | Promise<unknown>;
+/** Thuộc tính gắn được của khối lõi: tên trong bindings → nơi đặt giá trị. */
+export declare const BINDABLE: Record<string, readonly string[]>;
+export declare const CORE_BINDING_SOURCES: Record<string, BindingSource>;

package/dist/bindings.js

@@ -0,0 +1,30 @@
+/** Thuộc tính gắn được của khối lõi: tên trong bindings → nơi đặt giá trị. */
+export const BINDABLE = {
+    paragraph: ["content"], heading: ["content"], image: ["src", "alt", "caption"], button: ["text", "href"],
+};
+const scalar = (v) => (typeof v === "string" || typeof v === "number" || typeof v === "boolean" ? String(v) : undefined);
+export const CORE_BINDING_SOURCES = {
+    "core/post": (args, { post }) => {
+        if (!post)
+            return undefined;
+        switch (args.field) {
+            case "title": return post.title;
+            case "excerpt": return post.excerpt;
+            case "date": return post.publishedAt ? new Date(post.publishedAt).toLocaleDateString(post.locale || "vi") : undefined;
+            case "author": return post.author?.name;
+            case "link": return post.link;
+            case "featuredImage": return post.featuredMedia?.url;
+            default: return undefined;
+        }
+    },
+    "core/post-meta": (args, { post }) => (typeof args.key === "string" && post?.meta ? scalar(post.meta[args.key]) : undefined),
+    "core/site": (args, { site }) => {
+        switch (args.field) {
+            case "title": return site.title;
+            case "tagline": return site.tagline;
+            case "url": return site.url;
+            case "logo": return scalar(site.themeSettings?.logo?.url);
+            default: return undefined;
+        }
+    },
+};

package/dist/browser.d.ts

@@ -0,0 +1,56 @@
+import { type ReactNode } from "react";
+import type { ClientMessages, Translator } from "./i18n.js";
+import type { BrowserEvents } from "./client.js";
+/** Lỗi trả về từ endpoint của plugin: status HTTP, lời nhắn (title), lỗi theo từng trường (422), mã lỗi (code). */
+export declare class PluginApiError extends Error {
+    readonly status: number;
+    readonly errors?: Record<string, string[]> | undefined;
+    readonly code?: string | undefined;
+    readonly data?: unknown | undefined;
+    constructor(status: number, message: string, errors?: Record<string, string[]> | undefined, code?: string | undefined, data?: unknown | undefined);
+}
+export interface PluginRequestOptions {
+    query?: Record<string, string | number | boolean | null | undefined>;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+export interface PluginClient {
+    get<T = unknown>(path: string, opts?: PluginRequestOptions): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown, opts?: PluginRequestOptions): Promise<T>;
+    put<T = unknown>(path: string, body?: unknown, opts?: PluginRequestOptions): Promise<T>;
+    delete<T = unknown>(path: string, opts?: PluginRequestOptions): Promise<T>;
+}
+/**
+ * Gọi endpoint của plugin từ component client — cùng endpoint với `pluginFetch` phía server, qua proxy của website
+ * (`/api/cms/plugins/{slug}/…`): gửi kèm phiên của người đang đăng nhập (ICurrentUser ở backend), chặn gọi từ trang khác.
+ * Lỗi → `PluginApiError` (status, title, errors theo trường).
+ *
+ *   const shop = pluginClient("shop");
+ *   const cart = await shop.post<Cart>("/cart/items", { productId, qty: 1 });
+ */
+export declare function pluginClient(slug: string): PluginClient;
+type EventName = keyof BrowserEvents extends never ? string : keyof BrowserEvents | (string & {});
+type EventData<K> = K extends keyof BrowserEvents ? BrowserEvents[K] : unknown;
+/**
+ * Phát sự kiện cho mọi component trên trang (vd plugin giỏ hàng báo "đã thêm" để mini-cart của theme cập nhật).
+ * `crossTab: true`: các tab khác của cùng website cũng nhận (BroadcastChannel).
+ */
+export declare function emit<K extends EventName>(name: K, detail?: EventData<K>, opts?: {
+    crossTab?: boolean;
+}): void;
+/** Nghe sự kiện; trả hàm huỷ. Nhận cả sự kiện từ tab khác nếu bên phát dùng crossTab. */
+export declare function on<K extends EventName>(name: K, handler: (detail: EventData<K>) => void): () => void;
+/** Hook React của `on`: tự huỷ khi component gỡ; handler mới nhất luôn được gọi (không cần useCallback). */
+export declare function useEvent<K extends EventName>(name: K, handler: (detail: EventData<K>) => void): void;
+/**
+ * Chuyển chuỗi đã dịch xuống component client. Server Component lấy bằng `getClientMessages(["cart."])` rồi bọc:
+ *   <TranslationsProvider value={await getClientMessages(["cart."])}><CartButton /></TranslationsProvider>
+ * Nhiều provider lồng nhau được gộp (provider trong thắng).
+ */
+export declare function TranslationsProvider({ value, children }: {
+    value: ClientMessages;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** Hàm dịch trong component client — cùng cú pháp ICU với `getT`. Khoá không có trong provider → trả lại chính khoá. */
+export declare function useT(): Translator;
+export {};

package/dist/browser.js

@@ -0,0 +1,132 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef } from "react";
+import { formatMessage } from "./i18n-format.js";
+// ---------------------------------------------------------------------------
+// Gọi endpoint của plugin từ trình duyệt (core ≥ 1.20.0)
+// ---------------------------------------------------------------------------
+/** Lỗi trả về từ endpoint của plugin: status HTTP, lời nhắn (title), lỗi theo từng trường (422), mã lỗi (code). */
+export class PluginApiError extends Error {
+    status;
+    errors;
+    code;
+    data;
+    constructor(status, message, errors, code, data) {
+        super(message);
+        this.status = status;
+        this.errors = errors;
+        this.code = code;
+        this.data = data;
+        this.name = "PluginApiError";
+    }
+}
+/**
+ * Gọi endpoint của plugin từ component client — cùng endpoint với `pluginFetch` phía server, qua proxy của website
+ * (`/api/cms/plugins/{slug}/…`): gửi kèm phiên của người đang đăng nhập (ICurrentUser ở backend), chặn gọi từ trang khác.
+ * Lỗi → `PluginApiError` (status, title, errors theo trường).
+ *
+ *   const shop = pluginClient("shop");
+ *   const cart = await shop.post<Cart>("/cart/items", { productId, qty: 1 });
+ */
+export function pluginClient(slug) {
+    if (!/^[a-z0-9][a-z0-9-]{1,63}$/.test(slug))
+        throw new Error(`pluginClient: slug không hợp lệ "${slug}"`);
+    async function send(method, path, body, opts = {}) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(opts.query ?? {}))
+            if (v !== undefined && v !== null)
+                qs.set(k, String(v));
+        const url = `/api/cms/plugins/${slug}${path.startsWith("/") ? path : `/${path}`}${qs.size ? `?${qs}` : ""}`;
+        const res = await fetch(url, {
+            method, signal: opts.signal, credentials: "same-origin", cache: "no-store",
+            headers: { accept: "application/json", ...(body !== undefined ? { "content-type": "application/json" } : {}), ...opts.headers },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        const text = await res.text();
+        let data = undefined;
+        if (text) {
+            try {
+                data = JSON.parse(text);
+            }
+            catch {
+                data = text;
+            }
+        }
+        if (!res.ok) {
+            const d = (typeof data === "object" && data);
+            throw new PluginApiError(res.status, (d && (d.title ?? d.detail)) || res.statusText || `HTTP ${res.status}`, d ? d.errors : undefined, d ? d.code : undefined, data);
+        }
+        return data;
+    }
+    return {
+        get: (path, opts) => send("GET", path, undefined, opts),
+        post: (path, body, opts) => send("POST", path, body, opts),
+        put: (path, body, opts) => send("PUT", path, body, opts),
+        delete: (path, opts) => send("DELETE", path, undefined, opts),
+    };
+}
+const PREFIX = "ecx:";
+let channel;
+function tabs() {
+    if (channel === undefined) {
+        channel = typeof BroadcastChannel === "undefined" ? null : new BroadcastChannel("ecx-events");
+        // Node (test, render phía server): kênh không được giữ tiến trình sống
+        channel?.unref?.();
+    }
+    return channel;
+}
+/**
+ * Phát sự kiện cho mọi component trên trang (vd plugin giỏ hàng báo "đã thêm" để mini-cart của theme cập nhật).
+ * `crossTab: true`: các tab khác của cùng website cũng nhận (BroadcastChannel).
+ */
+export function emit(name, detail, opts) {
+    if (typeof window === "undefined")
+        return;
+    window.dispatchEvent(new CustomEvent(PREFIX + String(name), { detail }));
+    if (opts?.crossTab)
+        tabs()?.postMessage({ name: String(name), detail });
+}
+/** Nghe sự kiện; trả hàm huỷ. Nhận cả sự kiện từ tab khác nếu bên phát dùng crossTab. */
+export function on(name, handler) {
+    if (typeof window === "undefined")
+        return () => { };
+    const local = (e) => handler(e.detail);
+    const remote = (e) => { if (e.data?.name === name)
+        handler(e.data.detail); };
+    window.addEventListener(PREFIX + String(name), local);
+    tabs()?.addEventListener("message", remote);
+    return () => { window.removeEventListener(PREFIX + String(name), local); tabs()?.removeEventListener("message", remote); };
+}
+/** Hook React của `on`: tự huỷ khi component gỡ; handler mới nhất luôn được gọi (không cần useCallback). */
+export function useEvent(name, handler) {
+    const ref = useRef(handler);
+    useEffect(() => { ref.current = handler; });
+    useEffect(() => on(name, (d) => ref.current(d)), [name]);
+}
+// ---------------------------------------------------------------------------
+// Dịch chữ trong component client (core ≥ 1.20.0)
+// ---------------------------------------------------------------------------
+const TranslationsContext = createContext(null);
+/**
+ * Chuyển chuỗi đã dịch xuống component client. Server Component lấy bằng `getClientMessages(["cart."])` rồi bọc:
+ *   <TranslationsProvider value={await getClientMessages(["cart."])}><CartButton /></TranslationsProvider>
+ * Nhiều provider lồng nhau được gộp (provider trong thắng).
+ */
+export function TranslationsProvider({ value, children }) {
+    const parent = useContext(TranslationsContext);
+    const merged = useMemo(() => parent ? { locale: value.locale, messages: { ...parent.messages, ...value.messages } } : value, [parent, value]);
+    return _jsx(TranslationsContext.Provider, { value: merged, children: children });
+}
+/** Hàm dịch trong component client — cùng cú pháp ICU với `getT`. Khoá không có trong provider → trả lại chính khoá. */
+export function useT() {
+    const ctx = useContext(TranslationsContext);
+    return useMemo(() => {
+        const compiled = new Map();
+        const t = ((key, vars) => {
+            const hit = ctx?.messages[key];
+            return hit ? formatMessage(hit.text, hit.code, vars, compiled, `${hit.code}\0${key}`) : key;
+        });
+        t.locale = ctx?.locale ?? "en";
+        return t;
+    }, [ctx]);
+}

package/dist/client.d.ts

@@ -1,6 +1,14 @@
 import { Component } from "react";
 import type { Comment } from "./types.js";
 import type { AnchorHTMLAttributes, ReactNode } from "react";
+export { pluginClient, PluginApiError, emit, on, useEvent, TranslationsProvider, useT, type PluginClient, type PluginRequestOptions } from "./browser.js";
+/**
+ * Bảng tên sự kiện phía trình duyệt → dữ liệu (emit / on / useEvent, core ≥ 1.20.0). Theme / plugin khai báo kiểu cho sự kiện của mình:
+ *   declare module "@ecomcx/ecomweb-theme-sdk/client" { interface BrowserEvents { "shop.cart.changed": { count: number } } }
+ * Tên nên có tiền tố slug plugin (như hook backend).
+ */
+export interface BrowserEvents {
+}
 export declare class ExtensionBoundary extends Component<{
     name: string;
     children?: ReactNode;
@@ -98,5 +106,5 @@ export declare function LanguageSwitcherClient({ languages, current, defaultLoca
     className?: string;
     variant: "list" | "select";
 }): import("react").JSX.Element;
-export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, extraFields, AUTH_LABELS, AUTH_PATHS, type AuthLabels, type AuthPaths } from "./auth-forms.js";
+export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, extraFields, ProfileForm, ChangePasswordForm, DeleteAccountForm, AUTH_LABELS, AUTH_PATHS, type AuthLabels, type AuthPaths, type SignInProvider } from "./auth-forms.js";
 export { safeRedirect, type CurrentUser } from "./auth-shared.js";

package/dist/client.js

@@ -7,6 +7,7 @@ import NextLink, { useLinkStatus } from "next/link";
 import NextForm from "next/form";
 import { cx, formatDate } from "./utils.js";
 import { createFetchKit, isFetchKitError } from "next-fetch-kit";
+export { pluginClient, PluginApiError, emit, on, useEvent, TranslationsProvider, useT } from "./browser.js";
 // ---------------------------------------------------------------------------
 // Cô lập lỗi của plugin/theme: phần nào ném lỗi khi hiển thị thì ẩn phần đó, trang vẫn hiện bình thường
 // ---------------------------------------------------------------------------
@@ -187,5 +188,5 @@ export function LanguageSwitcherClient({ languages, current, defaultLocale, labe
         return (_jsx("select", { className: className ?? "lang-switcher", "aria-label": label, value: current, onChange: (e) => { window.location.href = href(e.target.value); }, children: languages.map((l) => _jsxs("option", { value: l.code, children: [l.flag ? `${l.flag} ` : "", l.name] }, l.code)) }));
     return (_jsx("nav", { className: className ?? "lang-switcher", "aria-label": label, children: _jsx("ul", { children: languages.map((l) => (_jsx("li", { className: l.code === current ? "current-lang" : undefined, children: _jsxs("a", { href: href(l.code), hrefLang: l.code, lang: l.code, "aria-current": l.code === current ? "true" : undefined, children: [l.flag && _jsxs("span", { "aria-hidden": true, children: [l.flag, " "] }), l.code.toUpperCase()] }) }, l.code))) }) }));
 }
-export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, extraFields, AUTH_LABELS, AUTH_PATHS } from "./auth-forms.js";
+export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, extraFields, ProfileForm, ChangePasswordForm, DeleteAccountForm, AUTH_LABELS, AUTH_PATHS } from "./auth-forms.js";
 export { safeRedirect } from "./auth-shared.js";

package/dist/content.js

@@ -2,6 +2,7 @@ import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 import { ExtensionBoundary, PostPasswordForm } from "./client.js";
 import { applyFilters, findBlock, findRegion, findShortcode, getActiveExtensions } from "./runtime.js";
 import { getPattern, getSite, getTemplates } from "./api.js";
+import { CORE_BINDING_SOURCES } from "./bindings.js";
 import { getT } from "./i18n.js";
 import { renderDynamic } from "./dynamic.js";
 import { renderContent } from "./rich.js";
@@ -57,5 +58,10 @@ export async function contentContext(site, post, data) {
         parts: async (slug) => (await getTemplates().catch(() => null))?.parts[slug] ?? null,
         region: (name, fallback) => regionOverride(name, fallback, site, data),
         pattern: (ref) => getPattern(ref),
+        binding: async (source, args, c) => {
+            const fn = CORE_BINDING_SOURCES[source] ?? (await getActiveExtensions(site)).map((d) => d.bindingSources?.[source]).find(Boolean);
+            // Bài của vòng lặp (query) / bài đang xem / bài của nội dung
+            return fn ? fn(args, { site, post: c.post ?? post, data: c.data ?? data }) : undefined;
+        },
     };
 }

package/dist/dynamic.js

@@ -78,6 +78,55 @@ export async function renderDynamic(node, key, ctx, children) {
         }
         case "comments":
             return post && ctx.data?.post?.id === post.id ? _jsx(Comments, { post: post }, key) : null;
+        // H1 của trang lưu trữ / tìm kiếm / tác giả (trang chủ dạng danh sách bài: tên trang)
+        case "queryTitle": {
+            const d = ctx.data;
+            if (!d)
+                return null;
+            const t = await getT();
+            const Tag = `h${Math.min(6, Math.max(1, a.level ?? 1))}`;
+            const text = d.search != null ? t("query.search", { q: d.search })
+                : d.term ? (a.prefix ? t(d.term.taxonomy === "post_tag" ? "query.tag" : "query.category", { name: d.term.name }) : d.term.name)
+                    : d.author ? (a.prefix ? t("query.author", { name: d.author.name }) : d.author.name)
+                        : d.title || site.title;
+            return _jsx(Tag, { className: "ecx-query-title", style: align(a), children: text }, key);
+        }
+        case "termDescription":
+            return ctx.data?.term?.description ? _jsx("div", { className: "ecx-term-description", style: align(a), children: ctx.data.term.description }, key) : null;
+        case "breadcrumbs": {
+            const d = ctx.data;
+            if (!d)
+                return null;
+            const t = await getT();
+            const items = [];
+            if (a.showHome !== false)
+                items.push({ name: t("breadcrumbs.home"), href: localeHref(site, "/") });
+            const cat = d.post?.terms?.category?.[0];
+            if (d.post && cat)
+                items.push({ name: cat.name, href: cat.link });
+            const current = d.post?.title ?? d.term?.name ?? d.author?.name ?? (d.search != null ? t("query.search", { q: d.search }) : d.title);
+            if (a.showCurrent !== false && current)
+                items.push({ name: current });
+            if (items.length < 2)
+                return null;
+            const base = (site.url ?? "").replace(/\/$/, "");
+            // Schema BreadcrumbList: Google hiện đường dẫn thay cho URL trong kết quả tìm kiếm
+            const jsonLd = { "@context": "https://schema.org", "@type": "BreadcrumbList", itemListElement: items.map((it, i) => ({ "@type": "ListItem", position: i + 1, name: it.name, ...(it.href ? { item: /^https?:/.test(it.href) ? it.href : base + it.href } : {}) })) };
+            return (_jsxs("nav", { className: "ecx-breadcrumbs", "aria-label": t("breadcrumbs.label"), children: [_jsx("ol", { children: items.map((it, i) => _jsxs("li", { children: [i > 0 && _jsx("span", { className: "ecx-breadcrumbs-sep", "aria-hidden": "true", children: a.separator ?? "›" }), it.href ? _jsx(Link, { href: it.href, children: it.name }) : _jsx("span", { "aria-current": "page", children: it.name })] }, i)) }), _jsx("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(jsonLd).replace(/</g, "\\u003c") } })] }, key));
+        }
+        case "postNavigation": {
+            const cur = ctx.data?.post;
+            if (!cur || !cur.publishedAt)
+                return null;
+            const t = await getT();
+            const [prev, next] = await Promise.all([
+                getPosts({ type: cur.type, perPage: 1, before: cur.publishedAt, orderBy: "date", order: "desc", exclude: [cur.id] }).then((r) => r.items[0]).catch(() => undefined),
+                getPosts({ type: cur.type, perPage: 1, after: cur.publishedAt, orderBy: "date", order: "asc", exclude: [cur.id] }).then((r) => r.items[0]).catch(() => undefined),
+            ]);
+            if (!prev && !next)
+                return null;
+            return (_jsxs("nav", { className: "ecx-post-navigation", "aria-label": t("postNav.label"), children: [prev ? _jsxs(Link, { className: "ecx-post-navigation-prev", href: prev.link, rel: "prev", children: [_jsx("span", { children: t("postNav.previous") }), a.showTitle !== false && _jsx("strong", { children: prev.title })] }) : _jsx("span", {}), next ? _jsxs(Link, { className: "ecx-post-navigation-next", href: next.link, rel: "next", children: [_jsx("span", { children: t("postNav.next") }), a.showTitle !== false && _jsx("strong", { children: next.title })] }) : _jsx("span", {})] }, key));
+        }
         case "query": {
             let posts;
             let data;

package/dist/i18n-format.d.ts

@@ -0,0 +1,6 @@
+import { IntlMessageFormat } from "intl-messageformat";
+/**
+ * Định dạng một thông điệp ICU (dùng chung cho getT phía server và useT phía trình duyệt).
+ * Thiếu biến hoặc cú pháp sai → thay {biến} thô, không ném lỗi.
+ */
+export declare function formatMessage(src: string, locale: string, vars: Record<string, string | number> | undefined, compiled: Map<string, IntlMessageFormat | null>, id: string): string;

package/dist/i18n-format.js

@@ -0,0 +1,28 @@
+import { IntlMessageFormat } from "intl-messageformat";
+/**
+ * Định dạng một thông điệp ICU (dùng chung cho getT phía server và useT phía trình duyệt).
+ * Thiếu biến hoặc cú pháp sai → thay {biến} thô, không ném lỗi.
+ */
+export function formatMessage(src, locale, vars, compiled, id) {
+    if (!src.includes("{") && !src.includes("'"))
+        return src;
+    if (!compiled.has(id)) {
+        try {
+            compiled.set(id, new IntlMessageFormat(src, locale, undefined, { ignoreTag: true }));
+        }
+        catch {
+            compiled.set(id, null);
+        }
+    }
+    const f = compiled.get(id);
+    try {
+        if (f)
+            return String(f.format(vars));
+    }
+    catch { /* thiếu biến → thay thô */ }
+    let s = src;
+    if (vars)
+        for (const [k, v] of Object.entries(vars))
+            s = s.replaceAll(`{${k}}`, String(v));
+    return s;
+}

package/dist/i18n.d.ts

@@ -3,9 +3,17 @@ export declare const BUILTIN: Record<string, Record<string, string>>;
 export type Translator = ((key: string, vars?: Record<string, string | number>) => string) & {
     locale: string;
 };
+export declare const getT: () => Promise<Translator>;
+/** Chuỗi đã chọn đúng ngôn ngữ để truyền xuống trình duyệt (<TranslationsProvider>). */
+export interface ClientMessages {
+    locale: string;
+    messages: Record<string, {
+        code: string;
+        text: string;
+    }>;
+}
 /**
- * Hàm dịch chữ cho ngôn ngữ hiện tại. Thông điệp theo ICU MessageFormat: biến `{name}`, số nhiều
- * `{count, plural, one {# comment} other {# comments}}`, chọn `{gender, select, …}`.
- * Thứ tự tra: locales của theme (con → cha) → chữ có sẵn của SDK; ngôn ngữ hiện tại → mặc định → tiếng Anh → chính key.
+ * Lấy các chuỗi cần cho component client (core ≥ 1.20.0) — chỉ khoá bắt đầu bằng một trong <paramref name="prefixes"/>
+ * (vd ["cart.", "auth."]) để không gửi cả từ điển xuống trình duyệt. Truyền kết quả vào <TranslationsProvider value={…}>.
  */
-export declare const getT: () => Promise<Translator>;
+export declare function getClientMessages(prefixes: string[]): Promise<ClientMessages>;

package/dist/i18n.js

@@ -1,11 +1,11 @@
-import { IntlMessageFormat } from "intl-messageformat";
 import { cache } from "react";
 import { getSite } from "./api.js";
 import { getActiveTheme } from "./runtime.js";
+import { formatMessage } from "./i18n-format.js";
 /** Chữ mặc định của các component trong SDK (theme có thể ghi đè trong locales/{code}.json). */
 export const BUILTIN = {
     vi: {
-        "search.placeholder": "Tìm kiếm…", "search.button": "Tìm", "search.label": "Từ khoá", "navigation.menu": "Menu", "toc.title": "Mục lục",
+        "search.placeholder": "Tìm kiếm…", "search.button": "Tìm", "search.label": "Từ khoá", "navigation.menu": "Menu", "toc.title": "Mục lục", "query.search": "Kết quả tìm kiếm: {q}", "query.category": "Chuyên mục: {name}", "query.tag": "Thẻ: {name}", "query.author": "Tác giả: {name}", "breadcrumbs.home": "Trang chủ", "breadcrumbs.label": "Đường dẫn", "postNav.previous": "Bài trước", "postNav.next": "Bài sau", "postNav.label": "Bài khác",
         "pagination.prev": "« Trước", "pagination.next": "Sau »", "pagination.label": "Phân trang",
         "comments.title": "Bình luận", "comments.closed": "Bình luận đã đóng.",
         "comments.form.title": "Để lại bình luận", "comments.form.content": "Bình luận", "comments.form.name": "Tên",
@@ -24,9 +24,13 @@ export const BUILTIN = {
         "auth.login2": "Đăng nhập", "auth.registerClosed": "Website hiện không mở đăng ký thành viên.",
         "auth.missingToken": "Liên kết không hợp lệ — hãy yêu cầu đặt lại mật khẩu lần nữa.", "auth.signedInAs": "Bạn đang đăng nhập với tên {name}.",
         "file.download": "Tải tệp", "form.submit": "Gửi", "form.sending": "Đang gửi…", "form.error": "Không gửi được, vui lòng thử lại",
+        "auth.bio": "Giới thiệu", "auth.currentPassword": "Mật khẩu hiện tại", "auth.currentPasswordForEmail": "Mật khẩu hiện tại (cần khi đổi email)",
+        "auth.submitProfile": "Lưu hồ sơ", "auth.submitPassword": "Đổi mật khẩu", "auth.notSignedIn": "Bạn cần đăng nhập để xem trang này.",
+        "auth.deleteWarning": "Xoá tài khoản là vĩnh viễn: bạn không đăng nhập được nữa, bài viết của bạn không còn tác giả.",
+        "auth.deleteConfirm": "Tôi hiểu, xoá tài khoản của tôi", "auth.submitDelete": "Xoá tài khoản",
     },
     en: {
-        "search.placeholder": "Search…", "search.button": "Search", "search.label": "Keyword", "navigation.menu": "Menu", "toc.title": "Contents",
+        "search.placeholder": "Search…", "search.button": "Search", "search.label": "Keyword", "navigation.menu": "Menu", "toc.title": "Contents", "query.search": "Search results: {q}", "query.category": "Category: {name}", "query.tag": "Tag: {name}", "query.author": "Author: {name}", "breadcrumbs.home": "Home", "breadcrumbs.label": "Breadcrumb", "postNav.previous": "Previous", "postNav.next": "Next", "postNav.label": "More posts",
         "pagination.prev": "« Previous", "pagination.next": "Next »", "pagination.label": "Pagination",
         "comments.title": "Comments", "comments.closed": "Comments are closed.",
         "comments.form.title": "Leave a comment", "comments.form.content": "Comment", "comments.form.name": "Name",
@@ -45,6 +49,10 @@ export const BUILTIN = {
         "auth.login2": "Log in", "auth.registerClosed": "Registration is currently closed.",
         "auth.missingToken": "Invalid link — please request a new password reset.", "auth.signedInAs": "You are logged in as {name}.",
         "file.download": "Download", "form.submit": "Send", "form.sending": "Sending…", "form.error": "Could not send, please try again",
+        "auth.bio": "Bio", "auth.currentPassword": "Current password", "auth.currentPasswordForEmail": "Current password (needed to change your email)",
+        "auth.submitProfile": "Save profile", "auth.submitPassword": "Change password", "auth.notSignedIn": "Please log in to see this page.",
+        "auth.deleteWarning": "Deleting your account is permanent: you can no longer log in and your posts will have no author.",
+        "auth.deleteConfirm": "I understand, delete my account", "auth.submitDelete": "Delete account",
     },
 };
 /**
@@ -52,7 +60,8 @@ export const BUILTIN = {
  * `{count, plural, one {# comment} other {# comments}}`, chọn `{gender, select, …}`.
  * Thứ tự tra: locales của theme (con → cha) → chữ có sẵn của SDK; ngôn ngữ hiện tại → mặc định → tiếng Anh → chính key.
  */
-export const getT = cache(async () => {
+/** Từ điển theo thứ tự tra cho ngôn ngữ hiện tại (theme con → cha → SDK; hiện tại → mặc định → tiếng Anh). */
+const getDicts = cache(async () => {
     const site = await getSite();
     const theme = await getActiveTheme(site);
     const order = [...new Set([site.locale, site.defaultLocale, "en"])];
@@ -70,35 +79,28 @@ export const getT = cache(async () => {
         if (BUILTIN[code])
             dicts.push({ code, dict: BUILTIN[code] });
     }
+    return { site, dicts };
+});
+export const getT = cache(async () => {
+    const { site, dicts } = await getDicts();
     const compiled = new Map();
     const t = ((key, vars) => {
         const hit = dicts.find((d) => d.dict[key] !== undefined);
-        if (!hit)
-            return key;
-        const src = hit.dict[key];
-        if (!src.includes("{") && !src.includes("'"))
-            return src;
-        const id = `${hit.code}\0${key}`;
-        if (!compiled.has(id)) {
-            try {
-                compiled.set(id, new IntlMessageFormat(src, hit.code, undefined, { ignoreTag: true }));
-            }
-            catch {
-                compiled.set(id, null);
-            }
-        }
-        const f = compiled.get(id);
-        try {
-            if (f)
-                return String(f.format(vars));
-        }
-        catch { /* thiếu biến → thay thô như bản cũ */ }
-        let s = src;
-        if (vars)
-            for (const [k, v] of Object.entries(vars))
-                s = s.replaceAll(`{${k}}`, String(v));
-        return s;
+        return hit ? formatMessage(hit.dict[key], hit.code, vars, compiled, `${hit.code}\0${key}`) : key;
     });
     t.locale = site.locale;
     return t;
 });
+/**
+ * Lấy các chuỗi cần cho component client (core ≥ 1.20.0) — chỉ khoá bắt đầu bằng một trong <paramref name="prefixes"/>
+ * (vd ["cart.", "auth."]) để không gửi cả từ điển xuống trình duyệt. Truyền kết quả vào <TranslationsProvider value={…}>.
+ */
+export async function getClientMessages(prefixes) {
+    const { site, dicts } = await getDicts();
+    const messages = {};
+    for (const d of dicts)
+        for (const [key, text] of Object.entries(d.dict))
+            if (!(key in messages) && prefixes.some((p) => key.startsWith(p)))
+                messages[key] = { code: d.code, text };
+    return { locale: site.locale, messages };
+}

package/dist/index.d.ts

@@ -5,15 +5,16 @@ export { definePlugin, getPlugin, hasPlugin, applyFilters, doAction, getSlotItem
 export { PostContent, EditableRegion } from "./content.js";
 export { Img, imageCandidates, type ImgProps } from "./image.js";
 export { Menu, WidgetArea, Slot, SearchForm, Pagination, FeaturedImage, PostDate, TermLinks, Comments, LanguageSwitcher } from "./components.js";
-export { getT, BUILTIN as BUILTIN_STRINGS, type Translator } from "./i18n.js";
+export { getT, getClientMessages, BUILTIN as BUILTIN_STRINGS, type Translator, type ClientMessages } from "./i18n.js";
 export { getRequestLocale, localeHref, LOCALE_HEADER } from "./locale.js";
 export { CommentForm, CommentList, CommentsMore, ExtensionBoundary, PostPasswordForm, Link, isInternalHref, type LinkProps } from "./client.js";
 export { getPreference } from "./preferences.js";
 export { getCurrentUser, getAccessToken, requireUser, userCan, safeRedirect, ACCESS_COOKIE, REFRESH_COOKIE, type CurrentUser } from "./auth.js";
-export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, AUTH_LABELS, AUTH_PATHS, type AuthLabels, type AuthPaths } from "./auth-forms.js";
+export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, ProfileForm, ChangePasswordForm, DeleteAccountForm, AUTH_LABELS, AUTH_PATHS, type AuthLabels, type AuthPaths, type SignInProvider } from "./auth-forms.js";
 export { buildDocumentMetadata } from "./metadata.js";
 /** Lấy giá trị Customizer của theme đang active. */
 export declare function getThemeSettings(): Promise<import("./types.js").JsonObject>;
 export { PluginForm } from "./plugin-form.js";
 export type { PluginFormField } from "./plugin-form-client.js";
 export { defineBlock, type BlockDefinition, type BlockDefinitionInput, type BlockAttrSpec } from "@ecomcx/ecomweb-content";
+export { BINDABLE, CORE_BINDING_SOURCES, type BindingContext, type BindingSource } from "./bindings.js";

package/dist/index.js

@@ -5,12 +5,12 @@ export { definePlugin, getPlugin, hasPlugin, applyFilters, doAction, getSlotItem
 export { PostContent, EditableRegion } from "./content.js";
 export { Img, imageCandidates } from "./image.js";
 export { Menu, WidgetArea, Slot, SearchForm, Pagination, FeaturedImage, PostDate, TermLinks, Comments, LanguageSwitcher } from "./components.js";
-export { getT, BUILTIN as BUILTIN_STRINGS } from "./i18n.js";
+export { getT, getClientMessages, BUILTIN as BUILTIN_STRINGS } from "./i18n.js";
 export { getRequestLocale, localeHref, LOCALE_HEADER } from "./locale.js";
 export { CommentForm, CommentList, CommentsMore, ExtensionBoundary, PostPasswordForm, Link, isInternalHref } from "./client.js";
 export { getPreference } from "./preferences.js";
 export { getCurrentUser, getAccessToken, requireUser, userCan, safeRedirect, ACCESS_COOKIE, REFRESH_COOKIE } from "./auth.js";
-export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, AUTH_LABELS, AUTH_PATHS } from "./auth-forms.js";
+export { LoginForm, RegisterForm, ForgotPasswordForm, ResetPasswordForm, LogoutButton, useCurrentUser, ProfileForm, ChangePasswordForm, DeleteAccountForm, AUTH_LABELS, AUTH_PATHS } from "./auth-forms.js";
 export { buildDocumentMetadata } from "./metadata.js";
 /** Lấy giá trị Customizer của theme đang active. */
 export async function getThemeSettings() {
@@ -19,3 +19,4 @@ export async function getThemeSettings() {
 }
 export { PluginForm } from "./plugin-form.js";
 export { defineBlock } from "@ecomcx/ecomweb-content";
+export { BINDABLE, CORE_BINDING_SOURCES } from "./bindings.js";

package/dist/rich.d.ts

@@ -42,6 +42,8 @@ export interface RenderContext {
     styles?: Map<string, string>;
     /** Đang vẽ bên trong nhóm nút (`buttons`): nút không bọc thêm đoạn văn. */
     inButtons?: boolean;
+    /** Lấy giá trị của nguồn gắn dữ liệu (attrs.bindings). Không có → bỏ qua bindings (giữ nội dung gõ tay). */
+    binding?(source: string, args: Record<string, string | number | boolean>, ctx: RenderContext): Promise<unknown>;
     /** Tiêu đề của bài (khối mục lục) — renderContent ngoài cùng tính. */
     headings?: Array<{
         level: number;

package/dist/rich.js

@@ -149,7 +149,48 @@ function decorate(el, a, key, ctx) {
     }
     return _jsx("div", { className: extra || undefined, id: a.anchor, children: el }, key);
 }
+/** Thuộc tính gắn được của khối lõi (ngoài danh sách bị bỏ qua). */
+const BINDABLE = { paragraph: ["content"], heading: ["content"], image: ["src", "alt", "caption"], button: ["text", "href"] };
+const URL_ATTRS = new Set(["src", "href"]);
+/**
+ * Áp gắn dữ liệu: thay chữ / thuộc tính bằng giá trị của nguồn lúc hiển thị. Giá trị là chữ thường (không HTML), đường dẫn qua safeUrl;
+ * nguồn không có / trả về rỗng → giữ nội dung gõ tay. Lỗi của nguồn (plugin) chỉ bỏ qua thuộc tính đó.
+ */
+async function applyBindings(node, ctx) {
+    const bindings = node.attrs?.bindings;
+    const allowed = BINDABLE[node.type];
+    if (!bindings || !allowed || !ctx.binding)
+        return node;
+    let out = node;
+    for (const [attr, b] of Object.entries(bindings)) {
+        if (!allowed.includes(attr) || typeof b?.source !== "string")
+            continue;
+        let v;
+        try {
+            v = await ctx.binding(b.source, b.args ?? {}, ctx);
+        }
+        catch (e) {
+            console.warn(`[cms] binding ${b.source} lỗi:`, e.message);
+            continue;
+        }
+        if (v === null || v === undefined || v === "")
+            continue;
+        const text = String(v);
+        if (attr === "content")
+            out = { ...out, content: [{ type: "text", text }] };
+        else if (URL_ATTRS.has(attr)) {
+            const u = safeUrl(text, "");
+            if (u)
+                out = { ...out, attrs: { ...out.attrs, [attr]: u } };
+        }
+        else
+            out = { ...out, attrs: { ...out.attrs, [attr]: text } };
+    }
+    return out;
+}
 async function renderNode(node, key, ctx) {
+    if (node.attrs?.bindings)
+        node = await applyBindings(node, ctx);
     const el = await renderNodeInner(node, key, ctx);
     const a = node.attrs;
     const out = a && (a.style || a.blockStyle || a.className || a.anchor) ? decorate(el, a, key, ctx) : el;

package/dist/types.d.ts

@@ -497,6 +497,11 @@ export interface PluginDefinition {
     blocks?: Record<string, ComponentType<BlockProps>>;
     /** Định nghĩa khối (defineBlock, file dùng chung với phần admin) — website chuẩn hoá thuộc tính + nâng phiên bản trước khi vẽ. */
     blockTypes?: import("@ecomcx/ecomweb-content").BlockDefinition[];
+    /**
+     * Nguồn gắn dữ liệu (attrs.bindings của khối, @ecomcx/ecomweb-content 1.15): { "shop/product": async ({ id, field }, { post }) => … }.
+     * Khối lõi (đoạn văn, tiêu đề, ảnh, nút) hiện giá trị trả về; trả null/undefined → giữ nội dung gõ tay.
+     */
+    bindingSources?: Record<string, import("./bindings.js").BindingSource>;
     /** File ở gốc website: { "/news-sitemap.xml": handler }. Đường dẫn phải khai báo trong plugin.json → frontend.routes. */
     routes?: Record<string, PluginRoute>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecomcx/ecomweb-theme-sdk",
-  "version": "1.29.0",
+  "version": "1.31.0",
   "description": "SDK để viết theme và phần frontend của plugin cho Ecomweb",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,7 +33,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@ecomcx/ecomweb-content": "^1.14.0",
+    "@ecomcx/ecomweb-content": "^1.15.0",
     "intl-messageformat": "12.1.3"
   },
   "peerDependencies": {