barakopress 0.2.0 → 0.3.0

package/dist/screens/post-view.js

@@ -1,19 +1,186 @@
-import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import Link from "next/link";
 import { formatDate } from "../cms.js";
 import { renderMarkdown } from "../markdown.js";
+import { initials, readingMinutes } from "../reading-time.js";
+import { proseCss, relatedCss } from "../theme.js";
 /*
- * The rendering, shared by the static screen and the preview screen.
+ * The post page, shared by the static screen and the preview screen.
  *
  * It is its own component because reading `searchParams` forces a route to render dynamically,
  * and a site built with `output: "export"` is refused outright for it. Preview needs the query
  * string; a published post does not. Splitting the fetch from the render is what lets one set of
  * markup serve a static site and a server-rendered one.
  *
- * Every link is built from `config.routes`, so a site that mounts posts at /writing gets /writing
- * links here, in the feed and in the sitemap, instead of three files disagreeing.
+ * Every link is built from `config.routes`, and every colour, face and radius from `config.theme`,
+ * so a site that mounts posts at /writing gets /writing links here and in the feed, and a site
+ * with its own palette gets its own palette without touching this file.
+ *
+ * The styles are inline rather than classes against `barakopress/styles.css`. That stylesheet is
+ * opt-in, barakocms.com never imported it, and the result was this screen rendering as an
+ * unstyled article at x=0 on a blank page, which is why that site stopped using the screen at all.
+ * A screen whose look depends on an import the consumer might not make is a screen that renders
+ * broken for somebody. The one exception is the rendered body, which is a string of HTML that
+ * inline styles cannot reach, so it gets a generated stylesheet built from the same tokens.
  */
-export function PostView({ config, post, preview = false, }) {
-    return (_jsxs("article", { children: [preview && (_jsx("div", { className: "notice preview-banner", children: "Preview. This is how the post will look. It is not published, and it is served uncached so nothing here reaches another reader." })), _jsx("p", { className: "meta", children: _jsx(Link, { href: "/", children: "Back" }) }), _jsx("h1", { children: post.title }), _jsxs("p", { className: "meta", children: [post.publishedAt && (_jsx("time", { dateTime: post.publishedAt, children: formatDate(config, post.publishedAt) })), post.author && config.routes.author && (_jsxs(_Fragment, { children: [" by ", _jsx(Link, { href: `${config.routes.author}/${post.author.slug}`, children: post.author.name })] })), post.author && !config.routes.author && _jsx(_Fragment, { children: ` by ${post.author.name}` }), post.category && config.routes.category && (_jsxs(_Fragment, { children: [" in ", _jsx(Link, { href: `${config.routes.category}/${post.category.slug}`, children: post.category.name })] }))] }), post.coverImage && (_jsx("img", { className: "cover", src: post.coverImage, alt: post.coverImageAlt ?? "" })), _jsx("div", { className: "prose", dangerouslySetInnerHTML: { __html: renderMarkdown(post.body) } }), post.tags.length > 0 && (_jsx("p", { className: "tags", children: post.tags.map((t) => (_jsx("span", { className: "tag", children: t }, t))) }))] }));
+/** Scopes the generated body stylesheet. Prefixed so it cannot collide with a consumer's own `.prose`. */
+const PROSE_CLASS = "bp-prose";
+/** Same reason as PROSE_CLASS: a hover rule needs a selector, and a style attribute has none. */
+const RELATED_CLASS = "bp-related-card";
+export function PostView({ config, post, preview = false, headerBackdrop, beforeBody, afterBody, related = [], }) {
+    const t = config.theme;
+    const c = t.colors;
+    const gutter = t.layout.gutter;
+    const backHref = config.routes.post || "/";
+    // "/writing" reads as WRITING. The route is the only thing that knows what the index is called,
+    // and asking for a label as well would be a second place to keep the same word.
+    const backLabel = backHref.split("/").filter(Boolean).pop() ?? "Home";
+    const minutes = readingMinutes(post.body);
+    const monogram = post.author ? initials(post.author.name) : "";
+    const band = { padding: `0 ${gutter}` };
+    const meta = { fontFamily: t.fonts.mono, fontSize: "12.5px", color: c.muted };
+    return (_jsxs("div", { style: { background: c.pageBg, color: c.ink, fontFamily: t.fonts.body }, children: [_jsx("style", { dangerouslySetInnerHTML: {
+                    __html: proseCss(t, PROSE_CLASS) + relatedCss(t, RELATED_CLASS),
+                } }), preview && (_jsx("div", { style: { ...band, paddingTop: "16px", background: c.surface }, children: _jsx("div", { style: {
+                        maxWidth: t.layout.prose,
+                        margin: "0 auto",
+                        padding: "14px 18px",
+                        borderRadius: t.radii.panel,
+                        background: c.accentTint,
+                        border: `1px solid ${c.accentTintBorder}`,
+                        color: c.accentInk,
+                        fontSize: "14px",
+                        lineHeight: 1.6,
+                    }, children: "Preview. This is how the post will look. It is not published, and it is served uncached so nothing here reaches another reader." }) })), _jsxs("header", { style: {
+                    ...band,
+                    paddingTop: "64px",
+                    paddingBottom: "56px",
+                    background: c.surface,
+                    borderBottom: `1px solid ${c.hairline}`,
+                    position: "relative",
+                    overflow: "hidden",
+                }, children: [headerBackdrop && (_jsx("div", { style: { position: "absolute", inset: 0, pointerEvents: "none" }, "aria-hidden": true, children: headerBackdrop })), _jsxs("div", { style: { maxWidth: t.layout.prose, margin: "0 auto", position: "relative" }, children: [_jsxs(Link, { href: backHref, style: {
+                                    display: "inline-flex",
+                                    alignItems: "center",
+                                    gap: "8px",
+                                    fontFamily: t.fonts.mono,
+                                    fontSize: "11.5px",
+                                    letterSpacing: ".14em",
+                                    textTransform: "uppercase",
+                                    color: c.muted,
+                                }, children: [_jsx("svg", { viewBox: "0 0 16 16", width: "12", height: "12", fill: "currentColor", "aria-hidden": true, children: _jsx("path", { d: "M7.2 2.3 1.5 8l5.7 5.7 1.1-1.1L4.7 8.8H14.5V7.2H4.7l3.6-3.8z" }) }), backLabel] }), _jsx("h1", { style: {
+                                    margin: "22px 0 0",
+                                    fontFamily: t.fonts.heading,
+                                    fontWeight: 600,
+                                    fontSize: "clamp(34px, 4.6vw, 58px)",
+                                    lineHeight: 1.06,
+                                    letterSpacing: "-.038em",
+                                    color: c.ink,
+                                    textWrap: "balance",
+                                }, children: post.title }), post.excerpt && (_jsx("p", { style: {
+                                    margin: "24px 0 0",
+                                    maxWidth: "60ch",
+                                    fontSize: "19.5px",
+                                    lineHeight: 1.6,
+                                    color: c.secondaryInk,
+                                    textWrap: "pretty",
+                                }, children: post.excerpt })), _jsxs("div", { style: {
+                                    marginTop: "30px",
+                                    display: "flex",
+                                    flexWrap: "wrap",
+                                    alignItems: "center",
+                                    gap: "10px 26px",
+                                    fontSize: "14px",
+                                    color: c.muted,
+                                }, children: [post.author && (_jsxs("span", { style: { display: "flex", alignItems: "center", gap: "9px" }, children: [_jsx("span", { "aria-hidden": true, style: {
+                                                    width: "28px",
+                                                    height: "28px",
+                                                    flexShrink: 0,
+                                                    borderRadius: t.radii.pill,
+                                                    background: c.accentTint,
+                                                    color: c.accentInk,
+                                                    display: "flex",
+                                                    alignItems: "center",
+                                                    justifyContent: "center",
+                                                    fontFamily: t.fonts.heading,
+                                                    fontSize: "12px",
+                                                    fontWeight: 600,
+                                                }, children: monogram }), "by", " ", config.routes.author ? (_jsx(Link, { href: `${config.routes.author}/${post.author.slug}`, style: { color: c.ink, fontWeight: 600 }, children: post.author.name })) : (_jsx("span", { style: { color: c.ink, fontWeight: 600 }, children: post.author.name }))] })), post.publishedAt && (_jsx("time", { dateTime: post.publishedAt, style: meta, children: formatDate(config, post.publishedAt) })), _jsxs("span", { style: meta, children: [minutes, " min read"] }), post.category && config.routes.category && (_jsx(Link, { href: `${config.routes.category}/${post.category.slug}`, style: meta, children: post.category.name })), post.tags.map((tag) => (_jsx("span", { style: {
+                                            display: "inline-flex",
+                                            alignItems: "center",
+                                            padding: "5px 11px",
+                                            borderRadius: t.radii.pill,
+                                            background: c.accentTint,
+                                            color: c.accentInk,
+                                            fontFamily: t.fonts.mono,
+                                            fontSize: "11px",
+                                            letterSpacing: ".1em",
+                                            textTransform: "uppercase",
+                                        }, children: tag }, tag)))] })] })] }), beforeBody && (_jsx("section", { style: { ...band, paddingTop: "56px", paddingBottom: "8px" }, children: _jsx("div", { style: { maxWidth: t.layout.wide, margin: "0 auto" }, children: beforeBody }) })), _jsx("article", { style: { ...band, paddingTop: "48px", paddingBottom: "72px" }, children: _jsxs("div", { style: { maxWidth: t.layout.prose, margin: "0 auto" }, children: [post.coverImage && (_jsx("img", { src: post.coverImage, alt: post.coverImageAlt ?? "", style: {
+                                width: "100%",
+                                marginBottom: "36px",
+                                borderRadius: t.radii.panel,
+                                border: `1px solid ${c.hairline}`,
+                            } })), _jsx("div", { className: PROSE_CLASS, dangerouslySetInnerHTML: { __html: renderMarkdown(post.body) } }), afterBody] }) }), related.length > 0 && (_jsx("section", { style: {
+                    ...band,
+                    paddingTop: "52px",
+                    paddingBottom: "60px",
+                    background: c.surface,
+                    borderTop: `1px solid ${c.hairline}`,
+                }, children: _jsxs("div", { style: { maxWidth: t.layout.wide, margin: "0 auto" }, children: [_jsxs("div", { style: {
+                                display: "flex",
+                                flexWrap: "wrap",
+                                alignItems: "baseline",
+                                gap: "12px",
+                            }, children: [_jsx("h2", { style: {
+                                        margin: 0,
+                                        fontFamily: t.fonts.heading,
+                                        fontSize: "24px",
+                                        fontWeight: 600,
+                                        letterSpacing: "-.025em",
+                                        color: c.ink,
+                                    }, children: "Related" }), _jsx("span", { style: {
+                                        fontFamily: t.fonts.mono,
+                                        fontSize: "11.5px",
+                                        color: c.muted,
+                                    }, children: "cosine similarity, computed on load, not curated" })] }), _jsx("div", { style: {
+                                marginTop: "20px",
+                                display: "grid",
+                                gridTemplateColumns: "repeat(auto-fit, minmax(min(260px, 100%), 1fr))",
+                                gap: "14px",
+                            }, children: related.map((r) => (_jsxs(Link, { href: `${config.routes.post}/${r.slug}`, className: RELATED_CLASS, style: {
+                                    display: "flex",
+                                    flexDirection: "column",
+                                    gap: "10px",
+                                    minWidth: 0,
+                                    padding: "20px",
+                                    borderRadius: t.radii.panel,
+                                    border: `1px solid ${c.hairline}`,
+                                    background: c.pageBg,
+                                }, children: [_jsxs("span", { style: {
+                                            display: "flex",
+                                            alignItems: "center",
+                                            gap: "10px",
+                                            fontFamily: t.fonts.mono,
+                                            fontSize: "11px",
+                                            color: c.muted,
+                                        }, children: [_jsx("span", { style: {
+                                                    padding: "3px 8px",
+                                                    borderRadius: t.radii.pill,
+                                                    background: c.accentTint,
+                                                    color: c.accentInk,
+                                                    fontVariantNumeric: "tabular-nums",
+                                                }, children: r.score.toFixed(4) }), r.publishedAt && formatDate(config, r.publishedAt)] }), _jsx("span", { style: {
+                                            fontFamily: t.fonts.heading,
+                                            fontSize: "17px",
+                                            fontWeight: 600,
+                                            lineHeight: 1.3,
+                                            letterSpacing: "-.02em",
+                                            color: c.ink,
+                                        }, children: r.title }), r.excerpt && (_jsx("span", { style: {
+                                            fontSize: "14px",
+                                            lineHeight: 1.6,
+                                            color: c.secondaryInk,
+                                        }, children: r.excerpt }))] }, r.slug))) })] }) }))] }));
 }
 //# sourceMappingURL=post-view.js.map

package/dist/screens/post-view.js.map

@@ -1 +1 @@
-{"version":3,"file":"post-view.js","sourceRoot":"","sources":["../../src/screens/post-view.tsx"],"names":[],"mappings":";AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAa,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,EACrB,MAAM,EACN,IAAI,EACJ,OAAO,GAAG,KAAK,GAKlB;IACG,OAAO,CACH,8BACK,OAAO,IAAI,CACR,cAAK,SAAS,EAAC,uBAAuB,gJAGhC,CACT,EAED,YAAG,SAAS,EAAC,MAAM,YACf,KAAC,IAAI,IAAC,IAAI,EAAC,GAAG,qBAAY,GAC1B,EAEJ,uBAAK,IAAI,CAAC,KAAK,GAAM,EAErB,aAAG,SAAS,EAAC,MAAM,aACd,IAAI,CAAC,WAAW,IAAI,CACjB,eAAM,QAAQ,EAAE,IAAI,CAAC,WAAW,YAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,GAAQ,CAClF,EACA,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CACpC,8BACK,MAAM,EACP,KAAC,IAAI,IAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,YACpD,IAAI,CAAC,MAAM,CAAC,IAAI,GACd,IACR,CACN,EACA,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,4BAAG,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAI,EACxE,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,CACxC,8BACK,MAAM,EACP,KAAC,IAAI,IAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YACxD,IAAI,CAAC,QAAQ,CAAC,IAAI,GAChB,IACR,CACN,IACD,EAEH,IAAI,CAAC,UAAU,IAAI,CAIhB,cAAK,SAAS,EAAC,OAAO,EAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE,GAAI,CACjF,EAED,cAAK,SAAS,EAAC,OAAO,EAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,GAAI,EAExF,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CACrB,YAAG,SAAS,EAAC,MAAM,YACd,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAClB,eAAc,SAAS,EAAC,KAAK,YACxB,CAAC,IADK,CAAC,CAEL,CACV,CAAC,GACF,CACP,IACK,CACb,CAAC;AACN,CAAC"}
+{"version":3,"file":"post-view.js","sourceRoot":"","sources":["../../src/screens/post-view.tsx"],"names":[],"mappings":"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"}

package/dist/theme.d.ts

@@ -0,0 +1,68 @@
+export interface ThemeColors {
+    /** The page behind the bands. */
+    pageBg: string;
+    /** Cards, panels, and the bands that sit above the page. */
+    surface: string;
+    /** Headings and anything that has to read as primary. */
+    ink: string;
+    /** Body copy in the prose column, which is deliberately lighter than a heading. */
+    proseInk: string;
+    /** Supporting copy outside the prose column. */
+    secondaryInk: string;
+    /** Meta: dates, labels, captions. */
+    muted: string;
+    hairline: string;
+    accent: string;
+    accentHover: string;
+    /** Accent dark enough to carry small text on the tint. */
+    accentInk: string;
+    accentTint: string;
+    accentTintBorder: string;
+    accentTintBorderStrong: string;
+    /** Code panels and the footer band. */
+    darkPanel: string;
+    /** Controls sitting on the dark panel. */
+    darkPanelChrome: string;
+    darkPanelInk: string;
+    darkPanelAccent: string;
+    codeGreen: string;
+    success: string;
+}
+export interface ThemeFonts {
+    /** Headings and the wordmark. */
+    heading: string;
+    /** Body and UI. */
+    body: string;
+    /** Code, meta and labels. The distinction is load bearing: every machine-produced value is mono. */
+    mono: string;
+}
+export interface ThemeRadii {
+    panel: string;
+    control: string;
+    pill: string;
+}
+export interface ThemeLayout {
+    /** The reading column. */
+    prose: string;
+    /** Bands that deliberately break out of the reading column. */
+    wide: string;
+    /** Side padding on every band. */
+    gutter: string;
+}
+export interface PressTheme {
+    colors: ThemeColors;
+    fonts: ThemeFonts;
+    radii: ThemeRadii;
+    layout: ThemeLayout;
+}
+export type PressThemeInput = {
+    colors?: Partial<ThemeColors>;
+    fonts?: Partial<ThemeFonts>;
+    radii?: Partial<ThemeRadii>;
+    layout?: Partial<ThemeLayout>;
+};
+export declare const DEFAULT_THEME: PressTheme;
+export declare function resolveTheme(input: PressThemeInput | undefined): PressTheme;
+export declare function proseCss(theme: PressTheme, scope: string): string;
+export declare function relatedCss(theme: PressTheme, scope: string): string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,WAAW;IACxB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,oGAAoG;IACpG,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IACxB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,UAqC3B,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,UAAU,CAO3E;AAgBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiCjE;AAUD,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnE"}

package/dist/theme.js

@@ -0,0 +1,128 @@
+/*
+ * What the post page looks like, as configuration.
+ *
+ * The seam in config.ts covers data: which type holds posts, what the fields are called, where the
+ * routes are mounted. It says nothing about appearance, and that gap is why barakocms.com does not
+ * use `PostView` at all. It reimplemented the whole page inline, because the screen came with a
+ * stylesheet the site never imports and rendered on a blank page. The second consumer would have
+ * done the same, and two forks of a screen is the thing this package exists to prevent.
+ *
+ * So the look is tokens, and the screens style themselves from them inline. Inline rather than a
+ * stylesheet on purpose: `barakopress/styles.css` is opt-in, and a screen whose look depends on an
+ * import the consumer may not make is a screen that renders unstyled for somebody. Inline styles
+ * arrive with the markup and cannot be forgotten.
+ *
+ * The defaults are the barakoCMS palette, the same values styles.css carries, so a site that wants
+ * the house look passes nothing.
+ */
+export const DEFAULT_THEME = {
+    colors: {
+        pageBg: "#FAFAFC",
+        surface: "#FFFFFF",
+        ink: "#101223",
+        proseInk: "#2B2E45",
+        secondaryInk: "#4A4E66",
+        muted: "#63687D",
+        hairline: "#E7E8F1",
+        accent: "#5A46D6",
+        accentHover: "#4A38C0",
+        accentInk: "#4034A8",
+        accentTint: "#EEEBFD",
+        accentTintBorder: "#DED8FB",
+        accentTintBorderStrong: "#C9C1F5",
+        darkPanel: "#101223",
+        darkPanelChrome: "#2A2C45",
+        darkPanelInk: "#DED8FB",
+        darkPanelAccent: "#A99BF7",
+        codeGreen: "#7BE0C4",
+        success: "#0B7A6B",
+    },
+    fonts: {
+        heading: "'Sora', ui-sans-serif, system-ui, sans-serif",
+        body: "'Manrope', ui-sans-serif, system-ui, -apple-system, 'Segoe UI', sans-serif",
+        mono: "'JetBrains Mono', ui-monospace, 'SFMono-Regular', Menlo, monospace",
+    },
+    radii: {
+        panel: "14px",
+        control: "11px",
+        pill: "999px",
+    },
+    layout: {
+        prose: "780px",
+        wide: "1160px",
+        gutter: "40px",
+    },
+};
+export function resolveTheme(input) {
+    return {
+        colors: { ...DEFAULT_THEME.colors, ...input?.colors },
+        fonts: { ...DEFAULT_THEME.fonts, ...input?.fonts },
+        radii: { ...DEFAULT_THEME.radii, ...input?.radii },
+        layout: { ...DEFAULT_THEME.layout, ...input?.layout },
+    };
+}
+/*
+ * A rendered body is a string of HTML, so it is the one part of a screen inline styles cannot
+ * reach. This is the stylesheet for it, generated from the same tokens so the prose column and the
+ * markup around it cannot drift.
+ *
+ * Values are interpolated into CSS, and a token is a developer-supplied string rather than a
+ * constant, so they are stripped of the two characters that could close the element early. Nobody
+ * is expected to put a bracket in a colour; this is here so that a config that somehow carries one
+ * produces a broken rule instead of an injected tag.
+ */
+function css(value) {
+    return value.replace(/[<>]/g, "");
+}
+export function proseCss(theme, scope) {
+    const c = theme.colors;
+    const f = theme.fonts;
+    const s = `.${scope}`;
+    return [
+        `${s}{font-family:${css(f.body)};font-size:17.5px;line-height:1.75;color:${css(c.proseInk)};text-wrap:pretty}`,
+        `${s} > *:first-child{margin-top:0}`,
+        `${s} p{margin:18px 0 0}`,
+        `${s} h2{margin:56px 0 0;font-family:${css(f.heading)};font-weight:600;font-size:clamp(24px,2.8vw,32px);line-height:1.15;letter-spacing:-.03em;color:${css(c.ink)};text-wrap:balance}`,
+        `${s} h3{margin:38px 0 0;font-family:${css(f.heading)};font-weight:600;font-size:21px;line-height:1.25;letter-spacing:-.025em;color:${css(c.ink)}}`,
+        `${s} h4{margin:30px 0 0;font-family:${css(f.heading)};font-weight:600;font-size:17px;color:${css(c.ink)}}`,
+        `${s} ul,${s} ol{margin:18px 0 0;padding-left:1.4rem}`,
+        `${s} ul{list-style:disc}`,
+        `${s} ol{list-style:decimal}`,
+        `${s} li{margin:.5rem 0}`,
+        `${s} li > ul,${s} li > ol{margin:.4rem 0}`,
+        `${s} a{color:${css(c.accent)};font-weight:600;text-decoration:underline;text-underline-offset:2px}`,
+        `${s} a:hover{color:${css(c.accentHover)}}`,
+        `${s} strong{color:${css(c.ink)};font-weight:700}`,
+        // No background on inline code. The handoff calls for it, and a tinted chip inside a
+        // 17.5px line is the thing that makes body copy look like documentation.
+        `${s} code{font-family:${css(f.mono)};font-size:16px;color:${css(c.ink)}}`,
+        `${s} pre{margin:30px 0 0;padding:18px 16px;border-radius:${css(theme.radii.panel)};background:${css(c.darkPanel)};color:${css(c.darkPanelInk)};font-family:${css(f.mono)};font-size:13.5px;line-height:1.85;overflow-x:auto}`,
+        `${s} pre code{font-size:inherit;color:inherit}`,
+        `${s} blockquote{margin:24px 0 0;padding:2px 0 2px 18px;border-left:2px solid ${css(c.accentTintBorder)};color:${css(c.secondaryInk)}}`,
+        `${s} img{max-width:100%;height:auto;border-radius:${css(theme.radii.panel)};border:1px solid ${css(c.hairline)}}`,
+        `${s} hr{margin:40px 0 0;border:0;border-top:1px solid ${css(c.hairline)}}`,
+        // Its own scroller, so a wide table cannot make the page scroll sideways.
+        `${s} table{display:block;overflow-x:auto;width:100%;margin:24px 0 0;border-collapse:collapse;font-size:14.5px}`,
+        `${s} th,${s} td{border:1px solid ${css(c.hairline)};padding:.55rem .75rem;text-align:left;vertical-align:top}`,
+        `${s} th{background:${css(c.pageBg)};color:${css(c.ink)};font-weight:700;white-space:nowrap}`,
+    ].join("");
+}
+/*
+ * Hover and focus for the related cards.
+ *
+ * These cannot be inline: a style attribute has no `:hover`, no `:focus-visible` and no media
+ * query. It is the same generated-from-tokens trick the prose stylesheet uses, for the same
+ * reason, and it stays small on purpose. The handoff's motion contract is deliberately minimal,
+ * and the lift is the only movement on this part of the page.
+ */
+export function relatedCss(theme, scope) {
+    const c = theme.colors;
+    const s = `.${scope}`;
+    return [
+        `${s}{transition:border-color .2s ease,transform .2s ease}`,
+        `${s}:hover{border-color:${css(c.accent)};transform:translateY(-2px)}`,
+        `${s}:focus-visible{outline:2px solid ${css(c.accent)};outline-offset:2px}`,
+        `@media (prefers-reduced-motion: reduce){${s}{transition:none}${s}:hover{transform:none}}`,
+    ].join("");
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "barakopress",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "A configurable blog engine for barakoCMS: Next.js server components, cached until the CMS says otherwise.",
   "license": "MIT",
   "author": "Arnel Robles",
@@ -18,6 +18,8 @@
   "files": [
     "dist",
     "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
     "README.md",
     "LICENSE"
   ],

package/src/config.ts

@@ -14,6 +14,8 @@
  * `createBlogIndex(config)` and exports the result. One import, one call, full control.
  */
 
+import { resolveTheme, type PressTheme, type PressThemeInput } from "./theme.js";
+
 export interface TypeNames {
     /** The content type holding posts. */
     post: string;
@@ -84,6 +86,8 @@ export interface PressConfig {
     cmsUrl: string;
     /** Tenant slug, for a multi-tenant deployment. */
     tenant?: string;
+    /** What the screens look like. See theme.ts for why appearance is config and not a stylesheet. */
+    theme: PressTheme;
 }
 
 export type PressConfigInput = {
@@ -92,7 +96,13 @@ export type PressConfigInput = {
     routes?: Partial<RouteMap>;
     site?: Partial<SiteIdentity>;
     pageSizes?: Partial<PageSizes>;
-} & Partial<Omit<PressConfig, "types" | "fields" | "routes" | "site" | "pageSizes">>;
+    /*
+     * Nested partials, so a site overriding one colour keeps the other seventeen. A flat
+     * Partial<PressTheme> would take the whole colours object or none of it, which in practice
+     * means every consumer pastes the full palette to change an accent.
+     */
+    theme?: PressThemeInput;
+} & Partial<Omit<PressConfig, "types" | "fields" | "routes" | "site" | "pageSizes" | "theme">>;
 
 /** The `blog` blueprint, which is what `POST /api/content-types/blueprints/blog` creates. */
 const BLOG_BLUEPRINT: Pick<PressConfig, "types" | "fields"> = {
@@ -140,6 +150,7 @@ export function defineConfig(input: PressConfigInput & { site: SiteIdentity }):
         locale: input.locale ?? "en-GB",
         cmsUrl: trimSlash(input.cmsUrl ?? process.env.CMS_URL ?? "http://localhost:5005"),
         tenant: input.tenant ?? process.env.CMS_TENANT ?? undefined,
+        theme: resolveTheme(input.theme),
     };
 }
 

package/src/delivery.ts

@@ -132,3 +132,56 @@ export async function bySlugPreview(
         `/api/public/${encodeURIComponent(type)}/${encodeURIComponent(slug)}?preview=${encodeURIComponent(token)}`,
     );
 }
+
+/*
+ * Semantic search, from the optional BarakoCMS.AI module.
+ *
+ * Optional is the whole design constraint. A CMS without the module answers 404 on this route, a
+ * type that is not publicly deliverable answers 404, and a module installed but not enabled
+ * answers 200 with an empty list, because it ships inert until `Ai:Enabled`. All three are normal
+ * and none of them is an error, so this returns an empty list for every one of them rather than
+ * throwing. A post page must not fail because a module the site never installed is not there.
+ */
+export interface SemanticHit {
+    contentType: string;
+    /** Nullable in the API. A hit with no slug is not linkable, so callers drop it. */
+    slug?: string;
+    title: string;
+    /** Cosine similarity, rounded to 4 decimals by the API. Anything under 0.4 is already dropped. */
+    score: number;
+}
+
+export interface SemanticResponse {
+    results: SemanticHit[];
+    count: number;
+    query: string;
+}
+
+/** The API clamps this itself. It is repeated here so a caller asking for 50 sends a legal request. */
+const MAX_SEMANTIC_LIMIT = 20;
+
+export async function semantic(
+    config: PressConfig,
+    type: string,
+    query: string,
+    limit: number,
+): Promise<SemanticHit[]> {
+    const q = query.trim();
+    // The API answers empty under two characters. Not spending a request to be told that.
+    if (q.length < 2) return [];
+
+    const params = new URLSearchParams({
+        q,
+        limit: String(Math.max(1, Math.min(limit, MAX_SEMANTIC_LIMIT))),
+    });
+
+    try {
+        const res = await get<SemanticResponse>(
+            config,
+            `/api/public/${encodeURIComponent(type)}/semantic?${params}`,
+        );
+        return Array.isArray(res.results) ? res.results : [];
+    } catch {
+        return [];
+    }
+}

package/src/index.ts

@@ -26,6 +26,16 @@
  */
 
 export { defineConfig, includesFor } from "./config.js";
+export { DEFAULT_THEME, resolveTheme, proseCss, relatedCss } from "./theme.js";
+export type {
+    PressTheme,
+    PressThemeInput,
+    ThemeColors,
+    ThemeFonts,
+    ThemeRadii,
+    ThemeLayout,
+} from "./theme.js";
+export { readingMinutes, initials } from "./reading-time.js";
 export type {
     PressConfig,
     PressConfigInput,
@@ -36,8 +46,18 @@ export type {
     SiteIdentity,
 } from "./config.js";
 
-export { list, bySlug, bySlugPreview } from "./delivery.js";
-export type { PublicContent, Seo, ListOptions, Paged } from "./delivery.js";
+export { list, bySlug, bySlugPreview, semantic } from "./delivery.js";
+export type {
+    PublicContent,
+    Seo,
+    ListOptions,
+    Paged,
+    SemanticHit,
+    SemanticResponse,
+} from "./delivery.js";
+
+export { listRelated, pickRelated } from "./related.js";
+export type { RelatedPost } from "./related.js";
 
 export {
     listPosts,
@@ -61,6 +81,7 @@ export {
 } from "./screens/blog-post.js";
 export { createArchive, createArchiveStaticParams } from "./screens/archive.js";
 export { PostView } from "./screens/post-view.js";
+export type { PostViewProps } from "./screens/post-view.js";
 
 export { createRevalidateRoute } from "./routes/revalidate.js";
 export type { RevalidateOptions } from "./routes/revalidate.js";