@roobscoob/vibes 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rose Kodsi-Hall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,255 @@
-# Temporary Holding Version
+# @roobscoob/vibes
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Color, light and time for sketches on the lights at the
+[Recurse Center](https://www.recurse.com): the room's color bulbs, 4×1
+panels and old on/off bulbs, run by arclamp and made in vibes.
+
+```sh
+npm install @roobscoob/vibes
+```
+
+```ts
+import { sketch, white, wave } from "@roobscoob/vibes";
+
+// A slow warm wave rolls across the room.
+export const update = sketch(({ x, t }) => white(2700, 30 + 400 * wave(t / 8 - x / 12)));
+```
+
+## One light, now
+
+A sketch says what each light should make, a hundred times a second.
+`sketch()` asks your function once per light per tick, and gives it `here`:
+
+| | |
+|---|---|
+| `x`, `y` | where the light is, in meters from the building's top-left corner |
+| `u`, `v` | the same, 0 to 1 across the room the lights fill (left to right, top to bottom) |
+| `t` | seconds since the sketch started |
+| `dt` | seconds since the last tick (about 0.01 in the room, 0.03 in the preview) |
+| `now` | the clock, in ms since 1970 |
+| `light` | the light itself: `id`, `kind` (`"color"` or `"switch"`), `tags`, `has(tag)`, `rail`, `random`, `below`, `state` |
+| `room` | every light: `lights`, `rails`, `rail(id)`, `tagged(tag)`, `width`, `depth`, `center` |
+| `at({ x, y, t })` | the same light, looking from somewhere else or at another time |
+
+Return a color (anything that says one: see below), or `null` to leave the
+light as the layers below have it. `sketch("#f80")` makes every light one
+color; `sketch(palettes.dusk)` lays a palette across the room.
+
+- `light.rail` is `{ id, along, t, index, count }`: how far along its rail
+  (meters, and 0 to 1), its place on it, and how many share it.
+- `light.random` is a number from 0 to 1 of its own, the same every time.
+- `light.below` is what the layers below this sketch make it, as a color.
+- `light.state` is the light's own memory, kept from tick to tick.
+
+Old bulbs only switch: `sketch()` turns them on at 100 lm or more and off
+below 70 (`sketch(fn, { switchOn, switchOff })` to change that). Something
+that isn't a color leaves its light as it is, with a warning in the console,
+so one slip doesn't stop the sketch.
+
+## Colors
+
+A color is light: a hue and chroma (OKLab's a and b at full lightness), and
+an amount of light in **lumens**. Lumens are absolute, the same on every
+light: 800 lm is a bright bulb, 20 lm a glow, whichever bulb it lands on.
+
+Colors never change. Read them with properties, and change them with
+methods, each giving a new color:
+
+```ts
+const warm = white(2700).at(400);
+warm.mix("#ff8800", 0.3).fade(0.5);
+light.below.shiftHue(20).dim(0.8);   // a filter over what's below
+```
+
+### Making them
+
+```ts
+white(2700, 400)            // a white by color temperature, 400 lm
+lemtone(265, 0.3, 40)       // the lights' own: hue, chroma at full lightness, lumens
+oklch(0.7, 0.2, 265)        // CSS's oklch()
+hsl(240, 1, 0.5)            // the familiar wheel: 0 red, 120 green, 240 blue
+rgb(1, 0.5, 0)              // 0–1, or 0–255
+hex("#ff8800")
+xy(0.3127, 0.329, 500)      // CIE 1931 chromaticity, lumens
+color(anything)             // anything below
+off
+```
+
+Screens' spaces (RGB, hex, HSL, OKLCh, …) count a screen's white as a fixed
+1000 lm: `#ffffff` is 1000 lm, `#0000ff` about 72, `oklch(0.5 0 0)` 125, as
+dim next to white as on a screen. `white()` and `lemtone()` take lumens
+straight (1000 if not given), and `.at(lm)` sets them on any color.
+
+Hues in the lights' own terms (`lemtone`, `c.hue`) are OKLab's: about 30°
+red, 110° yellow, 145° green, 195° cyan, 265° blue, 330° magenta. They're
+not HSL's, which is why `hsl()` is its own maker. Chroma: 0 is white, 0.1
+pale, 0.3 strong.
+
+### Anything that says a color
+
+Wherever a color goes (`color()`, `.mix()`, `.add()`, palettes, fields,
+what your look returns, `sketch()` itself), anything that says one will do:
+
+| | |
+|---|---|
+| text | any CSS color: `"#f80"`, `"ff8800cc"`, `"orange"`, `"rgb(255 136 0 / 50%)"`, `"hsl(30deg, 100%, 50%)"`, `"hwb(…)"`, `"oklch(70% 0.2 265)"`, `"oklab(…)"`, `"lab(…)"`, `"lch(…)"`, `"color(display-p3 1 0 0)"` |
+| | color temperatures: `"2700K"`, `"2700 kelvin"`, `"candlelight"`, `"incandescent"`, `"halogen"`, `"daylight"` |
+| | the lights' own: `"lemtone(265 0.3 40)"`, and `"265° C0.300 · 40 lm"` (as a color prints itself) |
+| | with lumens or fidelity alongside: `"#f80 · 120 lm"`, `"2700K @ 400lm"`, `"orange 50 lumens"`, `"… · F0.5"` |
+| a number | a color temperature in kelvin: `2700` |
+| a list | `[r, g, b]` or `[r, g, b, alpha]`, 0–1 or 0–255 |
+| an object | `{ a, b, lm }`, arclamp's channels `{ a, b, brightness, fidelity }`, `{ r, g, b }`, `{ h, s, l }`, `{ l, c, h }`, `{ hue, chroma, lm }`, `{ kelvin, lm }`, `{ x, y }`, an old bulb's `{ on }`, with `lm`, `lumens`, `brightness` or `fidelity` on any |
+| nothing | `null` or `undefined` is `off` |
+
+Alpha is less light: `#ff880080` is half the lumens of `#ff8800`.
+Something it can't read throws, saying what it would take.
+
+### Reading them
+
+| | |
+|---|---|
+| `c.lm`, `c.brightness` | lumens; arclamp's units (1.0 is 1000 lm) |
+| `c.hue`, `c.chroma` | in the lights' own terms |
+| `c.kelvin`, `c.nearestKelvin` | its color temperature if it's a white (else null); the nearest white's |
+| `c.looks` | how bright it looks, 0–1 (1000 lm and up is 1) |
+| `c.hex`, `c.rgb`, `c.hsl`, `c.oklch`, `c.oklab`, `c.xy`, `c.xyz` | in other spaces, on the same 1000 lm scale (`rgb` goes past 1 when brighter) |
+| `c.channels` | arclamp's channels |
+| `` `${c}` `` | `"2700 K · 400 lm"`, which `color()` reads back |
+
+### Changing them
+
+| | |
+|---|---|
+| `.at(lm)` | the same color at `lm` lumens |
+| `.dim(k)`, `.fade(k)` | k times the lumens; looks k times as bright |
+| `.mix(other, t)` | toward another color by t (0.5 if not given), evenly as it looks; to or from dark, only brightness changes |
+| `.add(...others)` | lights shining together, added up as light |
+| `.shiftHue(deg)`, `.saturate(k)` | |
+| `.with({ … })` | any of `a`, `b`, `hue`, `chroma`, `kelvin`, `lm`, `brightness`, `fidelity` changed |
+| `.vivid()` | dimmed to what a color bulb makes of it, so it isn't paled |
+
+### Palettes
+
+`palette(a, b, c)` is colors from 0 to 1: `palette(a, b, c)(0.5)` is `b`.
+Stops can be anything that says a color, in a list, or placed:
+`palette([0, "black"], [0.2, "#f80"], [1, 6500])`. Outside 0–1 it holds the
+ends. `palettes.dusk`, `.sea`, `.ember` and `.aurora` start you off, each
+dark to bright, within what the bulbs make.
+
+### What bulbs make
+
+**Saturated colors are dim.** A color bulb's strongest blue tops out near
+30 lm; asked for more, a bulb keeps the lumens and pales the color toward
+white. `c.vivid()` dims it instead, so it stays the color you asked for, and
+`br30.maxLm(c)` says how bright a color can be on a color bulb (`br30` is
+arclamp's name for them). Whites go brightest around 4000 K (about 950 lm),
+and 2700 K reaches about 500; the bulbs go no warmer than about 1800 K, and
+only dimly there. 4×1 panels have no model yet.
+
+## Fields
+
+A field is a pattern over the room and time: a function of `here`, with
+methods to chain. Sources make numbers from 0 to 1, a palette makes them
+colors, and `sketch()` takes the result.
+
+```ts
+import { sketch, osc, noise, palettes } from "@roobscoob/vibes";
+
+export const update = sketch(
+  osc(3, 0.05)                    // 3 bands across the room, each light going round 0.05 times a second
+    .rotate(({ t }) => t * 6)     // any number can be a function of here: 6° a second
+    .kaleid(5)
+    .warp(noise(2, 0.1), 1.5)     // pushed up to 1.5 m by slow noise
+    .color(palettes.dusk),
+);
+```
+
+Sources count across the room's width, from its center.
+
+| Sources | |
+|---|---|
+| `osc(n, speed, phase)` | smooth bands, n across the room |
+| `noise(n, speed)` | smooth noise, blobs about n across |
+| `rings(n, speed)` | rings out from the center |
+| `gradient(degrees)` | 0 to 1 across the room: 0° left to right, 90° top to bottom |
+| `voronoi(n, speed)` | drifting cells, 0 at their centers |
+| `solid(value)` | the same everywhere, a number or a color |
+| `field(fn)` | your own function of here, to chain onto |
+
+`speed` is how many times a second each light goes round.
+
+| Methods | |
+|---|---|
+| `.rotate(deg)`, `.scale(k)`, `.move(dx, dy)`, `.kaleid(n)`, `.warp(field, meters)` | where it looks |
+| `.delay(seconds)`, `.speed(k)` | when it looks: `.delay(({ u }) => 2 * u)` runs later across the room |
+| `.pow(k)`, `.steps(n)`, `.thresh(level)`, `.invert()`, `.mul(k)`, `.add(x)`, `.mix(x, t)` | numbers |
+| `.color(palette)` | numbers to colors: a palette, a list of stops (`["black", "#f80", "white"]`), one color (dark to it), or your own function |
+| `.at(lm)`, `.dim(k)`, `.fade(k)`, `.boost(by, amount)`, `.shiftHue(deg)`, `.saturate(k)`, `.vivid()`, `.add(color)`, `.mix(color, t)` | colors |
+| `.map(fn)` | your own change: `.map((v, here) => ...)` |
+| `.only(test)` | just some lights: `.only((light) => light.rail)` |
+
+Transforms move where and when a field looks, never which light it is.
+
+## Both at once
+
+A field is a function of `here`, so your function can read one, and
+`field()` makes your function chainable:
+
+```ts
+const petals = osc(3, 0.05).rotate(({ t }) => t * 6).kaleid(5);
+
+export const update = sketch((here) => {
+  const { light, t } = here;
+  if (light.rail) return palettes.sea(petals(here)).vivid();   // bulbs on rails show the petals
+  return white(2200, 200 * wave(t / 4 + light.random));       // panels breathe, each on its own beat
+});
+```
+
+Nothing needs a chain: every transform is also a plain function on `here`
+(`rotate(here, 30)`, `kaleid(here, 5)`, `delay(here, 1)`, …).
+
+## Time
+
+Waves count in cycles and run 0 to 1: `wave(t / 8)` goes round every 8 s.
+
+| | |
+|---|---|
+| `wave`, `saw`, `tri`, `square(x, duty)` | smooth, rising, up and down, on and off |
+| `ease.in`, `ease.out`, `ease.inOut`, `smoothstep`, `lerp`, `remap`, `clamp`, `fract` | |
+| `noiseAt(x, y, z)` | smooth noise from any numbers |
+| `hash(...ns)` | a number from 0 to 1 that's the same for the same inputs |
+| `decay(dt, halfLife)` | `v *= decay(dt, 2)` halves v every 2 s |
+| `chance(perSecond, dt)` | true as often as something happening that many times a second |
+
+The room ticks about three times as often as the preview, so anything done
+each tick should use `dt`: `decay` and `chance` do.
+
+A clock counts beats, for wiring into any number a field takes:
+
+```ts
+const beat = clock(96);
+const hit = beat.every(1).env({ attack: 0.02, release: 0.45 });   // 0 → 1 → 0 on every beat
+const turn = beat.every(4).seq([0, 45, 90, 135]);                 // a hard step each bar
+const look = beat.every(16).seq([palettes.dusk, palettes.sea]);
+
+export const update = sketch(osc(4, 0.1).rotate(turn).kaleid(6).color(look).boost(hit, 0.8));
+```
+
+`every(n)` also gives `count`, `ramp` (0 to 1 between marks) and `since`.
+
+## Without sketch()
+
+`sketch()` makes arclamp's `update(prev, nowMs, initialMs)`, which you can
+write yourself: it gets every light (`id`, `channels`, `tags`, `coords`,
+`rail`) and returns `{ lights: [{ id, channels }] }`. Color lights' channels
+are `a`, `b`, `brightness` (1.0 = 1000 lm) and `fidelity`; old bulbs' is `on`.
+`color(light.channels)` reads a light's channels, and `c.channels` writes
+them. The types are `Prev`, `Out` and `Update`.
+
+## Working on this library
+
+It lives in vibes (`packages/vibes`). `node packages/vibes/scripts/gamut.ts`
+remakes the color bulbs' table from vibes' model of them; `npm run build` in
+this folder makes `dist/`.
+
+MIT licensed.

package/dist/arclamp.d.ts

@@ -0,0 +1,34 @@
+/** Where a light is: millimeters on its floor's plan, from the building's top-left wall corner. */
+export interface Coords {
+    mm_x: number;
+    mm_y: number;
+    floor: number;
+}
+/** A light as update() is given it. */
+export interface PrevLight {
+    id: number;
+    /** A color bulb's or panel's a, b, brightness (1.0 = 1000 lm) and fidelity, or an old bulb's on. */
+    channels: Record<string, number>;
+    tags?: string[] | null;
+    /** Null until the light has been placed. */
+    coords?: Coords | null;
+    /** The rail it hangs on, and how far along it from the rail's start. */
+    rail?: {
+        id: string;
+        mm_along: number;
+    } | null;
+}
+export interface Prev {
+    initial_time: number;
+    lights: PrevLight[];
+}
+/** The lights to change, and their channels; anything left out keeps its value from below. */
+export interface Out {
+    lights: {
+        id: number;
+        channels: Record<string, number>;
+    }[];
+}
+/** arclamp's shader entry point. */
+export type Update = (prev: Prev, nowMs: number, initialMs: number) => Out;
+//# sourceMappingURL=arclamp.d.ts.map

package/dist/arclamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arclamp.d.ts","sourceRoot":"","sources":["../src/arclamp.ts"],"names":[],"mappings":"AAKA,mGAAmG;AACnG,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,oGAAoG;IACpG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACvB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,IAAI;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,8FAA8F;AAC9F,MAAM,WAAW,GAAG;IAClB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,EAAE,CAAC;CAC5D;AAED,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,GAAG,CAAC"}

package/dist/arclamp.js

@@ -0,0 +1,5 @@
+// What update() is given, and gives back: arclamp's shader contract
+// (rclamp backend/internal/state ToJSObject). update(prev, nowMs, initialMs)
+// runs about a hundred times a second, with every light as the layers below
+// left it, and says what each should be making now.
+export {};

package/dist/color.d.ts

@@ -0,0 +1,199 @@
+import { type Vec3 } from "./lemtone.ts";
+/** Anything that says a color: see the top of color.ts. */
+export type ColorInput = Color | string | number | readonly number[] | {
+    readonly [key: string]: unknown;
+};
+/** A color, given anywhere but as a number (which in a field is a number, not a color temperature). */
+export type ColorLike = Exclude<ColorInput, number>;
+/** What Color.with() changes: any of these, the rest kept. */
+export interface ColorChanges {
+    a?: number;
+    b?: number;
+    hue?: number;
+    chroma?: number;
+    kelvin?: number;
+    lm?: number;
+    lumens?: number;
+    /** In arclamp's units: 1.0 is 1000 lm. */
+    brightness?: number;
+    fidelity?: number;
+}
+export declare class Color {
+    /** OKLab's a at full lightness: green (−) to red (+). */
+    readonly a: number;
+    /** OKLab's b at full lightness: blue (−) to yellow (+). */
+    readonly b: number;
+    /** How much light, in lumens. */
+    readonly lm: number;
+    /** 0 builds pale colors and whites from the RGB LEDs, 1 from the white ones. */
+    readonly fidelity: number;
+    constructor(a: number, b: number, lm: number, fidelity?: number);
+    /** Reads anything that says a color, as color() does. */
+    static from(input: ColorInput, lm?: number): Color;
+    /** Its hue in degrees, 0–360 (OKLab's: about 30 red, 110 yellow, 145 green, 265 blue, 330 magenta). */
+    get hue(): number;
+    /** How saturated: 0 is white, 0.1 pale, 0.3 strong. */
+    get chroma(): number;
+    /** Its color temperature, if it's a white; null if it isn't. */
+    get kelvin(): number | null;
+    /** The color temperature of the white nearest it, white or not. */
+    get nearestKelvin(): number;
+    /** How bright it looks, 0–1 (the cube root of its light; 1000 lm and up is 1). */
+    get looks(): number;
+    /** Its brightness in arclamp's units: 1.0 is 1000 lm. */
+    get brightness(): number;
+    /** As arclamp's channels for a color light. */
+    get channels(): {
+        a: number;
+        b: number;
+        brightness: number;
+        fidelity: number;
+    };
+    /** As CIE XYZ (D65), with Y = 1 for 1000 lm. */
+    get xyz(): Vec3;
+    /** Its CIE 1931 chromaticity. */
+    get xy(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * As sRGB, 0–1 per channel at 1000 lm of white (past 1 when brighter). What
+     * a screen can't show of it (the bulbs' deepest blues, say) is left out.
+     */
+    get rgb(): {
+        r: number;
+        g: number;
+        b: number;
+    };
+    /** As a CSS hex code, "#rrggbb", clipped to what a screen shows. */
+    get hex(): string;
+    /** As HSL: hue in degrees, saturation and lightness 0–1 (clipped to what a screen shows). */
+    get hsl(): {
+        h: number;
+        s: number;
+        l: number;
+    };
+    /** As OKLab (CSS's: L 0–1, at 1000 lm of white). */
+    get oklab(): {
+        l: number;
+        a: number;
+        b: number;
+    };
+    /** As OKLCh (CSS's: L 0–1 at 1000 lm of white, chroma, hue in degrees). */
+    get oklch(): {
+        l: number;
+        c: number;
+        h: number;
+    };
+    /** The same color at `lm` lumens. */
+    at(lm: number): Color;
+    /** k times the light: dim(0.5) is half the lumens, dim(2) twice. */
+    dim(k: number): Color;
+    /** Looks k times as bright: fade(0.5) looks half as bright (an eighth of the lumens). */
+    fade(k: number): Color;
+    /** With some of it changed: with({ fidelity: 0 }), with({ hue: 200 }), with({ kelvin: 3000 }). */
+    with(changes: ColorChanges): Color;
+    /**
+     * Toward `other` by t (0 is this, 1 is other; 0.5 if not given), evenly as
+     * it looks: the color in a straight line through OKLab, brightness by its
+     * cube root. To or from dark, only the brightness changes.
+     */
+    mix(other: ColorInput, t?: number): Color;
+    /** This and others shining together: their light added up, as it would be on a wall. */
+    add(...others: ColorInput[]): Color;
+    /** The hue turned by `degrees`. */
+    shiftHue(degrees: number): Color;
+    /** k times the chroma: 0 is white, 1 unchanged, 2 twice as saturated. */
+    saturate(k: number): Color;
+    /** Dimmed, if need be, to what a bulb makes of it (a color bulb, br30, unless told), so it isn't paled. */
+    vivid(bulb?: Bulb): Color;
+    /** Like "2700 K · 400 lm" or "265° C0.300 · 40 lm"; color() reads it back. */
+    toString(): string;
+    toJSON(): {
+        a: number;
+        b: number;
+        lm: number;
+        fidelity: number;
+    };
+}
+/** No light. */
+export declare const off: Color;
+/**
+ * Anything that says a color, as a Color (see the top of color.ts), at `lm`
+ * lumens if given. Throws, saying why, if it can't tell what color it is.
+ */
+export declare function color(input: ColorInput, lm?: number): Color;
+/**
+ * A white of this color temperature (2700 K is a warm bulb, 4000 K neutral,
+ * 6500 K daylight; the bulbs go as warm as about 1800 K, dimly), at `lm`
+ * lumens (1000 if not given). With no temperature, OKLab's own white.
+ */
+export declare function white(kelvin?: number | string, lm?: number): Color;
+/**
+ * A color in the lights' own terms: hue in degrees (OKLab's: about 30 red,
+ * 110 yellow, 145 green, 265 blue, 330 magenta), chroma at full lightness (0
+ * white, 0.1 pale, 0.3 strong, up to about 0.8 for the bulbs' violet), and
+ * lumens (1000 if not given).
+ */
+export declare function lemtone(hue: number, chroma: number, lm?: number, fidelity?: number): Color;
+/** CSS's oklch(): lightness 0–1 (past 1, a percentage), chroma, hue in degrees; L = 1 is 1000 lm of white. */
+export declare function oklch(l: number, c: number, h: number, alpha?: number): Color;
+/** CSS's oklab(): lightness 0–1 (past 1, a percentage), a, b; L = 1 is 1000 lm of white. */
+export declare function oklab(l: number, a: number, b: number, alpha?: number): Color;
+/** sRGB, 0–1 per channel (0–255 if any is past 1), white at 1000 lm. */
+export declare function rgb(r: number, g: number, b: number, alpha?: number): Color;
+/** HSL: hue in degrees, saturation and lightness 0–1 (past 1, percentages), white at 1000 lm. */
+export declare function hsl(h: number, s: number, l: number, alpha?: number): Color;
+/** A CSS hex code ("#f80", "#ff8800", "ff8800cc"), or anything else color() reads. */
+export declare const hex: (code: string) => Color;
+/** A CIE 1931 chromaticity, at `lm` lumens (1000 if not given). */
+export declare function xy(x: number, y: number, lm?: number): Color;
+/** Colors along a line from 0 to 1: palette(x) is the color at x. */
+export interface Palette {
+    (x: number): Color;
+    readonly stops: readonly Color[];
+    /** Where each stop is, 0 to 1. */
+    readonly positions: readonly number[];
+}
+/** A palette's stop: a color, or a color at a place, [0.3, "#f80"]. */
+export type Stop = ColorInput | readonly [number, ColorInput];
+/** Whether v is a palette. */
+export declare const isPalette: (v: unknown) => v is Palette;
+/**
+ * A palette through these colors (evenly spaced from 0 to 1 unless placed,
+ * [0.3, "#f80"]), mixed between them; outside 0–1 it holds the ends.
+ * palette(a, b, c) and palette([a, b, c]) are the same.
+ */
+export declare function palette(...given: Stop[] | [readonly Stop[]]): Palette;
+/** A palette from anything that says one: a palette, a list of stops, or one color (from dark at 0 to it at 1). */
+export declare function toPalette(v: unknown): Palette;
+/** Palettes to start from, each dark to bright, within what the color bulbs make. */
+export declare const palettes: {
+    /** Deep violet, magenta, orange, warm white. */
+    dusk: Palette;
+    /** Deep blue, teal, pale cyan, cool white. */
+    sea: Palette;
+    /** Ember red, orange, firelight, warm white. */
+    ember: Palette;
+    /** Green, teal, violet: northern lights. */
+    aurora: Palette;
+};
+/** What a kind of light can make of each color. */
+export interface Bulb {
+    /** arclamp's name for it. */
+    readonly type: string;
+    /** The most lumens it makes of this color before it starts to pale it; 0 past its most saturated. */
+    maxLm(c: ColorInput): number;
+    /** The most chroma it makes of this hue. */
+    edgeOf(hue: number): number;
+    /** The color, dimmed if need be to what it makes, so it isn't paled; one more saturated than it makes at all, brought in to the most it does. */
+    vivid(c: ColorInput): Color;
+}
+/**
+ * The color bulbs (br30), from vibes' model of Walter's solve: asked for more
+ * than they can make of a color, they keep the lumens and pale it toward
+ * white. A strong blue tops out near 30 lm; whites near 950 at 4000 K, 500 at
+ * 2700 K.
+ */
+export declare const br30: Bulb;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"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"}