aam-rs 2.0.2

A Rust implementation of the Abstract Alias Mapping (AAM) framework for aliasing and maping aam files.
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

# Public API (PHP)

Source of truth: `php/src/AamPhp.php`.

## Main Classes

- `AamDocument`
- `AamBuilder`
- `SchemaField`

## AamDocument Construction

- `new AamDocument(string $content, ?string $libPath = null)`

## AamDocument Methods

- `reload(string $content): void`
- `format(string $content): string`
- `get(string $key): ?string`
- `find(string $query): array`
- `deepSearch(string $pattern): array`
- `reverseSearch(string $value): array`
- `schemaNames(): array`
- `typeNames(): array`

## Builder API

- `SchemaField::required(string $name, string $typeName): SchemaField`
- `SchemaField::optional(string $name, string $typeName): SchemaField`
- `SchemaField::toAam(): string`
- `AamBuilder::addLine(string $key, string $value): AamBuilder`
- `AamBuilder::comment(string $text): AamBuilder`
- `AamBuilder::schema(string $name, array $fields): AamBuilder`
- `AamBuilder::derive(string $path, array $schemas = []): AamBuilder`
- `AamBuilder::import(string $path): AamBuilder`
- `AamBuilder::typeAlias(string $alias, string $typeName): AamBuilder`
- `AamBuilder::build(): string`
- `AamBuilder::toFile(string $path): void`

## Runtime Notes

- Uses PHP FFI and requires native `aam_rs` shared library.
- Library path can be passed explicitly or resolved from env/default path.