fix: add wrapping for package summary

third_party/docfx-doclet-143274/src/main/java/com/microsoft/build/PackageOverviewFile.java

@@ -3,6 +3,7 @@
 import static com.microsoft.build.BuilderUtil.LANGS;
 
 import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.google.common.annotations.VisibleForTesting;
 import com.google.common.collect.ImmutableList;
 import com.google.docfx.doclet.RepoMetadata;
 import com.microsoft.lookup.PackageLookup;
@@ -376,7 +377,7 @@ private static String createHtmlTable(
             .append("<td><a href=\"")
             .append(linkPrefix + packageChildSummary.uid)
             .append("\">")
-            .append(packageChildSummary.uid)
+            .append(withLineBreaks(packageChildSummary.uid))
             .append("</a></td>\n")
             .append("<td>\n")
             .append(packageChildSummary.summary != null ? packageChildSummary.summary : "")
@@ -417,4 +418,18 @@ public String getFileName() {
   public void setFileName(String fileName) {
     this.fileName = fileName;
   }
+
+  @VisibleForTesting
+  static String withLineBreaks(String uid) {
+    Pattern p = Pattern.compile("[a-zA-Z\\d][a-z\\d]+\\.|[A-Z][a-z]+");
+    Matcher m = p.matcher(uid);
+    if (!m.find()) {
+      return uid;
+    }
+    StringBuilder s = new StringBuilder();
+    while (m.find()) {
+      m.appendReplacement(s, "<wbr>" + m.group());
+    }
+    return s.toString();
+  }
 }

third_party/docfx-doclet-143274/src/test/java/com/microsoft/build/PackageOverviewFileTest.java

@@ -45,4 +45,17 @@ public void testExtractPackageBaseURIBeforeVersion() {
     assertEquals("N/A", packageInfo_4.get(0));
     assertEquals("N/A", packageInfo_4.get(1));
   }
+
+  @Test
+  public void testWithLineBreaks() {
+    String uid =
+        "com.google.cloud.securitycenter.v2.AttackPathName.OrganizationLocationSimulationValuedResourceAttackPathBuilder";
+    String converted = PackageOverviewFile.withLineBreaks(uid);
+    assertEquals(
+        "com.<wbr>google.<wbr>cloud.<wbr>securitycenter.<wbr>v2.<wbr>Attack<wbr>Path<wbr>Name.<wbr>Organization<wbr>Location<wbr>Simulation<wbr>Valued<wbr>Resource<wbr>Attack<wbr>Path<wbr>Builder",
+        converted);
+
+    String nonMatchable = "123non-matchable";
+    assertEquals(nonMatchable, PackageOverviewFile.withLineBreaks(nonMatchable));
+  }
 }

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.ExceptionHandler.Interceptor.RetryResult.yml

@@ -273,4 +273,4 @@ references:
 - uid: "T>valueOf(java.lang.Class"
   name: "T>valueOf(Class"
   nameWithType: "T>valueOf(Class"
-  fullName: "T>valueOf(java.lang.Class"
+  fullName: "T>valueOf(java.lang.Class"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.agreements.md

@@ -19,21 +19,21 @@ Class</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.AgreementDetailsCollectionOperations">com.microsoft.samples.agreements.AgreementDetailsCollectionOperations</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.AgreementDetailsCollectionOperations">com.<wbr>microsoft.<wbr>samples.<wbr>agreements.<wbr>Agreement<wbr>Details<wbr>Collection<wbr>Operations</a></td>
 <td>
 
 <strong>Deprecated.</strong> <em>Use <xref uid="AgreementMetaData" data-throw-if-not-resolved="false">AgreementMetaData</xref> instead.</em>
 
 Agreement details collection operations implementation class.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.AgreementMetaData">com.microsoft.samples.agreements.AgreementMetaData</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.AgreementMetaData">com.<wbr>microsoft.<wbr>samples.<wbr>agreements.<wbr>Agreement<wbr>Meta<wbr>Data</a></td>
 <td>
 The AgreementMetaData provides metadata about the agreement type that partner can provide
  confirmation of customer acceptance.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.ResourceCollection">com.microsoft.samples.agreements.ResourceCollection</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.ResourceCollection">com.<wbr>microsoft.<wbr>samples.<wbr>agreements.<wbr>Resource<wbr>Collection</a></td>
 <td>
 Contains a collection of resources with JSON properties to represent the output Type of objects
  in collection</td>
@@ -48,7 +48,7 @@ Interface</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.IAgreementDetailsCollection">com.microsoft.samples.agreements.IAgreementDetailsCollection</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.agreements.IAgreementDetailsCollection">com.<wbr>microsoft.<wbr>samples.<wbr>agreements.I<wbr>Agreement<wbr>Details<wbr>Collection</a></td>
 <td>
 
 <strong>Deprecated.</strong> <em>This one is deprecated :(</em>

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.commentinheritance.md

@@ -19,22 +19,22 @@ Class</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Animal">com.microsoft.samples.commentinheritance.Animal</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Animal">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Animal</a></td>
 <td>
 Animal.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Dog">com.microsoft.samples.commentinheritance.Dog</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Dog">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Dog</a></td>
 <td>
 Canine and man's best friend.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Herbivorous.Plant">com.microsoft.samples.commentinheritance.Herbivorous.Plant</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Herbivorous.Plant">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Herbivorous.<wbr>Plant</a></td>
 <td>
 </td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Mammal">com.microsoft.samples.commentinheritance.Mammal</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Mammal">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Mammal</a></td>
 <td>
 Mammal.</td>
    </tr>
@@ -48,27 +48,27 @@ Interface</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Carnivorous">com.microsoft.samples.commentinheritance.Carnivorous</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Carnivorous">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Carnivorous</a></td>
 <td>
 Marks an Animal that eats other animals.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Herbivorous">com.microsoft.samples.commentinheritance.Herbivorous</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Herbivorous">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Herbivorous</a></td>
 <td>
 Marks animals that eat plants.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Omnivorous">com.microsoft.samples.commentinheritance.Omnivorous</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Omnivorous">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Omnivorous</a></td>
 <td>
 Eats plants and animals.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Organism">com.microsoft.samples.commentinheritance.Organism</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Organism">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Organism</a></td>
 <td>
 </td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Viviparous">com.microsoft.samples.commentinheritance.Viviparous</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.commentinheritance.Viviparous">com.<wbr>microsoft.<wbr>samples.<wbr>commentinheritance.<wbr>Viviparous</a></td>
 <td>
 Mammals that give birth to young that develop within the mother's body.</td>
    </tr>

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.ProductSearchSettings.Builder.yml

@@ -1608,4 +1608,4 @@ references:
 - uid: "?,?>,java.lang.Void>)"
   name: "?,?>,Void>)"
   nameWithType: "?,?>,Void>)"
-  fullName: "?,?>,java.lang.Void>)"
+  fullName: "?,?>,java.lang.Void>)"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.RecognitionAudio.AudioSourceCase.yml

@@ -365,4 +365,4 @@ references:
 - uid: "T>valueOf(java.lang.Class"
   name: "T>valueOf(Class"
   nameWithType: "T>valueOf(Class"
-  fullName: "T>valueOf(java.lang.Class"
+  fullName: "T>valueOf(java.lang.Class"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.RecognitionAudio.yml

@@ -1256,4 +1256,4 @@ references:
 - uid: "ListT>makeMutableCopy(ListT,int)"
   name: "ListT>makeMutableCopy(ListT,int)"
   nameWithType: "ListT>makeMutableCopy(ListT,int)"
-  fullName: "ListT>makeMutableCopy(ListT,int)"
+  fullName: "ListT>makeMutableCopy(ListT,int)"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.SpeechSettings.Builder.yml

@@ -733,4 +733,4 @@ references:
 - uid: "?,?>,java.lang.Void>)"
   name: "?,?>,Void>)"
   nameWithType: "?,?>,Void>)"
-  fullName: "?,?>,java.lang.Void>)"
+  fullName: "?,?>,java.lang.Void>)"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.SpeechSettings.yml

@@ -786,4 +786,4 @@ references:
 - uid: "B>toBuilder()"
   name: "B>toBuilder()"
   nameWithType: "B>toBuilder()"
-  fullName: "B>toBuilder()"
+  fullName: "B>toBuilder()"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.md

@@ -21,7 +21,7 @@ Client</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.SpeechClient">com.microsoft.samples.google.SpeechClient</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.SpeechClient">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Speech<wbr>Client</a></td>
 <td>
 Service Description: Service that implements Google Cloud Speech API.
 
@@ -39,15 +39,15 @@ Settings</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ProductSearchSettings">com.microsoft.samples.google.ProductSearchSettings</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ProductSearchSettings">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Product<wbr>Search<wbr>Settings</a></td>
 <td>
 Settings class to configure an instance of <xref uid="ProductSearchClient" data-throw-if-not-resolved="false">ProductSearchClient</xref>.
 
  <p>The default instance has everything set to sensible defaults:
 </td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.SpeechSettings">com.microsoft.samples.google.SpeechSettings</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.SpeechSettings">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Speech<wbr>Settings</a></td>
 <td>
 Settings class to configure an instance of <xref uid="SpeechClient" data-throw-if-not-resolved="false">SpeechClient</xref>.
 
@@ -64,20 +64,20 @@ Class</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ProductSearchSettings.Builder">com.microsoft.samples.google.ProductSearchSettings.Builder</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ProductSearchSettings.Builder">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Product<wbr>Search<wbr>Settings.<wbr>Builder</a></td>
 <td>
 Builder for ProductSearchSettings.</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.RecognitionAudio">com.microsoft.samples.google.RecognitionAudio</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.RecognitionAudio">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Recognition<wbr>Audio</a></td>
 <td>
 
  Contains audio data in the encoding specified in the <code>RecognitionConfig</code>.
  Either <code>content</code> or <code>uri</code> must be supplied. Supplying both or neither
  returns <xref uid="google.rpc.Code.INVALID_ARGUMENT" data-throw-if-not-resolved="false">google.rpc.Code.INVALID_ARGUMENT</xref>. See</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.SpeechSettings.Builder">com.microsoft.samples.google.SpeechSettings.Builder</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.SpeechSettings.Builder">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Speech<wbr>Settings.<wbr>Builder</a></td>
 <td>
 Builder for SpeechSettings.</td>
    </tr>
@@ -91,15 +91,15 @@ Interface</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.BetaApi">com.microsoft.samples.google.BetaApi</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.BetaApi">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Beta<wbr>Api</a></td>
 <td>
 Indicates a public API that can change at any time, and has no guarantee of API stability and
  backward-compatibility.
 
  <p>Usage guidelines:</td>
    </tr>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ValidationException.Supplier">com.microsoft.samples.google.ValidationException.Supplier</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ValidationException.Supplier">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Validation<wbr>Exception.<wbr>Supplier</a></td>
 <td>
 </td>
    </tr>
@@ -113,7 +113,7 @@ Enum</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.RecognitionAudio.AudioSourceCase">com.microsoft.samples.google.RecognitionAudio.AudioSourceCase</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.RecognitionAudio.AudioSourceCase">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Recognition<wbr>Audio.<wbr>Audio<wbr>Source<wbr>Case</a></td>
 <td>
 </td>
    </tr>
@@ -127,7 +127,7 @@ Exception</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ValidationException">com.microsoft.samples.google.ValidationException</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.ValidationException">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>Validation<wbr>Exception</a></td>
 <td>
 Exception thrown if there is a validation problem with a path template, http config, or related
  framework methods. Comes as an illegal argument exception subclass. Allows to globally set a

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.v1.md

@@ -17,7 +17,7 @@ Client</th>
      <th>
 Description</th>
 <tr>
-<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.v1.SpeechClient">com.microsoft.samples.google.v1.SpeechClient</a></td>
+<td><a href="https://cloud.google.com/java/docs/reference/google-cloud-apikeys/latest/com.microsoft.samples.google.v1.SpeechClient">com.<wbr>microsoft.<wbr>samples.<wbr>google.<wbr>v1.<wbr>Speech<wbr>Client</a></td>
 <td>
 Service Description: Service that implements Google Cloud Speech API.
 

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.v1.stub.SpeechStubSettings.Builder.yml

@@ -775,4 +775,4 @@ references:
 - uid: "B>build()"
   name: "B>build()"
   nameWithType: "B>build()"
-  fullName: "B>build()"
+  fullName: "B>build()"

third_party/docfx-doclet-143274/src/test/resources/expected-generated-files/com.microsoft.samples.google.v1.stub.SpeechStubSettings.yml

@@ -906,4 +906,4 @@ references:
   isExternal: true
   name: "StubSettings"
   nameWithType: "StubSettings"
-  fullName: "com.google.api.gax.rpc.StubSettings"
+  fullName: "com.google.api.gax.rpc.StubSettings"