kumwe / navigation

v0.1.2 2026-09-08 16:08 UTC

Requires

• php: ^8.5
• ext-mbstring: *

Requires (Dev)

• ext-zip: *
• phpstan/phpstan: ^2.1
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^12.0
• squizlabs/php_codesniffer: ^4.0

Apache-2.0

Published on Packagist.org on 2026-09-08 16:09 UTC

README

Bounded deterministic navigation trees, records and persistence contracts under Kumwe\Navigation\. The package owns immutable tree operations, stable paths, scoped repository contracts and explicit version conflicts. Core supplies persistence, authorization, transactions and rendering.

Installation and usage

composer require kumwe/navigation:0.1.2

Requires PHP 8.5 and mbstring. Navigation has no other Kumwe runtime dependency. Construct values directly and supply host repository ports; no ConfigProvider, global locator or captured request context is registered.

See the standalone example, public API, Core contract and integration.

Compatibility

Trees admit at most 1,024 items and paths at most 64 items. Oversized input fails before unbounded traversal. Parent UUID normalization, UTF-8 titles, bounded derived paths, stable ordering and immutable moves remain part of the public contract. Repository adapters preserve scope, optimistic versioning and exact cascade ownership. See compatibility and repository guarantees.

Pre-1.0 consumers pin exact verified versions. Publication and source CI are separate from independent consumer verification and Core deployment acceptance. Dependency status records the minimal runtime closure; the live badges above report published versions and default-branch CI.

Development

composer install
composer check
composer examples

The package gate checks syntax, generated API/manifests, architecture, static analysis, coding standards, dependency readiness, behavior/conformance ownership, examples, security and a fresh no-dev archive consumer. See test ownership, release process, release record and security.