@remnic/core 1.0.0

package/dist/chunk-ZPKBYX2F.js

@@ -0,0 +1,297 @@
+import {
+  diffGraphSnapshots
+} from "./chunk-3SLRNYNG.js";
+import {
+  graphSnapshotFromMemoryDir
+} from "./chunk-LIRZNNUP.js";
+
+// src/dashboard-runtime.ts
+import { createHash } from "crypto";
+import { createServer } from "http";
+import { watch } from "fs";
+import { readFile } from "fs/promises";
+import path from "path";
+var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "::1"]);
+function normalizeOriginHostname(hostname) {
+  if (hostname.startsWith("[") && hostname.endsWith("]")) {
+    return hostname.slice(1, -1);
+  }
+  return hostname;
+}
+function websocketAcceptKey(clientKey) {
+  return createHash("sha1").update(`${clientKey}258EAFA5-E914-47DA-95CA-C5AB0DC85B11`).digest("base64");
+}
+function encodeTextFrame(payload) {
+  const payloadBuffer = Buffer.from(payload, "utf-8");
+  const len = payloadBuffer.length;
+  const header = [129];
+  if (len <= 125) {
+    header.push(len);
+  } else if (len <= 65535) {
+    header.push(126, len >> 8 & 255, len & 255);
+  } else {
+    const high = Math.floor(len / 2 ** 32);
+    const low = len >>> 0;
+    header.push(127, high >> 24 & 255, high >> 16 & 255, high >> 8 & 255, high & 255, low >> 24 & 255, low >> 16 & 255, low >> 8 & 255, low & 255);
+  }
+  return Buffer.concat([Buffer.from(header), payloadBuffer]);
+}
+var GraphDashboardServer = class {
+  memoryDir;
+  host;
+  requestedPort;
+  publicDir;
+  watchDebounceMs;
+  server = null;
+  watcher = null;
+  clients = /* @__PURE__ */ new Map();
+  graphSnapshot = {
+    generatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+    nodes: [],
+    edges: [],
+    stats: { nodes: 0, edges: 0, malformedLines: 0, filesMissing: [] }
+  };
+  debounceTimer = null;
+  lastError = null;
+  boundPort = 0;
+  constructor(options) {
+    this.memoryDir = options.memoryDir;
+    this.host = options.host?.trim() || "127.0.0.1";
+    this.requestedPort = Number.isFinite(options.port) ? Math.max(0, Math.floor(options.port ?? 0)) : 0;
+    this.publicDir = options.publicDir ?? path.join(process.cwd(), "dashboard", "public");
+    this.watchDebounceMs = Math.max(50, Math.floor(options.watchDebounceMs ?? 300));
+  }
+  async start() {
+    if (this.server) {
+      return this.status();
+    }
+    await this.rebuildSnapshot();
+    const candidate = createServer((req, res) => {
+      void this.handleHttp(req, res);
+    });
+    candidate.on("upgrade", (req, socket) => {
+      this.handleUpgrade(req, socket);
+    });
+    try {
+      await new Promise((resolve, reject) => {
+        const onError = (err) => {
+          candidate.off("listening", onListening);
+          reject(err);
+        };
+        const onListening = () => {
+          candidate.off("error", onError);
+          resolve();
+        };
+        candidate.once("error", onError);
+        candidate.once("listening", onListening);
+        candidate.listen(this.requestedPort, this.host);
+      });
+    } catch (err) {
+      this.lastError = err instanceof Error ? err.message : String(err);
+      try {
+        candidate.close();
+      } catch {
+      }
+      throw err;
+    }
+    this.server = candidate;
+    const addr = candidate.address();
+    this.boundPort = typeof addr === "object" && addr ? addr.port : this.requestedPort;
+    this.startWatcher();
+    return this.status();
+  }
+  async stop() {
+    const closeServer = this.server;
+    this.server = null;
+    this.boundPort = 0;
+    if (this.debounceTimer) {
+      clearTimeout(this.debounceTimer);
+      this.debounceTimer = null;
+    }
+    if (this.watcher) {
+      this.watcher.close();
+      this.watcher = null;
+    }
+    for (const client of this.clients.values()) {
+      try {
+        client.socket.destroy();
+      } catch {
+      }
+    }
+    this.clients.clear();
+    if (closeServer) {
+      await new Promise((resolve, reject) => {
+        closeServer.close((err) => {
+          if (err) reject(err);
+          else resolve();
+        });
+      });
+    }
+  }
+  status() {
+    return {
+      running: this.server !== null,
+      host: this.host,
+      port: this.boundPort,
+      watching: this.watcher !== null,
+      lastUpdatedAt: this.graphSnapshot.generatedAt,
+      graphNodeCount: this.graphSnapshot.stats.nodes,
+      graphEdgeCount: this.graphSnapshot.stats.edges
+    };
+  }
+  async handleHttp(req, res) {
+    const url = req.url ?? "/";
+    if (req.method === "GET" && url === "/api/health") {
+      this.respondJson(res, 200, {
+        ok: true,
+        running: this.server !== null,
+        watching: this.watcher !== null,
+        graph: this.graphSnapshot.stats,
+        clients: this.clients.size,
+        lastError: this.lastError ?? void 0
+      });
+      return;
+    }
+    if (req.method === "GET" && url === "/api/graph") {
+      this.respondJson(res, 200, this.graphSnapshot);
+      return;
+    }
+    if (req.method === "GET" && url === "/app.js") {
+      await this.respondStatic(res, path.join(this.publicDir, "app.js"), "application/javascript; charset=utf-8");
+      return;
+    }
+    if (req.method === "GET" && (url === "/" || url === "/index.html")) {
+      await this.respondStatic(res, path.join(this.publicDir, "index.html"), "text/html; charset=utf-8");
+      return;
+    }
+    this.respondJson(res, 404, { error: "Not found" });
+  }
+  respondJson(res, status, payload) {
+    const body = JSON.stringify(payload, null, 2);
+    res.statusCode = status;
+    res.setHeader("content-type", "application/json; charset=utf-8");
+    res.setHeader("content-length", String(Buffer.byteLength(body)));
+    res.end(body);
+  }
+  async respondStatic(res, filePath, contentType) {
+    try {
+      const body = await readFile(filePath, "utf-8");
+      res.statusCode = 200;
+      res.setHeader("content-type", contentType);
+      res.setHeader("content-length", String(Buffer.byteLength(body)));
+      res.end(body);
+    } catch {
+      this.respondJson(res, 404, { error: "Not found" });
+    }
+  }
+  handleUpgrade(req, socket) {
+    const upgrade = typeof req.headers.upgrade === "string" ? req.headers.upgrade.toLowerCase() : "";
+    const key = req.headers["sec-websocket-key"];
+    const origin = typeof req.headers.origin === "string" ? req.headers.origin : "";
+    if (upgrade !== "websocket" || typeof key !== "string") {
+      socket.write("HTTP/1.1 400 Bad Request\r\n\r\n");
+      socket.destroy();
+      return;
+    }
+    if (!this.isAllowedOrigin(origin)) {
+      socket.write("HTTP/1.1 403 Forbidden\r\n\r\n");
+      socket.destroy();
+      return;
+    }
+    const accept = websocketAcceptKey(key);
+    socket.write(
+      [
+        "HTTP/1.1 101 Switching Protocols",
+        "Upgrade: websocket",
+        "Connection: Upgrade",
+        `Sec-WebSocket-Accept: ${accept}`,
+        "",
+        ""
+      ].join("\r\n")
+    );
+    const id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    this.clients.set(id, { id, socket });
+    socket.on("close", () => {
+      this.clients.delete(id);
+    });
+    socket.on("error", () => {
+      this.clients.delete(id);
+    });
+    const hello = JSON.stringify({
+      type: "hello",
+      graph: this.graphSnapshot
+    });
+    socket.write(encodeTextFrame(hello));
+  }
+  isAllowedOrigin(origin) {
+    if (!origin) return false;
+    try {
+      const parsed = new URL(origin);
+      const hostname = normalizeOriginHostname(parsed.hostname);
+      if (!LOOPBACK_HOSTS.has(hostname)) return false;
+      if (parsed.protocol !== "http:") return false;
+      const originPort = parsed.port ? Number(parsed.port) : 80;
+      return Number.isFinite(originPort) && originPort === this.boundPort;
+    } catch {
+      return false;
+    }
+  }
+  broadcast(payload) {
+    const frame = encodeTextFrame(JSON.stringify(payload));
+    for (const [id, client] of this.clients.entries()) {
+      try {
+        client.socket.write(frame);
+      } catch {
+        this.clients.delete(id);
+      }
+    }
+  }
+  startWatcher() {
+    const graphDir = path.join(this.memoryDir, "state", "graphs");
+    try {
+      this.watcher = watch(graphDir, { persistent: false }, () => {
+        this.scheduleRebuild();
+      });
+      this.watcher.on("error", (err) => {
+        this.lastError = err instanceof Error ? err.message : String(err);
+      });
+    } catch (err) {
+      this.lastError = err instanceof Error ? err.message : String(err);
+      this.watcher = null;
+    }
+  }
+  scheduleRebuild() {
+    if (this.debounceTimer) clearTimeout(this.debounceTimer);
+    this.debounceTimer = setTimeout(() => {
+      this.debounceTimer = null;
+      void this.rebuildAndBroadcast();
+    }, this.watchDebounceMs);
+  }
+  async rebuildAndBroadcast() {
+    const previous = this.graphSnapshot;
+    await this.rebuildSnapshot();
+    const patch = diffGraphSnapshots(previous, this.graphSnapshot);
+    if (patch.addedEdges.length === 0 && patch.removedEdges.length === 0 && patch.addedNodes.length === 0 && patch.removedNodes.length === 0) {
+      return;
+    }
+    this.broadcast({
+      type: "graph_patch",
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      patch,
+      graph: this.graphSnapshot
+    });
+  }
+  async rebuildSnapshot() {
+    try {
+      this.graphSnapshot = await graphSnapshotFromMemoryDir(this.memoryDir);
+      this.lastError = null;
+    } catch (err) {
+      this.lastError = err instanceof Error ? err.message : String(err);
+    }
+  }
+};
+
+export {
+  GraphDashboardServer
+};
+//# sourceMappingURL=chunk-ZPKBYX2F.js.map

package/dist/chunk-ZPKBYX2F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dashboard-runtime.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport { watch, type FSWatcher } from \"node:fs\";\nimport { readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport { graphSnapshotFromMemoryDir, type GraphSnapshot } from \"./graph-dashboard-parser.js\";\nimport { diffGraphSnapshots } from \"./graph-dashboard-diff.js\";\n\nexport interface DashboardServerOptions {\n  memoryDir: string;\n  host?: string;\n  port?: number;\n  publicDir?: string;\n  watchDebounceMs?: number;\n}\n\nexport interface DashboardStatus {\n  running: boolean;\n  host: string;\n  port: number;\n  watching: boolean;\n  lastUpdatedAt?: string;\n  graphNodeCount: number;\n  graphEdgeCount: number;\n}\n\ntype WsClient = {\n  id: string;\n  socket: Duplex;\n};\n\nconst LOOPBACK_HOSTS = new Set([\"127.0.0.1\", \"localhost\", \"::1\"]);\n\nfunction normalizeOriginHostname(hostname: string): string {\n  if (hostname.startsWith(\"[\") && hostname.endsWith(\"]\")) {\n    return hostname.slice(1, -1);\n  }\n  return hostname;\n}\n\nfunction websocketAcceptKey(clientKey: string): string {\n  return createHash(\"sha1\")\n    .update(`${clientKey}258EAFA5-E914-47DA-95CA-C5AB0DC85B11`)\n    .digest(\"base64\");\n}\n\nfunction encodeTextFrame(payload: string): Buffer {\n  const payloadBuffer = Buffer.from(payload, \"utf-8\");\n  const len = payloadBuffer.length;\n  const header: number[] = [0x81];\n  if (len <= 125) {\n    header.push(len);\n  } else if (len <= 0xffff) {\n    header.push(126, (len >> 8) & 0xff, len & 0xff);\n  } else {\n    const high = Math.floor(len / 2 ** 32);\n    const low = len >>> 0;\n    header.push(127, (high >> 24) & 0xff, (high >> 16) & 0xff, (high >> 8) & 0xff, high & 0xff, (low >> 24) & 0xff, (low >> 16) & 0xff, (low >> 8) & 0xff, low & 0xff);\n  }\n  return Buffer.concat([Buffer.from(header), payloadBuffer]);\n}\n\nexport class GraphDashboardServer {\n  private readonly memoryDir: string;\n  private readonly host: string;\n  private readonly requestedPort: number;\n  private readonly publicDir: string;\n  private readonly watchDebounceMs: number;\n  private server: ReturnType<typeof createServer> | null = null;\n  private watcher: FSWatcher | null = null;\n  private clients = new Map<string, WsClient>();\n  private graphSnapshot: GraphSnapshot = {\n    generatedAt: new Date(0).toISOString(),\n    nodes: [],\n    edges: [],\n    stats: { nodes: 0, edges: 0, malformedLines: 0, filesMissing: [] },\n  };\n  private debounceTimer: NodeJS.Timeout | null = null;\n  private lastError: string | null = null;\n  private boundPort = 0;\n\n  constructor(options: DashboardServerOptions) {\n    this.memoryDir = options.memoryDir;\n    this.host = options.host?.trim() || \"127.0.0.1\";\n    this.requestedPort = Number.isFinite(options.port) ? Math.max(0, Math.floor(options.port ?? 0)) : 0;\n    this.publicDir = options.publicDir ?? path.join(process.cwd(), \"dashboard\", \"public\");\n    this.watchDebounceMs = Math.max(50, Math.floor(options.watchDebounceMs ?? 300));\n  }\n\n  async start(): Promise<DashboardStatus> {\n    if (this.server) {\n      return this.status();\n    }\n\n    await this.rebuildSnapshot();\n    const candidate = createServer((req, res) => {\n      void this.handleHttp(req, res);\n    });\n    candidate.on(\"upgrade\", (req, socket) => {\n      this.handleUpgrade(req, socket);\n    });\n    try {\n      await new Promise<void>((resolve, reject) => {\n        const onError = (err: Error) => {\n          candidate.off(\"listening\", onListening);\n          reject(err);\n        };\n        const onListening = () => {\n          candidate.off(\"error\", onError);\n          resolve();\n        };\n        candidate.once(\"error\", onError);\n        candidate.once(\"listening\", onListening);\n        candidate.listen(this.requestedPort, this.host);\n      });\n    } catch (err) {\n      this.lastError = err instanceof Error ? err.message : String(err);\n      try {\n        candidate.close();\n      } catch {\n        // no-op\n      }\n      throw err;\n    }\n    this.server = candidate;\n    const addr = candidate.address();\n    this.boundPort = typeof addr === \"object\" && addr ? addr.port : this.requestedPort;\n    this.startWatcher();\n    return this.status();\n  }\n\n  async stop(): Promise<void> {\n    const closeServer = this.server;\n    this.server = null;\n    this.boundPort = 0;\n\n    if (this.debounceTimer) {\n      clearTimeout(this.debounceTimer);\n      this.debounceTimer = null;\n    }\n    if (this.watcher) {\n      this.watcher.close();\n      this.watcher = null;\n    }\n    for (const client of this.clients.values()) {\n      try {\n        client.socket.destroy();\n      } catch {\n        // no-op\n      }\n    }\n    this.clients.clear();\n\n    if (closeServer) {\n      await new Promise<void>((resolve, reject) => {\n        closeServer.close((err) => {\n          if (err) reject(err);\n          else resolve();\n        });\n      });\n    }\n  }\n\n  status(): DashboardStatus {\n    return {\n      running: this.server !== null,\n      host: this.host,\n      port: this.boundPort,\n      watching: this.watcher !== null,\n      lastUpdatedAt: this.graphSnapshot.generatedAt,\n      graphNodeCount: this.graphSnapshot.stats.nodes,\n      graphEdgeCount: this.graphSnapshot.stats.edges,\n    };\n  }\n\n  private async handleHttp(req: IncomingMessage, res: ServerResponse): Promise<void> {\n    const url = req.url ?? \"/\";\n    if (req.method === \"GET\" && url === \"/api/health\") {\n      this.respondJson(res, 200, {\n        ok: true,\n        running: this.server !== null,\n        watching: this.watcher !== null,\n        graph: this.graphSnapshot.stats,\n        clients: this.clients.size,\n        lastError: this.lastError ?? undefined,\n      });\n      return;\n    }\n    if (req.method === \"GET\" && url === \"/api/graph\") {\n      this.respondJson(res, 200, this.graphSnapshot);\n      return;\n    }\n    if (req.method === \"GET\" && url === \"/app.js\") {\n      await this.respondStatic(res, path.join(this.publicDir, \"app.js\"), \"application/javascript; charset=utf-8\");\n      return;\n    }\n    if (req.method === \"GET\" && (url === \"/\" || url === \"/index.html\")) {\n      await this.respondStatic(res, path.join(this.publicDir, \"index.html\"), \"text/html; charset=utf-8\");\n      return;\n    }\n    this.respondJson(res, 404, { error: \"Not found\" });\n  }\n\n  private respondJson(res: ServerResponse, status: number, payload: unknown): void {\n    const body = JSON.stringify(payload, null, 2);\n    res.statusCode = status;\n    res.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n    res.setHeader(\"content-length\", String(Buffer.byteLength(body)));\n    res.end(body);\n  }\n\n  private async respondStatic(res: ServerResponse, filePath: string, contentType: string): Promise<void> {\n    try {\n      const body = await readFile(filePath, \"utf-8\");\n      res.statusCode = 200;\n      res.setHeader(\"content-type\", contentType);\n      res.setHeader(\"content-length\", String(Buffer.byteLength(body)));\n      res.end(body);\n    } catch {\n      this.respondJson(res, 404, { error: \"Not found\" });\n    }\n  }\n\n  private handleUpgrade(req: IncomingMessage, socket: Duplex): void {\n    const upgrade = typeof req.headers.upgrade === \"string\" ? req.headers.upgrade.toLowerCase() : \"\";\n    const key = req.headers[\"sec-websocket-key\"];\n    const origin = typeof req.headers.origin === \"string\" ? req.headers.origin : \"\";\n    if (upgrade !== \"websocket\" || typeof key !== \"string\") {\n      socket.write(\"HTTP/1.1 400 Bad Request\\r\\n\\r\\n\");\n      socket.destroy();\n      return;\n    }\n    if (!this.isAllowedOrigin(origin)) {\n      socket.write(\"HTTP/1.1 403 Forbidden\\r\\n\\r\\n\");\n      socket.destroy();\n      return;\n    }\n    const accept = websocketAcceptKey(key);\n    socket.write(\n      [\n        \"HTTP/1.1 101 Switching Protocols\",\n        \"Upgrade: websocket\",\n        \"Connection: Upgrade\",\n        `Sec-WebSocket-Accept: ${accept}`,\n        \"\",\n        \"\",\n      ].join(\"\\r\\n\"),\n    );\n    const id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n    this.clients.set(id, { id, socket });\n    socket.on(\"close\", () => {\n      this.clients.delete(id);\n    });\n    socket.on(\"error\", () => {\n      this.clients.delete(id);\n    });\n\n    const hello = JSON.stringify({\n      type: \"hello\",\n      graph: this.graphSnapshot,\n    });\n    socket.write(encodeTextFrame(hello));\n  }\n\n  private isAllowedOrigin(origin: string): boolean {\n    if (!origin) return false;\n    try {\n      const parsed = new URL(origin);\n      const hostname = normalizeOriginHostname(parsed.hostname);\n      if (!LOOPBACK_HOSTS.has(hostname)) return false;\n      if (parsed.protocol !== \"http:\") return false;\n      const originPort = parsed.port ? Number(parsed.port) : 80;\n      return Number.isFinite(originPort) && originPort === this.boundPort;\n    } catch {\n      return false;\n    }\n  }\n\n  private broadcast(payload: unknown): void {\n    const frame = encodeTextFrame(JSON.stringify(payload));\n    for (const [id, client] of this.clients.entries()) {\n      try {\n        client.socket.write(frame);\n      } catch {\n        this.clients.delete(id);\n      }\n    }\n  }\n\n  private startWatcher(): void {\n    const graphDir = path.join(this.memoryDir, \"state\", \"graphs\");\n    try {\n      this.watcher = watch(graphDir, { persistent: false }, () => {\n        this.scheduleRebuild();\n      });\n      this.watcher.on(\"error\", (err) => {\n        this.lastError = err instanceof Error ? err.message : String(err);\n      });\n    } catch (err) {\n      this.lastError = err instanceof Error ? err.message : String(err);\n      this.watcher = null;\n    }\n  }\n\n  private scheduleRebuild(): void {\n    if (this.debounceTimer) clearTimeout(this.debounceTimer);\n    this.debounceTimer = setTimeout(() => {\n      this.debounceTimer = null;\n      void this.rebuildAndBroadcast();\n    }, this.watchDebounceMs);\n  }\n\n  private async rebuildAndBroadcast(): Promise<void> {\n    const previous = this.graphSnapshot;\n    await this.rebuildSnapshot();\n    const patch = diffGraphSnapshots(previous, this.graphSnapshot);\n    if (patch.addedEdges.length === 0 && patch.removedEdges.length === 0 && patch.addedNodes.length === 0 && patch.removedNodes.length === 0) {\n      return;\n    }\n    this.broadcast({\n      type: \"graph_patch\",\n      generatedAt: new Date().toISOString(),\n      patch,\n      graph: this.graphSnapshot,\n    });\n  }\n\n  private async rebuildSnapshot(): Promise<void> {\n    try {\n      this.graphSnapshot = await graphSnapshotFromMemoryDir(this.memoryDir);\n      this.lastError = null;\n    } catch (err) {\n      this.lastError = err instanceof Error ? err.message : String(err);\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunking.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Automatic Chunking with Overlap (Phase 2A)
+ *
+ * Sentence-boundary chunking for long memories.
+ * Preserves coherent thoughts by never splitting mid-sentence.
+ */
+interface ChunkingConfig {
+    /** Target tokens per chunk (default 200) */
+    targetTokens: number;
+    /** Minimum tokens to trigger chunking (default 150) */
+    minTokens: number;
+    /** Number of sentences to overlap between chunks (default 2) */
+    overlapSentences: number;
+}
+interface Chunk {
+    /** Chunk content */
+    content: string;
+    /** 0-based index */
+    index: number;
+    /** Approximate token count */
+    tokenCount: number;
+}
+interface ChunkResult {
+    /** Whether content was chunked */
+    chunked: boolean;
+    /** Array of chunks (length 1 if not chunked) */
+    chunks: Chunk[];
+}
+/** Default chunking configuration */
+declare const DEFAULT_CHUNKING_CONFIG: ChunkingConfig;
+/**
+ * Chunk content into overlapping segments at sentence boundaries.
+ *
+ * @param content - The text content to chunk
+ * @param config - Chunking configuration
+ * @returns ChunkResult with chunks array
+ */
+declare function chunkContent(content: string, config?: ChunkingConfig): ChunkResult;
+/**
+ * Get parent content by reassembling chunks.
+ * Useful for displaying full context when a chunk is retrieved.
+ *
+ * @param chunks - Array of chunk contents in order
+ * @returns Reassembled parent content (with overlap removed)
+ */
+declare function reassembleChunks(chunks: string[]): string;
+
+export { type Chunk, type ChunkResult, type ChunkingConfig, DEFAULT_CHUNKING_CONFIG, chunkContent, reassembleChunks };

package/dist/chunking.js

@@ -0,0 +1,11 @@
+import {
+  DEFAULT_CHUNKING_CONFIG,
+  chunkContent,
+  reassembleChunks
+} from "./chunk-B7LOFDVE.js";
+export {
+  DEFAULT_CHUNKING_CONFIG,
+  chunkContent,
+  reassembleChunks
+};
+//# sourceMappingURL=chunking.js.map

package/dist/chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}