Add Java Pair goody

Hypothetically we could use [`javafx.util.Pair`](https://docs.oracle.com/javase/8/javafx/api/javafx/util/Pair.html) but I don't love that the fields are named key and value. So let's reinvent the wheel!

Author: miorel

tools/adventure-pack/goodies/java/src/pair/Pair.java

@@ -0,0 +1,3 @@
+package pair;
+
+public record Pair<TFirst, TSecond>(TFirst first, TSecond second) {}

tools/adventure-pack/goodies/java/src/pair/goody.json

@@ -0,0 +1,3 @@
+{
+  "name": "Pair"
+}

tools/adventure-pack/src/app/__tests__/__snapshots__/equip-test.ts.snap

@@ -1,5 +1,17 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`App can equip single goody: Java Pair 1`] = `
+"////////////////////////// BEGIN ADVENTURE PACK CODE ///////////////////////////
+// Adventure Pack commit fake-commit-hash
+// Running at: https://example.com/
+
+record Pair<TFirst, TSecond>(TFirst first, TSecond second) {
+
+}
+
+/////////////////////////// END ADVENTURE PACK CODE ////////////////////////////"
+`;
+
 exports[`App can equip single goody: Java UnionFind 1`] = `
 "////////////////////////// BEGIN ADVENTURE PACK CODE ///////////////////////////
 // Adventure Pack commit fake-commit-hash

tools/adventure-pack/src/app/__tests__/__snapshots__/render-test.ts.snap

@@ -1,5 +1,13 @@
 // Jest Snapshot v1, https://goo.gl/fbAQLP
 
+exports[`App can render goody: Java Pair 1`] = `
+"package pair;
+
+record Pair<TFirst, TSecond>(TFirst first, TSecond second) {
+
+}"
+`;
+
 exports[`App can render goody: Java UnionFind 1`] = `
 "package union_find;
 

tools/adventure-pack/src/app/__tests__/render-test.ts

@@ -3,7 +3,7 @@ import { describe, expect, it } from "@jest/globals";
 import { LANGUAGE_NAMES } from "../constants";
 import type { Language } from "../Language";
 import { readAllGoodies } from "../../scripts/package-goodies/readAllGoodies";
-import { goodyToText } from "../goodyToText";
+import { stringifyGoody } from "../stringifyGoody";
 
 describe("App", () => {
   it("can render goody", async () => {
@@ -12,7 +12,7 @@ describe("App", () => {
     for (const language of Object.keys(goodiesByLanguage) as Language[]) {
       const goodies = goodiesByLanguage[language];
       for (const goody of Object.values(goodies)) {
-        const code = goodyToText(goody);
+        const code = stringifyGoody(goody);
 
         expect(code).toMatchSnapshot(
           `${LANGUAGE_NAMES[language]} ${goody.name}`,

tools/adventure-pack/src/app/components/GoodyCard.tsx

@@ -1,7 +1,7 @@
 import React from "react";
 
 import type { Goody } from "../Goody";
-import { goodyToText } from "../goodyToText";
+import { stringifyGoody } from "../stringifyGoody";
 import { HighlightedCode } from "./HighlightedCode";
 
 type Props = {
@@ -13,7 +13,7 @@ export function GoodyCard({ goody }: Props) {
     <div>
       <h2>{goody.name}</h2>
       <HighlightedCode language={goody.language}>
-        {goodyToText(goody)}
+        {stringifyGoody(goody)}
       </HighlightedCode>
     </div>
   );

tools/adventure-pack/src/app/mergeCode.ts

@@ -127,11 +127,11 @@ export function mergeCode({
         for (const [moduleName, interfaceDeclarations] of Object.entries(
           goody.moduleDeclarations,
         )) {
-          for (const [interfaceName, codeGroups] of Object.entries(
+          for (const [interfaceName, codeSections] of Object.entries(
             interfaceDeclarations,
           )) {
             ((mergedDeclarations[moduleName] ??= {})[interfaceName] ??=
-              []).push(...codeGroups);
+              []).push(...codeSections);
           }
         }
       }

tools/adventure-pack/src/app/mergeJavaCode.ts

@@ -6,19 +6,18 @@ import type { JavaGoody } from "./parsers/javaGoodyParser";
 const ADVENTURE_PACK_CLASS_NAME = "AP";
 
 export function mergeJavaCode(goodies: Iterable<ReadonlyDeep<JavaGoody>>) {
-  const classes: Record<string, { code: string[]; modifiers: Set<string> }> =
-    {};
+  const classes: Record<string, { code: string[]; declaration: string }> = {};
   for (const goody of goodies) {
     for (const className of Object.keys(goody.codeByClass)) {
       invariant(
         classes[className] == null || className === ADVENTURE_PACK_CLASS_NAME,
         `Only the ${ADVENTURE_PACK_CLASS_NAME} class can exist in multiple goodies!`,
       );
 
-      classes[className] ??= { code: [], modifiers: new Set() };
-      for (const modifier of goody.codeByClass[className].modifiers) {
-        classes[className].modifiers.add(modifier);
-      }
+      classes[className] ??= {
+        code: [],
+        declaration: goody.codeByClass[className].declaration,
+      };
       classes[className].code.push(goody.codeByClass[className].code);
     }
   }
@@ -33,7 +32,7 @@ export function mergeJavaCode(goodies: Iterable<ReadonlyDeep<JavaGoody>>) {
   const res: string[] = [];
   for (const className of Object.keys(classes)) {
     res.push(
-      `${[...classes[className].modifiers, "class", className].join(" ")} {\n${classes[className].code.map((section) => section + "\n").join("\n")}}`,
+      `${classes[className].declaration}\n${classes[className].code.map((codeSection) => codeSection + "\n").join("\n")}}`,
     );
   }
 

tools/adventure-pack/src/app/parsers/javaGoodyParser.ts

@@ -11,7 +11,7 @@ export const javaGoodyParser = goodyBaseParser
       z
         .object({
           code: z.string(),
-          modifiers: z.array(nonBlankStringParser),
+          declaration: nonBlankStringParser,
         })
         .strict(),
     ),

tools/adventure-pack/src/app/sortTypeScriptModuleAndInterfaceDeclarations.ts

@@ -12,8 +12,8 @@ export function sortTypeScriptModuleAndInterfaceDeclarations(
 ): Record<string, Record<string, string[]>> {
   return sortObjectKeysRecursive(
     mapObjectValues(moduleDeclarations, (interfaceDeclarations) =>
-      mapObjectValues(interfaceDeclarations, (codeGroups) =>
-        [...codeGroups].sort(compareStringsCaseInsensitive),
+      mapObjectValues(interfaceDeclarations, (codeSections) =>
+        [...codeSections].sort(compareStringsCaseInsensitive),
       ),
     ),
     compareStringsCaseInsensitive,