@quazardous/qdadm 1.20.0 → 1.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "1.20.0",
+  "version": "1.21.0",
   "description": "Vue 3 framework for admin dashboards with PrimeVue",
   "author": "quazardous",
   "license": "MIT",

package/src/i18n/I18n.ts

@@ -59,6 +59,7 @@ export class I18n {
   private _appAliases: AliasPattern[]
   private _entityToModule: Map<string, string> = new Map()
   private _signals: I18nDeps['signals']
+  private _emitMissing: boolean
   private _defaultLocale: string
   private _fallbackLocale: string
   private _loadedLocales: Set<string> = new Set()
@@ -76,6 +77,7 @@ export class I18n {
     this._strategyName = options.keyStrategy ?? 'global'
     this._appAliases = options.aliases ? [...options.aliases] : []
     this._signals = deps.signals ?? null
+    this._emitMissing = options.emitMissing ?? true
 
     this._registry = new MessagesRegistry()
     this.inline = new InlineTranslationProvider()
@@ -99,7 +101,7 @@ export class I18n {
       fallbackLocale: this._fallbackLocale,
       globalAliases: this._currentStrategyAliases(),
       onMissing: (key, locale) => {
-        this._signals?.emit('i18n:missing', { key, locale })
+        if (this._emitMissing) this._signals?.emit('i18n:missing', { key, locale })
       },
     })
 

package/src/i18n/__tests__/I18n.test.ts

@@ -105,6 +105,37 @@ describe('I18n — locale change', () => {
   })
 })
 
+describe('I18n — emitMissing flag', () => {
+  function makeSignals() {
+    const events: Array<{ signal: string; data: unknown }> = []
+    return {
+      events,
+      signals: {
+        emit: (signal: string, data: unknown) => {
+          events.push({ signal, data })
+        },
+        on: () => () => {},
+      },
+    }
+  }
+
+  it('emits i18n:missing on an unresolved key by default', async () => {
+    const { events, signals } = makeSignals()
+    const i18n = new I18n({ disableDefaultCoreBundle: true }, { signals })
+    await i18n.bootstrap()
+    i18n.t('totally.unknown.key')
+    expect(events.some((e) => e.signal === 'i18n:missing')).toBe(true)
+  })
+
+  it('does not emit i18n:missing when emitMissing is false', async () => {
+    const { events, signals } = makeSignals()
+    const i18n = new I18n({ disableDefaultCoreBundle: true, emitMissing: false }, { signals })
+    await i18n.bootstrap()
+    i18n.t('totally.unknown.key')
+    expect(events.some((e) => e.signal === 'i18n:missing')).toBe(false)
+  })
+})
+
 describe('I18n — providers', () => {
   it('loads from a custom TranslationProvider during bootstrap', async () => {
     const provider: TranslationProvider = {

package/src/i18n/types.ts

@@ -31,4 +31,12 @@ export type {
 export interface I18nOptions extends BaseI18nOptions {
   /** Disable shipping qdadm's default core.* bundles (EN + FR). Default: false. */
   disableDefaultCoreBundle?: boolean
+  /**
+   * Emit the `i18n:missing` debug signal when a key cannot be resolved.
+   * Default: `true`. Set to `false` to silence the missing-key stream (e.g. an
+   * untranslated app where every key would otherwise fire it) — the debug
+   * panel's "Missing" section then stays empty. No functional impact: nothing
+   * but the debug collector consumes this signal.
+   */
+  emitMissing?: boolean
 }