clarity-theme 0.1.0 → 0.1.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Zhilu
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+MIT License
+
+Copyright (c) 2024 Zhilu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.

package/README.md

@@ -25,14 +25,24 @@ Clarity Theme is a reusable **Nuxt 4 Layer blog theme** extracted from [L33Z22L1
 | Nuxt peer | `^4.5.2` |
 | Vue peer | `^3.5.42` |
 
-The package is not currently available from the npm registry. Install it as a Git dependency pinned to a reviewed commit until the first package release is published. Clarity is part of your application runtime, so install it as a regular dependency rather than a development dependency.
+Clarity is available from the npm registry as `clarity-theme`. It is part of your application runtime (the Nuxt build and static generation load the Layer directly), so install it as a regular dependency rather than a development dependency; a production install must still be able to resolve it.
 
 ## Installation
 
+```bash
+pnpm add clarity-theme
+```
+
+### Git commit installation (development fallback)
+
+For unreleased commits, local debugging, or reviewing a specific change before it is published, install directly from GitHub instead:
+
 ```bash
 pnpm add github:iicemeta/clarity-theme#<commit>
 ```
 
+This path is intended for development only. Released sites should consume the published npm version so installs are reproducible and covered by the release verification matrix.
+
 ## Quick Start
 
 ### 1. Extend the Layer
@@ -83,7 +93,9 @@ Place articles under `content/posts/` and other Content pages under `content/`.
 // feeds.ts
 import type { FeedGroup } from 'clarity-theme/config'
 
-export default [] satisfies FeedGroup[]
+const feeds: FeedGroup[] = []
+
+export default feeds
 ```
 
 Without this file, the friend page and OPML output use empty data and the build logs a warning.
@@ -229,6 +241,8 @@ All documents are also available in 简体中文 as sibling `*.zh-CN.md` files.
 | [Patches](./docs/PATCHES.md) | Consumer patch ownership and current conclusions |
 | [Release audit](./docs/RELEASE-AUDIT.md) | Pre-closing engineering audit and remaining release gates |
 | [Release checklist](./docs/RELEASE-CHECKLIST.md) | Exact final checks, remaining blockers, and verification evidence |
+| [Publishing](./docs/PUBLISHING.md) | Versioning, tags, GitHub Releases, OIDC publishing, provenance, and rollback policy |
+| [Changelog](./CHANGELOG.md) | Consumer-facing release history |
 | [Extraction history](./docs/history/2026-09-layer-extraction.md) | Historical phases and one-time differential validation |
 
 ## Development
@@ -267,9 +281,9 @@ The weekly workflow only detects and reports drift. It never applies, commits, o
 
 ## Release Status
 
-Clarity Theme is a **v0.1.0 pre-publish Layer candidate**. The Layer/package boundary, validated configuration, Content factory, rendering pipeline, server outputs, playground, real-consumer acceptance, compatibility matrix, three-layer CI, and upstream-sync baseline are implemented.
+Clarity Theme is a **v0.1.1 gated npm release**. The Layer/package boundary, validated configuration, Content factory, rendering pipeline, server outputs, playground, real-consumer acceptance, compatibility matrix, three-layer CI, upstream-sync baseline, release gate, and OIDC publish workflow are implemented. See the [release checklist](./docs/RELEASE-CHECKLIST.md) for the exact remaining manual publication steps.
 
-The first npm release is intentionally still blocked by the P0 correctness items in [Roadmap](./docs/ROADMAP.md)—especially the server/client configuration split, feature-off route semantics, anti-mirror navigation verification, and the no-op random-permalink contract—and by an exact-commit release run. Migration documentation and repeatability are being completed in this release-closing phase.
+The v0.1.0 correctness gates from [Roadmap](./docs/ROADMAP.md) are resolved: server/client configuration is split, feature-off routes return 404 at runtime, anti-mirror navigation is verified in a real browser, the no-op random-permalink field is removed, and multi-pattern stats are covered by a regression test. Remaining deferred items are recorded in the roadmap and release notes.
 
 ## License
 

package/README.zh-CN.md

@@ -25,14 +25,24 @@ Clarity Theme 是一个从 [L33Z22L11/blog-v3](https://github.com/L33Z22L11/blog
 | Nuxt peer | `^4.5.2` |
 | Vue peer | `^3.5.42` |
 
-该包目前尚未发布到 npm 注册表。在第一个包版本发布之前，请以锁定到已审查 commit 的 Git 依赖方式安装。Clarity 属于应用运行时的一部分，因此请将其安装为常规依赖（dependency），而不是开发依赖（devDependency）。
+Clarity 已通过 npm 注册表以 `clarity-theme` 分发。它属于应用运行时的一部分（Nuxt 构建与静态生成会直接加载 Layer），因此请将其安装为常规依赖（dependency），而不是开发依赖（devDependency）；生产环境安装也必须能解析到它。
 
 ## 安装
 
+```bash
+pnpm add clarity-theme
+```
+
+### Git commit 安装（开发回退方式）
+
+如需使用未发布的 commit、本地调试，或在发布前审查某个具体变更，可以直接从 GitHub 安装：
+
 ```bash
 pnpm add github:iicemeta/clarity-theme#<commit>
 ```
 
+该方式仅用于开发场景。正式站点应使用已发布的 npm 版本，以保证安装可复现并被发布验证矩阵覆盖。
+
 ## 快速开始
 
 ### 1. 继承 Layer
@@ -83,7 +93,9 @@ export default createClarityContentConfig(clarityConfig)
 // feeds.ts
 import type { FeedGroup } from 'clarity-theme/config'
 
-export default [] satisfies FeedGroup[]
+const feeds: FeedGroup[] = []
+
+export default feeds
 ```
 
 如果没有这个文件，友链页面和 OPML 输出会使用空数据，并且构建时会记录一条警告。
@@ -250,6 +262,8 @@ UI 分组、同路径组件覆盖、CSS 覆盖、服务端/路由自定义与 Sh
 | [补丁说明](./docs/PATCHES.zh-CN.md) | 使用方补丁归属与当前结论 |
 | [发布审计](./docs/RELEASE-AUDIT.zh-CN.md) | 收尾前工程审计与剩余发布门槛 |
 | [发布清单](./docs/RELEASE-CHECKLIST.zh-CN.md) | 确切的最终检查、剩余阻塞项与验证证据 |
+| [发布指南](./docs/PUBLISHING.zh-CN.md) | 版本管理、tag、GitHub Release、OIDC 发布、provenance 与回滚策略 |
+| [更新日志](./CHANGELOG.md) | 面向使用者的发布历史 |
 | [抽取历史](./docs/history/2026-09-layer-extraction.zh-CN.md) | 历史阶段与一次性差分验证 |
 
 ## 开发
@@ -288,9 +302,9 @@ pnpm sync:verify  # 重新运行主题纯度与基线检查
 
 ## 发布状态
 
-Clarity Theme 是一个 **v0.1.0 发布前 Layer 候选版本**。Layer/包边界、已校验配置、Content 工厂、渲染管线、服务端输出、playground、真实消费者验收、兼容性矩阵、三层 CI 与上游同步基线均已实现。
+Clarity Theme 是一个 **v0.1.1 门禁 npm 发布版本**。Layer/包边界、已校验配置、Content 工厂、渲染管线、服务端输出、playground、真实消费者验收、兼容性矩阵、三层 CI、上游同步基线、发布门禁与 OIDC 发布工作流均已实现。剩余的人工发布步骤见[发布检查清单](./docs/RELEASE-CHECKLIST.zh-CN.md)。
 
-首次 npm 发布仍被[路线图](./docs/ROADMAP.zh-CN.md)中的 P0 正确性事项刻意阻塞——尤其是服务端/客户端配置拆分、功能关闭时的路由语义、反镜像导航验证与 no-op 随机固定链接契约——同时还需要一次在确切 commit 上的发布运行。迁移文档与可复现性正在本次收尾阶段完成。
+[路线图](./docs/ROADMAP.zh-CN.md)中的 v0.1.0 正确性门禁已解决：服务端/客户端配置已拆分、功能关闭路由在运行时返回 404、反镜像导航已在真实浏览器中验证、no-op 随机固定链接字段已移除，多模式统计已增加回归测试。其余推迟事项记录在路线图与发布说明中。
 
 ## 许可证
 

package/app/app.config.ts

@@ -1,110 +1,110 @@
-/**
- * Clarity Theme UI 默认配置。
- *
- * 站点数据（标题、作者、文章分类等）来自根目录 clarity.config.ts，
- * 由 modules/clarity-config 注入到 appConfig.clarity 中。
- *
- * 消费项目可在自己的 app/app.config.ts 中按需覆盖任意键。
- */
-export default defineAppConfig({
-	clarity: {
-		// @keep-sorted
-		component: {
-			alert: {
-				/** 默认使用卡片风格还是扁平风格 */
-				defaultStyle: 'card' as 'card' | 'flat',
-			},
-
-			codeblock: {
-				/** 代码块触发折叠的行数 */
-				triggerRows: 32,
-				/** 代码块折叠后的行数 */
-				collapsedRows: 16,
-				/** 启用代码块缩进导航会关闭空格渲染 */
-				enableIndentGuide: true,
-				/** 代码块缩进导航竖线匹配空格数 */
-				indent: 4,
-				/** tab 渲染宽度 */
-				tabSize: 3,
-			},
-
-			/** 文章开头摘要 */
-			excerpt: {
-				animation: true,
-				caret: '_',
-			},
-
-			/** 精选文章 Slide */
-			slide: {
-				/** 适合封面图无字时启用 */
-				showTitle: true,
-			},
-
-			stats: {
-				/** 归档页面每年标题对应的年龄，无需展示时可留空 */
-				birthYear: undefined as number | undefined,
-			},
-		},
-
-		// @keep-sorted
-		footer: {
-			/** 侧边栏底部图标导航 */
-			iconNav: [] as { icon: string, text: string, url: string }[],
-			/** 页脚站点地图 */
-			nav: [] as {
-				title: string
-				items: { icon: string, text: string, url: string }[]
-			}[],
-		},
-
-		/** 左侧栏顶部 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' },
-				],
-			},
-		],
-
-		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: '深色模式',
-			},
-		},
-	},
-})
+/**
+ * Clarity Theme UI 默认配置。
+ *
+ * 站点数据（标题、作者、文章分类等）来自根目录 clarity.config.ts，
+ * 由 modules/clarity-config 注入到 appConfig.clarity 中。
+ *
+ * 消费项目可在自己的 app/app.config.ts 中按需覆盖任意键。
+ */
+export default defineAppConfig({
+	clarity: {
+		// @keep-sorted
+		component: {
+			alert: {
+				/** 默认使用卡片风格还是扁平风格 */
+				defaultStyle: 'card' as 'card' | 'flat',
+			},
+
+			codeblock: {
+				/** 代码块触发折叠的行数 */
+				triggerRows: 32,
+				/** 代码块折叠后的行数 */
+				collapsedRows: 16,
+				/** 启用代码块缩进导航会关闭空格渲染 */
+				enableIndentGuide: true,
+				/** 代码块缩进导航竖线匹配空格数 */
+				indent: 4,
+				/** tab 渲染宽度 */
+				tabSize: 3,
+			},
+
+			/** 文章开头摘要 */
+			excerpt: {
+				animation: true,
+				caret: '_',
+			},
+
+			/** 精选文章 Slide */
+			slide: {
+				/** 适合封面图无字时启用 */
+				showTitle: true,
+			},
+
+			stats: {
+				/** 归档页面每年标题对应的年龄，无需展示时可留空 */
+				birthYear: undefined as number | undefined,
+			},
+		},
+
+		// @keep-sorted
+		footer: {
+			/** 侧边栏底部图标导航 */
+			iconNav: [] as { icon: string, text: string, url: string }[],
+			/** 页脚站点地图 */
+			nav: [] as {
+				title: string
+				items: { icon: string, text: string, url: string }[]
+			}[],
+		},
+
+		/** 左侧栏顶部 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' },
+				],
+			},
+		],
+
+		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/app/app.vue

@@ -1,5 +1,5 @@
-<template>
-<NuxtLayout>
-	<NuxtPage />
-</NuxtLayout>
-</template>
+<template>
+<NuxtLayout>
+	<NuxtPage />
+</NuxtLayout>
+</template>

package/app/components/blog/BlogAside.vue

@@ -1,27 +1,27 @@
-<script setup lang="ts">
-const layoutStore = useLayoutStore()
-
-// 页面完成异步 setup 后才注册具名插槽；水合前等待，避免重复插入 SSR 侧栏。
-const layoutSlots = inject<{ ready: Promise<void> }>(Symbol.for('dxup:layout-slots'))
-if (layoutSlots)
-	await layoutSlots.ready
-</script>
-
-<template>
-<BlogMask
-	:show="layoutStore.state === 'aside'"
-	class="widescreen-only"
-	@click="layoutStore.close()"
-/>
-
-<!-- 不能用 Transition 实现弹出收起动画，因为宽屏状态始终显示 -->
-<!-- 如果为空数组则隐藏 -->
-<aside id="blog-aside" :class="{ show: layoutStore.state === 'aside' }">
-	<slot />
-</aside>
-</template>
-
-<style lang="scss" scoped>
+<script setup lang="ts">
+const layoutStore = useLayoutStore()
+
+// 页面完成异步 setup 后才注册具名插槽；水合前等待，避免重复插入 SSR 侧栏。
+const layoutSlots = inject<{ ready: Promise<void> }>(Symbol.for('dxup:layout-slots'))
+if (layoutSlots)
+	await layoutSlots.ready
+</script>
+
+<template>
+<BlogMask
+	:show="layoutStore.state === 'aside'"
+	class="widescreen-only"
+	@click="layoutStore.close()"
+/>
+
+<!-- 不能用 Transition 实现弹出收起动画，因为宽屏状态始终显示 -->
+<!-- 如果为空数组则隐藏 -->
+<aside id="blog-aside" :class="{ show: layoutStore.state === 'aside' }">
+	<slot />
+</aside>
+</template>
+
+<style lang="scss" scoped>
 #blog-aside {
 	display: flex;
 	flex-direction: column;
@@ -60,4 +60,4 @@ if (layoutSlots)
 		display: none;
 	}
 }
-</style>
+</style>

package/app/components/blog/BlogFooter.vue

@@ -1,27 +1,27 @@
-<script setup lang="ts">
-const clarity = useClarityConfig()
-</script>
-
-<template>
-<footer class="blog-footer">
-	<nav class="footer-nav">
-		<div v-for="(group, groupIndex) in clarity.footer.nav" :key="groupIndex">
-			<hgroup class="text-creative" v-text="group.title" />
-			<menu>
-				<li v-for="(item, itemIndex) in group.items" :key="itemIndex">
-					<UtilLink :to="item.url">
-						<Icon :name="item.icon" />
-						<span class="nav-text">{{ item.text }}</span>
-					</UtilLink>
-				</li>
-			</menu>
-		</div>
-	</nav>
-	<p v-html="clarity.footer.copyright" />
-</footer>
-</template>
-
-<style lang="scss" scoped>
+<script setup lang="ts">
+const clarity = useClarityConfig()
+</script>
+
+<template>
+<footer class="blog-footer">
+	<nav class="footer-nav">
+		<div v-for="(group, groupIndex) in clarity.footer.nav" :key="groupIndex">
+			<hgroup class="text-creative" v-text="group.title" />
+			<menu>
+				<li v-for="(item, itemIndex) in group.items" :key="itemIndex">
+					<UtilLink :to="item.url">
+						<Icon :name="item.icon" />
+						<span class="nav-text">{{ item.text }}</span>
+					</UtilLink>
+				</li>
+			</menu>
+		</div>
+	</nav>
+	<p v-html="clarity.footer.copyright" />
+</footer>
+</template>
+
+<style lang="scss" scoped>
 .blog-footer {
 	margin: 3rem 1rem;
 	font-size: 0.9em;
@@ -58,4 +58,4 @@ const clarity = useClarityConfig()
 		margin: 0.5em;
 	}
 }
-</style>
+</style>

package/app/components/blog/BlogHeader.global.vue

@@ -1,50 +1,50 @@
-<script setup lang="ts">
-withDefaults(defineProps<{
-	tag?: string
-}>(), {
-	tag: 'div',
-})
-const clarity = useClarityConfig()
-</script>
-
-<template>
-<UtilLink class="blog-header">
-	<div v-if="clarity.header.emojiTail" class="emoji-tail">
-		<span
-			v-for="(emoji, emojiIndex) in clarity.header.emojiTail"
-			:key="emojiIndex"
-			class="split-char"
-			:style="getFixedDelay(emojiIndex * .6 - 3)"
-			v-text="emoji"
-		/>
-	</div>
-
-	<NuxtImg
-		:src="clarity.header.logo"
-		class="blog-logo round-cobblestone"
-		:class="{ circle: clarity.header.showTitle }"
-		:alt="clarity.site.title"
-	/>
-
-	<div v-if="clarity.header.showTitle" class="blog-text">
-		<component :is="tag" class="header-title">
-			<span
-				v-for="(char, charIndex) in clarity.site.title"
-				:key="charIndex"
-				class="split-char"
-				:style="getFixedDelay((charIndex + 1) * .1)"
-				v-text="char"
-			/>
-		</component>
-
-		<div class="header-subtitle">
-			{{ clarity.header.subtitle }}
-		</div>
-	</div>
-</UtilLink>
-</template>
-
-<style lang="scss" scoped>
+<script setup lang="ts">
+withDefaults(defineProps<{
+	tag?: string
+}>(), {
+	tag: 'div',
+})
+const clarity = useClarityConfig()
+</script>
+
+<template>
+<UtilLink class="blog-header">
+	<div v-if="clarity.header.emojiTail" class="emoji-tail">
+		<span
+			v-for="(emoji, emojiIndex) in clarity.header.emojiTail"
+			:key="emojiIndex"
+			class="split-char"
+			:style="getFixedDelay(emojiIndex * .6 - 3)"
+			v-text="emoji"
+		/>
+	</div>
+
+	<NuxtImg
+		:src="clarity.header.logo"
+		class="blog-logo round-cobblestone"
+		:class="{ circle: clarity.header.showTitle }"
+		:alt="clarity.site.title"
+	/>
+
+	<div v-if="clarity.header.showTitle" class="blog-text">
+		<component :is="tag" class="header-title">
+			<span
+				v-for="(char, charIndex) in clarity.site.title"
+				:key="charIndex"
+				class="split-char"
+				:style="getFixedDelay((charIndex + 1) * .1)"
+				v-text="char"
+			/>
+		</component>
+
+		<div class="header-subtitle">
+			{{ clarity.header.subtitle }}
+		</div>
+	</div>
+</UtilLink>
+</template>
+
+<style lang="scss" scoped>
 .blog-header {
 	contain: layout;
 	display: flex;
@@ -143,4 +143,4 @@ const clarity = useClarityConfig()
 		filter: blur(1px);
 	}
 }
-</style>
+</style>