@otfdashkit/ui 0.1.1 → 0.1.2

package/src/forms/field.tsx

@@ -1,62 +1 @@
-import React from 'react'
-import { cn } from '../utils/cn'
-
-export interface FieldProps {
-  label?: string
-  description?: string
-  error?: string
-  required?: boolean
-  children: React.ReactNode
-  className?: string
-}
-
-export function Field({ label, description, error, required, children, className }: FieldProps) {
-  return (
-    <div className={cn('flex flex-col gap-1.5', className)}>
-      {label && <FieldLabel required={required}>{label}</FieldLabel>}
-      {children}
-      {description && !error && <FieldDescription>{description}</FieldDescription>}
-      {error && <FieldError>{error}</FieldError>}
-    </div>
-  )
-}
-
-export interface FieldLabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
-  required?: boolean
-}
-
-export const FieldLabel = React.forwardRef<HTMLLabelElement, FieldLabelProps>(
-  ({ className, required, children, ...props }, ref) => (
-    <label
-      ref={ref}
-      className={cn('text-sm font-medium leading-none text-[hsl(var(--foreground))]', className)}
-      {...props}
-    >
-      {children}
-      {required && <span className="ml-1 text-[hsl(var(--destructive))]">*</span>}
-    </label>
-  )
-)
-FieldLabel.displayName = 'FieldLabel'
-
-export const FieldDescription = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLParagraphElement>>(
-  ({ className, ...props }, ref) => (
-    <p
-      ref={ref}
-      className={cn('text-xs text-[hsl(var(--muted-foreground))]', className)}
-      {...props}
-    />
-  )
-)
-FieldDescription.displayName = 'FieldDescription'
-
-export const FieldError = React.forwardRef<HTMLParagraphElement, React.HTMLAttributes<HTMLParagraphElement>>(
-  ({ className, ...props }, ref) => (
-    <p
-      ref={ref}
-      className={cn('text-xs text-[hsl(var(--destructive))]', className)}
-      {...props}
-    />
-  )
-)
-FieldError.displayName = 'FieldError'
+export * from './Field/index'

package/src/forms/file-upload.tsx

@@ -1,101 +1 @@
-import React, { useRef, useState } from 'react'
-import { Upload, X } from 'lucide-react'
-import { cn } from '../utils/cn'
-
-export interface FileUploadProps {
-  accept?: string
-  multiple?: boolean
-  maxSize?: number
-  onFiles?: (files: File[]) => void
-  className?: string
-  disabled?: boolean
-}
-
-function formatBytes(bytes: number) {
-  if (bytes < 1024) return `${bytes} B`
-  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`
-  return `${(bytes / 1024 / 1024).toFixed(1)} MB`
-}
-
-function filterBySize(files: File[], maxSize?: number) {
-  return maxSize ? files.filter(f => f.size <= maxSize) : files
-}
-
-export function FileUpload({ accept, multiple, maxSize, onFiles, className, disabled }: FileUploadProps) {
-  const inputRef = useRef<HTMLInputElement>(null)
-  const [dragging, setDragging] = useState(false)
-
-  function handleFiles(raw: FileList | null) {
-    if (!raw) return
-    const files = filterBySize(Array.from(raw), maxSize)
-    onFiles?.(files)
-  }
-
-  function handleDrop(e: React.DragEvent) {
-    e.preventDefault()
-    setDragging(false)
-    if (!disabled) handleFiles(e.dataTransfer.files)
-  }
-
-  return (
-    <div
-      role="button"
-      tabIndex={disabled ? -1 : 0}
-      onClick={() => !disabled && inputRef.current?.click()}
-      onKeyDown={e => e.key === 'Enter' && !disabled && inputRef.current?.click()}
-      onDragOver={e => { e.preventDefault(); if (!disabled) setDragging(true) }}
-      onDragLeave={() => setDragging(false)}
-      onDrop={handleDrop}
-      className={cn(
-        'flex flex-col items-center justify-center gap-2 rounded-md border-2 border-dashed border-[hsl(var(--border))] p-8 text-center transition-colors cursor-pointer',
-        dragging && 'border-[hsl(var(--primary))] bg-[hsl(var(--accent))]',
-        disabled && 'cursor-not-allowed opacity-50',
-        className
-      )}
-    >
-      <Upload className="h-8 w-8 text-[hsl(var(--muted-foreground))]" />
-      <div>
-        <p className="text-sm font-medium">Drag files here or click to upload</p>
-        {maxSize && <p className="text-xs text-[hsl(var(--muted-foreground))]">Max size: {formatBytes(maxSize)}</p>}
-      </div>
-      <input
-        ref={inputRef}
-        type="file"
-        accept={accept}
-        multiple={multiple}
-        className="hidden"
-        onChange={e => handleFiles(e.target.files)}
-        disabled={disabled}
-      />
-    </div>
-  )
-}
-
-export interface FileUploadPreviewProps {
-  files: File[]
-  onRemove: (index: number) => void
-  className?: string
-}
-
-export function FileUploadPreview({ files, onRemove, className }: FileUploadPreviewProps) {
-  if (!files.length) return null
-  return (
-    <ul className={cn('flex flex-col gap-1', className)}>
-      {files.map((file, i) => (
-        <li key={i} className="flex items-center justify-between rounded-md border border-[hsl(var(--border))] px-3 py-2 text-sm">
-          <span className="min-w-0 truncate text-[hsl(var(--foreground))]">{file.name}</span>
-          <div className="ml-2 flex shrink-0 items-center gap-2">
-            <span className="text-xs text-[hsl(var(--muted-foreground))]">{formatBytes(file.size)}</span>
-            <button
-              type="button"
-              onClick={() => onRemove(i)}
-              className="text-[hsl(var(--muted-foreground))] hover:text-[hsl(var(--destructive))] transition-colors"
-            >
-              <X className="h-4 w-4" />
-            </button>
-          </div>
-        </li>
-      ))}
-    </ul>
-  )
-}
+export * from './FileUpload'

package/src/forms/floating-label-input.tsx

@@ -0,0 +1 @@
+export * from './FloatingLabelInput'

package/src/forms/form.tsx

@@ -1,57 +1 @@
-import React, { useId } from 'react'
-import { FormProvider, Controller, useFormContext, type FieldValues, type ControllerProps, type FieldPath } from 'react-hook-form'
-import { cn } from '../utils/cn'
-
-export { FormProvider as Form }
-
-export function FormField<T extends FieldValues, N extends FieldPath<T>>(
-  props: ControllerProps<T, N>
-) {
-  return <Controller {...props} />
-}
-
-export function FormItem({ className, ...props }: React.HTMLAttributes<HTMLDivElement>) {
-  return <div className={cn('flex flex-col gap-1.5', className)} {...props} />
-}
-
-interface FormLabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
-  error?: boolean
-}
-
-export const FormLabel = React.forwardRef<HTMLLabelElement, FormLabelProps>(
-  ({ className, error, ...props }, ref) => (
-    <label
-      ref={ref}
-      className={cn(
-        'text-sm font-medium leading-none',
-        error ? 'text-[hsl(var(--destructive))]' : 'text-[hsl(var(--foreground))]',
-        className
-      )}
-      {...props}
-    />
-  )
-)
-FormLabel.displayName = 'FormLabel'
-
-export const FormControl = React.forwardRef<HTMLDivElement, React.HTMLAttributes<HTMLDivElement>>(
-  ({ ...props }, ref) => {
-    const id = useId()
-    return <div ref={ref} id={id} {...props} />
-  }
-)
-FormControl.displayName = 'FormControl'
-
-export function FormDescription({ className, ...props }: React.HTMLAttributes<HTMLParagraphElement>) {
-  return <p className={cn('text-xs text-[hsl(var(--muted-foreground))]', className)} {...props} />
-}
-
-export function FormMessage({ className, children, name }: React.HTMLAttributes<HTMLParagraphElement> & { name?: string }) {
-  const { formState } = useFormContext()
-  const error = name ? formState.errors[name] : undefined
-  const message = error?.message ? String(error.message) : children
-
-  if (!message) return null
-  return (
-    <p className={cn('text-xs text-[hsl(var(--destructive))]', className)}>{message}</p>
-  )
-}
+export * from './Form/index'

package/src/forms/object-field.tsx

@@ -1,53 +1 @@
-import React, { useState } from 'react'
-import { ChevronDown, ChevronRight } from 'lucide-react'
-import { cn } from '../utils/cn'
-
-export interface ObjectFieldProps {
-  title: string
-  description?: string
-  collapsible?: boolean
-  defaultOpen?: boolean
-  children: React.ReactNode
-  className?: string
-}
-
-export function ObjectField({
-  title,
-  description,
-  collapsible = false,
-  defaultOpen = true,
-  children,
-  className,
-}: ObjectFieldProps) {
-  const [open, setOpen] = useState(defaultOpen)
-
-  return (
-    <div className={cn('rounded-md border border-[hsl(var(--border))] overflow-hidden', className)}>
-      <div
-        className={cn(
-          'flex items-center justify-between px-4 py-3 bg-[hsl(var(--muted)/0.4)]',
-          collapsible && 'cursor-pointer hover:bg-[hsl(var(--accent))] transition-colors'
-        )}
-        onClick={() => collapsible && setOpen(o => !o)}
-        role={collapsible ? 'button' : undefined}
-        tabIndex={collapsible ? 0 : undefined}
-        onKeyDown={e => collapsible && e.key === 'Enter' && setOpen(o => !o)}
-      >
-        <div>
-          <h4 className="text-sm font-semibold text-[hsl(var(--foreground))]">{title}</h4>
-          {description && <p className="text-xs text-[hsl(var(--muted-foreground))]">{description}</p>}
-        </div>
-        {collapsible && (
-          open
-            ? <ChevronDown className="h-4 w-4 text-[hsl(var(--muted-foreground))]" />
-            : <ChevronRight className="h-4 w-4 text-[hsl(var(--muted-foreground))]" />
-        )}
-      </div>
-      {(!collapsible || open) && (
-        <div className="p-4 flex flex-col gap-4">
-          {children}
-        </div>
-      )}
-    </div>
-  )
-}
+export * from './ObjectField'

package/src/forms/password-input.tsx

@@ -1,54 +1 @@
-import React, { useState } from 'react'
-import { Eye, EyeOff } from 'lucide-react'
-import { Input, type InputProps } from '../primitives/input'
-import { cn } from '../utils/cn'
-
-export interface PasswordInputProps extends InputProps {
-  strength?: boolean
-}
-
-function getStrength(value: string): { level: 'weak' | 'medium' | 'strong'; width: string; color: string } {
-  const has = (re: RegExp) => re.test(value)
-  const score = [value.length >= 8, has(/[A-Z]/), has(/[0-9]/), has(/[^A-Za-z0-9]/)].filter(Boolean).length
-  if (score <= 1) return { level: 'weak', width: 'w-1/3', color: 'bg-[hsl(var(--destructive))]' }
-  if (score <= 3) return { level: 'medium', width: 'w-2/3', color: 'bg-yellow-500' }
-  return { level: 'strong', width: 'w-full', color: 'bg-green-500' }
-}
-
-export const PasswordInput = React.forwardRef<HTMLInputElement, PasswordInputProps>(
-  ({ className, strength, ...props }, ref) => {
-    const [show, setShow] = useState(false)
-    const value = String(props.value ?? '')
-    const str = getStrength(value)
-
-    return (
-      <div className="flex flex-col gap-1.5">
-        <div className="relative">
-          <Input
-            ref={ref}
-            type={show ? 'text' : 'password'}
-            className={cn('pr-9', className)}
-            {...props}
-          />
-          <button
-            type="button"
-            onClick={() => setShow(s => !s)}
-            className="absolute right-2.5 top-1/2 -translate-y-1/2 text-[hsl(var(--muted-foreground))] hover:text-[hsl(var(--foreground))] transition-colors"
-            tabIndex={-1}
-          >
-            {show ? <EyeOff className="h-4 w-4" /> : <Eye className="h-4 w-4" />}
-          </button>
-        </div>
-        {strength && value.length > 0 && (
-          <div className="space-y-1">
-            <div className="h-1 w-full rounded-full bg-[hsl(var(--muted))]">
-              <div className={cn('h-full rounded-full transition-all', str.width, str.color)} />
-            </div>
-            <p className="text-xs text-[hsl(var(--muted-foreground))] capitalize">{str.level}</p>
-          </div>
-        )}
-      </div>
-    )
-  }
-)
-PasswordInput.displayName = 'PasswordInput'
+export * from './PasswordInput'

package/src/forms/search-input.tsx

@@ -1,64 +1 @@
-import React, { useState } from 'react'
-import { Search, X } from 'lucide-react'
-import { cn } from '../utils/cn'
-import { type InputProps } from '../primitives/input'
-
-export interface SearchInputProps extends Omit<InputProps, 'onChange'> {
-  shortcut?: string
-  onClear?: () => void
-  onChange?: (value: string) => void
-}
-
-export const SearchInput = React.forwardRef<HTMLInputElement, SearchInputProps>(
-  ({ className, shortcut, onClear, onChange, value: valueProp, defaultValue, ...props }, ref) => {
-    const [internalValue, setInternalValue] = useState(defaultValue ?? '')
-    const isControlled = valueProp !== undefined
-    const value = isControlled ? String(valueProp) : String(internalValue)
-
-    function handleChange(e: React.ChangeEvent<HTMLInputElement>) {
-      if (!isControlled) setInternalValue(e.target.value)
-      onChange?.(e.target.value)
-    }
-
-    function handleClear() {
-      if (!isControlled) setInternalValue('')
-      onChange?.('')
-      onClear?.()
-    }
-
-    return (
-      <div className="relative flex items-center">
-        <Search className="pointer-events-none absolute left-2.5 h-4 w-4 text-[hsl(var(--muted-foreground))]" />
-        <input
-          ref={ref}
-          value={value}
-          onChange={handleChange}
-          className={cn(
-            'flex h-9 w-full rounded-md border border-[hsl(var(--input))] bg-transparent pl-8 pr-8 text-sm shadow-sm transition-colors',
-            'placeholder:text-[hsl(var(--muted-foreground))]',
-            'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[hsl(var(--ring))]',
-            'disabled:cursor-not-allowed disabled:opacity-50',
-            className
-          )}
-          {...props}
-        />
-        <div className="absolute right-2.5 flex items-center">
-          {value ? (
-            <button
-              type="button"
-              onClick={handleClear}
-              className="text-[hsl(var(--muted-foreground))] hover:text-[hsl(var(--foreground))] transition-colors"
-            >
-              <X className="h-4 w-4" />
-            </button>
-          ) : shortcut ? (
-            <kbd className="pointer-events-none rounded border border-[hsl(var(--border))] px-1.5 py-0.5 text-[10px] text-[hsl(var(--muted-foreground))]">
-              {shortcut}
-            </kbd>
-          ) : null}
-        </div>
-      </div>
-    )
-  }
-)
-SearchInput.displayName = 'SearchInput'
+export * from './SearchInput'

package/src/forms/step-form.tsx

@@ -1,113 +1 @@
-import React, { createContext, useContext, useState } from 'react'
-import { Button } from '../primitives/button'
-import { cn } from '../utils/cn'
-
-interface StepFormContextValue {
-  currentStep: number
-  totalSteps: number
-  steps: string[]
-  next: () => void
-  prev: () => void
-  isFirst: boolean
-  isLast: boolean
-}
-
-const StepFormContext = createContext<StepFormContextValue | null>(null)
-
-function useStepForm() {
-  const ctx = useContext(StepFormContext)
-  if (!ctx) throw new Error('useStepForm must be used within StepForm')
-  return ctx
-}
-
-export interface StepFormProps {
-  steps: string[]
-  onSubmit: () => void
-  children: React.ReactNode
-  className?: string
-}
-
-export function StepForm({ steps, onSubmit, children, className }: StepFormProps) {
-  const [currentStep, setCurrentStep] = useState(0)
-  const totalSteps = steps.length
-
-  const ctx: StepFormContextValue = {
-    currentStep,
-    totalSteps,
-    steps,
-    next: () => setCurrentStep(s => Math.min(s + 1, totalSteps - 1)),
-    prev: () => setCurrentStep(s => Math.max(s - 1, 0)),
-    isFirst: currentStep === 0,
-    isLast: currentStep === totalSteps - 1,
-  }
-
-  const childArray = React.Children.toArray(children)
-  const currentChild = childArray[currentStep]
-
-  return (
-    <StepFormContext.Provider value={ctx}>
-      <div className={cn('flex flex-col gap-6', className)}>
-        <StepIndicator steps={steps} currentStep={currentStep} />
-        <div>{currentChild}</div>
-        <StepFormNavigation onSubmit={onSubmit} />
-      </div>
-    </StepFormContext.Provider>
-  )
-}
-
-function StepIndicator({ steps, currentStep }: { steps: string[]; currentStep: number }) {
-  return (
-    <div className="flex items-center gap-2">
-      {steps.map((label, i) => (
-        <React.Fragment key={i}>
-          {i > 0 && <div className={cn('h-px flex-1 bg-[hsl(var(--border))]', i <= currentStep && 'bg-[hsl(var(--primary))]')} />}
-          <div className="flex flex-col items-center gap-1">
-            <div className={cn(
-              'flex h-7 w-7 items-center justify-center rounded-full text-xs font-medium border transition-colors',
-              i < currentStep && 'bg-[hsl(var(--primary))] border-[hsl(var(--primary))] text-[hsl(var(--primary-foreground))]',
-              i === currentStep && 'border-[hsl(var(--primary))] text-[hsl(var(--primary))]',
-              i > currentStep && 'border-[hsl(var(--border))] text-[hsl(var(--muted-foreground))]'
-            )}>{i + 1}</div>
-            <span className="hidden text-[10px] text-[hsl(var(--muted-foreground))] sm:block">{label}</span>
-          </div>
-        </React.Fragment>
-      ))}
-    </div>
-  )
-}
-
-export interface StepFormStepProps {
-  title: string
-  description?: string
-  children: React.ReactNode
-}
-
-export function StepFormStep({ title, description, children }: StepFormStepProps) {
-  return (
-    <div className="flex flex-col gap-4">
-      <div>
-        <h3 className="text-base font-semibold text-[hsl(var(--foreground))]">{title}</h3>
-        {description && <p className="text-sm text-[hsl(var(--muted-foreground))]">{description}</p>}
-      </div>
-      {children}
-    </div>
-  )
-}
-
-export interface StepFormNavigationProps {
-  onSubmit?: () => void
-  submitLabel?: string
-}
-
-export function StepFormNavigation({ onSubmit, submitLabel = 'Submit' }: StepFormNavigationProps) {
-  const { prev, next, isFirst, isLast } = useStepForm()
-  return (
-    <div className="flex justify-between">
-      <Button type="button" variant="outline" onClick={prev} disabled={isFirst}>Previous</Button>
-      {isLast
-        ? <Button type="button" onClick={onSubmit}>{submitLabel}</Button>
-        : <Button type="button" onClick={next}>Next</Button>
-      }
-    </div>
-  )
-}
+export * from './StepForm'

package/src/index.ts

@@ -23,7 +23,7 @@ export * from './primitives/context-menu'
 export * from './primitives/dialog'
 export * from './primitives/drawer'
 export * from './primitives/dropdown-menu'
-export * from './primitives/form'
+// export * from './primitives/form'  // conflicts with forms/form.tsx (Form, FormField, etc.)
 export * from './primitives/hover-card'
 export * from './primitives/input-otp'
 export * from './primitives/input'
@@ -59,7 +59,7 @@ export * from './primitives/tooltip'
 // components
 export * from './components/banner'
 export * from './components/breadcrumb'
-export * from './components/command-item'
+export { CommandListItem } from './components/command-item'
 export * from './components/data-grid'
 export * from './components/data-table'
 export * from './components/empty-state'
@@ -132,6 +132,7 @@ export * from './forms/color-picker'
 export * from './forms/date-picker'
 export * from './forms/field'
 export * from './forms/file-upload'
+export * from './forms/floating-label-input'
 export * from './forms/form'
 export * from './forms/object-field'
 export * from './forms/password-input'
@@ -153,7 +154,9 @@ export * from './layouts/stack'
 export { PageLayout } from './layout/PageLayout'
 export type { PageHeaderProps } from './layout/PageLayout'
 export { PageContainer, PageMain } from './layout/PageContainer'
-export * from './nav'
+export type { CommandPaletteProps } from './nav/CommandPalette'
+export { CommandPaletteProvider, useCommandPalette, CommandPalette } from './nav/CommandPalette'
+export * from './nav/HotkeysProvider'
 export * from './feedback'
 export * from './text'
 export * from './backgrounds'

package/src/primitives/Button/Button.tsx

@@ -43,6 +43,24 @@ const buttonVariants = cva(
           'hover:border-border/60 hover:bg-accent',
           'active:shadow-none',
         ].join(' '),
+        /** Shimmer — animated conic gradient sweep with a hover highlight.
+         *  Loud + premium; reserve for primary CTAs and pricing pages, not
+         *  for in-product UI (gets tiring fast). Cross-platform parity with
+         *  @otfdashkit/ui-native via the same `shimmer` variant key. */
+        shimmer: [
+          'relative isolate overflow-hidden',
+          'bg-primary text-primary-foreground',
+          'shadow-[0_1px_0_rgba(255,255,255,0.18)_inset,0_-1px_0_rgba(0,0,0,0.25)_inset]',
+          'hover:bg-primary/95',
+          // Continuous conic-gradient sweep behind the surface.
+          'before:absolute before:inset-[-1px] before:rounded-[inherit] before:-z-10',
+          'before:bg-[conic-gradient(from_0deg,transparent_0deg,transparent_70deg,rgba(255,255,255,0.55)_90deg,transparent_110deg,transparent_360deg)]',
+          'before:animate-[shimmer-rotate_2.6s_linear_infinite]',
+          // Diagonal gloss that sweeps on hover.
+          'after:absolute after:inset-0 after:rounded-[inherit] after:pointer-events-none',
+          'after:bg-[linear-gradient(115deg,transparent_30%,rgba(255,255,255,0.22)_50%,transparent_70%)]',
+          'after:translate-x-[-120%] hover:after:translate-x-[120%] after:transition-transform after:duration-[900ms] after:ease-out',
+        ].join(' '),
       },
       size: {
         sm:      'h-8 px-3 text-xs rounded-md',

package/src/primitives/code-block.tsx

@@ -106,7 +106,7 @@ export const CodeBlock = React.forwardRef<HTMLDivElement, CodeBlockProps>(
     return (
       <div
         ref={(node) => {
-          containerRef.current = node
+          (containerRef as React.MutableRefObject<HTMLDivElement | null>).current = node
           if (typeof ref === 'function') ref(node)
           else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node
         }}

package/src/primitives/comparison.tsx

@@ -100,7 +100,7 @@ export const Comparison = React.forwardRef<HTMLDivElement, ComparisonProps>(
     return (
       <div
         ref={(node) => {
-          containerRef.current = node
+          (containerRef as React.MutableRefObject<HTMLDivElement | null>).current = node
           if (typeof ref === 'function') ref(node)
           else if (ref) (ref as React.MutableRefObject<HTMLDivElement | null>).current = node
         }}

package/src/primitives/qr-code.tsx

@@ -20,7 +20,11 @@ export type QrCodeProps = Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>
     src: string
     height: number
     width: number
-    excavate?: boolean
+    excavate: boolean
+    x?: number
+    y?: number
+    opacity?: number
+    crossOrigin?: 'anonymous' | 'use-credentials' | ''
   }
 }
 

package/src/themes/base.css

@@ -23,3 +23,21 @@ h1, h2, h3, h4, h5, h6 {
   line-height: var(--line-height-heading, 1.2);
   font-weight: var(--font-weight-heading, 600);
 }
+
+/* ── Animations shipped with the SDK ────────────────────────────────────────
+   Consumers get these automatically by importing '@otfdashkit/ui/styles'.
+   Keep keyframe names unique to avoid collision with consumer-defined ones. */
+
+/* Conic-gradient shimmer rotation — used by Button variant="shimmer".
+   Animation: 360deg sweep, 2.6s linear, infinite. */
+@keyframes shimmer-rotate {
+  0%   { --shimmer-angle: 0deg;   transform: rotate(0deg); }
+  100% { --shimmer-angle: 360deg; transform: rotate(360deg); }
+}
+
+/* Concentric ripple expand — reserved for future use (RippleLoader, ping).
+   The existing motion/Ripple is click-triggered; this is for ambient pulses. */
+@keyframes pulse-ring {
+  0%   { transform: scale(0.4); opacity: 0.8; }
+  100% { transform: scale(1.6); opacity: 0; }
+}