';"""
+ "\n// styles.card\n"
+ r"""export const View = () =>
;""",
+ encoding="utf-8",
+ )
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+ assert {finding.name for finding in findings} == {"card"}
+ assert all(finding.removable for finding in findings)
+
+
+@pytest.mark.parametrize("extension", ["ts", "tsx"])
+@pytest.mark.parametrize(
+ "declaration",
+ [
+ r"""function view
() { return styles.card; }""",
+ r"""const view = () => styles.card;""",
+ r"""const view = () => styles.card;""",
+ r"""const view = () => styles.card;""",
+ ],
+)
+def test_type_parameter_heads_keep_javascript_string_escaping(tmp_path, extension, declaration):
+ (tmp_path / "Card.module.css").write_text(".card {}\n.unused {}\n", encoding="utf-8")
+ (tmp_path / f"consumer.{extension}").write_text(
+ f"import styles from './Card.module.css';\n{declaration}\n", encoding="utf-8"
+ )
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+ assert {finding.name for finding in findings} == {"unused"}
+ assert all(finding.removable for finding in findings)
+
+
+@pytest.mark.parametrize("extension", ["tsx", "jsx"])
+@pytest.mark.parametrize(
+ "view",
+ [
+ "It's
",
+ 'He said "hello
',
+ "https://example.test
",
+ "/* raw child prose
",
+ "`raw child prose
",
+ "<>It's {flag ? : null}",
+ 'It\'s {"quoted \\" value"}
',
+ "It's a child
; element.className = styles.card",
+ ],
+)
+def test_jsx_child_text_preserves_live_rules_and_following_code(tmp_path, monkeypatch, extension, view):
+ test_raw_jsx_attribute_quotes_preserve_live_module_rules(tmp_path, monkeypatch, extension, view)
+
+
+@pytest.mark.parametrize("extension", ["tsx", "jsx"])
+def test_jsx_child_prose_does_not_invent_module_access(tmp_path, extension):
+ (tmp_path / "Card.module.css").write_text(".card {}\n", encoding="utf-8")
+ (tmp_path / f"consumer.{extension}").write_text(
+ "import styles from './Card.module.css';\nconst View=()=> It's styles.card // prose /* text */ `text`
;\n",
+ encoding="utf-8",
+ )
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+ assert len(findings) == 1 and findings[0].name == "card" and findings[0].removable
+
+
+def test_typescript_assertion_with_apparent_closing_tag_keeps_live_access(tmp_path):
+ (tmp_path / "Card.module.css").write_text(".card {}\n.unused {}\n", encoding="utf-8")
+ (tmp_path / "consumer.ts").write_text(
+ "import styles from './Card.module.css';\nconst selected=render(\"\"); const live=styles.card;\n",
+ encoding="utf-8",
+ )
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+ assert {finding.name for finding in findings} == {"unused"}
+
+
+@pytest.mark.parametrize("tag", ["Élément", "Button"])
+def test_generic_and_unicode_jsx_keep_module_and_literal_classes(tmp_path, tag):
+ (tmp_path / "Card.module.css").write_text(".card {}\n.unused {}\n", encoding="utf-8")
+ (tmp_path / "global.css").write_text(".literal {}\n.unusedGlobal {}\n", encoding="utf-8")
+ closing = tag.split("<")[0]
+ (tmp_path / "consumer.tsx").write_text(
+ "import styles from './Card.module.css';\n"
+ f'<{tag} className="literal">It\'s ;\n',
+ encoding="utf-8",
+ )
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+ assert {finding.name for finding in findings} == {"unused", "unusedGlobal"}
+ assert all(finding.removable for finding in findings)
+
+
+@pytest.mark.parametrize("extension", ["tsx", "jsx"])
+@pytest.mark.parametrize("tag", ["_Button", "$Button", "Button$", "Élément"])
+def test_all_jsx_identifier_forms_keep_raw_attribute_grammar(tmp_path, monkeypatch, extension, tag):
+ view = rf'<{tag} data-path="C:\" className={{styles.card}} />'
+ test_raw_jsx_attribute_quotes_preserve_live_module_rules(tmp_path, monkeypatch, extension, view)
+
+
+@pytest.mark.parametrize("extension", ["ts", "tsx"])
+@pytest.mark.parametrize(
+ "expression,live",
+ [("a < styles.card > (b)", False), ("(a < styles.card) > b", True), ("a < styles.card > b", True)],
+)
+def test_angle_expression_usage_agrees_with_typescript_emission(tmp_path, extension, expression, live):
+ # TypeScript 5.9.3 emits a(b) for the first expression, and preserves the
+ # two explicitly relational forms. Whitespace does not change that grammar.
+ (tmp_path / "Card.module.css").write_text(".card {}\n", encoding="utf-8")
+ (tmp_path / f"consumer.{extension}").write_text(
+ f"import styles from './Card.module.css';\nconst value = {expression};\n", encoding="utf-8"
+ )
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+ assert bool(findings) is not live
+ assert all(finding.name == "card" and finding.removable for finding in findings)
diff --git a/tests/test_namespace_sideeffect_imports.py b/tests/test_namespace_sideeffect_imports.py
index eb9cd6a..a812040 100644
--- a/tests/test_namespace_sideeffect_imports.py
+++ b/tests/test_namespace_sideeffect_imports.py
@@ -19,9 +19,7 @@ def _make_project(tmp_path: Path, consumer_source: str) -> Path:
"""utils.ts defines two exports; main.ts consumes it per consumer_source."""
utils = tmp_path / "src" / "utils.ts"
utils.parent.mkdir(parents=True, exist_ok=True)
- utils.write_text(
- "export function helper() { return 1; }\nexport const RATE = 2;\n"
- )
+ utils.write_text("export function helper() { return 1; }\nexport const RATE = 2;\n")
main = tmp_path / "src" / "main.ts"
main.write_text(consumer_source)
return tmp_path
@@ -40,8 +38,7 @@ class TestNamespaceImports:
def test_namespace_import_marks_all_exports_used(self, tmp_path):
project = _make_project(
tmp_path,
- "import * as Utils from './utils';\n\n"
- "const total = Utils.helper() + Utils.RATE;\nexport default total;\n",
+ "import * as Utils from './utils';\n\nconst total = Utils.helper() + Utils.RATE;\nexport default total;\n",
)
# Neither utils.ts export may be flagged: both are consumed via the
# namespace binding.
@@ -87,10 +84,7 @@ class TestDynamicAndRequireImports:
def test_dynamic_import_marks_all_exports_used(self, tmp_path):
project = _make_project(
tmp_path,
- "export async function load() {\n"
- " const u = await import('./utils');\n"
- " return u.helper() + u.RATE;\n"
- "}\n",
+ "export async function load() {\n const u = await import('./utils');\n return u.helper() + u.RATE;\n}\n",
)
assert not [f for _n, f in _unused_names(project) if f.endswith("utils.ts")]
diff --git a/tests/test_nested_include.py b/tests/test_nested_include.py
new file mode 100644
index 0000000..d83f23f
--- /dev/null
+++ b/tests/test_nested_include.py
@@ -0,0 +1,48 @@
+"""File include patterns must not prune unmatched ancestor directories."""
+
+import json
+
+import pytest
+from click.testing import CliRunner
+
+from deadcode.cli import cli
+from deadcode.scanner import DeadCodeScanner
+
+
+@pytest.fixture
+def nested_project(tmp_path):
+ nested = tmp_path / "src" / "components"
+ nested.mkdir(parents=True)
+ (nested / "Unused.tsx").write_text("export const unused = 1;\n")
+ (nested / "ignored.tsx").write_text("export const ignored = 2;\n")
+ (tmp_path / "outside.ts").write_text("export const outside = 3;\n")
+ return tmp_path
+
+
+@pytest.mark.parametrize("pattern", ["src/components/*.tsx", "**/*.tsx", "src/components/Unused.tsx"])
+def test_nested_file_whitelist_reaches_matching_files(nested_project, pattern):
+ result = DeadCodeScanner(nested_project, include_patterns=[pattern], ignore_patterns=["**/ignored.tsx"]).scan()
+
+ assert result.files_scanned == 1
+ assert [(finding.file, finding.name) for finding in result.findings] == [("src/components/Unused.tsx", "unused")]
+
+
+@pytest.mark.parametrize("command", [["scan", "--format=json"], ["stats"], ["remove", "--dry-run"]])
+def test_nested_whitelist_applies_to_all_cli_commands(nested_project, command):
+ source = nested_project / "src" / "components" / "Unused.tsx"
+ original = source.read_bytes()
+
+ result = CliRunner().invoke(
+ cli,
+ ["-p", str(nested_project), "--include", "src/components/Unused.tsx", *command],
+ )
+
+ assert result.exit_code == 0
+ if command[0] == "scan":
+ assert json.loads(result.output)["files_scanned"] == 1
+ elif command[0] == "stats":
+ assert "Files scanned: 1" in result.output
+ else:
+ assert "WOULD REMOVE" in result.output
+ assert "outside.ts" not in result.output
+ assert source.read_bytes() == original
diff --git a/tests/test_typescript_class_usage.py b/tests/test_typescript_class_usage.py
new file mode 100644
index 0000000..530b555
--- /dev/null
+++ b/tests/test_typescript_class_usage.py
@@ -0,0 +1,309 @@
+"""Erased TypeScript declarations cannot invent or obscure runtime CSS uses."""
+
+import time
+
+import pytest
+from click.testing import CliRunner
+
+from deadcode.cli import cli
+from deadcode.scanner import DeadCodeScanner
+
+
+@pytest.fixture(autouse=True)
+def no_countdown(monkeypatch):
+ monkeypatch.setattr(time, "sleep", lambda _: None)
+
+
+ERASED_CASES = [
+ ('interface Props { className: "legacy" }', "ts"),
+ ("type Props = { className: string }", "ts"),
+ ('export interface Props { className: string }', "tsx"),
+ ('export type Props = { nested: { className: "legacy" }; class: string };', "ts"),
+ ('type Props = { readonly className?: "legacy"; class: string }', "ts"),
+ ('type Props =\n | { className: "legacy" }\n | { class: string }\nconst next = 1;', "ts"),
+ ('type Props = ({ className: "legacy" } & { class: string })[];', "ts"),
+ ('type Props = T extends string ? {className: "legacy"} : {class: string};', "ts"),
+ ('type Props = () => { className: "legacy" };', "ts"),
+ ("type Props = (value: T) => { className: string };", "ts"),
+ ('type Props = `className: "legacy"`;', "ts"),
+ ("declare const props: { className: string };", "ts"),
+ ('declare function props(): { className: "legacy" };', "ts"),
+ ('declare class Props { className: "legacy"; }', "ts"),
+ ("declare namespace Props { const attrs: {className: string}; }", "ts"),
+ ('declare module "props" { export interface Props { className: string } }', "ts"),
+ ('export {}; declare global { interface Props { className: "legacy" } }', "ts"),
+ ("export declare const props: { className: string };", "ts"),
+ ("export const props: { className: string };", "d.ts"),
+ ("const props: { className: string } = {} as never;", "ts"),
+ ("function view(props: { className: string }): void {}", "ts"),
+ ("const view = (props: { className: string }): void => {};", "tsx"),
+ ('class Props { className: "legacy"; }', "ts"),
+ ('class Props { declare className: "legacy"; }', "ts"),
+ ("class Props { attrs: { className: string }; }", "ts"),
+ ("import type styles from './Card.module.css'; type Props = typeof styles['legacy'];", "ts"),
+ ("import styles from './Card.module.css'; type Props = typeof styles['legacy'];", "ts"),
+ ('interface Props extends Base<{className: "legacy"}> { className: string }', "ts"),
+ ("type Props = Readonly<{className: string}>;", "ts"),
+ ('type Props = new (value: {className: string}) => {className: "legacy"};', "ts"),
+ ('type Props = { [Key in "className"]: string };', "ts"),
+ ('type Props = {className: import("./props").Name};', "ts"),
+ ('type Props = {className: "legacy"} | null;', "ts"),
+ ("declare const props: {className: string}\nconst next = 1;", "ts"),
+ ("declare function props(): {className: string}\nconst next = 1;", "ts"),
+ ('declare class Props { className: "legacy" }', "ts"),
+ ("const props = source<{className: string}>;", "ts"),
+]
+
+
+RUNTIME_CASES = [
+ ('interface Props { className: "legacy" }\nconst attrs = {className: "live"};', "ts"),
+ ('type Props = {className: string}\nconst attrs = {className: "live"};', "ts"),
+ ('type Props = {className: string}\nconst view = ;', "tsx"),
+ ('const attrs: {className: string} = {className: "live"};', "ts"),
+ ('let a: {className: string}, attrs: {className: string} = {className: "live"};', "ts"),
+ ('function view(props: {className: string} = {className: "live"}) {}', "ts"),
+ ('function view(): {className: string} { return {className: "live"}; }', "ts"),
+ ('const view = (): {className: string} => ({className: "live"});', "tsx"),
+ ('const attrs = {className: "live"} satisfies {className: string};', "ts"),
+ ('const attrs = ({className: "live"} as {className: string});', "ts"),
+ ('const attrs = <{className: string}>{className: "live"};', "ts"),
+ ('declare function make(value: T): T; make<{className: string}>({className: "live"});', "ts"),
+ ('const view = className="live" />;', "tsx"),
+ ('function view() { return {className: "live"}; }', "ts"),
+ ('const view = () => ;', "tsx"),
+ ('class Props { className: string = "live"; }', "ts"),
+ ('class Props { className = "live"; }', "js"),
+ ('class Props { getAttrs(): {className: string} { return {className: "live"}; } }', "ts"),
+ ('const attrs = {view(): {className: string} { return {className: "live"}; }};', "ts"),
+ ('const type = {className: "live"}; const attrs = {interface: type, declare: type};', "ts"),
+ ('const attrs = {interface: {className: "live"}, type: 1, declare: 1};', "ts"),
+ ('const pattern = /interface\\s+Props\\{className: string\\}/; const attrs = {className: "live"};', "ts"),
+ ('// interface Props {className: string}\nconst attrs = {className: "live"};', "ts"),
+ ('const text = "type Props = {className: string}"; const attrs = {className: "live"};', "ts"),
+ ('const text = `interface Props {className: string}`; const attrs = {className: "live"};', "ts"),
+ ('const text = `${use({className: "live"})}`;', "ts"),
+ ('const text = `${`${use({className: "live"})}`}`;', "ts"),
+ ('const text = `${(() => {type Props = {className: string}; return use({className: "live"});})()}`;', "ts"),
+ ('const text = `${/}/.test(value) ? use({className: "live"}) : null}`;', "ts"),
+ ('class Props {className: string = "live";}', "ts"),
+ ('class Props extends make({className: "live"}) {}', "ts"),
+ ('class Props {other = 1\nclassName: string = "live"\n}', "ts"),
+ ('namespace Props { export const attrs: {className: string} = {className: "live"}; }', "ts"),
+ ('const attrs = {"className": "live"};', "ts"),
+ ('const attrs = {className: clsx("live")};', "ts"),
+ ('const view = className="live" />;', "tsx"),
+ ('class Props {view(): {className: string} {return {className: "live"};}}', "ts"),
+ ('const view = async () => ;', "tsx"),
+]
+
+
+UNKNOWN_CASES = [
+ ("type Props = {className: string}; const attrs = {className: selected};", "ts"),
+ ("interface Props {className: string} const view = ;", "tsx"),
+ ("type Props = {className: string}; const view = ;", "tsx"),
+ ('const attrs: {className: string} = {className: "prefix" + selected};', "ts"),
+ ("class Props { className: string = selected; }", "ts"),
+ ("class Props { className = selected; }", "js"),
+ ("const attrs = {className: selected} satisfies {className: string};", "ts"),
+ ("function view(): {className: string} { return {className: selected}; }", "ts"),
+ ("const compared = (left < {className: selected()}) > right;", "ts"),
+ ("const compared = (left < ((value = selected()) => ({className: value}))) > right;", "ts"),
+ ("const text = `${use({className: selected})}`;", "ts"),
+ ("const text = `${`${use({className: selected})}`}`;", "ts"),
+ ("import type styles from './Card.module.css'; const attrs = {className: styles.live};", "ts"),
+ ("// import styles from './Card.module.css';\nconst attrs = {className: styles.live};", "ts"),
+]
+
+
+CONTEXTUAL_RUNTIME_CASES = [
+ ('function render() { return as({className: "live"}); }', "ts"),
+ ('function render() { return satisfies({className: "live"}); }', "ts"),
+ ('function* render() { yield as({className: "live"}); }', "ts"),
+ ('function* render() { yield satisfies({className: "live"}); }', "ts"),
+ ('async function render() { await as({className: "live"}); }', "ts"),
+ ('async function render() { await satisfies({className: "live"}); }', "ts"),
+ ('function render() { throw as({className: "live"}); }', "ts"),
+ ('const view = new as({className: "live"});', "ts"),
+ ('const view = typeof as({className: "live"});', "ts"),
+ ('const view = void satisfies({className: "live"});', "ts"),
+ ('for (const value of as({className: "live"})) {}', "ts"),
+ ('switch (value) {case as({className: "live"}): break;}', "ts"),
+ ('class View extends as({className: "live"}) {}', "ts"),
+ ('export default satisfies({className: "live"});', "ts"),
+ ('const previous = 0; previous\nas({className: "live"});', "ts"),
+ ('const previous = 0; previous/*\n*/satisfies({className: "live"});', "ts"),
+]
+
+LINE_TERMINATORS = ["\n", "\r\n", "\u2028", "\u2029", "/*\n*/"]
+DECLARATION_RUNTIME_CASES = [
+ (f'{keyword}{gap}Props = {{className: "live"}};', "ts")
+ for keyword in ("type", "interface")
+ for gap in LINE_TERMINATORS
+] + [(f'declare{gap}class Props {{className = "live";}}', "ts") for gap in LINE_TERMINATORS]
+REGEX_RUNTIME_CASES = [
+ (f'const text = `${{flag {operator} /}}/.test(value) ? use({{className: "live"}}) : ""}}`;', extension)
+ for operator in ("&&", "||", "??")
+ for extension in ("ts", "js")
+]
+REGEX_UNKNOWN_CASES = [
+ (f'const text = `${{flag {operator} /}}/.test(value) ? use({{className: selected}}) : ""}}`;', extension)
+ for operator in ("&&", "||", "??")
+ for extension in ("ts", "js")
+]
+MODULE_RUNTIME_CASES = [
+ (f"{statement}\nconst attrs: {{className: string}} = {{className: type.live}};", "ts")
+ for statement in [
+ "import type from './Card.module.css';",
+ "import type, {value} from './Card.module.css';",
+ "import type, {type Value} from './Card.module.css';",
+ "import * as type from './Card.module.css';",
+ "import {default as type} from './Card.module.css';",
+ "import type\nfrom './Card.module.css';",
+ ]
+]
+
+
+def _write(project, content, extension, global_css, module_css):
+ (project / "global.css").write_text(global_css)
+ (project / "Card.module.css").write_text(module_css)
+ (project / "Other.module.css").write_text(".local {}\n")
+ (project / f"consumer.{extension}").write_text(content + "\n")
+
+
+def _remove(project):
+ result = CliRunner().invoke(cli, ["-p", str(project), "remove", "-c", "orphaned_css"])
+ assert result.exit_code == 0, result.output
+
+
+@pytest.mark.parametrize(("content", "extension"), ERASED_CASES)
+def test_erased_types_leave_unused_global_and_local_rules_removable(tmp_path, content, extension):
+ _write(tmp_path, content, extension, ".legacy {}\n.unusedGlobal {}\n", ":global(.legacy) {}\n.local {}\n")
+
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+
+ assert len(findings) == 5
+ assert all(finding.removable for finding in findings)
+ assert {finding.name for finding in findings} == {"legacy", "unusedGlobal", "local"}
+ _remove(tmp_path)
+ assert all((tmp_path / name).read_text() == "" for name in ("global.css", "Card.module.css", "Other.module.css"))
+
+
+@pytest.mark.parametrize(("content", "extension"), RUNTIME_CASES)
+def test_runtime_literals_survive_type_erasure_and_actual_remove(tmp_path, content, extension):
+ _write(tmp_path, content, extension, ".legacy {}\n.live {}\n.unusedGlobal {}\n", ":global(.live) {}\n.local {}\n")
+
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+
+ assert {finding.name for finding in findings} == {"legacy", "unusedGlobal", "local"}
+ assert all(finding.removable for finding in findings)
+ _remove(tmp_path)
+ assert (tmp_path / "global.css").read_text() == ".live {}\n"
+ assert (tmp_path / "Card.module.css").read_text() == ":global(.live) {}\n"
+ assert (tmp_path / "Other.module.css").read_text() == ""
+
+
+@pytest.mark.parametrize(("content", "extension"), CONTEXTUAL_RUNTIME_CASES)
+def test_contextual_assertion_identifiers_keep_live_runtime_calls(tmp_path, content, extension):
+ test_runtime_literals_survive_type_erasure_and_actual_remove(tmp_path, content, extension)
+
+
+@pytest.mark.parametrize(("content", "extension"), DECLARATION_RUNTIME_CASES + REGEX_RUNTIME_CASES)
+def test_lexical_boundaries_keep_explicit_live_runtime_classes(tmp_path, content, extension):
+ test_runtime_literals_survive_type_erasure_and_actual_remove(tmp_path, content, extension)
+
+
+@pytest.mark.parametrize(("content", "extension"), UNKNOWN_CASES)
+def test_unknown_runtime_values_keep_global_css_conservative(tmp_path, content, extension):
+ global_css = ".live {}\n.unusedGlobal {}\n"
+ _write(tmp_path, content, extension, global_css, ":global(.live) {}\n.local {}\n")
+
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+
+ assert all(not finding.removable for finding in findings if finding.file == "global.css")
+ assert all(
+ not finding.removable for finding in findings if finding.file == "Card.module.css" and finding.name == "live"
+ )
+ assert all(finding.removable for finding in findings if finding.name == "local")
+ _remove(tmp_path)
+ assert (tmp_path / "global.css").read_text() == global_css
+ assert (tmp_path / "Card.module.css").read_text() == ":global(.live) {}\n"
+ assert (tmp_path / "Other.module.css").read_text() == ""
+
+
+@pytest.mark.parametrize(("content", "extension"), REGEX_UNKNOWN_CASES)
+def test_template_regex_boundaries_keep_unknown_runtime_classes_conservative(tmp_path, content, extension):
+ test_unknown_runtime_values_keep_global_css_conservative(tmp_path, content, extension)
+
+
+@pytest.mark.parametrize(("content", "extension"), MODULE_RUNTIME_CASES)
+def test_value_import_binding_named_type_preserves_css_module_scope(tmp_path, content, extension):
+ for name in ("Card.module.css", "Other.module.css"):
+ (tmp_path / name).write_text(".live {}\n.unusedLocal {}\n")
+ (tmp_path / "global.css").write_text(".unusedGlobal {}\n")
+ (tmp_path / ("consumer." + extension)).write_text(content)
+
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+
+ assert all(finding.removable for finding in findings)
+ assert [(finding.name, finding.removable) for finding in findings if finding.file == "Card.module.css"] == [
+ ("unusedLocal", True)
+ ]
+ _remove(tmp_path)
+ assert (tmp_path / "Card.module.css").read_text() == ".live {}\n"
+ assert (tmp_path / "Other.module.css").read_text() == ""
+ assert (tmp_path / "global.css").read_text() == ""
+
+
+@pytest.mark.parametrize("accessor", ["styles.live", "styles[variant]"])
+def test_type_annotations_preserve_value_import_module_scope(tmp_path, accessor):
+ for name in ("Card.module.css", "Other.module.css"):
+ (tmp_path / name).write_text(".live {}\n.unusedLocal {}\n")
+ (tmp_path / "global.css").write_text(".unusedGlobal {}\n")
+ (tmp_path / "consumer.ts").write_text(
+ f"import styles from './Card.module.css';\nconst attrs: {{className: string}} = {{className: {accessor}}};\n"
+ )
+
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+
+ assert all(finding.removable for finding in findings if finding.file != "Card.module.css")
+ own = [finding for finding in findings if finding.file == "Card.module.css"]
+ assert [(finding.name, finding.removable) for finding in own] == (
+ [("unusedLocal", True)] if accessor == "styles.live" else [("live", False), ("unusedLocal", False)]
+ )
+ _remove(tmp_path)
+ assert (tmp_path / "Card.module.css").read_text() == (
+ ".live {}\n" if accessor == "styles.live" else ".live {}\n.unusedLocal {}\n"
+ )
+ assert (tmp_path / "Other.module.css").read_text() == ""
+ assert (tmp_path / "global.css").read_text() == ""
+
+
+@pytest.mark.parametrize(
+ "source",
+ [
+ 'interface Props {className: string;\nconst attrs = {className: "live"};',
+ 'declare const props: {className: string;\nconst attrs = {className: "live"};',
+ 'type Props = Array<{className: string};\nconst attrs = {className: "live"};',
+ ],
+)
+def test_unproved_type_boundaries_do_not_erase_runtime_uses(tmp_path, source):
+ global_css = ".live {}\n.unusedGlobal {}\n"
+ _write(tmp_path, source, "ts", global_css, ":global(.live) {}\n.local {}\n")
+
+ findings = DeadCodeScanner(tmp_path).scan().orphaned_css
+
+ assert all(not finding.removable for finding in findings if finding.file == "global.css")
+ _remove(tmp_path)
+ assert (tmp_path / "global.css").read_text() == global_css
+ assert (tmp_path / "Other.module.css").read_text() == ""
+
+
+def test_css_runtime_view_preserves_type_export_and_import_analysis(tmp_path):
+ (tmp_path / "types.ts").write_text("export interface Props {className: string}\nexport type Unused = string;\n")
+ (tmp_path / "consumer.ts").write_text('import type {Props} from "./types";\nconst next = 1;\n')
+ (tmp_path / "global.css").write_text(".unusedGlobal {}\n")
+
+ result = DeadCodeScanner(tmp_path).scan()
+
+ assert [(finding.name, finding.removable) for finding in result.orphaned_css] == [("unusedGlobal", True)]
+ assert [(finding.name, finding.removable) for finding in result.unused_exports] == [("Unused", True)]
diff --git a/uv.lock b/uv.lock
index aceafc8..d8f6b67 100755
--- a/uv.lock
+++ b/uv.lock
@@ -142,6 +142,7 @@ dev = [
{ name = "pytest" },
{ name = "pytest-cov" },
{ name = "ruff" },
+ { name = "tomli", marker = "python_full_version < '3.11'" },
]
[package.metadata]
@@ -153,6 +154,7 @@ requires-dist = [
{ name = "pyyaml", specifier = ">=6.0.3" },
{ name = "rich", specifier = ">=15.0.0" },
{ name = "ruff", marker = "extra == 'dev'", specifier = ">=0.4.0" },
+ { name = "tomli", marker = "python_full_version < '3.11' and extra == 'dev'", specifier = ">=1.1.0" },
]
provides-extras = ["dev"]