@czxingyu/xycomponents 0.1.4 → 0.1.6

package/dist/cli.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
-import { resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 //#region cli/component-lifecycle.ts
 var componentDeprecations = [];
 var retiredComponents = [{
@@ -7501,7 +7502,7 @@ const rows: XyTableRecord[] = [
 			},
 			{
 				default: "false",
-				description: "Grow with content, ignore scroll.y, and disable virtual mode.",
+				description: "Grow with content up to the parent height; scroll inside when overflowing; ignore scroll.y and disable virtual mode.",
 				name: "autoHeight",
 				type: "boolean"
 			},
@@ -9936,6 +9937,139 @@ var packageMetadata = {
 	schemaVersion: 1
 };
 //#endregion
+//#region cli/skills-install.ts
+var CONSUMER_SKILL_NAMES = [
+	"xycomponents-shared",
+	"xycomponents-cli",
+	"xycomponents-contribute"
+];
+var MAINTAINER_SKILL_NAMES = [...CONSUMER_SKILL_NAMES, "xycomponents-maintainer"];
+var SKILL_TARGETS = {
+	agents: ".agents/skills",
+	claude: ".claude/skills",
+	codex: ".codex/skills",
+	cursor: ".cursor/skills"
+};
+var AGENTS_GUIDE_START = "<!-- xycomponents:start -->";
+var AGENTS_GUIDE_END = "<!-- xycomponents:end -->";
+var AGENTS_GUIDE_BLOCK = `${AGENTS_GUIDE_START}
+
+## xycomponents Agent Guide
+
+This project uses \`@czxingyu/xycomponents\`. Query component APIs with the **project-local** CLI (do not use a globally installed CLI):
+
+\`\`\`bash
+pnpm exec xycomponents doctor --json
+pnpm exec xycomponents component <name> --json
+pnpm exec xycomponents snippet <name> --example <id>
+\`\`\`
+
+Workflow skills are installed for multiple agents under \`.cursor/skills/\`, \`.claude/skills/\`, \`.codex/skills/\`, and \`.agents/skills/\`:
+
+- \`xycomponents-shared\` — install, version alignment, Vue setup
+- \`xycomponents-cli\` — CLI commands and JSON metadata
+- \`xycomponents-contribute\` — GitHub Bug / Feature issues
+
+Re-run \`pnpm exec xycomponents skills install\` after upgrading \`@czxingyu/xycomponents\` so agent guides stay in sync.
+
+${AGENTS_GUIDE_END}`;
+function moduleUrlToPath(moduleUrl) {
+	return moduleUrl.startsWith("file:") ? fileURLToPath(moduleUrl) : moduleUrl;
+}
+function resolvePackageRoot(moduleUrl) {
+	return resolve(dirname(moduleUrlToPath(moduleUrl)), "..");
+}
+function resolveSkillsSourceDir(moduleUrl) {
+	return join(resolvePackageRoot(moduleUrl), "skills");
+}
+function resolveSkillNames(options) {
+	if (options.maintainer) return [...MAINTAINER_SKILL_NAMES];
+	if (options.consumer === false) return [...MAINTAINER_SKILL_NAMES];
+	return [...CONSUMER_SKILL_NAMES];
+}
+function resolveSkillTargets(targets) {
+	if (!targets || targets.length === 0) return Object.keys(SKILL_TARGETS);
+	return targets.filter((target) => target in SKILL_TARGETS);
+}
+function readPackageVersion(packageRoot) {
+	try {
+		return JSON.parse(readFileSync(join(packageRoot, "package.json"), "utf8")).version ?? "unknown";
+	} catch {
+		return "unknown";
+	}
+}
+function copySkillDirectory(source, destination, dryRun) {
+	if (dryRun) return;
+	mkdirSync(dirname(destination), { recursive: true });
+	cpSync(source, destination, {
+		force: true,
+		recursive: true
+	});
+}
+function upsertAgentsGuide(projectRoot, dryRun) {
+	const agentsGuidePath = join(projectRoot, "AGENTS.md");
+	const previous = existsSync(agentsGuidePath) ? readFileSync(agentsGuidePath, "utf8") : "";
+	if (previous.includes(AGENTS_GUIDE_START) && previous.includes(AGENTS_GUIDE_END)) {
+		const next = previous.replace(new RegExp(`${AGENTS_GUIDE_START}[\\s\\S]*?${AGENTS_GUIDE_END}`, "m"), AGENTS_GUIDE_BLOCK);
+		if (!dryRun) writeFileSync(agentsGuidePath, next, "utf8");
+		return {
+			agentsGuide: previous === next ? "skipped" : "updated",
+			agentsGuidePath
+		};
+	}
+	const next = `${previous}${previous.length > 0 && !previous.endsWith("\n") ? "\n\n" : previous.length > 0 ? "\n" : ""}${AGENTS_GUIDE_BLOCK}\n`;
+	if (!dryRun) writeFileSync(agentsGuidePath, next, "utf8");
+	return {
+		agentsGuide: previous.length > 0 ? "updated" : "created",
+		agentsGuidePath
+	};
+}
+function installSkills(options, moduleUrl = import.meta.url) {
+	const projectRoot = resolve(options.projectRoot ?? process.cwd());
+	const packageRoot = resolve(options.packageRoot ?? resolvePackageRoot(moduleUrl));
+	const skillsSource = resolveSkillsSourceDir(moduleUrl);
+	const skillNames = resolveSkillNames(options);
+	const targets = resolveSkillTargets(options.targets);
+	const installed = [];
+	const skipped = [];
+	if (!existsSync(skillsSource)) return {
+		agentsGuide: "skipped",
+		agentsGuidePath: join(projectRoot, "AGENTS.md"),
+		installed,
+		packageVersion: readPackageVersion(packageRoot),
+		projectRoot,
+		skillsSource,
+		skipped: [`skills source missing: ${skillsSource}`],
+		status: "fail"
+	};
+	for (const target of targets) {
+		const targetRoot = join(projectRoot, SKILL_TARGETS[target]);
+		for (const skillName of skillNames) {
+			const sourceDir = join(skillsSource, skillName);
+			const destinationDir = join(targetRoot, skillName);
+			if (!existsSync(join(sourceDir, "SKILL.md"))) {
+				skipped.push(`${skillName} (missing source for ${target})`);
+				continue;
+			}
+			copySkillDirectory(sourceDir, destinationDir, options.dryRun === true);
+			installed.push({
+				path: join(SKILL_TARGETS[target], skillName, "SKILL.md"),
+				skill: skillName,
+				target
+			});
+		}
+	}
+	return {
+		...upsertAgentsGuide(projectRoot, options.dryRun === true),
+		installed,
+		packageVersion: readPackageVersion(packageRoot),
+		projectRoot,
+		skillsSource,
+		skipped,
+		status: installed.length > 0 ? "pass" : "fail"
+	};
+}
+//#endregion
 //#region cli/index.ts
 function withTrailingNewline(value) {
 	return value.endsWith("\n") ? value : `${value}\n`;
@@ -10005,6 +10139,7 @@ Usage:
   xycomponents migrate link --json
   xycomponents package --json
   xycomponents doctor --json
+  xycomponents skills install --consumer --json
 
 Commands:
   components        List every documented component
@@ -10012,7 +10147,8 @@ Commands:
   snippet <name>    Print a component usage snippet
   migrate <name>    Explain stable, deprecated, or retired migration status
   package           Explain default and lite package entry contracts
-  doctor             Print catalog and detailed-metadata coverage
+  doctor            Print catalog and detailed-metadata coverage
+  skills install    Install AI agent skills for Cursor, Claude Code, Codex, and AGENTS.md
   help              Print this help message`);
 }
 function componentSummary(category) {
@@ -10067,6 +10203,39 @@ Lite: ${packageMetadata.entries.lite.import}
   Excludes: ${packageMetadata.entries.lite.excludedComponents.join(", ")}
 Docs: ${packageMetadata.docs}`);
 }
+function printSkillsInstall(flags, json) {
+	const rawTargets = readFlag(flags, "target", "all").split(",").map((value) => value.trim()).filter(Boolean);
+	const targets = rawTargets.length === 1 && rawTargets[0] === "all" ? resolveSkillTargets() : resolveSkillTargets(rawTargets);
+	const report = installSkills({
+		consumer: flags.has("consumer") || !flags.has("maintainer"),
+		dryRun: flags.has("dry-run"),
+		maintainer: flags.has("maintainer"),
+		projectRoot: readFlag(flags, "project", process.cwd()),
+		targets
+	});
+	if (json) {
+		const payload = stringifyJson(report);
+		return report.status === "pass" ? ok(payload) : {
+			exitCode: 1,
+			stderr: "",
+			stdout: withTrailingNewline(payload)
+		};
+	}
+	if (report.status !== "pass") return fail(["Failed to install xycomponents skills.", ...report.skipped].join("\n"));
+	const lines = [
+		`Installed ${report.installed.length} skill(s) for @czxingyu/xycomponents@${report.packageVersion}.`,
+		`Project: ${report.projectRoot}`,
+		`AGENTS.md: ${report.agentsGuide}`,
+		"",
+		"Targets:",
+		...Object.entries(SKILL_TARGETS).map(([name, directory]) => `- ${name}: ${directory}`),
+		"",
+		"Installed:",
+		...report.installed.map((item) => `- ${item.target}: ${item.path}`)
+	];
+	if (report.skipped.length > 0) lines.push("", "Skipped:", ...report.skipped.map((item) => `- ${item}`));
+	return ok(lines.join("\n"));
+}
 function printComponent(name, json) {
 	if (!name) return fail("Missing component name.");
 	const component = findComponent(name);
@@ -10154,10 +10323,15 @@ function runCli(argv) {
 	if (argv.includes("-h")) return printHelp();
 	const { flags, positionals } = parseArgs(argv);
 	if (flags.has("help")) return printHelp();
-	const [rawCommand, componentName] = positionals;
+	const [rawCommand, secondArg] = positionals;
 	const command = rawCommand?.toLowerCase() ?? "help";
 	const json = wantsJson(flags);
 	if (command === "help") return printHelp();
+	if (command === "skills") {
+		if (secondArg?.toLowerCase() === "install") return printSkillsInstall(flags, json);
+		return fail("Missing skills subcommand. Try \"xycomponents skills install\".");
+	}
+	const componentName = secondArg;
 	if (command === "components" || command === "list") return printComponents(json, readFlag(flags, "category", "") || void 0, flags.has("include-retired"));
 	if (command === "component" || command === "show") return printComponent(componentName, json);
 	if (command === "snippet") return printSnippet(componentName, readFlag(flags, "example", "basic"), 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.4";
+}) : n, e)), nt = "0.1.5";
 //#endregion
 //#region components/shared/install.ts
 function X(e) {
@@ -25427,7 +25427,7 @@ var ip = ["aria-busy"], ap = { key: 0 }, op = { key: 0 }, sp = ["colspan"], cp =
 		}))), 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: j.value ? "hidden" : r.scroll?.x ? "auto" : void 0,
-			overflowY: r.autoHeight || !r.scroll?.y ? void 0 : "auto",
+			overflowY: r.autoHeight || r.scroll?.y ? "auto" : void 0,
 			...Ne.value.container
 		})), ke = s(() => w.value ? {
 			minWidth: `${Ee.value}px`,
@@ -25438,6 +25438,7 @@ var ip = ["aria-busy"], ap = { key: 0 }, op = { key: 0 }, sp = ["colspan"], cp =
 			width: L.value ? `${Te.value}px` : r.scroll?.x ? void 0 : "100%",
 			...Ne.value.table
 		}), Ae = s(() => ({
+			"xy-table--auto-height": r.autoHeight,
 			"xy-table--bordered": r.bordered,
 			"xy-table--loading": r.loading,
 			"xy-table--striped": r.striped,
@@ -26347,7 +26348,7 @@ var ip = ["aria-busy"], ap = { key: 0 }, op = { key: 0 }, sp = ["colspan"], cp =
 			"total"
 		])) : l("", !0)], 14, ip));
 	}
-}), [["__scopeId", "data-v-e1a0865c"]])), Jp = ["aria-label", "aria-orientation"], Yp = [
+}), [["__scopeId", "data-v-1e60de17"]])), 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.4";
+var Xe = "0.1.5";
 //#endregion
 //#region components/shared/install.ts
 function Z(e) {