@adea-ai/ui 0.85.0 → 0.87.0

package/src/components/ui/text-link/text-link.tsx

@@ -0,0 +1,28 @@
+import type { ComponentProps } from 'solid-js'
+import { splitProps } from 'solid-js'
+import { cn } from '#lib/utils'
+
+/**
+ * TextLink.
+ *
+ * An inline, underlined link for prose and content navigation. Use ActionButton
+ * or ListRow when the link is a compact action or a row-sized target.
+ */
+export function TextLink(props: ComponentProps<'a'>) {
+  const [local, rest] = splitProps(props, ['class', 'tabIndex'])
+
+  return (
+    <a
+      data-slot="textlink"
+      class={cn(
+        'rounded-sm text-foreground underline decoration-primary underline-offset-4',
+        'transition-colors ease-out hover:decoration-foreground outline-none',
+        'focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-primary-subtle',
+        'motion-reduce:transition-none',
+        local.class
+      )}
+      tabIndex={local.tabIndex ?? 0}
+      {...rest}
+    />
+  )
+}

package/src/components/ui/textarea/textarea.tsx

@@ -1,5 +1,6 @@
 import type { ComponentProps } from 'solid-js'
 import { splitProps } from 'solid-js'
+import { useFormFieldControl } from '#lib/form-field'
 import { cn } from '#lib/utils'
 
 /**
@@ -14,11 +15,33 @@ import { cn } from '#lib/utils'
  * remains the fallback so an unsupported engine still gets a usable height.
  */
 export function Textarea(props: ComponentProps<'textarea'>) {
-  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 (
     <textarea
       data-slot="textarea"
+      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(
         'flex field-sizing-content min-h-16 w-full rounded-md border border-input bg-transparent px-control-md py-2 text-sm',
         'transition-[color,box-shadow,border-color] ease-out outline-none',

package/src/index.ts

@@ -69,6 +69,7 @@ export * from './components/ui/switch'
 export * from './components/ui/table'
 export * from './components/ui/tabs'
 export * from './components/ui/textarea'
+export * from './components/ui/text-link'
 export * from './components/ui/toast'
 export * from './components/ui/toggle'
 export * from './components/ui/toggle-group'
@@ -79,6 +80,7 @@ export * from './components/motion'
 
 /* --- Layout -------------------------------------------------------------- */
 export * from './components/layout/split-layout'
+export * from './components/layout/floating-preview'
 export * from './components/layout/orbit-layout'
 export * from './components/layout/virtual-window'
 export * from './components/layout/app-shell'
@@ -138,6 +140,7 @@ export {
   type ThemeVariant,
 } from './lib/themes'
 export { keyedRows, type KeyedRow } from './lib/keyed-rows'
+export { writeClipboardText } from './lib/clipboard'
 export { formatBytes, formatReleaseDate, plainTextFromMarkdown } from './lib/version-notes'
 export {
   accentPresets,

package/src/lib/clipboard.ts

@@ -0,0 +1,41 @@
+const CLIPBOARD_UNAVAILABLE = 'Clipboard is unavailable in this WebView'
+
+/** Writes text with the async Clipboard API, falling back for older WebViews. */
+export async function writeClipboardText(value: string): Promise<void> {
+  if (typeof navigator !== 'undefined' && typeof navigator.clipboard?.writeText === 'function') {
+    await navigator.clipboard.writeText(value)
+    return
+  }
+
+  if (typeof document === 'undefined' || !document.body) {
+    throw new Error(CLIPBOARD_UNAVAILABLE)
+  }
+
+  const previousFocus = document.activeElement
+  const textarea = document.createElement('textarea')
+  textarea.value = value
+  textarea.setAttribute('readonly', '')
+  textarea.setAttribute('aria-hidden', 'true')
+  textarea.tabIndex = -1
+  textarea.style.position = 'fixed'
+  textarea.style.opacity = '0'
+  document.body.appendChild(textarea)
+
+  let copied = false
+  try {
+    textarea.focus({ preventScroll: true })
+    textarea.select()
+    copied = typeof document.execCommand === 'function' && document.execCommand('copy')
+  } finally {
+    textarea.remove()
+    if (previousFocus instanceof HTMLElement && previousFocus.isConnected) {
+      try {
+        previousFocus.focus({ preventScroll: true })
+      } catch {
+        // A host may revoke focus during the copy; preserve the clipboard outcome.
+      }
+    }
+  }
+
+  if (!copied) throw new Error(CLIPBOARD_UNAVAILABLE)
+}

package/src/lib/download.ts

@@ -0,0 +1,29 @@
+/** Download a Blob through a temporary, non-focusable anchor. */
+export function downloadBlob(blob: Blob, filename: string): void {
+  const objectUrl = URL.createObjectURL(blob)
+  const previousFocus = document.activeElement as HTMLElement | null
+  let anchor: HTMLAnchorElement | undefined
+
+  try {
+    anchor = document.createElement('a')
+    anchor.href = objectUrl
+    anchor.download = filename
+    anchor.hidden = true
+    anchor.tabIndex = -1
+    anchor.setAttribute('aria-hidden', 'true')
+    document.body.append(anchor)
+    anchor.click()
+  } finally {
+    try {
+      anchor?.remove()
+    } finally {
+      try {
+        if (previousFocus?.isConnected && document.activeElement !== previousFocus) {
+          previousFocus.focus({ preventScroll: true })
+        }
+      } finally {
+        setTimeout(() => URL.revokeObjectURL(objectUrl), 0)
+      }
+    }
+  }
+}

package/src/lib/form-field.ts

@@ -0,0 +1,93 @@
+import type { ComponentProps } from 'solid-js'
+import { createContext, createSignal, useContext } from 'solid-js'
+
+export type FormFieldControlKind = 'control' | 'group'
+
+export type FormFieldContextValue = {
+  group: () => boolean
+  labelId: string
+  controlId: () => string
+  registerControlId: (requestedId?: string) => string | undefined
+  describedBy: () => string | undefined
+  errorId: () => string | undefined
+  invalid: () => boolean
+}
+
+export const FormFieldContext = createContext<FormFieldContextValue>()
+
+function mergeIds(...values: Array<string | undefined>) {
+  return (
+    [...new Set(values.flatMap((value) => value?.split(/\s+/).filter(Boolean) ?? []))].join(' ') ||
+    undefined
+  )
+}
+
+export function createFormFieldContext(props: {
+  controlId?: string
+  defaultControlId: string
+  labelId: string
+  descriptionId?: string
+  errorId?: string
+  hint: () => string | undefined
+  error: () => string | undefined
+  group: () => boolean
+}): FormFieldContextValue {
+  const [controlId, setControlId] = createSignal(props.controlId ?? props.defaultControlId)
+
+  return {
+    group: props.group,
+    labelId: props.labelId,
+    controlId,
+    registerControlId(requestedId) {
+      if (props.group() && !requestedId) return undefined
+      if (requestedId) {
+        setControlId(requestedId)
+        return requestedId
+      }
+      return props.group() ? undefined : controlId()
+    },
+    describedBy: () =>
+      [props.hint() ? props.descriptionId : undefined, props.error() ? props.errorId : undefined]
+        .filter((id): id is string => Boolean(id))
+        .join(' ') || undefined,
+    errorId: () => (props.error() ? props.errorId : undefined),
+    invalid: () => Boolean(props.error()),
+  }
+}
+
+export function useFormFieldControl(
+  kind: FormFieldControlKind,
+  props: {
+    id?: string
+    'aria-label'?: string
+    'aria-labelledby'?: string
+    'aria-describedby'?: string
+    'aria-invalid'?: ComponentProps<'input'>['aria-invalid']
+    'aria-errormessage'?: string
+  } = {}
+) {
+  const field = useContext(FormFieldContext)
+  if (!field) return null
+
+  const groupedDescendant = field.group() && kind !== 'group'
+  const id = groupedDescendant ? props.id : field.registerControlId(props.id)
+  const labelledBy =
+    props['aria-label'] || props['aria-labelledby']
+      ? props['aria-labelledby']
+      : groupedDescendant
+        ? undefined
+        : field.labelId
+  return {
+    id,
+    'aria-labelledby': labelledBy,
+    get 'aria-describedby'() {
+      return mergeIds(props['aria-describedby'], field.describedBy())
+    },
+    get 'aria-invalid'() {
+      return props['aria-invalid'] ?? (field.invalid() || undefined)
+    },
+    get 'aria-errormessage'() {
+      return props['aria-errormessage'] ?? field.errorId()
+    },
+  }
+}