clarity-theme 0.1.3 → 0.2.0

package/src/config/public.ts

@@ -1,71 +1,13 @@
-import type {
-	ClarityArticleConfig,
-	ClarityAuthor,
-	ClarityChangelogEntry,
-	ClarityConfig,
-	ClarityIntegrationsConfig,
-	ClaritySiteConfig,
-} from './schema'
+import type { ClarityIntegrationsConfig } from './schema'
 
 /**
- * 由 clarity.config.ts 注入 appConfig 的客户端可见配置。
- *
- * 可见性约定（详见 docs/guides/configuration.md）：
- * - 只有客户端渲染确实需要的字段进入 appConfig；
+ * 客户端可见性约定（详见 docs/guides/configuration.md）：
  * - feed、完整 stats、features 与 site.author.email 等服务端/构建期字段
  *   改由 Nitro 私有 runtimeConfig 提供（config/server.ts），不进入客户端 bundle；
  * - 仅构建期使用的字段（integrations.scripts、article.hidePostPrefix、
  *   article.robotsNotIndex）由模块直接消费，同样不进入 appConfig。
- * 这些配置允许进入客户端 bundle，不包含任何密钥（secret 只允许 runtimeConfig）。
+ * 允许进入客户端 bundle 的配置不包含任何密钥（secret 只允许 runtimeConfig）。
  */
 
 /** appConfig 中暴露的 integrations 子集：scripts 仅构建期注入 <head> */
 export type ClarityPublicIntegrationsConfig = Omit<ClarityIntegrationsConfig, 'scripts'>
-
-/** appConfig 中暴露的 site 子集：author.email 仅用于服务端 feed/meta 输出 */
-export type ClarityPublicSiteConfig = Omit<ClaritySiteConfig, 'author'> & {
-	author: Omit<ClarityAuthor, 'email'>
-}
-
-/** appConfig 中暴露的 article 子集：其余字段仅构建期使用 */
-export type ClarityPublicArticleConfig = Pick<ClarityArticleConfig, 'categories' | 'order'>
-
-/**
- * appConfig 中暴露的 stats 子集：由 includePaths 派生的展示事实，
- * 决定 BlogStats 标签使用「文章字数」还是「总字数」，不透出完整匹配规则。
- */
-export interface ClarityPublicStatsConfig {
-	postsOnly: boolean
-}
-
-export interface ClarityPublicConfig {
-	site: ClarityPublicSiteConfig
-	article: ClarityPublicArticleConfig
-	stats: ClarityPublicStatsConfig
-	integrations: ClarityPublicIntegrationsConfig
-	changelog: ClarityChangelogEntry[]
-}
-
-export function toPublicClarityConfig(config: ClarityConfig): ClarityPublicConfig {
-	return {
-		site: {
-			...config.site,
-			author: {
-				name: config.site.author.name,
-				avatar: config.site.author.avatar,
-				homepage: config.site.author.homepage,
-			},
-		},
-		article: {
-			categories: config.article.categories,
-			order: config.article.order,
-		},
-		stats: {
-			postsOnly: config.stats.includePaths.length > 0,
-		},
-		integrations: config.integrations.twikoo
-			? { twikoo: config.integrations.twikoo }
-			: {},
-		changelog: config.changelog,
-	}
-}

package/src/config/ui.ts

@@ -0,0 +1,111 @@
+/**
+ * Clarity Theme UI 默认值（上游 blog-v3 `app/app.config.ts` 的可分发子集）。
+ *
+ * 上游的 app/app.config.ts 属于消费项目文件（其 init-project 会重置），
+ * Layer 无法引用消费项目的 blog.config 来派生 logo / subtitle / copyright，
+ * 因此这些站点派生值由 src/modules/clarity-config 注入；
+ * 本文件只保留不携带个人数据的结构性默认值（footer.iconNav / footer.nav
+ * 的个人链接不能随 npm 包分发，默认置空，由消费项目自行填写）。
+ */
+import type { Nav, NavItem } from '../types/nav'
+
+// @keep-sorted
+export default {
+	component: {
+		alert: {
+			/** 默认使用卡片风格还是扁平风格 */
+			defaultStyle: 'card' as 'card' | 'flat',
+		},
+
+		codeblock: {
+			/** 代码块触发折叠的行数 */
+			triggerRows: 32,
+			/** 代码块折叠后的行数 */
+			collapsedRows: 16,
+			/** 启用代码块缩进导航会关闭空格渲染 */
+			enableIndentGuide: true,
+			/** 代码块缩进导航(Indent Guide)竖线匹配空格数 */
+			indent: 4,
+			/** tab渲染宽度 */
+			tabSize: 3,
+		},
+
+		/** 文章开头摘要 */
+		excerpt: {
+			animation: true,
+			caret: '_',
+		},
+
+		/** 精选文章 Slide */
+		slide: {
+			/** 适合封面图无字时启用 */
+			showTitle: true,
+		},
+
+		stats: {
+			/** 归档页面每年标题对应的年龄，无需展示时可设为 0 */
+			birthYear: 0,
+			/** blog-stats widget 的预置文本 */
+			wordCount: '',
+		},
+	},
+
+	// @keep-sorted
+	footer: {
+		/** 侧边栏底部图标导航（个人链接不随 Theme 分发，由消费项目配置） */
+		iconNav: [] as NavItem[],
+		/** 页脚站点地图（同上，默认为空） */
+		nav: [] as Nav,
+	},
+
+	/** 左侧栏顶部 Logo */
+	header: {
+		/** 展示标题文本，否则展示纯 Logo */
+		showTitle: true,
+		/** 标题后的随机表情 */
+		emojiTail: ['📝', '✨', '🌱'] as string[],
+	},
+
+	/** 友链页面 */
+	link: {
+		/** 无订阅源展示静音图标 */
+		remindNoFeed: true,
+		/** 友链分组内随机排序 */
+		randomInGroup: true,
+	},
+
+	/** 左侧栏导航 */
+	nav: [
+		{
+			title: '',
+			items: [
+				{ icon: 'tabler:files', text: '文章', url: '/' },
+				{ icon: 'tabler:link', text: '友链', url: '/link' },
+				{ icon: 'tabler:archive', text: '归档', url: '/archive' },
+			],
+		},
+	] as Nav,
+
+	pagination: {
+		perPage: 10,
+		/** 默认排序方式，需要是 article.order 中的键名 */
+		sortOrder: 'date',
+		/** 允许（普通/预览/归档）文章列表正序，开启后排序方式左侧图标可切换顺序 */
+		allowAscending: false,
+	},
+
+	themes: {
+		light: {
+			icon: 'tabler:sun',
+			tip: '浅色模式',
+		},
+		system: {
+			icon: 'tabler:device-desktop',
+			tip: '跟随系统',
+		},
+		dark: {
+			icon: 'tabler:moon',
+			tip: '深色模式',
+		},
+	},
+}

package/src/modules/anti-mirror/index.ts

@@ -0,0 +1,38 @@
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { defineNuxtModule } from 'nuxt/kit'
+import { minifySync } from 'oxc-minify'
+import handleMirror from './runtime/client'
+
+const blacklist = [
+	'dgjlx.com', // blog.revincx.icu
+	'dgvhqt.com', // blog.zhilu.cyou
+	'hcmsla.com', // thyuu.com
+	'wmlop.com', // xaoxuu.com
+	'yswjxs.com', // blog.zhilu.cyou
+]
+
+export default defineNuxtModule({
+	meta: {
+		name: 'anti-mirror',
+	},
+	async setup(_options, nuxt) {
+		// 生成的数据模块由 clarity-config（先于本模块注册）在 setup 阶段写入
+		// <buildDir>/clarity/；静态相对路径会命中安装包内部位置（穿透 pnpm
+		// 硬链接污染 store），改用基于 buildDir 的 file URL 动态导入，jiti 与
+		// Node 原生加载均可解析。
+		const buildInfoUrl = pathToFileURL(join(nuxt.options.buildDir, 'clarity', 'blog.config.mjs')).href
+		const { default: blogConfig } = await import(buildInfoUrl)
+		nuxt.options.app.head.script ??= []
+		nuxt.options.app.head.script.push({
+			innerHTML: toIifeString(handleMirror, blacklist.map(btoa), btoa(blogConfig.url)),
+		})
+	},
+})
+
+function toIifeString<T extends unknown[]>(fn: (...args: T) => void, ...args: T) {
+	const fnString = fn.toString()
+	const argsString = JSON.stringify(args).slice(1, -1)
+	const minified = minifySync('', `(${fnString})(${argsString})`)
+	return minified.code
+}

package/src/modules/{clarity-config/anti-mirror-client.ts → anti-mirror/runtime/client.ts}

@@ -1,11 +1,11 @@
 export default (sourcesEncoded: string[], targetEncoded: string) => {
 	const sources = sourcesEncoded.map(atob)
-	const canonicalHost = new URL(atob(targetEncoded)).host
+	const target = atob(targetEncoded)
 	const canonical = document.querySelector<HTMLLinkElement>('link[rel="canonical"]')
 	const isBadMirror = sources.some(domain => location.hostname.endsWith(domain))
 	if (isBadMirror) {
 		if (canonical)
-			canonical.href = canonical.href.replace(location.host, canonicalHost)
-		location.host = canonicalHost
+			canonical.href = canonical.href.replace(location.host, target)
+		location.host = target
 	}
 }