# Inspect File

Use file to map top-level declarations physically present in one file.
Exported declarations are marked in the output.
It shows what lives in the file before you decide whether to read code.

Good for:
- mapping an unfamiliar file
- listing top-level declarations
- checking whether a file contains real declarations or mostly re-exports

Do not add limit just in case.
file output is compact and most files have far fewer than 100 top-level declarations.
Use limit only after file output is actually too large.

Controls:
file, ranges, localOnly

Specific:
localOnly   show local declarations and reexports without resolving facade API; +localOnly

Defaults: +ranges
Use -ranges to show names without ranges.

Run:
aib inspect --stdin

Input:
file @svc/service.ts +localOnly
file src/index.ts

inspect file src/service.ts [--ranges] [--local-only]
