clarity-theme 0.1.0

package/server/routes/atom.xml.get.ts

@@ -0,0 +1,101 @@
+import type { ClarityContentRow } from '../../shared/types/content'
+import { queryCollection } from '@nuxt/content/server'
+import XmlBuilder from 'fast-xml-builder'
+import { toZonedTemporal } from '../../shared/utils/time'
+
+const runtimeConfig = useRuntimeConfig()
+
+const builder = new XmlBuilder({
+	attributeNamePrefix: '$',
+	cdataPropName: '$',
+	format: true,
+	ignoreAttributes: false,
+	textNodeName: '_',
+})
+
+export default defineEventHandler(async (event) => {
+	const { site, feed, features } = useClarityServerConfig()
+	if (!features.atom) {
+		throw createError({ statusCode: 404, statusMessage: 'Atom feed is disabled' })
+	}
+	const themeInfo = runtimeConfig.public.clarity as { theme: string, themeVersion: string, themeHomepage: string }
+
+	function formatIsoDate(date?: string) {
+		if (!date)
+			return
+		try {
+			return toZonedTemporal(date, site.timezone).toInstant().toString()
+		}
+		catch {
+			console.error('Invalid date format', date)
+			return date
+		}
+	}
+
+	function getUrl(path: string | undefined) {
+		return new URL(path ?? '', site.url).toString()
+	}
+
+	function renderContent(post: ClarityContentRow) {
+		return [
+			post.image && `<img src="${post.image}" alt="${post.title}" />`,
+			post.description && `<p>${post.description}</p>`,
+			`<a class="view-full" href="${getUrl(post.path)}" target="_blank">点击查看全文</a>`,
+		].filter(Boolean).join(' ')
+	}
+
+	const posts = await queryCollection(event, 'content' as never)
+		.where('stem', 'LIKE', 'posts/%')
+		.order('updated', 'DESC')
+		.limit(feed.limit)
+		.all() as ClarityContentRow[]
+
+	const entries = posts.map(post => ({
+		id: getUrl(post.path),
+		title: post.title ?? '',
+		updated: formatIsoDate(post.updated),
+		author: { name: (post as any).author || site.author.name },
+		content: {
+			$type: 'html',
+			$: renderContent(post),
+		},
+		link: { $href: getUrl(post.path) },
+		summary: post.description,
+		category: { $term: post.categories?.[0] },
+		published: formatIsoDate(post.published ?? post.date),
+	}))
+
+	const feedData = {
+		$xmlns: 'http://www.w3.org/2005/Atom',
+		id: site.url,
+		title: site.title,
+		updated: runtimeConfig.public.buildTime,
+		description: site.description,
+		author: {
+			name: site.author.name,
+			email: site.author.email,
+			uri: site.author.homepage,
+		},
+		link: [
+			{ $href: getUrl('atom.xml'), $rel: 'self' },
+			{ $href: site.url, $rel: 'alternate' },
+		],
+		language: site.language,
+		generator: {
+			$uri: themeInfo.themeHomepage,
+			$version: themeInfo.themeVersion,
+			_: themeInfo.theme,
+		},
+		icon: site.favicon,
+		logo: site.author.avatar,
+		rights: `© ${new Date().getFullYear()} ${site.author.name}`,
+		subtitle: site.subtitle || site.description,
+		entry: entries,
+	}
+
+	return builder.build({
+		'?xml': { $version: '1.0', $encoding: 'UTF-8' },
+		'?xml-stylesheet': feed.enableStyle ? { $type: 'text/xsl', $href: '/assets/atom.xsl' } : undefined,
+		'feed': feedData,
+	})
+})

package/server/routes/subscriptions.opml.get.ts

@@ -0,0 +1,70 @@
+import type { FeedEntry, FeedGroup } from '../../app/types/feed'
+import XmlBuilder from 'fast-xml-builder'
+import { toZonedTemporal } from '../../shared/utils/time'
+
+const runtimeConfig = useRuntimeConfig()
+
+const builder = new XmlBuilder({
+	attributeNamePrefix: '$',
+	format: true,
+	ignoreAttributes: false,
+})
+
+function mapEntry(item: FeedEntry, timeZone: string) {
+	return {
+		$text: item.title || item.sitenick || item.author,
+		$type: 'rss',
+		$xmlUrl: item.feed,
+		$created: toZonedTemporal(item.date, timeZone).toInstant().toString(),
+		$description: item.desc,
+		$htmlUrl: item.link || item.feed,
+	}
+}
+
+function flattenGroups(groups: FeedGroup[], timeZone: string) {
+	return groups.flatMap(({ entries }) => entries.filter(({ feed }) => feed).map(item => mapEntry(item, timeZone)))
+}
+
+export default defineEventHandler(async () => {
+	const { site, features } = useClarityServerConfig()
+	if (!features.opml) {
+		throw createError({ statusCode: 404, statusMessage: 'OPML subscription output is disabled' })
+	}
+	const feeds = (await import('#clarity/feeds')).default as FeedGroup[]
+	const myFeed: FeedEntry = {
+		author: site.author.name,
+		title: site.title,
+		desc: site.subtitle || site.description,
+		link: site.url,
+		feed: new URL('/atom.xml', site.url).toString(),
+		icon: site.favicon,
+		avatar: site.author.avatar || site.favicon,
+		date: site.established || '',
+	}
+
+	const outlines = [
+		mapEntry(myFeed, site.timezone),
+		...flattenGroups(feeds, site.timezone),
+	]
+
+	const opml = {
+		$version: '2.0',
+		head: {
+			title: `${site.title}的友链订阅`,
+			dateCreated: site.established
+				? toZonedTemporal(site.established, site.timezone).toInstant().toString()
+				: undefined,
+			dateModified: runtimeConfig.public.buildTime,
+			ownerName: site.author.name,
+			ownerEmail: site.author.email,
+			ownerId: site.author.homepage,
+			docs: 'https://opml.org/spec2.opml',
+		},
+		body: { outline: outlines },
+	}
+
+	return builder.build({
+		'?xml': { $version: '1.0', $encoding: 'UTF-8' },
+		opml,
+	})
+})

package/server/utils/clarity.ts

@@ -0,0 +1,11 @@
+import type { ClarityServerConfig } from '../../config/server'
+
+/**
+ * 获取服务端专用 Clarity 配置（完整 site/feed/stats 与 feature 路由开关）。
+ *
+ * 数据来自 Nitro 私有 runtimeConfig，不会进入客户端 bundle；
+ * 请只在 server/ 侧调用，客户端渲染请使用 useClarityConfig()。
+ */
+export function useClarityServerConfig(): ClarityServerConfig {
+	return useRuntimeConfig().clarity as ClarityServerConfig
+}

package/shared/types/content.ts

@@ -0,0 +1,30 @@
+import type { PageCollectionItemBase } from '@nuxt/content'
+
+/**
+ * Theme 内部使用的 content 集合行类型。
+ *
+ * 消费项目的精确集合类型由 @nuxt/content 按站点 schema 生成，并通过
+ * module augmentation 注入消费项目上下文。Theme 作为 node_modules Layer
+ * 解析到的 @nuxt/content 类型实例无法稳定共享该 augmentation（pnpm 严格
+ * 布局下会形成双实例），因此 Theme 内部只依赖自身 schema 的稳定字段。
+ */
+export type ClarityContentRow = PageCollectionItemBase & {
+	title?: string
+	description?: string
+	date?: string
+	updated?: string
+	published?: string
+	categories?: string[]
+	tags?: string[]
+	type?: string
+	image?: string
+	recommend?: number
+	draft?: boolean
+	permalink?: string
+	readingTime: {
+		text: string
+		minutes: number
+		time: number
+		words: number
+	}
+}

package/shared/utils/clarity.ts

@@ -0,0 +1,34 @@
+import type { ClarityAppConfig } from '../../config/app'
+import type { FeedEntry } from '../../config/feed'
+import type { ClaritySiteConfig } from '../../config/schema'
+
+/** 获取完整 Clarity 配置（站点配置 + UI 配置） */
+export function useClarityConfig(): ClarityAppConfig {
+	return useAppConfig().clarity as unknown as ClarityAppConfig
+}
+
+/** 获取站点配置（标题、作者、URL 等） */
+export function useClaritySite(): ClaritySiteConfig {
+	return useClarityConfig().site
+}
+
+/** 获取文章配置的客户端子集（分类图标/颜色、排序方式） */
+export function useClarityArticle(): ClarityAppConfig['article'] {
+	return useClarityConfig().article
+}
+
+/** 由站点配置生成本站订阅源条目（用于友链页与 OPML） */
+export function useClaritySiteFeedEntry(): FeedEntry {
+	const site = useClaritySite()
+	return {
+		author: site.author.name,
+		title: site.title,
+		desc: site.subtitle || site.description,
+		link: site.url,
+		feed: new URL('/atom.xml', site.url).toString(),
+		icon: site.favicon,
+		avatar: site.author.avatar || site.favicon,
+		date: site.established || '',
+		comment: '这是我自己',
+	}
+}

package/shared/utils/icon.ts

@@ -0,0 +1,218 @@
+/** 友链架构图标映射 */
+// @keep-sorted
+const archIcons = {
+	'Astro': 'simple-icons:astro',
+	'Cloudflare': 'simple-icons:cloudflare',
+	'Deno Deploy': 'simple-icons:deno',
+	'EdgeOne': 'simple-icons:cloudnativebuild', // 不准确
+	'Express': 'simple-icons:express',
+	'Fly': 'tabler:air-balloon',
+	'Framer': 'simple-icons:framer',
+	'Ghost': 'simple-icons:ghost',
+	'GitHub Pages': 'simple-icons:github',
+	'Golang': 'simple-icons:go',
+	'Gridea': 'tabler:square-rounded-letter-g-filled', // 不准确
+	'Halo': 'material-symbols:h-mobiledata-badge', // 不准确
+	'Hexo': 'simple-icons:hexo',
+	'HTML': 'simple-icons:html5',
+	'Hugo': 'simple-icons:hugo',
+	'Jekyll': 'simple-icons:jekyll',
+	'Material for MkDocs': 'simple-icons:materialformkdocs',
+	'Netlify': 'simple-icons:netlify',
+	'Next.js': 'simple-icons:nextdotjs',
+	'Notion': 'simple-icons:notion',
+	'NotionNext': 'simple-icons:notion',
+	'Nuxt': 'simple-icons:nuxt',
+	'PHP': 'simple-icons:php',
+	'Python': 'simple-icons:python',
+	'React': 'simple-icons:react',
+	'Typecho': 'icon-park-solid:align-text-left-one', // 不准确
+	'Valaxy': 'tabler:letter-v', // 不准确
+	'Vercel': 'simple-icons:vercel',
+	'VitePress': 'simple-icons:vitepress',
+	'Vue': 'uim:vuejs',
+	'VuePress': 'uim:vuejs',
+	'WordPress': 'simple-icons:wordpress',
+	'Zeabur': 'tabler:square-letter-z-filled', // 不准确
+	'国内 CDN': 'tabler:cloud-data-connection',
+	'服务器': 'tabler:server',
+	'虚拟主机': 'tabler:cloud-upload',
+}
+
+export type Arch = keyof typeof archIcons
+
+export function getArchIcon(arch: Arch) {
+	return archIcons[arch] ?? ''
+}
+
+/** BlogTech Widget 构建平台图标映射 */
+// @keep-sorted
+export const ciIcons: Record<string, string> = {
+	'Cloudflare Pages': 'devicon:cloudflare',
+	'Cloudflare Workers': 'devicon:cloudflareworkers',
+	'EdgeOne': 'https://edgeone.ai/favicon.ico',
+	'GitHub Actions': 'ri:github-fill',
+	'Netlify CI': 'catppuccin:netlify',
+	'Vercel': 'ri:vercel-fill',
+}
+
+/** 主域名图标映射 */
+// @keep-sorted
+const mainDomainIcons: Record<string, string> = {
+	'bilibili.com': 'ri:bilibili-fill',
+	'creativecommons.org': 'ri:creative-commons-line',
+	'feishu.cn': 'icon-park-outline:new-lark',
+	'github.com': 'ri:github-fill',
+	'github.io': 'ri:github-fill',
+	'google.cn': 'ri:google-fill',
+	'google.com': 'ri:google-fill',
+	'jd.com': 'arcticons:jd-sports',
+	'larkoffice.com': 'icon-park-outline:new-lark',
+	'microsoft.com': 'ri:microsoft-fill',
+	'netlify.app': 'simple-icons:netlify',
+	'pages.dev': 'simple-icons:cloudflare',
+	'qq.com': 'ri:qq-fill',
+	'taobao.com': 'ri:taobao-fill',
+	'thisis.host': 'tabler:star-filled',
+	'tmall.com': 'ri:taobao-fill',
+	'v2ex.com': 'simple-icons:v2ex',
+	'vercel.app': 'simple-icons:vercel',
+	'zabaur.app': 'tabler:square-letter-z-filled',
+	'zhihu.com': 'ri:zhihu-line',
+}
+
+/** 专门域名图标映射，优先级高于主域名图标 */
+// @keep-sorted
+export const domainIcons: Record<string, string> = {
+	'developer.mozilla.org': 'simple-icons:mdnwebdocs',
+	'h5.qzone.qq.com': 'simple-icons:qzone',
+	'mp.weixin.qq.com': 'ri:wechat-fill',
+}
+
+export function getDomainIcon(url: string) {
+	const domain = getDomain(url)
+	const mainDomain = getMainDomain(url, true)
+	if (domain in domainIcons)
+		return domainIcons[domain]
+	return mainDomainIcons[mainDomain]
+}
+
+/** 文件名后缀图标映射，优先级高于代码块语言图标映射 */
+// @keep-sorted
+const file2icon: Record<string, string> = {
+	'.babelrc.js': 'catppuccin:babel',
+	'.babelrc': 'catppuccin:babel',
+	'.crt': 'catppuccin:certificate',
+	'.editorconfig': 'catppuccin:editorconfig',
+	'.env': 'catppuccin:env',
+	'.gitattributes': 'catppuccin:git',
+	'.gitconfig': 'catppuccin:git',
+	'.gitignore': 'catppuccin:git',
+	'.gitkeep': 'catppuccin:git',
+	'.gitlab-ci.yml': 'catppuccin:gitlab',
+	'.gitmodules': 'catppuccin:git',
+	'.key': 'catppuccin:key',
+	'.npmrc': 'catppuccin:npm',
+	'.patch': 'catppuccin:git',
+	'.prettierrc': 'catppuccin:prettier',
+	'astro.config.mjs': 'catppuccin:astro-config',
+	'CHANGELOG.md': 'catppuccin:changelog',
+	'CODE_OF_CONDUCT.md': 'catppuccin:code-of-conduct',
+	'CODEOWNERS': 'catppuccin:codeowners',
+	'CONTRIBUTING.md': 'catppuccin:contributing',
+	'docker-compose.yml': 'catppuccin:docker-compose',
+	'eslint.config.js': 'catppuccin:eslint',
+	'eslint.config.mjs': 'catppuccin:eslint',
+	'LICENSE': 'catppuccin:license',
+	'netlify.toml': 'catppuccin:netlify',
+	'next.config.ts': 'catppuccin:next',
+	'nuxt.config.ts': 'catppuccin:nuxt',
+	'package.json': 'catppuccin:package-json',
+	'pnpm-workspace.yaml': 'catppuccin:pnpm',
+	'postcss.config.js': 'catppuccin:postcss',
+	'prettier.config.js': 'catppuccin:prettier',
+	'pyproject.toml': 'catppuccin:python-config',
+	'README.md': 'catppuccin:readme',
+	'renovate.json': 'catppuccin:renovate',
+	'requirements.txt': 'catppuccin:python-config',
+	'robots.txt': 'catppuccin:robots',
+	'rollup.config.js': 'catppuccin:rollup',
+	'SECURITY.md': 'catppuccin:security',
+	'stylelint.config.js': 'catppuccin:stylelint',
+	'stylelint.config.mjs': 'catppuccin:stylelint',
+	'tailwind.config.js': 'catppuccin:tailwind',
+	'tsconfig.json': 'catppuccin:typescript-config',
+	'verccel.json': 'catppuccin:vercel',
+	'vite.config.js': 'catppuccin:vite',
+	'vite.config.ts': 'catppuccin:vite',
+	'webpack.config.js': 'catppuccin:webpack',
+	'yarn.lock': 'catppuccin:yarn',
+}
+
+export function getFileIcon(filename?: string) {
+	if (!filename)
+		return undefined
+	const extension = Object.keys(file2icon).find(ext => filename.endsWith(ext))
+	return extension ? file2icon[extension] : undefined
+}
+
+/**
+ * 代码块语言简写或别名到 Catppuccin 图标库中的语言名映射
+ *
+ * 将 `blogConfig.shiki.langs` 的部分后缀名简写
+ * 转换为代码块语言对应的 Iconify Catppuccin 图标
+ */
+// @keep-sorted
+const ext2lang: Record<string, string> = {
+	'bat': 'catppuccin:batch',
+	'c': 'catppuccin:c',
+	'c++': 'catppuccin:cpp',
+	'cpp': 'catppuccin:cpp',
+	'css': 'catppuccin:css',
+	'diff': 'catppuccin:diff',
+	'dockerfile': 'catppuccin:docker',
+	'gql': 'catppuccin:graphql',
+	'hs': 'catppuccin:haskell',
+	'html': 'catppuccin:html',
+	'ini': 'catppuccin:properties',
+	'java': 'catppuccin:java',
+	'js': 'catppuccin:javascript',
+	'json': 'catppuccin:json',
+	'jsonc': 'catppuccin:json',
+	'jsx': 'catppuccin:javascript-react',
+	'log': 'catppuccin:log',
+	'make': 'catppuccin:makefile',
+	'makefile': 'catppuccin:makefile',
+	'matlab': 'catppuccin:matlab',
+	'md': 'catppuccin:markdown',
+	'mdc': 'catppuccin:markdown',
+	'mdx': 'catppuccin:markdown',
+	'mermaid': 'catppuccin:mermaid',
+	'mmd': 'catppuccin:mermaid',
+	'powershell': 'catppuccin:powershell',
+	'ps': 'catppuccin:powershell',
+	'ps1': 'catppuccin:powershell',
+	'py': 'catppuccin:python',
+	'python': 'catppuccin:python',
+	'rs': 'catppuccin:rust',
+	'scss': 'catppuccin:sass',
+	'sh': 'catppuccin:bash',
+	'shell': 'catppuccin:bash',
+	'shellscript': 'catppuccin:bash',
+	'sql': 'catppuccin:database',
+	'ssh-config': 'catppuccin:properties',
+	'ssh': 'catppuccin:properties',
+	'toml': 'catppuccin:toml',
+	'ts': 'catppuccin:typescript',
+	'tsx': 'catppuccin:typescript-react',
+	'vb': 'catppuccin:visual-studio',
+	'vue': 'catppuccin:vue',
+	'xml': 'catppuccin:xml',
+	'yaml': 'catppuccin:yaml',
+	'yml': 'catppuccin:yaml',
+	'zsh': 'catppuccin:bash',
+}
+
+export function getLangIcon(extension = 'file') {
+	return ext2lang[extension] ?? 'catppuccin:file'
+}

package/shared/utils/link.ts

@@ -0,0 +1,52 @@
+import { fromUrl, parseDomain, ParseResultType } from 'parse-domain'
+import { isPathFile } from 'site-config-stack/urls'
+
+const domainTip: Record<string, string> = {
+	'github.io': 'GitHub Pages 域名',
+	'netlify.app': 'Netlify 域名',
+	'pages.dev': 'Cloudflare 域名',
+	'thisis.host': '纸鹿提供的域名',
+	'vercel.app': 'Vercel 域名',
+	'zeabur.app': 'Zeabur 域名',
+}
+
+export function getDomain(url: string) {
+	const domain = fromUrl(url)
+	return typeof domain === 'symbol' ? url : domain
+}
+
+export function getMainDomain(url: string, useIcann?: boolean) {
+	const hostname = getDomain(url)
+	const parseResult = parseDomain(hostname)
+	if (parseResult.type !== ParseResultType.Listed)
+		return hostname
+	const { domain, topLevelDomains } = useIcann ? parseResult.icann : parseResult
+	return `${domain}.${topLevelDomains.join('.')}`
+}
+
+export function getDomainType(mainDomain: string) {
+	return domainTip[mainDomain]
+}
+
+const githubUsernameRegex = /github\.com\/([a-zA-Z0-9-]+)(?:\/[^/]+)?(\/?)$/
+
+export function getGithubUsername(url?: string) {
+	if (!url)
+		return ''
+	return url.match(githubUsernameRegex)?.[1] ?? ''
+}
+
+export function isExtLink(url?: string) {
+	return url
+		? url.includes(':') || url.startsWith('//') || !!isPathFile(url)
+		: false
+}
+
+export function safelyDecodeUriComponent(str: string) {
+	try {
+		return decodeURIComponent(str)
+	}
+	catch {
+		return str
+	}
+}

package/shared/utils/str.ts

@@ -0,0 +1,88 @@
+import { toArray } from '@vueuse/core'
+import { escape, escapeRegExp } from 'es-toolkit/string'
+
+// @keep-sorted
+const promptLanguageMap: Record<string, string> = {
+	'#': 'sh',
+	'$': 'sh',
+	'CMD': 'bat',
+	'PS': 'powershell',
+}
+
+export function formatNumber(num?: number) {
+	if (typeof num !== 'number')
+		return ''
+	const intervals = [
+		{ label: '万亿', threshold: 1e12 },
+		{ label: '亿', threshold: 1e8 },
+		{ label: '万', threshold: 1e4 },
+	]
+	for (const interval of intervals) {
+		if (num >= interval.threshold)
+			return `${(num / interval.threshold).toFixed(2)}${interval.label}`
+	}
+	return num.toString()
+}
+
+interface FormatBytesOptions {
+	decimals?: number
+	binary?: boolean
+	unitSeparator?: string
+}
+
+export function formatBytes(bytes: number, options: FormatBytesOptions = {}) {
+	const {
+		decimals = 2,
+		binary = true,
+		unitSeparator = ' ',
+	} = options
+
+	if (bytes === 0)
+		return `0${unitSeparator}Bytes`
+
+	const base = binary ? 1024 : 1000
+	const units = binary
+		? ['B', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB']
+		: ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB']
+
+	const i = Math.floor(Math.log(bytes) / Math.log(base))
+	const value = Number.parseFloat((bytes / base ** i).toFixed(decimals))
+
+	return `${value}${unitSeparator}${units[i]}`
+}
+
+export function getPromptLanguage(prompt: string | boolean) {
+	if (typeof prompt === 'boolean')
+		return 'text'
+	for (const promptPrefix in promptLanguageMap) {
+		if (prompt.startsWith(promptPrefix))
+			return promptLanguageMap[promptPrefix] ?? 'text'
+	}
+	return 'text'
+}
+
+export function joinWith(strings: (string | undefined)[], separator = '\n') {
+	return strings.filter(Boolean).join(separator)
+}
+
+export function highlightHtml(text: string, words: string | string[] | undefined, className?: string) {
+	const validTerms = toArray(words)
+		.filter((t): t is string => !!t?.trim())
+		.map(t => t.toLowerCase())
+
+	const highlightRegex = new RegExp(`(${Array.from(validTerms, escapeRegExp).join('|')})`, 'gi')
+
+	return text
+		.split(highlightRegex)
+		.map(part => part && validTerms.includes(part.toLowerCase())
+			? `<mark${className ? ` class="${className}"` : ''}>${escape(part)}</mark>`
+			: escape(part))
+		.join('')
+		.replace(/\n+/g, '<br>')
+}
+
+export function removeHtmlTags(str?: string) {
+	if (typeof str !== 'string')
+		return ''
+	return str.replace(/<[^>]+(>|$)/g, '')
+}