@roobscoob/vibes 0.1.0 → 0.2.0

package/README.md

@@ -32,19 +32,41 @@ A sketch says what each light should make, a hundred times a second.
 | `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 as the layers below have it. `sketch("#f80")` makes every color 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.below` is what the layers below this sketch make it, as a color, and
+  `light.belowOn` whether that's on at all.
 - `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.
+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.
+
+## Old bulbs
+
+The old bulbs only switch, and look nothing like the color lights, so they
+have a look of their own, apart from color's. Each look is named for the
+kind of light it's for, as `light.kind` names them:
+
+```ts
+export const update = sketch({
+  color: osc(3).color(palettes.dusk),   // the color bulbs and panels
+  switch: osc(1, 0.25).thresh(),        // the old bulbs: on or off
+});
+```
+
+`sketch(look)` is `sketch({ color: look })`: a color look is never asked
+about old bulbs, and never switches them. Without a `switch` look they're
+left as they are; `sketch(look, { switch })` gives one beside a color look.
+
+A `switch` look gives `true` or `false`, a number (on at 0.5 or more, as
+arclamp's own `on` channel: a field from 0 to 1 works, like
+`noise(4).thresh(0.6)` or `clock(96).every(1).env()`), `"on"` or `"off"`, or
+`null` to leave the bulb as it is. It can be a function of `here`, a field,
+or one answer for every old bulb: `sketch({ switch: true })`.
 
 ## Colors
 

package/dist/color.d.ts

@@ -1,4 +1,5 @@
 import { type Vec3 } from "./lemtone.ts";
+import type { Here } from "./here.ts";
 /** Anything that says a color: see the top of color.ts. */
 export type ColorInput = Color | string | number | readonly number[] | {
     readonly [key: string]: unknown;
@@ -151,6 +152,8 @@ 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;
+    /** Given a here instead, the palette laid across the room, left to right: its color at here.u. */
+    (here: Here): Color;
     readonly stops: readonly Color[];
     /** Where each stop is, 0 to 1. */
     readonly positions: readonly number[];

package/dist/color.d.ts.map

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

package/dist/color.js

@@ -433,7 +433,8 @@ export function palette(...given) {
     const stops = Object.freeze(placed.map((p) => Object.freeze(p.c)));
     const positions = Object.freeze(placed.map((p) => p.at));
     const at = (x) => {
-        const v = Number.isFinite(x) ? x : 0;
+        const along = typeof x === "number" ? x : x?.u;
+        const v = typeof along === "number" && Number.isFinite(along) ? along : 0;
         if (v <= positions[0])
             return stops[0];
         for (let i = 1; i < stops.length; i++) {

package/dist/here.d.ts

@@ -38,6 +38,8 @@ export declare class Light {
     readonly random: number;
     /** What the layers below this sketch are making it do. */
     below: Color;
+    /** Whether the layers below have it on (for an old bulb), or lit at all (for a color light). */
+    belowOn: boolean;
     /** Its own memory, kept from one tick to the next. */
     state: Record<string, any>;
     constructor(p: PrevLight, x: number, y: number);

package/dist/here.d.ts.map

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

package/dist/here.js

@@ -30,6 +30,8 @@ export class Light {
     random;
     /** What the layers below this sketch are making it do. */
     below = off;
+    /** Whether the layers below have it on (for an old bulb), or lit at all (for a color light). */
+    belowOn = false;
     /** Its own memory, kept from one tick to the next. */
     state = {};
     constructor(p, x, y) {

package/dist/index.d.ts

@@ -4,5 +4,5 @@ export { Here, Light, Room, type Rail, type RailSpot } from "./here.ts";
 export { delay, field, gradient, isField, kaleid, move, noise, osc, rings, rotate, scale, solid, speed, voronoi, warp, type ColorParam, type Field, type Param, } from "./field.ts";
 export { clock, type Clock, type Every } from "./signal.ts";
 export { chance, clamp, decay, ease, fract, hash, lerp, noiseAt, remap, saw, smoothstep, square, tri, wave } from "./shape.ts";
-export { sketch, type Look, type LookResult, type SketchOptions } from "./sketch.ts";
+export { sketch, type Look, type LookResult, type Looks, type SketchOptions, type SwitchLook, type SwitchResult } from "./sketch.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EACL,IAAI,EACJ,KAAK,EACL,KAAK,EACL,GAAG,EACH,GAAG,EACH,SAAS,EACT,OAAO,EACP,GAAG,EACH,KAAK,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,GAAG,EACH,SAAS,EACT,KAAK,EACL,EAAE,EACF,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,IAAI,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,IAAI,EACJ,KAAK,EACL,GAAG,EACH,KAAK,EACL,MAAM,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,KAAK,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/H,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EACL,IAAI,EACJ,KAAK,EACL,KAAK,EACL,GAAG,EACH,GAAG,EACH,SAAS,EACT,OAAO,EACP,GAAG,EACH,KAAK,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,GAAG,EACH,SAAS,EACT,KAAK,EACL,EAAE,EACF,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,IAAI,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EACL,KAAK,EACL,KAAK,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,IAAI,EACJ,KAAK,EACL,GAAG,EACH,KAAK,EACL,MAAM,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,OAAO,EACP,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,KAAK,EACV,KAAK,KAAK,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/H,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/sketch.d.ts

@@ -1,21 +1,29 @@
-import { type ColorInput, type Palette } from "./color.ts";
+import { type ColorInput } from "./color.ts";
 import type { Update } from "./arclamp.ts";
 import { Here } from "./here.ts";
-/** What a light should make, here and now; null, undefined or false leaves it as it is below. */
+/** What a color light should make, here and now; null, undefined or false leaves it as it is below. */
 export type LookResult = ColorInput | null | undefined | false | void;
-/**
- * What a light should make, here and now: a function of here giving a color,
- * one color for every light, or a palette, laid across the room.
- */
-export type Look = ((here: Here) => LookResult) | ColorInput | Palette;
+/** The color lights' look: a function of here giving a color, one color for every light, or a palette, laid across the room. */
+export type Look = ((here: Here) => LookResult) | ColorInput;
+/** Whether an old bulb should be on: true or false, a number (on at 0.5 or more), "on" or "off"; null or undefined leaves it as it is. */
+export type SwitchResult = boolean | number | string | null | undefined | void;
+/** The old bulbs' look: a function of here (a field too) saying whether each is on, or one answer for them all. */
+export type SwitchLook = ((here: Here) => SwitchResult) | boolean | number | string;
+/** A look for each kind of light (light.kind); either may be left out, and its lights are left as they are. */
+export interface Looks {
+    /** For the color bulbs and panels. */
+    color?: Look;
+    /** For the old bulbs, which only switch. */
+    switch?: SwitchLook;
+}
 export interface SketchOptions {
-    /** Old bulbs switch on when asked for this many lumens or more (default 100: about halfway, to the eye, to one that's on). */
-    switchOn?: number;
-    /** And off when asked for fewer than this (default 70). */
-    switchOff?: number;
+    /** The old bulbs' look, beside a color look given on its own. */
+    switch?: SwitchLook;
 }
-/** Your look (a function of here, or a field) as arclamp's update(). */
+/** Your color look (a function of here, or a field) as arclamp's update(); old bulbs are left alone, unless given `switch`. */
 export declare function sketch(look: (here: Here) => LookResult, options?: SketchOptions): Update;
-/** One color for every light, or a palette laid across the room, as arclamp's update(). */
-export declare function sketch(look: ColorInput | Palette, options?: SketchOptions): Update;
+/** A look for each kind of light: { color, switch }. */
+export declare function sketch(looks: Looks): Update;
+/** One color for every color light, or a palette laid across the room, as arclamp's update(). */
+export declare function sketch(look: ColorInput, options?: SketchOptions): Update;
 //# sourceMappingURL=sketch.d.ts.map

package/dist/sketch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sketch.d.ts","sourceRoot":"","sources":["../src/sketch.ts"],"names":[],"mappings":"AAeA,OAAO,EAA2B,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,KAAK,EAAa,MAAM,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAW,IAAI,EAAiC,MAAM,WAAW,CAAC;AAKzE,iGAAiG;AACjG,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;AAEtE;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,GAAG,UAAU,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,8HAA8H;IAC9H,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;AAC1F,2FAA2F;AAC3F,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC"}
+{"version":3,"file":"sketch.d.ts","sourceRoot":"","sources":["../src/sketch.ts"],"names":[],"mappings":"AAuBA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAa,MAAM,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAW,IAAI,EAAiC,MAAM,WAAW,CAAC;AAKzE,uGAAuG;AACvG,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;AAEtE,gIAAgI;AAChI,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,GAAG,UAAU,CAAC;AAE7D,0IAA0I;AAC1I,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;AAE/E,mHAAmH;AACnH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpF,+GAA+G;AAC/G,MAAM,WAAW,KAAK;IACpB,sCAAsC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,4CAA4C;IAC5C,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAKD,+HAA+H;AAC/H,wBAAgB,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;AAC1F,wDAAwD;AACxD,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC;AAC7C,iGAAiG;AACjG,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC"}

package/dist/sketch.js

@@ -1,28 +1,37 @@
-// sketch(): your look as arclamp's update().
+// sketch(): your looks as arclamp's update().
 //
-// A look is a function of here (your own, or a field), or one color for
-// every light (a palette is laid across the room, left to right). Each tick
-// sketch() asks it what every light should make now, and turns that into
-// channels: lemtone channels for color lights, and on or off for old bulbs
-// (on at `switchOn` lumens or more, off below `switchOff`, and left as they
-// were between, so a pattern hovering near the line doesn't chatter).
+// Color lights and old bulbs are controlled apart, each by a look of its own,
+// named for the kind of light it's for (light.kind):
 //
-// Anything a look gives that says a color will do: a Color, "#f80",
-// "2700K", { r, g, b }, … Null, undefined or false leaves the light as it is
-// below. Something that isn't a color, or a color that isn't all numbers,
-// leaves it as it is too, with a warning (once for each kind of mistake), so
-// one slip doesn't stop the sketch.
+//   sketch({ color: osc(3).color(palettes.dusk), switch: osc(1, 0.25).thresh() })
+//
+// The color look is asked about the color bulbs and panels only: a function
+// of here (your own, or a field) giving a color, one color for every light,
+// or a palette laid across the room. Anything that says a color will do (a
+// Color, "#f80", "2700K", { r, g, b }, …). sketch(look) is
+// sketch({ color: look }).
+//
+// The switch look is asked about the old bulbs only, which just switch: true or
+// false, a number (on at 0.5 or more, as arclamp's own `on` channel), "on" or
+// "off", or a function of here (a field too) giving one. Without one, the old
+// bulbs are left as they are; a color never switches them.
+//
+// Null or undefined from either leaves the light as it is below (so does
+// false from a color look). Something that can't be read leaves it as it is
+// too, with a warning (once for each kind of mistake), so one slip doesn't
+// stop the sketch.
 import { Color, color, isPalette } from "./color.js";
 import { colorOf, Here, roomOf, sameLayout } from "./here.js";
 // A tick after a long gap (the sketch paused, or held up) counts as at most this long.
 const MAX_DT = 0.25;
-export function sketch(look, options = {}) {
-    const ask = lookOf(look);
-    const switchOn = options.switchOn ?? 100;
-    const switchOff = Math.min(options.switchOff ?? 70, switchOn);
+export function sketch(given, options = {}) {
+    if (options && typeof options === "object" && "on" in options)
+        throw new Error(ON_KEY);
+    const looks = isLooks(given) ? { switch: options.switch, ...given } : { color: given, switch: options.switch };
+    const askColor = looks.color === undefined ? null : lookOf(looks.color);
+    const askSwitch = looks.switch === undefined ? null : switchLookOf(looks.switch);
     let room = null;
     let last = null;
-    const on = new Map();
     const warned = new Set();
     const warn = (kind, text) => {
         if (warned.has(kind))
@@ -41,7 +50,20 @@ export function sketch(look, options = {}) {
         for (let i = 0; i < list.length; i++) {
             const light = room.lights[i];
             light.below = colorOf(list[i], light.kind);
+            light.belowOn = light.below.lm > 0;
+            const ask = light.kind === "switch" ? askSwitch : askColor;
+            if (!ask)
+                continue;
             const v = ask(new Here(light.x, light.y, t, dt, nowMs, light, room));
+            if (light.kind === "switch") {
+                const on = readOn(v);
+                if (on === "unreadable") {
+                    warn("on", `light ${light.id} is an old bulb, which only switches: its look gives true or false, a number (on at 0.5 or more), or "on" or "off", not ${describe(v)}; give old bulbs a look of their own, sketch({ color, switch })`);
+                }
+                else if (on !== null)
+                    lights.push({ id: light.id, channels: { on: on ? 1 : 0 } });
+                continue;
+            }
             if (v === null || v === undefined || v === false)
                 continue;
             let c;
@@ -57,17 +79,6 @@ export function sketch(look, options = {}) {
                 }
                 continue;
             }
-            if (light.kind === "switch") {
-                if (!Number.isFinite(c.lm)) {
-                    warn("nan", `light ${light.id} was given a color that isn't all numbers, ${JSON.stringify(c)}, so it's left as it is`);
-                    continue;
-                }
-                const was = on.get(light.id) ?? c.lm >= switchOn;
-                const now = c.lm >= switchOn ? true : c.lm < switchOff ? false : was;
-                on.set(light.id, now);
-                lights.push({ id: light.id, channels: { on: now ? 1 : 0 } });
-                continue;
-            }
             const channels = c.channels;
             if (!Number.isFinite(channels.a) || !Number.isFinite(channels.b) || !Number.isFinite(channels.brightness) || !Number.isFinite(channels.fidelity)) {
                 warn("nan", `light ${light.id} was given a color that isn't all numbers, ${JSON.stringify(c)}, so it's left as it is`);
@@ -78,7 +89,18 @@ export function sketch(look, options = {}) {
         return { lights };
     };
 }
-/** The look as a function of here. One color is the same everywhere (and said wrong, an error now, not each tick). */
+const ON_KEY = 'old bulbs\' look is `switch`, for the kind of light it\'s for: sketch({ color, switch }), or sketch(look, { switch })';
+/** Whether a sketch was given a look for each kind of light ({ color, switch }) rather than one look. */
+function isLooks(v) {
+    if (!v || typeof v !== "object" || v instanceof Color || Array.isArray(v))
+        return false;
+    const keys = Object.keys(v);
+    // { on } would read as an old bulb's channels, a color: say what's meant instead.
+    if (keys.includes("on"))
+        throw new Error(ON_KEY);
+    return keys.length > 0 && keys.every((k) => k === "color" || k === "switch");
+}
+/** The color look as a function of here. One color is the same everywhere (and said wrong, an error now, not each tick). */
 function lookOf(look) {
     if (isPalette(look))
         return (here) => look(here.u);
@@ -87,3 +109,33 @@ function lookOf(look) {
     const c = color(look);
     return () => c;
 }
+/** The switch look as a function of here. One answer is the same everywhere (and said wrong, an error now). */
+function switchLookOf(look) {
+    if (typeof look === "function")
+        return look;
+    const on = readOn(look);
+    if (on === "unreadable")
+        throw new Error(`${describe(look)} isn't on or off: give true or false, a number (on at 0.5 or more), or "on" or "off"`);
+    return () => on;
+}
+/** On (true), off (false), leave it (null), or can't tell. */
+function readOn(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v === "boolean")
+        return v;
+    if (typeof v === "number")
+        return Number.isFinite(v) ? v >= 0.5 : "unreadable";
+    if (typeof v === "string") {
+        const s = v.trim().toLowerCase();
+        if (s === "on" || s === "true" || s === "yes")
+            return true;
+        if (s === "off" || s === "false" || s === "no")
+            return false;
+        return s !== "" && Number.isFinite(Number(s)) ? Number(s) >= 0.5 : "unreadable";
+    }
+    if (typeof v === "object" && !(v instanceof Color) && "on" in v)
+        return readOn(v.on);
+    return "unreadable";
+}
+const describe = (v) => (v instanceof Color ? `a color (${v})` : typeof v === "string" ? `"${v}"` : JSON.stringify(v) ?? String(v));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roobscoob/vibes",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Color, light and time for sketches on the lights at the Recurse Center",
   "keywords": ["lighting", "lemtone", "oklab", "arclamp", "recurse-center"],
   "license": "MIT",

package/src/color.ts

@@ -28,6 +28,7 @@ import {
   xyzToOklab,
   type Vec3,
 } from "./lemtone.ts";
+import type { Here } from "./here.ts";
 import { parseColor, type Spec } from "./parse.ts";
 import { clamp, lerp } from "./shape.ts";
 import {
@@ -484,6 +485,8 @@ function fromObject(o: Record<string, unknown>): Color {
 /** Colors along a line from 0 to 1: palette(x) is the color at x. */
 export interface Palette {
   (x: number): Color;
+  /** Given a here instead, the palette laid across the room, left to right: its color at here.u. */
+  (here: Here): Color;
   readonly stops: readonly Color[];
   /** Where each stop is, 0 to 1. */
   readonly positions: readonly number[];
@@ -512,8 +515,9 @@ export function palette(...given: Stop[] | [readonly Stop[]]): Palette {
     .sort((x, y) => x.at - y.at);
   const stops = Object.freeze(placed.map((p) => Object.freeze(p.c)));
   const positions = Object.freeze(placed.map((p) => p.at));
-  const at = (x: number): Color => {
-    const v = Number.isFinite(x) ? x : 0;
+  const at = (x: number | Here): Color => {
+    const along = typeof x === "number" ? x : (x as Partial<Here> | null)?.u;
+    const v = typeof along === "number" && Number.isFinite(along) ? along : 0;
     if (v <= positions[0]!) return stops[0]!;
     for (let i = 1; i < stops.length; i++) {
       if (v <= positions[i]!) {
@@ -523,7 +527,7 @@ export function palette(...given: Stop[] | [readonly Stop[]]): Palette {
     }
     return stops[stops.length - 1]!;
   };
-  return Object.assign(at, { stops, positions });
+  return Object.assign(at, { stops, positions }) as 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). */

package/src/here.ts

@@ -55,6 +55,8 @@ export class Light {
   readonly random: number;
   /** What the layers below this sketch are making it do. */
   below: Color = off;
+  /** Whether the layers below have it on (for an old bulb), or lit at all (for a color light). */
+  belowOn = false;
   /** Its own memory, kept from one tick to the next. */
   state: Record<string, any> = {};
 

package/src/index.ts

@@ -49,4 +49,4 @@ export {
 } from "./field.ts";
 export { clock, type Clock, type Every } from "./signal.ts";
 export { chance, clamp, decay, ease, fract, hash, lerp, noiseAt, remap, saw, smoothstep, square, tri, wave } from "./shape.ts";
-export { sketch, type Look, type LookResult, type SketchOptions } from "./sketch.ts";
+export { sketch, type Look, type LookResult, type Looks, type SketchOptions, type SwitchLook, type SwitchResult } from "./sketch.ts";

package/src/sketch.ts

@@ -1,55 +1,74 @@
-// sketch(): your look as arclamp's update().
+// sketch(): your looks as arclamp's update().
 //
-// A look is a function of here (your own, or a field), or one color for
-// every light (a palette is laid across the room, left to right). Each tick
-// sketch() asks it what every light should make now, and turns that into
-// channels: lemtone channels for color lights, and on or off for old bulbs
-// (on at `switchOn` lumens or more, off below `switchOff`, and left as they
-// were between, so a pattern hovering near the line doesn't chatter).
+// Color lights and old bulbs are controlled apart, each by a look of its own,
+// named for the kind of light it's for (light.kind):
 //
-// Anything a look gives that says a color will do: a Color, "#f80",
-// "2700K", { r, g, b }, … Null, undefined or false leaves the light as it is
-// below. Something that isn't a color, or a color that isn't all numbers,
-// leaves it as it is too, with a warning (once for each kind of mistake), so
-// one slip doesn't stop the sketch.
+//   sketch({ color: osc(3).color(palettes.dusk), switch: osc(1, 0.25).thresh() })
+//
+// The color look is asked about the color bulbs and panels only: a function
+// of here (your own, or a field) giving a color, one color for every light,
+// or a palette laid across the room. Anything that says a color will do (a
+// Color, "#f80", "2700K", { r, g, b }, …). sketch(look) is
+// sketch({ color: look }).
+//
+// The switch look is asked about the old bulbs only, which just switch: true or
+// false, a number (on at 0.5 or more, as arclamp's own `on` channel), "on" or
+// "off", or a function of here (a field too) giving one. Without one, the old
+// bulbs are left as they are; a color never switches them.
+//
+// Null or undefined from either leaves the light as it is below (so does
+// false from a color look). Something that can't be read leaves it as it is
+// too, with a warning (once for each kind of mistake), so one slip doesn't
+// stop the sketch.
 
-import { Color, color, isPalette, type ColorInput, type Palette } from "./color.ts";
+import { Color, color, isPalette, type ColorInput } from "./color.ts";
 import type { Out, Prev, Update } from "./arclamp.ts";
 import { colorOf, Here, roomOf, sameLayout, type Room } from "./here.ts";
 
 // Plain V8 (arclamp's sandbox) has only what arclamp's prelude gives it.
 declare const console: { warn(...data: unknown[]): void };
 
-/** What a light should make, here and now; null, undefined or false leaves it as it is below. */
+/** What a color light should make, here and now; null, undefined or false leaves it as it is below. */
 export type LookResult = ColorInput | null | undefined | false | void;
 
-/**
- * What a light should make, here and now: a function of here giving a color,
- * one color for every light, or a palette, laid across the room.
- */
-export type Look = ((here: Here) => LookResult) | ColorInput | Palette;
+/** The color lights' look: a function of here giving a color, one color for every light, or a palette, laid across the room. */
+export type Look = ((here: Here) => LookResult) | ColorInput;
+
+/** Whether an old bulb should be on: true or false, a number (on at 0.5 or more), "on" or "off"; null or undefined leaves it as it is. */
+export type SwitchResult = boolean | number | string | null | undefined | void;
+
+/** The old bulbs' look: a function of here (a field too) saying whether each is on, or one answer for them all. */
+export type SwitchLook = ((here: Here) => SwitchResult) | boolean | number | string;
+
+/** A look for each kind of light (light.kind); either may be left out, and its lights are left as they are. */
+export interface Looks {
+  /** For the color bulbs and panels. */
+  color?: Look;
+  /** For the old bulbs, which only switch. */
+  switch?: SwitchLook;
+}
 
 export interface SketchOptions {
-  /** Old bulbs switch on when asked for this many lumens or more (default 100: about halfway, to the eye, to one that's on). */
-  switchOn?: number;
-  /** And off when asked for fewer than this (default 70). */
-  switchOff?: number;
+  /** The old bulbs' look, beside a color look given on its own. */
+  switch?: SwitchLook;
 }
 
 // A tick after a long gap (the sketch paused, or held up) counts as at most this long.
 const MAX_DT = 0.25;
 
-/** Your look (a function of here, or a field) as arclamp's update(). */
+/** Your color look (a function of here, or a field) as arclamp's update(); old bulbs are left alone, unless given `switch`. */
 export function sketch(look: (here: Here) => LookResult, options?: SketchOptions): Update;
-/** One color for every light, or a palette laid across the room, as arclamp's update(). */
-export function sketch(look: ColorInput | Palette, options?: SketchOptions): Update;
-export function sketch(look: Look, options: SketchOptions = {}): Update {
-  const ask = lookOf(look);
-  const switchOn = options.switchOn ?? 100;
-  const switchOff = Math.min(options.switchOff ?? 70, switchOn);
+/** A look for each kind of light: { color, switch }. */
+export function sketch(looks: Looks): Update;
+/** One color for every color light, or a palette laid across the room, as arclamp's update(). */
+export function sketch(look: ColorInput, options?: SketchOptions): Update;
+export function sketch(given: Looks | Look, options: SketchOptions = {}): Update {
+  if (options && typeof options === "object" && "on" in options) throw new Error(ON_KEY);
+  const looks: Looks = isLooks(given) ? { switch: options.switch, ...given } : { color: given as Look, switch: options.switch };
+  const askColor = looks.color === undefined ? null : lookOf(looks.color);
+  const askSwitch = looks.switch === undefined ? null : switchLookOf(looks.switch);
   let room: Room | null = null;
   let last: number | null = null;
-  const on = new Map<number, boolean>();
   const warned = new Set<string>();
 
   const warn = (kind: string, text: string) => {
@@ -69,9 +88,23 @@ export function sketch(look: Look, options: SketchOptions = {}): Update {
     for (let i = 0; i < list.length; i++) {
       const light = room.lights[i]!;
       light.below = colorOf(list[i]!, light.kind);
+      light.belowOn = light.below.lm > 0;
+      const ask = light.kind === "switch" ? askSwitch : askColor;
+      if (!ask) continue;
       const v = ask(new Here(light.x, light.y, t, dt, nowMs, light, room));
-      if (v === null || v === undefined || v === false) continue;
 
+      if (light.kind === "switch") {
+        const on = readOn(v);
+        if (on === "unreadable") {
+          warn(
+            "on",
+            `light ${light.id} is an old bulb, which only switches: its look gives true or false, a number (on at 0.5 or more), or "on" or "off", not ${describe(v)}; give old bulbs a look of their own, sketch({ color, switch })`,
+          );
+        } else if (on !== null) lights.push({ id: light.id, channels: { on: on ? 1 : 0 } });
+        continue;
+      }
+
+      if (v === null || v === undefined || v === false) continue;
       let c: Color;
       try {
         c = v instanceof Color ? v : color(v as ColorInput);
@@ -83,19 +116,6 @@ export function sketch(look: Look, options: SketchOptions = {}): Update {
         }
         continue;
       }
-
-      if (light.kind === "switch") {
-        if (!Number.isFinite(c.lm)) {
-          warn("nan", `light ${light.id} was given a color that isn't all numbers, ${JSON.stringify(c)}, so it's left as it is`);
-          continue;
-        }
-        const was = on.get(light.id) ?? c.lm >= switchOn;
-        const now = c.lm >= switchOn ? true : c.lm < switchOff ? false : was;
-        on.set(light.id, now);
-        lights.push({ id: light.id, channels: { on: now ? 1 : 0 } });
-        continue;
-      }
-
       const channels = c.channels;
       if (!Number.isFinite(channels.a) || !Number.isFinite(channels.b) || !Number.isFinite(channels.brightness) || !Number.isFinite(channels.fidelity)) {
         warn("nan", `light ${light.id} was given a color that isn't all numbers, ${JSON.stringify(c)}, so it's left as it is`);
@@ -107,10 +127,46 @@ export function sketch(look: Look, options: SketchOptions = {}): Update {
   };
 }
 
-/** The look as a function of here. One color is the same everywhere (and said wrong, an error now, not each tick). */
+const ON_KEY = 'old bulbs\' look is `switch`, for the kind of light it\'s for: sketch({ color, switch }), or sketch(look, { switch })';
+
+/** Whether a sketch was given a look for each kind of light ({ color, switch }) rather than one look. */
+function isLooks(v: unknown): v is Looks {
+  if (!v || typeof v !== "object" || v instanceof Color || Array.isArray(v)) return false;
+  const keys = Object.keys(v);
+  // { on } would read as an old bulb's channels, a color: say what's meant instead.
+  if (keys.includes("on")) throw new Error(ON_KEY);
+  return keys.length > 0 && keys.every((k) => k === "color" || k === "switch");
+}
+
+/** The color look as a function of here. One color is the same everywhere (and said wrong, an error now, not each tick). */
 function lookOf(look: Look): (here: Here) => unknown {
   if (isPalette(look)) return (here) => look(here.u);
   if (typeof look === "function") return look as (here: Here) => unknown;
   const c = color(look);
   return () => c;
 }
+
+/** The switch look as a function of here. One answer is the same everywhere (and said wrong, an error now). */
+function switchLookOf(look: SwitchLook): (here: Here) => unknown {
+  if (typeof look === "function") return look as (here: Here) => unknown;
+  const on = readOn(look);
+  if (on === "unreadable") throw new Error(`${describe(look)} isn't on or off: give true or false, a number (on at 0.5 or more), or "on" or "off"`);
+  return () => on;
+}
+
+/** On (true), off (false), leave it (null), or can't tell. */
+function readOn(v: unknown): boolean | null | "unreadable" {
+  if (v === null || v === undefined) return null;
+  if (typeof v === "boolean") return v;
+  if (typeof v === "number") return Number.isFinite(v) ? v >= 0.5 : "unreadable";
+  if (typeof v === "string") {
+    const s = v.trim().toLowerCase();
+    if (s === "on" || s === "true" || s === "yes") return true;
+    if (s === "off" || s === "false" || s === "no") return false;
+    return s !== "" && Number.isFinite(Number(s)) ? Number(s) >= 0.5 : "unreadable";
+  }
+  if (typeof v === "object" && !(v instanceof Color) && "on" in v) return readOn((v as { on: unknown }).on);
+  return "unreadable";
+}
+
+const describe = (v: unknown) => (v instanceof Color ? `a color (${v})` : typeof v === "string" ? `"${v}"` : JSON.stringify(v) ?? String(v));