fix(oas/exampleGroups): properly set name for code samples (#873)

## 🧰 Changes

Fixes a few minuscule bugs with this `exampleGroups` object generation:
- [x] We were previously adding names to nameless code samples
regardless of their language (e.g., `Default #1` could be `shell` and
the next nameless sample would be `Default #2` regardless of it was
`shell` or not). We now properly split out our nameless sample counts by
language
- [x] We weren't properly tacking on these names to the code sample
objects themselves
- [x] Upgrades `oas-examples` to the latest

This `exampleGroups` object has some wonky ergonomics that I'm already
reckoning with but I can't seem to think of an alternative approach that
warrants a breaking change. Stay tuned I guess?

## 🧬 QA & Testing

Do tests still pass?

packages/oas/src/operation/lib/get-example-groups.ts

@@ -105,8 +105,10 @@ function addMatchingResponseExamples(groups: ExampleGroups, operation: Operation
  * Returns a name for the given custom code sample. If there isn't already one defined,
  * we construct a fallback value based on where the sample is in the array.
  */
-function getDefaultName(sample: Extensions['code-samples'], count: number): string {
-  return sample.name && sample.name.length > 0 ? sample.name : `Default${count > 1 ? ` #${count}` : ''}`;
+function getDefaultName(sample: Extensions['code-samples'], count: Record<string, number>): string {
+  return sample.name && sample.name.length > 0
+    ? sample.name
+    : `Default${count[sample.language] > 1 ? ` #${count[sample.language]}` : ''}`;
 }
 
 /**
@@ -121,32 +123,36 @@ function getDefaultName(sample: Extensions['code-samples'], count: number): stri
  * (i.e., a response example with the same key in the `examples` map).
  */
 export function getExampleGroups(operation: Operation): ExampleGroups {
-  let namelessCodeSamples = 0;
+  const namelessCodeSampleCounts: Record<string, number> = {};
   const groups: ExampleGroups = {};
 
   // add custom code samples
   const codeSamples = getExtension('code-samples', operation.api, operation) as Extensions['code-samples'][];
   codeSamples?.forEach(sample => {
-    namelessCodeSamples += 1;
-    const name = getDefaultName(sample, namelessCodeSamples);
+    if (namelessCodeSampleCounts[sample.language]) {
+      namelessCodeSampleCounts[sample.language] += 1;
+    } else {
+      namelessCodeSampleCounts[sample.language] = 1;
+    }
+    const name = getDefaultName(sample, namelessCodeSampleCounts);
 
     // sample contains `correspondingExample` key
     if (groups[sample.correspondingExample]?.customCodeSamples?.length) {
-      groups[sample.correspondingExample].customCodeSamples.push(sample);
+      groups[sample.correspondingExample].customCodeSamples.push({ ...sample, name });
     } else if (sample.correspondingExample) {
       groups[sample.correspondingExample] = {
         name,
-        customCodeSamples: [sample],
+        customCodeSamples: [{ ...sample, name }],
       };
     }
 
     // sample does not contain a corresponding response example
     else if (groups[noCorrespondingResponseKey]?.customCodeSamples?.length) {
-      groups[noCorrespondingResponseKey].customCodeSamples.push(sample);
+      groups[noCorrespondingResponseKey].customCodeSamples.push({ ...sample, name });
     } else {
       groups[noCorrespondingResponseKey] = {
         name,
-        customCodeSamples: [sample],
+        customCodeSamples: [{ ...sample, name }],
       };
     }
   });

packages/oas/test/operation/lib/__snapshots__/get-example-groups.test.ts.snap

@@ -190,10 +190,11 @@ exports[`custom code samples with matching response examples 1`] = `
   "NoCorrespondingResponseForCustomCodeSample": {
     "customCodeSamples": [
       {
-        "code": "# This custom cURL snippet does not have a custom name so it has the name of "Default #2".
+        "code": "# This custom cURL snippet does not have a custom name so it has the name of "Default #3".
 
 curl -X POST https://api.example.com/v2/alert",
         "language": "curl",
+        "name": "Default #3",
       },
     ],
     "name": "Default #3",
@@ -291,6 +292,7 @@ exports[`custom code samples with no matching response examples 1`] = `
 
 curl -X POST https://api.example.com/v2/alert",
         "language": "curl",
+        "name": "Default #2",
       },
     ],
     "name": "Custom cURL snippet",