@czxingyu/xycomponents 0.1.0

package/docs/maintenance/migrations/xy-link.md

@@ -0,0 +1,29 @@
+# XyLink 迁移说明
+
+`XyLink` / `xy-link` 已在 `0.0.1` 中移除。它同时封装 Vue Router、原生链接和按钮外观，导致路由所有权、可访问语义与视觉职责不清晰，因此不再保留统一替代组件。
+
+## 迁移映射
+
+| 旧用法                                                   | 新用法                                                          |
+| -------------------------------------------------------- | --------------------------------------------------------------- |
+| `to`                                                     | 直接使用应用的 `RouterLink`，继续由路由层处理 active 状态和导航 |
+| `href`、`target`、`rel`                                  | 使用原生 `<a>`，保留浏览器链接语义                              |
+| `variant="button"` / `variant="primary"`                 | 使用 `XyButton` 的 `href`、`target` 与对应按钮类型              |
+| `variant="plain"` / `variant="nav"` / `variant="subtle"` | 使用原生链接，并由业务样式或导航组件表达视觉层级                |
+| `block`                                                  | 在业务布局中设置宽度，不再由链接组件隐式控制                    |
+
+## 示例
+
+```vue
+<script setup lang="ts">
+import { RouterLink } from "vue-router";
+</script>
+
+<template>
+  <RouterLink to="/settings">设置</RouterLink>
+  <a href="https://example.com" target="_blank" rel="noreferrer">外部文档</a>
+  <xy-button type="primary" href="/reports">查看报表</xy-button>
+</template>
+```
+
+AI 工具可以随时运行 `xycomponents migrate link --json` 获取同一份机器可读迁移状态和本指南路径。

package/global.d.ts

@@ -0,0 +1,109 @@
+export {};
+
+type XyComponents = typeof import("@czxingyu/xycomponents");
+
+declare global {
+  interface ImportMetaEnv {
+    readonly DEV: boolean;
+    readonly MODE: string;
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv;
+  }
+}
+
+declare module "vue" {
+  export interface GlobalComponents {
+    XyAlert: XyComponents["XyAlert"];
+    XyAlertMarquee: XyComponents["XyAlertMarquee"];
+    XyAnchor: XyComponents["XyAnchor"];
+    XyApp: XyComponents["XyApp"];
+    XyAvatar: XyComponents["XyAvatar"];
+    XyAvatarGroup: XyComponents["XyAvatarGroup"];
+    XyBadge: XyComponents["XyBadge"];
+    XyBadgeRibbon: XyComponents["XyBadgeRibbon"];
+    XyBreadcrumb: XyComponents["XyBreadcrumb"];
+    XyButton: XyComponents["XyButton"];
+    XyCard: XyComponents["XyCard"];
+    XyCarousel: XyComponents["XyCarousel"];
+    XyCascader: XyComponents["XyCascader"];
+    XyCheckbox: XyComponents["XyCheckbox"];
+    XyCheckboxGroup: XyComponents["XyCheckboxGroup"];
+    XyCollapse: XyComponents["XyCollapse"];
+    XyCollapsePanel: XyComponents["XyCollapsePanel"];
+    XyColorPicker: XyComponents["XyColorPicker"];
+    XyConfigProvider: XyComponents["XyConfigProvider"];
+    XyDatePicker: XyComponents["XyDatePicker"];
+    XyDescriptions: XyComponents["XyDescriptions"];
+    XyDescriptionsItem: XyComponents["XyDescriptionsItem"];
+    XyDivider: XyComponents["XyDivider"];
+    XyDrawer: XyComponents["XyDrawer"];
+    XyEmpty: XyComponents["XyEmpty"];
+    XyForm: XyComponents["XyForm"];
+    XyFormErrorList: XyComponents["XyFormErrorList"];
+    XyFormItem: XyComponents["XyFormItem"];
+    XyFormList: XyComponents["XyFormList"];
+    XyGrid: XyComponents["XyGrid"];
+    XyGridItem: XyComponents["XyGridItem"];
+    XyIcon: XyComponents["XyIcon"];
+    XyIconButton: XyComponents["XyIconButton"];
+    XyInput: XyComponents["XyInput"];
+    XyInputNumber: XyComponents["XyInputNumber"];
+    XyLayout: XyComponents["XyLayout"];
+    XyLayoutContent: XyComponents["XyLayoutContent"];
+    XyLayoutFooter: XyComponents["XyLayoutFooter"];
+    XyLayoutHeader: XyComponents["XyLayoutHeader"];
+    XyLayoutSider: XyComponents["XyLayoutSider"];
+    XyList: XyComponents["XyList"];
+    XyListItem: XyComponents["XyListItem"];
+    XyListItemMeta: XyComponents["XyListItemMeta"];
+    XyTimeline: XyComponents["XyTimeline"];
+    XyTimelineItem: XyComponents["XyTimelineItem"];
+    XyMenu: XyComponents["XyMenu"];
+    XyMentions: XyComponents["XyMentions"];
+    XyMessage: XyComponents["XyMessage"];
+    XyModal: XyComponents["XyModal"];
+    XyNotification: XyComponents["XyNotification"];
+    XyPagination: XyComponents["XyPagination"];
+    XyPassword: XyComponents["XyPassword"];
+    XyPopconfirm: XyComponents["XyPopconfirm"];
+    XyPopover: XyComponents["XyPopover"];
+    XyProgress: XyComponents["XyProgress"];
+    XyRadio: XyComponents["XyRadio"];
+    XyRadioGroup: XyComponents["XyRadioGroup"];
+    XyRangePicker: XyComponents["XyRangePicker"];
+    XyRate: XyComponents["XyRate"];
+    XyResult: XyComponents["XyResult"];
+    XySearch: XyComponents["XySearch"];
+    XySelect: XyComponents["XySelect"];
+    XySlider: XyComponents["XySlider"];
+    XySwitch: XyComponents["XySwitch"];
+    XySkeleton: XyComponents["XySkeleton"];
+    XySpin: XyComponents["XySpin"];
+    XySpace: XyComponents["XySpace"];
+    XySpaceCompact: XyComponents["XySpaceCompact"];
+    XySplitter: XyComponents["XySplitter"];
+    XySplitterPanel: XyComponents["XySplitterPanel"];
+    XyStatistic: XyComponents["XyStatistic"];
+    XyTable: XyComponents["XyTable"];
+    XyTabs: XyComponents["XyTabs"];
+    XyTag: XyComponents["XyTag"];
+    XyCheckableTag: XyComponents["XyCheckableTag"];
+    XyTooltip: XyComponents["XyTooltip"];
+    XyTransfer: XyComponents["XyTransfer"];
+    XyTree: XyComponents["XyTree"];
+    XyTreeSelect: XyComponents["XyTreeSelect"];
+    XyTextarea: XyComponents["XyTextarea"];
+    XyTimePicker: XyComponents["XyTimePicker"];
+    XyTypography: XyComponents["XyTypography"];
+    XyUpload: XyComponents["XyUpload"];
+    XyWatermark: XyComponents["XyWatermark"];
+    XyFlex: XyComponents["XyFlex"];
+    XyDropdown: XyComponents["XyDropdown"];
+    XySteps: XyComponents["XySteps"];
+    XyAutoComplete: XyComponents["XyAutoComplete"];
+    XySegmented: XyComponents["XySegmented"];
+    // component-generator:global-types
+  }
+}

package/package.json

@@ -0,0 +1,168 @@
+{
+  "name": "@czxingyu/xycomponents",
+  "version": "0.1.0",
+  "bin": {
+    "xycomponents": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "components/style/*.css",
+    "docs/maintenance/migrations/*.md",
+    "global.d.ts"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "./components/style/*.css",
+    "./dist/*.css",
+    "./dist/index.esm.js",
+    "./dist/index.lite.esm.js",
+    "./dist/index.umd.js"
+  ],
+  "main": "dist/index.js",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./lite": {
+      "types": "./dist/lite.d.ts",
+      "import": "./dist/index.lite.esm.js",
+      "require": "./dist/index.lite.esm.js"
+    },
+    "./lite/style": "./dist/xycomponents-lite.css",
+    "./lite/style.css": "./dist/xycomponents-lite.css",
+    "./dist/*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js",
+      "require": "./dist/*.js"
+    },
+    "./global.d.ts": "./global.d.ts",
+    "./global": "./global.d.ts",
+    "./reset": "./components/style/reset.css",
+    "./reset.css": "./components/style/reset.css",
+    "./style": "./dist/xycomponents.css",
+    "./style/reset.css": "./components/style/reset.css",
+    "./package.json": "./package.json",
+    "./dist/index.esm.js": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.esm.js"
+    },
+    "./dist/index.lite.esm.js": {
+      "types": "./dist/lite.d.ts",
+      "default": "./dist/index.lite.esm.js"
+    },
+    "./dist/index.umd.js": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.umd.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@ant-design/icons-vue": "^7.0.1",
+    "@tanstack/vue-virtual": "^3.13.31",
+    "@vueuse/core": "^14.2.1",
+    "async-validator": "^4.2.5",
+    "dayjs": "^1.11.20",
+    "vue": "^3.5.30"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.1",
+    "@mdit-vue/plugin-frontmatter": "^2.1.4",
+    "@mdit-vue/plugin-headers": "^2.1.4",
+    "@mdit-vue/plugin-title": "^2.1.4",
+    "@mdit-vue/plugin-toc": "^2.1.4",
+    "@mdit-vue/shared": "^2.1.4",
+    "@mdit-vue/types": "^2.1.4",
+    "@playwright/test": "^1.61.1",
+    "@shikijs/markdown-it": "^3.23.0",
+    "@shikijs/transformers": "^3.23.0",
+    "@tsconfig/node24": "^24.0.4",
+    "@types/jsdom": "^28.0.0",
+    "@types/markdown-it": "^14.1.2",
+    "@types/node": "^24.12.0",
+    "@types/picomatch": "^4.0.2",
+    "@vitejs/plugin-vue": "^6.0.5",
+    "@vitejs/plugin-vue-jsx": "^5.1.5",
+    "@vue/language-core": "^3.2.5",
+    "@vue/test-utils": "^2.4.6",
+    "@vue/tsconfig": "^0.9.0",
+    "jiti": "^2.6.1",
+    "jsdom": "^28.1.0",
+    "lru-cache": "^11.2.7",
+    "markdown-it": "^14.1.1",
+    "markdown-it-anchor": "^9.2.0",
+    "markdown-it-async": "^2.2.0",
+    "markdown-it-attrs": "^4.3.1",
+    "markdown-it-container": "^4.0.0",
+    "markdown-it-emoji": "^3.0.0",
+    "mlly": "^1.8.1",
+    "nanoid": "^5.1.6",
+    "npm-run-all": "^4.1.5",
+    "npm-run-all2": "^8.0.4",
+    "oxfmt": "^0.41.0",
+    "oxlint": "^1.72.0",
+    "pathe": "^2.0.3",
+    "picomatch": "^4.0.3",
+    "pinia": "^3.0.4",
+    "postcss-selector-parser": "^7.1.1",
+    "shiki": "^3.23.0",
+    "tinyglobby": "^0.2.15",
+    "typescript": "~5.9.3",
+    "unocss": "^66.6.6",
+    "unplugin-auto-import": "^21.0.0",
+    "unplugin-vue-components": "^31.0.0",
+    "vite": "^8.1.2",
+    "vite-plugin-dayjs": "^1.0.1",
+    "vite-plugin-inspect": "^11.3.3",
+    "vite-plugin-tsx-resolve-types": "^1.0.1",
+    "vite-plugin-vue-devtools": "^8.1.0",
+    "vite-plugin-vue-resolve-types": "^0.0.1",
+    "vitest": "^4.1.9",
+    "vue-i18n": "^11.3.0",
+    "vue-router": "^5.0.3",
+    "vue-tsc": "^3.2.5"
+  },
+  "peerDependencies": {
+    "vue": ">=3.5.0"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "audit:components": "jiti scripts/audit-components.ts",
+    "xycomponents": "node dist/cli.js",
+    "docs:dev": "vite --config docs/vite.config.ts",
+    "docs:preview": "vite preview --config docs/vite.config.ts",
+    "test": "vitest run",
+    "test:unit": "vitest run",
+    "test:e2e": "pnpm run docs:build && jiti scripts/run-e2e.ts",
+    "docs:build": "vite build --config docs/vite.config.ts",
+    "type-check": "vue-tsc --build",
+    "build:comp": "vite build --config vite.build.config.ts",
+    "build:types": "vue-tsc -p tsconfig.build.json",
+    "build:esm": "vite build --config vite.esm.config.ts",
+    "build:lite": "vite build --config vite.lite.config.ts",
+    "build:umd": "vite build --config vite.umd.config.ts",
+    "build:cli": "vite build --config vite.cli.config.ts",
+    "build": "run-s build:comp build:types build:esm build:lite build:umd build:cli",
+    "check:esm-import": "node scripts/check-esm-import.mjs",
+    "check:umd-contract": "node scripts/check-umd-contract.mjs",
+    "check:bundle": "node scripts/check-bundle-size.mjs",
+    "check:package": "node scripts/check-package.mjs",
+    "check:packed-consumer": "node scripts/check-packed-consumer.mjs",
+    "changeset": "changeset",
+    "fmt": "oxfmt",
+    "fmt:check": "oxfmt --check",
+    "generate:component": "node scripts/generate-component.mjs",
+    "lint": "oxlint .",
+    "check": "pnpm run fmt:check && pnpm run lint && pnpm run type-check",
+    "ci": "pnpm run check && pnpm test && pnpm run audit:components && pnpm run test:e2e && pnpm run build && pnpm run check:esm-import && pnpm run check:umd-contract && pnpm run check:bundle && pnpm run check:package && pnpm run check:packed-consumer",
+    "release": "pnpm run ci && changeset publish",
+    "version-packages": "changeset version"
+  }
+}