glyria generate

Utilisation

npm run generate
# ou
npx glyria generate

Fonctionnement

glyria generate analyse votre projet et régénère le fichier .glyria/imports.d.ts — le fichier de déclaration TypeScript qui permet aux auto-imports de fonctionner dans votre IDE.

Il s’exécute automatiquement lors de glyria init et glyria dev. Vous n’avez besoin de l’exécuter manuellement qu’en production après l’ajout de nouveaux utilitaires.

Ce qui est analysé

Variables globales du framework

Tous les utilitaires de glyria.js sont déclarés globalement automatiquement :

GlyriaClient, GlyriaCommand, GlyriaUserCommand, GlyriaMessageCommand,
GlyriaEvent, EmbedV2Builder, GlyriaBus, globalBus,
createReplyableContext, useCommands, defineGlyriaConfig, logger,
hexToNumber, Events

Variables globales discord.js

L’intégralité de la bibliothèque discord.js est disponible globalement sous l’espace de noms djs :

djs.PermissionsBitField.Flags.BanMembers
djs.GatewayIntentBits.Guilds
djs.ButtonStyle.Primary
// ... tous les exports de discord.js

Variables globales utilisateur

glyria generate analyse les dossiers et fichiers suivants à la recherche de fonctions, classes et constantes exportées :

Par défaut, src/utils/ et src/composables/ sont analysés. Vous pouvez personnaliser cela dans glyria.config.ts :

export default defineGlyriaConfig({
  dev: {
    autoImportDirs: ['utils', 'composables', 'helpers', 'lib']
  }
})

Toute déclaration export const, export function ou export class trouvée dans ces fichiers est automatiquement ajoutée au scope global.

// src/utils/useDatabase.ts
export const useDatabase = () => { ... }
export const formatDate = (date: Date) => { ... }

Après exécution de glyria generate :

// src/commands/ping.ts — aucun import nécessaire
const db = useDatabase()
const date = formatDate(new Date())

Résultat généré

Le fichier .glyria/imports.d.ts généré ressemble à ceci :

// auto-généré par glyria — ne pas modifier

export {}

declare global {
  const djs: typeof import("discord.js")
  const GlyriaClient: typeof import("@glyria/bot")["GlyriaClient"]
  const GlyriaCommand: typeof import("@glyria/bot")["GlyriaCommand"]
  const useDatabase: typeof import("../src/utils/useDatabase.ts")["useDatabase"]
  // ...
}

Ce fichier est écrasé à chaque exécution de glyria generate. Toute modification manuelle sera perdue. ::

Quand l’exécuter manuellement

Exécutez glyria generate lorsque :

• Vous ajoutez un nouveau fichier dans src/utils/ ou src/composables/ en production
• Votre IDE ne reconnaît pas une variable globale qui devrait exister
• Après une mise à jour de glyria.js ajoutant de nouvelles fonctionnalités globales

En mode développement, glyria dev gère cela automatiquement — les types sont régénérés à chaque modification dans les dossiers d’auto-import.