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

package/dist/auth.js

@@ -0,0 +1,48 @@
+import { cache } from "react";
+import { ACCESS_COOKIE } from "./auth-shared.js";
+export { ACCESS_COOKIE, REFRESH_COOKIE, safeRedirect } from "./auth-shared.js";
+const API = (process.env.CMS_API_URL ?? "http://localhost:5100").replace(/\/$/, "");
+// Khoá frontend: request SSR của website không bị tính chung giới hạn đăng nhập theo IP của máy chủ website
+const KEY_HEADER = process.env.CMS_FRONTEND_KEY ? { "X-CMS-Frontend-Key": process.env.CMS_FRONTEND_KEY } : {};
+/** Access token của người đang xem (server). Trang gọi hàm này sẽ render theo từng người (không cache tĩnh). */
+export const getAccessToken = cache(async () => {
+    try {
+        const { cookies } = await import("next/headers");
+        return (await cookies()).get(ACCESS_COOKIE)?.value;
+    }
+    catch {
+        return undefined; // ngoài request (build)
+    }
+});
+/**
+ * Người đang đăng nhập trên website, null nếu là khách.
+ * Dùng trong Server Component, route, generateMetadata. Component client: dùng useCurrentUser() hoặc nhận qua props.
+ */
+export const getCurrentUser = cache(async () => {
+    const token = await getAccessToken();
+    if (!token)
+        return null;
+    try {
+        const res = await fetch(`${API}/api/auth/me`, { headers: { ...KEY_HEADER, Authorization: `Bearer ${token}` }, cache: "no-store" });
+        return res.ok ? (await res.json()) : null;
+    }
+    catch {
+        return null;
+    }
+});
+/** Người dùng có quyền này không — current_user_can(). */
+export function userCan(user, capability) {
+    return !!user?.capabilities.includes(capability);
+}
+/**
+ * Bắt buộc đăng nhập: khách bị chuyển tới /login, đăng nhập xong quay lại <paramref name="returnTo"/>.
+ *   const user = await requireUser("/account");
+ */
+export async function requireUser(returnTo = "/") {
+    const user = await getCurrentUser();
+    if (user)
+        return user;
+    const [{ redirect }, { getSite }, { localeHref }] = await Promise.all([import("next/navigation"), import("./api.js"), import("./locale.js")]);
+    // Trang đăng nhập cùng ngôn ngữ với trang đang xem (/en/login khi đang ở tiếng Anh)
+    return redirect(`${localeHref(await getSite(), "/login")}?redirect=${encodeURIComponent(returnTo)}`);
+}

package/dist/client.d.ts

@@ -0,0 +1,102 @@
+import { Component } from "react";
+import type { Comment } from "./types.js";
+import type { AnchorHTMLAttributes, ReactNode } from "react";
+export declare class ExtensionBoundary extends Component<{
+    name: string;
+    children?: ReactNode;
+}, {
+    failed: boolean;
+}> {
+    state: {
+        failed: boolean;
+    };
+    static getDerivedStateFromError(): {
+        failed: boolean;
+    };
+    componentDidCatch(error: unknown): void;
+    render(): import("react").JSX.Element | null;
+}
+export declare function isInternalHref(href: string): boolean;
+export type LinkProps = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & {
+    href: string;
+    children?: ReactNode;
+    /**
+     * Prefetch của Next.js. Mặc định false: mọi trang của CMS là trang động, mỗi lần prefetch là một lần render trên server
+     * (trang chủ báo có thể có cả trăm link). Bật cho vài link quan trọng nếu muốn chuyển trang tức thì.
+     */
+    prefetch?: boolean | null;
+    /** Đặt aria-current và class này khi URL hiện tại khớp href (dùng cho menu). */
+    activeClassName?: string;
+    /** Khớp cả trang con (vd /category/a/page/2 vẫn active cho /category/a). Mặc định true, trừ trang chủ. */
+    matchNested?: boolean;
+};
+export declare function Link({ href, prefetch, activeClassName, matchNested, className, children, ...rest }: LinkProps): import("react").JSX.Element;
+/** Form tìm kiếm (GET) chuyển trang phía client. */
+export declare function SearchFormClient({ action, defaultValue, placeholder, label, buttonLabel }: {
+    action: string;
+    defaultValue?: string | null;
+    placeholder: string;
+    label: string;
+    buttonLabel: string;
+}): import("react").JSX.Element;
+/** Ghi tuỳ chọn hiển thị của người đọc (xem getPreference). value = null để xoá. */
+export declare function setPreference(key: string, value: string | null, maxAgeDays?: number): void;
+/** Client phía trình duyệt: gọi các route proxy /api/cms/* của frontend. */
+declare const browserApi: import("next-fetch-kit").FetchKitInstance;
+/** Form gửi bình luận. Gửi qua route /api/cms/comments của frontend (proxy sang CMS API). */
+export { browserApi };
+type CommentLabels = Record<"title" | "content" | "name" | "email" | "website" | "submit" | "sending" | "approved" | "pending" | "error", string>;
+/** fields: ô thêm của plugin (captcha…) — Comments của SDK truyền <Slot name="comment_form.fields" />. Ô name="extra.*" gửi kèm trong "extra". */
+export declare function CommentForm({ postId, parentId, labels, fields }: {
+    postId: number;
+    parentId?: number;
+    labels?: Partial<CommentLabels>;
+    fields?: ReactNode;
+}): import("react").JSX.Element;
+type DateSite = {
+    dateFormat: string;
+    timezone: string;
+    locale?: string;
+};
+/** Danh sách bình luận lồng nhau (render được cả ở server lẫn client). */
+export declare function CommentList({ comments, site }: {
+    comments: Comment[];
+    site: DateSite;
+}): import("react").JSX.Element;
+/** Nút "Xem thêm bình luận": tải các trang tiếp theo qua /api/cms/comments. */
+export declare function CommentsMore({ postId, totalPages, site, labels }: {
+    postId: number;
+    totalPages: number;
+    site: DateSite;
+    labels: {
+        more: string;
+        loading: string;
+        error: string;
+    };
+}): import("react").JSX.Element;
+/** Form mật khẩu của bài được bảo vệ. Đúng mật khẩu → cookie httpOnly, tải lại nội dung trang. */
+export declare function PostPasswordForm({ postId, labels }: {
+    postId: number;
+    labels: {
+        intro: string;
+        label: string;
+        submit: string;
+        wrong: string;
+    };
+}): import("react").JSX.Element;
+type Lang = {
+    code: string;
+    name: string;
+    flag?: string;
+};
+/** Phần client của LanguageSwitcher: lấy link bản dịch từ <link rel="alternate" hreflang> do metadata của trang sinh ra. */
+export declare function LanguageSwitcherClient({ languages, current, defaultLocale, label, className, variant }: {
+    languages: Lang[];
+    current: string;
+    defaultLocale: string;
+    label: string;
+    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 { safeRedirect, type CurrentUser } from "./auth-shared.js";

package/dist/client.js

@@ -0,0 +1,191 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { extraFields } from "./auth-forms.js";
+import { Component, Suspense, useEffect, useState } from "react";
+import { usePathname, useRouter } from "next/navigation";
+import NextLink, { useLinkStatus } from "next/link";
+import NextForm from "next/form";
+import { cx, formatDate } from "./utils.js";
+import { createFetchKit, isFetchKitError } from "next-fetch-kit";
+// ---------------------------------------------------------------------------
+// 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
+// ---------------------------------------------------------------------------
+export class ExtensionBoundary extends Component {
+    state = { failed: false };
+    static getDerivedStateFromError() { return { failed: true }; }
+    componentDidCatch(error) { console.error(`[cms] ${this.props.name} lỗi khi hiển thị — đã ẩn phần này`, error); }
+    // Suspense bên trong: khi render trên server, React không dùng error boundary mà đẩy lỗi lên Suspense gần nhất —
+    // không có thì lỗi của một shortcode/slot làm cả trang trả 500 (tuỳ thời điểm khung trang đã gửi hay chưa).
+    // Có Suspense: phần lỗi được render lại phía trình duyệt, nơi boundary này bắt và ẩn; trang vẫn 200.
+    render() { return this.state.failed ? null : _jsx(Suspense, { fallback: null, children: this.props.children }); }
+}
+// ---------------------------------------------------------------------------
+// Link: điều hướng phía client (SPA) cho link nội bộ, <a> thường cho link ngoài/file
+// ---------------------------------------------------------------------------
+/** Đường dẫn không phải trang của theme (file, feed, API…) → luôn tải lại bình thường. */
+const NON_PAGE = /^\/(uploads|api|_next|extensions)\/|^\/(feed|sitemap\.xml|robots\.txt)(\?|$)|\.[a-z0-9]{2,5}(\?|$)/i;
+export function isInternalHref(href) {
+    return href.startsWith("/") && !href.startsWith("//") && !NON_PAGE.test(href);
+}
+/**
+ * Link của theme/plugin: link nội bộ dùng next/link (không tải lại trang, giữ header/menu, prefetch),
+ * link ngoài, file, RSS, target=_blank và nút đổi ngôn ngữ dùng <a> thường. HTML luôn là <a href> (tốt cho SEO).
+ */
+/** Báo trạng thái đang chuyển trang lên <html data-nav-pending> để core hiện thanh tiến trình. */
+function PendingSignal() {
+    const { pending } = useLinkStatus();
+    useEffect(() => {
+        if (!pending)
+            return;
+        document.documentElement.dataset.navPending = "";
+        return () => { delete document.documentElement.dataset.navPending; };
+    }, [pending]);
+    return null;
+}
+export function Link({ href, prefetch = false, activeClassName, matchNested = true, className, children, ...rest }) {
+    const pathname = usePathname();
+    const path = href.split(/[?#]/)[0];
+    const active = activeClassName !== undefined && (pathname === path || (matchNested && path !== "/" && pathname.startsWith(path.endsWith("/") ? path : path + "/")));
+    const cls = cx(className, active && activeClassName);
+    const ariaCurrent = active ? "page" : rest["aria-current"];
+    if (!isInternalHref(href) || rest.target === "_blank" || rest.download !== undefined)
+        return _jsx("a", { href: href, className: cls || undefined, ...rest, "aria-current": ariaCurrent, children: children });
+    return (_jsxs(NextLink, { href: href, prefetch: prefetch, className: cls || undefined, ...rest, "aria-current": ariaCurrent, onClick: (e) => {
+            rest.onClick?.(e);
+            // Trang không tải lại → tự đóng menu dạng <details> (menu mobile) chứa link vừa bấm
+            e.currentTarget.closest("details[open]")?.removeAttribute("open");
+        }, children: [children, _jsx(PendingSignal, {})] }));
+}
+/** Form tìm kiếm (GET) chuyển trang phía client. */
+export function SearchFormClient({ action, defaultValue, placeholder, label, buttonLabel }) {
+    return (_jsxs(NextForm, { action: action, role: "search", className: "search-form", children: [_jsx("input", { type: "search", name: "s", defaultValue: defaultValue ?? "", placeholder: placeholder, "aria-label": label, required: true }), _jsx("button", { type: "submit", children: buttonLabel })] }));
+}
+/** Ghi tuỳ chọn hiển thị của người đọc (xem getPreference). value = null để xoá. */
+export function setPreference(key, value, maxAgeDays = 365) {
+    if (!/^[a-z0-9-]{1,32}$/.test(key) || (value !== null && !/^[A-Za-z0-9_-]{0,64}$/.test(value)))
+        throw new Error("Tuỳ chọn không hợp lệ");
+    document.cookie = `cms-pref-${key}=${value ?? ""}; path=/; max-age=${value === null ? 0 : maxAgeDays * 86400}; samesite=lax`;
+}
+/** Client phía trình duyệt: gọi các route proxy /api/cms/* của frontend. */
+const browserApi = createFetchKit({ baseURL: "/api/cms", timeout: 15_000 });
+function errorMessage(e, fallback) {
+    if (isFetchKitError(e)) {
+        const d = e.data;
+        if (d?.errors)
+            return Object.values(d.errors).flat().join(". ");
+        return d?.title ?? fallback;
+    }
+    return e?.message ?? fallback;
+}
+/** Form gửi bình luận. Gửi qua route /api/cms/comments của frontend (proxy sang CMS API). */
+export { browserApi };
+const DEFAULT_LABELS = {
+    title: "Để lại bình luận", content: "Bình luận", name: "Tên", email: "Email", website: "Website", submit: "Gửi bình luận",
+    sending: "Đang gửi…", approved: "Cảm ơn bạn! Bình luận đã được đăng (tải lại trang để xem).", pending: "Cảm ơn bạn! Bình luận đang chờ duyệt.",
+    error: "Không gửi được bình luận",
+};
+/** fields: ô thêm của plugin (captcha…) — Comments của SDK truyền <Slot name="comment_form.fields" />. Ô name="extra.*" gửi kèm trong "extra". */
+export function CommentForm({ postId, parentId, labels, fields }) {
+    const L = { ...DEFAULT_LABELS, ...labels };
+    const [state, setState] = useState("idle");
+    const [message, setMessage] = useState("");
+    async function onSubmit(e) {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const fd = new FormData(form);
+        setState("sending");
+        try {
+            const { data } = await browserApi.post("/comments", {
+                body: {
+                    postId, parentId,
+                    authorName: fd.get("authorName"), authorEmail: fd.get("authorEmail"),
+                    authorUrl: fd.get("authorUrl"), content: fd.get("content"), website2: fd.get("website2"), extra: extraFields(fd),
+                },
+            });
+            form.reset();
+            setState("done");
+            setMessage(data.status === "approved" ? L.approved : L.pending);
+        }
+        catch (err) {
+            setState("error");
+            setMessage(errorMessage(err, L.error));
+        }
+    }
+    return (_jsxs("form", { className: "comment-form", onSubmit: onSubmit, children: [_jsx("h3", { children: L.title }), _jsx("p", { children: _jsxs("label", { children: [L.content, " *", _jsx("textarea", { name: "content", required: true, rows: 5, maxLength: 5000 })] }) }), _jsxs("p", { className: "comment-form-row", children: [_jsxs("label", { children: [L.name, " *", _jsx("input", { name: "authorName", required: true, maxLength: 100 })] }), _jsxs("label", { children: [L.email, " *", _jsx("input", { name: "authorEmail", type: "email", required: true, maxLength: 200 })] })] }), _jsx("p", { children: _jsxs("label", { children: [L.website, _jsx("input", { name: "authorUrl", type: "url", maxLength: 200 })] }) }), _jsx("input", { name: "website2", tabIndex: -1, autoComplete: "off", style: { position: "absolute", left: "-9999px" }, "aria-hidden": true }), fields, _jsx("p", { children: _jsx("button", { type: "submit", disabled: state === "sending", children: state === "sending" ? L.sending : L.submit }) }), message && _jsx("p", { className: state === "error" ? "form-error" : "form-success", role: "status", children: message })] }));
+}
+/** Danh sách bình luận lồng nhau (render được cả ở server lẫn client). */
+export function CommentList({ comments, site }) {
+    return (_jsx("ol", { className: "comment-list", children: comments.map((c) => (_jsxs("li", { id: `comment-${c.id}`, className: "comment", children: [_jsxs("article", { children: [_jsxs("header", { className: "comment-meta", children: [c.avatarUrl && _jsx("img", { className: "comment-avatar avatar", src: c.avatarUrl, alt: "", width: 40, height: 40, loading: "lazy", decoding: "async" }), _jsx("b", { className: "comment-author", children: c.authorUrl ? _jsx("a", { href: c.authorUrl, rel: "nofollow ugc", children: c.authorName }) : c.authorName }), " · ", _jsx("time", { dateTime: c.createdAt, children: formatDate(c.createdAt, site) })] }), _jsx("div", { className: "comment-content", children: c.content.split("\n").map((l, i) => _jsx("p", { children: l }, i)) })] }), c.replies.length > 0 && _jsx(CommentList, { comments: c.replies, site: site })] }, c.id))) }));
+}
+/** Nút "Xem thêm bình luận": tải các trang tiếp theo qua /api/cms/comments. */
+export function CommentsMore({ postId, totalPages, site, labels }) {
+    const [pages, setPages] = useState([]);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState("");
+    const next = pages.length + 2;
+    async function load() {
+        setLoading(true);
+        setError("");
+        try {
+            const { data } = await browserApi.get("/comments", { query: { postId, page: next } });
+            setPages((p) => [...p, data.items]);
+        }
+        catch (e) {
+            setError(errorMessage(e, labels.error));
+        }
+        finally {
+            setLoading(false);
+        }
+    }
+    return (_jsxs(_Fragment, { children: [pages.map((items, i) => _jsx(CommentList, { comments: items, site: site }, i)), next <= totalPages && _jsx("p", { className: "comments-more", children: _jsx("button", { type: "button", onClick: load, disabled: loading, children: loading ? labels.loading : labels.more }) }), error && _jsx("p", { className: "form-error", role: "alert", children: error })] }));
+}
+/** Form mật khẩu của bài được bảo vệ. Đúng mật khẩu → cookie httpOnly, tải lại nội dung trang. */
+export function PostPasswordForm({ postId, labels }) {
+    const router = useRouter();
+    const [error, setError] = useState("");
+    const [busy, setBusy] = useState(false);
+    async function onSubmit(e) {
+        e.preventDefault();
+        setBusy(true);
+        setError("");
+        try {
+            await browserApi.post("/unlock", { body: { postId, password: new FormData(e.currentTarget).get("password") } });
+            router.refresh();
+        }
+        catch (err) {
+            setError(errorMessage(err, labels.wrong));
+            setBusy(false);
+        }
+    }
+    return (_jsxs("form", { className: "post-password-form", onSubmit: onSubmit, children: [_jsx("p", { children: labels.intro }), _jsxs("p", { children: [_jsxs("label", { children: [labels.label, " ", _jsx("input", { name: "password", type: "password", required: true, autoComplete: "off", maxLength: 100 })] }), " ", _jsx("button", { type: "submit", disabled: busy, children: labels.submit })] }), error && _jsx("p", { className: "form-error", role: "alert", children: error })] }));
+}
+/** Phần client của LanguageSwitcher: lấy link bản dịch từ <link rel="alternate" hreflang> do metadata của trang sinh ra. */
+export function LanguageSwitcherClient({ languages, current, defaultLocale, label, className, variant }) {
+    const pathname = usePathname();
+    const home = (code) => (code === defaultLocale ? "/" : `/${code}`);
+    const [links, setLinks] = useState({});
+    useEffect(() => {
+        const read = () => {
+            const map = {};
+            document.querySelectorAll('link[rel="alternate"][hreflang]').forEach((l) => {
+                const lang = l.getAttribute("hreflang");
+                if (lang && lang !== "x-default") {
+                    try {
+                        map[lang] = new URL(l.href).pathname;
+                    }
+                    catch { /* bỏ qua */ }
+                }
+            });
+            setLinks(map);
+        };
+        read();
+        const t = setTimeout(read, 150); // metadata có thể được chèn sau khi chuyển trang
+        return () => clearTimeout(t);
+    }, [pathname]);
+    const href = (code) => links[code] ?? home(code);
+    if (variant === "select")
+        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 { safeRedirect } from "./auth-shared.js";

package/dist/components.d.ts

@@ -0,0 +1,68 @@
+import type { ReactNode } from "react";
+import type { Media, Post, ResolveResult, SlotName } from "./types.js";
+export declare function Menu({ location, menuId, currentPath, className, fallback }: {
+    location?: string;
+    menuId?: number;
+    currentPath?: string;
+    className?: string;
+    fallback?: ReactNode;
+}): Promise<import("react").JSX.Element>;
+export declare function WidgetArea({ id, className }: {
+    id: string;
+    className?: string;
+}): Promise<import("react").JSX.Element | null>;
+export declare function Slot<P = any>({ name, data, props, fallback, className, }: {
+    name: SlotName;
+    data?: ResolveResult | null;
+    props?: P;
+    fallback?: ReactNode;
+    className?: string;
+}): Promise<import("react").JSX.Element>;
+/** Ô tìm kiếm — gửi về trang chủ của ngôn ngữ hiện tại (/?s= hoặc /en?s=). */
+export declare function SearchForm({ defaultValue, placeholder, buttonLabel }: {
+    defaultValue?: string | null;
+    placeholder?: string;
+    buttonLabel?: string;
+}): Promise<import("react").JSX.Element>;
+export declare function Pagination({ data, prevLabel, nextLabel }: {
+    data: ResolveResult;
+    prevLabel?: string;
+    nextLabel?: string;
+}): Promise<import("react").JSX.Element | null>;
+/** Ảnh đại diện: responsive, WebP, srcset. */
+export declare function FeaturedImage({ media, size, className, link, sizes, priority }: {
+    media?: Media | null;
+    size?: string;
+    className?: string;
+    link?: string;
+    sizes?: string;
+    priority?: boolean;
+}): import("react").JSX.Element | null;
+export declare function PostDate({ post, site }: {
+    post: Post;
+    site?: {
+        dateFormat: string;
+        timezone: string;
+        locale?: string;
+    };
+}): import("react").JSX.Element;
+export declare function TermLinks({ terms, separator }: {
+    terms?: Array<{
+        id: number;
+        name: string;
+        link: string;
+    }>;
+    separator?: string;
+}): import("react").JSX.Element | null;
+export declare function Comments({ post, title }: {
+    post: Post;
+    title?: string;
+}): Promise<import("react").JSX.Element | null>;
+/**
+ * Nút chuyển ngôn ngữ. Đặt ở layout của theme. Ẩn khi site chỉ có một ngôn ngữ.
+ * Liên kết tới đúng bản dịch của trang hiện tại (đọc thẻ hreflang), không có thì về trang chủ ngôn ngữ đó.
+ */
+export declare function LanguageSwitcher({ className, variant }: {
+    className?: string;
+    variant?: "list" | "select";
+}): Promise<import("react").JSX.Element | null>;

package/dist/components.js

@@ -0,0 +1,154 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { getArchives, getComments, getMenu, getMenuById, getPosts, getSite, getTerms, getWidgets } from "./api.js";
+import { findWidget, getSlotItems } from "./runtime.js";
+import { cx, formatDate, pageLink } from "./utils.js";
+import { Img } from "./image.js";
+import { CommentForm, CommentList, CommentsMore, ExtensionBoundary, LanguageSwitcherClient, Link, SearchFormClient } from "./client.js";
+import { getT } from "./i18n.js";
+import { localeHref } from "./locale.js";
+// ---------------------------------------------------------------------------
+// Menu theo vị trí
+// ---------------------------------------------------------------------------
+function MenuItems({ items, currentPath, depth }) {
+    return (_jsx("ul", { className: depth === 0 ? "menu" : "sub-menu", children: items.map((item) => {
+            const active = currentPath !== undefined && (item.url === currentPath || (item.url !== "/" && currentPath.startsWith(item.url + "/")));
+            return (_jsxs("li", { className: cx("menu-item", item.cssClass, active && "current-menu-item", item.children.length > 0 && "has-children"), children: [_jsx(Link, { href: item.url, target: item.target ?? undefined, rel: item.target === "_blank" ? "noopener noreferrer" : undefined, "aria-current": active ? "page" : undefined, activeClassName: "current-menu-link", matchNested: item.url !== "/", children: item.title }), item.children.length > 0 && _jsx(MenuItems, { items: item.children, currentPath: currentPath, depth: depth + 1 })] }, item.id));
+        }) }));
+}
+export async function Menu({ location, menuId, currentPath, className, fallback }) {
+    const menu = menuId ? await getMenuById(menuId) : location ? await getMenu(location) : null;
+    if (!menu || menu.items.length === 0)
+        return _jsx(_Fragment, { children: fallback ?? null });
+    return _jsx("nav", { className: className, "aria-label": menu.name, children: _jsx(MenuItems, { items: menu.items, currentPath: currentPath, depth: 0 }) });
+}
+// ---------------------------------------------------------------------------
+// Khu vực widget
+// ---------------------------------------------------------------------------
+async function CoreWidget({ widget }) {
+    const s = widget.settings ?? {};
+    switch (widget.type) {
+        case "text": return _jsx("div", { className: "textwidget", children: String(s.text ?? "").split("\n").map((l, i) => _jsx("p", { children: l }, i)) });
+        case "html": return _jsx("div", { className: "textwidget", dangerouslySetInnerHTML: { __html: String(s.html ?? "") } });
+        case "search": return _jsx(SearchForm, {});
+        case "recent-posts": {
+            const { items } = await getPosts({ perPage: Number(s.number) || 5 });
+            return _jsx("ul", { children: items.map((p) => _jsx("li", { children: _jsx(Link, { href: p.link, children: p.title }) }, p.id)) });
+        }
+        case "categories": {
+            const terms = await getTerms("category", true);
+            // Phân cấp: chuyên mục con lồng trong chuyên mục cha
+            const ids = new Set(terms.map((t) => t.id));
+            const tree = (parent) => {
+                const level = terms.filter((t) => (t.parentId && ids.has(t.parentId) ? t.parentId : null) === parent);
+                return level.length ? _jsx("ul", { className: parent ? "children" : undefined, children: level.map((t) => _jsxs("li", { className: "cat-item", children: [_jsx(Link, { href: t.link, children: t.name }), s.showCount ? ` (${t.count})` : "", tree(t.id)] }, t.id)) }) : null;
+            };
+            return tree(null);
+        }
+        case "tag-cloud": {
+            const terms = await getTerms("post_tag", true);
+            const max = Math.max(1, ...terms.map((t) => t.count));
+            return _jsx("div", { className: "tagcloud", children: terms.map((t) => _jsx(Link, { href: t.link, style: { fontSize: `${0.8 + (t.count / max) * 0.8}em` }, children: t.name }, t.id)) });
+        }
+        case "archives": {
+            const [rows, t] = await Promise.all([getArchives(), getT()]);
+            return _jsx("ul", { children: rows.map((r) => _jsxs("li", { children: [_jsx(Link, { href: r.link, children: t("archives.month", { month: r.month, year: r.year }) }), " (", r.count, ")"] }, r.link)) });
+        }
+        case "menu": return s.menuId ? _jsx(Menu, { menuId: Number(s.menuId) }) : null;
+        default: return null;
+    }
+}
+export async function WidgetArea({ id, className }) {
+    const [site, widgets] = await Promise.all([getSite(), getWidgets(id)]);
+    if (widgets.length === 0)
+        return null;
+    const rendered = await Promise.all(widgets.map(async (w) => {
+        const Plugin = await findWidget(w.type, site);
+        const body = Plugin ? _jsx(ExtensionBoundary, { name: `Widget ${w.type}`, children: _jsx(Plugin, { widget: w, settings: w.settings ?? {}, site: site }) }) : await CoreWidget({ widget: w });
+        if (!body)
+            return null;
+        return (_jsxs("section", { className: cx("widget", `widget-${w.type}`), children: [w.title && _jsx("h2", { className: "widget-title", children: w.title }), body] }, w.id));
+    }));
+    return _jsx("aside", { className: cx("widget-area", className), "data-area": id, children: rendered });
+}
+// ---------------------------------------------------------------------------
+// Slot cho plugin (head, cuối trang, trước/sau nội dung…)
+// ---------------------------------------------------------------------------
+export async function Slot({ name, data, props, fallback, className, }) {
+    const site = await getSite();
+    const items = await getSlotItems(name, site);
+    if (items.length === 0)
+        return _jsx(_Fragment, { children: fallback ?? null });
+    const elements = items.map(({ Component, priority }, i) => (_jsx(ExtensionBoundary, { name: `Slot ${name}`, children: _jsx(Component, { site: site, data: data, ...props }) }, `${i}-${priority}`)));
+    return className ? _jsx("div", { className: className, children: elements }) : _jsx(_Fragment, { children: elements });
+}
+// ---------------------------------------------------------------------------
+// Tiện ích hiển thị
+// ---------------------------------------------------------------------------
+/** Ô tìm kiếm — gửi về trang chủ của ngôn ngữ hiện tại (/?s= hoặc /en?s=). */
+export async function SearchForm({ defaultValue, placeholder, buttonLabel }) {
+    const [t, site] = await Promise.all([getT(), getSite()]);
+    return _jsx(SearchFormClient, { action: localeHref(site, "/"), defaultValue: defaultValue, placeholder: placeholder ?? t("search.placeholder"), label: t("search.label"), buttonLabel: buttonLabel ?? t("search.button") });
+}
+export async function Pagination({ data, prevLabel, nextLabel }) {
+    if (data.totalPages <= 1)
+        return null;
+    const t = await getT();
+    prevLabel ??= t("pagination.prev");
+    nextLabel ??= t("pagination.next");
+    const pages = [];
+    for (let i = 1; i <= data.totalPages; i++) {
+        if (i === 1 || i === data.totalPages || Math.abs(i - data.page) <= 2)
+            pages.push(i);
+        else if (pages[pages.length - 1] !== "…")
+            pages.push("…");
+    }
+    const link = (p) => pageLink(data.basePath, p, data.kind === "search" ? data.search : null);
+    return (_jsxs("nav", { className: "pagination", "aria-label": t("pagination.label"), children: [data.page > 1 && _jsx(Link, { className: "prev", href: link(data.page - 1), children: prevLabel }), pages.map((p, i) => p === "…" ? _jsx("span", { className: "dots", children: "\u2026" }, `e${i}`)
+                : p === data.page ? _jsx("span", { className: "current", "aria-current": "page", children: p }, p)
+                    : _jsx(Link, { href: link(p), children: p }, p)), data.page < data.totalPages && _jsx(Link, { className: "next", href: link(data.page + 1), children: nextLabel })] }));
+}
+/** Ảnh đại diện: responsive, WebP, srcset. */
+export function FeaturedImage({ media, size = "large", className, link, sizes, priority }) {
+    if (!media)
+        return null;
+    const img = _jsx(Img, { media: media, size: size, sizes: sizes, priority: priority });
+    return _jsx("figure", { className: cx("featured-image", className), children: link ? _jsx(Link, { href: link, children: img }) : img });
+}
+export function PostDate({ post, site }) {
+    return _jsx("time", { dateTime: post.publishedAt ?? post.createdAt, children: formatDate(post.publishedAt ?? post.createdAt, site) });
+}
+export function TermLinks({ terms, separator = ", " }) {
+    if (!terms?.length)
+        return null;
+    return _jsx(_Fragment, { children: terms.map((t, i) => _jsxs("span", { children: [i > 0 && separator, _jsx(Link, { href: t.link, rel: "tag", children: t.name })] }, t.id)) });
+}
+// ---------------------------------------------------------------------------
+// Khu bình luận
+// ---------------------------------------------------------------------------
+export async function Comments({ post, title }) {
+    if (post.commentStatus !== "open" && post.commentCount === 0)
+        return null;
+    if (post.passwordProtected && !post.content)
+        return null; // bài có mật khẩu: ẩn bình luận tới khi mở khoá
+    const [site, page, t] = await Promise.all([getSite(), getComments(post.id), getT()]);
+    const comments = page?.items ?? [];
+    const dateSite = { dateFormat: site.dateFormat, timezone: site.timezone, locale: site.locale };
+    title ??= t("comments.title");
+    const labels = Object.fromEntries(["title", "content", "name", "email", "website", "submit", "sending", "approved", "pending", "error"].map((k) => [k, t(`comments.form.${k}`)]));
+    return (_jsxs("section", { id: "comments", className: "comments-area", children: [_jsx(Slot, { name: "comments.before", props: { post } }), _jsxs("h2", { className: "comments-title", children: [title, " (", post.commentCount, ")"] }), comments.length > 0 && _jsx(CommentList, { comments: comments, site: dateSite }), (page?.totalPages ?? 1) > 1 && _jsx(CommentsMore, { postId: post.id, totalPages: page.totalPages, site: dateSite, labels: { more: t("comments.more"), loading: t("comments.loading"), error: t("comments.form.error") } }), post.commentStatus === "open"
+                ? _jsx(CommentForm, { postId: post.id, labels: labels, fields: _jsx(Slot, { name: "comment_form.fields", props: { post } }) })
+                : _jsx("p", { className: "no-comments", children: t("comments.closed") }), _jsx(Slot, { name: "comments.after", props: { post } })] }));
+}
+// ---------------------------------------------------------------------------
+// Chuyển ngôn ngữ
+// ---------------------------------------------------------------------------
+/**
+ * Nút chuyển ngôn ngữ. Đặt ở layout của theme. Ẩn khi site chỉ có một ngôn ngữ.
+ * Liên kết tới đúng bản dịch của trang hiện tại (đọc thẻ hreflang), không có thì về trang chủ ngôn ngữ đó.
+ */
+export async function LanguageSwitcher({ className, variant = "list" }) {
+    const [site, t] = await Promise.all([getSite(), getT()]);
+    if (site.languages.length < 2)
+        return null;
+    return _jsx(LanguageSwitcherClient, { className: className, variant: variant, current: site.locale, defaultLocale: site.defaultLocale, label: t("language.label"), languages: site.languages.map((l) => ({ code: l.code, name: l.name, flag: l.flag ?? undefined })) });
+}

package/dist/content.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from "react";
+import type { Post, PostContentDoc, ResolveResult, Site } from "./types.js";
+import { type RenderContext } from "./rich.js";
+/**
+ * Render nội dung bài viết (định dạng của CMS — @ecomcx/nexus-content; phần vẽ ở rich.tsx, không phụ thuộc trình soạn).
+ * Luôn có class `ecx-content` (giao diện nền trong @ecomcx/nexus-content/style.css, theme ghi đè được); `className` thay cho `entry-content`.
+ */
+export declare function PostContent({ post, content, className }: {
+    post?: Post | null;
+    content?: PostContentDoc | null;
+    className?: string;
+}): Promise<import("react").JSX.Element | null>;
+/**
+ * Vùng của theme: header, footer (vùng chuẩn của core — nên luôn bọc) và vùng hybrid khai báo ở theme.json › regions.
+ * Thứ tự: plugin thay vùng (definePlugin → regions) → bản sửa trong Trình dựng / `parts/{name}.json` → `children` (bản code của theme).
+ * `<EditableRegion name="header" data={data}><Header /></EditableRegion>`
+ */
+export declare function EditableRegion({ name, data, className, children }: {
+    name: string;
+    data?: ResolveResult;
+    className?: string;
+    children?: ReactNode;
+}): Promise<import("react").JSX.Element>;
+/** Ngữ cảnh vẽ nội dung dùng chung cho bài viết và template khối. */
+export declare function contentContext(site: Site, post?: Post | null, data?: ResolveResult): Promise<RenderContext>;