Feature/overhaul lists

[dan323]

No description provided.

[Copilot]

Pull request overview

This PR updates the functional List implementation to support instance-based cons(...) and overhauls ZipApplicative zipping behavior (especially when zipping Cons-prefixed infinite lists), along with related test updates and new/updated documentation.

Changes:

• Refactors list construction toward list.cons(head) and adjusts List factory return types (generate/repeat/nil).
• Updates ZipApplicative/Zipped to use InfiniteList#getHead() and adds Cons-optimized zipping behavior.
• Adds docs/CORE_CONCEPTS.md and updates README/CHANGELOG to reflect documentation structure and the list overhaul.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
example-functional/src/test/java/com/dan323/functional/ZipApplicativeTest.java	Adds coverage for zipping with Cons-prefixed infinite lists.
example-functional/src/test/java/com/dan323/functional/ListTest.java	Updates list construction to use instance cons(...).
example-functional/src/test/java/com/dan323/functional/ListFunctorTest.java	Updates list construction to use instance cons(...).
example-functional/src/main/java/com/dan323/functional/data/optional/Nothing.java	Adjusts hashCode() and removes unused import.
example-functional/src/main/java/com/dan323/functional/data/optional/Just.java	Adjusts hashCode() formula.
example-functional/src/main/java/com/dan323/functional/data/list/Zipped.java	Switches to InfiniteList internals and computes head via getHead().
example-functional/src/main/java/com/dan323/functional/data/list/ZipApplicative.java	Reworks liftA2 branching, including Cons-specific zipping and Repeat optimization.
example-functional/src/main/java/com/dan323/functional/data/list/Repeat.java	Implements getHead() for the new InfiniteList head access pattern.
example-functional/src/main/java/com/dan323/functional/data/list/List.java	Adds instance cons(...), removes static cons(...), and narrows factory return types.
example-functional/src/main/java/com/dan323/functional/data/list/InfiniteList.java	Introduces getHead() and provides default head()/cons(...) implementations.
example-functional/src/main/java/com/dan323/functional/data/list/Generating.java	Implements getHead() and updates mapped infinite list internals.
example-functional/src/main/java/com/dan323/functional/data/list/FiniteList.java	Adds default instance cons(...).
example-functional/src/main/java/com/dan323/functional/data/list/Cons.java	Implements getHead() and adds zipBy(...) helper.
example-functional/src/main/java/com/dan323/functional/data/either/Left.java	Refactors equals(...) implementation style.
docs/CORE_CONCEPTS.md	Adds initial “Core Concepts” documentation page.
README.md	Simplifies/clarifies documentation index links.
CHANGELOG.md	Notes list zipping overhaul and adds a core concepts documentation entry.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
81.3% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud