eslint-plugin-modularity 2.0.0

package/README.md

@@ -0,0 +1,161 @@
+<p align="center">
+  <a href="https://eslint.interlace.tools" target="blank"><img src="https://eslint.interlace.tools/eslint-interlace-logo-light.svg" alt="ESLint Interlace Logo" width="120" /></a>
+</p>
+
+<p align="center">
+  Architecture rules for DDD patterns, module isolation, and clean design.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/eslint-plugin-modularity" target="_blank"><img src="https://img.shields.io/npm/v/eslint-plugin-modularity.svg" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/eslint-plugin-modularity" target="_blank"><img src="https://img.shields.io/npm/dm/eslint-plugin-modularity.svg" alt="NPM Downloads" /></a>
+  <a href="https://opensource.org/licenses/MIT" target="_blank"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="Package License" /></a>
+</p>
+
+## Description
+
+This plugin enforces Domain-Driven Design (DDD) patterns, module isolation, and architectural best practices. It helps teams maintain clean, layered architectures by detecting anemic domain models, mutable value objects, and architectural boundary violations.
+
+## Philosophy
+
+**Interlace** fosters **strength through integration**. Good architecture isn't just documentation — it should be enforced. These rules encode architectural decisions as code, preventing drift and maintaining design integrity over time.
+
+## Getting Started
+
+- To check out the [guide](https://eslint.interlace.tools/docs/modularity), visit [eslint.interlace.tools](https://eslint.interlace.tools). 📚
+
+```bash
+npm install eslint-plugin-modularity --save-dev
+```
+
+## ⚙️ Configuration Presets
+
+| Preset        | Description                                |
+| :------------ | :----------------------------------------- |
+| `recommended` | Balanced DDD and architecture enforcement  |
+| `strict`      | All rules as errors for strict enforcement |
+
+---
+
+## 🏢 Usage Example
+
+```js
+// eslint.config.js
+import modularity from 'eslint-plugin-modularity';
+
+export default [
+  modularity.configs.recommended,
+
+  // Apply strict DDD enforcement to domain layer
+  {
+    files: ['src/domain/**/*.ts'],
+    ...modularity.configs.strict,
+  },
+];
+```
+
+---
+
+## Rules
+
+| Rule                                                                             | Description                                    | 💼  | ⚠️  |
+| :------------------------------------------------------------------------------- | :--------------------------------------------- | :-: | :-: |
+| [ddd-anemic-domain-model](./docs/rules/ddd-anemic-domain-model.md)               | Detect anemic domain models lacking behavior   | 💼  | ⚠️  |
+| [ddd-value-object-immutability](./docs/rules/ddd-value-object-immutability.md)   | Enforce immutability in value objects          | 💼  |     |
+| [enforce-naming](./docs/rules/enforce-naming.md)                                 | Enforce consistent naming conventions by layer | 💼  | ⚠️  |
+| [enforce-rest-conventions](./docs/rules/enforce-rest-conventions.md)             | Enforce RESTful naming in API controllers      | 💼  |     |
+| [no-external-api-calls-in-utils](./docs/rules/no-external-api-calls-in-utils.md) | Prevent external API calls in utility modules  | 💼  |     |
+
+**Legend**: 💼 Recommended | ⚠️ Warns (not error)
+
+---
+
+## Why These Rules?
+
+### `ddd-anemic-domain-model`
+
+Detects domain entities that are just data containers without behavior — a common anti-pattern.
+
+```ts
+// ❌ Bad: Anemic model, no behavior
+class Order {
+  id: string;
+  items: OrderItem[];
+  status: OrderStatus;
+}
+
+// ✅ Good: Rich domain model with behavior
+class Order {
+  id: string;
+  private items: OrderItem[];
+  private status: OrderStatus;
+
+  addItem(item: OrderItem): void {
+    /* ... */
+  }
+  submit(): void {
+    /* ... */
+  }
+  cancel(reason: string): void {
+    /* ... */
+  }
+}
+```
+
+### `ddd-value-object-immutability`
+
+Value objects should be immutable. This rule catches mutable value objects.
+
+```ts
+// ❌ Bad: Mutable value object
+class Money {
+  amount: number; // Can be mutated!
+}
+
+// ✅ Good: Immutable value object
+class Money {
+  readonly amount: number;
+  readonly currency: string;
+
+  add(other: Money): Money {
+    return new Money(this.amount + other.amount, this.currency);
+  }
+}
+```
+
+### `no-external-api-calls-in-utils`
+
+Utility modules should be pure functions without side effects like API calls.
+
+```ts
+// ❌ Bad: Utils with external dependencies
+// src/utils/formatters.ts
+import axios from 'axios';
+
+export async function fetchAndFormat(id: string) {
+  const data = await axios.get(`/api/${id}`); // External API call!
+  return format(data);
+}
+
+// ✅ Good: Pure utility function
+export function format(data: Data): FormattedData {
+  return {
+    /* pure transformation */
+  };
+}
+```
+
+---
+
+## 🔗 Related ESLint Plugins
+
+Part of the **Interlace ESLint Ecosystem** — AI-native quality plugins with LLM-optimized error messages:
+
+| Plugin                                                                                                               | Description                               |
+| :------------------------------------------------------------------------------------------------------------------- | :---------------------------------------- |
+| [`eslint-plugin-import-next`](https://www.npmjs.com/package/eslint-plugin-import-next)                               | Import ordering & dependency architecture |
+| [`@interlace/eslint-plugin-maintainability`](https://www.npmjs.com/package/@interlace/eslint-plugin-maintainability) | Cognitive complexity & code quality       |
+
+## 📄 License
+
+MIT © [Ofri Peretz](https://github.com/ofri-peretz)

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "eslint-plugin-modularity",
+  "version": "2.0.0",
+  "description": "ESLint rules for architecture, DDD patterns, and module isolation with AI-parseable guidance.",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    }
+  },
+  "author": "Ofri Peretz <ofriperetzdev@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/ofri-peretz/eslint/tree/main/packages/eslint-plugin-modularity#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ofri-peretz/eslint",
+    "directory": "packages/eslint-plugin-modularity"
+  },
+  "bugs": {
+    "url": "https://github.com/ofri-peretz/eslint/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/",
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "eslint",
+    "eslint-plugin",
+    "eslintplugin",
+    "interlace-quality",
+    "modularity",
+    "ddd",
+    "domain-driven-design",
+    "architecture",
+    "llm-optimized",
+    "ai-assistant",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0",
+    "@interlace/eslint-devkit": "*"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+import { TSESLint } from '@interlace/eslint-devkit';
+/**
+ * Collection of all modularity and design pattern ESLint rules
+ */
+export declare const rules: Record<string, TSESLint.RuleModule<string, readonly unknown[]>>;
+/**
+ * ESLint Plugin object
+ */
+export declare const plugin: TSESLint.FlatConfig.Plugin;
+export declare const configs: Record<string, TSESLint.FlatConfig.Config>;
+export default plugin;

package/src/index.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configs = exports.plugin = exports.rules = void 0;
+const ddd_anemic_domain_model_1 = require("./rules/ddd-anemic-domain-model");
+const ddd_value_object_immutability_1 = require("./rules/ddd-value-object-immutability");
+const enforce_naming_1 = require("./rules/enforce-naming");
+const enforce_rest_conventions_1 = require("./rules/enforce-rest-conventions");
+const no_external_api_calls_in_utils_1 = require("./rules/no-external-api-calls-in-utils");
+/**
+ * Collection of all modularity and design pattern ESLint rules
+ */
+exports.rules = {
+    'ddd-anemic-domain-model': ddd_anemic_domain_model_1.dddAnemicDomainModel,
+    'ddd-value-object-immutability': ddd_value_object_immutability_1.dddValueObjectImmutability,
+    'enforce-naming': enforce_naming_1.enforceNaming,
+    'enforce-rest-conventions': enforce_rest_conventions_1.enforceRestConventions,
+    'no-external-api-calls-in-utils': no_external_api_calls_in_utils_1.noExternalApiCallsInUtils,
+};
+/**
+ * ESLint Plugin object
+ */
+exports.plugin = {
+    meta: {
+        name: 'eslint-plugin-modularity',
+        version: '1.0.0',
+    },
+    rules: exports.rules,
+};
+/**
+ * Preset configurations for modularity rules
+ */
+const recommendedRules = {
+    'modularity/ddd-anemic-domain-model': 'warn',
+    'modularity/ddd-value-object-immutability': 'error',
+    'modularity/enforce-naming': 'warn',
+    'modularity/enforce-rest-conventions': 'error',
+    'modularity/no-external-api-calls-in-utils': 'error',
+};
+exports.configs = {
+    recommended: {
+        plugins: {
+            'modularity': exports.plugin,
+        },
+        rules: recommendedRules,
+    },
+    strict: {
+        plugins: {
+            'modularity': exports.plugin,
+        },
+        rules: Object.fromEntries(Object.keys(exports.rules).map(ruleName => [`modularity/${ruleName}`, 'error'])),
+    },
+};
+exports.default = exports.plugin;
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/eslint-plugin-modularity/src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,6EAAuE;AACvE,yFAAmF;AACnF,2DAAuD;AACvD,+EAA0E;AAC1E,2FAAmF;AAInF;;GAEG;AACU,QAAA,KAAK,GAAoE;IACpF,yBAAyB,EAAE,8CAAoB;IAC/C,+BAA+B,EAAE,0DAA0B;IAC3D,gBAAgB,EAAE,8BAAa;IAC/B,0BAA0B,EAAE,iDAAsB;IAClD,gCAAgC,EAAE,0DAAyB;CACc,CAAC;AAE5E;;GAEG;AACU,QAAA,MAAM,GAA+B;IAChD,IAAI,EAAE;QACJ,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,OAAO;KACjB;IACD,KAAK,EAAL,aAAK;CAC+B,CAAC;AAEvC;;GAEG;AACH,MAAM,gBAAgB,GAAkD;IACtE,oCAAoC,EAAE,MAAM;IAC5C,0CAA0C,EAAE,OAAO;IACnD,2BAA2B,EAAE,MAAM;IACnC,qCAAqC,EAAE,OAAO;IAC9C,2CAA2C,EAAE,OAAO;CACrD,CAAC;AAEW,QAAA,OAAO,GAA+C;IACjE,WAAW,EAAE;QACX,OAAO,EAAE;YACP,YAAY,EAAE,cAAM;SACrB;QACD,KAAK,EAAE,gBAAgB;KACa;IAEtC,MAAM,EAAE;QACN,OAAO,EAAE;YACP,YAAY,EAAE,cAAM;SACrB;QACD,KAAK,EAAE,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,IAAI,CAAC,aAAK,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,cAAc,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC,CACxE;KACmC;CACvC,CAAC;AAEF,kBAAe,cAAM,CAAC"}

package/src/lib/eslint-plugin-modularity.d.ts

@@ -0,0 +1 @@
+export declare function eslintPluginModularity(): string;

package/src/lib/eslint-plugin-modularity.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eslintPluginModularity = eslintPluginModularity;
+function eslintPluginModularity() {
+    return 'eslint-plugin-modularity';
+}
+//# sourceMappingURL=eslint-plugin-modularity.js.map

package/src/lib/eslint-plugin-modularity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint-plugin-modularity.js","sourceRoot":"","sources":["../../../../../packages/eslint-plugin-modularity/src/lib/eslint-plugin-modularity.ts"],"names":[],"mappings":";;AAAA,wDAEC;AAFD,SAAgB,sBAAsB;IACpC,OAAO,0BAA0B,CAAC;AACpC,CAAC"}

package/src/rules/ddd-anemic-domain-model.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+/**
+ * ESLint Rule: ddd-anemic-domain-model
+ * Detects entities with only getters/setters and no business logic
+ * Priority 1: Domain-Driven Design
+ *
+ * @see https://martinfowler.com/bliki/AnemicDomainModel.html
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+type MessageIds = 'anemicDomainModel' | 'addBusinessLogic' | 'migrateToRichModel' | 'identifyAggregateRoot';
+export interface Options {
+    /** Minimum methods required to not be considered anemic. Default: 1 */
+    minBusinessMethods?: number;
+    /** Ignore DTOs and data transfer objects. Default: true */
+    ignoreDtos?: boolean;
+    /** Patterns for DTO identification. Default: ['DTO', 'Dto', 'Data', 'Request', 'Response'] */
+    dtoPatterns?: string[];
+}
+type RuleOptions = [Options?];
+export declare const dddAnemicDomainModel: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};

package/src/rules/ddd-anemic-domain-model.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dddAnemicDomainModel = void 0;
+const eslint_devkit_1 = require("@interlace/eslint-devkit");
+const eslint_devkit_2 = require("@interlace/eslint-devkit");
+/**
+ * Check if a class is likely a DTO
+ */
+function isDto(className, dtoPatterns) {
+    return dtoPatterns.some(pattern => className.includes(pattern));
+}
+/**
+ * Check if a method is a simple getter/setter in disguise
+ */
+function isSimpleGetterSetter(member) {
+    if (member.value.type !== 'FunctionExpression') {
+        return false;
+    }
+    const methodName = member.key.type === 'Identifier' ? member.key.name : '';
+    const body = member.value.body;
+    if (body.type !== 'BlockStatement' || body.body.length === 0) {
+        return false;
+    }
+    // Check if it's a simple getter (getName() { return this.name; })
+    if (methodName.startsWith('get') && body.body.length === 1) {
+        const statement = body.body[0];
+        if (statement.type === 'ReturnStatement' && statement.argument) {
+            // Simple return statement
+            return true;
+        }
+    }
+    // Check if it's a simple setter (setName(name) { this.name = name; })
+    if (methodName.startsWith('set') && body.body.length === 1) {
+        const statement = body.body[0];
+        if (statement.type === 'ExpressionStatement' &&
+            statement.expression.type === 'AssignmentExpression') {
+            // Simple assignment
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Check if a method is pure delegation (just calls another method and returns)
+ * e.g., save() { return this.repository.save(this); }
+ * Does NOT count calls to array methods, built-ins, or methods on this
+ */
+function isPureDelegation(member) {
+    if (member.value.type !== 'FunctionExpression') {
+        return false;
+    }
+    const body = member.value.body;
+    if (body.type !== 'BlockStatement' || body.body.length !== 1) {
+        return false;
+    }
+    const statement = body.body[0];
+    // Array/collection methods that are business logic, not delegation
+    const builtInMethods = new Set([
+        'map', 'filter', 'reduce', 'forEach', 'find', 'findIndex', 'some', 'every',
+        'includes', 'indexOf', 'slice', 'concat', 'join', 'sort', 'reverse',
+        'push', 'pop', 'shift', 'unshift', 'splice', 'flat', 'flatMap',
+        'toString', 'valueOf', 'toJSON'
+    ]);
+    // Check: return someService.method(...) or return this.service.method(...) 
+    if (statement.type === 'ReturnStatement' && statement.argument) {
+        const arg = statement.argument;
+        if (arg.type === 'CallExpression' && arg.callee.type === 'MemberExpression') {
+            const callee = arg.callee;
+            const methodName = callee.property.type === 'Identifier' ? callee.property.name : '';
+            // Skip if it's a built-in method (not delegation)
+            if (builtInMethods.has(methodName)) {
+                return false;
+            }
+            // It's a delegation call, check if it's to an external service
+            const object = callee.object;
+            if (object.type === 'MemberExpression' &&
+                object.object.type === 'ThisExpression') {
+                // this.service.method() pattern - but only if not a built-in
+                const propName = object.property.type === 'Identifier' ? object.property.name : '';
+                // Common service patterns: repository, service, api, client, dao
+                if (propName.includes('repository') || propName.includes('service') ||
+                    propName.includes('api') || propName.includes('client') ||
+                    propName.includes('dao') || propName.includes('Repository') ||
+                    propName.includes('Service') || propName.includes('Api')) {
+                    return true;
+                }
+                return false; // this.items.method() is business logic
+            }
+            if (object.type === 'Identifier') {
+                // externalService.method() pattern - definitely delegation
+                return true;
+            }
+        }
+    }
+    // Check: this.service.method(...) without return (void delegation)
+    if (statement.type === 'ExpressionStatement') {
+        const expr = statement.expression;
+        if (expr.type === 'CallExpression' && expr.callee.type === 'MemberExpression') {
+            const callee = expr.callee;
+            const methodName = callee.property.type === 'Identifier' ? callee.property.name : '';
+            // Skip built-in methods
+            if (builtInMethods.has(methodName)) {
+                return false;
+            }
+            const object = callee.object;
+            if (object.type === 'MemberExpression' &&
+                object.object.type === 'ThisExpression') {
+                const propName = object.property.type === 'Identifier' ? object.property.name : '';
+                if (propName.includes('repository') || propName.includes('service') ||
+                    propName.includes('api') || propName.includes('client') ||
+                    propName.includes('dao') || propName.includes('Repository') ||
+                    propName.includes('Service') || propName.includes('Api')) {
+                    return true;
+                }
+                return false;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Count business logic methods (non-getter/setter/delegation)
+ */
+function countBusinessMethods(node) {
+    let count = 0;
+    for (const member of node.body.body) {
+        if (member.type === 'MethodDefinition') {
+            const methodName = member.key.type === 'Identifier' ? member.key.name : '';
+            // Skip getters and setters
+            if (member.kind === 'get' || member.kind === 'set') {
+                continue;
+            }
+            // Skip constructor
+            if (methodName === 'constructor') {
+                continue;
+            }
+            // Skip simple getter/setter methods in disguise
+            if (isSimpleGetterSetter(member)) {
+                continue;
+            }
+            // Skip pure delegation methods (just calls external service)
+            if (isPureDelegation(member)) {
+                continue;
+            }
+            // Count methods (any method that's not a getter/setter/constructor/delegation is business logic)
+            const valueType = member.value.type;
+            if (valueType === 'FunctionExpression' || valueType === 'ArrowFunctionExpression') {
+                count++;
+            }
+        }
+        else if (member.type === 'PropertyDefinition') {
+            // Property definitions are not business logic
+            continue;
+        }
+    }
+    return count;
+}
+exports.dddAnemicDomainModel = (0, eslint_devkit_2.createRule)({
+    name: 'ddd-anemic-domain-model',
+    meta: {
+        type: 'suggestion',
+        docs: {
+            description: 'Detects entities with only getters/setters and no business logic',
+        },
+        messages: {
+            anemicDomainModel: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.ARCHITECTURE,
+                issueName: 'Anemic domain model',
+                description: 'Class {{className}} has no business logic (only getters/setters)',
+                severity: 'MEDIUM',
+                fix: 'Add business logic methods to create a rich domain model',
+                documentationLink: 'https://martinfowler.com/bliki/AnemicDomainModel.html',
+            }),
+            addBusinessLogic: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.INFO,
+                issueName: 'Add Business Logic',
+                description: 'Add business logic methods',
+                severity: 'LOW',
+                fix: 'Add domain behavior methods to {{className}}',
+                documentationLink: 'https://martinfowler.com/bliki/AnemicDomainModel.html',
+            }),
+            migrateToRichModel: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.INFO,
+                issueName: 'Migrate to Rich Model',
+                description: 'Migrate to rich domain model',
+                severity: 'LOW',
+                fix: 'Encapsulate behavior with data',
+                documentationLink: 'https://martinfowler.com/bliki/AnemicDomainModel.html',
+            }),
+            identifyAggregateRoot: (0, eslint_devkit_1.formatLLMMessage)({
+                icon: eslint_devkit_1.MessageIcons.INFO,
+                issueName: 'Identify Aggregate Root',
+                description: 'Identify aggregate root and enforce invariants',
+                severity: 'LOW',
+                fix: 'Define aggregate boundaries and enforce invariants',
+                documentationLink: 'https://martinfowler.com/bliki/DDD_Aggregate.html',
+            }),
+        },
+        schema: [
+            {
+                type: 'object',
+                properties: {
+                    minBusinessMethods: {
+                        type: 'number',
+                        default: 1,
+                        minimum: 0,
+                        description: 'Minimum business methods required',
+                    },
+                    ignoreDtos: {
+                        type: 'boolean',
+                        default: true,
+                        description: 'Ignore DTOs and data transfer objects',
+                    },
+                    dtoPatterns: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        default: ['DTO', 'Dto', 'Data', 'Request', 'Response', 'Payload'],
+                        description: 'Patterns for DTO identification',
+                    },
+                },
+                additionalProperties: false,
+            },
+        ],
+    },
+    defaultOptions: [
+        {
+            minBusinessMethods: 1,
+            ignoreDtos: true,
+            dtoPatterns: ['DTO', 'Dto', 'Data', 'Request', 'Response', 'Payload'],
+        },
+    ],
+    create(context, [options = {}]) {
+        const { minBusinessMethods = 1, ignoreDtos = true, dtoPatterns = ['DTO', 'Dto', 'Data', 'Request', 'Response', 'Payload'], } = options || {};
+        /**
+         * Check class declarations
+         */
+        function checkClass(node) {
+            if (!node.id) {
+                return; // Anonymous class
+            }
+            const className = node.id.name;
+            // Check if it's a DTO
+            if (ignoreDtos && isDto(className, dtoPatterns)) {
+                return;
+            }
+            const businessMethodCount = countBusinessMethods(node);
+            if (businessMethodCount < minBusinessMethods) {
+                context.report({
+                    node,
+                    messageId: 'anemicDomainModel',
+                    data: {
+                        className,
+                    },
+                    suggest: [
+                        {
+                            messageId: 'addBusinessLogic',
+                            fix: () => null,
+                            data: {
+                                className,
+                            },
+                        },
+                        {
+                            messageId: 'migrateToRichModel',
+                            fix: () => null,
+                        },
+                        {
+                            messageId: 'identifyAggregateRoot',
+                            fix: () => null,
+                        },
+                    ],
+                });
+            }
+        }
+        return {
+            ClassDeclaration: checkClass,
+            ClassExpression: checkClass,
+        };
+    },
+});
+//# sourceMappingURL=ddd-anemic-domain-model.js.map

package/src/rules/ddd-anemic-domain-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ddd-anemic-domain-model.js","sourceRoot":"","sources":["../../../../../packages/eslint-plugin-modularity/src/rules/ddd-anemic-domain-model.ts"],"names":[],"mappings":"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"}

package/src/rules/ddd-value-object-immutability.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Copyright (c) 2025 Ofri Peretz
+ * Licensed under the MIT License. Use of this source code is governed by the
+ * MIT license that can be found in the LICENSE file.
+ */
+/**
+ * ESLint Rule: ddd-value-object-immutability
+ * Validates value objects are properly immutable
+ * Priority 1: Domain-Driven Design
+ *
+ * @see https://martinfowler.com/bliki/ValueObject.html
+ */
+import type { TSESLint } from '@interlace/eslint-devkit';
+type MessageIds = 'mutableValueObject' | 'mutableNestedType' | 'addReadonly' | 'useObjectFreeze' | 'makeImmutable';
+export interface Options {
+    /** Patterns to identify value objects. Default: ['Value', 'VO', 'ValueObject'] */
+    valueObjectPatterns?: string[];
+    /** Require readonly modifiers. Default: true */
+    requireReadonly?: boolean;
+    /** Check for Object.freeze usage. Default: true */
+    checkObjectFreeze?: boolean;
+}
+type RuleOptions = [Options?];
+export declare const dddValueObjectImmutability: TSESLint.RuleModule<MessageIds, RuleOptions, unknown, TSESLint.RuleListener> & {
+    name: string;
+};
+export {};