@universe-platform/ui 0.1.0-beta.4 → 0.1.0-beta.40

package/dist/index.d.ts

@@ -1,9 +1,81 @@
 import { ClassValue } from 'clsx';
+import { ColumnDef } from './columns';
+export { BaseColumnDef, COLUMN_CAPABILITIES, COLUMN_DEFAULT_INPUT_CONFIG, COLUMN_TYPES, COLUMN_TYPE_LABELS, ColumnCapabilities, ColumnConfig, ColumnConfigMap, ColumnDef, ColumnDefaultInputConfig, ColumnInfo, ColumnType, CurrencyConfig, ExtendedColumnInfo, GoogleContactConfig, GoogleContactNamePart, PhoneConfig, RelationConfig, SubTableConfig, TEXT_REPRESENTABLE_TYPES, TextRepresentableColumnType, TypedColumnDef, isTextRepresentable } from './columns';
+import { RecordData, CellValue } from './records';
+export { CellValue, ColumnValueMap, DriveFileValue, GoogleContactValue, LinkValue, RecordData, SubTableEntryValue, SubTableResolvedEntryValue } from './records';
+import { WhatsAppConfig } from './pages';
+export { BaseComponent, ComponentType, EditorApp, EditorPage, PageComponent, PageInput, TableComponent, WhatsAppConfig } from './pages';
+import { SchemaDef } from './schema';
+export { SchemaDef, TableMeta } from './schema';
+import { TemplateIdentity } from './whatsappValidation';
+export * from './whatsappValidation';
+export { StatusConfig, TemplateIdentity, TemplateValidationParams, TemplateValidationResult, extractUniqueVariableIndices, extractVariableIndices, findVariableAtPosition, formatFileSize, getNextVariableIndex, getStatusConfig, hasBracketSpaces, hasConsecutiveVariables, hasFloatingVariables, hasInsufficientContextBetweenVariables, isDuplicateTemplate, isDuplicateTemplateName, isValidTemplateName, isWordToken, reindexVariables, sanitizeTemplateNameInput, seamlessVariableEngine, validateSequentialVariables, validateTemplateBody, validateWhatsAppTemplate, validateWordToVariableRatio } from './whatsappValidation';
+export * from './formula';
+export * from './relationCopy';
+export * from './relationButtons';
+export * from './defaultFilters';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React, { ReactNode } from 'react';
+import * as react from 'react';
+import react__default, { ReactNode } from 'react';
 
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * WhatsApp opener and phone formatting utilities.
+ */
+/**
+ * Robust WhatsApp Opener (Desktop App with Web Fallback).
+ * Tries the direct protocol first (whatsapp://) and falls back to WhatsApp Web
+ * if the app is not installed (window didn't lose focus).
+ */
+declare function openWhatsAppChat(phone: string, defaultCountryCode?: string): void;
+/**
+ * Formats a phone number for local UI display (e.g. Israeli 05X-XXX-XXXX format).
+ */
+declare function formatPhoneDisplay(phone: string): string;
+
+/**
+ * Phone number sanitization, validation, and WhatsApp link generation utilities.
+ * Pure functions with zero React or DOM dependencies for universal (server & client) usage.
+ */
+/**
+ * Sanitizes phone numbers by stripping whitespace, dashes, and non-numeric characters,
+ * preserving a leading '+' if present.
+ */
+declare function sanitizePhoneNumber(phone: string): string;
+/**
+ * Validates whether a phone number is valid (after sanitization).
+ * Supports Israeli formats (e.g. 0501234567, 031234567) and international formats (+972..., 9-15 digits).
+ */
+declare function isValidPhoneNumber(phone: string): boolean;
+/**
+ * Generates an official wa.me WhatsApp direct message link.
+ *
+ * @param phone Raw or sanitized phone number
+ * @param defaultCountryCode Defaults to Israeli code '972'
+ * @returns WhatsApp URL or null if phone is empty
+ */
+declare function generateWhatsAppLink(phone: string, defaultCountryCode?: string): string | null;
+/**
+ * Normalizes a phone number for WhatsApp sending (Meta international format without leading '+').
+ * - Returns empty string if input is falsy.
+ * - Trims input and removes leading '+' if it exists.
+ * - Strips all non-digit characters.
+ * - If starting with '972', returns it as is.
+ * - If starting with '0' (Israeli mobile/landline), strips '0' and prepends '972'.
+ * - If exactly 9 digits long (omitted leading zero), prepends '972'.
+ * - Returns the processed digits string.
+ */
+declare function normalizePhoneForWhatsApp(phone: string): string;
+
+interface PastelPalette {
+    bg: string;
+    text: string;
+    border: string;
+}
+declare const PASTEL_PALETTES: PastelPalette[];
+declare function getDeterministicPastelBadge(key: string): PastelPalette;
+
 /**
  * Core definitions for Universe UI components.
  * These interfaces define the standard contract that all generic visual components
@@ -43,37 +115,32 @@ interface BaseComponentProps<TData = any, TConfig = Record<string, any>> extends
     "data-testid"?: string;
 }
 
-/**
- * Table data schemas and record definitions for Universe UI components.
- */
-interface ColumnDef {
-    name: string;
-    type?: string;
-    defaultValue?: any;
-    isRequired?: boolean;
-    isUnique?: boolean;
-    referencedTableId?: string;
-    displayField?: string;
-    currencySymbol?: string;
-}
-interface SchemaDef {
-    columns?: ColumnDef[];
-    [key: string]: any;
-}
-interface RecordData {
-    id: string;
-    data: Record<string, any>;
-}
-interface DriveFileValue {
-    fileId: string;
-    fileUrl: string;
-    fileName: string;
+type OrgRole = "OWNER" | "EDITOR" | "VIEWER";
+interface RolePermissions {
+    permissions: ComponentPermissions;
+    readOnly: boolean;
 }
+declare function getRolePermissions(role?: OrgRole | null): RolePermissions;
 
 interface TableConfig extends SchemaDef {
 }
 type TableData = RecordData[];
-type TableBlockProps = BaseComponentProps<TableData, TableConfig>;
+type RowStatusType = "success" | "failed" | "skipped" | "partial";
+interface TableBlockProps extends Partial<BaseComponentProps<TableData, TableConfig>> {
+    exportAction?: (payload: any) => Promise<any>;
+    role?: OrgRole | null;
+    permissions?: ComponentPermissions;
+    readOnly?: boolean;
+    selectedRowIds?: string[];
+    onSelectionChange?: (selectedIds: string[]) => void;
+    onRowToggle?: (rowId: string, checked: boolean) => void;
+    rowStatusMap?: Record<string, {
+        status: RowStatusType;
+        tooltip?: string;
+    } | RowStatusType>;
+    editModelUrl?: string;
+    hideRelationButtons?: boolean;
+}
 interface CreateRecordPayload {
     records: RecordData[];
 }
@@ -84,15 +151,658 @@ interface DeleteRecordPayload {
     ids: string[];
 }
 
+declare function TableBlockClient({ data: initialRecords, settings: schema, executeAction, exportAction, emitEvent, pageState, isLoading, isUpdating, error, isEmpty: isStateEmpty, componentId, orgId, className, 'data-testid': dataTestId, role, permissions, readOnly, selectedRowIds, onSelectionChange, onRowToggle, rowStatusMap, editModelUrl, hideRelationButtons, }: TableBlockProps): react_jsx_runtime.JSX.Element;
+
 declare function TableBlock(props: TableBlockProps): react_jsx_runtime.JSX.Element;
 
+interface UseColumnResizeOptions {
+    storageKey: string;
+    defaultWidth?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    getMinColWidth?: (colName: string) => number;
+}
+declare function useColumnResize({ storageKey, defaultWidth, minWidth, maxWidth, getMinColWidth, }: UseColumnResizeOptions): {
+    columnWidths: Record<string, number>;
+    setColumnWidths: react.Dispatch<react.SetStateAction<Record<string, number>>>;
+    resizingCol: {
+        name: string;
+        startWidth: number;
+        startX: number;
+        minWidth: number;
+    } | null;
+    startResize: (colName: string, currentWidth: number, clientX: number, customMinWidth?: number) => void;
+    getWidth: (colName: string, fallback?: number) => number;
+    minWidth: number;
+};
+
+interface UseColumnReorderOptions {
+    onReorder: (draggedName: string, dropTargetName: string) => void | Promise<void>;
+    disabled?: boolean;
+}
+declare function useColumnReorder({ onReorder, disabled, }: UseColumnReorderOptions): {
+    draggedColName: string | null;
+    dragOverColName: string | null;
+    isDragging: (colName: string) => boolean;
+    isDragOver: (colName: string) => boolean;
+    getHeaderDragProps: (colName: string) => {
+        draggable: boolean;
+        onDragStart?: undefined;
+        onDragOver?: undefined;
+        onDragLeave?: undefined;
+        onDrop?: undefined;
+        onDragEnd?: undefined;
+    } | {
+        draggable: boolean;
+        onDragStart: (e: React.DragEvent) => void;
+        onDragOver: (e: React.DragEvent) => void;
+        onDragLeave: () => void;
+        onDrop: (e: React.DragEvent) => void;
+        onDragEnd: () => void;
+    };
+};
+
+/**
+ * Measure the width of a given text string in canvas 2D context using the specified font.
+ */
+declare function measureTextWidth(text: string, font?: string): number;
+interface SplitTitleResult {
+    isSingleWord: boolean;
+    line1: string;
+    line2?: string;
+}
+/**
+ * Splits a header title:
+ * - 1 word: stays on 1 line.
+ * - 2 or more words: divided as equally as possible between 2 lines without cutting any word.
+ */
+declare function splitHeaderTitle(name: string): SplitTitleResult;
+/**
+ * Calculate the minimum column width needed to display the header title cleanly:
+ * - If 1 word: minimum width is that word + padding + icon.
+ * - If 2+ words: minimum width is the longest line + padding + icon.
+ * - For specialized field types like GOOGLE_CONTACT: ensures room for button.
+ * Words are NEVER cut or truncated with ellipsis.
+ */
+declare function calculateMinColumnWidth(name: string, isSubTable?: boolean, colType?: string): number;
+interface ColumnHeaderTitleProps {
+    name: string;
+    width?: number;
+    isSubTable?: boolean;
+}
+/**
+ * Header title component:
+ * - Default / when enough width: takes up entire line on 1 single row.
+ * - When column is shrunk below full-line width: divides evenly into 2 rows without cutting any word.
+ * - Single words always stay on 1 row.
+ */
+declare function ColumnHeaderTitle({ name, width, isSubTable }: ColumnHeaderTitleProps): react_jsx_runtime.JSX.Element;
+
+declare function formatConflictCellValue(rawVal: any, colDef?: ColumnDef | {
+    name: string;
+    type?: string;
+    config?: any;
+}, relationOptionsMap?: Record<string, any[]>): react__default.ReactNode;
+
+interface DatePickerCellProps {
+    value: CellValue<'DATE'> | Date | number;
+    onChange: (value: CellValue<'DATE'>) => void;
+    column?: ColumnDef;
+    readOnly?: boolean;
+}
+declare function DatePickerCell({ value, onChange, readOnly }: DatePickerCellProps): react_jsx_runtime.JSX.Element;
+
+interface TimePickerCellProps {
+    value: CellValue<'TIME'> | Date;
+    onChange: (value: CellValue<'TIME'>) => void;
+    column?: ColumnDef;
+    readOnly?: boolean;
+}
+declare function parseTimeParts(val: any): {
+    hour: number;
+    minute: number;
+} | null;
+declare function formatTimeIso(hour: number, minute: number): string;
+declare function formatTimeInput(input: string | null | undefined): string;
+declare function TimePickerCell({ value, onChange, readOnly }: TimePickerCellProps): react_jsx_runtime.JSX.Element;
+
+interface LinkPickerCellProps {
+    value: CellValue<'LINK'> | string;
+    onChange: (value: CellValue<'LINK'>) => void;
+    column?: ColumnDef;
+    readOnly?: boolean;
+}
+declare function parseLinkValue(val: CellValue<'LINK'> | string): {
+    url: string;
+    label: string;
+};
+declare function resolveProtocol(url: string): string;
+declare function LinkPickerCell({ value, onChange, readOnly }: LinkPickerCellProps): react_jsx_runtime.JSX.Element;
+
+interface RelationPickerCellProps {
+    value: CellValue<'RELATION'> | string;
+    onChange: (value: CellValue<'RELATION'>) => void;
+    column: ColumnDef<'RELATION'> | ColumnDef;
+    context?: any;
+    rowId?: string;
+    readOnly?: boolean;
+}
+/**
+ * Normalizes any relation value into a canonical string[] of record IDs.
+ * Handles legacy single-string records, empty strings, null/undefined, and object shapes.
+ */
+declare function normalizeRelationValue(val: any): string[];
+declare function RelationPickerCell({ value, onChange, column, context, rowId, readOnly, }: RelationPickerCellProps): react_jsx_runtime.JSX.Element;
+
+interface RelationFilterOption {
+    id: string;
+    label: string;
+}
+type RelationFilterPayload = string[] | {
+    operator: 'notIn';
+    values: string[];
+} | undefined;
+interface RelationFilterPopoverProps {
+    isOpen: boolean;
+    onClose: () => void;
+    column: ColumnDef;
+    triggerRect: DOMRect | null;
+    options: RelationFilterOption[];
+    filterValue?: string[] | {
+        operator: 'notIn';
+        values: string[];
+    };
+    selectedValues?: string[];
+    onSelectionChange: (payload: RelationFilterPayload) => void;
+    isLoading?: boolean;
+}
+declare function RelationFilterPopover({ isOpen, onClose, column, triggerRect, options, filterValue, selectedValues, onSelectionChange, isLoading, }: RelationFilterPopoverProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * checkElementTruncation - Standard browser-accurate truncation detection using the Range API.
+ * Measures the exact unconstrained bounding box of rendered text without container padding interference.
+ */
+declare const checkElementTruncation: (el: HTMLElement | null) => boolean;
+/**
+ * useSmartTooltip - Reusable hook for detecting text truncation and rendering
+ * a custom portal tooltip bubble strictly when content is clipped (scrollWidth > el.clientWidth).
+ */
+declare function useSmartTooltip<T extends HTMLElement = HTMLElement>(): {
+    targetRef: react__default.RefObject<T | null>;
+    checkTruncation: () => boolean;
+    handleMouseEnter: () => void;
+    handleMouseLeave: () => void;
+    hideBubble: () => void;
+    renderTooltip: (text?: string, dir?: "ltr" | "rtl" | "auto") => react__default.ReactPortal | null;
+    isTruncated: boolean;
+    showBubble: boolean;
+};
+interface TruncatedTooltipProps {
+    text: string;
+    tooltipText?: string;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    className?: string;
+    wrapperClassName?: string;
+    children?: react__default.ReactNode;
+}
+/**
+ * TruncatedTooltip - A text container that applies ellipsis truncation
+ * and only displays a custom portal tooltip when text overflows horizontal bounds.
+ * Expands to full cell dimensions (w-full h-full min-h-[inherit]) for reliable hover detection.
+ * No native browser title attribute is rendered.
+ */
+declare const TruncatedTooltip: react__default.FC<TruncatedTooltipProps>;
+interface SmartTextCellProps {
+    value: any;
+    onChange?: (val: any) => void;
+    readOnly?: boolean;
+    type?: 'text' | 'number' | 'tel';
+    placeholder?: string;
+    className?: string;
+    prefix?: react__default.ReactNode;
+    suffix?: react__default.ReactNode;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    tooltipText?: string;
+    step?: string;
+    onFocus?: (e: react__default.FocusEvent<HTMLInputElement>) => void;
+    onBlur?: (e: react__default.FocusEvent<HTMLInputElement>) => void;
+}
+/**
+ * SmartTextCell - Text cell with intelligent hover tooltip.
+ * Only displays the custom portal tooltip bubble if the text is actually
+ * clipped/truncated within its visible boundary (scrollWidth > clientWidth).
+ * Native title attributes are omitted to prevent duplicate tooltips.
+ */
+declare const SmartTextCell: react__default.FC<SmartTextCellProps>;
+
+interface PlacementConfig {
+    sourceTableId: string;
+    sourceDisplayFieldId: string;
+    targetTableId: string;
+    targetFilterField1Id: string;
+    targetFilterField2Id: string;
+    targetSelectorFieldId: string;
+    targetAssignmentFieldId: string;
+    targetFilterDefaults?: Record<string, string>;
+    title?: string;
+    statusColors?: PlacementStatusSetting[];
+    defaultReturnStatusId?: string;
+}
+interface PlacementStatusSetting {
+    id: string;
+    hex: string;
+    label: string;
+}
+declare const DEFAULT_PLACEMENT_STATUS_COLORS: PlacementStatusSetting[];
+/** מחזיר את מזהה הסטטוס ההתחלתי התקף: זה שהוגדר, אחרת "3" אם קיים (תאימות לאחור), אחרת הראשון */
+declare function resolveDefaultStatusId(list: PlacementStatusSetting[], wanted?: string): string;
+interface PlacementSettingsProps {
+    config: PlacementConfig;
+    onChange: (newConfig: PlacementConfig) => void;
+    tables: Array<{
+        id: string;
+        name: string;
+        isGlobal?: boolean;
+        fields?: any[];
+        columns?: any[];
+    }>;
+}
+declare const PlacementStatusEditor: react__default.FC<{
+    config: PlacementConfig;
+    onChange: (newConfig: PlacementConfig) => void;
+}>;
+declare const PlacementSettings: react__default.FC<PlacementSettingsProps>;
+
+interface PlacementStatusColor {
+    id: string;
+    hex: string;
+    label: string;
+}
+type ExecuteAction = (actionType: string, payload: Record<string, any>) => Promise<any>;
+interface PlacementBlockProps {
+    settings?: any;
+    executeAction?: ExecuteAction;
+    componentId?: string;
+    className?: string;
+    config?: PlacementConfig;
+    fetchSourceData?: (tableId: string) => Promise<any[]>;
+    fetchTargetData?: (tableId: string) => Promise<any[]>;
+    updateAssignment?: (targetRecordId: string, sourceRecordId: string) => Promise<void>;
+}
+declare const PlacementBlock: react__default.FC<PlacementBlockProps>;
+
+declare const RELATION_SEP = "::";
+declare const RELATION_LABEL_KEY = "__label";
+declare const NON_TEXT_TYPES: string[];
+interface PlacementColumnOption {
+    /** הערך שנשמר ב-config (שם עמודה, או "קשר::עמודה") */
+    id: string;
+    /** מה שמוצג למשתמש */
+    name: string;
+    type?: string;
+    /** תיאור משני (סוג שדה / מאיזו טבלה) */
+    description?: string;
+    /** שם עמודת הקשר, אם העמודה באה מטבלה קשורה */
+    viaRelation?: string;
+    /** שם הטבלה הקשורה, אם העמודה באה מטבלה קשורה */
+    fromTableName?: string;
+    fromGlobalTable?: boolean;
+}
+type AnyTable = {
+    id: string;
+    name: string;
+    isGlobal?: boolean;
+    fields?: any[];
+    columns?: any[];
+};
+declare const tableColumns: (table?: {
+    fields?: any[];
+    columns?: any[];
+} | null) => any[];
+declare const isUserColumn: (c: any) => boolean;
+declare const buildRelationRef: (relationColumn: string, field: string) => string;
+declare function parseColumnRef(ref: string): {
+    relationColumn?: string;
+    field: string;
+};
+/** שם ידידותי להצגה: "עיר מגורים › שם העיר" */
+declare const columnRefLabel: (ref: string) => string;
+/**
+ * בונה את רשימת העמודות לבחירה בטבלה: עמודות הטבלה עצמה,
+ * ואחריהן (כשהן מותרות) עמודות מכל טבלה שמקושרת אליה ב-RELATION - כולל טבלאות מערכת.
+ * עמודות קשר מוצגות רק ברמה אחת (לא קשר בתוך קשר).
+ */
+declare function buildColumnOptions(table: AnyTable | undefined | null, allTables: AnyTable[] | undefined, opts?: {
+    textOnly?: boolean;
+    includeRelated?: boolean;
+}): PlacementColumnOption[];
+/**
+ * מעשיר רשומות בעמודות וירטואליות מהטבלאות הקשורות, לפי relationOptions שחזר מהשרת:
+ *   data["<קשר>::<עמודה>"]  = ערך העמודה ברשומה/ות הקשורות
+ *   data["<קשר>::__label"]  = התווית (displayField) של הרשומה/ות הקשורות
+ * הערך המקורי של עמודת הקשר (ה-IDs) נשאר כמות שהוא, כי הוא משמש לשמירה.
+ */
+declare function enrichRowsWithRelations<T extends {
+    data: Record<string, any>;
+}>(rows: T[], columns: any[], relationOptions: Record<string, any[]> | undefined): T[];
+/** קורא ערך עמודה (רגילה או מטבלה קשורה); עמודת קשר "חשופה" מוצגת לפי התווית שלה ולא לפי ה-ID */
+declare function readColumnValue(data: Record<string, any> | undefined, ref: string): any;
+
+interface MetaTemplateComponent {
+    type: "HEADER" | "BODY" | "FOOTER" | "BUTTONS" | string;
+    format?: "TEXT" | "IMAGE" | "DOCUMENT" | "VIDEO" | string;
+    text?: string;
+    example?: {
+        header_handle?: string[];
+        body_text?: string[][];
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+interface MetaWhatsAppTemplate {
+    id: string;
+    name: string;
+    status: "APPROVED" | "PENDING" | "IN_REVIEW" | "REJECTED" | "PAUSED" | string;
+    category: "MARKETING" | "UTILITY" | string;
+    language: string;
+    components?: MetaTemplateComponent[];
+    [key: string]: any;
+}
+interface TargetPhoneOption {
+    id: string;
+    label: string;
+    type: "DIRECT" | "SUBTABLE";
+    columnName: string;
+    parentColumnName?: string;
+    referencedTableId?: string;
+}
+interface PostSendTargetColumnOption {
+    id: string;
+    targetType: "MAIN" | "SUBTABLE";
+    columnName: string;
+    parentColumnName?: string;
+    referencedTableId?: string;
+    type: "BOOLEAN" | "RELATION";
+    label: string;
+    config?: any;
+}
+interface WhatsAppRecipient {
+    targetPhone: string;
+    mainRowId: string;
+    subtableRowId?: string;
+    recordData: Record<string, any>;
+}
+type WhatsAppData = any;
+interface TemplateVariableMappingItem {
+    type: "column" | "static";
+    value: string;
+}
+type TemplateVariableMapping = Record<string, TemplateVariableMappingItem>;
+interface TextableColumnOption {
+    id: string;
+    label: string;
+    columnName: string;
+    source: "MAIN" | "SUBTABLE";
+    parentColumnName?: string;
+    type?: string;
+}
+interface WhatsAppComponentProps extends Partial<BaseComponentProps<WhatsAppData, WhatsAppConfig>> {
+    permissions?: ComponentPermissions;
+    orgId?: string;
+    organizationId?: string;
+}
+
+interface SkippedRecipientDetail {
+    mainRowId: string;
+    subtableRowId?: string;
+    reason?: string;
+}
+
+/**
+ * WhatsAppComponent
+ * High-level orchestrator for the WhatsApp messaging interface.
+ * Coordinates template selection, dynamic filters, recipient settings/actions,
+ * and the embedded data grid.
+ */
+declare function WhatsAppComponent(props: WhatsAppComponentProps): react_jsx_runtime.JSX.Element;
+
+interface CreateTemplateModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onSuccess: () => void;
+    existingTemplateNames?: string[];
+    existingTemplates?: TemplateIdentity[];
+    executeAction?: (actionType: string, payload: Record<string, any>) => Promise<any>;
+    orgId?: string;
+}
+/**
+ * CreateTemplateModal
+ * Enterprise modal dialog for authoring and submitting WhatsApp message templates
+ * with atomic variable deletion, flexible editing, and strict word-to-variable ratio validation.
+ */
+declare function CreateTemplateModal({ isOpen, onClose, onSuccess, existingTemplateNames, existingTemplates, executeAction, orgId, }: CreateTemplateModalProps): react_jsx_runtime.JSX.Element | null;
+
+interface BroadcastProgressState {
+    current: number;
+    total: number;
+    successful: number;
+    failed: number;
+    skipped: number;
+    percent: number;
+}
+interface BroadcastSummaryState {
+    successful: number;
+    failed: number;
+    skipped: number;
+    total: number;
+    successfulRowIds: string[];
+    failedRowIds: string[];
+    skippedRowIds: string[];
+}
+declare function useWhatsAppState(props: WhatsAppComponentProps): {
+    orgId: any;
+    tableColumns: ColumnDef[];
+    rawRecords: RecordData[];
+    relationOptions: Record<string, {
+        id: string;
+        label: string;
+    }[]>;
+    isLoadingTableData: boolean;
+    tableError: string | null;
+    loadTableData: () => Promise<void>;
+    embeddedTableExecuteAction: (actionType: string, payload: Record<string, any>) => Promise<any>;
+    filteredRecords: RecordData[];
+    filters: Record<string, string>;
+    filterableColumns: ColumnDef[];
+    handleFilterChange: (colName: string, val: string) => void;
+    handleClearFilters: () => void;
+    activeFiltersCount: number;
+    selectedRowIds: string[];
+    handleSelectionChange: (selectedIds: string[]) => void;
+    handleRowToggle: (rowId: string, checked?: boolean) => void;
+    toggleRowSelection: (rowId: string, checked?: boolean) => void;
+    autoSelectCount: number | null;
+    setAutoSelectCount: react.Dispatch<react.SetStateAction<number | null>>;
+    filteredData: RecordData[];
+    targetPhoneOptions: TargetPhoneOption[];
+    phoneColumns: {
+        name: string;
+        id: string;
+        type: "PHONE";
+    }[];
+    phoneColumnId: string;
+    setPhoneColumnId: react.Dispatch<react.SetStateAction<string>>;
+    selectedPhoneOption: TargetPhoneOption;
+    isScanningPhoneColumns: boolean;
+    hasPhoneColumn: boolean;
+    subtableFilterableColumns: ColumnDef[];
+    selectedSubtableFilterCol: ColumnDef | undefined;
+    subtableFilterColumn: string;
+    setSubtableFilterColumn: react.Dispatch<react.SetStateAction<string>>;
+    subtableFilterValue: string;
+    setSubtableFilterValue: react.Dispatch<react.SetStateAction<string>>;
+    subtableSendLimit: "ALL" | "PRIMARY" | "FIRST";
+    setSubtableSendLimit: react.Dispatch<react.SetStateAction<"ALL" | "PRIMARY" | "FIRST">>;
+    getRelationOptionsForCol: (colName: string, parentColName?: string) => {
+        id: string;
+        label: string;
+    }[];
+    isSubtableFilterIncomplete: boolean;
+    enablePostSendAction: boolean;
+    setEnablePostSendAction: react.Dispatch<react.SetStateAction<boolean>>;
+    postSendActionColumn: string;
+    setPostSendActionColumn: react.Dispatch<react.SetStateAction<string>>;
+    postSendActionValue: string;
+    setPostSendActionValue: react.Dispatch<react.SetStateAction<string>>;
+    postSendActionTargetType: "SUBTABLE" | "MAIN";
+    setPostSendActionTargetType: react.Dispatch<react.SetStateAction<"SUBTABLE" | "MAIN">>;
+    postSendActionTargetOptions: PostSendTargetColumnOption[];
+    selectedPostSendCol: PostSendTargetColumnOption | undefined;
+    isPostSendActionIncomplete: boolean;
+    preparedRecipients: WhatsAppRecipient[] & {
+        skippedRowIds: string[];
+        skippedDetails: SkippedRecipientDetail[];
+    };
+    finalRecipientCount: number;
+    validMainRowsCount: number;
+    isSendDisabled: boolean;
+    isTestDisabled: boolean;
+    sendButtonTitle: string;
+    testButtonTitle: string;
+    requiresMediaHeader: boolean;
+    isMediaMissing: boolean;
+    templates: MetaWhatsAppTemplate[];
+    selectedTemplateId: string | null;
+    setSelectedTemplateId: react.Dispatch<react.SetStateAction<string | null>>;
+    selectedTemplate: MetaWhatsAppTemplate | null;
+    templateBodyText: string;
+    templateHeaderComp: MetaTemplateComponent | null;
+    headerMediaUrl: string;
+    handleHeaderMediaUrlChange: (newUrl: string) => void;
+    handleResetHeaderMediaUrl: () => void;
+    isUploadingMedia: boolean;
+    handleFileUpload: (file: File, templateName?: string) => Promise<void>;
+    templateVariables: string[];
+    variableMapping: TemplateVariableMapping;
+    textableColumnOptions: TextableColumnOption[];
+    handleVariableTypeChange: (varKey: string, newType: "column" | "static") => void;
+    handleVariableValueChange: (varKey: string, newValue: string) => void;
+    isLoadingTemplates: boolean;
+    fetchError: string | null;
+    isModalOpen: boolean;
+    setIsModalOpen: react.Dispatch<react.SetStateAction<boolean>>;
+    isDropdownOpen: boolean;
+    setIsDropdownOpen: react.Dispatch<react.SetStateAction<boolean>>;
+    isDeleting: boolean;
+    handleDeleteTemplate: () => Promise<void>;
+    existingTemplateNames: string[];
+    loadTemplates: () => Promise<void>;
+    isTestPromptOpen: boolean;
+    setIsTestPromptOpen: react.Dispatch<react.SetStateAction<boolean>>;
+    testPhoneNumber: string;
+    handleTestPhoneChange: (val: string) => void;
+    testFeedback: string | null;
+    setTestFeedback: react.Dispatch<react.SetStateAction<string | null>>;
+    isSendingTest: boolean;
+    isSendingBroadcast: boolean;
+    broadcastProgress: BroadcastProgressState;
+    broadcastSummary: BroadcastSummaryState | null;
+    rowStatusMap: Record<string, {
+        status: "success" | "failed" | "skipped" | "partial";
+        tooltip: string;
+    }>;
+    clearBroadcastSummary: () => void;
+    handleSendTest: () => Promise<void>;
+    handleSendMessages: () => Promise<void>;
+    feedback: {
+        type: "success" | "error";
+        message: string;
+    } | null;
+    setFeedback: react.Dispatch<react.SetStateAction<{
+        type: "success" | "error";
+        message: string;
+    } | null>>;
+};
+
+interface DynamicFiltersBlockProps {
+    filterableColumns: ColumnDef[];
+    filters: Record<string, string>;
+    handleFilterChange: (colName: string, val: string) => void;
+    handleClearFilters: () => void;
+    activeFiltersCount: number;
+    relationOptions: Record<string, any[]>;
+    getRelationOptionsForCol?: (colName: string, parentColName?: string) => any[];
+    selectedRowIds: string[];
+    filteredRecordsCount: number;
+    rawRecordsCount: number;
+    loadTableData: () => void;
+    isLoadingTableData: boolean;
+}
+declare function DynamicFiltersBlock({ filterableColumns, filters, handleFilterChange, handleClearFilters, activeFiltersCount, relationOptions, getRelationOptionsForCol, selectedRowIds, filteredRecordsCount, rawRecordsCount, loadTableData, isLoadingTableData, }: DynamicFiltersBlockProps): react_jsx_runtime.JSX.Element;
+
+interface SettingsAndActionsBlockProps {
+    isScanningPhoneColumns: boolean;
+    targetPhoneOptions: TargetPhoneOption[];
+    phoneColumnId: string;
+    setPhoneColumnId: (id: string) => void;
+    selectedPhoneOption: TargetPhoneOption | null;
+    autoSelectCount?: number | null;
+    setAutoSelectCount?: (count: number | null) => void;
+    subtableFilterColumn: string;
+    setSubtableFilterColumn: (col: string) => void;
+    subtableFilterValue: string;
+    setSubtableFilterValue: (val: string) => void;
+    subtableSendLimit: "PRIMARY" | "FIRST" | "ALL";
+    setSubtableSendLimit: (limit: "PRIMARY" | "FIRST" | "ALL") => void;
+    subtableFilterableColumns: ColumnDef[];
+    selectedSubtableFilterCol: ColumnDef | undefined;
+    getRelationOptionsForCol: (colName: string, parentColName?: string) => any[];
+    relationOptions: Record<string, any[]>;
+    enablePostSendAction: boolean;
+    setEnablePostSendAction: (enable: boolean) => void;
+    postSendActionColumn: string;
+    setPostSendActionColumn: (col: string) => void;
+    postSendActionValue: string;
+    setPostSendActionValue: (val: string) => void;
+    postSendActionTargetType: "MAIN" | "SUBTABLE";
+    setPostSendActionTargetType: (type: "MAIN" | "SUBTABLE") => void;
+    postSendActionTargetOptions: PostSendTargetColumnOption[];
+    selectedPostSendOption: PostSendTargetColumnOption | undefined;
+    isTestDisabled: boolean;
+    testButtonTitle: string;
+    setIsTestPromptOpen: (open: boolean) => void;
+    isSendDisabled: boolean;
+    sendButtonTitle: string;
+    handleSendMessages: () => void;
+    selectedRowIdsCount: number;
+    finalRecipientCount: number;
+    validMainRowsCount: number;
+    isSendingBroadcast?: boolean;
+    broadcastProgress?: BroadcastProgressState;
+    broadcastSummary?: BroadcastSummaryState | null;
+    clearBroadcastSummary?: () => void;
+}
+declare function SettingsAndActionsBlock({ isScanningPhoneColumns, targetPhoneOptions, phoneColumnId, setPhoneColumnId, selectedPhoneOption, autoSelectCount, setAutoSelectCount, subtableFilterColumn, setSubtableFilterColumn, subtableFilterValue, setSubtableFilterValue, subtableSendLimit, setSubtableSendLimit, subtableFilterableColumns, selectedSubtableFilterCol, getRelationOptionsForCol, relationOptions, enablePostSendAction, setEnablePostSendAction, postSendActionColumn, setPostSendActionColumn, postSendActionValue, setPostSendActionValue, setPostSendActionTargetType, postSendActionTargetOptions, selectedPostSendOption, isTestDisabled, testButtonTitle, setIsTestPromptOpen, isSendDisabled, sendButtonTitle, handleSendMessages, selectedRowIdsCount, finalRecipientCount, validMainRowsCount, isSendingBroadcast, broadcastProgress, broadcastSummary, clearBroadcastSummary, }: SettingsAndActionsBlockProps): react_jsx_runtime.JSX.Element;
+
+interface FormBlockProps {
+    settings: any;
+    executeAction?: (actionType: string, payload: Record<string, any>) => Promise<any>;
+    componentId?: string;
+    className?: string;
+    onSuccess?: () => void;
+}
+declare function FormBlock({ settings: schema, executeAction, componentId, className, onSuccess }: FormBlockProps): react_jsx_runtime.JSX.Element;
+
 /**
  * UNIVERSE_COMPONENTS
- * Dynamic Component Registry dictionary mapping component type strings (e.g., "TABLE")
+ * Dynamic Component Registry dictionary mapping component type strings (e.g., "TABLE", "WHATSAPP")
  * to their respective React component implementation.
  */
 declare const UNIVERSE_COMPONENTS: {
     readonly TABLE: typeof TableBlock;
+    readonly WHATSAPP: typeof WhatsAppComponent;
+    readonly FORM: typeof FormBlock;
+    readonly PLACEMENT: react.FC<PlacementBlockProps>;
 };
 type ComponentRegistry = typeof UNIVERSE_COMPONENTS;
 type UniverseComponentType = keyof ComponentRegistry;
@@ -110,11 +820,11 @@ interface ToastContextType {
     showError: (error: string | Error | null | undefined, title?: string) => void;
     removeToast: (id: string) => void;
 }
-declare const ToastContext: React.Context<ToastContextType | undefined>;
+declare const ToastContext: react__default.Context<ToastContextType | undefined>;
 declare function ToastProvider({ children }: {
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
 declare function useToast(): ToastContextType;
 
-export { type BaseComponentProps, type ColumnDef, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, type DeleteRecordPayload, type DriveFileValue, type RecordData, type SchemaDef, TableBlock, type TableBlockProps, type TableConfig, type TableData, ToastContext, type ToastContextType, type ToastItem, ToastProvider, UNIVERSE_COMPONENTS, type UniverseComponentType, type UpdateRecordPayload, cn, useToast };
+export { type BaseComponentProps, ColumnHeaderTitle, type ColumnHeaderTitleProps, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, CreateTemplateModal, type CreateTemplateModalProps, DEFAULT_PLACEMENT_STATUS_COLORS, DatePickerCell, type DeleteRecordPayload, DynamicFiltersBlock, type DynamicFiltersBlockProps, LinkPickerCell, type MetaTemplateComponent, type MetaWhatsAppTemplate, NON_TEXT_TYPES, type OrgRole, PASTEL_PALETTES, type PastelPalette, PlacementBlock, type PlacementBlockProps, type PlacementColumnOption, type PlacementConfig, PlacementSettings, type PlacementStatusColor, PlacementStatusEditor, type PlacementStatusSetting, RELATION_LABEL_KEY, RELATION_SEP, type RelationFilterOption, type RelationFilterPayload, RelationFilterPopover, type RelationFilterPopoverProps, RelationPickerCell, type RolePermissions, type RowStatusType, SettingsAndActionsBlock, type SettingsAndActionsBlockProps, SmartTextCell, type SplitTitleResult, TableBlock, TableBlockClient, type TableBlockProps, type TableConfig, type TableData, TimePickerCell, ToastContext, type ToastContextType, type ToastItem, ToastProvider, TruncatedTooltip, UNIVERSE_COMPONENTS, type UniverseComponentType, type UpdateRecordPayload, type UseColumnReorderOptions, type UseColumnResizeOptions, WhatsAppComponent, type WhatsAppComponentProps, type WhatsAppData, buildColumnOptions, buildRelationRef, calculateMinColumnWidth, checkElementTruncation, cn, columnRefLabel, enrichRowsWithRelations, formatConflictCellValue, formatPhoneDisplay, formatTimeInput, formatTimeIso, generateWhatsAppLink, getDeterministicPastelBadge, getRolePermissions, isUserColumn, isValidPhoneNumber, measureTextWidth, normalizePhoneForWhatsApp, normalizeRelationValue, openWhatsAppChat, parseColumnRef, parseLinkValue, parseTimeParts, readColumnValue, resolveDefaultStatusId, resolveProtocol, sanitizePhoneNumber, splitHeaderTitle, tableColumns, useColumnReorder, useColumnResize, useSmartTooltip, useToast, useWhatsAppState };