@basiclines/rampa 1.0.1 → 1.1.0

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

@@ -9906,7 +9906,7 @@ function showHelp() {
   const dim = "\x1B[2m";
   const reset = "\x1B[0m";
   const help = `
-rampa v1.0.1
+rampa v1.1.0
 Generate mathematically accurate color palettes from a base color
 
 USAGE
@@ -9944,7 +9944,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 +9960,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 +10078,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 +10144,7 @@ var validFormats = ["hex", "hsl", "rgb", "oklch"];
 var main = defineCommand({
   meta: {
     name: "rampa",
-    version: "1.0.1",
+    version: "1.1.0",
     description: "Generate mathematically accurate color palettes from a base color"
   },
   args: {
@@ -10214,7 +10218,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 +10338,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,6 +10450,20 @@ 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") {

package/package.json

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