@app-studio/web 0.9.26 → 0.9.28

package/dist/components/Calendar/Calendar/Calendar.props.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+import { ViewProps } from 'app-studio';
+import { ButtonProps } from '../../Button/Button/Button.props';
+import { TextProps } from '../../Text/Text/Text.props';
+export declare type CalendarView = 'day' | 'week' | 'month';
+export interface CalendarEvent {
+    /** Unique identifier for the event. */
+    id?: string | number;
+    /** Event title shown in the calendar cell. */
+    title: string;
+    /** Start date/time of the event. */
+    start: Date | string;
+    /** Optional end date/time of the event. */
+    end?: Date | string;
+    /** Optional description or supporting information. */
+    description?: string;
+    /** Additional metadata the consumer wants to keep with the event. */
+    metadata?: Record<string, unknown>;
+}
+export interface CalendarRenderEventContext {
+    /** Date of the cell currently being rendered. */
+    day: Date;
+    /** Active calendar view. */
+    view: CalendarView;
+    /** Whether the given day is today. */
+    isToday: boolean;
+}
+export interface CalendarViews {
+    container?: ViewProps;
+    header?: ViewProps;
+    headerTitle?: TextProps;
+    navigation?: ViewProps;
+    viewSwitcher?: ViewProps;
+    grid?: ViewProps;
+    weekdayRow?: ViewProps;
+    weekdayHeader?: ViewProps;
+    weekdayLabel?: TextProps;
+    weekRow?: ViewProps;
+    dayColumn?: ViewProps;
+    dayHeader?: ViewProps;
+    dayNumber?: TextProps;
+    dayMeta?: TextProps;
+    events?: ViewProps;
+    event?: ViewProps;
+    eventTitle?: TextProps;
+    eventTime?: TextProps;
+    emptyState?: TextProps;
+    navigationButton?: Partial<ButtonProps>;
+    viewButton?: Partial<ButtonProps>;
+}
+export interface CalendarProps {
+    /** Calendar events to render. */
+    events?: CalendarEvent[];
+    /** Starting date displayed in the calendar. */
+    initialDate?: Date | string;
+    /** Initial visible view. */
+    initialView?: CalendarView;
+    /** First day of the week, defaults to Sunday. */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Height of the calendar container. */
+    height?: string | number;
+    /** Optional custom render method for events. */
+    renderEvent?: (event: CalendarEvent, context: CalendarRenderEventContext) => React.ReactNode;
+    /** Called when the visible anchor date changes. */
+    onDateChange?: (date: Date) => void;
+    /** Called when the active view changes. */
+    onViewChange?: (view: CalendarView) => void;
+    /** Customise styling of calendar areas. */
+    views?: CalendarViews;
+}

package/dist/components/Calendar/Calendar/Calendar.utils.d.ts

@@ -0,0 +1,10 @@
+import { CalendarEvent } from './Calendar.props';
+export interface CalendarEventInternal extends CalendarEvent {
+    startDate: Date;
+    endDate: Date;
+}
+export declare const toDate: (value: Date | string) => Date;
+export declare const normalizeEvent: (event: CalendarEvent) => CalendarEventInternal;
+export declare const formatDayKey: (date: Date) => string;
+export declare const getEventsForDay: (events: CalendarEventInternal[], day: Date) => CalendarEventInternal[];
+export declare const chunk: <T>(items: T[], size: number) => T[][];

package/dist/components/Calendar/Calendar/Calendar.view.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { CalendarEvent, CalendarRenderEventContext, CalendarView, CalendarViews } from './Calendar.props';
+import { CalendarEventInternal } from './Calendar.utils';
+interface CalendarViewProps {
+    currentDate: Date;
+    view: CalendarView;
+    label: string;
+    weeks: Date[][];
+    weekdayLabels: Date[];
+    eventsByDay: Map<string, CalendarEventInternal[]>;
+    onPrevious: () => void;
+    onNext: () => void;
+    onToday: () => void;
+    onViewChange: (view: CalendarView) => void;
+    renderEvent?: (event: CalendarEvent, context: CalendarRenderEventContext) => React.ReactNode;
+    views?: CalendarViews;
+    height?: string | number;
+}
+declare const CalendarViewComponent: React.FC<CalendarViewProps>;
+export default CalendarViewComponent;

package/dist/components/Calendar/Calendar.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { CalendarProps } from './Calendar/Calendar.props';
+export declare const Calendar: React.FC<CalendarProps>;

package/dist/components/ChatInput/ChatInput/ChatInput.props.d.ts

@@ -176,6 +176,10 @@ export interface ChatInputViewProps extends ChatInputProps {
      * Whether files are being uploaded
      */
     isUploading: boolean;
+    /**
+     * Current upload progress (0-100)
+     */
+    uploadProgress?: number;
     leftButtons?: React.ReactNode;
     rightButtons?: React.ReactNode;
     /**
@@ -202,6 +206,10 @@ export interface ChatInputViewProps extends ChatInputProps {
      * Callback function to set whether files are being uploaded
      */
     setIsUploading: React.Dispatch<React.SetStateAction<boolean>>;
+    /**
+     * Start uploading newly added files
+     */
+    startUpload: (files: File[]) => void;
     /**
      * Currently selected model
      */

package/dist/components/ChatInput/ChatInput/ChatInput.state.d.ts

@@ -11,6 +11,7 @@ export declare const useChatInputState: (props: ChatInputProps) => {
     editableRef: import("react").MutableRefObject<HTMLDivElement | null>;
     fileInputRef: import("react").MutableRefObject<HTMLInputElement | null>;
     isUploading: boolean;
+    uploadProgress: number;
     isDraggingOver: boolean;
     uploadedFiles: File[];
     pendingFiles: File[];
@@ -18,6 +19,7 @@ export declare const useChatInputState: (props: ChatInputProps) => {
     setPendingFiles: import("react").Dispatch<import("react").SetStateAction<File[]>>;
     setUploadedFiles: import("react").Dispatch<import("react").SetStateAction<File[]>>;
     setIsUploading: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    startUpload: (files: File[]) => void;
     selectedModel: string;
     handleModelChange: import("react").Dispatch<import("react").SetStateAction<string>>;
     modelOptions: ModelOption[];

package/dist/components/Formik/Formik.Uploader.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import type { UploadProps } from '../Uploader/Uploader/Uploader.props';
+export declare type UploadFileHandler = (file: File, onProgress: (progress: number) => void) => Promise<any>;
+export interface FormikUploaderProps extends Omit<UploadProps, 'onFileSelect' | 'onMultipleFileSelect' | 'isLoading' | 'progress'> {
+    /**
+     * Name of the field that will receive the uploaded file responses
+     */
+    name: string;
+    /**
+     * Custom upload handler. Defaults to the platform UploadService
+     */
+    uploadFile?: UploadFileHandler;
+    /**
+     * Callback fired when a single file upload succeeds
+     */
+    onUploadSuccess?: (file: File, response: any) => void;
+    /**
+     * Callback fired when a single file upload fails
+     */
+    onUploadError?: (file: File, error: unknown) => void;
+    /**
+     * Transform the raw upload response before storing it in the form state
+     */
+    transformResponse?: (response: any, file: File) => any;
+    /**
+     * Optional external handler mirroring the Uploader prop
+     */
+    onMultipleFileSelect?: (files: File[]) => void;
+    /**
+     * Optional external handler mirroring the Uploader prop for single upload mode
+     */
+    onFileSelect?: (file: File) => void;
+    /**
+     * Enable/disable multiple uploads. Defaults to true
+     */
+    multiple?: boolean;
+}
+export declare const FormikUploader: React.FC<FormikUploaderProps>;

package/dist/components/Formik/index.d.ts

@@ -13,3 +13,4 @@ export { FormikForm } from './Formik.Form';
 export { FormikComboBox } from './Formik.ComboBox';
 export { FormikSlider } from './Formik.Slider';
 export { FormikOTPInput } from './Formik.OTPInput';
+export { FormikUploader } from './Formik.Uploader';

package/dist/components/KanbanBoard/KanbanBoard/KanbanBoard.props.d.ts

@@ -0,0 +1,46 @@
+import React from 'react';
+import { ViewProps } from 'app-studio';
+import { TextProps } from '../../Text/Text/Text.props';
+export interface KanbanBoardCard {
+    id: string;
+    title: string;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface KanbanBoardColumn {
+    id: string;
+    title: string;
+    cards: KanbanBoardCard[];
+    footer?: React.ReactNode;
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface KanbanBoardProps {
+    columns: KanbanBoardColumn[];
+    onChange?: (columns: KanbanBoardColumn[]) => void;
+    renderCard?: (card: KanbanBoardCard, column: KanbanBoardColumn) => React.ReactNode;
+    renderColumnHeader?: (column: KanbanBoardColumn) => React.ReactNode;
+    renderEmptyState?: (column: KanbanBoardColumn) => React.ReactNode;
+    views?: {
+        board?: ViewProps;
+        column?: ViewProps;
+        columnHeader?: ViewProps;
+        columnTitle?: TextProps;
+        columnBody?: ViewProps;
+        columnFooter?: ViewProps;
+        card?: ViewProps;
+        cardContent?: ViewProps;
+        emptyState?: ViewProps;
+    };
+}
+export interface KanbanBoardViewProps extends KanbanBoardProps {
+    columns: KanbanBoardColumn[];
+    draggedCardId: string | null;
+    onCardDragStart: (columnId: string, cardId: string, event: React.DragEvent<HTMLDivElement>) => void;
+    onCardDragEnd: () => void;
+    onCardDrop: (columnId: string, cardId: string | null, event: React.DragEvent<HTMLDivElement>) => void;
+    onColumnDrop: (columnId: string, event: React.DragEvent<HTMLDivElement>) => void;
+    onCardDragOver: (columnId: string, cardId: string | null, event: React.DragEvent<HTMLDivElement>) => void;
+    onColumnDragOver: (columnId: string, event: React.DragEvent<HTMLDivElement>) => void;
+}

package/dist/components/KanbanBoard/KanbanBoard/KanbanBoard.state.d.ts

@@ -0,0 +1,12 @@
+import type React from 'react';
+import { KanbanBoardProps } from './KanbanBoard.props';
+export declare const useKanbanBoardState: ({ columns: initialColumns, onChange, }: KanbanBoardProps) => {
+    columns: import("./KanbanBoard.props").KanbanBoardColumn[];
+    draggedCardId: string | null;
+    onCardDragStart: (columnId: string, cardId: string, event: React.DragEvent<HTMLDivElement>) => void;
+    onCardDragEnd: () => void;
+    onColumnDragOver: (_columnId: string, event: React.DragEvent<HTMLDivElement>) => void;
+    onCardDragOver: (_columnId: string, _cardId: string | null, event: React.DragEvent<HTMLDivElement>) => void;
+    onColumnDrop: (columnId: string, event: React.DragEvent<HTMLDivElement>) => void;
+    onCardDrop: (columnId: string, cardId: string | null, event: React.DragEvent<HTMLDivElement>) => void;
+};

package/dist/components/KanbanBoard/KanbanBoard/KanbanBoard.view.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { KanbanBoardViewProps } from './KanbanBoard.props';
+export declare const KanbanBoardView: React.FC<KanbanBoardViewProps>;

package/dist/components/KanbanBoard/KanbanBoard.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { KanbanBoardProps } from './KanbanBoard/KanbanBoard.props';
+export declare const KanbanBoard: React.FC<KanbanBoardProps>;

package/dist/components/ShareButton/ShareButton/ShareButton.props.d.ts

@@ -0,0 +1,38 @@
+import React from 'react';
+import { ButtonProps } from '../../Button/Button/Button.props';
+export declare type NavigatorShareData = Parameters<Navigator['share']>[0];
+/**
+ * Properties for the ShareButton component.
+ * Extends the design-system Button while wiring the Web Share API workflow.
+ */
+export interface ShareButtonProps extends Omit<ButtonProps, 'onClick'> {
+    /** Data passed to the `navigator.share` call. */
+    shareData: NavigatorShareData;
+    /** Optional label rendered when no custom children are provided. Defaults to "Share". */
+    label?: React.ReactNode;
+    /** Called immediately before invoking the Web Share API. */
+    onShareStart?: () => void;
+    /** Called when the share sheet completes successfully. */
+    onShareSuccess?: () => void;
+    /** Called when the user dismisses the native share sheet. */
+    onShareCancel?: () => void;
+    /** Called when the share operation throws an unexpected error. */
+    onShareError?: (error: unknown) => void;
+    /** Called when the Web Share API is not available for the provided data. */
+    onUnsupported?: () => void;
+    /**
+     * When true the button is disabled if the Web Share API is unavailable.
+     * Defaults to true to avoid misleading interactions.
+     */
+    disableWhenUnsupported?: boolean;
+    /** Additional click handler fired alongside the share workflow. */
+    onClick?: ButtonProps['onClick'];
+}
+export interface ShareButtonViewProps extends Omit<ShareButtonProps, 'shareData' | 'onShareStart' | 'onShareSuccess' | 'onShareCancel' | 'onShareError' | 'onUnsupported' | 'onClick'> {
+    /** Flag indicating if the current environment can use the Web Share API. */
+    isSupported: boolean;
+    /** True while awaiting the native share sheet to resolve. */
+    isSharing: boolean;
+    /** Internal handler that triggers the sharing flow. */
+    onShare: ButtonProps['onClick'];
+}

package/dist/components/ShareButton/ShareButton/ShareButton.state.d.ts

@@ -0,0 +1,6 @@
+import { ShareButtonProps } from './ShareButton.props';
+export declare const useShareButton: (props: ShareButtonProps) => {
+    isSupported: any;
+    isSharing: boolean;
+    handleShare: (...args: unknown[]) => void;
+};

package/dist/components/ShareButton/ShareButton/ShareButton.view.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ShareButtonViewProps } from './ShareButton.props';
+declare const ShareButtonView: React.FC<ShareButtonViewProps>;
+export default ShareButtonView;

package/dist/components/ShareButton/ShareButton.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { ShareButtonProps } from './ShareButton/ShareButton.props';
+export declare const ShareButton: React.FC<ShareButtonProps>;

package/dist/components/Text/Text/Text.props.d.ts

@@ -3,6 +3,7 @@ import type { TextProps as TextAppProps } from 'app-studio';
 import { Headings, Size, TextWeights } from './Text.type';
 export interface TextProps extends Omit<TextAppProps, 'children' | 'style' | 'pointerEvents'> {
     children?: React.ReactNode;
+    backgroundColor?: string;
     heading?: Headings;
     isItalic?: boolean;
     isStriked?: boolean;

package/dist/components/Text/Text/Text.utils.d.ts

@@ -0,0 +1,2 @@
+export declare const getTextColorHex: (backgroundColor: string) => "black" | "white";
+export declare const getTextColor: (backgroundColor: string) => "black" | "white";

package/dist/components/index.d.ts

@@ -9,6 +9,8 @@ export * from './Button/Button';
 export * from './Card/Card';
 export * from './Carousel/Carousel';
 export * from './Chart/Chart';
+export * from './KanbanBoard/KanbanBoard';
+export * from './Calendar/Calendar';
 export * from './CookieConsent/CookieConsent';
 export * from './ContextMenu/ContextMenu';
 export * from './File/File';
@@ -51,6 +53,7 @@ export * from './Menubar/Menubar';
 export * from './Pagination/Pagination';
 export * from './ProgressBar/ProgressBar';
 export * from './Separator/Separator';
+export * from './ShareButton/ShareButton';
 export * from './StatusIndicator/StatusIndicator';
 export * from './Sidebar/Sidebar';
 export * from './Resizable/Resizable';
@@ -73,8 +76,10 @@ export * from './Avatar/Avatar/Avatar.props';
 export * from './Badge/Badge/Badge.props';
 export * from './Button/Button/Button.props';
 export * from './Card/Card/Card.props';
+export * from './KanbanBoard/KanbanBoard/KanbanBoard.props';
 export * from './Carousel/Carousel/Carousel.props';
 export * from './Chart/Chart/Chart.props';
+export * from './Calendar/Calendar/Calendar.props';
 export * from './CookieConsent/CookieConsent/CookieConsent.props';
 export * from './ContextMenu/ContextMenu/ContextMenu.props';
 export * from './Form/Select/Select/Select.props';
@@ -108,6 +113,7 @@ export * from './Menubar/Menubar/Menubar.props';
 export * from './Pagination/Pagination/Pagination.props';
 export * from './ProgressBar/ProgressBar/ProgressBar.props';
 export * from './Separator/Separator/Separator.props';
+export * from './ShareButton/ShareButton/ShareButton.props';
 export * from './StatusIndicator/StatusIndicator/StatusIndicator.props';
 export * from './Sidebar/Sidebar/Sidebar.props';
 export * from './Resizable/Resizable/Resizable.props';

package/dist/pages/calendar.page.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const CalendarPage: () => React.JSX.Element;
+export default CalendarPage;

package/dist/pages/kanbanBoard.page.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const KanbanBoardPage: () => React.JSX.Element;
+export default KanbanBoardPage;