import type { ModName, Profile } from "../schema.js";
import type { SourceAdapterContext } from "../schema.js";
/** 已知 H2 段名（段名 = 命名空间）。modName 解析时左段必须是段名。
 *  扩展新段名 = 加这一行 + registerModuleRenderer 加一行 + 一致性测试。
 *  v9.1+（modules-to-profile-complete）：加 "User" / "Agent" 专用段（user-info / agent-info 重命名）。
 *  公开导出（src/asset-health.ts 复用做 unknown-modname 检测——避免重复常量）。 */
export declare const KNOWN_SECTION_NAMES: ReadonlySet<string>;
/** 解析 modName 字符串 → { section, item? }。
 *  形态 1: "Scene" → { section: "Scene" }（整段）
 *  形态 2: "User.user-profile" → { section: "User", item: "user-profile" }（单 H3 项）
 *  解析失败（不含 '.' 但段名未知 / 含 '.' 但段名未知 / 段名已知但项名为空）→ 返 null。
 *  不跨段匹配 item（"User.user-profile" 不匹配 "Agent" 段下同名 H3）—— 跨段同名由段名命名空间避免。 */
export declare function parseModName(raw: string): ModName | null;
/** 读 profiles/<fileName>.md → Profile { name, blueprint, domains, groups }
 *  v10.x：assetDir 让 fixtures 可指向 tests/fixtures/assets/（默认 .pt/assets）。
 *  v9.1（modules-to-profile 迁移）：每个 H2 段加读 `### Modules` 填 ProfileGroup.modules。
 *  v9.1+（modules-to-profile-complete）：modName 字符串解析为 ModName 对象（2 形态）。 */
export declare function parseProfile(absDir: string, fileName: string, adapterCtx?: SourceAdapterContext): Promise<Profile>;