@genispace/geniapp 0.2.0 → 0.4.0

package/dist/components/internal/shared-ui/hooks/builtInApps.d.ts

@@ -0,0 +1,91 @@
+import { LucideIcon } from 'lucide-react';
+import { EnabledBuiltInAppItem } from '../components/primitives/layout/AppHeader';
+
+/** Single locale block from marketplace catalog → `metadata.locales`. */
+export type BuiltInAppLocaleBlock = {
+    name?: string;
+    description?: string;
+};
+/** Registry `metadata.locales` keyed by language code (`en`, `zh`, …). */
+export type BuiltInAppLocales = Record<string, BuiltInAppLocaleBlock>;
+/**
+ * Resolve visible app title from registry locales (same rules as API `pickLocalizedStrings`).
+ * Used so AppHeader updates when UI language changes without refetching the list.
+ */
+export declare function pickBuiltInAppDisplayName(fallbackName: string, locales: BuiltInAppLocales | null | undefined, displayLanguage: string | undefined): string;
+/**
+ * Resolve visible app description from registry locales (same rules as display name).
+ * Used by Workspace tiles so descriptions follow UI language without refetching.
+ */
+export declare function pickBuiltInAppDisplayDescription(fallbackDescription: string, locales: BuiltInAppLocales | null | undefined, displayLanguage: string | undefined): string;
+/**
+ * Enabled built-in app row from the platform API (`GET .../enabled-built-in-apps`).
+ */
+/** Optional shell sidebar links for the active GeniApp (manifest `navigation`, overridden by repo `data/navigation.json` when the API loads it). Paths are relative to `/${identifier}/`. */
+export type AppNavigationItem = {
+    label: string;
+    path: string;
+    /** Lucide icon component name, e.g. `ListChecks`. Resolved in App Shell sidebar. */
+    icon?: string | null;
+    /**
+     * When set, App Shell resolves the visible label with `useTranslation('shell')` (e.g. `geniapp_hr_timesheet_nav_summary`).
+     * Falls back to `label` if the key is missing in locale files.
+     */
+    labelKey?: string | null;
+};
+export interface BuiltInApp {
+    id: string;
+    /** URL segment under the shell, e.g. `demo` -> `/:appSlug` */
+    identifier: string;
+    name: string;
+    /** From catalog `metadata.locales`; enables header label to follow UI language. */
+    locales?: BuiltInAppLocales | null;
+    pinnedVersion: string | null;
+    /** Expanded iframe document base for this team's pinned version (manifest `iframeEntryTemplate`). */
+    iframeEntryTemplate?: string | null;
+    /** Optional `sandbox` attribute override for the iframe (space-separated tokens). */
+    iframeSandbox?: string | null;
+    /** Extra allowed Shell origins for postMessage validation on the GeniApp side (manifest `allowedShellOrigins`). */
+    allowedShellOrigins?: string[] | null;
+    /** Lucide icon name for shell sidebar app header (manifest `shellAppIcon`). */
+    shellAppIcon?: string | null;
+    /** When set, Shell may render these instead of a generic single-app link. */
+    navigation?: AppNavigationItem[] | null;
+    /** Navigation destination: App Shell iframe or Workbench editor. */
+    navTarget?: 'shell' | 'workbench';
+    /** Set when `navTarget === 'workbench'`. */
+    workbenchId?: string | null;
+}
+export declare const BUILT_IN_APPS_QUERY_KEY: readonly ["builtInApps"];
+/** Fallback when the API is unavailable (dev / contract drift). */
+export declare const MOCK_BUILT_IN_APPS: BuiltInApp[];
+/** Minimal GET client shape (axios wrapper / BaseApiClient). */
+export type BuiltInAppsApiClient = {
+    get<T = unknown>(url: string, params?: Record<string, unknown>, config?: unknown): Promise<{
+        success?: boolean;
+        data?: T;
+        message?: string;
+    }>;
+};
+export type BuiltInAppsPayload = {
+    apps: BuiltInApp[];
+};
+/**
+ * GET `/spaces/current/enabled-built-in-apps` — enabled built-ins for the active space.
+ */
+export declare function fetchBuiltInApps(apiClient: BuiltInAppsApiClient): Promise<BuiltInApp[]>;
+/**
+ * Build AppHeader shortcuts: links go to the **App Shell** origin (`SHELL_URL`), not Console/Chat.
+ * When the API provides `navigation`, the first item's `path` is appended so the Shell opens the same landing as the sidebar (no version segment in the Shell URL).
+ */
+export declare function mapBuiltInAppsToHeaderItems(apps: BuiltInApp[], shellOrigin: string, fallbackIcon?: LucideIcon, displayLanguage?: string): EnabledBuiltInAppItem[];
+export type MapNavAppsOptions = {
+    shellOrigin: string;
+    workbenchUrl: string;
+    fallbackIcon?: LucideIcon;
+    displayLanguage?: string;
+};
+/**
+ * Map enabled nav apps (Shell GeniApps + Workbench apps) to AppHeader shortcut items.
+ */
+export declare function mapNavAppsToHeaderItems(apps: BuiltInApp[], options: MapNavAppsOptions): EnabledBuiltInAppItem[];

package/dist/components/internal/shared-ui/hooks/pinnedBuiltInNavApps.d.ts

@@ -0,0 +1,13 @@
+import { UserSettingsApiClient } from './useUserSettings';
+
+export declare const PINNED_BUILT_IN_NAV_APPS_CHANGED_EVENT = "genispace:pinnedBuiltInNavAppsChanged";
+export interface UsePinnedBuiltInNavAppsOptions {
+    apiClient?: UserSettingsApiClient | null;
+}
+export declare function usePinnedBuiltInNavApps(options?: UsePinnedBuiltInNavAppsOptions): {
+    pinnedIds: string[];
+    pin: (appId: string) => Promise<void>;
+    unpin: (appId: string) => Promise<void>;
+    isPinned: (appId: string) => boolean;
+    refresh: () => Promise<void>;
+};

package/dist/components/internal/shared-ui/hooks/shellNavLucideIcon.d.ts

@@ -0,0 +1,6 @@
+import { LucideIcon } from 'lucide-react';
+
+/**
+ * Resolve a manifest icon name (e.g. `"Timer"`) to a Lucide component.
+ */
+export declare function resolveShellNavLucideIcon(name?: string | null, fallback?: LucideIcon): LucideIcon;

package/dist/components/internal/shared-ui/hooks/useAppSettings.d.ts

@@ -0,0 +1,21 @@
+import { UserSettingsApiClient } from './useUserSettings';
+
+export interface UseAppSettingsOptions {
+    apiClient?: UserSettingsApiClient | null;
+    userLoggedIn?: boolean;
+    /**
+     * Skip applying theme/language from cookies + `initializeSettings` on mount.
+     * Use for iframe embed routes where the URL owns light/dark and `lang` (see chat `EmbedLayout`).
+     */
+    skipPersistedChromeBootstrap?: boolean;
+}
+export declare function useAppSettings(options?: UseAppSettingsOptions): {
+    theme: string;
+    language: string;
+    timeZone: string;
+    spaceId: string;
+    toggleTheme: (theme?: "light" | "dark") => Promise<void>;
+    toggleLanguage: (language?: string) => Promise<void>;
+    updateTimeZone: (timeZone: string) => Promise<void>;
+    updateSpaceId: (spaceId: string | null) => Promise<void>;
+};

package/dist/components/internal/shared-ui/hooks/useAuthTokenSync.d.ts

@@ -0,0 +1,3 @@
+export declare function useAuthTokenSync(user: {
+    isLoggedIn?: boolean;
+} | null, setUser: (user: null) => void): void;

package/dist/components/internal/shared-ui/hooks/useBuiltInApps.d.ts

@@ -0,0 +1,6 @@
+import { BuiltInAppsApiClient } from './builtInApps';
+
+/**
+ * Cached list of enabled built-in GeniApps (invalidates on `spaceSwitched`).
+ */
+export declare function useBuiltInApps(apiClient: BuiltInAppsApiClient): import('@tanstack/react-query').UseQueryResult<import('./builtInApps').BuiltInApp[], Error>;

package/dist/components/internal/shared-ui/hooks/useChatEntryTarget.d.ts

@@ -0,0 +1,35 @@
+import { UserSettingsApiClient } from './useUserSettings';
+
+/**
+ * Resolves where the shared header's "Chat" entry should point — and whether it
+ * should appear at all — based on what the current user can actually open in the
+ * active space. Mirrors the `showConsoleEntry` pattern: each app computes the
+ * decision from data it already has access to and passes the result to AppHeader,
+ * so all planes (hub / console / chat / workbench / shell) stay consistent.
+ *
+ * Decision tree (confirmed product behaviour):
+ *   1. Resume the single most recent session the user can still open — if it's a
+ *      platform-assistant session (`userAgentId == null`) -> `/chat/assistant`,
+ *      otherwise the specific agent -> `/chat/{userAgentId}`.
+ *   2. No resumable session: the platform assistant, if accessible -> `/chat/assistant`.
+ *   3. Otherwise the first accessible agent -> `/chat/{id}`.
+ *   4. Nothing usable -> hide the entry (`showChatEntry = false`).
+ *
+ * Fails open: while resolving (and on any error) the entry stays visible and
+ * points at `/chat/assistant`, matching the historical default, so a transient
+ * API hiccup never hides core navigation.
+ */
+export declare const DEFAULT_CHAT_LANDING_PATH = "/chat/assistant";
+export interface ChatEntryTarget {
+    /** Whether the Chat entry should be shown at all. */
+    showChatEntry: boolean;
+    /** In-app path (relative to the chat origin) the Chat entry should open. */
+    chatLandingPath: string;
+}
+export interface UseChatEntryTargetOptions {
+    /** Client used to probe agent access. When omitted the hook fails open. */
+    apiClient?: UserSettingsApiClient | null;
+    /** Set false to skip resolution entirely (e.g. embed/unauthenticated shells). */
+    enabled?: boolean;
+}
+export declare function useChatEntryTarget(options?: UseChatEntryTargetOptions): ChatEntryTarget;

package/dist/components/internal/shared-ui/hooks/useIsMobile.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tailwind `sm` breakpoint in px. Below this width we treat the viewport as an
+ * H5 / mobile device and switch to the mobile-first layouts (stat grids start at
+ * 2 columns, data tables fall back to card lists, denser padding, etc.).
+ */
+export declare const MOBILE_BREAKPOINT = 640;
+/**
+ * Reports whether the viewport is narrower than the given breakpoint (default:
+ * the Tailwind `sm` boundary, 640px). SSR-safe — returns `false` on the server
+ * and during the first client render, then syncs on mount so hydration matches.
+ *
+ * Use this to switch between desktop and mobile renderings that pure Tailwind
+ * responsive classes cannot express — e.g. rendering a card list instead of a
+ * `<table>`, or mounting a bottom sheet instead of an inline filter row.
+ */
+export declare function useIsMobile(breakpoint?: number): boolean;

package/dist/components/internal/shared-ui/hooks/useLanguage.d.ts

@@ -0,0 +1,11 @@
+import { UserSettingsApiClient } from './useUserSettings';
+
+type Language = 'zh' | 'en';
+export interface UseLanguageOptions {
+    apiClient?: UserSettingsApiClient | null;
+}
+export declare function useLanguage(options?: UseLanguageOptions): {
+    language: Language;
+    toggleLanguage: () => Promise<void>;
+};
+export {};

package/dist/components/internal/shared-ui/hooks/useLockBodyScroll.d.ts

@@ -0,0 +1 @@
+export declare function useLockBodyScroll(lock: boolean): void;

package/dist/components/internal/shared-ui/hooks/usePageState/index.d.ts

@@ -0,0 +1,4 @@
+import { PageStateOptions, PageStateReturn, StorageType } from './types';
+
+export type { PageStateOptions, PageStateReturn, StorageType };
+export declare function usePageState<T extends Record<string, unknown>>(options: PageStateOptions<T>): PageStateReturn<T>;

package/dist/components/internal/shared-ui/hooks/usePageState/types.d.ts

@@ -0,0 +1,13 @@
+export type StorageType = 'localStorage' | 'sessionStorage';
+export interface PageStateOptions<T extends Record<string, unknown>> {
+    key: string;
+    defaultValues: T;
+    storageType?: StorageType;
+    restoreOnMount?: boolean;
+}
+export interface PageStateReturn<T> {
+    state: T;
+    setState: React.Dispatch<React.SetStateAction<T>>;
+    resetState: () => void;
+    updateField: <K extends keyof T>(key: K, value: T[K]) => void;
+}

package/dist/components/internal/shared-ui/hooks/useTheme.d.ts

@@ -0,0 +1,11 @@
+import { UserSettingsApiClient } from './useUserSettings';
+
+type Theme = 'light' | 'dark';
+export interface UseThemeOptions {
+    apiClient?: UserSettingsApiClient | null;
+}
+export declare function useTheme(options?: UseThemeOptions): {
+    theme: Theme;
+    toggleTheme: () => Promise<void>;
+};
+export {};

package/dist/components/internal/shared-ui/hooks/useUserSettings.d.ts

@@ -0,0 +1,39 @@
+import { PinnedBuiltInNavAppsMap } from './userPreferencesPinnedNav';
+
+export interface UserPreferences {
+    theme: 'light' | 'dark';
+    language: string;
+    timeZone: string;
+    pinnedBuiltInNavApps?: PinnedBuiltInNavAppsMap;
+}
+export interface UserSettings {
+    spaceId: string | null;
+    preferences: UserPreferences;
+}
+export interface UserSettingsApiClient {
+    get: (url: string, params?: Record<string, unknown>, config?: any) => Promise<{
+        success: boolean;
+        data?: unknown;
+        message?: string;
+    }>;
+    put: (url: string, data?: unknown, config?: any) => Promise<{
+        success: boolean;
+        data?: unknown;
+        message?: string;
+    }>;
+}
+/**
+ * Hook for managing user settings (spaceId + preferences)
+ * Provides methods to get, update, and sync user settings
+ */
+export declare function useUserSettings(apiClient: UserSettingsApiClient): {
+    loading: boolean;
+    error: string;
+    getUserSettings: () => Promise<UserSettings | null>;
+    updateUserSettings: (updates: Partial<{
+        spaceId: string | null;
+        preferences: Partial<UserPreferences>;
+    }>) => Promise<UserSettings | null>;
+    syncSettings: (settings: UserSettings) => void;
+    fetchAndSyncSettings: () => Promise<UserSettings | null>;
+};

package/dist/components/internal/shared-ui/hooks/useWorkflowCanvas.d.ts

@@ -0,0 +1,36 @@
+import { MarkerType, Connection, Edge, Node, ReactFlowInstance, OnNodesChange, OnEdgesChange } from 'reactflow';
+import { Dispatch, MutableRefObject, SetStateAction } from 'react';
+
+export interface UseWorkflowCanvasOptions {
+    initialNodes?: Node[];
+    initialEdges?: Edge[];
+    defaultEdgeColor?: string;
+    snapGrid?: [number, number];
+    requirePorts?: boolean;
+    onConnectionError?: (message: string) => void;
+}
+export interface UseWorkflowCanvasReturn {
+    nodes: Node[];
+    edges: Edge[];
+    setNodes: Dispatch<SetStateAction<Node[]>>;
+    setEdges: Dispatch<SetStateAction<Edge[]>>;
+    onNodesChange: OnNodesChange;
+    onEdgesChange: OnEdgesChange;
+    onConnect: (params: Connection) => void;
+    reactFlowInstanceRef: MutableRefObject<ReactFlowInstance | null>;
+    connectionLineStyle: React.CSSProperties;
+    defaultEdgeOptions: {
+        animated: boolean;
+        style: {
+            stroke: string;
+            strokeWidth: number;
+        };
+        markerEnd: {
+            type: MarkerType;
+            color: string;
+            width: number;
+            height: number;
+        };
+    };
+}
+export declare function useWorkflowCanvas(options?: UseWorkflowCanvasOptions): UseWorkflowCanvasReturn;

package/dist/components/internal/shared-ui/hooks/userPreferencesPinnedNav.d.ts

@@ -0,0 +1,2 @@
+export type PinnedBuiltInNavAppsMap = Record<string, string[]>;
+export declare function normalizePinnedBuiltInNavAppsMap(raw: unknown): PinnedBuiltInNavAppsMap;

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

@@ -0,0 +1,127 @@
+export { Z_INDEX_LAYERS, Z_INDEX_CLASSES } from './styles/z-index-layers';
+export { CSS_VARS, BRAND_COLORS, TYPOGRAPHY, SPACING, SHADOWS, TRANSITIONS, MODAL_DIMENSIONS, } from './styles/design-tokens';
+export { cn } from '../shared-utils/index.ts';
+export { Button, buttonVariants, type ButtonProps } from './components/ui/button';
+export { Input } from './components/ui/input';
+export { Label } from './components/ui/label';
+export { Textarea } from './components/ui/textarea';
+export { Checkbox } from './components/ui/checkbox';
+export { Switch } from './components/ui/switch';
+export { RadioGroup, RadioGroupItem } from './components/ui/radio-group';
+export { RadioButtonGroup, type RadioButtonGroupProps, type RadioButtonOption } from './components/ui/radio-button-group';
+export { Slider } from './components/ui/slider';
+export { Progress } from './components/ui/progress';
+export { Skeleton } from './components/ui/skeleton';
+export { Separator, type SeparatorProps } from './components/ui/separator';
+export { Badge, badgeVariants, type BadgeProps } from './components/ui/badge';
+export { StripePaymentMark } from './components/icons/stripe-payment-mark';
+export { WeChatPayMark } from './components/icons/wechat-pay-mark';
+export { AlipayPayMark } from './components/icons/alipay-pay-mark';
+export { BankTransferMark } from './components/icons/bank-transfer-mark';
+export { Avatar, AvatarImage, AvatarFallback } from './components/ui/avatar';
+export { UserAvatar, userInitials, resolveAvatarUrl, type UserAvatarProps, type UserAvatarVariant, } from './components/features/user/UserAvatar';
+export { UserDisplay, type UserDisplayProps } from './components/features/user/UserDisplay';
+export { UserSelect, type UserSelectProps } from './components/features/user/UserSelect';
+export { useUserDirectory, type UseUserDirectoryResult } from './components/features/user/useUserDirectory';
+export type { PublicUserProfile, UserDirectoryClient, } from './components/features/user/userDirectoryTypes';
+export { AvatarPickerModal, AVATAR_STYLES, generateAvatarUrl, type AvatarPickerModalProps, type AvatarPickerLabels, type AvatarStyle, } from './components/features/avatar';
+export { AgentIdentity, agentIdentitySizeClass, getAgentIdentityInitials, getAgentIdentityTone, type AgentIdentityProps, type AgentIdentitySize, } from './components/features/agent';
+export { Card, CardHeader, CardFooter, CardTitle, CardDescription, CardContent } from './components/ui/card';
+export { Tabs, TabsList, TabsTrigger, TabsContent } from './components/ui/tabs';
+export { UnderlineTabs, UnderlineTabsList, UnderlineTabsTrigger, UnderlineTabsContent, underlineTabsTriggerVariants, } from './components/ui/underline-tabs';
+export { Toggle, toggleVariants } from './components/ui/toggle';
+export { ToggleGroup, ToggleGroupItem } from './components/ui/toggle-group';
+export { ViewModeToggle, type ViewModeToggleProps, type ViewMode, } from './components/ui/view-mode-toggle';
+export { Accordion, AccordionItem, AccordionTrigger, AccordionContent } from './components/ui/accordion';
+export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './components/ui/collapsible';
+export { ScrollArea, ScrollBar } from './components/ui/scroll-area';
+export { Sheet, SheetTrigger, SheetClose, SheetContent, SheetHeader, SheetFooter, SheetTitle, SheetDescription } from './components/ui/sheet';
+export { SidebarRail } from './components/ui/sidebar-rail';
+export { Form, FormItem, FormLabel, FormControl, FormDescription, FormMessage, FormField, useFormField, } from './components/ui/form';
+export { Dialog, DialogPortal, DialogOverlay, DialogClose, DialogTrigger, DialogContent, DialogHeader, DialogFooter, DialogTitle, DialogDescription, } from './components/ui/dialog';
+export { DialogInput, type DialogInputProps } from './components/ui/dialog-input';
+export { AlertDialog, AlertProvider, useAlert, useAlertDialog, type AlertType, } from './components/ui/alert-dialog';
+export { ModalContainer, useModal, MODAL_SIZES, type ModalSize, } from './components/ui/modal-container';
+export { BaseModal, FormModal, ConfirmModal, ListModal, } from './components/ui/modal-templates';
+export * from './components/ui/dialog-safe-select';
+export * from './components/ui/dropdown-menu';
+export * from './components/ui/select';
+export { MultiSelect, type MultiSelectProps, type MultiSelectOption } from './components/ui/multi-select';
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor } from './components/ui/popover';
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from './components/ui/tooltip';
+export { Calendar, type CalendarProps } from './components/ui/calendar';
+export { DatePicker, type DatePickerProps } from './components/ui/date-picker';
+export { DateRangePicker, type DateRangePickerProps, type DateRange } from './components/ui/date-range-picker';
+export { DateRangeFilter, type DateRangeFilterProps, type DateRange as DateRangeFilterDateRange, type DateRangeQuickSelectPresetKey } from './components/ui/date-range-filter';
+export { Alert, AlertTitle, AlertDescription } from './components/ui/alert';
+export { HintNotice, type HintNoticeProps, type HintNoticeVariant, } from './components/ui/hint-notice';
+export { HelpTip, type HelpTipProps } from './components/ui/help-tip';
+export { FeatureGuide, FeatureGuideTrigger, type FeatureGuideProps, type FeatureGuideStep, type FeatureGuideTriggerProps, } from './components/ui/feature-guide';
+export { AiDraftBanner, type AiDraftBannerProps, type AiDraftBannerTone, } from './components/ui/ai-draft-banner';
+export { useColumnConfig, ColumnConfigMenu, type ColumnConfigColumn, type ColumnConfigMenuProps, type UseColumnConfigResult, } from './components/ui/column-config';
+export * from './components/ui/toast';
+export { Toaster, useToast, toast } from './components/primitives/feedback';
+export { FilePreviewDialog, type FilePreviewDialogProps, ApiErrorState, type ApiErrorStateProps } from './components/primitives/data-display';
+export { Breadcrumb, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, } from './components/ui/breadcrumb';
+export * from './components/ui/table';
+export { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, type ChartConfig, } from './components/ui/chart';
+export { AiSuggestion, AiSuggestionAction, AiMessage } from './components/ai';
+/** Optional: import from `./components/features/rich-text/RichTextField` when @tiptap/* peers are installed. */
+export * from './components/ui/pagination';
+export { H1, H2, H3, H4, P, Blockquote, InlineCode, Lead, Large, Small, Muted, } from './components/ui/typography';
+export * from './components';
+export { HomepageBackground } from './components/features/home';
+export * as Auth from './components/features/auth';
+export * as Task from './components/features/task';
+export * as Agent from './components/features/agent';
+export * as Chat from './components/features/chat';
+export * as Application from './components/features/auth/application';
+export * as Operator from './components/features/operator';
+export * as Data from './components/features/data';
+export * as Team from './components/features/team';
+export * as Space from './components/features/space';
+export * as Rbac from './components/features/rbac';
+export { SpaceContext, SpaceProvider, useSpace, SpaceSwitcher, type SpaceMember, type SpaceOwner, type SpaceApiClient, type SpaceProviderProps, type Space as SpaceModel, getSpaceIconType, getSpaceIconStyle, roleColors as spaceRoleColors, useRoleNames, getRoleName, getRoleNameEn, getRoleClass, } from './components/features/space';
+/** @deprecated Use SpaceContext / useSpace or `Team` namespace */
+export { TeamContext, TeamProvider, useTeam, TeamSwitcher, type TeamMember, type TeamOwner, type TeamApiClient, type TeamProviderProps, getTeamIconType, getTeamIconStyle, } from './components/features/team';
+export { RequireAuth, type RequireAuthApiClient, type RequireAuthProps, type RequireAuthUser, } from './components/features/auth/RequireAuth';
+export { LogoutNotificationPage } from './components/features/auth/LogoutNotificationPage';
+export { useLockBodyScroll } from './hooks/useLockBodyScroll';
+export { useIsMobile, MOBILE_BREAKPOINT } from './hooks/useIsMobile';
+export { useTheme, type UseThemeOptions } from './hooks/useTheme';
+export { useLanguage, type UseLanguageOptions } from './hooks/useLanguage';
+export { useUserSettings, type UserSettings, type UserPreferences, type UserSettingsApiClient } from './hooks/useUserSettings';
+export { useAppSettings, type UseAppSettingsOptions } from './hooks/useAppSettings';
+export { useWorkflowCanvas, type UseWorkflowCanvasOptions, type UseWorkflowCanvasReturn } from './hooks/useWorkflowCanvas';
+export { useAuthTokenSync } from './hooks/useAuthTokenSync';
+export { BUILT_IN_APPS_QUERY_KEY, MOCK_BUILT_IN_APPS, fetchBuiltInApps, mapBuiltInAppsToHeaderItems, mapNavAppsToHeaderItems, pickBuiltInAppDisplayName, pickBuiltInAppDisplayDescription, type BuiltInApp, type BuiltInAppLocaleBlock, type BuiltInAppLocales, type AppNavigationItem, type BuiltInAppsApiClient, type BuiltInAppsPayload, } from './hooks/builtInApps';
+export { resolveShellNavLucideIcon } from './hooks/shellNavLucideIcon';
+export { useBuiltInApps } from './hooks/useBuiltInApps';
+export { usePinnedBuiltInNavApps, PINNED_BUILT_IN_NAV_APPS_CHANGED_EVENT, type UsePinnedBuiltInNavAppsOptions, } from './hooks/pinnedBuiltInNavApps';
+export { normalizePinnedBuiltInNavAppsMap, type PinnedBuiltInNavAppsMap, } from './hooks/userPreferencesPinnedNav';
+export { useChatEntryTarget, DEFAULT_CHAT_LANDING_PATH, type ChatEntryTarget, type UseChatEntryTargetOptions, } from './hooks/useChatEntryTarget';
+export { usePageState, type PageStateOptions, type PageStateReturn, type StorageType } from './hooks/usePageState';
+export { UserSettingsProvider, useUserSettingsContext, type UserSettingsProviderProps } from './contexts/UserSettingsContext';
+export { AppHostContext, AppHostProvider, useAppHost, type AppHostContextValue, } from './context/AppHostContext';
+export { getPlatform, isDesktop, openExternal, navigateTo, resolveAbsoluteUrl, resolveNavigationHref, isAbsoluteUrl, isModifiedNavigationClick, openNavigationInNewTab, navigateHeaderLink, handleHeaderNavigationClick, handleHeaderAnchorClick, navigateExternalOrInApp, } from './platform';
+export type { Platform } from './platform/types';
+export type { NavigateToOptions } from './platform';
+export { AppSidebar, type AppSidebarProps, type AppSidebarNavGroup } from './components/features/app/Sidebar';
+export { AppPage, type AppPageProps } from './components/features/app/Page';
+export { AppPageStates, type AppPageStatesProps } from './components/features/app/AppPageStates';
+export { AppDashboardSkeleton, type AppDashboardSkeletonProps } from './components/features/app/AppDashboardSkeleton';
+export { QueryErrorAlert, type QueryErrorAlertProps } from './components/features/app/QueryErrorAlert';
+export { AppModal, AppHelpSheet, type AppModalProps, type AppModalSize, type AppHelpSheetProps, } from './components/features/app/AppModal';
+export { AppConfirmDialog, type AppConfirmDialogProps, } from './components/features/app/AppConfirmDialog';
+export { AppDatePicker, AppDateRangePicker, AppDateTimePicker, AppTimePicker, temporalLabels, parseBusinessDate, formatBusinessDateValue, type AppDatePickerProps, type AppDateRangePickerProps, type AppDateTimePickerProps, type AppTimePickerProps, type AppTemporalLabels, type AppDatePickerPopoverLayer, type AppDateTimePickerPopoverLayer, } from './components/features/app/AppDatePicker';
+export { AppTemporalInput, isTemporalInputType, type AppTemporalInputProps, type TemporalInputType, } from './components/features/app/AppTemporalInput';
+export { AppSelectInput, type AppSelectInputProps } from './components/features/app/AppSelectInput';
+export { AppCheckboxInput, type AppCheckboxInputProps } from './components/features/app/AppCheckboxInput';
+export { FormSection, RecordListFrame, StatusStepper, type FormSectionProps, type RecordListFrameProps, type StatusStep, type StatusStepperProps, } from './components/patterns/entity-patterns';
+export { ThemeToggle, type ThemeToggleProps } from './components/primitives/layout/ThemeToggle';
+export { PublicHeader, type PublicHeaderProps, type NavigationConfig, type User as PublicHeaderUser } from './components/primitives/layout/PublicHeader';
+export { PublicFooter } from './components/primitives/layout/PublicFooter';
+export { PublicLayout, type PublicLayoutProps } from './components/primitives/layout/PublicLayout';
+export { AppWatermark, WatermarkOverlay, type AppWatermarkProps, type WatermarkOverlayProps } from './components/primitives/layout/AppWatermark';
+export { FormFieldSkeleton, PageHeaderSkeleton, TabsBarSkeleton, FormCardSkeleton, TablePageSkeleton, GridCardsSkeleton, SplitPaneSkeleton, ConfigEditorSkeleton, DetailTabsSkeleton, StatsRowSkeleton, FormPageSkeleton, PageLoadingSkeleton, ChartAreaSkeleton, ChartEmptyState, ListSkeleton, ComponentSkeletonShell, skeletonBarWidth, skeletonItemCount, type FormFieldSkeletonProps, type PageHeaderSkeletonProps, type TabsBarSkeletonProps, type FormCardSkeletonProps, type TablePageSkeletonProps, type GridCardsSkeletonProps, type SplitPaneSkeletonProps, type ConfigEditorSkeletonProps, type DetailTabsSkeletonProps, type StatsRowSkeletonProps, type FormPageSkeletonProps, type PageSkeletonPreset, type PageLoadingSkeletonProps, type ChartAreaSkeletonProps, type ChartEmptyStateProps, type ChartSkeletonType, type ListSkeletonProps, type ListSkeletonTemplate, type ComponentSkeletonShellProps, } from './components/primitives/page-skeleton';
+export * from './kit/ai';

package/dist/components/internal/shared-ui/kit/ai/conversation.d.ts

@@ -0,0 +1,16 @@
+import { ComponentProps, ReactNode } from 'react';
+import { StickToBottom } from 'use-stick-to-bottom';
+import { Button } from '../../components/ui/button';
+
+export type ConversationProps = ComponentProps<typeof StickToBottom>;
+export declare const Conversation: ({ className, ...props }: ConversationProps) => import("react").JSX.Element;
+export type ConversationContentProps = ComponentProps<typeof StickToBottom.Content>;
+export declare const ConversationContent: ({ className, ...props }: ConversationContentProps) => import("react").JSX.Element;
+export type ConversationEmptyStateProps = ComponentProps<'div'> & {
+    title?: string;
+    description?: string;
+    icon?: ReactNode;
+};
+export declare const ConversationEmptyState: ({ className, title, description, icon, children, ...props }: ConversationEmptyStateProps) => import("react").JSX.Element;
+export type ConversationScrollButtonProps = ComponentProps<typeof Button>;
+export declare const ConversationScrollButton: ({ className, ...props }: ConversationScrollButtonProps) => import("react").JSX.Element;

package/dist/components/internal/shared-ui/kit/ai/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Kit/AI — shadcn.io AI (Vercel AI Elements style) components adapted for
+ * GeniSpace (design guideline §16.1). Sub-apps must consume chat-style AI UI
+ * from here instead of hand-rolling panels.
+ */
+export { Conversation, ConversationContent, ConversationEmptyState, ConversationScrollButton, } from './conversation';
+export { Message, MessageContent, MessageAvatar, type AiMessageRole } from './message';
+export { Tool, ToolHeader, ToolContent, ToolInput, ToolOutput, type AiToolState, } from './tool';
+export { Suggestions, Suggestion } from './suggestion';
+export { Loader } from './loader';
+export { PromptInput, PromptInputTextarea, PromptInputToolbar, PromptInputTools, PromptInputSubmit, type PromptInputStatus, } from './prompt-input';

package/dist/components/internal/shared-ui/kit/ai/loader.d.ts

@@ -0,0 +1,6 @@
+import { HTMLAttributes } from 'react';
+
+export type LoaderProps = HTMLAttributes<HTMLDivElement> & {
+    size?: number;
+};
+export declare const Loader: ({ className, size, ...props }: LoaderProps) => import("react").JSX.Element;

package/dist/components/internal/shared-ui/kit/ai/message.d.ts

@@ -0,0 +1,14 @@
+import { HTMLAttributes } from 'react';
+
+export type AiMessageRole = 'user' | 'assistant' | 'system';
+export type MessageProps = HTMLAttributes<HTMLDivElement> & {
+    from: AiMessageRole;
+};
+export declare const Message: ({ className, from, ...props }: MessageProps) => import("react").JSX.Element;
+export type MessageContentProps = HTMLAttributes<HTMLDivElement>;
+export declare const MessageContent: ({ children, className, ...props }: MessageContentProps) => import("react").JSX.Element;
+export type MessageAvatarProps = HTMLAttributes<HTMLDivElement> & {
+    src?: string;
+    name?: string;
+};
+export declare const MessageAvatar: ({ src, name, className, ...props }: MessageAvatarProps) => import("react").JSX.Element;

package/dist/components/internal/shared-ui/kit/ai/prompt-input.d.ts

@@ -0,0 +1,18 @@
+import { ComponentProps } from 'react';
+import { Button } from '../../components/ui/button';
+
+export type PromptInputStatus = 'ready' | 'streaming' | 'disabled';
+export type PromptInputProps = ComponentProps<'form'>;
+export declare const PromptInput: ({ className, ...props }: PromptInputProps) => import("react").JSX.Element;
+export type PromptInputTextareaProps = ComponentProps<'textarea'> & {
+    onSubmitShortcut?: () => void;
+};
+export declare const PromptInputTextarea: ({ className, onSubmitShortcut, onKeyDown, rows, ...props }: PromptInputTextareaProps) => import("react").JSX.Element;
+export type PromptInputToolbarProps = ComponentProps<'div'>;
+export declare const PromptInputToolbar: ({ className, ...props }: PromptInputToolbarProps) => import("react").JSX.Element;
+export type PromptInputToolsProps = ComponentProps<'div'>;
+export declare const PromptInputTools: ({ className, ...props }: PromptInputToolsProps) => import("react").JSX.Element;
+export type PromptInputSubmitProps = ComponentProps<typeof Button> & {
+    status?: PromptInputStatus;
+};
+export declare const PromptInputSubmit: ({ className, status, children, ...props }: PromptInputSubmitProps) => import("react").JSX.Element;

package/dist/components/internal/shared-ui/kit/ai/suggestion.d.ts

@@ -0,0 +1,11 @@
+import { ComponentProps } from 'react';
+import { Button } from '../../components/ui/button';
+import { ScrollArea } from '../../components/ui/scroll-area';
+
+export type SuggestionsProps = ComponentProps<typeof ScrollArea>;
+export declare const Suggestions: ({ className, children, ...props }: SuggestionsProps) => import("react").JSX.Element;
+export type SuggestionProps = Omit<ComponentProps<typeof Button>, 'onClick'> & {
+    suggestion: string;
+    onClick?: (suggestion: string) => void;
+};
+export declare const Suggestion: ({ suggestion, onClick, className, variant, size, children, ...props }: SuggestionProps) => import("react").JSX.Element;

package/dist/components/internal/shared-ui/kit/ai/tool.d.ts

@@ -0,0 +1,28 @@
+import { ComponentProps } from 'react';
+import { Collapsible, CollapsibleContent } from '../../components/ui/collapsible';
+
+export type AiToolState = 'running' | 'completed' | 'error';
+export type ToolProps = ComponentProps<typeof Collapsible>;
+export declare const Tool: ({ className, ...props }: ToolProps) => import("react").JSX.Element;
+export interface ToolHeaderProps {
+    title: string;
+    state: AiToolState;
+    /** Localized state label (defaults to the raw state). */
+    stateLabel?: string;
+    className?: string;
+}
+export declare const ToolHeader: ({ className, title, state, stateLabel }: ToolHeaderProps) => import("react").JSX.Element;
+export type ToolContentProps = ComponentProps<typeof CollapsibleContent>;
+export declare const ToolContent: ({ className, ...props }: ToolContentProps) => import("react").JSX.Element;
+export type ToolInputProps = ComponentProps<'div'> & {
+    input: unknown;
+    label?: string;
+};
+export declare const ToolInput: ({ className, input, label, ...props }: ToolInputProps) => import("react").JSX.Element;
+export type ToolOutputProps = ComponentProps<'div'> & {
+    output?: unknown;
+    errorText?: string;
+    label?: string;
+    errorLabel?: string;
+};
+export declare const ToolOutput: ({ className, output, errorText, label, errorLabel, ...props }: ToolOutputProps) => import("react").JSX.Element;

package/dist/components/internal/shared-ui/kit.d.ts

@@ -0,0 +1,5 @@
+/**
+ * GeniApp shadcn/ui kit entry — re-exports the full component barrel.
+ * Consumed as `@genispace/shared-ui/kit` (tsconfig paths + package.json exports).
+ */
+export * from './index';

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

@@ -0,0 +1,38 @@
+import { NavigateFunction } from 'react-router-dom';
+import { Platform } from './types';
+
+export declare function getPlatform(): Platform;
+export declare function isDesktop(): boolean;
+export declare function resolveAbsoluteUrl(href: string, base?: string): string;
+export declare function openExternal(url: string): void;
+export interface NavigateToOptions {
+    external?: boolean;
+}
+export declare function navigateTo(url: string, opts?: NavigateToOptions): void;
+/** `http(s):` or protocol-relative `//` — same check as AppHeader / team-app shortcuts. */
+export declare function isAbsoluteUrl(url: string): boolean;
+/**
+ * Absolute URLs: desktop → shell external browser, web → same-tab navigation.
+ * Relative paths → React Router `navigate`.
+ */
+export declare function navigateExternalOrInApp(href: string, navigate: NavigateFunction): void;
+/** Resolve absolute / relative href to a full URL for `window.open` / `<a href>`. */
+export declare function resolveNavigationHref(href: string): string;
+type NavigationPointerEvent = Pick<MouseEvent, 'metaKey' | 'ctrlKey' | 'shiftKey' | 'altKey' | 'button'>;
+/** True when the browser should keep default navigation (new tab/window, middle-click, etc.). */
+export declare function isModifiedNavigationClick(event: NavigationPointerEvent): boolean;
+/** Open href in a new browser tab/window (desktop → system browser). */
+export declare function openNavigationInNewTab(href: string): void;
+/**
+ * Same-tab header navigation: absolute URLs use location / external browser;
+ * relative paths use React Router when `navigate` is provided.
+ */
+export declare function navigateHeaderLink(href: string, navigate?: NavigateFunction): void;
+/** For `<button>` header links — modifier / middle-click opens a new tab. */
+export declare function handleHeaderNavigationClick(event: NavigationPointerEvent, href: string, navigate?: NavigateFunction): void;
+/** For `<a href>` header links — preserves native modifier-click behavior. */
+export declare function handleHeaderAnchorClick(event: {
+    preventDefault(): void;
+    nativeEvent: NavigationPointerEvent;
+}, href: string, navigate?: NavigateFunction): void;
+export {};