hop-top/kit

This package is abandoned and no longer maintained. No replacement package was suggested.

Cross-language CLI UX parity toolkit

dev-main 2026-05-17 03:33 UTC

Requires

• php: ^8.3
• guzzlehttp/guzzle: ^7.9
• hop-top/uri: ^0.2.0@alpha

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11

MIT

README

experimental PHP client SDK.

URI facade

The experimental SDK exposes a thin facade over hop-top/uri so kit callers can use the shared URI contract without depending on kit-specific parsing code.

<?php

use Hop\Uri\ActionRoute;
use Hop\Uri\Policy;
use HopTop\Kit\Uri\UriFacade;

$uri = UriFacade::parse('task://hop-top/uri/T-0001');
echo $uri->namespace; // hop-top/uri
echo UriFacade::canonical($uri); // task://hop-top/uri/T-0001

$policy = new Policy(
    defaultNamespaceSegments: 1,
    schemeNamespaceSegments: ['tlc' => 2],
    actionRoutes: [
        'task.claim' => new ActionRoute(
            command: 'tlc',
            args: ['-C', '{namespace}', 'task', 'claim', '{id}'],
        ),
    ],
);

$actionUri = UriFacade::parse('tlc://org/repo/T-0001?action=task.claim', $policy);
$plan = UriFacade::resolveAction($actionUri, $policy);

This facade intentionally delegates to hop-top/uri; it does not reimplement URI parsing, vanity handling, action routing, or handler identity.