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

package/dist/content.js

@@ -0,0 +1,59 @@
+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 { getT } from "./i18n.js";
+import { renderDynamic } from "./dynamic.js";
+import { renderContent } from "./rich.js";
+import { cx } from "./utils.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 async function PostContent({ post, content, className }) {
+    const site = await getSite();
+    const doc = content ?? post?.content;
+    if (!content && post?.passwordProtected && !post.content) {
+        const t = await getT();
+        return _jsx("div", { className: cx(className ?? "entry-content", "ecx-content"), children: _jsx(PostPasswordForm, { postId: post.id, labels: { intro: t("password.intro"), label: t("password.label"), submit: t("password.submit"), wrong: t("password.wrong") } }) });
+    }
+    if (!doc?.blocks?.length)
+        return null;
+    const rendered = await renderContent(doc, await contentContext(site, post), (blocks) => applyFilters("post.blocks", blocks, { site, post }, site));
+    return _jsx("div", { className: cx(className ?? "entry-content", "ecx-content"), children: rendered });
+}
+/**
+ * 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 async function EditableRegion({ name, data, className, children }) {
+    const doc = (await getTemplates().catch(() => null))?.parts[name];
+    const site = await getSite();
+    const own = doc?.blocks?.length
+        ? _jsx("div", { className: cx(`ecx-region ecx-region-${name}`, "ecx-content", className), children: await renderContent(doc, await contentContext(site, data?.post, data)) })
+        : _jsx(_Fragment, { children: children });
+    return _jsx(_Fragment, { children: await regionOverride(name, own, site, data) });
+}
+/** Plugin thay vùng: component nhận bản sẽ vẽ (`children`), lỗi chỉ ẩn vùng đó. */
+async function regionOverride(name, fallback, site, data) {
+    const Region = await findRegion(name, site);
+    if (!Region)
+        return fallback;
+    return _jsx(ExtensionBoundary, { name: `Region ${name}`, children: _jsx(Region, { name: name, site: site, data: data ?? null, children: fallback }) });
+}
+/** Ngữ cảnh vẽ nội dung dùng chung cho bài viết và template khối. */
+export async function contentContext(site, post, data) {
+    const t = await getT();
+    const blocks = (await getActiveExtensions(site)).flatMap((d) => d.blockTypes ?? []);
+    return {
+        site, post, data, blocks,
+        resolve: { shortcode: (name) => findShortcode(name, site), block: (type) => findBlock(type, site) },
+        labels: { download: t("file.download"), toc: t("toc.title") },
+        boundary: (name, key, el) => _jsx(ExtensionBoundary, { name: name, children: el }, key),
+        dynamic: renderDynamic,
+        parts: async (slug) => (await getTemplates().catch(() => null))?.parts[slug] ?? null,
+        region: (name, fallback) => regionOverride(name, fallback, site, data),
+        pattern: (ref) => getPattern(ref),
+    };
+}

package/dist/dynamic.d.ts

@@ -0,0 +1,9 @@
+import { type ReactNode } from "react";
+import { type RenderContext, type RenderNode } from "./rich.js";
+type Children = (ctx: RenderContext, nodes?: RenderNode[]) => Promise<ReactNode[]>;
+/**
+ * Khối động (@ecomcx/nexus-content DYNAMIC_NODES): vẽ theo ngữ cảnh — website, trang đang xem (`ctx.data`), bài trong vòng lặp (`ctx.post`).
+ * Ngoài template (nội dung bài) không có `ctx.data`: `postContent` không vẽ (tránh lặp vô hạn), `query` luôn tự lấy bài.
+ */
+export declare function renderDynamic(node: RenderNode, key: string, ctx: RenderContext, children: Children): Promise<ReactNode>;
+export {};

package/dist/dynamic.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Fragment } from "react";
+import { getPosts } from "./api.js";
+import { Link } from "./client.js";
+import { Comments, FeaturedImage, LanguageSwitcher, Menu, Pagination, PostDate, SearchForm, TermLinks } from "./components.js";
+import { getT } from "./i18n.js";
+import { localeHref } from "./locale.js";
+import { renderContent } from "./rich.js";
+import { cx } from "./utils.js";
+const align = (a) => (a.textAlign && a.textAlign !== "left" ? { textAlign: a.textAlign } : undefined);
+const ASPECT = { "16/9": "16 / 9", "4/3": "4 / 3", "1/1": "1 / 1", "3/4": "3 / 4" };
+/**
+ * Khối động (@ecomcx/nexus-content DYNAMIC_NODES): vẽ theo ngữ cảnh — website, trang đang xem (`ctx.data`), bài trong vòng lặp (`ctx.post`).
+ * Ngoài template (nội dung bài) không có `ctx.data`: `postContent` không vẽ (tránh lặp vô hạn), `query` luôn tự lấy bài.
+ */
+export async function renderDynamic(node, key, ctx, children) {
+    const a = node.attrs ?? {};
+    const site = ctx.site;
+    const post = ctx.post ?? ctx.data?.post;
+    switch (node.type) {
+        case "siteTitle": {
+            const Tag = (a.level > 0 ? `h${Math.min(6, a.level)}` : "p");
+            const title = a.link === false ? site.title : _jsx(Link, { href: localeHref(site, "/"), rel: "home", children: site.title });
+            return _jsx(Tag, { className: "ecx-site-title", style: align(a), children: title }, key);
+        }
+        case "siteLogo": {
+            const logo = site.themeSettings?.logo;
+            if (!logo?.url)
+                return null;
+            const img = _jsx("img", { src: logo.url, alt: site.title, width: a.width ?? 120, style: { height: "auto" } });
+            return _jsx("div", { className: "ecx-site-logo", children: a.link === false ? img : _jsx(Link, { href: localeHref(site, "/"), rel: "home", children: img }) }, key);
+        }
+        case "siteTagline":
+            return site.tagline ? _jsx("p", { className: "ecx-site-tagline", style: align(a), children: site.tagline }, key) : null;
+        case "navigation": {
+            const location = String(a.location ?? "primary");
+            const menu = _jsx(Menu, { location: location, className: "ecx-navigation-menu" });
+            const t = await getT();
+            return (_jsxs("div", { className: cx("ecx-navigation", `ecx-navigation-${a.orientation ?? "horizontal"}`, a.mobile !== false && "has-mobile"), children: [_jsx("div", { className: "ecx-navigation-items", children: menu }), a.mobile !== false && _jsxs("details", { className: "ecx-navigation-toggle", children: [_jsx("summary", { "aria-label": t("navigation.menu"), children: "\u2630" }), menu] })] }, key));
+        }
+        case "search":
+            return _jsx("div", { className: "ecx-search", children: _jsx(SearchForm, { defaultValue: ctx.data?.search, placeholder: a.placeholder, buttonLabel: a.buttonText }) }, key);
+        case "languageSwitcher":
+            return _jsx(LanguageSwitcher, { className: "ecx-language-switcher" }, key);
+        case "copyright":
+            return _jsxs("p", { className: "ecx-copyright", style: align(a), children: ["\u00A9 ", new Date().getFullYear(), " ", a.text || site.title] }, key);
+        case "postTitle": {
+            if (!post)
+                return null;
+            const Tag = `h${Math.min(6, Math.max(1, a.level ?? 1))}`;
+            return _jsx(Tag, { className: "ecx-post-title", style: align(a), children: a.link ? _jsx(Link, { href: post.link, children: post.title }) : post.title }, key);
+        }
+        case "postContent": {
+            if (!post || !ctx.data)
+                return null;
+            const { PostContent } = await import("./content.js");
+            return _jsx(PostContent, { post: post }, key);
+        }
+        case "postExcerpt":
+            if (!post?.excerpt)
+                return null;
+            return _jsxs("p", { className: "ecx-post-excerpt", children: [post.excerpt, a.moreText && _jsxs(_Fragment, { children: [" ", _jsx(Link, { href: post.link, className: "ecx-more-link", children: a.moreText })] })] }, key);
+        case "featuredImage": {
+            if (!post?.featuredMedia)
+                return null;
+            const ratio = ASPECT[a.aspect];
+            return _jsx("div", { className: "ecx-featured-image", style: ratio ? { aspectRatio: ratio, overflow: "hidden" } : undefined, children: _jsx(FeaturedImage, { media: post.featuredMedia, size: a.size ?? "large", link: a.link ? post.link : undefined }) }, key);
+        }
+        case "postDate":
+            return post ? _jsx("p", { className: "ecx-post-date", style: align(a), children: _jsx(PostDate, { post: post, site: site }) }, key) : null;
+        case "postAuthor":
+            if (!post?.author)
+                return null;
+            return _jsxs("p", { className: "ecx-post-author", children: [a.avatar && post.author.avatarUrl && _jsx("img", { src: post.author.avatarUrl, alt: "", width: 32, height: 32, style: { borderRadius: "50%", verticalAlign: "middle", marginRight: 8 } }), _jsx(Link, { href: localeHref(site, `/author/${post.author.slug}`), rel: "author", children: post.author.name })] }, key);
+        case "postTerms": {
+            const terms = post?.terms?.[a.taxonomy ?? "category"];
+            return terms?.length ? _jsx("p", { className: "ecx-post-terms", children: _jsx(TermLinks, { terms: terms, separator: a.separator ?? ", " }) }, key) : null;
+        }
+        case "comments":
+            return post && ctx.data?.post?.id === post.id ? _jsx(Comments, { post: post }, key) : null;
+        case "query": {
+            let posts;
+            let data;
+            if (a.inherit !== false && ctx.data?.posts) {
+                posts = ctx.data.posts;
+                data = ctx.data;
+            }
+            else {
+                const taxonomy = a.category ? "category" : a.tag ? "post_tag" : undefined;
+                const res = await getPosts({ type: a.postType ?? "post", perPage: a.perPage ?? 10, taxonomy, term: a.category || a.tag || undefined,
+                    orderBy: a.orderBy ?? "date", order: a.order ?? "desc" }).catch(() => null);
+                posts = res?.items ?? [];
+            }
+            return _jsx("div", { className: "ecx-query", children: await children({ ...ctx, query: { posts, data } }) }, key);
+        }
+        case "postTemplate": {
+            const posts = ctx.query?.posts ?? [];
+            if (!posts.length)
+                return null;
+            const grid = a.layout === "grid";
+            const style = grid ? { display: "grid", gap: "1.5rem", gridTemplateColumns: `repeat(auto-fill, minmax(min(100%, ${Math.floor(60 / (a.columns ?? 3))}rem), 1fr))`, listStyle: "none", padding: 0 } : { listStyle: "none", padding: 0 };
+            const items = await Promise.all(posts.map(async (p) => _jsx("li", { className: "ecx-post", children: await children({ ...ctx, post: p }) }, p.id)));
+            return _jsx("ul", { className: cx("ecx-post-template", grid && "is-grid"), style: style, children: items }, key);
+        }
+        case "pagination":
+            return ctx.query?.data ? _jsx(Pagination, { data: ctx.query.data }, key) : null;
+        case "queryEmpty":
+            return ctx.query && !ctx.query.posts.length ? _jsx("div", { className: "ecx-query-empty", children: await children(ctx) }, key) : null;
+        case "syncedPattern": {
+            if (typeof a.ref !== "number" || !ctx.pattern || (ctx.partDepth ?? 0) >= 4)
+                return null;
+            const doc = await ctx.pattern(a.ref);
+            if (!doc)
+                return null;
+            return _jsx(Fragment, { children: await renderContent(doc, { ...ctx, partDepth: (ctx.partDepth ?? 0) + 1 }) }, key);
+        }
+        case "templatePart": {
+            if (!a.slug || !ctx.parts || (ctx.partDepth ?? 0) >= 4)
+                return null;
+            const doc = await ctx.parts(String(a.slug));
+            const Tag = (["header", "footer", "aside", "section"].includes(a.tagName) ? a.tagName : "div");
+            const part = doc ? _jsx(Tag, { className: cx("ecx-template-part", `ecx-template-part-${a.slug}`), children: await renderContent(doc, { ...ctx, partDepth: (ctx.partDepth ?? 0) + 1 }) }) : null;
+            const el = ctx.region ? await ctx.region(String(a.slug), part) : part;
+            return el == null ? null : _jsx(Fragment, { children: el }, key);
+        }
+    }
+    return null;
+}

package/dist/i18n.d.ts

@@ -0,0 +1,11 @@
+/** Chữ mặc định của các component trong SDK (theme có thể ghi đè trong locales/{code}.json). */
+export declare const BUILTIN: Record<string, Record<string, string>>;
+export type Translator = ((key: string, vars?: Record<string, string | number>) => string) & {
+    locale: 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.
+ */
+export declare const getT: () => Promise<Translator>;

package/dist/i18n.js

@@ -0,0 +1,104 @@
+import { IntlMessageFormat } from "intl-messageformat";
+import { cache } from "react";
+import { getSite } from "./api.js";
+import { getActiveTheme } from "./runtime.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",
+        "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",
+        "comments.form.email": "Email", "comments.form.website": "Website", "comments.form.submit": "Gửi bình luận",
+        "comments.form.sending": "Đang gửi…", "comments.form.approved": "Cảm ơn bạn! Bình luận đã được đăng (tải lại trang để xem).",
+        "comments.form.pending": "Cảm ơn bạn! Bình luận đang chờ duyệt.", "comments.form.error": "Không gửi được bình luận",
+        "comments.more": "Xem thêm bình luận", "comments.loading": "Đang tải…",
+        "password.intro": "Nội dung này được bảo vệ bằng mật khẩu. Nhập mật khẩu để xem:", "password.label": "Mật khẩu",
+        "password.submit": "Xem nội dung", "password.wrong": "Mật khẩu không đúng",
+        "archives.month": "Tháng {month}/{year}", "language.label": "Ngôn ngữ",
+        "auth.login": "Tên đăng nhập hoặc email", "auth.password": "Mật khẩu", "auth.submitLogin": "Đăng nhập", "auth.code": "Mã xác thực (6 số)",
+        "auth.verify": "Xác nhận", "auth.userName": "Tên đăng nhập", "auth.email": "Email", "auth.displayName": "Tên hiển thị",
+        "auth.submitRegister": "Tạo tài khoản", "auth.submitForgot": "Gửi liên kết đặt lại", "auth.newPassword": "Mật khẩu mới (tối thiểu 10 ký tự)",
+        "auth.submitReset": "Đặt mật khẩu", "auth.sending": "Đang xử lý…", "auth.error": "Có lỗi xảy ra, vui lòng thử lại", "auth.logout": "Đăng xuất",
+        "auth.noAccount": "Chưa có tài khoản?", "auth.register": "Đăng ký", "auth.forgot": "Quên mật khẩu?", "auth.haveAccount": "Đã có tài khoản?",
+        "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",
+    },
+    en: {
+        "search.placeholder": "Search…", "search.button": "Search", "search.label": "Keyword", "navigation.menu": "Menu", "toc.title": "Contents",
+        "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",
+        "comments.form.email": "Email", "comments.form.website": "Website", "comments.form.submit": "Post comment",
+        "comments.form.sending": "Sending…", "comments.form.approved": "Thanks! Your comment is published (reload to see it).",
+        "comments.form.pending": "Thanks! Your comment is awaiting moderation.", "comments.form.error": "Could not post your comment",
+        "comments.more": "Load more comments", "comments.loading": "Loading…",
+        "password.intro": "This content is password protected. Enter the password to view it:", "password.label": "Password",
+        "password.submit": "Enter", "password.wrong": "Incorrect password",
+        "archives.month": "{month}/{year}", "language.label": "Language",
+        "auth.login": "Username or email", "auth.password": "Password", "auth.submitLogin": "Log in", "auth.code": "Authentication code (6 digits)",
+        "auth.verify": "Verify", "auth.userName": "Username", "auth.email": "Email", "auth.displayName": "Display name",
+        "auth.submitRegister": "Create account", "auth.submitForgot": "Send reset link", "auth.newPassword": "New password (at least 10 characters)",
+        "auth.submitReset": "Set password", "auth.sending": "Working…", "auth.error": "Something went wrong, please try again", "auth.logout": "Log out",
+        "auth.noAccount": "No account yet?", "auth.register": "Register", "auth.forgot": "Forgot password?", "auth.haveAccount": "Already have an account?",
+        "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",
+    },
+};
+/**
+ * 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.
+ */
+export const getT = cache(async () => {
+    const site = await getSite();
+    const theme = await getActiveTheme(site);
+    const order = [...new Set([site.locale, site.defaultLocale, "en"])];
+    const dicts = [];
+    for (const code of order) {
+        for (const t of theme.chain) {
+            const loader = t.locales?.[code];
+            if (loader) {
+                try {
+                    dicts.push({ code, dict: (await loader()).default });
+                }
+                catch { /* bỏ qua */ }
+            }
+        }
+        if (BUILTIN[code])
+            dicts.push({ code, dict: BUILTIN[code] });
+    }
+    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;
+    });
+    t.locale = site.locale;
+    return t;
+});

package/dist/image.d.ts

@@ -0,0 +1,24 @@
+import type { CSSProperties } from "react";
+import type { Media, MediaSize } from "./types.js";
+/**
+ * Các cỡ ảnh dùng cho srcset: cỡ được chọn + mọi cỡ cùng tỉ lệ (không bị cắt) nhỏ hơn,
+ * để trình duyệt tự chọn file vừa đủ cho màn hình.
+ */
+export declare function imageCandidates(media: Media, size?: string): MediaSize[];
+export interface ImgProps {
+    media?: Media | null;
+    /** Cỡ lớn nhất cần dùng: thumbnail, medium, medium_large, large, 1536x1536, 2048x2048 hoặc cỡ theme tự khai báo. */
+    size?: string;
+    /** Thuộc tính sizes của HTML, vd "(max-width: 768px) 100vw, 50vw". Mặc định: rộng tối đa bằng cỡ ảnh. */
+    sizes?: string;
+    className?: string;
+    alt?: string;
+    /** Ảnh đầu trang (LCP): tải ngay, ưu tiên cao. */
+    priority?: boolean;
+    style?: CSSProperties;
+}
+/**
+ * Ảnh responsive: <picture> với WebP + ảnh gốc, srcset nhiều cỡ, width/height chống nhảy layout,
+ * object-position theo điểm lấy nét chọn trong thư viện media.
+ */
+export declare function Img({ media, size, sizes, className, alt, priority, style }: ImgProps): import("react").JSX.Element | null;

package/dist/image.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cx } from "./utils.js";
+const ratio = (w, h) => (w && h ? w / h : 0);
+/**
+ * Các cỡ ảnh dùng cho srcset: cỡ được chọn + mọi cỡ cùng tỉ lệ (không bị cắt) nhỏ hơn,
+ * để trình duyệt tự chọn file vừa đủ cho màn hình.
+ */
+export function imageCandidates(media, size = "large") {
+    const chosen = media.sizes[size];
+    const full = { url: media.url, width: media.width ?? 0, height: media.height ?? 0, webpUrl: media.webpUrl ?? undefined };
+    const target = chosen ?? full;
+    const r = ratio(target.width, target.height);
+    const all = [...Object.values(media.sizes), ...(chosen ? [] : [full])];
+    const same = all.filter((s) => s.width <= target.width && Math.abs(ratio(s.width, s.height) - r) < 0.02);
+    if (!same.includes(target))
+        same.push(target);
+    return same.filter((s) => s.width > 0).sort((a, b) => a.width - b.width);
+}
+/**
+ * Ảnh responsive: &lt;picture&gt; với WebP + ảnh gốc, srcset nhiều cỡ, width/height chống nhảy layout,
+ * object-position theo điểm lấy nét chọn trong thư viện media.
+ */
+export function Img({ media, size = "large", sizes, className, alt, priority, style }) {
+    if (!media)
+        return null;
+    const list = imageCandidates(media, size);
+    const main = list[list.length - 1] ?? { url: media.url, width: media.width ?? 0, height: media.height ?? 0 };
+    const srcSet = list.map((s) => `${s.url} ${s.width}w`).join(", ");
+    const webp = list.every((s) => s.webpUrl) ? list.map((s) => `${s.webpUrl} ${s.width}w`).join(", ") : null;
+    const sz = sizes ?? (main.width ? `(max-width: ${main.width}px) 100vw, ${main.width}px` : undefined);
+    const focal = media.focalX != null && media.focalY != null
+        ? { objectPosition: `${Math.round(media.focalX * 100)}% ${Math.round(media.focalY * 100)}%` } : undefined;
+    const img = (_jsx("img", { src: main.url, srcSet: list.length > 1 ? srcSet : undefined, sizes: list.length > 1 ? sz : undefined, width: main.width || undefined, height: main.height || undefined, alt: alt ?? media.alt ?? "", loading: priority ? "eager" : "lazy", decoding: "async", fetchPriority: priority ? "high" : undefined, className: className, style: { ...focal, ...style } }));
+    if (!webp || media.mimeType === "image/webp")
+        return img;
+    return _jsxs("picture", { className: cx("cms-picture"), children: [_jsx("source", { type: "image/webp", srcSet: webp, sizes: sz }), img] });
+}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export * from "./types.js";
+export * from "./api.js";
+export * from "./utils.js";
+export { definePlugin, getPlugin, hasPlugin, applyFilters, doAction, getSlotItems, getSlotComponents, getActiveTheme, getActiveExtensions, BUILTIN_PAGE_TEMPLATES, findShortcode, findWidget, findBlock, findRoute, findRegion } from "./runtime.js";
+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 { 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 { 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/nexus-content";

package/dist/index.js

@@ -0,0 +1,21 @@
+export * from "./types.js";
+export * from "./api.js";
+export * from "./utils.js";
+export { definePlugin, getPlugin, hasPlugin, applyFilters, doAction, getSlotItems, getSlotComponents, getActiveTheme, getActiveExtensions, BUILTIN_PAGE_TEMPLATES, findShortcode, findWidget, findBlock, findRoute, findRegion } from "./runtime.js";
+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 { 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 { buildDocumentMetadata } from "./metadata.js";
+/** Lấy giá trị Customizer của theme đang active. */
+export async function getThemeSettings() {
+    const { getSite } = await import("./api.js");
+    return (await getSite()).themeSettings;
+}
+export { PluginForm } from "./plugin-form.js";
+export { defineBlock } from "@ecomcx/nexus-content";

package/dist/locale.d.ts

@@ -0,0 +1,9 @@
+/** Header do proxy.ts của frontend gắn vào request: mã ngôn ngữ lấy từ tiền tố URL (/en/...). */
+export declare const LOCALE_HEADER = "x-cms-locale";
+/** Ngôn ngữ của request hiện tại (undefined = ngôn ngữ mặc định của site). */
+export declare const getRequestLocale: () => Promise<string | undefined>;
+/** Đường dẫn có tiền tố ngôn ngữ: localeHref(site, "/author/an") → "/en/author/an" khi đang ở tiếng Anh. */
+export declare function localeHref(site: {
+    locale: string;
+    defaultLocale: string;
+}, path: string): string;

package/dist/locale.js

@@ -0,0 +1,20 @@
+import { cache } from "react";
+/** Header do proxy.ts của frontend gắn vào request: mã ngôn ngữ lấy từ tiền tố URL (/en/...). */
+export const LOCALE_HEADER = "x-cms-locale";
+/** Ngôn ngữ của request hiện tại (undefined = ngôn ngữ mặc định của site). */
+export const getRequestLocale = cache(async () => {
+    try {
+        const { headers } = await import("next/headers");
+        return (await headers()).get(LOCALE_HEADER) ?? undefined;
+    }
+    catch {
+        return undefined; // ngoài request (build, route tĩnh)
+    }
+});
+/** Đường dẫn có tiền tố ngôn ngữ: localeHref(site, "/author/an") → "/en/author/an" khi đang ở tiếng Anh. */
+export function localeHref(site, path) {
+    const p = path.startsWith("/") ? path : `/${path}`;
+    if (site.locale === site.defaultLocale)
+        return p;
+    return p === "/" ? `/${site.locale}` : `/${site.locale}${p}`;
+}

package/dist/metadata.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentMetadata, ResolveResult, Site } from "./types.js";
+/** Metadata mặc định cho trang + cho plugin (vd SEO) sửa qua filter "document.metadata". */
+export declare function buildDocumentMetadata(data: ResolveResult, site: Site): Promise<DocumentMetadata>;

package/dist/metadata.js

@@ -0,0 +1,26 @@
+import { applyFilters } from "./runtime.js";
+/** Metadata mặc định cho trang + cho plugin (vd SEO) sửa qua filter "document.metadata". */
+export async function buildDocumentMetadata(data, site) {
+    const isHome = data.kind === "home" || data.kind === "front-page";
+    const base = {
+        title: isHome ? `${site.title}${site.tagline ? ` – ${site.tagline}` : ""}` : `${data.title} – ${site.title}`,
+        description: data.post?.excerpt || (data.term?.description || undefined) || site.tagline,
+        canonical: data.post?.link ?? (data.basePath || undefined),
+        alternates: Object.fromEntries((data.alternates ?? []).map((a) => [a.locale, a.link])),
+        openGraph: {
+            title: data.post?.title ?? data.title,
+            description: data.post?.excerpt || site.tagline,
+            image: data.post?.featuredMedia?.sizes?.large?.url ?? data.post?.featuredMedia?.url,
+            type: data.kind === "single" ? "article" : "website",
+        },
+    };
+    if (data.kind === "404" || data.kind === "search" || data.noIndex)
+        base.robots = "noindex";
+    if (site.indexable === false)
+        base.robots = "noindex, nofollow";
+    const meta = await applyFilters("document.metadata", base, { site, data }, site);
+    // Trang core/plugin khai báo noindex (đăng nhập, tài khoản, giỏ hàng) — plugin SEO không được mở index
+    if (data.noIndex || site.indexable === false)
+        meta.robots = site.indexable === false ? "noindex, nofollow" : "noindex, follow";
+    return meta;
+}

package/dist/page-canvas.d.ts

@@ -0,0 +1,4 @@
+import type { TemplateProps } from "./types.js";
+/** Template "canvas": không có header/footer của theme, chỉ nội dung trang (trang dựng bằng khối). */
+export default function Canvas({ data }: TemplateProps): import("react").JSX.Element;
+export declare const layout = false;

package/dist/page-canvas.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { PostContent } from "./content.js";
+/** Template "canvas": không có header/footer của theme, chỉ nội dung trang (trang dựng bằng khối). */
+export default function Canvas({ data }) {
+    return _jsx("main", { className: "ecx-canvas", children: _jsx(PostContent, { post: data.post }) });
+}
+export const layout = false;

package/dist/page-full-width.d.ts

@@ -0,0 +1,3 @@
+import type { TemplateProps } from "./types.js";
+/** Template "full-width": giữ header/footer của theme, nội dung trải hết chiều ngang màn hình. */
+export default function FullWidth({ data }: TemplateProps): import("react").JSX.Element;

package/dist/page-full-width.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { PostContent } from "./content.js";
+/** Template "full-width": giữ header/footer của theme, nội dung trải hết chiều ngang màn hình. */
+export default function FullWidth({ data }) {
+    return _jsx("div", { className: "ecx-full-width", children: _jsx(PostContent, { post: data.post }) });
+}

package/dist/plugin-form-client.d.ts

@@ -0,0 +1,27 @@
+export interface PluginFormField {
+    key: string;
+    type: string;
+    label: string;
+    required: boolean;
+    maxLength?: number | null;
+    minLength?: number | null;
+    min?: string | null;
+    max?: string | null;
+    options?: string[] | null;
+    pattern?: string | null;
+    default?: unknown;
+}
+export interface PluginFormLabels {
+    submit: string;
+    sending: string;
+    error: string;
+}
+/** Phần chạy trên trình duyệt của <PluginForm>: ô nhập, gửi, hiện lỗi theo từng ô (422) và lời cảm ơn. */
+export declare function PluginFormClient({ plugin, table, fields, labels, successMessage, className }: {
+    plugin: string;
+    table: string;
+    fields: PluginFormField[];
+    labels: PluginFormLabels;
+    successMessage?: string | null;
+    className?: string;
+}): import("react").JSX.Element;

package/dist/plugin-form-client.js

@@ -0,0 +1,55 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+/** Phần chạy trên trình duyệt của <PluginForm>: ô nhập, gửi, hiện lỗi theo từng ô (422) và lời cảm ơn. */
+export function PluginFormClient({ plugin, table, fields, labels, successMessage, className }) {
+    const [errors, setErrors] = useState({});
+    const [state, setState] = useState({ status: "idle" });
+    async function submit(e) {
+        e.preventDefault();
+        const form = e.currentTarget;
+        const data = new FormData(form);
+        const body = {};
+        for (const f of fields) {
+            const v = data.get(f.key);
+            if (f.type === "boolean")
+                body[f.key] = data.has(f.key);
+            else if (v === null || v === "")
+                body[f.key] = null;
+            else if (f.type === "number")
+                body[f.key] = Number(v);
+            else if (f.type === "datetime")
+                body[f.key] = new Date(String(v)).toISOString();
+            else
+                body[f.key] = String(v);
+        }
+        setState({ status: "sending" });
+        setErrors({});
+        try {
+            const res = await fetch(`/api/cms/plugins/${plugin}/data/${table}`, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
+            const json = await res.json().catch(() => ({}));
+            if (!res.ok) {
+                setErrors(json.errors ?? {});
+                setState({ status: "error", message: json.title ?? labels.error });
+                return;
+            }
+            form.reset();
+            setState({ status: "done", message: json.message ?? successMessage ?? "" });
+        }
+        catch {
+            setState({ status: "error", message: labels.error });
+        }
+    }
+    if (state.status === "done")
+        return _jsx("p", { className: "ecx-form-success form-success", role: "status", children: state.message });
+    return (_jsxs("form", { className: ["ecx-form cms-form", className].filter(Boolean).join(" "), onSubmit: submit, noValidate: true, children: [fields.map((f) => {
+                const id = `cms-form-${plugin}-${table}-${f.key}`;
+                const err = errors[f.key];
+                const common = { id, name: f.key, required: f.required, "aria-invalid": err ? true : undefined, defaultValue: f.default == null ? undefined : String(f.default) };
+                return (_jsxs("p", { className: `ecx-form-field ecx-form-${f.type} cms-form-field cms-form-${f.type}`, children: [f.type === "boolean"
+                            ? _jsxs("label", { htmlFor: id, children: [_jsx("input", { type: "checkbox", id: id, name: f.key, defaultChecked: f.default === true }), " ", f.label] })
+                            : _jsxs("label", { htmlFor: id, children: [f.label, f.required && _jsx("span", { "aria-hidden": "true", children: " *" })] }), f.type === "textarea" ? _jsx("textarea", { rows: 5, maxLength: f.maxLength ?? undefined, ...common })
+                            : f.type === "select" ? (_jsxs("select", { ...common, children: [!f.required && _jsx("option", { value: "", children: "\u2014" }), (f.options ?? []).map((o) => _jsx("option", { value: o, children: o }, o))] }))
+                                : f.type !== "boolean" && _jsx("input", { ...common, type: { email: "email", tel: "tel", url: "url", number: "number", date: "date", time: "time", datetime: "datetime-local" }[f.type] ?? "text", maxLength: f.maxLength ?? undefined, minLength: f.minLength ?? undefined, min: f.min ?? undefined, max: f.max ?? undefined, pattern: f.pattern ?? undefined }), err && _jsx("span", { className: "ecx-form-error form-error", children: err.join(" ") })] }, f.key));
+            }), state.status === "error" && _jsx("p", { className: "ecx-form-error form-error", role: "alert", children: state.message }), _jsx("button", { type: "submit", disabled: state.status === "sending", children: state.status === "sending" ? labels.sending : labels.submit })] }));
+}

package/dist/plugin-form.d.ts

@@ -0,0 +1,15 @@
+import type { ShortcodeProps } from "./types.js";
+/**
+ * Form tự sinh cho bảng EF của plugin có [PublicCreate] (form liên hệ, đặt lịch, đăng ký…):
+ *   <PluginForm plugin="lien-he" table="messages" />   — hoặc shortcode [cms-form plugin="lien-he" table="messages"]
+ * Ô nhập, nhãn, ràng buộc lấy từ kiểu dữ liệu C# của plugin; máy chủ kiểm tra lại và giới hạn số lần gửi.
+ * Class CSS: cms-form, cms-form-field, cms-form-{kiểu}, form-error, form-success.
+ */
+export declare function PluginForm({ plugin, table, submitLabel, className }: {
+    plugin: string;
+    table: string;
+    submitLabel?: string;
+    className?: string;
+}): Promise<import("react").JSX.Element | null>;
+/** Shortcode có sẵn: [cms-form plugin="lien-he" table="messages" submit="Gửi liên hệ" class="…"]. */
+export declare function CmsFormShortcode({ attrs }: ShortcodeProps): import("react").JSX.Element;