@waggylabs/yumekit 0.5.1 → 0.5.2

package/llm.txt

@@ -3,7 +3,7 @@
 A modern, framework-agnostic Web Components UI kit providing 51 production-ready custom HTML elements. Built entirely on native web standards with zero external runtime dependencies.
 
 ## Version
-0.5.1
+0.5.2
 
 ## License
 MIT
@@ -1657,6 +1657,7 @@ Attributes:
 - `position` — `"top"` (default) | `"bottom"` | `"left"` | `"right"`
 - `size` — `"small"` | `"medium"` | `"large"`
 - `variant` — `"default"` (default, bordered boxes) | `"accent"` (minimal tabs; the active tab shows a primary-colored indicator border on its content-facing edge — bottom for `top` tabs, top for `bottom`, etc. — like Material/Carbon)
+- `overflow` — `"scroll"` (default; tabs stay on one line and prev/next arrow buttons appear when the strip overflows its container) | `"wrap"` (tabs flow onto multiple rows, or columns for `left`/`right` positions)
 
 Methods: `activateTab(id)`
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@waggylabs/yumekit",
-    "version": "0.5.1",
+    "version": "0.5.2",
     "description": "Modern Web Component UI Kit",
     "type": "module",
     "main": "dist/yumekit.min.js",

package/scripts/install-ai-docs.js

@@ -1,4 +1,9 @@
 #!/usr/bin/env node
+// `npx @waggylabs/yumekit init-ai` — copies YumeKit's bundled AI docs into the
+// current project so coding assistants (Claude Code and generic LLM tooling)
+// can use them. Opt-in and idempotent: existing files are skipped unless
+// --force is passed.
+
 import {
     appendFileSync,
     cpSync,
@@ -11,18 +16,8 @@ import {
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 
-// `npx @waggylabs/yumekit init-ai` — copies YumeKit's bundled AI docs into the
-// current project so coding assistants (Claude Code and generic LLM tooling)
-// can use them. Opt-in and idempotent: existing files are skipped unless
-// --force is passed.
-
 const __dirname = dirname(fileURLToPath(import.meta.url));
-const aiDir = join(__dirname, "..", "dist", "ai");
-
-const args = process.argv.slice(2);
-const force = args.includes("--force");
-const wantsHelp = args.includes("--help") || args.includes("-h");
-const cmd = args.find((a) => !a.startsWith("-"));
+const AI_DIR = join(__dirname, "..", "dist", "ai");
 
 const HELP = `
 YumeKit AI docs installer
@@ -40,49 +35,11 @@ Options:
   --help    Show this help
 `;
 
-if (wantsHelp || cmd !== "init-ai") {
-    console.log(HELP);
-    process.exit(wantsHelp || !cmd ? 0 : 1);
-}
-
-if (!existsSync(aiDir)) {
-    console.error(
-        `✗ Bundled AI docs not found at ${aiDir}.\n  This package may not have been built with AI docs — please report it.`,
-    );
-    process.exit(1);
-}
-
-const cwd = process.cwd();
-const results = [];
-
-// 1. Claude skill ---------------------------------------------------------
-const skillDest = join(cwd, ".claude", "skills", "yumekit");
-if (existsSync(skillDest) && !force) {
-    results.push("• skip   .claude/skills/yumekit/ (exists — use --force)");
-} else {
-    // Clear the destination first so --force is a true replacement — a
-    // recursive copy alone would leave behind files removed/renamed upstream.
-    if (existsSync(skillDest)) rmSync(skillDest, { recursive: true, force: true });
-    mkdirSync(dirname(skillDest), { recursive: true });
-    cpSync(join(aiDir, "skill"), skillDest, { recursive: true });
-    results.push("✔ wrote  .claude/skills/yumekit/");
-}
-
-// 2. llm.txt --------------------------------------------------------------
-const llmDest = join(cwd, "llm.txt");
-if (existsSync(llmDest) && !force) {
-    results.push("• skip   llm.txt (exists — use --force)");
-} else {
-    cpSync(join(aiDir, "llm.txt"), llmDest);
-    results.push("✔ wrote  llm.txt");
-}
-
-// 3. AGENTS.md pointer ----------------------------------------------------
-// Delimited so --force can refresh the block in place without disturbing the
-// rest of the user's AGENTS.md.
+// Delimited so --force can refresh the AGENTS.md block in place without
+// disturbing the rest of the user's file.
 const POINTER_START = "<!-- yumekit-ai-docs -->";
 const POINTER_END = "<!-- /yumekit-ai-docs -->";
-const pointer = `${POINTER_START}
+const POINTER = `${POINTER_START}
 ## YumeKit UI components
 
 This project uses [@waggylabs/yumekit](https://www.yumekit.com) web components.
@@ -90,28 +47,92 @@ When building UI with \`y-*\` elements, consult:
 - \`.claude/skills/yumekit/\` — full component skill (Claude Code)
 - \`llm.txt\` — component API reference for any LLM/agent
 ${POINTER_END}`;
-const agentsDest = join(cwd, "AGENTS.md");
-if (!existsSync(agentsDest)) {
-    writeFileSync(agentsDest, `# AGENTS\n\n${pointer}\n`);
-    results.push("✔ wrote  AGENTS.md");
-} else {
-    const existing = readFileSync(agentsDest, "utf8");
+
+// ---------- install steps ----------
+
+// Copies the Claude skill tree into <cwd>/.claude/skills/yumekit/. With --force
+// the destination is cleared first so the copy is a true replacement (a plain
+// recursive copy would leave behind files removed/renamed upstream).
+function installSkill(cwd, force) {
+    const dest = join(cwd, ".claude", "skills", "yumekit");
+    if (existsSync(dest) && !force) {
+        return "• skip   .claude/skills/yumekit/ (exists — use --force)";
+    }
+
+    if (existsSync(dest)) rmSync(dest, { recursive: true, force: true });
+    mkdirSync(dirname(dest), { recursive: true });
+    cpSync(join(AI_DIR, "skill"), dest, { recursive: true });
+    return "✔ wrote  .claude/skills/yumekit/";
+}
+
+// Copies llm.txt into the project root.
+function installLlm(cwd, force) {
+    const dest = join(cwd, "llm.txt");
+    if (existsSync(dest) && !force) {
+        return "• skip   llm.txt (exists — use --force)";
+    }
+
+    cpSync(join(AI_DIR, "llm.txt"), dest);
+    return "✔ wrote  llm.txt";
+}
+
+// Writes the pointer block into AGENTS.md: creates the file if absent, appends
+// the block if the file exists without it, or (with --force) replaces an
+// existing block in place. A legacy block with no end marker is replaced
+// through end of file.
+function installAgentsPointer(cwd, force) {
+    const dest = join(cwd, "AGENTS.md");
+    if (!existsSync(dest)) {
+        writeFileSync(dest, `# AGENTS\n\n${POINTER}\n`);
+        return "✔ wrote  AGENTS.md";
+    }
+
+    const existing = readFileSync(dest, "utf8");
     const start = existing.indexOf(POINTER_START);
     if (start === -1) {
-        appendFileSync(agentsDest, `\n${pointer}\n`);
-        results.push("✔ append AGENTS.md (pointer)");
-    } else if (!force) {
-        results.push("• skip   AGENTS.md (pointer present — use --force)");
-    } else {
-        // Replace the existing block (handles a legacy block with no end marker
-        // by replacing through end of file).
-        const endMark = existing.indexOf(POINTER_END, start);
-        const end = endMark === -1 ? existing.length : endMark + POINTER_END.length;
-        writeFileSync(agentsDest, existing.slice(0, start) + pointer + existing.slice(end));
-        results.push("✔ update AGENTS.md (pointer)");
+        appendFileSync(dest, `\n${POINTER}\n`);
+        return "✔ append AGENTS.md (pointer)";
+    }
+    if (!force) {
+        return "• skip   AGENTS.md (pointer present — use --force)";
     }
+
+    const endMark = existing.indexOf(POINTER_END, start);
+    const end = endMark === -1 ? existing.length : endMark + POINTER_END.length;
+    writeFileSync(dest, existing.slice(0, start) + POINTER + existing.slice(end));
+    return "✔ update AGENTS.md (pointer)";
+}
+
+// ---------- run ----------
+
+function main() {
+    const args = process.argv.slice(2);
+    const force = args.includes("--force");
+    const wantsHelp = args.includes("--help") || args.includes("-h");
+    const cmd = args.find((a) => !a.startsWith("-"));
+
+    if (wantsHelp || cmd !== "init-ai") {
+        console.log(HELP);
+        process.exit(wantsHelp || !cmd ? 0 : 1);
+    }
+
+    if (!existsSync(AI_DIR)) {
+        console.error(
+            `✗ Bundled AI docs not found at ${AI_DIR}.\n  This package may not have been built with AI docs — please report it.`,
+        );
+        process.exit(1);
+    }
+
+    const cwd = process.cwd();
+    const results = [
+        installSkill(cwd, force),
+        installLlm(cwd, force),
+        installAgentsPointer(cwd, force),
+    ];
+
+    console.log(`\nYumeKit AI docs → ${cwd}\n`);
+    console.log(results.map((r) => `  ${r}`).join("\n"));
+    console.log("");
 }
 
-console.log(`\nYumeKit AI docs → ${cwd}\n`);
-console.log(results.map((r) => `  ${r}`).join("\n"));
-console.log("");
+main();