@polymorfa/react 0.1.0-dev.20260922094209

package/dist/components.d.ts

@@ -0,0 +1,109 @@
+import { type ConversationController, type ConversationMessage, type MessageAttachment, type MessageComposerController, type RenderedTemplate, type TemplateBuilderController } from "@polymorfa/browser";
+import { type QuickReplyOption, type ChatIconName, type ComponentSlot, type MessageKey, type SlotClassNames } from "@polymorfa/ui";
+import { type CSSProperties, type ReactNode } from "react";
+import { usePolymorfa } from "./context.js";
+type ControllerProps<T> = {
+    readonly controller?: T;
+    readonly createController?: () => T;
+};
+type Configuration = ReturnType<typeof usePolymorfa>;
+interface SlotProps {
+    readonly className: string;
+    readonly style?: CSSProperties;
+    readonly "data-slot": ComponentSlot;
+}
+export type Slots = (slot: ComponentSlot, base: string) => SlotProps;
+/** Slot resolver that keeps its identity while the inputs are unchanged. */
+export declare function useSlots(classNames: SlotClassNames | undefined): Slots;
+/** Root props: theme classes, direction, CSS variables, and the slot. */
+export declare function useShell(slots: Slots, slot: ComponentSlot, base: string, className: string | undefined): {
+    readonly dir: "ltr" | "rtl";
+    readonly className: string;
+    readonly style: CSSProperties;
+    readonly "data-slot": ComponentSlot;
+};
+export declare function text(configuration: Configuration, key: MessageKey, values?: Readonly<Record<string, string>>): string;
+export declare function Icon({ name, className, }: {
+    readonly name: ChatIconName;
+    readonly className?: string;
+}): import("react").JSX.Element;
+export type RenderAttachment = (attachment: MessageAttachment, message: ConversationMessage) => ReactNode;
+interface ConversationViewProps {
+    readonly renderMessage?: (message: ConversationMessage) => ReactNode;
+    readonly renderAttachment?: RenderAttachment;
+    /** Show a Reply action on each message. */
+    readonly onReply?: (message: ConversationMessage) => void;
+}
+export interface MessageListProps extends ControllerProps<ConversationController>, ConversationViewProps {
+    readonly className?: string;
+    readonly classNames?: SlotClassNames;
+}
+export declare function MessageList({ controller, createController, className, classNames, ...viewProps }: MessageListProps): import("react").JSX.Element;
+export interface ComposeBoxProps extends ControllerProps<MessageComposerController> {
+    readonly onSent?: () => void;
+    readonly className?: string;
+    readonly classNames?: SlotClassNames;
+    /**
+     * Offer file attachments: the attach button, drop and paste. Defaults to
+     * `true`. Turn it off when the composer's actions have no upload adapter.
+     */
+    readonly attachments?: boolean;
+    /** File types the attach button offers, as for `<input accept>`. */
+    readonly accept?: string;
+    /** Allow picking several files at once. Defaults to `true`. */
+    readonly multiple?: boolean;
+    /** Resolves the reply banner's quoted message. */
+    readonly conversation?: ConversationController;
+    /** Resolves the reply banner's quoted message without a controller. */
+    readonly messages?: readonly ConversationMessage[];
+    /** Replaces the locale's `composer.placeholder`. */
+    readonly placeholder?: string;
+    /** Rendered in the toolbar before the built-in buttons. */
+    readonly startActions?: ReactNode;
+    /** Rendered after the message field, before the send or mic button. */
+    readonly endActions?: ReactNode;
+    /** Show the emoji picker button. Defaults to `true`. */
+    readonly emoji?: boolean;
+    /**
+     * Show the voice note button. Defaults to `true` where the browser has
+     * `MediaRecorder` and `getUserMedia`.
+     */
+    readonly voiceNotes?: boolean;
+    /** Send a voice note as soon as it finishes uploading. Defaults to `true`. */
+    readonly voiceNoteAutoSend?: boolean;
+    /** Options for the "/" quick reply menu. */
+    readonly quickReplies?: readonly QuickReplyOption[];
+    /** Called after a quick reply's text is inserted. */
+    readonly onQuickReply?: (option: QuickReplyOption) => void;
+    /** Rows the message field grows to before it scrolls. Defaults to 8. */
+    readonly maxRows?: number;
+}
+export declare function ComposeBox({ controller, createController, onSent, className, classNames, attachments, accept, multiple, conversation, messages, placeholder, startActions, endActions, emoji, voiceNotes, voiceNoteAutoSend, quickReplies, onQuickReply, maxRows, }: ComposeBoxProps): import("react").JSX.Element;
+export interface ChatDrawerProps extends MessageListProps {
+    readonly open?: boolean;
+    readonly onClose?: () => void;
+    /** Custom footer; takes precedence over the built-in composer. */
+    readonly composer?: ReactNode;
+    readonly title?: string;
+    /** Alias of `controller`. */
+    readonly conversation?: ConversationController;
+    /** Renders the built-in composer and wires message Reply to it. */
+    readonly composerController?: MessageComposerController;
+    readonly createComposerController?: () => MessageComposerController;
+    /**
+     * Move focus into the drawer when it first mounts open. Defaults to
+     * `false`; focus always moves when `open` changes to `true`.
+     */
+    readonly autoFocus?: boolean;
+    /** Props for the built-in composer. */
+    readonly composerProps?: Omit<ComposeBoxProps, "controller" | "createController" | "conversation">;
+}
+export declare function ChatDrawer({ open, onClose, composer, title, className, classNames, conversation, controller, createController, composerController, createComposerController, composerProps, onReply, autoFocus, ...viewProps }: ChatDrawerProps): import("react").JSX.Element | null;
+export interface TemplateBuilderProps extends ControllerProps<TemplateBuilderController> {
+    readonly renderPreview?: (preview: RenderedTemplate) => ReactNode;
+    readonly className?: string;
+    readonly classNames?: SlotClassNames;
+}
+export declare function TemplateBuilder({ controller, createController, renderPreview, className, classNames, }: TemplateBuilderProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.tsx"],"names":[],"mappings":"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"}