docs: rewrite README with comprehensive API documentation

[cristinecula]

Summary

• Replaces the near-empty README ("A pionjs component") with comprehensive documentation covering the full API surface
• All examples are production-inspired, based on real usage patterns from cosmoz-frontend (purchase procurement views)
• Documents the 4 main entry points: main queue, actions, list, and fetch utilities

Documentation structure

Section	Content
Quick start	queue() factory with typed example showing details, list, view, loader pattern
View modes	Explanation of list/split/queue tabs, URL hash sync, mobile behavior
List module	listCore(), column(), useListCore(), useListCoreState() with full examples
Actions module	action(), renderActions(), defaultButton() with dialog integration examples
Advanced hooks	useQueue() + renderQueue() composition, individual hooks reference table
Utilities	Fetch helpers (setBaseInit, handleJSON, RequestError), itemClick(), getItems(), touch()
Architecture	ASCII diagram of the internal composition tree
Entry points	Reference table mapping all import paths to their exports

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-02-12 08:41 UTC

[github-actions]

🎉 This PR is included in version 1.6.2 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)

Your semantic-release bot 📦🚀