ply-ui-cli 1.1.140 → 1.1.141

package/README.md

@@ -26,7 +26,7 @@ The old npm name `base-ui-cli` is **deprecated** (name collision with [MUI Base
 - **progress-button** (free) — button with a stable-width loading spinner: the label fades out, the spinner takes its place, and the button keeps its exact size and color while the async action runs.
 - **shell** (Pro) — unified page/dashboard application shell with optional footer, push drawers, and mini rail.
 - **AI agents** — copy-in install is cheaper in tokens than generating a widget. Walkthrough (simulation, not a lab benchmark): [rich text editor](https://ply-ui.com/learn/ai-agent-tokens-rich-text-editor/).
-- **UI design skill** — `npx ply-ui-cli init` writes `.cursor/skills/ply-ui-design/` when that folder is missing. Walkthrough: [Why Ply installs a UI design skill when you run init](https://ply-ui.com/learn/ply-ui-design-skill/).
+- **UI design skill** — `npx ply-ui-cli init` writes `.cursor/skills/ply-ui-design/` and `.agents/skills/ply-ui-design/` when those folders are missing. `npx ply-ui-cli init --refresh-editor-kit` replaces a kit that is already there. Walkthrough: [Why Ply installs a UI design skill when you run init](https://ply-ui.com/learn/ply-ui-design-skill/).
 
 Full history: [ply-ui.com/changelog](https://ply-ui.com/changelog)
 
@@ -272,10 +272,10 @@ Run npx ply-ui-cli doctor. It checks ply-ui.json, the Angular workspace, @angula
 Open Theme Studio at https://ply-ui.com/theme/ or the docs customizer, pick a preset or hue, then copy the Tailwind v4 @theme block into src/tailwind.css. ply-ui.css points --ply-primary and Tailwind blue-* utilities at that palette (--ply-brand and --ply-scale-*). The live preview shows buttons, tabs, forms, and overlays together.
 
 **Can AI agents install Ply?**  
-Yes. npx -y ply-ui-mcp runs over stdio in Cursor, VS Code, Claude Code, Claude Desktop, Codex, Antigravity, Grok Build, Kimi Code, Qwen Code, Windsurf, and other local hosts. ChatGPT and Gemini chat apps use the Streamable HTTP connector at https://mcp.ply-ui.com/mcp (catalog tools) or a local npx -y ply-ui-mcp --http without --read-only so add/init/update can see the project. Pro add uses PLY_LICENSE_KEY on the MCP process. Setup for each host: https://ply-ui.com/getting-started/#ai-agents-mcp. Editors that skip MCP can copy the Cursor rule and snippet pack from https://ply-ui.com/getting-started/#editor-rules.
+Yes. npx -y ply-ui-mcp runs over stdio in Cursor, VS Code, Claude Code, Claude Desktop, Codex, Antigravity, Grok Build, Kimi Code, Qwen Code, Windsurf, and other local hosts. ChatGPT and Gemini chat apps use the Streamable HTTP connector at https://mcp.ply-ui.com/mcp (catalog tools) or a local npx -y ply-ui-mcp --http without --read-only so add/init/update can see the project. doctor, add_components, and update_components return structuredContent: checks, missing packages with the install command, and one result per file. Hosts that can ask confirm an overwrite before replace. init_project accepts refreshEditorKit. When PLY_LICENSE_KEY is already set, leave it in the environment and out of the tool call. Setup for each host: https://ply-ui.com/getting-started/#ai-agents-mcp. Editors that skip MCP can copy the Cursor rule and snippet pack from https://ply-ui.com/getting-started/#editor-rules.
 
 **What does init install for AI agents?**  
-npx ply-ui-cli init writes ply-ui.json, ply-ui.css, icon sprites, .cursor/rules/ply-ui.mdc, .vscode/ply-ui.code-snippets, and the UI design skill at .cursor/skills/ply-ui-design/ (SKILL.md, reference.md, examples.md) when those files are missing. The skill tells the agent to reuse ply-button, ply-card, and ply-input-group, keep one accent, and include loading, error, empty, and data states. It does not install components. Published copy: https://ply-ui.com/docs/ai/skills/ply-ui-design/SKILL.md. Walkthrough: https://ply-ui.com/learn/ply-ui-design-skill/.
+npx ply-ui-cli init writes ply-ui.json, ply-ui.css, icon sprites, .cursor/rules/ply-ui.mdc, .vscode/ply-ui.code-snippets, and the UI design skill at .cursor/skills/ply-ui-design/ and .agents/skills/ply-ui-design/ (SKILL.md, reference.md, examples.md) when those files are missing. npx ply-ui-cli init --refresh-editor-kit replaces a kit that is already there. The skill tells the agent to reuse ply-button, ply-card, and ply-input-group, keep one accent, and include loading, error, empty, and data states. It does not install components. Published copy: https://ply-ui.com/docs/ai/skills/ply-ui-design/SKILL.md. Walkthrough: https://ply-ui.com/learn/ply-ui-design-skill/.
 
 **Do AI agents use fewer tokens with Ply?**  
 Usually, yes. With Ply the agent copies a finished component (CLI or MCP) and wires it, instead of generating a toolbar, selection model, sanitizer, and SSR guards from a blank file. Token use still depends on the prompt and the model. A reconstructed Claude/Grok session for the rich text editor is at https://ply-ui.com/learn/ai-agent-tokens-rich-text-editor/ — that is a teaching simulation, not a lab benchmark.

package/dist/commands/init.js

@@ -32,7 +32,8 @@ var init_exports = {};
 __export(init_exports, {
   discoverProjectLayout: () => discoverProjectLayout,
   init: () => init,
-  insertComponentSource: () => insertComponentSource
+  insertComponentSource: () => insertComponentSource,
+  writeEditorKit: () => writeEditorKit
 });
 module.exports = __toCommonJS(init_exports);
 var import_fs3 = __toESM(require("fs"));
@@ -55,6 +56,7 @@ var LEGACY_LOCKFILE_NAME = "base-ui-lock.json";
 var CURSOR_RULE_REL = ".cursor/rules/ply-ui.mdc";
 var SNIPPETS_REL = ".vscode/ply-ui.code-snippets";
 var DESIGN_SKILL_DIR = ".cursor/skills/ply-ui-design";
+var AGENTS_SKILL_DIR = ".agents/skills/ply-ui-design";
 var DOCS_CURSOR_RULE = "docs/ai/ply-ui.mdc";
 var DOCS_SNIPPETS = "docs/ai/ply-ui.code-snippets";
 var DOCS_DESIGN_SKILL = "docs/ai/skills/ply-ui-design";
@@ -281,8 +283,8 @@ async function downloadSprite(name, targetDir) {
     return false;
   }
 }
-function writeEditorFile(dest, content, label, docsPath = DOCS_CURSOR_RULE) {
-  if (import_fs3.default.existsSync(dest)) return;
+function writeEditorFile(dest, content, label, docsPath = DOCS_CURSOR_RULE, refresh = false) {
+  if (import_fs3.default.existsSync(dest) && !refresh) return;
   try {
     import_fs3.default.mkdirSync(import_path2.default.dirname(dest), { recursive: true });
     import_fs3.default.writeFileSync(dest, content, "utf8");
@@ -293,6 +295,34 @@ function writeEditorFile(dest, content, label, docsPath = DOCS_CURSOR_RULE) {
     );
   }
 }
+function writeEditorKit(cwd, options = {}) {
+  const refresh = options.refresh === true;
+  writeEditorFile(
+    import_path2.default.resolve(cwd, CURSOR_RULE_REL),
+    CURSOR_RULE,
+    CURSOR_RULE_REL,
+    DOCS_CURSOR_RULE,
+    refresh
+  );
+  writeEditorFile(
+    import_path2.default.resolve(cwd, SNIPPETS_REL),
+    CODE_SNIPPETS,
+    SNIPPETS_REL,
+    DOCS_SNIPPETS,
+    refresh
+  );
+  for (const dir of [DESIGN_SKILL_DIR, AGENTS_SKILL_DIR]) {
+    for (const [name, content] of Object.entries(DESIGN_SKILL_FILES)) {
+      writeEditorFile(
+        import_path2.default.resolve(cwd, dir, name),
+        content,
+        `${dir}/${name}`,
+        `${DOCS_DESIGN_SKILL}/${name}`,
+        refresh
+      );
+    }
+  }
+}
 var INIT_DEFAULTS = {
   componentsAlias: "src/app/components",
   styles: "src/styles.scss",
@@ -519,32 +549,14 @@ ${stylesContent}`, "utf8");
   for (const sprite of ICON_SPRITES) {
     await downloadSprite(sprite, assetsDir);
   }
-  spinner.text = "Writing editor rules, snippets, and the UI design skill...";
-  writeEditorFile(
-    import_path2.default.resolve(process.cwd(), CURSOR_RULE_REL),
-    CURSOR_RULE,
-    CURSOR_RULE_REL,
-    DOCS_CURSOR_RULE
-  );
-  writeEditorFile(
-    import_path2.default.resolve(process.cwd(), SNIPPETS_REL),
-    CODE_SNIPPETS,
-    SNIPPETS_REL,
-    DOCS_SNIPPETS
-  );
-  for (const [name, content] of Object.entries(DESIGN_SKILL_FILES)) {
-    writeEditorFile(
-      import_path2.default.resolve(process.cwd(), DESIGN_SKILL_DIR, name),
-      content,
-      `${DESIGN_SKILL_DIR}/${name}`,
-      `${DOCS_DESIGN_SKILL}/${name}`
-    );
-  }
+  spinner.text = options.refreshEditorKit ? "Refreshing editor rules, snippets, and the UI design skill..." : "Writing editor rules, snippets, and the UI design skill...";
+  writeEditorKit(process.cwd(), { refresh: options.refreshEditorKit });
   spinner.succeed(`Project initialized! Add your first component with "${CLI_NPX} add button".`);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   discoverProjectLayout,
   init,
-  insertComponentSource
+  insertComponentSource,
+  writeEditorKit
 });

package/dist/index.js

@@ -34,7 +34,7 @@ function printHelp() {
   console.log(`Usage: ${CLI_BIN} <command> [options]
 
 Commands:
-  init                 Initialize your project (ply-ui.json, styles, icons, Cursor rules, snippets)
+  init                 Initialize your project (ply-ui.json, styles, icons, editor kit)
   add [components...]  Add components; omit names to pick from the catalog
   list                 List all available components (free and pro)
   diff [components...] Show upstream changes for installed components since you added them
@@ -48,6 +48,7 @@ Options:
   -f, --force          On conflict, take the upstream version (update)
       --overwrite-local  On update, also revert files you edited that upstream did not change
       --merge            On conflict, 3-way merge using the installed snapshot as ancestor
+      --refresh-editor-kit  Replace the Cursor rule, snippets, and design skill (.cursor/skills and .agents/skills)
   -V, --version        Print version
   -h, --help           Show help
 
@@ -62,6 +63,7 @@ function parseArgs(argv) {
     force: false,
     overwriteLocal: false,
     merge: false,
+    refreshEditorKit: false,
     help: false,
     version: false
   };
@@ -86,6 +88,9 @@ function parseArgs(argv) {
       case "--merge":
         flags.merge = true;
         break;
+      case "--refresh-editor-kit":
+        flags.refreshEditorKit = true;
+        break;
       case "-h":
       case "--help":
         flags.help = true;
@@ -108,7 +113,7 @@ function parseArgs(argv) {
 async function main() {
   const { command, positionals, flags } = parseArgs(process.argv.slice(2));
   if (flags.version && !command) {
-    console.log("1.1.140");
+    console.log("1.1.141");
     return;
   }
   if (flags.help || !command) {
@@ -118,7 +123,7 @@ async function main() {
   switch (command) {
     case "init": {
       const { init } = await import("./commands/init.js");
-      await init({ yes: flags.yes });
+      await init({ yes: flags.yes, refreshEditorKit: flags.refreshEditorKit });
       return;
     }
     case "add": {
@@ -158,7 +163,7 @@ async function main() {
     }
     case "--version":
     case "-V":
-      console.log("1.1.140");
+      console.log("1.1.141");
       return;
     default:
       console.error(`Unknown command: ${command}`);

package/dist/vendor.js

@@ -13148,6 +13148,7 @@ __export(util_exports, {
   required: () => required,
   safeExtend: () => safeExtend,
   shallowClone: () => shallowClone,
+  sizeCaps: () => sizeCaps,
   slugify: () => slugify,
   stringifyPrimitive: () => stringifyPrimitive,
   toZod: () => toZod,
@@ -13667,6 +13668,18 @@ function prefixIssues(path, issues) {
 function unwrapMessage(message) {
   return typeof message === "string" ? message : message?.message;
 }
+function sizeCaps(defChecks) {
+  const caps = [];
+  for (const ch of defChecks ?? []) {
+    const d = ch._zod.def;
+    if (!/_(length|size)$|_equals$/.test(d.check))
+      break;
+    const max = d.maximum ?? d.length ?? d.size;
+    if (max >= 0)
+      caps.push([max, ch]);
+  }
+  return caps;
+}
 function attachSchema(issues, start, inst) {
   var _a3;
   for (let i = start; i < issues.length; i++) {
@@ -15087,7 +15100,7 @@ ${content.join("\n")}
 var version = {
   major: 4,
   minor: 6,
-  patch: 5
+  patch: 7
 };
 
 // node_modules/zod/v4/core/schemas.js
@@ -15843,6 +15856,31 @@ var $ZodDate = /* @__PURE__ */ $constructor("$ZodDate", (inst, def) => {
     return payload;
   };
 });
+function capSize(inst, size) {
+  const caps = sizeCaps(inst._zod.def.checks);
+  if (!caps.length)
+    return;
+  const cap = Math.min(...caps.map((c) => c[0]));
+  const parse3 = inst._zod.parse;
+  inst._zod.parse = (payload, ctx) => {
+    const n = size(payload.value);
+    if (n > cap && !ctx?.skipChecks && ctx?.direction !== "backward") {
+      for (const [max, ch] of sizeCaps(inst._zod.def.checks)) {
+        if (n > max && ch._zod.def.when(payload)) {
+          const start = payload.issues.length;
+          ch._zod.check(payload);
+          payload.issues[start].continue = false;
+          attachSchema(payload.issues, start, inst);
+          return payload;
+        }
+      }
+    }
+    return parse3(payload, ctx);
+  };
+}
+var arraySize = (input2) => Array.isArray(input2) ? input2.length : -1;
+var mapSize = (input2) => input2 instanceof Map ? input2.size : -1;
+var setSize = (input2) => input2 instanceof Set ? input2.size : -1;
 function handleArrayResult(result, final, index) {
   if (result.issues.length) {
     final.issues.push(...prefixIssues(index, result.issues));
@@ -15886,6 +15924,7 @@ var $ZodArray = /* @__PURE__ */ $constructor("$ZodArray", (inst, def) => {
     }
     return payload;
   };
+  capSize(inst, arraySize);
 });
 function handlePropertyResult(result, final, key, input2, optin, optout) {
   const isPresent = key in input2;
@@ -16842,6 +16881,7 @@ var $ZodMap = /* @__PURE__ */ $constructor("$ZodMap", (inst, def) => {
       return Promise.all(proms).then(() => payload);
     return payload;
   };
+  capSize(inst, mapSize);
 });
 function handleMapResult(keyResult, valueResult, final, key, input2, inst, ctx) {
   if (keyResult.issues.length) {
@@ -16908,6 +16948,7 @@ var $ZodSet = /* @__PURE__ */ $constructor("$ZodSet", (inst, def) => {
       return Promise.all(proms).then(() => payload);
     return payload;
   };
+  capSize(inst, setSize);
 });
 function handleSetResult(result, final) {
   if (result.issues.length) {
@@ -26438,9 +26479,15 @@ function generateNullableCheck(doc, ctx, schema, accessor, buildsValue = true) {
   doc.write(`}`);
   return outputVar;
 }
+function generateSizeGate(doc, schema, size) {
+  for (const [max, check2] of sizeCaps(schema._zod.def.checks)) {
+    doc.write(`if (${size} > ${numericOperand(max, check2._zod.def.check)}) return INVALID;`);
+  }
+}
 function generateArrayCheck(doc, ctx, schema, accessor, buildsValue = true) {
   const def = schema._zod.def;
   doc.write(`if (!Array.isArray(${accessor})) return INVALID;`);
+  generateSizeGate(doc, schema, `${accessor}.length`);
   const outputVar = buildsValue ? newVar(ctx) : null;
   const iVar = newVar(ctx);
   const elemVar = newVar(ctx);
@@ -26840,6 +26887,7 @@ function literalPropertyKey(ctx, key) {
 function generateMapCheck(doc, ctx, schema, accessor) {
   const def = schema._zod.def;
   doc.write(`if (!(${accessor} instanceof Map)) return INVALID;`);
+  generateSizeGate(doc, schema, `${accessor}.size`);
   const outputVar = newVar(ctx);
   const kVar = newVar(ctx);
   const valVar = newVar(ctx);
@@ -26856,6 +26904,7 @@ function generateMapCheck(doc, ctx, schema, accessor) {
 function generateSetCheck(doc, ctx, schema, accessor) {
   const def = schema._zod.def;
   doc.write(`if (!(${accessor} instanceof Set)) return INVALID;`);
+  generateSizeGate(doc, schema, `${accessor}.size`);
   const outputVar = newVar(ctx);
   const valVar = newVar(ctx);
   doc.write(`const ${outputVar} = new Set();`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ply-ui-cli",
-  "version": "1.1.140",
+  "version": "1.1.141",
   "description": "Ply CLI — add Angular + Tailwind CSS components to your project (shadcn-style, code is copied in and owned by you). Not MUI Base UI.",
   "main": "dist/index.js",
   "publishConfig": {