@quazardous/qdadm 1.19.6 → 1.19.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quazardous/qdadm",
-  "version": "1.19.6",
+  "version": "1.19.7",
   "description": "Vue 3 framework for admin dashboards with PrimeVue",
   "author": "quazardous",
   "license": "MIT",
@@ -17,6 +17,7 @@
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
+    "gen:i18n-defaults": "node scripts/gen-i18n-defaults.mjs",
     "type-check": "vue-tsc --noEmit",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",

package/src/i18n/defaults/DefaultCoreProvider.ts

@@ -2,13 +2,17 @@
  * Default core provider — ships qdadm's `core.*` defaults (EN + FR) as a
  * `LazyTranslationProvider` configured with a YAML loader.
  *
- * The YAML files (`core.en.yml`, `core.fr.yml`) are imported via Vite's
- * `?raw` query so the text is fetched on-demand, then parsed at runtime.
- * Splitting the bundle by locale (and, in the future, by domain) keeps the
- * provider tree-shakeable and translator-friendly.
+ * The YAML text is imported from `core.<locale>.generated.ts` — plain TS
+ * modules that `export default` the raw YAML string, generated from the
+ * sibling `core.<locale>.yml` source-of-truth (see `scripts/gen-i18n-defaults.mjs`).
+ * Using a normal module instead of a Vite `?raw` query keeps the import
+ * portable across bundlers and avoids the file:/symlink `server.fs.allow`
+ * trap (qdadm #492). The dynamic-import boundary still gives per-locale
+ * code-splitting, and the `.yml` files stay translator-friendly.
  *
- * Adding a built-in locale = drop `core.<locale>.yml` next to this file and
- * add it to the loader map below.
+ * Adding a built-in locale = drop `core.<locale>.yml` next to this file,
+ * run `npm run gen:i18n-defaults -w packages/qdadm`, and add the locale to
+ * the loader map below.
  */
 
 import { LazyTranslationProvider } from '../LazyTranslationProvider'
@@ -16,8 +20,8 @@ import { createYamlLoader } from '../loaders/yaml'
 
 export function createDefaultCoreProvider(): LazyTranslationProvider {
   const yamlLoader = createYamlLoader({
-    en: () => import('./core.en.yml?raw'),
-    fr: () => import('./core.fr.yml?raw'),
+    en: () => import('./core.en.generated'),
+    fr: () => import('./core.fr.generated'),
   })
 
   return new LazyTranslationProvider({

package/src/i18n/defaults/__tests__/generated-sync.test.ts

@@ -0,0 +1,42 @@
+/**
+ * Guards the `core.<locale>.yml` → `core.<locale>.generated.ts` pipeline
+ * introduced for qdadm #492 (drop the Vite-specific `?raw` import).
+ *
+ * - Drift guard: the generated module's default export must equal the raw
+ *   `.yml` text verbatim. The generator wraps the raw text in a template
+ *   literal, which round-trips back to the original — so if you edit a `.yml`
+ *   without running `npm run gen:i18n-defaults`, this fails.
+ * - End-to-end: the default core provider must load its bundles through the
+ *   new (non-`?raw`) import path.
+ */
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { describe, it, expect } from 'vitest'
+
+import enGenerated from '../core.en.generated'
+import frGenerated from '../core.fr.generated'
+import { createDefaultCoreProvider } from '../DefaultCoreProvider'
+
+const defaultsDir = join(dirname(fileURLToPath(import.meta.url)), '..')
+const readYml = (locale: string) =>
+  readFileSync(join(defaultsDir, `core.${locale}.yml`), 'utf8')
+
+describe('i18n default providers — generated/.yml sync', () => {
+  it('core.en.generated.ts round-trips core.en.yml', () => {
+    expect(enGenerated).toBe(readYml('en'))
+  })
+
+  it('core.fr.generated.ts round-trips core.fr.yml', () => {
+    expect(frGenerated).toBe(readYml('fr'))
+  })
+
+  it('default core provider loads bundles via the generated modules', async () => {
+    type CoreBundle = { core: { actions: { save: string } } }
+    const provider = createDefaultCoreProvider()
+    const en = (await provider.load('en')) as CoreBundle
+    const fr = (await provider.load('fr')) as CoreBundle
+    expect(en.core.actions.save).toBe('Save')
+    expect(fr.core.actions.save).toBe('Enregistrer')
+  })
+})

package/src/i18n/defaults/core.en.generated.ts

@@ -0,0 +1,58 @@
+/* GENERATED from core.en.yml — DO NOT EDIT.
+ * Run `npm run gen:i18n-defaults -w packages/qdadm` to regenerate. */
+export default `core:
+  actions:
+    save: Save
+    cancel: Cancel
+    delete: Delete
+    edit: Edit
+    create: Create
+    update: Update
+    createAndClose: Create & Close
+    updateAndClose: Update & Close
+    add: Add
+    remove: Remove
+    submit: Submit
+    reset: Reset
+    back: Back
+    next: Next
+    previous: Previous
+    close: Close
+    confirm: Confirm
+    search: Search
+    filter: Filter
+    clear: Clear
+    refresh: Refresh
+    export: Export
+    import: Import
+  tooltips:
+    saveAndContinue: Save and continue editing
+    saveAndReturn: Save and return to list
+    unsavedChanges: Unsaved changes
+  placeholders:
+    search: Search…
+    noSelection: Click to select…
+  fields:
+    id: ID
+    created_at: Created at
+    updated_at: Updated at
+    created_by: Created by
+    updated_by: Updated by
+  messages:
+    empty: No items available
+    loading: Loading…
+    noResults: No results
+    noMatching: No matching items
+    saved: Saved
+    deleted: Deleted
+    created: Created
+    updated: Updated
+    confirmDelete: Are you sure you want to delete this item?
+  errors:
+    required: Required
+    tooShort: Too short (min {min})
+    tooLong: Too long (max {max})
+    invalid: Invalid value
+    notFound: Not found
+    unknown: An unknown error occurred
+`

package/src/i18n/defaults/core.fr.generated.ts

@@ -0,0 +1,58 @@
+/* GENERATED from core.fr.yml — DO NOT EDIT.
+ * Run `npm run gen:i18n-defaults -w packages/qdadm` to regenerate. */
+export default `core:
+  actions:
+    save: Enregistrer
+    cancel: Annuler
+    delete: Supprimer
+    edit: Modifier
+    create: Créer
+    update: Mettre à jour
+    createAndClose: Créer et fermer
+    updateAndClose: Mettre à jour et fermer
+    add: Ajouter
+    remove: Retirer
+    submit: Valider
+    reset: Réinitialiser
+    back: Retour
+    next: Suivant
+    previous: Précédent
+    close: Fermer
+    confirm: Confirmer
+    search: Rechercher
+    filter: Filtrer
+    clear: Effacer
+    refresh: Actualiser
+    export: Exporter
+    import: Importer
+  tooltips:
+    saveAndContinue: Enregistrer et continuer la modification
+    saveAndReturn: Enregistrer et revenir à la liste
+    unsavedChanges: Modifications non enregistrées
+  placeholders:
+    search: Rechercher…
+    noSelection: Cliquez pour sélectionner…
+  fields:
+    id: Identifiant
+    created_at: Créé le
+    updated_at: Modifié le
+    created_by: Créé par
+    updated_by: Modifié par
+  messages:
+    empty: Aucun élément
+    loading: Chargement…
+    noResults: Aucun résultat
+    noMatching: Aucune correspondance
+    saved: Enregistré
+    deleted: Supprimé
+    created: Créé
+    updated: Modifié
+    confirmDelete: Êtes-vous sûr de vouloir supprimer cet élément ?
+  errors:
+    required: Requis
+    tooShort: Trop court (min {min})
+    tooLong: Trop long (max {max})
+    invalid: Valeur invalide
+    notFound: Introuvable
+    unknown: Une erreur inconnue est survenue
+`

package/src/i18n/loaders/yaml.ts

@@ -5,11 +5,14 @@
  * `LazyLoader` that resolves the YAML text for the requested locale and
  * parses it through the `yaml` package.
  *
- * Typical usage with Vite/Vitest `?raw` imports (qdadm-internal default):
+ * The importer just needs to resolve to `{ default: <yaml text> }`. qdadm's
+ * own defaults import generated `.ts` string modules (see DefaultCoreProvider
+ * — bundler-portable, no `?raw`), but a consumer on Vite/Vitest can equally
+ * pass `?raw` imports of their own YAML:
  *
  *   const loader = createYamlLoader({
- *     en: () => import('./core.en.yml?raw'),
- *     fr: () => import('./core.fr.yml?raw'),
+ *     en: () => import('./messages.en.yml?raw'),
+ *     fr: () => import('./messages.fr.yml?raw'),
  *   })
  *
  * The dynamic-import boundary is what gives us code-splitting: the YAML for