vite-plugin-gas-html

Vite plugin pour exporter/importer des sources frontend au format HTML Apps Script et générer automatiquement le fichier version.js.

Fonctionnalités

• Export : Convertit tous les fichiers du dossier frontend en fichiers HTML Apps Script (format + ).
• Import : Restaure les fichiers frontend à partir des fichiers HTML Apps Script.
• Génération de version.js : Crée un fichier version.js avec la date de build à chaque compilation.
• Centralisation des plugins Vite : Utilisez le helper gasHtmlVitePlugins pour inclure React, SingleFile, htmlConfig et ce plugin dans votre config Vite.
• CLI globale : Utilisez la commande gas-html pour exporter ou importer sans projet Vite.
• Automatisation des releases : Version, changelog, commit, tag et publication npm automatisés.

Installation

npm install vite-plugin-gas-html

Utilisation Vite

Dans votre vite.config.js :

const { gasHtmlVitePlugins } = require('vite-plugin-gas-html/vitePlugins');

export default defineConfig({
  plugins: gasHtmlVitePlugins({
    srcDir: 'frontend',
    outDir: 'appscript/src',
    versionFile: 'version.js',
    enableExport: true,
    enableImport: true,
  }),
  // ...autre config
});

Pour importer les fichiers Apps Script vers le frontend :

VITE_IMPORT_GAS_HTML=1 npm run build

Utilisation CLI globale

Vous pouvez installer le plugin en global et utiliser la commande gas-html partout, même sans projet Vite :

npm install -g vite-plugin-gas-html

Exporter le frontend vers Apps Script

gas-html export --src ./frontend --out ./appscript/src

Importer les fichiers Apps Script vers le frontend

gas-html import --in ./appscript/src --out ./frontend

Options :

• --src <srcDir> : Dossier source à exporter (défaut : ./frontend)
• --out <outDir> : Dossier de sortie (défaut : ./appscript/src)
• --in <inDir> : Dossier d'entrée pour import (défaut : ./appscript/src)

Automatisation des releases

Ce projet utilise standard-version pour automatiser la gestion des versions, changelog, commit, tag et publication npm.

Workflow release

• Pour générer une nouvelle version, le changelog, commit et tag :

  npm run release

• Pour tout pousser et publier sur npm :

  npm run release:publish

Le changelog est généré automatiquement dans CHANGELOG.md et la version est incrémentée dans package.json selon les commits.

Licence

MIT