@risali/react 0.2.0 → 0.6.0

package/README.md

@@ -141,6 +141,28 @@ export function HomePage({ content }: { content: RisaliContent | null }) {
 
 Helpers always validate the block type (a block typed `image` will return `defaultValue` from `getBlockValue`) and `getBlockRichText` always sanitises — including the fallback HTML — so a stored XSS payload can't reach the browser even if the block is missing.
 
+### Builder pages (v0.6.0)
+
+A page with `render_mode='builder'` in the Risali dashboard is a DB-driven list of sections (hero, text + image, features, gallery, CTA, contact, plain). `<RisaliPage>` renders the whole page server-side; pages still in `code` mode return `notFound`, so a catch-all route coexists with your static routes:
+
+```tsx
+// app/[[...rest]]/page.tsx
+import { notFound } from "next/navigation";
+import { RisaliPage } from "@risali/react";
+
+export default async function Page({ params }: { params: Promise<{ rest?: string[] }> }) {
+  const { rest } = await params;
+  const path = "/" + (rest ?? []).join("/");
+  const page = await RisaliPage({ path });
+  if (!page) notFound();
+  return page;
+}
+```
+
+Signature sections you build in code register via `customSections={{ moja_sekcia: MyComponent }}` and win over the built-in catalog on a type collision.
+
+`<RisaliBrand />` in the root layout emits the brand palette + fonts as CSS variables (`--risali-color-<key>`, `--risali-font-heading`, `--risali-font-body`) — builder sections consume them automatically, and your own components/Tailwind theme can too. A brand change in the dashboard revalidates the site instantly, no deploy.
+
 ## Editor mode
 
 Every rendered block carries a `data-risali-key="<pageKey>"` attribute. The Risali editor iframe (`/risali.js?site=<slug>&risali_edit=1`) uses that marker to wire up click-to-edit — no CSS selector generation, no content-hash drift, no fragile DOM scanning.

package/dist/blog-jsonld.d.ts

@@ -0,0 +1,74 @@
+import type { RisaliBlogPost } from "./blog.js";
+export type BuildBlogPostJsonLdOptions = {
+    /** Absolute origin of the client web (https://klient.sk). Required for
+     * `mainEntityOfPage` and absolute image URLs. */
+    origin: string;
+    /** Site name — shown in the `publisher.name` slot. */
+    siteName: string;
+    /** Optional publisher logo URL (used in `publisher.logo.url`). */
+    publisherLogoUrl?: string;
+};
+/**
+ * Produce a `BlogPosting` JSON-LD object compliant with schema.org.
+ * Drop fields when source data is missing — Google's structured data
+ * validator silently ignores empty strings but warns on null/undefined.
+ *
+ * The HTML embed pattern:
+ *
+ *     const ld = buildBlogPostJsonLd(post, { origin, siteName });
+ *     <script
+ *       type="application/ld+json"
+ *       dangerouslySetInnerHTML={{ __html: JSON.stringify(ld) }}
+ *     />
+ */
+export declare function buildBlogPostJsonLd(post: RisaliBlogPost, opts: BuildBlogPostJsonLdOptions): Record<string, unknown>;
+/**
+ * Build a Next.js `Metadata` partial for a blog post (PR 36d helper).
+ * The consumer uses it in `generateMetadata`:
+ *
+ *     export async function generateMetadata({ params }) {
+ *       const { slug } = await params;
+ *       const post = await getRisaliBlogPost(slug);
+ *       return buildBlogPostMetadata(post, { siteName, origin });
+ *     }
+ *
+ * Returns the empty title fallback so an unknown post renders a
+ * generic "Article" tab title rather than `undefined - …`.
+ */
+export declare function buildBlogPostMetadata(post: RisaliBlogPost | null, opts: {
+    siteName: string;
+    origin: string;
+    defaultTitle?: string;
+}): {
+    title: string;
+    description?: undefined;
+    alternates?: undefined;
+    openGraph?: undefined;
+    twitter?: undefined;
+} | {
+    title: string;
+    description: string | undefined;
+    alternates: {
+        canonical: string;
+    };
+    openGraph: {
+        title: string;
+        description: string | undefined;
+        url: string;
+        type: string;
+        siteName: string;
+        publishedTime: string;
+        modifiedTime: string;
+        authors: string[] | undefined;
+        images: {
+            url: string;
+        }[] | undefined;
+    };
+    twitter: {
+        card: string;
+        title: string;
+        description: string | undefined;
+        images: string[] | undefined;
+    };
+};
+//# sourceMappingURL=blog-jsonld.d.ts.map

package/dist/blog-jsonld.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-jsonld.d.ts","sourceRoot":"","sources":["../src/blog-jsonld.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,MAAM,0BAA0B,GAAG;IACvC;qDACiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,0BAA0B,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,GAAG,IAAI,EAC3B,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmClE"}

package/dist/blog-jsonld.js

@@ -0,0 +1,111 @@
+// JSON-LD `BlogPosting` schema builder for the blog post page (PR 36d).
+// Pure: takes a post payload (typed) + site context, returns a JS
+// object the consumer can JSON.stringify into a `<script
+// type="application/ld+json">` tag.
+//
+// Standalone helper so the consumer can wire it into their
+// `generateMetadata` flow or inline-emit it next to <RisaliBlogPost />.
+/**
+ * Produce a `BlogPosting` JSON-LD object compliant with schema.org.
+ * Drop fields when source data is missing — Google's structured data
+ * validator silently ignores empty strings but warns on null/undefined.
+ *
+ * The HTML embed pattern:
+ *
+ *     const ld = buildBlogPostJsonLd(post, { origin, siteName });
+ *     <script
+ *       type="application/ld+json"
+ *       dangerouslySetInnerHTML={{ __html: JSON.stringify(ld) }}
+ *     />
+ */
+export function buildBlogPostJsonLd(post, opts) {
+    const baseOrigin = opts.origin.replace(/\/+$/, "");
+    const url = `${baseOrigin}/blog/${post.slug}`;
+    const headline = (post.seo_meta.title || post.title || "").slice(0, 110);
+    const description = post.seo_meta.description || post.excerpt || undefined;
+    const imageUrl = post.seo_meta.og_image_url || post.hero_image_url || undefined;
+    const author = post.author_display
+        ? { "@type": "Person", name: post.author_display }
+        : { "@type": "Organization", name: opts.siteName };
+    const publisher = {
+        "@type": "Organization",
+        name: opts.siteName,
+    };
+    if (opts.publisherLogoUrl) {
+        publisher.logo = {
+            "@type": "ImageObject",
+            url: opts.publisherLogoUrl,
+        };
+    }
+    const ld = {
+        "@context": "https://schema.org",
+        "@type": "BlogPosting",
+        headline,
+        mainEntityOfPage: {
+            "@type": "WebPage",
+            "@id": url,
+        },
+        url,
+        author,
+        publisher,
+        datePublished: post.published_at,
+        dateModified: post.updated_at || post.published_at,
+    };
+    if (description)
+        ld.description = description;
+    if (imageUrl)
+        ld.image = imageUrl;
+    if (post.category)
+        ld.articleSection = post.category;
+    if (post.reading_minutes) {
+        ld.timeRequired = `PT${post.reading_minutes}M`;
+    }
+    return ld;
+}
+/**
+ * Build a Next.js `Metadata` partial for a blog post (PR 36d helper).
+ * The consumer uses it in `generateMetadata`:
+ *
+ *     export async function generateMetadata({ params }) {
+ *       const { slug } = await params;
+ *       const post = await getRisaliBlogPost(slug);
+ *       return buildBlogPostMetadata(post, { siteName, origin });
+ *     }
+ *
+ * Returns the empty title fallback so an unknown post renders a
+ * generic "Article" tab title rather than `undefined - …`.
+ */
+export function buildBlogPostMetadata(post, opts) {
+    if (!post) {
+        return {
+            title: opts.defaultTitle ?? "Článok",
+        };
+    }
+    const title = post.seo_meta.title || post.title;
+    const description = post.seo_meta.description || post.excerpt || undefined;
+    const ogImage = post.seo_meta.og_image_url || post.hero_image_url || undefined;
+    const url = `${opts.origin.replace(/\/+$/, "")}/blog/${post.slug}`;
+    return {
+        title: `${title} — ${opts.siteName}`,
+        description,
+        alternates: { canonical: url },
+        openGraph: {
+            title,
+            description,
+            url,
+            type: "article",
+            siteName: opts.siteName,
+            publishedTime: post.published_at,
+            modifiedTime: post.updated_at,
+            authors: post.author_display ? [post.author_display] : undefined,
+            images: ogImage ? [{ url: ogImage }] : undefined,
+        },
+        twitter: {
+            card: ogImage ? "summary_large_image" : "summary",
+            title,
+            description,
+            images: ogImage ? [ogImage] : undefined,
+        },
+    };
+}
+//# sourceMappingURL=blog-jsonld.js.map

package/dist/blog-jsonld.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-jsonld.js","sourceRoot":"","sources":["../src/blog-jsonld.ts"],"names":[],"mappings":"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"}

package/dist/blog-list.d.ts

@@ -0,0 +1,29 @@
+import type { CSSProperties } from "react";
+import { type GetBlogPostsOptions } from "./blog.js";
+export type RisaliBlogListProps = GetBlogPostsOptions & {
+    /** Hide the empty-state placeholder when the list is empty. */
+    hideEmptyState?: boolean;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * Server component that renders a responsive grid of blog cards
+ * (hero image + title + excerpt + date + reading minutes + category
+ * chip). Use it on the client web's `/blog` route:
+ *
+ *     // app/blog/page.tsx
+ *     import { RisaliBlogList } from "@risali/react";
+ *     export default function BlogIndex() {
+ *       return <RisaliBlogList limit={12} />;
+ *     }
+ *
+ * Renders an empty-state placeholder when the site has no published
+ * posts yet (suppress with `hideEmptyState`).
+ *
+ * Styling: unopinionated. Tailwind-friendly class names on the wrapper;
+ * pass a `className` to override. The card layout uses inline CSS so it
+ * works on hosts without a CSS framework, but tenants are free to
+ * style via `.risali-blog-*` class names.
+ */
+export declare function RisaliBlogList(props: RisaliBlogListProps): Promise<import("react/jsx-runtime").JSX.Element | null>;
+//# sourceMappingURL=blog-list.d.ts.map

package/dist/blog-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-list.d.ts","sourceRoot":"","sources":["../src/blog-list.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,WAAW,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACtD,+DAA+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAgBF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,2DAoC9D"}

package/dist/blog-list.js

@@ -0,0 +1,113 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getRisaliBlogPosts, } from "./blog.js";
+// Format ISO date for the SK locale, falling back to the raw value on
+// any parse failure (never throws — runtime errors in a server
+// component crash the whole route).
+function fmtDate(iso) {
+    if (!iso)
+        return "";
+    const d = new Date(iso);
+    if (!Number.isFinite(d.getTime()))
+        return "";
+    return d.toLocaleDateString("sk-SK", {
+        day: "numeric",
+        month: "long",
+        year: "numeric",
+    });
+}
+/**
+ * Server component that renders a responsive grid of blog cards
+ * (hero image + title + excerpt + date + reading minutes + category
+ * chip). Use it on the client web's `/blog` route:
+ *
+ *     // app/blog/page.tsx
+ *     import { RisaliBlogList } from "@risali/react";
+ *     export default function BlogIndex() {
+ *       return <RisaliBlogList limit={12} />;
+ *     }
+ *
+ * Renders an empty-state placeholder when the site has no published
+ * posts yet (suppress with `hideEmptyState`).
+ *
+ * Styling: unopinionated. Tailwind-friendly class names on the wrapper;
+ * pass a `className` to override. The card layout uses inline CSS so it
+ * works on hosts without a CSS framework, but tenants are free to
+ * style via `.risali-blog-*` class names.
+ */
+export async function RisaliBlogList(props) {
+    const posts = await getRisaliBlogPosts({
+        siteSlug: props.siteSlug,
+        category: props.category,
+        limit: props.limit,
+        offset: props.offset,
+    });
+    if (posts.length === 0) {
+        if (props.hideEmptyState)
+            return null;
+        return (_jsx("div", { className: props.className ?? "risali-blog-empty", style: props.style, children: _jsx("p", { style: { color: "#6b7280" }, children: "Zatia\u013E tu nie s\u00FA \u017Eiadne \u010Dl\u00E1nky." }) }));
+    }
+    return (_jsx("div", { className: props.className ?? "risali-blog-list", style: {
+            display: "grid",
+            gap: "1.5rem",
+            gridTemplateColumns: "repeat(auto-fill, minmax(280px, 1fr))",
+            ...props.style,
+        }, children: posts.map((post) => (_jsx(BlogCard, { post: post }, post.slug))) }));
+}
+function BlogCard({ post }) {
+    return (_jsx("article", { className: "risali-blog-card", style: {
+            display: "flex",
+            flexDirection: "column",
+            overflow: "hidden",
+            borderRadius: "0.75rem",
+            background: "#fff",
+            boxShadow: "0 1px 2px rgba(0,0,0,0.05)",
+            border: "1px solid #e5e7eb",
+        }, children: _jsxs("a", { href: `/blog/${encodeURIComponent(post.slug)}`, className: "risali-blog-card-link", style: {
+                color: "inherit",
+                textDecoration: "none",
+                display: "flex",
+                flexDirection: "column",
+                height: "100%",
+            }, children: [post.hero_image_url ? (
+                // eslint-disable-next-line @next/next/no-img-element
+                _jsx("img", { src: post.hero_image_url, alt: "", loading: "lazy", style: {
+                        width: "100%",
+                        aspectRatio: "16 / 9",
+                        objectFit: "cover",
+                        display: "block",
+                    } })) : (_jsx("div", { style: {
+                        width: "100%",
+                        aspectRatio: "16 / 9",
+                        background: "#f3f4f6",
+                    } })), _jsxs("div", { style: {
+                        padding: "1.25rem",
+                        display: "flex",
+                        flexDirection: "column",
+                        gap: "0.5rem",
+                        flex: 1,
+                    }, children: [post.category ? (_jsx("span", { className: "risali-blog-card-category", style: {
+                                alignSelf: "flex-start",
+                                fontSize: "0.75rem",
+                                textTransform: "uppercase",
+                                letterSpacing: "0.05em",
+                                color: "#6b7280",
+                            }, children: post.category })) : null, _jsx("h2", { className: "risali-blog-card-title", style: {
+                                fontSize: "1.25rem",
+                                fontWeight: 600,
+                                lineHeight: 1.3,
+                                margin: 0,
+                            }, children: post.title }), post.excerpt ? (_jsx("p", { className: "risali-blog-card-excerpt", style: {
+                                color: "#4b5563",
+                                fontSize: "0.95rem",
+                                lineHeight: 1.5,
+                                margin: 0,
+                            }, children: post.excerpt })) : null, _jsxs("div", { style: {
+                                marginTop: "auto",
+                                paddingTop: "0.75rem",
+                                display: "flex",
+                                gap: "0.75rem",
+                                fontSize: "0.85rem",
+                                color: "#6b7280",
+                            }, children: [_jsx("span", { children: fmtDate(post.published_at) }), post.reading_minutes ? (_jsxs("span", { children: ["\u00B7 ", post.reading_minutes, " min \u010D\u00EDtania"] })) : null, post.author_display ? (_jsxs("span", { children: ["\u00B7 ", post.author_display] })) : null] })] })] }) }));
+}
+//# sourceMappingURL=blog-list.js.map

package/dist/blog-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-list.js","sourceRoot":"","sources":["../src/blog-list.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,kBAAkB,GAGnB,MAAM,WAAW,CAAC;AASnB,sEAAsE;AACtE,+DAA+D;AAC/D,oCAAoC;AACpC,SAAS,OAAO,CAAC,GAAkB;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE;QACnC,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;QACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,IAAI,KAAK,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QACtC,OAAO,CACL,cACE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,mBAAmB,EACjD,KAAK,EAAE,KAAK,CAAC,KAAK,YAElB,YAAG,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,yEAE1B,GACA,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,cACE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,kBAAkB,EAChD,KAAK,EAAE;YACL,OAAO,EAAE,MAAM;YACf,GAAG,EAAE,QAAQ;YACb,mBAAmB,EAAE,uCAAuC;YAC5D,GAAG,KAAK,CAAC,KAAK;SACf,YAEA,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,KAAC,QAAQ,IAAiB,IAAI,EAAE,IAAI,IAArB,IAAI,CAAC,IAAI,CAAgB,CACzC,CAAC,GACE,CACP,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,EAAE,IAAI,EAAgC;IACtD,OAAO,CACL,kBACE,SAAS,EAAC,kBAAkB,EAC5B,KAAK,EAAE;YACL,OAAO,EAAE,MAAM;YACf,aAAa,EAAE,QAAQ;YACvB,QAAQ,EAAE,QAAQ;YAClB,YAAY,EAAE,SAAS;YACvB,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE,4BAA4B;YACvC,MAAM,EAAE,mBAAmB;SAC5B,YAED,aACE,IAAI,EAAE,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC9C,SAAS,EAAC,uBAAuB,EACjC,KAAK,EAAE;gBACL,KAAK,EAAE,SAAS;gBAChB,cAAc,EAAE,MAAM;gBACtB,OAAO,EAAE,MAAM;gBACf,aAAa,EAAE,QAAQ;gBACvB,MAAM,EAAE,MAAM;aACf,aAEA,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;gBACrB,qDAAqD;gBACrD,cACE,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAC,EAAE,EACN,OAAO,EAAC,MAAM,EACd,KAAK,EAAE;wBACL,KAAK,EAAE,MAAM;wBACb,WAAW,EAAE,QAAQ;wBACrB,SAAS,EAAE,OAAO;wBAClB,OAAO,EAAE,OAAO;qBACjB,GACD,CACH,CAAC,CAAC,CAAC,CACF,cACE,KAAK,EAAE;wBACL,KAAK,EAAE,MAAM;wBACb,WAAW,EAAE,QAAQ;wBACrB,UAAU,EAAE,SAAS;qBACtB,GACD,CACH,EACD,eACE,KAAK,EAAE;wBACL,OAAO,EAAE,SAAS;wBAClB,OAAO,EAAE,MAAM;wBACf,aAAa,EAAE,QAAQ;wBACvB,GAAG,EAAE,QAAQ;wBACb,IAAI,EAAE,CAAC;qBACR,aAEA,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CACf,eACE,SAAS,EAAC,2BAA2B,EACrC,KAAK,EAAE;gCACL,SAAS,EAAE,YAAY;gCACvB,QAAQ,EAAE,SAAS;gCACnB,aAAa,EAAE,WAAW;gCAC1B,aAAa,EAAE,QAAQ;gCACvB,KAAK,EAAE,SAAS;6BACjB,YAEA,IAAI,CAAC,QAAQ,GACT,CACR,CAAC,CAAC,CAAC,IAAI,EACR,aACE,SAAS,EAAC,wBAAwB,EAClC,KAAK,EAAE;gCACL,QAAQ,EAAE,SAAS;gCACnB,UAAU,EAAE,GAAG;gCACf,UAAU,EAAE,GAAG;gCACf,MAAM,EAAE,CAAC;6BACV,YAEA,IAAI,CAAC,KAAK,GACR,EACJ,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CACd,YACE,SAAS,EAAC,0BAA0B,EACpC,KAAK,EAAE;gCACL,KAAK,EAAE,SAAS;gCAChB,QAAQ,EAAE,SAAS;gCACnB,UAAU,EAAE,GAAG;gCACf,MAAM,EAAE,CAAC;6BACV,YAEA,IAAI,CAAC,OAAO,GACX,CACL,CAAC,CAAC,CAAC,IAAI,EACR,eACE,KAAK,EAAE;gCACL,SAAS,EAAE,MAAM;gCACjB,UAAU,EAAE,SAAS;gCACrB,OAAO,EAAE,MAAM;gCACf,GAAG,EAAE,SAAS;gCACd,QAAQ,EAAE,SAAS;gCACnB,KAAK,EAAE,SAAS;6BACjB,aAED,yBAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,GAAQ,EACxC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CACtB,sCAAS,IAAI,CAAC,eAAe,8BAAoB,CAClD,CAAC,CAAC,CAAC,IAAI,EACP,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CACrB,sCAAS,IAAI,CAAC,cAAc,IAAQ,CACrC,CAAC,CAAC,CAAC,IAAI,IACJ,IACF,IACJ,GACI,CACX,CAAC;AACJ,CAAC"}

package/dist/blog-post.d.ts

@@ -0,0 +1,40 @@
+import type { CSSProperties } from "react";
+import { type GetBlogPostOptions } from "./blog.js";
+export type RisaliBlogPostProps = GetBlogPostOptions & {
+    /** Required: the post slug from the route segment. */
+    slug: string;
+    /** Fallback to render when the post isn't available. */
+    fallback?: React.ReactNode;
+    /**
+     * Origin of the client web (https://klient.sk). When supplied
+     * together with `siteName`, the component emits a `BlogPosting`
+     * JSON-LD `<script>` tag for SEO rich results.
+     */
+    origin?: string;
+    /** Site name — required for JSON-LD `publisher.name`. */
+    siteName?: string;
+    /** Optional publisher logo URL for JSON-LD. */
+    publisherLogoUrl?: string;
+    className?: string;
+    style?: CSSProperties;
+};
+/**
+ * Server component for a single blog post. Use it on the client web's
+ * `/blog/[slug]` route:
+ *
+ *     // app/blog/[slug]/page.tsx
+ *     import { RisaliBlogPost } from "@risali/react";
+ *     export default async function PostPage(
+ *       { params }: { params: Promise<{ slug: string }> },
+ *     ) {
+ *       const { slug } = await params;
+ *       return <RisaliBlogPost slug={slug} />;
+ *     }
+ *
+ * Returns the `fallback` prop (or a generic "not found" message) when
+ * the post isn't available. Renders the sanitised HTML via
+ * dangerouslySetInnerHTML — the API has already sanitised the payload
+ * server-side; we sanitise again here as defense-in-depth.
+ */
+export declare function RisaliBlogPost(props: RisaliBlogPostProps): Promise<import("react/jsx-runtime").JSX.Element>;
+//# sourceMappingURL=blog-post.d.ts.map

package/dist/blog-post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post.d.ts","sourceRoot":"","sources":["../src/blog-post.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAInB,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAaF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,oDAyI9D"}

package/dist/blog-post.js

@@ -0,0 +1,109 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getRisaliBlogPost, } from "./blog.js";
+import { sanitiseRichText } from "./sanitize.js";
+import { buildBlogPostJsonLd } from "./blog-jsonld.js";
+function fmtDate(iso) {
+    if (!iso)
+        return "";
+    const d = new Date(iso);
+    if (!Number.isFinite(d.getTime()))
+        return "";
+    return d.toLocaleDateString("sk-SK", {
+        day: "numeric",
+        month: "long",
+        year: "numeric",
+    });
+}
+/**
+ * Server component for a single blog post. Use it on the client web's
+ * `/blog/[slug]` route:
+ *
+ *     // app/blog/[slug]/page.tsx
+ *     import { RisaliBlogPost } from "@risali/react";
+ *     export default async function PostPage(
+ *       { params }: { params: Promise<{ slug: string }> },
+ *     ) {
+ *       const { slug } = await params;
+ *       return <RisaliBlogPost slug={slug} />;
+ *     }
+ *
+ * Returns the `fallback` prop (or a generic "not found" message) when
+ * the post isn't available. Renders the sanitised HTML via
+ * dangerouslySetInnerHTML — the API has already sanitised the payload
+ * server-side; we sanitise again here as defense-in-depth.
+ */
+export async function RisaliBlogPost(props) {
+    const post = await getRisaliBlogPost(props.slug, {
+        siteSlug: props.siteSlug,
+        previewToken: props.previewToken,
+    });
+    if (!post) {
+        if (props.fallback !== undefined)
+            return _jsx(_Fragment, { children: props.fallback });
+        return (_jsx("div", { className: props.className ?? "risali-blog-not-found", style: props.style, children: _jsx("p", { style: { color: "#6b7280" }, children: "Tento \u010Dl\u00E1nok sa nena\u0161iel." }) }));
+    }
+    const safeHtml = sanitiseRichText(post.content_html);
+    const jsonLd = props.origin && props.siteName
+        ? buildBlogPostJsonLd(post, {
+            origin: props.origin,
+            siteName: props.siteName,
+            publisherLogoUrl: props.publisherLogoUrl,
+        })
+        : null;
+    return (_jsxs("article", { className: props.className ?? "risali-blog-post", style: {
+            maxWidth: "780px",
+            margin: "0 auto",
+            ...props.style,
+        }, children: [jsonLd ? (_jsx("script", { type: "application/ld+json", 
+                // JSON.stringify is XSS-safe enough for JSON-LD; the
+                // payload contains only typed primitives from the
+                // sanitised post + caller-supplied origin/name. The HTML
+                // injection vector for JSON-LD is `</script>` inside a
+                // string — replace `<` so the parser can't close the tag
+                // early.
+                dangerouslySetInnerHTML: {
+                    __html: JSON.stringify(jsonLd).replace(/</g, "\\u003c"),
+                } })) : null, props.previewToken ? (_jsx("div", { className: "risali-blog-preview-banner", style: {
+                    background: "#fef3c7",
+                    color: "#854d0e",
+                    padding: "0.5rem 1rem",
+                    borderRadius: "0.5rem",
+                    marginBottom: "1rem",
+                    fontSize: "0.9rem",
+                    textAlign: "center",
+                }, children: "N\u00E1h\u013Ead \u2014 tento odkaz je platn\u00FD 15 min\u00FAt a uvid\u00ED\u0161 ho len ty." })) : null, post.hero_image_url ? (
+            // eslint-disable-next-line @next/next/no-img-element
+            _jsx("img", { src: post.hero_image_url, alt: "", loading: "eager", fetchPriority: "high", style: {
+                    width: "100%",
+                    aspectRatio: "16 / 9",
+                    objectFit: "cover",
+                    borderRadius: "0.75rem",
+                    marginBottom: "1.5rem",
+                } })) : null, post.category ? (_jsx("div", { className: "risali-blog-post-category", style: {
+                    fontSize: "0.85rem",
+                    textTransform: "uppercase",
+                    letterSpacing: "0.05em",
+                    color: "#6b7280",
+                    marginBottom: "0.5rem",
+                }, children: post.category })) : null, _jsx("h1", { className: "risali-blog-post-title", style: {
+                    fontSize: "2.25rem",
+                    fontWeight: 700,
+                    lineHeight: 1.2,
+                    margin: "0 0 1rem 0",
+                }, children: post.title }), _jsxs("div", { className: "risali-blog-post-meta", style: {
+                    display: "flex",
+                    gap: "0.75rem",
+                    fontSize: "0.9rem",
+                    color: "#6b7280",
+                    marginBottom: "2rem",
+                }, children: [post.author_display ? _jsx("span", { children: post.author_display }) : null, _jsx("span", { children: fmtDate(post.published_at) }), post.reading_minutes ? (_jsxs("span", { children: ["\u00B7 ", post.reading_minutes, " min \u010D\u00EDtania"] })) : null] }), _jsx("div", { className: "risali-blog-post-body", style: {
+                    fontSize: "1.05rem",
+                    lineHeight: 1.7,
+                    color: "#111827",
+                }, 
+                // Server-side sanitised HTML. The render-time sanitiseRichText
+                // run is a defense-in-depth second pass over what the API
+                // already cleaned at save time (PR 36a normalizer).
+                dangerouslySetInnerHTML: { __html: safeHtml } })] }));
+}
+//# sourceMappingURL=blog-post.js.map

package/dist/blog-post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post.js","sourceRoot":"","sources":["../src/blog-post.tsx"],"names":[],"mappings":"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"}

package/dist/blog.d.ts

@@ -0,0 +1,69 @@
+export type RisaliBlogPostCard = {
+    slug: string;
+    title: string;
+    excerpt: string | null;
+    hero_image_url: string | null;
+    category: string | null;
+    published_at: string;
+    author_display: string | null;
+    reading_minutes: number | null;
+};
+export type RisaliBlogPostSeo = {
+    title?: string;
+    description?: string;
+    og_image_url?: string;
+};
+export type RisaliBlogPost = {
+    slug: string;
+    title: string;
+    content_html: string;
+    excerpt: string | null;
+    hero_image_url: string | null;
+    category: string | null;
+    published_at: string;
+    updated_at: string;
+    author_display: string | null;
+    reading_minutes: number | null;
+    seo_meta: RisaliBlogPostSeo;
+};
+export type GetBlogPostsOptions = {
+    /** Override the resolved site slug (default: RISALI_SITE_SLUG env). */
+    siteSlug?: string;
+    /** Filter by single free-text category. */
+    category?: string;
+    /** Page size (1..50, default 12). */
+    limit?: number;
+    /** Pagination offset (default 0). */
+    offset?: number;
+};
+export type GetBlogPostOptions = {
+    /** Override the resolved site slug. */
+    siteSlug?: string;
+    /**
+     * Optional preview token from the dashboard "Preview" button. When
+     * supplied, the fetch hits the preview path which bypasses
+     * `status='published'` and returns drafts + scheduled posts.
+     * Tokens expire 15 minutes after issuance.
+     */
+    previewToken?: string;
+};
+/**
+ * Fetch the published blog post list for the resolved site. Returns
+ * an empty array on any failure (unknown site, plan downgrade,
+ * network) so the consumer can fall back to an empty grid without
+ * dropping the whole page.
+ */
+export declare function getRisaliBlogPosts(opts?: GetBlogPostsOptions): Promise<RisaliBlogPostCard[]>;
+/**
+ * Fetch a single blog post by slug. Returns null on any failure so
+ * the consumer can render a notFound() page instead of throwing.
+ * When `previewToken` is supplied, the call goes through the
+ * preview path (no cache, drafts allowed).
+ */
+export declare function getRisaliBlogPost(postSlug: string, opts?: GetBlogPostOptions): Promise<RisaliBlogPost | null>;
+/**
+ * Build a public `/blog/<slug>` URL for the client web. Helper for
+ * hand-rolled card grids that don't use `<RisaliBlogList />`.
+ */
+export declare function buildBlogPostHref(postSlug: string): string;
+//# sourceMappingURL=blog.d.ts.map

package/dist/blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAqB/B;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA2BhC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D"}