@genispace/geniapp 0.2.0 → 0.4.0

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

@@ -0,0 +1,164 @@
+export type HeroCardTheme = 'primary' | 'success' | 'info' | 'warning' | 'destructive' | 'muted';
+export type HeroRowFormat = 'raw' | 'number' | 'percent' | 'currency' | 'currency-compact' | 'compact-k' | 'wan';
+export interface HeroKpiItem {
+    label: string;
+    field: string;
+    lyField?: string;
+    diff?: 'absolute' | 'pp' | 'percent';
+    format?: HeroRowFormat;
+    /** Fixed currency for this item's symbol (e.g. 'CNY' for CNY-based stats on a local-currency card); defaults to row.currency. */
+    currency?: string;
+}
+export type HeroRow = {
+    type: 'text';
+    text?: unknown;
+    field?: string;
+    format?: HeroRowFormat;
+    size?: 'xs' | 'sm' | 'base';
+    muted?: boolean;
+} | {
+    type: 'metric';
+    field: string;
+    format?: HeroRowFormat;
+    prefix?: string;
+    suffix?: string;
+    label?: string;
+    lyField?: string;
+    lyLabel?: string;
+    lyFormat?: HeroRowFormat;
+    currency?: string; /** Render LY inline in parens on the same line as the value (e.g. Y3.6K (LY Y323.1K)) instead of below it. */
+    lyInline?: boolean; /** Shrink the row's font sizes so value + inline LY always fit on ONE line (replaces the narrow-flow wrap point). */
+    autoFit?: boolean;
+} | {
+    type: 'trend-badges';
+    items: Array<{
+        label: string;
+        field: string;
+        suffix?: string;
+    }>; /** Shrink the strip's font sizes so all badges stay on ONE line (replaces the narrow-flow flex-wrap). */
+    autoFit?: boolean;
+} | {
+    type: 'key-value';
+    label: string;
+    field: string;
+    format?: HeroRowFormat;
+    prefix?: string;
+    suffix?: string;
+    signedColor?: boolean;
+    signed?: boolean;
+    currency?: string; /** Shrink the row's font sizes so label + value always fit on ONE line. */
+    autoFit?: boolean;
+} | {
+    type: 'dual-key-value';
+    label: unknown;
+    label2: unknown;
+    field: string;
+    field2: string;
+    format?: HeroRowFormat;
+    format2?: HeroRowFormat;
+    currency?: string;
+    signed2?: boolean;
+    signedColor2?: boolean; /** Shrink the row's font sizes so all parts always fit on ONE line. */
+    autoFit?: boolean;
+} | {
+    type: 'progress';
+    field: string;
+    max?: number;
+} | {
+    type: 'kpi-list';
+    columns?: 1 | 2;
+    items: HeroKpiItem[];
+    valueAlign?: 'left' | 'right'; /** Shrink each item row's font sizes so label + value + delta always fit on ONE line. */
+    autoFit?: boolean;
+} | {
+    type: 'title-bar';
+    titleField: string;
+    statusField?: string;
+    statusMap?: Record<string, {
+        label?: unknown;
+        class?: string;
+    }>;
+} | {
+    type: 'price-row';
+    retailLabel?: unknown;
+    retailField: string;
+    sellingLabel?: unknown;
+    sellingField: string;
+    discountField?: string;
+    discountThreshold?: number;
+    discountOff?: boolean;
+    discountLabel?: unknown;
+    discountTextField?: string;
+    currencyField?: string;
+} | {
+    type: 'divider';
+} | {
+    type: 'spacer';
+    size?: number;
+};
+export interface HeroBanner {
+    imageField?: string;
+    colorField?: string;
+    colorMap?: Record<string, string>;
+    emojiField?: string;
+    emojiMap?: Record<string, string>;
+    fallbackColor?: string;
+    fallbackEmoji?: string;
+    height?: number;
+    imageFit?: 'cover' | 'contain';
+    imageBg?: string;
+}
+export declare const HERO_GRADIENT_PRESETS: Record<string, {
+    from: string;
+    to: string;
+}>;
+export interface HeroCardProps {
+    className?: string;
+    rows?: HeroRow[];
+    /** Editor quick preset (on selection, prefer writing concrete gradientFrom/To values directly; lowest priority in the render fallback order). */
+    gradientPreset?: string;
+    /** Static gradient colors (concrete values set explicitly in the page config). */
+    gradientFrom?: string;
+    gradientTo?: string;
+    /** Gradient column bindings: colors read from row data (values supplied by the datasource; highest priority — audit decision §2.4). */
+    gradientFromField?: string;
+    gradientToField?: string;
+    cardWidth?: number | 'full';
+    shell?: 'gradient' | 'muted' | 'detail';
+    banner?: HeroBanner;
+    /** Render ONE card per datasource row (N rows -> N sibling cards) instead of only row[0].
+     *  Each card uses the exact same single-card markup; per-row titles come from row-bound
+     *  rows (e.g. title-bar's titleField). False = original single-card behavior. */
+    cardPerRow?: boolean;
+    titleFontSize?: number;
+    valueFontSize?: number;
+    labelFontSize?: number;
+    numberFontSize?: number;
+    badgeFontSize?: number;
+}
+export declare function formatCompactCurrency(raw: unknown, currency?: unknown): string;
+export declare function formatCompactK(raw: unknown): string;
+export declare function formatCurrencyK(raw: unknown, currency?: unknown): string;
+export declare function formatHeroRowValue(raw: unknown, format?: HeroRowFormat, currency?: unknown, prefix?: string, suffix?: string): string;
+export interface HeroCardAppearance {
+    containerClass: string;
+    containerStyle?: {
+        background?: string;
+    };
+    mutedTextClass: string;
+    strongTextClass: string;
+    badgeClass: string;
+    trendClass: string;
+    progressBarColor: string;
+    progressTrackColor?: string;
+}
+export declare const HERO_DETAIL_APPEARANCE: HeroCardAppearance;
+export declare function normalizeHeroTheme(theme?: string): HeroCardTheme;
+export declare function resolveHeroCardAppearance(props: {
+    theme?: HeroCardTheme | string;
+    gradientFrom?: string;
+    gradientTo?: string;
+}): HeroCardAppearance;
+export declare function readRowField(row: Record<string, unknown> | null | undefined, field?: string): unknown;
+/** Normalize progress when SQL returns 0-100 or 0-1. */
+export declare function normalizeProgressValue(raw: unknown): number;

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

@@ -0,0 +1,38 @@
+import { ListRenderer } from './ListRenderers';
+import { renderByType } from './BaseRenderers';
+import { ContainerRenderer } from './ContainerRenderers';
+import { default as StatisticGroup } from './StatisticGroup';
+import { default as TableRenderer } from './TableRenderer';
+import { default as EditableTableRenderer } from './EditableTableRenderer';
+import { default as TabsRenderer } from './TabsRenderer';
+import { default as CardRenderer } from './CardRenderer';
+import { default as DataGridCard } from './DataGridCard';
+import { default as ChartRenderer } from './ChartRenderer';
+import { default as RadarChartRenderer } from './RadarChartRenderer';
+import { default as MapChartRenderer } from './MapChartRenderer';
+import { default as EChartsChartRenderer } from './EChartsChartRenderer';
+import { default as FilterPanelRenderer } from './FilterPanelRenderer';
+import { TypographyRenderer, TextRenderer, TitleRenderer, ParagraphRenderer } from './TypographyRenderer';
+import { default as HeroCardRenderer } from './HeroCardRenderer';
+import { default as MetricCarouselRenderer } from './MetricCarouselRenderer';
+import { default as CollapsePanelRenderer } from './CollapsePanelRenderer';
+import { default as AnalyticsTableRenderer } from './AnalyticsTableRenderer';
+import { default as ProductReportRenderer } from './ProductReportRenderer';
+import { default as ProductDetailRenderer } from './ProductDetailRenderer';
+import { default as TileGridRenderer } from './TileGridRenderer';
+import { default as RingStatRenderer } from './RingStatRenderer';
+import { default as PublishHistoryRenderer } from './PublishHistoryRenderer';
+import { default as PublishPreviewEntryRenderer } from './PublishPreviewEntryRenderer';
+import { default as NavTileRenderer } from './NavTileRenderer';
+import { default as AppIdentityListRenderer } from './AppIdentityListRenderer';
+import { default as IdentityAttributeAssignRenderer } from './IdentityAttributeAssignRenderer';
+import { default as LoadingRenderer } from './LoadingRenderer';
+import { default as TaskInputRenderer } from './TaskInputRenderer';
+import { default as ServiceDeskReporterRenderer } from './ServiceDeskReporterRenderer';
+import { default as SimpleTreeRenderer } from './SimpleTreeRenderer';
+import { default as CustomContentRenderer } from './CustomContentRenderer';
+import { ListRendererProps, ContainerRendererProps, StatisticGroupProps, TableRendererProps, TabsRendererProps, CardRendererProps, DataGridCardProps, TextRendererProps, TitleRendererProps, ParagraphRendererProps, TypographyProps, TypographyContentSegment, TypographyDatabaseSegment, TypographySegmentTextType, TaskInputRendererProps, SimpleTreeRendererProps, RadarChartRendererProps, FilterPanelRendererProps, RenderersMap } from './types';
+
+declare const renderers: RenderersMap;
+export type { ListRendererProps, ContainerRendererProps, StatisticGroupProps, TableRendererProps, TabsRendererProps, CardRendererProps, DataGridCardProps, TextRendererProps, TitleRendererProps, ParagraphRendererProps, TypographyProps, TypographyContentSegment, TypographyDatabaseSegment, TypographySegmentTextType, TaskInputRendererProps, SimpleTreeRendererProps, RadarChartRendererProps, FilterPanelRendererProps };
+export { ListRenderer, ContainerRenderer, renderByType, StatisticGroup, TableRenderer, EditableTableRenderer, DataGridCard, TabsRenderer, CardRenderer, ChartRenderer, RadarChartRenderer, MapChartRenderer, EChartsChartRenderer, FilterPanelRenderer, HeroCardRenderer, MetricCarouselRenderer, CollapsePanelRenderer, AnalyticsTableRenderer, ProductReportRenderer, ProductDetailRenderer, TileGridRenderer, RingStatRenderer, PublishHistoryRenderer, PublishPreviewEntryRenderer, NavTileRenderer, AppIdentityListRenderer, IdentityAttributeAssignRenderer, TypographyRenderer, TextRenderer, TitleRenderer, ParagraphRenderer, LoadingRenderer, renderers, TaskInputRenderer, ServiceDeskReporterRenderer, CustomContentRenderer, SimpleTreeRenderer };

package/dist/components/internal/workbench/components/renderers/list/ListActionButton.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { TableAction } from '../../../types';
+import { TableActionButtonPlacement } from '../../../utils/tableActionButtonRender';
+
+interface ListActionButtonProps {
+    action: TableAction;
+    placement: TableActionButtonPlacement;
+    onClick: (e: React.MouseEvent) => void;
+}
+export declare const ListActionButton: React.FC<ListActionButtonProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/list/ListDataTable.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { ListColumn } from '../../../types/renderers';
+
+interface ListDataTableProps {
+    columns: ListColumn[];
+    data: Record<string, unknown>[];
+    allData: Record<string, unknown>[];
+    className?: string;
+    /** Mobile only: pin the header below the FilterPanel on page scroll. Off by default. */
+    freezeFirstColumn?: boolean;
+}
+export declare const ListDataTable: React.FC<ListDataTableProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/list/ListProgressBar.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+
+export interface ListProgressBarProps {
+    value: number;
+    max?: number;
+    fullWidth?: boolean;
+    size?: 'sm' | 'md' | 'lg';
+    barColor?: string;
+    trackColor?: string;
+    className?: string;
+}
+export declare const ListProgressBar: React.FC<ListProgressBarProps>;

package/dist/components/internal/workbench/components/renderers/list/ListTaskExecuteDialog.d.ts

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { TableAction } from '../../../types';
+import { TableDataType } from '../../../types/renderers';
+
+export interface ListTaskExecuteDialogState {
+    isOpen: boolean;
+    action: TableAction | null;
+    record: TableDataType | null;
+}
+interface ListTaskExecuteDialogProps {
+    dialog: ListTaskExecuteDialogState;
+    pageParams?: Record<string, unknown>;
+    onClose: () => void;
+    onRefresh?: () => void;
+}
+export declare const ListTaskExecuteDialog: React.FC<ListTaskExecuteDialogProps>;
+export {};

package/dist/components/internal/workbench/components/renderers/list/listActionUtils.d.ts

@@ -0,0 +1,18 @@
+import { TableAction, NavigationItem } from '../../../types';
+import { TableDataType } from '../../../types/renderers';
+import { ParameterRecord } from '../../../types/parameters';
+
+export declare function resolveWorkbenchIdFromPath(pathname: string, paramWorkbenchId?: string): string | undefined;
+export declare function buildListNavigateUrl(targetPage: string, workbenchId: string | undefined, queryString: string): string;
+export interface ExecuteListNavigateOptions {
+    action: TableAction;
+    record: TableDataType;
+    pageParams?: ParameterRecord;
+    workbenchId?: string;
+    pathname: string;
+    navigate: (url: string) => void;
+    navigationItems?: NavigationItem[];
+}
+/** Align List navigate behavior with TableRenderer (open-tab + workbench path fallback). */
+export declare function executeListNavigate({ action, record, pageParams, workbenchId: paramWorkbenchId, pathname, navigate, navigationItems, }: ExecuteListNavigateOptions): void;
+export declare function buildListActionParameters(action: TableAction, record: TableDataType, pageParams?: ParameterRecord): ParameterRecord;

package/dist/components/internal/workbench/components/renderers/list/listCellRender.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { ListColumn } from '../../../types/renderers';
+import { ListProgressContext } from './listFormatUtils';
+
+export interface ListCellRenderContext extends ListProgressContext {
+    index: number;
+    highlighted?: boolean;
+}
+export declare function renderListCellValue(column: ListColumn, record: Record<string, unknown>, context?: Partial<ListCellRenderContext>): React.ReactNode;

package/dist/components/internal/workbench/components/renderers/list/listConfig.d.ts

@@ -0,0 +1,67 @@
+import { ListColumn, ListItemLayoutConfig, ListRendererProps } from '../../../types/renderers';
+import { TableAction } from '../../../types';
+
+export declare function resolveListActions(actions?: TableAction[], rowActions?: TableAction[], toolbarActions?: TableAction[]): {
+    rowActions: TableAction[];
+    toolbarActions: TableAction[];
+    rowClickActions: TableAction[];
+};
+export declare function resolveRowClickAction(itemLayoutConfig?: ListItemLayoutConfig, rowClickActions?: TableAction[]): TableAction | undefined;
+export declare function isListActionVisible(action: TableAction, record: Record<string, unknown>): boolean;
+export interface ListColumnSlots {
+    title?: ListColumn;
+    titleSuffix: ListColumn[];
+    subtitle?: ListColumn;
+    description?: ListColumn;
+    avatar?: ListColumn;
+    icon?: ListColumn;
+    tags: ListColumn[];
+    custom: ListColumn[];
+    hasActionsSlot: boolean;
+    prefix?: ListColumn;
+    meta?: ListColumn;
+    progress?: ListColumn;
+    extraPrimary?: ListColumn;
+    extraSecondary?: ListColumn;
+    extraOthers: ListColumn[];
+    /** One horizontal row at the top of the row tail (ranking template right-block top row, e.g. rank-change badge group); columns sorted by slotIndex. */
+    extraTop: ListColumn[];
+    metrics: ListColumn[];
+}
+export declare function buildListColumnSlots(columns: ListColumn[]): ListColumnSlots;
+export declare const EMPTY_DEFAULT_SORT: Array<{
+    field: string;
+    direction: 'asc' | 'desc';
+}>;
+export declare function sortStateToQuery(sortState: Array<{
+    field: string;
+    direction: 'asc' | 'desc';
+}>): string | undefined;
+export interface ListColumnPreset {
+    columns: ListColumn[];
+    itemLayoutConfig?: ListItemLayoutConfig;
+    /** List props aligned with column slot layout (see list-dashboard-demo.json) */
+    listProps?: Partial<Pick<ListRendererProps, 'split' | 'pagination' | 'defaultSort' | 'showRefresh' | 'selectionType'>>;
+}
+/** Subtask List — list-dashboard-demo.json comp-subtask-list */
+export declare const SUBTASK_LIST_PRESET: ListColumnPreset;
+/** Top 10 SKUs — list-dashboard-demo.json comp-top-skus */
+export declare const TOP_SKUS_PRESET: ListColumnPreset;
+/** Top 5 Stores — list-dashboard-demo.json comp-top-stores */
+export declare const TOP_STORES_PRESET: ListColumnPreset;
+/** Product card list — mobile SKU catalog (title + status + 4 KPI metrics) */
+export declare const PRODUCT_CARD_PRESET: ListColumnPreset;
+export declare const LIST_COLUMN_PRESETS: readonly [{
+    readonly id: "subtask-list";
+    readonly preset: ListColumnPreset;
+}, {
+    readonly id: "top-skus";
+    readonly preset: ListColumnPreset;
+}, {
+    readonly id: "top-stores";
+    readonly preset: ListColumnPreset;
+}, {
+    readonly id: "product-card";
+    readonly preset: ListColumnPreset;
+}];
+export declare function applyListColumnPreset(preset: ListColumnPreset, onPropChange: (key: string, value: unknown) => void): void;

package/dist/components/internal/workbench/components/renderers/list/listCsvExport.d.ts

@@ -0,0 +1,4 @@
+import { ListColumn } from '../../../types/renderers';
+
+export declare function generateListCsv(rows: Record<string, unknown>[], columns: ListColumn[]): string;
+export declare function downloadListCsv(content: string, filename: string): void;

package/dist/components/internal/workbench/components/renderers/list/listFormatUtils.d.ts

@@ -0,0 +1,13 @@
+import { ListRenderProps } from '../../../types/renderers';
+
+export interface ListProgressContext {
+    record: Record<string, unknown>;
+    pageData: Record<string, unknown>[];
+    allData: Record<string, unknown>[];
+}
+export declare function formatListNumber(value: unknown, props?: ListRenderProps): string;
+export declare function calcProgressValue(raw: unknown, props?: ListRenderProps, context?: ListProgressContext): number;
+export declare function resolveListRank(props: ListRenderProps, context: {
+    index: number;
+    record: Record<string, unknown>;
+}): number;

package/dist/components/internal/workbench/components/renderers/list/listItemTemplates.d.ts

@@ -0,0 +1,32 @@
+import { default as React } from 'react';
+import { ListItemLayoutConfig } from '../../../types/renderers';
+import { ListColumnSlots } from './listConfig';
+import { ListFontSizes } from '../ListRenderers';
+
+export interface ListItemTemplateContext {
+    item: Record<string, unknown>;
+    index: number;
+    rowId: string | number;
+    slots: ListColumnSlots;
+    itemLayoutConfig?: ListItemLayoutConfig;
+    split?: boolean;
+    isSelected?: boolean;
+    pageData: Record<string, unknown>[];
+    allData: Record<string, unknown>[];
+    selectionCheckbox?: React.ReactNode;
+    rowActions?: React.ReactNode;
+    onRowClick?: () => void;
+    /** Current/highlighted row (left border + tint). */
+    highlighted?: boolean;
+    /** Status dots node rendered before the title. */
+    statusDots?: React.ReactNode;
+    /** Current/highlight badge node rendered after the title. */
+    highlightBadge?: React.ReactNode;
+    /** Per-role content font sizes (px); falls back to readable defaults. */
+    fontSizes?: ListFontSizes;
+    /** Narrow container (real mobile + studio phone frame); hook is called in the component, not here. */
+    narrow?: boolean;
+}
+export declare function renderRankingListItem(ctx: ListItemTemplateContext): React.ReactNode;
+export declare function renderProductCardListItem(ctx: ListItemTemplateContext): React.ReactNode;
+export declare function renderProgressTaskListItem(ctx: ListItemTemplateContext): React.ReactNode;

package/dist/components/internal/workbench/components/renderers/list/listViewToggleUtils.d.ts

@@ -0,0 +1,5 @@
+import { ViewType } from '../shared/ViewToggleButton';
+
+/** Legacy configs used `list` for the visual/card view — treat as chart view. */
+export declare function normalizeViewType(raw: unknown): ViewType;
+export declare function isDataViewType(viewType: ViewType): boolean;

package/dist/components/internal/workbench/components/renderers/list/useListActions.d.ts

@@ -0,0 +1,38 @@
+import { TableAction, NavigationItem } from '../../../types';
+import { TableDataType } from '../../../types/renderers';
+import { ParameterRecord } from '../../../types/parameters';
+
+interface UseListActionsOptions {
+    onRefresh: () => void;
+    pageParams?: ParameterRecord;
+    navigationItems?: NavigationItem[];
+}
+export declare function useListActions({ onRefresh, pageParams, navigationItems, }: UseListActionsOptions): {
+    executeAction: (action: TableAction, record: TableDataType) => Promise<void>;
+    actionFormDialog: {
+        isOpen: boolean;
+        action: TableAction | null;
+        record: TableDataType | null;
+    };
+    closeActionForm: () => void;
+    submitActionForm: (formValues: Record<string, unknown>) => Promise<void>;
+    confirmDialog: {
+        isOpen: boolean;
+        message: string;
+        onConfirm: (() => void) | null;
+    };
+    closeConfirm: () => void;
+    taskExecuteDialog: {
+        isOpen: boolean;
+        action: TableAction | null;
+        record: TableDataType | null;
+    };
+    closeTaskExecute: () => void;
+    runDatabaseUpdate: (action: TableAction, record: TableDataType, formValues?: Record<string, unknown>) => Promise<void>;
+    runDatabaseDelete: (action: TableAction, record: TableDataType, formValues?: Record<string, unknown>) => Promise<void>;
+    runDatabaseInsert: (action: TableAction, record: TableDataType, formValues?: Record<string, unknown>) => Promise<void>;
+    runDatasetUpdate: (action: TableAction, record: TableDataType, formValues?: Record<string, unknown>) => Promise<void>;
+    runDatasetInsert: (action: TableAction, record: TableDataType, formValues?: Record<string, unknown>) => Promise<void>;
+    runDatasetDelete: (action: TableAction, record: TableDataType, formValues?: Record<string, unknown>) => Promise<void>;
+};
+export {};

package/dist/components/internal/workbench/components/renderers/list/useListDataSource.d.ts

@@ -0,0 +1,58 @@
+import { DatabaseDataSourceConfig } from '../../../types/databaseDataSource';
+import { EnhancedDataSource } from '../../../types/datasource';
+import { ComponentParameterConfig } from '../../../types/parameters';
+import { ParameterConfig } from '../../../types';
+
+export interface UseListDataSourceOptions {
+    id?: string;
+    useMockData?: boolean;
+    mockData?: Record<string, unknown>[];
+    externalDataSource?: Record<string, unknown>[];
+    externalLoading?: boolean;
+    databaseDataSourceConfig?: DatabaseDataSourceConfig | null;
+    enhancedDataSource?: EnhancedDataSource | null;
+    parameterConfig?: ParameterConfig;
+    componentParameterConfig?: ComponentParameterConfig;
+    pageParams?: Record<string, unknown>;
+    defaultSort?: Array<{
+        field: string;
+        direction: 'asc' | 'desc';
+    }>;
+    enableSort?: boolean;
+    pageSize?: number;
+    paginationEnabled?: boolean;
+    /**
+     * Extra flat query params merged into the datasource request (e.g. a quick-filter pill value).
+     * Changing these re-queries the datasource (server-side filtering).
+     */
+    additionalParams?: Record<string, unknown>;
+}
+export declare function useListDataSource(options: UseListDataSourceOptions): {
+    data: Record<string, unknown>[];
+    allData: Record<string, unknown>[];
+    loading: boolean;
+    currentPage: number;
+    setCurrentPage: import('react').Dispatch<import('react').SetStateAction<number>>;
+    pageSize: number;
+    setPageSize: import('react').Dispatch<import('react').SetStateAction<number>>;
+    total: number;
+    sortState: {
+        field: string;
+        direction: "asc" | "desc";
+    }[];
+    setSortState: import('react').Dispatch<import('react').SetStateAction<{
+        field: string;
+        direction: "asc" | "desc";
+    }[]>>;
+    refresh: () => boolean;
+    dbPagination: {
+        total: number;
+        current_page: number;
+        total_pages: number;
+        limit: number;
+        offset: number;
+        has_more: boolean;
+    };
+    enableSort: boolean;
+    useServerPagination: boolean;
+};

package/dist/components/internal/workbench/components/renderers/list/useListSelectionEmit.d.ts

@@ -0,0 +1,22 @@
+import { ParameterConfig } from '../../../types';
+
+interface UseListSelectionEmitOptions {
+    componentId?: string;
+    rowKey: string;
+    selectionType: 'none' | 'single' | 'multiple';
+    selectedRowIds: (string | number)[];
+    allData: Record<string, unknown>[];
+    parameterConfig?: ParameterConfig;
+    componentParameterConfig?: {
+        enableParameterReceiving?: boolean;
+        listenToParameters?: string[];
+        enableCommunication?: boolean;
+        enableEmit?: boolean;
+        triggers?: Record<string, {
+            enabled?: boolean;
+            parameters?: string[];
+        }>;
+    };
+}
+export declare function useListSelectionEmit({ componentId, rowKey, selectionType, selectedRowIds, allData, parameterConfig, componentParameterConfig, }: UseListSelectionEmitOptions): void;
+export {};

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

@@ -0,0 +1,46 @@
+import { TableAction, TableActionConfig } from '../../types';
+import { BilingualText } from '../../utils/workbenchDisplayLocale';
+
+export type NavTileVariant = 'default' | 'compact' | 'outline';
+/**
+ * Inclusive range for the "columns per row" property. The minimum of 1 keeps
+ * the layout single-column; the maximum of 24 matches the parent
+ * `grid-24` container used by the workbench so a tile can never exceed
+ * the surrounding grid's track count.
+ */
+export declare const MIN_NAV_TILE_COLUMNS = 1;
+export declare const MAX_NAV_TILE_COLUMNS = 24;
+/** Default column count when none is provided or the value is invalid. */
+export declare const DEFAULT_NAV_TILE_COLUMNS = 2;
+/** Allowed column count for a NavTile row, expressed as a numeric range. */
+export type NavTileColumns = number;
+export interface NavTileItem {
+    id?: string;
+    /** Plain string OR bilingual { zh, en } — resolved via resolveBilingualText at render time. */
+    title: BilingualText;
+    subtitle?: BilingualText;
+    icon?: string;
+    badge?: string;
+    disabled?: boolean;
+    targetPage?: string;
+    parameterMapping?: TableActionConfig['parameterMapping'];
+}
+export interface NavTileProps {
+    items?: NavTileItem[];
+    columns?: NavTileColumns;
+    gap?: number;
+    /** Uniform height (px) for each nav tile; default 110 */
+    itemHeight?: number;
+    variant?: NavTileVariant;
+    showArrow?: boolean;
+    arrowIcon?: string;
+    className?: string;
+}
+export declare const DEFAULT_NAV_TILE_ITEM_HEIGHT = 110;
+export declare function normalizeNavTileItemHeight(height?: number): number;
+export declare function normalizeNavTileColumns(columns?: number): number;
+export declare function resolveNavTileGridClass(columns: number): string;
+export declare function resolveNavTileVariantClass(variant?: NavTileVariant): string;
+export declare function navTileItemToRecord(item: NavTileItem): Record<string, unknown>;
+export declare function navTileItemToAction(item: NavTileItem, index: number): TableAction | null;
+export declare function getVisibleNavTileItems(items?: NavTileItem[]): NavTileItem[];

package/dist/components/internal/workbench/components/renderers/product/productCellRender.d.ts

@@ -0,0 +1,25 @@
+import { default as React } from 'react';
+import { ReportColumn, ReportValueFormat, CardLayoutConfig } from '../../../types/productReport';
+
+type Row = Record<string, unknown>;
+/** Resolve a locale-aware field: row[base_zh|base_en] → row[base]. */
+export declare function resolveFieldByLang(row: Row, base: string, language: string): string;
+/** Shared value formatting (summary cards + table cells). */
+export declare function formatReportValue(raw: unknown, format: ReportValueFormat | undefined, currency?: unknown): string;
+export declare function ProductThumb({ url, light, className, }: {
+    url?: string;
+    bg?: string;
+    light?: boolean;
+    className?: string;
+}): React.JSX.Element;
+/** Render a single table cell from its ReportColumn config + row. */
+export declare function renderReportCell(col: ReportColumn, row: Row, language: string): React.ReactNode;
+/** A configurable list-card: banner thumbnail + header rows beside it, body rows below. */
+export declare function ReportCard({ layout, row, language, onClick, hiddenFields }: {
+    layout: CardLayoutConfig;
+    row: Row;
+    language: string;
+    onClick?: () => void;
+    hiddenFields?: Set<string>;
+}): React.JSX.Element;
+export {};

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

@@ -0,0 +1,41 @@
+/**
+ * Pure state helpers for PublishHistoryRenderer — kept free of React/i18n/api
+ * imports so the pagination reducer can be unit-tested in isolation.
+ *
+ * The API (`GET /workbenches/:id/publish-history`) already strips the
+ * '[publish]' description prefix and returns metadata only, so no
+ * description mapping happens client-side.
+ */
+export interface PublishHistoryItem {
+    version: string;
+    description: string;
+    publishedByName: string;
+    createdAt: string;
+}
+export interface PublishHistoryState {
+    items: PublishHistoryItem[];
+    total: number;
+    /** Initial / replace fetch in flight (offset 0). */
+    loading: boolean;
+    /** "Load more" append fetch in flight (offset > 0). */
+    loadingMore: boolean;
+    error: string | null;
+}
+export type PublishHistoryAction = {
+    type: 'reset';
+} | {
+    type: 'load-start';
+    append: boolean;
+} | {
+    type: 'load-success';
+    items: PublishHistoryItem[];
+    total: number;
+    offset: number;
+} | {
+    type: 'load-error';
+    message: string;
+};
+export declare const createInitialPublishHistoryState: () => PublishHistoryState;
+export declare function publishHistoryReducer(state: PublishHistoryState, action: PublishHistoryAction): PublishHistoryState;
+/** 'v18'-style badge text: prefix a lowercase v unless the version already has one. */
+export declare function formatVersionBadge(version: string): string;