@x18n/builtins 0.0.2 → 0.0.5

package/dist/formats.d.mts

@@ -0,0 +1,34 @@
+import { Plugin } from "@x18n/core";
+//#region src/formats/ecmascript.d.ts
+export declare function ecmascript(): Plugin;
+//#endregion
+//#region src/formats/ftl.d.ts
+export declare function ftl(): Plugin;
+//#endregion
+//#region src/formats/ini.d.ts
+export declare function ini(): Plugin;
+//#endregion
+//#region src/formats/json.d.ts
+interface JsonOptions {
+  /** Spaces per level for new files. Existing files keep their indent. */
+  readonly indent?: number;
+}
+export declare function json(options?: JsonOptions): Plugin;
+export declare function jsonc(options?: JsonOptions): Plugin;
+//#endregion
+//#region src/formats/json5.d.ts
+export declare function json5(): Plugin;
+//#endregion
+//#region src/formats/php.d.ts
+export declare function php(): Plugin;
+//#endregion
+//#region src/formats/po.d.ts
+export declare function po(): Plugin;
+//#endregion
+//#region src/formats/properties.d.ts
+export declare function properties(): Plugin;
+//#endregion
+//#region src/formats/yaml.d.ts
+export declare function yaml(): Plugin;
+//#endregion
+export type { JsonOptions };

package/dist/formats.mjs

@@ -0,0 +1 @@
+export { u as ecmascript, l as ftl, c as ini, o as json, a as json5, s as jsonc, i as php, r as po, n as properties, t as yaml } from "./formats-BAogSrvw.mjs";

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { Builtins } from "@x18n/core";
+//#region src/index.d.ts
+/** Plugins that are always on, and the presets that `'auto'` detects. */
+export declare function createBuiltins(): Builtins;
+//#endregion

package/dist/index.mjs

@@ -0,0 +1,38 @@
+import { recommended } from "./checks.mjs";
+import { i as pattern } from "./finders-CqTGh4OJ.mjs";
+import { a as json5, c as ini, i as php, l as ftl, n as properties, o as json, r as po, s as jsonc, t as yaml, u as ecmascript } from "./formats-BAogSrvw.mjs";
+import { i as js, n as vue } from "./vue-5GFR5hft.mjs";
+import { manifests } from "./manifests.mjs";
+import { n as regex } from "./regex-B9TBGgXC.mjs";
+import { t as presets } from "./presets-DNnE_2MQ.mjs";
+import { reporters } from "./reporters.mjs";
+import { t as svelte } from "./scanners-B27IEH4_.mjs";
+//#region src/index.ts
+/** Plugins that are always on, and the presets that `'auto'` detects. */
+function createBuiltins() {
+	return {
+		plugins: [
+			manifests(),
+			json(),
+			jsonc(),
+			json5(),
+			yaml(),
+			po(),
+			properties(),
+			ftl(),
+			ini(),
+			php(),
+			ecmascript(),
+			pattern(),
+			js(),
+			vue(),
+			svelte(),
+			regex(),
+			recommended(),
+			reporters()
+		],
+		presets
+	};
+}
+//#endregion
+export { createBuiltins };

package/dist/manifests.d.mts

@@ -0,0 +1,10 @@
+import { ManifestReader, Plugin } from "@x18n/core";
+//#region src/manifests/index.d.ts
+/** Adapted from i18n-ally (MIT), src/packagesParsers/ */
+export declare const packageJson: ManifestReader;
+export declare const composerJson: ManifestReader;
+export declare const pubspecYaml: ManifestReader;
+/** Every `gem 'name'` line, not just `rails-i18n` as in i18n-ally. */
+export declare const gemfile: ManifestReader;
+export declare function manifests(): Plugin;
+//#endregion

package/dist/manifests.mjs

@@ -0,0 +1,49 @@
+import { parse } from "yaml";
+//#region src/manifests/index.ts
+function keysOf(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? Object.keys(value) : [];
+}
+function fieldsOf(data, fields) {
+	if (typeof data !== "object" || data === null) return [];
+	const entries = new Map(Object.entries(data));
+	return fields.flatMap((field) => keysOf(entries.get(field)));
+}
+/** Adapted from i18n-ally (MIT), src/packagesParsers/ */
+const packageJson = {
+	id: "package.json",
+	file: "package.json",
+	read: (text) => fieldsOf(JSON.parse(text), [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies"
+	])
+};
+const composerJson = {
+	id: "composer.json",
+	file: "composer.json",
+	read: (text) => fieldsOf(JSON.parse(text), ["require", "require-dev"])
+};
+const pubspecYaml = {
+	id: "pubspec.yaml",
+	file: "pubspec.yaml",
+	read: (text) => fieldsOf(parse(text), ["dependencies", "dev_dependencies"])
+};
+/** Every `gem 'name'` line, not just `rails-i18n` as in i18n-ally. */
+const gemfile = {
+	id: "Gemfile",
+	file: "Gemfile",
+	read: (text) => [...text.matchAll(/^\s*gem\s+["']([^"']+)["']/gm)].map((match) => match[1])
+};
+function manifests() {
+	return {
+		name: "x18n:manifests",
+		manifests: [
+			packageJson,
+			composerJson,
+			pubspecYaml,
+			gemfile
+		]
+	};
+}
+//#endregion
+export { composerJson, gemfile, manifests, packageJson, pubspecYaml };

package/dist/placeholders.d.mts

@@ -0,0 +1,27 @@
+import { PlaceholderSyntax, Plugin } from "@x18n/core";
+//#region src/placeholders/index.d.ts
+/** `{name}`: vue-i18n named interpolation and similar. */
+export declare const braces: PlaceholderSyntax;
+/** `{{name}}`: i18next interpolation, including `{{name, format}}` and `{{- raw}}`. */
+export declare const doubleBraces: PlaceholderSyntax;
+/** `%{name}`: Rails, Polyglot. */
+export declare const percentBraces: PlaceholderSyntax;
+/** `%s`, `%d`, `%1$s`: printf. */
+export declare const printf: PlaceholderSyntax;
+/** `@:key` and `@.modifier:key`: vue-i18n linked messages. */
+export declare const linked: PlaceholderSyntax;
+/** `{ $name }`: Fluent variables. */
+export declare const fluent: PlaceholderSyntax;
+/** `:name`: Laravel. */
+export declare const colon: PlaceholderSyntax;
+/** `$name$`: Chrome extension messages. */
+export declare const dollars: PlaceholderSyntax;
+/** `$t(key)` nesting in i18next. */
+export declare const nesting: PlaceholderSyntax;
+/** ICU MessageFormat arguments: `{name}`, `{count, plural, ...}`. Nested sub-messages are scanned too. */
+export declare const icu: PlaceholderSyntax;
+/** Registers placeholder syntaxes. Presets call it with their library's syntaxes. */
+export declare function placeholders(...syntaxes: PlaceholderSyntax[]): Plugin;
+/** A syntax from a YAML shape such as `{name}`, `{{name}}` or `%{name}`, where `name` marks the name. */
+export declare function placeholderFromShape(shape: string): PlaceholderSyntax;
+//#endregion

package/dist/placeholders.mjs

@@ -0,0 +1,131 @@
+//#region src/placeholders/index.ts
+function byRegex(id, regex, example) {
+	return {
+		id,
+		example,
+		find(value) {
+			const out = [];
+			for (const match of value.matchAll(regex)) out.push({
+				syntax: id,
+				text: match[0],
+				name: match[1] ?? match[0],
+				range: {
+					start: match.index,
+					end: match.index + match[0].length
+				}
+			});
+			return out;
+		}
+	};
+}
+/** `{name}`: vue-i18n named interpolation and similar. */
+const braces = byRegex("braces", /(?<![{$])\{\s*([\w.-]+)\s*\}(?!\})/g, "{name}");
+/** `{{name}}`: i18next interpolation, including `{{name, format}}` and `{{- raw}}`. */
+const doubleBraces = byRegex("double-braces", /\{\{-?\s*([\w.]+)\s*(?:,[^}]*)?\}\}/g, "{{name}}");
+/** `%{name}`: Rails, Polyglot. */
+const percentBraces = byRegex("percent-braces", /%\{(\w+)\}/g, "%{name}");
+/** `%s`, `%d`, `%1$s`: printf. */
+const printf = byRegex("printf", /%(?:(\d+)\$)?[-+ 0#]*(?:[1-9]\d*)?(?:\.\d+)?[sdifoxXeEgGc@]/g, "%s");
+/** `@:key` and `@.modifier:key`: vue-i18n linked messages. */
+const linked = {
+	...byRegex("linked", /@(?:\.\w+)?:\(?([\w.-]+)\)?/g, "@:key"),
+	reference: true
+};
+/** `{ $name }`: Fluent variables. */
+const fluent = byRegex("fluent", /\{\s*\$([\w-]+)(?:\s[^}]*)?\}/g, "{ $name }");
+/** `:name`: Laravel. */
+const colon = byRegex("colon", /(?<![\w:]):([a-z_]\w*)/gi, ":name");
+/** `$name$`: Chrome extension messages. */
+const dollars = byRegex("dollars", /\$(\w+)\$/g, "$name$");
+/** `$t(key)` nesting in i18next. */
+const nesting = {
+	...byRegex("nesting", /\$t\(([\w.:-]+)(?:,[^)]*)?\)/g, "$t(key)"),
+	reference: true
+};
+/** Offset after the `}` that closes the `{` at `start`, or -1. */
+function closingBrace(value, start, to) {
+	let depth = 1;
+	let j = start + 1;
+	while (j < to && depth > 0) {
+		if (value[j] === "{") depth++;
+		else if (value[j] === "}") depth--;
+		j++;
+	}
+	return depth > 0 ? -1 : j;
+}
+/** ICU MessageFormat arguments: `{name}`, `{count, plural, ...}`. Nested sub-messages are scanned too. */
+const icu = {
+	id: "icu",
+	example: "{name}",
+	find(value) {
+		const out = [];
+		const scan = (from, to) => {
+			let i = from;
+			while (i < to) {
+				const char = value[i];
+				if (char === "'") {
+					const close = value.indexOf("'", i + 1);
+					if (value[i + 1] === "{" || value[i + 1] === "}") i = close === -1 ? to : close + 1;
+					else i++;
+					continue;
+				}
+				if (char !== "{") {
+					i++;
+					continue;
+				}
+				const j = closingBrace(value, i, to);
+				if (j === -1) return;
+				const body = value.slice(i + 1, j - 1);
+				const name = /^\s*([\w.-]+)/.exec(body)?.[1];
+				if (name) out.push({
+					syntax: "icu",
+					text: value.slice(i, j),
+					name,
+					range: {
+						start: i,
+						end: j
+					}
+				});
+				const firstSub = body.indexOf("{");
+				if (firstSub !== -1) scan(i + 1 + firstSub, j - 1);
+				i = j;
+			}
+		};
+		scan(0, value.length);
+		return out;
+	},
+	validate(value) {
+		let depth = 0;
+		let quoted = false;
+		for (let i = 0; i < value.length; i++) {
+			const char = value[i];
+			if (char === "'" && (value[i + 1] === "{" || value[i + 1] === "}" || quoted)) {
+				quoted = !quoted;
+				continue;
+			}
+			if (quoted) continue;
+			if (char === "{") depth++;
+			if (char === "}") depth--;
+			if (depth < 0) return [`Unexpected "}" at ${i}`];
+		}
+		if (depth > 0) return ["Unclosed \"{\""];
+		const errors = [];
+		for (const match of value.matchAll(/\{\s*([\w.-]+)\s*,\s*(plural|select|selectordinal)\s*,([\s\S]*)\}/g)) if (!/\bother\s*\{/.test(match[3] ?? "")) errors.push(`"${match[1]}" ${match[2]} has no "other" case`);
+		return errors;
+	}
+};
+/** Registers placeholder syntaxes. Presets call it with their library's syntaxes. */
+function placeholders(...syntaxes) {
+	return {
+		name: `x18n:placeholders-${syntaxes.map((s) => s.id).join("-")}`,
+		placeholders: syntaxes
+	};
+}
+/** A syntax from a YAML shape such as `{name}`, `{{name}}` or `%{name}`, where `name` marks the name. */
+function placeholderFromShape(shape) {
+	const [before, after] = shape.split("name");
+	const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	return byRegex(`shape:${shape}`, new RegExp(`${escape(before ?? "")}\\s*([\\w.-]+)\\s*${escape(after ?? "")}`, "g"), shape);
+}
+//#endregion
+export { braces, colon, dollars, doubleBraces, fluent, icu, linked, nesting, percentBraces, placeholderFromShape, placeholders, printf };