@datagouv/components-next 1.0.2-dev.19 → 1.0.2-dev.190

package/src/components/DataserviceQualityTooltipContent.vue

@@ -0,0 +1,79 @@
+<template>
+  <p class="text-sm text-gray-plain font-bold mb-0">
+    {{ t("Qualité des métadonnées :") }}
+  </p>
+  <ul class="list-none pl-0 space-y-2">
+    <QualityItem
+      :passed="quality.has_description"
+      :message-passed="t('Description renseignée')"
+      :message-failed="t('Description non renseignée')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.has_machine_documentation"
+      :message-passed="t('Documentation machine (OpenAPI) disponible')"
+      :message-failed="t('Documentation machine (OpenAPI) manquante')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.has_technical_documentation"
+      :message-passed="t('Documentation technique renseignée')"
+      :message-failed="t('Documentation technique manquante')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.has_business_documentation"
+      :message-passed="t('Documentation métier renseignée')"
+      :message-failed="t('Documentation métier manquante')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.license"
+      :message-passed="t('Licence renseignée')"
+      :message-failed="t('Licence non renseignée')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.has_contact_point"
+      :message-passed="t('Point de contact renseigné')"
+      :message-failed="t('Point de contact non renseigné')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.has_base_api_url"
+      :message-passed="t(`URL de base de l'API renseignée`)"
+      :message-failed="t(`URL de base de l'API non renseignée`)"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.availability_documented"
+      :message-passed="t('Disponibilité documentée')"
+      :message-failed="t('Disponibilité non documentée')"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.rate_limiting_documented"
+      :message-passed="t(`Limite d'appels documentée`)"
+      :message-failed="t(`Limite d'appels non documentée`)"
+      class="pb-0"
+    />
+    <QualityItem
+      :passed="quality.access_conditions_clear"
+      :message-passed="t(`Conditions d'accès claires`)"
+      :message-failed="t(`Conditions d'accès non précisées`)"
+      class="pb-0"
+    />
+  </ul>
+</template>
+
+<script setup lang="ts">
+import type { DataserviceQuality } from '../types/dataservices'
+import { useTranslation } from '../composables/useTranslation'
+import QualityItem from './QualityItem.vue'
+
+defineProps<{
+  quality: DataserviceQuality
+}>()
+
+const { t } = useTranslation()
+</script>

package/src/components/DatasetCard.vue

@@ -36,6 +36,7 @@
       :icon="RiDatabase2Line"
       :url="datasetUrl || dataset.page"
       :target="datasetUrlInNewTab ? '_blank' : undefined"
+      :title-tag="titleTag"
     >
       {{ dataset.title }}
       <template
@@ -106,10 +107,12 @@
         </p>
       </div>
     </div>
-    <ObjectCardShortDescription
-      v-if="showDescriptionShort"
-      :text="getDescriptionShort(props.dataset)"
-    />
+    <slot>
+      <ObjectCardShortDescription
+        v-if="showDescriptionShort"
+        :text="getDescriptionShort(props.dataset)"
+      />
+    </slot>
   </ObjectCard>
 </template>
 
@@ -117,6 +120,7 @@
 import type { RouteLocationRaw } from 'vue-router'
 import { RiArchiveLine, RiDatabase2Line, RiDownloadLine, RiEyeLine, RiLineChartLine, RiLockLine, RiStarLine, RiSubtractLine } from '@remixicon/vue'
 import type { Dataset, DatasetV2 } from '../types/datasets'
+import type { TitleTag } from '../types/ui'
 import { summarize } from '../functions/helpers'
 import { useFormatDate } from '../functions/dates'
 import { getDescriptionShort } from '../functions/description'
@@ -137,6 +141,7 @@ type Props = {
   datasetUrlInNewTab?: boolean
   organizationUrl?: RouteLocationRaw
   showDescriptionShort?: boolean
+  titleTag?: TitleTag
 }
 
 const props = withDefaults(defineProps<Props>(), {

package/src/components/DatasetQuality.vue

@@ -13,7 +13,7 @@
         {{ t('Qualité des métadonnées:') }}
       </span>
     </span>
-    <DatasetQualityScore
+    <QualityScore
       :score="quality.score"
       class="w-full"
     />
@@ -23,35 +23,35 @@
   </Toggletip>
   <template v-if="!hideWarnings">
     <ul class="list-none pl-0">
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.dataset_description_quality"
         :message="t('Description des données non renseignée')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.resources_documentation"
         :message="t('Documentation des fichiers manquante')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.license"
         :message="t('Licence non renseignée')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.update_frequency && quality.update_fulfilled_in_time"
         :message="quality.update_frequency ? t('Fréquence de mise à jour non respectée') : t('Fréquence de mise à jour non renseignée')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.has_open_format"
         :message="t('Formats de fichiers non standards')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.temporal_coverage"
         :message="t('Couverture temporelle non renseignée')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.spatial"
         :message="t('Couverture spatiale non renseignée')"
       />
-      <DatasetQualityItemWarning
+      <QualityItemWarning
         :quality-item="quality.all_resources_available"
         :message="t('Certains fichiers ne sont pas disponibles')"
       />
@@ -62,8 +62,8 @@
 <script setup lang="ts">
 import { RiInformationLine } from '@remixicon/vue'
 import type { Quality } from '../types/datasets'
-import DatasetQualityItemWarning from './DatasetQualityItemWarning.vue'
-import DatasetQualityScore from './DatasetQualityScore.vue'
+import QualityItemWarning from './QualityItemWarning.vue'
+import QualityScore from './QualityScore.vue'
 import Toggletip from './Toggletip.vue'
 import DatasetQualityTooltipContent from './DatasetQualityTooltipContent.vue'
 import { useTranslation } from '../composables/useTranslation'

package/src/components/DatasetQualityInline.vue

@@ -7,7 +7,7 @@
     >
       <RiInformationLine class="size-3.5 shrink-0" />
       <span class="text-gray-medium text-sm group-hover/quality:underline">{{ t('Métadonnées :') }}</span>
-      <DatasetQualityScore :score="quality.score" />
+      <QualityScore :score="quality.score" />
       <template #toggletip>
         <DatasetQualityTooltipContent :quality />
       </template>
@@ -18,7 +18,7 @@
 <script setup lang="ts">
 import { RiInformationLine } from '@remixicon/vue'
 import type { Quality } from '../types/datasets'
-import DatasetQualityScore from './DatasetQualityScore.vue'
+import QualityScore from './QualityScore.vue'
 import DatasetQualityTooltipContent from './DatasetQualityTooltipContent.vue'
 import Toggletip from './Toggletip.vue'
 import { useTranslation } from '../composables/useTranslation'

package/src/components/DatasetQualityTooltipContent.vue

@@ -68,7 +68,7 @@
 import type { Quality } from '../types/datasets'
 import { useComponentsConfig } from '../config'
 import { useTranslation } from '../composables/useTranslation'
-import DatasetQualityItem from './DatasetQualityItem.vue'
+import DatasetQualityItem from './QualityItem.vue'
 
 defineProps<{
   quality: Quality

package/src/components/Form/Listbox.vue

@@ -0,0 +1,101 @@
+<template>
+  <Listbox v-model="model">
+    <div class="relative min-w-0">
+      <div
+        ref="floatingReference"
+        class="relative w-full cursor-default overflow-hidden bg-white text-left shadow-md focus:outline-none focus-visible:ring-2 focus-visible:ring-white/75 focus-visible:ring-offset-2 focus-visible:ring-offset-teal-300 sm:text-sm"
+      >
+        <ListboxButton class="input shadow-input text-sm flex items-center gap-2">
+          <slot name="button">
+            <div class="w-full flex items-center justify-between gap-2">
+              <div
+                class="truncate"
+                :class="{ 'text-new-disabled-text': isDisabled(model) }"
+              >
+                {{ displayValue(model) }}
+              </div>
+              <RiArrowDownSLine class="flex-none size-4 justify-self-end" />
+            </div>
+          </slot>
+        </ListboxButton>
+      </div>
+
+      <ListboxOptions
+        ref="popover"
+        :style="floatingStyles"
+        class="z-10 mt-1 absolute max-h-60 min-w-80 w-full overflow-auto rounded-md bg-white text-base shadow-lg ring-1 ring-black/5 focus:outline-none sm:text-sm pl-0"
+      >
+        <ListboxOption
+          v-for="option in options"
+          :key="getOptionId(toValue(option))"
+          v-slot="{ active, selected }"
+          as="template"
+          :value="option"
+        >
+          <li
+            class="relative cursor-default select-none py-2 pr-4 list-none flex items-center gap-2 text-gray-900"
+            :class="{
+              'bg-gray-lower': active && !isDisabled(toValue(option)),
+              'text-new-disabled-text': isDisabled(toValue(option)),
+              'pl-2': selected,
+              'pl-6': !selected,
+            }"
+          >
+            <div class="flex items-center justify-center aspect-square">
+              <RiCheckLine
+                v-if="selected"
+                class="size-4"
+                :class="isDisabled(toValue(option)) ?' text-new-disabled-text' : 'text-new-primary'"
+              />
+            </div>
+            <slot
+              name="option"
+              v-bind="{ option, active }"
+            >
+              {{ displayValue(option) }}
+            </slot>
+          </li>
+        </ListboxOption>
+      </ListboxOptions>
+    </div>
+  </Listbox>
+</template>
+
+<script setup lang="ts" generic="T extends string | number | object">
+import { Listbox, ListboxButton, ListboxOption, ListboxOptions } from '@headlessui/vue'
+import { useFloating, autoUpdate, autoPlacement } from '@floating-ui/vue'
+import { toValue, useTemplateRef } from 'vue'
+import { RiArrowDownSLine, RiCheckLine } from '@remixicon/vue'
+
+withDefaults(defineProps<{
+  options?: Array<T>
+  getOptionId?: (option: T) => string | number
+  displayValue: (option: T | null) => string
+  isDisabled?: (option: T | null) => boolean
+}>(), {
+  getOptionId: (option: T): string | number => {
+    if (typeof option === 'string') return option
+    if (typeof option === 'number') return option
+    if (typeof option === 'object' && 'id' in option) return option.id as string
+
+    throw new Error('Please set getOptionId()')
+  },
+  isDisabled: (option: T | null): boolean => {
+    if (option && typeof option === 'object' && 'disabled' in option) return option.disabled as boolean
+
+    return false
+  },
+})
+
+const model = defineModel<T | null>({ required: true })
+
+const referenceRef = useTemplateRef('floatingReference')
+const floatingRef = useTemplateRef<InstanceType<typeof ListboxOptions>>('popover')
+const { floatingStyles } = useFloating(referenceRef, floatingRef, {
+  middleware: [autoPlacement({
+    allowedPlacements: ['bottom-start', 'bottom', 'bottom-end'],
+    crossAxis: true,
+  })],
+  whileElementsMounted: autoUpdate,
+})
+</script>

package/src/components/Form/SchemaSelect.vue

@@ -8,6 +8,7 @@
     :placeholder="t('Tous les schémas')"
     :get-option-id="(s: RegisteredSchema) => s.name"
     :display-value="(s: RegisteredSchema) => s.name"
+    :filter="schemaMatchesQuery"
     :multiple="false"
   />
 </template>
@@ -16,6 +17,7 @@
 import { useTranslation } from '../../composables/useTranslation'
 import { useSelectModelSync } from '../../composables/useSelectModelSync'
 import { useFetch } from '../../functions/api'
+import { schemaMatchesQuery } from '../../functions/schemas'
 import type { RegisteredSchema } from '../../types/schemas'
 import SearchableSelect from './SearchableSelect.vue'
 

package/src/components/InfiniteLoader.vue

@@ -0,0 +1,53 @@
+<template>
+  <div ref="sentinel">
+    <slot>
+      <div class="flex items-center justify-center p-4">
+        <span class="inline-flex items-center gap-2 text-xs text-gray-medium">
+          <RiLoader4Line
+            class="size-4 animate-spin"
+            aria-hidden="true"
+          />
+          {{ t('Chargement…') }}
+        </span>
+      </div>
+    </slot>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { onMounted, onUnmounted, useTemplateRef, watch } from 'vue'
+import { RiLoader4Line } from '@remixicon/vue'
+import { useTranslation } from '../composables/useTranslation'
+
+const props = defineProps<{
+  root?: HTMLElement | null
+}>()
+
+const emit = defineEmits<{
+  intersect: []
+}>()
+
+const { t } = useTranslation()
+
+const sentinelRef = useTemplateRef<HTMLElement>('sentinel')
+let observer: IntersectionObserver | null = null
+
+function setupObserver() {
+  observer?.disconnect()
+  const el = sentinelRef.value
+  if (!el) return
+  observer = new IntersectionObserver(
+    (entries) => {
+      if (entries[0]?.isIntersecting) {
+        emit('intersect')
+      }
+    },
+    { root: props.root ?? null, rootMargin: '200px' },
+  )
+  observer.observe(el)
+}
+
+onMounted(setupObserver)
+watch([sentinelRef, () => props.root], setupObserver)
+onUnmounted(() => observer?.disconnect())
+</script>

package/src/components/ObjectCardHeader.vue

@@ -1,5 +1,8 @@
 <template>
-  <h3 class="w-full text-base flex">
+  <component
+    :is="titleTag"
+    class="w-full text-base font-bold flex"
+  >
     <AppLink
       :to="url"
       class="text-gray-title text-base bg-none flex items-center w-full truncate gap-1"
@@ -19,17 +22,21 @@
       <slot name="extra" />
       <span class="absolute inset-0" />
     </AppLink>
-  </h3>
+  </component>
 </template>
 
 <script setup lang="ts">
 import type { Component } from 'vue'
 import type { RouteLocationRaw } from 'vue-router'
+import type { TitleTag } from '../types/ui'
 import AppLink from './AppLink.vue'
 
-defineProps<{
+withDefaults(defineProps<{
   icon: Component
   url: RouteLocationRaw
   target?: string
-}>()
+  titleTag?: TitleTag
+}>(), {
+  titleTag: 'h3',
+})
 </script>

package/src/components/OpenApiViewer/ContentTypeSelect.vue

@@ -0,0 +1,48 @@
+<template>
+  <Tooltip v-if="contentTypes.length > 1">
+    <div class="relative shrink-0">
+      <select
+        :value="modelValue"
+        class="appearance-none text-xs font-mono bg-white border border-gray-default rounded pl-2 pr-6 py-1 text-gray-medium cursor-pointer hover:border-gray-400 transition-colors"
+        @change="$emit('update:modelValue', ($event.target as HTMLSelectElement).value)"
+      >
+        <option
+          v-for="ct in contentTypes"
+          :key="ct"
+          :value="ct"
+        >
+          {{ contentTypeLabel(ct) }}
+        </option>
+      </select>
+      <RiArrowDownSLine class="pointer-events-none absolute right-1 top-1/2 -translate-y-1/2 size-3.5 text-gray-medium" />
+    </div>
+    <template #tooltip>
+      {{ modelValue }}
+    </template>
+  </Tooltip>
+  <Tooltip v-else-if="contentTypes.length === 1">
+    <span
+      class="text-xs font-mono bg-white border border-gray-default rounded px-2 py-1 text-gray-medium shrink-0"
+    >
+      {{ contentTypeLabel(contentTypes[0]!) }}
+    </span>
+    <template #tooltip>
+      {{ contentTypes[0] }}
+    </template>
+  </Tooltip>
+</template>
+
+<script setup lang="ts">
+import { RiArrowDownSLine } from '@remixicon/vue'
+import Tooltip from '../Tooltip.vue'
+import { contentTypeLabel } from './openapi'
+
+defineProps<{
+  contentTypes: string[]
+  modelValue: string
+}>()
+
+defineEmits<{
+  'update:modelValue': [value: string]
+}>()
+</script>

package/src/components/OpenApiViewer/EndpointRequest.vue

@@ -0,0 +1,164 @@
+<template>
+  <div class="border border-gray-default rounded">
+    <div
+      v-if="!tabs.length"
+      class="p-3 text-xs text-gray-medium"
+    >
+      {{ t("Aucun paramètre de requête") }}
+    </div>
+    <TabGroup
+      v-else
+      size="sm"
+      @change="onTabChange"
+    >
+      <div class="bg-gray-100 px-3 py-2 border-b border-gray-default flex items-center justify-between gap-2">
+        <TabList>
+          <Tab
+            v-for="tab in tabs"
+            :key="tab.key"
+          >
+            {{ tab.label }}
+          </Tab>
+        </TabList>
+        <ContentTypeSelect
+          v-if="activeTab === 'body' && bodyContentTypes.length"
+          :content-types="bodyContentTypes"
+          :model-value="selectedBodyContentType"
+          @update:model-value="selectedBodyContentType = $event"
+        />
+      </div>
+      <TabPanels>
+        <TabPanel
+          v-for="tab in tabs"
+          :key="tab.key"
+        >
+          <div
+            v-if="tab.key === 'query'"
+            class="p-3"
+          >
+            <div class="space-y-0 divide-y divide-gray-100">
+              <div
+                v-for="param in queryParams"
+                :key="param.name"
+                class="py-2"
+              >
+                <div class="flex items-baseline gap-2">
+                  <span class="font-mono text-xs text-gray-title">
+                    {{ param.name }}
+                    <span
+                      v-if="param.required"
+                      class="text-red-600"
+                    >*</span>
+                  </span>
+                  <span class="font-mono text-xs text-gray-medium">{{ getSchemaType(endpoint.spec, param.schema) }}</span>
+                </div>
+                <p
+                  v-if="param.description"
+                  class="text-xs text-gray-medium mt-0.5 mb-0"
+                >
+                  {{ param.description }}
+                </p>
+              </div>
+            </div>
+          </div>
+          <div
+            v-if="tab.key === 'path'"
+            class="p-3"
+          >
+            <div class="space-y-0 divide-y divide-gray-100">
+              <div
+                v-for="param in pathParams"
+                :key="param.name"
+                class="py-2"
+              >
+                <div class="flex items-baseline gap-2">
+                  <span class="font-mono text-xs text-gray-title">
+                    {{ param.name }}
+                    <span class="text-red-600">*</span>
+                  </span>
+                  <span class="font-mono text-xs text-gray-medium">{{ getSchemaType(endpoint.spec, param.schema) }}</span>
+                </div>
+                <p
+                  v-if="param.description"
+                  class="text-xs text-gray-medium mt-0.5 mb-0"
+                >
+                  {{ param.description }}
+                </p>
+              </div>
+            </div>
+          </div>
+          <div
+            v-if="tab.key === 'body'"
+            class="p-3"
+          >
+            <SchemaPanel
+              v-if="currentBodyMediaType?.schema"
+              :spec="endpoint.spec"
+              :schema="currentBodyMediaType.schema"
+            />
+          </div>
+        </TabPanel>
+      </TabPanels>
+    </TabGroup>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed, ref, watch } from 'vue'
+import TabGroup from '../Tabs/TabGroup.vue'
+import TabList from '../Tabs/TabList.vue'
+import Tab from '../Tabs/Tab.vue'
+import TabPanels from '../Tabs/TabPanels.vue'
+import TabPanel from '../Tabs/TabPanel.vue'
+import ContentTypeSelect from './ContentTypeSelect.vue'
+import { useTranslation } from '../../composables/useTranslation'
+import SchemaPanel from './SchemaPanel.vue'
+import { getSchemaType, type Endpoint } from './openapi'
+
+const props = defineProps<{
+  endpoint: Endpoint
+}>()
+
+const { t } = useTranslation()
+
+const queryParams = computed(() => props.endpoint.parameters.filter(p => p.in === 'query'))
+const pathParams = computed(() => props.endpoint.parameters.filter(p => p.in === 'path'))
+
+const tabs = computed(() => {
+  const result: { key: string, label: string }[] = []
+  if (pathParams.value.length) {
+    result.push({ key: 'path', label: t('Path') })
+  }
+  if (queryParams.value.length) {
+    result.push({ key: 'query', label: t('Query') })
+  }
+  if (props.endpoint.requestBody) {
+    result.push({ key: 'body', label: t('Body') })
+  }
+  return result
+})
+
+const activeTabIndex = ref(0)
+const activeTab = computed(() => tabs.value[activeTabIndex.value]?.key || '')
+const selectedBodyContentType = ref('')
+
+const bodyContentTypes = computed(() => {
+  if (!props.endpoint.requestBody?.content) return []
+  return Object.keys(props.endpoint.requestBody.content)
+})
+
+const currentBodyMediaType = computed(() => {
+  if (!props.endpoint.requestBody?.content) return null
+  const ct = selectedBodyContentType.value || bodyContentTypes.value[0]
+  if (!ct) return null
+  return props.endpoint.requestBody.content[ct] || null
+})
+
+watch(bodyContentTypes, (types) => {
+  selectedBodyContentType.value = types[0] || ''
+}, { immediate: true })
+
+function onTabChange(index: number) {
+  activeTabIndex.value = index
+}
+</script>