feat(support): add support for high level API

.gitignore

@@ -12,10 +12,10 @@ Thumbs.db
 # Composer dependencies resolver
 composer.lock
 
-# PHAR artifacts
-/phar/**
-!/phar/*.phar
-!/phar/*.phar.pubkey
+# Distribution artifacts
+/dist/**
+!/dist/*.phar
+!/dist/*.phar.pubkey
 
 # Storage folder for runtime-generated files
 /storage/

CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [v0.3.3](https://github.com/The-FireHub-Project/Core-Foundation/compare/v0.3.2...v0.3.3) – 2026-05-28
+
+### Added
+- Add `Map` and `Associative` data structures with advanced capabilities (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`15b5c3a`](https://github.com/The-FireHub-Project/Core-Foundation/commit/15b5c3a))
+- Add `crc32` checksum calculation to `StrSB` with unit test coverage (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`15b5c3a`](https://github.com/The-FireHub-Project/Core-Foundation/commit/15b5c3a))
+
+### Changed
+- Replace `ArrMapStorage` with new `HashStorage` abstraction; introduce pluggable `HashEngine` and remove outdated array-based initializers (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`b430fe0`](https://github.com/The-FireHub-Project/Core-Foundation/commit/b430fe0))
+
+### Fixed
+- Replace `addFirst` with `addLast` in `Vector` initialization logic (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`377be90`](https://github.com/The-FireHub-Project/Core-Foundation/commit/377be90))
+
+## [v0.3.2](https://github.com/The-FireHub-Project/Core-Foundation/compare/v0.3.1...v0.3.2) – 2026-05-27
+
+### Added
+- Introduce Data Transfer Object and Rehydratable capabilities for structured data management (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`1117c8b`](https://github.com/The-FireHub-Project/Core-Foundation/commit/1117c8b))
+- Add Rebuildable and Convertible capabilities to data structures (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`cc098de`](https://github.com/The-FireHub-Project/Core-Foundation/commit/cc098de))
+- Enhance `Vector` capabilities with advanced index-based operations and PHP 8.1 support (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`a8db5c5`](https://github.com/The-FireHub-Project/Core-Foundation/commit/a8db5c5))
+
+### Fixed
+- Correct documentation and improve mutation outcome handling in BackInsertion and ArrListStorage (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`16353ce`](https://github.com/The-FireHub-Project/Core-Foundation/commit/16353ce))
+
+## [v0.3.1](https://github.com/The-FireHub-Project/Core-Foundation/compare/v0.3.0...v0.3.1) – 2026-05-25
+
+### Added
+- Introduce an extensible data structure framework with granular capabilities and runtime state management (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`0400d2e`](https://github.com/The-FireHub-Project/Core-Foundation/commit/0400d2e))
+
+## [v0.3.0](https://github.com/The-FireHub-Project/Core-Foundation/compare/v0.2.0...v0.3.0) – 2026-05-19
+
+### Added
+- Redesign and expand data structure capabilities with flexible abstraction contracts (issue: [#11](https://github.com/The-FireHub-Project/Core-Foundation/issues/11), pr: [#13](https://github.com/The-FireHub-Project/Core-Foundation/pull/13), commit: [`ce61610`](https://github.com/The-FireHub-Project/Core-Foundation/commit/ce61610))
+
 ## [v0.2.0](https://github.com/The-FireHub-Project/Core-Foundation/compare/v0.1.1...v0.2.0) – 2026-03-23
 
 ### Added

CITATION.cff

@@ -4,8 +4,8 @@ title: The FireHub Project - Core Foundation
 abstract: The essential PHP core for clean, domain-driven architecture.
 type: software
 license: Apache-2.0
-version: v0.2.0
-date-released: 2026-03-23
+version: v0.3.1
+date-released: 2026-05-25
 
 url: "https://the-firehub-project.github.io/core-foundation"
 repository-code: "https://github.com/The-FireHub-Project/Core-Foundation"

composer.json

@@ -7,18 +7,15 @@
   "license": "Apache-2.0",
   "require": {
     "php": "^8.5",
+    "ext-openssl": "*",
     "ext-mbstring": "*"
   },
   "require-dev": {
     "phpstan/phpstan": "^2.0",
     "phpstan/phpstan-strict-rules": "^2.0",
+    "firehub/phpstan-rules": "^1.0",
     "phpunit/phpunit": "^13.0"
   },
-  "autoload-dev": {
-    "psr-4": {
-      "FireHub\\PHPStan\\": "phpstan/"
-    }
-  },
   "minimum-stability": "dev",
   "prefer-stable": true,
   "authors": [

dist/core.min.phar.pubkey

@@ -0,0 +1,14 @@
+-----BEGIN PUBLIC KEY-----
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA0IDxH1kkgj+hINvM/oMR
+w0CINronO5r+c2JWx52MrmdZw98TgMsu29XYXX92Vq6RuoVQxU9BHXZLEeeTdlJZ
+yJ8RPUM+FoKF0IfyvtUcd6P0r/Fuy6W2oAHYz9gF/Jo9OYK0gWAjf/LakLjY4BkD
+VntFcK0REXVPb88nbXk8HRTCP2cAEZU9YKopD7Q1Thq0lRRy0QSXT9E/sG4C9w9r
+mGXoTtfSB3qMkSZ4hrWkYLXeEoNVivLfOIjPv/hvHTl/kwZKFHr2Hyz/zsBREnw2
+cZfwpjdL3pNtvIonfDNbI7mDPw9joPMfpapk5BapoYyBZDuTETOC/5nw2RiX5F2n
++7THEK1u3YCqqPwVT9dWxGhH0+wcvs1QfBEcCBSXOBiFlvcw5y3yIPlwFUloDuN+
+hUn6GV68FhbKYBRUop9JhVLG/3/FCENfk7bm3vMDdWSkNWBnKt1s2LbRK4M6oBYG
+3/6xfS91zhh7XQsJvZpD6AxpsJx/50ailmgheLdycGaeflqpawC+L/fkTusOyjM1
+TKHHPKIKCieaeOW+bI1jaeKAmJuZGRouYun8No7S9ybS58Z/xjGrbLC2fjKRrRTE
+EBHb+o66gXTecCgNcSs0LmGkBLAsNL5HxhOk67GQexStuiTaAp4wjGuEPG1vQSQG
++dx6NDW9JrFPud0MgwRKTV8CAwEAAQ==
+-----END PUBLIC KEY-----

dist/core.phar.pubkey

@@ -0,0 +1,14 @@
+-----BEGIN PUBLIC KEY-----
+MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA0IDxH1kkgj+hINvM/oMR
+w0CINronO5r+c2JWx52MrmdZw98TgMsu29XYXX92Vq6RuoVQxU9BHXZLEeeTdlJZ
+yJ8RPUM+FoKF0IfyvtUcd6P0r/Fuy6W2oAHYz9gF/Jo9OYK0gWAjf/LakLjY4BkD
+VntFcK0REXVPb88nbXk8HRTCP2cAEZU9YKopD7Q1Thq0lRRy0QSXT9E/sG4C9w9r
+mGXoTtfSB3qMkSZ4hrWkYLXeEoNVivLfOIjPv/hvHTl/kwZKFHr2Hyz/zsBREnw2
+cZfwpjdL3pNtvIonfDNbI7mDPw9joPMfpapk5BapoYyBZDuTETOC/5nw2RiX5F2n
++7THEK1u3YCqqPwVT9dWxGhH0+wcvs1QfBEcCBSXOBiFlvcw5y3yIPlwFUloDuN+
+hUn6GV68FhbKYBRUop9JhVLG/3/FCENfk7bm3vMDdWSkNWBnKt1s2LbRK4M6oBYG
+3/6xfS91zhh7XQsJvZpD6AxpsJx/50ailmgheLdycGaeflqpawC+L/fkTusOyjM1
+TKHHPKIKCieaeOW+bI1jaeKAmJuZGRouYun8No7S9ybS58Z/xjGrbLC2fjKRrRTE
+EBHb+o66gXTecCgNcSs0LmGkBLAsNL5HxhOk67GQexStuiTaAp4wjGuEPG1vQSQG
++dx6NDW9JrFPud0MgwRKTV8CAwEAAQ==
+-----END PUBLIC KEY-----

phpstan.neon

@@ -1,17 +1,13 @@
 includes:
   - phar://phpstan.phar/conf/bleedingEdge.neon
   - vendor/phpstan/phpstan-strict-rules/rules.neon
-  - phpstan/rule.neon
-  - phpstan/type.neon
+  - vendor/firehub/phpstan-rules/rule.neon
+  - vendor/firehub/phpstan-rules/type.neon
 
 parameters:
   level: max
   paths:
     - src/
-    - phpstan/
-  excludePaths:
-   analyse:
-     - phpstan/**
   tmpDir: storage/cache/phpstan/
   ignoreErrors:
     - identifier: ternary.shortNotAllowed