module-lang 1.0.0

Module and import resolution for multi-file languages.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

<h1 align="center">
    <img width="90px" height="auto" src="https://raw.githubusercontent.com/jamesgober/jamesgober/main/media/icons/hexagon-3.svg" alt="Triple Hexagon">
    <br><b>CHANGELOG</b>
</h1>
<p>
  All notable changes to <code>module-lang</code> will be documented in this file. The format is based on <a href="https://keepachangelog.com/en/1.1.0/">Keep a Changelog</a>,
  and this project adheres to <a href="https://semver.org/spec/v2.0.0.html/">Semantic Versioning</a>.
</p>

---

## [Unreleased]

### Added

### Changed

### Fixed

### Security

---

## [1.0.0] - 2026-06-29

API freeze. The resolution surface introduced in v0.2.0 is ratified as the `1.0`
contract: stable and frozen under Semantic Versioning, with no breaking changes
before `2.0`. A `0.2.0` program compiles and behaves identically against `1.0.0`.

### Changed

- `docs/API.md` is marked stable and records the SemVer promise.
- Hardened the crate-level lint profile to forbid panics, `unwrap`/`expect`, and
  debug macros in library code.

### Added

- A `serde` round-trip test for `ModuleId` and `Visibility`.
- A runnable `multi_file_project` example.

---

## [0.2.0] - 2026-06-29

The resolution core. Module and import resolution across multiple source files,
wiring `symbol-lang` for the interned name key and `source-lang` for the file each
module was read from. Every invariant is property-tested against a naive reference
resolver.

### Added

- `ModuleGraph<T>` — the owner of resolution state, generic over the payload a name
  resolves to. Build it with `new` / `with_capacity`, add modules with
  `add_module`, declare names with `define` and `import`, look them up with
  `resolve`, and inspect it with `len`, `is_empty`, `module_name`, and
  `module_source`.
- `ModuleId` — a stable, opaque, copyable handle to a module, with `to_u32`.
- `Visibility` — `Public` / `Private`, gating whether an import from another module
  can reach a name.
- `ResolveError` — `UnknownModule`, `DuplicateName`, `Unresolved`, `Private`, and
  `ImportCycle`, with `Display` and `std::error::Error`; `#[non_exhaustive]`.
- Re-exports of `Symbol` (from `symbol-lang`) and `SourceId` (from `source-lang`),
  the handle types the API speaks in.
- `serde` derives for `ModuleId` and `Visibility` behind the `serde` feature.
- Property tests cross-checking resolution against a naive reference resolver, and
  `criterion` benchmarks for the build and resolve paths.
- `docs/API.md` documenting every public item with examples.

### Changed

- The `std` feature now forwards to `source-lang/std` and `symbol-lang/std`.

---

## [0.1.0] - 2026-06-18

Initial scaffold and repository bootstrap. No domain logic yet &mdash; this release establishes the structure, tooling, and quality gates the implementation will be built on.

### Added

- `Cargo.toml` with crate metadata, Rust 2024 edition, MSRV 1.85.
- Dual `Apache-2.0 OR MIT` license files.
- `README.md`, `CHANGELOG.md`, and a documentation skeleton.
- `REPS.md` compliance baseline.
- `.github/workflows/ci.yml` CI matrix; `deny.toml`, `clippy.toml`, `rustfmt.toml`.
- `dev/DIRECTIVES.md` and `dev/ROADMAP.md` (committed engineering standards + plan).

[Unreleased]: https://github.com/jamesgober/module-lang/compare/v1.0.0...HEAD
[1.0.0]: https://github.com/jamesgober/module-lang/compare/v0.2.0...v1.0.0
[0.2.0]: https://github.com/jamesgober/module-lang/compare/v0.1.0...v0.2.0
[0.1.0]: https://github.com/jamesgober/module-lang/releases/tag/v0.1.0