@adea-ai/ui 0.84.0 → 0.87.0

package/src/components/ui/combobox/combobox.tsx

@@ -3,6 +3,7 @@ import { Check, ChevronDown, X } from 'lucide-solid'
 import type { ComponentProps } from 'solid-js'
 import { Show, splitProps } from 'solid-js'
 import { menuContentPadding, menuItem, popoverArrow } from '#lib/overlay'
+import { useFormFieldControl } from '#lib/form-field'
 import { cn } from '#lib/utils'
 
 /**
@@ -43,10 +44,32 @@ export function ComboboxControl(props: ComponentProps<typeof KobalteCombobox.Con
 }
 
 export function ComboboxInput(props: ComponentProps<typeof KobalteCombobox.Input>) {
-  const [local, rest] = splitProps(props, ['class'])
+  const [local, rest] = splitProps(props, [
+    'class',
+    'id',
+    'aria-label',
+    'aria-labelledby',
+    'aria-describedby',
+    'aria-invalid',
+    'aria-errormessage',
+  ])
+  const field = useFormFieldControl('control', {
+    id: local.id,
+    'aria-label': local['aria-label'],
+    'aria-labelledby': local['aria-labelledby'],
+    'aria-describedby': local['aria-describedby'],
+    'aria-invalid': local['aria-invalid'],
+    'aria-errormessage': local['aria-errormessage'],
+  })
 
   return (
     <KobalteCombobox.Input
+      id={field?.id ?? local.id}
+      aria-label={local['aria-label']}
+      aria-labelledby={field?.['aria-labelledby'] ?? local['aria-labelledby']}
+      aria-describedby={field?.['aria-describedby'] ?? local['aria-describedby']}
+      aria-invalid={field?.['aria-invalid'] ?? local['aria-invalid']}
+      aria-errormessage={field?.['aria-errormessage'] ?? local['aria-errormessage']}
       class={cn(
         'h-full flex-1 bg-transparent text-sm outline-none placeholder:text-muted-foreground',
         'disabled:cursor-not-allowed',

package/src/components/ui/combobox/index.ts

@@ -8,3 +8,4 @@ export {
   ComboboxSection,
   ComboboxTrigger,
 } from './combobox'
+export { ValueCombobox, type ValueComboboxProps } from './value-combobox'

package/src/components/ui/combobox/value-combobox.tsx

@@ -0,0 +1,38 @@
+import { splitProps, type ComponentProps, type JSX } from 'solid-js'
+import { Combobox, ComboboxContent, ComboboxInput, ComboboxItem } from './combobox'
+
+export type ValueComboboxChoice =
+  | { value: string; label: string | number; textValue?: string }
+  | { value: string; label: JSX.Element; textValue: string }
+
+export type ValueComboboxProps = Omit<ComponentProps<typeof ComboboxInput>, 'value'> & {
+  value: string
+  choices: ValueComboboxChoice[]
+  onValueChange: (value: string) => void
+}
+
+/** A single-choice combobox for a controlled string value and labelled choices. */
+export function ValueCombobox(props: ValueComboboxProps) {
+  const [local, rest] = splitProps(props, ['value', 'choices', 'onValueChange'])
+
+  return (
+    <Combobox
+      options={local.choices}
+      optionValue="value"
+      optionTextValue={(choice) => choice.textValue ?? textFromLabel(choice.label)}
+      optionLabel={(choice) => choice.textValue ?? textFromLabel(choice.label)}
+      value={local.choices.find((choice) => String(choice.value) === local.value) ?? null}
+      onChange={(option) => option && local.onValueChange(String(option.value))}
+      itemComponent={(itemProps) => (
+        <ComboboxItem item={itemProps.item}>{itemProps.item.rawValue.label}</ComboboxItem>
+      )}
+    >
+      <ComboboxInput {...rest} />
+      <ComboboxContent />
+    </Combobox>
+  )
+}
+
+function textFromLabel(label: JSX.Element) {
+  return typeof label === 'string' || typeof label === 'number' ? String(label) : ''
+}

package/src/components/ui/empty/empty-state.tsx

@@ -0,0 +1,71 @@
+import { Search } from 'lucide-solid'
+import type { ComponentProps, JSX } from 'solid-js'
+import { Show, splitProps } from 'solid-js'
+import { ActionButton } from '../../composites/action-button'
+import { Spinner } from '../spinner'
+import { Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle } from './empty'
+
+export type EmptyStateProps = Omit<ComponentProps<'div'>, 'children' | 'role' | 'aria-live'> & {
+  title: string
+  detail: string
+  busy?: boolean
+  icon?: JSX.Element
+  announceAs?: 'alert' | 'status'
+  headingLevel?: 1 | 2 | 3 | 4 | 5 | 6
+  action?: () => void
+  actionLabel?: string
+  actionTooltip?: string
+}
+
+/** A semantic empty, loading, or error state built from the shared empty parts. */
+export function EmptyState(props: EmptyStateProps) {
+  const [local, rest] = splitProps(props, [
+    'title',
+    'detail',
+    'busy',
+    'icon',
+    'announceAs',
+    'headingLevel',
+    'action',
+    'actionLabel',
+    'actionTooltip',
+    'class',
+  ])
+
+  return (
+    <Empty
+      {...rest}
+      class={local.class}
+      role={local.announceAs}
+      aria-live={local.announceAs === 'status' ? 'polite' : undefined}
+      aria-busy={local.busy || undefined}
+    >
+      <EmptyHeader>
+        <Show when={local.busy || local.icon}>
+          <EmptyMedia variant="icon">
+            {local.busy ? (
+              <Spinner label={false} aria-hidden="true" />
+            ) : (
+              (local.icon ?? <Search aria-hidden="true" />)
+            )}
+          </EmptyMedia>
+        </Show>
+        <EmptyTitle role="heading" aria-level={local.headingLevel ?? 1}>
+          {local.title}
+        </EmptyTitle>
+        <EmptyDescription>{local.detail}</EmptyDescription>
+      </EmptyHeader>
+      <Show when={local.action}>
+        <EmptyContent>
+          <ActionButton
+            tooltip={local.actionTooltip ?? local.actionLabel ?? 'Try again'}
+            aria-label={local.actionLabel ?? 'Try again'}
+            onClick={local.action}
+          >
+            {local.actionLabel ?? 'Try again'}
+          </ActionButton>
+        </EmptyContent>
+      </Show>
+    </Empty>
+  )
+}

package/src/components/ui/empty/index.ts

@@ -8,3 +8,4 @@ export {
   type EmptyMediaProps,
   type EmptyProps,
 } from './empty'
+export { EmptyState, type EmptyStateProps } from './empty-state'

package/src/components/ui/entity-icon/entity-icon.tsx

@@ -1,4 +1,11 @@
-import { Show, splitProps, type Component, type ComponentProps, type JSX } from 'solid-js'
+import {
+  createSignal,
+  Show,
+  splitProps,
+  type Component,
+  type ComponentProps,
+  type JSX,
+} from 'solid-js'
 import { Dynamic } from 'solid-js/web'
 import { cva, type VariantProps } from '#lib/variants'
 import { cn } from '#lib/utils'
@@ -16,7 +23,8 @@ import { cn } from '#lib/utils'
  *
  * 1. **A glyph is always present.** A brand with no logo gets a monogram, not an
  *    empty box. `fallback` takes the name and returns the glyph, so a caller can
- *    choose initials, a domain letter, or a kind icon.
+ *    choose initials, a domain letter, or a kind icon. When `src` is supplied,
+ *    its contained image overlays that glyph and failure reveals the glyph below.
  * 2. **The tile owns its own contrast.** `tone` tints the background while
  *    monogram text keeps the body foreground; vector glyphs retain the status
  *    colour. A caller never picks a colour pair or ships a glyph that disappears.
@@ -67,6 +75,8 @@ export type EntityIconProps = Omit<ComponentProps<'span'>, 'children'> &
   EntityIconVariantProps & {
     /** The entity's name. Used for the accessible label and, via `fallback`, the monogram. */
     name: string
+    /** Optional image URL. The image is decorative; `name` remains the accessible label. */
+    src?: string
     /**
      * A logo or icon — a Lucide icon reference (`icon={Wrench}`) or an element
      * (`icon={<Wrench />}`). Both are accepted because both are what a caller
@@ -108,9 +118,27 @@ function Glyph(props: { glyph: Glyph }) {
   )
 }
 
+function EntityIconImage(props: { src: string }) {
+  const [failed, setFailed] = createSignal(false)
+
+  return (
+    <Show when={!failed()}>
+      <img
+        data-slot="entity-icon-image"
+        src={props.src}
+        alt=""
+        aria-hidden="true"
+        class="pointer-events-none absolute inset-0 size-full object-contain"
+        onError={() => setFailed(true)}
+      />
+    </Show>
+  )
+}
+
 export function EntityIcon(props: EntityIconProps) {
   const [local, rest] = splitProps(props, [
     'name',
+    'src',
     'icon',
     'fallback',
     'badge',
@@ -146,6 +174,9 @@ export function EntityIcon(props: EntityIconProps) {
       >
         {(value) => <Glyph glyph={value()} />}
       </Show>
+      <Show when={local.src} keyed>
+        {(src) => <EntityIconImage src={src} />}
+      </Show>
       <Show when={local.badge}>
         <span class="absolute right-0 bottom-0 translate-x-1/4 translate-y-1/4">{local.badge}</span>
       </Show>

package/src/components/ui/field/field.tsx

@@ -1,6 +1,8 @@
 import { TextField as KobalteTextField } from '@kobalte/core/text-field'
-import type { ComponentProps } from 'solid-js'
-import { Show, splitProps } from 'solid-js'
+import type { ComponentProps, JSX } from 'solid-js'
+import { createUniqueId, Show, splitProps } from 'solid-js'
+import { Label } from '../label/label'
+import { createFormFieldContext, FormFieldContext } from '#lib/form-field'
 import { cn } from '#lib/utils'
 
 /**
@@ -9,21 +11,110 @@ import { cn } from '#lib/utils'
  * The wrapper that makes a form control describable and validatable: a label,
  * a description, an error message, and the ARIA relationships between them.
  *
+ * This Kobalte TextField composition is for its own `FieldLabel`, `FieldInput`
+ * and `FieldTextArea` parts. Use `FormField` to wire the standalone shared
+ * controls, including checkboxes, switches and comboboxes.
+ *
  * It is built on Kobalte's TextField specifically so `aria-describedby`,
  * `aria-invalid` and `aria-errormessage` are wired by construction. Those three
  * attributes are the difference between "this field is required and empty" and
  * a red border that only a sighted user can perceive — and they are also the
  * first thing a hand-rolled form drops.
  *
- * `Field` owns the description and the error slot, so a form's controls line up
- * and its messages land in the same place regardless of which control is used.
- * Compose it with any control: `Field` wraps, `Label`/`Input`/`Select` fill it.
+ * `Field` owns the description and the error slot, so its controls line up and
+ * its messages land in the same place regardless of which TextField part is used.
  */
 export function Field(props: ComponentProps<typeof KobalteTextField>) {
   const [local, rest] = splitProps(props, ['class'])
   return <KobalteTextField class={cn('flex flex-col gap-1.5', local.class)} {...rest} />
 }
 
+export type FormFieldProps = Omit<ComponentProps<'div'>, 'children' | 'ref'> & {
+  label: string
+  hint?: string
+  error?: string
+  controlId?: string
+  group?: boolean
+  children: JSX.Element
+}
+
+/**
+ * FormField.
+ *
+ * A shared label, help and validation wrapper for any one shared control. Its
+ * context is consumed by Input, Textarea, NativeSelect, Checkbox, Switch,
+ * RadioGroup and ComboboxInput, so the actual focusable element receives the
+ * generated ID and description relationships. Set `group` when the label names
+ * a set of controls; the wrapper then uses fieldset and legend semantics.
+ */
+export function FormField(props: FormFieldProps) {
+  const [local, rest] = splitProps(props, [
+    'class',
+    'label',
+    'hint',
+    'error',
+    'controlId',
+    'group',
+    'children',
+  ])
+  const fieldId = createUniqueId()
+  const labelId = `${fieldId}-label`
+  const descriptionId = `${fieldId}-description`
+  const errorId = `${fieldId}-error`
+  const field = createFormFieldContext({
+    controlId: local.controlId,
+    defaultControlId: fieldId,
+    labelId,
+    descriptionId,
+    errorId,
+    hint: () => local.hint,
+    error: () => local.error,
+    group: () => local.group ?? false,
+  })
+  const help = () => (
+    <>
+      <Show when={local.hint}>
+        <p id={descriptionId} class="text-muted-foreground text-sm">
+          {local.hint}
+        </p>
+      </Show>
+      <Show when={local.error}>
+        <p id={errorId} role="alert" class="text-foreground text-sm">
+          {local.error}
+        </p>
+      </Show>
+    </>
+  )
+
+  return (
+    <FormFieldContext.Provider value={field}>
+      <div class={cn('flex flex-col gap-1.5', local.class)} {...rest}>
+        {local.group ? (
+          <FieldSet
+            class="flex flex-col gap-1.5"
+            aria-describedby={field.describedBy()}
+            aria-invalid={field.invalid() || undefined}
+          >
+            <FieldLegend id={labelId} variant="label">
+              {local.label}
+            </FieldLegend>
+            {local.children}
+            {help()}
+          </FieldSet>
+        ) : (
+          <>
+            <Label id={labelId} for={field.controlId()}>
+              {local.label}
+            </Label>
+            {local.children}
+            {help()}
+          </>
+        )}
+      </div>
+    </FormFieldContext.Provider>
+  )
+}
+
 export function FieldLabel(props: ComponentProps<typeof KobalteTextField.Label>) {
   const [local, rest] = splitProps(props, ['class'])
   return (
@@ -96,6 +187,12 @@ export function FieldSet(props: ComponentProps<'fieldset'>) {
   return <fieldset class={cn('flex flex-col gap-4', local.class)} {...rest} />
 }
 
+/** A visual stack for related controls that does not imply fieldset semantics. */
+export function FieldGroup(props: ComponentProps<'div'>) {
+  const [local, rest] = splitProps(props, ['class'])
+  return <div data-slot="field-group" class={cn('flex flex-col gap-4', local.class)} {...rest} />
+}
+
 export function FieldLegend(props: ComponentProps<'legend'> & { variant?: 'legend' | 'label' }) {
   const [local, rest] = splitProps(props, ['class', 'variant'])
   return (

package/src/components/ui/field/index.ts

@@ -1,11 +1,16 @@
 export {
   Field,
+  FormField,
   FieldDescription,
   FieldError,
+  FieldGroup,
   FieldInput,
   FieldLabel,
   FieldLegend,
   FieldSeparator,
   FieldSet,
   FieldTextArea,
+  type FormFieldProps,
 } from './field'
+export { NumberField } from './number-field'
+export type { NumberFieldProps } from './number-field'

package/src/components/ui/field/number-field.tsx

@@ -0,0 +1,71 @@
+import { createEffect, createSignal, type JSX } from 'solid-js'
+import { FormField } from './field'
+import { Input } from '../input/input'
+
+export type NumberFieldProps = {
+  label: string
+  hint?: string
+  value: number
+  min: number
+  max: number
+  integer?: boolean
+  onChange: (value: number) => void
+  class?: string
+  onBlur?: JSX.EventHandler<HTMLInputElement, FocusEvent>
+}
+
+/**
+ * A controlled numeric field that keeps an editable draft while validating
+ * range and integer constraints. Invalid drafts are announced and restored
+ * to the latest controlled value when focus leaves the input.
+ */
+export function NumberField(props: NumberFieldProps) {
+  const [draft, setDraft] = createSignal(String(props.value))
+  const [error, setError] = createSignal('')
+  const integer = () => props.integer ?? true
+
+  createEffect(() => {
+    setDraft(String(props.value))
+  })
+
+  const validate = (raw: string) => {
+    if (!raw) return `${props.label} is required.`
+    const next = Number(raw)
+    if (!Number.isFinite(next)) return `${props.label} must be a valid number.`
+    if (integer() && !Number.isInteger(next)) {
+      return `${props.label} must be a whole number.`
+    }
+    if (next < props.min || next > props.max) {
+      return `${props.label} must be between ${props.min} and ${props.max}.`
+    }
+    return ''
+  }
+
+  return (
+    <FormField label={props.label} hint={props.hint} error={error()} class={props.class}>
+      <Input
+        type="number"
+        value={draft()}
+        min={props.min}
+        max={props.max}
+        step={integer() ? 1 : 'any'}
+        required
+        onInput={(event) => {
+          const raw = event.currentTarget.value
+          setDraft(raw)
+          const nextError = validate(raw)
+          setError(nextError)
+          if (!nextError) props.onChange(Number(raw))
+        }}
+        onBlur={(event) => {
+          const nextError = validate(draft())
+          if (nextError) {
+            setDraft(String(props.value))
+            setError('')
+          }
+          props.onBlur?.(event)
+        }}
+      />
+    </FormField>
+  )
+}

package/src/components/ui/input/index.ts

@@ -1 +1,2 @@
 export { Input, type InputProps } from './input'
+export { InputControl, type InputControlProps } from './input-control'

package/src/components/ui/input/input-control.tsx

@@ -0,0 +1,38 @@
+import type { ComponentProps } from 'solid-js'
+import { splitProps } from 'solid-js'
+import { cn } from '#lib/utils'
+
+/**
+ * InputControl.
+ *
+ * A styled native input with no optional suggestion-list behavior. Use this
+ * when a consumer needs only the control; `Input` adds native datalist
+ * suggestions for forms that need them.
+ */
+export type InputControlProps = ComponentProps<'input'>
+
+export function InputControl(props: InputControlProps) {
+  const [local, rest] = splitProps(props, ['class', 'type'])
+
+  return (
+    <input
+      data-slot="input"
+      type={local.type ?? 'text'}
+      class={cn(
+        'h-control-md w-full min-w-0 rounded-md border border-input bg-transparent px-control-md py-1 text-sm',
+        'transition-[color,box-shadow,border-color] ease-out outline-none',
+        'placeholder:text-muted-foreground',
+        'selection:bg-primary selection:text-primary-foreground',
+        'file:inline-flex file:h-6 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground',
+        /* A pointer click on a text field is a typing affordance, so the ring
+         appears where the user agent already matches :focus-visible. */
+        'focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-primary-subtle',
+        'aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive-subtle',
+        'disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50',
+        'read-only:bg-surface-hover',
+        local.class
+      )}
+      {...rest}
+    />
+  )
+}

package/src/components/ui/input/input.tsx

@@ -1,6 +1,7 @@
 import type { ComponentProps } from 'solid-js'
 import { createUniqueId, For, Show, splitProps } from 'solid-js'
-import { cn } from '#lib/utils'
+import { useFormFieldControl } from '#lib/form-field'
+import { InputControl } from './input-control'
 
 /**
  * Input.
@@ -20,31 +21,42 @@ export type InputProps = ComponentProps<'input'> & {
 }
 
 export function Input(props: InputProps) {
-  const [local, rest] = splitProps(props, ['class', 'type', 'list', 'suggestions'])
+  const [local, rest] = splitProps(props, [
+    'class',
+    'type',
+    'id',
+    'list',
+    'suggestions',
+    'aria-label',
+    'aria-labelledby',
+    'aria-describedby',
+    'aria-invalid',
+    'aria-errormessage',
+  ])
+  const field = useFormFieldControl('control', {
+    id: local.id,
+    'aria-label': local['aria-label'],
+    'aria-labelledby': local['aria-labelledby'],
+    'aria-describedby': local['aria-describedby'],
+    'aria-invalid': local['aria-invalid'],
+    'aria-errormessage': local['aria-errormessage'],
+  })
   const suggestionsId = createUniqueId()
   const listId = () => local.list ?? `input-suggestions-${suggestionsId}`
 
   return (
     <>
-      <input
-        data-slot="input"
-        type={local.type ?? 'text'}
-        list={local.suggestions ? listId() : local.list}
-        class={cn(
-          'h-control-md w-full min-w-0 rounded-md border border-input bg-transparent px-control-md py-1 text-sm',
-          'transition-[color,box-shadow,border-color] ease-out outline-none',
-          'placeholder:text-muted-foreground',
-          'selection:bg-primary selection:text-primary-foreground',
-          'file:inline-flex file:h-6 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground',
-          /* A pointer click on a text field is a typing affordance, so the ring
-           appears where the user agent already matches :focus-visible. */
-          'focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-primary-subtle',
-          'aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive-subtle',
-          'disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50',
-          'read-only:bg-surface-hover',
-          local.class
-        )}
+      <InputControl
         {...rest}
+        class={local.class}
+        type={local.type}
+        id={field?.id ?? local.id}
+        list={local.suggestions ? listId() : local.list}
+        aria-label={local['aria-label']}
+        aria-labelledby={field?.['aria-labelledby'] ?? local['aria-labelledby']}
+        aria-describedby={field?.['aria-describedby'] ?? local['aria-describedby']}
+        aria-invalid={field?.['aria-invalid'] ?? local['aria-invalid']}
+        aria-errormessage={field?.['aria-errormessage'] ?? local['aria-errormessage']}
       />
       <Show when={local.suggestions}>
         {(suggestions) => (

package/src/components/ui/input-group/index.ts

@@ -6,3 +6,4 @@ export {
   InputGroupText,
   type InputGroupAddonProps,
 } from './input-group'
+export { SecretInputGroup, type SecretInputGroupProps } from './secret-input-group'

package/src/components/ui/input-group/input-group.tsx

@@ -1,5 +1,6 @@
 import type { ComponentProps, JSX } from 'solid-js'
 import { splitProps } from 'solid-js'
+import { useFormFieldControl } from '#lib/form-field'
 import { cn } from '#lib/utils'
 
 /**
@@ -26,7 +27,7 @@ export function InputGroup(props: ComponentProps<'div'>) {
         'transition-[color,box-shadow,border-color] ease-out',
         'focus-within:border-ring focus-within:ring-3 focus-within:ring-primary-subtle',
         'has-[[aria-invalid=true]]:border-destructive has-[[aria-invalid=true]]:ring-3 has-[[aria-invalid=true]]:ring-destructive-subtle',
-        'has-[input:disabled]:pointer-events-none has-[input:disabled]:cursor-not-allowed has-[input:disabled]:opacity-50',
+        'has-[input:disabled]:cursor-not-allowed has-[input:disabled]:opacity-50',
         local.class
       )}
       {...rest}
@@ -35,11 +36,33 @@ export function InputGroup(props: ComponentProps<'div'>) {
 }
 
 export function InputGroupInput(props: ComponentProps<'input'>) {
-  const [local, rest] = splitProps(props, ['class'])
+  const [local, rest] = splitProps(props, [
+    'class',
+    'id',
+    'aria-label',
+    'aria-labelledby',
+    'aria-describedby',
+    'aria-invalid',
+    'aria-errormessage',
+  ])
+  const field = useFormFieldControl('control', {
+    id: local.id,
+    'aria-label': local['aria-label'],
+    'aria-labelledby': local['aria-labelledby'],
+    'aria-describedby': local['aria-describedby'],
+    'aria-invalid': local['aria-invalid'],
+    'aria-errormessage': local['aria-errormessage'],
+  })
 
   return (
     <input
       data-slot="input-group-input"
+      id={field?.id ?? local.id}
+      aria-label={local['aria-label']}
+      aria-labelledby={field?.['aria-labelledby'] ?? local['aria-labelledby']}
+      aria-describedby={field?.['aria-describedby'] ?? local['aria-describedby']}
+      aria-invalid={field?.['aria-invalid'] ?? local['aria-invalid']}
+      aria-errormessage={field?.['aria-errormessage'] ?? local['aria-errormessage']}
       class={cn(
         'h-full min-w-0 flex-1 bg-transparent text-sm outline-none',
         'placeholder:text-muted-foreground',