@powerlines/plugin-i18next 0.1.14 → 0.1.16

package/dist/_virtual/rolldown_runtime.cjs

@@ -1 +1,29 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/helpers/config-utils.cjs

@@ -1 +1,31 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/correct-path`);function n(e,n,r){if(!e)return(0,t.correctPath)(`locales/${n}/${r??`translation`}.json`);if(typeof e==`function`)try{return(0,t.correctPath)(String(e(n,r)).replace(/\/{2,}/g,`/`))}catch{return(0,t.correctPath)(`locales/${n}/${r??`translation`}.json`)}let i=String(e);return i=i.replace(/\{\{language\}\}|\{\{lng\}\}/g,n),i=r==null?i.replace(/\/?\{\{namespace\}\}/g,``):i.replace(/\{\{namespace\}\}/g,r),i=i.replace(/\/{2,}/g,`/`),(0,t.correctPath)(i)}exports.getOutputPath=n;
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __stryke_path_correct_path = require("@stryke/path/correct-path");
+
+//#region src/helpers/config-utils.ts
+/**
+* Resolve an output template (string or function) into an actual path string.
+*
+* @remarks
+* - If `outputTemplate` is a function, call it with (language, namespace)
+* - If it's a string, replace placeholders:
+*    - \{\{language\}\} or \{\{lng\}\} -\> language
+*    - \{\{namespace\}\} -\> namespace (or removed if namespace is undefined)
+* - Normalizes duplicate slashes and returns a platform-correct path.
+*/
+function getOutputPath(outputTemplate, language, namespace) {
+	if (!outputTemplate) return (0, __stryke_path_correct_path.correctPath)(`locales/${language}/${namespace ?? "translation"}.json`);
+	if (typeof outputTemplate === "function") try {
+		return (0, __stryke_path_correct_path.correctPath)(String(outputTemplate(language, namespace)).replace(/\/{2,}/g, "/"));
+	} catch {
+		return (0, __stryke_path_correct_path.correctPath)(`locales/${language}/${namespace ?? "translation"}.json`);
+	}
+	let out = String(outputTemplate);
+	out = out.replace(/\{\{language\}\}|\{\{lng\}\}/g, language);
+	if (namespace !== void 0 && namespace !== null) out = out.replace(/\{\{namespace\}\}/g, namespace);
+	else out = out.replace(/\/?\{\{namespace\}\}/g, "");
+	out = out.replace(/\/{2,}/g, "/");
+	return (0, __stryke_path_correct_path.correctPath)(out);
+}
+
+//#endregion
+exports.getOutputPath = getOutputPath;

package/dist/helpers/config-utils.mjs

@@ -1 +1,30 @@
-import{correctPath as e}from"@stryke/path/correct-path";function t(t,n,r){if(!t)return e(`locales/${n}/${r??`translation`}.json`);if(typeof t==`function`)try{return e(String(t(n,r)).replace(/\/{2,}/g,`/`))}catch{return e(`locales/${n}/${r??`translation`}.json`)}let i=String(t);return i=i.replace(/\{\{language\}\}|\{\{lng\}\}/g,n),i=r==null?i.replace(/\/?\{\{namespace\}\}/g,``):i.replace(/\{\{namespace\}\}/g,r),i=i.replace(/\/{2,}/g,`/`),e(i)}export{t as getOutputPath};
+import { correctPath } from "@stryke/path/correct-path";
+
+//#region src/helpers/config-utils.ts
+/**
+* Resolve an output template (string or function) into an actual path string.
+*
+* @remarks
+* - If `outputTemplate` is a function, call it with (language, namespace)
+* - If it's a string, replace placeholders:
+*    - \{\{language\}\} or \{\{lng\}\} -\> language
+*    - \{\{namespace\}\} -\> namespace (or removed if namespace is undefined)
+* - Normalizes duplicate slashes and returns a platform-correct path.
+*/
+function getOutputPath(outputTemplate, language, namespace) {
+	if (!outputTemplate) return correctPath(`locales/${language}/${namespace ?? "translation"}.json`);
+	if (typeof outputTemplate === "function") try {
+		return correctPath(String(outputTemplate(language, namespace)).replace(/\/{2,}/g, "/"));
+	} catch {
+		return correctPath(`locales/${language}/${namespace ?? "translation"}.json`);
+	}
+	let out = String(outputTemplate);
+	out = out.replace(/\{\{language\}\}|\{\{lng\}\}/g, language);
+	if (namespace !== void 0 && namespace !== null) out = out.replace(/\{\{namespace\}\}/g, namespace);
+	else out = out.replace(/\/?\{\{namespace\}\}/g, "");
+	out = out.replace(/\/{2,}/g, "/");
+	return correctPath(out);
+}
+
+//#endregion
+export { getOutputPath };

package/dist/index.cjs

@@ -1,6 +1,109 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./helpers/config-utils.cjs`);let n=require(`@stryke/fs/list-files`),r=require(`@stryke/path/append`),i=require(`@stryke/path/file-path-fns`),a=require(`@stryke/path/join`),o=require(`@stryke/type-checks/is-set`),s=require(`@stryke/type-checks/is-set-object`),c=require(`@stryke/type-checks/is-string`),l=require(`defu`);l=e.__toESM(l);let u=require(`i18next-cli`),d=require(`i18next-resources-for-ts`);const f=(e={})=>({name:`i18next`,async config(){let t=(0,l.default)(e,{extract:{output:(e,t=`translation`)=>(0,a.joinPaths)(this.config.projectRoot,`locales/${e}/${t}.json`),primaryLanguage:this.workspaceConfig.locale}},{extract:{input:[`src/**/*.ts`,`src/**/*.tsx`,`src/**/*.js`,`src/**/*.jsx`],indentation:2,defaultNS:`translation`,mergeNamespaces:!0,nsSeparator:`:`,keySeparator:`.`,primaryLanguage:e.locales&&e.locales.length>0?e.locales[0]:`en`},types:{enableSelector:!1},locales:[]});return(!t.locales||t.locales.length===0)&&(t.locales=[t.extract.primaryLanguage||`en`]),(0,o.isSet)(t.types.indentation)||(t.types.indentation=t.extract.indentation),{i18next:t}},async configResolved(){},async prepare(){await(0,u.runExtractor)(this.config.i18next,{isWatchMode:!1,isDryRun:!1,syncAll:!0,syncPrimaryWithDefaults:!0},{info:e=>{this.info(e)},warn:(e,t)=>{this.warn(e)},error:e=>{this.error(e)}})},async types(e){let a=[];for(let e of await(0,n.listFiles)(t.getOutputPath(this.config.i18next.extract.output,this.config.i18next.extract.primaryLanguage,`*`))){let t=(0,i.findFileName)(e,{withExtension:!1}),n=await this.resolver.import(e);if(this.config.i18next.extract.mergeNamespaces&&(0,s.isSetObject)(n)&&Object.keys(n).filter(e=>(0,s.isSetObject)(n[e])).length>0){for(let e of Object.keys(n).filter(e=>(0,s.isSetObject)(n[e])))a.push({name:e,resources:n[e]});Object.keys(n).filter(e=>!(0,s.isSetObject)(n[e])).length>0&&this.warn(`The file ${e} contains top-level keys that are not objects (${Object.keys(n).filter(e=>!(0,s.isSetObject)(n[e])).join(`, `)}). When 'mergeNamespaces' is enabled, top-level keys are treated as namespaces. These keys will be ignored.`);continue}a.push({name:t,resources:n})}let o;return this.config.i18next.types.resourcesFile?await this.fs.write((0,r.appendPath)(this.config.i18next.types.resourcesFile,this.config.i18next.types.output||this.config.projectRoot),(0,d.mergeResourcesAsInterface)(a,{optimize:!!this.config.i18next.types.enableSelector,indentation:this.config.i18next.types.indentation})):o=`${e}
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_config_utils = require('./helpers/config-utils.cjs');
+let __stryke_fs_list_files = require("@stryke/fs/list-files");
+let __stryke_path_append = require("@stryke/path/append");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __stryke_path_join = require("@stryke/path/join");
+let __stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let i18next_cli = require("i18next-cli");
+let i18next_resources_for_ts = require("i18next-resources-for-ts");
 
-${(0,d.mergeResourcesAsInterface)(a,{optimize:!!this.config.i18next.types.enableSelector,indentation:this.config.i18next.types.indentation})}
+//#region src/index.ts
+/**
+* i18next Plugin
+*
+* @remarks
+* A Powerlines plugin to use the i18next internationalization framework during the prepare task.
+*
+* @see https://i18next.com
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "i18next",
+		async config() {
+			const i18next = (0, defu.default)(options, { extract: {
+				output: (language, namespace = "translation") => (0, __stryke_path_join.joinPaths)(this.config.projectRoot, `locales/${language}/${namespace}.json`),
+				primaryLanguage: this.workspaceConfig.locale
+			} }, {
+				extract: {
+					input: [
+						"src/**/*.ts",
+						"src/**/*.tsx",
+						"src/**/*.js",
+						"src/**/*.jsx"
+					],
+					indentation: 2,
+					defaultNS: "translation",
+					mergeNamespaces: true,
+					nsSeparator: ":",
+					keySeparator: ".",
+					primaryLanguage: options.locales && options.locales.length > 0 ? options.locales[0] : "en"
+				},
+				types: { enableSelector: false },
+				locales: []
+			});
+			if (!i18next.locales || i18next.locales.length === 0) i18next.locales = [i18next.extract.primaryLanguage || "en"];
+			if (!(0, __stryke_type_checks_is_set.isSet)(i18next.types.indentation)) i18next.types.indentation = i18next.extract.indentation;
+			return { i18next };
+		},
+		async configResolved() {},
+		async prepare() {
+			await (0, i18next_cli.runExtractor)(this.config.i18next, {
+				isWatchMode: false,
+				isDryRun: false,
+				syncAll: true,
+				syncPrimaryWithDefaults: true
+			}, {
+				info: (message) => {
+					this.info(message);
+				},
+				warn: (message, _more) => {
+					this.warn(message);
+				},
+				error: (message) => {
+					this.error(message);
+				}
+			});
+		},
+		async types(code) {
+			const resources = [];
+			for (const file of await (0, __stryke_fs_list_files.listFiles)(require_config_utils.getOutputPath(this.config.i18next.extract.output, this.config.i18next.extract.primaryLanguage, "*"))) {
+				const namespace = (0, __stryke_path_file_path_fns.findFileName)(file, { withExtension: false });
+				const parsedContent = await this.resolver.import(file);
+				if (this.config.i18next.extract.mergeNamespaces && (0, __stryke_type_checks_is_set_object.isSetObject)(parsedContent)) {
+					if (Object.keys(parsedContent).filter((k) => (0, __stryke_type_checks_is_set_object.isSetObject)(parsedContent[k])).length > 0) {
+						for (const nsName of Object.keys(parsedContent).filter((k) => (0, __stryke_type_checks_is_set_object.isSetObject)(parsedContent[k]))) resources.push({
+							name: nsName,
+							resources: parsedContent[nsName]
+						});
+						if (Object.keys(parsedContent).filter((k) => !(0, __stryke_type_checks_is_set_object.isSetObject)(parsedContent[k])).length > 0) this.warn(`The file ${file} contains top-level keys that are not objects (${Object.keys(parsedContent).filter((k) => !(0, __stryke_type_checks_is_set_object.isSetObject)(parsedContent[k])).join(", ")}). When 'mergeNamespaces' is enabled, top-level keys are treated as namespaces. These keys will be ignored.`);
+						continue;
+					}
+				}
+				resources.push({
+					name: namespace,
+					resources: parsedContent
+				});
+			}
+			let result;
+			if (this.config.i18next.types.resourcesFile) await this.fs.write((0, __stryke_path_append.appendPath)(this.config.i18next.types.resourcesFile, this.config.i18next.types.output || this.config.projectRoot), (0, i18next_resources_for_ts.mergeResourcesAsInterface)(resources, {
+				optimize: !!this.config.i18next.types.enableSelector,
+				indentation: this.config.i18next.types.indentation
+			}));
+			else result = `${code}
+
+${(0, i18next_resources_for_ts.mergeResourcesAsInterface)(resources, {
+				optimize: !!this.config.i18next.types.enableSelector,
+				indentation: this.config.i18next.types.indentation
+			})}
 
 /**
  * i18next Custom Type Options
@@ -9,9 +112,18 @@ ${(0,d.mergeResourcesAsInterface)(a,{optimize:!!this.config.i18next.types.enable
  */
 declare module 'i18next' {
   interface CustomTypeOptions {
-    enableSelector: ${(0,c.isString)(this.config.i18next.types.enableSelector)?`"${this.config.i18next.types.enableSelector}"`:this.config.i18next.types.enableSelector};
-    defaultNS: ${this.config.i18next.extract.defaultNS===!1?`false`:`'${this.config.i18next.extract.defaultNS||`translation`}'`};
+    enableSelector: ${(0, __stryke_type_checks_is_string.isString)(this.config.i18next.types.enableSelector) ? `"${this.config.i18next.types.enableSelector}"` : this.config.i18next.types.enableSelector};
+    defaultNS: ${this.config.i18next.extract.defaultNS === false ? "false" : `'${this.config.i18next.extract.defaultNS || "translation"}'`};
     resources: Resources;
   }
 }
-`,o}});var p=f;exports.default=p,exports.plugin=f;
+`;
+			return result;
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;
+exports.plugin = plugin;

package/dist/index.mjs

@@ -1,6 +1,106 @@
-import{getOutputPath as e}from"./helpers/config-utils.mjs";import{listFiles as t}from"@stryke/fs/list-files";import{appendPath as n}from"@stryke/path/append";import{findFileName as r}from"@stryke/path/file-path-fns";import{joinPaths as i}from"@stryke/path/join";import{isSet as a}from"@stryke/type-checks/is-set";import{isSetObject as o}from"@stryke/type-checks/is-set-object";import{isString as s}from"@stryke/type-checks/is-string";import c from"defu";import{runExtractor as l}from"i18next-cli";import{mergeResourcesAsInterface as u}from"i18next-resources-for-ts";const d=(d={})=>({name:`i18next`,async config(){let e=c(d,{extract:{output:(e,t=`translation`)=>i(this.config.projectRoot,`locales/${e}/${t}.json`),primaryLanguage:this.workspaceConfig.locale}},{extract:{input:[`src/**/*.ts`,`src/**/*.tsx`,`src/**/*.js`,`src/**/*.jsx`],indentation:2,defaultNS:`translation`,mergeNamespaces:!0,nsSeparator:`:`,keySeparator:`.`,primaryLanguage:d.locales&&d.locales.length>0?d.locales[0]:`en`},types:{enableSelector:!1},locales:[]});return(!e.locales||e.locales.length===0)&&(e.locales=[e.extract.primaryLanguage||`en`]),a(e.types.indentation)||(e.types.indentation=e.extract.indentation),{i18next:e}},async configResolved(){},async prepare(){await l(this.config.i18next,{isWatchMode:!1,isDryRun:!1,syncAll:!0,syncPrimaryWithDefaults:!0},{info:e=>{this.info(e)},warn:(e,t)=>{this.warn(e)},error:e=>{this.error(e)}})},async types(i){let a=[];for(let n of await t(e(this.config.i18next.extract.output,this.config.i18next.extract.primaryLanguage,`*`))){let e=r(n,{withExtension:!1}),t=await this.resolver.import(n);if(this.config.i18next.extract.mergeNamespaces&&o(t)&&Object.keys(t).filter(e=>o(t[e])).length>0){for(let e of Object.keys(t).filter(e=>o(t[e])))a.push({name:e,resources:t[e]});Object.keys(t).filter(e=>!o(t[e])).length>0&&this.warn(`The file ${n} contains top-level keys that are not objects (${Object.keys(t).filter(e=>!o(t[e])).join(`, `)}). When 'mergeNamespaces' is enabled, top-level keys are treated as namespaces. These keys will be ignored.`);continue}a.push({name:e,resources:t})}let c;return this.config.i18next.types.resourcesFile?await this.fs.write(n(this.config.i18next.types.resourcesFile,this.config.i18next.types.output||this.config.projectRoot),u(a,{optimize:!!this.config.i18next.types.enableSelector,indentation:this.config.i18next.types.indentation})):c=`${i}
+import { getOutputPath } from "./helpers/config-utils.mjs";
+import { listFiles } from "@stryke/fs/list-files";
+import { appendPath } from "@stryke/path/append";
+import { findFileName } from "@stryke/path/file-path-fns";
+import { joinPaths } from "@stryke/path/join";
+import { isSet } from "@stryke/type-checks/is-set";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isString } from "@stryke/type-checks/is-string";
+import defu from "defu";
+import { runExtractor } from "i18next-cli";
+import { mergeResourcesAsInterface } from "i18next-resources-for-ts";
 
-${u(a,{optimize:!!this.config.i18next.types.enableSelector,indentation:this.config.i18next.types.indentation})}
+//#region src/index.ts
+/**
+* i18next Plugin
+*
+* @remarks
+* A Powerlines plugin to use the i18next internationalization framework during the prepare task.
+*
+* @see https://i18next.com
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "i18next",
+		async config() {
+			const i18next = defu(options, { extract: {
+				output: (language, namespace = "translation") => joinPaths(this.config.projectRoot, `locales/${language}/${namespace}.json`),
+				primaryLanguage: this.workspaceConfig.locale
+			} }, {
+				extract: {
+					input: [
+						"src/**/*.ts",
+						"src/**/*.tsx",
+						"src/**/*.js",
+						"src/**/*.jsx"
+					],
+					indentation: 2,
+					defaultNS: "translation",
+					mergeNamespaces: true,
+					nsSeparator: ":",
+					keySeparator: ".",
+					primaryLanguage: options.locales && options.locales.length > 0 ? options.locales[0] : "en"
+				},
+				types: { enableSelector: false },
+				locales: []
+			});
+			if (!i18next.locales || i18next.locales.length === 0) i18next.locales = [i18next.extract.primaryLanguage || "en"];
+			if (!isSet(i18next.types.indentation)) i18next.types.indentation = i18next.extract.indentation;
+			return { i18next };
+		},
+		async configResolved() {},
+		async prepare() {
+			await runExtractor(this.config.i18next, {
+				isWatchMode: false,
+				isDryRun: false,
+				syncAll: true,
+				syncPrimaryWithDefaults: true
+			}, {
+				info: (message) => {
+					this.info(message);
+				},
+				warn: (message, _more) => {
+					this.warn(message);
+				},
+				error: (message) => {
+					this.error(message);
+				}
+			});
+		},
+		async types(code) {
+			const resources = [];
+			for (const file of await listFiles(getOutputPath(this.config.i18next.extract.output, this.config.i18next.extract.primaryLanguage, "*"))) {
+				const namespace = findFileName(file, { withExtension: false });
+				const parsedContent = await this.resolver.import(file);
+				if (this.config.i18next.extract.mergeNamespaces && isSetObject(parsedContent)) {
+					if (Object.keys(parsedContent).filter((k) => isSetObject(parsedContent[k])).length > 0) {
+						for (const nsName of Object.keys(parsedContent).filter((k) => isSetObject(parsedContent[k]))) resources.push({
+							name: nsName,
+							resources: parsedContent[nsName]
+						});
+						if (Object.keys(parsedContent).filter((k) => !isSetObject(parsedContent[k])).length > 0) this.warn(`The file ${file} contains top-level keys that are not objects (${Object.keys(parsedContent).filter((k) => !isSetObject(parsedContent[k])).join(", ")}). When 'mergeNamespaces' is enabled, top-level keys are treated as namespaces. These keys will be ignored.`);
+						continue;
+					}
+				}
+				resources.push({
+					name: namespace,
+					resources: parsedContent
+				});
+			}
+			let result;
+			if (this.config.i18next.types.resourcesFile) await this.fs.write(appendPath(this.config.i18next.types.resourcesFile, this.config.i18next.types.output || this.config.projectRoot), mergeResourcesAsInterface(resources, {
+				optimize: !!this.config.i18next.types.enableSelector,
+				indentation: this.config.i18next.types.indentation
+			}));
+			else result = `${code}
+
+${mergeResourcesAsInterface(resources, {
+				optimize: !!this.config.i18next.types.enableSelector,
+				indentation: this.config.i18next.types.indentation
+			})}
 
 /**
  * i18next Custom Type Options
@@ -9,9 +109,17 @@ ${u(a,{optimize:!!this.config.i18next.types.enableSelector,indentation:this.conf
  */
 declare module 'i18next' {
   interface CustomTypeOptions {
-    enableSelector: ${s(this.config.i18next.types.enableSelector)?`"${this.config.i18next.types.enableSelector}"`:this.config.i18next.types.enableSelector};
-    defaultNS: ${this.config.i18next.extract.defaultNS===!1?`false`:`'${this.config.i18next.extract.defaultNS||`translation`}'`};
+    enableSelector: ${isString(this.config.i18next.types.enableSelector) ? `"${this.config.i18next.types.enableSelector}"` : this.config.i18next.types.enableSelector};
+    defaultNS: ${this.config.i18next.extract.defaultNS === false ? "false" : `'${this.config.i18next.extract.defaultNS || "translation"}'`};
     resources: Resources;
   }
 }
-`,c}});var f=d;export{f as default,d as plugin};
+`;
+			return result;
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default, plugin };

package/dist/powerlines/src/types/context.d.cts

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
   /**
    * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,7 +333,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltinSync: (code: string, id: string, path?: string, options?: WriteOptions) => void;
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *

package/dist/powerlines/src/types/context.d.mts

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
   /**
    * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,7 +333,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltinSync: (code: string, id: string, path?: string, options?: WriteOptions) => void;
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *

package/dist/types/i18n.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/index.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/plugin.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-i18next",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "type": "module",
   "description": "A Powerlines plugin to use i18next for internationalization.",
   "repository": {
@@ -117,19 +117,19 @@
   "files": ["dist/**/*"],
   "keywords": ["i18next", "powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
-    "@stryke/fs": "^0.33.26",
-    "@stryke/path": "^0.24.0",
-    "@stryke/types": "^0.10.28",
+    "@stryke/fs": "^0.33.27",
+    "@stryke/path": "^0.24.1",
+    "@stryke/types": "^0.10.29",
     "defu": "^6.1.4",
-    "powerlines": "^0.36.22"
+    "powerlines": "^0.36.24"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.11.48",
-    "@powerlines/plugin-plugin": "^0.12.69",
+    "@powerlines/nx": "^0.11.50",
+    "@powerlines/plugin-plugin": "^0.12.71",
     "@types/node": "^24.10.4",
     "i18next-cli": "^1.33.5",
     "i18next-resources-for-ts": "^2.0.0"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "f88fe8eb30f96536b83fc9af884972d48e31e63a"
+  "gitHead": "4b695d4b3476fd9dd79521f92258d52dab2b8d72"
 }