Stencil

'use client';
// Generated by isomer. Do not edit by hand; run `isomer add` again to update. (from packages/react/src/Stencil.tsx)
// generated by packages/react/scripts/gen-components.mjs, do not edit
import type { CSSProperties } from 'react';
import { useIsomerCanvas, type Mount, type ImageInput, type ImageSource } from './useIsomerCanvas';
// @ts-ignore: the runtime is plain JS with no type declarations
import * as runtime from './stencil.js';
// @ts-ignore: the baked atlas as a PNG data URL
import atlas from './stencil.image.js';

const { DEFAULTS, mount, loadImage } = runtime as { DEFAULTS: StencilKnobs; mount: Mount; loadImage: (url: string) => Promise<ImageSource> };

export interface StencilKnobs {
  accent: string;
  spray: number;
  overspray: number;
  drips: number;
  grain: number;
  wall: string;
  coverage: number;
  softness: number;
  letterScale: number;
  wear: number;
  light: number;
}

export interface StencilProps extends Partial<StencilKnobs> {
  className?: string;
  style?: CSSProperties;
  /** Render this one frame (seconds) and run no clock. Used by the parity tests. */
  time?: number;
  paused?: boolean;
  /** The clock stops at t = 4 and holds that frame. Draw t = 2.6 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;
  /** The image the shader reads. Default: the baked glyph atlas of "Sold out". */
  image?: ImageInput;
}

export const stencilDefaults: Readonly<StencilKnobs> = DEFAULTS;

export function Stencil({ className, style, time, paused, respectReducedMotion, preserveDrawingBuffer, image, ...props }: StencilProps) {
  const knobs = { ...DEFAULTS };
  for (const k of Object.keys(DEFAULTS) as (keyof StencilKnobs)[]) {
    const v = props[k];
    if (v !== undefined) (knobs as Record<string, unknown>)[k] = v;
  }
  const ref = useIsomerCanvas({ mount, knobs, time, paused, respectReducedMotion, preserveDrawingBuffer, posterTime: 2.6, settleAt: 4.0, image: image ?? atlas, loadImage });
  return <canvas ref={ref} className={className} style={{ display: 'block', width: '100%', height: '100%', ...style }} />;
}