chore: deep overhaul — ship types, fix peer deps, add tests/CI/tooling, rewrite README

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,45 @@
+---
+name: Bug report
+about: Report a problem with react-native-header-view
+title: "[Bug] "
+labels: bug
+assignees: ""
+---
+
+## Describe the bug
+
+A clear and concise description of what the bug is.
+
+## Which header(s)?
+
+- [ ] GorgeousHeader
+- [ ] AppleHeader
+- [ ] ModernHeader
+- [ ] ClassicHeader
+- [ ] ProfileHeader
+- [ ] ElegantHeader
+
+## Reproduction
+
+A minimal code snippet or repo that reproduces the issue.
+
+```jsx
+// ...
+```
+
+## Expected behavior
+
+What you expected to happen.
+
+## Environment
+
+- `@freakycoder/react-native-header-view` version:
+- Relevant sub-package version(s) (e.g. `react-native-classic-header`):
+- `react-native` version:
+- `react` version:
+- Platform: iOS / Android / both
+- New Architecture (Fabric) enabled: yes / no
+
+## Additional context
+
+Add any other context, logs, or screenshots here.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Sub-package issues
+    url: https://github.com/kuraydev
+    about: This package only re-exports the standalone header packages. For a bug in a specific header's behavior, please file it on that header's own repository.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an idea for react-native-header-view
+title: "[Feature] "
+labels: enhancement
+assignees: ""
+---
+
+## Is your feature request related to a problem?
+
+A clear and concise description of the problem. Ex. "I'm always frustrated when [...]"
+
+## Describe the solution you'd like
+
+A clear and concise description of what you want to happen.
+
+## Describe alternatives you've considered
+
+Any alternative solutions or features you've considered.
+
+## Additional context
+
+Add any other context or screenshots about the feature request here.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## Summary
+
+<!-- What does this PR change and why? -->
+
+## Type of change
+
+- [ ] Bug fix (non-breaking)
+- [ ] New feature (non-breaking)
+- [ ] Breaking change
+- [ ] Documentation only
+- [ ] Tooling / CI / chore
+
+## Checklist
+
+- [ ] `npm run typecheck` passes
+- [ ] `npm run lint` passes
+- [ ] `npm test` passes
+- [ ] `npm run format:check` passes
+- [ ] I updated `CHANGELOG.md` under `## [Unreleased]`
+- [ ] The public API (exported names, prop names, default values) is unchanged, or the change is documented as breaking
+
+## Related issues
+
+<!-- e.g. Closes #36 -->

.github/dependabot.yml

@@ -1,7 +1,17 @@
 version: 2
 updates:
-- package-ecosystem: npm
-  directory: "/"
-  schedule:
-    interval: daily
-  open-pull-requests-limit: 10
+  - package-ecosystem: npm
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 10
+  - package-ecosystem: npm
+    directory: "/example"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 10
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5

.github/workflows/ci.yml

@@ -0,0 +1,40 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  build:
+    name: Lint, typecheck & test (Node ${{ matrix.node }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        node: [18, 20, 22]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node ${{ matrix.node }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+
+      - name: Install dependencies
+        run: npm install --legacy-peer-deps
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Format check
+        run: npm run format:check
+
+      - name: Test
+        run: npm test -- --ci

.prettierignore

@@ -0,0 +1,9 @@
+node_modules
+coverage
+lib
+example/node_modules
+example/ios
+example/android
+example/yarn.lock
+example/package-lock.json
+CHANGELOG.md

.prettierrc.json

@@ -0,0 +1,10 @@
+{
+  "arrowParens": "always",
+  "bracketSameLine": false,
+  "bracketSpacing": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "tabWidth": 2,
+  "semi": true,
+  "printWidth": 80
+}

CHANGELOG.md

@@ -1,63 +1,73 @@
-# Change Log
+# Changelog
 
-## [0.4.13](https://github.com/WrathChaos/react-native-header-view/tree/0.4.13) (2019-11-22)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.4.11...0.4.13)
+All notable changes to this project are documented in this file.
 
-## [0.4.11](https://github.com/WrathChaos/react-native-header-view/tree/0.4.11) (2019-11-13)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.4.10...0.4.11)
+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).
 
-## [0.4.10](https://github.com/WrathChaos/react-native-header-view/tree/0.4.10) (2019-11-13)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.4.7...0.4.10)
+## [Unreleased]
 
-**Implemented enhancements:**
+### Added
 
-- Apple header Bg colour options  [\#6](https://github.com/WrathChaos/react-native-header-view/issues/6)
+- **TypeScript type definitions** (`lib/index.d.ts`) with prop interfaces for all
+  six headers; `types`, `module`, `react-native`, `exports`, `sideEffects`, and
+  `files` fields added to `package.json`.
+- `react-native-profile-header` added to `peerDependencies` — it was imported and
+  re-exported by `lib/index.js` but missing from the manifest.
+- `peerDependenciesMeta` marking all six header sub-packages as **optional**, so
+  consumers who only use a subset are no longer warned about the rest.
+- Tooling: Jest contract test suite, ESLint 9 flat config, Prettier config, root
+  `tsconfig.json`, and npm scripts (`typecheck`, `lint`, `format`, `test`, `build`).
+- GitHub Actions CI (lint + typecheck + format check + test on Node 18/20/22).
+- `CONTRIBUTING.md`, issue templates, and a pull-request template.
 
-## [0.4.7](https://github.com/WrathChaos/react-native-header-view/tree/0.4.7) (2019-10-04)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.4.6...0.4.7)
+### Changed
 
-## [0.4.6](https://github.com/WrathChaos/react-native-header-view/tree/0.4.6) (2019-10-04)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.4.5...0.4.6)
+- Repointed `repository`, `bugs`, and `homepage` metadata from the old
+  `WrathChaos`/`freakycoder.com` owner to `kuraydev`. The npm package name
+  (`@freakycoder/react-native-header-view`) is unchanged.
+- Rewrote the README: accurate props/API tables, documented `ElegantHeader` and
+  `ProfileHeader`, a single copy-paste install command, a Table of Contents,
+  TypeScript and New Architecture notes, fixed badges/links, and corrected JSX
+  snippets.
+- Deduplicated and modernized `keywords`.
 
-**Closed issues:**
+### Fixed
 
-- Request to Add product in Start React [\#5](https://github.com/WrathChaos/react-native-header-view/issues/5)
+- **`ClassicHeader` title prop** documented correctly as `title` (not
+  `headerTitle`). Resolves [#36](https://github.com/kuraydev/react-native-header-view/issues/36).
+- Fixed invalid JSX in README examples (`hitSlops` missing object braces,
+  `leftIconComponent` pseudo-code).
+- Corrected the README logo `alt` text ("React Native Bottom Bar" → header view).
+- Replaced the dead, unrunnable `airbnb` + `babel-eslint` lint setup with a
+  working ESLint 9 flat config.
 
-**Merged pull requests:**
+### Removed
 
-- Bump eslint-utils from 1.4.0 to 1.4.2 in /example [\#4](https://github.com/WrathChaos/react-native-header-view/pull/4) ([dependabot[bot]](https://github.com/apps/dependabot))
+- Stale embedded changelog from the README (now lives here).
+- Legacy Expo `app.json` (pinned to SDK 31 / 2018 and referenced missing assets).
 
-## [0.4.5](https://github.com/WrathChaos/react-native-header-view/tree/0.4.5) (2019-08-17)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.3.0...0.4.5)
+## Historical releases
 
-## [0.3.0](https://github.com/WrathChaos/react-native-header-view/tree/0.3.0) (2019-08-12)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.61...0.3.0)
+The pre-`1.0.0` history below was generated by github_changelog_generator and is
+kept for reference. Links point at the original `WrathChaos` repository.
 
-**Merged pull requests:**
+### [0.4.13](https://github.com/WrathChaos/react-native-header-view/tree/0.4.13) (2019-11-22)
 
-- Bump lodash from 4.17.11 to 4.17.14 in /examples [\#3](https://github.com/WrathChaos/react-native-header-view/pull/3) ([dependabot[bot]](https://github.com/apps/dependabot))
-- Bump handlebars from 4.1.0 to 4.1.2 in /examples [\#2](https://github.com/WrathChaos/react-native-header-view/pull/2) ([dependabot[bot]](https://github.com/apps/dependabot))
-- Bump js-yaml from 3.12.1 to 3.13.1 in /examples [\#1](https://github.com/WrathChaos/react-native-header-view/pull/1) ([dependabot[bot]](https://github.com/apps/dependabot))
+### [0.4.11](https://github.com/WrathChaos/react-native-header-view/tree/0.4.11) (2019-11-13)
 
-## [0.2.61](https://github.com/WrathChaos/react-native-header-view/tree/0.2.61) (2019-03-19)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.6...0.2.61)
+### [0.4.10](https://github.com/WrathChaos/react-native-header-view/tree/0.4.10) (2019-11-13)
 
-## [0.2.6](https://github.com/WrathChaos/react-native-header-view/tree/0.2.6) (2019-03-05)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.5...0.2.6)
+- Apple header background colour option (#6)
 
-## [0.2.5](https://github.com/WrathChaos/react-native-header-view/tree/0.2.5) (2019-03-05)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.4...0.2.5)
+### [0.4.7](https://github.com/WrathChaos/react-native-header-view/tree/0.4.7) (2019-10-04)
 
-## [0.2.4](https://github.com/WrathChaos/react-native-header-view/tree/0.2.4) (2019-03-05)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.3...0.2.4)
+### [0.4.6](https://github.com/WrathChaos/react-native-header-view/tree/0.4.6) (2019-10-04)
 
-## [0.2.3](https://github.com/WrathChaos/react-native-header-view/tree/0.2.3) (2019-03-05)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.2...0.2.3)
+### [0.4.5](https://github.com/WrathChaos/react-native-header-view/tree/0.4.5) (2019-08-17)
 
-## [0.2.2](https://github.com/WrathChaos/react-native-header-view/tree/0.2.2) (2019-03-05)
-[Full Changelog](https://github.com/WrathChaos/react-native-header-view/compare/0.2.0...0.2.2)
+### [0.3.0](https://github.com/WrathChaos/react-native-header-view/tree/0.3.0) (2019-08-12)
 
-## [0.2.0](https://github.com/WrathChaos/react-native-header-view/tree/0.2.0) (2019-02-23)
+### [0.2.61](https://github.com/WrathChaos/react-native-header-view/tree/0.2.61) (2019-03-19)
 
-
-\* *This Change Log was automatically generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*
+### [0.2.0](https://github.com/WrathChaos/react-native-header-view/tree/0.2.0) (2019-02-23)

CONTRIBUTING.md

@@ -0,0 +1,61 @@
+# Contributing
+
+Thanks for your interest in improving **@freakycoder/react-native-header-view**!
+
+## What this package is
+
+This package is a thin **barrel** that re-exports six standalone React Native
+header components, each published as its own npm package:
+
+| Export           | Source package                 |
+| ---------------- | ------------------------------ |
+| `GorgeousHeader` | `react-native-gorgeous-header` |
+| `AppleHeader`    | `react-native-apple-header`    |
+| `ModernHeader`   | `react-native-modern-header`   |
+| `ClassicHeader`  | `react-native-classic-header`  |
+| `ProfileHeader`  | `react-native-profile-header`  |
+| `ElegantHeader`  | `react-native-elegant-header`  |
+
+There is **no UI code** in this repo — `lib/index.js` is the entire library.
+A bug in a header's _rendering or props_ almost always belongs in that header's
+own repository. Issues here should be about the aggregator: missing/incorrect
+exports, types, docs, packaging, or peer-dependency metadata.
+
+## Development setup
+
+```bash
+git clone https://github.com/kuraydev/react-native-header-view.git
+cd react-native-header-view
+npm install --legacy-peer-deps
+```
+
+The sub-packages are declared as **optional** peer dependencies and are not
+required to develop or test the barrel — the test suite mocks them.
+
+## Scripts
+
+| Script                 | What it does                                 |
+| ---------------------- | -------------------------------------------- |
+| `npm run typecheck`    | `tsc --noEmit` against the shipped type defs |
+| `npm run lint`         | ESLint (flat config)                         |
+| `npm run format`       | Prettier write                               |
+| `npm run format:check` | Prettier check (CI gate)                     |
+| `npm test`             | Jest contract tests                          |
+
+## Guidelines
+
+- **Do not rename or remove any of the six exports.** Doing so breaks every
+  dependent. Keep `GorgeousHeader`, `AppleHeader`, `ModernHeader`,
+  `ClassicHeader`, `ProfileHeader`, and `ElegantHeader`.
+- **Do not change the npm package name/scope** (`@freakycoder/...`).
+- Preserve prop names and runtime defaults. Fix docs to match the code, not the
+  reverse, unless it is a genuine bug.
+- Use [Conventional Commits](https://www.conventionalcommits.org/) for commit
+  messages.
+- Add a line under `## [Unreleased]` in `CHANGELOG.md` for any user-facing change.
+
+## Submitting changes
+
+1. Fork and create a feature branch.
+2. Make your change, keeping the checks above green.
+3. Open a PR using the template. Link any issues it closes.