README

PHP implementation of the WAFL (Wider Attribute Formatting Language) configuration pipeline. It loads .wafl files, resolves imports, evaluates expressions/tags, and validates the result against schemas declared in @schema blocks.

Package layout

File	Role
`src/ConfigLoader.php`	High-level orchestrator that chains all processing stages
`src/Loader.php`	Reads files, resolves `@import`, extracts `@schema` / `@eval` blocks
`src/Parser.php`	Indentation-aware parser that builds the intermediate AST
`src/Resolver.php`	Resolves `__expr` nodes, conditional lists, and registered tags
`src/DocumentEvaluator.php`	Runs the final evaluation pass (with `$` symbols support)
`src/SchemaValidator.php`	Validates the resolved config against schema definitions
`src/TagRegistry.php`	Built-in tag registry (`!rgb`, `!file`) with extension points
`src/TypeMetadataExtractor.php`	Captures `key<Type>` annotations before resolution
`src/Utils.php`	Shared helpers (`deepMerge`, associative detection, etc.)

Installation

composer require wafl/php-core

Usage

use Wafl\Core\ConfigLoader;

$loader = new ConfigLoader();
$result = $loader->load(__DIR__ . '/app.wafl', [
    'env' => $_ENV,
]);

$config = $result['config'];
$meta = $result['meta'];

WAFL file example

@schema:
  App:
    name: string
    version: string
    port: int
    debug?: bool
    theme:
      primary: string
      secondary: string
    features: list<string>

app<App>:
  name: "WAFL Demo"
  version: "1.0.0"

  port = $ENV.PORT || 3000
  debug = $ENV.NODE_ENV === "dev"

  theme:
    primary = !rgb(255, 200, 80)
    secondary = "#111"

  features:
    - login
    - analytics
    - if $ENV.NODE_ENV === "dev": monitoring

Loading this file with ConfigLoader resolves tags/expressions and validates against schema.wafl:

[
    'app' => [
        'name' => 'WAFL Demo',
        'version' => '1.0.0',
        'port' => 3000,
        'debug' => false,
        'theme' => [
            'primary' => '#ffc850',
            'secondary' => '#111',
        ],
        'features' => ['login', 'analytics'],
    ],
]

Setting NODE_ENV=dev PORT=8080 would flip debug to true, set port to 8080, and include the monitoring feature. TagRegistry includes built-ins like !rgb and can be extended; @schema is optional but enforced when present.

Running tests

composer install
composer test

wafl-lang / php-core

Maintainers

Details