type-lib 1.0.0

Validation and type constraint library. Declare domain types with invariants enforced at construction. Parse-dont-validate pattern as a first-class citizen. Zero-overhead wrappers with derive macros.
Documentation
# type-lib v0.1.0 - Scaffold

**The first publishable checkpoint.** `v0.1.0` is intentionally small: it establishes the crate identity, packaging, lint policy, CI workflow, and documentation structure without pretending that the validated-domain-type API already exists. The only public symbol in this release is `type_lib::VERSION`.

## What is type-lib?

`type-lib` is a forthcoming validation and type-constraint library for Rust. Its long-term direction is parse-dont-validate domain modeling with invariant-enforcing wrapper types and low-overhead ergonomics. This initial release exists to lock down the project scaffold before the real API is introduced in later milestones.

## What shipped in 0.1.0

### Repository and package scaffold

The crate now has the expected publishable structure: package metadata, dual licensing, changelog, formatting and lint configuration, CI, smoke tests, and the foundational crate attributes for a disciplined Rust library. The toolchain contract is internally consistent — edition 2021 against an MSRV of Rust 1.75 — and `REPS.md` carries the full Rust Efficiency & Performance Standards that govern the crate.

### Cross-platform workflow baseline

The CI workflow runs formatting, Clippy, tests, and rustdoc generation on Linux, macOS, and Windows for both stable Rust and the MSRV (`1.75`). This gives later milestones a clean baseline instead of trying to introduce quality gates after the API surface grows.

### Honest public documentation

The README, crate-level docs, and API reference were tightened so they describe the code that actually ships in `v0.1.0`. Earlier wording implied future capabilities such as derive macros and validated wrapper types; the published documentation now makes it explicit that those features are roadmap items, not current API.

## Public API in this release

```rust
pub const VERSION: &str
```

`VERSION` exposes the package version embedded by Cargo. It is useful for diagnostics, startup banners, and smoke tests.

```rust
assert_eq!(type_lib::VERSION, env!("CARGO_PKG_VERSION"));
```

## Breaking changes

None. This is the initial release.

## Verification

Validated against the repository CI contract:

```bash
cargo fmt --all -- --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test --all-features
RUSTDOCFLAGS="-D warnings" cargo doc --no-deps --all-features
```

## What's next

- `v0.2.0` defines the first real public surface: types, traits, error model, and module structure.
- The scaffold is now ready for that work without carrying inaccurate public claims.

## Installation

```toml
[dependencies]
type-lib = "0.1.0"
```

MSRV: Rust 1.75.

## Documentation

- [README]https://github.com/jamesgober/type-lib/blob/main/README.md
- [API Reference]https://github.com/jamesgober/type-lib/blob/main/docs/API.md
- [CHANGELOG]https://github.com/jamesgober/type-lib/blob/main/CHANGELOG.md

---

**Full diff:** `initial release`.
**Changelog:** `CHANGELOG.md` entry for `0.1.0` dated 2026-05-27.