fluent_typed_codegen 0.2.2

Automatic Fluent catalog discovery and typed code generation for Cargo
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
92
93
94
95
96
97
98
99
100
101
102

# Changelog

Notable changes are recorded here using
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html);
before 1.0, a minor release can introduce incompatible API changes.

## [0.2.2] - 2026-10-05

See the [migration from 0.2.1](docs/migration-0.2.2.md).

### Added

- Typed `ConfigError` and `BuildError` with recognized fields, path reasons,
  filesystem operations, module differences and original parser/I/O/upstream causes.

- Named `LocalizationManifest` constants through `embed_manifest! { ... }`,
  with relative schema selectors, visibility, attributes and multiple declarations.
- Package-relative `catalog` paths may use `..` for shared translation sources.

### Changed

- **Breaking:** configuration parsers and explicit generation entrypoints return
  typed errors instead of `String`; `ManifestError` has typed configuration and
  virtual-origin variants. `build() -> ExitCode` remains unchanged.

- **Breaking:** Cargo metadata contains only `catalog`, relative to Cargo.toml;
  direct `Settings` and generated metadata no longer expose an asset root.
- **Breaking:** `CATALOG_PATH` replaces `CATALOG_ASSET_PATH` and retains the build
  filesystem path without interpreting engine asset addresses.
- Embedded constants borrow static module entries and initialize shared metadata
  on first access, without constructing an additional lookup index.
- Unknown configuration fields are ignored; recognized fields remain validated.

### Removed

- **Breaking:** selective expression arguments to `embed_manifest!`, including
  `module = ...`; use constant declarations. The empty invocation is retained.
- **Breaking:** generated `ASSET_ROOT`, `Settings::asset_root` and the former
  leaf-name helper macros that confused catalog types with embedding operations.

## [0.2.1] - 2026-09-28

### Fixed

- Embedded module lookup builds a shared index on first use instead of scanning
  every embedded entry for each request. Large `read_modules` calls no longer
  spend quadratic time finding their source bytes; payloads remain borrowed.

## [0.2.0] - 2026-09-28

Follow the [migration from 0.1.4](docs/migration-0.2.md)
for dependency updates and before/after initialization examples.

### Added

- Checked leaf construction, optional unchecked construction, standalone
  validation and typed errors with module/locale context.
- Explicit file and embedded source contracts through `LocalizationManifest`;
  optional `manifest` support parses TOML without importing the generator.
- `load_all` and `load_all_unchecked` for complete sets of known languages.
- Typed `embed_manifest!` selection for a leaf, group or complete tree, including
  `use` aliases. Unselected FTL stays out of unoptimized binaries too.
- Metadata and integration hooks for assembling scopes from already parsed children.

### Changed

- **Breaking:** `Translations::from_modules` returns generated `LoadError`
  instead of `String`.
- **Breaking:** manual output includes require the `__fluent_codegen` support
  alias; extension `Scope` gains logical scope and leaf paths.
- Generation prepares a schema without mandatory FTL payloads. Applications
  explicitly choose storage, validation policy and module lifetimes.

### Removed

- **Breaking:** generated `Locale::load` and `Translations::embedded`;
  use explicit byte or manifest constructors.
- **Breaking:** embedded source text in `MODULES`; entries contain only locale
  and logical module path.

Typed message accessor signatures are unchanged. Upstream copies/reparsing remain;
this release does not introduce automatic fallback or caching.

## [0.1.4] - 2026-09-22

### Changed

- Clarify setup, explicit build-time generation and the relationship to fluent-typed.
- Demonstrate application-owned ICU formatting and plural-category selection.
- Document storage-independent `from_modules` loading, original FTL pack layout,
  generated metadata and input ownership, including generated Rustdoc.
- Add coverage for owned virtual sources and move example regression tests into
  `examples/minimal/tests/`, keeping the runnable example focused on API usage.

This documentation release changes no public API or parsing behavior.
Earlier releases predate this changelog; their source is retained in Git tags.

[0.2.2]: https://github.com/SDA-31/fluent_typed_codegen/compare/v0.2.1...v0.2.2
[0.2.1]: https://github.com/SDA-31/fluent_typed_codegen/compare/v0.2.0...v0.2.1
[0.2.0]: https://github.com/SDA-31/fluent_typed_codegen/compare/v0.1.4...v0.2.0
[0.1.4]: https://github.com/SDA-31/fluent_typed_codegen/compare/v0.1.3...v0.1.4