[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_153":154,"_155":156},"routes/_app.x.$handle.$name",{"_96":95,"_32":45,"_104":86,"_27":99,"_13":14,"_105":-5,"_11":106,"_107":108,"_109":110,"_111":112,"_113":114,"_20":-5,"_115":-5,"_116":-5,"_117":25,"_118":119,"_120":58,"_121":-5,"_122":-5,"_123":124},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":31,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":25},"version",2,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","main.ts","latestPath","fileId","f41ee43c-3800-11f1-9187-42b51c65c3df","name","fileType","http","content","import { parseVal } from \"https://esm.town/v/std/utils/index.ts\";\n\n/**\n * Claude Tool Utility\n * \n * A simple HTTP endpoint designed to be used as a Claude tool.\n * Supports GET (shows tool schema) and POST (executes the tool).\n * \n * Example tool: a text transformer that can uppercase, lowercase,\n * reverse, count words, or summarize stats about input text.\n */\n\nconst TOOL_SCHEMA = {\n name: \"text_transform\",\n description: \"Transform or analyze text in various ways\",\n input_schema: {\n type: \"object\",\n properties: {\n text: {\n type: \"string\",\n description: \"The input text to transform or analyze\",\n },\n operation: {\n type: \"string\",\n enum: [\"uppercase\", \"lowercase\", \"reverse\", \"word_count\", \"stats\", \"title_case\", \"slug\"],\n description: \"The transformation to apply\",\n },\n },\n required: [\"text\", \"operation\"],\n },\n};\n\nfunction transformText(text: string, operation: string): { result: string } {\n switch (operation) {\n case \"uppercase\":\n return { result: text.toUpperCase() };\n case \"lowercase\":\n return { result: text.toLowerCase() };\n case \"reverse\":\n return { result: text.split(\"\").reverse().join(\"\") };\n case \"word_count\":\n return { result: `${text.trim().split(/\\s+/).filter(Boolean).length} words` };\n case \"title_case\":\n return { result: text.replace(/\\b\\w/g, (c) => c.toUpperCase()) };\n case \"slug\":\n return { result: text.toLowerCase().replace(/[^a-z0-9]+/g, \"-\").replace(/^-|-$/g, \"\") };\n case \"stats\": {\n const words = text.trim().split(/\\s+/).filter(Boolean);\n return {\n result: JSON.stringify({\n characters: text.length,\n words: words.length,\n sentences: text.split(/[.!?]+/).filter(Boolean).length,\n paragraphs: text.split(/\\n\\n+/).filter(Boolean).length,\n avg_word_length: words.length\n ? (words.reduce((sum, w) => sum + w.length, 0) / words.length).toFixed(1)\n : 0,\n }, null, 2),\n };\n }\n default:\n throw new Error(`Unknown operation: ${operation}. Use one of: uppercase, lowercase, reverse, word_count, stats, title_case, slug`);\n }\n}\n\nexport default async function(req: Request): Promise {\n const url = new URL(req.url);\n\n // GET: show the tool schema + docs page\n if (req.method === \"GET\") {\n if (url.searchParams.get(\"schema\") === \"json\") {\n return Response.json(TOOL_SCHEMA);\n }\n\n const { links } = parseVal();\n const html = `\n\n\n Claude Tool Utility\n \n\n\n

🔧 Claude Tool Utility

A text transformation tool designed to be called by Claude.

\n \n

Supported Operations

uppercase — Convert to UPPER CASE
lowercase — Convert to lower case
reverse — Reverse the string
word_count — Count words
title_case — Convert To Title Case
slug — Convert to url-friendly-slug
stats — Full text statistics

\n\n

Usage

POST ${url.origin}${url.pathname}\nContent-Type: application/json\n\n{\n  \"text\": \"Hello World\",\n  \"operation\": \"uppercase\"\n}\n\n→ { \"result\": \"HELLO WORLD\" }

\n\n

Tool Schema

${JSON.stringify(TOOL_SCHEMA, null, 2)}

\n\n

\n JSON Schema\n View Source\n

\n\n`;\n return new Response(html, { headers: { \"content-type\": \"text/html\" } });\n }\n\n // POST: execute the tool\n if (req.method === \"POST\") {\n try {\n const body = await req.json();\n const { text, operation } = body;\n\n if (!text || !operation) {\n return Response.json({ error: \"Missing required fields: text, operation\" }, { status: 400 });\n }\n\n const result = transformText(text, operation);\n return Response.json(result);\n } catch (err: any) {\n return Response.json({ error: err.message }, { status: 400 });\n }\n }\n\n return Response.json({ error: \"Method not allowed\" }, { status: 405 });\n}","/**\n * Lyric Analysis API — Val.town HTTP handler\n * ==========================================\n * POST /parse-lyrics detect format and return structured lyric JSON\n * POST /rhyme-map phonetic rhyme analysis (+ optional HTML visualisation)\n * GET /health liveness check (no auth)\n *\n * Auth: X-API-Key header required on all non-health endpoints.\n * Set API_KEY in Val.town Environment (Settings → Environment Variables).\n *\n * Deploy: paste this file into a new Val.town HTTP val.\n */\n\nimport { dictionary as cmuDict } from \"npm:cmu-pronouncing-dictionary\";\n\n// ─── Auth ─────────────────────────────────────────────────────────────────────\n\nconst API_KEY = Deno.env.get(\"API_KEY\") ?? \"\";\n\nfunction checkAuth(req: Request): Response | null {\n if (!API_KEY) return json({ error: \"API_KEY not configured\" }, 500);\n const key = req.headers.get(\"X-API-Key\") ?? \"\";\n if (key !== API_KEY) {\n return json({ error: \"Invalid or missing API key\" }, 403);\n }\n return null;\n}\n\n// ─── Constants ────────────────────────────────────────────────────────────────\n\nconst VOWELS = new Set([\n \"AA\",\n \"AE\",\n \"AH\",\n \"AO\",\n \"AW\",\n \"AY\",\n \"EH\",\n \"ER\",\n \"EY\",\n \"IH\",\n \"IY\",\n \"OW\",\n \"OY\",\n \"UH\",\n \"UW\",\n]);\n\n// ─── Types ────────────────────────────────────────────────────────────────────\n\ninterface WordData {\n phones: string[];\n vowel: string | null;\n tail: string[] | null;\n tail_type: string | null;\n}\n\ntype WordIndex = Record;\n\ninterface LyricEntry {\n type: \"section\" | \"line\" | \"blank\";\n text: string;\n}\n\ninterface SectionLine {\n text: string;\n end_word: string | null;\n end_phones: string[] | null;\n rhyme_tail: string[] | null;\n rhyme_vowel: string | null;\n rhyme_type: string | null;\n rhyme_label: string;\n}\n\ninterface AnalysisSection {\n label: string | null;\n rhyme_scheme: string;\n lines: SectionLine[];\n}\n\ninterface RhymeGroup {\n tail: string[];\n vowel: string | null;\n rhyme_type: string;\n members: Array<{ word: string; section: string | null; line_index: number }>;\n}\n\n// ─── CMU Dict helpers ─────────────────────────────────────────────────────────\n\nconst _dict = cmuDict as Record;\n\nfunction getPhones(word: string): string[] | null {\n const w = word.toLowerCase();\n const candidates = [w];\n if (w.endsWith(\"'s\")) candidates.push(w.slice(0, -2));\n if (w.endsWith(\"s\")) candidates.push(w.slice(0, -1));\n if (w.endsWith(\"'\")) candidates.push(w.slice(0, -1));\n if (w.endsWith(\"in'\")) candidates.push(w.slice(0, -1) + \"g\");\n for (const c of candidates) {\n if (c in _dict) return _dict[c].split(\" \");\n }\n return null;\n}\n\nfunction primaryStressedVowel(phones: string[]): string | null {\n for (const p of phones) {\n if (p.endsWith(\"1\") && VOWELS.has(p.slice(0, -1))) return p.slice(0, -1);\n }\n for (const p of phones) {\n if (p.endsWith(\"2\") && VOWELS.has(p.slice(0, -1))) return p.slice(0, -1);\n }\n for (const p of phones) {\n const base = p.replace(/[012]$/, \"\");\n if (VOWELS.has(base)) return base;\n }\n return null;\n}\n\nfunction rhymeTail(phones: string[]): string[] | null {\n const tail: string[] = [];\n let found = false;\n for (const p of phones) {\n const base = p.replace(/[012]$/, \"\");\n const stress = /[012]$/.test(p) ? p[p.length - 1] : null;\n if (!found && VOWELS.has(base) && stress === \"1\") found = true;\n if (found) tail.push(base);\n }\n if (!found) {\n for (const p of phones) {\n const base = p.replace(/[012]$/, \"\");\n if (!found && VOWELS.has(base)) found = true;\n if (found) tail.push(base);\n }\n }\n return tail.length > 0 ? tail : null;\n}\n\nfunction rhymeTypeFn(tail: string[] | null): string | null {\n if (!tail) return null;\n return tail.length > 1 ? \"perfect\" : \"slant\";\n}\n\nfunction tailKey(tail: string[] | null): string | null {\n return tail ? tail.join(\",\") : null;\n}\n\n// ─── Core analysis ────────────────────────────────────────────────────────────\n\nfunction analyseWord(word: string): WordData | null {\n const phones = getPhones(word);\n if (!phones) return null;\n const vowel = primaryStressedVowel(phones);\n const tail = rhymeTail(phones);\n return {\n phones: phones.map((p) => p.replace(/[012]$/, \"\")),\n vowel,\n tail,\n tail_type: rhymeTypeFn(tail),\n };\n}\n\nfunction lineWords(text: string): string[] {\n return (text.match(/[A-Za-z']+/g) ?? []).map((w) =>\n w.toLowerCase().replace(/^'|'$/g, \"\")\n );\n}\n\nfunction extractTokens(text: string): Array<[string, boolean]> {\n const tokens = text.match(/[A-Za-z']+|[^A-Za-z']+/g) ?? [];\n return tokens.map((t) => [t, /[A-Za-z']/.test(t[0])]);\n}\n\nfunction buildWordIndex(parsed: LyricEntry[]): WordIndex {\n const index: WordIndex = {};\n for (const entry of parsed) {\n if (entry.type !== \"line\") continue;\n for (const w of lineWords(entry.text)) {\n if (w && !(w in index)) index[w] = analyseWord(w);\n }\n }\n return index;\n}\n\nfunction assignRhymeLabels(\n lines: LyricEntry[],\n wordIndex: WordIndex,\n): [string[], string] {\n const labelMap: Record = {};\n const labels: string[] = [];\n let code = 65; // \"A\"\n for (const line of lines) {\n const words = lineWords(line.text);\n const endWord = words.length > 0 ? words[words.length - 1] : null;\n const data = endWord ? wordIndex[endWord] : null;\n const tk = data?.tail ? tailKey(data.tail) : null;\n if (!tk) {\n labels.push(\"?\");\n } else {\n if (!(tk in labelMap)) labelMap[tk] = String.fromCharCode(code++);\n labels.push(labelMap[tk]);\n }\n }\n return [labels, labels.join(\"\")];\n}\n\nfunction buildSections(\n parsed: LyricEntry[],\n wordIndex: WordIndex,\n): AnalysisSection[] {\n const sections: AnalysisSection[] = [];\n let currentLabel: string | null = null;\n let currentLines: LyricEntry[] = [];\n\n function flush() {\n if (currentLines.length === 0) return;\n const [rhymeLabels, scheme] = assignRhymeLabels(currentLines, wordIndex);\n const linesOut: SectionLine[] = currentLines.map((line, i) => {\n const words = lineWords(line.text);\n const endWord = words.length > 0 ? words[words.length - 1] : null;\n const data = endWord ? wordIndex[endWord] : null;\n return {\n text: line.text,\n end_word: endWord,\n end_phones: data?.phones ?? null,\n rhyme_tail: data?.tail ?? null,\n rhyme_vowel: data?.vowel ?? null,\n rhyme_type: data?.tail_type ?? null,\n rhyme_label: rhymeLabels[i],\n };\n });\n sections.push({\n label: currentLabel,\n rhyme_scheme: scheme,\n lines: linesOut,\n });\n currentLabel = null;\n currentLines = [];\n }\n\n for (const entry of parsed) {\n if (entry.type === \"section\") {\n flush();\n currentLabel = entry.text;\n } else if (entry.type === \"line\") currentLines.push(entry);\n // blank: don't flush — sections can contain blank lines between stanzas\n }\n flush();\n return sections;\n}\n\nfunction buildRhymeGroups(\n sections: AnalysisSection[],\n _wordIndex: WordIndex,\n): RhymeGroup[] {\n const tailMap: Record<\n string,\n Array<{ word: string; section: string | null; line_index: number }>\n > = {};\n for (const section of sections) {\n section.lines.forEach((line, i) => {\n if (line.rhyme_tail && line.end_word) {\n const tk = tailKey(line.rhyme_tail) ?? \"\";\n if (!tailMap[tk]) tailMap[tk] = [];\n tailMap[tk].push({\n word: line.end_word,\n section: section.label,\n line_index: i,\n });\n }\n });\n }\n const groups: RhymeGroup[] = [];\n for (const [tk, members] of Object.entries(tailMap)) {\n if (members.length < 2) continue;\n const tailList = tk.split(\",\");\n const vowel = tailList[0] && VOWELS.has(tailList[0]) ? tailList[0] : null;\n groups.push({\n tail: tailList,\n vowel,\n rhyme_type: tailList.length > 1 ? \"perfect\" : \"slant\",\n members,\n });\n }\n return groups.sort((a, b) => b.members.length - a.members.length);\n}\n\nfunction buildAnalysis(\n title: string,\n parsed: LyricEntry[],\n wordIndex: WordIndex,\n) {\n const unresolved = Object.entries(wordIndex)\n .filter(([, d]) => d === null).map(([w]) => w).sort();\n const sections = buildSections(parsed, wordIndex);\n const rhymeGroups = buildRhymeGroups(sections, wordIndex);\n const wordMap = Object.fromEntries(\n Object.entries(wordIndex).filter(([, d]) => d !== null),\n ) as Record;\n return {\n title,\n meta: {\n cmudict_version: \"0.7b\",\n dialect: \"North American English\",\n unresolved_words: unresolved,\n },\n sections,\n rhyme_groups: rhymeGroups,\n word_map: wordMap,\n };\n}\n\n// ─── HTML rendering ───────────────────────────────────────────────────────────\n\nconst PALETTE = [\n { vowel: \"AY\", color: \"#e8593c\", bg: \"rgba(232,89,60,0.18)\" },\n { vowel: \"EY\", color: \"#c9a227\", bg: \"rgba(201,162,39,0.18)\" },\n { vowel: \"OW\", color: \"#3db88a\", bg: \"rgba(61,184,138,0.18)\" },\n { vowel: \"UW\", color: \"#5b9fd6\", bg: \"rgba(91,159,214,0.18)\" },\n { vowel: \"IY\", color: \"#b87fc8\", bg: \"rgba(184,127,200,0.18)\" },\n { vowel: \"AW\", color: \"#e0784a\", bg: \"rgba(224,120,74,0.18)\" },\n { vowel: \"AA\", color: \"#8ab8d6\", bg: \"rgba(138,184,214,0.18)\" },\n { vowel: \"ER\", color: \"#9fb870\", bg: \"rgba(159,184,112,0.18)\" },\n { vowel: \"IH\", color: \"#d4a060\", bg: \"rgba(212,160,96,0.18)\" },\n { vowel: \"AE\", color: \"#c06080\", bg: \"rgba(192,96,128,0.18)\" },\n { vowel: \"AO\", color: \"#60a0b0\", bg: \"rgba(96,160,176,0.18)\" },\n { vowel: \"UH\", color: \"#a08060\", bg: \"rgba(160,128,96,0.18)\" },\n { vowel: \"OY\", color: \"#a0c040\", bg: \"rgba(160,192,64,0.18)\" },\n { vowel: \"OE\", color: \"#c080a0\", bg: \"rgba(192,128,160,0.18)\" },\n];\nconst PALETTE_BY_VOWEL = Object.fromEntries(PALETTE.map((p) => [p.vowel, p]));\n\nfunction buildVowelColourMap(\n wordIndex: WordIndex,\n): Record {\n const familyWords: Record> = {};\n for (const [w, d] of Object.entries(wordIndex)) {\n if (d?.vowel) {\n if (!familyWords[d.vowel]) familyWords[d.vowel] = new Set();\n familyWords[d.vowel].add(w);\n }\n }\n const active = Object.entries(familyWords).filter(([, s]) => s.size >= 2);\n active.sort((a, b) => b[1].size - a[1].size);\n const colourMap: Record = {};\n const used: typeof PALETTE[0][] = [];\n for (const [v] of active) {\n const matched = PALETTE_BY_VOWEL[v];\n if (matched && !used.includes(matched)) {\n colourMap[v] = matched;\n used.push(matched);\n } else {\n for (const p of PALETTE) {\n if (!used.includes(p)) {\n colourMap[v] = p;\n used.push(p);\n break;\n }\n }\n }\n }\n return colourMap;\n}\n\nfunction splitIntoSyllables(phones: string[]): [string[][], number] {\n const syllables: string[][] = [];\n let current: string[] = [];\n let stressedIdx = -1;\n for (const p of phones) {\n const base = p.replace(/[012]$/, \"\");\n const stress = /[012]$/.test(p) ? p[p.length - 1] : null;\n if (VOWELS.has(base)) {\n current.push(p);\n if (stress === \"1\") stressedIdx = syllables.length;\n syllables.push(current);\n current = [];\n } else current.push(p);\n }\n if (current.length > 0 && syllables.length > 0) {\n syllables[syllables.length - 1].push(...current);\n } else if (current.length > 0) syllables.push(current);\n return [syllables, stressedIdx < 0 ? 0 : stressedIdx];\n}\n\nfunction syllableSpanPosition(\n word: string,\n phones: string[],\n): [number, number] {\n const [syllables, stressedIdx] = splitIntoSyllables(phones);\n const w = word.toLowerCase();\n if (syllables.length <= 1) return [0, word.length];\n const orthoVowels = \"aeiouy\";\n const vowelRuns: [number, number][] = [];\n let i = 0;\n while (i < w.length) {\n if (orthoVowels.includes(w[i])) {\n let j = i;\n while (j < w.length && orthoVowels.includes(w[j])) j++;\n vowelRuns.push([i, j]);\n i = j;\n } else i++;\n }\n if (vowelRuns.length === 0 || stressedIdx >= vowelRuns.length) {\n return [0, w.length];\n }\n const [vStart, vEnd] = vowelRuns[stressedIdx];\n const sylStart = vStart;\n let sylEnd: number;\n if (stressedIdx + 1 < vowelRuns.length) {\n const nextVStart = vowelRuns[stressedIdx + 1][0];\n sylEnd = vEnd + Math.min(nextVStart - vEnd, 2);\n } else sylEnd = w.length;\n return [sylStart, sylEnd];\n}\n\nfunction escapeHtml(s: string): string {\n return s.replace(/&/g, \"&\").replace(//g, \">\");\n}\n\nfunction wordToHtml(\n token: string,\n wordIndex: WordIndex,\n colourMap: Record,\n): string {\n const w = token.toLowerCase().replace(/^'|'$/g, \"\");\n const data = wordIndex[w];\n if (!data) return escapeHtml(token);\n const v = data.vowel;\n if (!v || !(v in colourMap)) return escapeHtml(token);\n const c = colourMap[v];\n const phones = getPhones(w);\n const tail = data.tail ?? [];\n const isSlant = tail.length <= 1;\n let sylStyle =\n `background:${c.bg};color:${c.color};border-radius:3px;padding:0 2px;`;\n if (isSlant) {\n sylStyle +=\n \"text-decoration:underline dashed;text-underline-offset:3px;text-decoration-thickness:1px;\";\n }\n let start = 0, end = token.length;\n if (phones) [start, end] = syllableSpanPosition(token, phones);\n const pre = escapeHtml(token.slice(0, start));\n const mid = escapeHtml(token.slice(start, end));\n const post = escapeHtml(token.slice(end));\n const span =\n `${mid}`;\n return `${pre}${span}${post}`;\n}\n\nfunction renderLineHtml(\n text: string,\n wordIndex: WordIndex,\n colourMap: Record,\n): string {\n return extractTokens(text).map(([token, isWord]) =>\n isWord ? wordToHtml(token, wordIndex, colourMap) : escapeHtml(token)\n ).join(\"\");\n}\n\nfunction buildLegendHtml(\n colourMap: Record,\n wordIndex: WordIndex,\n): string {\n const familyWords: Record = {};\n for (const [w, d] of Object.entries(wordIndex)) {\n if (d?.vowel && d.vowel in colourMap) {\n if (!familyWords[d.vowel]) familyWords[d.vowel] = [];\n familyWords[d.vowel].push(w);\n }\n }\n return Object.entries(colourMap).map(([v, c]) => {\n const words = (familyWords[v] ?? []).sort();\n const swatch =\n ``;\n const members = words.slice(0, 14).join(\", \") +\n (words.length > 14 ? \"\\u2026\" : \"\");\n return `

${swatch}

${v} vowel
${members}

`;\n }).join(\"\\n\");\n}\n\nfunction renderHtml(\n title: string,\n parsed: LyricEntry[],\n wordIndex: WordIndex,\n): string {\n const colourMap = buildVowelColourMap(wordIndex);\n const legendHtml = buildLegendHtml(colourMap, wordIndex);\n const parts: string[] = [];\n let inBlock = false;\n\n const closeBlock = () => {\n if (inBlock) {\n parts.push(\"\");\n inBlock = false;\n }\n };\n const openBlock = () => {\n if (!inBlock) {\n parts.push(\n '

',\n );\n inBlock = true;\n }\n };\n\n for (const entry of parsed) {\n if (entry.type === \"blank\") {\n closeBlock();\n parts.push('

');\n } else if (entry.type === \"section\") {\n closeBlock();\n parts.push(\n `

${\n escapeHtml(entry.text)\n }

`,\n );\n } else if (entry.type === \"line\") {\n openBlock();\n parts.push(\n `

${\n renderLineHtml(entry.text, wordIndex, colourMap)\n }

`,\n );\n }\n }\n closeBlock();\n\n return `\n\n\n\n\n${escapeHtml(title)} \\u2014 Rhyme Map\n\n\n\n

${escapeHtml(title)}

Rhyme map \\u00b7 cmudict phonetic analysis \\u00b7 highlighted syllable = primary stress \\u00b7 solid = end-consonant rhyme \\u00b7 dashed = vowel-only slant

Active vowel families (2+ members in lyric) \\u00b7 click to isolate

\n ${legendHtml}\n

\n${parts.join(\"\\n\")}\n

\n Notes
\n \\u2014 Highlighted syllable carries the primary stressed vowel (cmudict ARPAbet)
\n \\u2014 Words sharing a colour share a stressed vowel nucleus
\n \\u2014 Dashed underline = vowel-only slant rhyme \\u00b7 solid = tail phonemes match
\n \\u2014 Click any word or legend row to isolate that family \\u00b7 click again or click elsewhere to deselect\n

Generated by lyric-analysis-api \\u00b7 cmu-pronouncing-dictionary \\u00b7 North American English

\n\n\n`;\n}\n\n// ─── Parse lyrics ─────────────────────────────────────────────────────────────\n\nconst _CHORD_PAT =\n \"[A-G][b#]?(?:maj|min|m|dim|aug|sus|add)?(?:\\\\d+)?(?:/[A-G][b#]?)?\";\nconst INLINE_CHORD_RE = new RegExp(`\\\\[(${_CHORD_PAT})\\\\]`, \"g\");\nconst CHORD_LINE_RE = new RegExp(\n `^\\\\s*(${_CHORD_PAT})(\\\\s+(${_CHORD_PAT}))*\\\\s*$`,\n);\nconst SECTION_BRACKET_RE = /^\\[([^\\]]{2,})\\]$/;\n\nfunction detectFormat(raw: string): string {\n const lines = raw.trim().split(\"\\n\").filter((l) => l.trim());\n if (lines.some((l) => /^\\{[a-z_]+/.test(l.trim()))) return \"chordpro\";\n const bracketLines = lines.map((l) => l.trim()).filter((l) =>\n l.startsWith(\"[\")\n );\n const sectionBrackets = bracketLines.filter((l) =>\n !new RegExp(`^\\\\[(${_CHORD_PAT})\\\\]$`).test(l)\n );\n if (sectionBrackets.length > 0) return \"bracketed\";\n const allcaps = lines.filter((l) => /^[A-Z][A-Z\\s\\-\\d]{2,}$/.test(l.trim()));\n if (allcaps.length > 0) return \"allcaps\";\n const chordLines = lines.filter((l) => CHORD_LINE_RE.test(l));\n if (chordLines.length >= 2) return \"ultimate_guitar\";\n return \"plain\";\n}\n\nfunction extractMetadata(\n lines: string[],\n): [Record, string[], string | null] {\n const metadata: Record = {};\n let title: string | null = null;\n let i = 0;\n while (i < lines.length) {\n const m = lines[i].trim().match(/^([A-Za-z][A-Za-z /]*?):\\s*(.+)/);\n if (m) {\n const key = m[1].trim().toLowerCase();\n const value = m[2].trim();\n if (key === \"title\") title = value;\n else metadata[key] = value;\n i++;\n } else break;\n }\n return [metadata, lines.slice(i), title];\n}\n\nfunction inferTitle(\n lines: string[],\n parseNotes: string[],\n): [string | null, string[]] {\n if (lines.length === 0) return [null, lines];\n const first = lines[0].trim();\n const words = first.split(/\\s+/);\n if (\n first && words.length >= 1 && words.length <= 8 &&\n first[0] === first[0].toUpperCase() &&\n !first.startsWith(\"[\") &&\n !/^[A-Z][A-Z\\s\\-]{2,}$/.test(first) &&\n !first.endsWith(\",\")\n ) {\n parseNotes.push(`Title inferred from first line: \"${first}\"`);\n return [first, lines.slice(1)];\n }\n return [null, lines];\n}\n\nfunction stripInlineChords(line: string): string {\n return line.replace(INLINE_CHORD_RE, \"\").trim();\n}\n\nfunction stanzaHint(\n lines: string[],\n priorSections: Array<{ label?: string }>,\n): string {\n const count = lines.length;\n const hasChorus = priorSections.some((s) =>\n (s.label ?? \"\").toLowerCase().includes(\"chorus\")\n );\n if (count <= 2) return \"possible_outro_or_hook\";\n if (count === 4) {\n return hasChorus\n ? \"possible_verse\"\n : \"possible_verse_or_chorus\";\n }\n if (count >= 6) return \"possible_verse\";\n return \"unknown\";\n}\n\nfunction makeResult(\n title: string | null,\n fmt: string,\n metadata: Record,\n sections: object[],\n unparsedBlocks: object[],\n parseNotes: string[],\n) {\n return {\n title,\n format_detected: fmt,\n metadata,\n sections,\n unparsed_blocks: unparsedBlocks,\n requires_llm: unparsedBlocks.length > 0,\n parse_notes: parseNotes,\n };\n}\n\nfunction parseChordpro(raw: string) {\n const lines = raw.trim().split(\"\\n\");\n let title: string | null = null;\n const metadata: Record = {};\n const sections: object[] = [];\n const parseNotes: string[] = [];\n let currentLabel: string | null = null;\n let currentLines: string[] = [];\n let inSection = false;\n let verseN = 0, chorusN = 0, partN = 0;\n\n const SECTION_START: Record = {\n start_of_verse: \"Verse\",\n start_of_chorus: \"Chorus\",\n start_of_bridge: \"Bridge\",\n start_of_part: \"Part\",\n };\n const SKIP_START = new Set([\"start_of_tab\", \"start_of_grid\"]);\n\n function flush() {\n const lyricLines = currentLines.filter((l) => l);\n if (lyricLines.length > 0 && currentLabel !== null) {\n sections.push({\n label: `[${currentLabel}]`,\n confidence: \"high\",\n lines: lyricLines,\n });\n } else if (lyricLines.length > 0) {\n sections.push({\n label: \"[Unlabelled]\",\n confidence: \"low\",\n alternatives: [\"[Verse]\", \"[Chorus]\"],\n reason: \"Lyric lines appeared outside a {start_of_*} directive.\",\n lines: lyricLines,\n });\n }\n currentLabel = null;\n currentLines = [];\n inSection = false;\n }\n\n for (const rawLine of lines) {\n const stripped = rawLine.trim();\n const d = stripped.match(/^\\{([a-z_]+)(?::\\s*(.*?))?\\}$/);\n if (d) {\n const directive = d[1], value = (d[2] ?? \"\").trim();\n if (directive === \"title\") title = value;\n else if (\n [\n \"artist\",\n \"composer\",\n \"lyricist\",\n \"album\",\n \"year\",\n \"key\",\n \"tempo\",\n \"time\",\n \"copyright\",\n \"capo\",\n \"meta\",\n ].includes(directive)\n ) {\n metadata[directive] = value;\n } else if (directive in SECTION_START) {\n flush();\n const kind = SECTION_START[directive];\n if (value) currentLabel = value;\n else if (kind === \"Verse\") {\n verseN++;\n currentLabel = `Verse ${verseN}`;\n } else if (kind === \"Chorus\") {\n chorusN++;\n currentLabel = chorusN === 1 ? \"Chorus\" : `Chorus ${chorusN}`;\n } else if (kind === \"Bridge\") currentLabel = \"Bridge\";\n else {\n partN++;\n currentLabel = `Part ${partN}`;\n }\n inSection = true;\n } else if (SKIP_START.has(directive)) {\n flush();\n inSection = false;\n } else if (directive.startsWith(\"end_of_\")) { /* flush on next start */ }\n else if (directive === \"comment\") {\n parseNotes.push(`Source comment: \"${value}\"`);\n }\n continue;\n }\n const clean = stripInlineChords(stripped);\n if (inSection && clean) currentLines.push(clean);\n else if (clean && !stripped.startsWith(\"#\")) currentLines.push(clean);\n }\n flush();\n if (!title) parseNotes.push(\"No {title} directive found — title unknown.\");\n return makeResult(title, \"chordpro\", metadata, sections, [], parseNotes);\n}\n\nfunction parseBracketed(raw: string) {\n const allLines = raw.trim().split(\"\\n\");\n const [metadata, remaining, extractedTitle] = extractMetadata(allLines);\n const parseNotes: string[] = [];\n let lines = remaining;\n let title = extractedTitle;\n if (!title) [title, lines] = inferTitle(lines, parseNotes);\n\n const sections: object[] = [];\n const unparsedBlocks: object[] = [];\n let currentLabel: string | null = null;\n let currentLines: string[] = [];\n\n function flush() {\n const lyricLines = currentLines.filter((l) => l.trim());\n if (lyricLines.length === 0) {\n currentLabel = null;\n currentLines = [];\n return;\n }\n if (currentLabel !== null) {\n sections.push({\n label: currentLabel,\n confidence: \"high\",\n lines: lyricLines,\n });\n } else {\n unparsedBlocks.push({\n raw: lyricLines.join(\"\\n\"),\n issue: \"no_header\",\n hint: stanzaHint(lyricLines, sections as Array<{ label?: string }>),\n });\n }\n currentLabel = null;\n currentLines = [];\n }\n\n for (const line of lines) {\n const stripped = line.trim();\n if (!stripped) flush();\n else if (\n SECTION_BRACKET_RE.test(stripped) &&\n !new RegExp(`^\\\\[(${_CHORD_PAT})\\\\]$`).test(stripped)\n ) {\n flush();\n currentLabel = stripped;\n } else currentLines.push(stripped);\n }\n flush();\n\n if (unparsedBlocks.length > 0) {\n parseNotes.push(\n `${unparsedBlocks.length} block(s) have no section header — LLM labelling needed.`,\n );\n }\n return makeResult(\n title,\n \"bracketed\",\n metadata,\n sections,\n unparsedBlocks,\n parseNotes,\n );\n}\n\nfunction parseAllcaps(raw: string) {\n const allLines = raw.trim().split(\"\\n\");\n const [metadata, remaining, extractedTitle] = extractMetadata(allLines);\n const parseNotes: string[] = [];\n let lines = remaining;\n let title = extractedTitle;\n if (!title) [title, lines] = inferTitle(lines, parseNotes);\n\n const sections: object[] = [];\n const unparsedBlocks: object[] = [];\n let currentLabel: string | null = null;\n let currentLines: string[] = [];\n\n function flush() {\n const lyricLines = currentLines.filter((l) => l.trim());\n if (lyricLines.length === 0) {\n currentLabel = null;\n currentLines = [];\n return;\n }\n if (currentLabel !== null) {\n const label = currentLabel.charAt(0) +\n currentLabel.slice(1).toLowerCase();\n sections.push({\n label: `[${label}]`,\n confidence: \"high\",\n lines: lyricLines,\n });\n } else {\n unparsedBlocks.push({\n raw: lyricLines.join(\"\\n\"),\n issue: \"no_header\",\n hint: stanzaHint(lyricLines, sections as Array<{ label?: string }>),\n });\n }\n currentLabel = null;\n currentLines = [];\n }\n\n for (const line of lines) {\n const stripped = line.trim();\n if (!stripped) flush();\n else if (/^[A-Z][A-Z\\s\\-\\d]{2,}$/.test(stripped)) {\n flush();\n currentLabel = stripped;\n } else currentLines.push(stripped);\n }\n flush();\n\n if (unparsedBlocks.length > 0) {\n parseNotes.push(\n `${unparsedBlocks.length} block(s) have no section header — LLM labelling needed.`,\n );\n }\n return makeResult(\n title,\n \"allcaps\",\n metadata,\n sections,\n unparsedBlocks,\n parseNotes,\n );\n}\n\nfunction parsePlain(raw: string) {\n const allLines = raw.trim().split(\"\\n\");\n const [metadata, remaining, extractedTitle] = extractMetadata(allLines);\n const parseNotes: string[] = [];\n let lines = remaining;\n let title = extractedTitle;\n if (!title) [title, lines] = inferTitle(lines, parseNotes);\n\n const stanzas: string[][] = [];\n let current: string[] = [];\n for (const line of lines) {\n if (line.trim()) current.push(line.trim());\n else if (current.length > 0) {\n stanzas.push(current);\n current = [];\n }\n }\n if (current.length > 0) stanzas.push(current);\n\n const unparsedBlocks = stanzas.map((stanza, i) => ({\n raw: stanza.join(\"\\n\"),\n issue: \"no_header\",\n hint: stanzaHint(stanza, []),\n stanza_index: i,\n }));\n parseNotes.push(\n `No section headers detected. ${stanzas.length} stanza(s) require LLM labelling.`,\n );\n return makeResult(title, \"plain\", metadata, [], unparsedBlocks, parseNotes);\n}\n\nfunction parseUltimateGuitar(raw: string) {\n const lines = raw.trim().split(\"\\n\");\n const lyricLines = lines.filter((l) => !CHORD_LINE_RE.test(l));\n const cleaned = lyricLines.join(\"\\n\");\n const fmt = detectFormat(cleaned);\n const result = fmt === \"bracketed\"\n ? parseBracketed(cleaned)\n : fmt === \"allcaps\"\n ? parseAllcaps(cleaned)\n : parsePlain(cleaned);\n result.format_detected = \"ultimate_guitar\";\n (result.parse_notes as string[]).unshift(\n \"Chord-above-lines stripped before section detection.\",\n );\n return result;\n}\n\nfunction parseLyrics(raw: string) {\n const fmt = detectFormat(raw);\n return fmt === \"chordpro\"\n ? parseChordpro(raw)\n : fmt === \"bracketed\"\n ? parseBracketed(raw)\n : fmt === \"allcaps\"\n ? parseAllcaps(raw)\n : fmt === \"ultimate_guitar\"\n ? parseUltimateGuitar(raw)\n : parsePlain(raw);\n}\n\n// Convert parse result sections → flat LyricEntry list for rhyme analysis\nfunction toFlatEntries(\n parseResult: ReturnType,\n): LyricEntry[] {\n const entries: LyricEntry[] = [];\n for (\n const section of parseResult.sections as Array<\n { label: string; lines: string[] }\n >\n ) {\n entries.push({ type: \"section\", text: section.label });\n for (const line of section.lines) {\n entries.push({ type: \"line\", text: line });\n }\n }\n // Include unparsed block lines so rhyme analysis still runs on them\n for (\n const block of (parseResult.unparsed_blocks as Array<{ raw: string }>) ?? []\n ) {\n for (const line of block.raw.split(\"\\n\")) {\n if (line.trim()) entries.push({ type: \"line\", text: line.trim() });\n }\n }\n return entries;\n}\n\n// ─── HTTP handler ─────────────────────────────────────────────────────────────\n\nfunction json(body: unknown, status = 200): Response {\n return new Response(JSON.stringify(body), {\n status,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Headers\": \"Content-Type, X-API-Key\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n },\n });\n}\n\nexport default async function handler(req: Request): Promise {\n const url = new URL(req.url);\n\n // CORS preflight\n if (req.method === \"OPTIONS\") {\n return new Response(null, {\n status: 204,\n headers: {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Headers\": \"Content-Type, X-API-Key\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n },\n });\n }\n\n // Health (no auth)\n if (req.method === \"GET\" && url.pathname === \"/health\") {\n return json({ status: \"ok\" });\n }\n\n // All other routes require auth\n const authError = checkAuth(req);\n if (authError) return authError;\n\n if (req.method !== \"POST\") return json({ error: \"Method not allowed\" }, 405);\n\n let body: Record;\n try {\n body = await req.json();\n } catch {\n return json({ error: \"Invalid JSON body\" }, 400);\n }\n\n // POST /parse-lyrics\n if (url.pathname === \"/parse-lyrics\") {\n const lyrics = body.lyrics as string;\n if (!lyrics) return json({ error: \"lyrics field required\" }, 400);\n return json(parseLyrics(lyrics));\n }\n\n // POST /rhyme-map\n if (url.pathname === \"/rhyme-map\") {\n const lyrics = body.lyrics as string;\n if (!lyrics) return json({ error: \"lyrics field required\" }, 400);\n\n const parseResult = parseLyrics(lyrics);\n let title = (body.title as string) ?? null;\n if (!title) title = parseResult.title ?? \"Untitled\";\n\n const parsed = toFlatEntries(parseResult);\n const wordIndex = buildWordIndex(parsed);\n const analysis = buildAnalysis(title, parsed, wordIndex);\n\n const result: Record = { analysis };\n if (body.html === true) result.html = renderHtml(title, parsed, wordIndex);\n return json(result);\n }\n\n return json({ error: \"Not found\" }, 404);\n}","createdAt",["D",1776171621065],"branchVersion","branchId","e37e467c-3800-11f1-88dd-42b51c65c3df","id","e37dd5f2-3800-11f1-88dd-42b51c65c3df","claude-tool-util",["D",1776171189300],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Simple JS utility to support a Claude tool","imageUrl","be85293e-5fb2-45a6-85a4-80a56645ecd1","pinnedFileId","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019d8c0c-9789-745d-8f6f-b5b7cabb1ccb","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_96":95,"_103":99},"org",{"_96":95,"_97":-5,"_98":99,"_18":55,"_100":101,"_102":25},"branch",{"_13":85,"_32":86,"_43":42,"_87":44,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":45,"_94":95},"isOwned",40,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","andrewau","handle","displayName","avatar","","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_43":44,"_32":45,"_38":149,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":31,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":150,"_80":151,"_82":152,"_84":25},"tree",[144],"files",[144],"counts",{"_134":62,"_135":130,"_136":62,"_137":138,"_139":140},"contents",[125],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":126,"_32":28,"_30":31,"_127":-5,"_41":42,"_40":14,"_128":25,"_38":129,"_13":130,"_33":34,"_35":37,"_24":25,"_131":132,"_27":133},"e4db61c0-3801-11f1-bc11-42b51c65c3df","parentId","latest",["D",1776171621065],1,"label","lyric",[28],"pulls","branches","forks","envVars",{"_141":130,"_143":62},"connections",{"_141":62,"_142":62},"count","unfilledCount","emptyCount",{"_43":126,"_32":28,"_30":31,"_127":-5,"_41":42,"_40":14,"_128":25,"_38":145,"_13":130,"_33":34,"_35":37,"_24":25,"_131":132,"_146":147,"_27":148},["D",1776171621065],"children",[],[28],["D",1776171189300],{"_96":95,"_103":99},{"_96":95,"_97":-5,"_98":99,"_18":55,"_100":101,"_102":25},{"_13":85,"_32":86,"_43":42,"_87":44,"_88":-5,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":45,"_94":95},"ctx",{"_78":-5,"_122":186,"_187":188,"_189":190,"_191":25,"_192":25,"_193":25,"_194":58,"_195":-5,"_196":-7,"_197":-7,"_198":62,"_199":25,"_200":25,"_201":-5,"_202":25,"_203":25,"_204":25,"_205":-5},"ENV",{"_157":158,"_159":160,"_161":86,"_162":163,"_164":165,"_166":167,"_168":169,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181,"_182":183,"_184":185},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v2