Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.
Python aicode-complexitycode-healthcode-intelligencecode-qualitydead-codedeveloper-toolsdocumentationgit-analyticsmcpopen-sourcepythonrefactoringstatic-analysistechnical-debt
fix(dead-code): evaluate top-level exported const literals as unused exports in TS/JS (#1065)
Akshat malik9bc36f6b7fbd
diff --git a/docs/layers/DEAD_CODE.md b/docs/layers/DEAD_CODE.mdindex 2f7dac476..a45a1e9c5 100644--- a/docs/layers/DEAD_CODE.md+++ b/docs/layers/DEAD_CODE.md@@ -43,7 +43,7 @@ get_dead_code(kind="unused_export", group_by="owner")| Kind | What it means | How it is computed | Base confidence ||------|---------------|--------------------|-----------------|| `unreachable_file` | No file in the repo imports this one. | File-node in-degree of 0 on the dependency graph, after entry points and the never-flag allowlist are removed. | Scored from git age (below) |-| `unused_export` | A public symbol nothing imports. | No `imports` edge names the symbol (or `*`, or a TypeScript `export { local as alias }` rename), and no `calls` / `method_implements` / `reads` / `extends` / `implements` / `type_use` edge reaches it. | `1.00` when the containing file *does* have importers (so the file is alive and only this symbol is not), `0.70` when it does not, `0.30` when the name ends in `_DEPRECATED` / `_LEGACY` / `_COMPAT` |+| `unused_export` | A public symbol nothing imports. | No `imports` edge names the symbol (or `*`, or a TypeScript `export { local as alias }` rename), and no `calls` / `method_implements` / `reads` / `extends` / `implements` / `type_use` edge reaches it. Member kinds (`method`, `field`, `property`, `enum_member`) are excluded from this pass across all languages since they are accessed through their container, not imported by name. Top-level `export const` primitives, objects, and arrays in TypeScript and JavaScript are fully evaluated (they are always importable by name). | `1.00` when the containing file *does* have importers (so the file is alive and only this symbol is not), `0.70` when it does not, `0.30` when the name ends in `_DEPRECATED` / `_LEGACY` / `_COMPAT` || `unused_internal` | A private or underscore-prefixed symbol nothing calls. | No `calls` edge, and no cross-file importer pulls the name (which would mean a dispatch-table lookup). Off by default. | `0.65` || `zombie_package` | A whole top-level package no other package imports. | No inter-package import edges into it. Never marked safe to delete. | `0.50` |@@ -140,6 +140,15 @@ evidence is not evidence of absence), and COM contract methods(`QueryInterface`, `AddRef`, `Release`) are capped the same way because they aredispatched through native vtables.+**Symbol-kind exemptions in the unused-export pass.** Class methods, struct+fields, properties, and enum members are never evaluated as unused exports across+all languages — they are only reachable through their enclosing container, not+independently importable. Top-level `export const` declarations in TypeScript and+JavaScript (`export const API_URL = "..."`, `export const config = {...}`) are+*not* exempt: they are module-level named exports and are fully evaluated. Non-exported+constants (declared without `export`) are automatically private and never reach+the pass.+Zombie-package detection additionally ignores directories that are not packagesat all: `.github`, `.vscode`, `.devcontainer`, `docs`, `scripts`, `assets`,`static`, `public`, `tests`, `benches`, `fuzz`, and their siblings.diff --git a/packages/core/src/repowise/core/analysis/dead_code/analyzer.py b/packages/core/src/repowise/core/analysis/dead_code/analyzer.pyindex 430ffb877..87cbabf1e 100644--- a/packages/core/src/repowise/core/analysis/dead_code/analyzer.py+++ b/packages/core/src/repowise/core/analysis/dead_code/analyzer.py@@ -80,6 +80,10 @@ _LANGUAGE_NON_IMPORTABLE: dict[str, frozenset[str]] = {}+# Kinds allowed as top-level imports in TS/JS (top-level `export const` literals/objects)+_TS_JS_IMPORTABLE_KINDS: frozenset[str] = frozenset({"constant", "variable"})++def _non_importable_kinds(language: str) -> frozenset[str]:"""Per-language set of symbol kinds excluded from unused-export passes.@@ -89,10 +93,13 @@ def _non_importable_kinds(language: str) -> frozenset[str]:"""extra = _LANGUAGE_NON_IMPORTABLE.get(language)if extra is None:+ if language in ("typescript", "javascript"):+ return _UNIVERSAL_NON_IMPORTABLE - _TS_JS_IMPORTABLE_KINDSreturn _UNIVERSAL_NON_IMPORTABLEreturn _UNIVERSAL_NON_IMPORTABLE | extra+# Preserved for tests / external callers that imported the old name.# New code should prefer ``_non_importable_kinds(language)``._NON_IMPORTABLE_SYMBOL_KINDS: frozenset[str] = _UNIVERSAL_NON_IMPORTABLE | frozenset({"interface"})diff --git a/tests/unit/analysis/test_ts_never_flag.py b/tests/unit/analysis/test_ts_never_flag.pyindex 32cd290b0..010fc910c 100644--- a/tests/unit/analysis/test_ts_never_flag.py+++ b/tests/unit/analysis/test_ts_never_flag.py@@ -112,3 +112,26 @@ class TestEntryPointSymbolNames:from repowise.core.analysis.dead_code.analyzer import _ENTRY_POINT_SYMBOL_NAMESfor name in ("load", "action", "loader", "meta", "metadata", "config", "headers"):assert name not in _ENTRY_POINT_SYMBOL_NAMES+++class TestTsUnusedExportConstants:+ def test_non_importable_kinds_allows_ts_const_and_var(self):+ from repowise.core.analysis.dead_code.analyzer import _non_importable_kinds+ kinds = _non_importable_kinds("typescript")+ assert "constant" not in kinds+ assert "variable" not in kinds+ assert "method" in kinds+ assert "field" in kinds++ def test_non_importable_kinds_allows_js_const_and_var(self):+ from repowise.core.analysis.dead_code.analyzer import _non_importable_kinds+ kinds = _non_importable_kinds("javascript")+ assert "constant" not in kinds+ assert "variable" not in kinds++ def test_other_languages_retain_universal_non_importable(self):+ from repowise.core.analysis.dead_code.analyzer import _non_importable_kinds+ python_kinds = _non_importable_kinds("python")+ assert "constant" in python_kinds+ assert "variable" in python_kinds+