@genispace/geniapp 0.3.0 → 0.5.0

package/dist/components/types/databaseDataSource.d.ts

@@ -0,0 +1,120 @@
+export interface ParameterRefConfig {
+    type: 'parameter' | 'system';
+    source?: string;
+    systemParam?: string;
+    value?: any;
+    waitForValue?: boolean;
+}
+export interface DatabaseDataSourceConfig {
+    type: 'database-datasource';
+    datasourceId: string;
+    datasourceName?: string;
+    /** Pin a datasource version; omit to use the default version */
+    version?: number;
+    sqlQuery?: string;
+    parameters?: Record<string, any>;
+    parameterTypes?: Record<string, string>;
+    outputFields?: string[];
+    defaultSort?: DefaultSortItem[];
+    enableSort?: boolean;
+}
+export interface DatabaseDataSourceResponse {
+    success: boolean;
+    data?: {
+        rows: Record<string, any>[];
+        columns: string[];
+        totalCount: number;
+        executionTime: number;
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    };
+    message?: string;
+    error?: string;
+}
+export interface DatabaseDataSourceParams {
+    parameters?: Record<string, any>;
+    page?: number;
+    limit?: number;
+    offset?: number;
+    filter?: string;
+    sort?: string;
+    outputFields?: string[];
+}
+export type ComponentDataSourceType = 'dataset' | 'database-datasource' | 'external' | 'mock';
+export type UnifiedDataSourceConfig = {
+    type: 'dataset';
+    datasetConfig: any;
+} | {
+    type: 'database-datasource';
+    databaseDataSourceConfig: DatabaseDataSourceConfig;
+} | {
+    type: 'external';
+    externalConfig: any;
+} | {
+    type: 'mock';
+    mockConfig: any;
+};
+export interface DatabaseDataSourceOption {
+    id: string;
+    name: string;
+    description?: string;
+    type?: string;
+    status?: 'active' | 'inactive';
+    createdAt?: string;
+    updatedAt?: string;
+}
+export interface DatabaseFieldInfo {
+    name: string;
+    type: string;
+    description?: string;
+    nullable?: boolean;
+    defaultValue?: any;
+}
+export interface DatabaseDataSourcePreviewData {
+    fields: DatabaseFieldInfo[];
+    sampleData: Record<string, any>[];
+    totalCount?: number;
+}
+export interface UseDatabaseDataSourceReturn {
+    data: Record<string, any>[];
+    loading: boolean;
+    error: string | null;
+    pagination: {
+        total: number;
+        current_page: number;
+        total_pages: number;
+        limit: number;
+        offset: number;
+        has_more: boolean;
+    } | null;
+    isInitialized: boolean;
+    refetch: (params?: Record<string, any>) => Promise<void>;
+    clearCache: () => void;
+    exportAllData: (onProgress: (current: number, total: number) => void) => Promise<Record<string, any>[]>;
+}
+export type SupportedComponentType = 'Tree' | 'Table' | 'EditableTable' | 'Form' | 'Chart' | 'StatisticGroup' | 'Typography' | 'HeroCard' | 'CollapsePanel' | 'ProductReport' | 'ProductDetail' | 'TileGrid' | 'RingStat' | 'RadarChart' | 'List';
+export interface DefaultSortItem {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+export interface DataExtractionStrategy {
+    componentType: SupportedComponentType;
+    dataPath?: string;
+    transformFn?: (data: any[]) => any[];
+}
+export interface ErrorHandlingConfig {
+    showToast?: boolean;
+    retryAttempts?: number;
+    retryDelay?: number;
+    fallbackData?: any[];
+}
+export interface PerformanceConfig {
+    debounceTime?: number;
+    throttleTime?: number;
+    batchSize?: number;
+    lazyLoad?: boolean;
+}

package/dist/components/types/datasource.d.ts

@@ -0,0 +1,117 @@
+export type FilterOperator = 'eq' | 'ne' | 'gt' | 'lt' | 'gte' | 'lte' | 'like' | 'in' | 'not_in';
+export interface ParameterFilterCondition {
+    id: string;
+    field: string;
+    operator: FilterOperator;
+    parameterName: string;
+    fallbackValue?: any;
+    enabled: boolean;
+    description?: string;
+}
+export interface DataSourceCommunicationConfig {
+    enabled: boolean;
+    listenToParameters: string[];
+    enableDebugLog?: boolean;
+    manualListenParameters?: string[];
+    autoListenParameters?: string[];
+}
+export interface DataSourceParams {
+    parameterFilters?: ParameterFilterCondition[];
+    limit?: number;
+    offset?: number;
+    outputFields?: string[];
+    [key: string]: unknown;
+}
+export interface DataSource {
+    type: 'dataset';
+    datasetId: string;
+    datasetName?: string;
+    params: DataSourceParams;
+    [key: string]: unknown;
+}
+export interface EnhancedDataSource extends DataSource {
+    communicationConfig?: DataSourceCommunicationConfig;
+}
+export interface SchemaField {
+    name: string;
+    type: string;
+    description?: string;
+}
+export interface DatasetSchema {
+    fields: SchemaField[];
+}
+export interface ColumnConfig {
+    title: string;
+    dataIndex: string;
+    key: string;
+    width?: number | string;
+    minWidth?: number | string;
+    maxWidth?: number | string;
+    align?: string;
+    ellipsis?: boolean;
+    editable?: boolean;
+    editRequired?: boolean;
+    filterable?: boolean;
+    filterType?: 'equals' | 'like' | 'in';
+    filterMultiSelect?: boolean;
+    filterMaxTags?: number;
+    filterPassMode?: 'filter' | 'parameter';
+    filterParameterName?: string;
+    hidden?: boolean;
+    /** Pin column to the left in table renderer (horizontal scroll) */
+    frozen?: boolean;
+    fieldType?: 'VARCHAR' | 'INT8' | 'INT16' | 'INT32' | 'INT64' | 'FLOAT' | 'DOUBLE' | 'BOOL' | 'JSON' | 'ARRAY' | 'DATE' | 'DATETIME' | 'TEXT' | 'SWITCH' | 'IMAGE';
+    render?: {
+        type: 'Tag' | 'Progress' | 'Image' | 'yyyy-MM-dd' | 'yyyy-MM-dd HH:mm:ss' | 'Custom' | 'RankBadge' | 'Currency' | 'Number';
+        props?: {
+            color?: Record<string, string>;
+            text?: Record<string, string>;
+            textColor?: Record<string, string>;
+            status?: string;
+            showInfo?: boolean;
+            size?: 'small' | 'default' | 'large';
+            width?: number;
+            height?: number;
+            preview?: boolean;
+            fallback?: string;
+            render?: string;
+            customColor?: string;
+            fontWeight?: string;
+            fontFamily?: string;
+            fontStyle?: string;
+            textDecoration?: string;
+            topHighlight?: number;
+            highlightFrom?: string;
+            highlightTo?: string;
+            defaultFill?: string;
+            rankStyle?: 'square' | 'circle';
+            rankSize?: 'xs' | 'sm' | 'md';
+            medalTop?: number;
+            currencyField?: string;
+            compact?: boolean;
+            decimals?: number;
+        };
+    };
+    switchConfig?: {
+        showText?: boolean;
+        onText?: string;
+        offText?: string;
+    };
+    inputType?: 'text' | 'number' | 'color' | 'date' | 'select' | 'switch' | 'file';
+    datasource?: {
+        datasourceId?: string;
+        /** Pin a datasource version; omit to use the default version */
+        version?: number;
+        valueField?: string;
+        labelField?: string;
+    };
+    [key: string]: unknown;
+}
+export interface PaginationConfig {
+    pageSize: number;
+    current?: number;
+    showSizeChanger?: boolean;
+    showQuickJumper?: boolean;
+    showTotal?: boolean;
+    [key: string]: unknown;
+}

package/dist/components/types/editor.d.ts

@@ -0,0 +1,4 @@
+export type { BasePropertyEditorProps, ComponentEditorProps, DataSourceEditorProps, MockDataEditorProps, SchemaColumnSelectorProps, PropertyConfig, ComponentTypeConfig } from './editors';
+export type { DataSource, DataSourceParams, SchemaField, DatasetSchema, ColumnConfig, PaginationConfig } from './datasource';
+export type { StatisticItem } from './components';
+export type { ComponentTypeName } from './components';

package/dist/components/types/editors.d.ts

@@ -0,0 +1,91 @@
+import { DataSource, SchemaField, DatasetSchema, ColumnConfig, EnhancedDataSource } from './datasource';
+import { ComponentTypeName } from './components';
+
+export interface BasePropertyEditorProps {
+    component: {
+        id: string;
+        type: string;
+        props?: Record<string, unknown>;
+        dataSource?: DataSource;
+        mockData?: unknown;
+        parameterConfig?: unknown;
+        actions?: unknown[];
+        [key: string]: unknown;
+    };
+    onPropChange: (propKey: string, value: unknown) => void;
+    availablePages?: Array<{
+        key: string;
+        title: string;
+    }>;
+    availableParameters?: Array<{
+        label: string;
+        value: string;
+        type?: string;
+    }>;
+}
+export interface ComponentEditorProps extends BasePropertyEditorProps {
+    onDataSourceChange?: (dataSource: DataSource) => void;
+    onMockDataChange?: (mockData: unknown) => void;
+    onIdChange?: (id: string) => void;
+}
+export interface DataSourceEditorProps {
+    dataSource: EnhancedDataSource | null;
+    componentType: ComponentTypeName;
+    onChange: (dataSource: EnhancedDataSource) => void;
+    availableParameters?: Array<{
+        label: string;
+        value: string;
+        type?: string;
+    }>;
+}
+export interface MockDataEditorProps {
+    mockData: unknown;
+    componentType: ComponentTypeName;
+    onChange: (mockData: unknown) => void;
+}
+export interface SchemaColumnSelectorProps {
+    isOpen: boolean;
+    onOpenChange: (open: boolean) => void;
+    schema: DatasetSchema | null;
+    existingColumns: ColumnConfig[];
+    onSelect: (selectedFields: SchemaField[]) => void;
+}
+export interface PropertyConfig {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    label: string;
+    description?: string;
+    required?: boolean;
+    defaultValue?: any;
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    children?: {
+        [key: string]: PropertyConfig;
+    };
+}
+export interface ComponentTypeConfig {
+    type: ComponentTypeName;
+    title: string;
+    description: string;
+    icon: string;
+    propTypes: {
+        [key: string]: PropertyConfig;
+    };
+    dataSourceTypes?: {
+        [key: string]: {
+            label: string;
+            description?: string;
+            required?: boolean;
+            children: {
+                [key: string]: PropertyConfig;
+            };
+        };
+    };
+    mockData?: {
+        type: 'array' | 'object';
+        label: string;
+        description: string;
+        defaultValue: any;
+    };
+}

package/dist/components/types/host-adapters.d.ts

@@ -0,0 +1,35 @@
+export type GeniAppHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface GeniAppHostRequest {
+    url: string;
+    method: GeniAppHttpMethod;
+    body?: unknown;
+    params?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    responseType?: 'json' | 'blob' | 'text';
+    signal?: AbortSignal;
+}
+export interface GeniAppHostResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    code?: number;
+    message?: string;
+    error?: unknown;
+    timestamp?: string;
+}
+export interface GeniAppHostAdapters {
+    /** Platform transport used by Datasource, Task, Identity and Access renderers. */
+    request?: <T = unknown>(request: GeniAppHostRequest) => Promise<GeniAppHostResponse<T>>;
+    /** Application navigation. The default implementation uses react-router/browser history. */
+    navigate?: (path: string, options?: {
+        replace?: boolean;
+        state?: unknown;
+    }) => void;
+    /** Optional notification bridge for hosts that centralize user feedback. */
+    notify?: (notification: {
+        title: string;
+        description?: string;
+        variant?: 'default' | 'destructive' | 'success';
+    }) => void;
+    /** Optional namespaced storage implementation. Browser storage is used by default. */
+    storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+}

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

@@ -0,0 +1,7 @@
+export * from '../types';
+export * from './application';
+export * from './datasource';
+export * from './components';
+export * from './renderers';
+export * from './editors';
+export * from './parameters';

package/dist/components/types/parameters.d.ts

@@ -0,0 +1,59 @@
+export type ParameterValue = string | number | boolean | null | undefined | Record<string, any> | any[];
+export type ParameterRecord = Record<string, ParameterValue>;
+export interface TabParameterInfo {
+    tabId: string;
+    pageId: string;
+    parameters: ParameterRecord;
+    timestamp: number;
+}
+export interface ParameterChangeEvent {
+    key: string;
+    value: ParameterValue;
+    oldValue: ParameterValue;
+    source: 'user' | 'component' | 'system';
+    timestamp: number;
+    componentId?: string;
+}
+export type ParameterListener = (event: ParameterChangeEvent) => void;
+export interface ParameterSubscription {
+    parameterKeys: string[];
+    callback: ParameterListener;
+    componentId?: string;
+    immediate?: boolean;
+}
+export type ParameterReadyCallback = () => void;
+export interface ParameterContextValue {
+    currentTabParams: ParameterRecord;
+    getCurrentTabParams: () => ParameterRecord;
+    globalUrlParams: ParameterRecord;
+    updateTabParams: (params: Partial<ParameterRecord>, source?: 'user' | 'component' | 'system', componentId?: string) => void;
+    getTabParams: (tabId: string) => ParameterRecord;
+    cleanupTabParams: (activeTabIds: string[]) => void;
+    subscribeToParameter: (subscription: ParameterSubscription) => () => void;
+    unsubscribeFromParameter: (parameterKeys: string[], componentId?: string) => void;
+    broadcastParameterChange: (key: string, value: ParameterValue, source?: 'user' | 'component' | 'system', componentId?: string) => void;
+    markParametersReady: (parameterKeys: string[]) => void;
+    isParametersReady: (parameterKeys: string[]) => boolean;
+    subscribeToParametersReady: (parameterKeys: string[], callback: ParameterReadyCallback) => () => void;
+}
+export interface ParameterParseConfig {
+    enableJsonParsing: boolean;
+    defaultValues: ParameterRecord;
+    validationRules?: Record<string, (value: ParameterValue) => boolean>;
+}
+export interface ParameterProps {
+    pageParams?: ParameterRecord;
+    pageId?: string;
+    tabId?: string;
+}
+export interface ComponentParameterConfig {
+    enableParameterReceiving?: boolean;
+    parameterMapping?: Record<string, {
+        targetField: string;
+        targetType?: 'props' | 'dataSource' | 'filterCondition';
+        required?: boolean;
+        defaultValue?: ParameterValue;
+        transform?: (value: ParameterValue) => ParameterValue;
+    }>;
+    listenToParameters?: string[];
+}