@genispace/geniapp 0.3.0 → 0.4.0

package/dist/components/internal/workbench/lib/services/agentService.d.ts

@@ -0,0 +1,77 @@
+import { ApiResponse } from '../types/api';
+
+export interface AgentSession {
+    sessionId: string;
+    agentId: string;
+    userId: string;
+    spaceId: string;
+    title?: string;
+    status: 'ACTIVE' | 'COMPLETED' | 'FAILED';
+    createdAt: string;
+    updatedAt?: string;
+    metadata?: Record<string, any>;
+}
+export interface CreateSessionRequest {
+    title?: string;
+    metadata?: Record<string, any>;
+    sessionType?: 'chat' | 'test' | 'task' | 'assistant';
+}
+export interface CreateSessionResponse {
+    sessionId: string;
+    agentId: string;
+    userId: string;
+    spaceId: string;
+    title?: string;
+    status: string;
+    createdAt: string;
+}
+export declare class AgentService {
+    private static instance;
+    private readonly basePath;
+    private constructor();
+    static getInstance(): AgentService;
+    createSession(agentId: string, options?: CreateSessionRequest): Promise<ApiResponse<CreateSessionResponse>>;
+    getUserSessions(options?: {
+        agentId?: string;
+        status?: 'ACTIVE' | 'COMPLETED' | 'FAILED';
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<{
+        data: AgentSession[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    }>>;
+    getSessionById(sessionId: string): Promise<ApiResponse<AgentSession>>;
+    updateSession(sessionId: string, updateData: {
+        title?: string;
+        metadata?: Record<string, any>;
+        status?: 'ACTIVE' | 'COMPLETED' | 'FAILED';
+    }): Promise<ApiResponse<AgentSession>>;
+    deleteSession(sessionId: string): Promise<ApiResponse<{
+        message: string;
+    }>>;
+    getSessionMessages(sessionId: string, options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<ApiResponse<{
+        data: any[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    }>>;
+    getSessionStats(options?: {
+        agentId?: string;
+        dateRange?: string;
+    }): Promise<ApiResponse<any>>;
+    executeAgent(agentId: string, requestData: any, agentType?: 'chat' | 'task', stream?: boolean): Promise<ApiResponse<any>>;
+    getAgent(agentId: string): Promise<ApiResponse<any>>;
+}
+export declare const agentService: AgentService;
+export default agentService;

package/dist/components/internal/workbench/lib/services/applicationService.d.ts

@@ -0,0 +1,111 @@
+import { Application, ApplicationFilter, ApplicationStatus, CreateApplicationData, ApplicationCategory, ApplicationTemplate, ApplicationDeployment, ApplicationReview, ApplicationOrder, ApplicationApiKey } from '../../types';
+
+export interface ApplicationListResponse {
+    success: boolean;
+    data: Application[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        pages: number;
+    };
+}
+export interface ApplicationDetailResponse {
+    success: boolean;
+    data: Application;
+}
+export interface ApplicationStatsResponse {
+    success: boolean;
+    data: {
+        total: number;
+        active: number;
+        growth: number;
+        breakdown: {
+            containerized: number;
+            lowcode: number;
+        };
+    };
+}
+declare class ApplicationApiService {
+    getMyApplications(filters?: Partial<ApplicationFilter>, page?: number, limit?: number): Promise<ApplicationListResponse>;
+    getApplicationById(id: string): Promise<Application>;
+    createApplication(data: CreateApplicationData): Promise<Application>;
+    updateApplication(id: string, data: Partial<CreateApplicationData>): Promise<Application>;
+    deleteApplication(id: string): Promise<void>;
+    toggleApplicationStatus(id: string, status: ApplicationStatus): Promise<Application>;
+    deployApplication(id: string, versionId?: string, environment?: string): Promise<ApplicationDeployment>;
+    stopApplication(id: string): Promise<void>;
+    getApplicationDeployments(id: string): Promise<ApplicationDeployment[]>;
+    getApplicationLogs(id: string, options?: {
+        lines?: number;
+        since?: string;
+        level?: string;
+    }): Promise<any[]>;
+    getApplicationStats(id: string, timeRange?: string): Promise<any>;
+    getApplicationTemplates(framework?: string): Promise<ApplicationTemplate[]>;
+    getApplicationCategories(): Promise<ApplicationCategory[]>;
+    purchaseApplication(id: string, data: {
+        planType: string;
+        authorizedUsers?: number;
+        authorizedTeams?: number;
+    }): Promise<ApplicationOrder>;
+    installFreeApplication(id: string): Promise<void>;
+    getMyApplicationOrders(page?: number, limit?: number, status?: string): Promise<{
+        orders: ApplicationOrder[];
+        pagination: {
+            page: number;
+            limit: number;
+            total: number;
+            pages: number;
+        };
+    }>;
+    getApplicationStatistics(): Promise<{
+        total: number;
+        active: number;
+        growth: number;
+        breakdown: {
+            containerized: number;
+            lowcode: number;
+        };
+    }>;
+    getMyDashboardApplications(): Promise<Array<{
+        id: string;
+        title: string;
+        description: string;
+        type: string;
+        status: string;
+        lastUsed: string;
+        usage: string;
+        link: string;
+        createdAt: string;
+        updatedAt: string;
+    }>>;
+    createApplicationReview(id: string, data: {
+        rating: number;
+        comment?: string;
+        version?: string;
+    }): Promise<ApplicationReview>;
+    updateApplicationReview(id: string, data: {
+        rating: number;
+        comment?: string;
+        version?: string;
+    }): Promise<ApplicationReview>;
+    deleteApplicationReview(id: string): Promise<void>;
+    createApiKey(id: string, data: {
+        keyName: string;
+        permissions?: Record<string, any>;
+        rateLimit?: number;
+        expiresAt?: string;
+    }): Promise<ApplicationApiKey>;
+    updateApiKey(appId: string, keyId: string, data: {
+        keyName?: string;
+        permissions?: Record<string, any>;
+        rateLimit?: number;
+        isActive?: boolean;
+        expiresAt?: string;
+    }): Promise<ApplicationApiKey>;
+    deleteApiKey(appId: string, keyId: string): Promise<void>;
+}
+export declare const applicationApi: ApplicationApiService;
+export { ApplicationApiService };
+export default applicationApi;

package/dist/components/internal/workbench/lib/theme/themeUtils.d.ts

@@ -0,0 +1,13 @@
+import { Theme } from '../../themes';
+
+/**
+ * Parses `hsl(h, s%, l%)` / `hsl(h s l)` into Tailwind-compatible channel triplets `"h s l"`.
+ */
+export declare function hslFunctionalToChannels(fn: string): string | null;
+export declare function flattenDeclarations(decl: Record<string, string>): string;
+/**
+ * Builds CSS for injecting into `#workbench-theme-variables`.
+ * Overrides base semantic tokens (`--primary`, ...) and keeps `--color-*` for themed CSS such as inkOnyx.css.
+ */
+export declare function buildWorkbenchPaletteCss(theme: Theme): string;
+export declare function listRegisteredThemes(themeMap: Record<string, Theme>): Theme[];

package/dist/components/internal/workbench/lib/theme/useWorkbenchTheme.d.ts

@@ -0,0 +1 @@
+export { useWorkbenchTheme } from '../../contexts/WorkbenchThemeContext';

package/dist/components/internal/workbench/lib/types/api.d.ts

@@ -0,0 +1,113 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export interface ApiResponse<T = any> {
+    success: boolean;
+    message?: string;
+    data?: T;
+    code?: number;
+    timestamp?: string;
+    error?: string;
+    errorDetails?: any;
+}
+export interface StreamMetadata {
+    components_found?: Array<{
+        name: string;
+        type: string;
+        description?: string;
+        id?: string;
+    }>;
+    workflow_created?: {
+        workflow_id?: string;
+        name?: string;
+        description?: string;
+        nodes?: any[];
+        mode?: string;
+    };
+    agent_created?: {
+        agent_id?: string;
+        name?: string;
+        description?: string;
+        model?: string;
+        mode?: string;
+    };
+    operator_created?: {
+        operator_id?: string;
+        name?: string;
+        description?: string;
+        type?: string;
+        mode?: string;
+    };
+    task_analyzed?: {
+        task_id?: string;
+        name?: string;
+        description?: string;
+        status?: string;
+        mode?: string;
+    };
+    platform_help_provided?: {
+        help_content?: string;
+        topics?: string[];
+    };
+    intent_category?: string;
+    workflow_stage?: string;
+    user_mode?: 'auto' | 'manual';
+    iterations?: number;
+    error_details?: string;
+    tools?: Record<string, any>;
+    action?: string;
+    iteration?: number;
+    session_id?: string;
+}
+export interface StreamProgress {
+    currentNode: string;
+    progress: number;
+    status: string;
+}
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+    search?: string;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+export interface PaginatedResponse<T> {
+    success: boolean;
+    data: T[];
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        pages: number;
+    };
+}
+export interface FileUploadOptions {
+    maxSize?: number;
+    allowedTypes?: string[];
+    compress?: boolean;
+}
+export interface UploadResponse {
+    url: string;
+    filename: string;
+    size: number;
+    type: string;
+}
+export interface ApiError {
+    code: number;
+    message: string;
+    details?: any;
+    field?: string;
+}
+export interface ApiRequestConfig {
+    skipAuth?: boolean;
+    skipErrorHandling?: boolean;
+    timeout?: number;
+    retries?: number;
+    headers?: Record<string, string>;
+}
+export interface WebSocketMessage<T = any> {
+    type: string;
+    data: T;
+    timestamp: number;
+    id?: string;
+}
+export type ApiMethod = HttpMethod;
+export type ApiConfig = ApiRequestConfig;

package/dist/components/internal/workbench/lib/utils/avatar.d.ts

@@ -0,0 +1,7 @@
+export declare const AVATAR_STYLES: readonly ["adventurer", "avataaars", "big-ears", "big-ears-neutral", "big-smile", "bottts", "croodles", "fun-emoji", "icons", "identicon", "initials", "lorelei", "micah", "miniavs", "open-peeps", "personas", "pixel-art", "shapes", "thumbs"];
+export type AvatarStyle = typeof AVATAR_STYLES[number];
+export declare function generateAvatarUrl(name: string, style?: AvatarStyle, size?: number): string;
+export declare function getAgentAvatar(agentName: string, agentType?: string, isSystemAgent?: boolean): string;
+export declare function preloadAvatar(url: string): void;
+export declare function preloadAvatars(urls: string[]): void;
+export declare function getFallbackAvatarUrl(name: string): string;

package/dist/components/internal/workbench/lib/utils/cn.d.ts

@@ -0,0 +1,3 @@
+import { ClassValue } from 'clsx';
+
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/components/internal/workbench/lib/utils/color.d.ts

@@ -0,0 +1 @@
+export declare const getIconColor: (type: string) => string;

package/dist/components/internal/workbench/lib/utils/debounce.d.ts

@@ -0,0 +1 @@
+export declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;

package/dist/components/internal/workbench/lib/utils/formatting.d.ts

@@ -0,0 +1,4 @@
+export declare const formatDuration: (seconds: number) => string;
+export declare const formatDurationFromMs: (ms: number) => string;
+export declare const formatDateTime: (dateString: string | null) => string;
+export declare const formatRelativeTime: (dateString: string) => string;

package/dist/components/internal/workbench/lib/utils/icon.d.ts

@@ -0,0 +1 @@
+export declare const getIconComponent: (iconName: string, size?: number, className?: string) => JSX.Element;

package/dist/components/internal/workbench/lib/utils.d.ts

@@ -0,0 +1,7 @@
+import { ClassValue } from 'clsx';
+
+export declare function cn(...inputs: ClassValue[]): string;
+export declare function formatDate(date: string | Date): string;
+export declare function formatNumber(num: number): string;
+export declare function formatLargeNumber(num: number, precision?: number): string;
+export declare function formatTokens(tokens: number, showUnit?: boolean): string;

package/dist/components/internal/workbench/locales/i18n.d.ts

@@ -0,0 +1,10 @@
+import { default as i18n } from 'i18next';
+import { Namespace } from './types';
+
+/** Matches language folder names under public/locales; avoids wrong language on first paint if LanguageDetector misses query */
+declare const SUPPORTED_APP_LANGS: readonly ["en", "zh"];
+type SupportedAppLang = (typeof SUPPORTED_APP_LANGS)[number];
+export declare function readSupportedAppLngFromSearch(search: string): SupportedAppLang | undefined;
+export declare const ALL_NAMESPACES: Namespace[];
+export declare const INITIAL_NS: readonly Namespace[];
+export default i18n;

package/dist/components/internal/workbench/locales/routeNamespaces.d.ts

@@ -0,0 +1,4 @@
+import { RouteLocaleRule } from '../../shared-utils/index.ts';
+
+export declare const ROUTE_LOCALE_RULES: RouteLocaleRule[];
+export declare function prefetchNamespacesForWorkbenchPath(pathname: string): string[];

package/dist/components/internal/workbench/mobile/components/BottomTabNavigation.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { NavigationItem } from '../../types';
+
+interface BottomTabNavigationProps {
+    workbenchId?: string;
+    currentPageId?: string;
+    navigationItems?: NavigationItem[];
+    currentMemberId?: string | null;
+}
+export declare function BottomTabNavigation({ workbenchId, currentPageId, navigationItems, currentMemberId, }: BottomTabNavigationProps): React.JSX.Element;
+export {};

package/dist/components/internal/workbench/mobile/components/ComponentAdapter.d.ts

@@ -0,0 +1,9 @@
+export { isMobileWorkbenchViewport, isMobileAdaptedComponentType, MOBILE_ADAPTED_COMPONENT_TYPES, mapTableColumnsForMobile, mapChartRowsForMobile, mapEChartsRowsForMobile, mapStatisticItemsForMobile, sortGrid24ComponentsForMobileFlow, } from '../utils/mobileComponentProps';
+export { MobileTableView } from './adaptive/MobileTableView';
+export { MobileChartView } from './adaptive/MobileChartView';
+export { MobileEChartsView } from './adaptive/MobileEChartsView';
+export { MobileStatCard } from './adaptive/MobileStatCard';
+export { MobileFormView } from './adaptive/MobileFormView';
+export { MobileListView } from './adaptive/MobileListView';
+export { MobileTabsView } from './adaptive/MobileTabsView';
+export { MobileCardView } from './adaptive/MobileCardView';

package/dist/components/internal/workbench/mobile/components/MobileFloatingBackButton.d.ts

@@ -0,0 +1,23 @@
+import { default as React } from 'react';
+
+interface MobileFloatingBackButtonProps {
+    /** Config gate (appConfig.floatingBackButton). */
+    enabled: boolean;
+    workbenchId?: string;
+    /** Form factor — only affects which localStorage key the dragged position is stored
+     *  under (desktop and mobile positions are remembered separately). Defaults to mobile. */
+    variant?: 'mobile' | 'desktop';
+    /** Left offset in px. Desktop passes the sidebar width + gap so the pill sits at the
+     *  content area's left edge instead of covering the sidebar nav; mobile keeps the
+     *  viewport left edge (safe-area aware) when omitted. */
+    leftOffset?: number;
+}
+/**
+ * Floating pill-shaped back button for drill-down pages (SW requirement E rework, 2026-08-05;
+ * extended to the desktop layout 2026-08-06 despite the Mobile* name). Shown whenever the
+ * shared nav stack has a previous entry; sits at the left edge below the FilterPanel,
+ * draggable vertically, and the dragged position is shared across drill-down pages
+ * (persisted per workbench per form factor in localStorage).
+ */
+export declare const MobileFloatingBackButton: React.FC<MobileFloatingBackButtonProps>;
+export default MobileFloatingBackButton;

package/dist/components/internal/workbench/mobile/components/adaptive/MobileCardView.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { CardRenderer } from '../../../components/renderers';
+
+type MobileCardViewProps = React.ComponentProps<typeof CardRenderer>;
+export declare function MobileCardView({ children, ...props }: MobileCardViewProps): React.JSX.Element;
+export {};

package/dist/components/internal/workbench/mobile/components/adaptive/MobileChartView.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { default as ChartRenderer } from '../../../components/renderers/ChartRenderer';
+
+export type MobileChartViewProps = React.ComponentProps<typeof ChartRenderer>;
+/**
+ * Mobile wrapper around ChartRenderer.
+ * Reuses mock / dataset / database data loading so charts render on mobile.
+ */
+export declare function MobileChartView({ height, className, ...props }: MobileChartViewProps): React.JSX.Element;

package/dist/components/internal/workbench/mobile/components/adaptive/MobileDateRangeFilterField.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { DateRange } from 'react-day-picker';
+import { DateRangeDefaultConfig, DateRangeQuickSelectItems } from '../../../utils/filterPanelDateRangeUtils';
+
+export interface MobileDateRangeFilterFieldProps {
+    label: string;
+    value?: DateRange;
+    onChange: (range: DateRange | undefined) => void;
+    quickSelect?: boolean;
+    quickSelectItems?: DateRangeQuickSelectItems;
+    showTimePicker?: boolean;
+    placeholder?: string;
+    timeConfig?: DateRangeDefaultConfig;
+}
+declare function MobileDateRangeFilterField({ label, value, onChange, quickSelect, quickSelectItems, showTimePicker, placeholder, timeConfig, }: MobileDateRangeFilterFieldProps): React.JSX.Element;
+export default MobileDateRangeFilterField;

package/dist/components/internal/workbench/mobile/components/adaptive/MobileEChartsView.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { EChartsChartRendererProps } from '../../../components/renderers/EChartsChartRenderer';
+
+export type MobileEChartsViewProps = EChartsChartRendererProps;
+/**
+ * Mobile wrapper around EChartsChartRenderer.
+ * Reuses the full data pipeline (mock / dataset / database datasource) so charts
+ * render correctly on mobile; only layout and default height differ from desktop.
+ */
+export declare function MobileEChartsView({ height, className, showDataView, ...props }: MobileEChartsViewProps): React.JSX.Element;

package/dist/components/internal/workbench/mobile/components/adaptive/MobileFormView.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { default as FormRenderer } from '../../../components/renderers/FormRenderer';
+
+type MobileFormViewProps = React.ComponentProps<typeof FormRenderer>;
+export declare function MobileFormView(props: MobileFormViewProps): React.JSX.Element;
+export {};

package/dist/components/internal/workbench/mobile/components/adaptive/MobileListView.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { ListRendererProps } from '../../../types/renderers';
+
+/** Mobile-optimized List wrapper. */
+export declare const MobileListView: React.FC<ListRendererProps>;
+export default MobileListView;

package/dist/components/internal/workbench/mobile/components/adaptive/MobileStatCard.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+
+interface StatItem {
+    title: string;
+    value: string | number;
+    trend?: number;
+    trendLabel?: string;
+}
+interface MobileStatCardProps {
+    items?: StatItem[];
+}
+export declare function MobileStatCard({ items }: MobileStatCardProps): React.JSX.Element;
+export {};

package/dist/components/internal/workbench/mobile/components/adaptive/MobileTableView.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { default as TableRenderer } from '../../../components/renderers/TableRenderer';
+
+export type MobileTableViewProps = React.ComponentProps<typeof TableRenderer>;
+/**
+ * Mobile wrapper around TableRenderer.
+ * Reuses mock / dataset / database data loading so tables render on mobile.
+ */
+export declare function MobileTableView(props: MobileTableViewProps): React.JSX.Element;

package/dist/components/internal/workbench/mobile/components/adaptive/MobileTabsView.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { default as TabsRenderer } from '../../../components/renderers/TabsRenderer';
+
+type MobileTabsViewProps = React.ComponentProps<typeof TabsRenderer>;
+export declare function MobileTabsView(props: MobileTabsViewProps): React.JSX.Element;
+export {};

package/dist/components/internal/workbench/mobile/components/adaptive/index.d.ts

@@ -0,0 +1,4 @@
+export { MobileListView } from './MobileListView';
+export { MobileTabsView } from './MobileTabsView';
+export { MobileCardView } from './MobileCardView';
+export { MobileEChartsView } from './MobileEChartsView';

package/dist/components/internal/workbench/mobile/components/adaptive/mobileFilterFieldStyles.d.ts

@@ -0,0 +1,19 @@
+/** Shared layout tokens for mobile FilterPanel fields (DESIGN_GUIDELINE §05–07). */
+export declare const mobileFilterFieldStyles: {
+    readonly panel: string;
+    readonly fieldsStack: "flex flex-col gap-4";
+    /** Label left, control right (panel row fields). */
+    readonly field: "flex flex-row items-center gap-2";
+    /** Vertical stack inside bottom sheet (e.g. date start/end). */
+    readonly sheetField: "flex flex-col gap-2";
+    readonly label: "shrink-0 text-sm font-medium text-foreground whitespace-nowrap";
+    readonly control: "min-w-0 flex-1";
+    /** Border aligned with date summary row (overrides Select default neutral-300) */
+    readonly fieldControl: string;
+    readonly controlTrigger: string;
+    readonly selectTrigger: string;
+    readonly chipRow: "flex gap-2 overflow-x-auto pb-1";
+    readonly chip: "shrink-0 rounded-full";
+    readonly sheetFooter: string;
+    readonly sheetAction: "h-9 flex-1 rounded-lg";
+};

package/dist/components/internal/workbench/mobile/hooks/useMobileNavigationCanGoBack.d.ts

@@ -0,0 +1 @@
+export declare function useMobileNavigationCanGoBack(): boolean;

package/dist/components/internal/workbench/mobile/hooks/useMobileTabTransitionDirection.d.ts

@@ -0,0 +1 @@
+export declare function useMobileTabTransitionDirection(): -1 | 0 | 1;

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

@@ -0,0 +1,3 @@
+export { BottomTabNavigation } from './components/BottomTabNavigation';
+export * from './components/ComponentAdapter';
+export * from './components/adaptive';

package/dist/components/internal/workbench/mobile/utils/fetchUserCurrentSpaceId.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolve the user's active space from server settings only.
+ * Used for workbench space alignment — must not fall back to cookie.
+ */
+export declare function fetchUserCurrentSpaceIdStrict(): Promise<string | null>;
+/**
+ * Resolve the user's active space from server settings (authoritative),
+ * falling back to local cookie when the request fails.
+ */
+export declare function fetchUserCurrentSpaceId(): Promise<string | null>;
+export declare function waitForUserSpaceId(expectedSpaceId: string, options?: {
+    maxAttempts?: number;
+    delayMs?: number;
+    fetchUserCurrentSpaceId?: () => Promise<string | null>;
+}): Promise<boolean>;

package/dist/components/internal/workbench/mobile/utils/getMobileViewportState.d.ts

@@ -0,0 +1,25 @@
+export type ViewportMode = 'mobile' | 'desktop';
+export type ViewportOverride = ViewportMode | null;
+export type ViewportSource = 'override' | 'wecom' | 'ua' | 'default';
+export declare const VIEWPORT_OVERRIDE_STORAGE_KEY = "viewportOverride";
+export interface WorkbenchViewportDebugState {
+    mode: ViewportMode;
+    source: ViewportSource;
+    override: ViewportOverride;
+    canReturnToDesktop: boolean;
+}
+declare global {
+    interface Window {
+        __WORKBENCH_VIEWPORT__?: WorkbenchViewportDebugState;
+    }
+}
+export declare function getViewportOverride(): ViewportOverride;
+export declare function setViewportOverride(override: ViewportOverride): void;
+export declare function resolveViewportSource(): ViewportSource;
+export declare function resolveViewportMode(): ViewportMode;
+export declare function getIsMobileViewport(): boolean;
+export declare function isNativeMobileSession(): boolean;
+export declare function canReturnToDesktop(): boolean;
+export declare function getViewportDebugState(): WorkbenchViewportDebugState;
+export declare function publishViewportDebugState(): void;
+export declare function dispatchViewportModeChanged(): void;

package/dist/components/internal/workbench/mobile/utils/mobileBottomNav.d.ts

@@ -0,0 +1,13 @@
+import { NavigationItem } from '../../types';
+import { VisibleWhenContext } from '../../utils/visibleWhen';
+
+export interface MobileBottomNavTab {
+    key: string;
+    label: string;
+    icon?: string;
+    pageId: string;
+    pageParameters?: Record<string, unknown>;
+}
+export declare function resolveTabPageId(item: NavigationItem): string | null;
+export declare function resolveMobileBottomNavTabs(items: NavigationItem[] | undefined | null, currentMemberId?: string | null, language?: string, visibleWhenContext?: VisibleWhenContext): MobileBottomNavTab[];
+export declare function isMobileBottomNavTabActive(tab: MobileBottomNavTab, currentPageId: string | undefined, navigationItems: NavigationItem[] | undefined | null): boolean;

package/dist/components/internal/workbench/mobile/utils/mobileBottomNavInset.d.ts

@@ -0,0 +1,4 @@
+/** Bottom padding under page content. The tab bar is an in-flow footer (not fixed) since the
+ *  2026-07-15 WeCom jitter fix, so content no longer needs to clear a floating bar — this is
+ *  just a small breathing space above the nav. */
+export declare const MOBILE_BOTTOM_NAV_CLEARANCE = "1rem";