@promptbook/color weekly downloads statistics

<!-- ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten -->

🐙 Promptbook: Invisible AI Agents

Create persistent AI agents that turn your company's scattered knowledge into action - powered by the Agents Server

🚀 Quick deploy

Run the standalone VPS installer (for example on DigitalOcean) only on a fresh server. Interactive mode asks for the installation values:

sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/install.sh | bash

Non-interactive mode takes defaults from command-line options. Use --env live, --env preview, --env production, or --env lts to pick the installed environment; the default is preview. When --openai-api-key is provided with the default OpenAI Codex runner, the installer installs and configures Codex automatically; other runner authentication can be configured later from the UI or SSH:

sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/install.sh | bash -s -- \
    --non-interactive \
    --yes-i-understand-that-script-should-be-run-on-fresh-server \
    --env preview \
    --domain my-server.com \
    --openai-api-key sk-proj-xxx \
    --admin-password xxx

<blockquote style="color: #ff8811"> <b>⚠ Warning:</b> This is a pre-release version of the library. It is not yet ready for production use. Please look at <a href="https://www.npmjs.com/package/@promptbook/core?activeTab=versions">latest stable release</a>. </blockquote>

📦 Package @promptbook/color

• Promptbooks are divided into several packages, all are published from single monorepo.
• This package @promptbook/color is one part of the promptbook ecosystem.

To install this package, run:

# Install entire promptbook ecosystem
npm i ptbk

# Install just this package to save space
npm install @promptbook/color

🎨 Core Features

Color Creation and Parsing

Create colors from various formats including hex, RGB, HSL, and CSS color names:

import { Color } from '@promptbook/color';

// From hex values
const blue = Color.fromHex('#009edd');
const shortHex = Color.fromHex('#09d');

// From RGB values
const red = Color.fromValues(255, 0, 0);
const transparentRed = Color.fromValues(255, 0, 0, 128); // 50% alpha

// From CSS color names
const navy = Color.get('midnightblue');

// From various string formats
const color1 = Color.fromString('#ff0000');
const color2 = Color.fromString('rgb(255, 0, 0)');
const color3 = Color.fromString('red');

Color Manipulation

Transform colors using various operators:

import { Color, darken, lighten, grayscale, negative } from '@promptbook/color';

const originalColor = Color.fromHex('#009edd');

// Darken and lighten colors
const darker = darken(originalColor, 0.2);
const lighter = lighten(originalColor, 0.3);

// Convert to grayscale
const gray = grayscale(originalColor);

// Create negative/inverted color
const inverted = negative(originalColor);

// Adjust alpha channel
const transparent = withAlpha(originalColor, 0.5);

Color Analysis

Analyze color properties and relationships:

import { colorDistance, colorLuminance, colorHue, colorSaturation, areColorsEqual } from '@promptbook/color';

const color1 = Color.fromHex('#ff0000');
const color2 = Color.fromHex('#00ff00');

// Calculate distance between colors
const distance = colorDistance(color1, color2);

// Get color properties
const luminance = colorLuminance(color1);
const hue = colorHue(color1);
const saturation = colorSaturation(color1);

// Compare colors
const areEqual = areColorsEqual(color1, color2);

Color Mixing and Blending

Mix colors and find optimal color combinations:

import { mixColors, mixWithColor, nearest, furthest, textColor } from '@promptbook/color';

const red = Color.fromHex('#ff0000');
const blue = Color.fromHex('#0000ff');

// Mix two colors
const purple = mixColors(red, blue, 0.5); // 50/50 mix

// Mix with a specific color
const tinted = mixWithColor(red, Color.fromHex('#ffffff'), 0.2); // Add 20% white

// Find nearest color from a palette
const palette = [Color.get('red'), Color.get('green'), Color.get('blue')];
const closest = nearest(Color.fromHex('#ff3333'), palette);

// Find furthest color for maximum contrast
const contrast = furthest(red, palette);…