README

Biblioteka kontraktowa dla wyszukiwania symboli w kodzie PHP.

Cel

Ta biblioteka definiuje stabilny, rozszerzalny kontrakt (interfejsy, DTO, VO, kolekcje, wyjątki) dla wyszukiwania symboli w kodzie PHP:

• typy (class / interface / trait / enum / anonymous),
• metody,
• relacje typów (implements / extends, w tym wyszukiwanie potomków).

Nie zawiera żadnej implementacji indeksowania ani wyszukiwania.

Instalacja

composer require adachsoft/code-search-contract

Główna fasada

use AdachSoft\CodeSearchContract\PublicApi\CodeSearchFacadeInterface;

Implementacja tej fasady powinna być dostarczona w osobnej bibliotece.

Quick start (dla deweloperów kontraktu)

composer install
composer test

Zakres API

• CodeSearchFacadeInterface główna fasada,
• DTO/VO w przestrzeni nazw AdachSoft\CodeSearchContract\PublicApi i podprzestrzeniach,
• kolekcje oparte o adachsoft/collection (brak publicznych array w API),
• wyjątki jako główny mechanizm sygnalizacji błędów.

Szczegóły struktury można znaleźć w kodzie źródłowym w katalogu src/PublicApi.