@lingo.dev/cli 1.0.0 → 1.0.1

package/guides/api.md

@@ -6,7 +6,7 @@
 ## Translation helpers (context required)
 ```tsx
 l.text(source, { context, values? })
-l.jsx(source, { context, tags?, values? })
+l.rich(source, { context, tags?, values? })
 l.plural(count, { one, other, zero?, two?, few?, many? }, { context })
 l.select(value, { ...forms, other }, { context })
 ```
@@ -15,13 +15,13 @@ Examples:
 ```tsx
 l.text("Save", { context: "Form submit button" })
 l.text("Hello, {name}!", { context: "Dashboard welcome", values: { name } })
-l.jsx("Read <link>docs</link>", { context: "Footer link", tags: { link: c => <a href="/docs">{c}</a> } })
+l.rich("Read <link>docs</link>", { context: "Footer link", tags: { link: c => <a href="/docs">{c}</a> } })
 l.plural(items, { one: "# item", other: "# items" }, { context: "Cart count" })
 l.select(role, { admin: "Admin", user: "User", other: "Guest" }, { context: "Nav label" })
 ```
 
 Context rules:
-1) Always required on text/jsx/plural/select.
+1) Always required on text/rich/plural/select.
 2) Describes where/how the string is used ("Checkout CTA", "Toast error").
 3) Same source + different context = different translation key.
 

package/guides/index.md

@@ -4,7 +4,7 @@ Use `npx @lingo.dev/cli guide <name>` to view a guide.
 
 Available guides:
 - `setup` – first-time setup for @lingo.dev/react (Next.js Pages Router focus, works for React too)
-- `api` – API reference for `l.text`, `l.jsx`, `l.plural`, `l.select`, formatting helpers
+- `api` – API reference for `l.text`, `l.rich`, `l.plural`, `l.select`, formatting helpers
 - `migrate` – migrate from next-intl, react-intl, i18next, lingui to @lingo.dev/react
 
 Always finish workflows with `npx @lingo.dev/cli check` (or `pnpm lingo check`) and expect 0 issues.

package/guides/migrate.md

@@ -10,7 +10,7 @@
 |------------------|----------------------------|---------------------------------|---------------------------|------------------------------------------------------|
 | Plain text       | `t("key")`               | `formatMessage({ id })`         | `t("key")`              | `l.text("source", { context: "..." })`            |
 | With values      | `t("key", { name })`     | `formatMessage({ id }, { name })`| `t("key", { name })`   | `l.text("Hello, {name}", { context: "...", values: { name } })` |
-| Rich text        | `t.rich("key", { link })`| `<FormattedMessage components>`  | `<Trans components>`     | `l.jsx("Click <link>here</link>", { context: "...", tags: { link } })` |
+| Rich text        | `t.rich("key", { link })`| `<FormattedMessage components>`  | `<Trans components>`     | `l.rich("Click <link>here</link>", { context: "...", tags: { link } })` |
 | Plurals          | ICU in JSON               | `<FormattedPlural>`             | ICU in JSON              | `l.plural(count, { one: "# item", other: "# items" }, { context: "..." })` |
 | Provider         | `NextIntlProvider`        | `IntlProvider`                  | `I18nextProvider`        | `withLingoApp` (wraps LingoProvider)                 |
 | Hook             | `useTranslations()`       | `useIntl()`                     | `useTranslation()`       | `useLingo()`                                        |

package/guides/setup.md

@@ -65,11 +65,11 @@ const l = useLingo();
 <p>{l.text("The best tool for teams.", { context: "Hero subheading" })}</p>
 <button>{l.text("Get started", { context: "Hero CTA" })}</button>
 ```
-Context is REQUIRED on l.text/l.jsx/l.plural/l.select.
+Context is REQUIRED on l.text/l.rich/l.plural/l.select.
 
 ### API cheatsheet
 - `l.text(source, { context, values? })`
-- `l.jsx(source, { context, tags?, values? })`
+- `l.rich(source, { context, tags?, values? })`
 - `l.plural(count, forms, { context })`
 - `l.select(value, forms, { context })`
 - Formatting: `l.num`, `l.currency`, `l.percent`, `l.date`, `l.time`, `l.relative`, `l.list`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/cli",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "bin": {
     "lingo": "./dist/bin.js"
@@ -33,7 +33,7 @@
     "posthog-node": "^5.28.2",
     "semver": "^7.7.4",
     "zod": "^4.0.0",
-    "@lingo.dev/spec": "1.0.0"
+    "@lingo.dev/spec": "1.0.1"
   },
   "devDependencies": {
     "@babel/types": "^7.29.0",
@@ -49,7 +49,6 @@
     "build": "tsdown",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
-    "cli": "node --import tsx/esm src/bin.ts",
-    "dev": "tsdown && node dist/bin.js"
+    "cli": "node --import tsx/esm src/bin.ts"
   }
 }

package/dist/bin.js

@@ -1,108 +0,0 @@
-import { a as extractCommandInfo, b as ApiClientLive, d as subcommands, f as TelemetryService, g as cancel, i as collectOptions, l as helpConfig, m as trackCommand, n as renderRootHelp, o as unwrapCommand, p as TelemetryServiceLive, s as cliConfig, t as renderCommandHelp, u as run, w as AuthServiceLive, x as AuthContext, y as ConfigServiceLive } from "./renderer-DvB06WWF.js";
-import { n as UpdateService, r as UpdateServiceLive } from "./update-C-JdpZwG.js";
-import { AutoCorrect, CliConfig, ValidationError } from "@effect/cli";
-import { NodeContext, NodeRuntime } from "@effect/platform-node";
-import { Cause, Effect, Layer, pipe } from "effect";
-import pc from "picocolors";
-//#region src/errors.ts
-const GLOBAL_FLAGS = new Set(["--api-key"]);
-/**
-* Finds the closest known flag for a typo using Levenshtein distance.
-* Returns the suggestion string (e.g. "--json") or undefined if no close match.
-*/
-function findFlagSuggestion(userArgs, subcommands, cliConfig) {
-	const commandName = userArgs[0];
-	if (!commandName) return void 0;
-	const match = subcommands.find((cmd) => extractCommandInfo(cmd.descriptor).name === commandName);
-	if (!match) return void 0;
-	const knownFlags = collectKnownFlags(match.descriptor);
-	const userFlags = userArgs.slice(1).filter((a) => a.startsWith("-")).map((a) => a.split("=")[0]);
-	for (const flag of userFlags) {
-		if (GLOBAL_FLAGS.has(flag) || knownFlags.has(flag)) continue;
-		const suggestion = closest(flag, knownFlags, cliConfig);
-		if (suggestion) return suggestion;
-	}
-}
-/**
-* Finds the closest known subcommand for a typo using Levenshtein distance.
-*/
-function findSubcommandSuggestion(commandName, subcommands, cliConfig) {
-	return closest(commandName, new Set(subcommands.map((cmd) => extractCommandInfo(cmd.descriptor).name)), cliConfig);
-}
-/**
-* Formats the hint lines shown after a validation error.
-* When commandName is provided, hints at command-level help; otherwise root help.
-*/
-function formatValidationHint(cliName, commandName, suggestion) {
-	const lines = [];
-	if (suggestion) lines.push(`  ${pc.yellow("Tip:")} Did you mean ${pc.bold(suggestion)}?`);
-	const helpCmd = commandName ? `${cliName} ${commandName} --help` : `${cliName} --help`;
-	const helpTarget = commandName ? "available options" : "available commands";
-	lines.push(`  Run ${pc.bold(helpCmd)} for ${helpTarget}.`);
-	return lines.join("\n");
-}
-function collectKnownFlags(descriptor) {
-	const options = collectOptions(unwrapCommand(descriptor).options);
-	const flags = /* @__PURE__ */ new Set();
-	for (const opt of options) {
-		flags.add(`--${opt.long}`);
-		if (opt.short) flags.add(`-${opt.short}`);
-	}
-	return flags;
-}
-function closest(input, candidates, config) {
-	let best;
-	let bestDist = Infinity;
-	for (const candidate of candidates) {
-		const dist = AutoCorrect.levensteinDistance(input, candidate, config);
-		if (dist < bestDist) {
-			bestDist = dist;
-			best = candidate;
-		}
-	}
-	return bestDist <= 2 ? best : void 0;
-}
-//#endregion
-//#region src/bin.ts
-process.on("SIGINT", () => process.exit(0));
-process.on("SIGTERM", () => process.exit(0));
-const args = process.argv;
-const userArgs = args.slice(2).filter((a) => a !== "--");
-if (userArgs[0] === "mcp") import("./server-BxEBM9NU.js").then((m) => m.startMcpServer()).catch((e) => {
-	process.stderr.write(`MCP server error: ${e}\n`);
-	process.exit(1);
-});
-else {
-	let globalApiKey;
-	const apiKeyIdx = userArgs.indexOf("--api-key");
-	if (apiKeyIdx !== -1 && userArgs[apiKeyIdx + 1]) globalApiKey = userArgs[apiKeyIdx + 1];
-	const isHelp = userArgs.includes("--help") || userArgs.includes("-h") || userArgs.length === 0;
-	if (process.env.npm_lifecycle_event === "npx" || process.env.npm_execpath?.includes("npx") || process.env.npm_execpath?.includes("dlx")) process.stderr.write(`  ${pc.dim("Tip: install globally for faster startup:")} npm i -g @lingo.dev/cli\n\n`);
-	if (isHelp) {
-		const subcommandName = userArgs.filter((a) => a !== "--help" && a !== "-h")[0];
-		const match = subcommands.find((cmd) => extractCommandInfo(cmd.descriptor).name === subcommandName);
-		if (match) console.log(renderCommandHelp(helpConfig, match.descriptor));
-		else console.log(renderRootHelp(helpConfig, subcommands.map((cmd) => cmd.descriptor)));
-	} else {
-		const AuthContextLive = Layer.succeed(AuthContext, { apiKeyFlag: globalApiKey });
-		const authLayer = pipe(AuthServiceLive, Layer.provide(AuthContextLive));
-		const apiLayer = pipe(ApiClientLive, Layer.provide(authLayer));
-		const telemetryLayer = pipe(TelemetryServiceLive, Layer.provide(authLayer), Layer.provide(apiLayer), Layer.provide(ConfigServiceLive));
-		const appLayer = pipe(Layer.merge(NodeContext.layer, CliConfig.layer(cliConfig)), Layer.merge(ConfigServiceLive), Layer.merge(authLayer), Layer.merge(apiLayer), Layer.merge(telemetryLayer), Layer.merge(UpdateServiceLive));
-		const commandName = userArgs[0] ?? "unknown";
-		const flagNames = userArgs.filter((a) => a.startsWith("--")).map((a) => a.split("=")[0]);
-		const showUpdateNotification = commandName === "update" ? Effect.void : pipe(UpdateService, Effect.flatMap((u) => u.check), Effect.tap((info) => info ? Effect.sync(() => {
-			process.stderr.write(`\n  Update available: ${pc.dim(info.current)} → ${pc.green(info.latest)}\n  Run ${pc.bold("lingo update")} to upgrade\n`);
-		}) : Effect.void), Effect.catchAll(() => Effect.void));
-		pipe(run(args), trackCommand(commandName, flagNames), Effect.tap(() => showUpdateNotification), Effect.catchTag("PromptCancelledError", () => cancel("Cancelled.")), Effect.catchIf(ValidationError.isValidationError, (e) => {
-			const isSubcommandError = ValidationError.isCommandMismatch(e);
-			const suggestion = ValidationError.isInvalidValue(e) ? findFlagSuggestion(userArgs, subcommands, cliConfig) : isSubcommandError ? findSubcommandSuggestion(commandName, subcommands, cliConfig) : void 0;
-			return Effect.sync(() => process.stderr.write(formatValidationHint(helpConfig.name, isSubcommandError ? void 0 : commandName, suggestion) + "\n"));
-		}), Effect.tapErrorCause((cause) => Cause.isInterruptedOnly(cause) ? Effect.void : pipe(Effect.all([Effect.sync(() => process.stderr.write(`\n  ${pc.red("Error:")} Something went wrong. Please try again.\n`)), pipe(TelemetryService, Effect.flatMap((t) => pipe(t.capture("cli_error", {
-			command: commandName,
-			error: Cause.pretty(cause)
-		}), Effect.andThen(t.shutdown))))]), Effect.catchAll(() => Effect.void))), Effect.tap(() => pipe(TelemetryService, Effect.flatMap((t) => t.shutdown), Effect.catchAll(() => Effect.void))), Effect.provide(appLayer), NodeRuntime.runMain({ disableErrorReporting: true }));
-	}
-}
-//#endregion
-export {};

package/dist/flush-telemetry.js

@@ -1,38 +0,0 @@
-import * as fs from "node:fs";
-import { PostHog } from "posthog-node";
-//#region src/flush-telemetry.ts
-/**
-* Detached subprocess that sends buffered telemetry events to PostHog.
-* Spawned by TelemetryService.shutdown -- runs after the main CLI process exits.
-*/
-const file = process.argv[2];
-if (!file) process.exit(0);
-let payload;
-try {
-	payload = JSON.parse(fs.readFileSync(file, "utf-8"));
-} catch {
-	process.exit(0);
-}
-const client = new PostHog(payload.apiKey, {
-	host: payload.host,
-	flushAt: payload.events.length || 1,
-	flushInterval: 0,
-	requestTimeout: 5e3,
-	fetchRetryCount: 1
-});
-if (payload.identifyTraits) client.identify({
-	distinctId: payload.distinctId,
-	properties: payload.identifyTraits
-});
-for (const event of payload.events) client.capture({
-	distinctId: payload.distinctId,
-	event: event.event,
-	properties: event.properties,
-	timestamp: new Date(event.timestamp)
-});
-await client.shutdown(1e4);
-try {
-	fs.unlinkSync(file);
-} catch {}
-//#endregion
-export {};

package/dist/index.js

@@ -1,3 +0,0 @@
-import { C as AuthService, S as AuthError, _ as ConfigError, a as extractCommandInfo, c as command, d as subcommands, h as PromptCancelledError, i as collectOptions, l as helpConfig, n as renderRootHelp, r as collectArgs, s as cliConfig, t as renderCommandHelp, u as run, v as ConfigService, w as AuthServiceLive, x as AuthContext, y as ConfigServiceLive } from "./renderer-DvB06WWF.js";
-import { n as UpdateService, r as UpdateServiceLive, s as VERSION, t as UpdateError } from "./update-C-JdpZwG.js";
-export { AuthContext, AuthError, AuthService, AuthServiceLive, ConfigError, ConfigService, ConfigServiceLive, PromptCancelledError, UpdateError, UpdateService, UpdateServiceLive, VERSION, cliConfig, collectArgs, collectOptions, command, extractCommandInfo, helpConfig, renderCommandHelp, renderRootHelp, run, subcommands };