{"_id":"@aymenkits/clustermap-core","name":"@aymenkits/clustermap-core","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@aymenkits/clustermap-core","version":"1.0.0","description":"Backend-driven H3 hierarchical map clustering engine. Pure TypeScript: points in, clusters out — no database, no framework.","license":"MIT","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit"},"dependencies":{"h3-js":"^4.1.0"},"publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/aymenmokhtarikouki/clustermap-kit.git","directory":"packages/core"},"keywords":["map","clustering","h3","mapbox","geospatial","markers","core"],"engines":{"node":">=18"},"sideEffects":false,"homepage":"https://github.com/aymenmokhtarikouki/clustermap-kit#readme","bugs":{"url":"https://github.com/aymenmokhtarikouki/clustermap-kit/issues"},"author":{"name":"Aymen Mokhtari"},"_id":"@aymenkits/clustermap-core@1.0.0","gitHead":"fa3884826f530a9d72f2b9ef11c6921bf881f652","_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-iffLyTojHOub4jwnAdXdD47jtRZP7h+Kp18GwraVDmVFZAYZ6mg6JFIiv1BtslJ78G85fyqsYEzy++R2CFJ+8A==","shasum":"0149ce60e1f186ececaed005ec6e4d8f7a478af4","tarball":"https://registry.npmjs.org/@aymenkits/clustermap-core/-/clustermap-core-1.0.0.tgz","fileCount":31,"unpackedSize":67236,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICKOAbDmp/MaUqoFyxcKPsC/Yf192wB5WIfZK6yaAQ2WAiEAkHG8e1IefiXGe4rTYMNNah78HwCmN9SKD3pAZ2flDBw="}]},"_npmUser":{"name":"aymen-mokhtari","email":"ayman.mokhtari@proton.me"},"directories":{},"maintainers":[{"name":"aymen-mokhtari","email":"ayman.mokhtari@proton.me"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/clustermap-core_1.0.0_1783791364093_0.7127877999265078"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-11T17:36:03.943Z","1.0.0":"2026-07-11T17:36:04.253Z","modified":"2026-07-11T17:36:04.491Z"},"maintainers":[{"name":"aymen-mokhtari","email":"ayman.mokhtari@proton.me"}],"description":"Backend-driven H3 hierarchical map clustering engine. Pure TypeScript: points in, clusters out — no database, no framework.","homepage":"https://github.com/aymenmokhtarikouki/clustermap-kit#readme","keywords":["map","clustering","h3","mapbox","geospatial","markers","core"],"repository":{"type":"git","url":"git+https://github.com/aymenmokhtarikouki/clustermap-kit.git","directory":"packages/core"},"author":{"name":"Aymen Mokhtari"},"bugs":{"url":"https://github.com/aymenmokhtarikouki/clustermap-kit/issues"},"license":"MIT","readme":"# @aymenkits/clustermap-core\n\nBackend map-clustering engine: viewport-adaptive H3 hierarchical clustering with centroid + tight member bounds per cluster, antimeridian handling and validZoom cache metadata.\n\n## Install\n\n```bash\nnpm install @aymenkits/clustermap-core\n```\n\nInstalls with it: `h3-js` (automatic dependency).\n\n## You provide\n\n- `ClusterDataSource` — two queries on YOUR schema: aggregate counts per H3 cell and load raw points for small cells (SQL/Prisma/anything)\n\nThe package never owns tables, never imports an ORM, HTTP framework, or\nprovider SDK it can take as a parameter — storage and delivery are seams your\napp implements on its own stack.\n\n## Quick example\n\n```ts\nimport { createClusterEngine } from '@aymenkits/clustermap-core'\n\nconst engine = createClusterEngine({ dataSource: myDataSource })\nconst result = await engine.cluster({ bounds, zoom, filters })\n// → { clusters: [...], points: [...], meta: { validZoom } }\n```\n\n## Pairs with\n\n- `@aymenkits/clustermap-server` for the HTTP endpoint\n- `@aymenkits/clustermap-react` for the Mapbox GL frontend\n\nKits pair **by shape, never by import** — pass the sibling kit, your own\nservice, or a stub in tests.\n\n## Docs\n\nFull contracts and integration guides live in the repo:\nhttps://github.com/aymenmokhtarikouki/clustermap-kit (`contracts/`, `docs/`).\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-7c203ef178e35e6c6fa5da3e8d5b1aa6"}