@genispace/geniapp 0.3.0 → 0.5.0

package/dist/components/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/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/lib/utils/cn.d.ts

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

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

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

package/dist/components/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/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/lib/utils/icon.d.ts

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

package/dist/components/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/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/locales/routeNamespaces.d.ts

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

package/dist/components/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/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/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/mobile/components/adaptive/MobileCardView.d.ts

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

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

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { default as ChartRenderer } from '../../../renderers/chart/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/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/mobile/components/adaptive/MobileEChartsView.d.ts

@@ -0,0 +1,10 @@
+import { default as React } from 'react';
+import { EChartsChartRendererProps } from '../../../renderers/echarts/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/mobile/components/adaptive/MobileFormView.d.ts

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

package/dist/components/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/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/mobile/components/adaptive/MobileTableView.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { default as TableRenderer } from '../../../renderers/table/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/mobile/components/adaptive/MobileTabsView.d.ts

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

package/dist/components/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/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/mobile/hooks/useMobileNavigationCanGoBack.d.ts

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

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

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

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

@@ -0,0 +1,4 @@
+export { MobileFlowLayoutProvider, useMobileFlowLayout } from './mobileFlowLayoutContext';
+export { ViewportProvider, useViewport } from '../contexts/ViewportContext';
+export { useMobileViewport } from '../hooks/useMobileViewport';
+export * from './components/ComponentAdapter';

package/dist/components/mobile/mobileFlowLayoutContext.d.ts

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

package/dist/components/mobile/runtime-index.d.ts

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

package/dist/components/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/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/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/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";

package/dist/components/mobile/utils/mobileComponentProps.d.ts

@@ -0,0 +1,44 @@
+import { TableColumnType } from '../../types/renderers';
+
+export declare const MOBILE_ADAPTED_COMPONENT_TYPES: Set<string>;
+export declare function isMobileWorkbenchViewport(): boolean;
+export declare function isMobileAdaptedComponentType(type: string): boolean;
+export declare function mapTableColumnsForMobile(columns?: TableColumnType[]): {
+    key: string;
+    title: string;
+}[];
+export declare function mapChartRowsForMobile(rows?: Record<string, unknown>[], xField?: string, yField?: string): {
+    label: string;
+    value: number;
+}[];
+export type MobileChartDisplayType = 'line' | 'bar' | 'pie';
+export interface MobileEChartsChartData {
+    title?: string;
+    displayType: MobileChartDisplayType;
+    data: Array<{
+        label: string;
+        value: number;
+    }>;
+    gaugeValue?: number;
+}
+export declare function mapEChartsRowsForMobile(rows?: Record<string, unknown>[], options?: {
+    chartType?: string;
+    nameField?: string;
+    valueField?: string;
+    categoryField?: string;
+    multiLineValueFields?: string[];
+    gaugeValue?: number;
+    title?: string;
+}): MobileEChartsChartData;
+export interface MobileStatisticItem {
+    title: string;
+    value: string | number;
+    trend?: number;
+    trendLabel?: string;
+}
+export declare function mapStatisticItemsForMobile(items?: Array<Record<string, unknown>>): MobileStatisticItem[];
+export declare function sortGrid24ComponentsForMobileFlow<T extends {
+    id?: string;
+    rowStart?: number;
+    colStart?: number;
+}>(components: T[], mobileOrder?: string[]): T[];

package/dist/components/mobile/utils/mobileFormDisplayUtils.d.ts

@@ -0,0 +1,4 @@
+import { FormField } from '../../types';
+
+export declare function formatMobileFormDisplayValue(field: FormField, value: unknown): string;
+export declare function getVisibleMobileFormFields(fields?: FormField[]): FormField[];

package/dist/components/mobile/utils/mobileNavigationStore.d.ts

@@ -0,0 +1,35 @@
+export interface MobileNavEntry {
+    pathname: string;
+    search: string;
+}
+export declare function isMobileWorkbenchPath(pathname: string): boolean;
+export declare function subscribeMobileNavigation(listener: () => void): () => void;
+export declare function subscribeMobileTabTransition(listener: () => void): () => void;
+export declare function getMobileTabTransitionDirection(): -1 | 0 | 1;
+export declare function setMobileTabTransitionDirection(direction: -1 | 0 | 1): void;
+export declare function resetMobileTabTransitionDirection(): void;
+export declare function getMobileNavigationCanGoBack(): boolean;
+export declare function resetMobileNavigationStack(): void;
+export declare function pushMobileNavigationEntry(location: {
+    pathname: string;
+    search: string;
+}): void;
+export declare function popMobileNavigationEntry(): MobileNavEntry | undefined;
+export declare function formatMobileNavEntry(entry: MobileNavEntry): string;
+export declare function shouldPushMobileNavigation(location: {
+    pathname: string;
+    search: string;
+}, targetPath: string): boolean;
+/** Record current page and navigate — used for in-app page jumps on mobile. */
+export declare function mobilePushNavigate(navigate: (to: string, options?: {
+    replace?: boolean;
+}) => void, location: {
+    pathname: string;
+    search: string;
+}, to: string, options?: {
+    replace?: boolean;
+}): void;
+/** Bottom tab navigation — clears stack and opens a root tab page. */
+export declare function mobileNavigateFromBottomTab(navigate: (to: string, options?: {
+    replace?: boolean;
+}) => void, to: string): void;

package/dist/components/mobile/utils/mobileToolbarNav.d.ts

@@ -0,0 +1,13 @@
+import { NavigationItem } from '../../types';
+import { VisibleWhenContext } from '../../utils/visibleWhen';
+import { MobileBottomNavTab } from './mobileBottomNav';
+
+export type MobileToolbarNavItem = MobileBottomNavTab;
+/**
+ * Top-level navigation items flagged `mobileToolbar: true`, rendered as entries in the
+ * mobile top toolbar ("..." panel). The device gate is intentionally NOT applied here —
+ * these items typically carry `visibility.devices: ['desktop']` precisely so they stay
+ * out of the mobile bottom nav while remaining reachable from the toolbar. Member and
+ * visibleWhen gates still apply.
+ */
+export declare function resolveMobileToolbarNavItems(items: NavigationItem[] | undefined | null, currentMemberId?: string | null, language?: string, visibleWhenContext?: VisibleWhenContext): MobileToolbarNavItem[];

package/dist/components/mobile/utils/mobileUA.d.ts

@@ -0,0 +1 @@
+export declare function isMobileUserAgent(userAgent?: string): boolean;

package/dist/components/mobile/utils/mobileWorkbenchSpaceSync.d.ts

@@ -0,0 +1,60 @@
+import { SpaceModel } from '../../shared/platform-ui/index.ts';
+
+export type MobileWorkbenchSpaceSyncResult = {
+    action: 'proceed';
+} | {
+    action: 'pending';
+} | {
+    action: 'switch';
+    targetSpaceId: string;
+} | {
+    action: 'denied';
+};
+export interface MobileWorkbenchSpaceSyncInput {
+    workbenchSpaceId: string;
+    serverSpaceId?: string | null;
+    currentSpaceId?: string | null;
+    persistedSpaceId?: string | null;
+    userSpaceIds: string[];
+    isDemoWorkbench: boolean;
+    alreadyAttemptedSwitch: boolean;
+    /** When false, mismatched space may still be valid once the list loads. */
+    spacesReady?: boolean;
+}
+export type AlignMobileWorkbenchSpaceResult = {
+    status: 'aligned';
+} | {
+    status: 'pending';
+} | {
+    status: 'switched';
+} | {
+    status: 'denied';
+} | {
+    status: 'switch_failed';
+};
+export interface AlignMobileWorkbenchSpaceParams {
+    workbenchId: string;
+    workbenchSpaceId: string;
+    currentSpaceId: string | null | undefined;
+    spaces: SpaceModel[];
+    spacesReady?: boolean;
+    isDemoWorkbench: boolean;
+    switchSpace: (space: SpaceModel, options?: {
+        skipNavigation?: boolean;
+    }) => Promise<void>;
+    fetchUserCurrentSpaceId?: () => Promise<string | null>;
+}
+/** Server settings first, then cookie, then React context. */
+export declare function resolveEffectiveCurrentSpaceId(input: {
+    serverSpaceId?: string | null;
+    persistedSpaceId?: string | null;
+    currentSpaceId?: string | null;
+}): string | null | undefined;
+export declare function markMobileWorkbenchSpaceSyncAttempted(workbenchId: string): void;
+export declare function hasMobileWorkbenchSpaceSyncAttempted(workbenchId: string): boolean;
+export declare function clearMobileWorkbenchSpaceSyncAttempts(workbenchId?: string): void;
+/**
+ * Decide whether mobile workbench entry should proceed, switch space, or deny access.
+ */
+export declare function resolveMobileWorkbenchSpaceSync(input: MobileWorkbenchSpaceSyncInput): MobileWorkbenchSpaceSyncResult;
+export declare function alignMobileWorkbenchSpace(params: AlignMobileWorkbenchSpaceParams): Promise<AlignMobileWorkbenchSpaceResult>;

package/dist/components/mobile/utils/wecomDetector.d.ts

@@ -0,0 +1,9 @@
+declare global {
+    interface Window {
+        __WECOM_DEVICE__?: string;
+        WxWork?: {
+            jsENV?: unknown;
+        };
+    }
+}
+export declare function isWeComEnvironment(): boolean;

package/dist/components/mobile/utils/workbenchSpaceSyncGate.d.ts

@@ -0,0 +1,7 @@
+/** Block datasource auto-fetch while mobile workbench space is being aligned. */
+export declare function beginWorkbenchSpaceSync(reason: string): void;
+export declare function endWorkbenchSpaceSync(reason: string): void;
+export declare function releaseWorkbenchSpaceSyncForMobileContent(): void;
+export declare function isWorkbenchSpaceSyncPending(): boolean;
+export declare function resetWorkbenchSpaceSyncGate(): void;
+export declare function subscribeWorkbenchSpaceSyncGate(listener: () => void): () => void;

package/dist/components/mobile.js

@@ -0,0 +1,25 @@
+import { H as a, I as i, J as s, K as r, N as l, O as b, Q as t, R as M, S as w, T as p, V, U as m, W as C, X as F, Y as T, Z as d, _ as n, $ as u, a0 as E, a1 as h, a2 as P } from "./renderers/runtime-DX1LfmqO.js";
+export {
+  a as MOBILE_ADAPTED_COMPONENT_TYPES,
+  i as MobileCardView,
+  s as MobileChartView,
+  r as MobileEChartsView,
+  l as MobileFlowLayoutProvider,
+  b as MobileFormView,
+  t as MobileListView,
+  M as MobileStatCard,
+  w as MobileTableView,
+  p as MobileTabsView,
+  V as ViewportProvider,
+  m as isMobileAdaptedComponentType,
+  C as isMobileWorkbenchViewport,
+  F as mapChartRowsForMobile,
+  T as mapEChartsRowsForMobile,
+  d as mapStatisticItemsForMobile,
+  n as mapTableColumnsForMobile,
+  u as sortGrid24ComponentsForMobileFlow,
+  E as useMobileFlowLayout,
+  h as useMobileViewport,
+  P as useViewport
+};
+//# sourceMappingURL=mobile.js.map

package/dist/components/mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mobile.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}