PHPackages                             super-kernel/contract - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. super-kernel/contract

ActiveLibrary[Framework](/categories/framework)

super-kernel/contract
=====================

Core interface definitions for the super-kernel framework. This package provides the abstract contracts to guide dependency injection and ensures architectural integrity by preventing direct implementation coupling.

v1.0.0(3d ago)0220↓100%7MITPHPPHP ~8.4.0

Since Mar 16Pushed 3d agoCompare

[ Source](https://github.com/super-kernel/contract)[ Packagist](https://packagist.org/packages/super-kernel/contract)[ Docs](https://github.com/super-kernel/contract)[ RSS](/packages/super-kernel-contract/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (5)Versions (3)Used By (7)

Super Kernel Contracts
======================

[](#super-kernel-contracts)

[![Latest Stable Version](https://camo.githubusercontent.com/05a2d030194b115177c323a1bf5929cc6cda7f112ef5de8f28c9ab43e6e49d42/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73757065722d6b65726e656c2f636f6e74726163742e737667)](https://packagist.org/packages/super-kernel/contract)[![License](https://camo.githubusercontent.com/92977a4e7b70b6fbc3fc945c62d4d09878aad423da55006632500c17cbaedb83/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73757065722d6b65726e656c2f636f6e74726163742e737667)](https://packagist.org/packages/super-kernel/contract)

The **super-kernel/contract** package provides a set of core interface definitions and abstract standards for the Super Kernel framework. It serves as the single source of truth for all components within the ecosystem, ensuring decoupling and strict architectural integrity.

---

📌 Overview
----------

[](#-overview)

In a modular ecosystem, components should depend on **abstractions**, not **implementations**. This package defines the " rules of engagement" for Super Kernel. By requiring this package, your components stay lightweight and remain compatible with any compliant implementation of the kernel.

🚀 Key Features
--------------

[](#-key-features)

- **Standardization**: Uniform interfaces for Dependency Injection, Service Container, and Core Events.
- **Strict Decoupling**: Allows swapping underlying implementations without breaking dependent packages.
- **Architectural Guardrails**: Prevents implementation leakage and unauthorized scope elevation.

🛠 Installation
--------------

[](#-installation)

You can install the package via Composer:

```
composer require super-kernel/contract
```

📖 Usage &amp; Best Practices
----------------------------

[](#-usage--best-practices)

### 1. Dependency Injection (DI) Constraints

[](#1-dependency-injection-di-constraints)

**Scope Note:** The following constraints apply strictly to components managed and instantiated via the \*\*DI Container \*\*. Internal framework bootstrap components and third-party utility packages are excluded from these specific enforcement rules.

Always type-hint the interfaces provided by this package in your constructors. Do not reference concrete classes from implementation bundles.

**Correct Approach:**

```
use SuperKernel\Contract\ContainerInterface;

final class MyService {
    public function __construct(
        private ContainerInterface $container // Depend on Contract
    )
    {
    }
}
```

### 2. Forbidden Operations

[](#2-forbidden-operations)

To maintain the stability and security of the kernel, the following operations are strictly prohibited for DI-managed components:

- **Direct Instantiation**: Never use `new` on implementation classes. Always resolve via the Container.
- **Scope Elevation**: Do not attempt to bypass access modifiers or elevate the scope of internal kernel services.
- **Implementation Coupling**: Avoid checking for specific implementation types (e.g., `instanceof ConcreteService`).

---

🏗 Architecture Principles
-------------------------

[](#-architecture-principles)

This package follows the **Dependency Inversion Principle (DIP)**:

 High-level modules should not depend on low-level modules. Both should depend on abstractions.

LayerResponsibilityContracts"Defines ""What"" the system does (Interfaces)."ComponentsConsume Contracts to provide features.Core"Implements the ""How"" (Concrete Logic)."🤝 Contributing
--------------

[](#-contributing)

Since this package defines the fundamental contracts for the entire framework, changes are subject to strict review.

 1. Ensure all interface changes maintain backward compatibility (BC).

 2. Update the corresponding implementation guides when adding new contracts.

⚖️ License
----------

[](#️-license)

The Super Kernel Contracts is open-sourced software licensed under the [MIT license](https://www.google.com/search?q=LICENSE).

###  Health Score

47

—

FairBetter than 94% of packages

Maintenance99

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9a5bd52f6d618b240ca6bbeb2ffc620448c229e1c1595e41453b37b8e72c3473?d=identicon)[wheakerd](/maintainers/wheakerd)

---

Top Contributors

[![wheakerd](https://avatars.githubusercontent.com/u/78034820?v=4)](https://github.com/wheakerd "wheakerd (4 commits)")

---

Tags

phpframeworkinterfacescontractsuper-kernel

### Embed Badge

![Health badge](/badges/super-kernel-contract/health.svg)

```
[![Health](https://phpackages.com/badges/super-kernel-contract/health.svg)](https://phpackages.com/packages/super-kernel-contract)
```

###  Alternatives

[nimbly/syndicate

A powerful queue and pubsub message publisher and consumer framework.

304.2k](/packages/nimbly-syndicate)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
