@fluenti/solid 0.2.1 → 0.3.1

package/dist/types.d.ts

@@ -1,11 +1,11 @@
 import { Accessor } from 'solid-js';
-import { FluentConfig, Locale, Messages, CompiledMessage, MessageDescriptor, DateFormatOptions, NumberFormatOptions } from '@fluenti/core';
+import { FluentiCoreConfig, Locale, LocalizedString, Messages, CompiledMessage, MessageDescriptor, DateFormatOptions, NumberFormatOptions } from '@fluenti/core';
 /** Chunk loader for lazy locale loading */
 export type ChunkLoader = (locale: string) => Promise<Record<string, CompiledMessage> | {
     default: Record<string, CompiledMessage>;
 }>;
 /** Extended config with lazy locale loading support */
-export interface I18nConfig extends FluentConfig {
+export interface FluentiConfig extends FluentiCoreConfig {
     /** Async chunk loader for lazy locale loading */
     chunkLoader?: ChunkLoader;
     /** Enable lazy locale loading through chunkLoader */
@@ -16,25 +16,25 @@ export interface I18nConfig extends FluentConfig {
     numberFormats?: NumberFormatOptions;
 }
 /** Reactive i18n context holding locale signal and translation utilities */
-export interface I18nContext {
+export interface FluentiContext {
     /** Reactive accessor for the current locale */
     locale(): Locale;
     /** Set the active locale (async when lazy locale loading is enabled) */
     setLocale(locale: Locale): Promise<void>;
     /** Translate a message by id with optional interpolation values */
-    t(id: string | MessageDescriptor, values?: Record<string, unknown>): string;
+    t(id: string | MessageDescriptor, values?: Record<string, unknown>): LocalizedString;
     /** Tagged template form: t`Hello ${name}` */
-    t(strings: TemplateStringsArray, ...exprs: unknown[]): string;
+    t(strings: TemplateStringsArray, ...exprs: unknown[]): LocalizedString;
     /** Merge additional messages into a locale catalog at runtime */
     loadMessages(locale: Locale, messages: Messages): void;
     /** Return all locale codes that have loaded messages */
     getLocales(): Locale[];
     /** Format a date value for the current locale */
-    d(value: Date | number, style?: string): string;
+    d(value: Date | number, style?: string): LocalizedString;
     /** Format a number value for the current locale */
-    n(value: number, style?: string): string;
+    n(value: number, style?: string): LocalizedString;
     /** Format an ICU message string directly (no catalog lookup) */
-    format(message: string, values?: Record<string, unknown>): string;
+    format(message: string, values?: Record<string, unknown>): LocalizedString;
     /** Whether a locale chunk is currently being loaded */
     isLoading: Accessor<boolean>;
     /** Set of locales whose messages have been loaded */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EACV,YAAY,EACZ,MAAM,EACN,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,eAAe,CAAA;AAEtB,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE,CAAC,CAAA;AAE5F,uDAAuD;AACvD,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,iCAAiC;IACjC,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,IAAI,MAAM,CAAA;IAChB,wEAAwE;IACxE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,mEAAmE;IACnE,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;IAC3E,6CAA6C;IAC7C,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAC7D,iEAAiE;IACjE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACtD,wDAAwD;IACxD,UAAU,IAAI,MAAM,EAAE,CAAA;IACtB,iDAAiD;IACjD,CAAC,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC/C,mDAAmD;IACnD,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxC,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAA;IACjE,uDAAuD;IACvD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC5B,qDAAqD;IACrD,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACpC,iEAAiE;IACjE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,KAAK,EACV,iBAAiB,EACjB,MAAM,EACN,eAAe,EACf,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,eAAe,CAAA;AAEtB,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;CAAE,CAAC,CAAA;AAE5F,uDAAuD;AACvD,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,iDAAiD;IACjD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,iCAAiC;IACjC,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,MAAM,IAAI,MAAM,CAAA;IAChB,wEAAwE;IACxE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,mEAAmE;IACnE,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAA;IACpF,6CAA6C;IAC7C,CAAC,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,CAAA;IACtE,iEAAiE;IACjE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAA;IACtD,wDAAwD;IACxD,UAAU,IAAI,MAAM,EAAE,CAAA;IACtB,iDAAiD;IACjD,CAAC,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAAA;IACxD,mDAAmD;IACnD,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAAA;IACjD,gEAAgE;IAChE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAAA;IAC1E,uDAAuD;IACvD,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAC5B,qDAAqD;IACrD,aAAa,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACpC,iEAAiE;IACjE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC"}

package/dist/use-i18n.d.ts

@@ -1,12 +1,8 @@
-import { I18nContext } from './context';
+import { FluentiContext } from './context';
 /**
- * Access the i18n context.
+ * Access the i18n context from the nearest `<I18nProvider>`.
  *
- * Resolution order:
- * 1. Nearest `<I18nProvider>` in the component tree
- * 2. Module-level singleton created by `createI18n()`
- *
- * Throws if neither is available.
+ * Throws if no provider is found in the component tree.
  */
-export declare function useI18n(): I18nContext;
+export declare function useI18n(): FluentiContext;
 //# sourceMappingURL=use-i18n.d.ts.map

package/dist/use-i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-i18n.d.ts","sourceRoot":"","sources":["../src/use-i18n.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,OAAO,IAAI,WAAW,CAerC"}
+{"version":3,"file":"use-i18n.d.ts","sourceRoot":"","sources":["../src/use-i18n.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C;;;;GAIG;AACH,wBAAgB,OAAO,IAAI,cAAc,CASxC"}

package/dist/vite-plugin.cjs

@@ -1,114 +1,3 @@
-let e=require(`@fluenti/vite-plugin`),t=require(`node:path`);var n={generateRuntime(e){let{catalogDir:n,locales:r,sourceLocale:i,defaultBuildLocale:a}=e,o=a||i,s=(0,t.resolve)(process.cwd(),n);return`
-import { createSignal } from 'solid-js'
-import { createStore, reconcile } from 'solid-js/store'
-import __defaultMsgs from '${s}/${o}.js'
-
-const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })
-const [__currentLocale, __setCurrentLocale] = createSignal('${o}')
-const __loadedLocales = new Set(['${o}'])
-const [__loading, __setLoading] = createSignal(false)
-const __cache = new Map()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter(e=>e!==o).map(e=>`  '${e}': () => import('${s}/${e}.js'),`).join(`
-`)}
-}
-
-async function __switchLocale(locale) {
-  if (__loadedLocales.has(locale)) {
-    __setCatalog(reconcile(__cache.get(locale) || __defaultMsgs))
-    __setCurrentLocale(locale)
-    return
-  }
-  __setLoading(true)
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-    __setCatalog(reconcile(mod))
-    __setCurrentLocale(locale)
-  } finally {
-    __setLoading(false)
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__loadedLocales.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.solid')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }
-`},generateRouteRuntime(e){let{catalogDir:n,locales:r,sourceLocale:i,defaultBuildLocale:a}=e,o=a||i,s=(0,t.resolve)(process.cwd(),n);return`
-import { createSignal } from 'solid-js'
-import { createStore, reconcile } from 'solid-js/store'
-import __defaultMsgs from '${s}/${o}.js'
-
-const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })
-const [__currentLocale, __setCurrentLocale] = createSignal('${o}')
-const __loadedLocales = new Set(['${o}'])
-const [__loading, __setLoading] = createSignal(false)
-const __cache = new Map()
-const __loadedRoutes = new Set()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter(e=>e!==o).map(e=>`  '${e}': () => import('${s}/${e}.js'),`).join(`
-`)}
-}
-
-const __routeLoaders = {}
-
-function __registerRouteLoader(routeId, locale, loader) {
-  const key = routeId + ':' + locale
-  __routeLoaders[key] = loader
-}
-
-async function __loadRoute(routeId, locale) {
-  const key = routeId + ':' + (locale || __currentLocale())
-  if (__loadedRoutes.has(key)) return
-  const loader = __routeLoaders[key]
-  if (!loader) return
-  const mod = __normalizeMessages(await loader())
-  __setCatalog(reconcile({ ...__catalog, ...mod }))
-  __loadedRoutes.add(key)
-}
-
-async function __switchLocale(locale) {
-  if (locale === __currentLocale()) return
-  __setLoading(true)
-  try {
-    if (__cache.has(locale)) {
-      __setCatalog(reconcile(__cache.get(locale)))
-    } else {
-      const mod = __normalizeMessages(await __loaders[locale]())
-      __cache.set(locale, mod)
-      __setCatalog(reconcile(mod))
-    }
-    __loadedLocales.add(locale)
-    __setCurrentLocale(locale)
-  } finally {
-    __setLoading(false)
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__cache.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.solid')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }
-`}};function r(t){return(0,e.createFluentiPlugins)({...t,framework:`solid`},[],n)}module.exports=r;
+let e=require(`@fluenti/vite-plugin`);var t=(0,e.createRuntimeGenerator)({imports:`import { createSignal } from 'solid-js'
+import { createStore, reconcile } from 'solid-js/store'`,catalogInit:`const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })`,localeInit:e=>`const [__currentLocale, __setCurrentLocale] = createSignal('${e}')`,loadingInit:`const [__loading, __setLoading] = createSignal(false)`,catalogUpdate:e=>`__setCatalog(reconcile(${e}))`,catalogMerge:e=>`__setCatalog(reconcile({ ...__catalog, ...${e} }))`,localeUpdate:e=>`__setCurrentLocale(${e})`,loadingUpdate:e=>`__setLoading(${e})`,localeRead:`__currentLocale()`,runtimeKey:`fluenti.runtime.solid.v1`});function n(n){return(0,e.createFluentiPlugins)({...n?.config===void 0?{}:{config:n.config},framework:`solid`},[],t)}module.exports=n;
 //# sourceMappingURL=vite-plugin.cjs.map

package/dist/vite-plugin.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.cjs","names":[],"sources":["../src/solid-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { RuntimeGenerator, RuntimeGeneratorOptions } from '@fluenti/vite-plugin'\n\nexport const solidRuntimeGenerator: RuntimeGenerator = {\n  generateRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.solid'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport { createSignal } from 'solid-js'\nimport { createStore, reconcile } from 'solid-js/store'\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })\nconst [__currentLocale, __setCurrentLocale] = createSignal('${defaultLocale}')\nconst __loadedLocales = new Set(['${defaultLocale}'])\nconst [__loading, __setLoading] = createSignal(false)\nconst __cache = new Map()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nasync function __switchLocale(locale) {\n  if (__loadedLocales.has(locale)) {\n    __setCatalog(reconcile(__cache.get(locale) || __defaultMsgs))\n    __setCurrentLocale(locale)\n    return\n  }\n  __setLoading(true)\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n    __setCatalog(reconcile(mod))\n    __setCurrentLocale(locale)\n  } finally {\n    __setLoading(false)\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__loadedLocales.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }\n`\n  },\n\n  generateRouteRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.solid'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport { createSignal } from 'solid-js'\nimport { createStore, reconcile } from 'solid-js/store'\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })\nconst [__currentLocale, __setCurrentLocale] = createSignal('${defaultLocale}')\nconst __loadedLocales = new Set(['${defaultLocale}'])\nconst [__loading, __setLoading] = createSignal(false)\nconst __cache = new Map()\nconst __loadedRoutes = new Set()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nconst __routeLoaders = {}\n\nfunction __registerRouteLoader(routeId, locale, loader) {\n  const key = routeId + ':' + locale\n  __routeLoaders[key] = loader\n}\n\nasync function __loadRoute(routeId, locale) {\n  const key = routeId + ':' + (locale || __currentLocale())\n  if (__loadedRoutes.has(key)) return\n  const loader = __routeLoaders[key]\n  if (!loader) return\n  const mod = __normalizeMessages(await loader())\n  __setCatalog(reconcile({ ...__catalog, ...mod }))\n  __loadedRoutes.add(key)\n}\n\nasync function __switchLocale(locale) {\n  if (locale === __currentLocale()) return\n  __setLoading(true)\n  try {\n    if (__cache.has(locale)) {\n      __setCatalog(reconcile(__cache.get(locale)))\n    } else {\n      const mod = __normalizeMessages(await __loaders[locale]())\n      __cache.set(locale, mod)\n      __setCatalog(reconcile(mod))\n    }\n    __loadedLocales.add(locale)\n    __setCurrentLocale(locale)\n  } finally {\n    __setLoading(false)\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__cache.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }\n`\n  },\n}\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { solidRuntimeGenerator } from './solid-runtime'\n\nexport type { FluentiPluginOptions as FluentiSolidOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiSolid(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...options, framework: 'solid' },\n    [],\n    solidRuntimeGenerator,\n  )\n}\n"],"mappings":"6DAGA,IAAa,EAA0C,CACrD,gBAAgB,EAA0C,CACxD,GAAM,CAAE,aAAY,UAAS,eAAc,sBAAuB,EAC5D,EAAgB,GAAsB,EACtC,GAAA,EAAA,EAAA,SAA6B,QAAQ,KAAK,CAAE,EAAW,CAI7D,MAAO;;;6BAGkB,EAAmB,GAAG,EAAc;;;8DAGH,EAAc;oCACxC,EAAc;;;;;;EAT1B,EAAQ,OAAQ,GAAW,IAAW,EAAc,CAe9D,IAAK,GAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK;EAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoC9F,qBAAqB,EAA0C,CAC7D,GAAM,CAAE,aAAY,UAAS,eAAc,sBAAuB,EAC5D,EAAgB,GAAsB,EACtC,GAAA,EAAA,EAAA,SAA6B,QAAQ,KAAK,CAAE,EAAW,CAI7D,MAAO;;;6BAGkB,EAAmB,GAAG,EAAc;;;8DAGH,EAAc;oCACxC,EAAc;;;;;;;EAT1B,EAAQ,OAAQ,GAAW,IAAW,EAAc,CAgB9D,IAAK,GAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK;EAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoD/F,CC9HD,SAAwB,EAAa,EAA0C,CAC7E,OAAA,EAAA,EAAA,sBACE,CAAE,GAAG,EAAS,UAAW,QAAS,CAClC,EAAE,CACF,EACD"}
+{"version":3,"file":"vite-plugin.cjs","names":[],"sources":["../src/solid-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { createRuntimeGenerator } from '@fluenti/vite-plugin'\nimport type { RuntimeGenerator } from '@fluenti/vite-plugin'\n\nexport const solidRuntimeGenerator: RuntimeGenerator = createRuntimeGenerator({\n  imports: `import { createSignal } from 'solid-js'\\nimport { createStore, reconcile } from 'solid-js/store'`,\n  catalogInit: 'const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })',\n  localeInit: (defaultLocale) => `const [__currentLocale, __setCurrentLocale] = createSignal('${defaultLocale}')`,\n  loadingInit: 'const [__loading, __setLoading] = createSignal(false)',\n  catalogUpdate: (msgs) => `__setCatalog(reconcile(${msgs}))`,\n  catalogMerge: (msgs) => `__setCatalog(reconcile({ ...__catalog, ...${msgs} }))`,\n  localeUpdate: (locale) => `__setCurrentLocale(${locale})`,\n  loadingUpdate: (value) => `__setLoading(${value})`,\n  localeRead: '__currentLocale()',\n  runtimeKey: 'fluenti.runtime.solid.v1',\n})\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { solidRuntimeGenerator } from './solid-runtime'\n\nexport type { FluentiPluginOptions as FluentiSolidOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiSolid(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...(options?.config !== undefined ? { config: options.config } : {}), framework: 'solid' },\n    [],\n    solidRuntimeGenerator,\n  )\n}\n"],"mappings":"sCAGA,IAAa,GAAA,EAAA,EAAA,wBAAiE,CAC5E,QAAS;yDACT,YAAa,sEACb,WAAa,GAAkB,+DAA+D,EAAc,IAC5G,YAAa,wDACb,cAAgB,GAAS,0BAA0B,EAAK,IACxD,aAAe,GAAS,6CAA6C,EAAK,MAC1E,aAAe,GAAW,sBAAsB,EAAO,GACvD,cAAgB,GAAU,gBAAgB,EAAM,GAChD,WAAY,oBACZ,WAAY,2BACb,CAAC,CCPF,SAAwB,EAAa,EAA0C,CAC7E,OAAA,EAAA,EAAA,sBACE,CAAE,GAAI,GAAS,SAAW,IAAA,GAAyC,EAAE,CAA/B,CAAE,OAAQ,EAAQ,OAAQ,CAAQ,UAAW,QAAS,CAC5F,EAAE,CACF,EACD"}

package/dist/vite-plugin.js

@@ -1,131 +1,22 @@
-import { createFluentiPlugins as e } from "@fluenti/vite-plugin";
-import { resolve as t } from "node:path";
+import { createFluentiPlugins as e, createRuntimeGenerator as t } from "@fluenti/vite-plugin";
 //#region src/solid-runtime.ts
-var n = {
-	generateRuntime(e) {
-		let { catalogDir: n, locales: r, sourceLocale: i, defaultBuildLocale: a } = e, o = a || i, s = t(process.cwd(), n);
-		return `
-import { createSignal } from 'solid-js'
-import { createStore, reconcile } from 'solid-js/store'
-import __defaultMsgs from '${s}/${o}.js'
-
-const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })
-const [__currentLocale, __setCurrentLocale] = createSignal('${o}')
-const __loadedLocales = new Set(['${o}'])
-const [__loading, __setLoading] = createSignal(false)
-const __cache = new Map()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter((e) => e !== o).map((e) => `  '${e}': () => import('${s}/${e}.js'),`).join("\n")}
-}
-
-async function __switchLocale(locale) {
-  if (__loadedLocales.has(locale)) {
-    __setCatalog(reconcile(__cache.get(locale) || __defaultMsgs))
-    __setCurrentLocale(locale)
-    return
-  }
-  __setLoading(true)
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-    __setCatalog(reconcile(mod))
-    __setCurrentLocale(locale)
-  } finally {
-    __setLoading(false)
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__loadedLocales.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.solid')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }
-`;
-	},
-	generateRouteRuntime(e) {
-		let { catalogDir: n, locales: r, sourceLocale: i, defaultBuildLocale: a } = e, o = a || i, s = t(process.cwd(), n);
-		return `
-import { createSignal } from 'solid-js'
-import { createStore, reconcile } from 'solid-js/store'
-import __defaultMsgs from '${s}/${o}.js'
-
-const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })
-const [__currentLocale, __setCurrentLocale] = createSignal('${o}')
-const __loadedLocales = new Set(['${o}'])
-const [__loading, __setLoading] = createSignal(false)
-const __cache = new Map()
-const __loadedRoutes = new Set()
-const __normalizeMessages = (mod) => mod.default ?? mod
-
-const __loaders = {
-${r.filter((e) => e !== o).map((e) => `  '${e}': () => import('${s}/${e}.js'),`).join("\n")}
-}
-
-const __routeLoaders = {}
-
-function __registerRouteLoader(routeId, locale, loader) {
-  const key = routeId + ':' + locale
-  __routeLoaders[key] = loader
-}
-
-async function __loadRoute(routeId, locale) {
-  const key = routeId + ':' + (locale || __currentLocale())
-  if (__loadedRoutes.has(key)) return
-  const loader = __routeLoaders[key]
-  if (!loader) return
-  const mod = __normalizeMessages(await loader())
-  __setCatalog(reconcile({ ...__catalog, ...mod }))
-  __loadedRoutes.add(key)
-}
-
-async function __switchLocale(locale) {
-  if (locale === __currentLocale()) return
-  __setLoading(true)
-  try {
-    if (__cache.has(locale)) {
-      __setCatalog(reconcile(__cache.get(locale)))
-    } else {
-      const mod = __normalizeMessages(await __loaders[locale]())
-      __cache.set(locale, mod)
-      __setCatalog(reconcile(mod))
-    }
-    __loadedLocales.add(locale)
-    __setCurrentLocale(locale)
-  } finally {
-    __setLoading(false)
-  }
-}
-
-async function __preloadLocale(locale) {
-  if (__cache.has(locale) || !__loaders[locale]) return
-  try {
-    const mod = __normalizeMessages(await __loaders[locale]())
-    __cache.set(locale, mod)
-    __loadedLocales.add(locale)
-  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }
-}
-
-globalThis[Symbol.for('fluenti.runtime.solid')] = { __switchLocale, __preloadLocale }
-
-export { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }
-`;
-	}
-};
+var n = t({
+	imports: "import { createSignal } from 'solid-js'\nimport { createStore, reconcile } from 'solid-js/store'",
+	catalogInit: "const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })",
+	localeInit: (e) => `const [__currentLocale, __setCurrentLocale] = createSignal('${e}')`,
+	loadingInit: "const [__loading, __setLoading] = createSignal(false)",
+	catalogUpdate: (e) => `__setCatalog(reconcile(${e}))`,
+	catalogMerge: (e) => `__setCatalog(reconcile({ ...__catalog, ...${e} }))`,
+	localeUpdate: (e) => `__setCurrentLocale(${e})`,
+	loadingUpdate: (e) => `__setLoading(${e})`,
+	localeRead: "__currentLocale()",
+	runtimeKey: "fluenti.runtime.solid.v1"
+});
 //#endregion
 //#region src/vite-plugin.ts
 function r(t) {
 	return e({
-		...t,
+		...t?.config === void 0 ? {} : { config: t.config },
 		framework: "solid"
 	}, [], n);
 }

package/dist/vite-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin.js","names":[],"sources":["../src/solid-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport type { RuntimeGenerator, RuntimeGeneratorOptions } from '@fluenti/vite-plugin'\n\nexport const solidRuntimeGenerator: RuntimeGenerator = {\n  generateRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.solid'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport { createSignal } from 'solid-js'\nimport { createStore, reconcile } from 'solid-js/store'\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })\nconst [__currentLocale, __setCurrentLocale] = createSignal('${defaultLocale}')\nconst __loadedLocales = new Set(['${defaultLocale}'])\nconst [__loading, __setLoading] = createSignal(false)\nconst __cache = new Map()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nasync function __switchLocale(locale) {\n  if (__loadedLocales.has(locale)) {\n    __setCatalog(reconcile(__cache.get(locale) || __defaultMsgs))\n    __setCurrentLocale(locale)\n    return\n  }\n  __setLoading(true)\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n    __setCatalog(reconcile(mod))\n    __setCurrentLocale(locale)\n  } finally {\n    __setLoading(false)\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__loadedLocales.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __currentLocale, __loading, __loadedLocales }\n`\n  },\n\n  generateRouteRuntime(options: RuntimeGeneratorOptions): string {\n    const { catalogDir, locales, sourceLocale, defaultBuildLocale } = options\n    const defaultLocale = defaultBuildLocale || sourceLocale\n    const absoluteCatalogDir = resolve(process.cwd(), catalogDir)\n    const runtimeKey = 'fluenti.runtime.solid'\n    const lazyLocales = locales.filter((locale) => locale !== defaultLocale)\n\n    return `\nimport { createSignal } from 'solid-js'\nimport { createStore, reconcile } from 'solid-js/store'\nimport __defaultMsgs from '${absoluteCatalogDir}/${defaultLocale}.js'\n\nconst [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })\nconst [__currentLocale, __setCurrentLocale] = createSignal('${defaultLocale}')\nconst __loadedLocales = new Set(['${defaultLocale}'])\nconst [__loading, __setLoading] = createSignal(false)\nconst __cache = new Map()\nconst __loadedRoutes = new Set()\nconst __normalizeMessages = (mod) => mod.default ?? mod\n\nconst __loaders = {\n${lazyLocales.map((l) => `  '${l}': () => import('${absoluteCatalogDir}/${l}.js'),`).join('\\n')}\n}\n\nconst __routeLoaders = {}\n\nfunction __registerRouteLoader(routeId, locale, loader) {\n  const key = routeId + ':' + locale\n  __routeLoaders[key] = loader\n}\n\nasync function __loadRoute(routeId, locale) {\n  const key = routeId + ':' + (locale || __currentLocale())\n  if (__loadedRoutes.has(key)) return\n  const loader = __routeLoaders[key]\n  if (!loader) return\n  const mod = __normalizeMessages(await loader())\n  __setCatalog(reconcile({ ...__catalog, ...mod }))\n  __loadedRoutes.add(key)\n}\n\nasync function __switchLocale(locale) {\n  if (locale === __currentLocale()) return\n  __setLoading(true)\n  try {\n    if (__cache.has(locale)) {\n      __setCatalog(reconcile(__cache.get(locale)))\n    } else {\n      const mod = __normalizeMessages(await __loaders[locale]())\n      __cache.set(locale, mod)\n      __setCatalog(reconcile(mod))\n    }\n    __loadedLocales.add(locale)\n    __setCurrentLocale(locale)\n  } finally {\n    __setLoading(false)\n  }\n}\n\nasync function __preloadLocale(locale) {\n  if (__cache.has(locale) || !__loaders[locale]) return\n  try {\n    const mod = __normalizeMessages(await __loaders[locale]())\n    __cache.set(locale, mod)\n    __loadedLocales.add(locale)\n  } catch (e) { console.warn('[fluenti] preload failed:', locale, e) }\n}\n\nglobalThis[Symbol.for('${runtimeKey}')] = { __switchLocale, __preloadLocale }\n\nexport { __catalog, __switchLocale, __preloadLocale, __loadRoute, __registerRouteLoader, __currentLocale, __loading, __loadedLocales }\n`\n  },\n}\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { solidRuntimeGenerator } from './solid-runtime'\n\nexport type { FluentiPluginOptions as FluentiSolidOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiSolid(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...options, framework: 'solid' },\n    [],\n    solidRuntimeGenerator,\n  )\n}\n"],"mappings":";;;AAGA,IAAa,IAA0C;CACrD,gBAAgB,GAA0C;EACxD,IAAM,EAAE,eAAY,YAAS,iBAAc,0BAAuB,GAC5D,IAAgB,KAAsB,GACtC,IAAqB,EAAQ,QAAQ,KAAK,EAAE,EAAW;AAI7D,SAAO;;;6BAGkB,EAAmB,GAAG,EAAc;;;8DAGH,EAAc;oCACxC,EAAc;;;;;;EAT1B,EAAQ,QAAQ,MAAW,MAAW,EAAc,CAe9D,KAAK,MAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC9F,qBAAqB,GAA0C;EAC7D,IAAM,EAAE,eAAY,YAAS,iBAAc,0BAAuB,GAC5D,IAAgB,KAAsB,GACtC,IAAqB,EAAQ,QAAQ,KAAK,EAAE,EAAW;AAI7D,SAAO;;;6BAGkB,EAAmB,GAAG,EAAc;;;8DAGH,EAAc;oCACxC,EAAc;;;;;;;EAT1B,EAAQ,QAAQ,MAAW,MAAW,EAAc,CAgB9D,KAAK,MAAM,MAAM,EAAE,mBAAmB,EAAmB,GAAG,EAAE,QAAQ,CAAC,KAAK,KAAK,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoD/F;;;AC9HD,SAAwB,EAAa,GAA0C;AAC7E,QAAO,EACL;EAAE,GAAG;EAAS,WAAW;EAAS,EAClC,EAAE,EACF,EACD"}
+{"version":3,"file":"vite-plugin.js","names":[],"sources":["../src/solid-runtime.ts","../src/vite-plugin.ts"],"sourcesContent":["import { createRuntimeGenerator } from '@fluenti/vite-plugin'\nimport type { RuntimeGenerator } from '@fluenti/vite-plugin'\n\nexport const solidRuntimeGenerator: RuntimeGenerator = createRuntimeGenerator({\n  imports: `import { createSignal } from 'solid-js'\\nimport { createStore, reconcile } from 'solid-js/store'`,\n  catalogInit: 'const [__catalog, __setCatalog] = createStore({ ...__defaultMsgs })',\n  localeInit: (defaultLocale) => `const [__currentLocale, __setCurrentLocale] = createSignal('${defaultLocale}')`,\n  loadingInit: 'const [__loading, __setLoading] = createSignal(false)',\n  catalogUpdate: (msgs) => `__setCatalog(reconcile(${msgs}))`,\n  catalogMerge: (msgs) => `__setCatalog(reconcile({ ...__catalog, ...${msgs} }))`,\n  localeUpdate: (locale) => `__setCurrentLocale(${locale})`,\n  loadingUpdate: (value) => `__setLoading(${value})`,\n  localeRead: '__currentLocale()',\n  runtimeKey: 'fluenti.runtime.solid.v1',\n})\n","import type { Plugin } from 'vite'\nimport type { FluentiPluginOptions } from '@fluenti/vite-plugin'\nimport { createFluentiPlugins } from '@fluenti/vite-plugin'\nimport { solidRuntimeGenerator } from './solid-runtime'\n\nexport type { FluentiPluginOptions as FluentiSolidOptions } from '@fluenti/vite-plugin'\n\nexport default function fluentiSolid(options?: FluentiPluginOptions): Plugin[] {\n  return createFluentiPlugins(\n    { ...(options?.config !== undefined ? { config: options.config } : {}), framework: 'solid' },\n    [],\n    solidRuntimeGenerator,\n  )\n}\n"],"mappings":";;AAGA,IAAa,IAA0C,EAAuB;CAC5E,SAAS;CACT,aAAa;CACb,aAAa,MAAkB,+DAA+D,EAAc;CAC5G,aAAa;CACb,gBAAgB,MAAS,0BAA0B,EAAK;CACxD,eAAe,MAAS,6CAA6C,EAAK;CAC1E,eAAe,MAAW,sBAAsB,EAAO;CACvD,gBAAgB,MAAU,gBAAgB,EAAM;CAChD,YAAY;CACZ,YAAY;CACb,CAAC;;;ACPF,SAAwB,EAAa,GAA0C;AAC7E,QAAO,EACL;EAAE,GAAI,GAAS,WAAW,KAAA,IAAyC,EAAE,GAA/B,EAAE,QAAQ,EAAQ,QAAQ;EAAQ,WAAW;EAAS,EAC5F,EAAE,EACF,EACD"}

package/llms-full.txt

@@ -0,0 +1,186 @@
+# @fluenti/solid
+
+> SolidJS bindings for Fluenti — compile-time `t`, runtime-capable components, and signal-based locale switching.
+
+@fluenti/solid is the Solid runtime layer for Fluenti. It supports:
+
+- compile-time authoring with `import { t } from '@fluenti/solid'`
+- runtime lookup and imperative APIs through `useI18n()`
+- signal-driven locale reactivity
+- runtime-capable components that keep working without the build plugin
+
+## Install
+
+```bash
+pnpm add @fluenti/core @fluenti/solid @fluenti/vite-plugin
+```
+
+## Public Exports
+
+- `createFluentiContext`
+- `I18nProvider`
+- `useI18n`
+- `t`
+- `Trans`
+- `Plural`
+- `Select`
+- `DateTime`
+- `NumberFormat`
+- `msg`
+
+Types:
+
+- `FluentiContext`
+- `FluentiConfig`
+- `FluentiTransProps`
+- `FluentiPluralProps`
+- `FluentiSelectProps`
+
+## Context model
+
+### `createFluentiContext(config)`
+
+Creates an isolated reactive context backed by Solid signals. This is the factory used internally by `<I18nProvider>` and can also be used directly for advanced setups.
+
+### `I18nProvider`
+
+Creates and provides the nearest Solid context boundary for its subtree.
+
+### `useI18n()`
+
+Returns the context from the nearest `<I18nProvider>`. Throws if no provider is found.
+
+This is the public runtime API for translations, locale switching, and formatting.
+
+## Example
+
+```tsx
+import { render } from 'solid-js/web'
+import { I18nProvider, useI18n, t } from '@fluenti/solid'
+
+function Greeting() {
+  const name = 'Fluenti'
+  const headline = t`Hello ${name}`
+  const { setLocale, preloadLocale } = useI18n()
+
+  return (
+    <>
+      <h1>{headline}</h1>
+      <button onMouseEnter={() => preloadLocale('ja')} onClick={() => void setLocale('ja')}>
+        日本語
+      </button>
+    </>
+  )
+}
+
+render(() => (
+  <I18nProvider locale="en" messages={{ en, ja }}>
+    <Greeting />
+  </I18nProvider>
+), document.getElementById('root')!)
+```
+
+## `I18nConfig`
+
+`I18nConfig` extends the core config with Solid-specific lazy-loading support:
+
+```ts
+{
+  locale: 'en',
+  messages: { en },
+  fallbackLocale: 'en',
+  fallbackChain: { ja: ['en'] },
+  lazyLocaleLoading: true,
+  chunkLoader: (locale) => import(`./locales/compiled/${locale}.js`),
+  dateFormats: { short: { dateStyle: 'medium' } },
+  numberFormats: { currency: { style: 'currency', currency: 'USD' } },
+}
+```
+
+Fields added on top of the core runtime:
+
+- `lazyLocaleLoading?: boolean`
+- `chunkLoader?: (locale) => Promise<Messages | { default: Messages }>`
+- `fallbackChain?`
+- `dateFormats?`
+- `numberFormats?`
+
+## `useI18n()` return shape
+
+- `locale(): string`
+- `setLocale(locale): Promise<void>`
+- `t(idOrDescriptor, values?)`
+- tagged-template `t\`\``
+- `d(value, style?)`
+- `n(value, style?)`
+- `format(message, values?)`
+- `loadMessages(locale, messages)`
+- `getLocales()`
+- `isLoading()`
+- `loadedLocales()`
+- `te(key, locale?)`
+- `tm(key, locale?)`
+- `preloadLocale(locale)`
+
+Any reactive computation that reads `t()` re-runs when `locale()` changes.
+
+## Compile-time `t`
+
+Imported `t` is compile-time only:
+
+```ts
+import { t } from '@fluenti/solid'
+
+const title = t`Hello ${name}`                                   // ✅ Preferred
+const label = t({ message: 'Hello {name}', context: 'home.hero' }, { name }) // ✅ Preferred
+```
+
+Use `useI18n().t()` for runtime lookup by ID or other imperative scenarios.
+
+If imported `t` runs at runtime without the build plugin, it throws a clear error.
+
+## Runtime-capable components
+
+These components continue to work without the build plugin:
+
+- `Trans`
+- `Plural`
+- `Select`
+- `DateTime`
+- `NumberFormat`
+
+Cross-framework contract highlights:
+
+- `Plural` supports `id`, `context`, `comment`, and `offset`
+- `zero` maps to exact `=0`
+- `#` uses the adjusted count
+- `Select` supports `options`, which take precedence over direct case props
+
+## Lazy locale loading
+
+```tsx
+<I18nProvider
+  locale="en"
+  messages={{ en }}
+  lazyLocaleLoading={true}
+  chunkLoader={(locale) => import(`./locales/compiled/${locale}.js`)}
+>
+  <App />
+</I18nProvider>
+```
+
+Behavior:
+
+- default locale can be loaded eagerly
+- additional locales load on demand
+- `setLocale()` becomes async when a chunk must be fetched
+- `preloadLocale()` fetches a locale without switching
+
+## Build plugin relationship
+
+`@fluenti/solid` is the runtime layer. `@fluenti/vite-plugin` provides compile-time transforms for:
+
+- direct-import `t`
+- JSX component optimizations
+
+The component layer remains runtime-correct without the plugin.