From 75abc89b23eac74b9fdd17129ac41d9a18a71695 Mon Sep 17 00:00:00 2001
From: enzonotario <enzo.notario@gmail.com>
Date: Wed, 11 Dec 2024 22:44:37 -0300
Subject: [PATCH] feat(examples): allows to show them wrapped or in columns

---
 docs/composables/useTheme.md             |  3 ++-
 src/components/Parameter/OAParameter.vue | 24 +++++++++++++++++++-----
 src/composables/useTheme.ts              | 11 +++++++++++
 test/composables/useTheme.test.ts        |  6 ++++++
 4 files changed, 38 insertions(+), 6 deletions(-)

diff --git a/docs/composables/useTheme.md b/docs/composables/useTheme.md
index 6d7a1bd5..f749454e 100644
--- a/docs/composables/useTheme.md
+++ b/docs/composables/useTheme.md
@@ -91,6 +91,7 @@ export default {
                 avoidCirculars: false, // Avoid circular references when parsing schemas.
                 lazyRendering: false, // Lazy render Paths and Tags components.
                 defaultTag: 'Default', // Default tag to use when a path has no tags.
+                wrapExamples: true, // Wrap examples in a row or show them in a column.
             },
         })
     }
@@ -153,4 +154,4 @@ export default {
 
 | Function        | Description                  | Default Value                                                                                                                             | Allowed Values                                                                                                                                     |
 |-----------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------|
-| `setSpecConfig` | Sets the spec configuration. | `{ groupByTags: true, collapsePaths: false, showPathsSummary: true, avoidCirculars: false, lazyRendering: false, defaultTag: 'Default' }` | `{ groupByTags: boolean, collapsePaths: boolean, showPathsSummary: boolean, avoidCirculars: boolean, lazyRendering: boolean, defaultTag: string }` |
+| `setSpecConfig` | Sets the spec configuration. | `{ groupByTags: true, collapsePaths: false, showPathsSummary: true, avoidCirculars: false, lazyRendering: false, defaultTag: 'Default', wrapExamples: true }` | `{ groupByTags: boolean, collapsePaths: boolean, showPathsSummary: boolean, avoidCirculars: boolean, lazyRendering: boolean, defaultTag: string, wrapExamples: boolean }` |
diff --git a/src/components/Parameter/OAParameter.vue b/src/components/Parameter/OAParameter.vue
index 3b1871d5..a638f3d7 100644
--- a/src/components/Parameter/OAParameter.vue
+++ b/src/components/Parameter/OAParameter.vue
@@ -2,6 +2,7 @@
 import OACodeValue from '../Common/OACodeValue.vue'
 import { getConstraints } from '../../lib/constraintsParser'
 import { getExamples } from '../../lib/getExamples'
+import { useTheme } from '../../composables/useTheme'
 
 const props = defineProps({
   parameter: {
@@ -13,6 +14,8 @@ const props = defineProps({
 const examples = getExamples(props.parameter)
 
 const constraints = getConstraints(props.parameter.schema)
+
+const wrapExamples = useTheme().getWrapExamples()
 </script>
 
 <template>
@@ -74,15 +77,26 @@ const constraints = getConstraints(props.parameter.schema)
       </div>
       <div
         v-if="examples?.length > 1"
-        class="flex flex-row flex-wrap items-center gap-2"
+        class="flex flex-row flex-wrap gap-2"
+        :class="{
+          'items-center': wrapExamples,
+        }"
       >
         <span class="text-sm">{{ $t('Examples') }}</span>
         <div
-          v-for="(example, idx) in examples"
-          :key="idx"
-          class="flex flex-wrap gap-2"
+          class="flex gap-2"
+          :class="{
+            'flex-col': !wrapExamples,
+            'flex-row flex-wrap': wrapExamples,
+          }"
         >
-          <OACodeValue :value="example" />
+          <OACodeValue
+            v-for="(example, idx) in examples"
+            :key="idx"
+            :value="example"
+          >
+            <OACodeValue />
+          </oacodevalue>
         </div>
       </div>
 
diff --git a/src/composables/useTheme.ts b/src/composables/useTheme.ts
index 02029f75..641f64bd 100644
--- a/src/composables/useTheme.ts
+++ b/src/composables/useTheme.ts
@@ -87,6 +87,7 @@ export interface SpecConfig {
   lazyRendering?: Ref<boolean>
   defaultTag?: string
   defaultTagDescription?: string
+  wrapExamples?: boolean
 }
 
 export interface UseThemeConfig {
@@ -267,6 +268,7 @@ const themeConfig: UseThemeConfig = {
     lazyRendering: ref(false),
     defaultTag: 'Default',
     defaultTagDescription: '',
+    wrapExamples: true,
   },
   codeSamples: {
     langs: [
@@ -602,6 +604,10 @@ export function useTheme(initialConfig: Partial<UseThemeConfigUnref> = {}) {
     return themeConfig.spec
   }
 
+  function getWrapExamples() {
+    return themeConfig?.spec?.wrapExamples
+  }
+
   function setSpecConfig(config: Partial<SpecConfig>) {
     if (!themeConfig.spec) {
       themeConfig.spec = {}
@@ -639,6 +645,10 @@ export function useTheme(initialConfig: Partial<UseThemeConfigUnref> = {}) {
     if (config.defaultTagDescription !== undefined) {
       themeConfig.spec.defaultTagDescription = config.defaultTagDescription
     }
+
+    if (config.wrapExamples !== undefined) {
+      themeConfig.spec.wrapExamples = config.wrapExamples
+    }
   }
 
   function getCodeSamplesLangs() {
@@ -753,6 +763,7 @@ export function useTheme(initialConfig: Partial<UseThemeConfigUnref> = {}) {
     getI18nConfig,
     setI18nConfig,
     getSpecConfig,
+    getWrapExamples,
     setSpecConfig,
     getCodeSamplesLangs,
     getCodeSamplesDefaultLang,
diff --git a/test/composables/useTheme.test.ts b/test/composables/useTheme.test.ts
index 4eae78ef..f7df62a1 100644
--- a/test/composables/useTheme.test.ts
+++ b/test/composables/useTheme.test.ts
@@ -92,7 +92,9 @@ describe('composition API', () => {
       lazyRendering: ref(false),
       defaultTag: 'Default',
       defaultTagDescription: '',
+      wrapExamples: true,
     })
+    expect(theme.getWrapExamples()).toBe(true)
   })
 
   it('can reset', () => {
@@ -336,6 +338,7 @@ describe('useTheme', () => {
       lazyRendering: ref(false),
       defaultTag: 'Default',
       defaultTagDescription: '',
+      wrapExamples: true,
     })
   })
 
@@ -346,6 +349,7 @@ describe('useTheme', () => {
       showPathsSummary: false,
       avoidCirculars: true,
       lazyRendering: true,
+      wrapExamples: false,
     })
     const result = themeConfig.getSpecConfig()
     result.groupByTags.value = false
@@ -353,6 +357,8 @@ describe('useTheme', () => {
     result.showPathsSummary.value = false
     result.avoidCirculars.value = true
     result.lazyRendering.value = true
+    result.wrapExamples = false
+    expect(themeConfig.getWrapExamples()).toBe(false)
   })
 
   it('returns the default links prefixes config', () => {