From 9711aff913d135267c9dbf833890eb95e71ef6a1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Danijel=20Gali=C4=87?= Date: Wed, 29 Jul 2026 09:58:23 +0200 Subject: [PATCH 1/3] Refine `Iterator::toArray` PHPDoc and suppress static analysis error **Details:** - Updated `@template TKey` to remove unnecessary restriction (`of array-key`) for better flexibility. - Enhanced `@return` annotation to use stricter type unions: `(int & TKey) | (string & TKey)`, improving type safety in IDEs. - Added `@phpstan-ignore return.type` comment to suppress false positive warnings from PHPStan on return type. - No functional changes to the implementation; focuses on improving documentation and static analysis support. --- src/Iterator.php | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/Iterator.php b/src/Iterator.php index 9cdedb5..7be1990 100644 --- a/src/Iterator.php +++ b/src/Iterator.php @@ -38,7 +38,7 @@ final class Iterator extends NativeRuntime { * Copy the elements of an iterator into an array. * @since 1.0.0 * - * @template TKey of array-key + * @template TKey * @template TValue * * @param iterable $iterator

@@ -54,7 +54,8 @@ final class Iterator extends NativeRuntime { * to integers. *

* - * @return ($preserve_keys is true ? array : list) An array containing items of the iterator. + * @return ($preserve_keys is true ? array<(int&TKey)|(string&TKey), TValue> : list) An array containing + * items of the iterator. * * @note If this parameter $preserve_keys is not set or set to true, duplicate keys will be overwritten. * The last value with a given key will be in the returned array. @@ -62,7 +63,7 @@ final class Iterator extends NativeRuntime { */ public static function toArray (iterable $iterator, bool $preserve_keys = true):array { - return iterator_to_array($iterator, $preserve_keys); + return iterator_to_array($iterator, $preserve_keys); // @phpstan-ignore return.type } From 9bf8399feb01d887aa9712bff92d8accf8dcda9c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Danijel=20Gali=C4=87?= Date: Wed, 29 Jul 2026 10:11:04 +0200 Subject: [PATCH 2/3] Add changelog entry for `v0.1.1` **Details:** - Documented the addition of refined PHPDoc for `Iterator::toArray` in `CHANGELOG.md`. - Linked the change to version `v0.1.1`, released on 2026-07-29. - Maintains consistency in version tracking and changelog structure for the project. --- CHANGELOG.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index f318342..b48bae1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +## [v0.1.1] – 2026-07-29 + +### Added +* Refine `Iterator::toArray` PHPDoc by @dieselxxx + ## [v0.1.0] – 2026-07-28 ### Added From 08ca87cb16b03851d39f4b6d3f07f7147317f2be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Danijel=20Gali=C4=87?= <56673130+dieselxxx@users.noreply.github.com> Date: Wed, 29 Jul 2026 10:12:23 +0200 Subject: [PATCH 3/3] Revise README with updated badges and repository info Updated README.md to reflect changes in versioning, repository purpose, and community guidelines. Added new badges and links for better visibility and support. --- README.md | 115 ++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 72 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index 2f30db8..ccc2058 100644 --- a/README.md +++ b/README.md @@ -7,12 +7,12 @@ PHP Runtime Foundation
release version @@ -22,25 +22,46 @@ /> -[![PHPStan](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPStan.yml/badge.svg?branch=develop)](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPStan.yml) -[![PHPUnit](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPUnit.yml/badge.svg?branch=develop)](https://github.com/The-FireHub-Project/Runtime/actions/workflows/PHPUnit.yml) -[![Codecov](https://codecov.io/gh/The-FireHub-Project/Runtime/branch/develop/graph/badge.svg?token=XW2YEONF51)](https://app.codecov.io/gh/The-FireHub-Project/Runtime/tree/develop) -

- + + GitHub created at + GitHub last commit (branch) - + GitHub activity (branch) - + + GitHub contributors + GitHub commit difference between two branches + + GitHub top language + + GitHub repo size + + GitHub code size

@@ -52,47 +73,55 @@ It contains no domain logic, no business rules, and no framework coupling. Its r --- -## FireHub Icon Development Branch +## FireHub Icon Repository Purpose -⚠️ **This is the `develop` branch** +This repository provides a lightweight PHP runtime abstraction layer that wraps native PHP functionality into clean, consistent, and deterministic APIs. -- Unstable -- APIs may change without notice -- Not intended for production use +Its purpose is to reduce boilerplate and standardize common execution patterns across the FireHub ecosystem by offering ergonomic helper classes for arrays, strings, files, environment access, and other low-level runtime operations. -## FireHub Icon Branch Purpose +It is strictly focused on execution-level concerns and does not contain domain logic, business rules, or framework-level orchestration. It exists to improve developer productivity while preserving native PHP behavior and ensuring zero framework coupling. -The `develop` branch is the **primary integration branch** for all ongoing development. +## FireHub Icon Security -It serves as the staging area where: -- Feature branches are merged -- Bug fixes are integrated -- Experimental work is stabilized -- Code is prepared for upcoming releases +For security reporting and guidelines, please refer to our [SECURITY.md](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file. -All **release branches** are created **from `develop`**. +## FireHub Icon Community -## Stability Guarantee +![GitHub watchers](https://img.shields.io/github/watchers/The-FireHub-Project/Runtime?style=social) +![GitHub Repo stars](https://img.shields.io/github/stars/The-FireHub-Project/Runtime?style=social) +![GitHub forks](https://img.shields.io/github/forks/The-FireHub-Project/Runtime?style=social) -❌ No backward compatibility guarantee -❌ APIs may change without notice -❌ Behavior may be incomplete or inconsistent -❌ Breaking changes are expected +- Be sure to review the [Code of Conduct](https://github.com/The-FireHub-Project/.github/blob/master/.github/CODE_OF_CONDUCT.md). +- Read a [Contributing](https://github.com/The-FireHub-Project/.github/blob/master/.github/CONTRIBUTING.md) file to see how you can contribute to this project. +- Read our [Security policy](https://github.com/The-FireHub-Project/.github/blob/master/.github/SECURITY.md) file to see how you can report a vulnerability. +- Review the project [Governance model](https://github.com/The-FireHub-Project/.github/blob/master/.github/GOVERNANCE.md), including roles, decision-making, RFC process, and releases. -This branch is intended **only for contributors and advanced testers**. +## FireHub Icon Support -## FireHub Icon Composer Usage (Not Recommended) +

+ + GitHub in-progress issues + + GitHub total issues + + GitHub opened pull requests +

-For internal testing only: +For help with FireHub products, please refer to the following resources: -```json -{ - "require": { - "the-firehub-project/runtime": "dev-develop" - } -} -``` -⚠️ Never use dev-develop in production. +- **General questions & discussions**: [GitHub Discussions](https://github.com/orgs/The-FireHub-Project/discussions) +- **Bug reports & issues**: [Support](https://github.com/The-FireHub-Project/Runtime/issues) +- **Documentation & guides**: [FireHub Docs](https://the-firehub-project.github.io) +- **Commercial support** (Pro/Enterprise): contact your account manager ## FireHub Icon Authors and Contributors @@ -109,4 +138,4 @@ Architecture guidelines, design principles, and ecosystem documentation are avai This software is licensed under the Apache-2.0 License. -For more details, read the full license [here](./LICENSE). \ No newline at end of file +For more details, read the full license [here](./LICENSE).