Expand description
Portable Capability Descriptor validation and binding generation.
A locked Descriptor and its package-local JSON Schemas are the portable cross-language authority. They may be derived from compiled source types, but every backend consumes the same checked snapshot. This crate deliberately lives above the Kernel: it checks evolution rules and emits deterministic Rust and TypeScript artifacts before an App is booted.
Structs§
- Descriptor
- A validated, self-contained portable Capability Descriptor.
- Generated
Artifacts - Compatibility aggregate for callers that intentionally generate both projections.
- Generated
Metadata - Metadata embedded in every generated language artifact.
- Generated
Projection - One independently generated language projection.
Enums§
- Codegen
Error - Errors produced while parsing, validating, or generating a contract.
- Compatibility
Error - Reasons why a Descriptor evolution is not safe for an existing Capability series.
- Projection
Language - One language projection emitted from a portable Capability contract.
Functions§
- check_
generated - Fails when either checked-in artifact is not exactly reproducible.
- check_
projection - Fails when one selected language projection is not exactly reproducible.
- check_
source_ snapshot - Fails unless every committed Descriptor and Schema byte matches compiled source.
- generate
- Generates both language artifacts from one Descriptor source.
- generate_
browser_ request_ client - Generates an executable browser request client from the same validated Descriptor IR used by the checked-in Rust and TypeScript bindings.
- generate_
projection - Generates one selected language projection from a Descriptor source.
- lint_
compatibility - Checks whether
new_pathis an additive, compatible evolution ofold_path.truemeans the same Capability series remains compatible. - load_
descriptor - Reads and validates one Descriptor, resolving package-local
$reffiles. - round_
trip_ portable_ json - Round-trips one JSON value through the portable wire representation.
- validate_
wire_ value - Validates a wire value against a package-local JSON Schema.
- write_
generated - Writes generated artifacts to checked-in paths.
- write_
projection - Writes one selected language projection to a checked-in path.
- write_
source_ snapshot - Writes one Descriptor and its package-local Schemas from compiled source types.