refactor(project structure): restructure project to feature-driven architecture

- Move release sorter core logic to features/release-sorter/core.ts
- Add Vue composable for release sorter state management
- Relocate ScrollToTopButton to features/scroll-to-top/
- Move shared components and styles to shared/ directory
- Update import paths across the codebase
- Replace deprecated biome lint/format commands with biome check
- Switch from pnpm to bun in README and scripts
- Remove unused Vite and Vue SVG assets
- Update AGENTS.md and README.md to document new architecture

Author: ChouChiu

AGENTS.md

@@ -16,10 +16,32 @@ No test framework. Run `bun run lint` and `bun run build` (includes type-check)
 - **Package manager**: bun (lockfile: `bun.lock`). There is also a `pnpm-lock.yaml` — ignore it.
 - **Vue is external**: bundled via CDN (`vue.global.prod.js`), not in the output JS. Do not add Vue to the build bundle.
 - **Userscript grants**: `GM_addStyle`, `GM_getValue`, `GM_setValue` — declared in `vite.config.ts`. These are the only GM APIs available.
-- **Release sorter is DOM-based**: `initReleaseSorter()` in `src/utils/release-sorter.ts` runs before Vue mounts and operates on raw DOM. Vue components call `sortAndHighlight()` to trigger re-sorting after preference changes.
+- **Release sorter is DOM-based**: `initReleaseSorter()` in `src/features/release-sorter/core.ts` runs before Vue mounts and operates on raw DOM. Vue components call `sortAndHighlight()` to trigger re-sorting after preference changes.
 - **GitHub Turbo navigation**: The script listens to `turbo:load` events and uses a `MutationObserver` on `document.body` to re-run sorting on SPA navigation. Both use 100ms debounce.
 - **Biome overrides for `.vue` files**: `noUnusedVariables` and `noUnusedImports` are disabled for Vue SFCs (Biome can't parse Vue templates properly).
 
+## Project Structure
+
+```
+src/
+├── features/
+│   ├── scroll-to-top/
+│   │   └── ScrollToTopButton.vue
+│   └── release-sorter/
+│       ├── ReleaseSorterSettings.vue
+│       ├── core.ts              # DOM manipulation, sorting logic
+│       ├── composable.ts        # Vue-facing exports, types, constants
+│       └── index.ts             # Public API barrel export
+├── shared/
+│   ├── components/
+│   │   └── SettingsPanel.vue
+│   └── styles/
+│       └── global.css
+├── App.vue
+├── main.ts
+└── vite-env.d.ts
+```
+
 ## Code style
 
 - Tabs for indent, double quotes (enforced by Biome)

README.md

@@ -17,30 +17,39 @@
 
 ```bash
 # 安装依赖
-pnpm install
+bun install
 
 # 启动开发服务器（自动注入用户脚本到浏览器）
-pnpm dev
+bun dev
 
-# 构建生产版本
-pnpm build
+# 构建生产版本（含类型检查）
+bun run build
 
-# 代码检查 & 格式化
-pnpm lint
-pnpm format
+# 代码检查
+bun run lint
+
+# 代码格式化
+bun run format
 ```
 
 ## 项目结构
 
 ```
 src/
-├── main.ts                          # 入口，初始化 release sorter 并挂载 Vue
-├── App.vue                          # 根组件
-├── style.css                        # 全局样式 + 高亮样式
-├── components/
-│   ├── ScrollToTopButton.vue        # 返回顶部按钮
-│   ├── SettingsPanel.vue            # 通用设置面板（齿轮按钮 + 弹出面板容器）
-│   └── ReleaseSorterSettings.vue    # Release 排序设置内容
-└── utils/
-    └── release-sorter.ts            # 排序/高亮核心逻辑与存储
+├── main.ts                              # 入口，初始化 release sorter 并挂载 Vue
+├── App.vue                              # 根组件
+├── vite-env.d.ts                        # Vite 类型声明
+├── features/
+│   ├── scroll-to-top/
+│   │   └── ScrollToTopButton.vue        # 返回顶部按钮（含滚动进度环）
+│   └── release-sorter/
+│       ├── ReleaseSorterSettings.vue    # Release 排序设置 UI
+│       ├── core.ts                      # DOM 操作、排序逻辑、存储
+│       ├── composable.ts                # Vue composable 及类型导出
+│       └── index.ts                     # 公共 API 导出
+└── shared/
+    ├── components/
+    │   └── SettingsPanel.vue            # 通用设置面板（齿轮按钮 + 弹出容器）
+    └── styles/
+        └── global.css                   # 全局样式 + 高亮样式
 ```

package.json

@@ -14,8 +14,8 @@
 		"dev": "vite",
 		"build": "vue-tsc -b && vite build",
 		"preview": "vite preview",
-		"lint": "biome lint .",
-		"format": "biome format --write ."
+		"lint": "biome check .",
+		"format": "biome check --write ."
 	},
 	"dependencies": {
 		"vue": "^3.5.38"

src/App.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
-import ScrollToTopButton from "./components/ScrollToTopButton.vue";
-import SettingsPanel from "./components/SettingsPanel.vue";
-import ReleaseSorterSettings from "./components/ReleaseSorterSettings.vue";
+import ReleaseSorterSettings from "./features/release-sorter/ReleaseSorterSettings.vue";
+import ScrollToTopButton from "./features/scroll-to-top/ScrollToTopButton.vue";
+import SettingsPanel from "./shared/components/SettingsPanel.vue";
 </script>
 
 <template>

src/assets/vite.svg

@@ -1,64 +1,27 @@
 <script setup lang="ts">
-import { ref, computed } from "vue";
 import {
-	OS_OPTIONS,
-	OS_LABELS,
-	ARCH_OPTIONS,
 	ARCH_LABELS,
-	PKG_OPTIONS,
-	PKG_LABELS,
-	type OsOption,
-	type ArchOption,
-	type PkgOption,
-	getSelectedOs,
-	setSelectedOs,
-	getSelectedArch,
-	setSelectedArch,
-	getSelectedPkg,
-	setSelectedPkg,
-	detectPlatform,
+	ARCH_OPTIONS,
 	detectArch,
-	sortAndHighlight,
-	getKeywordsPreview,
-} from "../utils/release-sorter";
-
-const selectedOs = ref<OsOption>(getSelectedOs());
-const selectedArch = ref<ArchOption>(getSelectedArch());
-const selectedPkg = ref<PkgOption>(getSelectedPkg());
-
-const resolvedPlatform = computed(() => {
-	return selectedOs.value === "auto" ? detectPlatform() : selectedOs.value;
-});
-
-const resolvedArch = computed(() => {
-	return selectedArch.value === "auto" ? detectArch() : selectedArch.value;
-});
-
-const keywords = computed(() => {
-	return getKeywordsPreview(
-		selectedOs.value,
-		selectedArch.value,
-		selectedPkg.value,
-	);
-});
-
-function selectOs(os: OsOption) {
-	selectedOs.value = os;
-	setSelectedOs(os);
-	sortAndHighlight();
-}
-
-function selectArch(arch: ArchOption) {
-	selectedArch.value = arch;
-	setSelectedArch(arch);
-	sortAndHighlight();
-}
-
-function selectPkg(pkg: PkgOption) {
-	selectedPkg.value = pkg;
-	setSelectedPkg(pkg);
-	sortAndHighlight();
-}
+	detectPlatform,
+	OS_LABELS,
+	OS_OPTIONS,
+	PKG_LABELS,
+	PKG_OPTIONS,
+	useReleaseSorter,
+} from "./composable";
+
+const {
+	selectedOs,
+	selectedArch,
+	selectedPkg,
+	resolvedPlatform,
+	resolvedArch,
+	keywords,
+	selectOs,
+	selectArch,
+	selectPkg,
+} = useReleaseSorter();
 </script>
 
 <template>

src/assets/vue.svg

@@ -0,0 +1,91 @@
+import { computed, ref } from "vue";
+import {
+	type ArchOption,
+	detectArch,
+	detectPlatform,
+	getKeywordsPreview,
+	getSelectedArch,
+	getSelectedOs,
+	getSelectedPkg,
+	type OsOption,
+	type PkgOption,
+	setSelectedArch,
+	setSelectedOs,
+	setSelectedPkg,
+	sortAndHighlight,
+} from "./core";
+
+export {
+	ARCH_LABELS,
+	ARCH_OPTIONS,
+	type ArchOption,
+	detectArch,
+	detectPlatform,
+	getKeywordsPreview,
+	getSelectedArch,
+	getSelectedOs,
+	getSelectedPkg,
+	isReleasePage,
+	OS_LABELS,
+	OS_OPTIONS,
+	type OsOption,
+	PKG_LABELS,
+	PKG_OPTIONS,
+	type PkgOption,
+	setSelectedArch,
+	setSelectedOs,
+	setSelectedPkg,
+	sortAndHighlight,
+} from "./core";
+
+export function useReleaseSorter() {
+	const selectedOs = ref<OsOption>(getSelectedOs());
+	const selectedArch = ref<ArchOption>(getSelectedArch());
+	const selectedPkg = ref<PkgOption>(getSelectedPkg());
+
+	const resolvedPlatform = computed(() => {
+		return selectedOs.value === "auto" ? detectPlatform() : selectedOs.value;
+	});
+
+	const resolvedArch = computed(() => {
+		return selectedArch.value === "auto" ? detectArch() : selectedArch.value;
+	});
+
+	const keywords = computed(() => {
+		return getKeywordsPreview(
+			selectedOs.value,
+			selectedArch.value,
+			selectedPkg.value,
+		);
+	});
+
+	function selectOs(os: OsOption) {
+		selectedOs.value = os;
+		setSelectedOs(os);
+		sortAndHighlight();
+	}
+
+	function selectArch(arch: ArchOption) {
+		selectedArch.value = arch;
+		setSelectedArch(arch);
+		sortAndHighlight();
+	}
+
+	function selectPkg(pkg: PkgOption) {
+		selectedPkg.value = pkg;
+		setSelectedPkg(pkg);
+		sortAndHighlight();
+	}
+
+	return {
+		selectedOs,
+		selectedArch,
+		selectedPkg,
+		resolvedPlatform,
+		resolvedArch,
+		keywords,
+		selectOs,
+		selectArch,
+		selectPkg,
+	};
+}

src/components/ReleaseSorterSettings.vue …release-sorter/ReleaseSorterSettings.vuesrc/components/ReleaseSorterSettings.vue renamed to src/features/release-sorter/ReleaseSorterSettings.vue src/components/ReleaseSorterSettings.vue renamed to src/features/release-sorter/ReleaseSorterSettings.vue

@@ -0,0 +1,3 @@
+export { useReleaseSorter } from "./composable";
+export type { ArchOption, OsOption, PkgOption } from "./core";
+export { initReleaseSorter, isReleasePage, sortAndHighlight } from "./core";