@iviva/uxp-lint 0.0.1

package/README.md

@@ -0,0 +1,273 @@
+# @iviva/uxp-lint
+
+Linting and validation tool for iviva v5 UXP apps. Enforces the patterns established across the System, Location, and User reference apps.
+
+## What it checks
+
+| Group | Rules |
+|-------|-------|
+| **Configuration.yml** | pageId format, nav group structure, duplicate links, otherRoutes redirects |
+| **bundle.json** | label vs component key, registerUI/bundle.json ID sync, localization order |
+| **Bulk Imports** | `name` attribute on root XML element |
+| **Folder Structure** | one .tsx per views/ subfolder, forms in forms/, services.ts required |
+| **Code Quality (ESLint)** | TypeScript recommended + React recommended + 9 custom UXP rules |
+| **Formatting (Prettier)** | All .ts/.tsx/.scss files match project Prettier config |
+| **SCSS Rules** | App-prefix class naming, no top-level .uxp-* overrides |
+| **Bundle Size** | dist/main.js under configured limit (default 1MB) |
+| **Duplicate Code** | Code clones ≥10 lines (via jscpd) |
+
+Run `uxp-lint --list-rules` to see all 23 rules with severity. Run `uxp-lint --explain <rule>` for details on any rule.
+
+---
+
+## Installation
+
+Install in the app you want to lint:
+
+```bash
+npm install -D @iviva/uxp-lint
+```
+
+Add a script to the app's `package.json`:
+
+```json
+"scripts": {
+  "lint": "uxp-lint",
+  "lint:fix": "uxp-lint --fix",
+  "lint:ci": "uxp-lint --ci"
+}
+```
+
+---
+
+## Setup
+
+On first run with no config file, an interactive setup wizard creates `.uxplintrc.json`:
+
+```bash
+npx uxp-lint
+```
+
+Or create `.uxplintrc.json` manually at the app root:
+
+```json
+{
+  "v5": true,
+  "viewsSrc": "./Resources/views/src",
+  "configYml": "./Configuration.yml",
+  "bundleJson": "./Resources/views/bundle.json",
+  "bulkImportsDir": "./BulkImports",
+  "rules": {},
+  "bundleSize": { "maxKb": 1024, "severity": "warn" },
+  "duplication": { "minLines": 10, "severity": "warn" },
+  "ai": { "enabled": false, "model": "claude-sonnet-4-6" }
+}
+```
+
+### App prefix (optional)
+
+The SCSS validator auto-detects your app prefix from `global.scss`. To set it explicitly:
+
+```json
+{ "appPrefix": "ilocapp_" }
+```
+
+### Override rule severity
+
+```json
+{
+  "rules": {
+    "no-hardcoded-jsx-text": "error",
+    "no-native-html-interactive": "off"
+  }
+}
+```
+
+---
+
+## Usage
+
+```bash
+# Interactive run (default)
+uxp-lint
+
+# Auto-fix formatting and safe ESLint issues
+uxp-lint --fix
+
+# CI mode — exits with code 1 on any error
+uxp-lint --ci
+
+# Write full report to a file (default: uxp-lint-report.txt)
+uxp-lint --report
+uxp-lint --report my-report.txt
+
+# List all rules
+uxp-lint --list-rules
+
+# Explain a specific rule
+uxp-lint --explain no-direct-uxp-override
+
+# Include AI code review (Claude API)
+UXP_CLAUDE_API_KEY=sk-ant-... uxp-lint --ai
+```
+
+### Terminal output
+
+Messages are grouped by file within each check group. Each file header shows the error and warning count at a glance:
+
+```
+  ── Code Quality (ESLint)
+
+     src/components/AuthManager.tsx  1 error  4 warnings
+         14:14  error  Component "AuthManager" should be wrapped with memo(). [uxp/require-memo]
+         28:8   warn   React Hook useEffect has a missing dependency: 'loadConfigs'. [react-hooks/exhaustive-deps]
+         ...
+```
+
+A summary table is always printed at the end:
+
+```
+  ┌────────────────────────────────┬────────┬──────────┬────────────┐
+  │ Group                          │ Status │ Errors   │ Warnings   │
+  ├────────────────────────────────┼────────┼──────────┼────────────┤
+  │ Configuration.yml              │   ✔    │        – │          – │
+  │ bundle.json                    │   ✔    │        – │          1 │
+  │ Code Quality (ESLint)          │   ✗    │      418 │        270 │
+  │ Formatting (Prettier)          │   ✔    │        – │        115 │
+  │ SCSS Rules                     │   ✗    │        2 │          – │
+  ├────────────────────────────────┼────────┼──────────┼────────────┤
+  │ Total                          │        │      420 │        398 │
+  └────────────────────────────────┴────────┴──────────┴────────────┘
+```
+
+With `--report`, per-group details are written to the file only; the terminal shows the summary table and the report path.
+
+---
+
+## Development
+
+### Prerequisites
+
+- Node ≥ 18
+- npm ≥ 9
+
+### Building
+
+```bash
+cd /path/to/uxp-lint
+
+# Install dependencies
+npm install
+
+# Build (compiles TypeScript to dist/)
+npm run build
+
+# Watch mode
+npm run watch
+```
+
+### Testing against a real app
+
+The fastest way to test is to point the CLI at a local v5 app without installing:
+
+```bash
+# From inside the app directory (e.g. Location/5.0)
+node /path/to/uxp-lint/bin/uxp-lint.js
+```
+
+Or use a temporary config file to avoid touching the app's own `.uxplintrc.json`:
+
+```bash
+# Write a temp config
+cat > /tmp/lint-test.json << 'EOF'
+{
+  "v5": true,
+  "viewsSrc": "./Resources/views/src",
+  "configYml": "./Configuration.yml",
+  "bulkImportsDir": "./BulkImports",
+  "rules": {},
+  "ai": { "enabled": false }
+}
+EOF
+
+# Copy to app dir, run, then clean up
+cp /tmp/lint-test.json /path/to/app/.uxplintrc.json
+node /path/to/uxp-lint/bin/uxp-lint.js --ci
+rm /path/to/app/.uxplintrc.json
+```
+
+### Testing specific features
+
+```bash
+# Verify all 23 rules are registered
+node bin/uxp-lint.js --list-rules
+
+# Test --explain for a rule (picks any rule id from --list-rules)
+node bin/uxp-lint.js --explain folder-structure
+node bin/uxp-lint.js --explain no-direct-uxp-override
+node bin/uxp-lint.js --explain require-memo
+
+# Test --fix (run inside an app directory with .uxplintrc.json)
+node /path/to/uxp-lint/bin/uxp-lint.js --fix
+```
+
+### Adding a new ESLint rule
+
+1. Create `src/eslint/rules/<rule-name>.ts`
+2. Export `doc: RuleDoc` and a default `Rule.RuleModule`
+3. Register in `src/eslint/config.ts` — add to `UXP_RULES` and `rules[...]`
+4. Import `doc` in `src/rule-registry.ts` and add to `ALL_RULES`
+5. Add the rule ID + default severity to `DEFAULT_CONFIG.rules` in `src/types.ts`
+6. `npm run build` — zero errors
+
+### Adding a new validator
+
+1. Create `src/validators/<name>.ts`
+2. Export `doc: RuleDoc` (or `docs: RuleDoc[]` for multiple rule IDs)
+3. Export an `async function validate<Name>(config, cwd): Promise<GroupResult>`
+4. Import and call it in `src/runner.ts`
+5. Import `doc`/`docs` in `src/rule-registry.ts` and add to `ALL_RULES`
+6. `npm run build` — zero errors
+
+### Project structure
+
+```
+src/
+  cli.ts                  Entry point — parses CLI args, calls runner
+  runner.ts               Orchestrates all validators in order
+  types.ts                Shared interfaces (LintConfig, GroupResult, RuleDoc, …)
+  rule-registry.ts        Collects all rule docs into ALL_RULES
+  rules-reader.ts         Public API: loadAllRules(), findRule(), getRulesAsContext()
+  reporter.ts             Console output formatting
+  setup.ts                Interactive first-run config wizard
+  eslint/
+    config.ts             Loads standard recommended configs + registers custom rules
+    rules/                9 custom UXP/iviva ESLint rules (each exports doc + Rule.RuleModule)
+  validators/             File-system and static validators (each exports doc + validate fn)
+
+bin/
+  uxp-lint.js             Shell wrapper that calls dist/cli.js
+
+templates/
+  prettier.config.js      Prettier config template (copied to project on first run)
+```
+
+---
+
+## Publishing
+
+Publishing is automated via GitHub Actions (`.github/workflows/npm-publish.yml`). The workflow runs on every push to `master` and publishes to npm only when the version in `package.json` has changed.
+
+**To release a new version:**
+
+1. Bump `version` in `package.json`
+2. Commit with a message starting with `Release`:
+   ```bash
+   git commit -m "Release 1.0.1"
+   git push
+   ```
+3. The workflow builds, publishes the package, and tags the commit `v1.0.1` automatically.
+
+**Required GitHub secrets:**
+- `NPM_AUTH_TOKEN` — npm access token with publish rights to `@iviva/uxp-lint`
+- `ACTION_MONITORING_SLACK` *(optional)* — Slack webhook for build status notifications

package/bin/uxp-lint.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli').main();

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function main(): Promise<void>;

package/dist/cli.js

@@ -0,0 +1,100 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const path_1 = __importDefault(require("path"));
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("./config");
+const runner_1 = require("./runner");
+const setup_1 = require("./setup");
+const rules_reader_1 = require("./rules-reader");
+const reporter_1 = require("./reporter");
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require('../package.json');
+async function main() {
+    var _a, _b, _c;
+    const program = new commander_1.Command();
+    program
+        .name('uxp-lint')
+        .description('Linting and validation tool for iviva v5 UXP apps')
+        .version(version)
+        .option('--fix', 'auto-fix formatting and safe ESLint issues')
+        .option('--ci', 'non-interactive mode — exit code 1 on any error')
+        .option('--ai', 'include AI-powered code review (requires Claude API key)')
+        .option('--report [file]', 'write full report to a file (default: uxp-lint-report.txt)')
+        .option('--explain <rule>', 'show documentation for a specific rule')
+        .option('--list-rules', 'list all rules with their severity');
+    program.parse(process.argv);
+    const opts = program.opts();
+    (0, reporter_1.printHeader)(version);
+    // --explain <rule>
+    if (opts.explain) {
+        const doc = (0, rules_reader_1.findRule)(opts.explain);
+        if (!doc) {
+            (0, reporter_1.printError)(`Rule "${opts.explain}" not found. Run --list-rules to see available rules.`);
+            process.exit(1);
+        }
+        console.log(chalk_1.default.bold(`  Rule: ${doc.id}`));
+        console.log(chalk_1.default.gray(`  Category: ${doc.category}  |  Severity: ${doc.severity}`));
+        console.log('');
+        console.log(`  ${doc.description}`);
+        if (doc.rationale)
+            console.log(chalk_1.default.gray(`\n  Why: ${doc.rationale}`));
+        if (doc.fix)
+            console.log(chalk_1.default.cyan(`\n  Fix: ${doc.fix}`));
+        console.log('');
+        return;
+    }
+    // --list-rules
+    if (opts.listRules) {
+        const rules = (0, rules_reader_1.loadAllRules)();
+        if (rules.length === 0) {
+            (0, reporter_1.printInfo)('No rule documentation found.');
+        }
+        else {
+            console.log(chalk_1.default.bold('  Available rules:'));
+            console.log('');
+            for (const rule of rules) {
+                const sev = rule.severity === 'error' ? chalk_1.default.red(rule.severity) : chalk_1.default.yellow(rule.severity);
+                console.log(`    ${sev.padEnd(14)}  ${chalk_1.default.cyan(rule.id.padEnd(32))}  ${chalk_1.default.gray(rule.description)}`);
+            }
+        }
+        console.log('');
+        return;
+    }
+    const cwd = process.cwd();
+    // Interactive setup if no config exists (and not in CI mode)
+    let config = (0, config_1.configExists)(cwd) ? (0, config_1.loadConfig)(cwd) : null;
+    if (!config) {
+        if (opts.ci) {
+            (0, reporter_1.printError)('No .uxplintrc.json found. Run uxp-lint (without --ci) to set up.');
+            process.exit(1);
+        }
+        config = await (0, setup_1.runSetup)();
+        (0, config_1.saveConfig)(config, cwd);
+        (0, reporter_1.printInfo)(`Saved .uxplintrc.json`);
+        console.log('');
+    }
+    // Resolve --report path: true (flag with no value) → default filename
+    const reportPath = opts.report
+        ? (typeof opts.report === 'string' ? opts.report : 'uxp-lint-report.txt')
+        : undefined;
+    try {
+        const { errors, reportPath: writtenPath } = await (0, runner_1.runAllValidators)(config, { fix: (_a = opts.fix) !== null && _a !== void 0 ? _a : false, ci: (_b = opts.ci) !== null && _b !== void 0 ? _b : false, ai: (_c = opts.ai) !== null && _c !== void 0 ? _c : false, report: reportPath }, cwd);
+        if (writtenPath) {
+            console.log(chalk_1.default.bold('  Report: ') + chalk_1.default.cyan(path_1.default.resolve(writtenPath)));
+            console.log('');
+        }
+        if (errors > 0) {
+            process.exit(1);
+        }
+    }
+    catch (e) {
+        (0, reporter_1.printError)(`Unexpected error: ${e}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import { LintConfig } from './types';
+export declare function configExists(cwd?: string): boolean;
+export declare function loadConfig(cwd?: string): LintConfig;
+export declare function saveConfig(config: LintConfig, cwd?: string): void;

package/dist/config.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configExists = configExists;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const types_1 = require("./types");
+const CONFIG_FILE = '.uxplintrc.json';
+function configExists(cwd = process.cwd()) {
+    return fs_1.default.existsSync(path_1.default.join(cwd, CONFIG_FILE));
+}
+function loadConfig(cwd = process.cwd()) {
+    var _a, _b, _c, _d;
+    const configPath = path_1.default.join(cwd, CONFIG_FILE);
+    if (!fs_1.default.existsSync(configPath)) {
+        return { ...types_1.DEFAULT_CONFIG };
+    }
+    try {
+        const raw = fs_1.default.readFileSync(configPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return {
+            ...types_1.DEFAULT_CONFIG,
+            ...parsed,
+            rules: { ...types_1.DEFAULT_CONFIG.rules, ...((_a = parsed.rules) !== null && _a !== void 0 ? _a : {}) },
+            bundleSize: { ...types_1.DEFAULT_CONFIG.bundleSize, ...((_b = parsed.bundleSize) !== null && _b !== void 0 ? _b : {}) },
+            duplication: { ...types_1.DEFAULT_CONFIG.duplication, ...((_c = parsed.duplication) !== null && _c !== void 0 ? _c : {}) },
+            ai: { ...types_1.DEFAULT_CONFIG.ai, ...((_d = parsed.ai) !== null && _d !== void 0 ? _d : {}) },
+        };
+    }
+    catch (e) {
+        throw new Error(`Failed to parse ${CONFIG_FILE}: ${e}`);
+    }
+}
+function saveConfig(config, cwd = process.cwd()) {
+    const configPath = path_1.default.join(cwd, CONFIG_FILE);
+    fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;AAMA,oCAEC;AAED,gCAmBC;AAED,gCAGC;AAlCD,4CAAoB;AACpB,gDAAwB;AACxB,mCAAqD;AAErD,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAEtC,SAAgB,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9C,OAAO,YAAE,CAAC,UAAU,CAAC,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,UAAU,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;;IAC5C,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC/C,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,GAAG,sBAAc,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAwB,CAAC;QACtD,OAAO;YACL,GAAG,sBAAc;YACjB,GAAG,MAAM;YACT,KAAK,EAAE,EAAE,GAAG,sBAAc,CAAC,KAAK,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,KAAK,mCAAI,EAAE,CAAC,EAAE;YAC3D,UAAU,EAAE,EAAE,GAAG,sBAAc,CAAC,UAAU,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,UAAU,mCAAI,EAAE,CAAC,EAAE;YAC1E,WAAW,EAAE,EAAE,GAAG,sBAAc,CAAC,WAAW,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,WAAW,mCAAI,EAAE,CAAC,EAAE;YAC7E,EAAE,EAAE,EAAE,GAAG,sBAAc,CAAC,EAAE,EAAE,GAAG,CAAC,MAAA,MAAM,CAAC,EAAE,mCAAI,EAAE,CAAC,EAAE;SACnD,CAAC;IACJ,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,WAAW,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED,SAAgB,UAAU,CAAC,MAAkB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC/C,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC/E,CAAC"}

package/dist/eslint/config.d.ts

@@ -0,0 +1,2 @@
+import { GroupResult, LintConfig } from '../types';
+export declare function runEslint(config: LintConfig, cwd: string, fix: boolean): Promise<GroupResult>;

package/dist/eslint/config.js

@@ -0,0 +1,225 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEslint = runEslint;
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const eslint_1 = require("eslint");
+// Suppress @typescript-eslint version mismatch warning — the app being linted
+// may have a newer TypeScript than @typescript-eslint/parser v7 officially supports.
+process.env['TYPESCRIPT_ESLINT_NO_VERSION_WARNING'] = '1';
+const require_memo_1 = __importDefault(require("./rules/require-memo"));
+const no_inline_styles_1 = __importDefault(require("./rules/no-inline-styles"));
+const url_params_form_state_1 = __importDefault(require("./rules/url-params-form-state"));
+const service_config_shape_1 = __importDefault(require("./rules/service-config-shape"));
+const no_fa_prefix_1 = __importDefault(require("./rules/no-fa-prefix"));
+const no_bad_hook_deps_1 = __importDefault(require("./rules/no-bad-hook-deps"));
+const no_hardcoded_jsx_text_1 = __importDefault(require("./rules/no-hardcoded-jsx-text"));
+const no_native_html_interactive_1 = __importDefault(require("./rules/no-native-html-interactive"));
+const event_name_format_1 = __importDefault(require("./rules/event-name-format"));
+// ── Custom uxp/ rules ──────────────────────────────────────────────────────
+const UXP_RULES = {
+    'require-memo': require_memo_1.default,
+    'no-inline-styles': no_inline_styles_1.default,
+    'url-params-form-state': url_params_form_state_1.default,
+    'service-config-shape': service_config_shape_1.default,
+    'no-fa-prefix': no_fa_prefix_1.default,
+    'no-bad-hook-deps': no_bad_hook_deps_1.default,
+    'no-hardcoded-jsx-text': no_hardcoded_jsx_text_1.default,
+    'no-native-html-interactive': no_native_html_interactive_1.default,
+    'event-name-format': event_name_format_1.default,
+};
+// Files excluded from linting — generated/vendor stubs
+const EXCLUDED_FILES = new Set(['uxp.ts', 'uxp.d.ts', 'designer.d.ts']);
+function collectSourceFiles(dir) {
+    if (!fs_1.default.existsSync(dir))
+        return [];
+    const results = [];
+    for (const entry of fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        const full = path_1.default.join(dir, entry.name);
+        if (entry.isDirectory() && entry.name !== 'node_modules' && entry.name !== 'dist') {
+            results.push(...collectSourceFiles(full));
+        }
+        else if (entry.isFile() &&
+            (entry.name.endsWith('.ts') || entry.name.endsWith('.tsx')) &&
+            !entry.name.endsWith('.d.ts') &&
+            !EXCLUDED_FILES.has(entry.name)) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+function sev(config, rule, fallback) {
+    var _a;
+    return (_a = config.rules[rule]) !== null && _a !== void 0 ? _a : fallback;
+}
+/**
+ * Load the recommended rule sets from each installed plugin and merge them.
+ * Using the Linter class (CJS-compatible) — no file-system plugin resolution needed.
+ */
+function buildRulesConfig(config, linter) {
+    const rules = {};
+    // ── eslint:recommended ──────────────────────────────────────────────────
+    // The Linter class has built-in access to eslint:recommended rules via getRules().
+    // We apply the ones flagged as recommended.
+    try {
+        const builtinRules = linter.getRules();
+        builtinRules.forEach((rule, name) => {
+            var _a, _b;
+            if ((_b = (_a = rule.meta) === null || _a === void 0 ? void 0 : _a.docs) === null || _b === void 0 ? void 0 : _b.recommended) {
+                rules[name] = 'error';
+            }
+        });
+    }
+    catch {
+        // fallback: manual subset of eslint:recommended essentials
+        Object.assign(rules, {
+            'no-debugger': 'error',
+            'no-dupe-keys': 'error',
+            'no-duplicate-case': 'error',
+            'no-undef': 'off', // TypeScript handles this
+            'no-unreachable': 'error',
+            'no-unused-vars': 'off', // @typescript-eslint/no-unused-vars is used instead
+        });
+    }
+    // ── @typescript-eslint/recommended ─────────────────────────────────────
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const tsPlugin = require('@typescript-eslint/eslint-plugin');
+        // Register all plugin rules
+        for (const [name, rule] of Object.entries(tsPlugin.rules)) {
+            linter.defineRule(`@typescript-eslint/${name}`, rule);
+        }
+        // Apply recommended config rules
+        for (const [name, entry] of Object.entries(tsPlugin.configs.recommended.rules)) {
+            if (entry !== 'off' && entry !== 0) {
+                rules[name] = entry;
+            }
+        }
+        // @typescript-eslint/recommended disables base no-unused-vars — ensure our version is on
+        rules['no-unused-vars'] = 'off'; // disabled in favour of @typescript-eslint version
+    }
+    catch {
+        // plugin not installed
+    }
+    // ── eslint-plugin-react/recommended ────────────────────────────────────
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const reactPlugin = require('eslint-plugin-react');
+        for (const [name, rule] of Object.entries(reactPlugin.rules)) {
+            linter.defineRule(`react/${name}`, rule);
+        }
+        for (const [name, entry] of Object.entries(reactPlugin.configs.recommended.rules)) {
+            if (entry !== 'off' && entry !== 0) {
+                rules[name] = entry;
+            }
+        }
+        // We use React 18 with the new JSX transform — suppress prop-types and react-in-scope
+        rules['react/prop-types'] = 'off';
+        rules['react/react-in-jsx-scope'] = 'off';
+        rules['react/display-name'] = 'warn';
+    }
+    catch {
+        // plugin not installed
+    }
+    // ── eslint-plugin-react-hooks/recommended ──────────────────────────────
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const hooksPlugin = require('eslint-plugin-react-hooks');
+        for (const [name, rule] of Object.entries(hooksPlugin.rules)) {
+            linter.defineRule(`react-hooks/${name}`, rule);
+        }
+        for (const [name, entry] of Object.entries(hooksPlugin.configs.recommended.rules)) {
+            if (entry !== 'off' && entry !== 0) {
+                rules[name] = entry;
+            }
+        }
+    }
+    catch {
+        // plugin not installed
+    }
+    // ── iviva / UXP custom rules (uxp/ prefix) ─────────────────────────────
+    rules['uxp/require-memo'] = sev(config, 'require-memo', 'error');
+    rules['uxp/no-inline-styles'] = sev(config, 'no-inline-styles', 'error');
+    rules['uxp/url-params-form-state'] = sev(config, 'url-params-form-state', 'error');
+    rules['uxp/service-config-shape'] = sev(config, 'service-config-shape', 'error');
+    rules['uxp/no-fa-prefix'] = sev(config, 'no-fa-prefix', 'error');
+    rules['uxp/no-bad-hook-deps'] = sev(config, 'no-bad-hook-deps', 'warn');
+    rules['uxp/no-hardcoded-jsx-text'] = sev(config, 'no-hardcoded-jsx-text', 'warn');
+    rules['uxp/no-native-html-interactive'] = sev(config, 'no-native-html-interactive', 'warn');
+    rules['uxp/event-name-format'] = sev(config, 'event-name-format', 'warn');
+    return rules;
+}
+async function runEslint(config, cwd, fix) {
+    var _a;
+    const errors = [];
+    const warnings = [];
+    const srcDir = path_1.default.resolve(cwd, config.viewsSrc);
+    const files = collectSourceFiles(srcDir);
+    if (files.length === 0) {
+        return {
+            group: 'Code Quality (ESLint)',
+            passed: true, errors: [], warnings: [],
+            skipped: true,
+            skipReason: `No source files found in ${config.viewsSrc}`,
+        };
+    }
+    const linter = new eslint_1.Linter();
+    // Register TypeScript parser
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    linter.defineParser('@typescript-eslint/parser', require('@typescript-eslint/parser'));
+    // Register custom rules
+    for (const [name, rule] of Object.entries(UXP_RULES)) {
+        linter.defineRule(`uxp/${name}`, rule);
+    }
+    const rules = buildRulesConfig(config, linter);
+    const lintConfig = {
+        parser: '@typescript-eslint/parser',
+        parserOptions: {
+            ecmaVersion: 2020,
+            sourceType: 'module',
+            ecmaFeatures: { jsx: true },
+        },
+        settings: {
+            react: { version: '18.3' },
+        },
+        env: { browser: true, es2020: true, node: true },
+        rules,
+    };
+    for (const filePath of files) {
+        const source = fs_1.default.readFileSync(filePath, 'utf8');
+        const relPath = path_1.default.relative(cwd, filePath);
+        let messages;
+        if (fix) {
+            const result = linter.verifyAndFix(source, lintConfig, { filename: filePath });
+            if (result.fixed)
+                fs_1.default.writeFileSync(filePath, result.output, 'utf8');
+            messages = linter.verify(result.output, lintConfig, { filename: filePath });
+        }
+        else {
+            messages = linter.verify(source, lintConfig, { filename: filePath });
+        }
+        for (const msg of messages) {
+            const item = {
+                file: relPath,
+                line: msg.line,
+                col: msg.column,
+                rule: (_a = msg.ruleId) !== null && _a !== void 0 ? _a : undefined,
+                message: msg.message,
+            };
+            if (msg.severity === 2)
+                errors.push(item);
+            else if (msg.severity === 1)
+                warnings.push(item);
+        }
+    }
+    return {
+        group: 'Code Quality (ESLint)',
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=config.js.map