Checklist de publication Community

Cette page résume la procédure de validation avant publication npm de @vevedh/qform-builder-layer.

1. Nettoyage

bunx nuxi cleanup .playground

Sous Windows, en cas de cache corrompu :

Remove-Item -Recurse -Force .playground\.nuxt, .playground\.output, .nuxt, .output, node_modules\.cache\vite, node_modules\.vite -ErrorAction SilentlyContinue

2. Installation

bun install

3. Validation complète

bun run docs:build
bun run typecheck:nuxt
bun run pack:dry-run

Ou directement :

bun run release:doctor

4. Vérifier le contenu publié

npm pack --dry-run

Le package npm doit contenir :

app/components
app/composables
app/constants
app/stores
app/types
app/utils
formkit.config.ts
nuxt.config.ts
README.md
LICENSE
CHANGELOG.md
COMMUNITY_EDITION.md
SECURITY.md

Il ne doit pas contenir :

.playground
.nuxt
.output
node_modules
PROMPT_CONTEXT.md
PATCH_*.md
*.zip

5. Dry-run publication

npm publish --dry-run --access public

ou :

bun run release:publish:dry-run

6. Publication réelle

npm login
npm publish --access public

Pour un package scoped public, la première publication doit être publique explicitement.

7. Test consommateur

Créer un projet Nuxt 4 neuf :

bunx nuxi init qform-consumer-test
cd qform-consumer-test
bun install

Installer les dépendances :

bun add @vevedh/qform-builder-layer \
  nuxt-quasar-ui @pinia/nuxt @formkit/nuxt \
  quasar @quasar/extras \
  @formkit/core @formkit/i18n @formkit/vue @formkit/utils pinia

Configurer :

export default defineNuxtConfig({
  extends: ['@vevedh/qform-builder-layer'],
  compatibilityDate: '2026-05-09',
})

Tester :

<script setup lang="ts">
import type { FormBuilderSchema, FormBuilderValues } from '@vevedh/qform-builder-layer/types'

const schema = ref<FormBuilderSchema>([])
const values = ref<FormBuilderValues>({})
</script>

<template>
  <ClientOnly>
    <FormBuilder
      builder-id="consumer-test-builder"
      v-model:schema="schema"
      v-model:values="values"
      autosave
    />
  </ClientOnly>
</template>