@superxd-studio/adptr 0.5.0

package/types/components/icons.d.ts

@@ -0,0 +1,138 @@
+import type { SVGProps } from "react";
+export type IconProps = Omit<SVGProps<SVGSVGElement>, "children">;
+export declare const IconClock: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconVideo: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconGlobe: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconCalendar: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconCalendarPlus: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconGrid: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconColumns: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconChevronLeft: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconChevronRight: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconChevronDown: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconArrowUp: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconDownload: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconArrowDown: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconSquare: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconCopy: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconEdit: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconCheck: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconX: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconPaperclip: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconFile: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconArrowLeft: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconInfo: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconAlert: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconCircleCheck: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconCircleAlert: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconHourglass: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconMapPin: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconSearch: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconRotate: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconUser: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconMail: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconPlus: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconSun: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};
+export declare const IconMoon: {
+    ({ className, ...props }: IconProps): import("react").JSX.Element;
+    displayName: string;
+};

package/types/components/responsive-overlay.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode, type RefObject } from "react";
+/** Shared by anchored content and its read-only canvas presentation. */
+export declare const overlaySurfaceClassName = "flex min-h-0 flex-col overflow-hidden bg-surface text-fg shadow-dialog";
+export interface ResponsiveOverlayProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    triggerRef: RefObject<HTMLElement | null>;
+    "aria-label": string;
+    /** Keep an in-flight mutation visible until the adapter reports its result. */
+    isDismissDisabled?: boolean;
+    children: ReactNode;
+    className?: string;
+}
+/** The same contextual content, anchored on desktop and in a bottom drawer on phones. */
+export declare function ResponsiveOverlay({ isOpen, onOpenChange, triggerRef, "aria-label": label, isDismissDisabled, children, className, }: ResponsiveOverlayProps): import("react").JSX.Element;

package/types/components/scenario-picker/copy.d.ts

@@ -0,0 +1,5 @@
+export declare const scenarioPickerCopy: {
+    readonly label: "Scenario";
+    readonly search: "Search scenarios";
+    readonly empty: "No matching scenarios.";
+};

package/types/components/scenario-picker/index.d.ts

@@ -0,0 +1,14 @@
+export interface ScenarioOption<K extends string> {
+    id: K;
+    label: string;
+    description: string;
+    isDisabled?: boolean;
+}
+/** Chooses demo conditions. The demo owner controls resetting and request cleanup. */
+export declare function ScenarioPicker<K extends string>({ label, value, onChange, options, isDisabled, }: {
+    label: string;
+    value: K;
+    onChange: (value: K) => void;
+    options: ScenarioOption<K>[];
+    isDisabled?: boolean;
+}): import("react").JSX.Element;

package/types/components/scroll-area.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+export interface ScrollAreaProps {
+    children: ReactNode;
+    className?: string;
+    /** Label for keyboard users when the area scrolls (it becomes focusable). */
+    label?: string;
+    /** Scroll to this position (in pixels) when it first appears or changes. */
+    scrollTo?: number;
+}
+/**
+ * A scrolling box whose edges fade when there's more to see, so a list cut
+ * off by the edge reads as "keep scrolling" rather than "broken".
+ */
+export declare function ScrollArea({ children, className, label, scrollTo }: ScrollAreaProps): import("react").JSX.Element;

package/types/components/search-picker.d.ts

@@ -0,0 +1,27 @@
+import type { ReactNode } from "react";
+export interface PickerItem {
+    id: string;
+    /** What's shown and searched. */
+    label: string;
+    /** A quieter second line or right-hand detail, also searched. */
+    detail?: string;
+    /** Extra words to match when searching (not shown). */
+    keywords?: string;
+}
+export interface SearchPickerProps {
+    /** What's being chosen, for screen readers ("Time zone"). */
+    label: string;
+    items: PickerItem[];
+    value: string;
+    onChange: (id: string) => void;
+    /** The content of the trigger button. */
+    trigger: ReactNode;
+    searchPlaceholder?: string;
+    emptyMessage?: string;
+    triggerClassName?: string;
+}
+/**
+ * A button that opens a searchable list, for long lists like time zones.
+ * Typing filters the list; arrow keys and Enter choose; Escape closes.
+ */
+export declare function SearchPicker({ label, items, value, onChange, trigger, searchPlaceholder, emptyMessage, triggerClassName, }: SearchPickerProps): import("react").JSX.Element;

package/types/components/segmented-control.d.ts

@@ -0,0 +1,23 @@
+import { type ReactNode } from "react";
+export interface SegmentedOption<K extends string> {
+    id: K;
+    label: ReactNode;
+    icon?: ReactNode;
+    /** Required when the label is only an icon. */
+    "aria-label"?: string;
+    isDisabled?: boolean;
+}
+export interface SegmentedControlProps<K extends string> {
+    /** What the choice is about, for screen readers ("Meeting length"). */
+    label: string;
+    options: SegmentedOption<K>[];
+    value: K;
+    onChange: (value: K) => void;
+    size?: "sm" | "md";
+    className?: string;
+}
+/**
+ * One choice from a few options, shown side by side: 12h or 24h, 15, 30 or
+ * 60 minutes, month, week or columns. Arrow keys move between options.
+ */
+export declare function SegmentedControl<K extends string>({ label, options, value, onChange, size, className, }: SegmentedControlProps<K>): import("react").JSX.Element;

package/types/components/skeleton.d.ts

@@ -0,0 +1,4 @@
+/** A placeholder shape while content loads. Hidden from screen readers. */
+export declare function Skeleton({ className }: {
+    className?: string;
+}): import("react").JSX.Element;

package/types/components/spinner.d.ts

@@ -0,0 +1,4 @@
+/** Three staggered dots. Decorative: announce progress with words nearby. */
+export declare function Spinner({ className }: {
+    className?: string;
+}): import("react").JSX.Element;

package/types/components/superxd-arrow.d.ts

@@ -0,0 +1,5 @@
+export declare const sxdArrowPath = "M5 12h14m-6-6 6 6-6 6";
+/** The same SuperXD arrow used by the site chrome, without importing the rest of the chrome. */
+export declare function SxdArrow({ className }: {
+    className?: string;
+}): import("react").JSX.Element;

package/types/components/switch.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from "react";
+import { type SwitchProps as AriaSwitchProps } from "react-aria-components";
+export interface SwitchProps extends Omit<AriaSwitchProps, "children"> {
+    label: ReactNode;
+    description?: ReactNode;
+}
+/** An immediately applied on/off setting, with a persistent label in both positions. */
+export declare function Switch({ label, description, className, ...props }: SwitchProps): import("react").JSX.Element;

package/types/components/text-field.d.ts

@@ -0,0 +1,19 @@
+import type { ReactNode } from "react";
+import { type TextFieldProps as AriaTextFieldProps } from "react-aria-components";
+export interface TextFieldProps extends Omit<AriaTextFieldProps, "children"> {
+    label: ReactNode;
+    description?: ReactNode;
+    /** The problem with the current value. Shows the field as invalid when set. */
+    error?: ReactNode;
+    placeholder?: string;
+    /** Adds "(optional)" after the label. Required fields stay unmarked. */
+    optional?: boolean;
+    multiline?: boolean;
+    rows?: number;
+    inputClassName?: string;
+}
+/**
+ * A labelled text box with an optional description and an error message.
+ * The error is linked to the input for screen readers.
+ */
+export declare function TextField({ label, description, error, placeholder, optional, multiline, rows, className, inputClassName, ...props }: TextFieldProps): import("react").JSX.Element;

package/types/components/thinking.d.ts

@@ -0,0 +1,8 @@
+/**
+ * SuperXD's thinking mark: a 3×3 pixel matrix lighting in a spiral, for waits of unknown
+ * length (an AI preparing an answer). About the height of a line of text. Decorative: say
+ * what's happening in words beside it.
+ */
+export declare function Thinking({ className }: {
+    className?: string;
+}): import("react").JSX.Element;

package/types/components/ui/copy.d.ts

@@ -0,0 +1,12 @@
+export declare const uiCopy: {
+    readonly choose: "Choose an option";
+    readonly empty: "No options available.";
+    readonly close: "Close";
+    readonly previous: "Previous page";
+    readonly next: "Next page";
+    readonly page: (page: number, total: number) => string;
+    readonly sort: (label: string) => string;
+    readonly noRows: "No rows to show.";
+    readonly dismiss: "Dismiss notification";
+    readonly notifications: "Notifications";
+};

package/types/components/ui/display.d.ts

@@ -0,0 +1,50 @@
+import { type ReactNode, type HTMLAttributes } from "react";
+import { UNSTABLE_ToastQueue as ToastQueue, type ProgressBarProps, type SeparatorProps, type SortDescriptor, type Selection } from "react-aria-components";
+export declare function Card({ children, className, ...props }: HTMLAttributes<HTMLElement>): import("react").JSX.Element;
+export type BadgeTone = "neutral" | "info" | "success" | "attention" | "error";
+export declare function Badge({ children, tone }: {
+    children: ReactNode;
+    tone?: BadgeTone;
+}): import("react").JSX.Element;
+export declare function Progress({ label, className, ...props }: Omit<ProgressBarProps, "children"> & {
+    label: string;
+}): import("react").JSX.Element;
+export declare function Separator({ className, ...props }: SeparatorProps): import("react").JSX.Element;
+export declare function AspectRatio({ ratio, children, className, }: {
+    ratio?: number;
+    children: ReactNode;
+    className?: string;
+}): import("react").JSX.Element;
+export declare function KeyboardHint({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export interface DataColumn {
+    id: string;
+    label: string;
+    sortable?: boolean;
+    isRowHeader?: boolean;
+}
+export interface DataRow {
+    id: string;
+    values: Readonly<Record<string, string | number>>;
+}
+export declare function sortRows(rows: readonly DataRow[], sort?: SortDescriptor): DataRow[];
+/** Local sorting and selection. Server pagination and virtualisation belong to the host. */
+export declare function DataTable({ label, columns, rows, empty, selectionMode, selectedKeys, onSelectionChange, }: {
+    label: string;
+    columns: readonly DataColumn[];
+    rows: readonly DataRow[];
+    empty?: string;
+    selectionMode?: "none" | "single" | "multiple";
+    selectedKeys?: Selection;
+    onSelectionChange?: (keys: Selection) => void;
+}): import("react").JSX.Element;
+export interface Notification {
+    title: string;
+    description?: string;
+}
+export declare function createNotificationQueue(): ToastQueue<Notification>;
+export declare function ToastRegion({ queue, label, }: {
+    queue: ToastQueue<Notification>;
+    label?: string;
+}): import("react").JSX.Element;

package/types/components/ui/navigation.d.ts

@@ -0,0 +1,63 @@
+import type { ReactNode } from "react";
+import { type DisclosureGroupProps, type TabsProps, type TooltipTriggerComponentProps } from "react-aria-components";
+export interface MenuCommand {
+    id: string;
+    label: string;
+    description?: string;
+    isDisabled?: boolean;
+    isDestructive?: boolean;
+}
+export declare function Menu({ label, items, onAction, isDisabled, }: {
+    label: string;
+    items: readonly MenuCommand[];
+    onAction: (id: string) => void;
+    isDisabled?: boolean;
+}): import("react").JSX.Element;
+export interface DisclosureItem {
+    id: string;
+    title: string;
+    content: ReactNode;
+    isDisabled?: boolean;
+}
+export declare function Accordion({ label, items, className, ...props }: Omit<DisclosureGroupProps, "children"> & {
+    label: string;
+    items: readonly DisclosureItem[];
+}): import("react").JSX.Element;
+export interface ContentTab {
+    id: string;
+    label: string;
+    content: ReactNode;
+    isDisabled?: boolean;
+}
+export declare function Tabs({ label, items, className, ...props }: Omit<TabsProps, "children"> & {
+    label: string;
+    items: readonly ContentTab[];
+}): import("react").JSX.Element;
+export declare function Tooltip({ children, content, ...props }: Omit<TooltipTriggerComponentProps, "children"> & {
+    children: ReactNode;
+    content: ReactNode;
+}): import("react").JSX.Element;
+/** A labelled, controlled modal. The host can prevent dismissal while a mutation settles. */
+export declare function ModalDialog({ title, children, isOpen, onOpenChange, isDismissDisabled, trigger, }: {
+    title: string;
+    children: ReactNode;
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    isDismissDisabled?: boolean;
+    trigger: ReactNode;
+}): import("react").JSX.Element;
+export declare function Pagination({ label, page, total, onChange, isDisabled, }: {
+    label: string;
+    page: number;
+    total: number;
+    onChange: (page: number) => void;
+    isDisabled?: boolean;
+}): import("react").JSX.Element;
+export declare function Breadcrumbs({ label, items, }: {
+    label: string;
+    items: readonly {
+        id: string;
+        label: string;
+        href?: string;
+    }[];
+}): import("react").JSX.Element;

package/types/components/ui/portal-theme.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode, type CSSProperties } from "react";
+/** Portals leave scoped preview/host themes. Copy their computed variables at the trigger. */
+export declare function PortalTheme({ children, }: {
+    children: (theme: {
+        className: string;
+        style: CSSProperties;
+    }) => ReactNode;
+}): import("react").JSX.Element;

package/types/components/ui/selection.d.ts

@@ -0,0 +1,37 @@
+import { type ReactNode } from "react";
+import { type CheckboxProps, type CheckboxGroupProps, type RadioGroupProps, type SelectProps, type SliderProps, type ToggleButtonProps, type FormProps } from "react-aria-components";
+import { type TextFieldProps } from "../text-field";
+export interface Choice {
+    id: string;
+    label: string;
+    description?: string;
+    isDisabled?: boolean;
+}
+export declare function Checkbox({ label, description, className, ...props }: Omit<CheckboxProps, "children"> & {
+    label: ReactNode;
+    description?: ReactNode;
+}): import("react").JSX.Element;
+export declare function CheckboxGroup({ label, description, error, options, className, ...props }: Omit<CheckboxGroupProps, "children"> & {
+    label: ReactNode;
+    description?: ReactNode;
+    error?: ReactNode;
+    options: readonly Choice[];
+}): import("react").JSX.Element;
+export declare function RadioGroup({ label, description, error, options, className, ...props }: Omit<RadioGroupProps, "children"> & {
+    label: ReactNode;
+    description?: ReactNode;
+    error?: ReactNode;
+    options: readonly Choice[];
+}): import("react").JSX.Element;
+export declare function Select({ label, description, error, options, className, placeholder, ...props }: Omit<SelectProps<Choice>, "children" | "items"> & {
+    label: ReactNode;
+    description?: ReactNode;
+    error?: ReactNode;
+    options: readonly Choice[];
+}): import("react").JSX.Element;
+export declare function Slider({ label, className, ...props }: Omit<SliderProps, "children"> & {
+    label: ReactNode;
+}): import("react").JSX.Element;
+export declare function Toggle({ className, ...props }: ToggleButtonProps): import("react").JSX.Element;
+export declare function TextField(props: TextFieldProps): import("react").JSX.Element;
+export declare function Form({ className, children, validationBehavior, ...props }: FormProps): import("react").JSX.Element;

package/types/lib/cn.d.ts

@@ -0,0 +1,3 @@
+import { type ClassValue } from "clsx";
+/** Joins class names and resolves Tailwind conflicts (last one wins). */
+export declare function cn(...inputs: ClassValue[]): string;

package/types/reusable/ai-sdk/index.d.ts

@@ -0,0 +1,15 @@
+import { type ChatAdapter } from "../core/index.js";
+export interface AiSdkChatOptions {
+    endpoint: string;
+    /** Opt into editing, regeneration and versions. Restart is controlled separately by retry. */
+    conversationActions?: boolean;
+    /** Allow Restart as a new run. Defaults to true; disable for endpoints without replay safety. */
+    retry?: boolean;
+    /** Stable conversation identity; requestId remains a distinct per-run identifier. */
+    chatId?: string;
+    headers?: () => HeadersInit | Promise<HeadersInit>;
+    credentials?: RequestCredentials;
+    fetch?: typeof globalThis.fetch;
+}
+/** SDK owns protocol parsing only; SuperXD or the host owns the conversation. */
+export declare function createAiSdkChatAdapter(options: AiSdkChatOptions): ChatAdapter;

package/types/reusable/assistant-ui/index.d.ts

@@ -0,0 +1,12 @@
+import { type ReactNode } from "react";
+import { type ChatActions, type ChatAdapter, type ChatSnapshot } from "../core/index.js";
+/** Optional bridge. assistant-ui alone owns state; there is no mirrored controller. */
+type Projection = {
+    snapshot: ChatSnapshot;
+    actions: ChatActions;
+};
+export declare function AssistantChat({ adapter, children, }: {
+    adapter: ChatAdapter;
+    children: (chat: Projection) => ReactNode;
+}): import("react").JSX.Element;
+export {};

package/types/reusable/core/attachments.d.ts

@@ -0,0 +1,54 @@
+import { type ChatFile } from "./index.js";
+export interface UploadSource<Data> {
+    readonly id?: string;
+    readonly name: string;
+    readonly mediaType: string;
+    readonly size: number;
+    readonly data: Data;
+}
+export interface UploadAdapter<Data> {
+    upload(source: UploadSource<Data>, signal: AbortSignal): Promise<ChatFile>;
+    /** Release a removed draft file. Transferred transcript references must stay valid. */
+    release?(file: ChatFile): Promise<void>;
+}
+export interface UploadPolicy {
+    readonly maxFiles: number;
+    readonly maxBytes: number;
+    readonly mediaTypes: readonly string[];
+}
+export type AttachmentIssue = "type" | "size" | "count" | "failed";
+export interface AttachmentItem {
+    readonly id: string;
+    readonly name: string;
+    readonly mediaType: string;
+    readonly size: number;
+    readonly status: "uploading" | "ready" | "error" | "cancelled" | "rejected";
+    readonly file?: ChatFile;
+    readonly issue?: AttachmentIssue;
+}
+export interface AttachmentSnapshot {
+    readonly items: readonly AttachmentItem[];
+    readonly issue?: AttachmentIssue;
+}
+/** Upload state is separate from transcript state; no browser assumptions or second chat owner. */
+export declare class AttachmentController<Data> {
+    private readonly adapter;
+    readonly policy: UploadPolicy;
+    private readonly id;
+    private snapshot;
+    private readonly listeners;
+    private readonly sources;
+    private readonly active;
+    constructor(adapter: UploadAdapter<Data>, policy: UploadPolicy, id: () => string);
+    getSnapshot: () => AttachmentSnapshot;
+    subscribe: (listener: () => void) => () => boolean;
+    private publish;
+    add: (inputs: readonly UploadSource<Data>[]) => void;
+    cancel: (id: string) => void;
+    remove: (id: string) => void;
+    retry: (id: string) => void;
+    /** Call only after send accepts: files now belong to the transcript, not the draft. */
+    transfer: () => void;
+    dispose: () => void;
+    private begin;
+}