inclusion-md 0.2.2 → 0.2.3

package/lib/ascii.js

@@ -3,31 +3,47 @@
 const c = require("./colors");
 
 /**
- * Gentle 3-frame welcome animation. Conveys "coming together" via dots that
- * gradually connect. ASCII-only, no flashing, no inverted colors, no Unicode.
+ * Animated INCLUSION.md wordmark. The letters wipe in from left to right,
+ * then settle from dim to bold.
  *
  * Accessibility:
  * - Skipped automatically when stdout is not a TTY (CI, piped output).
- * - Skipped when --no-color is passed (color is the cue, not motion).
+ * - Skipped when --no-color is passed (intensity is the cue).
  * - Skipped when --yes is passed (non-interactive runs).
- * - Frames change appearance gradually (dim -> normal -> bold), not flashing.
- * - Total runtime under 1 second.
+ * - No flashing, no inverted colors, no decorative color. Motion is a
+ *   single left-to-right reveal under 1 second total.
+ * - Uses Unicode block characters; terminals without block-drawing glyph
+ *   support will see boxes instead of letters but the CLI still works.
  */
 
-const FRAMES = [
-  ["   .     .     .   ", "                   ", "   .     .     .   "],
-  ["   o     o     o   ", "                   ", "   o     o     o   "],
-  ["   o-----o-----o   ", "         |         ", "   o-----o-----o   "],
+// "INCLUSION.md" wordmark, 3 rows tall, 73 columns wide.
+const ART = [
+  "██ ███  ██ ▄█████ ██     ██  ██ ▄█████ ██ ▄████▄ ███  ██   ▄▄   ▄▄ ▄▄▄▄ ",
+  "██ ██ ▀▄██ ██     ██     ██  ██ ▀▀▀▄▄▄ ██ ██  ██ ██ ▀▄██   ██▀▄▀██ ██▀██",
+  "██ ██   ██ ▀█████ ██████ ▀████▀ █████▀ ██ ▀████▀ ██   ██ ▄ ██   ██ ████▀",
 ];
 
-function renderFrame(frame, intensity) {
+const ART_WIDTH = ART[0].length;
+const ART_LINES = ART.length + 2; // includes 1 blank line top + bottom
+
+function stylize(s, intensity) {
   // intensity: 0 = dim, 1 = normal, 2 = bold
-  const stylize = intensity === 0 ? c.dim : intensity === 2 ? c.bold : (s) => s;
-  return frame.map((line) => stylize(line)).join("\n");
+  if (intensity === 0) return c.dim(s);
+  if (intensity === 2) return c.bold(s);
+  return s;
+}
+
+function renderRevealed(width, intensity) {
+  const lines = ART.map((line) => {
+    const visible = line.slice(0, width);
+    const padded = visible.padEnd(ART_WIDTH, " ");
+    return stylize(padded, intensity);
+  });
+  return ["", ...lines, ""].join("\n");
 }
 
-function clearFrame(lineCount) {
-  for (let i = 0; i < lineCount; i++) {
+function clearLines(n) {
+  for (let i = 0; i < n; i++) {
     process.stdout.write("\x1b[1A\x1b[2K");
   }
 }
@@ -36,16 +52,27 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-async function play({ enabled = true, frameMs = 220 } = {}) {
-  if (!enabled) return;
-  for (let i = 0; i < FRAMES.length; i++) {
-    const intensity = i === FRAMES.length - 1 ? 2 : i;
-    process.stdout.write(renderFrame(FRAMES[i], intensity) + "\n");
-    if (i < FRAMES.length - 1) {
-      await sleep(frameMs);
-      clearFrame(FRAMES[i].length + 1);
-    }
+async function play({ enabled = true, frameMs = 70 } = {}) {
+  if (!enabled) {
+    // Static render so non-animated runs aren't blank.
+    process.stdout.write(renderRevealed(ART_WIDTH, 2) + "\n");
+    return;
   }
+
+  // Phase 1: column-wipe reveal in 6 steps, dim.
+  const steps = 6;
+  for (let i = 1; i <= steps; i++) {
+    const w = Math.ceil((ART_WIDTH * i) / steps);
+    process.stdout.write(renderRevealed(w, 0) + "\n");
+    await sleep(frameMs);
+    clearLines(ART_LINES + 1);
+  }
+
+  // Phase 2: settle — full art, normal then bold.
+  process.stdout.write(renderRevealed(ART_WIDTH, 1) + "\n");
+  await sleep(120);
+  clearLines(ART_LINES + 1);
+  process.stdout.write(renderRevealed(ART_WIDTH, 2) + "\n");
 }
 
 function shouldAnimate({ noColor, yes }) {
@@ -56,4 +83,5 @@ function shouldAnimate({ noColor, yes }) {
   return true;
 }
 
-module.exports = { play, shouldAnimate, FRAMES };
+// Back-compat: previous versions exported FRAMES.
+module.exports = { play, shouldAnimate, ART, FRAMES: [ART, ART, ART] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inclusion-md",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Scaffold an INCLUSION.md - a context engineering doc that gives AI coding assistants inclusion-oriented guidance during code generation.",
   "keywords": [
     "inclusion",