@xingwangzhe/stalux 1.7.9 → 1.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.7.9",
+    "version": "1.9.0",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",
@@ -25,6 +25,7 @@
     "files": [
         "src/index.ts",
         "src/config.ts",
+        "src/expressive-code.ts",
         "src/components/**/*.astro",
         "src/components/**/*.ts",
         "src/layouts/**/*.astro",
@@ -45,6 +46,7 @@
     "exports": {
         ".": "./src/index.ts",
         "./config": "./src/config.ts",
+        "./expressive-code": "./src/expressive-code.ts",
         "./schemas": "./src/schemas/config.ts",
         "./schemas/collections": "./src/schemas/collections.ts",
         "./components/*": "./src/components/*",

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

@@ -59,9 +59,9 @@ const mdSourceUrl = exportMd
                 )
             }
         </div>
-        {
-            <div class={style.pageStats}>
-                    {(props.readingTime || props.readingMinutes) && (
+            {
+                <div class={style.pageStats}>
+                    {(Boolean(props.readingTime) || (props.readingMinutes ?? 0) > 0) && (
                         <span class={style.readingTime}>
                             {t("post.readingTime")}{props.readingMinutes && props.readingMinutes > 0
                                 ? (props.readingMinutes < 1
@@ -70,7 +70,7 @@ const mdSourceUrl = exportMd
                                 : props.readingTime}
                         </span>
                     )}
-                    {props.wordCount && props.wordCount > 0 && (
+                    {(props.wordCount ?? 0) > 0 && (
                         <span class={style.wordCount}>
                             {t("post.wordCount")}{props.wordCount}
                         </span>

package/src/expressive-code.ts

@@ -0,0 +1,31 @@
+/**
+ * Stalux 封装的 Expressive Code 集成 —— 默认启用代码块行号。
+ *
+ * 插件模式下直接从包导入，无需单独安装 @expressive-code/plugin-line-numbers：
+ * ```js
+ * import { expressiveCode } from "@xingwangzhe/stalux";
+ *
+ * export default defineConfig({
+ *     integrations: [stalux({ contentDir: "stalux" }), expressiveCode({ themes: [...] })],
+ * });
+ * ```
+ *
+ * 行号插件是 Expressive Code 引擎级插件（必须通过 expressiveCode() 的 plugins 选项传入，
+ * 无法由 stalux 集成自动注入），因此这里把 pluginLineNumbers 与用户配置合并，
+ * 让行号成为默认行为。
+ */
+import { pluginLineNumbers } from "@expressive-code/plugin-line-numbers";
+import expressiveCodeBase from "astro-expressive-code";
+
+type ExpressiveCodeOptions = NonNullable<Parameters<typeof expressiveCodeBase>[0]>;
+
+/**
+ * 创建带默认行号插件的 Expressive Code 集成。
+ * @param options - 透传 astro-expressive-code 的选项；用户传入的 plugins 会追加在行号插件之后
+ */
+export function expressiveCode(options: ExpressiveCodeOptions = {}) {
+    const plugins = [pluginLineNumbers(), ...(options.plugins ?? [])];
+    return expressiveCodeBase({ ...options, plugins });
+}
+
+export default expressiveCode;

package/src/index.ts

@@ -21,6 +21,8 @@ import { createIndex as pagefindCreateIndex } from "pagefind";
 import type { StaluxOptions } from "./config";
 import { staluxComponentsAlias } from "./internal/components-plugin";
 import { runFontSubsetting } from "./internal/font-subset";
+import { featureFlagsHast, featureFlagsMdast } from "./plugins/feature-flags";
+import { temml } from "./plugins/satteri-temml";
 
 // ---------------------------------------------------------------------------
 // 页面条目定义
@@ -191,7 +193,43 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
 
                 logger.info(`Stalux initialized (contentDir: ${opt.contentDir})`);
 
-                // 5. 站点 URL 单源化：以 stalux/config/site.yml 的 url 为准
+                // 5. 注入 satteri 插件（字数统计/特性标记/数学公式），按插件 name 去重
+                // 源码模式下 astro.config 会显式注册同款插件，插件模式则由集成补齐，
+                // 保证两种模式行为一致（wordCount/readingMinutes/hasImage 由构建期插件写入）。
+                // 去重是必须的：重复注册 featureFlagsMdast 会导致字数统计翻倍。
+                try {
+                    const processor = (config.markdown?.processor ?? undefined) as
+                        | { name?: string; options?: { mdastPlugins?: any[]; hastPlugins?: any[] } }
+                        | undefined;
+                    if (processor?.name === "satteri") {
+                        const mdastPlugins = processor.options?.mdastPlugins ?? [];
+                        const hastPlugins = processor.options?.hastPlugins ?? [];
+                        const seen = new Set<string>();
+                        for (const p of [...mdastPlugins, ...hastPlugins]) {
+                            if (p?.name) seen.add(p.name);
+                        }
+                        const pushUnique = (list: any[], plugin: any) => {
+                            if (plugin?.name) {
+                                if (seen.has(plugin.name)) return;
+                                seen.add(plugin.name);
+                            }
+                            list.push(plugin);
+                        };
+                        pushUnique(mdastPlugins, temml());
+                        pushUnique(mdastPlugins, featureFlagsMdast);
+                        pushUnique(hastPlugins, featureFlagsHast);
+                        logger.debug("Stalux: injected satteri plugins (temml/feature-flags)");
+                    } else {
+                        logger.warn(
+                            "Stalux: markdown.processor 不是 satteri，无法注入字数统计/数学公式插件。" +
+                                "请在 astro.config 中配置 `processor: satteri({...})`。",
+                        );
+                    }
+                } catch (error) {
+                    logger.warn(`Stalux: 注入 markdown 插件失败: ${String(error)}`);
+                }
+
+                // 6. 站点 URL 单源化：以 stalux/config/site.yml 的 url 为准
                 // sitemap 与 context.site 都派生自 astro.config 的 site 字段，
                 // 这里在构建前将其与主题配置对齐，避免输出与配置不一致的 URL
                 // （例如 README 里的 https://example.com 占位、或用户只改了 site.yml 忘了改 astro.config）。
@@ -229,7 +267,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
                     logger.debug("Stalux: site.yml not found, skip site sync");
                 }
 
-                // 6. 字体裁剪（在 config:setup 阶段执行，保证 dev/build 都能生成）
+                // 7. 字体裁剪（在 config:setup 阶段执行，保证 dev/build 都能生成）
                 try {
                     const projectRoot = process.cwd();
                     await runFontSubsetting(projectRoot, logger, true);
@@ -239,7 +277,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
             },
 
             "astro:build:start": async ({ logger }) => {
-                // 7. 字体裁剪（构建时，生成全部路由子集）
+                // 8. 字体裁剪（构建时，生成全部路由子集）
                 try {
                     const projectRoot = process.cwd();
                     await runFontSubsetting(projectRoot, logger);
@@ -249,7 +287,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
             },
 
             "astro:server:setup": async ({ server, logger }) => {
-                // 8. 字体裁剪（开发模式，生成 common 子集 + 按需路由切片）
+                // 9. 字体裁剪（开发模式，生成 common 子集 + 按需路由切片）
                 try {
                     const projectRoot = process.cwd();
                     // 清除旧的字体缓存
@@ -315,3 +353,6 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration {
 }
 
 export default stalux;
+
+// 便捷导出：带默认行号的 Expressive Code 集成（也可从 @xingwangzhe/stalux/expressive-code 导入）
+export { expressiveCode } from "./expressive-code";