aem-eds-kit 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -6,6 +6,19 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.4.1] - 2026-10-06
+
+### Changed
+- Animated the five accent dots at interactive entry points (`eds` menu and
+  `block from-design`): a highlight bounces across them, then settles. Static
+  fallback when piped or with `--no-color`.
+- Removed the maker credit from the brand lockup and dropped "× Figma" from the
+  default logo tagline (it reads as design-agnostic now).
+
+### Fixed
+- Docs page links (logo / Home / nav) pointed at `/` and 404'd on the project
+  Pages path - now relative to `index.html`.
+
 ## [0.4.0] - 2026-10-06
 
 Design-agnostic generation, a full interactive configurator, and the first version
@@ -88,6 +101,7 @@ harness, gradient ANSI logo. Not published (superseded by 0.3.0).
 Initial CLI scaffold: `block create`, `block from-figma`, `block list`,
 `figma setup`, `doctor`, `preview`, `publish`. Not published.
 
-[Unreleased]: https://github.com/piotrgodycki/aem-eds-kit/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/piotrgodycki/aem-eds-kit/compare/v0.4.1...HEAD
+[0.4.1]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.1
 [0.4.0]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.4.0
 [0.3.0]: https://github.com/piotrgodycki/aem-eds-kit/releases/tag/v0.3.0

package/README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src=".github/assets/readme-banner.png" alt="aem-eds-kit - Figma frame in. EDS block out." width="100%"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/piotrgodycki/aem-eds-kit/main/.github/assets/readme-banner.png" alt="aem-eds-kit - Design frame in. EDS block out." width="100%"></p>
 
 # aem-eds-kit
 

package/dist/bin/eds.js

@@ -18,70 +18,8 @@ var init_esm_shims = __esm({
   }
 });
 
-// src/lib/logger.ts
-import chalk from "chalk";
-function getLevel() {
-  const env = process.env.EDS_LOG_LEVEL?.toLowerCase();
-  if (env && env in LEVEL_ORDER) return env;
-  return "info";
-}
-function shouldLog(level) {
-  if (quiet) return level === "error";
-  return LEVEL_ORDER[level] >= LEVEL_ORDER[currentLevel];
-}
-var LEVEL_ORDER, currentLevel, quiet, logoShown, logger;
-var init_logger = __esm({
-  "src/lib/logger.ts"() {
-    "use strict";
-    init_esm_shims();
-    LEVEL_ORDER = {
-      debug: 0,
-      info: 1,
-      warn: 2,
-      error: 3,
-      silent: 4
-    };
-    currentLevel = getLevel();
-    quiet = false;
-    logoShown = false;
-    logger = {
-      setLevel(level) {
-        currentLevel = level;
-      },
-      setQuiet(q) {
-        quiet = q;
-      },
-      debug(...args) {
-        if (shouldLog("debug")) console.error(chalk.gray("[debug]"), ...args);
-      },
-      info(...args) {
-        if (shouldLog("info")) console.error(...args);
-      },
-      /**
-       * Print the brand logo at most once per process. The interactive menu and
-       * every command call this, so running a command directly shows the logo,
-       * while picking it from the menu (which already showed it) doesn't repeat it.
-       */
-      logoOnce(art) {
-        if (logoShown) return;
-        logoShown = true;
-        if (shouldLog("info")) console.error(art);
-      },
-      success(...args) {
-        if (shouldLog("info")) console.error(chalk.green("\u2713"), ...args);
-      },
-      warn(...args) {
-        if (shouldLog("warn")) console.error(chalk.yellow("\u26A0"), ...args);
-      },
-      error(...args) {
-        if (shouldLog("error")) console.error(chalk.red("\u2717"), ...args);
-      }
-    };
-  }
-});
-
 // src/lib/ui.ts
-import chalk2 from "chalk";
+import chalk from "chalk";
 function statusIcon(status) {
   return icon[status];
 }
@@ -93,10 +31,27 @@ function padEndVisible(s, width) {
   return pad > 0 ? s + " ".repeat(pad) : s;
 }
 function mark() {
-  return chalk2.bgHex("#ff5a36").hex("#0d0d0c").bold(" >_ ");
+  return chalk.bgHex("#ff5a36").hex("#0d0d0c").bold(" >_ ");
 }
 function lockup() {
-  return `${mark()} ${chalk2.bold("aem-eds-kit")} ${chalk2.dim("by Piotr Godycki")}`;
+  return `${mark()} ${chalk.bold("aem-eds-kit")}`;
+}
+function dotsStatic() {
+  return Array.from({ length: DOTS_N }, () => brand.accent("\u25CF")).join(" ");
+}
+function dotsFrame(step) {
+  const period = DOTS_N * 2 - 2;
+  const phase = step % period;
+  const lit = phase < DOTS_N ? phase : period - phase;
+  return Array.from({ length: DOTS_N }, (_, i) => {
+    const d = Math.abs(i - lit);
+    if (d === 0) return chalk.hex("#ff8a66").bold("\u25CF");
+    if (d === 1) return brand.accent("\u25CF");
+    return chalk.hex("#7a3a2a")("\u25CF");
+  }).join(" ");
+}
+function brandLine(dots, tagline) {
+  return `${lockup()}   ${dots}  ${chalk.dim(tagline)}`;
 }
 function hexToRgb(hex) {
   const h = hex.replace("#", "");
@@ -121,34 +76,35 @@ function gradientLine(line, stops, width) {
     if (ch === " ") return ch;
     const seg = i / span * (stops.length - 1);
     const idx = Math.min(Math.floor(seg), stops.length - 2);
-    return chalk2.hex(mix(stops[idx], stops[idx + 1], seg - idx))(ch);
+    return chalk.hex(mix(stops[idx], stops[idx + 1], seg - idx))(ch);
   }).join("");
 }
-function logo(tagline = "AEM Edge Delivery \xD7 Figma") {
+function logoArt() {
   const width = columnWidth(LOGO_ART);
-  const art = LOGO_ART.map((row) => `  ${gradientLine(row, LOGO_STOPS, width)}`).join("\n");
-  const dots = Array.from({ length: 5 }, () => brand.accent("\u25CF")).join(" ");
+  return LOGO_ART.map((row) => `  ${gradientLine(row, LOGO_STOPS, width)}`).join("\n");
+}
+function logo(tagline = "AEM Edge Delivery Services") {
   return `
-${art}
+${logoArt()}
 
-  ${lockup()}   ${dots}  ${chalk2.dim(tagline)}
+  ${brandLine(dotsStatic(), tagline)}
 `;
 }
 function heading(title, subtitle) {
   const bar = brand.red("\u258A");
-  const sub = subtitle ? ` ${chalk2.dim(subtitle)}` : "";
+  const sub = subtitle ? ` ${chalk.dim(subtitle)}` : "";
   return `
-${bar} ${chalk2.bold(title)}${sub}
+${bar} ${chalk.bold(title)}${sub}
 `;
 }
 function statusLine(status, name, message, nameWidth = 0) {
   const padded = nameWidth ? padEndVisible(name, nameWidth) : name;
-  const msg = message ? `  ${chalk2.dim(message)}` : "";
+  const msg = message ? `  ${chalk.dim(message)}` : "";
   return `  ${icon[status]} ${padded}${msg}`;
 }
 function accentLine(name, message, nameWidth = 0) {
   const padded = nameWidth ? padEndVisible(name, nameWidth) : name;
-  const msg = message ? `  ${chalk2.dim(message)}` : "";
+  const msg = message ? `  ${chalk.dim(message)}` : "";
   return `  ${brand.accent("\u2714")} ${padded}${msg}`;
 }
 function columnWidth(items) {
@@ -169,47 +125,48 @@ function summary(counts) {
   if (counts.warn) parts.push(`${icon.warn} ${counts.warn} ${plural(counts.warn, "warning")}`);
   if (counts.fail) parts.push(`${icon.fail} ${counts.fail} failed`);
   if (counts.info) parts.push(`${icon.info} ${counts.info} info`);
-  return parts.join(chalk2.dim("   "));
+  return parts.join(chalk.dim("   "));
 }
 function plural(n, word) {
   return n === 1 ? word : `${word}s`;
 }
-var brand, icon, ANSI, LOGO_ART, LOGO_STOPS;
+var brand, icon, ANSI, DOTS_N, LOGO_ART, LOGO_STOPS;
 var init_ui = __esm({
   "src/lib/ui.ts"() {
     "use strict";
     init_esm_shims();
     brand = {
       // Warm sweep for the logo wordmark (red → ember → orange)
-      red: chalk2.hex("#FA0F00"),
-      ember: chalk2.hex("#FF4B1F"),
-      orange: chalk2.hex("#FF7B00"),
+      red: chalk.hex("#FA0F00"),
+      ember: chalk.hex("#FF4B1F"),
+      orange: chalk.hex("#FF7B00"),
       // Accent
-      blue: chalk2.hex("#2680EB"),
+      blue: chalk.hex("#2680EB"),
       // Signature accent (matches the landing's `#FF5A36`)
-      accent: chalk2.hex("#ff5a36"),
+      accent: chalk.hex("#ff5a36"),
       // Five-colour dot mark (the CLI signature)
-      dotOrange: chalk2.hex("#F24E1E"),
-      dotPurple: chalk2.hex("#A259FF"),
-      dotBlue: chalk2.hex("#1ABCFE"),
-      dotGreen: chalk2.hex("#0ACF83"),
-      dotPink: chalk2.hex("#FF7262"),
+      dotOrange: chalk.hex("#F24E1E"),
+      dotPurple: chalk.hex("#A259FF"),
+      dotBlue: chalk.hex("#1ABCFE"),
+      dotGreen: chalk.hex("#0ACF83"),
+      dotPink: chalk.hex("#FF7262"),
       // Semantic roles
-      ok: chalk2.hex("#2D9D78"),
-      warn: chalk2.hex("#E68619"),
-      err: chalk2.hex("#D7373F"),
-      info: chalk2.hex("#2680EB")
+      ok: chalk.hex("#2D9D78"),
+      warn: chalk.hex("#E68619"),
+      err: chalk.hex("#D7373F"),
+      info: chalk.hex("#2680EB")
     };
     icon = {
       pass: brand.ok("\u2713"),
       warn: brand.warn("\u26A0"),
       fail: brand.err("\u2717"),
       info: brand.info("\u2139"),
-      bullet: chalk2.dim("\u2022"),
-      arrow: chalk2.dim("\u21B3"),
+      bullet: chalk.dim("\u2022"),
+      arrow: chalk.dim("\u21B3"),
       figma: brand.dotPurple("\u25C6")
     };
     ANSI = /\[[0-9;]*m/g;
+    DOTS_N = 5;
     LOGO_ART = [
       "\u2588\u2588\u2588\u2588\u2588 \u2588\u2588\u2588\u2588  \u2588\u2588\u2588\u2588\u2588",
       "\u2588     \u2588   \u2588 \u2588    ",
@@ -221,6 +178,96 @@ var init_ui = __esm({
   }
 });
 
+// src/lib/logger.ts
+import chalk2 from "chalk";
+function getLevel() {
+  const env = process.env.EDS_LOG_LEVEL?.toLowerCase();
+  if (env && env in LEVEL_ORDER) return env;
+  return "info";
+}
+function shouldLog(level) {
+  if (quiet) return level === "error";
+  return LEVEL_ORDER[level] >= LEVEL_ORDER[currentLevel];
+}
+var LEVEL_ORDER, currentLevel, quiet, logoShown, logger;
+var init_logger = __esm({
+  "src/lib/logger.ts"() {
+    "use strict";
+    init_esm_shims();
+    init_ui();
+    LEVEL_ORDER = {
+      debug: 0,
+      info: 1,
+      warn: 2,
+      error: 3,
+      silent: 4
+    };
+    currentLevel = getLevel();
+    quiet = false;
+    logoShown = false;
+    logger = {
+      setLevel(level) {
+        currentLevel = level;
+      },
+      setQuiet(q) {
+        quiet = q;
+      },
+      debug(...args) {
+        if (shouldLog("debug")) console.error(chalk2.gray("[debug]"), ...args);
+      },
+      info(...args) {
+        if (shouldLog("info")) console.error(...args);
+      },
+      /**
+       * Print the brand logo at most once per process. The interactive menu and
+       * every command call this, so running a command directly shows the logo,
+       * while picking it from the menu (which already showed it) doesn't repeat it.
+       */
+      logoOnce(art) {
+        if (logoShown) return;
+        logoShown = true;
+        if (shouldLog("info")) console.error(art);
+      },
+      /**
+       * Like {@link logoOnce}, but animates the five accent dots on an interactive
+       * TTY: a highlight bounces across them before settling. Falls back to the
+       * static logo when piped, when `--no-color` is set, or when logging is quiet.
+       * Used at the interactive entry points (menu, `block from-design`).
+       */
+      async logoOnceAnimated(tagline) {
+        if (logoShown) return;
+        logoShown = true;
+        if (!shouldLog("info")) return;
+        const out = process.stderr;
+        if (!out.isTTY || chalk2.level === 0) {
+          console.error(logo(tagline));
+          return;
+        }
+        out.write(`
+${logoArt()}
+
+`);
+        const frames = 16;
+        for (let step = 0; step < frames; step++) {
+          out.write(`\r\x1B[K  ${brandLine(dotsFrame(step), tagline)}`);
+          await new Promise((r) => setTimeout(r, 70));
+        }
+        out.write(`\r\x1B[K  ${brandLine(dotsStatic(), tagline)}
+`);
+      },
+      success(...args) {
+        if (shouldLog("info")) console.error(chalk2.green("\u2713"), ...args);
+      },
+      warn(...args) {
+        if (shouldLog("warn")) console.error(chalk2.yellow("\u26A0"), ...args);
+      },
+      error(...args) {
+        if (shouldLog("error")) console.error(chalk2.red("\u2717"), ...args);
+      }
+    };
+  }
+});
+
 // src/lib/schemas.ts
 import { z } from "zod";
 var figmaUrlSchema, edsConfigSchema, edsProjectSchema, edsMetaSchema, kebabCaseRegex;
@@ -1575,7 +1622,7 @@ async function blockFromDesign(figmaUrlArg, optionsArg) {
     process.exitCode = 1;
     return;
   }
-  logger.logoOnce(logo("Design \u2192 EDS block"));
+  await logger.logoOnceAnimated("Design \u2192 EDS block");
   let designUrl = figmaUrlArg;
   let options = optionsArg;
   if (!designUrl) {
@@ -4005,7 +4052,7 @@ async function listBlockNames(projectRoot) {
 }
 async function mainMenu() {
   const { select, input } = await import("@inquirer/prompts");
-  logger.logoOnce(logo("What do you want to do?"));
+  await logger.logoOnceAnimated("What do you want to do?");
   const action = await select({
     message: "Choose an action",
     choices: [
@@ -4103,18 +4150,89 @@ var init_menu = __esm({
     init_logger();
     init_project();
     init_schemas();
-    init_ui();
   }
 });
 
 // src/bin/eds.ts
 init_esm_shims();
-init_logger();
-init_ui();
 import chalk14 from "chalk";
 import { Command } from "commander";
+
+// package.json
+var package_default = {
+  name: "aem-eds-kit",
+  version: "0.4.1",
+  description: "CLI for AEM Edge Delivery Services with Figma MCP integration",
+  type: "module",
+  engines: {
+    node: ">=20"
+  },
+  bin: {
+    eds: "dist/bin/eds.js"
+  },
+  main: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  files: [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  scripts: {
+    dev: "tsx src/bin/eds.ts",
+    build: "tsup",
+    test: "vitest run",
+    "test:watch": "vitest",
+    lint: "biome check src/ tests/",
+    "lint:fix": "biome check --write src/ tests/",
+    typecheck: "tsc --noEmit",
+    prepare: "git config core.hooksPath .githooks || true",
+    prepublishOnly: "npm run build"
+  },
+  keywords: [
+    "aem",
+    "edge-delivery-services",
+    "helix",
+    "figma",
+    "mcp",
+    "cli",
+    "adobe"
+  ],
+  author: "Piotr Godycki <piotrgodycki@yahoo.com>",
+  license: "MIT",
+  repository: {
+    type: "git",
+    url: "git+https://github.com/piotrgodycki/aem-eds-kit.git"
+  },
+  homepage: "https://piotrgodycki.github.io/aem-eds-kit/",
+  bugs: {
+    url: "https://github.com/piotrgodycki/aem-eds-kit/issues"
+  },
+  dependencies: {
+    "@inquirer/prompts": "^7.0.0",
+    chalk: "^5.4.0",
+    commander: "^13.0.0",
+    execa: "^9.5.0",
+    ora: "^8.1.0",
+    yaml: "^2.6.0",
+    zod: "^3.24.0"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^1.9.0",
+    "@types/node": "^22.0.0",
+    tsup: "^8.3.0",
+    tsx: "^4.19.0",
+    typescript: "^5.7.0",
+    vitest: "^2.1.0"
+  },
+  optionalDependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+};
+
+// src/bin/eds.ts
+init_logger();
+init_ui();
 var program = new Command();
-program.name("eds").description("CLI for AEM Edge Delivery Services with Figma integration").version("0.4.0").option("--verbose", "Enable verbose output").option("--quiet", "Suppress non-error output").option("--json", "Output in JSON format").option("--no-color", "Disable color output").showHelpAfterError("(add --help for usage)").hook("preAction", (thisCommand) => {
+program.name("eds").description("CLI for AEM Edge Delivery Services with Figma integration").version(package_default.version).option("--verbose", "Enable verbose output").option("--quiet", "Suppress non-error output").option("--json", "Output in JSON format").option("--no-color", "Disable color output").showHelpAfterError("(add --help for usage)").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.verbose) logger.setLevel("debug");
   if (opts.quiet) logger.setQuiet(true);