chatkit-bun 0.0.2

package/types/widgets/components.d.ts

@@ -0,0 +1,144 @@
+import type { ActionConfig } from "../actions";
+import type { DynamicWidgetComponent, DynamicWidgetRoot, WidgetJson } from "./types";
+type ActionConfigInput = {
+    type: ActionConfig["type"];
+    payload?: WidgetJson;
+    handler?: ActionConfig["handler"];
+    loadingBehavior?: ActionConfig["loadingBehavior"];
+    streaming?: ActionConfig["streaming"];
+    [key: string]: WidgetJson | undefined;
+};
+type WidgetPropValue = WidgetJson | ActionConfigInput | DynamicWidgetComponent | DynamicWidgetComponent[] | undefined;
+type WidgetProps = Record<string, WidgetPropValue>;
+type Children = DynamicWidgetComponent[];
+type SingleChild = DynamicWidgetComponent;
+export type BasicProps = WidgetProps & {
+    children?: Children;
+};
+export declare function Basic(props?: BasicProps): DynamicWidgetRoot;
+export type CardProps = WidgetProps & {
+    children: Children;
+    asForm?: boolean;
+    confirm?: WidgetJson;
+    cancel?: WidgetJson;
+};
+export declare function Card(props: CardProps): DynamicWidgetRoot;
+export type ListViewProps = WidgetProps & {
+    children: DynamicWidgetComponent[];
+};
+export declare function ListView(props: ListViewProps): DynamicWidgetRoot;
+export type ListViewItemProps = WidgetProps & {
+    children: Children;
+    onClickAction?: ActionConfigInput;
+};
+export declare function ListViewItem(props: ListViewItemProps): DynamicWidgetComponent;
+export type TextProps = WidgetProps & {
+    value: string;
+    streaming?: boolean;
+};
+export type TextWidget = {
+    type: "Text";
+} & TextProps;
+export declare function Text(props: TextProps): TextWidget;
+export type MarkdownProps = WidgetProps & {
+    value: string;
+    streaming?: boolean;
+};
+export type MarkdownWidget = {
+    type: "Markdown";
+} & MarkdownProps;
+export declare function Markdown(props: MarkdownProps): MarkdownWidget;
+export type TitleProps = WidgetProps & {
+    value: string;
+};
+export declare function Title(props: TitleProps): DynamicWidgetComponent;
+export type CaptionProps = WidgetProps & {
+    value: string;
+};
+export declare function Caption(props: CaptionProps): DynamicWidgetComponent;
+export type BadgeProps = WidgetProps & {
+    label: string;
+};
+export declare function Badge(props: BadgeProps): DynamicWidgetComponent;
+export type BoxProps = WidgetProps & {
+    children?: Children;
+};
+export declare function Box(props?: BoxProps): DynamicWidgetComponent;
+export type RowProps = WidgetProps & {
+    children?: Children;
+};
+export declare function Row(props?: RowProps): DynamicWidgetComponent;
+export type ColProps = WidgetProps & {
+    children?: Children;
+};
+export declare function Col(props?: ColProps): DynamicWidgetComponent;
+export type FormProps = WidgetProps & {
+    children?: Children;
+    onSubmitAction?: ActionConfigInput;
+};
+export declare function Form(props?: FormProps): DynamicWidgetComponent;
+export declare function Divider(props?: WidgetProps): DynamicWidgetComponent;
+export type IconProps = WidgetProps & {
+    name: string;
+};
+export declare function Icon(props: IconProps): DynamicWidgetComponent;
+export type ImageProps = WidgetProps & {
+    src: string;
+    alt?: string;
+};
+export declare function Image(props: ImageProps): DynamicWidgetComponent;
+export type ButtonProps = WidgetProps & {
+    label?: string;
+    onClickAction?: ActionConfigInput;
+};
+export declare function Button(props?: ButtonProps): DynamicWidgetComponent;
+export declare function Spacer(props?: WidgetProps): DynamicWidgetComponent;
+export type SelectProps = WidgetProps & {
+    name: string;
+    options: WidgetJson[];
+};
+export declare function Select(props: SelectProps): DynamicWidgetComponent;
+export type DatePickerProps = WidgetProps & {
+    name: string;
+};
+export declare function DatePicker(props: DatePickerProps): DynamicWidgetComponent;
+export type CheckboxProps = WidgetProps & {
+    name: string;
+    label?: string;
+};
+export declare function Checkbox(props: CheckboxProps): DynamicWidgetComponent;
+export type InputProps = WidgetProps & {
+    name: string;
+};
+export declare function Input(props: InputProps): DynamicWidgetComponent;
+export type LabelProps = WidgetProps & {
+    value: string;
+    fieldName: string;
+};
+export declare function Label(props: LabelProps): DynamicWidgetComponent;
+export type RadioGroupProps = WidgetProps & {
+    name: string;
+    options?: WidgetJson[];
+};
+export declare function RadioGroup(props: RadioGroupProps): DynamicWidgetComponent;
+export type TextareaProps = WidgetProps & {
+    name: string;
+};
+export declare function Textarea(props: TextareaProps): DynamicWidgetComponent;
+export type TransitionProps = WidgetProps & {
+    children: SingleChild;
+};
+export declare function Transition(props: TransitionProps): DynamicWidgetComponent;
+export type ChartProps = WidgetProps & {
+    data: WidgetJson[];
+    series: WidgetJson[];
+    xAxis: string;
+    showYAxis?: boolean;
+    showLegend?: boolean;
+    showTooltip?: boolean;
+    barGap?: string | number;
+    barCategoryGap?: string | number;
+    flex?: string | number;
+};
+export declare function Chart(props: ChartProps): DynamicWidgetComponent;
+export {};

package/types/widgets/diff.d.ts

@@ -0,0 +1,7 @@
+import type { ThreadItemUpdate } from "../types/server";
+import type { WidgetRoot } from "./types";
+type WidgetDiffUpdate = Extract<ThreadItemUpdate, {
+    type: "widget.root.updated" | "widget.streaming_text.value_delta";
+}>;
+export declare function diffWidget(before: WidgetRoot, after: WidgetRoot): WidgetDiffUpdate[];
+export {};

package/types/widgets/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./components";
+export * from "./diff";
+export * from "./serialization";
+export * from "./stream";
+export * from "./template";
+export * from "./types";

package/types/widgets/serialization.d.ts

@@ -0,0 +1,2 @@
+import { type WidgetRoot } from "./types";
+export declare function serializeWidget(widget: WidgetRoot): Record<string, unknown>;

package/types/widgets/stream.d.ts

@@ -0,0 +1,10 @@
+import type { StoreItemType } from "../store";
+import type { ThreadMetadata } from "../types/core";
+import type { ThreadStreamEvent } from "../types/server";
+import type { WidgetRoot } from "./types";
+export interface StreamWidgetOptions {
+    copyText?: string | null;
+    generateId?: (itemType: StoreItemType) => string;
+    now?: () => string;
+}
+export declare function streamWidget(thread: ThreadMetadata, widgetOrAsyncIterable: WidgetRoot | AsyncIterable<WidgetRoot>, options?: StreamWidgetOptions): AsyncIterable<ThreadStreamEvent>;

package/types/widgets/template.d.ts

@@ -0,0 +1,19 @@
+import { type BasicRoot, type DynamicWidgetRoot } from "./types";
+export interface WidgetTemplateDefinition {
+    version: string;
+    name: string;
+    template: string;
+    dataSchema?: Record<string, unknown>;
+    jsonSchema?: Record<string, unknown>;
+}
+export declare class WidgetTemplate {
+    readonly version: string;
+    readonly name: string;
+    readonly template: string;
+    readonly dataSchema: Record<string, unknown>;
+    readonly jsonSchema?: Record<string, unknown>;
+    constructor(definition: WidgetTemplateDefinition);
+    static fromFile(path: string): Promise<WidgetTemplate>;
+    build(data?: unknown): DynamicWidgetRoot;
+    buildBasic(data?: unknown): BasicRoot;
+}

package/types/widgets/types.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export type WidgetPrimitive = string | number | boolean | null;
+export type WidgetJson = WidgetPrimitive | WidgetJson[] | {
+    [key: string]: WidgetJson | undefined;
+};
+export type DynamicWidgetComponent = {
+    type: string;
+    key?: string;
+    id?: string;
+    children?: DynamicWidgetComponent | DynamicWidgetComponent[];
+    [key: string]: WidgetJson | DynamicWidgetComponent | DynamicWidgetComponent[] | undefined;
+};
+export type BasicRoot = DynamicWidgetComponent & {
+    type: "Basic";
+};
+export type DynamicWidgetRoot = DynamicWidgetComponent & {
+    type: "Card" | "ListView" | "Basic";
+};
+export declare const WidgetJsonSchema: z.ZodType<WidgetJson>;
+export declare const DynamicWidgetComponentSchema: z.ZodType<DynamicWidgetComponent>;
+export declare const BasicRootSchema: z.ZodType<BasicRoot>;
+export declare const DynamicWidgetRootSchema: z.ZodType<DynamicWidgetRoot>;
+export type WidgetComponent = DynamicWidgetComponent;
+export type WidgetRoot = DynamicWidgetRoot;