npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@cypress-design/react-textbox

v1.1.0

Published

The textbox component is contained in the `@cypress-design/react-textbox` package. You'll also want to install `@cypress-design/constants-textbox` to get proper types for TypeScript.

Readme

Textbox

Install

The textbox component is contained in the @cypress-design/react-textbox package. You'll also want to install @cypress-design/constants-textbox to get proper types for TypeScript.

npm install @cypress-design/react-textbox @cypress-design/constants-textbox

or with yarn

yarn add @cypress-design/react-textbox @cypress-design/constants-textbox

Usage

import Textbox from '@cypress-design/react-textbox'
import { IconShapeLightningBolt } from '@cypress-design/react-icon'
import Textbox from '@cypress-design/react-textbox'

export default () => (
  <Textbox iconLeft={IconShapeLightningBolt} placeholder="Search..." />
)

Possible variants

The Textbox component supports four variants: default, valid, invalid, and warning. Each variant has different visual styling to indicate the input state.

Placeholders

All variants with placeholder text:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-white p-4">
    <div className="flex flex-col gap-4">
      <Textbox variant="default" placeholder="Default placeholder" />
      <Textbox variant="valid" placeholder="Valid placeholder" />
      <Textbox variant="invalid" placeholder="Invalid placeholder" />
      <Textbox variant="warning" placeholder="Warning placeholder" />
    </div>
  </div>
)

Types

All variants with values:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-white p-4">
    <div className="flex flex-col gap-4">
      <Textbox variant="default" defaultValue="Default" />
      <Textbox variant="valid" defaultValue="Valid" />
      <Textbox variant="invalid" defaultValue="Invalid" />
      <Textbox variant="warning" defaultValue="Warning" />
      <Textbox disabled defaultValue="Disabled" />
    </div>
  </div>
)

Dark mode

All variants in dark mode with placeholders:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-gray-1000 p-4">
    <div className="flex flex-col gap-4">
      <Textbox theme="dark" variant="default" placeholder="Default" />
      <Textbox theme="dark" variant="valid" placeholder="Valid" />
      <Textbox theme="dark" variant="invalid" placeholder="Invalid" />
      <Textbox theme="dark" variant="warning" placeholder="Warning" />
    </div>
  </div>
)

All variants in dark mode with values:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-gray-1000 p-4">
    <div className="flex flex-col gap-4">
      <Textbox theme="dark" variant="default" defaultValue="Default" />
      <Textbox theme="dark" variant="valid" defaultValue="Valid" />
      <Textbox theme="dark" variant="invalid" defaultValue="Invalid" />
      <Textbox theme="dark" variant="warning" defaultValue="Warning" />
      <Textbox theme="dark" disabled defaultValue="Disabled" />
    </div>
  </div>
)

Sizes

The Textbox supports three sizes: 32, 40 (default), and 48.

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-white p-4">
    <div className="flex flex-col gap-4">
      <Textbox size="32" defaultValue="Size 32" />
      <Textbox size="40" defaultValue="Size 40" />
      <Textbox size="48" defaultValue="Size 48" />
    </div>
  </div>
)

Dark mode:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-gray-1000 p-4">
    <div className="flex flex-col gap-4">
      <Textbox theme="dark" size="32" defaultValue="Size 32" />
      <Textbox theme="dark" size="40" defaultValue="Size 40" />
      <Textbox theme="dark" size="48" defaultValue="Size 48" />
    </div>
  </div>
)

Rounded

The Textbox supports a rounded prop to toggle between rounded and square corners. Shown here with size 40px:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-white p-4">
    <div className="flex flex-col gap-4">
      <Textbox size="40" rounded={false} defaultValue="Not rounded" />
      <Textbox size="40" rounded={true} defaultValue="Rounded" />
    </div>
  </div>
)

Dark mode:

import Textbox from '@cypress-design/react-textbox'
export default () => (
  <div className="rounded bg-gray-1000 p-4">
    <div className="flex flex-col gap-4">
      <Textbox
        theme="dark"
        size="40"
        rounded={false}
        defaultValue="Not rounded"
      />
      <Textbox theme="dark" size="40" rounded={true} defaultValue="Rounded" />
    </div>
  </div>
)

Options

The Textbox supports various combinations of optional elements. All sizes with labels on the left and right:

import Textbox from '@cypress-design/react-textbox'
import { IconShapeLightningBolt } from '@cypress-design/react-icon'
export default () => (
  <div className="rounded bg-white p-4">
    <div className="flex flex-col gap-4">
      <Textbox
        divider
        size="32"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 32"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        size="40"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 40"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        variant="valid"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        variant="invalid"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        variant="warning"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        disabled
        divider
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="disabled"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        rounded
        divider
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        placeholder="Placeholder"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
    </div>
  </div>
)

Dark mode:

import Textbox from '@cypress-design/react-textbox'
import { IconShapeLightningBolt } from '@cypress-design/react-icon'
export default () => (
  <div className="rounded bg-gray-1000 p-4">
    <div className="flex flex-col gap-4">
      <Textbox
        divider
        theme="dark"
        size="32"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 32"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        theme="dark"
        size="40"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 40"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        theme="dark"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        theme="dark"
        variant="valid"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        theme="dark"
        variant="invalid"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        theme="dark"
        variant="warning"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        disabled
        divider
        theme="dark"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="disabled"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        rounded
        theme="dark"
        divider
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        defaultValue="Size 48"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
      <Textbox
        divider
        theme="dark"
        size="48"
        labelLeft="Label left"
        labelRight="Label right"
        placeholder="Placeholder"
        iconLeft={IconShapeLightningBolt}
        iconRight={IconShapeLightningBolt}
      />
    </div>
  </div>
)

Props

onClick

onChange

onInput

onFocus

onBlur

className

iconLeft

iconRight

type

name

id

autoFocus

rounded

size

Size (height) of the textbox in pixels

disabled

Whether the input is disabled

placeholder

Placeholder text

value

Current value of the input

defaultValue

Default value (uncontrolled)

theme

Theme mode: 'light' or 'dark' forces a specific mode

variant

Visual variant/type of the textbox

labelLeft

Label text or element on the left side

divider

Whether to show a divider between iconLeft and input

labelRight

Label text or element on the right side

Ref Forwarding

The Textbox component supports ref forwarding, allowing you to access the underlying input element directly:

import { useRef } from 'react'
import Textbox from '@cypress-design/react-textbox'

function MyComponent() {
  const inputRef = useRef<HTMLInputElement>(null)

  const handleFocus = () => {
    inputRef.current?.focus()
  }

  return (
    <>
      <Textbox ref={inputRef} placeholder="Type here..." />
      <button onClick={handleFocus}>Focus Input</button>
    </>
  )
}

This is useful for:

  • Programmatically focusing the input
  • Accessing input methods like select(), setSelectionRange()
  • Integrating with third-party libraries that need direct DOM access
  • Measuring input dimensions

Keyboard Event Handlers

The Textbox component supports keyboard event handlers for advanced interactions:

import Textbox from '@cypress-design/react-textbox'

function MyComponent() {
  const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
    if (e.key === 'Enter') {
      console.log('Enter pressed')
    }
  }

  const handleKeyUp = (e: React.KeyboardEvent<HTMLInputElement>) => {
    console.log('Key released:', e.key)
  }

  return (
    <Textbox
      placeholder="Press Enter..."
      onKeyDown={handleKeyDown}
      onKeyUp={handleKeyUp}
    />
  )
}

Available Keyboard Handlers

  • onKeyDown: Fired when a key is pressed down
  • onKeyUp: Fired when a key is released

Common Input Attributes

The Textbox component supports all standard HTML input attributes through the ...rest props spread. This includes:

Form Attributes

  • readonly: Makes the input read-only
  • required: Marks the input as required for form validation
  • name: Input name for form submission
  • form: Associates input with a form element

Validation Attributes

  • maxLength: Maximum number of characters
  • minLength: Minimum number of characters
  • pattern: Regular expression pattern for validation
  • title: Tooltip text shown on validation error

Other Attributes

  • readOnly: Alias for readonly
  • tabIndex: Tab order
  • autoComplete: Autocomplete behavior
  • spellCheck: Enable/disable spell checking

Example:

<Textbox
  placeholder="Username"
  name="username"
  required
  maxLength={20}
  minLength={3}
  pattern="[a-zA-Z0-9]+"
  title="Username must be 3-20 alphanumeric characters"
/>

Real-World Use Cases

Form Input with Validation

function LoginForm() {
  const [email, setEmail] = useState('')
  const [error, setError] = useState('')

  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    setEmail(e.target.value)
    setError('')
  }

  const handleBlur = () => {
    if (!email.includes('@')) {
      setError('Invalid email address')
    }
  }

  return (
    <div>
      <Textbox
        type="email"
        placeholder="Email"
        value={email}
        onChange={handleChange}
        onBlur={handleBlur}
        variant={error ? 'invalid' : 'default'}
        aria-describedby={error ? 'email-error' : undefined}
      />
      {error && <div id="email-error">{error}</div>}
    </div>
  )
}

Search Input with Keyboard Shortcuts

import { useRef, useEffect } from 'react'
import Textbox from '@cypress-design/react-textbox'
import { IconShapeLightningBolt } from '@cypress-design/react-icon'

function SearchBox() {
  const inputRef = useRef<HTMLInputElement>(null)

  useEffect(() => {
    const handleKeyPress = (e: KeyboardEvent) => {
      if (e.key === '/' && e.target !== inputRef.current) {
        e.preventDefault()
        inputRef.current?.focus()
      }
    }

    window.addEventListener('keydown', handleKeyPress)
    return () => window.removeEventListener('keydown', handleKeyPress)
  }, [])

  return (
    <Textbox
      ref={inputRef}
      iconLeft={IconShapeLightningBolt}
      placeholder="Search (press / to focus)"
      onKeyDown={(e) => {
        if (e.key === 'Escape') {
          e.currentTarget.blur()
        }
      }}
    />
  )
}

Controlled Input with Debouncing

function DebouncedSearch() {
  const [value, setValue] = useState('')
  const [debouncedValue, setDebouncedValue] = useState('')

  useEffect(() => {
    const timer = setTimeout(() => {
      setDebouncedValue(value)
    }, 300)

    return () => clearTimeout(timer)
  }, [value])

  return (
    <>
      <Textbox
        value={value}
        onChange={(e) => setValue(e.target.value)}
        placeholder="Search..."
      />
      <p>Searching for: {debouncedValue}</p>
    </>
  )
}