@verbaly/compiler 0.17.0 → 0.19.0

package/dist/index.d.ts

@@ -133,7 +133,11 @@ declare function formatCheckResult(result: CheckResult): string;
 //#endregion
 //#region src/codegen.d.ts
 declare const VIRTUAL_ID = "virtual:verbaly";
-declare function generateRuntimeModule(cfg: ResolvedConfig): string;
+interface RuntimeModuleOptions {
+  localeImport?: (locale: string) => string;
+  extraExports?: string;
+}
+declare function generateRuntimeModule(cfg: ResolvedConfig, options?: RuntimeModuleOptions): string;
 declare function generateLocaleModule(catalog: Catalog): string;
 declare function generateDts(entries: Map<string, string>): string;
 declare function writeDts(cfg: ResolvedConfig, entries: Map<string, string>): void;
@@ -289,5 +293,5 @@ interface TransformResult {
 }
 declare function transformCode(code: string, file: string, analysis?: Analysis): TransformResult | null;
 //#endregion
-export { type Alternate, type Analysis, type Catalog, type Catalogs, type CheckResult, type ClaudeProviderOptions, type DoctorEntry, type DoctorResult, type ExchangeFormat, type ExportOptions, type ExportResult, type ExportedFile, type ImportOptions, type ImportResult, type InitOptions, type InitResult, LOCALE_MODULE_PREFIX, MessageRegistry, type MissingEntry, PSEUDO_LOCALE, type ParamType, RESOLVED_VIRTUAL_ID, type RenderConfig, type RenderHtmlOptions, type RenderHtmlResult, type RenderSiteOptions, type RenderSiteResult, type ResolvedConfig, SOURCE_FILE_RE, type SyncResult, type TaggedMessage, type TaggedParam, type TransComponent, type TransformResult, type TranslateConfig, type TranslateOptions, type TranslateProvider, type TranslateRequest, type TranslateResult, type UnknownEntry, type UsedKey, VIRTUAL_ID, type VerbalyConfig, analyze, catalogPath, check, claudeProvider, collectParams, detectBundler, doctor, exportCatalogs, extractProject, findConfigFile, formatCheckResult, generateDts, generateLocaleModule, generateRuntimeModule, importCatalogs, init, isTransformTarget, loadCatalogs, loadConfig, loadConfigFile, loadVirtualModule, parseExchangeFile, pruneCatalogs, pseudoCatalogs, pseudoLocalize, readCatalog, renderHtml, renderParamType, renderSite, resolveConfig, resolveVirtualId, runBuildGate, serializeCatalog, stableKey, structureMatches, syncCatalogs, targetLocales, transformCode, translateCatalogs, writeCatalog, writeDts };
+export { type Alternate, type Analysis, type Catalog, type Catalogs, type CheckResult, type ClaudeProviderOptions, type DoctorEntry, type DoctorResult, type ExchangeFormat, type ExportOptions, type ExportResult, type ExportedFile, type ImportOptions, type ImportResult, type InitOptions, type InitResult, LOCALE_MODULE_PREFIX, MessageRegistry, type MissingEntry, PSEUDO_LOCALE, type ParamType, RESOLVED_VIRTUAL_ID, type RenderConfig, type RenderHtmlOptions, type RenderHtmlResult, type RenderSiteOptions, type RenderSiteResult, type ResolvedConfig, type RuntimeModuleOptions, SOURCE_FILE_RE, type SyncResult, type TaggedMessage, type TaggedParam, type TransComponent, type TransformResult, type TranslateConfig, type TranslateOptions, type TranslateProvider, type TranslateRequest, type TranslateResult, type UnknownEntry, type UsedKey, VIRTUAL_ID, type VerbalyConfig, analyze, catalogPath, check, claudeProvider, collectParams, detectBundler, doctor, exportCatalogs, extractProject, findConfigFile, formatCheckResult, generateDts, generateLocaleModule, generateRuntimeModule, importCatalogs, init, isTransformTarget, loadCatalogs, loadConfig, loadConfigFile, loadVirtualModule, parseExchangeFile, pruneCatalogs, pseudoCatalogs, pseudoLocalize, readCatalog, renderHtml, renderParamType, renderSite, resolveConfig, resolveVirtualId, runBuildGate, serializeCatalog, stableKey, structureMatches, syncCatalogs, targetLocales, transformCode, translateCatalogs, writeCatalog, writeDts };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -409,25 +409,35 @@ function renderParamType(types) {
 //#endregion
 //#region src/codegen.ts
 const VIRTUAL_ID = "virtual:verbaly";
-function generateRuntimeModule(cfg) {
+function generateRuntimeModule(cfg, options = {}) {
+	const importPath = options.localeImport ?? ((locale) => `virtual:verbaly/locale/${locale}`);
 	const others = cfg.locales.filter((locale) => locale !== cfg.sourceLocale);
 	const src = JSON.stringify(cfg.sourceLocale);
-	const loaders = others.map((locale) => `      ${JSON.stringify(locale)}: () => import('${VIRTUAL_ID}/locale/${locale}'),`).join("\n");
+	const loaders = others.map((locale) => `  ${JSON.stringify(locale)}: () => import('${importPath(locale)}'),`).join("\n");
 	return `import { createVerbaly } from 'verbaly';
-import source from '${VIRTUAL_ID}/locale/${cfg.sourceLocale}';
+import source from '${importPath(cfg.sourceLocale)}';
 
 export const sourceLocale = ${src};
 export const locales = ${JSON.stringify(cfg.locales)};
 
+const localeLoaders = {
+${loaders}
+};
+
+// raw catalog access — SSR integrations serialize it across the client boundary
+export async function loadMessages(locale) {
+  if (locale === ${src}) return source;
+  const loader = localeLoaders[locale];
+  return loader ? (await loader()).default : {};
+}
+
 // per-request/per-instance factory (SSR) — the singleton below is browser/SPA-only
 export function createInstance(options) {
   return createVerbaly({
     locale: ${src},
     fallback: ${src},
     messages: { [${src}]: source },
-    loaders: {
-${loaders}
-    },
+    loaders: localeLoaders,
     ...options,
   });
 }
@@ -456,7 +466,7 @@ export async function setLocale(locale) {
   await v.loadLocale(locale);
   v.setLocale(locale);
 }
-`;
+${options.extraExports ?? ""}`;
 }
 function generateLocaleModule(catalog) {
 	return `export default ${JSON.stringify(catalog)};\n`;
@@ -482,6 +492,7 @@ ${lines.join("\n")}
 
   export const sourceLocale: string;
   export const locales: string[];
+  export function loadMessages(locale: string): Promise<Record<string, string>>;
   export function createInstance(
     options?: import('verbaly').VerbalyOptions<VerbalyKey>,
   ): import('verbaly').Verbaly<VerbalyKey>;