@obinexusltd/obix-config-eslint 0.1.0

package/README.md

@@ -0,0 +1,237 @@
+# @obinexusltd/obix-config-eslint
+
+> ESLint v9 flat configuration for OBIX SDK packages — part of the `@obinexusltd/obix-monorepo`.
+
+Provides typed factory functions, ready-to-use flat config files, and environment-specific rule presets for linting OBIX SDK source code with ESLint 9 + typescript-eslint 8.
+
+---
+
+## Installation
+
+Registered automatically as an npm workspace package:
+
+```bash
+# From monorepo root
+npm install
+```
+
+To add it as a dependency in a consumer package:
+
+```json
+{
+  "devDependencies": {
+    "@obinexusltd/obix-config-eslint": "workspace:*"
+  }
+}
+```
+
+---
+
+## Package Structure
+
+```
+packages/config/eslint/
+├── eslint.config.js          ← Root flat config (./flat export)
+├── base/
+│   └── eslint.config.js      ← Base TypeScript rules
+├── development/
+│   └── eslint.config.js      ← Dev config (console allowed, any-type off)
+├── production/
+│   └── eslint.config.js      ← Prod config (no-console error, strict types)
+└── src/
+    └── index.ts              ← TypeScript programmatic API (compiled to dist/)
+```
+
+---
+
+## Requirements
+
+This package targets **ESLint v9 flat config** only. The legacy `.eslintrc` format is not supported.
+
+Your `eslint.config.js` (or `eslint.config.mjs`) must be present at the project root.
+
+---
+
+## Programmatic API
+
+```ts
+import {
+  createBaseConfig,
+  createDevConfig,
+  createProdConfig,
+  resolveConfig,
+} from '@obinexusltd/obix-config-eslint';
+
+// Base — TypeScript-eslint recommended + OBIX core rules
+const base = createBaseConfig();
+
+// Development — relaxed console/any rules
+const dev = createDevConfig({ typescript: true });
+
+// Production — strict, no-console error, explicit return types
+const prod = createProdConfig();
+
+// Resolve by environment string
+const config = resolveConfig('production', { files: ['src/**/*.ts'] });
+```
+
+### Factory Functions
+
+| Function | Description |
+|----------|-------------|
+| `createBaseConfig(opts?)` | Base TypeScript rules, `no-console: warn` |
+| `createDevConfig(opts?)` | Dev: `no-console: off`, `no-explicit-any: off` |
+| `createProdConfig(opts?)` | Prod: `no-console: error`, `no-explicit-any: error`, strict types |
+| `resolveConfig(env, opts?)` | Delegates by `'base' \| 'development' \| 'production'` |
+
+All factories return `Array<Record<string, unknown>>` — a plain flat config array. Spread into your own `tseslint.config(...)` call or use directly.
+
+### `ObixEsLintOptions`
+
+```ts
+interface ObixEsLintOptions {
+  typescript?: boolean;        // default: true  — enable @typescript-eslint rules
+  imports?: boolean;           // default: false — enable eslint-plugin-import
+  unicorn?: boolean;           // default: false — enable eslint-plugin-unicorn
+  files?: string[];            // default: ['**/*.ts', '**/*.tsx']
+  ignores?: string[];          // default: ['dist/**', 'node_modules/**', '**/*.d.ts']
+  rules?: Record<string, unknown>; // default: {} — merged on top of preset
+}
+```
+
+### Static Descriptors
+
+```ts
+import {
+  baseConfig,
+  developmentConfig,
+  productionConfig,
+} from '@obinexusltd/obix-config-eslint';
+```
+
+---
+
+## Using Config Files Directly
+
+### Root flat config (recommended)
+
+Reference in your project's `eslint.config.js`:
+
+```js
+// eslint.config.js
+import obixConfig from '@obinexusltd/obix-config-eslint/flat';
+
+export default [
+  ...obixConfig,
+  // your project-specific overrides
+  {
+    rules: {
+      'no-console': 'off', // override for this project
+    },
+  },
+];
+```
+
+Or with the `tseslint.config()` helper:
+
+```js
+import tseslint from 'typescript-eslint';
+import obixConfig from '@obinexusltd/obix-config-eslint/flat';
+
+export default tseslint.config(
+  ...obixConfig,
+  {
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
+);
+```
+
+### Base config
+
+```js
+import base from '@obinexusltd/obix-config-eslint/base';
+export default [...base];
+```
+
+### Development config
+
+```js
+import devConfig from '@obinexusltd/obix-config-eslint/development';
+export default [...devConfig];
+```
+
+### Production config
+
+```js
+import prodConfig from '@obinexusltd/obix-config-eslint/production';
+export default [...prodConfig];
+```
+
+---
+
+## Environment Rule Reference
+
+| Rule | `base` | `development` | `production` |
+|------|--------|---------------|--------------|
+| `no-console` | `warn` | `off` | `error` |
+| `no-debugger` | `error` | `warn` | `error` |
+| `@typescript-eslint/no-explicit-any` | `warn` | `off` | `error` |
+| `@typescript-eslint/no-unused-vars` | `error` | `error` | `error` |
+| `@typescript-eslint/explicit-function-return-type` | — | — | `warn` |
+| `@typescript-eslint/strict-boolean-expressions` | — | — | `warn` |
+| `@typescript-eslint/consistent-type-imports` | `warn` | `off` | `error` |
+| `@typescript-eslint/no-non-null-assertion` | `warn` | `warn` | `error` |
+| `prefer-const` | `error` | `error` | `error` |
+| `no-var` | `error` | `error` | `error` |
+| `eqeqeq` | `error` | `error` | `error` |
+| `curly` | `error` | `error` | `error` |
+
+---
+
+## Peer Dependencies
+
+Required:
+
+```json
+{
+  "devDependencies": {
+    "@eslint/js": ">=9.0.0",
+    "eslint": ">=9.0.0",
+    "typescript-eslint": ">=8.0.0"
+  }
+}
+```
+
+Optional:
+
+```json
+{
+  "devDependencies": {
+    "eslint-plugin-import": "*",
+    "eslint-plugin-unicorn": "*"
+  }
+}
+```
+
+---
+
+## Comparison with Other OBIX Config Packages
+
+| Feature | ESLint | TypeScript | Rollup | Webpack |
+|---------|--------|------------|--------|---------|
+| Primary role | Linting | Type checking | Library bundling | App bundling |
+| TypeScript support | `typescript-eslint` | Native | `@rollup/plugin-typescript` | `ts-loader` |
+| Output format | Report only | `.d.ts` + `.js` | ESM / CJS | Bundle |
+| Best for | Code quality | Type safety | SDK packages | Browser apps |
+
+Use ESLint **alongside** your build toolchain — not instead of it.
+
+---
+
+## Author
+
+**Nnamdi Michael Okpala** — OBINexus &lt;okpalan@protonmail.com&gt;
+
+Part of the [OBIX Heart/Soul UI/UX SDK](https://github.com/OBINexusComputing/obix-sdk) monorepo.

package/base/eslint.config.js

@@ -0,0 +1,43 @@
+// @obinexusltd/obix-config-eslint/base
+// Base flat config — TypeScript-eslint recommended + OBIX core rules.
+// Environment-neutral: suitable as a common foundation for dev and prod configs.
+//
+// Usage:
+//   import base from '@obinexusltd/obix-config-eslint/base';
+//   export default [...base, { rules: { 'no-console': 'off' } }];
+
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  // ESLint recommended baseline
+  js.configs.recommended,
+
+  // typescript-eslint recommended rules (flat config array)
+  ...tseslint.configs.recommended,
+
+  // OBIX base TypeScript rules
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    rules: {
+      // TypeScript
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/consistent-type-imports': ['warn', { prefer: 'type-imports' }],
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+
+      // Best practices
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'no-console': 'warn',
+      'no-debugger': 'error',
+      eqeqeq: ['error', 'always'],
+      curly: ['error', 'all'],
+    },
+  },
+
+  // Global ignores
+  {
+    ignores: ['dist/**', 'node_modules/**', '**/*.d.ts'],
+  },
+);

package/development/eslint.config.js

@@ -0,0 +1,30 @@
+// @obinexusltd/obix-config-eslint/development
+// Development flat config — relaxes console/debugger and any-type rules.
+// Extends the OBIX base config with developer-friendly overrides.
+//
+// Usage:
+//   import devConfig from '@obinexusltd/obix-config-eslint/development';
+//   export default [...devConfig, ...yourOverrides];
+
+import base from '../base/eslint.config.js';
+
+export default [
+  ...base,
+
+  // Development-specific rule relaxations
+  {
+    rules: {
+      // Allow console during development
+      'no-console': 'off',
+
+      // Downgrade debugger from error to warning
+      'no-debugger': 'warn',
+
+      // Allow `any` during active development
+      '@typescript-eslint/no-explicit-any': 'off',
+
+      // Type imports not enforced during development
+      '@typescript-eslint/consistent-type-imports': 'off',
+    },
+  },
+];

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/** ESLint build environment */
+export type ESLintEnv = 'base' | 'development' | 'production';
+/** Options accepted by all factory functions */
+export interface ObixEsLintOptions {
+    /**
+     * Enable TypeScript-specific rules via typescript-eslint.
+     * Default: `true`
+     */
+    typescript?: boolean;
+    /**
+     * Enable import ordering rules (requires optional `eslint-plugin-import`).
+     * Default: `false`
+     */
+    imports?: boolean;
+    /**
+     * Enable unicorn opinionated rules (requires optional `eslint-plugin-unicorn`).
+     * Default: `false`
+     */
+    unicorn?: boolean;
+    /**
+     * Glob patterns for files to lint.
+     * Default: `['**\/*.ts', '**\/*.tsx']`
+     */
+    files?: string[];
+    /**
+     * Glob patterns for files to ignore.
+     * Default: `['dist/**', 'node_modules/**', '**\/*.d.ts']`
+     */
+    ignores?: string[];
+    /**
+     * Additional rule overrides merged on top of the environment preset.
+     * Default: `{}`
+     */
+    rules?: Record<string, unknown>;
+}
+/** Fully-resolved options — all fields present */
+export type ResolvedObixEsLintOptions = Required<ObixEsLintOptions>;
+/** Static descriptor used by obix-cli to introspect the config package */
+export interface ObixEsLintConfig {
+    env: ESLintEnv;
+    options: ResolvedObixEsLintOptions;
+}
+export declare const baseConfig: ObixEsLintConfig;
+export declare const developmentConfig: ObixEsLintConfig;
+export declare const productionConfig: ObixEsLintConfig;
+/**
+ * Create a base ESLint flat config array.
+ * Includes TypeScript-eslint recommended rules and OBIX base rules.
+ * Suitable as a starting point — extends `typescript-eslint/recommended`.
+ *
+ * Returns a plain array shaped like an ESLint v9 flat config.
+ * Consumer must spread with `@eslint/js` and `typescript-eslint` entries.
+ */
+export declare function createBaseConfig(opts?: ObixEsLintOptions): Array<Record<string, unknown>>;
+/**
+ * Create a development ESLint flat config array.
+ * Relaxed rules: `no-console` off, `no-debugger` warn, `no-explicit-any` off.
+ */
+export declare function createDevConfig(opts?: ObixEsLintOptions): Array<Record<string, unknown>>;
+/**
+ * Create a production ESLint flat config array.
+ * Strict rules: `no-console` error, `no-debugger` error, `no-explicit-any` error,
+ * `explicit-function-return-type` warn, `strict-boolean-expressions` warn.
+ */
+export declare function createProdConfig(opts?: ObixEsLintOptions): Array<Record<string, unknown>>;
+/**
+ * Resolve an ESLint flat config array by environment name.
+ * Delegates to `createBaseConfig`, `createDevConfig`, or `createProdConfig`.
+ */
+export declare function resolveConfig(env: ESLintEnv, opts?: ObixEsLintOptions): Array<Record<string, unknown>>;
+//# 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":"AAQA,+BAA+B;AAC/B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,CAAC;AAE9D,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,kDAAkD;AAClD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAEpE,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,yBAAyB,CAAC;CACpC;AAyBD,eAAO,MAAM,UAAU,EAAE,gBAGxB,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAU/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAY9B,CAAC;AAkEF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMzF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMxF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAMzF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,EACd,IAAI,CAAC,EAAE,iBAAiB,GACvB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAOhC"}

package/dist/index.js

@@ -0,0 +1,155 @@
+// @obinexusltd/obix-config-eslint
+// Programmatic ESLint configuration factory for OBIX SDK packages.
+// NOTE: This module does NOT import eslint or typescript-eslint at compile time.
+// All config objects are plain arrays matching ESLint v9 flat config shape.
+// ESLint and typescript-eslint remain peerDependencies consumed at runtime.
+// ─── Defaults ─────────────────────────────────────────────────────────────────
+const DEFAULT_OPTIONS = {
+    typescript: true,
+    imports: false,
+    unicorn: false,
+    files: ['**/*.ts', '**/*.tsx'],
+    ignores: ['dist/**', 'node_modules/**', '**/*.d.ts'],
+    rules: {},
+};
+function resolveOptions(overrides) {
+    return {
+        ...DEFAULT_OPTIONS,
+        ...overrides,
+        files: overrides?.files ?? DEFAULT_OPTIONS.files,
+        ignores: overrides?.ignores ?? DEFAULT_OPTIONS.ignores,
+        rules: { ...DEFAULT_OPTIONS.rules, ...overrides?.rules },
+    };
+}
+// ─── Static descriptors (for obix-cli indexing) ───────────────────────────────
+export const baseConfig = {
+    env: 'base',
+    options: { ...DEFAULT_OPTIONS },
+};
+export const developmentConfig = {
+    env: 'development',
+    options: {
+        ...DEFAULT_OPTIONS,
+        rules: {
+            'no-console': 'off',
+            'no-debugger': 'warn',
+            '@typescript-eslint/no-explicit-any': 'off',
+        },
+    },
+};
+export const productionConfig = {
+    env: 'production',
+    options: {
+        ...DEFAULT_OPTIONS,
+        rules: {
+            'no-console': 'error',
+            'no-debugger': 'error',
+            '@typescript-eslint/no-explicit-any': 'error',
+            '@typescript-eslint/explicit-function-return-type': 'warn',
+            '@typescript-eslint/strict-boolean-expressions': 'warn',
+        },
+    },
+};
+// ─── Internal helpers ──────────────────────────────────────────────────────────
+/** Core TypeScript + best-practice rules for all environments */
+function buildBaseRules(opts) {
+    const rules = {
+        'prefer-const': 'error',
+        'no-var': 'error',
+        'no-console': 'warn',
+        'no-debugger': 'error',
+        eqeqeq: ['error', 'always'],
+        curly: ['error', 'all'],
+    };
+    if (opts.typescript) {
+        Object.assign(rules, {
+            '@typescript-eslint/no-explicit-any': 'warn',
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+            '@typescript-eslint/consistent-type-imports': ['warn', { prefer: 'type-imports' }],
+            '@typescript-eslint/no-non-null-assertion': 'warn',
+        });
+    }
+    return { ...rules, ...opts.rules };
+}
+/** Relaxed rule overrides for development */
+function buildDevRules(opts) {
+    return {
+        ...buildBaseRules(opts),
+        'no-console': 'off',
+        'no-debugger': 'warn',
+        '@typescript-eslint/no-explicit-any': 'off',
+        ...opts.rules,
+    };
+}
+/** Strict rule overrides for production */
+function buildProdRules(opts) {
+    return {
+        ...buildBaseRules(opts),
+        'no-console': 'error',
+        'no-debugger': 'error',
+        '@typescript-eslint/no-explicit-any': 'error',
+        '@typescript-eslint/explicit-function-return-type': 'warn',
+        '@typescript-eslint/strict-boolean-expressions': 'warn',
+        ...opts.rules,
+    };
+}
+/** Build the files config object for a flat config entry */
+function buildFilesEntry(opts, rules) {
+    return { files: opts.files, rules };
+}
+/** Build the ignores config object for a flat config entry */
+function buildIgnoresEntry(opts) {
+    return { ignores: opts.ignores };
+}
+// ─── Factory functions ─────────────────────────────────────────────────────────
+/**
+ * Create a base ESLint flat config array.
+ * Includes TypeScript-eslint recommended rules and OBIX base rules.
+ * Suitable as a starting point — extends `typescript-eslint/recommended`.
+ *
+ * Returns a plain array shaped like an ESLint v9 flat config.
+ * Consumer must spread with `@eslint/js` and `typescript-eslint` entries.
+ */
+export function createBaseConfig(opts) {
+    const o = resolveOptions(opts);
+    return [
+        buildFilesEntry(o, buildBaseRules(o)),
+        buildIgnoresEntry(o),
+    ];
+}
+/**
+ * Create a development ESLint flat config array.
+ * Relaxed rules: `no-console` off, `no-debugger` warn, `no-explicit-any` off.
+ */
+export function createDevConfig(opts) {
+    const o = resolveOptions(opts);
+    return [
+        buildFilesEntry(o, buildDevRules(o)),
+        buildIgnoresEntry(o),
+    ];
+}
+/**
+ * Create a production ESLint flat config array.
+ * Strict rules: `no-console` error, `no-debugger` error, `no-explicit-any` error,
+ * `explicit-function-return-type` warn, `strict-boolean-expressions` warn.
+ */
+export function createProdConfig(opts) {
+    const o = resolveOptions(opts);
+    return [
+        buildFilesEntry(o, buildProdRules(o)),
+        buildIgnoresEntry(o),
+    ];
+}
+/**
+ * Resolve an ESLint flat config array by environment name.
+ * Delegates to `createBaseConfig`, `createDevConfig`, or `createProdConfig`.
+ */
+export function resolveConfig(env, opts) {
+    switch (env) {
+        case 'production': return createProdConfig(opts);
+        case 'development': return createDevConfig(opts);
+        case 'base':
+        default: return createBaseConfig(opts);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/eslint.config.js

@@ -0,0 +1,48 @@
+// @obinexusltd/obix-config-eslint — root flat config (./flat export)
+// Ready-to-use ESLint v9 flat config with OBIX TypeScript defaults.
+//
+// Usage:
+//   // eslint.config.js in consumer package
+//   import obixConfig from '@obinexusltd/obix-config-eslint/flat';
+//   export default [...obixConfig, ...yourOverrides];
+//
+// Or with tseslint.config():
+//   import tseslint from 'typescript-eslint';
+//   import obixConfig from '@obinexusltd/obix-config-eslint/flat';
+//   export default tseslint.config(...obixConfig, { rules: { ... } });
+
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+
+export default tseslint.config(
+  // ESLint recommended baseline
+  js.configs.recommended,
+
+  // typescript-eslint recommended rules (flat config array)
+  ...tseslint.configs.recommended,
+
+  // OBIX standard TypeScript rules
+  {
+    files: ['**/*.ts', '**/*.tsx'],
+    rules: {
+      // TypeScript
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+      '@typescript-eslint/consistent-type-imports': ['warn', { prefer: 'type-imports' }],
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+
+      // Best practices
+      'prefer-const': 'error',
+      'no-var': 'error',
+      'no-console': 'warn',
+      'no-debugger': 'error',
+      eqeqeq: ['error', 'always'],
+      curly: ['error', 'all'],
+    },
+  },
+
+  // Global ignores
+  {
+    ignores: ['dist/**', 'node_modules/**', '**/*.d.ts'],
+  },
+);

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@obinexusltd/obix-config-eslint",
+  "version": "0.1.0",
+  "description": "OBIX ESLint configuration for OBIX CLI and SDK packages",
+  "author": "Nnamdi Michael Okpala <okpalan@protonmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./base": "./base/eslint.config.js",
+    "./development": "./development/eslint.config.js",
+    "./production": "./production/eslint.config.js",
+    "./flat": "./eslint.config.js"
+  },
+  "files": [
+    "dist",
+    "eslint.config.js",
+    "base",
+    "development",
+    "production"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"No tests for config package\" && exit 0"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "peerDependencies": {
+    "@eslint/js": ">=9.0.0",
+    "eslint": ">=9.0.0",
+    "typescript-eslint": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint-plugin-import": { "optional": true },
+    "eslint-plugin-unicorn": { "optional": true }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/production/eslint.config.js

@@ -0,0 +1,39 @@
+// @obinexusltd/obix-config-eslint/production
+// Production flat config — enforces maximum strictness for release builds.
+// Extends the OBIX base config with production-hardened overrides.
+//
+// Usage:
+//   import prodConfig from '@obinexusltd/obix-config-eslint/production';
+//   export default [...prodConfig, ...yourOverrides];
+
+import base from '../base/eslint.config.js';
+
+export default [
+  ...base,
+
+  // Production-specific strict overrides
+  {
+    rules: {
+      // No console output in production code
+      'no-console': 'error',
+
+      // No leftover debugger statements
+      'no-debugger': 'error',
+
+      // Disallow `any` — forces explicit typing
+      '@typescript-eslint/no-explicit-any': 'error',
+
+      // Require explicit return types on exported functions
+      '@typescript-eslint/explicit-function-return-type': 'warn',
+
+      // Prevent unintended boolean coercions
+      '@typescript-eslint/strict-boolean-expressions': 'warn',
+
+      // Enforce type imports for tree-shaking
+      '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+
+      // No non-null assertions in production
+      '@typescript-eslint/no-non-null-assertion': 'error',
+    },
+  },
+];