@flagshark/core 1.0.1 → 1.3.0

package/dist/config/defaults.d.ts

@@ -0,0 +1,3 @@
+import { type FlagsharkConfig } from './schema.js';
+export declare function buildDefaultConfig(): FlagsharkConfig;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAEzE,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD"}

package/dist/config/defaults.js

@@ -0,0 +1,6 @@
+import { FlagsharkConfigSchema } from './schema.js';
+export function buildDefaultConfig() {
+    // Parse an empty object — schema fills in all defaults.
+    return FlagsharkConfigSchema.parse({});
+}
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAwB,MAAM,aAAa,CAAA;AAEzE,MAAM,UAAU,kBAAkB;IAChC,wDAAwD;IACxD,OAAO,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;AACxC,CAAC"}

package/dist/config/excluder.d.ts

@@ -0,0 +1,18 @@
+import type { FlagsharkConfig } from './schema.js';
+export interface EffectiveRules {
+    paths: string[];
+    files: string[];
+    presets: string[];
+    presetPatterns: string[];
+    ignoreFile: string[];
+}
+export interface Excluder {
+    shouldExclude(path: string): boolean;
+    effectiveRules: EffectiveRules;
+}
+export interface BuildExcluderInput {
+    config: FlagsharkConfig;
+    ignoreFilePatterns: string[];
+}
+export declare function buildExcluder(input: BuildExcluderInput): Excluder;
+//# sourceMappingURL=excluder.d.ts.map

package/dist/config/excluder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excluder.d.ts","sourceRoot":"","sources":["../../src/config/excluder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAIlD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACpC,cAAc,EAAE,cAAc,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,eAAe,CAAA;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAC7B;AAwBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,QAAQ,CA4BjE"}

package/dist/config/excluder.js

@@ -0,0 +1,51 @@
+import ignoreModule from 'ignore';
+import { expandPresets } from './presets.js';
+const ignore = ignoreModule.default ?? ignoreModule;
+/**
+ * Convert trailing-slash directory patterns (`examples/`) to recursive globs
+ * (`examples/**`) so that `!`-negation works downstream.
+ *
+ * The `ignore@5` package follows the strict gitignore spec: once a parent
+ * directory is excluded via a trailing-slash pattern, files inside it cannot
+ * be re-included via `!`. Converting to `examples/**` bypasses this restriction
+ * by treating the pattern as a glob rather than a directory match.
+ *
+ * Trade-off: `examples/**` is anchored to the repo root, while gitignore's
+ * `examples/` is unanchored (matches `examples/` anywhere in the tree).
+ * In practice the scanner's hardcoded SKIP_DIRS already filters node_modules,
+ * vendor, etc., so this anchoring change rarely affects real users — but it
+ * is a deliberate departure from strict gitignore semantics.
+ */
+function normalisePattern(p) {
+    if (!p.startsWith('!') && p.endsWith('/')) {
+        return p + '**';
+    }
+    return p;
+}
+export function buildExcluder(input) {
+    const { config, ignoreFilePatterns } = input;
+    const presetPatterns = expandPresets(config.excludes.presets);
+    const allPatterns = [
+        ...config.excludes.paths,
+        ...config.excludes.files,
+        ...presetPatterns,
+        ...ignoreFilePatterns,
+    ];
+    const matcher = ignore().add(allPatterns.map(normalisePattern));
+    return {
+        shouldExclude(path) {
+            if (allPatterns.length === 0)
+                return false;
+            const normalised = path.startsWith('./') ? path.slice(2) : path;
+            return matcher.ignores(normalised);
+        },
+        effectiveRules: {
+            paths: [...config.excludes.paths],
+            files: [...config.excludes.files],
+            presets: [...config.excludes.presets],
+            presetPatterns,
+            ignoreFile: [...ignoreFilePatterns],
+        },
+    };
+}
+//# sourceMappingURL=excluder.js.map

package/dist/config/excluder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excluder.js","sourceRoot":"","sources":["../../src/config/excluder.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,QAAQ,CAAA;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAI5C,MAAM,MAAM,GAAI,YAA6D,CAAC,OAAO,IAAI,YAAY,CAAA;AAoBrG;;;;;;;;;;;;;;GAcG;AACH,SAAS,gBAAgB,CAAC,CAAS;IACjC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,IAAI,CAAA;IACjB,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,KAAK,CAAA;IAE5C,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IAE7D,MAAM,WAAW,GAAa;QAC5B,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK;QACxB,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK;QACxB,GAAG,cAAc;QACjB,GAAG,kBAAkB;KACtB,CAAA;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAA;IAE/D,OAAO;QACL,aAAa,CAAC,IAAY;YACxB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAA;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACpC,CAAC;QACD,cAAc,EAAE;YACd,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjC,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YACjC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrC,cAAc;YACd,UAAU,EAAE,CAAC,GAAG,kBAAkB,CAAC;SACpC;KACF,CAAA;AACH,CAAC"}

package/dist/config/ignore-file.d.ts

@@ -0,0 +1,6 @@
+export interface LoadedIgnore {
+    patterns: string[];
+    path: string;
+}
+export declare function loadIgnoreFile(startDir: string): Promise<LoadedIgnore | null>;
+//# sourceMappingURL=ignore-file.d.ts.map

package/dist/config/ignore-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-file.d.ts","sourceRoot":"","sources":["../../src/config/ignore-file.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkBnF"}

package/dist/config/ignore-file.js

@@ -0,0 +1,23 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+export async function loadIgnoreFile(startDir) {
+    const home = homedir();
+    let dir = resolve(startDir);
+    for (;;) {
+        const candidate = join(dir, '.flagsharkignore');
+        if (existsSync(candidate)) {
+            const raw = readFileSync(candidate, 'utf-8');
+            const patterns = raw
+                .split('\n')
+                .map((line) => line.trim())
+                .filter((line) => line.length > 0 && !line.startsWith('#'));
+            return { patterns, path: candidate };
+        }
+        const parent = dirname(dir);
+        if (parent === dir || dir === home || dir === '/')
+            return null;
+        dir = parent;
+    }
+}
+//# sourceMappingURL=ignore-file.js.map

package/dist/config/ignore-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore-file.js","sourceRoot":"","sources":["../../src/config/ignore-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOlD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE3B,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAA;QAC/C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;YAC5C,MAAM,QAAQ,GAAG,GAAG;iBACjB,KAAK,CAAC,IAAI,CAAC;iBACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;iBAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;QACtC,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC9D,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+export { buildDefaultConfig } from './defaults.js';
+export { loadConfigFile, type LoadedConfig } from './loader.js';
+export { loadIgnoreFile, type LoadedIgnore } from './ignore-file.js';
+export { buildExcluder, type Excluder, type EffectiveRules, type BuildExcluderInput } from './excluder.js';
+export { expandPresets, PRESETS } from './presets.js';
+export { FlagsharkConfigSchema, type FlagsharkConfig, type ExcludesConfig, type SuppressConfig, type PathRuleConfig, type OutputConfig, type PresetName, } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAC1G,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,GAChB,MAAM,aAAa,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,7 @@
+export { buildDefaultConfig } from './defaults.js';
+export { loadConfigFile } from './loader.js';
+export { loadIgnoreFile } from './ignore-file.js';
+export { buildExcluder } from './excluder.js';
+export { expandPresets, PRESETS } from './presets.js';
+export { FlagsharkConfigSchema, } from './schema.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,cAAc,EAAqB,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAqB,MAAM,kBAAkB,CAAA;AACpE,OAAO,EAAE,aAAa,EAA+D,MAAM,eAAe,CAAA;AAC1G,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EACL,qBAAqB,GAOtB,MAAM,aAAa,CAAA"}

package/dist/config/loader.d.ts

@@ -0,0 +1,7 @@
+import { type FlagsharkConfig } from './schema.js';
+export interface LoadedConfig {
+    config: FlagsharkConfig;
+    path: string;
+}
+export declare function loadConfigFile(startDir: string): Promise<LoadedConfig | null>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AAIzE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,eAAe,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAenF"}

package/dist/config/loader.js

@@ -0,0 +1,47 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { parse as parseYaml, YAMLParseError } from 'yaml';
+import { FlagsharkConfigSchema } from './schema.js';
+const FILENAMES = ['.flagshark.yml', '.flagshark.yaml'];
+export async function loadConfigFile(startDir) {
+    const home = homedir();
+    let dir = resolve(startDir);
+    for (;;) {
+        for (const name of FILENAMES) {
+            const candidate = join(dir, name);
+            if (existsSync(candidate)) {
+                return readAndValidate(candidate);
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir || dir === home || dir === '/')
+            return null;
+        dir = parent;
+    }
+}
+function readAndValidate(path) {
+    const raw = readFileSync(path, 'utf-8');
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        if (err instanceof YAMLParseError) {
+            throw new Error(`Invalid YAML in ${path}: ${err.message}`);
+        }
+        throw err;
+    }
+    if (parsed == null || typeof parsed !== 'object') {
+        return { config: FlagsharkConfigSchema.parse({}), path };
+    }
+    const result = FlagsharkConfigSchema.safeParse(parsed);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `${i.path.join('.') || '(root)'}: ${i.message}`)
+            .join('; ');
+        throw new Error(`Invalid .flagshark.yml at ${path}: ${issues}`);
+    }
+    return { config: result.data, path };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAElD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAEzD,OAAO,EAAE,qBAAqB,EAAwB,MAAM,aAAa,CAAA;AAEzE,MAAM,SAAS,GAAG,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;AAOvD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,IAAI,GAAG,OAAO,EAAE,CAAA;IACtB,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE3B,SAAS,CAAC;QACR,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YACjC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC1B,OAAO,eAAe,CAAC,SAAS,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3B,IAAI,MAAM,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC9D,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAEvC,IAAI,MAAe,CAAA;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QAC5D,CAAC;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,EAAE,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAA;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,MAAM,IAAI,KAAK,CAAC,6BAA6B,IAAI,KAAK,MAAM,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAA;AACtC,CAAC"}

package/dist/config/presets.d.ts

@@ -0,0 +1,11 @@
+import type { PresetName } from './schema.js';
+/**
+ * Built-in exclude presets. Each preset expands to a list of gitignore-style
+ * glob patterns that match common conventions for that category.
+ *
+ * Test-files patterns are derived from the private flag-shark monorepo's
+ * `packages/shared/lib/test-files.ts` `isTestFile()` helper — credit there.
+ */
+export declare const PRESETS: Readonly<Record<PresetName, readonly string[]>>;
+export declare function expandPresets(names: readonly PresetName[]): string[];
+//# sourceMappingURL=presets.d.ts.map

package/dist/config/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/config/presets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC,CA6ClE,CAAA;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,EAAE,CAcpE"}

package/dist/config/presets.js

@@ -0,0 +1,70 @@
+/**
+ * Built-in exclude presets. Each preset expands to a list of gitignore-style
+ * glob patterns that match common conventions for that category.
+ *
+ * Test-files patterns are derived from the private flag-shark monorepo's
+ * `packages/shared/lib/test-files.ts` `isTestFile()` helper — credit there.
+ */
+export const PRESETS = Object.freeze({
+    'test-files': Object.freeze([
+        // JavaScript / TypeScript
+        '**/*.test.ts', '**/*.test.tsx', '**/*.test.js', '**/*.test.jsx',
+        '**/*.test.mjs', '**/*.test.cjs',
+        '**/*.spec.ts', '**/*.spec.tsx', '**/*.spec.js', '**/*.spec.jsx',
+        // Go
+        '**/*_test.go',
+        // Python
+        '**/*_test.py', '**/test_*.py',
+        // Java / Kotlin
+        '**/*Test.java', '**/*Tests.java', '**/*Test.kt', '**/*Tests.kt',
+        // Swift
+        '**/*Tests.swift',
+        // Ruby
+        '**/*_spec.rb', '**/spec/**/*.rb',
+        // C# / .NET
+        '**/*Test.cs', '**/*Tests.cs',
+        // PHP
+        '**/*Test.php',
+        // Rust
+        '**/tests/**',
+        // Directories that always indicate tests
+        '**/__tests__/**', '**/test/**',
+    ]),
+    'snapshots': Object.freeze([
+        '**/*.snap',
+        '**/__snapshots__/**',
+    ]),
+    'examples': Object.freeze([
+        'examples/**', 'example/**',
+        'demo/**', 'demos/**',
+    ]),
+    'stories': Object.freeze([
+        '**/*.stories.ts', '**/*.stories.tsx',
+        '**/*.stories.js', '**/*.stories.jsx',
+        '**/*.story.ts', '**/*.story.tsx',
+    ]),
+    'fixtures': Object.freeze([
+        '**/__fixtures__/**', '**/fixtures/**',
+    ]),
+    'generated': Object.freeze([
+        '**/*.generated.ts', '**/*.generated.js',
+        '**/*.gen.go', '**/generated/**',
+    ]),
+});
+export function expandPresets(names) {
+    const seen = new Set();
+    const out = [];
+    for (const name of names) {
+        const patterns = PRESETS[name];
+        if (!patterns)
+            continue;
+        for (const pattern of patterns) {
+            if (!seen.has(pattern)) {
+                seen.add(pattern);
+                out.push(pattern);
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=presets.js.map

package/dist/config/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/config/presets.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAoD,MAAM,CAAC,MAAM,CAAC;IACpF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,0BAA0B;QAC1B,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;QAChE,eAAe,EAAE,eAAe;QAChC,cAAc,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe;QAChE,KAAK;QACL,cAAc;QACd,SAAS;QACT,cAAc,EAAE,cAAc;QAC9B,gBAAgB;QAChB,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc;QAChE,QAAQ;QACR,iBAAiB;QACjB,OAAO;QACP,cAAc,EAAE,iBAAiB;QACjC,YAAY;QACZ,aAAa,EAAE,cAAc;QAC7B,MAAM;QACN,cAAc;QACd,OAAO;QACP,aAAa;QACb,yCAAyC;QACzC,iBAAiB,EAAE,YAAY;KAChC,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;QACzB,WAAW;QACX,qBAAqB;KACtB,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,aAAa,EAAE,YAAY;QAC3B,SAAS,EAAE,UAAU;KACtB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACvB,iBAAiB,EAAE,kBAAkB;QACrC,iBAAiB,EAAE,kBAAkB;QACrC,eAAe,EAAE,gBAAgB;KAClC,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,oBAAoB,EAAE,gBAAgB;KACvC,CAAC;IACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;QACzB,mBAAmB,EAAE,mBAAmB;QACxC,aAAa,EAAE,iBAAiB;KACjC,CAAC;CACH,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,KAA4B;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC9B,IAAI,CAAC,QAAQ;YAAE,SAAQ;QACvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBACjB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,322 @@
+import { z } from 'zod';
+export declare const PresetNameSchema: z.ZodEnum<["test-files", "snapshots", "examples", "stories", "fixtures", "generated"]>;
+export type PresetName = z.infer<typeof PresetNameSchema>;
+export declare const ExcludesSchema: z.ZodDefault<z.ZodObject<{
+    paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    presets: z.ZodDefault<z.ZodArray<z.ZodEnum<["test-files", "snapshots", "examples", "stories", "fixtures", "generated"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    paths: string[];
+    files: string[];
+    presets: ("examples" | "test-files" | "snapshots" | "stories" | "fixtures" | "generated")[];
+}, {
+    paths?: string[] | undefined;
+    files?: string[] | undefined;
+    presets?: ("examples" | "test-files" | "snapshots" | "stories" | "fixtures" | "generated")[] | undefined;
+}>>;
+export declare const SuppressSchema: z.ZodDefault<z.ZodObject<{
+    flags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    flags: string[];
+}, {
+    flags?: string[] | undefined;
+}>>;
+export declare const PathRuleSchema: z.ZodObject<{
+    match: z.ZodString;
+    threshold: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    match: string;
+    threshold?: number | undefined;
+}, {
+    match: string;
+    threshold?: number | undefined;
+}>;
+export declare const MethodConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    flagKeyIndex: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    flagKeyIndex: number;
+}, {
+    name: string;
+    flagKeyIndex: number;
+}>;
+export declare const CustomProviderSchema: z.ZodObject<{
+    language: z.ZodEnum<["typescript", "javascript", "go", "python", "java", "kotlin", "swift", "ruby", "csharp", "php", "rust", "cpp", "objc"]>;
+    name: z.ZodString;
+    importPattern: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    methods: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        flagKeyIndex: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        flagKeyIndex: number;
+    }, {
+        name: string;
+        flagKeyIndex: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    methods: {
+        name: string;
+        flagKeyIndex: number;
+    }[];
+    enabled: boolean;
+    language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+    importPattern?: string | undefined;
+}, {
+    name: string;
+    methods: {
+        name: string;
+        flagKeyIndex: number;
+    }[];
+    language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+    importPattern?: string | undefined;
+    enabled?: boolean | undefined;
+}>;
+export declare const OutputConfigSchema: z.ZodDefault<z.ZodObject<{
+    format: z.ZodDefault<z.ZodEnum<["text", "json", "sarif", "markdown", "csv"]>>;
+    groupBy: z.ZodDefault<z.ZodEnum<["file", "provider", "signal", "none"]>>;
+    sortBy: z.ZodDefault<z.ZodEnum<["age", "name", "count"]>>;
+    color: z.ZodDefault<z.ZodEnum<["auto", "always", "never"]>>;
+    maxDisplay: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    format: "json" | "text" | "sarif" | "markdown" | "csv";
+    groupBy: "provider" | "file" | "signal" | "none";
+    sortBy: "name" | "age" | "count";
+    color: "never" | "auto" | "always";
+    maxDisplay: number;
+}, {
+    format?: "json" | "text" | "sarif" | "markdown" | "csv" | undefined;
+    groupBy?: "provider" | "file" | "signal" | "none" | undefined;
+    sortBy?: "name" | "age" | "count" | undefined;
+    color?: "never" | "auto" | "always" | undefined;
+    maxDisplay?: number | undefined;
+}>>;
+export declare const HealthScoreSchema: z.ZodDefault<z.ZodObject<{
+    weights: z.ZodDefault<z.ZodObject<{
+        age: z.ZodDefault<z.ZodNumber>;
+        lowUsage: z.ZodDefault<z.ZodNumber>;
+        hardcoded: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        age: number;
+        hardcoded: number;
+        lowUsage: number;
+    }, {
+        age?: number | undefined;
+        hardcoded?: number | undefined;
+        lowUsage?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    weights: {
+        age: number;
+        hardcoded: number;
+        lowUsage: number;
+    };
+}, {
+    weights?: {
+        age?: number | undefined;
+        hardcoded?: number | undefined;
+        lowUsage?: number | undefined;
+    } | undefined;
+}>>;
+export declare const EngineSchema: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["regex", "tree-sitter"]>>>;
+export declare const FlagsharkConfigSchema: z.ZodObject<{
+    threshold: z.ZodDefault<z.ZodNumber>;
+    excludes: z.ZodDefault<z.ZodObject<{
+        paths: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        files: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        presets: z.ZodDefault<z.ZodArray<z.ZodEnum<["test-files", "snapshots", "examples", "stories", "fixtures", "generated"]>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        paths: string[];
+        files: string[];
+        presets: ("examples" | "test-files" | "snapshots" | "stories" | "fixtures" | "generated")[];
+    }, {
+        paths?: string[] | undefined;
+        files?: string[] | undefined;
+        presets?: ("examples" | "test-files" | "snapshots" | "stories" | "fixtures" | "generated")[] | undefined;
+    }>>;
+    suppress: z.ZodDefault<z.ZodObject<{
+        flags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        flags: string[];
+    }, {
+        flags?: string[] | undefined;
+    }>>;
+    paths: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        match: z.ZodString;
+        threshold: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        match: string;
+        threshold?: number | undefined;
+    }, {
+        match: string;
+        threshold?: number | undefined;
+    }>, "many">>;
+    providers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        language: z.ZodEnum<["typescript", "javascript", "go", "python", "java", "kotlin", "swift", "ruby", "csharp", "php", "rust", "cpp", "objc"]>;
+        name: z.ZodString;
+        importPattern: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        methods: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            flagKeyIndex: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            flagKeyIndex: number;
+        }, {
+            name: string;
+            flagKeyIndex: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        methods: {
+            name: string;
+            flagKeyIndex: number;
+        }[];
+        enabled: boolean;
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        importPattern?: string | undefined;
+    }, {
+        name: string;
+        methods: {
+            name: string;
+            flagKeyIndex: number;
+        }[];
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        importPattern?: string | undefined;
+        enabled?: boolean | undefined;
+    }>, "many">>;
+    output: z.ZodDefault<z.ZodObject<{
+        format: z.ZodDefault<z.ZodEnum<["text", "json", "sarif", "markdown", "csv"]>>;
+        groupBy: z.ZodDefault<z.ZodEnum<["file", "provider", "signal", "none"]>>;
+        sortBy: z.ZodDefault<z.ZodEnum<["age", "name", "count"]>>;
+        color: z.ZodDefault<z.ZodEnum<["auto", "always", "never"]>>;
+        maxDisplay: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        format: "json" | "text" | "sarif" | "markdown" | "csv";
+        groupBy: "provider" | "file" | "signal" | "none";
+        sortBy: "name" | "age" | "count";
+        color: "never" | "auto" | "always";
+        maxDisplay: number;
+    }, {
+        format?: "json" | "text" | "sarif" | "markdown" | "csv" | undefined;
+        groupBy?: "provider" | "file" | "signal" | "none" | undefined;
+        sortBy?: "name" | "age" | "count" | undefined;
+        color?: "never" | "auto" | "always" | undefined;
+        maxDisplay?: number | undefined;
+    }>>;
+    healthScore: z.ZodDefault<z.ZodObject<{
+        weights: z.ZodDefault<z.ZodObject<{
+            age: z.ZodDefault<z.ZodNumber>;
+            lowUsage: z.ZodDefault<z.ZodNumber>;
+            hardcoded: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            age: number;
+            hardcoded: number;
+            lowUsage: number;
+        }, {
+            age?: number | undefined;
+            hardcoded?: number | undefined;
+            lowUsage?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        weights: {
+            age: number;
+            hardcoded: number;
+            lowUsage: number;
+        };
+    }, {
+        weights?: {
+            age?: number | undefined;
+            hardcoded?: number | undefined;
+            lowUsage?: number | undefined;
+        } | undefined;
+    }>>;
+    engine: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["regex", "tree-sitter"]>>>;
+}, "strict", z.ZodTypeAny, {
+    providers: {
+        name: string;
+        methods: {
+            name: string;
+            flagKeyIndex: number;
+        }[];
+        enabled: boolean;
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        importPattern?: string | undefined;
+    }[];
+    engine: Record<string, "regex" | "tree-sitter">;
+    paths: {
+        match: string;
+        threshold?: number | undefined;
+    }[];
+    threshold: number;
+    excludes: {
+        paths: string[];
+        files: string[];
+        presets: ("examples" | "test-files" | "snapshots" | "stories" | "fixtures" | "generated")[];
+    };
+    suppress: {
+        flags: string[];
+    };
+    output: {
+        format: "json" | "text" | "sarif" | "markdown" | "csv";
+        groupBy: "provider" | "file" | "signal" | "none";
+        sortBy: "name" | "age" | "count";
+        color: "never" | "auto" | "always";
+        maxDisplay: number;
+    };
+    healthScore: {
+        weights: {
+            age: number;
+            hardcoded: number;
+            lowUsage: number;
+        };
+    };
+}, {
+    providers?: {
+        name: string;
+        methods: {
+            name: string;
+            flagKeyIndex: number;
+        }[];
+        language: "go" | "typescript" | "javascript" | "python" | "java" | "kotlin" | "swift" | "ruby" | "csharp" | "php" | "rust" | "cpp" | "objc";
+        importPattern?: string | undefined;
+        enabled?: boolean | undefined;
+    }[] | undefined;
+    engine?: Record<string, "regex" | "tree-sitter"> | undefined;
+    paths?: {
+        match: string;
+        threshold?: number | undefined;
+    }[] | undefined;
+    threshold?: number | undefined;
+    excludes?: {
+        paths?: string[] | undefined;
+        files?: string[] | undefined;
+        presets?: ("examples" | "test-files" | "snapshots" | "stories" | "fixtures" | "generated")[] | undefined;
+    } | undefined;
+    suppress?: {
+        flags?: string[] | undefined;
+    } | undefined;
+    output?: {
+        format?: "json" | "text" | "sarif" | "markdown" | "csv" | undefined;
+        groupBy?: "provider" | "file" | "signal" | "none" | undefined;
+        sortBy?: "name" | "age" | "count" | undefined;
+        color?: "never" | "auto" | "always" | undefined;
+        maxDisplay?: number | undefined;
+    } | undefined;
+    healthScore?: {
+        weights?: {
+            age?: number | undefined;
+            hardcoded?: number | undefined;
+            lowUsage?: number | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type FlagsharkConfig = z.infer<typeof FlagsharkConfigSchema>;
+export type ExcludesConfig = z.infer<typeof ExcludesSchema>;
+export type SuppressConfig = z.infer<typeof SuppressSchema>;
+export type PathRuleConfig = z.infer<typeof PathRuleSchema>;
+export type OutputConfig = z.infer<typeof OutputConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,eAAO,MAAM,gBAAgB,wFAAuB,CAAA;AACpD,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,cAAc;;;;;;;;;;;;GAIb,CAAA;AAEd,eAAO,MAAM,cAAc;;;;;;GAEb,CAAA;AAEd,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,CAAA;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;GAMjB,CAAA;AAEd,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;GAMhB,CAAA;AAEd,eAAO,MAAM,YAAY,6EAGZ,CAAA;AAEb,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASvB,CAAA;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}