@smartfront/react
v0.2.2
Published
Smartfront react operations SDK
Readme
@smartfront/react
React 18+ adapter with a Provider, headless chat behavior, automatic registration cleanup and cached external-store subscriptions. No state-manager migration is required.
Build your entire UI with useSmartChat(): state, typed subscribeEvents() and bound send/cancel/confirm/form/context handlers. SmartChat is an unstyled textarea only, customizable through native attributes, classes/styles, refs, controlled value/onValueChange, onSend and onEvent. The complete UI is an explicit SmartChatPanel opt-in, as in the examples below. Custom UI and input examples.
Recommended: declare defineSmartModule modules and a defineSmartfront config in new files, then wrap the existing app once with <SmartfrontProvider config={config}><App /></SmartfrontProvider>. Render your own chat controls inside the Provider, optionally using SmartChat for the input. Zustand actions use the existing store's getState(); no store changes or extra subscriptions are required. Pass instance-specific dependencies to factories. Modules, Zustand, plain services and SSR.
The hooks below remain alternatives for component-owned state and callbacks.
import { SmartfrontProvider, SmartChatPanel, useSmartOperation, useSmartContext } from '@smartfront/react';
function AI() {
useSmartContext('counter', () => ({ count: store.getState().count }));
useSmartOperation('increment', ({ amount }) => store.getState().increment(amount), {
description: 'Increase the counter', params: { amount: { type: 'integer' } },
});
return <SmartChatPanel voice />;
}
export function App() { return <SmartfrontProvider endpoint="/v1/chat"><AI /></SmartfrontProvider>; }Standalone <SmartChatPanel endpoint="/v1/chat" /> owns its client. A Provider-created client is disposed on real unmount and survives Strict Mode effect replay. An external client remains caller-owned. Use a separate client per SSR request and remount with a new key to change initialization options. Exported headless hooks include useSmartfrontClient, useSmartfrontState and useSmartChat. The core enforces dangerous confirmations for custom interfaces too.
Workspace build/test: npm run build -w @smartfront/react, npm run test -w @smartfront/react after building core/UI.
