@mathews_cometchat/bubble-builder 1.0.0-alpha29 → 1.0.0-alpha30

package/dist/types/schema.d.ts

@@ -0,0 +1,315 @@
+export type Padding = number | {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+};
+export type SizeOrPercentage = number | string;
+export type ColorValue = string;
+export interface OpenUrlAction {
+    type: 'openUrl';
+    url: string;
+    openIn?: 'browser' | 'webview';
+}
+export interface ChatWithUserAction {
+    type: 'chatWithUser';
+    uid: string;
+}
+export interface ChatWithGroupAction {
+    type: 'chatWithGroup';
+    guid: string;
+}
+export interface SendMessageAction {
+    type: 'sendMessage';
+    text: string;
+    receiverUid?: string;
+    receiverGuid?: string;
+}
+export interface CopyToClipboardAction {
+    type: 'copyToClipboard';
+    value: string;
+}
+export interface DownloadFileAction {
+    type: 'downloadFile';
+    url: string;
+    filename?: string;
+}
+export interface InitiateCallAction {
+    type: 'initiateCall';
+    uid?: string;
+    guid?: string;
+    callType: 'audio' | 'video';
+}
+export interface ApiCallAction {
+    type: 'apiCall';
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+}
+export interface CustomCallbackAction {
+    type: 'customCallback';
+}
+export type BubbleAction = OpenUrlAction | ChatWithUserAction | ChatWithGroupAction | SendMessageAction | CopyToClipboardAction | DownloadFileAction | InitiateCallAction | ApiCallAction | CustomCallbackAction;
+export declare const ACTION_TYPES: readonly ["openUrl", "chatWithUser", "chatWithGroup", "sendMessage", "copyToClipboard", "downloadFile", "initiateCall", "apiCall", "customCallback"];
+export type ActionType = typeof ACTION_TYPES[number];
+export interface TextElement {
+    id: string;
+    type: 'text';
+    content: string;
+    variant?: 'title' | 'heading1' | 'heading2' | 'heading3' | 'heading4' | 'body' | 'caption1' | 'caption2';
+    color?: ColorValue;
+    align?: 'left' | 'center' | 'right' | 'justify';
+    fontWeight?: 'regular' | 'medium' | 'bold';
+    maxLines?: number;
+    padding?: Padding;
+}
+export interface ImageElement {
+    id: string;
+    type: 'image';
+    url: string;
+    altText?: string;
+    fit?: 'cover' | 'contain' | 'fill';
+    width?: SizeOrPercentage;
+    height?: SizeOrPercentage;
+    borderRadius?: number;
+    padding?: Padding;
+}
+export interface IconElement {
+    id: string;
+    type: 'icon';
+    name: string;
+    size?: number;
+    color?: ColorValue;
+    backgroundColor?: ColorValue;
+    borderRadius?: number;
+    padding?: number;
+}
+export interface AvatarElement {
+    id: string;
+    type: 'avatar';
+    imageUrl?: string;
+    fallbackInitials?: string;
+    size?: number;
+    borderRadius?: number;
+    backgroundColor?: ColorValue;
+    fontSize?: number;
+    fontWeight?: 'regular' | 'medium' | 'bold';
+}
+export interface BadgeElement {
+    id: string;
+    type: 'badge';
+    text: string;
+    color?: ColorValue;
+    size?: number;
+    backgroundColor?: ColorValue;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+    borderRadius?: number;
+    padding?: Padding;
+    fontSize?: number;
+}
+export interface DividerElement {
+    id: string;
+    type: 'divider';
+    color?: ColorValue;
+    thickness?: number;
+    margin?: number;
+}
+export interface SpacerElement {
+    id: string;
+    type: 'spacer';
+    height: number;
+}
+export interface ChipElement {
+    id: string;
+    type: 'chip';
+    text: string;
+    color?: ColorValue;
+    icon?: string;
+    backgroundColor?: ColorValue;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+    borderRadius?: number;
+    padding?: Padding;
+    fontSize?: number;
+}
+export interface ProgressBarElement {
+    id: string;
+    type: 'progressBar';
+    value: number;
+    color?: ColorValue;
+    trackColor?: ColorValue;
+    height?: number;
+    label?: string;
+    borderRadius?: number;
+    labelFontSize?: number;
+    labelColor?: ColorValue;
+}
+export interface CodeBlockElement {
+    id: string;
+    type: 'codeBlock';
+    content: string;
+    language?: string;
+    backgroundColor?: ColorValue;
+    textColor?: ColorValue;
+    padding?: Padding;
+    borderRadius?: number;
+    fontSize?: number;
+    languageLabelFontSize?: number;
+    languageLabelColor?: ColorValue;
+}
+export interface MarkdownElement {
+    id: string;
+    type: 'markdown';
+    content: string;
+    baseFontSize?: number;
+    linkColor?: ColorValue;
+    color?: ColorValue;
+    lineHeight?: number;
+}
+export interface RowElement {
+    id: string;
+    type: 'row';
+    items: BubbleElement[];
+    gap?: number;
+    align?: 'start' | 'center' | 'end' | 'spaceBetween' | 'spaceAround';
+    wrap?: boolean;
+    scrollable?: boolean;
+    peek?: number;
+    snap?: 'item' | 'free';
+    padding?: Padding;
+    backgroundColor?: ColorValue;
+    borderRadius?: number;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+}
+export interface ColumnElement {
+    id: string;
+    type: 'column';
+    items: BubbleElement[];
+    gap?: number;
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    padding?: Padding;
+    backgroundColor?: ColorValue;
+    borderRadius?: number;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+}
+export interface GridElement {
+    id: string;
+    type: 'grid';
+    items: BubbleElement[];
+    columns?: 2 | 3 | 4;
+    gap?: number;
+    padding?: Padding;
+    backgroundColor?: ColorValue;
+    borderRadius?: number;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+}
+export interface AccordionElement {
+    id: string;
+    type: 'accordion';
+    header: string;
+    headerIcon?: string;
+    body: BubbleElement[];
+    expandedByDefault?: boolean;
+    border?: boolean;
+    padding?: Padding;
+    fontSize?: number;
+    fontWeight?: 'regular' | 'medium' | 'bold';
+    borderRadius?: number;
+}
+export interface TabsElement {
+    id: string;
+    type: 'tabs';
+    tabs: {
+        label: string;
+        content: BubbleElement[];
+    }[];
+    defaultActiveTab?: number;
+    tabAlign?: 'start' | 'center' | 'stretch';
+    tabPadding?: Padding;
+    contentPadding?: Padding;
+    fontSize?: number;
+}
+export interface ButtonElement {
+    id: string;
+    type: 'button';
+    label: string;
+    action: BubbleAction;
+    backgroundColor?: ColorValue;
+    textColor?: ColorValue;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+    borderRadius?: number;
+    icon?: string;
+    iconPosition?: 'left' | 'right';
+    size?: number;
+    fullWidth?: boolean;
+    padding?: Padding;
+    fontSize?: number;
+}
+export interface IconButtonElement {
+    id: string;
+    type: 'iconButton';
+    icon: string;
+    action: BubbleAction;
+    size?: number;
+    color?: ColorValue;
+    backgroundColor?: ColorValue;
+    borderRadius?: number;
+}
+export interface LinkElement {
+    id: string;
+    type: 'link';
+    text: string;
+    action: BubbleAction;
+    color?: ColorValue;
+    underline?: boolean;
+    fontSize?: number;
+}
+export interface TableElement {
+    id: string;
+    type: 'table';
+    columns: string[];
+    rows: string[][];
+    headerBackgroundColor?: ColorValue;
+    border?: boolean;
+    stripedRows?: boolean;
+    cellPadding?: number;
+    fontSize?: number;
+    stripedRowColor?: ColorValue;
+    borderColor?: ColorValue;
+}
+export type BubbleElement = TextElement | ImageElement | IconElement | AvatarElement | BadgeElement | DividerElement | SpacerElement | ChipElement | ProgressBarElement | CodeBlockElement | MarkdownElement | RowElement | ColumnElement | GridElement | AccordionElement | TabsElement | ButtonElement | IconButtonElement | LinkElement | TableElement;
+export type ElementType = BubbleElement['type'];
+export interface BubbleSettings {
+    background?: ColorValue;
+    borderRadius?: number;
+    borderColor?: ColorValue;
+    borderWidth?: number;
+    padding?: Padding;
+}
+export interface BubbleMessage {
+    version: '1.0';
+    body: BubbleElement[];
+    settings?: BubbleSettings;
+    fallbackText: string;
+    notificationTitle?: string;
+    notificationBody?: string;
+}
+export interface Template {
+    id: string;
+    name: string;
+    description?: string;
+    schemaVersion?: string;
+    bubbleData: BubbleMessage;
+    thumbnail?: string;
+    createdBy?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare function isContainerElement(el: BubbleElement): el is RowElement | ColumnElement | GridElement | AccordionElement;
+export declare function getContainerChildren(el: BubbleElement): BubbleElement[] | null;

package/dist/utils/element-errors.d.ts

@@ -0,0 +1,9 @@
+import type { BubbleElement } from '../types/schema';
+export interface FieldError {
+    field: string;
+    message: string;
+}
+/** Returns field-level validation errors for a single element. */
+export declare function getElementErrors(el: BubbleElement): FieldError[];
+/** Quick check: does this element have any errors? Useful for tree indicators. */
+export declare function hasElementErrors(el: BubbleElement): boolean;

package/dist/utils/id.d.ts

@@ -0,0 +1,4 @@
+export declare function generateId(type: string): string;
+import type { BubbleElement } from '../types/schema';
+/** Recursively assign IDs to all elements that don't have one */
+export declare function assignIds(elements: BubbleElement[]): BubbleElement[];

package/dist/utils/portal-root.d.ts

@@ -0,0 +1,2 @@
+export declare function setPortalRoot(el: HTMLElement): void;
+export declare function getPortalRoot(): HTMLElement;

package/dist/utils/validate.d.ts

@@ -0,0 +1,6 @@
+import type { BubbleMessage } from '../types/schema';
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export declare function validateBubble(bubble: BubbleMessage): ValidationError[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mathews_cometchat/bubble-builder",
-  "version": "1.0.0-alpha29",
+  "version": "1.0.0-alpha30",
   "type": "module",
   "main": "dist/bubble-builder.umd.js",
   "module": "dist/bubble-builder.es.js",