@genispace/geniapp 0.3.0 → 0.5.0

package/dist/components/shared/platform-ui/components/features/subscription/useSubscription.d.ts

@@ -0,0 +1,20 @@
+import { SubscriptionInfo, SubscriptionLimits, SubscriptionFeatures, ResourceUsage, ResourceRemaining, FeatureKey, ResourceType, SubscriptionPlan, UpgradePrompt, SubscriptionDisplay } from './types';
+
+export interface UseSubscriptionReturn {
+    subscription: SubscriptionInfo;
+    limits: SubscriptionLimits;
+    features: SubscriptionFeatures;
+    usage: ResourceUsage;
+    remaining: ResourceRemaining;
+    display?: SubscriptionDisplay;
+    isLoading: boolean;
+    isStandalone: boolean;
+    error: Error | null;
+    canAccess: (featureKey: FeatureKey) => boolean;
+    hasPlan: (requiredPlan: SubscriptionPlan) => boolean;
+    checkLimit: (resourceType: ResourceType, currentCount?: number) => boolean;
+    getFeatureUpgradePrompt: (featureKey: FeatureKey) => UpgradePrompt | null;
+    getResourceUpgradePrompt: (resourceType: ResourceType) => UpgradePrompt | null;
+    refresh: () => Promise<void>;
+}
+export declare function useSubscription(): UseSubscriptionReturn;

package/dist/components/shared/platform-ui/components/features/subscription/utils.d.ts

@@ -0,0 +1,18 @@
+import { SubscriptionPlan, UpgradePrompt, FeatureKey, ResourceType, SubscriptionLimits, ResourceRemaining } from './types';
+
+export declare function isPlanSufficient(currentPlan: SubscriptionPlan, requiredPlan: SubscriptionPlan): boolean;
+export declare function getUpgradePath(currentPlan: SubscriptionPlan): SubscriptionPlan[];
+export declare function getNextPlan(currentPlan: SubscriptionPlan): SubscriptionPlan | null;
+export declare function getPlanDisplayName(plan: SubscriptionPlan): string;
+export declare function getFeatureDisplayName(featureKey: FeatureKey): string;
+export declare function getResourceDisplayName(resourceType: ResourceType): string;
+export declare function generateFeatureUpgradePrompt(currentPlan: SubscriptionPlan, featureKey: FeatureKey): UpgradePrompt;
+export declare function generateResourceUpgradePrompt(currentPlan: SubscriptionPlan, resourceType: ResourceType, limit: number): UpgradePrompt;
+export declare function formatLimitValue(value: number): string;
+export declare function isUnlimited(value: number): boolean;
+/** Maps frontend ResourceType to plan limit field names (aligned with API RESOURCE_LIMIT_KEYS). */
+export declare function getResourceLimitValue(limits: SubscriptionLimits, resourceType: ResourceType): number | undefined;
+/** Maps frontend ResourceType to remaining usage keys (API uses spaceMember for teamMember). */
+export declare function getResourceRemainingValue(remaining: ResourceRemaining, resourceType: ResourceType): number | undefined;
+export declare function calculateUsagePercentage(current: number, limit: number): number;
+export declare function getUsageLevel(current: number, limit: number): 'low' | 'medium' | 'high' | 'full';

package/dist/components/shared/platform-ui/components/features/task/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/components/shared/platform-ui/components/features/team/index.d.ts

@@ -0,0 +1,4 @@
+/** @deprecated Import from `../space` or `@genispace/shared-ui` Space exports */
+export { SpaceContext as TeamContext, SpaceProvider as TeamProvider, useSpace as useTeam, type Space as Team, type SpaceMember as TeamMember, type SpaceOwner as TeamOwner, type SpaceApiClient as TeamApiClient, type SpaceProviderProps as TeamProviderProps, getSpaceIconType as getTeamIconType, getSpaceIconStyle as getTeamIconStyle, roleColors, useRoleNames, getRoleName, getRoleNameEn, getRoleClass, type SubscriptionPlan, } from '../space/SpaceContext';
+/** @deprecated Import SpaceSwitcher from `../space` */
+export { SpaceSwitcher as TeamSwitcher, type SpaceSwitcherProps as TeamSwitcherProps, } from '../space/SpaceSwitcher';

package/dist/components/shared/platform-ui/components/features/user/UserAvatar.d.ts

@@ -0,0 +1,17 @@
+export declare function userInitials(name: string, email?: string): string;
+export declare function resolveAvatarUrl(u: {
+    avatarUrl?: string | null;
+    avatar?: string | null;
+}): string | null;
+export type UserAvatarVariant = 'default' | 'chatUser';
+export interface UserAvatarProps {
+    name: string;
+    email?: string;
+    avatarUrl?: string | null;
+    /** Tailwind size classes, e.g. size-5, size-6, size-20 */
+    sizeClassName?: string;
+    className?: string;
+    variant?: UserAvatarVariant;
+    shape?: 'circle' | 'rounded';
+}
+export declare function UserAvatar({ name, email, avatarUrl, sizeClassName, className, variant, shape, }: UserAvatarProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/features/user/UserDisplay.d.ts

@@ -0,0 +1,10 @@
+import { PublicUserProfile } from './userDirectoryTypes';
+
+export type UserDisplayProps = {
+    userId?: string | null;
+    profile?: PublicUserProfile | null;
+    showAvatar?: boolean;
+    className?: string;
+    emptyLabel?: string;
+};
+export declare function UserDisplay({ userId, profile, showAvatar, className, emptyLabel, }: UserDisplayProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/features/user/UserSelect.d.ts

@@ -0,0 +1,14 @@
+import { PublicUserProfile } from './userDirectoryTypes';
+
+export type UserSelectProps = {
+    value: string;
+    onChange: (userId: string) => void;
+    members: PublicUserProfile[];
+    allowEmpty?: boolean;
+    emptyLabel?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+    id?: string;
+};
+export declare function UserSelect({ value, onChange, members, allowEmpty, emptyLabel, placeholder, disabled, className, id, }: UserSelectProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/features/user/useUserDirectory.d.ts

@@ -0,0 +1,13 @@
+import { PublicUserProfile, UserDirectoryClient } from './userDirectoryTypes';
+
+export type UseUserDirectoryOptions = {
+    memberStatus?: string;
+};
+export type UseUserDirectoryResult = {
+    loading: boolean;
+    error: string | null;
+    members: PublicUserProfile[];
+    getProfile: (userId: string | null | undefined) => PublicUserProfile | undefined;
+    resolveMany: (userIds: string[]) => Promise<void>;
+};
+export declare function useUserDirectory(client: UserDirectoryClient | null | undefined, options?: UseUserDirectoryOptions): UseUserDirectoryResult;

package/dist/components/shared/platform-ui/components/features/user/userDirectoryTypes.d.ts

@@ -0,0 +1,18 @@
+export type PublicUserProfile = {
+    id: string;
+    name: string;
+    email?: string;
+    avatarUrl?: string | null;
+    status?: string;
+};
+/** Minimal GeniSpace client surface for user directory hooks. */
+export type UserDirectoryClient = {
+    spaces: {
+        listMemberProfiles(params?: {
+            status?: string;
+        }): Promise<PublicUserProfile[]>;
+    };
+    users: {
+        getPublicProfiles(userIds: string[]): Promise<PublicUserProfile[]>;
+    };
+};

package/dist/components/shared/platform-ui/components/icons/alipay-pay-mark.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare function AlipayPayMark({ className, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;

package/dist/components/shared/platform-ui/components/icons/bank-transfer-mark.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare function BankTransferMark({ className, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;

package/dist/components/shared/platform-ui/components/icons/stripe-payment-mark.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare function StripePaymentMark({ className, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;

package/dist/components/shared/platform-ui/components/icons/wechat-pay-mark.d.ts

@@ -0,0 +1,2 @@
+import * as React from 'react';
+export declare function WeChatPayMark({ className, ...props }: React.SVGProps<SVGSVGElement>): React.JSX.Element;

package/dist/components/shared/platform-ui/components/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ui';
+export * from './primitives';
+export * from './features';

package/dist/components/shared/platform-ui/components/patterns/entity-patterns.d.ts

@@ -0,0 +1,3 @@
+export { FormSection, type FormSectionProps } from './form-section';
+export { RecordListFrame, type RecordListFrameProps } from './record-list-frame';
+export { StatusStepper, type StatusStep, type StatusStepperProps } from './status-stepper';

package/dist/components/shared/platform-ui/components/patterns/form-section.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+export type FormSectionProps = {
+    title: string;
+    description?: string;
+    children: React.ReactNode;
+    className?: string;
+};
+/**
+ * Grouped form block: title, optional description, and fields (design tokens).
+ */
+export declare function FormSection({ title, description, children, className }: FormSectionProps): React.JSX.Element;

package/dist/components/shared/platform-ui/components/patterns/record-list-frame.d.ts

@@ -0,0 +1,12 @@
+import * as React from 'react';
+export type RecordListFrameProps = {
+    title: string;
+    toolbar?: React.ReactNode;
+    footer?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
+};
+/**
+ * List shell: title row, optional toolbar, scrollable body (table in `children`).
+ */
+export declare function RecordListFrame({ title, toolbar, footer, children, className }: RecordListFrameProps): React.JSX.Element;

package/dist/components/shared/platform-ui/components/patterns/status-stepper.d.ts

@@ -0,0 +1,13 @@
+export type StatusStep = {
+    key: string;
+    label: string;
+};
+export type StatusStepperProps = {
+    steps: StatusStep[];
+    currentKey: string;
+    className?: string;
+};
+/**
+ * Compact horizontal step indicator for workflows or record states.
+ */
+export declare function StatusStepper({ steps, currentKey, className }: StatusStepperProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/data-display/ApiErrorState.d.ts

@@ -0,0 +1,10 @@
+export interface ApiErrorStateProps {
+    title: string;
+    detailMessage?: string;
+    showDetail?: boolean;
+    onRetry?: () => void;
+    retryLabel?: string;
+    className?: string;
+    compact?: boolean;
+}
+export declare function ApiErrorState({ title, detailMessage, showDetail, onRetry, retryLabel, className, compact, }: ApiErrorStateProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/data-display/FilePreviewDialog.d.ts

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+
+export interface FilePreviewDialogProps {
+    open: boolean;
+    onClose: () => void;
+    fileUrl?: string;
+    fileName: string;
+    mimeType?: string;
+    fileSize?: number;
+    showDownload?: boolean;
+    onDownload?: () => void | Promise<void>;
+    fileId?: string;
+    getFileUrl?: (fileId: string) => Promise<string>;
+    publicUrl?: string;
+    onCopyLink?: (publicUrl: string) => void | Promise<void>;
+    getAuthToken?: () => string | null;
+}
+export declare const FilePreviewDialog: React.FC<FilePreviewDialogProps>;

package/dist/components/shared/platform-ui/components/primitives/data-display/index.d.ts

@@ -0,0 +1,4 @@
+export { FilePreviewDialog } from './FilePreviewDialog';
+export type { FilePreviewDialogProps } from './FilePreviewDialog';
+export { ApiErrorState } from './ApiErrorState';
+export type { ApiErrorStateProps } from './ApiErrorState';

package/dist/components/shared/platform-ui/components/primitives/feedback/index.d.ts

@@ -0,0 +1,2 @@
+export { Toaster } from './toaster';
+export { useToast, toast, actionTypes, reducer } from './use-toast';

package/dist/components/shared/platform-ui/components/primitives/feedback/toaster.d.ts

@@ -0,0 +1 @@
+export declare function Toaster(): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/feedback/use-toast.d.ts

@@ -0,0 +1,46 @@
+import { ToastActionElement, ToastProps } from '../../ui/toast';
+import * as React from "react";
+type ToasterToast = ToastProps & {
+    id: string;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    action?: ToastActionElement;
+    duration?: number;
+};
+declare const actionTypes: {
+    readonly ADD_TOAST: "ADD_TOAST";
+    readonly UPDATE_TOAST: "UPDATE_TOAST";
+    readonly DISMISS_TOAST: "DISMISS_TOAST";
+    readonly REMOVE_TOAST: "REMOVE_TOAST";
+};
+export { actionTypes };
+type ActionType = typeof actionTypes;
+type Action = {
+    type: ActionType["ADD_TOAST"];
+    toast: ToasterToast;
+} | {
+    type: ActionType["UPDATE_TOAST"];
+    toast: Partial<ToasterToast>;
+} | {
+    type: ActionType["DISMISS_TOAST"];
+    toastId?: ToasterToast["id"];
+} | {
+    type: ActionType["REMOVE_TOAST"];
+    toastId?: ToasterToast["id"];
+};
+interface State {
+    toasts: ToasterToast[];
+}
+export declare const reducer: (state: State, action: Action) => State;
+type Toast = Omit<ToasterToast, "id">;
+declare function toast({ duration, ...props }: Toast): {
+    id: string;
+    dismiss: () => void;
+    update: (props: ToasterToast) => void;
+};
+declare function useToast(): {
+    toast: typeof toast;
+    dismiss: (toastId?: string) => void;
+    toasts: ToasterToast[];
+};
+export { useToast, toast };

package/dist/components/shared/platform-ui/components/primitives/forms/CountryCodeSelect.d.ts

@@ -0,0 +1,16 @@
+import { CountryCode } from '../../../../platform-utils/index.ts';
+import * as React from 'react';
+export interface CountryCodeSelectProps {
+    value?: string;
+    onChange?: (country: CountryCode) => void;
+    disabled?: boolean;
+    className?: string;
+    placeholder?: string;
+    language?: 'en' | 'zh';
+    /** When set, only these ISO country codes are listed (e.g. CN/HK/MO/TW). */
+    allowedCodes?: string[];
+    /** Show search input. Defaults to false when `allowedCodes` is set, otherwise true. */
+    searchable?: boolean;
+}
+export declare function CountryCodeSelect({ value, onChange, disabled, className, placeholder, language, allowedCodes, searchable, }: CountryCodeSelectProps): React.JSX.Element;
+export default CountryCodeSelect;

package/dist/components/shared/platform-ui/components/primitives/forms/index.d.ts

@@ -0,0 +1 @@
+export { CountryCodeSelect, type CountryCodeSelectProps } from './CountryCodeSelect';

package/dist/components/shared/platform-ui/components/primitives/index.d.ts

@@ -0,0 +1,5 @@
+export * from './forms';
+export * from './data-display';
+export * from './feedback';
+export * from './layout';
+export * from './page-skeleton';

package/dist/components/shared/platform-ui/components/primitives/layout/AppHeader.d.ts

@@ -0,0 +1,111 @@
+import { default as React } from 'react';
+import { NotificationApiClient } from '../../features/notification/NotificationList';
+import { SpaceApiClient } from '../../features/space/SpaceContext';
+import { UserSettingsApiClient } from '../../../hooks/useUserSettings';
+
+export interface User {
+    isLoggedIn?: boolean;
+    email?: string;
+    name?: string;
+    avatarUrl?: string | null;
+    token?: string;
+}
+/**
+ * One team-enabled built-in application shortcut (Odoo-style app bar).
+ * Parent should resolve `href` (e.g. `${appOrigin}/${appSlug}`) from config + team context.
+ */
+export interface EnabledBuiltInAppItem {
+    id: string;
+    label: string;
+    href: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
+}
+export interface AppHeaderProps {
+    currentApp?: 'console' | 'workbench' | 'chat' | 'workspace';
+    /** Whether to show the Console entry. Gate this by the user's console access
+     *  (e.g. in the Hub, application-only members have no console access). Default true. */
+    showConsoleEntry?: boolean;
+    /** Whether to show the Workspace (launcher) entry — the apps/agents home on the
+     *  Hub. Default true; it's the universal "back to the launcher" affordance. */
+    showWorkspaceEntry?: boolean;
+    /** Whether to show the Chat entry. Gate this by whether the user has any usable
+     *  chat target (the platform assistant or at least one accessible agent). When
+     *  the user can open nothing, hide it rather than dead-ending on `/chat/assistant`.
+     *  Use `useChatEntryTarget` to compute this consistently across planes. Default true. */
+    showChatEntry?: boolean;
+    /** In-app path the Chat entry opens, relative to `navigationConfig.chatUrl`.
+     *  Defaults to `/chat/assistant`. Pass the resolved target from
+     *  `useChatEntryTarget` so users without assistant access land on a usable agent. */
+    chatLandingPath?: string;
+    navigationConfig: {
+        /** Console (management) base URL — used for the "Console" entry button. */
+        consoleUrl: string;
+        /**
+         * Hub (main site / home) base URL — used for the brand/logo "home" link and
+         * the "Workspace" (launcher) entry. Falls back to
+         * `window.__APP_CONFIG__.APP_URL` (Hub base) then `consoleUrl` when omitted.
+         */
+        appUrl?: string;
+        workbenchUrl: string;
+        chatUrl: string;
+    };
+    /**
+     * Built-in apps the current team has enabled (platform API). Shown after Console (desktop), before theme; in the mobile menu after Console.
+     */
+    enabledBuiltInApps?: EnabledBuiltInAppItem[];
+    /** When the user is inside one of these apps, pass its `id` to highlight the matching shortcut.
+     */
+    activeBuiltInAppId?: string | null;
+    /** Used to persist pinned built-in nav apps via `PUT /users/me/settings`. */
+    userSettingsApiClient?: UserSettingsApiClient;
+    user?: User | null;
+    onSignOut: () => void | Promise<void>;
+    profileUrl?: string;
+    showSpaceSwitcher?: boolean;
+    /** @deprecated Use showSpaceSwitcher */
+    showTeamSwitcher?: boolean;
+    showNotifications?: boolean;
+    showFeedback?: boolean;
+    notificationApiClient?: NotificationApiClient;
+    spaceApiClient?: SpaceApiClient;
+    /** @deprecated Use spaceApiClient */
+    teamApiClient?: SpaceApiClient;
+    getUnreadNotificationsCount?: () => Promise<{
+        success: boolean;
+        data: {
+            total: number;
+        };
+    }>;
+    onViewAllNotifications?: () => void;
+    reportIssueUrl?: string;
+    feedbackRecordsUrl?: string;
+    onReportIssue?: () => void;
+    onFeedbackRecords?: () => void;
+    brandChannel?: string;
+    /**
+     * Optional host-provided brand logo URL (static config). The bundled
+     * GeniSpace mark renders by default — and immediately — so the app identity
+     * never depends on the hosting plane serving `/logo.svg`; a custom URL only
+     * augments it and falls back to the bundled mark if it fails to load.
+     */
+    brandLogoUrl?: string;
+    theme?: 'light' | 'dark';
+    onToggleTheme?: () => void;
+    currentLanguage?: string;
+    onToggleLanguage?: () => void;
+    manageSpaceUrl?: string;
+    createSpaceUrl?: string;
+    /** @deprecated Use manageSpaceUrl */
+    manageTeamUrl?: string;
+    /** @deprecated Use createSpaceUrl */
+    createTeamUrl?: string;
+    signInUrl?: string;
+    titleBarDrag?: boolean;
+    trailingExtras?: React.ReactNode;
+    compactHeight?: boolean;
+    teamLinksOpenExternal?: boolean;
+    userMenuBeforeLogout?: (closeMenu: () => void) => React.ReactNode;
+}
+export declare function AppHeader({ currentApp, showConsoleEntry, showWorkspaceEntry, showChatEntry, chatLandingPath, navigationConfig, user, onSignOut, profileUrl, showSpaceSwitcher, showTeamSwitcher, showNotifications, showFeedback, notificationApiClient, getUnreadNotificationsCount, onViewAllNotifications, reportIssueUrl, feedbackRecordsUrl, onReportIssue, onFeedbackRecords, theme, onToggleTheme, currentLanguage, onToggleLanguage, manageSpaceUrl, createSpaceUrl, manageTeamUrl, createTeamUrl, signInUrl, titleBarDrag, trailingExtras, compactHeight, teamLinksOpenExternal, userMenuBeforeLogout, enabledBuiltInApps, activeBuiltInAppId, userSettingsApiClient, brandLogoUrl, }: AppHeaderProps): React.JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/layout/AppWatermark.d.ts

@@ -0,0 +1,7 @@
+export interface AppWatermarkProps {
+    enabled?: boolean;
+    text?: string | null;
+}
+/** Renders a non-interactive diagonal watermark when enabled and text is present. */
+export declare function AppWatermark({ enabled, text }: AppWatermarkProps): import("react").JSX.Element;
+export { WatermarkOverlay, type WatermarkOverlayProps } from './WatermarkOverlay';

package/dist/components/shared/platform-ui/components/primitives/layout/PublicFooter.d.ts

@@ -0,0 +1,6 @@
+import { NavigationConfig } from './PublicHeader';
+
+export interface PublicFooterProps {
+    navigationConfig: NavigationConfig;
+}
+export declare function PublicFooter({ navigationConfig }: PublicFooterProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/layout/PublicHeader.d.ts

@@ -0,0 +1,39 @@
+import { UserSettingsApiClient } from '../../../hooks/useUserSettings';
+
+export interface User {
+    isLoggedIn?: boolean;
+    name?: string;
+    email?: string;
+    token?: string;
+    avatarUrl?: string | null;
+}
+export interface NavigationConfig {
+    /** Console (management) base URL — used for the "Console" entry. */
+    consoleUrl: string;
+    /**
+     * Hub (main site / home) base URL — used for the brand/logo home link and
+     * public discovery pages (App Store / Explore). Falls back to
+     * `window.__APP_CONFIG__.APP_URL` (Hub base) then `consoleUrl` when omitted.
+     */
+    appUrl?: string;
+    workbenchUrl: string;
+    chatUrl: string;
+    partnerUrl: string;
+    webUrl: string;
+}
+export interface PublicHeaderProps {
+    user?: User | null;
+    onSignOut: () => void | Promise<void>;
+    navigationConfig: NavigationConfig;
+    apiClient: UserSettingsApiClient;
+    currentLanguage?: string;
+    onToggleLanguage?: () => void;
+    navigation?: Array<{
+        name: string;
+        href: string;
+    }>;
+    signInUrl?: string;
+    profileUrl?: string;
+    onLogin?: () => void;
+}
+export declare function PublicHeader({ user, onSignOut, navigationConfig, apiClient, currentLanguage, onToggleLanguage, navigation, signInUrl, profileUrl, onLogin, }: PublicHeaderProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/layout/PublicLayout.d.ts

@@ -0,0 +1,6 @@
+import { PublicHeaderProps } from './PublicHeader';
+
+export interface PublicLayoutProps extends Omit<PublicHeaderProps, 'children'> {
+    showFooter?: boolean;
+}
+export declare function PublicLayout({ showFooter, ...headerProps }: PublicLayoutProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/layout/ThemeToggle.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+import { UserSettingsApiClient } from '../../../hooks/useUserSettings';
+
+export interface ThemeToggleProps {
+    /**
+     * Optional API client for server synchronization.
+     * If provided, theme changes will be synced to the server.
+     * If not provided, theme changes will only be stored locally.
+     */
+    apiClient?: UserSettingsApiClient | null;
+    /**
+     * Additional CSS class names to apply to the button
+     */
+    className?: string;
+}
+/**
+ * ThemeToggle component for switching between light and dark themes.
+ *
+ * This component uses the `useAppSettings` hook from shared-ui to manage theme state
+ * and optionally sync with the server if an `apiClient` is provided.
+ * Settings are automatically synced across subdomains via Cookie.
+ *
+ * @example
+ * ```tsx
+ * // Without server sync (local only)
+ * <ThemeToggle />
+ *
+ * // With server sync
+ * import apiClient from '@/lib/api/apiClient';
+ * <ThemeToggle apiClient={apiClient} />
+ * ```
+ */
+export declare function ThemeToggle({ apiClient, className }: ThemeToggleProps): React.JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/layout/WatermarkOverlay.d.ts

@@ -0,0 +1,9 @@
+export interface WatermarkOverlayProps {
+    text: string;
+    className?: string;
+}
+/**
+ * Non-interactive diagonal watermark. Uses a repeating SVG background (no DOM grid)
+ * and sits above content with pointer-events-none so clicks/drag pass through.
+ */
+export declare function WatermarkOverlay({ text, className }: WatermarkOverlayProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/layout/brandAssets.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bundled GeniSpace brand mark (same asset as the planes' `public/logo.svg`).
+ *
+ * The header identity must render deterministically on EVERY plane. A root-
+ * absolute `/logo.svg` only resolves when the hosting app both ships the file
+ * and is served at the origin root — the console (path-mounted at /console/)
+ * and the workbench don't, so the brand mark intermittently disappeared.
+ * Shipping the mark inside the bundle removes the runtime fetch entirely;
+ * hosts can still override it via `AppHeaderProps.brandLogoUrl`.
+ */
+export declare const GENISPACE_LOGO_DATA_URI = "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyBpZD0iX+WbvuWxgl8yIiBkYXRhLW5hbWU9IuWbvuWxgiAyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB2aWV3Qm94PSIwIDAgNzAwIDM0MS44MyI+CiAgPGRlZnM+CiAgICA8c3R5bGU+CiAgICAgIC5jbHMtMSB7CiAgICAgICAgZmlsbDogdXJsKCNf5pyq5ZG95ZCN55qE5riQ5Y+YXzYtMik7CiAgICAgIH0KCiAgICAgIC5jbHMtMiB7CiAgICAgICAgZmlsbDogdXJsKCNf5pyq5ZG95ZCN55qE5riQ5Y+YXzYpOwogICAgICB9CiAgICA8L3N0eWxlPgogICAgPGxpbmVhckdyYWRpZW50IGlkPSJf5pyq5ZG95ZCN55qE5riQ5Y+YXzYiIGRhdGEtbmFtZT0i5pyq5ZG95ZCN55qE5riQ5Y+YIDYiIHgxPSIyMi41MyIgeTE9IjI1NS43OSIgeDI9IjU4My45NiIgeTI9Ii02OC4zNiIgZ3JhZGllbnRVbml0cz0idXNlclNwYWNlT25Vc2UiPgogICAgICA8c3RvcCBvZmZzZXQ9IjAiIHN0b3AtY29sb3I9IiMzYjgyZjYiLz4KICAgICAgPHN0b3Agb2Zmc2V0PSIuMyIgc3RvcC1jb2xvcj0iIzYwNjBmMCIvPgogICAgICA8c3RvcCBvZmZzZXQ9Ii41NyIgc3RvcC1jb2xvcj0iIzdjNDdlZCIvPgogICAgICA8c3RvcCBvZmZzZXQ9Ii44MiIgc3RvcC1jb2xvcj0iIzhkMzhlYSIvPgogICAgICA8c3RvcCBvZmZzZXQ9IjEiIHN0b3AtY29sb3I9IiM5MzMzZWEiLz4KICAgIDwvbGluZWFyR3JhZGllbnQ+CiAgICA8bGluZWFyR3JhZGllbnQgaWQ9Il/mnKrlkb3lkI3nmoTmuJDlj5hfNi0yIiBkYXRhLW5hbWU9IuacquWRveWQjeeahOa4kOWPmCA2IiB4MT0iNDIzLjI1IiB5MT0iMzIyLjQiIHgyPSI3MTYuMjYiIHkyPSIxNTMuMjMiIHhsaW5rOmhyZWY9IiNf5pyq5ZG95ZCN55qE5riQ5Y+YXzYiLz4KICA8L2RlZnM+CiAgPGcgaWQ9Il/lm77lsYJfMS0yIiBkYXRhLW5hbWU9IuWbvuWxgiAxIj4KICAgIDxnPgogICAgICA8cGF0aCBjbGFzcz0iY2xzLTIiIGQ9Ik00OTMuOTcsMTAxLjg3bDcuODUsMzYuOTRjMS4wMyw2Ljk0LDEwLjMyLDEzLjc4LDIzLjA3LDYuMTZsMTMwLjI3LTkwLjAyQzYyMy45NywyMS42OCw1NzguMywwLDUyOS4wOSwwYy0yNi41LDAtNDguNTcsNC43My02OS4zOCwxNC44MS0xNy4zMSw4LjM5LTMyLjY3LDIwLjMyLTQ1LjUzLDM0LjYyLTguNjMsOS42LTE5LjA4LDIxLjYzLTI3LjE2LDMxLjAzLTQxLjA4LDQ3Ljc4LTEzMy43NiwxNTcuNDYtMjE1LjMxLDE0NC43N3YzMS42MWMwLDEuNDctMS43MywyLjI2LTIuODQsMS4yOWwtODUuMjUtNzQuMjJjLTIuODUtMi40OS0yLjg4LTYuOTEtLjA1LTkuNDNsODUuMDUtNzUuNTZjMS4xLS45OCwyLjg0LS4yLDIuODUsMS4yN2wuMjMsMzMuNDZjNjguMTQsMTkuMzcsMTM5LjExLTU1LjA3LDEzOS4xMS01NS4wNywwLDAtMTAuMDMtMTEuMTEtMTcuNy0yMC40M0MyNjEuOCwyMi41OSwyMjIuMDIsMCwxNzAuOTEsMCw3Ni41MiwwLDAsNzYuNTIsMCwxNzAuOTFzNzYuNTIsMTcwLjkxLDE3MC45MSwxNzAuOTFjMzQuMSwwLDU5LjkzLTguNTUsODcuNjQtMjUuODksMTMuNDEtOC4zOSwyNC45NC0xNy41NCwzNi4xNi0yNy4zMSwxNS4yNi0xMy4yOCwyOS43NS0yNy40MSw0My42MS00Mi4xM0w0NzYuNTksOTcuMTFjNS4wMy01LjI4LDE2LjI5LTIuNDUsMTcuMzgsNC43N1oiLz4KICAgICAgPHBhdGggY2xhc3M9ImNscy0xIiBkPSJNNjk5Ljk5LDE2OC42Yy0uNDQtMzMuMy0xMC40MS02NC4zLTI3LjMtOTAuNCwwLDAtMTU3LjUyLDE2My4zLTE3NS4zNiwxNzMuOTItNS4wMSwyLjk4LTExLjQ5LC4yOS0xMi45NC01LjM1bC0xMi42Mi00NC4zM2MtLjk0LTMuNjQtMy45Ny02LjA1LTcuMzctNi40OC0zLjQtLjg3LTcuMTktLjM2LTkuNjcsMi4wNGwtNjcuNjMsNjEuNzhjMzAuNzQsNDcuNzIsODMuMDMsODIuMTgsMTQyLjM4LDgyLjA1LDk0LjA5LS4yLDE3MS43Ny03OS4xNCwxNzAuNTItMTczLjIzWiIvPgogICAgPC9nPgogIDwvZz4KPC9zdmc+";

package/dist/components/shared/platform-ui/components/primitives/layout/index.d.ts

@@ -0,0 +1,6 @@
+export { AppHeader, type AppHeaderProps, type User as AppHeaderUser, type EnabledBuiltInAppItem, } from './AppHeader';
+export * from './ThemeToggle';
+export { PublicHeader, type PublicHeaderProps, type User as PublicHeaderUser, type NavigationConfig } from './PublicHeader';
+export * from './PublicFooter';
+export * from './PublicLayout';
+export { AppWatermark, WatermarkOverlay, type AppWatermarkProps, type WatermarkOverlayProps } from './AppWatermark';

package/dist/components/shared/platform-ui/components/primitives/page-skeleton/ChartAreaSkeleton.d.ts

@@ -0,0 +1,13 @@
+export type ChartSkeletonType = 'line' | 'column' | 'bar' | 'area' | 'pie' | 'radar' | 'heatmap' | 'composedBar' | 'overlapBar';
+export interface ChartAreaSkeletonProps {
+    /** 绘图区高度（px），与真实图高对齐以避免跳动 */
+    height: number;
+    chartType?: ChartSkeletonType;
+    className?: string;
+}
+/**
+ * 图表区骨架屏：替换居中 spinner。
+ * - pie / radar：环形占位 + legend 条。
+ * - 其余笛卡尔图：y 轴刻度 + 柱形占位 + x 轴刻度。
+ */
+export declare function ChartAreaSkeleton({ height, chartType, className }: ChartAreaSkeletonProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/page-skeleton/ChartEmptyState.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+import { ChartSkeletonType } from './ChartAreaSkeleton';
+
+export interface ChartEmptyStateProps {
+    /** 绘图区高度（px），与真实图高对齐避免跳动 */
+    height: number;
+    chartType?: ChartSkeletonType;
+    title?: string;
+    description?: string;
+    /** 操作按钮（如"重置筛选"）；不传则不渲染 */
+    action?: ReactNode;
+    className?: string;
+}
+export declare function ChartEmptyState({ height, chartType, title, description, action, className, }: ChartEmptyStateProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/page-skeleton/ComponentSkeletonShell.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties } from 'react';
+
+export interface ComponentSkeletonShellProps {
+    /** 是否展示卡片标题骨架条 */
+    showHeader?: boolean;
+    /** 内容区骨架行数 */
+    lines?: number;
+    /** 最小高度（px），与 loaded 态对齐避免跳动 */
+    height?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * 通用组件骨架壳：无专用骨架的组件类型的兜底占位（卡片标题条 + 若干内容行）。
+ */
+export declare function ComponentSkeletonShell({ showHeader, lines, height, className, style, }: ComponentSkeletonShellProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/page-skeleton/ConfigEditorSkeleton.d.ts

@@ -0,0 +1,5 @@
+export interface ConfigEditorSkeletonProps {
+    tabCount?: number;
+    className?: string;
+}
+export declare function ConfigEditorSkeleton({ tabCount, className }: ConfigEditorSkeletonProps): import("react").JSX.Element;

package/dist/components/shared/platform-ui/components/primitives/page-skeleton/DetailTabsSkeleton.d.ts

@@ -0,0 +1,6 @@
+export interface DetailTabsSkeletonProps {
+    tabCount?: number;
+    showHeader?: boolean;
+    className?: string;
+}
+export declare function DetailTabsSkeleton({ tabCount, showHeader, className, }: DetailTabsSkeletonProps): import("react").JSX.Element;