@mebular/core 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Windsander
+
+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,156 @@
-# Temporary Holding Version
+<div align="center">
 
-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.
+<picture>
+  <source media="(prefers-color-scheme: light)" srcset="assets/banner-light.svg">
+  <img src="assets/banner.svg" alt="Mebular">
+</picture>
+
+**One memory. Every assistant. Every device.**
+
+A distributed memory network for your AI assistants.<br>
+Memory and tasks stay on your devices; devices sync directly.
+
+[![CI](https://github.com/Windsander/Mebular/actions/workflows/ci.yml/badge.svg?style=flat-square)](https://github.com/Windsander/Mebular/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE) [![Node.js >=20](https://img.shields.io/badge/Node-%E2%89%A520-339933?logo=node.js&logoColor=white&style=flat-square)](docs/getting-started/QUICKSTART.md) [![MCP](https://img.shields.io/badge/MCP-5A67D8?style=flat-square)](docs/getting-started/QUICKSTART.md)
+
+[Start in 5 minutes](docs/getting-started/QUICKSTART.md) · [How it works](docs/architecture/ARCHITECT.md) · [Website](https://mebular.cyberfederal.io) · [中文](README_CN.md)
+
+<sub>No hosted account · No central coordinator</sub>
+
+</div>
+
+---
+
+<p align="center">
+  <img src="assets/star-map-baseline-en.jpg" width="49%" alt="Star map baseline: the device network before hovering">
+  <img src="assets/star-map-lanes-en.jpg" width="49%" alt="Task lanes and a fleet event: blue can send, gold can receive, gray unreachable">
+</p>
+<p align="center"><sub>The map at rest: devices and their shared-subscription edges. · On hover: task-domain lanes plus live fleet traffic.<br>Blue and gold show this device's two-way task-domain reachability, not peer-to-peer links.</sub></p>
+
+## One memory
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="assets/one-graph-en-light.svg">
+    <img src="assets/one-graph-en.svg" alt="Why Mebular: one shared graph instead of a silo; local-first, direct sync, auditable, MCP">
+  </picture>
+</p>
+
+## Get started
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="assets/desktop-steps-en-light.svg">
+    <img src="assets/desktop-steps-en.svg" alt="Desktop app setup: 1 Start deployment, 2 Create or join a Cloud, 3 Invite the next device">
+  </picture>
+</p>
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="assets/other-paths-en-light.svg">
+    <img src="assets/other-paths-en.svg" alt="Other ways to start: Browser, CLI and Agent, all sharing one graph">
+  </picture>
+</p>
+
+**Desktop app (v0.1.0, unsigned).** [Download from GitHub Releases](https://github.com/Windsander/Mebular/releases/tag/v0.1.0): macOS Universal DMG, Windows x64 NSIS, Linux x64 AppImage and deb. Verify every file against `SHA256SUMS.txt` first. macOS needs right-click → **Open** (or Privacy & Security → **Open Anyway**); Windows SmartScreen needs **More info → Run anyway**. The app bundles Electron and its runtime, so it needs no local Node.js.
+
+**Or install the CLI and server:**
+
+```bash
+npm install -g @mebular/core
+mebular serve                                  # browser console
+fleet quickstart --daemon                      # CLI start
+mebular print-config --client opencode         # MCP config
+```
+
+## How it works
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="assets/network-overview-en-light.svg">
+    <img src="assets/network-overview-en.svg" alt="Mebular network overview: each machine runs one node; nodes sync memory and tasks directly; add devices with a QR code or token">
+  </picture>
+</p>
+
+<p align="center"><sub>Write with <code>memory_write</code>, hand off with <code>task_submit</code> — the same graph, from any assistant.</sub></p>
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: light)" srcset="assets/pairing-flow-en-light.svg">
+    <img src="assets/pairing-flow-en.svg" alt="Pairing flow: device A invites, device B joins with the QR code or token, then connection and the default grant happen automatically">
+  </picture>
+</p>
+
+## Docs
+
+<table width="100%">
+  <thead>
+    <tr>
+      <th align="left">Start</th>
+      <th align="left">Learn</th>
+      <th align="left">Run</th>
+      <th align="left">Trust</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td><strong><a href="docs/getting-started/QUICKSTART.md">Quickstart</a></strong><br><sub>Install &amp; pair</sub></td>
+      <td><strong><a href="docs/architecture/ARCHITECT.md">Architecture</a></strong><br><sub>Nodes &amp; sync</sub></td>
+      <td><strong><a href="docs/console/README.md">Console</a></strong><br><sub>Local GUI</sub></td>
+      <td><strong><a href="docs/limitations/LIMITATIONS.md">Limitations</a></strong><br><sub>Sensitive data</sub></td>
+    </tr>
+    <tr>
+      <td><strong><a href="packages/skill/SETUP.md">Agent skills</a></strong><br><sub>Setup playbooks</sub></td>
+      <td><strong><a href="packages/fleet/RUNBOOK.md">Fleet ops</a></strong><br><sub>Multi-machine</sub></td>
+      <td><strong><a href="docs/operations/RELEASE.md">Release SOP</a></strong><br><sub>Release steps</sub></td>
+      <td><strong><a href="SEALING.md">Sealing docs</a></strong><br><sub>Protocol rules</sub></td>
+    </tr>
+    <tr>
+      <td><strong><a href="CHANGELOG.md">Changelog</a></strong><br><sub>Release notes</sub></td>
+      <td><strong><a href="CONTRIBUTING.md">Contributing</a></strong><br><sub>Quality gates</sub></td>
+      <td><strong><a href="SECURITY.md">Security</a></strong><br><sub>Report a vuln</sub></td>
+      <td><strong><a href="https://mebular.cyberfederal.io">Website</a></strong><br><sub>Product site</sub></td>
+    </tr>
+  </tbody>
+</table>
+
+<p align="center"><strong>Use with DSH</strong><br>
+Keep the Mebular app running, then install the plugin from npm into DSH's web profile:<br>
+<code>dsh plugin --profile web add @mebular/dsh-plugin@0.1.0</code><br>
+A Mebular sidebar panel embeds the same Console through <code>?embed=dsh</code> (loopback only), and the official MCP client reaches the same graph. The plugin discovers the daemon by <code>daemonUrl &gt; MEBULAR_HTTP_PORT &gt; runtime.json &gt; 7331</code>, so custom ports follow automatically. It has its own version line and is not part of the five-package lockstep. For plugin development, install from <code>packages/dsh-plugin</code> instead.<br>
+<a href="packages/dsh-plugin/README.md">DSH plugin guide →</a> · <a href="docs/integrations/DSH.md">Integration notes →</a></p>
+
+<details>
+<summary>Who does what</summary>
+
+| Who | Handles |
+|---|---|
+| **You** | One-time pairing, Cloud choice, invites, subscriptions. |
+| **Your assistant** | Memory reads and writes, task claim and completion. |
+| **Mebular** | Discovery, direct / relay / hole-punch, retries, certificates, service autostart. |
+
+</details>
+
+<details>
+<summary>Use it from code</summary>
+
+```ts
+import { Mebular } from 'mebular';
+
+const mebular = new Mebular({
+  storagePath: './store.jsonl',
+  deviceId: 'device-a',
+  network: { enabled: false },
+});
+
+await mebular.initialize();
+```
+
+Runnable examples: [`examples/quickstart`](examples/quickstart/index.mjs) writes and recalls a preference; [`examples/two-devices`](examples/two-devices/index.mjs) demonstrates offline sync.
+
+</details>
+
+<div align="center">
+
+v0.1.0 · early · MIT
+
+</div>

package/dist/core/GraphStore.d.ts

@@ -0,0 +1,54 @@
+import type { StorageAdapter } from '../storage/StorageAdapter.js';
+import type { Node, Edge, NodeFilter, EdgeFilter, TraverseOptions, TraverseResult } from '../types/index.js';
+import type { EventLog } from '../eventlog/EventLog.js';
+export interface GraphStoreConfig {
+    storage: StorageAdapter;
+    author: string;
+    /** 配置后，所有图变更自动写入带签名的事件日志（Phase 3 同步的前提） */
+    eventLog?: EventLog;
+}
+export declare class GraphStore {
+    private storage;
+    private author;
+    private clock;
+    private eventLog?;
+    constructor(config: GraphStoreConfig);
+    createNode(type: string, content: Record<string, unknown>, labels?: string[], options?: {
+        validFrom?: number;
+        validTo?: number;
+        namespace?: string;
+    }): Promise<Node>;
+    updateNode(id: string, updates: Partial<Node>): Promise<Node | null>;
+    deleteNode(id: string): Promise<boolean>;
+    getNode(id: string): Promise<Node | null>;
+    listNodes(filter?: NodeFilter): Promise<Node[]>;
+    createEdge(source: string, target: string, relation: string, labels?: string[], options?: {
+        namespace?: string;
+    }): Promise<Edge>;
+    updateEdge(id: string, updates: Partial<Edge>): Promise<Edge | null>;
+    deleteEdge(id: string): Promise<boolean>;
+    /** 为节点添加标签（spec-003 AddTag；幂等） */
+    addTag(nodeId: string, tag: string): Promise<Node | null>;
+    /** 移除节点标签（spec-003 RemoveTag；幂等） */
+    removeTag(nodeId: string, tag: string): Promise<Node | null>;
+    getEdge(id: string): Promise<Edge | null>;
+    listEdges(filter?: EdgeFilter): Promise<Edge[]>;
+    getNeighbors(nodeId: string, direction?: 'incoming' | 'outgoing' | 'both'): Promise<Edge[]>;
+    /**
+     * 图遍历（spec-004 TraverseOptions）：从起点 BFS，
+     * 支持深度/边类型/方向/删除过滤，visited 集合防环。
+     */
+    traverse(startId: string, options?: TraverseOptions): Promise<TraverseResult>;
+    batchAddNodes(nodes: Array<{
+        type: string;
+        content: Record<string, unknown>;
+        labels?: string[];
+    }>): Promise<Node[]>;
+    batchAddEdges(edges: Array<{
+        source: string;
+        target: string;
+        relation: string;
+        labels?: string[];
+    }>): Promise<Edge[]>;
+}
+//# sourceMappingURL=GraphStore.d.ts.map

package/dist/core/GraphStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphStore.d.ts","sourceRoot":"","sources":["../../src/core/GraphStore.ts"],"names":[],"mappings":"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"}

package/dist/core/GraphStore.js

@@ -0,0 +1,374 @@
+// GraphStore - 图存储核心实现
+//
+// 签名语义（D11，Phase 6.0 收口）：实体不逐条签名（signature 字段保留
+// 为空串），真实性由事件日志的内容寻址 ID + 事件级签名承载（Phase 3+）。
+// 旧版 signatureManager 缝隙与 snapshot()/merge() 遗留已移除。
+import { VectorClock } from '../sync/index.js';
+import { matchesNamespace, normalizeNamespace } from './namespace.js';
+import { ulid } from 'ulid';
+export class GraphStore {
+    storage;
+    author;
+    clock;
+    eventLog;
+    constructor(config) {
+        this.storage = config.storage;
+        this.author = config.author;
+        this.clock = new VectorClock();
+        this.eventLog = config.eventLog;
+    }
+    async createNode(type, content, labels, options) {
+        const now = Date.now();
+        const node = {
+            id: ulid(),
+            type,
+            content,
+            labels: labels || [],
+            createdBy: this.author,
+            signature: '',
+            createdAt: now,
+            updatedAt: now,
+            validFrom: options?.validFrom ?? now,
+            validTo: options?.validTo ?? 9999999999999,
+            tags: [],
+            namespace: normalizeNamespace(options?.namespace),
+        };
+        this.clock.increment(this.author);
+        node.clocks = this.clock.toJSON();
+        node.vectorClock = this.clock.toJSON();
+        // 单一时钟源（D10 收口）：事件日志存在时，实体时钟以事件时钟为准；
+        // 载荷用快照拷贝，避免随后的时钟盖写突变已被内容寻址的事件内容
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'node_created',
+                data: { node: { ...node } },
+                namespace: node.namespace,
+            });
+            node.clocks = { ...event.vectorClock };
+            node.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putNode(node);
+        return node;
+    }
+    async updateNode(id, updates) {
+        const existing = await this.storage.getNode(id);
+        if (!existing) {
+            return null;
+        }
+        const now = Date.now();
+        const updated = {
+            ...existing,
+            ...updates,
+            id,
+            updatedAt: now,
+            updatedBy: this.author,
+            createdAt: existing.createdAt,
+            validFrom: existing.validFrom,
+            validTo: existing.validTo,
+            tags: existing.tags,
+            vectorClock: this.clock.toJSON(),
+        };
+        this.clock.increment(this.author);
+        updated.clocks = this.clock.toJSON();
+        updated.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'node_updated',
+                data: { nodeId: id, newVersion: { ...updated } },
+                namespace: updated.namespace,
+            });
+            updated.clocks = { ...event.vectorClock };
+            updated.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putNode(updated);
+        return updated;
+    }
+    async deleteNode(id) {
+        const existing = await this.storage.getNode(id);
+        if (!existing) {
+            return false;
+        }
+        const now = Date.now();
+        const deleted = {
+            ...existing,
+            deletedAt: now,
+            deletedBy: this.author,
+            validTo: now,
+            updatedAt: now,
+        };
+        this.clock.increment(this.author);
+        deleted.clocks = this.clock.toJSON();
+        deleted.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'node_deleted',
+                data: { nodeId: id, deletionTime: now },
+                namespace: deleted.namespace,
+            });
+            deleted.clocks = { ...event.vectorClock };
+            deleted.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putNode(deleted);
+        return true;
+    }
+    async getNode(id) {
+        return this.storage.getNode(id);
+    }
+    async listNodes(filter) {
+        return this.storage.listNodes(filter || {});
+    }
+    async createEdge(source, target, relation, labels, options) {
+        const now = Date.now();
+        // 边归属其源节点分区（未指定时）：保证边事件与快照按分区裁剪时一致
+        const sourceNode = await this.storage.getNode(source);
+        const namespace = normalizeNamespace(options?.namespace ?? sourceNode?.namespace);
+        const edge = {
+            id: ulid(),
+            type: 'edge',
+            source,
+            target,
+            relation,
+            createdBy: this.author,
+            signature: '',
+            createdAt: now,
+            updatedAt: now,
+            labels: labels || [],
+            validFrom: now,
+            validTo: 9999999999999,
+            namespace,
+        };
+        this.clock.increment(this.author);
+        edge.clocks = this.clock.toJSON();
+        edge.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'edge_created',
+                data: { edge: { ...edge } },
+                namespace: edge.namespace,
+            });
+            edge.clocks = { ...event.vectorClock };
+            edge.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putEdge(edge);
+        return edge;
+    }
+    async updateEdge(id, updates) {
+        const existing = await this.storage.getEdge(id);
+        if (!existing) {
+            return null;
+        }
+        const now = Date.now();
+        const updated = {
+            ...existing,
+            ...updates,
+            id,
+            updatedAt: now,
+            updatedBy: this.author,
+            createdAt: existing.createdAt,
+            validFrom: existing.validFrom,
+            validTo: existing.validTo,
+            vectorClock: this.clock.toJSON(),
+        };
+        this.clock.increment(this.author);
+        updated.clocks = this.clock.toJSON();
+        updated.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'edge_updated',
+                data: { edgeId: id, newVersion: { ...updated } },
+                namespace: updated.namespace,
+            });
+            updated.clocks = { ...event.vectorClock };
+            updated.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putEdge(updated);
+        return updated;
+    }
+    async deleteEdge(id) {
+        const existing = await this.storage.getEdge(id);
+        if (!existing) {
+            return false;
+        }
+        const now = Date.now();
+        const deleted = {
+            ...existing,
+            deletedAt: now,
+            deletedBy: this.author,
+            validTo: now,
+            updatedAt: now,
+        };
+        this.clock.increment(this.author);
+        deleted.clocks = this.clock.toJSON();
+        deleted.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'edge_deleted',
+                data: { edgeId: id, deletionTime: now },
+                namespace: deleted.namespace,
+            });
+            deleted.clocks = { ...event.vectorClock };
+            deleted.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putEdge(deleted);
+        return true;
+    }
+    /** 为节点添加标签（spec-003 AddTag；幂等） */
+    async addTag(nodeId, tag) {
+        const existing = await this.storage.getNode(nodeId);
+        if (!existing) {
+            return null;
+        }
+        if ((existing.tags ?? []).includes(tag)) {
+            return existing;
+        }
+        const now = Date.now();
+        const updated = {
+            ...existing,
+            tags: [...(existing.tags ?? []), tag],
+            updatedAt: now,
+            updatedBy: this.author,
+        };
+        this.clock.increment(this.author);
+        updated.clocks = this.clock.toJSON();
+        updated.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'tag_added',
+                data: { nodeId, tag },
+                namespace: updated.namespace,
+            });
+            updated.clocks = { ...event.vectorClock };
+            updated.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putNode(updated);
+        return updated;
+    }
+    /** 移除节点标签（spec-003 RemoveTag；幂等） */
+    async removeTag(nodeId, tag) {
+        const existing = await this.storage.getNode(nodeId);
+        if (!existing) {
+            return null;
+        }
+        if (!(existing.tags ?? []).includes(tag)) {
+            return existing;
+        }
+        const now = Date.now();
+        const updated = {
+            ...existing,
+            tags: (existing.tags ?? []).filter((t) => t !== tag),
+            updatedAt: now,
+            updatedBy: this.author,
+        };
+        this.clock.increment(this.author);
+        updated.clocks = this.clock.toJSON();
+        updated.vectorClock = this.clock.toJSON();
+        if (this.eventLog) {
+            const event = await this.eventLog.append({
+                type: 'tag_removed',
+                data: { nodeId, tag },
+                namespace: updated.namespace,
+            });
+            updated.clocks = { ...event.vectorClock };
+            updated.vectorClock = { ...event.vectorClock };
+        }
+        await this.storage.putNode(updated);
+        return updated;
+    }
+    async getEdge(id) {
+        return this.storage.getEdge(id);
+    }
+    async listEdges(filter) {
+        return this.storage.listEdges(filter || {});
+    }
+    async getNeighbors(nodeId, direction) {
+        const filter = { limit: 100 };
+        if (direction === 'incoming') {
+            filter.target = nodeId;
+        }
+        else if (direction === 'outgoing') {
+            filter.source = nodeId;
+        }
+        else {
+            const incoming = await this.storage.listEdges({ target: nodeId });
+            const outgoing = await this.storage.listEdges({ source: nodeId });
+            return [...incoming, ...outgoing];
+        }
+        return this.storage.listEdges(filter);
+    }
+    /**
+     * 图遍历（spec-004 TraverseOptions）：从起点 BFS，
+     * 支持深度/边类型/方向/删除过滤，visited 集合防环。
+     */
+    async traverse(startId, options = {}) {
+        const maxDepth = options.maxDepth ?? 3;
+        const direction = options.direction ?? 'both';
+        const includeDeleted = options.includeDeleted ?? false;
+        const visited = options.visited ?? new Set();
+        // 分区隔离：指定 namespace 时，起点、邻居与边都必须落在该分区内
+        const namespaceFilter = options.namespace;
+        const result = { visitedNodes: [], visitedEdges: [], path: [] };
+        const start = await this.storage.getNode(startId);
+        if (!start ||
+            (!includeDeleted && start.deletedAt) ||
+            !matchesNamespace(start.namespace, namespaceFilter) ||
+            visited.has(startId)) {
+            return result;
+        }
+        visited.add(startId);
+        result.visitedNodes.push(start);
+        result.path.push({ nodeId: startId });
+        let frontier = [{ nodeId: startId, depth: 0 }];
+        while (frontier.length > 0) {
+            const next = [];
+            for (const { nodeId, depth } of frontier) {
+                if (depth >= maxDepth) {
+                    continue;
+                }
+                const edges = await this.getNeighbors(nodeId, direction);
+                for (const edge of edges) {
+                    if (!includeDeleted && edge.deletedAt) {
+                        continue;
+                    }
+                    if (options.edgeTypes && !options.edgeTypes.includes(edge.relation)) {
+                        continue;
+                    }
+                    if (!matchesNamespace(edge.namespace, namespaceFilter)) {
+                        continue;
+                    }
+                    const otherId = edge.source === nodeId ? edge.target : edge.source;
+                    if (visited.has(otherId)) {
+                        continue;
+                    }
+                    const other = await this.storage.getNode(otherId);
+                    if (!other || (!includeDeleted && other.deletedAt) || !matchesNamespace(other.namespace, namespaceFilter)) {
+                        continue;
+                    }
+                    visited.add(otherId);
+                    result.visitedEdges.push(edge);
+                    result.visitedNodes.push(other);
+                    result.path.push({ nodeId: otherId, edgeId: edge.id });
+                    next.push({ nodeId: otherId, depth: depth + 1 });
+                }
+            }
+            frontier = next;
+        }
+        return result;
+    }
+    async batchAddNodes(nodes) {
+        const created = [];
+        for (const nodeData of nodes) {
+            const node = await this.createNode(nodeData.type, nodeData.content, nodeData.labels);
+            created.push(node);
+        }
+        return created;
+    }
+    async batchAddEdges(edges) {
+        const created = [];
+        for (const edgeData of edges) {
+            const edge = await this.createEdge(edgeData.source, edgeData.target, edgeData.relation, edgeData.labels);
+            created.push(edge);
+        }
+        return created;
+    }
+}
+//# sourceMappingURL=GraphStore.js.map

package/dist/core/GraphStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphStore.js","sourceRoot":"","sources":["../../src/core/GraphStore.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,gDAAgD;AAChD,6CAA6C;AAC7C,oDAAoD;AAKpD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAS5B,MAAM,OAAO,UAAU;IACb,OAAO,CAAiB;IACxB,MAAM,CAAS;IACf,KAAK,CAAc;IACnB,QAAQ,CAAY;IAE5B,YAAY,MAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAY,EACZ,OAAgC,EAChC,MAAiB,EACjB,OAAsE;QAEtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,IAAI,EAAE;YACV,IAAI;YACJ,OAAO;YACP,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,GAAG;YACpC,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,aAAa;YAC1C,IAAI,EAAE,EAAE;YACR,SAAS,EAAE,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC;SAClD,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEvC,qCAAqC;QACrC,iCAAiC;QACjC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,OAAsB;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG;YACd,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,EAAE;YACF,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;SACjC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE;gBAChD,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG;YACd,GAAG,QAAQ;YACX,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;gBACvC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,UAAU,CACd,MAAc,EACd,MAAc,EACd,QAAgB,EAChB,MAAiB,EACjB,OAAgC;QAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,mCAAmC;QACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,SAAS,CAAC,CAAC;QAClF,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,IAAI,EAAE;YACV,IAAI,EAAE,MAAM;YACZ,MAAM;YACN,MAAM;YACN,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,aAAa;YACtB,SAAS;SACV,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAEvC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE;gBAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,OAAsB;QACjD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG;YACd,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,EAAE;YACF,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;SACjC,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE;gBAChD,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG;YACd,GAAG,QAAQ;YACX,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,CAAC,MAAM;YACtB,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;gBACvC,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,GAAW;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAS;YACpB,GAAG,QAAQ;YACX,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC;YACrC,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,CAAC,MAAM;SACvB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;gBACrB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,GAAW;QACzC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAS;YACpB,GAAG,QAAQ;YACX,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC;YACpD,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,CAAC,MAAM;SACvB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACvC,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE;gBACrB,SAAS,EAAE,OAAO,CAAC,SAAS;aAC7B,CAAC,CAAC;YACH,OAAO,CAAC,MAAM,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,OAAO,CAAC,WAAW,GAAG,EAAE,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACjD,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAmB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,SAA4C;QAC7E,MAAM,MAAM,GAAe,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1C,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,UAA2B,EAAE;QAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;QAC9C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC;QACvD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,GAAG,EAAU,CAAC;QACrD,uCAAuC;QACvC,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;QAE1C,MAAM,MAAM,GAAmB,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAEhF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,IACE,CAAC,KAAK;YACN,CAAC,CAAC,cAAc,IAAI,KAAK,CAAC,SAAS,CAAC;YACpC,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,eAAe,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EACpB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAEtC,IAAI,QAAQ,GAA6C,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACzF,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,GAA6C,EAAE,CAAC;YAC1D,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,QAAQ,EAAE,CAAC;gBACzC,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACtB,SAAS;gBACX,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;wBACtC,SAAS;oBACX,CAAC;oBACD,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACpE,SAAS;oBACX,CAAC;oBACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC;wBACvD,SAAS;oBACX,CAAC;oBACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;oBACnE,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;wBACzB,SAAS;oBACX,CAAC;oBACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAClD,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,cAAc,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC;wBAC1G,SAAS;oBACX,CAAC;oBACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACrB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC/B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACvD,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAmF;QACrG,MAAM,OAAO,GAAW,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAAqF;QACvG,MAAM,OAAO,GAAW,EAAE,CAAC;QAC3B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;YACzG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/core/displayName.d.ts

@@ -0,0 +1,5 @@
+/** 规范化展示名；无效返回 null（调用方决定拒绝写入还是忽略事件）。 */
+export declare function normalizeDisplayName(raw: unknown): string | null;
+/** 展示名是否合法（不改变输入）。 */
+export declare function isValidDisplayName(raw: unknown): boolean;
+//# sourceMappingURL=displayName.d.ts.map

package/dist/core/displayName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayName.d.ts","sourceRoot":"","sources":["../../src/core/displayName.ts"],"names":[],"mappings":"AAYA,yCAAyC;AACzC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAOhE;AAED,sBAAsB;AACtB,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAExD"}