#moontiles

#解决的痛点

#已支持

#安装

moon add qqq66668/moontiles

import {
  "qqq66668/moontiles/pmtiles",
  "qqq66668/moontiles/mbtiles",
  "qqq66668/moontiles/tilemath",
  "qqq66668/moontiles/sqlite",
}

#快速开始

let file = @pmtiles.PmtilesFile::from_bytes(bytes)
let header = file.header()
let tile = file.tile(12, 3372, 1552)
let meta = file.metadata_text()

let db = @mbtiles.Mbtiles::from_bytes(bytes)
let format = db.metadata("format")
let tile = db.tile(0, 0, 0)

moon run cmd/moontiles --target wasm-gc

#包结构

#与参考实现对拍

• 瓦片编号：97 组 (z, x, y) 与参考实现 pmtiles 3.8.1 的 zxy_to_tileid 逐项一致。
• 目录解码：按规范编码的 fixture 交给参考实现解码，tile_id / offset / length / run_length 四列逐项一致。
• SQLite 与 MBTiles：fixture 由 Python 标准库 sqlite3 写出，文件头、页头、记录头与元数据键值对逐项断言。

#测试

moon check --target wasm-gc --deny-warn
moon test --target wasm-gc
moon test --target js

#后续计划

• GeoPackage 1.4 瓦片表读取（复用同一 SQLite 层）。
• 记录正文跨多级内部页的更大表遍历压力测试。

#已知限制

• 只读：不写 PMTiles、MBTiles 或 SQLite 文件。
• 不做瓦片渲染、投影变换与矢量瓦片内容解码。

#许可

#参考项目

• PMTiles 规范：https://github.com/protomaps/PMTiles/blob/main/spec/v3/spec.md
• MBTiles 1.3 规范：https://github.com/mapbox/mbtiles-spec/blob/master/1.3/spec.md
• SQLite 文件格式：https://www.sqlite.org/fileformat2.html
• gzip 解压复用 moonbit-community/flate（Apache-2.0），未在本库重复实现 DEFLATE。

#变异测试

python tools/mutation_check.py

#开发回顾

• gzip 解压不自己实现，复用生态里成熟的 moonbit-community/flate，把范围收敛到容器解析本身。
• 目录解码按规范的列式布局实现；偏移列 0 表示紧邻上一项、非 0 表示绝对偏移加一，这条规则来自规范与参考实现源码核对，不是猜测。
• 记录正文超过单页时走溢出页链，而不是直接拒绝，避免把合法文件判为非法。