@genispace/geniapp 0.2.0 → 0.4.0

package/dist/components/internal/workbench/components/renderers/WorkflowComponent/types.d.ts

@@ -0,0 +1,185 @@
+import { JSONSchema } from '../../../../shared-types/index.ts';
+
+export type StepComponentType = 'upload' | 'proposal' | 'result' | 'custom';
+export type ProposalRendererType = 'table' | 'form' | 'card' | 'custom';
+export type ActionType = 'approve' | 'edit' | 'reject' | 'submit' | 'cancel' | 'custom';
+export type DisplayFormat = 'json' | 'table' | 'card' | 'custom';
+export type AlertType = 'warning' | 'info' | 'success' | 'error';
+export interface WorkflowStep {
+    id: string;
+    title: string;
+    description: string;
+    icon?: string;
+    component: StepComponentType;
+    config: StepConfig;
+    order?: number;
+}
+export interface StepConfig {
+    upload?: UploadStepConfig;
+    proposal?: ProposalStepConfig;
+    result?: ResultStepConfig;
+    custom?: CustomStepConfig;
+}
+export interface UploadStepConfig {
+    accept?: string;
+    maxSize?: number;
+    multiple?: boolean;
+    preview?: boolean;
+    buttonText?: string;
+    placeholder?: string;
+    onUpload?: (file: File) => Promise<any>;
+}
+export interface ProposalStepConfig {
+    renderer: ProposalRendererType;
+    rendererConfig: ProposalRendererConfig;
+    actions: ActionButton[];
+    metadata?: MetadataField[];
+    alerts?: AlertConfig[];
+    editable?: boolean;
+    editMode?: 'inline' | 'form';
+}
+export interface ProposalRendererConfig {
+    type: ProposalRendererType;
+    table?: {
+        columns: TableColumn[];
+        dataPath?: string;
+        showHeader?: boolean;
+        striped?: boolean;
+    };
+    form?: {
+        schema: JSONSchema;
+        layout?: 'vertical' | 'horizontal' | 'grid';
+        showOptionalFields?: boolean;
+    };
+    card?: {
+        fields: CardField[];
+        layout?: 'grid' | 'list';
+    };
+    custom?: {
+        rendererId: string;
+        props?: Record<string, any>;
+    };
+}
+export interface TableColumn {
+    key: string;
+    label: string;
+    type?: 'text' | 'number' | 'currency' | 'date' | 'boolean';
+    format?: string;
+    align?: 'left' | 'center' | 'right';
+    width?: string | number;
+    render?: (value: any, record: any) => React.ReactNode;
+}
+export interface CardField {
+    key: string;
+    label: string;
+    type: 'text' | 'badge' | 'progress' | 'link' | 'custom';
+    valuePath?: string;
+    format?: string;
+    icon?: string;
+    color?: string;
+}
+export interface ActionButton {
+    id: string;
+    label: string;
+    variant: 'primary' | 'secondary' | 'destructive' | 'outline';
+    icon?: string;
+    action: ActionType;
+    handler?: string;
+    confirmMessage?: string;
+    disabled?: boolean | ((data: any) => boolean);
+    loading?: boolean;
+}
+export interface MetadataField {
+    key: string;
+    label: string;
+    valuePath: string;
+    icon?: string;
+    format?: 'date' | 'currency' | 'percentage' | 'text' | 'number';
+    color?: string;
+}
+export interface AlertConfig {
+    type: AlertType;
+    message: string;
+    icon?: string;
+    dismissible?: boolean;
+}
+export interface ResultStepConfig {
+    displayFormat: DisplayFormat;
+    showCopy?: boolean;
+    successMessage?: string;
+    errorMessage?: string;
+    customRenderer?: string;
+}
+export interface CustomStepConfig {
+    componentId: string;
+    props?: Record<string, any>;
+}
+export interface DataTransformConfig {
+    transformStepData?: (stepId: string, data: any, context?: any) => any;
+    prepareStepOutput?: (stepId: string, data: any, context?: any) => any;
+    validateStepData?: (stepId: string, data: any) => {
+        valid: boolean;
+        errors?: string[];
+    };
+    apiHandlers?: {
+        [stepId: string]: (data: any, config: any) => Promise<any>;
+    };
+}
+export interface WorkflowComponentProps {
+    agentId?: string;
+    /**
+     * Parse task id (resolved from `parseTaskIdentifier` at install). Step 1 runs the
+     * uploaded file through this task (document-reader → agent) to produce a
+     * structured record for review — it does NOT save. Preferred over `agentId`.
+     */
+    parseTaskId?: string;
+    /**
+     * Save task id (resolved from `saveTaskIdentifier`). Runs on confirm to write the
+     * reviewed record into the dataset (vector store). Two-phase: parse → review → save.
+     */
+    saveTaskId?: string;
+    /**
+     * Maps the uploaded file into the parse task's workflow input ports:
+     * `{urlNode}.{urlPort}` receives `{ url, filename }` (fed to document-reader),
+     * `{metaNode}.{metaPort}` receives `{ id, name, folderId }` (source provenance).
+     */
+    fileInput?: {
+        urlNode: string;
+        urlPort: string;
+        metaNode?: string;
+        metaPort?: string;
+    };
+    /**
+     * Maps the reviewed record into the save task's workflow input port:
+     * `{recordNode}.{recordPort}` receives the confirmed record object.
+     */
+    saveInput?: {
+        recordNode: string;
+        recordPort: string;
+    };
+    className?: string;
+    steps: WorkflowStep[];
+    transforms?: DataTransformConfig;
+    onStepComplete?: (stepId: string, data: any) => void;
+    onWorkflowComplete?: (finalData: any) => void;
+    onError?: (error: Error, stepId?: string) => void;
+    onAction?: (actionId: string, data: any) => void | Promise<void>;
+    useMockData?: boolean;
+    mockData?: Record<string, any>;
+    customRenderers?: {
+        [rendererId: string]: React.ComponentType<any>;
+    };
+    layout?: {
+        columns?: number;
+        gap?: string;
+    };
+}
+export interface WorkflowState {
+    currentStep: number;
+    stepData: Record<string, any>;
+    uploadedFile: File | null;
+    isProcessing: boolean;
+    error: Error | null;
+    isEditing?: boolean;
+    actionStatus: Record<string, 'idle' | 'loading' | 'success' | 'error'>;
+}

package/dist/components/internal/workbench/components/renderers/cell-editors/ColorEditor.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+
+interface ColorEditorProps {
+    value: string;
+    onChange: (value: string) => void;
+    onSave: () => void;
+    autoFocus?: boolean;
+    onKeyDown?: (e: React.KeyboardEvent) => void;
+}
+export declare const ColorEditor: React.FC<ColorEditorProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/cell-editors/DateEditor.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+
+export interface DateEditorProps {
+    value: string;
+    onChange: (value: string) => void;
+    onSave: () => void;
+    autoFocus?: boolean;
+    dateMode?: 'date' | 'datetime';
+    onKeyDown?: (e: React.KeyboardEvent) => void;
+}
+export declare const DateEditor: React.FC<DateEditorProps>;

package/dist/components/internal/workbench/components/renderers/cell-editors/FileEditor.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+
+interface FileEditorProps {
+    value?: string;
+    onChange: (value: string) => void;
+    onSave: () => void;
+}
+export declare const FileEditor: React.FC<FileEditorProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/cell-editors/NumberEditor.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+
+export interface NumberEditorProps {
+    value: string | number;
+    onChange: (value: number | string) => void;
+    onSave: () => void;
+    autoFocus?: boolean;
+    onKeyDown?: (e: React.KeyboardEvent) => void;
+}
+export declare const NumberEditor: React.FC<NumberEditorProps>;

package/dist/components/internal/workbench/components/renderers/cell-editors/SelectEditor.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+
+interface SelectEditorProps {
+    value: string | number;
+    onChange: (value: string | number) => void;
+    onSave: () => void;
+    datasourceId?: string;
+    version?: number;
+    valueField?: string;
+    labelField?: string;
+    autoFocus?: boolean;
+    staticOptions?: {
+        value: string;
+        label: string;
+    }[];
+    commitOnSelect?: boolean;
+}
+export declare const SelectEditor: React.FC<SelectEditorProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/cell-editors/SwitchEditor.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+
+export interface SwitchEditorProps {
+    value: boolean | string | number;
+    onChange: (value: boolean) => void;
+    onSave: () => void;
+    showText?: boolean;
+    onText?: string;
+    offText?: string;
+    className?: string;
+    onKeyDown?: (e: React.KeyboardEvent) => void;
+}
+export declare const SwitchEditor: React.FC<SwitchEditorProps>;

package/dist/components/internal/workbench/components/renderers/cell-editors/TextEditor.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+
+interface TextEditorProps {
+    value: string | number;
+    onChange: (value: string) => void;
+    onSave: () => void;
+    autoFocus?: boolean;
+    onKeyDown?: (e: React.KeyboardEvent) => void;
+}
+export declare const TextEditor: React.FC<TextEditorProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/cell-editors/index.d.ts

@@ -0,0 +1,7 @@
+export { TextEditor } from './TextEditor';
+export { NumberEditor } from './NumberEditor';
+export { ColorEditor } from './ColorEditor';
+export { DateEditor } from './DateEditor';
+export { SelectEditor } from './SelectEditor';
+export { SwitchEditor } from './SwitchEditor';
+export { FileEditor } from './FileEditor';

package/dist/components/internal/workbench/components/renderers/cells/swCells.d.ts

@@ -0,0 +1,49 @@
+import { default as React } from 'react';
+
+export type SwCellFormat = 'currency-compact' | 'currency-k' | 'compact-k' | 'percent1' | 'number2' | 'number' | 'plain';
+export type SwCellType = 'Stacked' | 'Delta' | 'PctBar' | 'RankBadge' | 'Currency' | 'Number' | 'Badge';
+/** Threshold rule → a class/token; first match wins. `eq` matches by string equality. */
+export interface ColorRule {
+    gte?: number;
+    gt?: number;
+    lte?: number;
+    lt?: number;
+    eq?: number | string;
+    /** Result token: a tailwind text class for cells, or a tone key for Badge. */
+    color: string;
+}
+/** First matching rule's color, else undefined. */
+export declare function matchColorRule(value: unknown, rules?: ColorRule[]): string | undefined;
+/** Badge tone tokens → bg+text classes. */
+export declare const BADGE_TONE: Record<string, string>;
+export interface SwCellProps {
+    format?: SwCellFormat;
+    mainField?: string;
+    subField?: string;
+    subFormat?: SwCellFormat;
+    subPrefix?: string;
+    subSuffix?: string;
+    subKind?: 'value' | 'diffPct' | 'diffPP' | 'signed';
+    baselineField?: string;
+    emptyDash?: boolean;
+    currency?: string;
+    topHighlight?: number;
+    highlightFrom?: string;
+    highlightTo?: string;
+    defaultFill?: string;
+    rankStyle?: 'square' | 'circle';
+    rankSize?: 'xs' | 'sm' | 'md';
+    medalTop?: number;
+    currencyField?: string;
+    compact?: boolean;
+    decimals?: number;
+    /** Text prefix (e.g. '#'). */
+    prefix?: string;
+    /** Static badge tone key (see BADGE_TONE); overridden by colorRules match. */
+    tone?: string;
+    /** Threshold rules: text color for Number, tone for Badge. */
+    colorRules?: ColorRule[];
+}
+export declare function formatSwValue(v: unknown, format?: SwCellFormat, currency?: string): string;
+export declare function renderSwCell(type: SwCellType, props: SwCellProps | undefined, row: Record<string, unknown>, columnField: string): React.ReactNode;
+export declare const SW_CELL_TYPES: readonly SwCellType[];

package/dist/components/internal/workbench/components/renderers/data/useBoundRows.d.ts

@@ -0,0 +1,9 @@
+import { DatabaseDataSourceConfig } from '../../../types/databaseDataSource';
+import { ComponentParameterConfig } from '../../../types/parameters';
+
+export declare function useBoundRows(config: DatabaseDataSourceConfig | null | undefined, cpc: ComponentParameterConfig | undefined, pageParams: Record<string, unknown>, id: string, label: string, extraParams?: Record<string, unknown>): {
+    rows: Record<string, unknown>[];
+    loading: boolean;
+    total: number;
+    totalPages: number;
+};

package/dist/components/internal/workbench/components/renderers/echarts/shared/colors.d.ts

@@ -0,0 +1,56 @@
+export declare const DEFAULT_GAUGE_TRACK_BASE = "#94a3b8";
+export declare const HORIZONTAL_BAR_LABEL_POSITION_MAP: Record<string, 'right' | 'insideLeft' | 'inside' | 'insideRight'>;
+export declare const VERTICAL_BAR_LABEL_POSITION_MAP: Record<string, 'top' | 'insideBottom' | 'inside' | 'insideTop'>;
+export declare const HORIZONTAL_BAR_LABEL_USE_CHART_FG_BELOW_FILL_RATIO = 0.58;
+export declare const HORIZONTAL_BAR_LABEL_CONTRAST_ON_LONG_OUTSIDE_FILL_RATIO = 0.88;
+export declare function parseEchartsBool(value: unknown, defaultValue: boolean): boolean;
+export declare function parseCssColorToRgb(color: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+export declare function relativeLuminance255(r: number, g: number, b: number): number;
+export declare function pickContrastTextOnBarFill(backgroundCssColor: string): string;
+export declare function isColorTooDarkForDarkMode(color: string): boolean;
+export declare function resolveGaugeColorWithDarkModeSafe(userColor: string | undefined, fallbackColor: string, themedForeground: string, isDarkMode: boolean): string;
+export declare function colorToRgba(color: string, alpha: number): string;
+export declare function lightenColor(color: string, ratio: number): string;
+export declare function darkenColor(color: string, ratio: number): string;
+export type { GradientStop } from '../../../../utils/chartGradientStops';
+export { getTopToBottomGradientStops, getLineAreaGradientStops } from '../../../../utils/chartGradientStops';
+export declare function buildTopToBottomGradientColor(color: string): unknown;
+export declare function rgbTripletToCss(rgb: {
+    r: number;
+    g: number;
+    b: number;
+}): string;
+export declare function toRgbTripletString(color: string, fallback: string): string;
+export declare function rgbDistanceSquared(a: {
+    r: number;
+    g: number;
+    b: number;
+}, b: {
+    r: number;
+    g: number;
+    b: number;
+}): number;
+export declare function ensureGaugeTrackBaseDistinct(trackBaseRgb: string, progressBase: string): string;
+export declare function buildGaugeTrackGradient(baseColor: string): unknown;
+export declare function ensureSolidGaugeTrackDistinct(trackCss: string, progressBase: string): string;
+export declare function buildLineAreaGradient(color: string): {
+    color: unknown;
+};
+export declare function coerceGaugeFontWeight(value: unknown, fallback: number): number;
+export declare function formatGaugeSeriesOffsetAxis(value: number | string | undefined, axis: 'x' | 'y', defaults: {
+    x: number | string;
+    y: string;
+}): number | string;
+export declare function computePieOutsideLabelLiftDy(params: {
+    labelRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    labelLinePoints?: number[][];
+}): number;

package/dist/components/internal/workbench/components/renderers/echarts/shared/index.d.ts

@@ -0,0 +1 @@
+export * from './colors';

package/dist/components/internal/workbench/components/renderers/editableTableApiErrors.d.ts

@@ -0,0 +1,3 @@
+import { TFunction } from 'i18next';
+
+export declare function getDataSourceTableApiErrorMessage(error: unknown, t: TFunction): string;

package/dist/components/internal/workbench/components/renderers/editableTableDictionary.d.ts

@@ -0,0 +1,13 @@
+import { CSSProperties } from 'react';
+import { DictionaryDataSourceConfig, TableColumnType } from '../../types/renderers';
+
+export declare function fetchDictionaryRows(config: DictionaryDataSourceConfig | undefined): Promise<Record<string, unknown>[]>;
+export declare function findMatchedDictionaryItem(record: Record<string, unknown>, column: TableColumnType, dictionaryRows: Record<string, unknown>[] | undefined): Record<string, unknown> | null;
+export declare function getDictionaryCellPresentation(record: Record<string, unknown>, column: TableColumnType, dictionaryRows: Record<string, unknown>[] | undefined): {
+    text: string;
+    style: CSSProperties;
+};
+export declare function getDictionarySelectStaticOptions(column: TableColumnType, dictionaryRows: Record<string, unknown>[] | undefined): {
+    value: string;
+    label: string;
+}[];

package/dist/components/internal/workbench/components/renderers/editableTableFormatters.d.ts

@@ -0,0 +1,11 @@
+import { EditableTableColumnConfig } from './EditableTable.types';
+
+export type DateRenderFormat = 'yyyy-MM-dd' | 'yyyy-MM-dd HH:mm:ss';
+export declare function getDateInputMode(column: EditableTableColumnConfig): 'date' | 'datetime';
+export declare function getDateRenderFormat(column: EditableTableColumnConfig): DateRenderFormat;
+export declare function formatDateForEditableTable(value: unknown, format: DateRenderFormat): string;
+export declare function toNativeDateInputValue(value: unknown, mode: 'date' | 'datetime'): string;
+export declare function fromNativeDateInputString(input: string, mode: 'date' | 'datetime'): string;
+export declare function getSwitchChecked(value: unknown): boolean;
+export declare function normalizeColorDisplay(value: unknown): string;
+export declare function formatNumberDisplay(value: unknown): string;

package/dist/components/internal/workbench/components/renderers/editableTableWriteDatasourceId.d.ts

@@ -0,0 +1,8 @@
+import { TableAction } from '../../types';
+
+export declare function getEditableTableWriteDatasourceId(tableDatabaseConfig: {
+    datasourceId?: string;
+} | null | undefined, rowClickOrAction: TableAction | null | undefined): string | undefined;
+export declare function getEditableTableWriteDatasourceVersion(tableDatabaseConfig: {
+    version?: number;
+} | null | undefined, rowClickOrAction: TableAction | null | undefined): number | undefined;

package/dist/components/internal/workbench/components/renderers/filterOptionCache.d.ts

@@ -0,0 +1,33 @@
+export interface FilterOptionCacheEntry {
+    rows: Record<string, unknown>[];
+    dataStamp?: string;
+    cachedAt: number;
+}
+/** cacheKey: filterOpts:{datasourceId}:{version}:{fields}:{scope}:{paramsHash}:{lang}
+ *  datasourceId is globally unique (no workbench namespace needed).
+ *  - scope is part of the entry's identity (it selects the dataStamp that validates the
+ *    entry), so two fields sharing a datasourceId but different scopes must not collide.
+ *  - fields (projected label/value columns) also identifies the rows: two fields can query
+ *    the same datasourceId but project different columns, which must not share an entry. */
+export declare function buildFilterOptionCacheKey(parts: {
+    datasourceId: string;
+    version?: number;
+    fields?: string[];
+    scope?: string;
+    paramsHash?: string;
+    lang: string;
+}): string;
+export declare function getFilterOptionCache(key: string): FilterOptionCacheEntry | null;
+export declare function setFilterOptionCache(key: string, entry: FilterOptionCacheEntry): void;
+/** Decide whether a cache entry is still usable. */
+export declare function isFilterOptionCacheValid(entry: FilterOptionCacheEntry | null, opts: {
+    dataStamp?: string;
+    ttlMs?: number;
+    now?: number;
+}): entry is FilterOptionCacheEntry;
+/** Stable hash for datasource parameters (used in cacheKey for dependsOn / param variants). */
+export declare function hashFilterParams(params: Record<string, unknown> | undefined): string;
+export declare function loadFilterOptions(cacheKey: string, datasourceId: string, outputFields: string[], opts: {
+    dataStamp?: string;
+    ttlMs?: number;
+}, useCache?: boolean, params?: Record<string, unknown>, version?: number): Promise<Record<string, unknown>[]>;

package/dist/components/internal/workbench/components/renderers/filterSelectionMemory.d.ts

@@ -0,0 +1,11 @@
+export interface FilterSelectionMemory {
+    v: string;
+    start?: string;
+    end?: string;
+    tab?: string;
+    savedAt: number;
+}
+export declare const isYmdDateString: (s: unknown) => s is string;
+export declare function buildFilterMemoryKey(workbenchId: string | undefined, componentId: string | undefined, filterKey: string): string;
+export declare function readFilterSelectionMemory(key: string, validPresets: string[]): FilterSelectionMemory | null;
+export declare function writeFilterSelectionMemory(key: string, m: Omit<FilterSelectionMemory, 'savedAt'>): void;

package/dist/components/internal/workbench/components/renderers/formSizing.d.ts

@@ -0,0 +1,14 @@
+import { CSSProperties } from 'react';
+
+export interface FormHeightConfig {
+    height?: number;
+    heightMode?: 'auto' | 'fixed' | 'fullscreen';
+}
+/**
+ * Resolves the form's outer height from exactly one owner.
+ *
+ * Grid24 owns height through rowSpan and always wins while the form is inside
+ * an imposed cell. Standalone forms retain their explicit fixed/fullscreen
+ * behavior for backward compatibility.
+ */
+export declare function resolveFormContainerStyle(config: FormHeightConfig, fillCell: boolean, formTopOffset: number): CSSProperties;

package/dist/components/internal/workbench/components/renderers/heroCardRows.d.ts

@@ -0,0 +1,30 @@
+import { default as React } from 'react';
+import { HeroRow, HeroCardAppearance } from './heroCardUtils';
+
+export interface HeroFontSizes {
+    /** title-bar product/section name */
+    title: number;
+    /** the big metric (hero) number */
+    value: number;
+    /** muted labels, captions, LY, price labels, descriptive text */
+    label: number;
+    /** secondary inline numbers: key-value / kpi / price values, deltas */
+    number: number;
+    /** status / trend badges */
+    badge: number;
+}
+export declare const DEFAULT_HERO_FONT_SIZES: HeroFontSizes;
+interface Ctx {
+    row: Record<string, unknown> | null;
+    ap: HeroCardAppearance;
+    onDark: boolean;
+    currency: unknown;
+    lang: string;
+    fs: HeroFontSizes;
+    /** Narrow-flow layout (mobile / studio phone frame): rows may wrap/truncate.
+        When false the markup must stay byte-identical to the original desktop rendering. */
+    narrow: boolean;
+}
+export declare function renderHeroRow(rowCfg: HeroRow, idx: number, ctx: Ctx): React.ReactNode;
+export declare function renderHeroRows(rows: HeroRow[], ctx: Ctx): React.ReactNode;
+export {};