docs(docs-infra): display CLI enum values for enums (angular#61521)

fixes angular#61516

PR Close angular#61521

Author: JeanMeche

adev/shared-docs/pipeline/api-gen/rendering/cli-entities.mts

@@ -23,6 +23,7 @@ export interface CliCommand {
 export interface CliOption {
   name: string;
   type: 'boolean' | 'string' | 'number';
+  enum: string[] | undefined;
   default: string;
   description: string;
   positional?: number;

adev/shared-docs/pipeline/api-gen/rendering/templates/cli-card.tsx

@@ -31,8 +31,25 @@ export function CliCard(props: {card: CliCardRenderable}) {
               <div dangerouslySetInnerHTML={{__html: item.description}}></div>
             </div>
             <div class="docs-reference-type-and-default">
-              <span>Value Type</span>
-              <code>{item.type}</code>
+              {/* Display the enum values if there are some, else the type expected for the option */}
+              {item.enum ? (
+                <>
+                  <span>Allowed Values</span>
+                  <span>
+                    {item.enum.map((val, i, items) => (
+                      <>
+                        <code>{val}</code>
+                        {i < items.length - 1 && ', '}
+                      </>
+                    ))}
+                  </span>
+                </>
+              ) : (
+                <>
+                  <span>Value Type</span>
+                  <code>{item.type}</code>
+                </>
+              )}
               {/* Default Value */}
               {item.default !== undefined ? <span>Default</span> : <></>}
               {props.card.type === 'Options' && item.default !== undefined ? (

adev/shared-docs/styles/_reference.scss

@@ -381,7 +381,6 @@
         }
 
         .docs-reference-type-and-default {
-          width: 4.375rem;
           flex-shrink: 0;
 
           span {