mc-tunnel 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mc-tunnel contributors
+
+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.md

@@ -1,3 +1,261 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# mc-tunnel
+
+面向 **Electron / Node.js** 的 Minecraft 局域网联机模块。
+
+房主在游戏里「对局域网开放」，把 **房间码** 发给朋友；朋友输入房间码后，
+游戏「多人游戏 → 局域网世界」里就会出现这条房间，双击即可进入。
+
+> [EasyTier](https://github.com/EasyTier/EasyTier) 以**外部子进程**方式调用完成 P2P 组网
+> （详见 [合规说明](#合规说明)）。
+
+---
+
+## 特性
+
+| | |
+|---|---|
+| 零依赖 | 运行时只使用 Node 内置模块（`http` / `dgram` / `net` / `child_process`），不引入任何 npm 依赖 |
+| 免管理员权限 | EasyTier 以 `--no-tun` 运行，不创建虚拟网卡 |
+| 无需自建服务器 | 房间码自包含凭据，节点发现交给 EasyTier 公共节点；也支持完全离线直连 |
+| 无需 mod | 通过伪造 Minecraft 局域网多播让原版客户端直接可见 |
+| 安全 | 房间码含 CRC-12 校验；协调服务使用握手指纹 + 令牌鉴权（恒定时间比较） |
+| 双格式 | 同时产出 ESM 与 CJS，附带 `.d.ts` 类型声明 |
+| 可观测 | 全流程 `state` / `players` / `error` 事件，失败时携带 EasyTier 日志尾部 |
+
+---
+
+## 安装
+
+```bash
+npm install mc-tunnel
+```
+
+同时需要准备 EasyTier 的两个可执行文件（本包**不打包**它们，避免体积与许可问题）：
+
+```
+easytier-core(.exe)
+easytier-cli(.exe)
+```
+
+放置位置三选一：
+
+1. Electron：`resources/easytier/`（配合 electron-builder 的 `extraResources`）
+2. 任意目录 + 环境变量 `MC_TUNNEL_EASYTIER=/path/to/dir`
+3. 代码里传 `easyTier: { binDir: '/path/to/dir' }`
+
+---
+
+## 快速开始
+
+```ts
+import { createHost, createGuest } from 'mc-tunnel';
+
+// ---------- 房主 ----------
+const host = await createHost({
+  mcPort: 25565,          // 不传则自动监听局域网广播发现
+  playerName: 'Alice',
+});
+
+console.log('房间码:', host.roomCode);   // 例如 7Q2M-K9XP-3RTF-WV4D
+
+host.on('player-join', (player) => console.log(`${player.name} 加入了`));
+host.on('mc-closed', () => console.log('存档已关闭，房间失效'));
+
+// ---------- 客人 ----------
+const guest = await createGuest({
+  roomCode: '7Q2M-K9XP-3RTF-WV4D',
+  playerName: 'Bob',
+});
+
+console.log('在游戏里连接:', guest.address);   // 127.0.0.1:25565
+// 此时「局域网世界」里已经出现房间，双击即可进入
+
+// 退出时务必关闭，否则会残留 easytier-core 进程
+await guest.close();
+await host.close();
+```
+
+### Electron 集成
+
+```ts
+import { app, BrowserWindow } from 'electron';
+import { createHostInElectron, manageSessions } from 'mc-tunnel/electron';
+
+const host = await createHostInElectron(app, { mcPort: 25565 });
+
+// 应用退出时自动关闭会话，避免孤儿进程
+manageSessions(app, host);
+```
+
+`electronDefaults()` 会自动把：
+- 设备标识放到 `app.getPath('userData')`
+- EasyTier 目录指向 `process.resourcesPath/easytier`
+
+`electron-builder` 配置示例：
+
+```jsonc
+{
+  "extraResources": [
+    { "from": "vendor/easytier", "to": "easytier" }
+  ]
+}
+```
+
+> ⚠️ 如果使用 ASAR 打包，EasyTier 必须放在 `extraResources`（ASAR 内的可执行文件无法 `spawn`）。
+
+---
+
+## API
+
+### `createHost(options?): Promise<TunnelHost>`
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `roomCode` | `string` | 指定房间码，不传则随机生成 |
+| `mcPort` | `number` | 指定端口；不传则监听局域网广播自动发现 |
+| `playerName` | `string` | 昵称，默认 `Host` |
+| `motd` | `string` | 局域网列表显示名 |
+| `coordPort` | `number` | 协调服务端口，默认 `25991`（双方必须一致） |
+| `listeners` | `string[]` | 额外监听地址，如 `["tcp://0.0.0.0:11010"]` |
+| `peers` | `string[]` | 直连对端，如 `["tcp://1.2.3.4:11010"]` |
+| `scanTimeoutMs` | `number` | 自动发现超时，默认 `30000` |
+| `dataDir` | `string` | 设备标识存储目录 |
+| `easyTier` | `EasyTierOptions` | `{ binDir, publicNodes, p2pOnly }` |
+
+会话属性：`roomCode` `mcPort` `coordPort` `virtualIp` `phase`，方法：`players()` `close()`。
+
+事件：`state` `players` `player-join` `player-leave` `mc-closed` `error`。
+
+### `createGuest(options): Promise<TunnelGuest>`
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `roomCode` | `string` | **必填** |
+| `playerName` | `string` | 昵称，默认 `Guest` |
+| `preferredLocalPort` | `number` | 期望本地端口，默认与房主端口同号 |
+| `peers` | `string[]` | 直连对端，可完全绕开公共节点 |
+| `timeoutMs` | `number` | 建链总超时，默认 `90000` |
+| `dataDir` / `easyTier` | | 同上 |
+
+会话属性：`roomCode` `mcPort` `localPort` `address` `natDifficulty` `phase`，
+方法：`hostPlayers()` `close()`。
+
+事件：`state` `players` `server-status` `error`。
+
+### 工具函数
+
+```ts
+import {
+  generateRoomCode,    // () => string
+  verifyRoomCode,      // (code) => boolean
+  normalizeRoomCode,   // (input) => string | null
+  parseRoomCode,       // (code) => { code, networkName, networkSecret }
+  pingMc,              // (port, host?, timeoutMs?) => Promise<McStatus | null>
+  isPortOpen,          // (port, host?, timeoutMs?) => Promise<boolean>
+  resolveBinaries,     // (binDir?) => { core, cli }
+} from 'mc-tunnel';
+```
+
+---
+
+## 工作原理
+
+```
+房主                                     客人
+────                                     ────
+扫描局域网广播                            ← 房间码解析出网络名/密钥
+    ↓                                        ↓
+EasyTier 固定虚拟 IP 10.144.144.1        EasyTier DHCP 拿 IP
+    ↓                                        ↓
+协调服务 0.0.0.0:25991                   ← 端口映射 127.0.0.1:x → 10.144.144.1:25991
+    ↓                                        ↓
+提供 /v1/session 返回 MC 端口             HTTP 握手校验 + 取端口
+    ↓                                        ↓
+Minecraft 0.0.0.0:25565                  ← 端口映射 TCP/UDP → 10.144.144.1:25565
+                                             ↓
+                                        多播广播「局域网世界」
+```
+
+### 房间码格式（自研）
+
+16 个字符 × 5 bit = 80 bit：
+
+```
+[4 bit 版本][64 bit 随机种子][12 bit CRC]
+```
+
+- 字符集：Crockford Base32（`0-9A-Z` 去掉 `I/L/O/U`）
+- 展示：`XXXX-XXXX-XXXX-XXXX`
+- 输入容错：小写、空格、`MT-` 前缀、`I→1` `L→1` `O→0` `U→V` 自动纠正
+- 网络名/密钥由种子经 **HMAC-SHA256 域分离派生**（`mc-tunnel/v1/*`），房间码本身不含明文凭据
+
+### 协调协议（自研）
+
+HTTP/1.1 + JSON，跑在隧道内：
+
+| 方法 | 路径 | 鉴权 | 说明 |
+|---|---|---|---|
+| GET | `/v1/hello` | 否 | 返回握手指纹，客人据此确认对端身份 |
+| GET | `/v1/session` | 是 | 返回房主 MC 端口与玩家列表 |
+| POST | `/v1/players` | 是 | 玩家心跳 / 昵称上报 |
+
+鉴权用房间码派生的令牌（`x-mct-token`），比较用 `timingSafeEqual`。
+
+---
+
+## 常见问题
+
+**为什么不能把 `127.0.0.1` 写进 `peers`？**
+EasyTier 连接对端时会绑定本地地址，回环地址会报 `10049 AddrNotAvailable`。
+直连请使用真实网卡 IP（可参考 `test/helpers.mjs` 的 `primaryIpv4()`）。
+
+**客人提前退出了房主仍在？**
+房主侧玩家列表 12 秒无心跳自动剔除，不阻塞后续加入。
+
+**端口冲突怎么办？**
+协调服务默认 `25991`，被占用会直接报错（不会静默换端口，否则客人找不到）。
+Minecraft 映射端口优先与房主同号，被占用时自动改用随机端口，功能不受影响，
+但依赖固定 UDP 端口的 mod（如 SimpleVoiceChat）可能需要手动指定 `preferredLocalPort`。
+
+**对称 NAT 连不上？**
+默认 `p2pOnly: true`，不走中继。若需要中继，请自建 EasyTier 公共节点并设置
+`easyTier: { p2pOnly: false, publicNodes: ['tcp://your-node:11010'] }`。
+
+**支持哪些平台？**
+Node.js >= 18.17（使用内置 `fetch` 与 `AbortSignal.timeout`）。Windows / macOS / Linux 均可用。
+
+---
+
+## 开发
+
+```bash
+npm install          # 国内镜像已写入 .npmrc
+npm run build        # 产出 dist/{esm,cjs,types}
+npm test             # node:test，无需额外框架
+```
+
+端到端测试需要 EasyTier 二进制，放到 `test/fixtures/bin/` 或设置
+`MC_TUNNEL_EASYTIER`，缺失时自动跳过。
+
+---
+
+## 合规说明
+
+本包为**独立实现**：
+
+- 房间码编码、校验算法、协调协议、状态机均为本项目原创；
+- 不含任何第三方项目的源代码、常量或协议格式；
+- EasyTier 仅在运行时以**独立子进程**调用（`spawn`），不做静态/动态链接，
+  也不修改其可执行文件。
+
+因此：
+
+- 你可以把本包用于**闭源商业软件**；
+- 本包自身采用 MIT 许可，你可以自由修改、私有化（也可以把 `license` 改成 `UNLICENSED`）；
+- 分发时请遵守 EasyTier 自身的许可要求，详见 `THIRD_PARTY_NOTICES.md`。
+
+---
+
+## 许可
+
+MIT

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,40 @@
+# 第三方组件声明
+
+本包（`mc-tunnel`）自身不包含任何第三方源代码或二进制文件。
+以下组件由使用者自行提供，并在运行时以独立进程方式调用。
+
+---
+
+## EasyTier
+
+- 项目地址：https://github.com/EasyTier/EasyTier
+- 许可：请以你所使用的发行版附带的 `LICENSE` 为准（上游为 Apache-2.0）
+- 使用方式：
+  - 本包通过 `child_process.spawn` 启动 `easytier-core`，
+    通过 `easytier-cli` 的 JSON 输出读取节点信息；
+  - **不做静态或动态链接**，不修改其可执行文件，不重新分发其二进制。
+
+### 你需要做什么
+
+如果你在分发产品时捆绑了 EasyTier 的可执行文件，请：
+
+1. 保留其 `LICENSE` / `NOTICE` 文件（如发行包内有）；
+2. 在产品的「开源许可 / 关于」页面列出 EasyTier 及其许可与项目地址；
+3. 若你对 EasyTier 二进制做了任何修改，需按 Apache-2.0 第 4 条标注修改说明
+   （本包不要求你修改，建议直接使用官方发布版）。
+
+示例文案：
+
+```
+本产品使用 EasyTier 提供 P2P 网络能力。
+EasyTier: https://github.com/EasyTier/EasyTier
+Licensed under the Apache License, Version 2.0.
+```
+
+---
+
+## 关于 Minecraft
+
+本项目实现了 Minecraft 客户端的公开协议行为（局域网多播发现、服务器列表 Ping），
+仅用于本机与玩家之间的连接建立，不包含 Mojang / Microsoft 的任何代码或资源。
+请遵守 Minecraft 最终用户许可协议（EULA）。

package/dist/cjs/constants.js

@@ -0,0 +1,21 @@
+"use strict";
+/** 全局常量。 */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MC_WATCH_INTERVAL_MS = exports.HEARTBEAT_INTERVAL_MS = exports.DEFAULT_MOTD = exports.DEFAULT_COORD_PORT = exports.HOST_VIRTUAL_IP = exports.VERSION = void 0;
+/** 与 package.json 的 version 保持一致（发布前请同步）。 */
+exports.VERSION = '0.1.0';
+/**
+ * 房主在虚拟网络中的固定地址。
+ * 10.144.144.0/24 是 EasyTier 的默认虚拟网段，固定 .1 可以让客人无需任何发现协议
+ * 就能直接找到协调服务——这是本实现相对「编码到 hostname」方案的主要简化。
+ */
+exports.HOST_VIRTUAL_IP = '10.144.144.1';
+/** 协调服务默认端口。房主与客人必须一致。 */
+exports.DEFAULT_COORD_PORT = 25991;
+/** 局域网列表里显示的房间名。 */
+exports.DEFAULT_MOTD = '§b§lMC Tunnel 联机房间（请保持程序运行）';
+/** 客人向房主上报心跳的间隔。 */
+exports.HEARTBEAT_INTERVAL_MS = 5000;
+/** 房主检查 Minecraft 是否存活的间隔。 */
+exports.MC_WATCH_INTERVAL_MS = 5000;
+//# sourceMappingURL=constants.js.map

package/dist/cjs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";AAAA,YAAY;;;AAEZ,6CAA6C;AAChC,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B;;;;GAIG;AACU,QAAA,eAAe,GAAG,cAAc,CAAC;AAE9C,0BAA0B;AACb,QAAA,kBAAkB,GAAG,KAAK,CAAC;AAExC,oBAAoB;AACP,QAAA,YAAY,GAAG,6BAA6B,CAAC;AAE1D,oBAAoB;AACP,QAAA,qBAAqB,GAAG,IAAI,CAAC;AAE1C,8BAA8B;AACjB,QAAA,oBAAoB,GAAG,IAAI,CAAC"}

package/dist/cjs/coord.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoordClient = exports.CoordServer = exports.COORD_TOKEN_HEADER = exports.COORD_PROTOCOL_VERSION = void 0;
+/**
+ * 房主侧协调服务（跑在隧道内，客人通过端口映射访问）。
+ *
+ * 协议：HTTP/1.1 + JSON，全部为本包自定义，与任何既有项目无关。
+ *
+ *   GET  /v1/hello    公开接口，返回握手探针，客人据此确认对端身份
+ *   GET  /v1/session  需要令牌，返回房主的 Minecraft 端口与玩家列表
+ *   POST /v1/players  需要令牌，客人上报心跳 / 昵称
+ *
+ * 之所以选 HTTP/JSON 而不是自定义二进制帧：调试成本低（curl 就能测），
+ * 而且 Node 内置 http 模块足够，不需要引入任何依赖。
+ */
+const node_http_1 = require("node:http");
+const node_events_1 = require("node:events");
+const room_code_js_1 = require("./room-code.js");
+exports.COORD_PROTOCOL_VERSION = 1;
+exports.COORD_TOKEN_HEADER = 'x-mct-token';
+/** 客人心跳间隔的 2 倍仍没消息就从列表里剔除 */
+const PLAYER_TIMEOUT_MS = 12000;
+const BODY_LIMIT = 4096;
+function readBody(request) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        request.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > BODY_LIMIT) {
+                reject(new Error('Body too large'));
+                request.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        request.on('error', reject);
+    });
+}
+function sendJson(response, status, data) {
+    const body = Buffer.from(JSON.stringify(data), 'utf8');
+    response.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': body.length,
+        'cache-control': 'no-store',
+    });
+    response.end(body);
+}
+class CoordServer extends node_events_1.EventEmitter {
+    options;
+    playerTimeoutMs;
+    server;
+    players = new Map();
+    pruneTimer;
+    constructor(options) {
+        super();
+        this.options = options;
+        this.playerTimeoutMs = options.playerTimeoutMs ?? PLAYER_TIMEOUT_MS;
+    }
+    static async start(options) {
+        const instance = new CoordServer(options);
+        instance.players.set(options.hostId, {
+            id: options.hostId,
+            name: options.hostName,
+            role: 'host',
+            lastSeen: Date.now(),
+        });
+        const server = (0, node_http_1.createServer)((request, response) => {
+            instance.handle(request, response).catch(() => {
+                if (!response.headersSent) {
+                    sendJson(response, 500, { error: 'internal' });
+                }
+            });
+        });
+        await new Promise((resolve, reject) => {
+            server.once('error', (error) => {
+                reject(error.code === 'EADDRINUSE'
+                    ? new Error(`Coord port ${options.port} is already in use`)
+                    : error);
+            });
+            server.listen(options.port, '0.0.0.0', () => resolve());
+        });
+        instance.server = server;
+        // 剔除周期跟着超时走，避免超时很短时仍要等 4 秒
+        const sweep = Math.max(200, Math.min(4000, Math.floor(instance.playerTimeoutMs / 2)));
+        instance.pruneTimer = setInterval(() => instance.prune(), sweep);
+        instance.pruneTimer.unref?.();
+        return instance;
+    }
+    prune() {
+        const now = Date.now();
+        let changed = false;
+        for (const [id, record] of this.players) {
+            if (record.role === 'host') {
+                continue;
+            }
+            if (now - record.lastSeen > this.playerTimeoutMs) {
+                this.players.delete(id);
+                changed = true;
+                this.emit('player-leave', { id: record.id, name: record.name });
+            }
+        }
+        if (changed) {
+            this.emit('players', this.list());
+        }
+    }
+    list() {
+        return [...this.players.values()]
+            .map(({ id, name, role }) => ({ id, name, role }))
+            .sort((a, b) => (a.role === b.role ? a.id.localeCompare(b.id) : a.role === 'host' ? -1 : 1));
+    }
+    authorized(request) {
+        const header = request.headers[exports.COORD_TOKEN_HEADER];
+        const token = Array.isArray(header) ? header[0] : header;
+        return typeof token === 'string' && (0, room_code_js_1.safeEqual)(token, this.options.token);
+    }
+    async handle(request, response) {
+        const url = new URL(request.url ?? '/', 'http://localhost');
+        if (request.method === 'GET' && url.pathname === '/v1/hello') {
+            sendJson(response, 200, {
+                app: 'mc-tunnel',
+                protocol: exports.COORD_PROTOCOL_VERSION,
+                probe: this.options.probe,
+            });
+            return;
+        }
+        if (!this.authorized(request)) {
+            sendJson(response, 401, { error: 'unauthorized' });
+            return;
+        }
+        if (request.method === 'GET' && url.pathname === '/v1/session') {
+            sendJson(response, 200, {
+                room: this.options.roomCode,
+                mcPort: this.options.mcPort,
+                host: { id: this.options.hostId, name: this.options.hostName },
+                players: this.list(),
+            });
+            return;
+        }
+        if (request.method === 'POST' && url.pathname === '/v1/players') {
+            const raw = await readBody(request);
+            let body;
+            try {
+                body = JSON.parse(raw);
+            }
+            catch {
+                sendJson(response, 400, { error: 'bad-json' });
+                return;
+            }
+            const id = typeof body.id === 'string' ? body.id.trim() : '';
+            const name = typeof body.name === 'string' ? body.name.trim().slice(0, 32) : '';
+            if (!/^[0-9a-z]{8,64}$/i.test(id) || name.length === 0) {
+                sendJson(response, 400, { error: 'bad-player' });
+                return;
+            }
+            const existing = this.players.get(id);
+            if (existing && existing.role === 'host') {
+                sendJson(response, 409, { error: 'id-conflict' });
+                return;
+            }
+            const isNew = existing === undefined;
+            this.players.set(id, {
+                id,
+                name,
+                role: 'guest',
+                lastSeen: Date.now(),
+            });
+            if (isNew) {
+                this.emit('player-join', { id, name });
+                this.emit('players', this.list());
+            }
+            sendJson(response, 200, { players: this.list() });
+            return;
+        }
+        sendJson(response, 404, { error: 'not-found' });
+    }
+    get port() {
+        return this.options.port;
+    }
+    async stop() {
+        if (this.pruneTimer) {
+            clearInterval(this.pruneTimer);
+            this.pruneTimer = undefined;
+        }
+        const server = this.server;
+        if (!server) {
+            return;
+        }
+        this.server = undefined;
+        await new Promise((resolve) => {
+            server.close(() => resolve());
+            // 关闭后不再处理新连接，已在途连接由 Node 自行收尾
+            server.closeAllConnections?.();
+        });
+    }
+}
+exports.CoordServer = CoordServer;
+/** 客人侧客户端。 */
+class CoordClient {
+    base;
+    token;
+    constructor(base, token) {
+        this.base = base.replace(/\/$/, '');
+        this.token = token;
+    }
+    async request(path, init, timeoutMs = 5000) {
+        return fetch(`${this.base}${path}`, {
+            ...init,
+            headers: { ...(init?.headers ?? {}) },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    async hello() {
+        const response = await this.request('/v1/hello');
+        if (!response.ok) {
+            throw new Error(`hello failed: HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+    async session() {
+        const response = await this.request('/v1/session', {
+            headers: { [exports.COORD_TOKEN_HEADER]: this.token },
+        });
+        if (!response.ok) {
+            throw new Error(`session failed: HTTP ${response.status}`);
+        }
+        return (await response.json());
+    }
+    async heartbeat(id, name) {
+        const response = await this.request('/v1/players', {
+            method: 'POST',
+            headers: { [exports.COORD_TOKEN_HEADER]: this.token, 'content-type': 'application/json' },
+            body: JSON.stringify({ id, name }),
+        });
+        if (!response.ok) {
+            throw new Error(`heartbeat failed: HTTP ${response.status}`);
+        }
+        const data = (await response.json());
+        return data.players;
+    }
+}
+exports.CoordClient = CoordClient;
+//# sourceMappingURL=coord.js.map

package/dist/cjs/coord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coord.js","sourceRoot":"","sources":["../../src/coord.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;GAWG;AACH,yCAAiG;AACjG,6CAA2C;AAC3C,iDAA2C;AAG9B,QAAA,sBAAsB,GAAG,CAAC,CAAC;AAC3B,QAAA,kBAAkB,GAAG,aAAa,CAAC;AAChD,6BAA6B;AAC7B,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,UAAU,GAAG,IAAI,CAAC;AAmBxB,SAAS,QAAQ,CAAC,OAAwB;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QAEb,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACnC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC;YAErB,IAAI,IAAI,GAAG,UAAU,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBACpC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAClB,OAAO;YACT,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,QAAQ,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAa;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IAEvD,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,iCAAiC;QACjD,gBAAgB,EAAE,IAAI,CAAC,MAAM;QAC7B,eAAe,EAAE,UAAU;KAC5B,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC;AAED,MAAa,WAAY,SAAQ,0BAAY;IAC1B,OAAO,CAAqB;IAC5B,eAAe,CAAS;IACjC,MAAM,CAAU;IACP,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IACnD,UAAU,CAAkB;IAEpC,YAAoB,OAA2B;QAC7C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,iBAAiB,CAAC;IACtE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAA2B;QAC5C,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;QAE1C,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE;YACnC,EAAE,EAAE,OAAO,CAAC,MAAM;YAClB,IAAI,EAAE,OAAO,CAAC,QAAQ;YACtB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;SACrB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YAChD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC5C,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;oBAC1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;gBACjD,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAA4B,EAAE,EAAE;gBACpD,MAAM,CACJ,KAAK,CAAC,IAAI,KAAK,YAAY;oBACzB,CAAC,CAAC,IAAI,KAAK,CAAC,cAAc,OAAO,CAAC,IAAI,oBAAoB,CAAC;oBAC3D,CAAC,CAAC,KAAK,CACV,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,2BAA2B;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtF,QAAQ,CAAC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC;QACjE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;QAE9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK;QACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC3B,SAAS;YACX,CAAC;YAED,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;gBACjD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,OAAO,GAAG,IAAI,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,CAAC;IAEO,UAAU,CAAC,OAAwB;QACzC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,0BAAkB,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAEzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAA,wBAAS,EAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3E,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAwB,EAAE,QAAwB;QACrE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,kBAAkB,CAAC,CAAC;QAE5D,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC7D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,GAAG,EAAE,WAAW;gBAChB,QAAQ,EAAE,8BAAsB;gBAChC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;aAC1B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC/D,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACtB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAC3B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;gBAC3B,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAC9D,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;aACrB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAChE,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;YAEpC,IAAI,IAAsC,CAAC;YAE3C,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqC,CAAC;YAC7D,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC/C,OAAO;YACT,CAAC;YAED,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhF,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAEtC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,KAAK,SAAS,CAAC;YAErC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE;gBACnB,EAAE;gBACF,IAAI;gBACJ,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;aACrB,CAAC,CAAC;YAEH,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;YAED,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QAExB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9B,8BAA8B;YAC9B,MAAM,CAAC,mBAAmB,EAAE,EAAE,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAzLD,kCAyLC;AASD,cAAc;AACd,MAAa,WAAW;IACL,IAAI,CAAS;IACb,KAAK,CAAS;IAE/B,YAAY,IAAY,EAAE,KAAa;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAkB,EAAE,SAAS,GAAG,IAAI;QACtE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE;YAClC,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,EAAE;YACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEjD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;YACjD,OAAO,EAAE,EAAE,CAAC,0BAAkB,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE;SAC9C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,EAAU,EAAE,IAAY;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,CAAC,0BAAkB,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE;YACjF,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AArDD,kCAqDC"}