@curenorway/kode-cli 1.17.1 → 1.18.0

package/README.md

@@ -160,6 +160,20 @@ kode pages                  # List all cached pages
 kode pages --json           # Output as JSON
 ```
 
+### `kode library`
+
+Browse and use the global script library (Bibliotek). Contains reusable snippets like GSAP animations, form handlers, scroll effects.
+
+```bash
+kode library                    # List all library snippets
+kode library search "scroll"    # Search by name or tags
+kode library add gsap-scroll-reveal  # Copy snippet into project
+kode library pull               # Download all as local references
+kode library push my-script.js  # Push a local script to the library
+```
+
+Library snippets are reference material — they live in `.cure-kode-scripts/library/` and are never deployed. Use `kode library add` to copy a snippet into your project scripts, then adapt it.
+
 ### `kode context`
 
 View and manage AI context.
@@ -279,7 +293,11 @@ your-project/
 ├── .cure-kode-scripts/   # Your scripts directory
 │   ├── main.js
 │   ├── form-handler.js
-│   └── styles.css
+│   ├── styles.css
+│   └── library/          # Reference only (never deployed)
+│       ├── animations/
+│       ├── forms/
+│       └── utilities/
 ├── .mcp.json             # MCP server configuration
 └── CLAUDE.md             # Reference to KODE.md (your content preserved)
 ```

package/dist/{chunk-7EPXFFNR.js → chunk-MSXS4ARI.js}

@@ -1355,6 +1355,9 @@ kode doctor        # Check for issues and CLI updates
 | \`kode pages\` | List CDN pages |
 | \`kode pages create <name> -p /path\` | Create a page with URL patterns |
 | \`kode pages assign <page> <script>\` | Assign script to page |
+| \`kode library\` | List global library snippets |
+| \`kode library search <query>\` | Search library |
+| \`kode library add <slug>\` | Copy snippet into project |
 
 ## MCP Tools
 
@@ -1365,6 +1368,9 @@ AI agents can use these tools directly:
 - \`kode_deploy\` / \`kode_promote\` - Deploy to staging/production
 - \`kode_create_page\` - Create CDN page with URL patterns
 - \`kode_assign_script_to_page\` - Assign script to page
+- \`kode_library_list\` - Browse global script library
+- \`kode_library_get\` - Get snippet with full code
+- \`kode_library_use\` - Copy snippet into project
 
 ## File Structure
 
@@ -1378,7 +1384,10 @@ AI agents can use these tools directly:
 .cure-kode-scripts/  # Your script files
 \u251C\u2500\u2500 main.js
 \u251C\u2500\u2500 form-handler.js
-\u2514\u2500\u2500 ...
+\u2514\u2500\u2500 library/         # Reference only (never deployed)
+    \u251C\u2500\u2500 animations/
+    \u251C\u2500\u2500 forms/
+    \u2514\u2500\u2500 utilities/
 
 .claude/skills/      # Claude Code skills
 \u251C\u2500\u2500 deploy/          # /deploy \u2014 push and deploy workflow
@@ -1455,6 +1464,15 @@ function generateSkills(projectRoot, siteSlug) {
   } else {
     skipped.push("deploy");
   }
+  const libraryDir = join4(skillsDir, "library");
+  const libraryPath = join4(libraryDir, "SKILL.md");
+  if (!existsSync4(libraryPath)) {
+    mkdirSync2(libraryDir, { recursive: true });
+    writeFileSync4(libraryPath, LIBRARY_SKILL);
+    created.push("library");
+  } else {
+    skipped.push("library");
+  }
   const webflowDir = join4(skillsDir, "webflow-patterns");
   const webflowSkillPath = join4(webflowDir, "SKILL.md");
   const webflowRefPath = join4(webflowDir, "reference.md");
@@ -1565,6 +1583,68 @@ See [reference.md](reference.md) for:
 - Animation and interaction scripting
 - Cure Kode script loading and execution order
 `;
+var LIBRARY_SKILL = `---
+name: library
+description: Check the Cure Kode global library before writing common patterns from scratch. Contains reusable GSAP animations, form handlers, scroll effects, and utilities.
+user-invocable: false
+---
+
+# Cure Kode Library (Bibliotek)
+
+Before writing common JavaScript/CSS patterns, check if the global library already has a reusable snippet.
+
+## Workflow
+
+### 1. Browse available snippets
+
+\`\`\`
+kode library list
+\`\`\`
+
+Or search for a specific pattern:
+
+\`\`\`
+kode library search "scroll"
+\`\`\`
+
+Via MCP: use \`kode_library_list\` or \`kode_library_get\`.
+
+### 2. Copy and adapt
+
+**Direct copy** (for utilities that don't need changes):
+\`\`\`
+kode library add debounce-throttle
+kode push
+\`\`\`
+
+**Copy-and-adapt** (for patterns that need project-specific selectors):
+1. Read the snippet: \`kode library search gsap\`
+2. Copy it: \`kode library add gsap-scroll-reveal\`
+3. Edit the local file \u2014 update CSS selectors, classes, timing
+4. Push: \`kode push\`
+
+### 3. Contribute back
+
+If you improve a library snippet or create a reusable pattern:
+\`\`\`
+kode library push my-improved-script.js
+\`\`\`
+
+## Categories
+
+| Category | Content |
+|----------|---------|
+| \`animations\` | GSAP scroll reveals, smooth scrolling, parallax, counters |
+| \`forms\` | Form validation, multi-step forms, Webflow form intercept |
+| \`utilities\` | Debounce/throttle, viewport detection, cookie helpers |
+| \`tracking\` | Event tracking, scroll depth, click maps |
+| \`integrations\` | Third-party widget loaders, API connectors |
+
+## Local reference files
+
+Library snippets are downloaded to \`.cure-kode-scripts/library/\` during \`kode init\`.
+These are **reference only** \u2014 they are never deployed. Only files in the root of \`.cure-kode-scripts/\` are pushed.
+`;
 var WEBFLOW_REFERENCE = `# Webflow Patterns \u2014 Detailed Reference
 
 ## CMS Collection Lists
@@ -2019,6 +2099,44 @@ config.json
     const contextMdContent = generateInitialContext(config, scripts, siteInfo);
     writeFileSync5(join5(cwd, ".cure-kode", "context.md"), contextMdContent);
     spinner.succeed("AI-dokumentasjon generert");
+    spinner.start("Laster ned bibliotek-referanser...");
+    try {
+      const libResponse = await fetch("https://app.cure.no/api/cdn/library", {
+        headers: { "X-API-Key": apiKey }
+      });
+      if (libResponse.ok) {
+        const libSnippets = await libResponse.json();
+        if (libSnippets.length > 0) {
+          const { existsSync: exists, mkdirSync: mkDir, writeFileSync: writeFile } = await import("fs");
+          const { join: joinPath } = await import("path");
+          const libDir = joinPath(scriptsPath, "library");
+          let downloaded = 0;
+          for (const s of libSnippets) {
+            const catDir = joinPath(libDir, s.category || "other");
+            if (!exists(catDir)) mkDir(catDir, { recursive: true });
+            const ext = s.type === "javascript" ? "js" : "css";
+            try {
+              const snippetRes = await fetch(`https://app.cure.no/api/cdn/library/${s.slug}`, {
+                headers: { "X-API-Key": apiKey }
+              });
+              if (snippetRes.ok) {
+                const full = await snippetRes.json();
+                writeFile(joinPath(catDir, `${s.slug}.${ext}`), full.code);
+                downloaded++;
+              }
+            } catch {
+            }
+          }
+          spinner.succeed(`${downloaded} bibliotek-referanser lastet ned`);
+        } else {
+          spinner.succeed("Biblioteket er tomt");
+        }
+      } else {
+        spinner.succeed("Bibliotek ikke tilgjengelig");
+      }
+    } catch {
+      spinner.succeed("Bibliotek hoppet over");
+    }
     spinner.start("Genererer Claude Code skills...");
     const skillsResult = generateSkills(cwd, config.siteSlug);
     if (skillsResult.created.length > 0) {
@@ -2043,7 +2161,8 @@ config.json
     console.log(chalk.dim("  \u251C\u2500\u2500 .mcp.json              ") + chalk.green("(MCP-servere)"));
     console.log(chalk.dim("  \u251C\u2500\u2500 .claude/skills/        ") + chalk.green("(Claude Code skills)"));
     console.log(chalk.dim("  \u2502   \u251C\u2500\u2500 deploy/            (/deploy \u2014 push og deploy)"));
-    console.log(chalk.dim("  \u2502   \u2514\u2500\u2500 webflow-patterns/  (Webflow DOM-referanse)"));
+    console.log(chalk.dim("  \u2502   \u251C\u2500\u2500 webflow-patterns/  (Webflow DOM-referanse)"));
+    console.log(chalk.dim("  \u2502   \u2514\u2500\u2500 library/           (Bibliotek-referanse)"));
     console.log(chalk.dim("  \u251C\u2500\u2500 .cure-kode/"));
     console.log(chalk.dim("  \u2502   \u251C\u2500\u2500 config.json        (konfigurasjon)"));
     console.log(chalk.dim("  \u2502   \u251C\u2500\u2500 KODE.md            ") + chalk.green("(Kode-dokumentasjon)"));
@@ -2365,6 +2484,25 @@ var KodeApiClient = class {
       body: JSON.stringify({ siteId })
     });
   }
+  // Library (global snippets)
+  async listLibrary(search) {
+    const params = new URLSearchParams();
+    if (search) params.set("search", search);
+    const qs = params.toString();
+    return this.request(`/api/cdn/library${qs ? `?${qs}` : ""}`);
+  }
+  async getLibrarySnippet(slugOrId) {
+    return this.request(`/api/cdn/library/${encodeURIComponent(slugOrId)}`);
+  }
+  async createLibrarySnippet(data) {
+    return this.request("/api/cdn/library", {
+      method: "POST",
+      body: JSON.stringify(data)
+    });
+  }
+  async recordLibraryUsage(snippetId) {
+    await this.request(`/api/cdn/library/${snippetId}`);
+  }
   // Webflow Custom Code injection
   async getWebflowCustomCodeStatus(siteId) {
     return this.request(`/api/cdn/sites/${siteId}/webflow/custom-code`);
@@ -2600,7 +2738,7 @@ async function pushCommand(options) {
     }
   }
   const files = readdirSync(scriptsDir).filter(
-    (f) => f.endsWith(".js") || f.endsWith(".css")
+    (f) => (f.endsWith(".js") || f.endsWith(".css")) && f !== "library"
   );
   if (files.length === 0) {
     console.log(chalk3.yellow("Ingen skriptfiler funnet."));

package/dist/cli.js

@@ -23,7 +23,7 @@ import {
   updateClaudeMd,
   updateKodeDocs,
   watchCommand
-} from "./chunk-7EPXFFNR.js";
+} from "./chunk-MSXS4ARI.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -1787,6 +1787,223 @@ async function webflowStatusCommand() {
   }
 }
 
+// src/commands/library.ts
+import chalk12 from "chalk";
+import ora8 from "ora";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync3, existsSync as existsSync5, mkdirSync as mkdirSync2 } from "fs";
+import { join as join5, basename as basename2, extname as extname2 } from "path";
+async function libraryListCommand(options) {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk12.red('Feil: Ikke i et Cure Kode-prosjekt. Kj\xF8r "kode init" f\xF8rst.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk12.red("Feil: Kunne ikke lese prosjektkonfigurasjon."));
+    return;
+  }
+  const spinner = ora8("Henter bibliotek...").start();
+  try {
+    const client = createApiClient(config);
+    const snippets = await client.listLibrary();
+    spinner.stop();
+    if (snippets.length === 0) {
+      console.log(chalk12.dim("Biblioteket er tomt."));
+      return;
+    }
+    if (options.json) {
+      console.log(JSON.stringify(snippets, null, 2));
+      return;
+    }
+    console.log();
+    console.log(chalk12.bold(`  Bibliotek (${snippets.length} snippets)`));
+    console.log();
+    const grouped = /* @__PURE__ */ new Map();
+    for (const s of snippets) {
+      const cat = s.category || "other";
+      if (!grouped.has(cat)) grouped.set(cat, []);
+      grouped.get(cat).push(s);
+    }
+    for (const [category, items] of grouped) {
+      console.log(chalk12.dim(`  ${category}/`));
+      for (const s of items) {
+        const typeLabel = s.type === "javascript" ? chalk12.yellow("JS") : chalk12.blue("CSS");
+        const tags = s.tags.length > 0 ? chalk12.dim(` [${s.tags.join(", ")}]`) : "";
+        console.log(`    ${typeLabel}  ${s.name}${chalk12.dim(` v${s.version}`)}${tags}`);
+      }
+    }
+    console.log();
+  } catch (error) {
+    spinner.fail("Kunne ikke hente bibliotek");
+    console.error(chalk12.red("Feil:"), error);
+  }
+}
+async function librarySearchCommand(query) {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk12.red('Feil: Ikke i et Cure Kode-prosjekt. Kj\xF8r "kode init" f\xF8rst.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk12.red("Feil: Kunne ikke lese prosjektkonfigurasjon."));
+    return;
+  }
+  const spinner = ora8(`S\xF8ker etter "${query}"...`).start();
+  try {
+    const client = createApiClient(config);
+    const snippets = await client.listLibrary(query);
+    spinner.stop();
+    if (snippets.length === 0) {
+      console.log(chalk12.dim(`Ingen treff for "${query}".`));
+      return;
+    }
+    console.log();
+    console.log(chalk12.bold(`  ${snippets.length} treff for "${query}"`));
+    console.log();
+    for (const s of snippets) {
+      const typeLabel = s.type === "javascript" ? chalk12.yellow("JS") : chalk12.blue("CSS");
+      const desc = s.description ? chalk12.dim(` \u2014 ${s.description}`) : "";
+      console.log(`  ${typeLabel}  ${s.name}${chalk12.dim(` v${s.version}`)}${desc}`);
+    }
+    console.log();
+  } catch (error) {
+    spinner.fail("S\xF8k feilet");
+    console.error(chalk12.red("Feil:"), error);
+  }
+}
+async function libraryAddCommand(slug) {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk12.red('Feil: Ikke i et Cure Kode-prosjekt. Kj\xF8r "kode init" f\xF8rst.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk12.red("Feil: Kunne ikke lese prosjektkonfigurasjon."));
+    return;
+  }
+  const spinner = ora8(`Henter snippet "${slug}"...`).start();
+  try {
+    const client = createApiClient(config);
+    const snippet = await client.getLibrarySnippet(slug);
+    const ext = snippet.type === "javascript" ? "js" : "css";
+    const scriptsDir = getScriptsDir(projectRoot, config);
+    if (!existsSync5(scriptsDir)) {
+      mkdirSync2(scriptsDir, { recursive: true });
+    }
+    const filePath = join5(scriptsDir, `${snippet.slug}.${ext}`);
+    if (existsSync5(filePath)) {
+      spinner.fail(`Filen finnes allerede: ${snippet.slug}.${ext}`);
+      console.log(chalk12.dim("Slett den f\xF8rst eller bruk et annet navn."));
+      return;
+    }
+    writeFileSync3(filePath, snippet.code);
+    try {
+      await client.recordLibraryUsage(snippet.id);
+    } catch {
+    }
+    spinner.succeed(chalk12.green(`${snippet.slug}.${ext}`) + chalk12.dim(` \u2190 ${snippet.name}`));
+    console.log();
+    console.log(chalk12.dim("  Filen er kopiert til prosjektet ditt."));
+    console.log(chalk12.dim("  Kj\xF8r ") + chalk12.cyan("kode push") + chalk12.dim(" for \xE5 laste opp til CDN."));
+    console.log();
+  } catch (error) {
+    spinner.fail(`Fant ikke snippet "${slug}"`);
+    console.error(chalk12.red("Feil:"), error);
+  }
+}
+async function libraryPullCommand() {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk12.red('Feil: Ikke i et Cure Kode-prosjekt. Kj\xF8r "kode init" f\xF8rst.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk12.red("Feil: Kunne ikke lese prosjektkonfigurasjon."));
+    return;
+  }
+  const spinner = ora8("Henter bibliotek...").start();
+  try {
+    const client = createApiClient(config);
+    const snippets = await client.listLibrary();
+    if (snippets.length === 0) {
+      spinner.succeed("Biblioteket er tomt \u2014 ingenting \xE5 laste ned.");
+      return;
+    }
+    const scriptsDir = getScriptsDir(projectRoot, config);
+    const libraryDir = join5(scriptsDir, "library");
+    let downloaded = 0;
+    for (const s of snippets) {
+      const categoryDir = join5(libraryDir, s.category || "other");
+      if (!existsSync5(categoryDir)) {
+        mkdirSync2(categoryDir, { recursive: true });
+      }
+      const ext = s.type === "javascript" ? "js" : "css";
+      const filePath = join5(categoryDir, `${s.slug}.${ext}`);
+      try {
+        const full = await client.getLibrarySnippet(s.slug);
+        writeFileSync3(filePath, full.code);
+        downloaded++;
+      } catch {
+      }
+    }
+    spinner.succeed(`Lastet ned ${downloaded} snippets til ${chalk12.dim("library/")}`);
+    console.log(chalk12.dim("  Disse filene er kun referanse \u2014 de deployes ikke."));
+    console.log();
+  } catch (error) {
+    spinner.fail("Kunne ikke laste ned bibliotek");
+    console.error(chalk12.red("Feil:"), error);
+  }
+}
+async function libraryPushCommand(file) {
+  const projectRoot = findProjectRoot();
+  if (!projectRoot) {
+    console.log(chalk12.red('Feil: Ikke i et Cure Kode-prosjekt. Kj\xF8r "kode init" f\xF8rst.'));
+    return;
+  }
+  const config = getProjectConfig(projectRoot);
+  if (!config) {
+    console.log(chalk12.red("Feil: Kunne ikke lese prosjektkonfigurasjon."));
+    return;
+  }
+  const scriptsDir = getScriptsDir(projectRoot, config);
+  const filePath = existsSync5(file) ? file : join5(scriptsDir, file);
+  if (!existsSync5(filePath)) {
+    console.log(chalk12.red(`Filen finnes ikke: ${file}`));
+    return;
+  }
+  const content = readFileSync5(filePath, "utf-8");
+  const name = basename2(file, extname2(file));
+  const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+  const type = extname2(filePath) === ".css" ? "css" : "javascript";
+  console.log();
+  console.log(chalk12.bold("  Push til globalt bibliotek"));
+  console.log();
+  console.log(chalk12.dim(`  Fil: ${basename2(filePath)}`));
+  console.log(chalk12.dim(`  Slug: ${slug}`));
+  console.log(chalk12.dim(`  Type: ${type}`));
+  console.log(chalk12.dim(`  St\xF8rrelse: ${content.length} tegn`));
+  console.log();
+  const spinner = ora8("Laster opp til bibliotek...").start();
+  try {
+    const client = createApiClient(config);
+    await client.createLibrarySnippet({
+      name: name.charAt(0).toUpperCase() + name.slice(1).replace(/-/g, " "),
+      slug,
+      type,
+      code: content
+    });
+    spinner.succeed(chalk12.green(`"${name}" lagt til i biblioteket`));
+    console.log();
+  } catch (error) {
+    spinner.fail("Kunne ikke laste opp til bibliotek");
+    console.error(chalk12.red("Feil:"), error?.message || error);
+  }
+}
+
 // src/cli.ts
 var program = new Command();
 program.name("kode").description("CLI for Cure Kode - manage JS/CSS scripts for Webflow sites").version(CLI_VERSION);
@@ -1876,6 +2093,22 @@ webflowCmd.command("remove").description("Remove Cure Kode init.js from Webflow"
 webflowCmd.command("status", { isDefault: true }).description("Show current Webflow injection status").action(() => {
   webflowStatusCommand();
 });
+var libraryCmd = program.command("library").description("Browse and use the global script library (Bibliotek)");
+libraryCmd.command("list", { isDefault: true }).description("List all library snippets").option("-j, --json", "Output as JSON").action((options) => {
+  libraryListCommand(options);
+});
+libraryCmd.command("search <query>").description("Search library by name or tags").action((query) => {
+  librarySearchCommand(query);
+});
+libraryCmd.command("add <slug>").description("Copy a library snippet into your project scripts").action((slug) => {
+  libraryAddCommand(slug);
+});
+libraryCmd.command("pull").description("Download all library snippets as local references").action(() => {
+  libraryPullCommand();
+});
+libraryCmd.command("push <file>").description("Push a local script to the global library").action((file) => {
+  libraryPushCommand(file);
+});
 program.command("doctor").description("Diagnose configuration and environment issues").action(() => {
   doctorCommand();
 });

package/dist/index.d.ts

@@ -240,6 +240,44 @@ declare class KodeApiClient {
         acquiredAt?: string;
         duration_ms?: number;
     }>;
+    listLibrary(search?: string): Promise<Array<{
+        id: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        type: 'javascript' | 'css';
+        category: string | null;
+        tags: string[];
+        version: number;
+        usage_count: number;
+    }>>;
+    getLibrarySnippet(slugOrId: string): Promise<{
+        id: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        type: 'javascript' | 'css';
+        code: string;
+        category: string | null;
+        tags: string[];
+        version: number;
+        usage_count: number;
+        example_usage: string | null;
+    }>;
+    createLibrarySnippet(data: {
+        name: string;
+        slug: string;
+        type: 'javascript' | 'css';
+        code: string;
+        description?: string;
+        category?: string;
+        tags?: string[];
+        exampleUsage?: string;
+    }): Promise<{
+        id: string;
+        slug: string;
+    }>;
+    recordLibraryUsage(snippetId: string): Promise<void>;
     getWebflowCustomCodeStatus(siteId: string): Promise<{
         injected: boolean;
         scriptId: string | null;

package/dist/index.js

@@ -28,7 +28,7 @@ import {
   updateScriptPurpose,
   watchCommand,
   writeContext
-} from "./chunk-7EPXFFNR.js";
+} from "./chunk-MSXS4ARI.js";
 export {
   KodeApiClient,
   KodeApiError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-cli",
-  "version": "1.17.1",
+  "version": "1.18.0",
   "description": "CLI for Cure Kode CDN - manage, deploy, and sync JS/CSS scripts for Webflow sites with AI agent support",
   "type": "module",
   "bin": {