@basiclines/rampa 1.0.1 → 1.1.1

package/README.md

@@ -4,6 +4,19 @@ Generate mathematically accurate, accessible color palettes from a base color.
 
 ## Installation
 
+### npm
+
+```bash
+npx @basiclines/rampa -C "#3b82f6"
+```
+
+Or install globally:
+
+```bash
+npm install -g @basiclines/rampa
+rampa -C "#3b82f6"
+```
+
 ### Homebrew (macOS/Linux)
 
 ```bash
@@ -44,6 +57,9 @@ rampa -C "#3b82f6" --size=5 -L 10:90
 # Add complementary harmony
 rampa -C "#3b82f6" --add=complementary
 
+# Add hue-shifted ramp (45 degrees)
+rampa -C "#3b82f6" --add=shift:45
+
 # Output as CSS variables
 rampa -C "#3b82f6" --output=css
 ```
@@ -108,7 +124,14 @@ Available blend modes: `normal`, `multiply`, `screen`, `overlay`, `darken`, `lig
 |------|-------------|
 | `--add` | Add harmony ramp (repeatable) |
 
-Available harmonies: `complementary`, `triadic`, `analogous`, `split-complementary`, `square`, `compound`
+Available types:
+- `complementary` — Opposite on color wheel (+180°)
+- `triadic` — 3 colors, 120° apart
+- `analogous` — Adjacent colors, 30° apart
+- `split-complementary` — 2 colors near opposite
+- `square` — 4 colors, 90° apart
+- `compound` — Complementary + split
+- `shift:N` — Custom hue rotation by N degrees (e.g., `shift:45`, `shift:-30`)
 
 ### Output
 
@@ -150,6 +173,19 @@ rampa -C "#3b82f6" --tint-color="#FF0000" --tint-opacity=15 --tint-blend=overlay
 rampa -C "#3b82f6" --add=complementary --add=triadic
 ```
 
+### Custom Hue Shifts
+
+```bash
+# Warm shift (+45°)
+rampa -C "#3b82f6" --add=shift:45
+
+# Cool shift (-30°)  
+rampa -C "#3b82f6" --add=shift:-30
+
+# Multiple shifts
+rampa -C "#3b82f6" --add=shift:30 --add=shift:60 --add=shift:90
+```
+
 ### JSON Output
 
 ```bash

package/dist/index.js

@@ -9897,6 +9897,41 @@ function formatCss2(ramps) {
 `);
 }
 
+// src/utils/terminal-colors.ts
+function hasLimitedColorSupport() {
+  return process.env.TERM_PROGRAM === "Apple_Terminal";
+}
+function rgbTo256(r4, g3, b2) {
+  if (r4 === g3 && g3 === b2) {
+    if (r4 < 8)
+      return 16;
+    if (r4 > 248)
+      return 231;
+    return Math.round((r4 - 8) / 10) + 232;
+  }
+  const rIndex = Math.round(r4 / 255 * 5);
+  const gIndex = Math.round(g3 / 255 * 5);
+  const bIndex = Math.round(b2 / 255 * 5);
+  return 16 + 36 * rIndex + 6 * gIndex + bIndex;
+}
+function coloredSquare(r4, g3, b2) {
+  if (hasLimitedColorSupport()) {
+    const colorCode = rgbTo256(r4, g3, b2);
+    return `\x1B[38;5;${colorCode}m■\x1B[0m`;
+  }
+  return `\x1B[38;2;${r4};${g3};${b2}m■\x1B[0m`;
+}
+function getColorLimitationNote() {
+  if (hasLimitedColorSupport()) {
+    const dim = "\x1B[2m";
+    const yellow = "\x1B[33m";
+    const reset = "\x1B[0m";
+    return `${yellow}Note:${reset} ${dim}Using 256-color mode. macOS Terminal.app has limited truecolor support.${reset}
+${dim}For accurate color previews, use iTerm2, Warp, kitty, or another truecolor terminal.${reset}`;
+  }
+  return null;
+}
+
 // src/index.ts
 if (process.argv.includes("--help") || process.argv.includes("-h")) {
   showHelp();
@@ -9906,7 +9941,7 @@ function showHelp() {
   const dim = "\x1B[2m";
   const reset = "\x1B[0m";
   const help = `
-rampa v1.0.1
+rampa v1.1.1
 Generate mathematically accurate color palettes from a base color
 
 USAGE
@@ -9944,7 +9979,7 @@ HARMONIES
   ${cyan}--add <type>${reset}                   ${dim}Add harmony ramp (can repeat)${reset}
 
                                   ${dim}Types: complementary, triadic, analogous,${reset}
-                                  ${dim}split-complementary, square, compound${reset}
+                                  ${dim}split-complementary, square, compound, shift:<degrees>${reset}
 
 OUTPUT
   ${cyan}-O, --output <format>${reset}          ${dim}Output format (default: text)${reset}
@@ -9960,6 +9995,7 @@ EXAMPLES
   ${cyan}rampa -C "#3b82f6"${reset}
   ${cyan}rampa -C "#3b82f6" --size=5 -L 10:90${reset}
   ${cyan}rampa -C "#3b82f6" --add=complementary --add=triadic${reset}
+  ${cyan}rampa -C "#3b82f6" --add=shift:45 --add=shift:90${reset}
   ${cyan}rampa -C "#3b82f6" -O css${reset}
   ${cyan}rampa -C "#3b82f6" --tint-color="#FF0000" --tint-opacity=15${reset}
 `;
@@ -10077,16 +10113,19 @@ Examples:
   rampa -C "#3b82f6" --tint-color="#FF0000" --tint-opacity=20 --tint-blend=screen
 `,
   add: `
---add <harmony>  Add harmony ramps (can be used multiple times)
+--add <type>  Add harmony ramps (can be used multiple times)
 
-Available harmonies:
+Available types:
   ${HARMONY_TYPES.join(", ")}
+  shift:<degrees>  - Custom hue rotation (e.g., shift:45, shift:-30)
 
 Examples:
   rampa -C "#3b82f6" --add=complementary
   rampa -C "#3b82f6" --add=triadic
   rampa -C "#3b82f6" --add=complementary --add=analogous
-  rampa -C "#3b82f6" --add=split-complementary --add=square
+  rampa -C "#3b82f6" --add=shift:45           # Warm shift
+  rampa -C "#3b82f6" --add=shift:-30          # Cool shift
+  rampa -C "#3b82f6" --add=shift:45 --add=shift:90
 `,
   output: `
 --output, -O <format>  Output format
@@ -10140,7 +10179,7 @@ var validFormats = ["hex", "hsl", "rgb", "oklch"];
 var main = defineCommand({
   meta: {
     name: "rampa",
-    version: "1.0.1",
+    version: "1.1.1",
     description: "Generate mathematically accurate color palettes from a base color"
   },
   args: {
@@ -10214,7 +10253,7 @@ var main = defineCommand({
     },
     add: {
       type: "string",
-      description: "Add harmony ramp (repeatable: complementary, triadic, etc.)"
+      description: "Add harmony ramp (repeatable: complementary, triadic, shift:N, etc.)"
     },
     output: {
       type: "string",
@@ -10334,14 +10373,29 @@ var main = defineCommand({
     }
     const addValues = args.add ? Array.isArray(args.add) ? args.add : [args.add] : [];
     const harmonies = [];
-    for (const h2 of addValues) {
-      if (!isValidHarmonyType(h2)) {
-        console.error(`Error: Invalid harmony type "${h2}"
+    const hueShifts = [];
+    for (const value of addValues) {
+      if (value.startsWith("shift:")) {
+        const shiftStr = value.slice(6);
+        const shift = parseFloat(shiftStr);
+        if (isNaN(shift)) {
+          console.error(`Error: Invalid shift value "${shiftStr}" - must be a number
 `);
-        showFlagHelp("add");
-      }
-      if (!harmonies.includes(h2)) {
-        harmonies.push(h2);
+          showFlagHelp("add");
+        }
+        const normalized = (shift % 360 + 360) % 360;
+        if (!hueShifts.includes(normalized)) {
+          hueShifts.push(normalized);
+        }
+      } else {
+        if (!isValidHarmonyType(value)) {
+          console.error(`Error: Invalid harmony type "${value}"
+`);
+          showFlagHelp("add");
+        }
+        if (!harmonies.includes(value)) {
+          harmonies.push(value);
+        }
       }
     }
     if (!tintColor && tintOpacity > 0) {
@@ -10431,11 +10485,32 @@ var main = defineCommand({
         });
       });
     }
+    for (const shift of hueShifts) {
+      const baseChroma = chroma_js_default(validatedColor);
+      const [h2, s2, l2] = baseChroma.hsl();
+      const shiftedHue = ((h2 || 0) + shift) % 360;
+      const shiftedBaseColor = chroma_js_default.hsl(shiftedHue, s2, l2).hex();
+      const shiftedRampColors = generateColorRamp(buildConfig(shiftedBaseColor));
+      const formattedShiftedColors = shiftedRampColors.map((c4) => formatColor2(c4, outputFormat));
+      ramps.push({
+        name: `shift-${Math.round(shift)}`,
+        baseColor: formatColor2(shiftedBaseColor, outputFormat),
+        config: buildRampConfig(),
+        colors: formattedShiftedColors
+      });
+    }
     if (outputType === "json") {
       console.log(formatJson(ramps));
     } else if (outputType === "css") {
       console.log(formatCss2(ramps));
     } else {
+      if (args.preview) {
+        const limitationNote = getColorLimitationNote();
+        if (limitationNote) {
+          console.log(limitationNote);
+          console.log("");
+        }
+      }
       ramps.forEach((ramp, rampIndex) => {
         if (rampIndex > 0 || ramps.length > 1) {
           if (rampIndex > 0)
@@ -10446,7 +10521,7 @@ var main = defineCommand({
           if (args.preview) {
             const c4 = chroma_js_default(color);
             const [r4, g3, b2] = c4.rgb();
-            const square = `\x1B[38;2;${r4};${g3};${b2}m■\x1B[0m`;
+            const square = coloredSquare(r4, g3, b2);
             console.log(`${square} ${color}`);
           } else {
             console.log(color);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basiclines/rampa",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "description": "Generate mathematically accurate color palettes from a base color",
   "type": "module",
   "bin": {