Also available as vitreui— the same library under a shorter name.npm i vitreui
Skip to content

Input

A glass-wrapped text input exposing aria-invalid and aria-describedby for error and description wiring.

Group: Form Controls · Import path: @orionshub/lucent/input · Server-safe — renders on the server without a client bundle.

Import

tsx
import { Input } from '@orionshub/lucent'
import '@orionshub/lucent/styles.css' // once, at your app root

Examples

States

States
Show source
tsx
export function InputBasic() {
  return (
    <div style={stack}>
      <Input placeholder="Default" />
      <Input placeholder="Invalid" aria-invalid isInvalid />
      <Input placeholder="Disabled" disabled />
    </div>
  )
}

Props

PropTypeDefaultDescription
asChildboolean | undefinedRender the inner element as the single child element (for react-hook-form).
endIconReact.ReactNodeIcon after the input text. Rendered aria-hidden.
isInvalidboolean | undefinedMarks the input as invalid — applies danger border colour.
startIconReact.ReactNodeIcon before the input text. Rendered aria-hidden.
wrapperClassNamestring | undefinedExtra className for the outer wrapper div.

Guidance

One-time CSS import

Import the compiled stylesheet once at your app root: import '@orionshub/lucent/styles.css'. Components ship stable class names and read design tokens from CSS custom properties — there is no style runtime. See CSS Import.

Transparency & solid mode

Every glass surface reads --lucent-glass-opacity (0.60–1.0). Dial it at runtime with setGlassOpacity(), or switch to setContrast('solid') for a fully opaque, high-contrast rendering. See Transparency & Solid Mode.

RTL

Authored with CSS logical properties — set dir="rtl" on a parent (or the document) and layout mirrors with no JS. Toggle RTL from the glass-controls panel to preview. See RTL Support.

SSR / Next.js

Server-safe — renders on the server without a client bundle. All components are safe to import in a Server Component tree; interactive ones carry their own "use client" boundary. See SSR & Next.js.

Released under the MIT License.