/**
 * Shared UI asset resolution logic — used by Beam and api-browse routes.
 *
 * Resolves a UI asset ID to a file path, respecting the priority order:
 *   .photon.html > .photon.tsx > .photon.md > .html > .tsx
 */
export interface ResolvedUI {
    path: string;
    isPhotonTemplate: boolean;
    isPhotonMarkdown: boolean;
}
/**
 * Resolve a UI asset by probing candidate extensions in priority order.
 */
export declare function resolveUIAssetPath(photonDir: string, photonBaseName: string, uiId: string): Promise<ResolvedUI>;
/**
 * If a resolved path points to .html, check for higher-priority siblings
 * (.photon.html, .photon.tsx, .photon.md).
 */
export declare function upgradeToSibling(resolvedPath: string): Promise<ResolvedUI>;
/**
 * Read a UI file, compiling TSX if needed. Returns a self-contained
 * document for .tsx (bundle inlined). Use this for auxiliary surfaces
 * that have no sibling-asset route (format renderers, api-browse).
 */
export declare function readUIContent(filePath: string): Promise<string>;
/**
 * Read a UI file for an app mount that CAN serve sibling assets. For
 * .tsx this returns the tiny cache-busting shell plus the compiled
 * descriptor so the caller can serve `<base>.<hash>.js` immutably.
 */
export declare function readUICompiled(filePath: string): Promise<{
    content: string;
    compiled?: import('../tsx-compiler.js').CompiledTsx;
}>;
//# sourceMappingURL=ui-resolver.d.ts.map