Merge pull request #58 from puzzmo-com/refs-in-amuse

Adds support for grabbing refs in the amuse json

Author: orta

packages/xd-crossword-tools/src/amuseJSONToXD.ts

@@ -280,6 +280,32 @@ export function convertAmuseToCrosswordJSON(amuseJson: AmuseTopLevel): Crossword
       currentClue.metadata.revealer = convertHtmlToXdMarkup(placedWord.clue.refText)
     }
 
+    // Add refs metadata for linked clues
+    if (currentClue.metadata && placedWord.linkedWordIdxs && placedWord.linkedWordIdxs.length > 0) {
+      const refs: string[] = []
+      for (const linkedIdx of placedWord.linkedWordIdxs) {
+        const linkedWord = amuseData.placedWords[linkedIdx]
+        if (linkedWord) {
+          // Determine direction of the linked word
+          let linkedDirection: "A" | "D"
+          if (linkedWord.clueSection) {
+            linkedDirection = linkedWord.clueSection === "Across" ? "A" : "D"
+          } else if ("acrossNotDown" in linkedWord) {
+            linkedDirection = linkedWord.acrossNotDown ? "A" : "D"
+          } else {
+            // Skip this linked word if we can't determine direction
+            continue
+          }
+          
+          refs.push(`${linkedDirection}${linkedWord.clueNum}`)
+        }
+      }
+      
+      if (refs.length > 0) {
+        currentClue.metadata.refs = refs.join(" ")
+      }
+    }
+
     const clueID = `${clueNumberStr}-${direction}`
 
     const positionData: CluePosition = {

packages/xd-crossword-tools/tests/amuseJSONToXD.test.ts

@@ -4,12 +4,12 @@ import type { AmuseTopLevel } from "../src/amuseJSONToXD.types"
 import { beforeAll, describe, expect, it } from "vitest"
 import { rebusAmuseExample, schrodingerAmuseExample } from "./amuse/amuseExamples"
 
-const exampleJSONPath = "/Users/orta/dev/workshop/packages/amuse-to-xd/examples/2024_03_17-barred_cryptic.json"
+const exampleJSONPath = "/Users/orta/dev/old-workshop/packages/amuse-to-xd/examples/2024_03_17-barred_cryptic.json"
 const fullExamplePath = exampleJSONPath
 
-const hasCirclesPath = "/Users/orta/dev/workshop/packages/amuse-to-xd/examples/2025_04_01-themed.json"
-const largeGrid = "/Users/orta/dev/workshop/packages/amuse-to-xd/examples/2021_01_01-oversize.json"
-const cartoon = "/Users/orta/dev/workshop/packages/amuse-to-xd/examples/2019_12_23-cartoon.json"
+const hasCirclesPath = "/Users/orta/dev/old-workshop/packages/amuse-to-xd/examples/2025_04_01-themed.json"
+const largeGrid = "/Users/orta/dev/old-workshop/packages/amuse-to-xd/examples/2021_01_01-oversize.json"
+const cartoon = "/Users/orta/dev/old-workshop/packages/amuse-to-xd/examples/2019_12_23-cartoon.json"
 
 // Only run tests if the example JSON files exist
 const shouldRunTests = existsSync(fullExamplePath) && existsSync(hasCirclesPath)
@@ -614,5 +614,26 @@ describeConditional("amuseJSONToXD", () => {
       expect(a1Clue?.body).toEqual("Hairdo")
       expect(a1Clue?.answer).toEqual("COIF")
     })
+
+    it("handles linked clues with refs metadata", () => {
+      const xdOutput = convertAmuseToCrosswordJSON(JSON.parse(readFileSync(largeGrid, "utf-8")))
+
+      // Look for clues with refs metadata (linked clues)
+      const allClues = [...xdOutput.clues.across, ...xdOutput.clues.down]
+      const cluesWithRefs = allClues.filter((clue) => clue.metadata?.refs)
+
+      expect(cluesWithRefs.map((c) => [c.body, c.metadata?.refs] as const).sort((a, b) => a[0].localeCompare(b[0]))).toMatchInlineSnapshot(`
+          [
+            [
+              "See 54-Across",
+              "A54",
+            ],
+            [
+              "With 44-Across, Middle Eastern body of water",
+              "A44",
+            ],
+          ]
+        `)
+    })
   })
 })