@fluenti/vite-plugin 0.2.1 → 0.3.0

package/dist/types.d.ts

@@ -1,55 +1,17 @@
-/** Options passed to RuntimeGenerator methods */
-export interface RuntimeGeneratorOptions {
-    catalogDir: string;
-    locales: string[];
-    sourceLocale: string;
-    defaultBuildLocale: string;
-}
-/** Framework-specific virtual module runtime generator */
-export interface RuntimeGenerator {
-    /** Generate the main reactive runtime module (virtual:fluenti/runtime) */
-    generateRuntime(options: RuntimeGeneratorOptions): string;
-    /** Generate the per-route runtime module (virtual:fluenti/route-runtime) */
-    generateRouteRuntime(options: RuntimeGeneratorOptions): string;
-}
+import { FluentiBuildConfig } from '@fluenti/core/internal';
+export type { RuntimeGeneratorOptions, RuntimeGenerator } from '@fluenti/core/transform';
+/** Custom message ID generator function */
+export type IdGenerator = (message: string, context?: string) => string;
 /** User-facing plugin options (framework packages expose this to consumers) */
 export interface FluentiPluginOptions {
-    /** Directory containing compiled message catalogs */
-    catalogDir?: string;
-    /** Source locale */
-    sourceLocale?: string;
-    /** Available locales */
-    locales?: string[];
-    /** Code splitting strategy: 'dynamic' (reactive catalog), 'static' (direct imports), false (off) */
-    splitting?: 'dynamic' | 'static' | false;
-    /** Default locale for build-time static strategy */
-    defaultBuildLocale?: string;
-    /** Source file patterns for auto extract in dev */
-    include?: string[];
-    /** Auto extract+compile in dev mode (default: true) */
-    devAutoCompile?: boolean;
-    /** Auto extract+compile before production build (default: true) */
-    buildAutoCompile?: boolean;
+    /** fluenti.config.ts path or inline config. Auto-discovered by default. */
+    config?: string | FluentiBuildConfig;
 }
 /** Internal options used by createFluentiPlugins (includes required framework field) */
 export interface FluentiCoreOptions {
-    /** Directory containing compiled message catalogs */
-    catalogDir?: string | undefined;
-    /** Source locale */
-    sourceLocale?: string | undefined;
-    /** Available locales */
-    locales?: string[] | undefined;
-    /** Code splitting strategy: 'dynamic' (reactive catalog), 'static' (direct imports), false (off) */
-    splitting?: 'dynamic' | 'static' | false | undefined;
-    /** Default locale for build-time static strategy */
-    defaultBuildLocale?: string | undefined;
-    /** Source file patterns for auto extract in dev */
-    include?: string[] | undefined;
-    /** Auto extract+compile in dev mode (default: true) */
-    devAutoCompile?: boolean | undefined;
-    /** Auto extract+compile before production build (default: true) */
-    buildAutoCompile?: boolean | undefined;
-    /** Framework identifier for scope transform and runtime key */
-    framework: 'vue' | 'solid' | 'react';
+    /** fluenti.config.ts path or inline config. Auto-discovered by default. */
+    config?: string | FluentiBuildConfig;
+    /** Framework identifier for scope transform and runtime key (e.g. 'vue', 'solid', 'react', 'svelte') */
+    framework: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,eAAe,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAA;IACzD,4EAA4E;IAC5E,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAA;CAC/D;AAED,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oGAAoG;IACpG,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAA;IACxC,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,oBAAoB;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,oGAAoG;IACpG,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAA;IACpD,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,+DAA+D;IAC/D,SAAS,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAEhE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAExF,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAEvE,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAA;CACrC;AAED,wFAAwF;AACxF,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAAA;IACpC,wGAAwG;IACxG,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/dist/virtual-modules.d.ts

@@ -1,10 +1,12 @@
 import { RuntimeGenerator } from './types';
 export interface VirtualModuleOptions {
+    rootDir: string;
     catalogDir: string;
+    catalogExtension: string;
     locales: string[];
     sourceLocale: string;
     defaultBuildLocale: string;
-    framework: 'vue' | 'solid' | 'react';
+    framework: string;
     runtimeGenerator?: RuntimeGenerator | undefined;
 }
 export declare function resolveVirtualSplitId(id: string): string | undefined;

package/dist/virtual-modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"virtual-modules.d.ts","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,SAAS,CAAA;AASxE,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;IACpC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CAChD;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpE;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,SAAS,CAWpB;AAwBD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAYhF"}
+{"version":3,"file":"virtual-modules.d.ts","sourceRoot":"","sources":["../src/virtual-modules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,SAAS,CAAA;AA8BxE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAA;CAChD;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpE;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,oBAAoB,GAC5B,MAAM,GAAG,SAAS,CAWpB;AA0BD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAYhF"}

package/llms-full.txt

@@ -0,0 +1,124 @@
+# @fluenti/vite-plugin
+
+> Internal Vite plugin core for Fluenti — provides `createFluentiPlugins()` factory used by framework packages.
+
+Docs: https://fluenti.dev
+GitHub: https://github.com/usefluenti/fluenti/tree/main/packages/vite-plugin
+License: MIT
+
+## This is an internal package
+
+Users should NOT install `@fluenti/vite-plugin` directly. It is automatically installed as a dependency of the framework packages. Use framework subpath exports instead:
+
+```ts
+// Vue — vite.config.ts
+import fluentiVue from '@fluenti/vue/vite-plugin'
+export default { plugins: [vue(), fluentiVue()] }
+
+// React — vite.config.ts
+import fluentiReact from '@fluenti/react/vite-plugin'
+export default { plugins: [fluentiReact(), react()] }
+
+// Solid — vite.config.ts
+import fluentiSolid from '@fluenti/solid/vite-plugin'
+export default { plugins: [solidPlugin(), fluentiSolid()] }
+```
+
+Peer dependency: `vite ^5 || ^6 || ^8`
+Runtime dependency: `@fluenti/core`
+
+## Public Options
+
+All framework plugins accept the same `FluentiPluginOptions`:
+
+```ts
+interface FluentiPluginOptions {
+  catalogDir?: string        // default: 'src/locales/compiled'
+  sourceLocale?: string      // default: 'en'
+  locales?: string[]         // default: [sourceLocale]
+  splitting?: 'dynamic' | 'static' | false  // default: false
+  defaultBuildLocale?: string // default: sourceLocale
+  include?: string[]         // default: ['src/**/*.{vue,tsx,jsx,ts,js}']
+  devAutoCompile?: boolean   // default: true
+}
+```
+
+## Architecture
+
+`@fluenti/vite-plugin` provides a `createFluentiPlugins()` factory that assembles the Vite plugin pipeline:
+
+1. `fluenti:virtual` — resolves virtual modules (`virtual:fluenti/messages/*`, `virtual:fluenti/runtime`)
+2. Framework-specific plugins (injected by the calling framework package)
+3. `fluenti:script-transform` — AST-based `t`` ` tagged template and `<Trans>` compile-time transforms
+4. `fluenti:build-split` — build-time code splitting (dynamic/static/per-route)
+5. `fluenti:dev` — dev-mode auto-compile + HMR for catalog changes
+
+Framework packages provide:
+- A `RuntimeGenerator` that generates framework-specific reactive runtime code (Vue uses `shallowReactive`, Solid uses `createStore`, React uses plain objects)
+- Framework-specific plugins (e.g., Vue's `v-t` template transform)
+
+## What The Plugin Transforms
+
+### direct-import `t`
+
+```ts
+import { t } from '@fluenti/react'
+t`Hello ${name}`
+t({ message: 'Hello {name}', context: 'home.hero' }, { name })
+```
+
+Rewritten to framework runtime `t` binding with stable IDs.
+
+### `useI18n().t`
+
+```ts
+const { t } = useI18n()
+const { t: translate } = useI18n()
+```
+
+Runtime APIs that also participate in build-time chunk planning.
+
+### Vue template features (via `@fluenti/vue/vite-plugin`)
+
+- `v-t` directive
+- `v-t.plural`, `.alt`, `.placeholder`, `.title` modifiers
+- `<Trans>`, `<Plural>`, `<Select>` components
+
+### JSX components (React & Solid)
+
+`<Trans>`, `<Plural>`, and `<Select>` message usage collected for chunk splitting.
+
+## Chunk Splitting
+
+### `'dynamic'`
+
+- Default locale in initial bundle
+- Non-default locales loaded on demand via `switchLocale()`
+- Transformed lookups read from an internal reactive catalog
+
+### `'static'`
+
+- All lookups rewritten to statically imported catalog entries
+- Ideal for SSR / SSG single-locale builds
+
+### `false`
+
+Disables locale chunk splitting.
+
+## Exports
+
+```ts
+// Named exports only — no default export
+export function createFluentiPlugins(
+  options: FluentiCoreOptions,
+  frameworkPlugins: Plugin[],
+  runtimeGenerator?: RuntimeGenerator,
+): Plugin[]
+
+export type { FluentiPluginOptions }    // user-facing options
+export type { FluentiCoreOptions }      // internal options (includes framework field)
+export type { RuntimeGenerator }        // framework-specific runtime generator
+export type { RuntimeGeneratorOptions } // options passed to generator methods
+```
+
+The `sfc-transform` subpath export provides Vue SFC template transformation utilities used by `@fluenti/vue/vite-plugin`.

package/llms.txt

@@ -0,0 +1,57 @@
+# @fluenti/vite-plugin
+
+> Internal Vite plugin core for Fluenti — provides `createFluentiPlugins()` factory used by framework packages.
+
+Docs: https://fluenti.dev
+GitHub: https://github.com/usefluenti/fluenti/tree/main/packages/vite-plugin
+
+## This is an internal package
+
+Users should NOT install this directly. Instead use framework subpath exports:
+
+```ts
+// Vue
+import fluentiVue from '@fluenti/vue/vite-plugin'
+
+// React
+import fluentiReact from '@fluenti/react/vite-plugin'
+
+// Solid
+import fluentiSolid from '@fluenti/solid/vite-plugin'
+```
+
+## Plugin Options
+
+All framework plugins accept the same `FluentiPluginOptions`:
+
+- `catalogDir`: path to compiled message catalogs (default: `'src/locales/compiled'`)
+- `sourceLocale`: source locale (default: `'en'`)
+- `locales`: available locales (default: `[sourceLocale]`)
+- `splitting`: `'dynamic' | 'static' | false` (default: `false`)
+- `defaultBuildLocale`: locale used for `'static'` builds (default: `sourceLocale`)
+
+## What It Transforms
+
+- direct-import `t` from `@fluenti/vue`, `@fluenti/react`, or `@fluenti/solid`
+- runtime `t` bindings from `useI18n()`
+- Vue `v-t` (via `@fluenti/vue/vite-plugin`)
+- `<Trans>`, `<Plural>`, and `<Select>`
+
+## Splitting Model
+
+- `'dynamic'`: default locale stays in the initial bundle; other locales load on demand
+- `'static'`: inline one locale at build time, ideal for SSR / SSG single-locale builds
+- `false`: no locale chunk splitting
+
+## Exports
+
+- `createFluentiPlugins(options, frameworkPlugins, runtimeGenerator): Plugin[]`
+- `FluentiPluginOptions`: user-facing plugin options type
+- `FluentiCoreOptions`: internal options type (includes `framework` field)
+- `RuntimeGenerator`, `RuntimeGeneratorOptions`: interface for framework-specific runtime generation
+- `resolveVirtualSplitId(id)`: Resolve a virtual split module ID to its `\0`-prefixed form
+- `loadVirtualSplitModule(id, options)`: Load and generate code for a virtual split module
+- `setResolvedMode(command)`: Set the resolved Vite command mode ('serve' | 'build')
+- `isBuildMode(env?)`: Check if the current Vite environment is a production build
+- `getPluginEnvironment(pluginContext)`: Get the plugin environment from a Vite plugin context
+- `IdGenerator`: Type for custom message ID generation functions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluenti/vite-plugin",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "type": "module",
   "description": "Vite plugin for Fluenti — build-time transforms, virtual modules, code splitting",
   "homepage": "https://fluenti.dev",
@@ -57,10 +57,11 @@
   },
   "files": [
     "dist",
-    "client.d.ts"
+    "client.d.ts",
+    "llms*.txt"
   ],
   "dependencies": {
-    "@fluenti/core": "0.2.1"
+    "@fluenti/core": "0.3.0"
   },
   "peerDependencies": {
     "vite": "^5 || ^6 || ^8"

package/dist/scope-transform.d.ts

@@ -1,3 +0,0 @@
-export { scopeTransform } from '@fluenti/core/internal';
-export type { ScopeTransformOptions, ScopeTransformResult, Replacement } from '@fluenti/core/internal';
-//# sourceMappingURL=scope-transform.d.ts.map

package/dist/scope-transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scope-transform.d.ts","sourceRoot":"","sources":["../src/scope-transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/trans-transform.d.ts

@@ -1,3 +0,0 @@
-export { transformTransComponents } from '@fluenti/core/internal';
-export type { TransTransformResult } from '@fluenti/core/internal';
-//# sourceMappingURL=trans-transform.d.ts.map

package/dist/trans-transform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trans-transform.d.ts","sourceRoot":"","sources":["../src/trans-transform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}