@movk/maplibre 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YiXuan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,192 @@
+[![Movk MapLibre](https://maplibre.mhaibaraai.cn/og-image.png)](https://maplibre.mhaibaraai.cn/)
+
+English | [简体中文](./README.md)
+
+> A declarative MapLibre GL wrapper — compose maps with `MaplibreMap` / `MaplibreSource` / `MaplibreLayer` components and composables. The same `src/runtime` ships as a Nuxt 4 module and works in plain Vue + Vite projects via a Vite plugin. Built-in 3D buildings, dynamic effects (radar / diffusion / glow), sky / terrain environments, drawing (terra-draw), Tianditu tiles, WMS / WMTS, and multi-CRS localization support.
+
+[![Install MCP in Cursor](https://maplibre.mhaibaraai.cn/mcp/badge.svg)](https://maplibre.mhaibaraai.cn/mcp/deeplink)
+[![Install MCP in VS Code](https://maplibre.mhaibaraai.cn/mcp/badge.svg?ide=vscode)](https://maplibre.mhaibaraai.cn/mcp/deeplink?ide=vscode)
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![Nuxt](https://img.shields.io/badge/Nuxt-4-00DC82.svg)](https://nuxt.com/)
+[![MapLibre GL](https://img.shields.io/badge/MapLibre%20GL-v6-396cb2.svg)](https://maplibre.org/maplibre-gl-js/docs/)
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+
+- 📖 [Documentation](https://maplibre.mhaibaraai.cn)
+- 🇨🇳 [中文 README](./README.md)
+
+## ✨ Features
+
+- **Declarative composition** — Build maps, sources, layers, markers, popups, and controls with components. No imperative instance lifecycle management required.
+- **Context injection architecture** — `MaplibreContext` is propagated via provide/inject. Child components access the instance with `useMap()` directly, no id lookup needed.
+- **Two-way camera binding** — `v-model:center` / `zoom` / `bearing` / `pitch`, with cross-route persistence (`persistent` + keepalive).
+- **Rich layers and effects** — circle / fill / line / symbol / fill-extrusion / heatmap, clustering, buildings, raster, video, plus dynamic effects: radar / diffusion / glow / wave / migration / trail.
+- **3D environment** — Sky and atmosphere, terrain, and temperature heatmaps.
+- **Localization extensions** — Tianditu base tiles, WMS / WMTS services, `MaplibreDrawControl` drawing, and gcoord multi-CRS conversion (WGS84 / GCJ02 / BD09).
+- **SSR safe** — Map instances are created client-side in `onMounted` inside the component. No `<ClientOnly>` wrapper needed.
+- **AI friendly** — Built-in MCP Server and `llms.txt`. Components, composables, and docs are indexable by AI agents.
+
+The same components work in both Nuxt 4 and plain Vue + Vite. Drawing capabilities require the optional `terra-draw` and `terra-draw-maplibre-gl-adapter` packages.
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# pnpm
+pnpm add @movk/maplibre maplibre-gl
+
+# yarn
+yarn add @movk/maplibre maplibre-gl
+
+# npm
+npm install @movk/maplibre maplibre-gl
+```
+
+```bash
+# Optional: drawing support
+pnpm add terra-draw terra-draw-maplibre-gl-adapter
+```
+
+### Nuxt
+
+Register the module in `nuxt.config.ts`:
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@movk/maplibre']
+})
+```
+
+MapLibre needs no access token; when using Tianditu basemaps, the Tianditu token is read from an environment variable:
+
+```bash
+NUXT_PUBLIC_MAPLIBRE_TK=your_tianditu_tk
+```
+
+Components and composables are auto-imported — ready to use out of the box.
+
+### Vue + Vite
+
+Use the Vite plugin and Vue plugin in plain Vue + Vite projects. The API is identical to Nuxt:
+
+```ts
+// vite.config.ts
+import vue from '@vitejs/plugin-vue'
+import Maplibre from '@movk/maplibre/vite'
+
+export default defineConfig({
+  plugins: [vue(), Maplibre()]
+})
+```
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import MaplibrePlugin from '@movk/maplibre/vue-plugin'
+import '@movk/maplibre/index.css'
+// maplibre-gl v6 needs an explicit worker URL when bundled by Vite
+import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url'
+import App from './App.vue'
+
+createApp(App)
+  .use(MaplibrePlugin, { workerUrl, tk: import.meta.env.VITE_TIANDITU_TK })
+  .mount('#app')
+```
+
+### Basic Example
+
+Map instances are created client-side in `onMounted`. The component handles SSR safety internally — **no `<ClientOnly>` wrapper needed**:
+
+```vue
+<script setup lang="ts">
+const center = ref<[number, number]>([116.397, 39.908])
+const zoom = ref(9)
+</script>
+
+<template>
+  <MaplibreMap v-model:center="center" v-model:zoom="zoom" :options="{ style: 'https://tiles.openfreemap.org/styles/liberty' }">
+    <MaplibreLayer
+      layer-id="points"
+      type="circle"
+      :source="{ type: 'geojson', data: '/points.geojson' }"
+      :paint="{ 'circle-radius': 8, 'circle-color': '#e11d48' }"
+    />
+    <MaplibreNavigationControl position="top-right" />
+  </MaplibreMap>
+</template>
+```
+
+## 📦 Core Features
+
+### Declarative Components
+
+All components are prefixed with `Maplibre` by default (configurable). Grouped by domain:
+
+| Category | Components |
+| --- | --- |
+| Core | `MaplibreMap` `MaplibreSource` `MaplibreLayer` `MaplibreLayerGroup` `MaplibreCustomLayer` `MaplibreMarker` `MaplibreLottieMarker` `MaplibrePopup` `MaplibreTooltip` |
+| Layers | `MaplibreBuildingLayer` `MaplibreClusterLayer` `MaplibreImageLayer` `MaplibreRasterLayer` `MaplibreVideoLayer` |
+| Effects | `MaplibreRadar` `MaplibreDiffusionCircle` `MaplibreGlowCircle` `MaplibreWaveCircle` `MaplibreGradientBuilding` `MaplibreTextureBuilding` `MaplibreWindowBuilding` `MaplibreFlowBuilding` `MaplibreMigration` `MaplibreTrail` `MaplibreAnimatedImage` `MaplibreSpriteImage` |
+| Environment | `MaplibreSky` `MaplibreTerrain` `MaplibreTemperature` |
+| Controls | `MaplibreNavigationControl` `MaplibreGeolocateControl` `MaplibreFullscreenControl` `MaplibreScaleControl` `MaplibreAttributionControl` |
+| Extensions | `MaplibreDrawControl` `MaplibreTiandituLayer` `MaplibreWmsLayer` `MaplibreWmtsLayer` |
+| Buffers | `MaplibreBufferCircle` `MaplibreBufferEllipse` `MaplibreBufferLine` `MaplibreBufferPolygon` `MaplibreBufferSector` |
+
+### Composables
+
+- `useMap()` — Inject the current map context (`map` / `isLoaded` / `whenLoaded()` / `onReady()`).
+- `useMaplibre(id)` — Retrieve context by id from the registry (cross-tree / cross-route escape hatch).
+- `useMaplibreCamera()` — Read and control the camera (center / zoom / bearing / pitch).
+- `useMaplibreImage()` — Load and manage map images (icons / patterns).
+- `useFrameIcon()` — Animated icon management based on frame sequences.
+- `useFeatureState()` — Feature state (hover / active) management.
+- `useMapAnimation()` — Frame-by-frame animation driver with lifecycle control.
+- `useMapExport()` — Export map canvas as an image.
+- `useMeasure()` — Distance and area measurement.
+- `useMaplibreDraw(options?)` — Access the draw context; pass `mapId` to drive drawing from outside the component tree.
+- `defineMaplibreControl(onAdd, onRemove)` — Define a custom map control.
+
+### Coordinate Conversion
+
+```ts
+import { transformPoint, transformGeoJSON } from '@movk/maplibre/utils/coordinate'
+
+transformPoint([116.397, 39.908], 'WGS84', 'GCJ02')
+transformGeoJSON(featureCollection, 'GCJ02', 'WGS84')
+```
+
+## 🏗️ Architecture
+
+All runtime code lives in `src/runtime`, shared by both distribution paths:
+
+- **Nuxt module** — `src/module.ts` registers components and composables, writes config such as the Tianditu token to `runtimeConfig.public.maplibre`, and sets up the `#maplibre` alias pointing to the runtime.
+- **Vite + unplugin** — `src/vite.ts` / `src/vue-plugin.ts` / `src/unplugin.ts` expose plugin entry points for component resolution and auto-imports. Runtime config is shared as a `globalThis` singleton so both build targets read the same config.
+- **Runtime** — Map instances are distributed via provide/inject context. `onReady()` is the unified entry point for child components to register sources and layers, and automatically rebuilds them after `setStyle`.
+- **Foundation** — Built on [MapLibre GL JS v6](https://maplibre.org/maplibre-gl-js/docs/), [@movk/core](https://github.com/mhaibaraai), [Turf.js](https://turfjs.org/), [gcoord](https://github.com/hujiulong/gcoord), and [VueUse](https://vueuse.org/).
+
+## ⚡ Tech Stack
+
+- [MapLibre GL JS v6](https://maplibre.org/maplibre-gl-js/docs/) — Interactive vector map rendering engine
+- [Nuxt 4](https://nuxt.com/) — The Intuitive Vue Framework
+- [Vue 3.5](https://vuejs.org/) — The Progressive JavaScript Framework
+- [TypeScript](https://www.typescriptlang.org/) — JavaScript with syntax for types
+- [Turf.js](https://turfjs.org/) — Geospatial analysis; [gcoord](https://github.com/hujiulong/gcoord) — Multi-CRS conversion
+- [Vitest](https://vitest.dev/) — Next Generation Testing Framework
+
+## 📄 License
+
+[MIT](./LICENSE) License © 2024-PRESENT [YiXuan](https://github.com/mhaibaraai)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@movk/maplibre?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/@movk/maplibre
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/@movk/maplibre?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/@movk/maplibre
+
+[license-src]: https://img.shields.io/github/license/mhaibaraai/movk-maplibre.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/mhaibaraai/movk-maplibre/blob/main/LICENSE

package/README.md

@@ -0,0 +1,191 @@
+[![Movk MapLibre](https://maplibre.mhaibaraai.cn/og-image.png)](https://maplibre.mhaibaraai.cn/)
+
+简体中文 | [English](./README.en.md)
+
+> 声明式 MapLibre GL 封装库 —— 用 `MaplibreMap` / `MaplibreSource` / `MaplibreLayer` 等组件与 composables 组合地图。同一套 `src/runtime` 既作为 Nuxt 4 模块发布，也经 Vite 插件在纯 Vue + Vite 项目中使用。无需 access token，内置 3D 建筑、雷达 / 扩散 / 辉光等动态效果，sky / terrain 环境，绘制（terra-draw）、天地图、WMS / WMTS 与多坐标系本土化支持。
+
+[![Install MCP in Cursor](https://maplibre.mhaibaraai.cn/mcp/badge.svg)](https://maplibre.mhaibaraai.cn/mcp/deeplink)
+[![Install MCP in VS Code](https://maplibre.mhaibaraai.cn/mcp/badge.svg?ide=vscode)](https://maplibre.mhaibaraai.cn/mcp/deeplink?ide=vscode)
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+[![Nuxt](https://img.shields.io/badge/Nuxt-4-00DC82.svg)](https://nuxt.com/)
+[![MapLibre GL](https://img.shields.io/badge/MapLibre%20GL-v6-396cb2.svg)](https://maplibre.org/maplibre-gl-js/docs/)
+[![npm version][npm-version-src]][npm-version-href]
+[![npm downloads][npm-downloads-src]][npm-downloads-href]
+[![License][license-src]][license-href]
+
+- 📖 [在线文档](https://maplibre.mhaibaraai.cn)
+
+## ✨ 特性
+
+- **声明式组合** - 用组件搭建地图、数据源、图层、标记、弹窗、控件，无需命令式管理实例生命周期。
+- **上下文注入架构** - `MaplibreContext` 经 provide/inject 下发，子组件用 `useMap()` 直接取实例，不靠 id 查表。
+- **相机双向绑定** - `v-model:center` / `zoom` / `bearing` / `pitch`，支持跨路由持久化（`persistent` + keepalive）。
+- **丰富图层与效果** - circle / fill / line / symbol / fill-extrusion / heatmap、聚合、建筑、栅格、视频，叠加雷达 / 扩散 / 辉光 / 波纹 / 迁徙 / 轨迹等动态效果。
+- **三维环境** - sky 天空与大气、terrain 地形与 temperature 温度热力。
+- **本土化扩展** - 天地图底图、WMS / WMTS 服务、`MaplibreDrawControl` 绘制与 gcoord 多坐标系（WGS84 / GCJ02 / BD09）转换。
+- **SSR 安全** - 地图实例只在客户端 `onMounted` 创建，组件内已处理，无需 `<ClientOnly>` 包裹。
+- **AI 友好** - 内置 MCP Server 与 llms.txt，组件、composable、文档可被 AI 智能体检索。
+
+同一套组件在 Nuxt 4 与纯 Vue + Vite 下通用，仅绘制能力需可选安装 `terra-draw` 与 `terra-draw-maplibre-gl-adapter`。
+
+## 🚀 快速开始
+
+### 安装
+
+```bash
+# pnpm
+pnpm add @movk/maplibre maplibre-gl
+
+# yarn
+yarn add @movk/maplibre maplibre-gl
+
+# npm
+npm install @movk/maplibre maplibre-gl
+```
+
+```bash
+# 可选：绘制能力
+pnpm add terra-draw terra-draw-maplibre-gl-adapter
+```
+
+### Nuxt
+
+在 `nuxt.config.ts` 中注册模块：
+
+```ts
+export default defineNuxtConfig({
+  modules: ['@movk/maplibre']
+})
+```
+
+MapLibre 无需 access token；使用天地图底图时，天地图 token 从环境变量读取：
+
+```bash
+NUXT_PUBLIC_MAPLIBRE_TK=your_tianditu_tk
+```
+
+组件与 composables 自动导入，开箱即用。
+
+### Vue + Vite
+
+在纯 Vue + Vite 项目中经 Vite 插件 + Vue 插件使用，用法与 Nuxt 完全一致：
+
+```ts
+// vite.config.ts
+import vue from '@vitejs/plugin-vue'
+import Maplibre from '@movk/maplibre/vite'
+
+export default defineConfig({
+  plugins: [vue(), Maplibre()]
+})
+```
+
+```ts
+// main.ts
+import { createApp } from 'vue'
+import MaplibrePlugin from '@movk/maplibre/vue-plugin'
+import '@movk/maplibre/index.css'
+// maplibre-gl v6 经 Vite 打包时需显式提供 worker 地址
+import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url'
+import App from './App.vue'
+
+createApp(App)
+  .use(MaplibrePlugin, { workerUrl, tk: import.meta.env.VITE_TIANDITU_TK })
+  .mount('#app')
+```
+
+### 基础示例
+
+地图实例只在客户端 `onMounted` 创建，组件已做 SSR 安全处理，**无需 `<ClientOnly>` 包裹**：
+
+```vue
+<script setup lang="ts">
+const center = ref<[number, number]>([116.397, 39.908])
+const zoom = ref(9)
+</script>
+
+<template>
+  <MaplibreMap v-model:center="center" v-model:zoom="zoom" :options="{ style: 'https://tiles.openfreemap.org/styles/liberty' }">
+    <MaplibreLayer
+      layer-id="points"
+      type="circle"
+      :source="{ type: 'geojson', data: '/points.geojson' }"
+      :paint="{ 'circle-radius': 8, 'circle-color': '#e11d48' }"
+    />
+    <MaplibreNavigationControl position="top-right" />
+  </MaplibreMap>
+</template>
+```
+
+## 📦 核心功能
+
+### 声明式组件
+
+组件全局加 `Maplibre` 前缀（默认前缀可配），按领域分组：
+
+| 分类 | 组件 |
+| --- | --- |
+| 核心 | `MaplibreMap` `MaplibreSource` `MaplibreLayer` `MaplibreLayerGroup` `MaplibreCustomLayer` `MaplibreMarker` `MaplibreLottieMarker` `MaplibrePopup` `MaplibreTooltip` |
+| 图层 | `MaplibreBuildingLayer` `MaplibreClusterLayer` `MaplibreImageLayer` `MaplibreRasterLayer` `MaplibreVideoLayer` |
+| 效果 | `MaplibreRadar` `MaplibreDiffusionCircle` `MaplibreGlowCircle` `MaplibreWaveCircle` `MaplibreGradientBuilding` `MaplibreTextureBuilding` `MaplibreWindowBuilding` `MaplibreFlowBuilding` `MaplibreMigration` `MaplibreTrail` `MaplibreAnimatedImage` `MaplibreSpriteImage` |
+| 环境 | `MaplibreSky` `MaplibreTerrain` `MaplibreTemperature` |
+| 控件 | `MaplibreNavigationControl` `MaplibreGeolocateControl` `MaplibreFullscreenControl` `MaplibreScaleControl` `MaplibreAttributionControl` |
+| 扩展 | `MaplibreDrawControl` `MaplibreTiandituLayer` `MaplibreWmsLayer` `MaplibreWmtsLayer` |
+| 缓冲 | `MaplibreBufferCircle` `MaplibreBufferEllipse` `MaplibreBufferLine` `MaplibreBufferPolygon` `MaplibreBufferSector` |
+
+### Composables
+
+- `useMap()` — 注入当前地图上下文（`map` / `isLoaded` / `whenLoaded()` / `onReady()`）。
+- `useMaplibre(id)` — 按 id 从注册表获取上下文（跨树 / 跨路由逃生口）。
+- `useMaplibreCamera()` — 读取与控制相机（center / zoom / bearing / pitch）。
+- `useMaplibreImage()` — 地图图像（icon / pattern）的加载与管理。
+- `useFrameIcon()` — 基于帧序列的动画图标管理。
+- `useFeatureState()` — 要素状态（hover / active）管理。
+- `useMapAnimation()` — 逐帧动画驱动与生命周期控制。
+- `useMapExport()` — 地图画布截图导出。
+- `useMeasure()` — 距离 / 面积量算。
+- `useMaplibreDraw(options?)` — 获取绘制上下文；传 `mapId` 可在组件树外驱动绘制。
+- `defineMaplibreControl(onAdd, onRemove)` — 定义自定义控件。
+
+### 坐标转换
+
+```ts
+import { transformPoint, transformGeoJSON } from '@movk/maplibre/utils/coordinate'
+
+transformPoint([116.397, 39.908], 'WGS84', 'GCJ02')
+transformGeoJSON(featureCollection, 'GCJ02', 'WGS84')
+```
+
+## 🏗️ 架构分层
+
+库的全部运行时实现都在 `src/runtime`，两条分发链共用同一套代码：
+
+- **Nuxt 模块** - `src/module.ts` 注册组件与 composables，把天地图 token 等配置写入 `runtimeConfig.public.maplibre`，并挂 `#maplibre` 别名指向 runtime。
+- **Vite + unplugin** - `src/vite.ts` / `src/vue-plugin.ts` / `src/unplugin.ts` 对外暴露插件入口，解析组件与自动导入；运行时配置以 `globalThis` 单例共享，使双构建读到同一份配置。
+- **运行时** - `src/runtime` 内地图实例经 provide/inject 下发上下文，`onReady()` 是子组件建 source / layer 的统一入口，并在 `setStyle` 后自动重建。
+- **基座** - 构建于 [MapLibre GL JS v6](https://maplibre.org/maplibre-gl-js/docs/)、[@movk/core](https://github.com/mhaibaraai)、[Turf.js](https://turfjs.org/)、[gcoord](https://github.com/hujiulong/gcoord) 与 [VueUse](https://vueuse.org/)。
+
+## ⚡ 技术栈
+
+- [MapLibre GL JS v6](https://maplibre.org/maplibre-gl-js/docs/) - 交互式矢量地图渲染引擎
+- [Nuxt 4](https://nuxt.com/) - The Intuitive Vue Framework
+- [Vue 3.5](https://vuejs.org/) - The Progressive JavaScript Framework
+- [TypeScript](https://www.typescriptlang.org/) - JavaScript with syntax for types
+- [Turf.js](https://turfjs.org/) - 地理空间分析；[gcoord](https://github.com/hujiulong/gcoord) - 多坐标系转换
+- [Vitest](https://vitest.dev/) - Next Generation Testing Framework
+
+## 📄 许可证
+
+[MIT](./LICENSE) License © 2024-PRESENT [YiXuan](https://github.com/mhaibaraai)
+
+<!-- Badges -->
+
+[npm-version-src]: https://img.shields.io/npm/v/@movk/maplibre?style=flat&colorA=080f12&colorB=1fa669
+[npm-version-href]: https://npmjs.com/package/@movk/maplibre
+
+[npm-downloads-src]: https://img.shields.io/npm/dm/@movk/maplibre?style=flat&colorA=080f12&colorB=1fa669
+[npm-downloads-href]: https://npmjs.com/package/@movk/maplibre
+
+[license-src]: https://img.shields.io/github/license/mhaibaraai/movk-maplibre.svg?style=flat&colorA=080f12&colorB=1fa669
+[license-href]: https://github.com/mhaibaraai/movk-maplibre/blob/main/LICENSE

package/dist/module.d.mts

@@ -0,0 +1,20 @@
+import * as _nuxt_schema from '@nuxt/schema';
+export * from '../dist/runtime/types/index.js';
+
+interface ModuleOptions {
+    /** 天地图服务 token（tk） */
+    tk?: string;
+    /** 空白样式的字体 pbf 地址模板（含 {fontstack} 与 {range}） */
+    glyphs?: string;
+    /** 库内置文字图层使用的字体栈 */
+    textFont?: string[];
+    /**
+     * 组件前缀
+     * @defaultValue 'Maplibre'
+     */
+    prefix?: string;
+}
+declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+
+export { _default as default };
+export type { ModuleOptions };

package/dist/module.d.ts

@@ -0,0 +1,20 @@
+import * as _nuxt_schema from '@nuxt/schema';
+export * from '../dist/runtime/types/index.js';
+
+interface ModuleOptions {
+    /** 天地图服务 token（tk） */
+    tk?: string;
+    /** 空白样式的字体 pbf 地址模板（含 {fontstack} 与 {range}） */
+    glyphs?: string;
+    /** 库内置文字图层使用的字体栈 */
+    textFont?: string[];
+    /**
+     * 组件前缀
+     * @defaultValue 'Maplibre'
+     */
+    prefix?: string;
+}
+declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
+
+export { _default as default };
+export type { ModuleOptions };

package/dist/module.json

@@ -0,0 +1,12 @@
+{
+  "name": "@movk/maplibre",
+  "version": "1.0.0",
+  "configKey": "maplibre",
+  "compatibility": {
+    "nuxt": ">=4.0.0"
+  },
+  "builder": {
+    "@nuxt/module-builder": "1.0.3",
+    "unbuild": "3.6.1"
+  }
+}

package/dist/module.mjs

@@ -0,0 +1,63 @@
+import { createRequire } from 'node:module';
+import { defineNuxtModule, createResolver, addComponentsDir, addImportsDir, addImports, addPlugin, addPluginTemplate, extendViteConfig } from '@nuxt/kit';
+import { defu } from 'defu';
+
+const name = "@movk/maplibre";
+const version = "1.0.0";
+
+const module$1 = defineNuxtModule({
+  meta: {
+    name,
+    version,
+    configKey: "maplibre",
+    compatibility: { nuxt: ">=4.0.0" }
+  },
+  defaults: {
+    prefix: "Maplibre"
+  },
+  setup(options, nuxt) {
+    const { resolve } = createResolver(import.meta.url);
+    nuxt.options.alias["#maplibre"] = resolve("./runtime");
+    const publicConfig = nuxt.options.runtimeConfig.public;
+    publicConfig.maplibre = defu(publicConfig.maplibre, {
+      tk: options.tk || process.env.NUXT_PUBLIC_MAPLIBRE_TK,
+      glyphs: options.glyphs,
+      textFont: options.textFont
+    });
+    nuxt.options.css.push(resolve("./runtime/index.css"));
+    addComponentsDir({
+      path: resolve("./runtime/components"),
+      prefix: options.prefix,
+      pathPrefix: false
+    });
+    addImportsDir(resolve("./runtime/composables"));
+    addImports([
+      { name: "movkDrawModes", from: resolve("./runtime/draw-modes") },
+      { name: "drawThemeStyles", from: resolve("./runtime/utils/draw-theme") }
+    ]);
+    addPlugin({ src: resolve("./runtime/plugins/config") });
+    addPluginTemplate({
+      filename: "movk-maplibre-worker.client.mjs",
+      mode: "client",
+      getContents: () => [
+        `import { defineNuxtPlugin } from '#app'`,
+        `import workerUrl from 'maplibre-gl/dist/maplibre-gl-worker.mjs?worker&url'`,
+        `import { setMaplibreConfig } from ${JSON.stringify(resolve("./runtime/domains/map/config"))}`,
+        `export default defineNuxtPlugin(() => { setMaplibreConfig({ workerUrl }) })`
+      ].join("\n")
+    });
+    extendViteConfig((config) => {
+      config.optimizeDeps ||= {};
+      const include = config.optimizeDeps.include ||= [];
+      const require = createRequire(import.meta.url);
+      if (include.includes("lottie-web")) return;
+      try {
+        require.resolve("lottie-web", { paths: [nuxt.options.rootDir] });
+        include.push("lottie-web");
+      } catch {
+      }
+    });
+  }
+});
+
+export { module$1 as default };

package/dist/runtime/components/CustomLayer.d.vue.ts

@@ -0,0 +1,24 @@
+import type { CustomLayerInterface } from 'maplibre-gl';
+/** CustomLayerInterface 逃生舱：托管自定义 WebGL 图层的挂载/卸载与样式重载重建。 */
+type __VLS_Props = {
+    /**
+     * 自定义图层实现（含 id/type/render）
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/interfaces/CustomLayerInterface/
+     */
+    layer: CustomLayerInterface;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/CustomLayer.vue

@@ -0,0 +1,23 @@
+<script setup>
+import { onUnmounted } from "vue";
+import { useMap } from "../composables/useMap";
+const props = defineProps({
+  layer: { type: Object, required: true },
+  beforeId: { type: String, required: false }
+});
+const ctx = useMap();
+const stopReady = ctx.onReady((map) => {
+  if (map.getLayer(props.layer.id)) return;
+  const before = props.beforeId && map.getLayer(props.beforeId) ? props.beforeId : void 0;
+  map.addLayer(props.layer, before);
+});
+onUnmounted(() => {
+  stopReady();
+  const map = ctx.map.value;
+  if (map?.getLayer(props.layer.id)) map.removeLayer(props.layer.id);
+});
+</script>
+
+<template>
+  <slot />
+</template>

package/dist/runtime/components/CustomLayer.vue.d.ts

@@ -0,0 +1,24 @@
+import type { CustomLayerInterface } from 'maplibre-gl';
+/** CustomLayerInterface 逃生舱：托管自定义 WebGL 图层的挂载/卸载与样式重载重建。 */
+type __VLS_Props = {
+    /**
+     * 自定义图层实现（含 id/type/render）
+     * @see https://maplibre.org/maplibre-gl-js/docs/API/interfaces/CustomLayerInterface/
+     */
+    layer: CustomLayerInterface;
+    /** 插入到该图层之前 */
+    beforeId?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};