eslint-plugin-lingui-typescript 1.0.0

package/README.md

@@ -0,0 +1,111 @@
+# eslint-plugin-lingui-typescript
+
+[![npm version](https://img.shields.io/npm/v/eslint-plugin-lingui-typescript.svg)](https://www.npmjs.com/package/eslint-plugin-lingui-typescript)
+[![CI](https://github.com/sebastian-software/eslint-plugin-lingui-typescript/actions/workflows/ci.yml/badge.svg)](https://github.com/sebastian-software/eslint-plugin-lingui-typescript/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+ESLint plugin for [Lingui](https://lingui.dev/) with TypeScript type-aware rules.
+
+## Why TypeScript?
+
+Traditional i18n linters rely on heuristics and manual whitelists to distinguish user-visible text from technical strings. This leads to false positives and constant configuration tweaking.
+
+This plugin leverages TypeScript's type system to **automatically** recognize technical strings:
+
+```ts
+// ✅ Automatically ignored - TypeScript knows these are technical
+document.createElement("div")                    // keyof HTMLElementTagNameMap
+element.addEventListener("click", handler)       // keyof GlobalEventHandlersEventMap
+fetch(url, { mode: "cors" })                     // RequestMode
+date.toLocaleDateString("de-DE", { weekday: "long" })  // Intl.DateTimeFormatOptions
+
+type Status = "idle" | "loading" | "error"
+const status: Status = "loading"                 // String literal union
+
+// ❌ Reported - actual user-visible text
+const message = "Welcome to our app"
+<button>Save changes</button>
+```
+
+**No configuration needed** for DOM APIs, Intl methods, or your own string literal union types. TypeScript already knows!
+
+## Features
+
+- 🔍 Detects incorrect usage of Lingui translation macros
+- 📝 Enforces simple, safe expressions inside translated messages
+- 🎯 Detects missing localization of user-visible text
+- 🧠 Zero-config recognition of technical strings via TypeScript types
+
+## Requirements
+
+- Node.js ≥ 24
+- ESLint ≥ 9
+- TypeScript ≥ 5
+- `typescript-eslint` with type-aware linting enabled
+
+## Installation
+
+```bash
+npm install --save-dev eslint-plugin-lingui-typescript
+```
+
+## Usage
+
+This plugin requires TypeScript and type-aware linting. Configure your `eslint.config.ts`:
+
+```ts
+import eslint from "@eslint/js"
+import tseslint from "typescript-eslint"
+import linguiPlugin from "eslint-plugin-lingui-typescript"
+
+export default [
+  eslint.configs.recommended,
+  ...tseslint.configs.strictTypeChecked,
+  linguiPlugin.configs["flat/recommended"],
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname
+      }
+    }
+  }
+]
+```
+
+Or configure rules manually:
+
+```ts
+{
+  plugins: {
+    "lingui-ts": linguiPlugin
+  },
+  rules: {
+    "lingui-ts/no-unlocalized-strings": "error",
+    "lingui-ts/no-single-variable-message": "error"
+  }
+}
+```
+
+## Rules
+
+| Rule | Description | Recommended |
+|------|-------------|:-----------:|
+| [no-unlocalized-strings](docs/rules/no-unlocalized-strings.md) | Detects user-visible strings not wrapped in Lingui macros. Uses TypeScript types to automatically ignore technical strings like string literal unions, DOM APIs, Intl methods, and discriminated union fields. | ✅ |
+| [no-single-variable-message](docs/rules/no-single-variable-message.md) | Disallows messages that consist only of a single variable without surrounding text. Such messages provide no context for translators. | ✅ |
+| [no-single-tag-message](docs/rules/no-single-tag-message.md) | Disallows `<Trans>` components that contain only a single JSX element without text. The wrapped element should be translated directly instead. | ✅ |
+| [no-nested-macros](docs/rules/no-nested-macros.md) | Prevents nesting Lingui macros inside each other (e.g., `t` inside `<Trans>`). Nested macros create invalid message catalogs and confuse translators. | ✅ |
+| [no-complex-expressions-in-message](docs/rules/no-complex-expressions-in-message.md) | Restricts embedded expressions in messages to simple identifiers and member access. Complex expressions like function calls or ternaries should be extracted to variables. | ✅ |
+| [valid-t-call-location](docs/rules/valid-t-call-location.md) | Ensures `t` macro calls are inside functions, not at module scope. Module-level calls execute before i18n is initialized and won't update on locale change. | ✅ |
+| [consistent-plural-format](docs/rules/consistent-plural-format.md) | Validates `<Plural>` component usage by ensuring required plural keys (`one`, `other`) are present. Helps maintain consistent pluralization across the codebase. | ✅ |
+| [text-restrictions](docs/rules/text-restrictions.md) | Enforces project-specific text restrictions like disallowed patterns or minimum length. Requires configuration to be useful. | — |
+
+## Related Projects
+
+- [Lingui](https://lingui.dev/) – The excellent i18n library this plugin is built for. Provides powerful macros like `t`, `<Trans>`, and `plural` for seamless internationalization.
+- [eslint-plugin-lingui](https://github.com/lingui/eslint-plugin-lingui) – The official Lingui ESLint plugin. Great for JavaScript projects; this plugin extends the concept with TypeScript type-awareness.
+- [typescript-eslint](https://typescript-eslint.io/) – The foundation that makes type-aware linting possible. This plugin builds on their excellent tooling.
+
+## License
+
+[MIT](LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ESLint Plugin for Lingui with TypeScript type-aware rules
+ *
+ * @packageDocumentation
+ */
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    rules: {
+        "consistent-plural-format": import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingPluralKey", [import("./rules/consistent-plural-format.js").Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "no-complex-expressions-in-message": import("@typescript-eslint/utils/ts-eslint").RuleModule<"complexExpression", [import("./rules/no-complex-expressions-in-message.js").Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "no-nested-macros": import("@typescript-eslint/utils/ts-eslint").RuleModule<"nestedMacro", [import("./rules/no-nested-macros.js").Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "no-single-tag-message": import("@typescript-eslint/utils/ts-eslint").RuleModule<"singleTag", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "no-single-variable-message": import("@typescript-eslint/utils/ts-eslint").RuleModule<"singleVariable", [], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "no-unlocalized-strings": import("@typescript-eslint/utils/ts-eslint").RuleModule<"unlocalizedString", [import("./rules/no-unlocalized-strings.js").Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "text-restrictions": import("@typescript-eslint/utils/ts-eslint").RuleModule<"forbiddenPattern" | "tooShort", [import("./rules/text-restrictions.js").Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+        "valid-t-call-location": import("@typescript-eslint/utils/ts-eslint").RuleModule<"topLevelNotAllowed", [import("./rules/valid-t-call-location.js").Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+    };
+    configs: Record<string, unknown>;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;aAeK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CACvC,CAAA;AAqBD,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * ESLint Plugin for Lingui with TypeScript type-aware rules
+ *
+ * @packageDocumentation
+ */
+import { consistentPluralFormat } from "./rules/consistent-plural-format.js";
+import { noComplexExpressionsInMessage } from "./rules/no-complex-expressions-in-message.js";
+import { noNestedMacros } from "./rules/no-nested-macros.js";
+import { noSingleTagMessage } from "./rules/no-single-tag-message.js";
+import { noSingleVariableMessage } from "./rules/no-single-variable-message.js";
+import { noUnlocalizedStrings } from "./rules/no-unlocalized-strings.js";
+import { textRestrictions } from "./rules/text-restrictions.js";
+import { validTCallLocation } from "./rules/valid-t-call-location.js";
+const plugin = {
+    meta: {
+        name: "eslint-plugin-lingui-typescript",
+        version: "1.0.0"
+    },
+    rules: {
+        "consistent-plural-format": consistentPluralFormat,
+        "no-complex-expressions-in-message": noComplexExpressionsInMessage,
+        "no-nested-macros": noNestedMacros,
+        "no-single-tag-message": noSingleTagMessage,
+        "no-single-variable-message": noSingleVariableMessage,
+        "no-unlocalized-strings": noUnlocalizedStrings,
+        "text-restrictions": textRestrictions,
+        "valid-t-call-location": validTCallLocation
+    },
+    configs: {}
+};
+// Add flat config with self-reference
+plugin.configs = {
+    "flat/recommended": {
+        plugins: {
+            "lingui-ts": plugin
+        },
+        rules: {
+            "lingui-ts/consistent-plural-format": "error",
+            "lingui-ts/no-complex-expressions-in-message": "error",
+            "lingui-ts/no-nested-macros": "error",
+            "lingui-ts/no-single-tag-message": "error",
+            "lingui-ts/no-single-variable-message": "error",
+            "lingui-ts/no-unlocalized-strings": "error",
+            "lingui-ts/valid-t-call-location": "error"
+            // text-restrictions not in recommended (requires configuration)
+        }
+    }
+};
+export default plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAA;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAA;AAC5F,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAA;AAC/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAErE,MAAM,MAAM,GAAG;IACb,IAAI,EAAE;QACJ,IAAI,EAAE,iCAAiC;QACvC,OAAO,EAAE,OAAO;KACjB;IACD,KAAK,EAAE;QACL,0BAA0B,EAAE,sBAAsB;QAClD,mCAAmC,EAAE,6BAA6B;QAClE,kBAAkB,EAAE,cAAc;QAClC,uBAAuB,EAAE,kBAAkB;QAC3C,4BAA4B,EAAE,uBAAuB;QACrD,wBAAwB,EAAE,oBAAoB;QAC9C,mBAAmB,EAAE,gBAAgB;QACrC,uBAAuB,EAAE,kBAAkB;KAC5C;IACD,OAAO,EAAE,EAA6B;CACvC,CAAA;AAED,sCAAsC;AACtC,MAAM,CAAC,OAAO,GAAG;IACf,kBAAkB,EAAE;QAClB,OAAO,EAAE;YACP,WAAW,EAAE,MAAM;SACpB;QACD,KAAK,EAAE;YACL,oCAAoC,EAAE,OAAO;YAC7C,6CAA6C,EAAE,OAAO;YACtD,4BAA4B,EAAE,OAAO;YACrC,iCAAiC,EAAE,OAAO;YAC1C,sCAAsC,EAAE,OAAO;YAC/C,kCAAkC,EAAE,OAAO;YAC3C,iCAAiC,EAAE,OAAO;YAC1C,gEAAgE;SACjE;KACF;CACF,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/rules/consistent-plural-format.d.ts

@@ -0,0 +1,5 @@
+export interface Options {
+    requiredKeys: string[];
+}
+export declare const consistentPluralFormat: import("@typescript-eslint/utils/ts-eslint").RuleModule<"missingPluralKey", [Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=consistent-plural-format.d.ts.map

package/dist/rules/consistent-plural-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent-plural-format.d.ts","sourceRoot":"","sources":["../../src/rules/consistent-plural-format.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAmBD,eAAO,MAAM,sBAAsB,4JAqDjC,CAAA"}

package/dist/rules/consistent-plural-format.js

@@ -0,0 +1,67 @@
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { createRule } from "../utils/create-rule.js";
+const DEFAULT_REQUIRED_KEYS = ["one", "other"];
+/**
+ * Extracts attribute names from a JSX opening element.
+ */
+function getJSXAttributeNames(node) {
+    const names = [];
+    for (const attr of node.attributes) {
+        if (attr.type === AST_NODE_TYPES.JSXAttribute && attr.name.type === AST_NODE_TYPES.JSXIdentifier) {
+            names.push(attr.name.name);
+        }
+    }
+    return names;
+}
+export const consistentPluralFormat = createRule({
+    name: "consistent-plural-format",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Ensure <Plural> component has required plural category props"
+        },
+        messages: {
+            missingPluralKey: "<Plural> is missing required prop '{{key}}'"
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    requiredKeys: {
+                        type: "array",
+                        items: { type: "string" },
+                        default: DEFAULT_REQUIRED_KEYS
+                    }
+                },
+                additionalProperties: false
+            }
+        ]
+    },
+    defaultOptions: [
+        {
+            requiredKeys: DEFAULT_REQUIRED_KEYS
+        }
+    ],
+    create(context, [options]) {
+        return {
+            JSXElement(node) {
+                const openingElement = node.openingElement;
+                // Check for <Plural> component
+                if (openingElement.name.type !== AST_NODE_TYPES.JSXIdentifier || openingElement.name.name !== "Plural") {
+                    return;
+                }
+                const providedProps = getJSXAttributeNames(openingElement);
+                for (const requiredKey of options.requiredKeys) {
+                    if (!providedProps.includes(requiredKey)) {
+                        context.report({
+                            node,
+                            messageId: "missingPluralKey",
+                            data: { key: requiredKey }
+                        });
+                    }
+                }
+            }
+        };
+    }
+});
+//# sourceMappingURL=consistent-plural-format.js.map

package/dist/rules/consistent-plural-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent-plural-format.js","sourceRoot":"","sources":["../../src/rules/consistent-plural-format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAiB,MAAM,0BAA0B,CAAA;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAQpD,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AAE9C;;GAEG;AACH,SAAS,oBAAoB,CAAC,IAAgC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa,EAAE,CAAC;YACjG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAuB;IACrE,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,8DAA8D;SAC5E;QACD,QAAQ,EAAE;YACR,gBAAgB,EAAE,6CAA6C;SAChE;QACD,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,YAAY,EAAE;wBACZ,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,OAAO,EAAE,qBAAqB;qBAC/B;iBACF;gBACD,oBAAoB,EAAE,KAAK;aAC5B;SACF;KACF;IACD,cAAc,EAAE;QACd;YACE,YAAY,EAAE,qBAAqB;SACpC;KACF;IACD,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC;QACvB,OAAO;YACL,UAAU,CAAC,IAAI;gBACb,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAA;gBAE1C,+BAA+B;gBAC/B,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,CAAC,aAAa,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvG,OAAM;gBACR,CAAC;gBAED,MAAM,aAAa,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAA;gBAE1D,KAAK,MAAM,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBAC/C,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;wBACzC,OAAO,CAAC,MAAM,CAAC;4BACb,IAAI;4BACJ,SAAS,EAAE,kBAAkB;4BAC7B,IAAI,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE;yBAC3B,CAAC,CAAA;oBACJ,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}

package/dist/rules/consistent-plural-format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=consistent-plural-format.test.d.ts.map

package/dist/rules/consistent-plural-format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent-plural-format.test.d.ts","sourceRoot":"","sources":["../../src/rules/consistent-plural-format.test.ts"],"names":[],"mappings":""}

package/dist/rules/consistent-plural-format.test.js

@@ -0,0 +1,74 @@
+import { RuleTester } from "@typescript-eslint/rule-tester";
+import { afterAll, describe, it } from "vitest";
+import { consistentPluralFormat } from "./consistent-plural-format.js";
+RuleTester.afterAll = afterAll;
+RuleTester.describe = describe;
+RuleTester.it = it;
+const ruleTester = new RuleTester({
+    languageOptions: {
+        parserOptions: {
+            ecmaVersion: 2022,
+            sourceType: "module",
+            ecmaFeatures: {
+                jsx: true
+            }
+        }
+    }
+});
+ruleTester.run("consistent-plural-format", consistentPluralFormat, {
+    valid: [
+        // All required props present (default: one, other)
+        '<Plural value={count} one="# item" other="# items" />',
+        '<Plural value={count} one="One" other="Many" zero="None" />',
+        // With expressions
+        "<Plural value={count} one={oneMsg} other={otherMsg} />",
+        // Custom required keys
+        {
+            code: '<Plural value={count} other="items" />',
+            options: [{ requiredKeys: ["other"] }]
+        },
+        {
+            code: '<Plural value={count} one="#" other="#" zero="none" />',
+            options: [{ requiredKeys: ["one", "other", "zero"] }]
+        },
+        // Non-Plural components should be ignored
+        '<Select value={gender} male="He" female="She" other="They" />',
+        '<div one="x" />',
+        "<Trans>Hello</Trans>"
+    ],
+    invalid: [
+        // Missing 'other' (default required)
+        {
+            code: '<Plural value={count} one="# item" />',
+            errors: [{ messageId: "missingPluralKey", data: { key: "other" } }]
+        },
+        // Missing 'one' (default required)
+        {
+            code: '<Plural value={count} other="# items" />',
+            errors: [{ messageId: "missingPluralKey", data: { key: "one" } }]
+        },
+        // Missing both default required keys
+        {
+            code: '<Plural value={count} zero="None" />',
+            errors: [
+                { messageId: "missingPluralKey", data: { key: "one" } },
+                { messageId: "missingPluralKey", data: { key: "other" } }
+            ]
+        },
+        // Custom required keys missing
+        {
+            code: '<Plural value={count} one="#" other="#" />',
+            options: [{ requiredKeys: ["one", "other", "zero"] }],
+            errors: [{ messageId: "missingPluralKey", data: { key: "zero" } }]
+        },
+        // Only value prop
+        {
+            code: "<Plural value={count} />",
+            errors: [
+                { messageId: "missingPluralKey", data: { key: "one" } },
+                { messageId: "missingPluralKey", data: { key: "other" } }
+            ]
+        }
+    ]
+});
+//# sourceMappingURL=consistent-plural-format.test.js.map

package/dist/rules/consistent-plural-format.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistent-plural-format.test.js","sourceRoot":"","sources":["../../src/rules/consistent-plural-format.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAC3D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAA;AAC9B,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAA;AAC9B,UAAU,CAAC,EAAE,GAAG,EAAE,CAAA;AAElB,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC;IAChC,eAAe,EAAE;QACf,aAAa,EAAE;YACb,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,QAAQ;YACpB,YAAY,EAAE;gBACZ,GAAG,EAAE,IAAI;aACV;SACF;KACF;CACF,CAAC,CAAA;AAEF,UAAU,CAAC,GAAG,CAAC,0BAA0B,EAAE,sBAAsB,EAAE;IACjE,KAAK,EAAE;QACL,mDAAmD;QACnD,uDAAuD;QACvD,6DAA6D;QAE7D,mBAAmB;QACnB,wDAAwD;QAExD,uBAAuB;QACvB;YACE,IAAI,EAAE,wCAAwC;YAC9C,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;SACvC;QACD;YACE,IAAI,EAAE,wDAAwD;YAC9D,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;SACtD;QAED,0CAA0C;QAC1C,+DAA+D;QAC/D,iBAAiB;QACjB,sBAAsB;KACvB;IACD,OAAO,EAAE;QACP,qCAAqC;QACrC;YACE,IAAI,EAAE,uCAAuC;YAC7C,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC;SACpE;QAED,mCAAmC;QACnC;YACE,IAAI,EAAE,0CAA0C;YAChD,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC;SAClE;QAED,qCAAqC;QACrC;YACE,IAAI,EAAE,sCAAsC;YAC5C,MAAM,EAAE;gBACN,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;gBACvD,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;aAC1D;SACF;QAED,+BAA+B;QAC/B;YACE,IAAI,EAAE,4CAA4C;YAClD,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;YACrD,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;SACnE;QAED,kBAAkB;QAClB;YACE,IAAI,EAAE,0BAA0B;YAChC,MAAM,EAAE;gBACN,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;gBACvD,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;aAC1D;SACF;KACF;CACF,CAAC,CAAA"}

package/dist/rules/no-complex-expressions-in-message.d.ts

@@ -0,0 +1,7 @@
+export interface Options {
+    allowedCallees: string[];
+    allowMemberExpressions: boolean;
+    maxExpressionDepth: number | null;
+}
+export declare const noComplexExpressionsInMessage: import("@typescript-eslint/utils/ts-eslint").RuleModule<"complexExpression", [Options], unknown, import("@typescript-eslint/utils/ts-eslint").RuleListener>;
+//# sourceMappingURL=no-complex-expressions-in-message.d.ts.map

package/dist/rules/no-complex-expressions-in-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-complex-expressions-in-message.d.ts","sourceRoot":"","sources":["../../src/rules/no-complex-expressions-in-message.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,OAAO;IACtB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,sBAAsB,EAAE,OAAO,CAAA;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AA+GD,eAAO,MAAM,6BAA6B,6JA+FxC,CAAA"}

package/dist/rules/no-complex-expressions-in-message.js

@@ -0,0 +1,184 @@
+import { AST_NODE_TYPES } from "@typescript-eslint/utils";
+import { createRule } from "../utils/create-rule.js";
+const DEFAULT_ALLOWED_CALLEES = ["i18n.number", "i18n.date"];
+/**
+ * Gets the string representation of a callee (e.g., "i18n.number", "Math.random").
+ */
+function getCalleeName(node) {
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return node.name;
+    }
+    if (node.type === AST_NODE_TYPES.MemberExpression && !node.computed) {
+        const object = getCalleeName(node.object);
+        const property = node.property.type === AST_NODE_TYPES.Identifier ? node.property.name : null;
+        if (object !== null && property !== null) {
+            return `${object}.${property}`;
+        }
+    }
+    return null;
+}
+/**
+ * Gets the depth of a member expression chain.
+ */
+function getMemberExpressionDepth(node) {
+    let depth = 1;
+    let current = node.object;
+    while (current.type === AST_NODE_TYPES.MemberExpression) {
+        depth++;
+        current = current.object;
+    }
+    return depth;
+}
+/**
+ * Checks if an expression is allowed within a Lingui message.
+ */
+function isAllowedExpression(node, options) {
+    // Simple identifiers are always allowed: name, count
+    if (node.type === AST_NODE_TYPES.Identifier) {
+        return true;
+    }
+    // Member expressions: props.name, user.id
+    if (node.type === AST_NODE_TYPES.MemberExpression) {
+        if (!options.allowMemberExpressions) {
+            return false;
+        }
+        // Check depth limit
+        const depth = getMemberExpressionDepth(node);
+        if (options.maxExpressionDepth !== null && depth > options.maxExpressionDepth) {
+            return false;
+        }
+        // Optional chaining is not allowed
+        if (node.optional) {
+            return false;
+        }
+        return true;
+    }
+    // Call expressions: check if callee is whitelisted
+    if (node.type === AST_NODE_TYPES.CallExpression) {
+        const calleeName = getCalleeName(node.callee);
+        if (calleeName !== null && options.allowedCallees.includes(calleeName)) {
+            return true;
+        }
+        return false;
+    }
+    // All other expression types are not allowed
+    return false;
+}
+/**
+ * Gets a readable representation of an expression for error messages.
+ */
+function getExpressionText(node) {
+    switch (node.type) {
+        case AST_NODE_TYPES.BinaryExpression:
+            return `binary expression (${node.operator})`;
+        case AST_NODE_TYPES.CallExpression: {
+            const name = getCalleeName(node.callee);
+            return name !== null ? `function call (${name})` : "function call";
+        }
+        case AST_NODE_TYPES.MemberExpression:
+            return "member expression";
+        case AST_NODE_TYPES.ConditionalExpression:
+            return "conditional expression";
+        case AST_NODE_TYPES.LogicalExpression:
+            return `logical expression (${node.operator})`;
+        case AST_NODE_TYPES.UnaryExpression:
+            return `unary expression (${node.operator})`;
+        case AST_NODE_TYPES.TemplateLiteral:
+            return "template literal";
+        case AST_NODE_TYPES.ArrayExpression:
+            return "array expression";
+        case AST_NODE_TYPES.ObjectExpression:
+            return "object expression";
+        default:
+            return node.type;
+    }
+}
+export const noComplexExpressionsInMessage = createRule({
+    name: "no-complex-expressions-in-message",
+    meta: {
+        type: "problem",
+        docs: {
+            description: "Disallow complex expressions in Lingui messages"
+        },
+        messages: {
+            complexExpression: "Complex expression '{{expression}}' in Lingui message. Use simple identifiers or extract to a variable."
+        },
+        schema: [
+            {
+                type: "object",
+                properties: {
+                    allowedCallees: {
+                        type: "array",
+                        items: { type: "string" },
+                        default: DEFAULT_ALLOWED_CALLEES
+                    },
+                    allowMemberExpressions: {
+                        type: "boolean",
+                        default: false
+                    },
+                    maxExpressionDepth: {
+                        type: ["number", "null"],
+                        default: 1
+                    }
+                },
+                additionalProperties: false
+            }
+        ]
+    },
+    defaultOptions: [
+        {
+            allowedCallees: DEFAULT_ALLOWED_CALLEES,
+            allowMemberExpressions: false,
+            maxExpressionDepth: 1
+        }
+    ],
+    create(context, [options]) {
+        function checkExpressions(expressions) {
+            for (const expr of expressions) {
+                if (!isAllowedExpression(expr, options)) {
+                    context.report({
+                        node: expr,
+                        messageId: "complexExpression",
+                        data: {
+                            expression: getExpressionText(expr)
+                        }
+                    });
+                }
+            }
+        }
+        function checkJSXChildren(children) {
+            for (const child of children) {
+                if (child.type === AST_NODE_TYPES.JSXExpressionContainer &&
+                    child.expression.type !== AST_NODE_TYPES.JSXEmptyExpression) {
+                    if (!isAllowedExpression(child.expression, options)) {
+                        context.report({
+                            node: child.expression,
+                            messageId: "complexExpression",
+                            data: {
+                                expression: getExpressionText(child.expression)
+                            }
+                        });
+                    }
+                }
+            }
+        }
+        return {
+            // Check t`Hello ${expr}` pattern
+            TaggedTemplateExpression(node) {
+                if (node.tag.type !== AST_NODE_TYPES.Identifier || node.tag.name !== "t") {
+                    return;
+                }
+                checkExpressions(node.quasi.expressions);
+            },
+            // Check <Trans>Hello {expr}</Trans> pattern
+            JSXElement(node) {
+                const openingElement = node.openingElement;
+                if (openingElement.name.type !== AST_NODE_TYPES.JSXIdentifier || openingElement.name.name !== "Trans") {
+                    return;
+                }
+                checkJSXChildren(node.children);
+            }
+        };
+    }
+});
+//# sourceMappingURL=no-complex-expressions-in-message.js.map

package/dist/rules/no-complex-expressions-in-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-complex-expressions-in-message.js","sourceRoot":"","sources":["../../src/rules/no-complex-expressions-in-message.ts"],"names":[],"mappings":"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"}

package/dist/rules/no-complex-expressions-in-message.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=no-complex-expressions-in-message.test.d.ts.map

package/dist/rules/no-complex-expressions-in-message.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-complex-expressions-in-message.test.d.ts","sourceRoot":"","sources":["../../src/rules/no-complex-expressions-in-message.test.ts"],"names":[],"mappings":""}