Taffy

'use client';
// Generated by isomer. Do not edit by hand; run `isomer add` again to update. (from packages/react/src/Taffy.tsx)
// generated by packages/react/scripts/gen-components.mjs, do not edit
import type { CSSProperties } from 'react';
import { useIsomerCanvas, usePrefersReducedMotion, type Mount } from './useIsomerCanvas';
import { useLive, usePointer, useScroll, type LiveSpec } from './live';
// @ts-ignore: the runtime is plain JS with no type declarations
import * as runtime from './taffy.js';

const { DEFAULTS, mount } = runtime as { DEFAULTS: TaffyKnobs; mount: Mount };

export interface TaffyKnobs {
  liquid: string;
  rim: string;
  gloss: number;
  glow: number;
  shadow: number;
  thickness: number;
  dropSize: number;
  thin: number;
  weight: number;
  damping: number;
  snap: number;
  drift: number;
  grain: number;
  trigger: number;
  pull: number;
  snapAt: number;
}

export interface TaffyProps extends Partial<TaffyKnobs> {
  className?: string;
  style?: CSSProperties;
  /** Render this one frame (seconds) and run no clock. Used by the parity tests. */
  time?: number;
  paused?: boolean;
  /** Draw t = 2 once when the user prefers reduced motion. Default true. */
  respectReducedMotion?: boolean;
  /** Keep each frame readable after it is shown, for canvas.toDataURL or readPixels. Read at mount. Default false. */
  preserveDrawingBuffer?: boolean;
  /**
   * Live inputs, when there is no `time` and the user does not prefer reduced motion: pull adds how far the
   * scroll is pulled past its top (see `scroll`), each through one follow spring, with the props as the rest.
   * Default true.
   */
  live?: boolean;
  /**
   * The scroll offset in CSS pixels, y down: 0 at rest, negative while the top is pulled past rest. Leave it out and the
   * component reads the nearest scrolling ancestor, else the page; browsers report a negative offset only while
   * WebKit rubber-bands, so pass your own number from a custom scroll container to get an overscroll elsewhere.
   */
  scroll?: number;
}

/** Where each live input comes from: the spec's `live` block. */
const LIVE: LiveSpec<TaffyKnobs> = {
  inputs: [{ name: 'pull', source: 'scroll.overscroll' }],
  follow: { stiffness: 1200.0, dampingRatio: 1.0 },
};

export const taffyDefaults: Readonly<TaffyKnobs> = DEFAULTS;

export function Taffy({ className, style, time, paused, respectReducedMotion, preserveDrawingBuffer, live, scroll, ...props }: TaffyProps) {
  const knobs = { ...DEFAULTS };
  for (const k of Object.keys(DEFAULTS) as (keyof TaffyKnobs)[]) {
    const v = props[k];
    if (v !== undefined) (knobs as Record<string, unknown>)[k] = v;
  }
  // A fixed time is test mode, and reduced motion draws the poster: either way the live inputs stay off (no
  // sensors, no pointer, no events) and the knobs render as given.
  const reduced = usePrefersReducedMotion() && respectReducedMotion !== false;
  const inputs = useLive(LIVE, mount, knobs, time === undefined && live !== false && !reduced);
  const ref = useIsomerCanvas({ mount: inputs.mount, knobs, time, paused, respectReducedMotion, preserveDrawingBuffer, posterTime: 2.0 });
  usePointer(ref, inputs);
  useScroll(ref, inputs, scroll);
  return <canvas ref={ref} className={className} style={{ display: 'block', width: '100%', height: '100%', ...style }} />;
}