/** Extracts the alias literals passed to `runSnippet("alias", ...)` calls in `code`. */ export function extractRunSnippetAliases(code: string): string[] { const aliases: string[] = []; const regex = /runSnippet\s*\(\s*(['"`])((?:(?!\1).)*)\1/g; let match: RegExpExecArray | null; while ((match = regex.exec(code)) !== null) { aliases.push(match[2]); } return aliases; } /** * Resolves the transitive closure of snippet aliases referenced (directly, or via * other snippets) by `stepCodes`, against the full alias -> code map. Aliases with * no matching entry in `snippetCodeByAlias` are dropped. Returned in discovery order. */ export function resolveUsedSnippetAliases( stepCodes: string[], snippetCodeByAlias: Record, ): string[] { const used: string[] = []; const seen = new Set(); const queue = stepCodes.flatMap((code) => extractRunSnippetAliases(code)); while (queue.length > 0) { const alias = queue.shift()!; if (seen.has(alias)) continue; seen.add(alias); const code = snippetCodeByAlias[alias]; if (code == null) continue; used.push(alias); queue.push(...extractRunSnippetAliases(code)); } return used; } /** * Splits a `runSnippet` reference into its alias and pinned version: * `"login@3"` → `{ alias: "login", version: 3 }`, `"login"` → `{ alias: "login", version: null }`. */ export function parseSnippetRef(ref: string): { alias: string; version: number | null; } { const match = /^(.+)@(\d+)$/.exec(ref); return match ? { alias: match[1], version: Number(match[2]) } : { alias: ref, version: null }; }