mirror of
https://github.com/temetro/temetro.git
synced 2026-08-29 20:07:01 +00:00
Khalid Abdi
929bec8f31
Stop blocking AI imports/proposals on missing non-critical fields. Records the chat agent drafts now save with safe placeholders, auto-generated file numbers, and a source="ai" marker that surfaces an "Added by AI" badge so a clinician can review/edit them later. Backend: - add `source` (manual|ai) column to patients/appointments/prescriptions (migration 0014) + canonical types, services, validation schemas - relax patient/appointment validation: empty file number allowed, demographic + type/provider/initials fall back to placeholders (initials derived from name) - patients.generateFileNumber() auto-assigns an MRN when one is missing - proposeAppointment accepts a name when no file number resolves; AI commits + /api/ai/import stamp source="ai" Frontend: - `source` on Appointment/Patient/Prescription types; AI commits send source="ai" - reusable <AiBadge> shown on the Patients table/detail and prescriptions list Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
105 lines
3.2 KiB
Markdown
105 lines
3.2 KiB
Markdown
# JSX Preview
|
|
|
|
A component that dynamically renders JSX strings with streaming support for AI-generated UI.
|
|
|
|
The `JSXPreview` component renders JSX strings dynamically, supporting streaming scenarios where JSX may be incomplete. It automatically closes unclosed tags during streaming, making it ideal for displaying AI-generated UI components in real-time.
|
|
|
|
See `scripts/jsx-preview.tsx` for this example.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npx ai-elements@latest add jsx-preview
|
|
```
|
|
|
|
## Features
|
|
|
|
- Renders JSX strings dynamically using `react-jsx-parser`
|
|
- Streaming support with automatic tag completion
|
|
- Custom component injection for rendering your own components
|
|
- Error handling with customizable error display
|
|
- Context-based architecture for flexible composition
|
|
|
|
## Usage with AI SDK
|
|
|
|
The JSXPreview component integrates with the AI SDK to render generated UI in real-time:
|
|
|
|
```tsx title="components/generated-ui.tsx"
|
|
"use client";
|
|
|
|
import {
|
|
JSXPreview,
|
|
JSXPreviewContent,
|
|
JSXPreviewError,
|
|
} from "@/components/ai-elements/jsx-preview";
|
|
|
|
type GeneratedUIProps = {
|
|
jsx: string;
|
|
isStreaming: boolean;
|
|
};
|
|
|
|
export const GeneratedUI = ({ jsx, isStreaming }: GeneratedUIProps) => (
|
|
<JSXPreview
|
|
jsx={jsx}
|
|
isStreaming={isStreaming}
|
|
onError={(error) => console.error("JSX Parse Error:", error)}
|
|
>
|
|
<JSXPreviewContent />
|
|
<JSXPreviewError />
|
|
</JSXPreview>
|
|
);
|
|
```
|
|
|
|
### With Custom Components
|
|
|
|
You can inject custom components to be used within the rendered JSX:
|
|
|
|
```tsx title="components/generated-ui-with-components.tsx"
|
|
"use client";
|
|
|
|
import {
|
|
JSXPreview,
|
|
JSXPreviewContent,
|
|
} from "@/components/ai-elements/jsx-preview";
|
|
import { Button } from "@/components/ui/button";
|
|
import { Card } from "@/components/ui/card";
|
|
|
|
const customComponents = {
|
|
Button,
|
|
Card,
|
|
};
|
|
|
|
export const GeneratedUIWithComponents = ({ jsx }: { jsx: string }) => (
|
|
<JSXPreview jsx={jsx} components={customComponents}>
|
|
<JSXPreviewContent />
|
|
</JSXPreview>
|
|
);
|
|
```
|
|
|
|
## Props
|
|
|
|
### `<JSXPreview />`
|
|
|
|
| Prop | Type | Default | Description |
|
|
|------|------|---------|-------------|
|
|
| `jsx` | `string` | Required | The JSX string to render. |
|
|
| `isStreaming` | `boolean` | `false` | When true, automatically completes unclosed tags. |
|
|
| `components` | `Record<string, React.ComponentType>` | - | Custom components available within the rendered JSX. |
|
|
| `bindings` | `Record<string, unknown>` | - | Variables and functions available within the JSX scope. |
|
|
| `onError` | `(error: Error) => void` | - | Callback fired when a parsing or rendering error occurs. |
|
|
| `...props` | `React.ComponentProps<` | - | Any other props are spread to the underlying div element. |
|
|
|
|
### `<JSXPreviewContent />`
|
|
|
|
| Prop | Type | Default | Description |
|
|
|------|------|---------|-------------|
|
|
| `renderError` | `JsxParserProps[` | - | Custom error renderer passed to react-jsx-parser. |
|
|
| `...props` | `React.ComponentProps<` | - | Any other props are spread to the underlying div element. |
|
|
|
|
### `<JSXPreviewError />`
|
|
|
|
| Prop | Type | Default | Description |
|
|
|------|------|---------|-------------|
|
|
| `children` | `ReactNode | ((error: Error) => ReactNode)` | - | Custom error content or render function receiving the error. |
|
|
| `...props` | `React.ComponentProps<` | - | Any other props are spread to the underlying div element. |
|