@djangocfg/widget-forms
Input surfaces: the things a user fills in, picks from, drags or speaks into.
Nine tools that share a job rather than a library — a form generated from a schema, two upload surfaces, a cron builder, three interaction primitives, a speech engine, and the registry that lets a voice button drive someone else's composer.
Install
pnpm add @djangocfg/widget-forms
Peers: react 19, react-dom 19, @djangocfg/ui-core, @djangocfg/i18n,
lucide-react, zustand.
Import a subpath
There is no root barrel worth importing. json-form carries RJSF and its AJV
validator; upload carries Rpldy; speech-recognition carries a store and an
engine. None of them belongs in an app that wanted a combobox.
| Subpath | What it is |
|---|---|
./json-form | JsonSchemaForm, lazy — a JSON Schema in, a themed form out |
./json-form/full | the same, eager, for a surface that always shows one |
./upload | Uploader — dropzone, previews, clipboard paste, abort |
./file-upload | the single-file control, when a batch would be overkill |
./cron-scheduler | CronScheduler, lazy — builds and explains a cron expression |
./combobox | a composed combobox (Trigger / Input / List / Item) |
./sortable | drag-to-reorder over dnd-kit |
./scroller | a scroll container with the affordances a list needs |
./speech-recognition | dictation, push-to-talk, engines, mic meter, language search |
./composer-registry | the seam a voice button uses to type into a composer it does not own |
./sounds | the short UI sounds the surfaces here play |
import { JsonSchemaForm } from '@djangocfg/widget-forms/json-form';
import { Combobox, ComboboxInput, ComboboxList, ComboboxItem }
from '@djangocfg/widget-forms/combobox';
composer-registry is why speech and chat can stay apart
A dictation button must put text into a composer. If it imported one, this
package would depend on the chat surface — so instead a composer registers a
handle (ComposerHandle), and the voice widget looks one up. The producer side
is @djangocfg/widget-chat and any TipTap host; the consumer side is
./speech-recognition. Neither imports the other.
ComposerHandle is the one type the root barrel exports, because a host
implementing the producer side needs it without pulling a widget in.
Testing
pnpm --filter @djangocfg/widget-forms check-types test
Six suites, all under speech/ — the reducer, the transcript assembly, the id
generator, language matching and search, and the Web Speech engine. That is
where the logic is; the rest of this package is composition over ui-core.