@iviva/uxp-lint 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,55 @@
+export type Severity = 'error' | 'warn' | 'off';
+export interface RuleDoc {
+    id: string;
+    severity: Severity;
+    category: 'react' | 'configuration' | 'patterns' | 'standards';
+    description: string;
+    rationale: string;
+    fix: string;
+}
+export interface LintMessage {
+    file?: string;
+    line?: number;
+    col?: number;
+    rule?: string;
+    message: string;
+}
+export interface GroupResult {
+    group: string;
+    passed: boolean;
+    errors: LintMessage[];
+    warnings: LintMessage[];
+    skipped?: boolean;
+    skipReason?: string;
+}
+export interface LintConfig {
+    v5: boolean;
+    viewsSrc: string;
+    configYml: string;
+    bundleJson: string;
+    bulkImportsDir: string;
+    appPrefix?: string;
+    rules: Record<string, Severity>;
+    bundleSize: {
+        maxKb: number;
+        severity: Severity;
+    };
+    duplication: {
+        minLines: number;
+        severity: Severity;
+    };
+    ai: {
+        enabled: boolean;
+        model: string;
+        apiKey?: string;
+    };
+}
+export interface RunOptions {
+    fix: boolean;
+    ci: boolean;
+    ai: boolean;
+    explain?: string;
+    listRules?: boolean;
+    report?: string;
+}
+export declare const DEFAULT_CONFIG: LintConfig;

package/dist/types.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.DEFAULT_CONFIG = {
+    v5: true,
+    viewsSrc: './Resources/views/src',
+    configYml: './Configuration.yml',
+    bundleJson: './Resources/views/bundle.json',
+    bulkImportsDir: './BulkImports',
+    rules: {
+        // ── UXP-specific (custom rules) ────────────────────────────────────────
+        'require-memo': 'error',
+        'no-inline-styles': 'error',
+        'url-params-form-state': 'error',
+        'service-config-shape': 'error',
+        'no-fa-prefix': 'error',
+        'no-bad-hook-deps': 'warn',
+        // ── Pattern rules (warn by default, upgrade to error when ready) ────────
+        'no-hardcoded-jsx-text': 'warn',
+        'no-native-html-interactive': 'warn',
+        'event-name-format': 'warn',
+        'folder-structure': 'warn',
+        'scss-app-prefix': 'warn',
+        'no-direct-uxp-override': 'error',
+    },
+    bundleSize: {
+        maxKb: 1024,
+        severity: 'warn',
+    },
+    duplication: {
+        minLines: 10,
+        severity: 'warn',
+    },
+    ai: {
+        enabled: false,
+        model: 'claude-sonnet-4-6',
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA4Da,QAAA,cAAc,GAAe;IACxC,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,uBAAuB;IACjC,SAAS,EAAE,qBAAqB;IAChC,UAAU,EAAE,+BAA+B;IAC3C,cAAc,EAAE,eAAe;IAC/B,KAAK,EAAE;QACL,0EAA0E;QAC1E,cAAc,EAAE,OAAO;QACvB,kBAAkB,EAAE,OAAO;QAC3B,uBAAuB,EAAE,OAAO;QAChC,sBAAsB,EAAE,OAAO;QAC/B,cAAc,EAAE,OAAO;QACvB,kBAAkB,EAAE,MAAM;QAC1B,2EAA2E;QAC3E,uBAAuB,EAAE,MAAM;QAC/B,4BAA4B,EAAE,MAAM;QACpC,mBAAmB,EAAE,MAAM;QAC3B,kBAAkB,EAAE,MAAM;QAC1B,iBAAiB,EAAE,MAAM;QACzB,wBAAwB,EAAE,OAAO;KAClC;IACD,UAAU,EAAE;QACV,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,MAAM;KACjB;IACD,WAAW,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,MAAM;KACjB;IACD,EAAE,EAAE;QACF,OAAO,EAAE,KAAK;QACd,KAAK,EAAE,mBAAmB;KAC3B;CACF,CAAC"}

package/dist/validators/ai.d.ts

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

package/dist/validators/ai.js

@@ -0,0 +1,115 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateWithAI = validateWithAI;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+function collectSourceFiles(dir, ext = ['.ts', '.tsx']) {
+    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') {
+            results.push(...collectSourceFiles(full, ext));
+        }
+        else if (entry.isFile() && ext.some((e) => entry.name.endsWith(e))) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+async function validateWithAI(config, cwd, rulesContext) {
+    var _a;
+    const apiKey = (_a = config.ai.apiKey) !== null && _a !== void 0 ? _a : process.env['UXP_CLAUDE_API_KEY'];
+    if (!apiKey) {
+        return {
+            group: 'AI Analysis',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: 'No API key — set UXP_CLAUDE_API_KEY or run uxp-lint setup',
+        };
+    }
+    const srcDir = path_1.default.resolve(cwd, config.viewsSrc);
+    const files = collectSourceFiles(srcDir).slice(0, 20); // limit to avoid token overflow
+    if (files.length === 0) {
+        return {
+            group: 'AI Analysis',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: 'No source files found',
+        };
+    }
+    let filesSummary = '';
+    for (const f of files) {
+        const rel = path_1.default.relative(cwd, f);
+        const content = fs_1.default.readFileSync(f, 'utf8');
+        // Truncate large files
+        const truncated = content.length > 3000 ? content.slice(0, 3000) + '\n// ... (truncated)' : content;
+        filesSummary += `\n\n--- ${rel} ---\n${truncated}`;
+    }
+    let Anthropic;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        Anthropic = require('@anthropic-ai/sdk');
+    }
+    catch {
+        return {
+            group: 'AI Analysis',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: '@anthropic-ai/sdk not installed',
+        };
+    }
+    const client = new Anthropic({ apiKey });
+    const prompt = `You are a code reviewer for iviva v5 UXP apps (React + TypeScript).
+
+Rules to enforce:
+${rulesContext}
+
+Review the following source files and report ONLY real violations. Be concise.
+Format each issue as: FILE:LINE  severity  message  [rule-id]
+If no issues found, say "No issues found."
+
+${filesSummary}`;
+    try {
+        const response = await client.messages.create({
+            model: config.ai.model,
+            max_tokens: 1024,
+            messages: [{ role: 'user', content: prompt }],
+        });
+        const text = response.content.map((b) => (b.type === 'text' ? b.text : '')).join('');
+        const warnings = [];
+        if (!text.includes('No issues found')) {
+            for (const line of text.split('\n')) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith('#'))
+                    continue;
+                warnings.push({ message: trimmed, rule: 'ai-review' });
+            }
+        }
+        return {
+            group: 'AI Analysis',
+            passed: true, // AI findings are always warnings
+            errors: [],
+            warnings,
+        };
+    }
+    catch (e) {
+        return {
+            group: 'AI Analysis',
+            passed: true,
+            errors: [],
+            warnings: [{ message: `AI analysis failed: ${e}`, rule: 'ai-review' }],
+        };
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/validators/ai.js.map

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

package/dist/validators/bulk-imports.d.ts

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

package/dist/validators/bulk-imports.js

@@ -0,0 +1,94 @@
+"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.validateBulkImports = validateBulkImports;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fast_xml_parser_1 = require("fast-xml-parser");
+exports.doc = {
+    id: 'bulk-import-name',
+    severity: 'error',
+    category: 'configuration',
+    description: 'BulkImports XML files must have a "name" attribute on the root element.',
+    rationale: 'The name attribute is used to identify the import in the UI — without it the import is anonymous and cannot be managed.',
+    fix: 'Add name="My Import Name" to the root XML element.',
+};
+const parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false, attributeNamePrefix: '@_' });
+async function validateBulkImports(config, cwd) {
+    const errors = [];
+    const warnings = [];
+    const dir = path_1.default.resolve(cwd, config.bulkImportsDir);
+    if (!fs_1.default.existsSync(dir)) {
+        return {
+            group: 'Bulk Imports',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: `No BulkImports/ folder found`,
+        };
+    }
+    const xmlFiles = fs_1.default.readdirSync(dir).filter((f) => f.endsWith('.xml'));
+    if (xmlFiles.length === 0) {
+        return {
+            group: 'Bulk Imports',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: 'No XML files in BulkImports/',
+        };
+    }
+    for (const filename of xmlFiles) {
+        const filePath = path_1.default.join(dir, filename);
+        const relPath = path_1.default.join(config.bulkImportsDir, filename);
+        let raw;
+        try {
+            raw = fs_1.default.readFileSync(filePath, 'utf8');
+        }
+        catch (e) {
+            errors.push({ file: relPath, message: `Cannot read file: ${e}` });
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = parser.parse(raw);
+        }
+        catch (e) {
+            errors.push({ file: relPath, message: `Invalid XML: ${e}` });
+            continue;
+        }
+        // Find the root element (skip ?xml declaration)
+        const rootKey = Object.keys(parsed).find((k) => k !== '?xml');
+        if (!rootKey) {
+            errors.push({ file: relPath, message: 'Cannot find root XML element' });
+            continue;
+        }
+        const root = parsed[rootKey];
+        const attrs = root;
+        // Check `name` attribute (required)
+        if (!attrs['@_name']) {
+            errors.push({
+                file: relPath,
+                message: `Missing required "name" attribute on <${rootKey}>. Add: name='...' to the root element.`,
+                rule: 'bulk-import-name',
+            });
+        }
+        // Check `schemaservice` — only warn if there's a service= attribute referencing a schema,
+        // but no schemaservice (informational only, hard to auto-detect)
+        if (attrs['@_service'] && !attrs['@_schemaservice']) {
+            // It's possible (but not certain) this import needs schemaservice
+            // Only the Location app uses this — we warn rather than error
+        }
+    }
+    return {
+        group: 'Bulk Imports',
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=bulk-imports.js.map

package/dist/validators/bulk-imports.js.map

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

package/dist/validators/bundle-json.d.ts

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

package/dist/validators/bundle-json.js

@@ -0,0 +1,130 @@
+"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.validateBundleJson = validateBundleJson;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.docs = [
+    {
+        id: 'bundle-label-not-component',
+        severity: 'error',
+        category: 'configuration',
+        description: 'bundle.json entries must use the "label" key, not "component".',
+        rationale: 'The "component" key is a v4 artifact — v5 uses "label" to display the UI name.',
+        fix: 'Rename "component" to "label" in each bundle.json entry.',
+    },
+    {
+        id: 'bundle-ids-match',
+        severity: 'error',
+        category: 'configuration',
+        description: 'All IDs registered via registerUI() in index.tsx must be present in bundle.json.',
+        rationale: 'Missing IDs cause the UXP shell to silently skip loading the component.',
+        fix: 'Add the missing ID to bundle.json uis array.',
+    },
+    {
+        id: 'localization-order',
+        severity: 'error',
+        category: 'configuration',
+        description: 'enableLocalization() must be called after all registerUI() calls in index.tsx.',
+        rationale: 'Calling enableLocalization() before registerUI() means some strings are never localized.',
+        fix: 'Move enableLocalization() to after the last registerUI() call.',
+    },
+];
+function extractRegisterUIIds(source) {
+    const ids = [];
+    // Match: registerUI({ id: 'some-id', ... }) or registerUI({ id: "some-id", ... })
+    const re = /registerUI\s*\(\s*\{[^}]*id\s*:\s*['"]([^'"]+)['"]/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        ids.push(m[1]);
+    }
+    return ids;
+}
+async function validateBundleJson(config, cwd) {
+    var _a;
+    const errors = [];
+    const warnings = [];
+    const bundleJsonPath = path_1.default.resolve(cwd, config.bundleJson);
+    const indexTsxPath = path_1.default.resolve(cwd, config.viewsSrc, 'index.tsx');
+    // Check bundle.json exists
+    if (!fs_1.default.existsSync(bundleJsonPath)) {
+        return {
+            group: 'bundle.json',
+            passed: false,
+            errors: [{ message: `File not found: ${config.bundleJson}` }],
+            warnings: [],
+        };
+    }
+    let bundle;
+    try {
+        bundle = JSON.parse(fs_1.default.readFileSync(bundleJsonPath, 'utf8'));
+    }
+    catch (e) {
+        return {
+            group: 'bundle.json',
+            passed: false,
+            errors: [{ message: `Failed to parse bundle.json: ${e}` }],
+            warnings: [],
+        };
+    }
+    const uis = (_a = bundle.uis) !== null && _a !== void 0 ? _a : [];
+    // Check `label` not `component`
+    for (const ui of uis) {
+        if ('component' in ui && ui.component) {
+            errors.push({
+                file: config.bundleJson,
+                message: `Entry "${ui.id}" uses "component" key — should be "label"`,
+                rule: 'bundle-label-not-component',
+            });
+        }
+    }
+    const bundleIds = new Set(uis.map((u) => u.id).filter(Boolean));
+    // Cross-check with index.tsx registerUI calls
+    if (!fs_1.default.existsSync(indexTsxPath)) {
+        warnings.push({ message: `Cannot find ${config.viewsSrc}/index.tsx — skipping registerUI cross-check` });
+        return { group: 'bundle.json', passed: errors.length === 0, errors, warnings };
+    }
+    const indexSource = fs_1.default.readFileSync(indexTsxPath, 'utf8');
+    const registeredIds = extractRegisterUIIds(indexSource);
+    // IDs in index.tsx but missing from bundle.json
+    for (const id of registeredIds) {
+        if (!bundleIds.has(id)) {
+            errors.push({
+                file: config.bundleJson,
+                message: `ID "${id}" is registered in index.tsx but missing from bundle.json`,
+                rule: 'bundle-ids-match',
+            });
+        }
+    }
+    // IDs in bundle.json but not in index.tsx
+    const registeredSet = new Set(registeredIds);
+    for (const id of bundleIds) {
+        if (!registeredSet.has(id)) {
+            warnings.push({
+                file: config.bundleJson,
+                message: `ID "${id}" is in bundle.json but not found in index.tsx registerUI calls`,
+                rule: 'bundle-ids-match',
+            });
+        }
+    }
+    // Check enableLocalization() comes after all registerUI() in index.tsx
+    const lastRegisterUI = indexSource.lastIndexOf('registerUI(');
+    const enableLocalization = indexSource.indexOf('enableLocalization(');
+    if (enableLocalization !== -1 && lastRegisterUI !== -1 && enableLocalization < lastRegisterUI) {
+        errors.push({
+            file: `${config.viewsSrc}/index.tsx`,
+            message: 'enableLocalization() must be called after all registerUI() calls',
+            rule: 'localization-order',
+        });
+    }
+    return {
+        group: 'bundle.json',
+        passed: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+//# sourceMappingURL=bundle-json.js.map

package/dist/validators/bundle-json.js.map

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

package/dist/validators/bundle-size.d.ts

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

package/dist/validators/bundle-size.js

@@ -0,0 +1,51 @@
+"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.validateBundleSize = validateBundleSize;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+exports.doc = {
+    id: 'bundle-size',
+    severity: 'warn',
+    category: 'standards',
+    description: 'The compiled dist/main.js should stay under the configured size limit (default 1MB).',
+    rationale: 'Large bundles slow initial load and hurt UXP shell startup time.',
+    fix: 'Analyze with `npx webpack-bundle-analyzer`. Lazy-load heavy components, remove unused imports.',
+};
+async function validateBundleSize(config, cwd) {
+    // Derive dist path from bundleJson location
+    const bundleDir = path_1.default.dirname(path_1.default.resolve(cwd, config.bundleJson));
+    const distFile = path_1.default.join(bundleDir, 'dist', 'main.js');
+    if (!fs_1.default.existsSync(distFile)) {
+        return {
+            group: 'Bundle Size',
+            passed: true,
+            errors: [],
+            warnings: [],
+            skipped: true,
+            skipReason: 'dist/main.js not found — run build first',
+        };
+    }
+    const bytes = fs_1.default.statSync(distFile).size;
+    const kb = Math.round(bytes / 1024);
+    const limitKb = config.bundleSize.maxKb;
+    const severity = config.bundleSize.severity;
+    if (kb > limitKb) {
+        const msg = {
+            file: 'dist/main.js',
+            message: `Bundle is ${kb}KB (limit: ${limitKb}KB)`,
+            rule: 'bundle-size',
+        };
+        return {
+            group: 'Bundle Size',
+            passed: severity !== 'error',
+            errors: severity === 'error' ? [msg] : [],
+            warnings: severity === 'warn' ? [msg] : [],
+        };
+    }
+    return { group: 'Bundle Size', passed: true, errors: [], warnings: [] };
+}
+//# sourceMappingURL=bundle-size.js.map

package/dist/validators/bundle-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-size.js","sourceRoot":"","sources":["../../src/validators/bundle-size.ts"],"names":[],"mappings":";;;;;;AAaA,gDAoCC;AAjDD,4CAAoB;AACpB,gDAAwB;AAGX,QAAA,GAAG,GAAY;IAC1B,EAAE,EAAE,aAAa;IACjB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,sFAAsF;IACnG,SAAS,EAAE,kEAAkE;IAC7E,GAAG,EAAE,gGAAgG;CACtG,CAAC;AAEK,KAAK,UAAU,kBAAkB,CAAC,MAAkB,EAAE,GAAW;IACtE,4CAA4C;IAC5C,MAAM,SAAS,GAAG,cAAI,CAAC,OAAO,CAAC,cAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAEzD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,0CAA0C;SACvD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IACzC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;IAE5C,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG;YACV,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,aAAa,EAAE,cAAc,OAAO,KAAK;YAClD,IAAI,EAAE,aAAa;SACpB,CAAC;QACF,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,QAAQ,KAAK,OAAO;YAC5B,MAAM,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;YACzC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;SAC3C,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAC1E,CAAC"}

package/dist/validators/config-yml.d.ts

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