@xingwangzhe/stalux 1.46.2 → 1.47.0

package/README.md

@@ -142,6 +142,10 @@ The desktop tag cloud loads dynamically near the viewport. Switching to mobile,
 
 TypeScript uses ESNext. The theme defaults `vite.build.target` to `"esnext"` to retain modern syntax with minimal compatibility transforms; an explicit consumer target takes precedence. This targets modern browsers, does not polyfill missing Web APIs, and does not move ordinary scripts onto the GPU. Biome enforces `noVar` and `useConst` as errors in maintained source; dependencies and generated bundles are outside this source policy.
 
+### CJK search enhancement
+
+Builds generate both Pagefind and a sharded CJK substring index shared by the dialog and WebMCP. Titles, summaries, tags and categories are searchable. Optional post frontmatter `searchKeywords: [alias, abbreviation]` defaults to an empty array; keywords are published in HTML and static search files, so never put private information there. Unquoted Chinese, Japanese and Korean queries add verified contiguous substring matches, including single characters, NFKC normalization and space-separated terms. Title matches rank first; native results are retained and deduplicated. Quoted queries and active filters retain native Pagefind semantics. Automatic Traditional/Simplified conversion, pinyin, typo correction and semantic search are not included. Search files load on demand, failures fall back to Pagefind and can be retried, with no external search service or new telemetry.
+
 ### Initial CSS and search styles
 
 The theme defaults to Astro's `build.inlineStylesheets: "never"`: hashed shared CSS can be cached across routes, while component styles load on the pages that use them. Normal blocking stylesheets prevent an unstyled first paint. An explicit consumer setting of `build.inlineStylesheets: "always"` restores inline styles at the cost of larger HTML responses.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.46.2",
+    "version": "1.47.0",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",
@@ -91,7 +91,7 @@
         "knip": "knip",
         "verify:build": "node scripts/verify-build.ts",
         "validate": "bun run styles:build && bun run check && bun run node:check && bun run astro:check && bun run knip && bun run test:coverage && bun run build && bun run build:cli",
-        "prepare": "git config core.hooksPath scripts/git-hooks",
+        "prepare": "sh -c 'if [ -d scripts/git-hooks ] && git rev-parse --git-dir >/dev/null 2>&1; then git config core.hooksPath scripts/git-hooks; fi'",
         "dev:debug": "STALUX_DEBUG=1 astro dev --verbose",
         "build:debug": "STALUX_DEBUG=1 astro build --timings --verbose && node scripts/verify-build.ts",
         "styles:build": "node scripts/build-styles.ts && node scripts/build-style-names.ts",
@@ -145,6 +145,7 @@
         "@unocss/astro": "^66.11.0",
         "@vitest/coverage-v8": "^5.0.4",
         "astro": "^7.4.2",
+        "happy-dom": "^21.0.4",
         "knip": "^6.41.0",
         "sharp": "0.35.5",
         "sonda": "^0.14.0",

package/src/components/stalux/archives/archivesList.astro

@@ -56,7 +56,7 @@ const archiveYears = [...archivesByYearMonth.entries()]
     }));
 ---
 
-<section class="stalux-archive-container" data-stalux-motion-content>
+<section class="stalux-archive-container" data-stalux-motion-content data-stalux-motion-stage>
     <div class="stalux-archive-page-header">
         <div class="stalux-archive-timeline-container">
             {archiveYears.length > 0 ? (

package/src/components/stalux/categories/categoriesList.astro

@@ -7,7 +7,12 @@ import { getCategoryCountList } from "@utils/collections-stats";
 const categoryList = await getCategoryCountList(Astro.logger);
 ---
 
-<ul class="stalux-categories" data-stalux-motion-content data-stalux-reveal>
+<ul
+    class="stalux-categories"
+    data-stalux-motion-content
+    data-stalux-motion-stage
+    data-stalux-reveal
+>
     {categoryList.map((category) => (
         <li data-stalux-reveal-item>
             <CategoriesCard category={category} />

package/src/components/stalux/common/Weather.astro

@@ -31,7 +31,7 @@ const zh = (site.lang || "zh-CN").startsWith("zh");
                 {zh ? "访客 IP 与位置加载中…" : "Loading visitor IP and location…"}
             </p>
         )}
-        <p class="stalux-weather-status" data-weather-status></p>
+        <p class="stalux-weather-status" data-weather-status />
         <button type="button" data-weather-retry hidden>
             {zh ? "重试" : "Retry"}
         </button>

package/src/components/stalux/common/date.astro

@@ -7,7 +7,7 @@
 (() => {
     const dateElement = document.querySelector('[data-ref="date"]');
     const timeElement = document.querySelector('[data-ref="time"]');
-    if (!dateElement || !timeElement) return;
+    if (!(dateElement && timeElement)) return;
     const now = new Date();
     const pad = (value) => String(value).padStart(2, "0");
     const lang = document.documentElement.lang || "zh-CN";

package/src/components/stalux/common/search.astro

@@ -2,8 +2,10 @@
 // Pagefind component-ui search modal.
 // Docs: https://pagefind.app/llms-component-ui.txt
 // data-pf-theme must be on a DIRECT parent wrapper of the component.
+import { sitePath } from "../../../utils/site-path";
 ---
 
 <div data-pf-theme="dark">
+    <pagefind-config bundle-path={sitePath("pagefind-enhanced/")}></pagefind-config>
     <pagefind-modal id="search"></pagefind-modal>
 </div>

package/src/components/stalux/footer/FooterBeian.astro

@@ -35,6 +35,8 @@ const showBeian = !!(icp || pubsec);
                 <img
                     src="https://beian.mps.gov.cn/img/logo01.dd7ff50e.png"
                     alt={t("footer.securityIcon")}
+                    width="15"
+                    height="15"
                 />
                 {pubsec}
             </a>

package/src/components/stalux/layout/head.astro

@@ -18,7 +18,7 @@ import {
 import { toMachineDateTime } from "@utils/semantic-time";
 import { buildSeoDocument, type SeoPageInput } from "@utils/seo-document";
 import { SEO } from "astro-seo";
-import packageJson from "../../../../package.json";
+import packageJson from "../../../../package.json" with { type: "json" };
 
 const configEntries = await getCollection("config");
 const siteConfig = getSiteData(configEntries);

package/src/components/stalux/links/linkList.astro

@@ -10,7 +10,7 @@ const linksConfig = getLinksData(configEntries);
 const links = linksConfig?.sites ?? [];
 ---
 
-<ul class="stalux-links" data-stalux-motion-content data-stalux-reveal>
+<ul class="stalux-links" data-stalux-motion-content data-stalux-motion-stage data-stalux-reveal>
     {links.map((link) => (
         <li class="stalux-link-list-item" data-stalux-reveal-item>
             <LinkCard link={link} />

package/src/components/stalux/posts/ArticleSummary.astro

@@ -16,7 +16,14 @@ const summary = description?.trim();
         aria-label={label}
     >
         <p class="stalux-article-summary-label">{label}</p>
-        <p class="stalux-article-summary-text">{summary}</p>
+        <p
+            class="stalux-article-summary-text"
+            data-pagefind-body
+            data-pagefind-weight="2"
+            data-stalux-search-description
+        >
+            {summary}
+        </p>
     </aside>
 )}
 

package/src/components/stalux/posts/postContent.astro

@@ -13,6 +13,7 @@ interface Props {
     postId?: string | number;
     title: string;
     description?: string;
+    searchKeywords?: string[];
     transitionName?: string;
     titleTransitionName?: string;
     transitionScope?: "article" | "about";
@@ -38,10 +39,19 @@ const exportMd = Boolean(promoteConfig?.export_md) && !isAboutPage;
 const mdSourceUrl = exportMd ? `${Astro.url.pathname.replace(/\/$/, "")}.md` : "";
 ---
 
-<article class="stalux-article" data-stalux-gallery={props.hasImage ? "true" : undefined}>
+<article
+    class="stalux-article"
+    data-stalux-motion-stage
+    data-stalux-gallery={props.hasImage ? "true" : undefined}
+>
     <!-- Article Header -->
     <header class="stalux-post-article-header" data-stalux-motion-region>
-        <h1 class="stalux-post-title" data-stalux-motion-focus>
+        <h1
+            class="stalux-post-title"
+            data-stalux-motion-focus
+            data-pagefind-body
+            data-pagefind-meta="title"
+        >
             {props.title}
         </h1>
         <div class="stalux-post-metadata">
@@ -107,6 +117,14 @@ const mdSourceUrl = exportMd ? `${Astro.url.pathname.replace(/\/$/, "")}.md` : "
         transitionName={`${transitionPrefix}-summary`}
     />
 
+    <span
+        hidden
+        data-pagefind-body
+        data-stalux-search-keywords
+        data-pagefind-index-attrs="data-search-keywords"
+        data-search-keywords={(props.searchKeywords ?? []).join(" ")}
+    ></span>
+
     <!-- Article Body -->
     <section
         class="stalux-post-body stalux-prose"

package/src/components/stalux/posts/postList.astro

@@ -11,7 +11,12 @@ const props = Astro.props as Props;
 const posts = props.posts ?? (await getCollection("posts", ({ data }) => !data.draft));
 ---
 
-<div data-stalux="postlist" class="stalux-post-list-container" data-stalux-motion-content>
+<div
+    data-stalux="postlist"
+    class="stalux-post-list-container"
+    data-stalux-motion-content
+    data-stalux-motion-stage
+>
     <ul class="post-list" data-stalux-reveal>
         {posts.map((post, index) => (
             <li data-stalux-reveal-item>

package/src/components/stalux/posts/postRight.astro

@@ -14,7 +14,14 @@ interface Props {
 const { headings = [], tags = [], categories = [] } = Astro.props;
 ---
 
-<aside class="stalux-sidebar-right" data-stalux-scroll-pane>
+<!--
+    The right column is a shell. Between two articles it keeps its node, its
+    scroll position and its frame; only the three article-specific lists inside
+    the slots are refreshed (see scripts/shell-hydration.ts). Rebuilding the whole
+    aside on every article change made the reader watch the sidebar disappear and
+    reflow, and it cost a full layout of the new article to do it.
+-->
+<aside class="stalux-sidebar-right" data-stalux-scroll-pane data-swup-persist="post-sidebar-right">
     <div
         class="stalux-sidebar-container"
         data-stalux-module="sidebar"
@@ -23,13 +30,13 @@ const { headings = [], tags = [], categories = [] } = Astro.props;
         <PostDate />
         <Weather />
     </div>
-    <div class="stalux-sidebar-container">
+    <div class="stalux-sidebar-container" data-stalux-shell-slot="toc">
         <PostToc headings={headings} />
     </div>
-    <div class="stalux-sidebar-container">
+    <div class="stalux-sidebar-container" data-stalux-shell-slot="tags">
         <PostTaxonomy kind="tag" items={tags} />
     </div>
-    <div class="stalux-sidebar-container">
+    <div class="stalux-sidebar-container" data-stalux-shell-slot="categories">
         <PostTaxonomy kind="category" items={categories} />
     </div>
 </aside>

package/src/components/stalux/words/wordList.astro

@@ -19,14 +19,17 @@ const sorted = [...entries].sort((a, b) => {
 });
 ---
 
-<ul class="stalux-word-list-list" data-stalux-motion-content data-stalux-reveal>
-    {sorted.map((entry) => {
-        return (
-            <li class="stalux-word-list-item" data-stalux-reveal-item>
-                <WordCard entry={entry} timezone={timezone} />
-            </li>
-        );
-    })}
+<ul
+    class="stalux-word-list-list"
+    data-stalux-motion-content
+    data-stalux-motion-stage
+    data-stalux-reveal
+>
+    {sorted.map((entry) => (
+        <li class="stalux-word-list-item" data-stalux-reveal-item>
+            <WordCard entry={entry} timezone={timezone} />
+        </li>
+    ))}
 </ul>
 
 <script src="../../../scripts/word-list.ts"></script>

package/src/index.ts

@@ -29,6 +29,7 @@ import { parse } from "parse5";
 import { parse as parseYaml } from "yaml";
 import type { StaluxOptions } from "./config";
 import { expressiveCode } from "./expressive-code";
+import { writeCjkSearchIndex } from "./internal/cjk-search-index";
 import { staluxComponentsAlias } from "./internal/components-plugin";
 import {
     clearPageFontSubsets,
@@ -126,6 +127,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
     // is served from the page-output cache still finds its file on disk.
     let coverCacheDir = "";
 
+    let searchBase = "/";
     let pageFontData: { fontBuffer: Buffer; outputDir: string; cacheDir: string } | undefined;
 
     const coreIntegration: AstroIntegration = {
@@ -140,6 +142,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 command,
                 logger,
             }) => {
+                searchBase = config.base;
                 const started = performance.now();
                 const isPluginMode = isPluginProject(config.root, new URL("../", import.meta.url));
                 const configLogger = logger.fork("stalux/config");
@@ -619,7 +622,9 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                     const pagefindStarted = performance.now();
 
                     try {
-                        const { index, errors } = await pagefindCreateIndex();
+                        const { index, errors } = await pagefindCreateIndex({
+                            includeCharacters: "+#._",
+                        });
 
                         if (!index) {
                             throw new Error(
@@ -627,15 +632,22 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                             );
                         }
 
-                        const { page_count } = await index.addDirectory({ path: outDir });
+                        const { page_count, errors: crawlErrors } = await index.addDirectory({
+                            path: outDir,
+                        });
+                        if (crawlErrors.length) throw new Error(crawlErrors.join("; "));
                         if (page_count === 0) {
                             throw new Error("Pagefind did not index any pages");
                         }
 
-                        const { outputPath } = await index.writeFiles({
+                        const { outputPath, errors: writeErrors } = await index.writeFiles({
                             outputPath: path.join(outDir, "pagefind"),
                         });
 
+                        if (writeErrors.length) throw new Error(writeErrors.join("; "));
+                        const cjkPages = await writeCjkSearchIndex(outDir, pageEntries, searchBase);
+                        logger.info(`CJK substring index: ${cjkPages} pages`);
+
                         logger.info(
                             `indexed ${page_count} pages → ${outputPath} (${(performance.now() - pagefindStarted).toFixed(1)}ms)`,
                         );
@@ -678,7 +690,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
             const postsDir = path.resolve(process.cwd(), contentDir, "posts");
             if (existsSync(postsDir)) {
                 for (const filename of readdirSync(postsDir)) {
-                    if (!filename.endsWith(".md") && !filename.endsWith(".mdx")) {
+                    if (!(filename.endsWith(".md") || filename.endsWith(".mdx"))) {
                         continue;
                     }
                     const source = readFileSync(path.join(postsDir, filename), "utf8");

package/src/internal/cjk-search-index.ts

@@ -0,0 +1,130 @@
+import { createHash } from "node:crypto";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { type DefaultTreeAdapterMap, parse } from "parse5";
+import { type CjkDocument, cjkGrams, gramShard, normalizeSearch } from "../utils/cjk-search";
+import { forEachBounded } from "./bounded-tasks";
+
+type Node = DefaultTreeAdapterMap["node"];
+const skipped = new Set(["script", "style", "template", "noscript", "nav", "footer", "form"]);
+const blocks = new Set([
+    "p",
+    "div",
+    "section",
+    "article",
+    "aside",
+    "li",
+    "br",
+    "pre",
+    "tr",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+]);
+const attr = (node: Node, name: string) =>
+    "attrs" in node ? node.attrs.find((item) => item.name === name)?.value : undefined;
+
+/** Extract only real indexed DOM, preserving adjacency across inline emphasis. */
+export function extractCjkDocument(html: string, url: string) {
+    const document = parse(html);
+    let language = "";
+    let title = "";
+    let documentTitle = "";
+    let description = "";
+    let keywords = "";
+    let hasBody = false;
+    const filters: Record<string, string[]> = {};
+    function text(node: Node): string {
+        if (
+            "tagName" in node &&
+            (skipped.has(node.tagName) || attr(node, "data-pagefind-ignore") !== undefined)
+        )
+            return "";
+        if ("value" in node) return node.value;
+        const body = "childNodes" in node ? node.childNodes.map(text).join("") : "";
+        return "tagName" in node && blocks.has(node.tagName) ? ` ${body} ` : body;
+    }
+    const parts: string[] = [];
+    function visit(node: Node, insideBody = false) {
+        if ("tagName" in node) {
+            if (skipped.has(node.tagName) || attr(node, "data-pagefind-ignore") !== undefined)
+                return;
+            if (node.tagName === "title") documentTitle = text(node).trim();
+            if (node.tagName === "html") language = attr(node, "lang") ?? "";
+            if (node.tagName === "h1" && !title) title = text(node).trim();
+            if (attr(node, "data-stalux-search-description") !== undefined)
+                description = text(node).trim();
+            if (attr(node, "data-stalux-search-keywords") !== undefined)
+                keywords = attr(node, "data-search-keywords") ?? "";
+            const filter = attr(node, "data-pagefind-filter");
+            if (filter) {
+                const match = /^([^[\]:]+)\[([^\]]+)\]$/u.exec(filter);
+                if (match) filters[match[1] as string] = [attr(node, match[2] as string) ?? ""];
+            }
+            const body = attr(node, "data-pagefind-body") !== undefined;
+            if (body) {
+                hasBody = true;
+                if (!insideBody) parts.push(text(node));
+                const attrs = attr(node, "data-pagefind-index-attrs")?.split(",") ?? [];
+                for (const name of attrs) parts.push(attr(node, name.trim()) ?? "");
+            }
+            insideBody ||= body;
+        }
+        if ("childNodes" in node) for (const child of node.childNodes) visit(child, insideBody);
+    }
+    visit(document);
+    if (!hasBody) return null;
+    const content = parts.join(" ").replace(/\s+/gu, " ").trim();
+    return {
+        url,
+        title: title || documentTitle || url,
+        description,
+        keywords,
+        language,
+        filters,
+        content,
+    };
+}
+
+/** Content-addressed shards prevent mixed old/new deployments and keep downloads query-specific. */
+export async function writeCjkSearchIndex(outDir: string, htmlFiles: string[], base: string) {
+    const directory = path.join(outDir, "pagefind", "cjk");
+    await mkdir(directory, { recursive: true });
+    async function asset(value: unknown) {
+        const json = JSON.stringify(value);
+        const hash = createHash("sha256").update(json).digest("hex").slice(0, 20);
+        const file = `${hash}.json`;
+        await writeFile(path.join(directory, file), json);
+        return file;
+    }
+    const extracted = new Map<string, NonNullable<ReturnType<typeof extractCjkDocument>>>();
+    await forEachBounded(htmlFiles, 6, async (file) => {
+        const html = await readFile(path.join(outDir, file), "utf8");
+        // Most output pages are archives/tags: don't parse pages without indexed sections.
+        if (!html.includes("data-pagefind-body")) return;
+        const url = `${base.replace(/\/$/u, "")}/${file.replace(/index\.html$/u, "")}`;
+        const record = extractCjkDocument(html, url);
+        if (record) extracted.set(file, record);
+    });
+    const documents: CjkDocument[] = [];
+    const postings: Record<string, Record<string, number[]>> = {};
+    for (const [, record] of [...extracted].sort(([a], [b]) => a.localeCompare(b))) {
+        const { content, ...meta } = record;
+        const id = documents.length;
+        documents.push({ ...meta, file: await asset({ content }) });
+        for (const gram of cjkGrams(normalizeSearch(content))) {
+            const key = gramShard(gram);
+            postings[key] ??= {};
+            const shard = postings[key];
+            shard[gram] ??= [];
+            shard[gram].push(id);
+        }
+    }
+    const shards: Record<string, string> = {};
+    for (const [key, value] of Object.entries(postings)) shards[key] = await asset(value);
+    await writeFile(path.join(directory, "manifest.json"), JSON.stringify({ documents, shards }));
+    return documents.length;
+}

package/src/internal/compact-styles.ts

@@ -80,7 +80,7 @@ function markupEdits(value: string, names: Names): Edit[] {
             if (["pre", "code", "script", "style"].includes(node.tagName)) return;
             for (const attr of node.attrs) {
                 const loc = node.sourceCodeLocation?.attrs?.[attr.name];
-                if (!loc || !["class", "style", "data-toc-active-class"].includes(attr.name))
+                if (!(loc && ["class", "style", "data-toc-active-class"].includes(attr.name)))
                     continue;
                 const raw = value.slice(loc.startOffset, loc.endOffset);
                 const offset = loc.startOffset + raw.indexOf("=") + 1;

package/src/internal/font-slices.ts

@@ -258,7 +258,7 @@ function isHiddenElement(attrs: Array<{ name: string; value: string }>): boolean
 const CONTROL_CHARACTER = /\p{C}/u;
 function addGlyphs(text: string, output: Set<string>): void {
     for (const char of text)
-        if (!output.has(char) && !CONTROL_CHARACTER.test(char)) output.add(char);
+        if (!(output.has(char) || CONTROL_CHARACTER.test(char))) output.add(char);
 }
 
 function collectBodyText(node: HtmlNode, output: Set<string>, skipSharedComponents = false): void {
@@ -410,7 +410,7 @@ function preparePageFont(
     excludedChars: ReadonlySet<string> = new Set(),
 ) {
     const body = findBody(document);
-    if (!body) return undefined;
+    if (!body) return;
 
     const glyphs = new Set<string>();
     addGlyphs(RESERVED_GLYPHS, glyphs);
@@ -425,7 +425,7 @@ function preparePageFont(
     const chars = [...glyphs].sort(
         (a, b) => (a.codePointAt(0) as number) - (b.codePointAt(0) as number),
     );
-    if (chars.length === 0) return undefined;
+    if (chars.length === 0) return;
 
     let prepared = preparedFonts.get(fontBuffer);
     if (!prepared) {

package/src/internal/page-output-cache.ts

@@ -59,14 +59,13 @@ export async function createPageOutputCache(
                 for (const [asset, expected] of record.assets) {
                     if ((await assetDigest(asset)) !== expected) return undefined;
                 }
-                if (record.font) {
-                    if (
-                        !/^page-[a-f\d]+\.woff2$/u.test(record.font.filename) ||
+                if (
+                    record.font &&
+                    (!/^page-[a-f\d]+\.woff2$/u.test(record.font.filename) ||
                         typeof record.font.sourcePath !== "string" ||
-                        !(await fs.stat(record.font.sourcePath)).isFile()
-                    )
-                        return undefined;
-                }
+                        !(await fs.stat(record.font.sourcePath)).isFile())
+                )
+                    return undefined;
                 return { html: record.html, font: record.font };
             } catch {
                 // Missing, truncated, or invalid cache entries are rebuilt from source.

package/src/internal/search-style.ts

@@ -1,4 +1,5 @@
 import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
 import type { Plugin } from "vite";
 
 const publicId = "virtual:stalux-search-style";
@@ -9,8 +10,23 @@ export function searchStylePlugin(development: boolean, base: string): Plugin {
     const stylesheet = createRequire(import.meta.url)
         .resolve("@pagefind/component-ui/css")
         .replaceAll("\\", "/");
+    let building = false;
     return {
         name: "stalux:search-style",
+        configResolved(config) {
+            building = config.command === "build";
+        },
+        buildStart() {
+            if (building && this.environment.name === "client")
+                this.emitFile({
+                    type: "chunk",
+                    id: fileURLToPath(
+                        new URL("../scripts/search-engine-entry.ts", import.meta.url),
+                    ),
+                    fileName: "pagefind-enhanced/pagefind.js",
+                    preserveSignature: "strict",
+                });
+        },
         configureServer(server) {
             // A linked package can be outside the consumer's workspace root.
             server.config.server.fs.allow.push(stylesheet);

package/src/internal/social-card-renderer.ts

@@ -87,7 +87,7 @@ async function loadCoverUncached(cover: string, paths: SocialCardPaths): Promise
         if (cachedStat && Date.now() - cachedStat.mtimeMs < 86_400_000)
             return readFile(remoteCache);
         const response = await fetch(url, { signal: AbortSignal.timeout(8000) });
-        if (!response.ok || !response.headers.get("content-type")?.startsWith("image/"))
+        if (!(response.ok && response.headers.get("content-type")?.startsWith("image/")))
             throw new Error(`cover returned HTTP ${response.status} or non-image content`);
         const chunks: Uint8Array[] = [];
         let size = 0;
@@ -100,8 +100,7 @@ async function loadCoverUncached(cover: string, paths: SocialCardPaths): Promise
         bytes = Buffer.concat(chunks);
         const dimensions = imageSize(bytes);
         if (
-            !dimensions.width ||
-            !dimensions.height ||
+            !(dimensions.width && dimensions.height) ||
             dimensions.width * dimensions.height > 32_000_000
         )
             throw new Error("invalid cover dimensions");
@@ -110,8 +109,7 @@ async function loadCoverUncached(cover: string, paths: SocialCardPaths): Promise
     }
     const dimensions = imageSize(bytes);
     if (
-        !dimensions.width ||
-        !dimensions.height ||
+        !(dimensions.width && dimensions.height) ||
         dimensions.width * dimensions.height > 32_000_000
     )
         throw new Error("invalid or oversized cover dimensions");

package/src/layouts/PostLayout.astro

@@ -14,6 +14,7 @@ import { buildWalineProps } from "@utils/waline";
 interface Props {
     title: string;
     description?: string;
+    searchKeywords?: string[];
     postId?: string | number;
     date?: string;
     updated?: string;
@@ -61,6 +62,7 @@ const walineConfig = walineSection?.serverURL
             postId={props.postId}
             title={props.title}
             description={props.description}
+            searchKeywords={[...tags, ...categories, ...(props.searchKeywords ?? [])]}
             titleTransitionName={props.postId === undefined
                 ? undefined
                 : getPostTitleTransitionName(props.postId)}

package/src/pages/og/[image].[format].ts

@@ -15,7 +15,7 @@ export async function getStaticPaths() {
     return posts
         .filter(
             (post) =>
-                !post.data["og:image"]?.trim() || !isSocialImageUrl(post.data["og:image"].trim()),
+                !(post.data["og:image"]?.trim() && isSocialImageUrl(post.data["og:image"].trim())),
         )
         .flatMap((post) => {
             const card = createSocialCardData(post.data, site, author);

package/src/pages/posts/[post].astro

@@ -75,6 +75,7 @@ export async function getStaticPaths() {
     <PostLayout
         title={props.post.data.title}
         description={autoDesc}
+        searchKeywords={props.post.data.searchKeywords ?? []}
         postId={props.post.data.abbrlink}
         date={props.post.data.date}
         updated={props.post.data.updated}

package/src/schemas/collections.ts

@@ -88,6 +88,7 @@ const postSchema = z.object({
     date: datetimeField("date"),
     updated: datetimeField("updated").optional(),
     draft: z.boolean().optional().default(false),
+    searchKeywords: z.array(z.string().trim().min(1)).optional(),
     tags: z.preprocess(
         (val) => (typeof val === "string" ? [val] : val),
         z.array(z.string()).optional(),