<commit_before>## Macros

All macros are located in `src/macros` directory. They're segregated by a namespace - a general "field" of their responsibility.

Each macro should be defined in a separated file. It's allowed to define macros _aliases_.
Macros are not namespaced so it's required that they don't leave any global variables declarations.

This shouldn't happen:

```php
use Baethon\Phln\Phln as P;

$fn = function () {};

P::macro('foo', function () use ($fn) {
    return $fn;
});
```

yet it's allowed to "scope" macro's definition by using self-calling closures:

```php
use Baethon\Phln\Phln as P;

call_user_func(function () {
    $fn = function () {};

    P::macro('foo', function () use ($fn) {
        return $fn;
    });
});
```

Every new macro should be added to `bundle.php` file which is responsible for loading them.

## CLI generator

It's possible to scaffold new macro by using `create:macro` command.

```bash
./bin/console.php create:macro math power
```

## Docs

Every new macro should be documented in Markdown docs located in `docs/` directory.<commit_msg>Docs: update internals section<commit_after>## Macros

All macros are located in `src/macros` directory. They're segregated by a namespace - a general "field" of their responsibility.

Each macro should be defined in a separated file. It's allowed to define macros _aliases_.

```php
use Baethon\Phln\Phln as P;

P::macro('foo', function () {
    return 'foo';
});

P::alias('bar', 'foo');
```

Every new macro should be added to `bundle.php` file which is responsible for loading them.

## CLI generator

It's possible to scaffold new macro by using `create:macro` command.

```bash
./bin/console.php create:macro math power
```

## Docs

Every new macro should be documented in Markdown docs located in `docs/` directory.
{'fraction_non_alphanumeric': 0.1153421633554084, 'fraction_numerical': 0.0, 'mean_word_length': 4.135977337110481, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4579427', 'n_tokens_mistral': 576, 'n_tokens_neox': 524, 'n_words': 231}