@genispace/geniapp 0.3.0 → 0.5.0

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

@@ -0,0 +1 @@
+export type Platform = 'web' | 'desktop';

package/dist/components/shared/platform-ui/styles/design-tokens.d.ts

@@ -0,0 +1,189 @@
+/**
+ * GeniSpace Design Tokens
+ *
+ * Single source of truth for all design values across the platform.
+ * Aligned with DESIGN_GUIDELINE.html v2.0 and GeniSpace_Design_Guideline.md v1.1.0.
+ */
+export declare const CSS_VARS: {
+    readonly light: {
+        readonly background: "0 0% 100%";
+        readonly foreground: "0 0% 9%";
+        readonly card: "0 0% 100%";
+        readonly cardForeground: "0 0% 9%";
+        readonly popover: "0 0% 100%";
+        readonly popoverForeground: "0 0% 9%";
+        readonly primary: "217 91% 60%";
+        readonly primaryForeground: "0 0% 100%";
+        readonly secondary: "0 0% 96.1%";
+        readonly secondaryForeground: "0 0% 14.9%";
+        readonly muted: "210 40% 96.1%";
+        readonly mutedForeground: "0 0% 25.1%";
+        readonly accent: "210 40% 96.1%";
+        readonly accentForeground: "222.2 47.4% 11.2%";
+        readonly destructive: "0 84.2% 60.2%";
+        readonly destructiveForeground: "0 0% 100%";
+        readonly border: "214.3 31.8% 91.4%";
+        readonly input: "214.3 31.8% 91.4%";
+        readonly ring: "217 91% 60%";
+        readonly radius: "0.5rem";
+        readonly sidebarBackground: "0 0% 98%";
+        readonly sidebarForeground: "0 0% 9%";
+        readonly sidebarPrimary: "0 0% 9%";
+        readonly sidebarPrimaryForeground: "0 0% 98%";
+        readonly sidebarAccent: "0 0% 96.1%";
+        readonly sidebarAccentForeground: "0 0% 9%";
+        readonly sidebarBorder: "0 0% 89.8%";
+        readonly sidebarRing: "0 0% 9%";
+    };
+    readonly dark: {
+        readonly background: "0 0% 3.9%";
+        readonly foreground: "0 0% 98%";
+        readonly card: "0 0% 3.9%";
+        readonly cardForeground: "0 0% 98%";
+        readonly popover: "0 0% 3.9%";
+        readonly popoverForeground: "0 0% 98%";
+        readonly primary: "0 0% 98%";
+        readonly primaryForeground: "0 0% 9%";
+        readonly secondary: "0 0% 14.9%";
+        readonly secondaryForeground: "0 0% 98%";
+        readonly muted: "0 0% 14.9%";
+        readonly mutedForeground: "0 0% 63.9%";
+        readonly accent: "0 0% 14.9%";
+        readonly accentForeground: "0 0% 98%";
+        readonly destructive: "0 84.2% 60.2%";
+        readonly destructiveForeground: "0 0% 100%";
+        readonly border: "0 0% 14.9%";
+        readonly input: "0 0% 14.9%";
+        readonly ring: "0 0% 83.1%";
+        readonly sidebarBackground: "0 0% 9%";
+        readonly sidebarForeground: "0 0% 98%";
+        readonly sidebarPrimary: "0 0% 98%";
+        readonly sidebarPrimaryForeground: "0 0% 9%";
+        readonly sidebarAccent: "0 0% 14.9%";
+        readonly sidebarAccentForeground: "0 0% 98%";
+        readonly sidebarBorder: "0 0% 14.9%";
+        readonly sidebarRing: "0 0% 83.1%";
+    };
+};
+export declare const BRAND_COLORS: {
+    readonly ink: {
+        readonly black: "#171717";
+        readonly dark: "#262626";
+        readonly medium: "#404040";
+        readonly light: "#737373";
+    };
+    readonly brand: {
+        readonly primary: "#262626";
+        readonly 'primary-light': "#525252";
+        readonly 'primary-dark': "#171717";
+    };
+    readonly paper: {
+        readonly light: "#FFFCF7";
+        readonly medium: "#FDF7EF";
+        readonly dark: "#FBF1E4";
+    };
+    readonly surface: {
+        readonly DEFAULT: "#ffffff";
+        readonly dark: "#0a0a0a";
+        readonly darker: "#171717";
+        readonly light: "#f3f4f6";
+    };
+    readonly content: {
+        readonly DEFAULT: "#111827";
+        readonly dark: "#fafafa";
+        readonly muted: "#4b5563";
+        readonly 'dark-muted': "#d1d5db";
+    };
+    readonly accent: {
+        readonly DEFAULT: "#3b82f6";
+        readonly light: "#60a5fa";
+        readonly dark: "#2563eb";
+        readonly foreground: "#ffffff";
+    };
+    readonly functional: {
+        readonly success: "#27AE60";
+        readonly warning: "#F39C12";
+        readonly error: "#E74C3C";
+        readonly info: "#3498DB";
+    };
+};
+export declare const TYPOGRAPHY: {
+    readonly fontFamily: {
+        readonly sans: readonly ["Inter", "Noto Sans SC", "system-ui", "-apple-system", "BlinkMacSystemFont", "Segoe UI", "PingFang SC", "Microsoft YaHei", "Helvetica Neue", "Arial", "sans-serif"];
+        readonly mono: readonly ["Geist Mono", "Noto Sans SC", "Consolas", "Monaco", "Courier New", "monospace"];
+        readonly display: readonly ["Space Grotesk", "Noto Sans SC", "system-ui", "-apple-system", "BlinkMacSystemFont", "sans-serif"];
+    };
+    readonly fontSize: {
+        readonly xs: "0.75rem";
+        readonly sm: "0.875rem";
+        readonly base: "1rem";
+        readonly lg: "1.125rem";
+        readonly xl: "1.25rem";
+        readonly '2xl': "1.5rem";
+        readonly '3xl': "1.75rem";
+        readonly '4xl': "2rem";
+    };
+    readonly lineHeight: {
+        readonly tight: "1.1";
+        readonly normal: "1.3";
+        readonly relaxed: "1.5";
+    };
+};
+export declare const SPACING: {
+    readonly px: "1px";
+    readonly 0: "0";
+    readonly 0.5: "2px";
+    readonly 1: "4px";
+    readonly 1.5: "6px";
+    readonly 2: "8px";
+    readonly 2.5: "10px";
+    readonly 3: "12px";
+    readonly 3.5: "14px";
+    readonly 4: "16px";
+    readonly 5: "20px";
+    readonly 6: "24px";
+    readonly 7: "28px";
+    readonly 8: "32px";
+    readonly 9: "36px";
+    readonly 10: "40px";
+    readonly 12: "48px";
+    readonly 16: "64px";
+    readonly 20: "80px";
+    readonly 24: "96px";
+};
+export declare const SHADOWS: {
+    readonly sm: "0 2px 4px rgba(10, 10, 10, 0.08)";
+    readonly md: "0 4px 12px rgba(10, 10, 10, 0.12)";
+    readonly lg: "0 8px 24px rgba(10, 10, 10, 0.16)";
+};
+export declare const TRANSITIONS: {
+    readonly fast: "150ms";
+    readonly standard: "300ms";
+    readonly slow: "500ms";
+};
+export declare const MODAL_DIMENSIONS: {
+    readonly sm: {
+        readonly width: "480px";
+        readonly maxHeight: "90vh";
+    };
+    readonly md: {
+        readonly width: "640px";
+        readonly maxHeight: "90vh";
+    };
+    readonly lg: {
+        readonly width: "896px";
+        readonly maxHeight: "90vh";
+    };
+    readonly xl: {
+        readonly width: "1000px";
+        readonly maxHeight: "90vh";
+    };
+    readonly wide: {
+        readonly width: "min(1152px, 95vw)";
+        readonly maxHeight: "90vh";
+    };
+    readonly full: {
+        readonly width: "95vw";
+        readonly maxHeight: "95vh";
+    };
+};

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

@@ -0,0 +1,46 @@
+export declare const Z_INDEX_LAYERS: {
+    readonly DEFAULT: 0;
+    readonly WATERMARK: 5;
+    readonly STICKY_HEADER: 10;
+    readonly SIDEBAR: 20;
+    readonly FIXED_HEADER: 30;
+    readonly FLOATING_PANEL: 100;
+    readonly TOOLTIP: 150;
+    readonly DROPDOWN_MENU: 200;
+    readonly POPOVER: 250;
+    readonly BACKDROP: 300;
+    readonly DRAWER: 400;
+    readonly MODAL_BACKDROP: 500;
+    readonly CONTEXT_MENU: 1000;
+    readonly FUNCTION_DROPDOWN: 10001;
+    readonly MODAL: 10000;
+    readonly NESTED_MODAL: 10002;
+    /** Date picker calendar popover inside modals */
+    readonly DATE_PICKER_POPOVER: 10003;
+    /** Select/Popover/DropdownMenu content portaled to body — must paint above dialog/sheet layers */
+    readonly OVERLAY_POPOVER: 10003;
+    readonly ALERT_MODAL: 50000;
+    readonly TOAST: 100000;
+};
+export declare const Z_INDEX_CLASSES: {
+    readonly DEFAULT: "z-0";
+    readonly WATERMARK: "z-[5]";
+    readonly STICKY_HEADER: "z-10";
+    readonly SIDEBAR: "z-20";
+    readonly FIXED_HEADER: "z-30";
+    readonly FLOATING_PANEL: "z-[100]";
+    readonly TOOLTIP: "z-[150]";
+    readonly DROPDOWN_MENU: "z-[200]";
+    readonly POPOVER: "z-[250]";
+    readonly BACKDROP: "z-[300]";
+    readonly DRAWER: "z-[400]";
+    readonly MODAL_BACKDROP: "z-[500]";
+    readonly CONTEXT_MENU: "z-[1000]";
+    readonly FUNCTION_DROPDOWN: "z-[10001]";
+    readonly MODAL: "z-[10000]";
+    readonly NESTED_MODAL: "z-[10002]";
+    readonly DATE_PICKER_POPOVER: "z-[10003]";
+    readonly OVERLAY_POPOVER: "z-[10003]";
+    readonly ALERT_MODAL: "z-[50000]";
+    readonly TOAST: "z-[100000]";
+};

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

@@ -0,0 +1,2 @@
+export declare function getHttpErrorStatus(error: unknown): number | undefined;
+export declare function getApiErrorMessage(error: unknown): string | undefined;

package/dist/components/shared/platform-utils/cookieSettings.d.ts

@@ -0,0 +1,12 @@
+export declare function setCookie(key: string, value: string): void;
+export declare function getCookie(key: string): string | null;
+export declare function removeCookie(key: string): void;
+export declare function setTheme(theme: string): void;
+export declare function getTheme(): string;
+export declare function setLanguage(language: string): void;
+export declare function getLanguage(): string;
+export declare function setTimeZone(timeZone: string): void;
+export declare function getTimeZone(): string;
+export declare function setSpaceId(spaceId: string | null): void;
+export declare function getSpaceId(): string | null;
+export declare function initializeSettings(onThemeChange?: (theme: string) => void, onLanguageChange?: (language: string) => void, onTimeZoneChange?: (timeZone: string) => void, onSpaceIdChange?: (spaceId: string | null) => void): void;

package/dist/components/shared/platform-utils/data/countryCodes.d.ts

@@ -0,0 +1,26 @@
+export interface CountryCode {
+    code: string;
+    name: string;
+    nameCn: string;
+    dialCode: string;
+    flag: string;
+}
+export declare const COUNTRY_CODES: CountryCode[];
+export declare function getCountryByCode(code: string): CountryCode | undefined;
+export declare function getCountriesByDialCode(dialCode: string): CountryCode[];
+export declare function getAllCountries(): CountryCode[];
+export declare function searchCountries(query: string, language?: 'en' | 'zh'): CountryCode[];
+/** ISO country codes for mainland China + HK / MO / TW (CN edition SMS allowlist). */
+export declare const GREATER_CHINA_COUNTRY_CODES: readonly ["CN", "HK", "MO", "TW"];
+export type GreaterChinaCountryCode = (typeof GREATER_CHINA_COUNTRY_CODES)[number];
+export declare function getGreaterChinaCountries(): CountryCode[];
+/**
+ * Validate national digits for a dial code (aligned with api phoneValidation KNOWN_REGIONS).
+ */
+export declare function validateNationalNumber(dialCode: string, national: string): boolean;
+export declare function formatPhoneNumber(dialCode: string, phoneNumber: string): string;
+export declare function parsePhoneNumber(phoneNumber: string): {
+    dialCode: string;
+    number: string;
+} | null;
+export declare function getChinaCountry(): CountryCode;

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

@@ -0,0 +1,18 @@
+export { cn } from './utils/cn';
+export { getPlaneBaseUrl, buildCrossAppUrl, crossAppNav, getAppLaunchUrl, resolveLanding, type AppPlane, type LaunchableApp, type ResolveLandingInput, type LandingTarget, } from './utils/crossApp';
+export { formatDate, formatNumber, formatBytes, formatLargeNumber, formatTokens, formatDuration, formatDurationFromMs, formatDateTime, formatLocalDate, formatLocalDateTime, formatRelativeTime, } from './utils/formatting';
+export { formatUserLabel, type UserLabelSource } from './utils/formatUserLabel';
+export { toDateInputValue } from './utils/toDateInputValue';
+export { debounce } from './utils/debounce';
+export { throttle } from './utils/throttle';
+export { isChunkLoadError, reloadOnceIfChunkError, setupChunkLoadRecovery, } from './utils/chunkLoadRecovery';
+export { namespacesForPath, type RouteLocaleRule, } from './utils/routeLocalePrefetch';
+export { createSSOClient, type SSOClient, type SSOClientConfig, type ApplicationConfig, type SSOCallbackResult, type StateData, } from './utils/sso';
+export { LOGOUT_NOTIFICATION_PATH, LOGOUT_COMPLETED_MESSAGE, collectLogoutNotificationUrls, broadcastLogoutNotifications, isLogoutBroadcastInProgress, } from './utils/logoutNotification';
+export { setCookie, getCookie, removeCookie, setTheme, getTheme, setLanguage, getLanguage, setTimeZone, getTimeZone, setSpaceId, getSpaceId, initializeSettings, } from './cookieSettings';
+export { getAllIanaTimeZoneIds, buildTimeZoneSelectOptions, type TimeZoneSelectOption, } from './utils/timezones';
+export { normalizeOperatorLang, mergeSchemaLocale, mergeImportedOperatorDefinitionLocale, getOperatorDefinitionDisplay, prepareTenantOperatorApiResponseForConsole, stripTenantOperatorSystemConfigurationDeep, syncSchemaLocalePatchWithCanonical, syncOperatorMetadataLocalesWithCanonicalSchemas, type OperatorLang, type OperatorDefinitionDisplay, type CanonicalMethodForLocaleSync, } from './utils/operatorLocale';
+export { COUNTRY_CODES, GREATER_CHINA_COUNTRY_CODES, getCountryByCode, getCountriesByDialCode, getAllCountries, getGreaterChinaCountries, searchCountries, validateNationalNumber, formatPhoneNumber, parsePhoneNumber, getChinaCountry, type CountryCode, type GreaterChinaCountryCode, } from './data/countryCodes';
+export { normalizeIframeBaseUrl, buildAppIframeSrc, shellPathnameToInnerPath, } from './utils/shellIframeUrl';
+export { pathnameWithinBase } from './utils/appPath';
+export { GENISPACE_APP_IDS, DEFAULT_SPACE_SETTINGS, normalizeSpaceSettings, isSpaceWatermarkEnabled, readStoredUserPhone, buildWatermarkLabel, type GenispaceAppId, type SpaceSettings, type SpaceWatermarkApps, type WatermarkLabelInput, } from './utils/watermark';

package/dist/components/shared/platform-utils/utils/appPath.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Path inside a GeniApp SPA after removing Vite's public base (`import.meta.env.BASE_URL`).
+ * Matches Shell ↔ iframe `innerPath` convention: no leading/trailing slashes (empty = app root).
+ */
+export declare function pathnameWithinBase(pathname: string, viteBaseRaw: string): string;

package/dist/components/shared/platform-utils/utils/chunkLoadRecovery.d.ts

@@ -0,0 +1,7 @@
+export declare function isChunkLoadError(err: unknown): boolean;
+export declare function reloadOnceIfChunkError(error: unknown, options?: {
+    storageKey?: string;
+}): boolean;
+export declare function setupChunkLoadRecovery(options?: {
+    storageKey?: string;
+}): void;

package/dist/components/shared/platform-utils/utils/cn.d.ts

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

package/dist/components/shared/platform-utils/utils/crossApp.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Cross-plane navigation + post-login landing resolution for the
+ * Hub / Console / Shell split.
+ *
+ * Base URLs come from the runtime `window.__APP_CONFIG__` so the same logic
+ * works in every app. When a plane's URL is unset (pre-split, single origin),
+ * targets resolve to relative paths and navigation stays in-app — i.e. this is
+ * behaviour-preserving until the subdomains are provisioned.
+ */
+export type AppPlane = 'hub' | 'console' | 'shell' | 'workbench' | 'chat';
+/**
+ * Origin for a plane from runtime config. Empty string means "same origin"
+ * (pre-split), in which case callers should navigate with a relative path.
+ */
+export declare function getPlaneBaseUrl(plane: AppPlane): string;
+/** Build a URL for another plane: absolute when its origin is configured, else a relative path. */
+export declare function buildCrossAppUrl(plane: AppPlane, path?: string): string;
+/**
+ * Navigate to another plane. If the target is same-origin (no configured base)
+ * and an SPA `navigate` fn is supplied, use it; otherwise do a full navigation.
+ */
+export declare function crossAppNav(plane: AppPlane, path?: string, navigate?: (path: string) => void): void;
+/** A launchable app (any type) as returned by the backend capability snapshot. */
+export interface LaunchableApp {
+    id: string;
+    identifier: string;
+    name?: string;
+    /** Short description shown on launcher tiles. */
+    description?: string | null;
+    type?: string;
+    /** Pinned version label (null → shown as "Default"). */
+    version?: string | null;
+    /** Backend launcher kind (`BUILTIN` from `/rbac/my-permissions`) or legacy `BUILT_IN`. */
+    kind?: 'BUILT_IN' | 'BUILTIN' | 'SHELL' | 'WORKBENCH' | 'CONSOLE' | 'CUSTOM';
+    workbenchId?: string | null;
+    ingressHost?: string | null;
+}
+/**
+ * Resolve the open URL for a launchable app of any type, mirroring the
+ * console's applicationOpenHref rules:
+ *  - workbench  -> WORKBENCH_URL/workbench/{workbenchId}
+ *  - built-in   -> SHELL_URL/{identifier}
+ *  - custom     -> https://{ingressHost} (RUNNING deployment)
+ * Returns null when the app is not currently openable.
+ */
+export declare function getAppLaunchUrl(app: LaunchableApp): string | null;
+export interface ResolveLandingInput {
+    canAccessConsole: boolean;
+    accessibleApps: LaunchableApp[];
+    /** Server-authoritative last surface: 'console' | 'app' | 'launcher'. */
+    lastSurface?: string | null;
+    lastAppId?: string | null;
+}
+export type LandingTarget = {
+    kind: 'console';
+    path: string;
+} | {
+    kind: 'app';
+    app: LaunchableApp;
+} | {
+    kind: 'launcher';
+} | {
+    kind: 'home';
+};
+/**
+ * Decide where a user lands after login or after switching space. Shared by the
+ * Hub and Console so behaviour is identical across surfaces. The caller is
+ * responsible for validating that a remembered target is still accessible — the
+ * accessibleApps list passed in is already the authoritative current set.
+ */
+export declare function resolveLanding(input: ResolveLandingInput): LandingTarget;

package/dist/components/shared/platform-utils/utils/debounce.d.ts

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

package/dist/components/shared/platform-utils/utils/formatUserLabel.d.ts

@@ -0,0 +1,8 @@
+export type UserLabelSource = {
+    name?: string | null;
+    email?: string | null;
+};
+/**
+ * Display label for a platform user: name, then email, then shortened id.
+ */
+export declare function formatUserLabel(profile?: UserLabelSource | null, userId?: string | null, emptyLabel?: string): string;

package/dist/components/shared/platform-utils/utils/formatting.d.ts

@@ -0,0 +1,18 @@
+export declare function formatDate(date: string | Date, locale?: string): string;
+export declare function formatNumber(num: number, locale?: string): string;
+export declare function formatBytes(bytes: number, decimals?: number, t?: (key: string, defaultValue: string) => string): string;
+export declare function formatLargeNumber(num: number, precision?: number, locale?: string): string;
+export declare function formatTokens(tokens: number, showUnit?: boolean, locale?: string): string;
+export declare const formatDuration: (seconds: number, t?: (key: string, defaultValue: string) => string) => string;
+export declare const formatDurationFromMs: (ms: number, t?: (key: string, defaultValue: string) => string) => string;
+export declare const formatDateTime: (dateString: string | null, locale?: string) => string;
+/**
+ * Format a date-only value (YYYY-MM-DD or ISO datetime) in the platform timezone.
+ * Uses noon-UTC to avoid day-boundary shifts for date-only strings.
+ */
+export declare function formatLocalDate(isoDate: string | null | undefined, locale?: string): string;
+/**
+ * Format a datetime value (ISO 8601) in the platform timezone, showing date + time.
+ */
+export declare function formatLocalDateTime(isoDatetime: string | null | undefined, locale?: string): string;
+export declare const formatRelativeTime: (dateString: string, t?: (key: string, defaultValue: string, options?: unknown) => string) => string;

package/dist/components/shared/platform-utils/utils/logoutNotification.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Front-channel logout across the multi-origin app family (Hub / Console /
+ * Workbench / Chat / Ebook / Partner / Shell).
+ *
+ * Auth tokens live in each origin's own localStorage, so signing out (or
+ * switching accounts) in one app cannot directly clear the others. Every app
+ * exposes a `/logout-notification` receiver page that wipes its origin's auth
+ * keys; on sign-out the initiating app loads those receivers in hidden iframes
+ * and waits for their `logout-completed` acks (bounded by a timeout).
+ *
+ * This relies on all apps being served from the same site (eTLD+1) so browser
+ * third-party storage partitioning does not isolate the iframes' localStorage.
+ */
+export declare const LOGOUT_NOTIFICATION_PATH = "/logout-notification";
+export declare const LOGOUT_COMPLETED_MESSAGE = "logout-completed";
+/**
+ * Receiver URLs for every configured app base except the current origin
+ * (the caller clears its own storage directly). Bases sharing an origin are
+ * deduped (e.g. Hub and its `/console` mount) — one receiver per origin.
+ */
+export declare function collectLogoutNotificationUrls(): string[];
+export declare function isLogoutBroadcastInProgress(): boolean;
+/**
+ * Load each receiver in a hidden iframe and resolve once every origin has
+ * acked with `logout-completed`, or after `timeoutMs` — never rejects, so it
+ * is safe to await inside sign-out flows before redirecting.
+ */
+export declare function broadcastLogoutNotifications(urls?: string[], timeoutMs?: number): Promise<void>;

package/dist/components/shared/platform-utils/utils/operatorLocale.d.ts

@@ -0,0 +1,32 @@
+export type OperatorLang = 'en' | 'zh';
+export declare function normalizeOperatorLang(language: string | undefined): OperatorLang;
+export declare function mergeSchemaLocale(base: unknown, patch: unknown): unknown;
+export declare function syncSchemaLocalePatchWithCanonical(canonical: unknown, existingPatch: unknown): Record<string, unknown> | undefined;
+export type CanonicalMethodForLocaleSync = {
+    identifier: string;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+};
+export declare function syncOperatorMetadataLocalesWithCanonicalSchemas(options: {
+    metadata: Record<string, unknown>;
+    methods: CanonicalMethodForLocaleSync[];
+    operatorInputSchema?: unknown;
+    operatorOutputSchema?: unknown;
+}): Record<string, unknown>;
+export declare function stripTenantOperatorSystemConfigurationDeep(op: Record<string, unknown>): void;
+export declare function prepareTenantOperatorApiResponseForConsole(raw: unknown, language: string | undefined): unknown;
+export declare function mergeImportedOperatorDefinitionLocale<T extends {
+    operator: Record<string, unknown>;
+}>(definition: T, language: string | undefined): T;
+export type OperatorDefinitionDisplay = {
+    name: string;
+    description: string;
+    methods: Array<{
+        identifier: string;
+        name: string;
+        description: string;
+    }>;
+};
+export declare function getOperatorDefinitionDisplay(definition: {
+    operator: Record<string, unknown>;
+}, language: string | undefined): OperatorDefinitionDisplay;

package/dist/components/shared/platform-utils/utils/routeLocalePrefetch.d.ts

@@ -0,0 +1,5 @@
+export interface RouteLocaleRule {
+    prefix: string;
+    namespaces: readonly string[];
+}
+export declare function namespacesForPath(pathname: string, rules: readonly RouteLocaleRule[]): string[];

package/dist/components/shared/platform-utils/utils/shellIframeUrl.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Helpers for Shell iframe embedding of GeniApps (cross-origin safe URL composition).
+ */
+export declare function normalizeIframeBaseUrl(base: string): string;
+/** True when `baseUrl` is an expanded CDN directory (`…/{identifier}/{version}/`), not a bare dev origin. */
+export declare function isExpandedGeniappIframeBase(baseUrl: string, identifier: string): boolean;
+/**
+ * Build full iframe document URL. `baseUrl` is typically expanded manifest `iframeEntryTemplate`
+ * (must include trailing slash when serving SPA from a directory prefix).
+ *
+ * - Bare origin (`https://host/`): append `{identifier}` and optional `innerPath` (legacy hr-timesheet dev).
+ * - Expanded CDN base (`…/{identifier}/{version}/`): always load the version directory root. Object
+ *   storage/CDN origins do not provide BrowserRouter fallback for deep paths; Shell sends `innerPath`
+ *   separately through `GENISPACE_SHELL_ROUTE` after the iframe is available.
+ */
+export declare function buildAppIframeSrc(baseUrl: string, identifier: string, innerPath: string): string;
+/** Shell route `/:appSlug/*` → path segments inside the GeniApp router (`summary`, `reports/project`, …). */
+export declare function shellPathnameToInnerPath(pathname: string, appSlug: string): string;
+/** @deprecated Use buildAppIframeSrc */
+export declare const buildGeniappIframeSrc: typeof buildAppIframeSrc;

package/dist/components/shared/platform-utils/utils/spaceSettings.d.ts

@@ -0,0 +1,20 @@
+export declare const GENISPACE_APP_IDS: readonly ["workbench", "console", "hub", "chat", "shell", "admin", "ebook", "partner"];
+export type GenispaceAppId = (typeof GENISPACE_APP_IDS)[number];
+export type SpaceWatermarkApps = Record<GenispaceAppId, boolean>;
+export interface SpaceSettings {
+    watermark: {
+        apps: SpaceWatermarkApps;
+    };
+}
+export declare const DEFAULT_SPACE_SETTINGS: SpaceSettings;
+export declare function normalizeSpaceSettings(raw?: unknown): SpaceSettings;
+export declare function isSpaceWatermarkEnabled(appId: GenispaceAppId, settings?: unknown): boolean;
+export declare function readStoredUserPhone(): string | null;
+export interface WatermarkLabelInput {
+    name?: string | null;
+    phone?: string | null;
+    email?: string | null;
+    spaceName?: string | null;
+}
+/** Build watermark text: `{identifier}@{spaceName}` (name → phone → email local-part). */
+export declare function buildWatermarkLabel(input: WatermarkLabelInput): string | null;

package/dist/components/shared/platform-utils/utils/sso.d.ts

@@ -0,0 +1,42 @@
+export interface ApplicationConfig {
+    client_id: string;
+    app_type: string;
+    app_name: string;
+    redirect_uris: string[];
+    scope: string;
+    is_platform_core: boolean;
+}
+export interface SSOCallbackResult {
+    token: string;
+    refreshToken?: string;
+    expiresIn?: number;
+    user: {
+        id: string;
+        email: string;
+        name: string;
+        emailVerified?: boolean;
+    };
+}
+export interface StateData {
+    nonce: string;
+    returnPath: string;
+    timestamp: number;
+}
+export interface SSOClientConfig {
+    getConfig: () => {
+        API_BASE_URL: string;
+        APP_URL?: string;
+    };
+    appType: string;
+    defaultReturnPath?: string;
+    identifyApp?: () => string;
+    getOAuthRedirectUri?: () => string | undefined | Promise<string | undefined>;
+    openLoginUrl?: (url: string) => void | Promise<void>;
+}
+export interface SSOClient {
+    startLogin: (returnPath?: string) => Promise<void>;
+    handleCallback: () => Promise<SSOCallbackResult>;
+    parseState: (state: string) => StateData | null;
+    clearCache: () => void;
+}
+export declare function createSSOClient(config: SSOClientConfig): SSOClient;

package/dist/components/shared/platform-utils/utils/throttle.d.ts

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

package/dist/components/shared/platform-utils/utils/timezones.d.ts

@@ -0,0 +1,14 @@
+/**
+ * IANA time zone helpers using Intl (supportedValuesOf, DisplayNames).
+ * Labels follow the given BCP 47 locale (e.g. en-US, zh-CN).
+ */
+/** All IANA zone IDs available in the runtime, sorted lexicographically. */
+export declare function getAllIanaTimeZoneIds(): string[];
+export type TimeZoneSelectOption = {
+    value: string;
+    label: string;
+};
+/**
+ * Build sorted options for a select: localized name + GMT offset (winter reference date).
+ */
+export declare function buildTimeZoneSelectOptions(locale: string, refDate?: Date): TimeZoneSelectOption[];

package/dist/components/shared/platform-utils/utils/toDateInputValue.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Normalize API/DB date values to YYYY-MM-DD for HTML date inputs and AppDatePicker.
+ * Uses local calendar components (not UTC) so PG DATE / node-pg values stay correct in all timezones.
+ */
+export declare function toDateInputValue(value: string | Date | null | undefined): string;

package/dist/components/shared/platform-utils/utils/watermark.d.ts

@@ -0,0 +1 @@
+export { GENISPACE_APP_IDS, DEFAULT_SPACE_SETTINGS, normalizeSpaceSettings, isSpaceWatermarkEnabled, readStoredUserPhone, buildWatermarkLabel, type GenispaceAppId, type SpaceSettings, type SpaceWatermarkApps, type WatermarkLabelInput, } from './spaceSettings';

package/dist/components/shared/templates/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './slugify';
+export { getAllTemplates, getTemplatesByCategory, getTemplateById, searchTemplates, getAllCategories, createWorkbenchConfigFromTemplate, clearTemplateCache, setDefaultTemplateLanguage, normalizeTemplateLanguage, } from './templateRegistry';

package/dist/components/shared/templates/slugify.d.ts

@@ -0,0 +1 @@
+export declare function slugifyIdentifier(name: string): string;

package/dist/components/shared/templates/templateRegistry.d.ts

@@ -0,0 +1,18 @@
+import { Template, TemplateCategory } from './types';
+
+export declare function normalizeTemplateLanguage(lang?: string): 'zh' | 'en';
+export declare function setDefaultTemplateLanguage(lang: string): void;
+export declare function getAllTemplates(lang?: string): Template[];
+export declare function getTemplatesByCategory(category: TemplateCategory, lang?: string): Template[];
+export declare function getTemplateById(id: string, lang?: string): Template | undefined;
+export declare function searchTemplates(keyword: string, lang?: string): Template[];
+export declare function getAllCategories(): TemplateCategory[];
+export declare function createWorkbenchConfigFromTemplate(templateId: string, customName?: string, lang?: string): {
+    name: string;
+    description: string;
+    config: {
+        appConfig: any;
+        pages: Record<string, any>;
+    };
+};
+export declare function clearTemplateCache(): void;