Initial commit v0.2

Author: kansatech

.gitignore

@@ -0,0 +1,11 @@
+# Composer dependencies
+/vendor/
+
+# Composer lock file (optional—commit if you want reproducible builds)
+/composer.lock
+
+# PHPStorm settings
+.idea/
+
+# Log files
+*.log

changelog.md

@@ -0,0 +1,13 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [0.2.0] - 2025-03-15
+
+### Added
+- Refactored `EventDispatcher` to improve efficiency and align with PSR-14.
+- Introduced `ListenerInterface` for structured event handling.
+- Added support for prioritized listeners using `SplPriorityQueue`.
+- Implemented `StoppableEventInterface` for event propagation control.
+- Improved exception handling with `InvalidEventException` and `InvalidListenerException`.
+

code_of_conduct.md

@@ -0,0 +1,27 @@
+# Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment include:
+- Using welcoming and inclusive language.
+- Being respectful of differing viewpoints and experiences.
+- Gracefully accepting constructive criticism.
+- Focusing on what is best for the community.
+
+Examples of unacceptable behavior by participants include:
+- Harassment, intimidation, or discriminatory comments.
+- Trolling, insulting, or derogatory comments.
+- Unwelcome sexual attention or advances.
+- Deliberate intimidation or stalking.
+
+## Reporting and Enforcement
+
+If you experience or witness any behavior that violates this Code of Conduct, please report it by emailing [conduct@commonphp.org](mailto:conduct@commonphp.org). All complaints will be reviewed promptly and confidentially by the project maintainers.
+
+Project maintainers are responsible for enforcing this code throughout the project and community. They have the right to remove, edit, or reject any contributions or comments that do not align with this Code of Conduct.
+
+By participating in this project, you agree to abide by these guidelines and help create a positive environment for everyone.

composer.json

@@ -0,0 +1,22 @@
+{
+  "name": "comphp/events",
+  "description": "A lightweight, modular event dispatcher with PSR-14 compatibility and an object-oriented approach for registering and triggering events.",
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "Neuron\\Events\\": "src/"
+    }
+  },
+  "autoload-dev": {
+    "psr-4": {
+      "NeuronTests\\Events\\": "test/"
+    }
+  },
+  "require": {
+    "php": "^8.4",
+    "psr/event-dispatcher": "^1.0"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^12.0"
+  }
+}

contributing.md

@@ -0,0 +1,25 @@
+# Contributing
+
+Thank you for considering contributing to this project! Your help is essential in making this library better for everyone.
+
+## How to Report Bugs
+- Before opening a new issue, please search the issue tracker for similar reports.
+- When reporting a bug, include a clear and descriptive title, a detailed explanation, and steps to reproduce the issue.
+
+## How to Request Features
+- Check the existing issues to ensure your feature hasn’t already been requested.
+- Provide a clear description of the feature, its benefits, and any potential implementation ideas.
+
+## Pull Request Guidelines
+- Fork the repository and create your branch from `master`.
+- Follow the coding style guidelines (PSR standards).
+- Write clear commit messages that explain the rationale behind your changes.
+- Ensure all tests pass before submitting your pull request.
+- Include relevant documentation updates if necessary.
+
+## Additional Guidelines
+- Respect the existing code style and architecture.
+- Be open to feedback and constructive criticism.
+- Engage in discussions on issues and pull requests respectfully.
+
+Thank you for your contributions!

examples/basic-dispatching.php

@@ -0,0 +1,12 @@
+<?php
+
+use Neuron\Events\EventDispatcher;
+
+require '../vendor/autoload.php';
+require 'include/user-registered-event.php';
+
+$dispatcher = new EventDispatcher();
+$dispatcher->listen(UserRegisteredEvent::class, function (UserRegisteredEvent $event) {
+    echo "User registered: " . $event->getPayload()['username'] . "\n";
+});
+$dispatcher->dispatch(new UserRegisteredEvent('Tim')); // Expected output: User registered: Tim

examples/include/order-placed-event.php

@@ -0,0 +1,11 @@
+<?php
+
+use Neuron\Events\AbstractEvent;
+use Psr\EventDispatcher\StoppableEventInterface;
+
+class OrderPlacedEvent extends AbstractEvent implements StoppableEventInterface
+{
+    private bool $stopped = false;
+    public function isPropagationStopped(): bool { return $this->stopped; }
+    public function stopPropagation(): void { $this->stopped = true; }
+}

examples/include/user-registered-event.php

@@ -0,0 +1,12 @@
+<?php
+
+use Neuron\Events\AbstractEvent;
+
+class UserRegisteredEvent extends AbstractEvent
+{
+    public function __construct(string $username)
+    {
+        parent::__construct(['username' => $username]);
+    }
+}
+

examples/include/welcome-email-listener.php

@@ -0,0 +1,13 @@
+<?php
+
+use Neuron\Events\EventInterface;
+use Neuron\Events\ListenerInterface;
+
+class WelcomeEmailListener implements ListenerInterface
+{
+    public function handle(EventInterface $event): void
+    {
+        echo "Sending welcome email to: " . $event->getPayload()['username'] . "\n";
+    }
+}
+

examples/listener-objects.php

@@ -0,0 +1,11 @@
+<?php
+
+use Neuron\Events\EventDispatcher;
+
+require '../vendor/autoload.php';
+require 'include/user-registered-event.php';
+require 'include/welcome-email-listener.php';
+
+$dispatcher = new EventDispatcher();
+$dispatcher->listen(UserRegisteredEvent::class, [new WelcomeEmailListener(), 'handle']);
+$dispatcher->dispatch(new UserRegisteredEvent('Alice')); // Expected output: Sending welcome email to: Alice