@lingkkkk/atlas-mindmap 0.1.0 → 0.1.1

package/README.md

@@ -5,6 +5,57 @@ data in a normalized store, geometry in typed arrays, viewport lookup in a spati
 rendering on one Canvas. The package has zero runtime dependencies and includes ESM, CommonJS,
 browser-IIFE, type declarations, and CSS builds.
 
+## Rendering preview
+
+![Atlas Mind Map rendering 20,001 topics across 201 levels with the live performance HUD](https://cdn.jsdelivr.net/npm/@lingkkkk/atlas-mindmap@0.1.1/assets/render-preview.webp)
+
+This production-demo capture renders **20,001 topics across 201 levels** on one Canvas. The fixed
+DOM toolbar and performance HUD remain interactive while topics, connectors, selection, collapse
+controls, and branch colors are drawn by the renderer. The same preview file ships inside this npm
+package at `assets/render-preview.webp`.
+
+## Performance snapshot
+
+The following qualification ran the public `dist/index.js` build in headed Chromium 151 on an
+Apple M1 Max, using a 1440 × 900 viewport at DPR 1. Each size used a fresh page, explicit CDP garbage
+collection, 120 sampled frames per view, and seven samples per editing operation.
+Version 0.1.1 is a documentation-and-preview release and does not change the measured runtime
+source from 0.1.0.
+
+| Topics | First render | Forced-GC JS heap | Page Elements | Topic Elements |
+| ---: | ---: | ---: | ---: | ---: |
+| 100 | 84.10 ms | 1.49 MB | 110 | 0 |
+| 500 | 66.80 ms | 1.69 MB | 110 | 0 |
+| 1,000 | 65.90 ms | 1.85 MB | 110 | 0 |
+| 2,000 | 75.50 ms | 2.17 MB | 110 | 0 |
+| 5,000 | 104.90 ms | 3.20 MB | 110 | 0 |
+| 10,000 | 153.70 ms | 5.23 MB | 110 | 0 |
+| 20,000 | 242.00 ms | 7.56 MB | 110 | 0 |
+| 50,000 | 565.50 ms | 15.87 MB | 110 | 0 |
+| 100,000 | 971.40 ms | 29.72 MB | 110 | 0 |
+
+First render is measured from the page navigation timeline until the Canvas renderer completes its
+first draw. JS heap is V8 heap after forced garbage collection; it is not total browser, GPU, or OS
+memory. Page Elements are counted immediately after first render and before benchmark interaction.
+Topic Elements stay at zero because topics are Canvas-drawn rather than represented by DOM nodes.
+
+| Topics | Full-map Fit FPS / frame P95 | Focused FPS / frame P95 | Text edit P95 | Drag reparent |
+| ---: | ---: | ---: | ---: | ---: |
+| 20,000 | 119.9 / 8.70 ms | 114.6 / 12.70 ms | 16.15 ms | 14.61 ms · passed |
+| 50,000 | 90.9 / 16.91 ms | 118.0 / 9.31 ms | 26.80 ms | 32.99 ms · passed |
+| 100,000 | 47.6 / 33.21 ms | 116.7 / 10.51 ms | 46.97 ms | 41.34 ms · passed |
+
+The 50,000 and 100,000-topic startup paths cross the report's 250 ms synchronous-blocking
+threshold, even though focused editing remains smooth on this machine. Treat startup capacity and
+post-startup interaction as separate acceptance criteria.
+
+The workload is a deterministic **normalized XMind topic model** containing topic kind, markers,
+labels, and task data. It measures layout and rendering after import; it does not include `.xmind`
+ZIP extraction, `content.json` parsing, image decoding, attachment loading, formulas, or
+collaboration traffic.
+
+Read the [complete performance and technical-review report](https://cdn.jsdelivr.net/npm/@lingkkkk/atlas-mindmap@0.1.1/PERFORMANCE.md) for all frame, cull, draw, style, editing, pointer-integrity, environment, and limitation data.
+
 ## Install
 
 ```bash
@@ -60,9 +111,9 @@ Load `node_modules/@lingkkkk/atlas-mindmap/dist/index.css` with your bundler or
 ## CDN / browser IIFE
 
 ```html
-<link rel="stylesheet" href="https://unpkg.com/@lingkkkk/atlas-mindmap@0.1.0/dist/index.css">
+<link rel="stylesheet" href="https://unpkg.com/@lingkkkk/atlas-mindmap@0.1.1/dist/index.css">
 <div id="mindmap" style="height:720px"></div>
-<script src="https://unpkg.com/@lingkkkk/atlas-mindmap@0.1.0/dist/index.global.js"></script>
+<script src="https://unpkg.com/@lingkkkk/atlas-mindmap@0.1.1/dist/index.global.js"></script>
 <script>
   const map = new AtlasMindMap.MindMap({
     container: '#mindmap',
@@ -128,7 +179,7 @@ animation frame; debounce geometry-changing controls until input commit.
 
 ## Safe icon and image strategy
 
-Version 0.1.0 stores XMind-compatible `markers` and `image` metadata, but does not claim arbitrary
+Version 0.1.1 stores XMind-compatible `markers` and `image` metadata, but does not claim arbitrary
 remote-image icon rendering as a completed feature. A high-volume icon plugin should use cached
 `Path2D` objects or a decoded bitmap atlas, key the cache by icon/size/DPR, cap its pixel budget,
 hide icons in low-zoom LOD, and never allocate an Image, SVG, or Promise inside the frame loop.
@@ -145,9 +196,10 @@ map.destroy()
 
 ## Performance evidence
 
-See [PERFORMANCE.md](./PERFORMANCE.md) for the 100/500/1,000/2,000/5,000/10,000/20,000/50,000/
-100,000-topic headed-Chromium qualification, environment, interaction checks, memory scope, and
-limitations. The report distinguishes full-map overview from 100% focused editing.
+See the [complete performance report](https://cdn.jsdelivr.net/npm/@lingkkkk/atlas-mindmap@0.1.1/PERFORMANCE.md)
+for the 100/500/1,000/2,000/5,000/10,000/20,000/50,000/100,000-topic headed-Chromium
+qualification, environment, interaction checks, memory scope, and limitations. The report
+distinguishes full-map overview from 100% focused editing.
 
 ## Browser support
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingkkkk/atlas-mindmap",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Framework-agnostic high-performance Canvas mind map for large JavaScript datasets",
   "keywords": [
     "mindmap",
@@ -16,6 +16,7 @@
   },
   "files": [
     "dist",
+    "assets",
     "README.md",
     "PERFORMANCE.md"
   ],