@kitn.ai/ui/dist/primitives/controllable.d.ts

Framework-agnostic, Shadow-DOM web components for building AI chat interfaces — works in React, Vue, Angular, Svelte, or plain HTML. Authored in SolidJS.

import { Accessor } from 'solid-js';
/**
 * The controlled/uncontrolled state pattern, as a reusable signal.
 *
 * `controlled` is an accessor for the controlling prop: when it returns a value,
 * that value wins (controlled mode); when it returns `undefined`, the component
 * manages its own state seeded from `initial` (uncontrolled mode). The returned
 * setter always writes the internal value — harmless (masked) while controlled,
 * authoritative while uncontrolled — so a single call site works in both modes.
 *
 * Mirrors `props.value ?? internal()` used elsewhere in the kit, without effects.
 */
export declare function createControllableSignal(controlled: Accessor<boolean | undefined>, initial: boolean): [Accessor<boolean>, (value: boolean) => void];