@linguanahq/vite 0.1.0 → 0.1.2

package/package.json

@@ -1,51 +1,66 @@
 {
-	"name": "@linguanahq/vite",
-	"version": "0.1.0",
-	"publishConfig": {
-		"access": "public"
-	},
-	"type": "module",
-	"exports": {
-		".": "./src/index.ts",
-		"./react": "./src/react.ts",
-		"./solid": "./src/solid.ts",
-		"./vue": "./src/vue.ts",
-		"./svelte": "./src/svelte.ts"
-	},
-	"imports": {
-		"#shared": "./src/shared.ts"
-	},
-	"scripts": {
-		"check-types": "tsc --noEmit",
-		"test": "bun test"
-	},
-	"dependencies": {
-		"@linguanahq/build-core": "0.1.0",
-		"@linguanahq/catalog": "0.1.0",
-		"@linguanahq/compiler": "0.1.0",
-		"magic-string": "^0.30.21"
-	},
-	"devDependencies": {
-		"@linguana/config": "0.0.0",
-		"@types/bun": "^1.3.14",
-		"@vue/compiler-dom": "^3.5.24",
-		"@vue/compiler-sfc": "^3.5.24",
-		"svelte": "^5.43.8",
-		"typescript": "^6",
-		"vite": "^8.1.3"
-	},
-	"peerDependencies": {
-		"vite": ">=7 <9"
-	},
-	"peerDependenciesMeta": {
-		"@vue/compiler-dom": {
-			"optional": true
-		},
-		"@vue/compiler-sfc": {
-			"optional": true
-		},
-		"svelte": {
-			"optional": true
-		}
-	}
+  "name": "@linguanahq/vite",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "Linguana vite integration",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "default": "./dist/react.js"
+    },
+    "./solid": {
+      "types": "./dist/solid.d.ts",
+      "import": "./dist/solid.js",
+      "default": "./dist/solid.js"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js",
+      "default": "./dist/vue.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte.d.ts",
+      "import": "./dist/svelte.js",
+      "default": "./dist/svelte.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "@linguanahq/build-core": "0.1.2",
+    "@linguanahq/catalog": "0.1.2",
+    "@linguanahq/compiler": "0.1.2",
+    "magic-string": "^0.30.21",
+    "@linguanahq/core": "0.1.2"
+  },
+  "peerDependencies": {
+    "vite": ">=7 <9",
+    "@vue/compiler-dom": ">=3.5 <4",
+    "@vue/compiler-sfc": ">=3.5 <4",
+    "svelte": ">=5 <6"
+  },
+  "peerDependenciesMeta": {
+    "@vue/compiler-dom": {
+      "optional": true
+    },
+    "@vue/compiler-sfc": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/src/index.ts

@@ -1,173 +0,0 @@
-import { isAbsolute, relative, resolve } from "node:path";
-
-import {
-	BuildSession,
-	type SourceAdapter,
-	type StrictPolicy,
-} from "@linguanahq/build-core";
-import {
-	createFilter,
-	normalizePath,
-	type Plugin,
-	type TransformResult,
-	version as viteVersion,
-} from "vite";
-
-export type LinguanaViteAdapter = SourceAdapter;
-export type LinguanaViteOptions = {
-	adapter: LinguanaViteAdapter;
-	projectId: string;
-	environment?: string;
-	sourceLocale?: string;
-	apiUrl?: string;
-	token?: string;
-	include?: string | string[];
-	exclude?: string | string[];
-	output?: string;
-	upload?: boolean;
-	strict?: StrictPolicy;
-	translation?:
-		| false
-		| {
-				enabled: true;
-				maxChargeMicros: number;
-				waitTimeoutMs?: number;
-				publish: "development";
-		  };
-};
-
-const VERSION = "0.1.0";
-const OFFICIAL_PLUGINS: Record<SourceAdapter["id"], string[]> = {
-	react: [
-		"vite:react-babel",
-		"vite:react-refresh",
-		"react-refresh/babel",
-		"tanstack-start",
-	],
-	solid: ["solid"],
-	vue: ["vite:vue"],
-	svelte: ["vite-plugin-svelte"],
-};
-
-export function linguana(options: LinguanaViteOptions): Plugin {
-	if (!options.adapter)
-		throw new Error("Linguana requires exactly one framework adapter.");
-	const environment = options.environment ?? "development";
-	const sourceLocale = options.sourceLocale ?? "en";
-	if (options.translation && (!options.token || environment !== "development"))
-		throw new Error(
-			"Build translation requires a token and the development environment.",
-		);
-	if (
-		options.translation &&
-		(!Number.isSafeInteger(options.translation.maxChargeMicros) ||
-			options.translation.maxChargeMicros <= 0)
-	)
-		throw new Error(
-			"translation.maxChargeMicros must be a positive safe integer.",
-		);
-	let root = process.cwd();
-	let session: BuildSession;
-	let filter: ReturnType<typeof createFilter>;
-	let sawSsr = false;
-	let processSource: (
-		code: string,
-		filename: string,
-		ssr?: boolean,
-	) => Promise<TransformResult | null>;
-
-	const plugin: Plugin & { api?: Record<string, unknown> } = {
-		name: "linguana:vite",
-		enforce: "pre",
-		configResolved(config) {
-			root = config.root;
-			filter = createFilter(
-				options.include ??
-					options.adapter.extensions.map((extension) => `**/*${extension}`),
-				options.exclude ?? ["**/node_modules/**", "**/*.test.*", "**/*.spec.*"],
-			);
-			session = new BuildSession({
-				projectId: options.projectId,
-				environment,
-				sourceLocale,
-				compilerVersion: VERSION,
-				strict: options.strict,
-				integration: {
-					tool: "vite",
-					toolVersion: viteVersion,
-					framework: options.adapter.id,
-					adapterVersion: options.adapter.version,
-					ssr: false,
-				},
-			});
-			const ownIndex = config.plugins.findIndex(
-				(item) => item.name === "linguana:vite",
-			);
-			const frameworkIndex = config.plugins.findIndex((item) =>
-				OFFICIAL_PLUGINS[options.adapter.id].some((name) =>
-					item.name.includes(name),
-				),
-			);
-			if (frameworkIndex < 0)
-				throw new Error(
-					`Linguana ${options.adapter.id} adapter requires the official ${options.adapter.id} Vite plugin.`,
-				);
-			if (ownIndex > frameworkIndex)
-				throw new Error(
-					`Place linguana() before the official ${options.adapter.id} plugin in vite.config.ts.`,
-				);
-			processSource = async (code, filename, ssr = false) => {
-				const cleanId = normalizePath(filename.split("?", 1)[0] ?? filename);
-				const projectRelativeId = relative(root, cleanId);
-				if (
-					options.include === undefined &&
-					(projectRelativeId === ".." ||
-						projectRelativeId.startsWith("../") ||
-						projectRelativeId.startsWith("..\\") ||
-						isAbsolute(projectRelativeId))
-				)
-					return null;
-				if (!filter(cleanId)) return null;
-				if (ssr) {
-					sawSsr = true;
-					session.options.integration.ssr = true;
-				}
-				const result = await options.adapter.transform({
-					code,
-					filename: cleanId,
-					root,
-					sourceLocale,
-				});
-				if (!result) return null;
-				session.collect(result);
-				return {
-					code: result.code,
-					map: result.map as TransformResult["map"],
-				};
-			};
-		},
-		async transform(code, id, transformOptions) {
-			return processSource(code, id, Boolean(transformOptions?.ssr));
-		},
-		async writeBundle() {
-			const manifest = await session.write(
-				resolve(root, options.output ?? ".linguana/manifest.json"),
-			);
-			for (const item of session.diagnostics)
-				this[item.severity === "error" ? "error" : "warn"](
-					`${item.code}: ${item.message}`,
-				);
-			if ((options.upload ?? Boolean(options.token)) && options.token)
-				await session.upload(manifest, {
-					apiUrl: options.apiUrl ?? "https://api.linguana.dev",
-					token: options.token,
-					translation: options.translation,
-					onProgress: (message) => this.info(`[linguana] ${message}`),
-				});
-			void sawSsr;
-		},
-	};
-	return plugin;
-}
-
-export default linguana;

package/src/react.ts

@@ -1,19 +0,0 @@
-import type { SourceAdapter } from "@linguanahq/build-core";
-import { transformSource } from "@linguanahq/compiler";
-
-export function react(): SourceAdapter {
-	return {
-		id: "react",
-		version: "0.1.0",
-		extensions: [".jsx", ".tsx"],
-		runtimeModule: "@linguanahq/react/compiler-runtime",
-		async transform(input) {
-			return transformSource(input.code, input.filename, {
-				sourceLocale: input.sourceLocale,
-				root: input.root,
-			}) as ReturnType<SourceAdapter["transform"]> extends Promise<infer T>
-				? T
-				: never;
-		},
-	};
-}

package/src/shared.ts

@@ -1,145 +0,0 @@
-import { relative } from "node:path";
-
-import {
-	contentHash,
-	type Diagnostic,
-	type ManifestMessage,
-	normalizeSource,
-	parseMessagePlaceholders,
-	stableMessageId,
-} from "@linguanahq/catalog";
-
-export const EXCLUDED_ELEMENTS = new Set(["script", "style", "code", "pre"]);
-export const TRANSLATABLE_ATTRIBUTES = new Set([
-	"title",
-	"placeholder",
-	"aria-label",
-	"alt",
-	"label",
-]);
-
-export function renderedText(value: string) {
-	return value.replace(/\s+/g, " ").trim();
-}
-
-export function escapeAttribute(value: string) {
-	return value
-		.replaceAll("&", "&")
-		.replaceAll('"', """)
-		.replaceAll("<", "&lt;");
-}
-
-export function message(input: {
-	source: string;
-	filename: string;
-	root: string;
-	line: number;
-	column: number;
-	sourceLocale: string;
-	element: string;
-}): ManifestMessage {
-	const context = { kind: "text" as const, element: input.element };
-	return {
-		id: stableMessageId({
-			sourceLocale: input.sourceLocale,
-			source: input.source,
-			context,
-		}),
-		source: input.source,
-		normalized: normalizeSource(input.source),
-		contentHash: contentHash(input.source),
-		context,
-		placeholders: parseMessagePlaceholders(input.source),
-		confidence: "high",
-		locations: [
-			{
-				file: relative(input.root, input.filename).replaceAll("\\", "/"),
-				line: input.line,
-				column: input.column,
-			},
-		],
-	};
-}
-
-export function attributeMessage(input: {
-	source: string;
-	filename: string;
-	root: string;
-	line: number;
-	column: number;
-	sourceLocale: string;
-	element: string;
-	attribute: string;
-}): ManifestMessage {
-	const context = {
-		kind: "attribute" as const,
-		element: input.element,
-		attribute: input.attribute,
-	};
-	return {
-		id: stableMessageId({
-			sourceLocale: input.sourceLocale,
-			source: input.source,
-			context,
-		}),
-		source: input.source,
-		normalized: normalizeSource(input.source),
-		contentHash: contentHash(input.source),
-		context,
-		placeholders: parseMessagePlaceholders(input.source),
-		confidence: "high",
-		locations: [
-			{
-				file: relative(input.root, input.filename).replaceAll("\\", "/"),
-				line: input.line,
-				column: input.column,
-			},
-		],
-	};
-}
-
-export function explicitMessage(input: {
-	source: string;
-	explicitId?: string;
-	filename: string;
-	root: string;
-	line: number;
-	column: number;
-	sourceLocale: string;
-}): ManifestMessage {
-	const context = { kind: "explicit" as const };
-	return {
-		id: stableMessageId({
-			sourceLocale: input.sourceLocale,
-			source: input.source,
-			context,
-			explicitId: input.explicitId,
-		}),
-		source: input.source,
-		normalized: normalizeSource(input.source),
-		contentHash: contentHash(input.source),
-		context,
-		placeholders: parseMessagePlaceholders(input.source),
-		confidence: "explicit",
-		locations: [
-			{
-				file: relative(input.root, input.filename).replaceAll("\\", "/"),
-				line: input.line,
-				column: input.column,
-			},
-		],
-	};
-}
-
-export function unsafeDiagnostic(
-	item: ManifestMessage,
-): Diagnostic | undefined {
-	if (/^(?:https?:\/\/|mailto:|tel:|www\.)/i.test(item.normalized))
-		return {
-			code: "unsafe-static-copy",
-			severity: "info",
-			message:
-				"URL-like or machine-readable text was excluded from extraction.",
-			location: item.locations[0],
-		};
-}

package/src/solid.ts

@@ -1,21 +0,0 @@
-import type { SourceAdapter } from "@linguanahq/build-core";
-import { transformSource } from "@linguanahq/compiler";
-
-export function solid(): SourceAdapter {
-	return {
-		id: "solid",
-		version: "0.1.0",
-		extensions: [".jsx", ".tsx"],
-		runtimeModule: "@linguanahq/solid/compiler-runtime",
-		async transform(input) {
-			return transformSource(input.code, input.filename, {
-				sourceLocale: input.sourceLocale,
-				root: input.root,
-				runtimePackage: "@linguanahq/solid",
-				compilerRuntime: "@linguanahq/solid/compiler-runtime",
-			}) as ReturnType<SourceAdapter["transform"]> extends Promise<infer T>
-				? T
-				: never;
-		},
-	};
-}

package/src/svelte.ts

@@ -1,226 +0,0 @@
-import type { SourceAdapter } from "@linguanahq/build-core";
-import type { Diagnostic, ManifestMessage } from "@linguanahq/catalog";
-import MagicString from "magic-string";
-import { parse } from "svelte/compiler";
-
-import {
-	attributeMessage,
-	EXCLUDED_ELEMENTS,
-	escapeAttribute,
-	explicitMessage,
-	message,
-	renderedText,
-	TRANSLATABLE_ATTRIBUTES,
-	unsafeDiagnostic,
-} from "#shared";
-
-type SvelteAttribute = {
-	type: string;
-	name: string;
-	start: number;
-	end: number;
-	value?: Array<{ type: string; data?: string }>;
-};
-
-type SvelteNode = {
-	type: string;
-	name?: string;
-	start: number;
-	end: number;
-	data?: string;
-	attributes?: SvelteAttribute[];
-	fragment?: { nodes?: SvelteNode[] };
-	[key: string]: unknown;
-};
-
-type SvelteRoot = {
-	fragment: SvelteNode;
-	instance?: { content?: { start?: number } };
-};
-
-function position(code: string, offset: number) {
-	const before = code.slice(0, offset).split("\n");
-	return { line: before.length, column: (before.at(-1) ?? "").length };
-}
-
-export function svelte(): SourceAdapter {
-	return {
-		id: "svelte",
-		version: "0.1.0",
-		extensions: [".svelte"],
-		runtimeModule: "@linguanahq/svelte/compiler-runtime",
-		async transform(input) {
-			const ast = parse(input.code, {
-				filename: input.filename,
-				modern: true,
-			}) as unknown as SvelteRoot;
-			const output = new MagicString(input.code);
-			const messages: ManifestMessage[] = [];
-			const diagnostics: Diagnostic[] = [];
-			const seen = new Set<SvelteNode>();
-			const visit = (
-				node: SvelteNode,
-				excluded = false,
-				parentTag = "svelte:fragment",
-			) => {
-				if (!node || typeof node !== "object" || seen.has(node)) return;
-				seen.add(node);
-				const tag = ["RegularElement", "Component"].includes(node.type)
-					? String(node.name)
-					: parentTag;
-				const nextExcluded =
-					excluded ||
-					EXCLUDED_ELEMENTS.has(tag.toLowerCase()) ||
-					(node.attributes ?? []).some((attribute) =>
-						["data-no-translate", "hidden"].includes(attribute.name),
-					);
-				if (
-					node.type === "Component" &&
-					["T", "LinguanaMessage"].includes(tag)
-				) {
-					const literal = (name: string) => {
-						const attribute = (node.attributes ?? []).find(
-							(item) => item.type === "Attribute" && item.name === name,
-						);
-						return attribute?.value?.length === 1 &&
-							attribute.value[0]?.type === "Text"
-							? attribute.value[0].data
-							: undefined;
-					};
-					const source = literal("defaultMessage");
-					if (source) {
-						const loc = position(input.code, node.start);
-						messages.push(
-							explicitMessage({
-								source,
-								explicitId: literal("id"),
-								filename: input.filename,
-								root: input.root,
-								line: loc.line,
-								column: loc.column,
-								sourceLocale: input.sourceLocale,
-							}),
-						);
-					}
-					return;
-				}
-				const fragmentChildren = node.fragment?.nodes ?? [];
-				if (
-					node.type === "RegularElement" &&
-					fragmentChildren.some(
-						(child: { type: string; data?: string }) =>
-							child.type === "Text" && Boolean(renderedText(child.data ?? "")),
-					) &&
-					fragmentChildren.some(
-						(child: { type: string }) => child.type !== "Text",
-					)
-				) {
-					const loc = position(input.code, node.start);
-					diagnostics.push({
-						code: "ambiguous-rich-text",
-						severity: "warning",
-						message:
-							"Mixed text and Svelte template nodes require an explicit <T> message.",
-						location: {
-							file: input.filename.slice(input.root.length + 1),
-							line: loc.line,
-							column: loc.column,
-						},
-						remediation: "Use <T defaultMessage> or data-no-translate.",
-					});
-					return;
-				}
-				if (node.type === "RegularElement" && !nextExcluded) {
-					for (const attribute of node.attributes ?? []) {
-						const text =
-							attribute.type === "Attribute" &&
-							attribute.value?.length === 1 &&
-							attribute.value[0]?.type === "Text"
-								? attribute.value[0]
-								: undefined;
-						if (
-							!text ||
-							typeof text.data !== "string" ||
-							!TRANSLATABLE_ATTRIBUTES.has(attribute.name)
-						)
-							continue;
-						const loc = position(input.code, attribute.start);
-						const item = attributeMessage({
-							source: text.data,
-							filename: input.filename,
-							root: input.root,
-							line: loc.line,
-							column: loc.column,
-							sourceLocale: input.sourceLocale,
-							element: tag,
-							attribute: attribute.name,
-						});
-						messages.push(item);
-						output.overwrite(
-							attribute.start,
-							attribute.end,
-							`${attribute.name}={String(__linguana.translate(${JSON.stringify(item.id)}, ${JSON.stringify(text.data)}))}`,
-						);
-					}
-				}
-				if (node.type === "Text" && !nextExcluded) {
-					const source = renderedText(
-						node.data ?? input.code.slice(node.start, node.end),
-					);
-					if (source) {
-						const loc = position(input.code, node.start);
-						const item = message({
-							source,
-							filename: input.filename,
-							root: input.root,
-							line: loc.line,
-							column: loc.column,
-							sourceLocale: input.sourceLocale,
-							element: parentTag,
-						});
-						const unsafe = unsafeDiagnostic(item);
-						if (unsafe) diagnostics.push(unsafe);
-						else {
-							messages.push(item);
-							output.overwrite(
-								node.start,
-								node.end,
-								`<LinguanaMessage id="${item.id}" defaultMessage="${escapeAttribute(source)}" />`,
-							);
-						}
-					}
-				}
-				for (const [key, value] of Object.entries(node)) {
-					if (["parent", "metadata", "attributes"].includes(key)) continue;
-					if (Array.isArray(value))
-						for (const child of value)
-							visit(child as SvelteNode, nextExcluded, tag);
-					else if (value && typeof value === "object" && "type" in value)
-						visit(value as SvelteNode, nextExcluded, tag);
-				}
-			};
-			visit(ast.fragment);
-			if (!messages.length && !diagnostics.length) return null;
-			if (messages.length) {
-				const importStatement = `\n<script>\nimport LinguanaMessage from "@linguanahq/svelte/compiler-runtime";\nimport { getLinguana } from "@linguanahq/svelte";\nconst __linguana = getLinguana();\n</script>\n`;
-				const instance = ast.instance;
-				if (instance?.content?.start !== undefined)
-					output.appendLeft(
-						instance.content.start,
-						`\nimport LinguanaMessage from "@linguanahq/svelte/compiler-runtime";\nimport { getLinguana as __getLinguana } from "@linguanahq/svelte";\nconst __linguana = __getLinguana();`,
-					);
-				else output.prepend(importStatement);
-			}
-			return {
-				code: output.toString(),
-				map: output.generateMap({
-					hires: true,
-					source: input.filename,
-					includeContent: true,
-				}) as unknown as Record<string, unknown>,
-				messages,
-				diagnostics,
-			};
-		},
-	};
-}