@nextsparkjs/core 0.1.0-beta.1 → 0.1.0-beta.3

package/scripts/build/registry/generators/translation-registry.mjs

@@ -6,9 +6,48 @@
  * @module core/scripts/build/registry/generators/translation-registry
  */
 
-import { existsSync, readdirSync } from 'fs'
+import { existsSync, readdirSync, statSync } from 'fs'
 import { join } from 'path'
 
+/**
+ * Detect locale entries from a messages directory
+ * Supports both directory pattern (en/, es/ with index.ts) and flat file pattern (en.json, es.json)
+ * Directory pattern takes precedence if both exist
+ *
+ * @param {string} messagesDir - Path to the messages directory
+ * @returns {Array<{locale: string, isDirectory: boolean}>} Detected locales with their type
+ */
+function detectLocales(messagesDir) {
+  if (!existsSync(messagesDir)) {
+    return []
+  }
+
+  const entries = readdirSync(messagesDir)
+  const locales = new Map() // Use Map to ensure directory takes precedence
+
+  entries.forEach(entry => {
+    const entryPath = join(messagesDir, entry)
+    const stat = statSync(entryPath)
+
+    if (stat.isDirectory()) {
+      // Directory pattern: check for index.ts
+      const indexPath = join(entryPath, 'index.ts')
+      if (existsSync(indexPath)) {
+        // Directory pattern takes precedence
+        locales.set(entry, { locale: entry, isDirectory: true })
+      }
+    } else if (entry.endsWith('.json')) {
+      // Flat file pattern (only if directory doesn't exist)
+      const locale = entry.replace(/\.json$/, '')
+      if (!locales.has(locale)) {
+        locales.set(locale, { locale, isDirectory: false })
+      }
+    }
+  })
+
+  return Array.from(locales.values())
+}
+
 /**
  * Generate Translation Registry
  * Auto-generates lazy-loading functions for theme translations
@@ -22,27 +61,59 @@ import { join } from 'path'
 export function generateTranslationRegistry(themes, config) {
   // Discover all translation files from themes
   const themeTranslations = []
+  // Discover entity translations
+  const entityTranslations = []
 
   themes.forEach(theme => {
     const messagesDir = join(config.contentsDir, 'themes', theme.name, 'messages')
+    const entitiesDir = join(config.contentsDir, 'themes', theme.name, 'entities')
 
-    if (existsSync(messagesDir)) {
-      const files = readdirSync(messagesDir)
-      const localeFiles = files.filter(f => f.endsWith('.json') || f.endsWith('.ts'))
-
-      localeFiles.forEach(file => {
-        const locale = file.replace(/\.(json|ts)$/, '')
-        themeTranslations.push({
-          themeName: theme.name,
-          locale,
-          filePath: `@/contents/themes/${theme.name}/messages/${file}`,
-          importKey: `theme_${theme.name.replace(/-/g, '_')}_${locale.replace(/-/g, '_')}`
-        })
+    // Scan theme-level translations
+    const locales = detectLocales(messagesDir)
+    locales.forEach(({ locale, isDirectory }) => {
+      // For directory pattern, import from the directory (index.ts)
+      // For flat file pattern, import the .json file
+      const filePath = isDirectory
+        ? `@/contents/themes/${theme.name}/messages/${locale}`
+        : `@/contents/themes/${theme.name}/messages/${locale}.json`
+
+      themeTranslations.push({
+        themeName: theme.name,
+        locale,
+        filePath,
+        isDirectory,
+        importKey: `theme_${theme.name.replace(/-/g, '_')}_${locale.replace(/-/g, '_')}`
+      })
+    })
+
+    // Scan entity-level translations
+    if (existsSync(entitiesDir)) {
+      const entityDirs = readdirSync(entitiesDir).filter(entry => {
+        const entryPath = join(entitiesDir, entry)
+        return statSync(entryPath).isDirectory()
+      })
+
+      entityDirs.forEach(entityName => {
+        const entityMessagesDir = join(entitiesDir, entityName, 'messages')
+        if (existsSync(entityMessagesDir)) {
+          const entityLocaleFiles = readdirSync(entityMessagesDir).filter(f => f.endsWith('.json'))
+
+          entityLocaleFiles.forEach(file => {
+            const locale = file.replace(/\.json$/, '')
+            entityTranslations.push({
+              themeName: theme.name,
+              entityName,
+              locale,
+              filePath: `@/contents/themes/${theme.name}/entities/${entityName}/messages/${file}`,
+              importKey: `entity_${theme.name.replace(/-/g, '_')}_${entityName.replace(/-/g, '_')}_${locale.replace(/-/g, '_')}`
+            })
+          })
+        }
       })
     }
   })
 
-  // Generate loader functions (lazy-loading for performance)
+  // Generate theme loader functions (lazy-loading for performance)
   const loaderEntries = {}
 
   themeTranslations.forEach(translation => {
@@ -60,14 +131,46 @@ export function generateTranslationRegistry(themes, config) {
     })
     .join(',\n')
 
+  // Generate entity loader functions
+  // Structure: { themeName: { entityName: { locale: loader } } }
+  const entityLoaderEntries = {}
+
+  entityTranslations.forEach(translation => {
+    if (!entityLoaderEntries[translation.themeName]) {
+      entityLoaderEntries[translation.themeName] = {}
+    }
+    if (!entityLoaderEntries[translation.themeName][translation.entityName]) {
+      entityLoaderEntries[translation.themeName][translation.entityName] = []
+    }
+    entityLoaderEntries[translation.themeName][translation.entityName].push(
+      `      '${translation.locale}': () => import('${translation.filePath}')`
+    )
+  })
+
+  const entityLoadersCode = Object.entries(entityLoaderEntries)
+    .map(([themeName, entities]) => {
+      const entitiesCode = Object.entries(entities)
+        .map(([entityName, loaders]) => {
+          return `    '${entityName}': {\n${loaders.join(',\n')}\n    }`
+        })
+        .join(',\n')
+      return `  '${themeName}': {\n${entitiesCode}\n  }`
+    })
+    .join(',\n')
+
+  // Count unique entities
+  const uniqueEntities = new Set(entityTranslations.map(t => `${t.themeName}:${t.entityName}`))
+
   return `/**
  * Auto-generated Translation Registry
  *
  * Generated at: ${new Date().toISOString()}
  * Themes with translations: ${Object.keys(loaderEntries).length}
- * Total translation files: ${themeTranslations.length}
+ * Total theme translation files: ${themeTranslations.length}
+ * Total entity translation files: ${entityTranslations.length}
+ * Total entities with translations: ${uniqueEntities.size}
  *
- * ⚠️ DO NOT EDIT - This file is auto-generated by scripts/build-registry.mjs
+ * DO NOT EDIT - This file is auto-generated by scripts/build-registry.mjs
  *
  * ZERO runtime string interpolation - all translation paths resolved at build time.
  * Preserves lazy-loading performance (only loads active locale).
@@ -87,14 +190,28 @@ export const THEME_TRANSLATION_LOADERS: Record<string, Record<string, Translatio
 ${loadersCode || '  // No theme translations discovered'}
 }
 
+/**
+ * Entity Translation Loaders Registry
+ * Access: ENTITY_TRANSLATION_LOADERS['theme-name']['entity-name']['locale']()
+ *
+ * Returns lazy-loading functions for entity-specific translations.
+ * Structure: theme -> entity -> locale -> loader
+ */
+export const ENTITY_TRANSLATION_LOADERS: Record<string, Record<string, Record<string, TranslationLoader>>> = {
+${entityLoadersCode || '  // No entity translations discovered'}
+}
+
 /**
  * Translation registry metadata
  */
 export const TRANSLATION_METADATA = {
   totalThemes: ${Object.keys(loaderEntries).length},
-  totalTranslations: ${themeTranslations.length},
+  totalThemeTranslations: ${themeTranslations.length},
+  totalEntityTranslations: ${entityTranslations.length},
+  totalEntitiesWithTranslations: ${uniqueEntities.size},
   generatedAt: '${new Date().toISOString()}',
-  themes: [${Object.keys(loaderEntries).map(t => `'${t}'`).join(', ')}]
+  themes: [${Object.keys(loaderEntries).map(t => `'${t}'`).join(', ')}],
+  entities: [${Array.from(uniqueEntities).map(e => `'${e}'`).join(', ')}]
 }
 `
 }

package/templates/contents/themes/default/entities/customers/messages/de.json

@@ -0,0 +1,66 @@
+{
+  "entity": {
+    "name": "Kunde",
+    "plural": "Kunden",
+    "description": "Verwalten Sie Ihre Kunden und deren Informationen"
+  },
+  "fields": {
+    "office": {
+      "label": "Büro",
+      "description": "Kundenbüro oder Filialstandort",
+      "placeholder": "Büro eingeben..."
+    },
+    "number": {
+      "label": "Kundennummer",
+      "description": "Eindeutige Kundenkennung",
+      "placeholder": "Kundennummer eingeben..."
+    },
+    "name": {
+      "label": "Name",
+      "description": "Kundenname",
+      "placeholder": "Kundennamen eingeben..."
+    },
+    "phone": {
+      "label": "Telefon",
+      "description": "Kundentelefonnummer",
+      "placeholder": "Telefonnummer eingeben..."
+    },
+    "salesRep": {
+      "label": "Vertriebsmitarbeiter",
+      "description": "Zugewiesener Vertriebsmitarbeiter",
+      "placeholder": "Vertriebsmitarbeiter eingeben..."
+    },
+    "visitDays": {
+      "label": "Besuchstage",
+      "description": "Geplante Besuchstage",
+      "placeholder": "Besuchstage eingeben..."
+    },
+    "contactDays": {
+      "label": "Kontakttage",
+      "description": "Bevorzugte Kontakttage",
+      "placeholder": "Kontakttage eingeben..."
+    },
+    "image": {
+      "label": "Bild",
+      "description": "Kundenlogo oder Bild-URL",
+      "placeholder": "Bild-URL eingeben..."
+    }
+  },
+  "actions": {
+    "create": "Kunde erstellen",
+    "edit": "Kunde bearbeiten",
+    "delete": "Kunde löschen",
+    "view": "Kunde anzeigen",
+    "list": "Kunden auflisten",
+    "search": "Kunden suchen",
+    "export": "Kunden exportieren",
+    "import": "Kunden importieren"
+  },
+  "messages": {
+    "created": "Kunde erfolgreich erstellt",
+    "updated": "Kunde erfolgreich aktualisiert",
+    "deleted": "Kunde erfolgreich gelöscht",
+    "notFound": "Kunde nicht gefunden",
+    "error": "Bei der Verarbeitung des Kunden ist ein Fehler aufgetreten"
+  }
+}

package/templates/contents/themes/default/entities/customers/messages/fr.json

@@ -0,0 +1,66 @@
+{
+  "entity": {
+    "name": "Client",
+    "plural": "Clients",
+    "description": "Gérez vos clients et leurs informations"
+  },
+  "fields": {
+    "office": {
+      "label": "Bureau",
+      "description": "Bureau ou agence du client",
+      "placeholder": "Entrez le bureau..."
+    },
+    "number": {
+      "label": "Numéro de client",
+      "description": "Identifiant unique du client",
+      "placeholder": "Entrez le numéro de client..."
+    },
+    "name": {
+      "label": "Nom",
+      "description": "Nom du client",
+      "placeholder": "Entrez le nom du client..."
+    },
+    "phone": {
+      "label": "Téléphone",
+      "description": "Numéro de téléphone du client",
+      "placeholder": "Entrez le numéro de téléphone..."
+    },
+    "salesRep": {
+      "label": "Représentant commercial",
+      "description": "Représentant commercial assigné",
+      "placeholder": "Entrez le représentant commercial..."
+    },
+    "visitDays": {
+      "label": "Jours de visite",
+      "description": "Jours de visite programmés",
+      "placeholder": "Entrez les jours de visite..."
+    },
+    "contactDays": {
+      "label": "Jours de contact",
+      "description": "Jours de contact préférés",
+      "placeholder": "Entrez les jours de contact..."
+    },
+    "image": {
+      "label": "Image",
+      "description": "Logo ou URL d'image du client",
+      "placeholder": "Entrez l'URL de l'image..."
+    }
+  },
+  "actions": {
+    "create": "Créer un client",
+    "edit": "Modifier le client",
+    "delete": "Supprimer le client",
+    "view": "Voir le client",
+    "list": "Liste des clients",
+    "search": "Rechercher des clients",
+    "export": "Exporter les clients",
+    "import": "Importer des clients"
+  },
+  "messages": {
+    "created": "Client créé avec succès",
+    "updated": "Client mis à jour avec succès",
+    "deleted": "Client supprimé avec succès",
+    "notFound": "Client introuvable",
+    "error": "Une erreur s'est produite lors du traitement du client"
+  }
+}

package/templates/contents/themes/default/entities/customers/messages/it.json

@@ -0,0 +1,66 @@
+{
+  "entity": {
+    "name": "Cliente",
+    "plural": "Clienti",
+    "description": "Gestisci i tuoi clienti e le loro informazioni"
+  },
+  "fields": {
+    "office": {
+      "label": "Ufficio",
+      "description": "Ufficio o filiale del cliente",
+      "placeholder": "Inserisci ufficio..."
+    },
+    "number": {
+      "label": "Numero Cliente",
+      "description": "Identificativo unico del cliente",
+      "placeholder": "Inserisci numero cliente..."
+    },
+    "name": {
+      "label": "Nome",
+      "description": "Nome del cliente",
+      "placeholder": "Inserisci nome cliente..."
+    },
+    "phone": {
+      "label": "Telefono",
+      "description": "Numero di telefono del cliente",
+      "placeholder": "Inserisci numero di telefono..."
+    },
+    "salesRep": {
+      "label": "Rappresentante Vendite",
+      "description": "Rappresentante vendite assegnato",
+      "placeholder": "Inserisci rappresentante vendite..."
+    },
+    "visitDays": {
+      "label": "Giorni di Visita",
+      "description": "Giorni di visita programmati",
+      "placeholder": "Inserisci giorni di visita..."
+    },
+    "contactDays": {
+      "label": "Giorni di Contatto",
+      "description": "Giorni di contatto preferiti",
+      "placeholder": "Inserisci giorni di contatto..."
+    },
+    "image": {
+      "label": "Immagine",
+      "description": "Logo o URL immagine del cliente",
+      "placeholder": "Inserisci URL immagine..."
+    }
+  },
+  "actions": {
+    "create": "Crea Cliente",
+    "edit": "Modifica Cliente",
+    "delete": "Elimina Cliente",
+    "view": "Visualizza Cliente",
+    "list": "Elenca Clienti",
+    "search": "Cerca Clienti",
+    "export": "Esporta Clienti",
+    "import": "Importa Clienti"
+  },
+  "messages": {
+    "created": "Cliente creato con successo",
+    "updated": "Cliente aggiornato con successo",
+    "deleted": "Cliente eliminato con successo",
+    "notFound": "Cliente non trovato",
+    "error": "Si è verificato un errore durante l'elaborazione del cliente"
+  }
+}

package/templates/contents/themes/default/entities/customers/messages/pt.json

@@ -0,0 +1,66 @@
+{
+  "entity": {
+    "name": "Cliente",
+    "plural": "Clientes",
+    "description": "Gerencie seus clientes e suas informações"
+  },
+  "fields": {
+    "office": {
+      "label": "Escritório",
+      "description": "Escritório ou filial do cliente",
+      "placeholder": "Digite o escritório..."
+    },
+    "number": {
+      "label": "Número do Cliente",
+      "description": "Identificador único do cliente",
+      "placeholder": "Digite o número do cliente..."
+    },
+    "name": {
+      "label": "Nome",
+      "description": "Nome do cliente",
+      "placeholder": "Digite o nome do cliente..."
+    },
+    "phone": {
+      "label": "Telefone",
+      "description": "Número de telefone do cliente",
+      "placeholder": "Digite o número de telefone..."
+    },
+    "salesRep": {
+      "label": "Representante de Vendas",
+      "description": "Representante de vendas atribuído",
+      "placeholder": "Digite o representante de vendas..."
+    },
+    "visitDays": {
+      "label": "Dias de Visita",
+      "description": "Dias de visita agendados",
+      "placeholder": "Digite os dias de visita..."
+    },
+    "contactDays": {
+      "label": "Dias de Contato",
+      "description": "Dias preferidos de contato",
+      "placeholder": "Digite os dias de contato..."
+    },
+    "image": {
+      "label": "Imagem",
+      "description": "Logo ou URL da imagem do cliente",
+      "placeholder": "Digite a URL da imagem..."
+    }
+  },
+  "actions": {
+    "create": "Criar Cliente",
+    "edit": "Editar Cliente",
+    "delete": "Excluir Cliente",
+    "view": "Visualizar Cliente",
+    "list": "Listar Clientes",
+    "search": "Buscar Clientes",
+    "export": "Exportar Clientes",
+    "import": "Importar Clientes"
+  },
+  "messages": {
+    "created": "Cliente criado com sucesso",
+    "updated": "Cliente atualizado com sucesso",
+    "deleted": "Cliente excluído com sucesso",
+    "notFound": "Cliente não encontrado",
+    "error": "Ocorreu um erro ao processar o cliente"
+  }
+}

package/templates/contents/themes/default/entities/pages/messages/de.json

@@ -0,0 +1,41 @@
+{
+  "entity": {
+    "singular": "Seite",
+    "plural": "Seiten"
+  },
+  "fields": {
+    "title": {
+      "label": "Titel",
+      "placeholder": "Seitentitel eingeben...",
+      "description": "Seitentitel im Browser und in der Navigation angezeigt"
+    },
+    "slug": {
+      "label": "Slug",
+      "placeholder": "seiten-slug",
+      "description": "URL-freundliche Kennung (z.B. 'ueber-uns' für /ueber-uns)"
+    },
+    "status": {
+      "label": "Status",
+      "description": "Veröffentlichungsstatus",
+      "options": {
+        "draft": "Entwurf",
+        "published": "Veröffentlicht",
+        "scheduled": "Geplant",
+        "archived": "Archiviert"
+      }
+    }
+  },
+  "actions": {
+    "create": "Seite erstellen",
+    "edit": "Seite bearbeiten",
+    "delete": "Seite löschen",
+    "publish": "Veröffentlichen",
+    "unpublish": "Veröffentlichung aufheben"
+  },
+  "messages": {
+    "created": "Seite erfolgreich erstellt",
+    "updated": "Seite erfolgreich aktualisiert",
+    "deleted": "Seite erfolgreich gelöscht",
+    "published": "Seite erfolgreich veröffentlicht"
+  }
+}

package/templates/contents/themes/default/entities/pages/messages/fr.json

@@ -0,0 +1,41 @@
+{
+  "entity": {
+    "singular": "Page",
+    "plural": "Pages"
+  },
+  "fields": {
+    "title": {
+      "label": "Titre",
+      "placeholder": "Entrez le titre de la page...",
+      "description": "Titre de la page affiché dans le navigateur et la navigation"
+    },
+    "slug": {
+      "label": "Identifiant",
+      "placeholder": "identifiant-page",
+      "description": "Identifiant adapté pour l'URL (ex : 'a-propos' pour /a-propos)"
+    },
+    "status": {
+      "label": "Statut",
+      "description": "Statut de publication",
+      "options": {
+        "draft": "Brouillon",
+        "published": "Publié",
+        "scheduled": "Programmé",
+        "archived": "Archivé"
+      }
+    }
+  },
+  "actions": {
+    "create": "Créer une page",
+    "edit": "Modifier la page",
+    "delete": "Supprimer la page",
+    "publish": "Publier",
+    "unpublish": "Dépublier"
+  },
+  "messages": {
+    "created": "Page créée avec succès",
+    "updated": "Page mise à jour avec succès",
+    "deleted": "Page supprimée avec succès",
+    "published": "Page publiée avec succès"
+  }
+}

package/templates/contents/themes/default/entities/pages/messages/it.json

@@ -0,0 +1,41 @@
+{
+  "entity": {
+    "singular": "Pagina",
+    "plural": "Pagine"
+  },
+  "fields": {
+    "title": {
+      "label": "Titolo",
+      "placeholder": "Inserisci titolo pagina...",
+      "description": "Titolo della pagina visualizzato nel browser e nella navigazione"
+    },
+    "slug": {
+      "label": "Slug",
+      "placeholder": "slug-pagina",
+      "description": "Identificativo URL-friendly (es. 'chi-siamo' per /chi-siamo)"
+    },
+    "status": {
+      "label": "Stato",
+      "description": "Stato di pubblicazione",
+      "options": {
+        "draft": "Bozza",
+        "published": "Pubblicato",
+        "scheduled": "Programmato",
+        "archived": "Archiviato"
+      }
+    }
+  },
+  "actions": {
+    "create": "Crea Pagina",
+    "edit": "Modifica Pagina",
+    "delete": "Elimina Pagina",
+    "publish": "Pubblica",
+    "unpublish": "Annulla Pubblicazione"
+  },
+  "messages": {
+    "created": "Pagina creata con successo",
+    "updated": "Pagina aggiornata con successo",
+    "deleted": "Pagina eliminata con successo",
+    "published": "Pagina pubblicata con successo"
+  }
+}

package/templates/contents/themes/default/entities/pages/messages/pt.json

@@ -0,0 +1,41 @@
+{
+  "entity": {
+    "singular": "Página",
+    "plural": "Páginas"
+  },
+  "fields": {
+    "title": {
+      "label": "Título",
+      "placeholder": "Digite o título da página...",
+      "description": "Título da página exibido no navegador e na navegação"
+    },
+    "slug": {
+      "label": "Slug",
+      "placeholder": "slug-da-pagina",
+      "description": "Identificador amigável para URL (ex: 'sobre' para /sobre)"
+    },
+    "status": {
+      "label": "Status",
+      "description": "Status de publicação",
+      "options": {
+        "draft": "Rascunho",
+        "published": "Publicado",
+        "scheduled": "Agendado",
+        "archived": "Arquivado"
+      }
+    }
+  },
+  "actions": {
+    "create": "Criar Página",
+    "edit": "Editar Página",
+    "delete": "Excluir Página",
+    "publish": "Publicar",
+    "unpublish": "Despublicar"
+  },
+  "messages": {
+    "created": "Página criada com sucesso",
+    "updated": "Página atualizada com sucesso",
+    "deleted": "Página excluída com sucesso",
+    "published": "Página publicada com sucesso"
+  }
+}