@iviva/uxp-lint 0.0.1

package/dist/validators/config-yml.js

@@ -0,0 +1,148 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docs = void 0;
+exports.validateConfigYml = validateConfigYml;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+exports.docs = [
+    {
+        id: 'pageId-format',
+        severity: 'error',
+        category: 'configuration',
+        description: 'pageId values in navigationLinks must be in the format "ui/<id>" or "widget/<id>".',
+        rationale: 'The UXP shell uses this prefix to route to the correct component type.',
+        fix: 'Set pageId to "ui/my-component" or "widget/my-widget".',
+    },
+    {
+        id: 'nav-group-no-pageid',
+        severity: 'error',
+        category: 'configuration',
+        description: 'Nav group parents (items with children but no link) must not set a pageId.',
+        rationale: 'Group nodes are not rendered as pages — pageId is ignored and causes confusion.',
+        fix: 'Remove pageId from nav groups, or set it to null.',
+    },
+    {
+        id: 'nav-parent-redirect',
+        severity: 'warn',
+        category: 'configuration',
+        description: 'Nav items with children and their own link should have an otherRoutes redirect to a default child.',
+        rationale: 'Without a redirect, navigating to the parent link renders nothing.',
+        fix: 'Add an otherRoutes entry: `"/parent": { redirectTo: "/parent/default-child" }`.',
+    },
+    {
+        id: 'unique-nav-links',
+        severity: 'error',
+        category: 'configuration',
+        description: 'Navigation links must be unique — no two top-level items can share the same link value.',
+        rationale: 'Duplicate links cause the router to match the wrong page.',
+        fix: 'Ensure each navigationLink has a unique link path.',
+    },
+];
+function collectNavLinks(links, out = []) {
+    var _a;
+    for (const link of links) {
+        out.push(link);
+        if ((_a = link.children) === null || _a === void 0 ? void 0 : _a.length)
+            collectNavLinks(link.children, out);
+    }
+    return out;
+}
+async function validateConfigYml(config, cwd) {
+    var _a, _b, _c, _d, _e;
+    const errors = [];
+    const warnings = [];
+    const filePath = path_1.default.resolve(cwd, config.configYml);
+    if (!fs_1.default.existsSync(filePath)) {
+        return {
+            group: 'Configuration.yml',
+            passed: false,
+            errors: [{ message: `File not found: ${config.configYml}` }],
+            warnings: [],
+        };
+    }
+    let parsed;
+    try {
+        const raw = fs_1.default.readFileSync(filePath, 'utf8');
+        parsed = js_yaml_1.default.load(raw);
+    }
+    catch (e) {
+        return {
+            group: 'Configuration.yml',
+            passed: false,
+            errors: [{ message: `Failed to parse YAML: ${e}` }],
+            warnings: [],
+        };
+    }
+    const file = config.configYml;
+    // Required fields
+    if (!parsed.appId)
+        errors.push({ file, message: 'Missing required field: appId' });
+    if (!parsed.bundleId)
+        errors.push({ file, message: 'Missing required field: bundleId' });
+    if (!parsed.baseRoute)
+        errors.push({ file, message: 'Missing required field: baseRoute' });
+    if (!Array.isArray(parsed.scripts) || parsed.scripts.length === 0) {
+        errors.push({ file, message: 'Missing or empty scripts array' });
+    }
+    const navLinks = (_a = parsed.navigationLinks) !== null && _a !== void 0 ? _a : [];
+    const otherRoutes = (_b = parsed.otherRoutes) !== null && _b !== void 0 ? _b : {};
+    const allLinks = collectNavLinks(navLinks);
+    for (const link of allLinks) {
+        // pageId format check (if present and not null)
+        if (link.pageId !== undefined && link.pageId !== null) {
+            if (!/^(ui|widget)\/.+/.test(link.pageId)) {
+                errors.push({
+                    file,
+                    message: `Nav link "${(_c = link.label) !== null && _c !== void 0 ? _c : link.id}" has invalid pageId "${link.pageId}" — must be "ui/<id>" or "widget/<id>"`,
+                    rule: 'pageId-format',
+                });
+            }
+        }
+        // Nav groups (no link, has children) must have no pageId and must have an otherRoutes redirect
+        if (((_d = link.children) === null || _d === void 0 ? void 0 : _d.length) && !link.link) {
+            if (link.pageId) {
+                errors.push({
+                    file,
+                    message: `Nav group "${link.label}" has children and no link but sets pageId — group parents should have pageId: null`,
+                    rule: 'nav-group-no-pageid',
+                });
+            }
+        }
+        // Parents that have children and a link should have an otherRoutes redirect to one of their children
+        if (((_e = link.children) === null || _e === void 0 ? void 0 : _e.length) && link.link) {
+            const fullLink = `${parsed.baseRoute}${link.link}`.replace(/\/+/g, '/');
+            const hasRedirect = Object.entries(otherRoutes).some(([route, val]) => {
+                const fullRoute = `${parsed.baseRoute}${route}`.replace(/\/+/g, '/');
+                return (fullRoute === fullLink || route === link.link) && !!val.redirectTo;
+            });
+            if (!hasRedirect) {
+                warnings.push({
+                    file,
+                    message: `Nav item "${link.label}" has children — add an otherRoutes redirect for "${link.link}" to its default child`,
+                    rule: 'nav-parent-redirect',
+                });
+            }
+        }
+    }
+    // Check for duplicate links (same link value appearing more than once at top level)
+    const topLevelLinks = navLinks.filter((l) => l.link).map((l) => l.link);
+    const seen = new Set();
+    for (const link of topLevelLinks) {
+        if (link && seen.has(link)) {
+            errors.push({ file, message: `Duplicate navigation link: "${link}"`, rule: 'unique-nav-links' });
+        }
+        if (link)
+            seen.add(link);
+    }
+    return {
+        group: 'Configuration.yml',
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=config-yml.js.map

package/dist/validators/config-yml.js.map

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

package/dist/validators/duplication.d.ts

@@ -0,0 +1,3 @@
+import { GroupResult, LintConfig, RuleDoc } from '../types';
+export declare const doc: RuleDoc;
+export declare function validateDuplication(config: LintConfig, cwd: string): Promise<GroupResult>;

package/dist/validators/duplication.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doc = void 0;
+exports.validateDuplication = validateDuplication;
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+exports.doc = {
+    id: 'no-duplication',
+    severity: 'warn',
+    category: 'standards',
+    description: 'Significant blocks of duplicated code (default: ≥10 lines) should be extracted to shared utilities.',
+    rationale: 'Duplicated logic drifts — the same bug gets fixed in one copy but not the other.',
+    fix: 'Extract repeated logic into src/shared/ or a custom hook. Run `npx jscpd src/` to see details.',
+};
+async function validateDuplication(config, cwd) {
+    const srcDir = path_1.default.resolve(cwd, config.viewsSrc);
+    const minLines = config.duplication.minLines;
+    const severity = config.duplication.severity;
+    // Run jscpd as a subprocess — most reliable way to handle its output
+    let output;
+    try {
+        output = (0, child_process_1.execSync)(`npx jscpd "${srcDir}" --min-lines ${minLines} --reporters json --silent 2>/dev/null || true`, { cwd, encoding: 'utf8', timeout: 30000 });
+    }
+    catch {
+        return {
+            group: 'Duplicate Code',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: 'jscpd not available',
+        };
+    }
+    // jscpd outputs JSON to stdout with --reporters json
+    let clones = [];
+    try {
+        // jscpd outputs to a report file; extract clone count from summary line if present
+        const match = output.match(/Found\s+(\d+)\s+clone/i);
+        if (match) {
+            const count = parseInt(match[1], 10);
+            if (count > 0) {
+                const msg = {
+                    message: `Found ${count} code clone${count !== 1 ? 's' : ''} (min ${minLines} lines). Run jscpd manually for details.`,
+                    rule: 'no-duplication',
+                };
+                return {
+                    group: 'Duplicate Code',
+                    passed: severity !== 'error',
+                    errors: severity === 'error' ? [msg] : [],
+                    warnings: severity === 'warn' ? [msg] : [],
+                };
+            }
+        }
+        // No clones found
+        void clones;
+    }
+    catch {
+        // Ignore parse errors
+    }
+    return { group: 'Duplicate Code', passed: true, errors: [], warnings: [] };
+}
+//# sourceMappingURL=duplication.js.map

package/dist/validators/duplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplication.js","sourceRoot":"","sources":["../../src/validators/duplication.ts"],"names":[],"mappings":";;;;;;AAaA,kDAkDC;AA/DD,gDAAwB;AACxB,iDAAyC;AAG5B,QAAA,GAAG,GAAY;IAC1B,EAAE,EAAE,gBAAgB;IACpB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,qGAAqG;IAClH,SAAS,EAAE,kFAAkF;IAC7F,GAAG,EAAE,gGAAgG;CACtG,CAAC;AAEK,KAAK,UAAU,mBAAmB,CAAC,MAAkB,EAAE,GAAW;IACvE,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;IAE7C,qEAAqE;IACrE,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,IAAA,wBAAQ,EACf,cAAc,MAAM,iBAAiB,QAAQ,gDAAgD,EAC7F,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAC1C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,qBAAqB;SAClC,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,IAAI,MAAM,GAAuG,EAAE,CAAC;IACpH,IAAI,CAAC;QACH,mFAAmF;QACnF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACrD,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG;oBACV,OAAO,EAAE,SAAS,KAAK,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,QAAQ,0CAA0C;oBACtH,IAAI,EAAE,gBAAgB;iBACvB,CAAC;gBACF,OAAO;oBACL,KAAK,EAAE,gBAAgB;oBACvB,MAAM,EAAE,QAAQ,KAAK,OAAO;oBAC5B,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;oBACzC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;iBAC3C,CAAC;YACJ,CAAC;QACH,CAAC;QACD,kBAAkB;QAClB,KAAK,MAAM,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC7E,CAAC"}

package/dist/validators/folder-structure.d.ts

@@ -0,0 +1,3 @@
+import { GroupResult, LintConfig, RuleDoc } from '../types';
+export declare const doc: RuleDoc;
+export declare function validateFolderStructure(config: LintConfig, cwd: string): Promise<GroupResult>;

package/dist/validators/folder-structure.js

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doc = void 0;
+exports.validateFolderStructure = validateFolderStructure;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.doc = {
+    id: 'folder-structure',
+    severity: 'warn',
+    category: 'patterns',
+    description: 'Each views/ subfolder must contain exactly one .tsx file; forms belong in forms/; services.ts required.',
+    rationale: 'Consistent structure makes navigation predictable and keeps views from growing into component dumps.',
+    fix: 'Move extra .tsx files to components/, form components to forms/, ensure src/index.tsx and src/services.ts exist.',
+};
+async function validateFolderStructure(config, cwd) {
+    const errors = [];
+    const warnings = [];
+    const srcDir = path_1.default.resolve(cwd, config.viewsSrc);
+    if (!fs_1.default.existsSync(srcDir)) {
+        return {
+            group: 'Folder Structure',
+            passed: false,
+            errors: [{ message: `src/ directory not found: ${config.viewsSrc}` }],
+            warnings: [],
+        };
+    }
+    // ── Required files ──────────────────────────────────────────────────────
+    const indexTsx = path_1.default.join(srcDir, 'index.tsx');
+    if (!fs_1.default.existsSync(indexTsx)) {
+        errors.push({ file: `${config.viewsSrc}/index.tsx`, message: 'Missing src/index.tsx' });
+    }
+    const servicesTsOptions = ['services.ts', 'services.tsx'];
+    const hasServices = servicesTsOptions.some((f) => fs_1.default.existsSync(path_1.default.join(srcDir, f)));
+    if (!hasServices) {
+        errors.push({
+            file: `${config.viewsSrc}/services.ts`,
+            message: 'Missing src/services.ts — all service configs must be centralized here',
+            rule: 'folder-structure',
+        });
+    }
+    // ── views/ structure ────────────────────────────────────────────────────
+    const viewsDir = path_1.default.join(srcDir, 'views');
+    if (fs_1.default.existsSync(viewsDir)) {
+        const viewSubdirs = fs_1.default.readdirSync(viewsDir, { withFileTypes: true }).filter((e) => e.isDirectory());
+        for (const subdir of viewSubdirs) {
+            const subdirPath = path_1.default.join(viewsDir, subdir.name);
+            const entries = fs_1.default.readdirSync(subdirPath, { withFileTypes: true });
+            const tsxFiles = entries.filter((e) => e.isFile() && e.name.endsWith('.tsx'));
+            // Each view subfolder should have exactly one .tsx file
+            if (tsxFiles.length === 0) {
+                warnings.push({
+                    file: `${config.viewsSrc}/views/${subdir.name}/`,
+                    message: `View folder "${subdir.name}" has no .tsx file — add a view component`,
+                    rule: 'folder-structure',
+                });
+            }
+            else if (tsxFiles.length > 1) {
+                warnings.push({
+                    file: `${config.viewsSrc}/views/${subdir.name}/`,
+                    message: `View folder "${subdir.name}" has ${tsxFiles.length} .tsx files. Views should contain exactly one view component — move extras to components/`,
+                    rule: 'folder-structure',
+                });
+            }
+            // Form files don't belong in views/ subfolders
+            const formFiles = tsxFiles.filter((f) => f.name.toLowerCase().includes('form') || f.name.toLowerCase().includes('dialog'));
+            for (const f of formFiles) {
+                warnings.push({
+                    file: `${config.viewsSrc}/views/${subdir.name}/${f.name}`,
+                    message: `Form/dialog "${f.name}" should be in src/forms/, not src/views/`,
+                    rule: 'folder-structure',
+                });
+            }
+        }
+        // Also check top-level .tsx files directly in views/ (not in a subfolder)
+        const topLevelTsx = fs_1.default.readdirSync(viewsDir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith('.tsx'));
+        for (const f of topLevelTsx) {
+            warnings.push({
+                file: `${config.viewsSrc}/views/${f.name}`,
+                message: `View "${f.name}" should be in its own subfolder: views/${f.name.replace('.tsx', '')}/`,
+                rule: 'folder-structure',
+            });
+        }
+    }
+    // ── forms/ check ────────────────────────────────────────────────────────
+    // Warn if there are form-named files outside of forms/ directory
+    const componentsDir = path_1.default.join(srcDir, 'components');
+    if (fs_1.default.existsSync(componentsDir)) {
+        const formFilesInComponents = findFormFiles(componentsDir);
+        for (const f of formFilesInComponents) {
+            const rel = path_1.default.relative(srcDir, f);
+            warnings.push({
+                file: `${config.viewsSrc}/${rel}`,
+                message: `Form component found in components/ — forms belong in src/forms/`,
+                rule: 'folder-structure',
+            });
+        }
+    }
+    return {
+        group: 'Folder Structure',
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+function findFormFiles(dir) {
+    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()) {
+            results.push(...findFormFiles(full));
+        }
+        else if (entry.isFile() &&
+            entry.name.endsWith('.tsx') &&
+            (entry.name.toLowerCase().includes('form') || entry.name.toLowerCase().includes('dialog'))) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=folder-structure.js.map

package/dist/validators/folder-structure.js.map

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

package/dist/validators/formatting.d.ts

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

package/dist/validators/formatting.js

@@ -0,0 +1,97 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doc = void 0;
+exports.validateFormatting = validateFormatting;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.doc = {
+    id: 'prettier',
+    severity: 'warn',
+    category: 'standards',
+    description: 'All source files must be formatted according to the project Prettier config.',
+    rationale: 'Consistent formatting eliminates noise in code reviews and prevents merge conflicts.',
+    fix: 'Run `uxp-lint --fix` to auto-format, or `npx prettier --write .`',
+};
+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('.scss'))) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+async function validateFormatting(config, cwd, fix) {
+    var _a;
+    const errors = [];
+    const warnings = [];
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    let prettier;
+    try {
+        prettier = require('prettier');
+    }
+    catch {
+        return {
+            group: 'Formatting (Prettier)',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: 'prettier not installed',
+        };
+    }
+    const srcDir = path_1.default.resolve(cwd, config.viewsSrc);
+    const files = collectSourceFiles(srcDir);
+    // Use project's own Prettier config if it exists, otherwise fall back to defaults
+    const resolvedConfig = (_a = (await prettier.resolveConfig(cwd))) !== null && _a !== void 0 ? _a : {
+        singleQuote: true,
+        trailingComma: 'es5',
+        printWidth: 120,
+        tabWidth: 4,
+        semi: true,
+    };
+    for (const filePath of files) {
+        const source = fs_1.default.readFileSync(filePath, 'utf8');
+        const relPath = path_1.default.relative(cwd, filePath);
+        const parser = filePath.endsWith('.scss') ? 'scss' : 'typescript';
+        let formatted;
+        try {
+            formatted = await prettier.format(source, { ...resolvedConfig, parser });
+        }
+        catch {
+            // Skip files that can't be parsed by Prettier
+            continue;
+        }
+        if (formatted !== source) {
+            if (fix) {
+                fs_1.default.writeFileSync(filePath, formatted, 'utf8');
+            }
+            else {
+                warnings.push({
+                    file: relPath,
+                    message: 'File is not formatted. Run uxp-lint --fix to auto-format.',
+                    rule: 'prettier',
+                });
+            }
+        }
+    }
+    return {
+        group: 'Formatting (Prettier)',
+        passed: true, // formatting issues are always warnings
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=formatting.js.map

package/dist/validators/formatting.js.map

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

package/dist/validators/scss-rules.d.ts

@@ -0,0 +1,3 @@
+import { GroupResult, LintConfig, RuleDoc } from '../types';
+export declare const docs: RuleDoc[];
+export declare function validateScssRules(config: LintConfig, cwd: string): Promise<GroupResult>;

package/dist/validators/scss-rules.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.docs = void 0;
+exports.validateScssRules = validateScssRules;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.docs = [
+    {
+        id: 'scss-app-prefix',
+        severity: 'warn',
+        category: 'patterns',
+        description: 'Top-level SCSS class selectors must start with the app-specific prefix (e.g. ilocapp_).',
+        rationale: 'App-prefixed classes prevent style collisions between apps sharing the same global stylesheet.',
+        fix: 'Rename .my-class to .ilocapp_myclass. Set appPrefix in .uxplintrc.json or auto-detect from global.scss.',
+    },
+    {
+        id: 'no-direct-uxp-override',
+        severity: 'error',
+        category: 'patterns',
+        description: 'Direct top-level overrides of .uxp-* or .uxpcore_* classes are not allowed.',
+        rationale: 'Top-level UXP overrides break other apps sharing the stylesheet and couple code to UXP internals.',
+        fix: 'Nest UXP class overrides inside your app-prefixed class: `.ilocapp_myview { .uxp-button { ... } }`',
+    },
+];
+async function validateScssRules(config, cwd) {
+    var _a, _b, _c;
+    const errors = [];
+    const warnings = [];
+    const srcDir = path_1.default.resolve(cwd, config.viewsSrc);
+    if (!fs_1.default.existsSync(srcDir)) {
+        return { group: 'SCSS Rules', passed: true, errors: [], warnings: [], skipped: true, skipReason: `src/ not found` };
+    }
+    const scssFiles = collectScssFiles(srcDir);
+    if (scssFiles.length === 0) {
+        return { group: 'SCSS Rules', passed: true, errors: [], warnings: [], skipped: true, skipReason: 'No .scss files found' };
+    }
+    // Derive app prefix: from config, or auto-detect from global.scss
+    const appPrefix = (_a = config.appPrefix) !== null && _a !== void 0 ? _a : detectAppPrefix(srcDir);
+    for (const filePath of scssFiles) {
+        const relPath = path_1.default.relative(cwd, filePath);
+        const lines = fs_1.default.readFileSync(filePath, 'utf8').split('\n');
+        let depth = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            // Track brace depth — count opens and closes on this line
+            const opens = ((_b = line.match(/\{/g)) !== null && _b !== void 0 ? _b : []).length;
+            const closes = ((_c = line.match(/\}/g)) !== null && _c !== void 0 ? _c : []).length;
+            // Check selectors only at depth 0 (before counting opens on this line)
+            if (depth === 0) {
+                const selector = extractSelector(line);
+                if (selector) {
+                    if (isUxpSelector(selector)) {
+                        errors.push({
+                            file: relPath,
+                            line: lineNum,
+                            message: `Top-level UXP override "${selector}" — nest this inside a custom app-prefixed class`,
+                            rule: 'no-direct-uxp-override',
+                        });
+                    }
+                    else if (appPrefix && !selector.startsWith(`.${appPrefix}`) && !selector.startsWith('%') && !selector.startsWith('@')) {
+                        // Only warn on class selectors that don't match the app prefix
+                        if (selector.startsWith('.') && !selector.startsWith('.uxp')) {
+                            warnings.push({
+                                file: relPath,
+                                line: lineNum,
+                                message: `Top-level selector "${selector}" should start with app prefix ".${appPrefix}"`,
+                                rule: 'scss-app-prefix',
+                            });
+                        }
+                    }
+                }
+            }
+            depth += opens - closes;
+            if (depth < 0)
+                depth = 0; // guard against malformed SCSS
+        }
+    }
+    return {
+        group: 'SCSS Rules',
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function collectScssFiles(dir) {
+    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(...collectScssFiles(full));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.scss')) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+/**
+ * Extract the primary selector from a line of SCSS, or null if the line is not a selector.
+ * Handles: `.class {`, `.class,`, `#id {`, `&:hover {`, `@mixin name {`
+ */
+function extractSelector(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith('//') || trimmed.startsWith('/*') || trimmed.startsWith('*'))
+        return null;
+    // Lines with property: value patterns are not selectors
+    if (/^[\w-]+\s*:/.test(trimmed) && !trimmed.includes('{'))
+        return null;
+    // Must end with { or , (selector line), or be a pure selector without property
+    if (!trimmed.includes('{') && !trimmed.endsWith(','))
+        return null;
+    // Pull first token up to whitespace, comma, colon, or brace
+    const match = trimmed.match(/^([.#%@&\w][\w-]*(?:\.[.\w-]+)*)/);
+    if (!match)
+        return null;
+    // Return the first "word" — the primary selector token
+    const sel = trimmed.split(/[\s,{]/)[0].trim();
+    return sel || null;
+}
+function isUxpSelector(selector) {
+    return selector.startsWith('.uxp-') || selector.startsWith('.uxpcore_') || selector.startsWith('.uxp_');
+}
+/**
+ * Auto-detect the app prefix by scanning for the first top-level class in global.scss
+ * that ends with an underscore and looks like an app prefix (e.g. "isystemapp_").
+ */
+function detectAppPrefix(srcDir) {
+    const candidates = [
+        path_1.default.join(srcDir, 'assets', 'styles', 'global.scss'),
+        path_1.default.join(srcDir, 'assets', 'scss', 'global.scss'),
+        path_1.default.join(srcDir, 'styles', 'global.scss'),
+        path_1.default.join(srcDir, 'global.scss'),
+    ];
+    for (const candidate of candidates) {
+        if (!fs_1.default.existsSync(candidate))
+            continue;
+        const lines = fs_1.default.readFileSync(candidate, 'utf8').split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed.startsWith('.'))
+                continue;
+            const m = trimmed.match(/^\.(([a-z]+app)_[\w-]*)\s*[{,]/);
+            if (m)
+                return `${m[2]}_`; // e.g. "isystemapp_"
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=scss-rules.js.map