@czxingyu/xycomponents 0.1.2 → 0.1.4

package/README.md

@@ -98,41 +98,34 @@ pnpm run docs:preview
 pnpm run type-check
 ```
 
-## CLI for AI-assisted usage
+## CLI and Skills for AI-assisted usage
 
-The package publishes a `xycomponents` CLI for tools and AI agents that need
-stable component metadata.
+The `xycomponents` CLI ships inside `@czxingyu/xycomponents` and **always matches
+the installed package version**. Install the library in your app and invoke the
+CLI locally—do not install the CLI globally.
 
 ```bash
-xycomponents components --json
-xycomponents components --category data-entry --json
-xycomponents components --include-retired --json
-xycomponents component button --json
-xycomponents snippet button --example primary
-xycomponents migrate link --json
-xycomponents doctor --json
-xycomponents package --json
+pnpm add @czxingyu/xycomponents
+pnpm exec xycomponents doctor --json
+pnpm exec xycomponents components --json
+pnpm exec xycomponents component button --json
+pnpm exec xycomponents snippet button --example primary
+pnpm exec xycomponents migrate link --json
+pnpm exec xycomponents package --json
 ```
 
+Re-run `pnpm add @czxingyu/xycomponents@<version>` when upgrading; the CLI
+updates with the package.
+
+Cursor Agent Skills live in [`skills/`](./skills/) (`xycomponents-shared`,
+`xycomponents-cli`). Copy them into a consumer project's `.cursor/skills/` or
+from `node_modules/@czxingyu/xycomponents/skills/` after install. See
+[`skills/README.md`](./skills/README.md).
+
 The CLI catalog covers every documented component with detailed props, events,
-slots, examples, and AI hints. The canonical component list lives in
-[`component-groups.ts`](./docs/src/pages/components/component-groups.ts). The
-component generator atomically adds a detailed baseline entry to
-[`generated-components.ts`](./cli/metadata/generated-components.ts); replace
-that placeholder contract while implementing the component, and move mature
-metadata into the appropriate domain module when useful. All metadata modules
-are composed by [`cli/metadata.ts`](./cli/metadata.ts), and the component audit
-rejects catalog-only fallbacks. The same audit normalizes Vue bindings and
-kebab-case names, then verifies every Props, Events, and Slots identifier is
-present in its component documentation.
-Schema v3 also publishes a lifecycle record for every active component and
-keeps retired-component tombstones. Use `migrate <name> --json` before replacing
-deprecated APIs or when an old component is no longer present in the runtime;
-the result contains the reason, removal timeline, migration instructions, and
-guide path.
-The release gate also installs the packed tarball into an isolated consumer,
-type-checks its TypeScript and Vue SFC public entries, and executes the
-installed CLI binary before publishing.
+slots, examples, and AI hints. Use `pnpm exec xycomponents migrate <name> --json`
+before replacing deprecated APIs. The release gate installs the packed tarball
+into an isolated consumer and executes the project-local CLI before publishing.
 
 ## Global component types
 

package/README.zh-CN.md

@@ -100,24 +100,27 @@ pnpm run docs:preview
 pnpm run type-check
 ```
 
-## 面向 AI 使用的 CLI
+## 面向 AI 使用的 CLI 与 Skills
 
-包发布时会提供 `xycomponents` CLI，方便脚本和 AI Agent 稳定读取组件元数据。
+CLI 随 `@czxingyu/xycomponents` 发布，**版本与 npm 包一致**。业务项目在本地安装后通过 `pnpm exec` 调用；升级库时重新 `pnpm add` 即可同步 CLI。
 
 ```bash
-xycomponents components --json
-xycomponents components --category data-entry --json
-xycomponents components --include-retired --json
-xycomponents component button --json
-xycomponents snippet button --example primary
-xycomponents migrate link --json
-xycomponents doctor --json
-xycomponents package --json
+pnpm add @czxingyu/xycomponents
+pnpm exec xycomponents doctor --json
+pnpm exec xycomponents components --json
+pnpm exec xycomponents component button --json
+pnpm exec xycomponents snippet button --example primary
+pnpm exec xycomponents migrate link --json
+pnpm exec xycomponents package --json
 ```
 
-CLI 以详细级元数据覆盖全部已文档化组件，提供 Props、Events、Slots、示例和 AI 提示。统一组件清单位于 [`component-groups.ts`](./docs/src/pages/components/component-groups.ts)。组件生成器会原子写入 [`generated-components.ts`](./cli/metadata/generated-components.ts) 的详细元数据基线；实现组件时必须替换占位契约，成熟后可按领域移入 [`cli/metadata/`](./cli/metadata/) 的对应模块。所有模块最终由 [`cli/metadata.ts`](./cli/metadata.ts) 组合，组件审计会拒绝目录级回退，并逐项核对 CLI API 标识符已出现在对应文档中。
+**不要**全局安装 CLI，避免 AI 查到与项目 `package.json` 不一致的 API。
+
+### Cursor Skills
+
+[`skills/`](./skills/) 提供 `xycomponents-shared`（安装与接入）和 `xycomponents-cli`（命令与 JSON 工作流）。业务项目复制到 `.cursor/skills/` 或从 `node_modules/@czxingyu/xycomponents/skills/` 复制；详见 [`skills/README.md`](./skills/README.md)。本仓库维护者已在 [`.cursor/skills/`](./.cursor/skills/) 启用同名 Skill。
 
-Schema v3 为每个现役组件提供生命周期记录，并永久保留 retired tombstone。替换 deprecated API 或遇到运行时已经移除的旧组件前，先运行 `migrate <name> --json`；结果会给出原因、移除版本、替代组件、迁移步骤和指南路径。发布门禁还会把真实 tarball 安装到隔离工程，严格检查 TypeScript/Vue SFC 公开类型，并执行安装后的 CLI。
+CLI 以详细级元数据覆盖全部已文档化组件。统一组件清单位于 [`component-groups.ts`](./docs/src/pages/components/component-groups.ts)。组件生成器会原子写入 [`generated-components.ts`](./cli/metadata/generated-components.ts) 的详细元数据基线；成熟后可移入 [`cli/metadata/`](./cli/metadata/)。Schema v3 提供生命周期记录与 retired tombstone；改 deprecated/retired API 前先 `pnpm exec xycomponents migrate <name> --json`。
 
 ## 全局组件类型
 

package/dist/index.esm.js

@@ -12,7 +12,7 @@ var qe = Object.create, Je = Object.defineProperty, Ye = Object.getOwnPropertyDe
 }, tt = (e, t, n) => (n = e == null ? {} : qe(Ze(e)), et(t || !e || !e.__esModule ? Je(n, "default", {
 	value: e,
 	enumerable: !0
-}) : n, e)), nt = "0.1.2";
+}) : n, e)), nt = "0.1.4";
 //#endregion
 //#region components/shared/install.ts
 function X(e) {
@@ -25426,7 +25426,7 @@ var ip = ["aria-busy"], ap = { key: 0 }, op = { key: 0 }, sp = ["colspan"], cp =
 			record: e
 		}))), ve = s(() => Xf(ge.value, r.rowKey, M.value ? r.tree : void 0, de.value)), ye = s(() => Math.max(1, Math.ceil(me.value.total / me.value.pageSize))), be = s(() => new Set(ue.value)), xe = s(() => ve.value.filter((e) => !it(e.record)).map((e) => e.key)), Se = s(() => xe.value.length > 0 && xe.value.every((e) => be.value.has(e))), Ce = s(() => xe.value.some((e) => be.value.has(e))), we = s(() => !!r.pagination && (!r.pagination || !r.pagination.hideOnSinglePage || me.value.total > me.value.pageSize)), Te = s(() => (P.value ? Wp : 0) + S.value.reduce((e, t) => e + Re(t), 0)), Ee = s(() => ze(Kp) + _e.value.reduce((e, t) => e + ze(t.key), 0)), De = s(() => [P.value ? `${Wp}px` : "", ...S.value.map((e) => `${Re(e)}px`)].filter(Boolean).join(" ")), Oe = s(() => ({
 			maxHeight: r.autoHeight ? void 0 : Uf(r.scroll?.y),
-			overflowX: r.scroll?.x ? "auto" : void 0,
+			overflowX: j.value ? "hidden" : r.scroll?.x ? "auto" : void 0,
 			overflowY: r.autoHeight || !r.scroll?.y ? void 0 : "auto",
 			...Ne.value.container
 		})), ke = s(() => w.value ? {
@@ -26347,7 +26347,7 @@ var ip = ["aria-busy"], ap = { key: 0 }, op = { key: 0 }, sp = ["colspan"], cp =
 			"total"
 		])) : l("", !0)], 14, ip));
 	}
-}), [["__scopeId", "data-v-90886cf3"]])), Jp = ["aria-label", "aria-orientation"], Yp = [
+}), [["__scopeId", "data-v-e1a0865c"]])), Jp = ["aria-label", "aria-orientation"], Yp = [
 	"data-tab-key",
 	"id",
 	"aria-controls",

package/dist/index.lite.esm.js

@@ -9,7 +9,7 @@ import qe from "dayjs/plugin/quarterOfYear.js";
 import Je from "dayjs/plugin/weekOfYear.js";
 import Ye from "dayjs/plugin/weekYear.js";
 //#region package.json
-var Xe = "0.1.2";
+var Xe = "0.1.4";
 //#endregion
 //#region components/shared/install.ts
 function Z(e) {