@genispace/geniapp 0.2.0 → 0.4.0

package/dist/components/internal/workbench/app/types/taskExecution.d.ts

@@ -0,0 +1,26 @@
+export interface TaskExecution {
+    id: string;
+    taskId: string;
+    userId: string;
+    spaceId: string;
+    taskType: string;
+    startTime: string;
+    endTime?: string;
+    status: 'PENDING' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELED' | 'RETRY';
+    outputs?: Record<string, unknown>;
+    logs?: Array<{
+        level: 'INFO' | 'WARNING' | 'ERROR' | 'DEBUG';
+        message: string;
+        metadata?: Record<string, unknown>;
+    }>;
+    currentNodeId?: string;
+    error?: string;
+}
+export interface LogEntry {
+    id: string;
+    level: string;
+    message: string;
+    metadata: Record<string, unknown>;
+    timestamp: string;
+    executionId: string;
+}

package/dist/components/internal/workbench/assets/maps/bundledMapGeo.d.ts

@@ -0,0 +1,4 @@
+export type BundledMapGeo = Record<string, unknown>;
+export declare function getBundledChinaGeo(): BundledMapGeo;
+export declare function getBundledUsaGeo(): BundledMapGeo;
+export declare function getBundledEuropeGeo(): BundledMapGeo;

package/dist/components/internal/workbench/components/Grid24Renderer.d.ts

@@ -0,0 +1,23 @@
+import { default as React } from 'react';
+import { Grid24LayoutConfig } from '../types/components';
+import { ParameterRecord } from '../types/parameters';
+
+interface Grid24RendererProps {
+    config: Grid24LayoutConfig;
+    components: any[];
+    nestingLevel: number;
+    appConfig: any;
+    pageParams?: ParameterRecord;
+    pageId?: string;
+    tabId?: string;
+    /** Render the mobile vertical flow regardless of the GLOBAL viewport flag —
+        the studio's phone-frame preview must stack like real mobile does, but
+        cannot flip the global override (it would switch the whole shell). */
+    forceMobileFlow?: boolean;
+    /** Optional node injected into the MOBILE flow only (e.g. the sub-page back
+        button). Sits right below the first pinned FilterPanel, else at the top —
+        mirroring the fluid fallback path in PageLayoutRenderer. */
+    mobileFlowInsert?: React.ReactNode;
+}
+declare const Grid24Renderer: React.FC<Grid24RendererProps>;
+export default Grid24Renderer;

package/dist/components/internal/workbench/components/Loading.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+
+interface LoadingProps {
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    fullScreen?: boolean;
+}
+declare const Loading: React.FC<LoadingProps>;
+export default Loading;

package/dist/components/internal/workbench/components/MultiPageRenderer.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { TabItem } from './TabManager';
+
+interface MultiPageRendererProps {
+    tabs: TabItem[];
+    activeTabId: string | null;
+    appConfig: any;
+    availableParameters?: Array<{
+        label: string;
+        value: string;
+        type?: string;
+    }>;
+}
+export declare const MultiPageRenderer: React.FC<MultiPageRendererProps>;
+export {};

package/dist/components/internal/workbench/components/PageComingSoonOverlay.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Frosted-glass overlay shown above the page content when the page's
+ * `comingSoon.enabled` config is on. Dismissal is per-mount only: reopening
+ * or refreshing the page shows the overlay again. Hidden in edit mode so the
+ * page stays editable.
+ *
+ * Visual language follows the system empty-state pattern (EmptyStateBadge):
+ * soft icon badge + medium title + muted one-liner + small pill action —
+ * not a billboard headline.
+ */
+export declare function PageComingSoonOverlay(): import("react").JSX.Element;

package/dist/components/internal/workbench/components/PageComponentRenderer.d.ts

@@ -0,0 +1,34 @@
+import { default as React } from 'react';
+import { ComponentConfig as BaseComponentConfig } from '../app/services/workbenchApi';
+import { ParameterConfig, TableAction } from '../types';
+import { ParameterRecord, ParameterContextValue } from '../types/parameters';
+import { CustomStylesConfig } from '../types/components';
+import { DatabaseDataSourceConfig } from '../types/databaseDataSource';
+import { EnhancedDataSource } from '../types/datasource';
+
+interface ExtendedComponentConfig extends BaseComponentConfig {
+    parameterConfig?: ParameterConfig;
+    actions?: TableAction[];
+    component?: ExtendedComponentConfig;
+    useMockData?: boolean;
+    databaseDataSourceConfig?: DatabaseDataSourceConfig;
+    enhancedDataSource?: EnhancedDataSource;
+    componentParameterConfig?: {
+        enableParameterReceiving?: boolean;
+        listenToParameters?: string[];
+    };
+    customStyles?: CustomStylesConfig;
+}
+interface PageComponentRendererProps {
+    component: ExtendedComponentConfig;
+    appConfig: Record<string, unknown>;
+    parentProps?: Record<string, unknown>;
+    pageParams?: ParameterRecord;
+    parameterContext?: ParameterContextValue;
+    pageId?: string;
+    tabId?: string;
+    /** Depth of layout containers (Container/Card/Tabs) wrapping this node; page roots use 0. */
+    nestingLevel?: number;
+}
+declare const PageComponentRenderer: React.FC<PageComponentRendererProps>;
+export default PageComponentRenderer;

package/dist/components/internal/workbench/components/PageLayoutRenderer.d.ts

@@ -0,0 +1,36 @@
+import { default as React } from 'react';
+import { Grid24LayoutConfig } from '../types/components';
+import { LayoutPreset, GridArea } from '../utils/layoutSystem';
+import { ParameterRecord } from '../types/parameters';
+
+interface PageLayoutConfig {
+    type: 'default' | 'grid' | 'custom';
+    preset?: LayoutPreset | 'top1-bottom2' | 'left1-right2' | 'top1-bottom3' | 'all-vertical' | 'dashboard-layout';
+    areas?: {
+        top?: string[];
+        bottom?: string[];
+        left?: string[];
+        right?: string[];
+    };
+    gridTemplate?: {
+        rows: string;
+        columns: string;
+        areas: string;
+    };
+    componentPositions?: Record<string, {
+        area: GridArea | 'top' | 'bottom' | 'left' | 'right';
+        order: number;
+        span?: number;
+    }>;
+}
+type PageLayoutInput = PageLayoutConfig | Grid24LayoutConfig;
+interface PageLayoutRendererProps {
+    components: any[];
+    appConfig: any;
+    layoutConfig?: PageLayoutInput;
+    pageParams?: ParameterRecord;
+    pageId?: string;
+    tabId?: string;
+}
+declare const PageLayoutRenderer: React.FC<PageLayoutRendererProps>;
+export default PageLayoutRenderer;

package/dist/components/internal/workbench/components/TabManager.d.ts

@@ -0,0 +1,39 @@
+import { default as React } from 'react';
+import { ParameterRecord } from '../types/parameters';
+
+export interface TabItem {
+    id: string;
+    pageId: string;
+    title: string;
+    icon?: string;
+    isActive: boolean;
+    pageConfig?: unknown;
+    isLoading: boolean;
+    hasError?: boolean;
+    errorMessage?: string;
+    urlParams?: ParameterRecord;
+    fullPath?: string;
+    navigationTitle?: string;
+    pageTitle?: string;
+}
+interface TabContextType {
+    tabs: TabItem[];
+    activeTabId: string | null;
+    openTab: (pageId: string, navigationTitle?: string, icon?: string, urlParams?: ParameterRecord, initialPageConfig?: unknown) => Promise<void>;
+    closeTab: (tabId: string) => void;
+    closeOtherTabs: (tabId: string) => void;
+    closeAllTabs: () => void;
+    switchTab: (tabId: string) => void;
+    getTabById: (tabId: string) => TabItem | undefined;
+    getActiveTab: () => TabItem | undefined;
+}
+export declare const workbenchHideTabBarRef: {
+    current: boolean;
+};
+export declare const useTabManager: () => TabContextType;
+interface TabProviderProps {
+    children: React.ReactNode;
+    workbenchId: string;
+}
+export declare const TabProvider: React.FC<TabProviderProps>;
+export {};

package/dist/components/internal/workbench/components/componentTypes.d.ts

@@ -0,0 +1,70 @@
+import { Component } from './renderers/types';
+
+type ComponentTypeName = 'Form' | 'Table' | 'EditableTable' | 'Chart' | 'StatisticGroup' | 'DataGridCard' | 'Container' | 'Tabs' | 'Typography' | 'Card' | 'List' | 'TaskInput' | 'ServiceDeskReporter' | 'Tree' | 'FilterPanel' | 'EChartsChart' | 'MapChart' | 'RadarChart' | 'HeroCard' | 'MetricCarousel' | 'CollapsePanel' | 'AnalyticsTable' | 'ProductReport' | 'ProductDetail' | 'TileGrid' | 'RingStat' | 'PublishHistory' | 'PublishPreviewEntry' | 'NavTile' | 'AppIdentityList' | 'IdentityAttributeAssign' | 'WorkflowComponent' | 'CustomContent';
+export interface BasePropertyConfig {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    label: string;
+    description?: string;
+    required?: boolean;
+    defaultValue?: any;
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+}
+export interface OptionPropertyConfig extends BasePropertyConfig {
+    type: 'string' | 'number';
+    options: Array<{
+        label: string;
+        value: string | number;
+    }>;
+}
+export interface ArrayPropertyConfig extends BasePropertyConfig {
+    type: 'array';
+    itemType: 'string' | 'number' | 'object';
+    itemConfig?: PropertyConfig;
+}
+export interface ObjectPropertyConfig extends BasePropertyConfig {
+    type: 'object';
+    properties: Record<string, PropertyConfig>;
+}
+export type PropertyConfig = BasePropertyConfig | OptionPropertyConfig | ArrayPropertyConfig | ObjectPropertyConfig;
+interface RecursivePropertyConfig extends BasePropertyConfig {
+    itemType?: 'string' | 'number' | 'object';
+    itemConfig?: RecursivePropertyConfig;
+    properties?: Record<string, RecursivePropertyConfig>;
+    additionalProperties?: boolean | RecursivePropertyConfig;
+    enum?: string[];
+    children?: {
+        [key: string]: RecursivePropertyConfig;
+    };
+}
+type PropType = RecursivePropertyConfig;
+export interface ComponentType {
+    type: ComponentTypeName;
+    title: string;
+    description: string;
+    icon: string;
+    propTypes: {
+        [key: string]: PropType;
+    };
+    dataSourceTypes?: {
+        [key: string]: {
+            label: string;
+            description?: string;
+            required?: boolean;
+            children: {
+                [key: string]: PropType;
+            };
+        };
+    };
+    mockData?: {
+        type: 'array' | 'object';
+        label: string;
+        description: string;
+        defaultValue: any;
+    };
+    createComponent: () => Component;
+}
+export declare const componentTypes: ComponentType[];
+export {};

package/dist/components/internal/workbench/components/dialogs/TaskParamsDialog.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+
+interface TaskParamsDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    taskId: string;
+    initialParams?: Record<string, unknown>;
+    onSuccess?: (result: {
+        id?: string;
+        executionId?: string;
+        [key: string]: unknown;
+    }) => void;
+    onError?: (error: Error) => void;
+    title?: string;
+    description?: string;
+}
+declare const TaskParamsDialog: React.FC<TaskParamsDialogProps>;
+export default TaskParamsDialog;

package/dist/components/internal/workbench/components/dialogs/TreeFormDialog.d.ts

@@ -0,0 +1,23 @@
+import { default as React } from 'react';
+import { InsertDatasetConfig, UpdateDatasetConfig } from '../../types';
+import { ColumnConfig } from '../editor/common/types';
+
+interface TreeFormDialogProps {
+    isOpen: boolean;
+    mode: 'add' | 'edit';
+    onClose: () => void;
+    onSubmit: (data: Record<string, any>) => void;
+    insertConfig?: InsertDatasetConfig;
+    updateConfig?: UpdateDatasetConfig;
+    treeColumns: ColumnConfig[];
+    selectedNode?: any;
+    selectedParent?: any;
+    parentKey?: string;
+    availableParameters?: Array<{
+        label: string;
+        value: string;
+        type?: string;
+    }>;
+}
+export declare const TreeFormDialog: React.FC<TreeFormDialogProps>;
+export {};

package/dist/components/internal/workbench/components/edit-mode/ComponentEditOverlay.d.ts

@@ -0,0 +1,3 @@
+import { PropsWithChildren, ReactNode } from 'react';
+
+export declare function ComponentEditOverlay({ children }: PropsWithChildren<Record<string, unknown>>): ReactNode;

package/dist/components/internal/workbench/components/edit-mode/ContainerDropZoneOverlay.d.ts

@@ -0,0 +1 @@
+export declare function ContainerDropZoneOverlay(_props: Record<string, unknown>): null;

package/dist/components/internal/workbench/components/edit-mode/EditModeProvider.d.ts

@@ -0,0 +1,26 @@
+import { PropsWithChildren, ReactNode } from 'react';
+
+export type ViewModePermissions = {
+    canEdit: false;
+    canManage: false;
+    canView: true;
+};
+/**
+ * Public GeniApps always execute the published/view branch of Workbench
+ * renderers. The Workbench editor continues to provide its own edit context.
+ */
+export declare const useEditMode: () => {
+    isEditMode: false;
+    permissions: ViewModePermissions;
+    permissionsLoading: boolean;
+    permissionsError: any;
+    draggedComponentType: string | null;
+    isAddingComponent: boolean;
+    previewOnly: boolean;
+    currentWorkbench: any;
+    openComponentEditor: () => any;
+    refreshComponent: () => any;
+    updatePageConfig: () => Promise<any>;
+    deletePage: () => Promise<any>;
+};
+export declare function EditModeProvider({ children }: PropsWithChildren): ReactNode;

package/dist/components/internal/workbench/components/edit-mode/WorkbenchEditMode.d.ts

@@ -0,0 +1,3 @@
+import { PropsWithChildren, ReactNode } from 'react';
+
+export declare function WorkbenchEditMode({ children }: PropsWithChildren<Record<string, unknown>>): ReactNode;

package/dist/components/internal/workbench/components/edit-mode/canvas/Grid24EditableCanvas.d.ts

@@ -0,0 +1 @@
+export default function Grid24EditableCanvas(_props: Record<string, unknown>): null;

package/dist/components/internal/workbench/components/edit-mode/canvas/MobileFlowCanvas.d.ts

@@ -0,0 +1 @@
+export default function MobileFlowCanvas(_props: Record<string, unknown>): null;

package/dist/components/internal/workbench/components/edit-mode/index.d.ts

@@ -0,0 +1,4 @@
+export { EditModeProvider, useEditMode } from './EditModeProvider';
+export { ComponentEditOverlay } from './ComponentEditOverlay';
+export { ContainerDropZoneOverlay } from './ContainerDropZoneOverlay';
+export { WorkbenchEditMode } from './WorkbenchEditMode';

package/dist/components/internal/workbench/components/edit-mode/studio/StudioPreviewContext.d.ts

@@ -0,0 +1,4 @@
+export declare const useGridCanvasGate: () => false;
+export declare const useStudioPreview: () => {
+    previewOnly: false;
+};

package/dist/components/internal/workbench/components/editor/common/types.d.ts

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

package/dist/components/internal/workbench/components/grid24CellContext.d.ts

@@ -0,0 +1,2 @@
+export declare const Grid24FillCellProvider: import('react').Provider<boolean>;
+export declare const useGrid24FillCell: () => boolean;

package/dist/components/internal/workbench/components/inputs/ArrayInput.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+
+interface ArrayInputProps {
+    value: string[];
+    onChange: (newValues: string[]) => void;
+    placeholder?: string;
+    maxItems?: number;
+    emptyMessage?: string;
+    addButtonLabel?: string;
+    className?: string;
+    inputClassName?: string;
+}
+export declare function ArrayInput({ value, onChange, placeholder, maxItems, emptyMessage, addButtonLabel, className, inputClassName, }: ArrayInputProps): React.JSX.Element;
+export {};

package/dist/components/internal/workbench/components/inputs/ObjectArrayInput.d.ts

@@ -0,0 +1,15 @@
+import { default as React } from 'react';
+import { JSONSchemaProperty } from '../../../shared-types/index.ts';
+
+interface ObjectArrayInputProps {
+    value: any[];
+    onChange: (newValues: any[]) => void;
+    itemSchema: JSONSchemaProperty;
+    className?: string;
+    label?: string;
+    description?: string;
+    required?: boolean;
+    errors?: Record<number, Record<string, string>>;
+}
+export declare const ObjectArrayInput: React.FC<ObjectArrayInputProps>;
+export {};

package/dist/components/internal/workbench/components/mobileFlowLayoutContext.d.ts

@@ -0,0 +1,2 @@
+export declare const MobileFlowLayoutProvider: import('react').Provider<boolean>;
+export declare const useMobileFlowLayout: () => boolean;

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

@@ -0,0 +1,125 @@
+import { default as React } from 'react';
+import { DatabaseDataSourceConfig } from '../../types/databaseDataSource';
+import { ComponentParameterConfig } from '../../types/parameters';
+import { ColorRule, SwCellProps, SwCellType, SwCellFormat } from './cells/swCells';
+
+interface PillItem {
+    value: string;
+    label: unknown;
+    color?: string;
+    filter?: {
+        field: string;
+        eq: unknown;
+    };
+}
+export type DerivedField = {
+    as: string;
+    kind: 'shareOfTotal';
+    field: string;
+    ifMissing?: boolean;
+} | {
+    as: string;
+    kind: 'subtract';
+    a: string;
+    b: string;
+};
+export interface AnalyticsColumn {
+    key: string;
+    label?: unknown;
+    align?: 'left' | 'right' | 'center';
+    sticky?: boolean;
+    sortField?: string;
+    headerColor?: string;
+    kind: 'label' | 'text' | SwCellType;
+    field?: string;
+    format?: SwCellFormat;
+    muted?: boolean;
+    /** Fixed column width — a px number or any CSS width string. Applied as width/min/max so the
+     *  default `table-layout:auto` honors it (browsers treat a bare `width` as a hint and may grow it). */
+    width?: number | string;
+    cellProps?: SwCellProps;
+    rowMarker?: boolean;
+    /** Threshold -> text color for `text` cells (e.g. SMI% >= 100 -> emerald). */
+    colorRules?: ColorRule[];
+    /** Render this column only while one of these quick-filter pills is active
+     *  (e.g. the live-share column exists only under the 'live' pill). Unset = always shown. */
+    showForPills?: string[];
+}
+export interface AnalyticsTableRendererProps {
+    id?: string;
+    dimLabel?: unknown;
+    databaseDataSourceConfig?: DatabaseDataSourceConfig | null;
+    summaryDataSourceConfig?: DatabaseDataSourceConfig | null;
+    componentParameterConfig?: ComponentParameterConfig;
+    pageParams?: Record<string, unknown>;
+    /**
+     * Row search + quick-filter pills. When `pillParam` is set, selecting a pill re-queries the
+     * datasource with `{ [pillParam]: activePill.value }` (server-side filtering) instead of filtering
+     * the already-loaded page rows; the pill's `filter` is then used only for row markers.
+     */
+    toolbar?: {
+        search?: boolean;
+        pills?: PillItem[];
+        pillParam?: string;
+    };
+    rowMarkers?: boolean;
+    maxHeight?: number;
+    bare?: boolean;
+    mockData?: Record<string, unknown>[];
+    useMockData?: boolean;
+    columns?: AnalyticsColumn[];
+    derivedFields?: DerivedField[];
+    summaryLabel?: unknown;
+    /** Show sub-values (LY line / diff-vs-baseline) in the summary (total) row. The summary datasource
+     *  usually lacks the *_ly fields, leaving a dangling "LY —" under the total — turn this off to
+     *  render main values only in the summary row. Body rows are unaffected. Default true. */
+    summaryShowSub?: boolean;
+    showIndex?: boolean;
+    /** Hard width (px) of the leading `#` index column. Omit to auto-size by the largest row number's
+     *  digit count (snug for a handful of rows, wider once indices reach 3+ digits). */
+    indexWidth?: number;
+    /** Horizontal padding (px) of the `#` index column cells (header/body/summary). Default 8 (px-2).
+     *  Lower it to shrink the index column and pull the first data column left, reclaiming space. */
+    indexPadX?: number;
+    /** Row field displayed in the `#` index column instead of the positional row number (e.g. a
+     *  datasource-computed `national_rank` — task #15 SA ranking: rank moves into the # slot and the
+     *  separate sequence number is dropped). NULL/empty renders '—'; the column width auto-sizes to the
+     *  field's largest digit count (a filtered view can show ranks higher than the row count). */
+    indexField?: string;
+    /** Label of the `#` index column header (localized via bi()). Default '#'. Task #15 SA ranking
+     *  renames it to "Rank"; combined with indexField the header also becomes a sort toggle (asc/desc
+     *  by the indexField value, same client-side sort as data columns). */
+    indexLabel?: unknown;
+    /** Override the width (px) of the first frozen label/dimension column. Lets tables on the shared
+     *  default columns set just this width without redefining the whole column set. */
+    labelWidth?: number;
+    headerClassName?: string;
+    indexHeaderClass?: string;
+    headerColors?: Record<string, string>;
+    zebra?: boolean;
+    zebraClassName?: string;
+    /** Highlight the row whose `field` equals a static `value` or a live bus param `valueParam`. */
+    highlightRow?: {
+        field: string;
+        value?: string;
+        valueParam?: string;
+        badge?: unknown;
+    };
+    /** Per-role content font sizes (px). Raise these for low-vision users; empty = readable defaults. */
+    headerFontSize?: number;
+    cellFontSize?: number;
+    badgeFontSize?: number;
+    /** Mobile only: freeze the first column (sticky-left) AND pin the header below the FilterPanel
+     *  on page scroll. Off by default — turn on only for wide/long tables (e.g. sales-detail by store). */
+    freezeFirstColumn?: boolean;
+    /** Row-fetch page size. These tables load the FULL result set and do search/sort/pagination
+     *  client-side, so the runtime data endpoint's default Table page size (20) would silently
+     *  truncate wide dims (e.g. 116 stores / 29 cities). Defaults to 1000 to load every row. */
+    fetchLimit?: number;
+    /** Wrap the first (label/dimension) column's text onto multiple lines instead of truncating with an
+     *  ellipsis. Row height grows to fit; other columns stay aligned via the shared table row. Off by
+     *  default (keeps the ellipsis behavior). Turn on for long store/city names (dashboard acceptance 0709 #8). */
+    wrapLabel?: boolean;
+}
+declare const AnalyticsTableRenderer: React.FC<AnalyticsTableRendererProps>;
+export default AnalyticsTableRenderer;

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

@@ -0,0 +1,60 @@
+import { default as React } from 'react';
+
+/**
+ * The one component that touches the platform RBAC API. Lists the workbench application's
+ * identities — users or roles — and composes over the page bus (row click emits the selected
+ * identity for a downstream IdentityAttributeAssign).
+ *
+ * Because identity (platform RBAC DB, via API) and its tenant-side attributes (business DB, via
+ * datasource) live in DIFFERENT databases, a SQL JOIN is impossible; this component MERGES them
+ * on the client by join key. So for roles it can show name/code/member-count from the API AND an
+ * inline-editable extension column (e.g. ds_roles_ex.filter_store) pulled from a datasource, keyed
+ * by role code. For users it can inline-assign application roles (a platform RBAC write).
+ */
+export interface AppIdentityListRendererProps {
+    id?: string;
+    /** Which identity set to list. */
+    source?: 'users' | 'roles';
+    /** Row click emits the selected identity id/code under this bus key. Empty → rows not selectable. */
+    emitParamKey?: string;
+    searchable?: boolean;
+    /** users: show the email column. */
+    showEmail?: boolean;
+    /** users: show the phone column. */
+    showPhone?: boolean;
+    /** users: show role badges (read-only) — ignored when roleAssignable is on. */
+    showRoles?: boolean;
+    /** users: render an inline role picker per row and write it via the RBAC assign API. */
+    roleAssignable?: boolean;
+    /** users: show the role filter dropdown next to search (default true). */
+    roleFilterable?: boolean;
+    /** roles: READ datasource holding the extension attribute rows (merged by attributeKeyField).
+     *  users: same datasource, loaded when emitAttributeParamKey is set. */
+    attributeDatasourceId?: string;
+    /** roles: TRANSACTION datasource that upserts one identity's attribute value. */
+    attributeSaveDatasourceId?: string;
+    /** roles: join field in the attribute rows (default 'role_code'). */
+    attributeKeyField?: string;
+    /** roles: value field in the attribute rows (default 'filter_store'). */
+    attributeValueField?: string;
+    /** roles: inline editor kind for the attribute column. */
+    attributeKind?: 'none' | 'toggle' | 'number';
+    /** roles: attribute column header (plain string or bilingual { zh, en }). */
+    attributeLabel?: unknown;
+    /** roles: SQL param name carrying the identity code in the save body (default 'roleCode'). */
+    attributeSaveKeyParam?: string;
+    /** roles: SQL param name carrying the value in the save body (default 'filterStore'). */
+    attributeSaveValueParam?: string;
+    /** users: bus key carrying the selected user's role attribute value ('true'/'false', looked up
+     *  from attributeDatasourceId by roles[0].code). Lets listeners (e.g. via visibleWhen) react to
+     *  whether the selected identity needs the attribute-gated workflow. Empty → not emitted. */
+    emitAttributeParamKey?: string;
+    showMemberCount?: boolean;
+    showPermissionCount?: boolean;
+    /** users: table box fixed height (px number or CSS e.g. calc(100vh - 200px); scrolls beyond). Unset → hug content. */
+    listHeight?: number | string;
+    /** users: rows per page (client-side pagination). 0/unset → single page. */
+    pageSize?: number;
+}
+export declare function AppIdentityListRenderer({ id, source, emitParamKey, searchable, showEmail, showPhone, showRoles, roleAssignable, roleFilterable, attributeDatasourceId, attributeSaveDatasourceId, attributeKeyField, attributeValueField, attributeKind, attributeLabel, attributeSaveKeyParam, attributeSaveValueParam, emitAttributeParamKey, showMemberCount, showPermissionCount, listHeight, pageSize, }: AppIdentityListRendererProps): React.JSX.Element;
+export default AppIdentityListRenderer;

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

@@ -0,0 +1,7 @@
+import { default as React } from 'react';
+
+export interface BaseProps {
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function renderByType(type: string, props: any): React.JSX.Element;

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

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+import { CustomStylesConfig } from '../../types/components';
+
+interface CardRendererProps {
+    title?: string;
+    description?: string;
+    footer?: React.ReactNode;
+    children?: React.ReactNode;
+    className?: string;
+    bordered?: boolean;
+    hoverable?: boolean;
+    shadow?: boolean;
+    /** Vertical gap between card title (header) and content. Number = px, or CSS length e.g. 8px, 0.5rem */
+    titleToContentGap?: string | number;
+    id?: string;
+    customStyles?: CustomStylesConfig;
+    componentConfig?: any;
+    appConfig?: Record<string, unknown>;
+    pageParams?: any;
+    pageId?: string;
+    nestingLevel?: number;
+}
+declare const CardRenderer: React.FC<CardRendererProps>;
+export default CardRenderer;