pxengine 0.1.66 → 0.1.69
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +1355 -904
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +186 -5
- package/dist/index.d.ts +186 -5
- package/dist/index.mjs +1477 -1031
- package/dist/index.mjs.map +1 -1
- package/dist/registry.json +212 -6
- package/package.json +1 -1
package/dist/index.d.cts
CHANGED
|
@@ -138,7 +138,8 @@ type GapSize = "none" | "sm" | "md" | "lg" | "xl";
|
|
|
138
138
|
type TextVariant = "h1" | "h2" | "h3" | "h4" | "p" | "small" | "muted" | "label";
|
|
139
139
|
type ButtonVariant$1 = "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | "purple" | "gradient";
|
|
140
140
|
type ButtonSize$1 = "default" | "sm" | "lg" | "icon" | "xl";
|
|
141
|
-
type InputType = "text" | "email" | "password" | "number" | "search" | "tel" | "url" | "textarea" | "select" | "slider" | "checkbox" | "switch" | "radio" | "otp" | "date" | "dropdown";
|
|
141
|
+
type InputType = "text" | "email" | "password" | "number" | "search" | "tel" | "url" | "textarea" | "select" | "slider" | "checkbox" | "switch" | "radio" | "otp" | "date" | "time" | "datetime-local" | "color" | "file" | "dropdown";
|
|
142
|
+
type ButtonAction = "submit" | "reset" | "cancel" | "next" | "back" | "custom";
|
|
142
143
|
interface BaseAtom {
|
|
143
144
|
id: string;
|
|
144
145
|
type: string;
|
|
@@ -150,7 +151,17 @@ interface ButtonAtomType extends BaseAtom {
|
|
|
150
151
|
label: string;
|
|
151
152
|
variant?: ButtonVariant$1;
|
|
152
153
|
size?: ButtonSize$1;
|
|
153
|
-
|
|
154
|
+
/**
|
|
155
|
+
* REQUIRED — Submission handler action.
|
|
156
|
+
* - "submit": Collects all sibling inputs and sends them as Q/A pairs to the agent via Run SSE
|
|
157
|
+
* - "reset": Clears all input values
|
|
158
|
+
* - "cancel": Closes/cancels the widget
|
|
159
|
+
* - "next" / "back": Multi-step navigation
|
|
160
|
+
* - "custom": User-defined handler via onAction prop
|
|
161
|
+
*/
|
|
162
|
+
action: ButtonAction | string;
|
|
163
|
+
/** Optional payload key sent alongside Q/A pairs (e.g. agent name, custom intent) */
|
|
164
|
+
actionPayload?: Record<string, any>;
|
|
154
165
|
disabled?: boolean;
|
|
155
166
|
isLoading?: boolean;
|
|
156
167
|
icon?: IconName;
|
|
@@ -159,7 +170,10 @@ interface ButtonAtomType extends BaseAtom {
|
|
|
159
170
|
interface InputAtomType extends BaseAtom {
|
|
160
171
|
type: "input";
|
|
161
172
|
inputType: InputType;
|
|
173
|
+
/** Visible label for the field — auto-used as the Q in Q/A submission if `question` is unset */
|
|
162
174
|
label?: string;
|
|
175
|
+
/** Explicit Q text used when serializing this input for agent submission. Falls back to `label`. */
|
|
176
|
+
question?: string;
|
|
163
177
|
placeholder?: string;
|
|
164
178
|
defaultValue?: any;
|
|
165
179
|
required?: boolean;
|
|
@@ -170,6 +184,8 @@ interface InputAtomType extends BaseAtom {
|
|
|
170
184
|
}>;
|
|
171
185
|
config?: Record<string, any>;
|
|
172
186
|
labelColor?: string;
|
|
187
|
+
/** Stable key for the answer in Q/A submission. Defaults to id. */
|
|
188
|
+
fieldKey?: string;
|
|
173
189
|
}
|
|
174
190
|
interface ToggleAtomType extends BaseAtom {
|
|
175
191
|
type: "toggle";
|
|
@@ -182,12 +198,16 @@ interface ToggleAtomType extends BaseAtom {
|
|
|
182
198
|
interface CheckboxAtomType extends BaseAtom {
|
|
183
199
|
type: "checkbox";
|
|
184
200
|
label?: string;
|
|
201
|
+
question?: string;
|
|
202
|
+
fieldKey?: string;
|
|
185
203
|
checked?: boolean;
|
|
186
204
|
disabled?: boolean;
|
|
187
205
|
}
|
|
188
206
|
interface SwitchAtomType extends BaseAtom {
|
|
189
207
|
type: "switch";
|
|
190
208
|
label?: string;
|
|
209
|
+
question?: string;
|
|
210
|
+
fieldKey?: string;
|
|
191
211
|
checked?: boolean;
|
|
192
212
|
disabled?: boolean;
|
|
193
213
|
}
|
|
@@ -198,6 +218,9 @@ interface LabelAtomType extends BaseAtom {
|
|
|
198
218
|
}
|
|
199
219
|
interface SliderAtomType extends BaseAtom {
|
|
200
220
|
type: "slider";
|
|
221
|
+
label?: string;
|
|
222
|
+
question?: string;
|
|
223
|
+
fieldKey?: string;
|
|
201
224
|
defaultValue?: number[];
|
|
202
225
|
max?: number;
|
|
203
226
|
min?: number;
|
|
@@ -206,6 +229,9 @@ interface SliderAtomType extends BaseAtom {
|
|
|
206
229
|
}
|
|
207
230
|
interface RadioGroupAtomType extends BaseAtom {
|
|
208
231
|
type: "radio-group";
|
|
232
|
+
label?: string;
|
|
233
|
+
question?: string;
|
|
234
|
+
fieldKey?: string;
|
|
209
235
|
options: Array<{
|
|
210
236
|
label: string;
|
|
211
237
|
value: string;
|
|
@@ -279,6 +305,9 @@ interface KbdAtomType extends BaseAtom {
|
|
|
279
305
|
}
|
|
280
306
|
interface RatingAtomType extends BaseAtom {
|
|
281
307
|
type: "rating";
|
|
308
|
+
label?: string;
|
|
309
|
+
question?: string;
|
|
310
|
+
fieldKey?: string;
|
|
282
311
|
value: number;
|
|
283
312
|
max?: number;
|
|
284
313
|
readonly?: boolean;
|
|
@@ -460,11 +489,17 @@ interface PaginationAtomType extends BaseAtom {
|
|
|
460
489
|
}
|
|
461
490
|
interface CalendarAtomType extends BaseAtom {
|
|
462
491
|
type: "calendar";
|
|
492
|
+
label?: string;
|
|
493
|
+
question?: string;
|
|
494
|
+
fieldKey?: string;
|
|
463
495
|
mode?: "single" | "range" | "multiple";
|
|
464
496
|
selectedDate?: string | string[];
|
|
465
497
|
}
|
|
466
498
|
interface InputOTPAtomType extends BaseAtom {
|
|
467
499
|
type: "input-otp";
|
|
500
|
+
label?: string;
|
|
501
|
+
question?: string;
|
|
502
|
+
fieldKey?: string;
|
|
468
503
|
length: number;
|
|
469
504
|
placeholder?: string;
|
|
470
505
|
}
|
|
@@ -1328,6 +1363,79 @@ declare function generateFieldsFromData(data: Record<string, any>): FieldConfig[
|
|
|
1328
1363
|
*/
|
|
1329
1364
|
declare function generateFieldsFromPropDefinitions(propDefs: EditableOrganismPropDef[], data: Record<string, any>): FieldConfig[];
|
|
1330
1365
|
|
|
1366
|
+
/**
|
|
1367
|
+
* Run SSE submission helpers for input widgets.
|
|
1368
|
+
*
|
|
1369
|
+
* The Q/A submission format is the contract between widget inputs and the agent:
|
|
1370
|
+
*
|
|
1371
|
+
* Q: <question or label>
|
|
1372
|
+
* A: <user's answer>
|
|
1373
|
+
*
|
|
1374
|
+
* Example payload sent to the agent:
|
|
1375
|
+
*
|
|
1376
|
+
* Q: What type of freelancing services do you offer?
|
|
1377
|
+
* A: Web/App Development
|
|
1378
|
+
*
|
|
1379
|
+
* Q: How many years of experience?
|
|
1380
|
+
* A: 5
|
|
1381
|
+
*/
|
|
1382
|
+
interface CollectedField {
|
|
1383
|
+
/** Stable field id (defaults to atom id). */
|
|
1384
|
+
key: string;
|
|
1385
|
+
/** Question text — derived from `question` prop, falling back to `label`. */
|
|
1386
|
+
question: string;
|
|
1387
|
+
/** User's current answer in the most human-readable form. */
|
|
1388
|
+
answer: string;
|
|
1389
|
+
/** Atom name (e.g. "InputAtom", "RatingAtom"). Useful for debugging. */
|
|
1390
|
+
atomName?: string;
|
|
1391
|
+
}
|
|
1392
|
+
interface InputElementLike {
|
|
1393
|
+
id?: string;
|
|
1394
|
+
atomName?: string;
|
|
1395
|
+
props: Record<string, any>;
|
|
1396
|
+
/** Optional in-memory user value captured by the runtime. */
|
|
1397
|
+
value?: any;
|
|
1398
|
+
}
|
|
1399
|
+
declare function isInputAtom(atomName: string | undefined): boolean;
|
|
1400
|
+
/**
|
|
1401
|
+
* Format a single input element into a Q/A field.
|
|
1402
|
+
* Returns null when the element isn't an input or has no question/label to anchor on.
|
|
1403
|
+
*/
|
|
1404
|
+
declare function elementToQAField(element: InputElementLike): CollectedField | null;
|
|
1405
|
+
/**
|
|
1406
|
+
* Build a Q/A formatted string from a list of input elements.
|
|
1407
|
+
* Used as the body of the message sent to the agent via Run SSE.
|
|
1408
|
+
*/
|
|
1409
|
+
declare function formatQAMessage(elements: InputElementLike[]): string;
|
|
1410
|
+
interface RunSseConfig {
|
|
1411
|
+
/** Backend base URL, e.g. https://api.pxengine.com */
|
|
1412
|
+
backendUrl: string;
|
|
1413
|
+
/** App identifier registered in ADK */
|
|
1414
|
+
appName: string;
|
|
1415
|
+
/** Authenticated user id */
|
|
1416
|
+
userId: string;
|
|
1417
|
+
/** Existing session id, or undefined to let the caller create one upstream */
|
|
1418
|
+
sessionId: string;
|
|
1419
|
+
/** Bearer token; omitted if your backend uses cookies */
|
|
1420
|
+
authToken?: string;
|
|
1421
|
+
/** Streaming on/off (default true) */
|
|
1422
|
+
streaming?: boolean;
|
|
1423
|
+
/** AbortSignal to cancel the stream */
|
|
1424
|
+
signal?: AbortSignal;
|
|
1425
|
+
/** Optional message override — if provided, replaces the auto-formatted Q/A body */
|
|
1426
|
+
messageOverride?: string;
|
|
1427
|
+
/** Extra payload merged into the request body (e.g. button.actionPayload) */
|
|
1428
|
+
extraPayload?: Record<string, any>;
|
|
1429
|
+
}
|
|
1430
|
+
/**
|
|
1431
|
+
* Submit a widget's collected inputs to an agent via the Run SSE endpoint.
|
|
1432
|
+
*
|
|
1433
|
+
* Returns the Response object — caller is responsible for reading the SSE stream
|
|
1434
|
+
* (e.g. via @microsoft/fetch-event-source on the consuming side). This keeps
|
|
1435
|
+
* @pxengine-ui dependency-free.
|
|
1436
|
+
*/
|
|
1437
|
+
declare function submitWidgetToAgent(elements: InputElementLike[], config: RunSseConfig): Promise<Response>;
|
|
1438
|
+
|
|
1331
1439
|
/**
|
|
1332
1440
|
* TextAtom
|
|
1333
1441
|
* Renders standardized text styles from UISchema
|
|
@@ -1486,7 +1594,7 @@ declare const ToggleAtom: React__default.FC<ToggleAtomType & {
|
|
|
1486
1594
|
|
|
1487
1595
|
/**
|
|
1488
1596
|
* SliderAtom
|
|
1489
|
-
* Wraps shadcn Slider
|
|
1597
|
+
* Wraps shadcn Slider with optional label
|
|
1490
1598
|
*/
|
|
1491
1599
|
declare const SliderAtom: React__default.FC<SliderAtomType & {
|
|
1492
1600
|
onValueChange?: (value: number[]) => void;
|
|
@@ -1568,7 +1676,7 @@ declare const VideoAtom: React__default.FC<VideoAtomType>;
|
|
|
1568
1676
|
|
|
1569
1677
|
/**
|
|
1570
1678
|
* RatingAtom
|
|
1571
|
-
* A star rating component for display or user input.
|
|
1679
|
+
* A star rating component for display or user input, with optional label.
|
|
1572
1680
|
*/
|
|
1573
1681
|
declare const RatingAtom: React__default.FC<RatingAtomType & {
|
|
1574
1682
|
onChange?: (val: number) => void;
|
|
@@ -2187,6 +2295,79 @@ interface ConfirmationCardProps {
|
|
|
2187
2295
|
*/
|
|
2188
2296
|
declare const ConfirmationCard: React__default.NamedExoticComponent<ConfirmationCardProps>;
|
|
2189
2297
|
|
|
2298
|
+
type InputWidgetFieldKind = "text" | "email" | "password" | "number" | "search" | "tel" | "url" | "textarea" | "select" | "checkbox" | "switch" | "slider" | "radio" | "rating" | "date" | "time" | "datetime-local" | "color" | "file" | "otp";
|
|
2299
|
+
interface InputWidgetField {
|
|
2300
|
+
/** Stable key for this field — used as the answer key in Q/A submission. */
|
|
2301
|
+
key: string;
|
|
2302
|
+
/** Visible label rendered above the input. */
|
|
2303
|
+
label: string;
|
|
2304
|
+
/** Question used as the "Q:" line when serializing for the agent. Falls back to `label`. */
|
|
2305
|
+
question?: string;
|
|
2306
|
+
kind: InputWidgetFieldKind;
|
|
2307
|
+
placeholder?: string;
|
|
2308
|
+
defaultValue?: any;
|
|
2309
|
+
required?: boolean;
|
|
2310
|
+
disabled?: boolean;
|
|
2311
|
+
options?: Array<{
|
|
2312
|
+
label: string;
|
|
2313
|
+
value: string;
|
|
2314
|
+
}>;
|
|
2315
|
+
min?: number;
|
|
2316
|
+
max?: number;
|
|
2317
|
+
step?: number;
|
|
2318
|
+
/** OTP length, slider step config, etc. */
|
|
2319
|
+
config?: Record<string, any>;
|
|
2320
|
+
}
|
|
2321
|
+
interface InputWidgetType {
|
|
2322
|
+
id: string;
|
|
2323
|
+
type: "input-widget";
|
|
2324
|
+
/** Heading shown above the field (optional — falls back to field label). */
|
|
2325
|
+
title?: string;
|
|
2326
|
+
/** Description / helper text shown under the title (optional). */
|
|
2327
|
+
description?: string;
|
|
2328
|
+
/** The fields that make up this input widget — at least one is required. */
|
|
2329
|
+
fields: InputWidgetField[];
|
|
2330
|
+
/** Submit button config — auto-included with action: "submit" by default. */
|
|
2331
|
+
submitButton?: {
|
|
2332
|
+
label?: string;
|
|
2333
|
+
action: ButtonAction | string;
|
|
2334
|
+
actionPayload?: Record<string, any>;
|
|
2335
|
+
variant?: "default" | "purple" | "gradient" | "outline" | "secondary";
|
|
2336
|
+
};
|
|
2337
|
+
/** Optional secondary button (cancel/reset/back). */
|
|
2338
|
+
secondaryButton?: {
|
|
2339
|
+
label?: string;
|
|
2340
|
+
action: ButtonAction | string;
|
|
2341
|
+
};
|
|
2342
|
+
className?: string;
|
|
2343
|
+
style?: React.CSSProperties;
|
|
2344
|
+
}
|
|
2345
|
+
|
|
2346
|
+
interface InputWidgetProps extends InputWidgetType {
|
|
2347
|
+
/**
|
|
2348
|
+
* Called when the submit button is pressed.
|
|
2349
|
+
* Receives the formatted Q/A message string AND the structured field list.
|
|
2350
|
+
* Caller wires this to a Run SSE sendMessage handler.
|
|
2351
|
+
*/
|
|
2352
|
+
onSubmit?: (qaMessage: string, fields: CollectedField[]) => void;
|
|
2353
|
+
/** Called for any non-submit button action (cancel, reset, custom). */
|
|
2354
|
+
onAction?: (action: string, payload?: Record<string, any>) => void;
|
|
2355
|
+
isSubmitting?: boolean;
|
|
2356
|
+
}
|
|
2357
|
+
/**
|
|
2358
|
+
* InputWidget
|
|
2359
|
+
*
|
|
2360
|
+
* A self-contained input molecule that *guarantees*:
|
|
2361
|
+
* 1. Every field has a label (no headless inputs)
|
|
2362
|
+
* 2. A submit button is always rendered
|
|
2363
|
+
* 3. On submit, all field values are formatted as Q/A pairs and handed
|
|
2364
|
+
* back to the caller for transmission via Run SSE.
|
|
2365
|
+
*
|
|
2366
|
+
* This is the canonical wrapper for any user-facing input widget built in
|
|
2367
|
+
* the widget builder.
|
|
2368
|
+
*/
|
|
2369
|
+
declare const InputWidget: React__default.FC<InputWidgetProps>;
|
|
2370
|
+
|
|
2190
2371
|
interface CampaignSeedCardProps extends Omit<FormCardProps, "fields"> {
|
|
2191
2372
|
/**
|
|
2192
2373
|
* Status of the selection (done by user or agent)
|
|
@@ -2666,4 +2847,4 @@ declare function CreatorImageList({ creatorImages, creatorLength, isAgentOutput,
|
|
|
2666
2847
|
|
|
2667
2848
|
declare function CreatorProgressBar({ statusDetails, timeRemaining: _timeRemaining, }: CreatorProgressBarProps): react_jsx_runtime.JSX.Element;
|
|
2668
2849
|
|
|
2669
|
-
export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, type BranchCI, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, type ChartDataPoint, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmationCard, type ConfirmationCardMolecule, type ConfirmationCardProps, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, type CreatorDetailData, CreatorExpandedPanel, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchCreatorDetailsParams, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GitHubConnectCard, type GitHubConnectCardProps, type GitHubConnectMolecule, GitHubIssueTrackerCard, type GitHubIssueTrackerCardProps, type GitHubIssueTrackerMolecule, GitHubRepoHealthCard, type GitHubRepoHealthCardProps, type GitHubRepoHealthMolecule, GitHubReposListCard, type GitHubReposListCardProps, GoogleSheetsCard, type GoogleSheetsCardProps, GoogleSheetsConnectCard, type GoogleSheetsConnectCardProps, GoogleSheetsListCard, type GoogleSheetsListCardProps, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, type PullRequest, REGISTERED_COMPONENTS, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, RecommendationCard, type RecommendationCardMolecule, type RecommendationCardProps, type RepoItem, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, type SheetColumn, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetRow, type SheetTabItem, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, type SocialPost, SocialPostCard, type SocialPostCardProps, type SocialPostMolecule, Spinner, SpinnerAtom, type SpinnerAtomType, type SpreadsheetItem, type StaleIssue, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, cn, defaultFetchSelections, defaultPersistSelection, generateFieldsFromData, generateFieldsFromPropDefinitions, useCreatorWidgetPolling };
|
|
2850
|
+
export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, type BranchCI, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, type ButtonAction, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, type ChartDataPoint, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, type CollectedField, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmationCard, type ConfirmationCardMolecule, type ConfirmationCardProps, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, type CreatorDetailData, CreatorExpandedPanel, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchCreatorDetailsParams, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GitHubConnectCard, type GitHubConnectCardProps, type GitHubConnectMolecule, GitHubIssueTrackerCard, type GitHubIssueTrackerCardProps, type GitHubIssueTrackerMolecule, GitHubRepoHealthCard, type GitHubRepoHealthCardProps, type GitHubRepoHealthMolecule, GitHubReposListCard, type GitHubReposListCardProps, GoogleSheetsCard, type GoogleSheetsCardProps, GoogleSheetsConnectCard, type GoogleSheetsConnectCardProps, GoogleSheetsListCard, type GoogleSheetsListCardProps, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, type InputElementLike, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, InputWidget, type InputWidgetField, type InputWidgetFieldKind, type InputWidgetType, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, type PullRequest, REGISTERED_COMPONENTS, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, RecommendationCard, type RecommendationCardMolecule, type RecommendationCardProps, type RepoItem, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, type RunSseConfig, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, type SheetColumn, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetRow, type SheetTabItem, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, type SocialPost, SocialPostCard, type SocialPostCardProps, type SocialPostMolecule, Spinner, SpinnerAtom, type SpinnerAtomType, type SpreadsheetItem, type StaleIssue, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, cn, defaultFetchSelections, defaultPersistSelection, elementToQAField, formatQAMessage, generateFieldsFromData, generateFieldsFromPropDefinitions, isInputAtom, submitWidgetToAgent, useCreatorWidgetPolling };
|
package/dist/index.d.ts
CHANGED
|
@@ -138,7 +138,8 @@ type GapSize = "none" | "sm" | "md" | "lg" | "xl";
|
|
|
138
138
|
type TextVariant = "h1" | "h2" | "h3" | "h4" | "p" | "small" | "muted" | "label";
|
|
139
139
|
type ButtonVariant$1 = "default" | "destructive" | "outline" | "secondary" | "ghost" | "link" | "purple" | "gradient";
|
|
140
140
|
type ButtonSize$1 = "default" | "sm" | "lg" | "icon" | "xl";
|
|
141
|
-
type InputType = "text" | "email" | "password" | "number" | "search" | "tel" | "url" | "textarea" | "select" | "slider" | "checkbox" | "switch" | "radio" | "otp" | "date" | "dropdown";
|
|
141
|
+
type InputType = "text" | "email" | "password" | "number" | "search" | "tel" | "url" | "textarea" | "select" | "slider" | "checkbox" | "switch" | "radio" | "otp" | "date" | "time" | "datetime-local" | "color" | "file" | "dropdown";
|
|
142
|
+
type ButtonAction = "submit" | "reset" | "cancel" | "next" | "back" | "custom";
|
|
142
143
|
interface BaseAtom {
|
|
143
144
|
id: string;
|
|
144
145
|
type: string;
|
|
@@ -150,7 +151,17 @@ interface ButtonAtomType extends BaseAtom {
|
|
|
150
151
|
label: string;
|
|
151
152
|
variant?: ButtonVariant$1;
|
|
152
153
|
size?: ButtonSize$1;
|
|
153
|
-
|
|
154
|
+
/**
|
|
155
|
+
* REQUIRED — Submission handler action.
|
|
156
|
+
* - "submit": Collects all sibling inputs and sends them as Q/A pairs to the agent via Run SSE
|
|
157
|
+
* - "reset": Clears all input values
|
|
158
|
+
* - "cancel": Closes/cancels the widget
|
|
159
|
+
* - "next" / "back": Multi-step navigation
|
|
160
|
+
* - "custom": User-defined handler via onAction prop
|
|
161
|
+
*/
|
|
162
|
+
action: ButtonAction | string;
|
|
163
|
+
/** Optional payload key sent alongside Q/A pairs (e.g. agent name, custom intent) */
|
|
164
|
+
actionPayload?: Record<string, any>;
|
|
154
165
|
disabled?: boolean;
|
|
155
166
|
isLoading?: boolean;
|
|
156
167
|
icon?: IconName;
|
|
@@ -159,7 +170,10 @@ interface ButtonAtomType extends BaseAtom {
|
|
|
159
170
|
interface InputAtomType extends BaseAtom {
|
|
160
171
|
type: "input";
|
|
161
172
|
inputType: InputType;
|
|
173
|
+
/** Visible label for the field — auto-used as the Q in Q/A submission if `question` is unset */
|
|
162
174
|
label?: string;
|
|
175
|
+
/** Explicit Q text used when serializing this input for agent submission. Falls back to `label`. */
|
|
176
|
+
question?: string;
|
|
163
177
|
placeholder?: string;
|
|
164
178
|
defaultValue?: any;
|
|
165
179
|
required?: boolean;
|
|
@@ -170,6 +184,8 @@ interface InputAtomType extends BaseAtom {
|
|
|
170
184
|
}>;
|
|
171
185
|
config?: Record<string, any>;
|
|
172
186
|
labelColor?: string;
|
|
187
|
+
/** Stable key for the answer in Q/A submission. Defaults to id. */
|
|
188
|
+
fieldKey?: string;
|
|
173
189
|
}
|
|
174
190
|
interface ToggleAtomType extends BaseAtom {
|
|
175
191
|
type: "toggle";
|
|
@@ -182,12 +198,16 @@ interface ToggleAtomType extends BaseAtom {
|
|
|
182
198
|
interface CheckboxAtomType extends BaseAtom {
|
|
183
199
|
type: "checkbox";
|
|
184
200
|
label?: string;
|
|
201
|
+
question?: string;
|
|
202
|
+
fieldKey?: string;
|
|
185
203
|
checked?: boolean;
|
|
186
204
|
disabled?: boolean;
|
|
187
205
|
}
|
|
188
206
|
interface SwitchAtomType extends BaseAtom {
|
|
189
207
|
type: "switch";
|
|
190
208
|
label?: string;
|
|
209
|
+
question?: string;
|
|
210
|
+
fieldKey?: string;
|
|
191
211
|
checked?: boolean;
|
|
192
212
|
disabled?: boolean;
|
|
193
213
|
}
|
|
@@ -198,6 +218,9 @@ interface LabelAtomType extends BaseAtom {
|
|
|
198
218
|
}
|
|
199
219
|
interface SliderAtomType extends BaseAtom {
|
|
200
220
|
type: "slider";
|
|
221
|
+
label?: string;
|
|
222
|
+
question?: string;
|
|
223
|
+
fieldKey?: string;
|
|
201
224
|
defaultValue?: number[];
|
|
202
225
|
max?: number;
|
|
203
226
|
min?: number;
|
|
@@ -206,6 +229,9 @@ interface SliderAtomType extends BaseAtom {
|
|
|
206
229
|
}
|
|
207
230
|
interface RadioGroupAtomType extends BaseAtom {
|
|
208
231
|
type: "radio-group";
|
|
232
|
+
label?: string;
|
|
233
|
+
question?: string;
|
|
234
|
+
fieldKey?: string;
|
|
209
235
|
options: Array<{
|
|
210
236
|
label: string;
|
|
211
237
|
value: string;
|
|
@@ -279,6 +305,9 @@ interface KbdAtomType extends BaseAtom {
|
|
|
279
305
|
}
|
|
280
306
|
interface RatingAtomType extends BaseAtom {
|
|
281
307
|
type: "rating";
|
|
308
|
+
label?: string;
|
|
309
|
+
question?: string;
|
|
310
|
+
fieldKey?: string;
|
|
282
311
|
value: number;
|
|
283
312
|
max?: number;
|
|
284
313
|
readonly?: boolean;
|
|
@@ -460,11 +489,17 @@ interface PaginationAtomType extends BaseAtom {
|
|
|
460
489
|
}
|
|
461
490
|
interface CalendarAtomType extends BaseAtom {
|
|
462
491
|
type: "calendar";
|
|
492
|
+
label?: string;
|
|
493
|
+
question?: string;
|
|
494
|
+
fieldKey?: string;
|
|
463
495
|
mode?: "single" | "range" | "multiple";
|
|
464
496
|
selectedDate?: string | string[];
|
|
465
497
|
}
|
|
466
498
|
interface InputOTPAtomType extends BaseAtom {
|
|
467
499
|
type: "input-otp";
|
|
500
|
+
label?: string;
|
|
501
|
+
question?: string;
|
|
502
|
+
fieldKey?: string;
|
|
468
503
|
length: number;
|
|
469
504
|
placeholder?: string;
|
|
470
505
|
}
|
|
@@ -1328,6 +1363,79 @@ declare function generateFieldsFromData(data: Record<string, any>): FieldConfig[
|
|
|
1328
1363
|
*/
|
|
1329
1364
|
declare function generateFieldsFromPropDefinitions(propDefs: EditableOrganismPropDef[], data: Record<string, any>): FieldConfig[];
|
|
1330
1365
|
|
|
1366
|
+
/**
|
|
1367
|
+
* Run SSE submission helpers for input widgets.
|
|
1368
|
+
*
|
|
1369
|
+
* The Q/A submission format is the contract between widget inputs and the agent:
|
|
1370
|
+
*
|
|
1371
|
+
* Q: <question or label>
|
|
1372
|
+
* A: <user's answer>
|
|
1373
|
+
*
|
|
1374
|
+
* Example payload sent to the agent:
|
|
1375
|
+
*
|
|
1376
|
+
* Q: What type of freelancing services do you offer?
|
|
1377
|
+
* A: Web/App Development
|
|
1378
|
+
*
|
|
1379
|
+
* Q: How many years of experience?
|
|
1380
|
+
* A: 5
|
|
1381
|
+
*/
|
|
1382
|
+
interface CollectedField {
|
|
1383
|
+
/** Stable field id (defaults to atom id). */
|
|
1384
|
+
key: string;
|
|
1385
|
+
/** Question text — derived from `question` prop, falling back to `label`. */
|
|
1386
|
+
question: string;
|
|
1387
|
+
/** User's current answer in the most human-readable form. */
|
|
1388
|
+
answer: string;
|
|
1389
|
+
/** Atom name (e.g. "InputAtom", "RatingAtom"). Useful for debugging. */
|
|
1390
|
+
atomName?: string;
|
|
1391
|
+
}
|
|
1392
|
+
interface InputElementLike {
|
|
1393
|
+
id?: string;
|
|
1394
|
+
atomName?: string;
|
|
1395
|
+
props: Record<string, any>;
|
|
1396
|
+
/** Optional in-memory user value captured by the runtime. */
|
|
1397
|
+
value?: any;
|
|
1398
|
+
}
|
|
1399
|
+
declare function isInputAtom(atomName: string | undefined): boolean;
|
|
1400
|
+
/**
|
|
1401
|
+
* Format a single input element into a Q/A field.
|
|
1402
|
+
* Returns null when the element isn't an input or has no question/label to anchor on.
|
|
1403
|
+
*/
|
|
1404
|
+
declare function elementToQAField(element: InputElementLike): CollectedField | null;
|
|
1405
|
+
/**
|
|
1406
|
+
* Build a Q/A formatted string from a list of input elements.
|
|
1407
|
+
* Used as the body of the message sent to the agent via Run SSE.
|
|
1408
|
+
*/
|
|
1409
|
+
declare function formatQAMessage(elements: InputElementLike[]): string;
|
|
1410
|
+
interface RunSseConfig {
|
|
1411
|
+
/** Backend base URL, e.g. https://api.pxengine.com */
|
|
1412
|
+
backendUrl: string;
|
|
1413
|
+
/** App identifier registered in ADK */
|
|
1414
|
+
appName: string;
|
|
1415
|
+
/** Authenticated user id */
|
|
1416
|
+
userId: string;
|
|
1417
|
+
/** Existing session id, or undefined to let the caller create one upstream */
|
|
1418
|
+
sessionId: string;
|
|
1419
|
+
/** Bearer token; omitted if your backend uses cookies */
|
|
1420
|
+
authToken?: string;
|
|
1421
|
+
/** Streaming on/off (default true) */
|
|
1422
|
+
streaming?: boolean;
|
|
1423
|
+
/** AbortSignal to cancel the stream */
|
|
1424
|
+
signal?: AbortSignal;
|
|
1425
|
+
/** Optional message override — if provided, replaces the auto-formatted Q/A body */
|
|
1426
|
+
messageOverride?: string;
|
|
1427
|
+
/** Extra payload merged into the request body (e.g. button.actionPayload) */
|
|
1428
|
+
extraPayload?: Record<string, any>;
|
|
1429
|
+
}
|
|
1430
|
+
/**
|
|
1431
|
+
* Submit a widget's collected inputs to an agent via the Run SSE endpoint.
|
|
1432
|
+
*
|
|
1433
|
+
* Returns the Response object — caller is responsible for reading the SSE stream
|
|
1434
|
+
* (e.g. via @microsoft/fetch-event-source on the consuming side). This keeps
|
|
1435
|
+
* @pxengine-ui dependency-free.
|
|
1436
|
+
*/
|
|
1437
|
+
declare function submitWidgetToAgent(elements: InputElementLike[], config: RunSseConfig): Promise<Response>;
|
|
1438
|
+
|
|
1331
1439
|
/**
|
|
1332
1440
|
* TextAtom
|
|
1333
1441
|
* Renders standardized text styles from UISchema
|
|
@@ -1486,7 +1594,7 @@ declare const ToggleAtom: React__default.FC<ToggleAtomType & {
|
|
|
1486
1594
|
|
|
1487
1595
|
/**
|
|
1488
1596
|
* SliderAtom
|
|
1489
|
-
* Wraps shadcn Slider
|
|
1597
|
+
* Wraps shadcn Slider with optional label
|
|
1490
1598
|
*/
|
|
1491
1599
|
declare const SliderAtom: React__default.FC<SliderAtomType & {
|
|
1492
1600
|
onValueChange?: (value: number[]) => void;
|
|
@@ -1568,7 +1676,7 @@ declare const VideoAtom: React__default.FC<VideoAtomType>;
|
|
|
1568
1676
|
|
|
1569
1677
|
/**
|
|
1570
1678
|
* RatingAtom
|
|
1571
|
-
* A star rating component for display or user input.
|
|
1679
|
+
* A star rating component for display or user input, with optional label.
|
|
1572
1680
|
*/
|
|
1573
1681
|
declare const RatingAtom: React__default.FC<RatingAtomType & {
|
|
1574
1682
|
onChange?: (val: number) => void;
|
|
@@ -2187,6 +2295,79 @@ interface ConfirmationCardProps {
|
|
|
2187
2295
|
*/
|
|
2188
2296
|
declare const ConfirmationCard: React__default.NamedExoticComponent<ConfirmationCardProps>;
|
|
2189
2297
|
|
|
2298
|
+
type InputWidgetFieldKind = "text" | "email" | "password" | "number" | "search" | "tel" | "url" | "textarea" | "select" | "checkbox" | "switch" | "slider" | "radio" | "rating" | "date" | "time" | "datetime-local" | "color" | "file" | "otp";
|
|
2299
|
+
interface InputWidgetField {
|
|
2300
|
+
/** Stable key for this field — used as the answer key in Q/A submission. */
|
|
2301
|
+
key: string;
|
|
2302
|
+
/** Visible label rendered above the input. */
|
|
2303
|
+
label: string;
|
|
2304
|
+
/** Question used as the "Q:" line when serializing for the agent. Falls back to `label`. */
|
|
2305
|
+
question?: string;
|
|
2306
|
+
kind: InputWidgetFieldKind;
|
|
2307
|
+
placeholder?: string;
|
|
2308
|
+
defaultValue?: any;
|
|
2309
|
+
required?: boolean;
|
|
2310
|
+
disabled?: boolean;
|
|
2311
|
+
options?: Array<{
|
|
2312
|
+
label: string;
|
|
2313
|
+
value: string;
|
|
2314
|
+
}>;
|
|
2315
|
+
min?: number;
|
|
2316
|
+
max?: number;
|
|
2317
|
+
step?: number;
|
|
2318
|
+
/** OTP length, slider step config, etc. */
|
|
2319
|
+
config?: Record<string, any>;
|
|
2320
|
+
}
|
|
2321
|
+
interface InputWidgetType {
|
|
2322
|
+
id: string;
|
|
2323
|
+
type: "input-widget";
|
|
2324
|
+
/** Heading shown above the field (optional — falls back to field label). */
|
|
2325
|
+
title?: string;
|
|
2326
|
+
/** Description / helper text shown under the title (optional). */
|
|
2327
|
+
description?: string;
|
|
2328
|
+
/** The fields that make up this input widget — at least one is required. */
|
|
2329
|
+
fields: InputWidgetField[];
|
|
2330
|
+
/** Submit button config — auto-included with action: "submit" by default. */
|
|
2331
|
+
submitButton?: {
|
|
2332
|
+
label?: string;
|
|
2333
|
+
action: ButtonAction | string;
|
|
2334
|
+
actionPayload?: Record<string, any>;
|
|
2335
|
+
variant?: "default" | "purple" | "gradient" | "outline" | "secondary";
|
|
2336
|
+
};
|
|
2337
|
+
/** Optional secondary button (cancel/reset/back). */
|
|
2338
|
+
secondaryButton?: {
|
|
2339
|
+
label?: string;
|
|
2340
|
+
action: ButtonAction | string;
|
|
2341
|
+
};
|
|
2342
|
+
className?: string;
|
|
2343
|
+
style?: React.CSSProperties;
|
|
2344
|
+
}
|
|
2345
|
+
|
|
2346
|
+
interface InputWidgetProps extends InputWidgetType {
|
|
2347
|
+
/**
|
|
2348
|
+
* Called when the submit button is pressed.
|
|
2349
|
+
* Receives the formatted Q/A message string AND the structured field list.
|
|
2350
|
+
* Caller wires this to a Run SSE sendMessage handler.
|
|
2351
|
+
*/
|
|
2352
|
+
onSubmit?: (qaMessage: string, fields: CollectedField[]) => void;
|
|
2353
|
+
/** Called for any non-submit button action (cancel, reset, custom). */
|
|
2354
|
+
onAction?: (action: string, payload?: Record<string, any>) => void;
|
|
2355
|
+
isSubmitting?: boolean;
|
|
2356
|
+
}
|
|
2357
|
+
/**
|
|
2358
|
+
* InputWidget
|
|
2359
|
+
*
|
|
2360
|
+
* A self-contained input molecule that *guarantees*:
|
|
2361
|
+
* 1. Every field has a label (no headless inputs)
|
|
2362
|
+
* 2. A submit button is always rendered
|
|
2363
|
+
* 3. On submit, all field values are formatted as Q/A pairs and handed
|
|
2364
|
+
* back to the caller for transmission via Run SSE.
|
|
2365
|
+
*
|
|
2366
|
+
* This is the canonical wrapper for any user-facing input widget built in
|
|
2367
|
+
* the widget builder.
|
|
2368
|
+
*/
|
|
2369
|
+
declare const InputWidget: React__default.FC<InputWidgetProps>;
|
|
2370
|
+
|
|
2190
2371
|
interface CampaignSeedCardProps extends Omit<FormCardProps, "fields"> {
|
|
2191
2372
|
/**
|
|
2192
2373
|
* Status of the selection (done by user or agent)
|
|
@@ -2666,4 +2847,4 @@ declare function CreatorImageList({ creatorImages, creatorLength, isAgentOutput,
|
|
|
2666
2847
|
|
|
2667
2848
|
declare function CreatorProgressBar({ statusDetails, timeRemaining: _timeRemaining, }: CreatorProgressBarProps): react_jsx_runtime.JSX.Element;
|
|
2668
2849
|
|
|
2669
|
-
export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, type BranchCI, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, type ChartDataPoint, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmationCard, type ConfirmationCardMolecule, type ConfirmationCardProps, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, type CreatorDetailData, CreatorExpandedPanel, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchCreatorDetailsParams, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GitHubConnectCard, type GitHubConnectCardProps, type GitHubConnectMolecule, GitHubIssueTrackerCard, type GitHubIssueTrackerCardProps, type GitHubIssueTrackerMolecule, GitHubRepoHealthCard, type GitHubRepoHealthCardProps, type GitHubRepoHealthMolecule, GitHubReposListCard, type GitHubReposListCardProps, GoogleSheetsCard, type GoogleSheetsCardProps, GoogleSheetsConnectCard, type GoogleSheetsConnectCardProps, GoogleSheetsListCard, type GoogleSheetsListCardProps, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, type PullRequest, REGISTERED_COMPONENTS, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, RecommendationCard, type RecommendationCardMolecule, type RecommendationCardProps, type RepoItem, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, type SheetColumn, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetRow, type SheetTabItem, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, type SocialPost, SocialPostCard, type SocialPostCardProps, type SocialPostMolecule, Spinner, SpinnerAtom, type SpinnerAtomType, type SpreadsheetItem, type StaleIssue, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, cn, defaultFetchSelections, defaultPersistSelection, generateFieldsFromData, generateFieldsFromPropDefinitions, useCreatorWidgetPolling };
|
|
2850
|
+
export { Accordion, AccordionAtom, type AccordionAtomType, AccordionContent, AccordionItem, AccordionTrigger, ActionButton, type ActionButtonAtom, type ActionButtonProps, Alert, AlertAtom, type AlertAtomType, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogAtom, type AlertDialogAtomType, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, ArrowToggleAtom, type ArrowToggleAtomType, AspectRatio, AspectRatioAtom, type AspectRatioAtomType, AudienceDemographicsCard, type AudienceDemographicsCardMolecule, AudienceMetricCard, type AudienceMetricCardMolecule, Avatar, AvatarAtom, type AvatarAtomType, AvatarFallback, AvatarImage, Badge, BadgeAtom, type BadgeAtomType, type BaseAtom, type BaseMolecule, type BranchCI, BrandAffinityGroup, type BrandAffinityGroupMolecule, Breadcrumb, BreadcrumbAtom, type BreadcrumbAtomType, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, type ButtonAction, ButtonAtom, type ButtonAtomType, type ButtonSize$1 as ButtonSize, type ButtonVariant$1 as ButtonVariant, Calendar, CalendarAtom, type CalendarAtomType, CampaignConceptCard, type CampaignConceptCardProps, CampaignSeedCard, type CampaignSeedCardAtom, type CampaignSeedCardProps, Card, CardAtom, type CardAtomType, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselAtom, type CarouselAtomType, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartAtom, type ChartAtomType, type ChartDataPoint, Checkbox, CheckboxAtom, type CheckboxAtomType, Collapsible, CollapsibleAtom, type CollapsibleAtomType, CollapsibleContent, CollapsibleTrigger, type CollectedField, Command, CommandAtom, type CommandAtomType, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ConfirmationCard, type ConfirmationCardMolecule, type ConfirmationCardProps, ContentPreviewGallery, type ContentPreviewGalleryMolecule, ContextMenu, ContextMenuAtom, type ContextMenuAtomType, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuItem, ContextMenuLabel, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuTrigger, CountrySelectDisplay, CountrySelectEdit, CreatorActionHeader, type CreatorActionHeaderMolecule, CreatorCompactView, type CreatorCompactViewProps, type CreatorDetailData, CreatorExpandedPanel, CreatorGridCard, type CreatorGridCardMolecule, CreatorImageList, type CreatorImageListProps, CreatorProfileSummary, type CreatorProfileSummaryMolecule, CreatorProgressBar, type CreatorProgressBarProps, CreatorSearch, type CreatorSearchProps, type CreatorVersionData, CreatorWidget, type CreatorWidgetAction, type CreatorWidgetMolecule, type CreatorWidgetProps, CreatorWidgetSkeleton, type CreatorWidgetStatus, DataGrid, type DataGridMolecule, Dialog, DialogAtom, type DialogAtomType, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerAtom, type DrawerAtomType, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuAtom, type DropdownMenuAtomType, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuTrigger, EditableField, type EditableFieldProps, EmptyState, type EmptyStateMolecule, type FetchCreatorDetailsParams, type FetchStatusParams, type FetchVersionsParams, FileUpload, type FileUploadMolecule, FilterBar, type FilterBarMolecule, Form, FormCard, type FormCardProps, FormControl, FormDescription, FormField, FormInputAtom, type FormInputAtomType, FormItem, FormLabel, FormMessage, FormSelectAtom, type FormSelectAtomType, FormTextareaAtom, type FormTextareaAtomType, type GapSize, GitHubConnectCard, type GitHubConnectCardProps, type GitHubConnectMolecule, GitHubIssueTrackerCard, type GitHubIssueTrackerCardProps, type GitHubIssueTrackerMolecule, GitHubRepoHealthCard, type GitHubRepoHealthCardProps, type GitHubRepoHealthMolecule, GitHubReposListCard, type GitHubReposListCardProps, GoogleSheetsCard, type GoogleSheetsCardProps, GoogleSheetsConnectCard, type GoogleSheetsConnectCardProps, GoogleSheetsListCard, type GoogleSheetsListCardProps, GrowthChartCard, type GrowthChartCardMolecule, HoverCard, HoverCardContent, HoverCardTrigger, IconAtom, type IconAtomType, type IconName, Input, InputAtom, type InputAtomType, type InputElementLike, InputOTP, InputOTPAtom, type InputOTPAtomType, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputType, InputWidget, type InputWidgetField, type InputWidgetFieldKind, type InputWidgetType, KbdAtom, type KbdAtomType, KeywordBundlesDisplay, KeywordBundlesEdit, Label, LabelAtom, type LabelAtomType, LayoutAtom, type LayoutAtomType, type LayoutDirection, LoadingOverlay, type LoadingOverlayMolecule, MCQCard, type MCQCardAtom, type MCQCardProps, type MCQOption, Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarLabel, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NotificationList, type NotificationListMolecule, PXEngineRenderer, Pagination, PaginationAtom, type PaginationAtomType, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PlatformIconGroup, type PlatformIconGroupMolecule, PlatformSelectDisplay, PlatformSelectEdit, type PollingConfig, Popover, PopoverAtom, type PopoverAtomType, PopoverContent, PopoverTrigger, Progress, ProgressAtom, type ProgressAtomType, type PullRequest, REGISTERED_COMPONENTS, RadioAtom, type RadioAtomType, RadioGroup, RadioGroupAtom, type RadioGroupAtomType, RadioGroupItem, RatingAtom, type RatingAtomType, RecommendationCard, type RecommendationCardMolecule, type RecommendationCardProps, type RepoItem, ResizableAtom, type ResizableAtomType, ResizablePanel, ResizablePanelGroup, type RunSseConfig, ScrollArea, ScrollAreaAtom, type ScrollAreaAtomType, ScrollBar, SearchSpecCard, type SearchSpecCardAtom, type SearchSpecCardProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, SeparatorAtom, type SeparatorAtomType, Sheet, SheetAtom, type SheetAtomType, SheetClose, type SheetColumn, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetRow, type SheetTabItem, SheetTitle, SheetTrigger, Skeleton, SkeletonAtom, type SkeletonAtomType, Slider, SliderAtom, type SliderAtomType, type SocialPost, SocialPostCard, type SocialPostCardProps, type SocialPostMolecule, Spinner, SpinnerAtom, type SpinnerAtomType, type SpreadsheetItem, type StaleIssue, StatsGrid, type StatsGridMolecule, type StatusDetails, StepWizard, type StepWizardMolecule, Switch, SwitchAtom, type SwitchAtomType, Table, TableAtom, type TableAtomType, TableBody, TableCaption, TableCell, TableHead, TableHeader, TableRow, Tabs, TabsAtom, type TabsAtomType, TabsContent, TabsList, TabsTrigger, TagCloud, type TagCloudMolecule, TextAtom, type TextAtomType, type TextVariant, Textarea, TextareaAtom, TimelineAtom, type TimelineAtomType, ToggleAtom, type ToggleAtomType, Tooltip, TooltipAtom, type TooltipAtomType, TooltipContent, TooltipProvider, TooltipTrigger, TopPostsGrid, type TopPostsGridMolecule, type UIAtom, type UIComponent, type UIMolecule, type UISchema, VideoAtom, type VideoAtomType, cn, defaultFetchSelections, defaultPersistSelection, elementToQAField, formatQAMessage, generateFieldsFromData, generateFieldsFromPropDefinitions, isInputAtom, submitWidgetToAgent, useCreatorWidgetPolling };
|