@opensip-cli/fitness 0.1.0

package/dist/framework/__tests__/scope-registry.test.js

@@ -0,0 +1,156 @@
+/**
+ * @fileoverview Scope-owned fitness registry contract (mirrors simulation's
+ * scope-bound registry tests). Covers the factories, the scope readers, the
+ * throw-outside-scope guards, and scope isolation — two concurrent
+ * `runWithScope` contexts must carry INDEPENDENT check/recipe registries.
+ */
+import { RunScope, runWithScope } from '@opensip-cli/core';
+import { describe, expect, it } from 'vitest';
+import { defineRecipe } from '../../recipes/types.js';
+import { fitnessTool } from '../../tool.js';
+import { defineCheck } from '../define-check.js';
+import { createCheckRegistry, createFitnessLoadState, createRecipeRegistry, currentCheckRegistry, currentFitnessLoadState, currentRecipeRegistry, } from '../scope-registry.js';
+let nextId = 0;
+function stubCheck(slug) {
+    nextId++;
+    return defineCheck({
+        id: `00000000-0000-4000-8000-${nextId.toString(16).padStart(12, '0')}`,
+        slug,
+        description: slug,
+        tags: ['demo'],
+        analyze: () => [],
+    });
+}
+/** Minimal user recipe for isolation assertions. */
+function stubRecipe(name) {
+    return defineRecipe({
+        name,
+        displayName: name,
+        description: name,
+        checks: { type: 'all' },
+    });
+}
+/** Construct a RunScope carrying fitness's contributed subscope. */
+function fitnessScope() {
+    const scope = new RunScope();
+    Object.assign(scope, fitnessTool.contributeScope?.() ?? {});
+    return scope;
+}
+describe('fitness scope-registry — factories', () => {
+    it('createCheckRegistry returns a fresh empty CheckRegistry', () => {
+        const reg = createCheckRegistry();
+        expect(reg.size).toBe(0);
+        reg.register(stubCheck('factory-check'));
+        expect(reg.size).toBe(1);
+    });
+    it('createRecipeRegistry returns a registry pre-seeded with built-ins', () => {
+        const reg = createRecipeRegistry();
+        expect(reg.has('default')).toBe(true);
+    });
+    it('createFitnessLoadState returns an empty lifecycle slot', () => {
+        const load = createFitnessLoadState();
+        expect(load.loadedFor).toBeNull();
+        expect(load.pluginLoadErrors).toEqual([]);
+        expect(load.loadWarnings).toEqual([]);
+    });
+});
+describe('fitness scope-registry — readers throw outside a scope', () => {
+    it('currentCheckRegistry throws when no scope is active', () => {
+        expect(() => currentCheckRegistry()).toThrow(/outside a RunScope/);
+    });
+    it('currentRecipeRegistry throws when no scope is active', () => {
+        expect(() => currentRecipeRegistry()).toThrow(/outside a RunScope/);
+    });
+    it('currentFitnessLoadState throws when no scope is active', () => {
+        expect(() => currentFitnessLoadState()).toThrow(/outside a RunScope/);
+    });
+    it('readers throw when the scope has no fitness subscope', async () => {
+        await runWithScope(new RunScope(), () => {
+            expect(() => currentCheckRegistry()).toThrow(/scope\.fitness is missing/);
+            expect(() => currentRecipeRegistry()).toThrow(/scope\.fitness is missing/);
+            expect(() => currentFitnessLoadState()).toThrow(/scope\.fitness is missing/);
+            return Promise.resolve();
+        });
+    });
+});
+describe('fitness scope-registry — readers resolve the scope-bound instances', () => {
+    it('currentCheckRegistry returns the scope.fitness.checks instance', async () => {
+        const scope = fitnessScope();
+        await runWithScope(scope, () => {
+            expect(currentCheckRegistry()).toBe(scope.fitness?.checks);
+            return Promise.resolve();
+        });
+    });
+    it('currentRecipeRegistry returns the scope.fitness.recipes instance', async () => {
+        const scope = fitnessScope();
+        await runWithScope(scope, () => {
+            expect(currentRecipeRegistry()).toBe(scope.fitness?.recipes);
+            return Promise.resolve();
+        });
+    });
+});
+describe('fitness scope-registry — scope isolation', () => {
+    it('two scopes carry INDEPENDENT check registries', async () => {
+        const scopeA = fitnessScope();
+        const scopeB = fitnessScope();
+        await runWithScope(scopeA, () => {
+            currentCheckRegistry().register(stubCheck('only-in-a'), 'a');
+            return Promise.resolve();
+        });
+        await runWithScope(scopeB, () => {
+            currentCheckRegistry().register(stubCheck('only-in-b'), 'b');
+            return Promise.resolve();
+        });
+        await runWithScope(scopeA, () => {
+            expect(currentCheckRegistry().getBySlug('a:only-in-a')).toBeDefined();
+            expect(currentCheckRegistry().getBySlug('b:only-in-b')).toBeUndefined();
+            return Promise.resolve();
+        });
+        await runWithScope(scopeB, () => {
+            expect(currentCheckRegistry().getBySlug('b:only-in-b')).toBeDefined();
+            expect(currentCheckRegistry().getBySlug('a:only-in-a')).toBeUndefined();
+            return Promise.resolve();
+        });
+    });
+    it('two scopes carry INDEPENDENT recipe registries', async () => {
+        const scopeA = fitnessScope();
+        const scopeB = fitnessScope();
+        await runWithScope(scopeA, () => {
+            currentRecipeRegistry().register(stubRecipe('only-in-a'));
+            return Promise.resolve();
+        });
+        await runWithScope(scopeB, () => {
+            currentRecipeRegistry().register(stubRecipe('only-in-b'));
+            return Promise.resolve();
+        });
+        await runWithScope(scopeA, () => {
+            // A's user recipe is visible in A; B's is not. Built-ins stay shared-by-value.
+            expect(currentRecipeRegistry().has('only-in-a')).toBe(true);
+            expect(currentRecipeRegistry().has('only-in-b')).toBe(false);
+            expect(currentRecipeRegistry().has('default')).toBe(true);
+            return Promise.resolve();
+        });
+        await runWithScope(scopeB, () => {
+            expect(currentRecipeRegistry().has('only-in-b')).toBe(true);
+            expect(currentRecipeRegistry().has('only-in-a')).toBe(false);
+            return Promise.resolve();
+        });
+    });
+    it('two scopes carry INDEPENDENT load state', async () => {
+        const scopeA = fitnessScope();
+        const scopeB = fitnessScope();
+        await runWithScope(scopeA, () => {
+            currentFitnessLoadState().loadedFor = '/project/a';
+            return Promise.resolve();
+        });
+        await runWithScope(scopeA, () => {
+            expect(currentFitnessLoadState().loadedFor).toBe('/project/a');
+            return Promise.resolve();
+        });
+        await runWithScope(scopeB, () => {
+            expect(currentFitnessLoadState().loadedFor).toBeNull();
+            return Promise.resolve();
+        });
+    });
+});
+//# sourceMappingURL=scope-registry.test.js.map

package/dist/framework/__tests__/scope-registry.test.js.map

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

package/dist/framework/__tests__/scope-resolver.golden.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope-resolver.golden.test.d.ts.map

package/dist/framework/__tests__/scope-resolver.golden.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.golden.test.d.ts","sourceRoot":"","sources":["../../../src/framework/__tests__/scope-resolver.golden.test.ts"],"names":[],"mappings":""}

package/dist/framework/__tests__/scope-resolver.golden.test.js

@@ -0,0 +1,105 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { TargetRegistry } from '../../targets/target-registry.js';
+import { buildScopeBasedFileMap } from '../scope-resolver.js';
+/**
+ * ADR-0037 enforcement-reason guard (2): fitness per-check file-set resolution
+ * is BYTE-IDENTICAL through the Phase 2 substrate migration. A fixed corpus of
+ * checks × targets is resolved by the live `buildScopeBasedFileMap` (which now
+ * globs via `@opensip-cli/targeting`) and asserted against a checked-in golden.
+ *
+ * The corpus exercises every resolution path:
+ *  - per-target `exclude`            (the test-file glob drops src test files from ts-src)
+ *  - project `globalExcludes`        (the generated-dir glob drops files everywhere)
+ *  - multi-target union              (multi-check → ts-src ∪ rs-src)
+ *  - checkOverrides precedence       (tier 1: override-check → docs)
+ *  - findByScope match               (tier 2: ts-check, multi-check)
+ *  - unscoped → not-in-map           (tier 3: unscoped-check absent)
+ *
+ * The golden was eyeballed for correctness; equality with the pre-migration
+ * output is further backed by the unchanged scope-resolver.test.ts behavior
+ * anchor (Phase 2 kept all 689 fitness tests green).
+ */
+let testDir;
+function fixture(rel) {
+    const abs = join(testDir, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, '');
+}
+function makeTarget(name, opts) {
+    return {
+        config: {
+            name,
+            description: name,
+            include: opts.include ?? [],
+            exclude: opts.exclude ?? [],
+            ...(opts.languages && { languages: opts.languages }),
+            ...(opts.concerns && { concerns: opts.concerns }),
+        },
+    };
+}
+/** Relativize + sort each entry so the golden is path-stable across machines. */
+function relativizeMap(map) {
+    const out = {};
+    for (const [slug, files] of map) {
+        out[slug] = files.map((f) => f.slice(testDir.length + 1)).sort();
+    }
+    return out;
+}
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-scope-golden-'));
+    // ── corpus fixtures ──
+    fixture('src/a.ts');
+    fixture('src/b.ts');
+    fixture('src/a.test.ts'); // dropped by ts-src per-target exclude
+    fixture('src/generated/g.ts'); // dropped by globalExcludes
+    fixture('rust/lib.rs');
+    fixture('rust/generated/g.rs'); // dropped by globalExcludes
+    fixture('docs/readme.md');
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('scope-resolver golden (byte-identical through the substrate migration)', () => {
+    it('resolves the fixed corpus to the golden file sets', () => {
+        const registry = new TargetRegistry();
+        registry.register(makeTarget('ts-src', {
+            include: ['src/**/*.ts'],
+            exclude: ['**/*.test.ts'],
+            languages: ['typescript'],
+            concerns: ['backend'],
+        }));
+        registry.register(makeTarget('rs-src', {
+            include: ['rust/**/*.rs'],
+            languages: ['rust'],
+            concerns: ['backend'],
+        }));
+        registry.register(makeTarget('docs', {
+            include: ['docs/**/*.md'],
+            languages: ['markdown'],
+            concerns: ['documentation'],
+        }));
+        const config = {
+            globalExcludes: ['**/generated/**'],
+            checkOverrides: { 'override-check': 'docs' },
+        };
+        const checks = [
+            { slug: 'ts-check', scope: { languages: ['typescript'], concerns: ['backend'] } },
+            { slug: 'multi-check', scope: { languages: ['typescript', 'rust'], concerns: ['backend'] } },
+            { slug: 'override-check' }, // tier 1 via checkOverrides
+            { slug: 'unscoped-check' }, // tier 3 → absent from the map
+        ];
+        const result = relativizeMap(buildScopeBasedFileMap(checks, registry, config, testDir));
+        const golden = {
+            'ts-check': ['src/a.ts', 'src/b.ts'],
+            'multi-check': ['rust/lib.rs', 'src/a.ts', 'src/b.ts'],
+            'override-check': ['docs/readme.md'],
+            // unscoped-check intentionally ABSENT (tier 3 → fileCache fallback)
+        };
+        expect(result).toEqual(golden);
+        expect(result['unscoped-check']).toBeUndefined();
+    });
+});
+//# sourceMappingURL=scope-resolver.golden.test.js.map

package/dist/framework/__tests__/scope-resolver.golden.test.js.map

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

package/dist/framework/__tests__/scope-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope-resolver.test.d.ts.map

package/dist/framework/__tests__/scope-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-resolver.test.d.ts","sourceRoot":"","sources":["../../../src/framework/__tests__/scope-resolver.test.ts"],"names":[],"mappings":""}

package/dist/framework/__tests__/scope-resolver.test.js

@@ -0,0 +1,150 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { TargetRegistry } from '../../targets/target-registry.js';
+import { buildScopeBasedFileMap } from '../scope-resolver.js';
+let testDir;
+function fixture(rel, content = '') {
+    const abs = join(testDir, rel);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+    return abs;
+}
+function makeRegistry(targets) {
+    const reg = new TargetRegistry();
+    for (const t of targets)
+        reg.register(t);
+    return reg;
+}
+function makeTarget(name, opts) {
+    return {
+        config: {
+            name,
+            description: name,
+            include: opts.include ?? [],
+            exclude: opts.exclude ?? [],
+            ...(opts.languages && { languages: opts.languages }),
+            ...(opts.concerns && { concerns: opts.concerns }),
+        },
+    };
+}
+function makeConfig(overrides = {}) {
+    return {
+        globalExcludes: overrides.globalExcludes ?? [],
+        checkOverrides: overrides.checkOverrides ?? {},
+        ...overrides,
+    };
+}
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-scope-resolver-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('buildScopeBasedFileMap', () => {
+    it('returns an empty map when no checks have scopes or overrides', () => {
+        const registry = makeRegistry([
+            makeTarget('src', {
+                include: ['src/**/*.ts'],
+                languages: ['typescript'],
+                concerns: ['backend'],
+            }),
+        ]);
+        const out = buildScopeBasedFileMap([], registry, makeConfig(), testDir);
+        expect(out.size).toBe(0);
+    });
+    it('matches checks to targets by scope.languages + concerns', () => {
+        fixture('src/a.ts');
+        fixture('src/b.ts');
+        fixture('lib/c.rs');
+        const registry = makeRegistry([
+            makeTarget('ts-src', {
+                include: ['src/**/*.ts'],
+                languages: ['typescript'],
+                concerns: ['backend'],
+            }),
+            makeTarget('rs-lib', {
+                include: ['lib/**/*.rs'],
+                languages: ['rust'],
+                concerns: ['backend'],
+            }),
+        ]);
+        const out = buildScopeBasedFileMap([{ slug: 'ts-check', scope: { languages: ['typescript'], concerns: ['backend'] } }], registry, makeConfig(), testDir);
+        const tsFiles = out.get('ts-check');
+        expect(tsFiles).toBeDefined();
+        expect(tsFiles?.length).toBe(2);
+        expect(tsFiles?.every((f) => f.endsWith('.ts'))).toBe(true);
+    });
+    it('returns empty when scope matches no targets', () => {
+        fixture('src/a.ts');
+        const registry = makeRegistry([
+            makeTarget('ts-src', {
+                include: ['src/**/*.ts'],
+                languages: ['typescript'],
+                concerns: ['backend'],
+            }),
+        ]);
+        const out = buildScopeBasedFileMap([{ slug: 'cobol-check', scope: { languages: ['cobol'], concerns: ['mainframe'] } }], registry, makeConfig(), testDir);
+        expect(out.get('cobol-check')).toEqual([]);
+    });
+    it('uses checkOverrides when present', () => {
+        fixture('src/a.ts');
+        fixture('test/b.ts');
+        const registry = makeRegistry([
+            makeTarget('src', { include: ['src/**/*.ts'] }),
+            makeTarget('test', { include: ['test/**/*.ts'] }),
+        ]);
+        const out = buildScopeBasedFileMap([{ slug: 'narrow-check', scope: { languages: [], concerns: [] } }], registry, makeConfig({ checkOverrides: { 'narrow-check': 'test' } }), testDir);
+        const files = out.get('narrow-check');
+        expect(files?.length).toBe(1);
+        expect(files?.[0]?.endsWith('test/b.ts')).toBe(true);
+    });
+    it('honors checkOverrides that point to multiple targets', () => {
+        fixture('src/a.ts');
+        fixture('test/b.ts');
+        const registry = makeRegistry([
+            makeTarget('src', { include: ['src/**/*.ts'] }),
+            makeTarget('test', { include: ['test/**/*.ts'] }),
+        ]);
+        const out = buildScopeBasedFileMap([{ slug: 'broad-check', scope: { languages: [], concerns: [] } }], registry, makeConfig({ checkOverrides: { 'broad-check': ['src', 'test'] } }), testDir);
+        expect(out.get('broad-check')?.length).toBe(2);
+    });
+    it('applies globalExcludes during pre-resolution', () => {
+        fixture('src/a.ts');
+        fixture('src/ignore-me/b.ts');
+        const registry = makeRegistry([
+            makeTarget('src', {
+                include: ['src/**/*.ts'],
+                languages: ['typescript'],
+                concerns: ['backend'],
+            }),
+        ]);
+        const out = buildScopeBasedFileMap([{ slug: 'check', scope: { languages: ['typescript'], concerns: ['backend'] } }], registry, makeConfig({ globalExcludes: ['**/ignore-me/**'] }), testDir);
+        const files = out.get('check') ?? [];
+        expect(files.some((f) => f.includes('ignore-me'))).toBe(false);
+        expect(files.length).toBe(1);
+    });
+    it('applies per-target excludes', () => {
+        fixture('src/a.ts');
+        fixture('src/skip.ts');
+        const registry = makeRegistry([
+            makeTarget('src', {
+                include: ['src/**/*.ts'],
+                exclude: ['**/skip.ts'],
+                languages: ['typescript'],
+                concerns: ['backend'],
+            }),
+        ]);
+        const out = buildScopeBasedFileMap([{ slug: 'check', scope: { languages: ['typescript'], concerns: ['backend'] } }], registry, makeConfig(), testDir);
+        const files = out.get('check') ?? [];
+        expect(files.some((f) => f.endsWith('skip.ts'))).toBe(false);
+    });
+    it('skips checks without a scope and without an override', () => {
+        fixture('src/a.ts');
+        const registry = makeRegistry([makeTarget('src', { include: ['src/**/*.ts'] })]);
+        const out = buildScopeBasedFileMap([{ slug: 'unscoped' }], registry, makeConfig(), testDir);
+        expect(out.has('unscoped')).toBe(false);
+    });
+});
+//# sourceMappingURL=scope-resolver.test.js.map

package/dist/framework/__tests__/scope-resolver.test.js.map

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

package/dist/framework/__tests__/severity-mapping.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=severity-mapping.test.d.ts.map

package/dist/framework/__tests__/severity-mapping.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-mapping.test.d.ts","sourceRoot":"","sources":["../../../src/framework/__tests__/severity-mapping.test.ts"],"names":[],"mappings":""}

package/dist/framework/__tests__/severity-mapping.test.js

@@ -0,0 +1,74 @@
+import { logger } from '@opensip-cli/core';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { mapFindingSeverity, mapTagsToSignalCategory } from '../severity-mapping.js';
+describe('mapFindingSeverity', () => {
+    it('maps "error" to "high"', () => {
+        expect(mapFindingSeverity('error')).toBe('high');
+    });
+    it('maps "warning" to "medium"', () => {
+        expect(mapFindingSeverity('warning')).toBe('medium');
+    });
+    it('falls back to "medium" for unknown severities', () => {
+        // @ts-expect-error — exercising the runtime default
+        expect(mapFindingSeverity('whatever')).toBe('medium');
+    });
+});
+describe('mapTagsToSignalCategory', () => {
+    it.each([
+        ['security', 'security'],
+        ['performance', 'performance'],
+        ['architecture', 'architecture'],
+        ['resilience', 'resilience'],
+        ['testing', 'testing'],
+        ['documentation', 'documentation'],
+    ])('maps %s tag to %s category', (tag, category) => {
+        expect(mapTagsToSignalCategory([tag])).toBe(category);
+    });
+    it('maps "quality" tag to "warning" category', () => {
+        expect(mapTagsToSignalCategory(['quality'])).toBe('warning');
+    });
+    it('falls back to "warning" when no recognized tag matches', () => {
+        expect(mapTagsToSignalCategory(['custom-tag'])).toBe('warning');
+    });
+    it('returns "warning" for an empty tag list', () => {
+        expect(mapTagsToSignalCategory([])).toBe('warning');
+    });
+    it('uses the first matching tag (priority order)', () => {
+        // 'quality' comes after 'security' lexically but the function iterates the
+        // input array in order, so 'security' wins here.
+        expect(mapTagsToSignalCategory(['quality', 'security'])).toBe('warning');
+        expect(mapTagsToSignalCategory(['security', 'quality'])).toBe('security');
+    });
+});
+describe('mapTagsToSignalCategory — warn-once on unknown tags', () => {
+    let warnSpy;
+    beforeEach(() => {
+        warnSpy = vi.spyOn(logger, 'warn').mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        warnSpy.mockRestore();
+    });
+    it("warns when a check's tags include none of the known categories", () => {
+        // Use a tag-set we have not seen before so the dedupe cache misses.
+        expect(mapTagsToSignalCategory(['custom-foo-misspelled'])).toBe('warning');
+        expect(warnSpy).toHaveBeenCalled();
+        const call = warnSpy.mock.calls[0]?.[0];
+        expect(call?.evt).toBe('fitness.severity_mapping.unknown_tags');
+        expect(call?.tags).toEqual(['custom-foo-misspelled']);
+    });
+    it('warns only once for the same unknown tag-set', () => {
+        mapTagsToSignalCategory(['warn-once-fixture-tag']);
+        mapTagsToSignalCategory(['warn-once-fixture-tag']);
+        mapTagsToSignalCategory(['warn-once-fixture-tag']);
+        const matching = warnSpy.mock.calls.filter((c) => {
+            const arg = c[0];
+            return arg?.tags?.[0] === 'warn-once-fixture-tag';
+        });
+        expect(matching.length).toBe(1);
+    });
+    it('does not warn when at least one known tag is present', () => {
+        mapTagsToSignalCategory(['security', 'totally-unknown']);
+        expect(warnSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=severity-mapping.test.js.map

package/dist/framework/__tests__/severity-mapping.test.js.map

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

package/dist/framework/__tests__/strip-literals.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strip-literals.test.d.ts.map

package/dist/framework/__tests__/strip-literals.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strip-literals.test.d.ts","sourceRoot":"","sources":["../../../src/framework/__tests__/strip-literals.test.ts"],"names":[],"mappings":""}