@universe-platform/ui 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/index.d.ts

@@ -1,7 +1,73 @@
 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';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+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 (E.164 without leading '+').
+ * - Strips spaces, dashes, and special characters.
+ * - If it starts with '05' (10 digits), replaces the leading '0' with '972' (e.g., '0586812807' -> '972586812807').
+ * - If it starts with '+', strips the '+'.
+ */
+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
@@ -41,7 +107,342 @@ interface BaseComponentProps<TData = any, TConfig = Record<string, any>> extends
     "data-testid"?: string;
 }
 
-declare const isUiLibraryReady = true;
-declare const isUiLibraryReadyNot = false;
+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 RowStatusType = "success" | "failed" | "skipped" | "partial";
+interface TableBlockProps extends Partial<BaseComponentProps<TableData, TableConfig>> {
+    exportAction?: (payload: any) => Promise<any>;
+    role?: OrgRole | null;
+    permissions?: ComponentPermissions;
+    readOnly?: boolean;
+    onSelectionChange?: (selectedIds: string[]) => void;
+    rowStatusMap?: Record<string, {
+        status: RowStatusType;
+        tooltip?: string;
+    } | RowStatusType>;
+    editModelUrl?: string;
+}
+interface CreateRecordPayload {
+    records: RecordData[];
+}
+interface UpdateRecordPayload {
+    modifications: Record<string, Record<string, any>>;
+}
+interface DeleteRecordPayload {
+    ids: string[];
+}
+
+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 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;
+}
+type WhatsAppData = any;
+interface WhatsAppComponentProps extends Partial<BaseComponentProps<WhatsAppData, WhatsAppConfig>> {
+    permissions?: ComponentPermissions;
+    orgId?: string;
+    organizationId?: 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;
+
+/**
+ * UNIVERSE_COMPONENTS
+ * 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;
+};
+type ComponentRegistry = typeof UNIVERSE_COMPONENTS;
+type UniverseComponentType = keyof ComponentRegistry;
+
+interface ToastItem {
+    id: string;
+    message: string;
+    type?: "error" | "success" | "info" | "warning";
+    title?: string;
+    duration?: number;
+}
+interface ToastContextType {
+    toasts: ToastItem[];
+    addToast: (toast: Omit<ToastItem, "id">) => string;
+    showError: (error: string | Error | null | undefined, title?: string) => void;
+    removeToast: (id: string) => void;
+}
+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 ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentState, cn, isUiLibraryReady, isUiLibraryReadyNot };
+export { type BaseComponentProps, ColumnHeaderTitle, type ColumnHeaderTitleProps, type ComponentCommunication, type ComponentConfig, type ComponentData, type ComponentPermissions, type ComponentRegistry, type ComponentState, type CreateRecordPayload, CreateTemplateModal, type CreateTemplateModalProps, DatePickerCell, type DeleteRecordPayload, LinkPickerCell, type MetaTemplateComponent, type MetaWhatsAppTemplate, type OrgRole, PASTEL_PALETTES, type PastelPalette, type RelationFilterOption, type RelationFilterPayload, RelationFilterPopover, type RelationFilterPopoverProps, RelationPickerCell, type RolePermissions, type RowStatusType, SmartTextCell, type SplitTitleResult, TableBlock, 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, calculateMinColumnWidth, checkElementTruncation, cn, formatConflictCellValue, formatPhoneDisplay, formatTimeInput, formatTimeIso, generateWhatsAppLink, getDeterministicPastelBadge, getRolePermissions, isValidPhoneNumber, measureTextWidth, normalizePhoneForWhatsApp, normalizeRelationValue, openWhatsAppChat, parseLinkValue, parseTimeParts, resolveProtocol, sanitizePhoneNumber, splitHeaderTitle, useColumnReorder, useColumnResize, useSmartTooltip, useToast };