clarity-theme 0.1.0

package/modules/clarity-config/index.ts

@@ -0,0 +1,324 @@
+import type { Nuxt } from '@nuxt/schema'
+import type { ClarityConfig } from '../../config/schema'
+import { existsSync } from 'node:fs'
+import { dirname, relative, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createJiti } from 'jiti'
+import {
+	addImportsDir,
+	addTypeTemplate,
+	defineNuxtModule,
+	updateAppConfig,
+	useLogger,
+} from 'nuxt/kit'
+import nuxtPkg from 'nuxt/package.json'
+import { minify } from 'oxc-minify'
+import vuePkg from 'vue/package.json'
+import { toPublicClarityConfig } from '../../config/public'
+import { toServerClarityConfig } from '../../config/server'
+import { clarityConfigSchema } from '../../config/schema'
+import handleMirror from './anti-mirror-client'
+
+const moduleDir = dirname(fileURLToPath(import.meta.url))
+const themeDir = resolve(moduleDir, '../..')
+
+/** app/app.config.ts 的 clarity 键只允许 UI 覆盖（站点级字段属于 clarity.config.ts） */
+const uiConfigKeys = new Set(['component', 'footer', 'header', 'link', 'nav', 'pagination', 'themes'])
+
+export interface ModuleOptions {
+	/** 消费项目中 clarity 配置文件路径（相对 rootDir） */
+	configFile?: string
+}
+
+export default defineNuxtModule<ModuleOptions>({
+	meta: {
+		name: 'clarity-config',
+		configKey: 'clarityConfig',
+	},
+
+	async setup(options, nuxt) {
+		const logger = useLogger('clarity-config')
+		const rootDir = nuxt.options.rootDir
+
+		const configPath = resolve(rootDir, options.configFile ?? findConfigFile(rootDir))
+		const feedsPath = findFeedsFile(rootDir, themeDir)
+
+		// ---- 依赖注入层：Theme 内部不感知消费项目的文件布局 ----
+		Object.assign(nuxt.options.alias, {
+			'#clarity/config': configPath,
+			'#clarity/feeds': feedsPath.resolved,
+		})
+
+		// @pinia/nuxt 不会自动扫描 Layer 的 stores 目录，需显式注册
+		addImportsDir(resolve(themeDir, 'app/stores'))
+
+		// ---- AppConfig 类型化：消费者 defineAppConfig({ clarity: ... }) 获得完整类型提示 ----
+		// 注意：类型文件生成于 buildDir/types/ 下，相对路径必须以其为基准计算，
+		// 否则导入解析失败会因 skipLibCheck 静默退化为 any（审计发现 #9）。
+		const appConfigTypeDir = resolve(nuxt.options.buildDir, 'types')
+		const appConfigTypePath = relative(appConfigTypeDir, resolve(themeDir, 'config/app.ts')).replaceAll('\\', '/')
+		const globalsTypePath = relative(appConfigTypeDir, resolve(themeDir, 'app/types/index.ts')).replaceAll('\\', '/')
+		addTypeTemplate({
+			filename: 'types/clarity-app-config.d.ts',
+			getContents: () => [
+				// app/types/index.ts 的 Window.twikoo 等环境声明在 node_modules Layer 中
+				// 不会被 tsconfig include 命中（被 node_modules exclude 过滤），需显式导入
+				`import '${globalsTypePath}'`,
+				`import type { ClarityAppConfig, ClarityUiConfigInput } from '${appConfigTypePath}'`,
+				'',
+				'declare module \'@nuxt/schema\' {',
+				'  // 读取侧：unknown 使 MergedAppConfig 回落到 Theme 注入的完整 Resolved 类型',
+				'  interface CustomAppConfig {',
+				'    clarity?: unknown',
+				'  }',
+				'  // 输入侧：完整配置（Theme 内部）或 UI 部分覆盖（消费项目 app/app.config.ts）',
+				'  interface AppConfigInput {',
+				'    clarity?: ClarityAppConfig | ClarityUiConfigInput',
+				'  }',
+				'}',
+				'',
+			].join('\n'),
+		})
+
+		// @bikariya/shiki 运行时固定导入 ~/shiki.config，
+		// 消费项目未提供时回退到 Theme 内置配置；
+		// 需置于 '~' 之前以保证 Vite 别名前缀优先匹配
+		if (!existsSync(resolve(nuxt.options.srcDir, 'shiki.config.ts'))) {
+			nuxt.options.alias = {
+				'~/shiki.config': resolve(themeDir, 'app/shiki.config.ts'),
+				...nuxt.options.alias,
+			}
+		}
+
+		if (!existsSync(configPath)) {
+			throw new Error(
+				`[clarity-config] 未找到 ${configPath}。`
+				+ '请在消费项目根目录创建 clarity.config.ts（可参考 playground/clarity.config.ts）。',
+			)
+		}
+		if (!feedsPath.found) {
+			logger.warn('未找到 feeds.ts，友链页面与 OPML 订阅将输出空数据。')
+		}
+
+		// ---- 读取并校验站点配置（错误在构建开始前暴露） ----
+		const jiti = createJiti(import.meta.url, { moduleCache: false, interopDefault: true })
+		const configModule = await importConfigFile(jiti, configPath)
+		const config = parseClarityConfig((configModule as { default?: unknown })?.default ?? configModule, configPath)
+		const { site, article, integrations, features } = config
+
+		// ---- 边界审计：app/app.config.ts 中不应出现站点级字段（其优先级更高，会覆盖站点配置注入） ----
+		await warnNonUiAppConfigOverrides(nuxt, jiti, logger)
+
+		// ---- Site Config → App Config 桥梁 ----
+		// 注意 Nuxt appConfig 合并优先级：消费项目 app.config > Theme app.config > 模块注入，
+		// 因此站点派生默认值（header.logo 等）不放入 Theme 的 app.config.ts，
+		// 由这里注入后仍可被消费项目覆盖。
+		updateAppConfig({
+			clarity: {
+				...toPublicClarityConfig(config),
+				header: {
+					logo: site.author.avatar ?? '',
+					subtitle: site.subtitle ?? '',
+				},
+				footer: {
+					copyright: site.copyright?.name
+						? `© ${new Date().getFullYear()} ${site.author.name} · ${site.copyright.name}`
+						: `© ${new Date().getFullYear()} ${site.author.name}`,
+				},
+			},
+		})
+
+		// ---- 服务端专用配置：注入 Nitro 私有 runtimeConfig（不进入客户端 bundle）----
+		// Atom/OPML/stats 处理器与 feature 路由守卫从这里读取完整配置。
+		nuxt.options.runtimeConfig.clarity = toServerClarityConfig(config)
+
+		// ---- SEO / site / robots / llms ----
+		nuxt.options.site = {
+			...nuxt.options.site,
+			name: site.title,
+			url: site.url,
+			defaultLocale: site.language,
+		} as typeof nuxt.options.site
+
+		nuxt.options.robots = {
+			...nuxt.options.robots,
+			disallow: article.robotsNotIndex,
+		} as typeof nuxt.options.robots
+
+		// nuxt-llms 的配置类型由该模块按需合并，此处运行时注入
+		const llmsOptions = (nuxt.options as any).llms ?? {}
+		;(nuxt.options as any).llms = {
+			...llmsOptions,
+			domain: site.url,
+			title: site.title,
+			description: site.description,
+		}
+
+		// ---- Head 元数据 ----
+		const head = nuxt.options.app.head
+		head.meta ??= []
+		head.meta.push({ name: 'author', content: [site.author.name, site.author.email].filter(Boolean).join(', ') })
+		head.link ??= []
+		head.link.push({ rel: 'icon', href: site.favicon })
+		if (features.atom) {
+			head.link.push({ rel: 'alternate', type: 'application/atom+xml', href: '/atom.xml' })
+		}
+		const twikooPreload = integrations.twikoo?.preload ?? integrations.twikoo?.envId
+		if (twikooPreload) {
+			head.link.push({ rel: 'preconnect', href: twikooPreload })
+		}
+		head.script ??= []
+		head.script.push(...integrations.scripts as any[])
+		head.titleTemplate = `%s %separator ${site.title}`
+
+		// ---- 构建信息（供 BlogTech 等 Widget 使用） ----
+		const consumerPkg = await loadJson(resolve(rootDir, 'package.json'), jiti)
+		const themePkg = await loadJson(resolve(themeDir, 'package.json'), jiti)
+		nuxt.options.runtimeConfig.public.clarity = {
+			theme: 'Clarity',
+			themeVersion: String(themePkg?.version ?? ''),
+			themeHomepage: String(themePkg?.homepage ?? ''),
+			siteVersion: String(consumerPkg?.version ?? ''),
+			sitePackageManager: String(consumerPkg?.packageManager ?? ''),
+			nuxtVersion: nuxtPkg.version,
+			vueVersion: vuePkg.version,
+		}
+
+		// ---- 路由规则 ----
+		const routeRules = nuxt.options.routeRules ??= {}
+		if (features.stats) {
+			routeRules['/api/stats'] = { prerender: true, headers: { 'Content-Type': 'application/json' } }
+		}
+		if (features.atom) {
+			routeRules['/atom.xml'] = { prerender: true, headers: { 'Content-Type': 'application/xml' } }
+		}
+		if (features.opml) {
+			routeRules['/subscriptions.opml'] = { prerender: true, headers: { 'Content-Type': 'application/xml' } }
+		}
+		routeRules['/favicon.ico'] = { redirect: { to: site.favicon } }
+
+		// ---- 自定义链接与 /posts 前缀处理 ----
+		nuxt.hook('content:file:afterParse', (ctx) => {
+			const { permalink, path } = ctx.content as Record<string, string | undefined>
+			if (permalink) {
+				ctx.content.path = permalink
+			}
+			else if (article.hidePostPrefix && path?.startsWith('/posts/')) {
+				ctx.content.path = path.slice('/posts'.length)
+			}
+		})
+
+		// ---- 可选功能：anti-mirror ----
+		// 黑名单完全由站点配置提供；Theme 不携带任何上游默认域名（审计发现 #5）。
+		if (features.antiMirror !== false) {
+			const blacklist = typeof features.antiMirror === 'boolean' ? [] : features.antiMirror.blacklist
+			if (blacklist.length === 0) {
+				logger.warn('features.antiMirror 已启用，但未配置 blacklist，已跳过反镜像脚本注入。')
+			}
+			else {
+				await injectAntiMirror(nuxt, blacklist, site.url)
+			}
+		}
+	},
+})
+
+async function importConfigFile(jiti: ReturnType<typeof createJiti>, configPath: string) {
+	try {
+		return await jiti.import(configPath) as unknown
+	}
+	catch (error) {
+		throw new Error(
+			`[clarity-config] 加载 ${configPath} 失败：${error instanceof Error ? error.message : String(error)}`,
+			{ cause: error },
+		)
+	}
+}
+
+function parseClarityConfig(raw: unknown, configPath: string): ClarityConfig {
+	const result = clarityConfigSchema.safeParse(raw)
+	if (!result.success) {
+		const issues = result.error.issues
+			.map(issue => `  - ${issue.path.join('.') || '(根对象)'}: ${issue.message}`)
+			.join('\n')
+		throw new Error(`[clarity-config] ${configPath} 校验失败：\n${issues}`)
+	}
+	return result.data
+}
+
+/** 消费项目 app/app.config.ts 若覆盖站点级字段，会在 defu 合并中压过 clarity.config.ts 注入，需要提示迁移 */
+async function warnNonUiAppConfigOverrides(nuxt: Nuxt, jiti: ReturnType<typeof createJiti>, logger: ReturnType<typeof useLogger>) {
+	const candidates = [
+		resolve(nuxt.options.srcDir, 'app.config.ts'),
+		resolve(nuxt.options.rootDir, 'app.config.ts'),
+	]
+	for (const appConfigPath of candidates) {
+		if (!existsSync(appConfigPath)) {
+			continue
+		}
+		// app.config.ts 依赖 defineAppConfig 全局函数，jiti 裸加载时需要临时注入（运行时它只是恒等函数）
+		const globalScope = globalThis as { defineAppConfig?: (config: unknown) => unknown }
+		const previousDefine = globalScope.defineAppConfig
+		globalScope.defineAppConfig ??= (config: unknown) => config
+		try {
+			const mod = await jiti.import(appConfigPath) as unknown
+			const clarity = ((mod as { default?: unknown })?.default ?? mod) as { clarity?: Record<string, unknown> } | undefined
+			if (!clarity?.clarity || typeof clarity.clarity !== 'object') {
+				continue
+			}
+			const offenders = Object.keys(clarity.clarity).filter(key => !uiConfigKeys.has(key))
+			if (offenders.length) {
+				logger.warn(
+					`app/app.config.ts 的 clarity 中出现站点级字段 [${offenders.join(', ')}]，`
+					+ '它们会覆盖 clarity.config.ts 的注入结果；请将站点配置迁移到 clarity.config.ts。',
+				)
+			}
+		}
+		catch {
+			// 尽力而为的边界提示：app.config 加载失败时交给 Nuxt 自身报错
+		}
+		finally {
+			if (previousDefine === undefined) {
+				delete globalScope.defineAppConfig
+			}
+			else {
+				globalScope.defineAppConfig = previousDefine
+			}
+		}
+	}
+}
+
+async function injectAntiMirror(nuxt: Nuxt, blacklist: string[], target: string) {
+	const source = `(${handleMirror.toString()})(${JSON.stringify(blacklist.map(btoa))},${JSON.stringify(btoa(target))})`
+	const { code, errors } = await minify('clarity-anti-mirror.iife.js', source)
+	if (errors.length > 0) {
+		throw new Error(`[clarity-config] anti-mirror 脚本压缩失败：\n${errors.map(error => error.message ?? String(error)).join('\n')}`)
+	}
+	;(nuxt.options.app.head.script ??= []).push({ innerHTML: code })
+}
+
+function findConfigFile(rootDir: string) {
+	for (const name of ['clarity.config.ts', 'clarity.config.mjs', 'clarity.config.js']) {
+		if (existsSync(resolve(rootDir, name))) {
+			return name
+		}
+	}
+	return 'clarity.config.ts'
+}
+
+function findFeedsFile(rootDir: string, themeDir: string) {
+	for (const name of ['feeds.ts', 'feeds.mjs', 'feeds.js']) {
+		if (existsSync(resolve(rootDir, name))) {
+			return { found: true, resolved: resolve(rootDir, name) }
+		}
+	}
+	return { found: false, resolved: resolve(themeDir, 'config/feeds.empty.ts') }
+}
+
+async function loadJson(path: string, jiti: ReturnType<typeof createJiti>) {
+	try {
+		return ((await jiti.import(path)) as { default?: Record<string, unknown> } | undefined)?.default
+	}
+	catch {
+		return undefined
+	}
+}

package/nuxt.config.ts

@@ -0,0 +1,225 @@
+import { dirname, join } from 'node:path'
+import { arch, env, version as nodeVersion, platform } from 'node:process'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { name as ciName, CLOUDFLARE_PAGES, GITHUB_ACTIONS, NETLIFY } from 'ci-info'
+import { Temporal } from 'temporal-polyfill'
+import { homepage, name as themeName, version as themeVersion } from './package.json'
+
+/** Theme 根目录（Layer 本地路径基准，兼容 npm 包 / git 包 / 本地目录安装） */
+const themeDir = dirname(fileURLToPath(import.meta.url))
+const toThemePath = (path: string) => join(themeDir, path).replaceAll('\\', '/')
+
+function pluginPath(path: string) {
+	// 插件必须是 .mjs：@nuxt/content 以 Node 原生方式加载，
+	// 不允许 node_modules 内的 TS 文件（TS 剥离限制）
+	return pathToFileURL(join(themeDir, 'remark-plugins', `${path}.mjs`)).href
+}
+
+/**
+ * Clarity Theme Layer 配置
+ *
+ * 站点数据（SEO、favicon、scripts 等）由 modules/clarity-config
+ * 读取消费项目的 clarity.config.ts 后统一注入，此处仅包含 Theme 自身能力。
+ */
+export default defineNuxtConfig({
+	app: {
+		head: {
+			meta: [
+				{ name: 'color-scheme', content: 'light dark' },
+				{ 'name': 'generator', 'content': `Clarity Theme ${themeVersion}`, 'data-github-repo': homepage },
+				{ name: 'mobile-web-app-capable', content: 'yes' },
+			],
+			link: [
+				{ rel: 'stylesheet', href: 'https://s4.zstatic.net/npm/katex@0.16.44/dist/katex.min.css' },
+				// "InterVariable", "Inter"
+				{ rel: 'stylesheet', href: 'https://s4.zstatic.net/npm/inter-ui@4.1.1/inter-variable.css' },
+				{ rel: 'stylesheet', href: 'https://s4.zstatic.net/npm/inter-ui@4.1.1/inter.css' },
+				// "JetBrains Mono", 思源宋体 "Noto Serif SC"
+				{ rel: 'preconnect', href: 'https://fonts.gstatic.cn', crossorigin: '' },
+				{ rel: 'stylesheet', href: 'https://fonts.googleapis.cn/css2?family=JetBrains+Mono:ital,wght@0,100..800;1,100..800&family=Noto+Serif+SC:wght@200..900&display=swap' },
+			],
+			templateParams: {
+				separator: '|',
+			},
+		},
+		rootAttrs: {
+			id: 'blog-root',
+		},
+	},
+
+	compatibilityDate: '2024-08-03',
+
+	components: [
+		{ path: toThemePath('app/components/partial'), prefix: 'Z' },
+		toThemePath('app/components'),
+	],
+
+	// @keep-sorted
+	css: [
+		toThemePath('app/assets/css/animation.scss'),
+		toThemePath('app/assets/css/article.scss'),
+		toThemePath('app/assets/css/color.scss'),
+		toThemePath('app/assets/css/font.scss'),
+		toThemePath('app/assets/css/main.scss'),
+		toThemePath('app/assets/css/reusable.scss'),
+	],
+
+	// @keep-sorted
+	experimental: {
+		extractAsyncDataHandlers: true,
+		typescriptPlugin: true,
+	},
+
+	// @keep-sorted
+	modules: [
+		'@bikariya/image-viewer',
+		'@bikariya/modals',
+		'@bikariya/shiki',
+		'@nuxt/content',
+		'@nuxt/icon',
+		'@nuxt/image',
+		'@nuxtjs/color-mode',
+		'@nuxtjs/seo',
+		'@pinia/nuxt',
+		'@vueuse/nuxt',
+		// Layer 配置中的相对 module 路径会以消费项目为基准解析，必须使用绝对路径；
+		// 且 clarity-config 必须先于 nuxt-llms 运行：后者在 setup 时读取注入的 llms 站点配置
+		toThemePath('modules/clarity-config'),
+		'nuxt-llms',
+	],
+
+	nitro: {
+		prerender: {
+			// 修复部分平台会在文章路径后添加 `/`，导致闪现 404 错误
+			// https://github.com/nuxt/content/issues/2378
+			autoSubfolderIndex: CLOUDFLARE_PAGES || GITHUB_ACTIONS || NETLIFY ? false : undefined,
+		},
+	},
+
+	runtimeConfig: {
+		// @keep-sorted
+		public: {
+			arch,
+			buildTime: Temporal.Now.zonedDateTimeISO().toString(),
+			// EdgeOne 检测暂时不可用
+			ci: env.TENCENTCLOUD_RUNENV === 'SCF' ? 'EdgeOne' : ciName || '',
+			nodeVersion,
+			platform,
+		},
+	},
+
+	typescript: {
+		nodeTsConfig: {
+			// @keep-sorted
+			include: [
+				'../config/**/*.ts',
+				'../remark-plugins/**/*.ts',
+			],
+		},
+	},
+
+	vite: {
+		css: {
+			preprocessorOptions: {
+				scss: {
+					additionalData: `@use "${toThemePath('app/assets/css/_variable.scss')}" as *;`,
+				},
+			},
+		},
+		// @keep-sorted
+		optimizeDeps: {
+			include: ['@shikijs/colorized-brackets', '@shikijs/transformers', '@unhead/schema-org/vue', '@vue/devtools-core', '@vue/devtools-kit', 'embla-carousel-autoplay', 'embla-carousel-vue', 'embla-carousel-wheel-gestures', 'es-toolkit/array', 'es-toolkit/math', 'es-toolkit/object', 'es-toolkit/promise', 'es-toolkit/string', 'minisearch', 'parse-domain', 'plain-shiki', 'shiki/themes/catppuccin-latte.mjs', 'shiki/themes/one-dark-pro.mjs', 'temporal-polyfill', 'vue-tippy'],
+		},
+		server: {
+			allowedHosts: true,
+		},
+	},
+
+	colorMode: {
+		preference: 'system',
+		fallback: 'light',
+		classSuffix: '',
+	},
+
+	content: {
+		build: {
+			markdown: {
+				highlight: false,
+				// @keep-sorted
+				remarkPlugins: {
+					[pluginPath('remark-code-component')]: {
+						options: {
+							'mermaid': { component: 'mermaid', prop: 'code' },
+							'music-abc': { component: 'music-score', prop: 'abc' },
+						},
+					},
+					'remark-math': {},
+					'remark-reading-time': {},
+				},
+				// @keep-sorted
+				rehypePlugins: {
+					[pluginPath('rehype-meta-slots')]: {},
+					'rehype-katex': {},
+				},
+				toc: { depth: 4, searchDepth: 4 },
+			},
+		},
+		experimental: {
+			sqliteConnector: 'native',
+		},
+	},
+
+	dxup: {
+		features: {
+			// 页面通过 <template #aside> 向布局具名插槽传参
+			namedLayoutSlots: true,
+		},
+	},
+
+	hooks: {
+		ready: () => {
+			console.info(`
+================================
+${themeName} ${themeVersion}
+${homepage}
+================================
+`)
+		},
+	},
+
+	icon: {
+		customCollections: [
+			{ prefix: 'clarity', dir: toThemePath('app/assets/icons') },
+		],
+		clientBundle: {
+			scan: {
+				globInclude: ['**\/*.{vue,jsx,tsx,ts,md,mdc,mdx}'],
+			},
+		},
+	},
+
+	image: {
+		densities: [1, 1.5, 2],
+		format: ['avif', 'webp'],
+		// Netlify 下 netlify 处理器无法显示站外图片，ipx 处理器无法显示站内图片，需彻底禁用
+		// https://github.com/nuxt/image/issues/1353
+		provider: NETLIFY ? 'none' : undefined,
+	},
+
+	linkChecker: {
+		// @keep-sorted
+		skipInspections: [
+			'no-baseless',
+			'no-non-ascii-chars',
+			'no-uppercase-chars',
+		],
+	},
+
+	ogImage: {
+		enabled: false,
+	},
+
+	robots: {
+		disableNuxtContentIntegration: true,
+	},
+})

package/package.json

@@ -0,0 +1,148 @@
+{
+  "name": "clarity-theme",
+  "type": "module",
+  "version": "0.1.0",
+  "packageManager": "pnpm@12.4.1",
+  "description": "Clarity Theme — 从 blog-v3 提取的可复用 Nuxt 4 Layer 博客主题",
+  "license": "MIT",
+  "homepage": "https://github.com/iicemeta/clarity-theme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iicemeta/clarity-theme.git"
+  },
+  "bugs": {
+    "url": "https://github.com/iicemeta/clarity-theme/issues"
+  },
+  "exports": {
+    ".": "./nuxt.config.ts",
+    "./config": {
+      "types": "./config/index.d.mts",
+      "default": "./config/index.mjs"
+    },
+    "./content": {
+      "types": "./config/content.d.mts",
+      "default": "./config/content.mjs"
+    },
+    "./img": {
+      "types": "./img/index.d.mts",
+      "default": "./img/index.mjs"
+    },
+    "./schema": {
+      "types": "./config/schema.d.mts",
+      "default": "./config/schema.mjs"
+    }
+  },
+  "main": "./nuxt.config.ts",
+  "files": [
+    "LICENSE",
+    "README.md",
+    "app",
+    "config",
+    "img",
+    "modules",
+    "nuxt.config.ts",
+    "package.json",
+    "public",
+    "remark-plugins",
+    "server",
+    "shared"
+  ],
+  "engines": {
+    "node": "^22.19 || ^24.11 || >=26"
+  },
+  "scripts": {
+    "dev": "pnpm --dir playground dev",
+    "build": "pnpm --dir playground build",
+    "generate": "pnpm --dir playground generate",
+    "lint": "eslint && stylelint \"app/**/*.{vue,scss}\" \"playground/app/**/*.vue\"",
+    "lint:fix": "eslint --fix && stylelint \"app/**/*.{vue,scss}\" \"playground/app/**/*.vue\" --fix",
+    "typecheck": "pnpm --dir playground typecheck",
+    "verify": "node scripts/verify-theme.mjs",
+    "test:sync": "node --test tests/sync-upstream.test.mjs",
+    "test:migration": "node --test tests/migration-skill.test.mjs",
+    "test:contract": "node scripts/test-compatibility.mjs --contract-only",
+    "test:release": "pnpm verify && pnpm test:consumer && pnpm test:compatibility",
+    "test:consumer": "node scripts/test-consumer.mjs",
+    "test:compatibility": "node scripts/test-compatibility.mjs",
+    "sync:check": "node scripts/sync-upstream.mjs check",
+    "sync:diff": "node scripts/sync-upstream.mjs diff",
+    "sync:apply": "node scripts/sync-upstream.mjs apply",
+    "sync:verify": "node scripts/sync-upstream.mjs verify"
+  },
+  "peerDependencies": {
+    "nuxt": "^4.5.2",
+    "vue": "^3.5.42"
+  },
+  "dependencies": {
+    "@bikariya/image-viewer": "^0.0.8",
+    "@bikariya/modals": "^0.0.8",
+    "@bikariya/shiki": "^0.0.8",
+    "@iconify-json/catppuccin": "^1.2.17",
+    "@iconify-json/line-md": "^1.2.16",
+    "@iconify-json/ri": "^1.2.10",
+    "@iconify-json/simple-icons": "^1.2.94",
+    "@iconify-json/tabler": "^1.2.38",
+    "@nuxt/content": "^3.16.0",
+    "@nuxt/icon": "^2.5.1",
+    "@nuxt/image": "^2.1.0",
+    "@nuxtjs/color-mode": "^4.0.1",
+    "@nuxtjs/seo": "^5.3.14",
+    "@nuxtjs/sitemap": "^8.5.1",
+    "@pinia/nuxt": "^1.0.2",
+    "@shikijs/colorized-brackets": "^4.4.3",
+    "@shikijs/transformers": "^4.4.3",
+    "@vueuse/core": "^14.4.0",
+    "@vueuse/nuxt": "^14.4.0",
+    "@vueuse/router": "^14.4.0",
+    "abcjs": "^6.7.0",
+    "ci-info": "^4.4.0",
+    "embla-carousel-autoplay": "^8.6.0",
+    "embla-carousel-vue": "^8.6.0",
+    "embla-carousel-wheel-gestures": "^8.1.0",
+    "es-toolkit": "^1.52.0",
+    "fast-xml-builder": "^1.3.1",
+    "jiti": "^2.3.0",
+    "mermaid": "^11.17.2",
+    "minisearch": "^7.2.0",
+    "nuxt-llms": "^0.2.0",
+    "oxc-minify": "^0.148.0",
+    "parse-domain": "^8.4.0",
+    "pinia": "^4.0.3",
+    "plain-shiki": "^0.3.2",
+    "reading-time": "^1.5.0",
+    "rehype-katex": "^7.0.1",
+    "remark-math": "^6.0.0",
+    "remark-reading-time": "^2.1.0",
+    "sass-embedded": "^1.104.0",
+    "shiki": "^4.4.3",
+    "site-config-stack": "^4.2.3",
+    "temporal-polyfill": "^1.0.4",
+    "ufo": "^1.6.0",
+    "unist-util-visit": "^5.1.0",
+    "vfile": "^6.0.3",
+    "vue-tippy": "^6.7.1",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^9.5.1",
+    "@nuxt/a11y": "1.0.0-alpha.1",
+    "@nuxt/hints": "^1.1.4",
+    "@stylistic/stylelint-plugin": "^5.2.1",
+    "@types/hast": "^3.0.5",
+    "@zinkawaii/stylelint-config": "^0.5.2",
+    "cspell": "^10.2.2",
+    "eslint": "^10.10.0",
+    "minimark": "0.2.0",
+    "nuxt": "^4.5.2",
+    "postcss-html": "^1.8.0",
+    "postcss-scss": "^4.0.9",
+    "rimraf": "^6.1.3",
+    "stylelint": "^17.15.0",
+    "stylelint-config-html": "^1.1.0",
+    "stylelint-config-standard": "^40.0.0",
+    "stylelint-order": "^8.1.1",
+    "typescript": "^6.0.3",
+    "vue": "^3.5.42",
+    "vue-router": "^5.3.1"
+  }
+}