export declare const SURFACE_IDS: readonly ["core", "macadamia"];
export type SurfaceId = (typeof SURFACE_IDS)[number];
export declare const DEFAULT_SURFACE_ID: SurfaceId;
export type SurfaceBranding = Readonly<{
    appName: string;
    logoSrc: string;
    logoAlt: string;
}>;
export declare function isSurfaceId(value: unknown): value is SurfaceId;
export declare function parseSurfaceId(value: unknown): SurfaceId | null;
export type SurfaceHostContext = Readonly<{
    surfaceId: SurfaceId;
    surfaceRootHost: string;
}>;
export declare const SURFACE_ROOT_HOSTS: Readonly<Record<SurfaceId, readonly string[]>>;
export declare function resolveSurfaceHostContext(value: string | URL | null | undefined): SurfaceHostContext | null;
export declare function buildSurfaceAwareDashboardOrigin(input: Readonly<{
    dashboardOrigin: string;
    requestOrigin: string;
}>): string | null;
export declare function buildSurfaceAwareSiteOrigin(input: Readonly<{
    siteSlug: string;
    baseSiteOrigin: string;
    requestOrigin: string;
}>): string | null;
export declare function extractSurfaceAwareSiteSlug(value: string | URL | null | undefined): string | null;
