@markmiro/hairy 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1298 @@
+/** Curves for the poof's rise and fall, from 0 to 1. Some overshoot, then come back. */
+declare const eases: {
+    linear: (t: number) => number;
+    /** Speeds up steadily, like something dropping. */
+    gravity: (t: number) => number;
+    "ease-in": (t: number) => number;
+    "ease-out": (t: number) => number;
+    "ease-in-out": (t: number) => number;
+    "back-out": (t: number) => number;
+    "elastic-out": (t: number) => number;
+};
+type Ease = keyof typeof eases;
+/** The choices for each setting that picks from a list, in the order the playground shows them. */
+declare const settingChoices: {
+    /** Straight hairs follow one smooth curve; wavy ones ripple side to side; curly ones coil into loops; frizzy ones kink at random and fly away. */
+    readonly hairType: readonly ["straight", "wavy", "curly", "frizzy"];
+    /** Round tips end in a half circle; sharp ones narrow to a fine point; square ones are cut straight across. */
+    readonly tipShape: readonly ["round", "sharp", "square"];
+    /** Natural fur, or glitter, with sparkling flakes. */
+    readonly material: readonly ["natural", "glitter"];
+    /** A coat pattern, as on an animal: none, zebra stripes, tiger stripes, dalmatian spots, leopard rosettes or giraffe patches. */
+    readonly pattern: readonly ["none", "zebra", "tiger", "dalmatian", "leopard", "giraffe"];
+    /** The pattern's colors: the animal's own, or tints of the fur's color. */
+    readonly patternColors: readonly ["natural", "tinted"];
+    /** When the label gets a halo: "auto" only when a pattern needs one, or "always" or "never". */
+    readonly halo: readonly ["auto", "always", "never"];
+};
+type HairType = (typeof settingChoices.hairType)[number];
+type TipShape = (typeof settingChoices.tipShape)[number];
+type Material = (typeof settingChoices.material)[number];
+type Pattern = (typeof settingChoices.pattern)[number];
+type PatternColors = (typeof settingChoices.patternColors)[number];
+type Halo = (typeof settingChoices.halo)[number];
+type ChoiceSetting = keyof typeof settingChoices;
+/**
+ * Every setting the fur has, at its defaults (the Plush preset). Each fur
+ * keeps its own copy. The ones marked "regrows" change the hairs themselves,
+ * so changing them grows the hairs again.
+ */
+declare const defaultSettings: {
+    /** Palette: where its middle sits (L*, 0–1, from the color), how far it reaches below and above that. */
+    shift: number;
+    darker: number;
+    lighter: number;
+    /** Hairs per area (regrows). */
+    density: number;
+    /** Hair length. Changing it grows or shrinks the hairs with the hover spring. */
+    length: number;
+    thickness: number;
+    /** How much hairs curl (regrows). */
+    curl: number;
+    /** How much hairs droop under their weight. */
+    droop: number;
+    /** How much hair lengths vary, 0 all the same (regrows). */
+    lengthVariation: number;
+    /** How much hair directions vary from the combed flow (regrows). */
+    messiness: number;
+    /** How far hairs along the outline lean out, making the fuzzy edge (regrows). */
+    fuzz: number;
+    /**
+     * How far from the button's edge the fur starts, in px at scale 1 (regrows):
+     * above 0 the outline hairs and the fur's body sit out past the edge, below
+     * 0 they move in, eating into the button.
+     */
+    distance: number;
+    /** Tip width relative to the root. */
+    taper: number;
+    /**
+     * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+     * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+     * hair gets wider to hold the fade, so it costs a little more to draw.
+     */
+    softness: number;
+    /** The hairs' pattern: straight, wavy, curly or frizzy. */
+    hairType: HairType;
+    /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+    typeAmount: number;
+    /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+    tightness: number;
+    /** How each hair ends: round, sharp or square. */
+    tipShape: TipShape;
+    /** What the hair looks made of: natural or glitter. */
+    material: Material;
+    /** How bright glitter's flashes are. */
+    materialAmount: number;
+    /** Glitter: how many flakes there are, 1 the usual amount. */
+    glitterDensity: number;
+    /** Glitter: how big the flakes are, 1 the usual size. */
+    glitterSize: number;
+    /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+    glitterSizeVariation: number;
+    /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+    pattern: Pattern;
+    /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+    patternColors: PatternColors;
+    /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+    patternScale: number;
+    /**
+     * A soft glow behind the label, in the fur's base color, so it reads where
+     * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+     * adds it only when a pattern needs one, or "always" or "never".
+     */
+    halo: Halo;
+    /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+    haloShade: number;
+    /** How far the halo's glow spreads round the letters, 1 the usual size. */
+    haloSize: number;
+    /** How strong the halo is, 1 the usual; 0 has none. */
+    haloStrength: number;
+    /** How many hairs catch the light (regrows). */
+    sheen: number;
+    /** Where the band of shine sits, 0 at the top to 1 at the bottom, and how far it spreads (regrows). */
+    sheenPosition: number;
+    sheenSpread: number;
+    /** How dark the hairs along the top edge are, turned away from the light; also keeps the shine off it (regrows). */
+    edgeShadow: number;
+    /** On wide-gamut screens, how far colors move out toward the more vivid colors sRGB can't show (0 to 1). */
+    vividness: number;
+    /** How far the hairs stand at rest, with no hover: 0 is combed flat, 1 standing up. */
+    static: number;
+    /** How much further the hairs stand when hovered, on top of `static` (up to 1). */
+    hover: number;
+    /**
+     * The hover spring: how fast it moves (rad/s) and its damping ratio (lower
+     * bounces more, 1 doesn't overshoot). Hovering out and clicking move on
+     * springs like it.
+     */
+    hoverSpeed: number;
+    hoverDamping: number;
+    /** The hover-out spring (without a click playing), back down to rest: speed (rad/s) and damping ratio. */
+    leaveSpeed: number;
+    leaveDamping: number;
+    /** How much the hairs sway while hovered. */
+    sway: number;
+    /**
+     * How much longer the hairs grow as they rise to the hover lift: 0.5 makes
+     * them half as long again (regrows, to make room).
+     */
+    hoverStretch: number;
+    /** How much lighter the fur gets as it rises to the hover lift, in L* (0–1); below 0 darkens. */
+    hoverLight: number;
+    /**
+     * A click poofs the fur up by `poofHeight` on the rise spring, hangs there
+     * for `poofHold` seconds, then comes back down to where it rests (hovered,
+     * or flat if the pointer has left) on the fall spring, which also springs
+     * the click's stretch back. Speeds in rad/s, then damping ratios (lower
+     * bounces more, 1 doesn't overshoot).
+     */
+    clickRiseSpeed: number;
+    clickRiseDamping: number;
+    clickFallSpeed: number;
+    clickFallDamping: number;
+    poofHeight: number;
+    /** How much longer still the hairs grow at the top of a click, on top of `hoverStretch` (regrows). */
+    clickStretch: number;
+    /** How much lighter still a click makes the fur, on top of `hoverLight`, springing back with the click. */
+    clickLight: number;
+    /** Seconds the fur hangs at the top of the poof. */
+    poofHold: number;
+    /** How strongly the pointer brushes the hairs. */
+    brush: number;
+    /** How brushed hairs spring back: speed (rad/s) and damping ratio (lower bounces more). */
+    brushSpeed: number;
+    brushDamping: number;
+};
+type Widen<T> = {
+    -readonly [K in keyof T]: T[K] extends number ? number : T[K];
+};
+type FurSettings = Widen<typeof defaultSettings>;
+/** Whether `value` can be `key`'s: a finite number for a number setting, or one of its choices. */
+declare function isSettingValue(key: keyof FurSettings, value: unknown): boolean;
+/** Settings that change the hairs themselves, so the fur is grown again when they change. */
+declare const regrowSettings: ReadonlySet<keyof FurSettings>;
+/** Named starting points for the settings, most related first. The first, Plush, is the default. */
+declare const presetSettings: {
+    /** Dense, short, neat fur with a springy click. */
+    Plush: {
+        /** Palette: where its middle sits (L*, 0–1, from the color), how far it reaches below and above that. */
+        shift: number;
+        darker: number;
+        lighter: number;
+        /** Hairs per area (regrows). */
+        density: number;
+        /** Hair length. Changing it grows or shrinks the hairs with the hover spring. */
+        length: number;
+        thickness: number;
+        /** How much hairs curl (regrows). */
+        curl: number;
+        /** How much hairs droop under their weight. */
+        droop: number;
+        /** How much hair lengths vary, 0 all the same (regrows). */
+        lengthVariation: number;
+        /** How much hair directions vary from the combed flow (regrows). */
+        messiness: number;
+        /** How far hairs along the outline lean out, making the fuzzy edge (regrows). */
+        fuzz: number;
+        /**
+         * How far from the button's edge the fur starts, in px at scale 1 (regrows):
+         * above 0 the outline hairs and the fur's body sit out past the edge, below
+         * 0 they move in, eating into the button.
+         */
+        distance: number;
+        /** Tip width relative to the root. */
+        taper: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+        typeAmount: number;
+        /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+        tightness: number;
+        /** How each hair ends: round, sharp or square. */
+        tipShape: TipShape;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+        /** How many hairs catch the light (regrows). */
+        sheen: number;
+        /** Where the band of shine sits, 0 at the top to 1 at the bottom, and how far it spreads (regrows). */
+        sheenPosition: number;
+        sheenSpread: number;
+        /** How dark the hairs along the top edge are, turned away from the light; also keeps the shine off it (regrows). */
+        edgeShadow: number;
+        /** On wide-gamut screens, how far colors move out toward the more vivid colors sRGB can't show (0 to 1). */
+        vividness: number;
+        /** How far the hairs stand at rest, with no hover: 0 is combed flat, 1 standing up. */
+        static: number;
+        /** How much further the hairs stand when hovered, on top of `static` (up to 1). */
+        hover: number;
+        /**
+         * The hover spring: how fast it moves (rad/s) and its damping ratio (lower
+         * bounces more, 1 doesn't overshoot). Hovering out and clicking move on
+         * springs like it.
+         */
+        hoverSpeed: number;
+        hoverDamping: number;
+        /** The hover-out spring (without a click playing), back down to rest: speed (rad/s) and damping ratio. */
+        leaveSpeed: number;
+        leaveDamping: number;
+        /** How much the hairs sway while hovered. */
+        sway: number;
+        /**
+         * How much longer the hairs grow as they rise to the hover lift: 0.5 makes
+         * them half as long again (regrows, to make room).
+         */
+        hoverStretch: number;
+        /** How much lighter the fur gets as it rises to the hover lift, in L* (0–1); below 0 darkens. */
+        hoverLight: number;
+        /**
+         * A click poofs the fur up by `poofHeight` on the rise spring, hangs there
+         * for `poofHold` seconds, then comes back down to where it rests (hovered,
+         * or flat if the pointer has left) on the fall spring, which also springs
+         * the click's stretch back. Speeds in rad/s, then damping ratios (lower
+         * bounces more, 1 doesn't overshoot).
+         */
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHeight: number;
+        /** How much longer still the hairs grow at the top of a click, on top of `hoverStretch` (regrows). */
+        clickStretch: number;
+        /** How much lighter still a click makes the fur, on top of `hoverLight`, springing back with the click. */
+        clickLight: number;
+        /** Seconds the fur hangs at the top of the poof. */
+        poofHold: number;
+        /** How strongly the pointer brushes the hairs. */
+        brush: number;
+        /** How brushed hairs spring back: speed (rad/s) and damping ratio (lower bounces more). */
+        brushSpeed: number;
+        brushDamping: number;
+    };
+    /** Sparse, thick, glossy strands, with a smooth hover that brightens, a slight bounce as it leaves and a soft, bouncy click that darkens. */
+    Teddy: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+        typeAmount: number;
+        /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+        tightness: number;
+        /** How each hair ends: round, sharp or square. */
+        tipShape: TipShape;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+    /** Curly, messy fur that stands up on its own, with a springy, rippling hover and click. */
+    Fluffy: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+        typeAmount: number;
+        /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+        tightness: number;
+        /** How each hair ends: round, sharp or square. */
+        tipShape: TipShape;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+    /** Long, thick, curly, heavily drooping fur set deep into the button, with sharp tips, a little shine and a quick, bouncy hover that stretches it. */
+    Fuzzy: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        hairType: string;
+        typeAmount: number;
+        tightness: number;
+        tipShape: string;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+    /** Thin, long, curly, droopy hair with lots of shine and a softer click. */
+    Shaggy: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        taper: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How far from the button's edge the fur starts, in px at scale 1 (regrows):
+         * above 0 the outline hairs and the fur's body sit out past the edge, below
+         * 0 they move in, eating into the button.
+         */
+        distance: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+        typeAmount: number;
+        /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+        tightness: number;
+        /** How each hair ends: round, sharp or square. */
+        tipShape: TipShape;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+        /** On wide-gamut screens, how far colors move out toward the more vivid colors sRGB can't show (0 to 1). */
+        vividness: number;
+        /** How much lighter still a click makes the fur, on top of `hoverLight`, springing back with the click. */
+        clickLight: number;
+    };
+    /** Long, sparse, messy, gently wavy strands with a bright band of shine along the top, a bouncy hover, and barely react to a click. */
+    Mane: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        taper: number;
+        hairType: string;
+        typeAmount: number;
+        tightness: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How far from the button's edge the fur starts, in px at scale 1 (regrows):
+         * above 0 the outline hairs and the fur's body sit out past the edge, below
+         * 0 they move in, eating into the button.
+         */
+        distance: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** How each hair ends: round, sharp or square. */
+        tipShape: TipShape;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+        /** How much lighter still a click makes the fur, on top of `hoverLight`, springing back with the click. */
+        clickLight: number;
+    };
+    /** Sparse, thick, very messy glittering curls with square ends set into the button, like tinsel, with slow, gentle motion that darkens on hover and click. */
+    Tinsel: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        typeAmount: number;
+        tightness: number;
+        tipShape: string;
+        material: string;
+        materialAmount: number;
+        glitterDensity: number;
+        glitterSize: number;
+        glitterSizeVariation: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+    /** A few thick, tightly curled, pointed strands that spring up on hover and stretch out on a click. */
+    Coil: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+        typeAmount: number;
+        /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+        tightness: number;
+        /** How each hair ends: round, sharp or square. */
+        tipShape: TipShape;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+    /** Long, thin, glossy, loosely wavy hairs with sharp ends that droop heavily from just inside the button, with a quick, bouncy hover and click and a light brush. */
+    Mustache: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        hairType: string;
+        typeAmount: number;
+        tightness: number;
+        tipShape: string;
+        materialAmount: number;
+        glitterSize: number;
+        glitterSizeVariation: number;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+    /** Sparse, thick, drooping bristles with square ends that stand up on their own, a quick hover, a high, snappy click and a strong brush. */
+    Bristle: {
+        shift: number;
+        darker: number;
+        lighter: number;
+        density: number;
+        length: number;
+        thickness: number;
+        curl: number;
+        droop: number;
+        lengthVariation: number;
+        messiness: number;
+        fuzz: number;
+        distance: number;
+        taper: number;
+        typeAmount: number;
+        tightness: number;
+        tipShape: string;
+        sheen: number;
+        sheenPosition: number;
+        sheenSpread: number;
+        edgeShadow: number;
+        vividness: number;
+        static: number;
+        hover: number;
+        hoverSpeed: number;
+        hoverDamping: number;
+        leaveSpeed: number;
+        leaveDamping: number;
+        sway: number;
+        hoverStretch: number;
+        hoverLight: number;
+        poofHeight: number;
+        clickStretch: number;
+        clickLight: number;
+        clickRiseSpeed: number;
+        clickRiseDamping: number;
+        clickFallSpeed: number;
+        clickFallDamping: number;
+        poofHold: number;
+        brush: number;
+        brushSpeed: number;
+        brushDamping: number;
+        /**
+         * How soft each hair's edge is, in px at scale 1: 0 is the crisp
+         * pixel-wide edge, higher fades it out over that many more pixels, up to 2. Each
+         * hair gets wider to hold the fade, so it costs a little more to draw.
+         */
+        softness: number;
+        /** The hairs' pattern: straight, wavy, curly or frizzy. */
+        hairType: HairType;
+        /** What the hair looks made of: natural or glitter. */
+        material: Material;
+        /** How bright glitter's flashes are. */
+        materialAmount: number;
+        /** Glitter: how many flakes there are, 1 the usual amount. */
+        glitterDensity: number;
+        /** Glitter: how big the flakes are, 1 the usual size. */
+        glitterSize: number;
+        /** Glitter: how much flake sizes differ, 0 all the same; at 1 they range from half to twice the size. */
+        glitterSizeVariation: number;
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        pattern: Pattern;
+        /** The pattern's colors: "natural" takes the animal's own, "tinted" makes them from the fur's color. */
+        patternColors: PatternColors;
+        /** How big the pattern's stripes, spots or patches are, 1 the usual size. */
+        patternScale: number;
+        /**
+         * A soft glow behind the label, in the fur's base color, so it reads where
+         * the fur alone doesn't, as on a zebra's white and black at once: "auto"
+         * adds it only when a pattern needs one, or "always" or "never".
+         */
+        halo: Halo;
+        /** How far the halo's shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        haloShade: number;
+        /** How far the halo's glow spreads round the letters, 1 the usual size. */
+        haloSize: number;
+        /** How strong the halo is, 1 the usual; 0 has none. */
+        haloStrength: number;
+    };
+};
+type PresetName = Lowercase<keyof typeof presetSettings>;
+/** Named starting points for the settings, by id. The first, Plush, is the default. */
+declare const presets: Record<PresetName, Readonly<FurSettings>>;
+/** Each preset's display name, by id, in order. */
+declare const presetNames: Record<PresetName, string>;
+
+/** Whether this screen can show wide-gamut (Display P3) color. */
+declare const supportsWideGamut: () => boolean;
+/** The label's lowest APCA contrast (unsigned Lc) over the shades most hairs take. */
+declare function labelContrast(label: string, color: string, S: FurSettings): number;
+/**
+ * A label color that reads on `color`'s fur, by APCA, and its contrast: the
+ * lowest Lc over the shades most hairs take, at rest and fully hovered. It
+ * prefers a light or dark tint of the fur's own hue, when that reaches the
+ * target Lc, and otherwise takes whichever of the tints, white or black reads
+ * best. The target is Lc 60 for large or bold text and Lc 75 otherwise.
+ */
+declare function autoLabel(color: string, S: FurSettings, text?: {
+    size: number;
+    weight: number;
+}): {
+    label: string;
+    lc: number;
+};
+type FurMotion = "hover" | "leave" | "click";
+interface FurLabel {
+    color: string;
+    /** Unsigned Lc: its lowest over the coat, or against the halo backing it. */
+    contrast: number;
+    /** Whether a halo backs it: always, never, or on auto, when a pattern needs one. */
+    halo: boolean;
+}
+
+/**
+ * The public option names, by group, and the setting each one sets. The groups
+ * follow the playground: how the fur is shaded, its shine, the hairs, and how
+ * it moves at rest, on hover, on hover out, on click and when brushed.
+ */
+declare const optionGroups: {
+    readonly shade: {
+        /** Moves the fur's middle shade lighter or darker than the color, in L* (0–1). */
+        readonly lightness: "shift";
+        /** How much darker the darkest hairs are than the middle shade. */
+        readonly shadows: "darker";
+        /** How much lighter the lightest hairs are than the middle shade. */
+        readonly highlights: "lighter";
+        /** On wide-gamut (P3) screens, how far colors move out toward the more vivid ones sRGB can't show (0 to 1). */
+        readonly vividness: "vividness";
+    };
+    readonly shine: {
+        /** How many glossy hairs catch the light. 0 is matte. */
+        readonly amount: "sheen";
+        /** Where the band of shine sits: 0 at the top, 1 at the bottom. */
+        readonly position: "sheenPosition";
+        /** How wide the band of shine is. */
+        readonly spread: "sheenSpread";
+        /** Darkens the hairs along the top edge, where the surface turns away from the light. */
+        readonly edgeShadow: "edgeShadow";
+    };
+    readonly hair: {
+        readonly density: "density";
+        readonly length: "length";
+        readonly thickness: "thickness";
+        /** Tip width compared to the root. */
+        readonly taper: "taper";
+        /** How soft each hair's edge is, in px: 0 is crisp, higher fades it over more pixels, up to 2. */
+        readonly softness: "softness";
+        readonly curl: "curl";
+        readonly droop: "droop";
+        /** How much hair lengths differ. 0 makes them all the same. */
+        readonly lengthVariation: "lengthVariation";
+        /** How far hairs stray from the combed direction. */
+        readonly messiness: "messiness";
+        /** How far hairs along the outline lean out, softening the edge. */
+        readonly fuzz: "fuzz";
+        /** Where the fur starts from the element's edge, in px. Below 0 it eats into the element. */
+        readonly distance: "distance";
+        /** The hairs' pattern: "straight", "wavy", "curly" or "frizzy". */
+        readonly type: "hairType";
+        /** How strong the waves, curls or frizz are: 0 is straight, 1 the usual amount. */
+        readonly typeAmount: "typeAmount";
+        /** How many waves, turns or kinks fit along each hair: higher is tighter. */
+        readonly tightness: "tightness";
+        /** How each hair ends: "round", "sharp" or "square". */
+        readonly end: "tipShape";
+    };
+    readonly material: {
+        /** What the hair looks made of: "natural" or "glitter". */
+        readonly type: "material";
+        /** How bright glitter's flashes are. */
+        readonly amount: "materialAmount";
+    };
+    readonly pattern: {
+        /** A coat pattern, as on an animal: "none", "zebra", "tiger", "dalmatian", "leopard" or "giraffe". */
+        readonly type: "pattern";
+        /** "natural" takes the animal's own colors; "tinted" makes them from the fur's color. */
+        readonly colors: "patternColors";
+        /** How big the stripes, spots or patches are: 1 the usual size. */
+        readonly scale: "patternScale";
+    };
+    readonly halo: {
+        /** When the label gets a halo: "auto" only when a pattern needs one, or "always" or "never". */
+        readonly when: "halo";
+        /** How far its shade moves from the base color, away from the label's: darker under a light label, lighter under a dark one (L, 0–1). */
+        readonly shade: "haloShade";
+        /** How far the glow spreads round the letters: 1 the usual size. */
+        readonly size: "haloSize";
+        /** How strong it is: 1 the usual, 0 none. */
+        readonly strength: "haloStrength";
+    };
+    readonly glitter: {
+        /** How many flakes there are: 1 the usual amount, 0 none. */
+        readonly density: "glitterDensity";
+        /** How big the flakes are: 1 the usual size. */
+        readonly size: "glitterSize";
+        /** How much flake sizes differ: 0 all the same; at 1 they range from half to twice the size. */
+        readonly sizeVariation: "glitterSizeVariation";
+    };
+    readonly rest: {
+        /** How far the hairs stand up on their own: 0 lies combed flat, 1 stands straight up. */
+        readonly static: "static";
+    };
+    readonly hover: {
+        /** How much further the hairs stand up on hover, on top of the rest's static. */
+        readonly static: "hover";
+        /** How much longer the hairs grow as they rise. 1 doubles them. */
+        readonly stretch: "hoverStretch";
+        /** How much lighter the fur gets as it rises, in L*. Below 0 darkens. */
+        readonly lightness: "hoverLight";
+        /** How far each hair rocks from side to side while hovered. */
+        readonly sway: "sway";
+        /** How quickly the fur rises (rad/s). */
+        readonly speed: "hoverSpeed";
+        /** How much the rise bounces: lower overshoots, 1 doesn't. */
+        readonly damping: "hoverDamping";
+    };
+    readonly leave: {
+        /** How quickly the fur springs back to rest when the pointer leaves (rad/s). */
+        readonly speed: "leaveSpeed";
+        /** How much it bounces past rest: lower overshoots, 1 doesn't. */
+        readonly damping: "leaveDamping";
+    };
+    readonly click: {
+        /** How much further a click makes the fur stand up, on top of hovering. */
+        readonly static: "poofHeight";
+        /** How much longer still the hairs grow at the top of a click. */
+        readonly stretch: "clickStretch";
+        /** How much lighter still a click makes the fur, in L*. */
+        readonly lightness: "clickLight";
+        /** How quickly the fur poofs up (rad/s). */
+        readonly riseSpeed: "clickRiseSpeed";
+        /** How far the poof overshoots its peak: lower overshoots more, 1 doesn't. */
+        readonly riseDamping: "clickRiseDamping";
+        /** Seconds the fur hangs at the top. */
+        readonly hold: "poofHold";
+        /** How quickly the fur comes back down, and the stretch springs back (rad/s). */
+        readonly fallSpeed: "clickFallSpeed";
+        /** How much it bounces on the way down: lower bounces more, 1 doesn't. */
+        readonly fallDamping: "clickFallDamping";
+    };
+    readonly brush: {
+        /** How strongly moving the pointer across the fur pushes the hairs. 0 turns brushing off. */
+        readonly amount: "brush";
+        /** How quickly brushed hairs spring back. */
+        readonly speed: "brushSpeed";
+        /** How much brushed hairs wobble on the way back. */
+        readonly damping: "brushDamping";
+    };
+};
+type OptionGroup = keyof typeof optionGroups;
+type GroupOptions<G extends OptionGroup> = {
+    [K in keyof (typeof optionGroups)[G]]?: (typeof optionGroups)[G][K] extends keyof FurSettings ? FurSettings[(typeof optionGroups)[G][K]] extends number ? number : FurSettings[(typeof optionGroups)[G][K]] : never;
+};
+/** The fur's look and motion, by group. Each value overrides the preset's. */
+type FurOptions = {
+    [G in OptionGroup]?: GroupOptions<G>;
+};
+/** A hair size: a number (1 is the default size, in CSS px), or "<n>em" to follow the element's font size. */
+type HairScale = number | `${number}em`;
+interface HairyOptions extends FurOptions {
+    /** The starting settings. Defaults to "plush". */
+    preset?: PresetName;
+    /** The fur's color, any CSS color. Defaults to the element's background color. */
+    color?: string;
+    /**
+     * The label's color. "auto" picks a readable one for the fur by APCA
+     * contrast; a CSS color sets it; leave it out to keep the element's own.
+     */
+    label?: "auto" | (string & {});
+    /**
+     * Hair size: at 2 the hairs are twice as long and thick, and fewer, so each
+     * shows. In em ("1em", "1.5em"), it follows the element's font size, with
+     * 16px as 1em, so the fur shrinks and grows with a responsive element.
+     * Defaults to the element's `--hairy-scale` CSS variable (a number or an
+     * em value), or 1.
+     */
+    scale?: HairScale;
+    /**
+     * Moves the fur down, in CSS px; below 0 moves it up. Hair combs down, so
+     * it hangs further below the element than it reaches above it, and the
+     * label can look high: a few px up (-4 or so) centers the fur on it.
+     * Defaults to 0.
+     */
+    translate?: number;
+    /** Draw in Display P3 on screens that support it. Defaults to true. */
+    wideGamut?: boolean;
+    /** Canvas pixels per CSS pixel. Defaults to the screen's, up to 2; set it higher to bake large images. */
+    pixelRatio?: number;
+}
+/** The full settings for `options`: the preset's, with each grouped option on top. */
+declare function resolveSettings(options: FurOptions & {
+    preset?: PresetName;
+}): FurSettings;
+/**
+ * The grouped options that turn `preset` into `settings`: only the values
+ * that differ, so they stay short. The inverse of `resolveSettings`.
+ */
+declare function diffOptions(settings: FurSettings, preset?: PresetName): FurOptions;
+
+/** Whether this browser can draw fur: WebGL2 on a real GPU. */
+declare const gpuSupported: () => boolean;
+
+/**
+ * APCA lightness contrast (Lc) of `text` on `background`, using the APCA-W3
+ * 0.0.98G-4g constants. Positive for dark text on a lighter background,
+ * negative for light text on a darker one. Black on white is about 106.
+ */
+declare function apca(text: string, background: string): number;
+
+interface Hairy {
+    /**
+     * Changes the options. Top-level options replace the old ones; each group
+     * (`hair`, `hover`…) is merged into the old group, value by value.
+     */
+    update(options: HairyOptions): void;
+    /** Replaces all the options, so anything left out goes back to its default. */
+    set(options: HairyOptions): void;
+    /** Plays a motion as if the pointer did it: "hover" in, "leave" (hover out), or a "click". */
+    play(motion: FurMotion): void;
+    /** The label color in use, its APCA contrast on the fur (unsigned Lc) and whether a halo backs it, when `label` is set. */
+    readonly label: FurLabel | null;
+    /** How far, in CSS px, the longest hairs can reach past the element's box, hovered, clicked or drooping. */
+    readonly reach: number;
+    /** Removes the fur, and puts back the element's own styles. */
+    destroy(): void;
+}
+/**
+ * Adds fur to an element you already have, usually a button. The fur is drawn
+ * on a canvas behind the element's content, in `color` (or the element's own
+ * background), and reacts to hover, click, keyboard focus and brushing.
+ *
+ * ```js
+ * import { hairy } from "@markmiro/hairy";
+ * const fur = hairy(document.querySelector("#adopt"), { preset: "plush", color: "#ff4d70", label: "auto" });
+ * ```
+ */
+declare function hairy(element: HTMLElement, options?: HairyOptions): Hairy;
+
+export { apca, autoLabel, defaultSettings, diffOptions, eases, hairy, isSettingValue, labelContrast, optionGroups, presetNames, presets, regrowSettings, resolveSettings, settingChoices, gpuSupported as supportsFur, supportsWideGamut };
+export type { ChoiceSetting, Ease, FurLabel, FurMotion, FurOptions, FurSettings, HairScale, HairType, Hairy, HairyOptions, Halo, Material, OptionGroup, Pattern, PatternColors, PresetName, TipShape };