@utsp/render 0.10.0 → 0.11.0-nightly.20251213232121.8b318c1

package/README.md

@@ -5,27 +5,121 @@
 > This package is currently in early development and should **NOT** be used in production.
 > The API is unstable and subject to breaking changes without notice.
 
-Rendering system for UTSP (Universal Text Stream Protocol).
+Rendering system for UTSP (Universal Text Stream Protocol) - Terminal character rendering with WebGL, Canvas 2D, and ANSI terminal support.
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+## Features
+
+- **TerminalGL** - High-performance WebGL 1.0 renderer with GPU palette
+- **Terminal2D** - CPU-based Canvas 2D fallback renderer
+- **TerminalANSI** - ANSI escape sequence renderer for native terminals (cmd, PowerShell, bash)
+- **Tree-shakeable** - Import only what you need for smaller bundles
+- **Overlays** - AutoplayOverlay, PostProcessOverlay, GridOverlay
+
+## Installation
+
+```bash
+npm install @utsp/render
+```
+
+## Entry Points
+
+The package provides multiple entry points for optimal bundle size:
+
+### Full Bundle (default)
+```typescript
+import { TerminalGL, Terminal2D, AutoplayOverlay } from '@utsp/render';
+```
+
+### WebGL Only (~43 KB)
+```typescript
+import { TerminalGL, ScalingMode } from '@utsp/render/gl';
+```
+
+### Canvas 2D Only (~27 KB)
+```typescript
+import { Terminal2D, BitmapFontAtlas } from '@utsp/render/2d';
+```
+
+### Common Utilities Only (~11 KB)
+```typescript
+import { AutoplayOverlay, PostProcessOverlay, GridOverlay } from '@utsp/render/common';
+```
+
+### ANSI Terminal (~3 KB)
+```typescript
+import { TerminalANSI } from '@utsp/render/ansi';
+```
+
+## Quick Start
+
+### WebGL Renderer (recommended)
+```typescript
+import { TerminalGL, ScalingMode } from '@utsp/render/gl';
+
+const terminal = new TerminalGL(container, {
+  cols: 80,
+  rows: 24,
+  scalingMode: ScalingMode.Integer
+});
+
+// Load bitmap font
+await terminal.loadBitmapFont(fontData, 8, 8);
+
+// Update cells from Core
+terminal.render(core.getDisplayBuffer());
+```
+
+### Canvas 2D Renderer (fallback)
+```typescript
+import { Terminal2D } from '@utsp/render/2d';
+
+const terminal = new Terminal2D(container, {
+  fixedCols: 80,
+  fixedRows: 24
+});
+
+// Render from Core
+terminal.render(core.getDisplayBuffer());
+```
+
+### ANSI Terminal Renderer (for CLI apps)
+```typescript
+import { TerminalANSI } from '@utsp/render/ansi';
+
+const renderer = new TerminalANSI({
+  optimizeColors: true,  // Only emit color codes when they change
+  hideCursor: true       // Hide cursor during rendering
+});
+
+// Render from Core's RenderState
+const output = renderer.render(renderState);
+process.stdout.write(output);
+
+// Cleanup on exit
+process.stdout.write(renderer.showCursor() + renderer.reset());
+```
+
+## Bundle Sizes
+
+| Entry Point | ESM (minified) | ESM (gzip) |
+|-------------|----------------|------------|
+| `@utsp/render` | 74.43 KB | 18.40 KB |
+| `@utsp/render/gl` | 43.49 KB | 11.03 KB |
+| `@utsp/render/2d` | 27.24 KB | 7.83 KB |
+| `@utsp/render/common` | 11.19 KB | 3.46 KB |
+
 ## ⚠️ Development Status
 
 **This is a prototype package under active development.**
 
 - ❌ No stable API
-- ❌ No documentation available yet
 - ❌ Breaking changes expected
 - ❌ Not recommended for production use
 
 **Please check back later for updates or watch the repository for release announcements.**
 
-## Installation
-
-```bash
-npm install @utsp/render
-```
-
 ## Repository
 
 - [GitHub](https://github.com/thp-software/utsp)

package/dist/2d/index.cjs

@@ -0,0 +1,34 @@
+"use strict";var W=Object.defineProperty;var X=Object.getOwnPropertyDescriptor;var Y=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var N=(d,t,e)=>t in d?W(d,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):d[t]=e;var f=(d,t)=>W(d,"name",{value:t,configurable:!0});var _=(d,t)=>{for(var e in t)W(d,e,{get:t[e],enumerable:!0})},j=(d,t,e,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of Y(t))!P.call(d,s)&&s!==e&&W(d,s,{get:()=>t[s],enumerable:!(i=X(t,s))||i.enumerable});return d};var q=d=>j(W({},"__esModule",{value:!0}),d);var o=(d,t,e)=>(N(d,typeof t!="symbol"?t+"":t,e),e);var Z={};_(Z,{BitmapFontAtlas:()=>H,DEFAULT_PALETTE:()=>I,GridOverlay:()=>w,ImageFontAtlas:()=>M,ScalingMode:()=>O.ScalingMode,Terminal2D:()=>A,colorToPaletteIndex:()=>L,getAtlasColumns:()=>D,getCharGridPosition:()=>R,getMaxCharCode:()=>E,paletteIndexToColor:()=>z});module.exports=q(Z);var T=class T{constructor(t,e,i,s,a){o(this,"atlases");o(this,"charMap");o(this,"baseCharWidth");o(this,"baseCharHeight");o(this,"baseCellWidth");o(this,"baseCellHeight");o(this,"atlasColumns",16);o(this,"font");o(this,"SCALES",[1,2,4,8]);o(this,"colorCache",new Map);o(this,"MAX_CACHE_SIZE",512);this.font=t,this.baseCharWidth=e,this.baseCharHeight=i,this.baseCellWidth=s??e,this.baseCellHeight=a??i,this.charMap=new Map,this.atlases=new Map,this.generateAtlases()}generateAtlases(){this.atlasColumns=16;let t=0;for(let[e,i]of this.font){let s=t%this.atlasColumns,a=Math.floor(t/this.atlasColumns);this.charMap.set(e,{x:s*this.baseCharWidth,y:a*this.baseCharHeight});for(let r of this.SCALES){let n=this.getOrCreateAtlas(r),h=s*n.charWidth,l=a*n.charHeight;this.renderBitmapToAtlas(n,i,h,l)}t++}}getOrCreateAtlas(t){let e=this.atlases.get(t);if(!e){let i=this.baseCharWidth*t,s=this.baseCharHeight*t,r=Math.ceil(256/this.atlasColumns),n=document.createElement("canvas");n.width=this.atlasColumns*i,n.height=r*s;let h=n.getContext("2d",{alpha:!0,willReadFrequently:!1});if(!h)throw new Error(`Impossible de cr\xE9er le contexte 2D pour l'atlas ${t}x`);h.imageSmoothingEnabled=!1,e={canvas:n,ctx:h,scale:t,charWidth:i,charHeight:s},this.atlases.set(t,e)}return e}renderBitmapToAtlas(t,e,i,s){let a=t.scale,r=t.ctx;r.fillStyle="#ffffff";for(let n=0;n<Math.min(e.length,this.baseCharHeight);n++){let h=e[n];for(let l=0;l<this.baseCharWidth;l++){let c=1<<7-l;h&c&&r.fillRect(i+l*a,s+n*a,a,a)}}}drawChar(t,e,i,s,a,r,n){let h=this.charMap.get(e);if(!h)return;let l=`${e}:${n}`,c=this.colorCache.get(l);if(c)c.lastUsed=performance.now();else{let v=this.createColoredGlyph(e,n,h);if(!v)return;c={canvas:v,lastUsed:performance.now()},this.colorCache.set(l,c),this.colorCache.size>this.MAX_CACHE_SIZE&&this.evictLRU()}let g=a/this.baseCellWidth,m=r/this.baseCellHeight,u=(this.baseCellWidth-this.baseCharWidth)/2*g,C=(this.baseCellHeight-this.baseCharHeight)/2*m,b=this.baseCharWidth*g,p=this.baseCharHeight*m;t.drawImage(c.canvas,i+u,s+C,b,p)}createColoredGlyph(t,e,i){let s=this.atlases.get(1);if(!s)return null;let a=s.ctx.getImageData(i.x,i.y,this.baseCharWidth,this.baseCharHeight),r=a.data,n=this.hexToRgb(e);for(let c=0;c<r.length;c+=4)r[c+3]>0&&(r[c]=n.r,r[c+1]=n.g,r[c+2]=n.b);let h=document.createElement("canvas");h.width=this.baseCharWidth,h.height=this.baseCharHeight;let l=h.getContext("2d",{alpha:!0});return l?(l.imageSmoothingEnabled=!1,l.putImageData(a,0,0),h):null}hexToRgb(t){if(t.startsWith("#")){let a=/^#?([a-f\d])([a-f\d])([a-f\d])$/i;t=t.replace(a,(n,h,l,c)=>h+h+l+l+c+c);let r=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(t);return r?{r:parseInt(r[1],16),g:parseInt(r[2],16),b:parseInt(r[3],16)}:{r:255,g:255,b:255}}let e=/rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*[\d.]+)?\)/.exec(t);if(e)return{r:parseInt(e[1],10),g:parseInt(e[2],10),b:parseInt(e[3],10)};let s={white:[255,255,255],black:[0,0,0],red:[255,0,0],green:[0,255,0],blue:[0,0,255],yellow:[255,255,0],cyan:[0,255,255],magenta:[255,0,255]}[t.toLowerCase()];return s?{r:s[0],g:s[1],b:s[2]}:{r:255,g:255,b:255}}evictLRU(){let t=null,e=1/0;for(let[i,s]of this.colorCache)s.lastUsed<e&&(e=s.lastUsed,t=i);if(t){let i=this.colorCache.get(t);i&&(i.canvas.width=0,i.canvas.height=0),this.colorCache.delete(t)}}getAtlasCanvas(t=1){return this.atlases.get(t)?.canvas}getAllAtlases(){return this.atlases}getCharDimensions(){return{width:this.baseCharWidth,height:this.baseCharHeight}}getCharCount(){return this.charMap.size}hasChar(t){return this.charMap.has(t)}getAtlasDimensions(t=1){let e=this.atlases.get(t);if(e)return{width:e.canvas.width,height:e.canvas.height}}toDataURL(t=1,e="image/png"){return this.atlases.get(t)?.canvas.toDataURL(e)}getCacheStats(){return{size:this.colorCache.size,maxSize:this.MAX_CACHE_SIZE}}clearCache(){for(let t of this.colorCache.values())t.canvas.width=0,t.canvas.height=0;this.colorCache.clear()}destroy(){this.charMap.clear();for(let t of this.atlases.values())t.canvas.width=0,t.canvas.height=0;this.atlases.clear(),this.clearCache()}};f(T,"BitmapFontAtlas");var H=T;function D(d){return Math.sqrt(d)*16}f(D,"getAtlasColumns");function E(d){return d*256-1}f(E,"getMaxCharCode");function R(d,t){let e=Math.floor(d/256),i=d%256,s=Math.sqrt(t),a=e%s,r=Math.floor(e/s),n=i%16,h=Math.floor(i/16);return{col:a*16+n,row:r*16+h}}f(R,"getCharGridPosition");var B=class B{constructor(t){o(this,"atlasCanvas",null);o(this,"atlasCtx",null);o(this,"atlasImage",null);o(this,"glyphWidth");o(this,"glyphHeight");o(this,"cellWidth");o(this,"cellHeight");o(this,"atlasBlocks");o(this,"atlasColumns");o(this,"maxCharCode");o(this,"isLoaded",!1);o(this,"colorCache",new Map);o(this,"MAX_CACHE_SIZE",1024);this.glyphWidth=t.glyphWidth,this.glyphHeight=t.glyphHeight,this.cellWidth=t.cellWidth??t.glyphWidth,this.cellHeight=t.cellHeight??t.glyphHeight,this.atlasBlocks=t.atlasBlocks,this.atlasColumns=D(t.atlasBlocks),this.maxCharCode=E(t.atlasBlocks)}async loadFromPNG(t){return new Promise((e,i)=>{let s=new Uint8Array(t),a=new Blob([s],{type:"image/png"}),r=URL.createObjectURL(a),n=new Image;n.onload=()=>{URL.revokeObjectURL(r);let h=this.atlasColumns*this.glyphWidth,l=this.atlasColumns*this.glyphHeight;if((n.width!==h||n.height!==l)&&console.warn(`ImageFontAtlas: Image size ${n.width}\xD7${n.height} doesn't match expected ${h}\xD7${l} for ${this.atlasBlocks} block(s) with ${this.glyphWidth}\xD7${this.glyphHeight} glyphs`),this.atlasCanvas=document.createElement("canvas"),this.atlasCanvas.width=n.width,this.atlasCanvas.height=n.height,this.atlasCtx=this.atlasCanvas.getContext("2d",{alpha:!0,willReadFrequently:!0}),!this.atlasCtx){i(new Error("Failed to create 2D context for atlas"));return}this.atlasCtx.imageSmoothingEnabled=!1,this.atlasCtx.drawImage(n,0,0),this.atlasImage=n,this.isLoaded=!0,e()},n.onerror=()=>{URL.revokeObjectURL(r),i(new Error("Failed to load PNG image for atlas"))},n.src=r})}isReady(){return this.isLoaded}getGlyphPosition(t){if(t<0||t>this.maxCharCode)return null;let{col:e,row:i}=R(t,this.atlasBlocks);return{x:e*this.glyphWidth,y:i*this.glyphHeight}}getCharUV(t){if(t<0||t>this.maxCharCode)return null;let{col:e,row:i}=R(t,this.atlasBlocks),s=e/this.atlasColumns,a=i/this.atlasColumns,r=(e+1)/this.atlasColumns,n=(i+1)/this.atlasColumns;return{u1:s,v1:a,u2:r,v2:n}}drawChar(t,e,i,s,a,r,n){if(!this.isLoaded||!this.atlasCanvas)return;let h=this.getGlyphPosition(e);if(!h)return;let l=`${e}:${n}`,c=this.colorCache.get(l);if(c)c.lastUsed=performance.now();else{let m=this.createColoredGlyph(e,n,h);if(!m)return;c={canvas:m,lastUsed:performance.now()},this.colorCache.set(l,c),this.colorCache.size>this.MAX_CACHE_SIZE&&this.evictLRU()}if(t.imageSmoothingEnabled=!1,a===this.cellWidth&&r===this.cellHeight){let m=Math.floor((this.cellWidth-this.glyphWidth)/2),u=Math.floor((this.cellHeight-this.glyphHeight)/2);t.drawImage(c.canvas,Math.floor(i)+m,Math.floor(s)+u)}else{let m=a/this.cellWidth,u=r/this.cellHeight,C=Math.floor((this.cellWidth-this.glyphWidth)/2*m),b=Math.floor((this.cellHeight-this.glyphHeight)/2*u),p=Math.ceil(this.glyphWidth*m),v=Math.ceil(this.glyphHeight*u);t.drawImage(c.canvas,Math.floor(i)+C,Math.floor(s)+b,p,v)}}createColoredGlyph(t,e,i){if(!this.atlasCtx)return null;let s=this.atlasCtx.getImageData(i.x,i.y,this.glyphWidth,this.glyphHeight),a=s.data,r=this.parseColor(e);for(let l=0;l<a.length;l+=4)a[l+3]>0&&(a[l]=r.r,a[l+1]=r.g,a[l+2]=r.b);let n=document.createElement("canvas");n.width=this.glyphWidth,n.height=this.glyphHeight;let h=n.getContext("2d",{alpha:!0});return h?(h.putImageData(s,0,0),n):null}parseColor(t){if(t.startsWith("#")){let i=t.slice(1);return i.length===3&&(i=i[0]+i[0]+i[1]+i[1]+i[2]+i[2]),{r:parseInt(i.slice(0,2),16),g:parseInt(i.slice(2,4),16),b:parseInt(i.slice(4,6),16)}}let e=/rgba?\((\d+),\s*(\d+),\s*(\d+)/.exec(t);return e?{r:parseInt(e[1],10),g:parseInt(e[2],10),b:parseInt(e[3],10)}:{r:255,g:255,b:255}}evictLRU(){let t=null,e=1/0;for(let[i,s]of this.colorCache)s.lastUsed<e&&(e=s.lastUsed,t=i);if(t){let i=this.colorCache.get(t);i&&(i.canvas.width=0,i.canvas.height=0),this.colorCache.delete(t)}}getAtlasCanvas(){return this.atlasCanvas}getAtlasImage(){return this.atlasImage}getConfig(){return{glyphWidth:this.glyphWidth,glyphHeight:this.glyphHeight,cellWidth:this.cellWidth,cellHeight:this.cellHeight,atlasBlocks:this.atlasBlocks}}getGlyphDimensions(){return{width:this.glyphWidth,height:this.glyphHeight}}getCellDimensions(){return{width:this.cellWidth,height:this.cellHeight}}getAtlasDimensions(){return{width:this.atlasColumns*this.glyphWidth,height:this.atlasColumns*this.glyphHeight}}getAtlasColumns(){return this.atlasColumns}getMaxCharCode(){return this.maxCharCode}isValidCharCode(t){return t>=0&&t<=this.maxCharCode}clearCache(){for(let t of this.colorCache.values())t.canvas.width=0,t.canvas.height=0;this.colorCache.clear()}getCacheStats(){return{size:this.colorCache.size,maxSize:this.MAX_CACHE_SIZE}}destroy(){this.clearCache(),this.atlasCanvas&&(this.atlasCanvas.width=0,this.atlasCanvas.height=0,this.atlasCanvas=null),this.atlasCtx=null,this.atlasImage=null,this.isLoaded=!1}};f(B,"ImageFontAtlas");var M=B;var S=class S{constructor(t,e){o(this,"canvas");o(this,"ctx");o(this,"container");o(this,"cols",0);o(this,"rows",0);o(this,"cellWidth",0);o(this,"cellHeight",0);o(this,"offsetX",0);o(this,"offsetY",0);o(this,"strokeColor","rgba(80, 80, 80, 0.4)");o(this,"lineWidth",1);this.container=t,this.canvas=document.createElement("canvas"),this.canvas.className="grid-overlay-canvas";let i=e?.zIndex??10;this.canvas.style.cssText=`
+      display: block !important;
+      position: absolute !important;
+      pointer-events: none !important;
+      image-rendering: pixelated !important;
+      image-rendering: crisp-edges !important;
+      z-index: ${i} !important;
+    `,this.container.appendChild(this.canvas);let s=this.canvas.getContext("2d");if(!s)throw new Error("[GridOverlay] Impossible de cr\xE9er le contexte 2D");this.ctx=s,e&&(e.strokeColor&&(this.strokeColor=e.strokeColor),e.lineWidth!==void 0&&(this.lineWidth=e.lineWidth))}setDimensions(t,e,i,s,a=0,r=0){this.cols=t,this.rows=e,this.cellWidth=i,this.cellHeight=s,this.offsetX=a,this.offsetY=r}setCanvasSize(t,e){this.canvas.width=t,this.canvas.height=e,this.ctx.setTransform(1,0,0,1,0,0)}setStyle(t){t.strokeColor&&(this.strokeColor=t.strokeColor),t.lineWidth!==void 0&&(this.lineWidth=t.lineWidth)}setTransform(t,e,i,s,a){let r=s.left-a.left,n=s.top-a.top,h=s.width,l=s.height;(this.canvas.width!==h||this.canvas.height!==l)&&(this.canvas.width=h,this.canvas.height=l);let c=this.canvas.style;c.width=`${h}px`,c.height=`${l}px`,c.left=`${r}px`,c.top=`${n}px`}render(){if(!this.ctx)return;let t=this.cols*this.cellWidth,e=this.rows*this.cellHeight,i=t>0?this.canvas.width/t:1,s=e>0?this.canvas.height/e:1,a=Math.min(i,s),r=this.cellWidth*a,n=this.cellHeight*a,h=this.cols*r,l=this.rows*n,c=this.offsetX*a,g=this.offsetY*a;if(!(h===0||l===0)){this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height),this.ctx.strokeStyle=this.strokeColor,this.ctx.lineWidth=Math.max(1,this.lineWidth*a),this.ctx.beginPath();for(let m=0;m<=this.cols;m++){let u=c+m*r+.5;this.ctx.moveTo(u,g),this.ctx.lineTo(u,g+l)}for(let m=0;m<=this.rows;m++){let u=g+m*n+.5;this.ctx.moveTo(c,u),this.ctx.lineTo(c+h,u)}this.ctx.stroke()}}update(t,e,i,s,a,r,n=0,h=0){this.setDimensions(t,e,i,s,n,h),this.setCanvasSize(a,r),this.render()}setVisible(t){this.canvas.style.display=t?"block":"none"}destroy(){this.canvas.parentElement&&this.canvas.parentElement.removeChild(this.canvas)}getCanvas(){return this.canvas}};f(S,"GridOverlay");var w=S;var x=require("@utsp/types");var G=class G{constructor(t,e={}){o(this,"containerDiv");o(this,"canvas");o(this,"ctx");o(this,"parentElement");o(this,"cells");o(this,"cols",0);o(this,"rows",0);o(this,"fontSize");o(this,"fontFamily");o(this,"defaultFgColor");o(this,"defaultBgColor");o(this,"canvasBgColor");o(this,"cellWidth");o(this,"cellHeight");o(this,"offsetX",0);o(this,"offsetY",0);o(this,"fontType","web");o(this,"bitmapFont");o(this,"bitmapAtlas");o(this,"imageAtlas");o(this,"bitmapCharWidth",8);o(this,"bitmapCharHeight",8);o(this,"showDebugGrid");o(this,"debugGridColor");o(this,"gridOverlay");o(this,"fixedGridMode");o(this,"fixedCols");o(this,"fixedRows");o(this,"cellAspectRatio");o(this,"resizeObserver");o(this,"imageDataBuffer");o(this,"useImageDataRendering",!1);o(this,"paletteCache");o(this,"scalingMode",x.ScalingMode.None);o(this,"currentScale",1);if(!t)throw new Error("Render: L'\xE9l\xE9ment parent est requis");this.parentElement=t,this.fixedGridMode=!!(e.fixedCols&&e.fixedRows),this.fixedCols=e.fixedCols,this.fixedRows=e.fixedRows,this.cellAspectRatio=e.cellAspectRatio??10/14,this.cellWidth=e.cellWidth??10,this.cellHeight=e.cellHeight??14,this.fontSize=e.fontSize??12,this.fontFamily=e.fontFamily??"monospace",this.defaultFgColor=e.defaultFgColor??"#ffffff",this.defaultBgColor=e.defaultBgColor??"#000000",this.canvasBgColor=e.canvasBgColor!==void 0?e.canvasBgColor:null,this.showDebugGrid=e.showDebugGrid??!1,this.debugGridColor=e.debugGridColor??"rgba(144, 24, 24, 1)",this.scalingMode=e.scalingMode??x.ScalingMode.None,window.getComputedStyle(this.parentElement).position==="static"&&(this.parentElement.style.position="relative"),this.containerDiv=document.createElement("div"),this.containerDiv.className="terminal2d-container",this.containerDiv.style.cssText=`
+      position: absolute !important;
+      top: 0 !important;
+      left: 0 !important;
+      right: 0 !important;
+      bottom: 0 !important;
+      width: 100% !important;
+      height: 100% !important;
+      overflow: visible !important;
+      contain: layout style !important;
+      display: flex !important;
+      justify-content: center !important;
+      align-items: center !important;
+      isolation: isolate !important;
+    `,this.canvas=document.createElement("canvas"),this.canvas.className="terminal2d-canvas",e.className&&(this.canvas.className+=" "+e.className),e.style&&Object.assign(this.canvas.style,e.style),this.canvas.style.imageRendering="pixelated",this.canvas.style.imageRendering="crisp-edges",this.containerDiv.appendChild(this.canvas),this.parentElement.appendChild(this.containerDiv);let s=this.canvas.getContext("2d",{alpha:!0,desynchronized:!1});if(!s)throw new Error("UTSPRender: Impossible d'obtenir le contexte 2D du canvas");this.ctx=s,this.ctx.imageSmoothingEnabled=!1,this.calculateGridSize(),this.cells=this.createEmptyGrid(),this.showDebugGrid&&(this.gridOverlay=new w(this.parentElement,{strokeColor:this.debugGridColor,lineWidth:1,zIndex:10})),this.enableAutoResize(),this.render()}calculateGridSize(){let t=this.parentElement.clientWidth||800,e=this.parentElement.clientHeight||600,i,s;if(this.fontType==="image"&&this.imageAtlas){let g=this.imageAtlas.getCellDimensions();i=g.width,s=g.height}else this.fontType==="bitmap"?(i=this.bitmapCharWidth,s=this.bitmapCharHeight):(i=Math.round(this.cellWidth)||10,s=Math.round(this.cellHeight)||14);this.cellWidth=Math.round(i),this.cellHeight=Math.round(s),this.fixedGridMode&&this.fixedCols&&this.fixedRows?(this.cols=this.fixedCols,this.rows=this.fixedRows):(this.cols=Math.floor(t/this.cellWidth)||1,this.rows=Math.floor(e/this.cellHeight)||1);let a=this.cols*this.cellWidth,r=this.rows*this.cellHeight,n=t/a,h=e/r,l=Math.min(n,h),c;switch(this.scalingMode){case x.ScalingMode.Integer:c=Math.max(1,Math.floor(l));break;case x.ScalingMode.Half:c=Math.max(.5,Math.floor(l*2)/2);break;case x.ScalingMode.Quarter:c=Math.max(.25,Math.floor(l*4)/4);break;case x.ScalingMode.Eighth:c=Math.max(.125,Math.floor(l*8)/8);break;case x.ScalingMode.None:default:c=Math.max(.1,l);break}this.currentScale=c,this.canvas.width=a,this.canvas.height=r,this.ctx.imageSmoothingEnabled=!1,this.canvas.style.cssText=`
+      flex-shrink: 0 !important;
+      flex-grow: 0 !important;
+      width: ${a}px !important;
+      height: ${r}px !important;
+      image-rendering: pixelated !important;
+      image-rendering: crisp-edges !important;
+      -ms-interpolation-mode: nearest-neighbor !important;
+      transform-origin: center center !important;
+      transform: scale(${c}) !important;
+      will-change: transform !important;
+      backface-visibility: hidden !important;
+    `,this.fontType==="web"&&(this.fontSize=Math.round(this.cellHeight/14*12)),this.offsetX=0,this.offsetY=0}createEmptyGrid(){let t=[];for(let e=0;e<this.rows;e++){let i=[];for(let s=0;s<this.cols;s++)i.push({char:" ",fgColor:this.defaultFgColor,bgColor:this.defaultBgColor});t.push(i)}return t}enableAutoResize(){this.resizeObserver=new ResizeObserver(()=>{let t=this.cols,e=this.rows;if(this.calculateGridSize(),this.cols!==t||this.rows!==e){let i=this.cells;this.cells=this.createEmptyGrid();let s=Math.min(t,this.cols),a=Math.min(e,this.rows);for(let r=0;r<a;r++)for(let n=0;n<s;n++)this.cells[r][n]=i[r][n]}this.render()}),this.resizeObserver.observe(this.parentElement)}setCell(t,e,i,s,a){if(e<0||e>=this.rows||t<0||t>=this.cols)return;let r=i&&typeof i=="string"?i.charAt(0):" ";this.cells[e][t]={char:r,fgColor:s??this.defaultFgColor,bgColor:a??this.defaultBgColor}}getCell(t,e){return e<0||e>=this.rows||t<0||t>=this.cols?null:this.cells[e][t]}write(t,e,i,s,a){for(let r=0;r<i.length;r++)this.setCell(t+r,e,i[r],s,a)}fillRect(t,e,i,s,a=" ",r,n){for(let h=e;h<e+s;h++)for(let l=t;l<t+i;l++)this.setCell(l,h,a,r,n)}clear(){this.cells=this.createEmptyGrid()}setFromArray(t){let e=t.width*t.height;if(t.cells.length!==e)throw new Error(`Invalid array length: expected ${e} (${t.width}\xD7${t.height}), got ${t.cells.length}`);let i=0;for(let s=0;s<t.height;s++)for(let a=0;a<t.width;a++){let r=t.cells[i];s<this.rows&&a<this.cols&&this.setCell(a,s,r.char,r.fgColor,r.bgColor),i++}}render(){if(this.fontType==="bitmap"&&this.bitmapFont&&this.useImageDataRendering){this.renderWithImageData();return}this.renderClassic()}renderWithImageData(){if(!this.bitmapFont)return;let t=this.cols*this.bitmapCharWidth,e=this.rows*this.bitmapCharHeight;(!this.imageDataBuffer||this.imageDataBuffer.width!==t||this.imageDataBuffer.height!==e)&&(this.imageDataBuffer=this.ctx.createImageData(t,e));let i=this.imageDataBuffer.data;for(let h=0;h<this.rows;h++)for(let l=0;l<this.cols;l++){let c=this.cells[h][l],g=this.parseColorToRGB(c.bgColor),m=this.parseColorToRGB(c.fgColor),u=c.char.charCodeAt(0),C=this.bitmapFont.get(u);for(let b=0;b<this.bitmapCharHeight;b++)for(let p=0;p<this.bitmapCharWidth;p++){let v=l*this.bitmapCharWidth+p,y=((h*this.bitmapCharHeight+b)*t+v)*4,F=!1;if(C&&b<C.length){let $=C[b],U=1<<7-p;F=($&U)!==0}F?(i[y]=m.r,i[y+1]=m.g,i[y+2]=m.b,i[y+3]=m.a):(i[y]=g.r,i[y+1]=g.g,i[y+2]=g.b,i[y+3]=g.a)}}this.canvasBgColor!==null?(this.ctx.fillStyle=this.canvasBgColor,this.ctx.fillRect(0,0,this.canvas.width,this.canvas.height)):this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height),this.ctx.imageSmoothingEnabled=!1,this.canvas.style.imageRendering="pixelated",this.canvas.style.imageRendering="crisp-edges";let s=document.createElement("canvas");s.width=t,s.height=e,s.getContext("2d").putImageData(this.imageDataBuffer,0,0);let r=this.cols*this.cellWidth,n=this.rows*this.cellHeight;this.ctx.drawImage(s,0,0,t,e,this.offsetX,this.offsetY,r,n),this.showDebugGrid&&this.drawDebugGrid()}parseColorToRGB(t){let e=/rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*([\d.]+))?\)/.exec(t);if(e)return{r:parseInt(e[1],10),g:parseInt(e[2],10),b:parseInt(e[3],10),a:e[4]?Math.round(parseFloat(e[4])*255):255};if(t.startsWith("#")){let a=/^#?([a-f\d])([a-f\d])([a-f\d])$/i;t=t.replace(a,(n,h,l,c)=>h+h+l+l+c+c);let r=/^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(t);if(r)return{r:parseInt(r[1],16),g:parseInt(r[2],16),b:parseInt(r[3],16),a:255}}let s={white:[255,255,255],black:[0,0,0],red:[255,0,0],green:[0,255,0],blue:[0,0,255],yellow:[255,255,0],cyan:[0,255,255],magenta:[255,0,255],transparent:[0,0,0]}[t.toLowerCase()];return s?{r:s[0],g:s[1],b:s[2],a:t==="transparent"?0:255}:{r:255,g:255,b:255,a:255}}renderClassic(){this.canvasBgColor!==null?(this.ctx.fillStyle=this.canvasBgColor,this.ctx.fillRect(0,0,this.canvas.width,this.canvas.height)):this.ctx.clearRect(0,0,this.canvas.width,this.canvas.height),this.fontType==="bitmap"||this.fontType==="image"?(this.ctx.imageSmoothingEnabled=!1,this.canvas.style.imageRendering="pixelated",this.canvas.style.imageRendering="crisp-edges"):(this.ctx.imageSmoothingEnabled=!0,this.ctx.imageSmoothingQuality="high",this.canvas.style.imageRendering="auto",this.ctx.font=`${this.fontSize}px ${this.fontFamily}`,this.ctx.textBaseline="top",this.ctx.textRendering="optimizeLegibility");for(let t=0;t<this.rows;t++)for(let e=0;e<this.cols;e++){let i=this.cells[t][e],s=Math.floor(this.offsetX+e*this.cellWidth),a=Math.floor(this.offsetY+t*this.cellHeight),r=Math.floor(this.offsetX+(e+1)*this.cellWidth),n=Math.floor(this.offsetY+(t+1)*this.cellHeight),h=r-s,l=n-a;if((this.canvasBgColor!==null||i.bgColor!==this.defaultBgColor)&&(this.ctx.fillStyle=i.bgColor,this.ctx.fillRect(s,a,h,l)),i.char!==" ")if(this.fontType==="image"&&this.imageAtlas){let g=i.char.charCodeAt(0);this.imageAtlas.drawChar(this.ctx,g,s,a,h,l,i.fgColor)}else if(this.fontType==="bitmap"&&this.bitmapFont)this.drawBitmapChar(i.char,s,a,h,l,i.fgColor);else{this.ctx.fillStyle=i.fgColor;let g=s+(h-this.ctx.measureText(i.char).width)/2,m=a+(l-this.fontSize)/2;this.ctx.fillText(i.char,g,m)}}this.showDebugGrid&&this.drawDebugGrid()}drawBitmapChar(t,e,i,s,a,r){let n=t.charCodeAt(0);if(this.bitmapAtlas){this.bitmapAtlas.drawChar(this.ctx,n,e,i,s,a,r);return}if(!this.bitmapFont)return;let h=this.bitmapFont.get(n);if(!h)return;let l=s/this.bitmapCharWidth,c=a/this.bitmapCharHeight;this.ctx.fillStyle=r;for(let g=0;g<Math.min(h.length,this.bitmapCharHeight);g++){let m=h[g],u=i+g*c,C=i+(g+1)*c;for(let b=0;b<this.bitmapCharWidth;b++){let p=1<<7-b;if(m&p){let v=e+b*l,k=e+(b+1)*l;this.ctx.fillRect(v,u,k-v,C-u)}}}}drawDebugGrid(){if(!this.gridOverlay)return;let t=this.parentElement.clientWidth||800,e=this.parentElement.clientHeight||600;this.gridOverlay.update(this.cols,this.rows,this.cellWidth,this.cellHeight,t,e,this.offsetX,this.offsetY)}getCanvas(){return this.canvas}getContext(){return this.ctx}getDimensions(){return{cols:this.cols,rows:this.rows}}getCellDimensions(){return{cellWidth:this.cellWidth,cellHeight:this.cellHeight}}getCellWidth(){return this.cellWidth}getCellHeight(){return this.cellHeight}getCurrentScale(){return this.currentScale}getScalingMode(){return this.scalingMode}getOffsets(){return{offsetX:this.offsetX,offsetY:this.offsetY}}setDebugGrid(t){this.showDebugGrid=t,t&&!this.gridOverlay?(this.gridOverlay=new w(this.parentElement,{strokeColor:this.debugGridColor,lineWidth:1,zIndex:10}),this.drawDebugGrid()):!t&&this.gridOverlay?(this.gridOverlay.destroy(),this.gridOverlay=void 0):t&&this.gridOverlay&&this.gridOverlay.setVisible(!0)}setCanvasBackgroundColor(t){this.canvasBgColor=t}getCanvasBackgroundColor(){return this.canvasBgColor}setFixedGrid(t,e,i){this.fixedGridMode=!0,this.fixedCols=t,this.fixedRows=e,i!==void 0&&(this.cellAspectRatio=i);let s=this.cols,a=this.rows,r=this.cells;if(this.calculateGridSize(),this.cols!==s||this.rows!==a){this.cells=this.createEmptyGrid();let n=Math.min(s,this.cols),h=Math.min(a,this.rows);for(let l=0;l<h;l++)for(let c=0;c<n;c++)this.cells[l][c]=r[l][c]}this.render()}setAdaptiveGrid(t,e){this.fixedGridMode=!1,this.fixedCols=void 0,this.fixedRows=void 0,t!==void 0&&(this.cellWidth=t),e!==void 0&&(this.cellHeight=e);let i=this.cols,s=this.rows,a=this.cells;if(this.calculateGridSize(),this.cols!==i||this.rows!==s){this.cells=this.createEmptyGrid();let r=Math.min(i,this.cols),n=Math.min(s,this.rows);for(let h=0;h<n;h++)for(let l=0;l<r;l++)this.cells[h][l]=a[h][l]}this.render()}isFixedGridMode(){return this.fixedGridMode}setDebugGridColor(t){this.debugGridColor=t}isDebugGridEnabled(){return this.showDebugGrid}setImageDataRendering(t){this.useImageDataRendering=t,t&&this.fontType==="bitmap"?console.warn("[Render] ImageData rendering enabled (optimized for benchmarks)"):t&&(console.warn("[Render] ImageData rendering requires bitmap font, keeping classic mode"),this.useImageDataRendering=!1)}isImageDataRenderingEnabled(){return this.useImageDataRendering}setWebFont(t,e){this.fontType="web",this.fontFamily=t,e!==void 0&&(this.fontSize=e),this.bitmapFont=void 0,this.bitmapAtlas=void 0,this.useImageDataRendering=!1,this.calculateGridSize(),this.cells=this.createEmptyGrid()}setBitmapFont(t,e,i,s,a){this.fontType="bitmap",this.bitmapFont=t,this.bitmapCharWidth=e,this.bitmapCharHeight=i,this.bitmapAtlas=new H(t,e,i,s,a),this.cellWidth=s,this.cellHeight=a,this.calculateGridSize(),this.cells=this.createEmptyGrid()}async setImageFont(t,e,i,s,a,r){this.fontType="image",this.imageAtlas=new M({glyphWidth:e,glyphHeight:i,cellWidth:s,cellHeight:a,atlasBlocks:r}),await this.imageAtlas.loadFromPNG(t),this.cellWidth=s,this.cellHeight=a,this.bitmapCharWidth=e,this.bitmapCharHeight=i,this.calculateGridSize(),this.cells=this.createEmptyGrid()}getFontType(){return this.fontType}getBitmapFont(){return this.bitmapFont}getBitmapCharDimensions(){return this.fontType!=="bitmap"?null:{width:this.bitmapCharWidth,height:this.bitmapCharHeight}}setPalette(t){this.paletteCache=t}renderDisplayData(t){if(!t||!t.cells||t.cells.length===0){console.warn("[Terminal2D] Empty display data");return}if(t.width===0||t.height===0){console.warn("[Terminal2D] Invalid display dimensions:",t.width,t.height);return}(t.width!==this.cols||t.height!==this.rows)&&this.setFixedGrid(t.width,t.height,this.cellAspectRatio);let e=this.paletteCache??t.palette;if(!e||e.length===0){console.error("[Terminal2D] No palette available (neither cached nor in display)");return}let i=f(s=>{if(s==null||isNaN(s))return console.warn("[Terminal2D] Invalid palette index (undefined/null/NaN):",s),this.defaultFgColor;if(s===255)return"rgba(0, 0, 0, 0)";if(s<0||s>=e.length)return console.warn(`[Terminal2D] Invalid palette index: ${s}`),this.defaultFgColor;let a=e[s];return!a||typeof a.r!="number"?(console.warn(`[Terminal2D] Corrupted palette entry at index ${s}:`,a),this.defaultFgColor):`rgba(${a.r}, ${a.g}, ${a.b}, ${a.a/255})`},"convertColor");for(let s=0;s<t.height&&s<this.rows;s++)for(let a=0;a<t.width&&a<this.cols;a++){let r=s*t.width+a;if(r>=t.cells.length)break;let n=t.cells[r];if(!n)continue;let h=i(n.fgColorIndex),l=i(n.bgColorIndex);this.setCell(a,s,n.char??" ",h,l)}this.render()}isReady(){return!0}getCols(){return this.cols}getRows(){return this.rows}resize(t,e){this.setFixedGrid(t,e)}destroy(){this.resizeObserver&&(this.resizeObserver.disconnect(),this.resizeObserver=void 0),this.gridOverlay&&(this.gridOverlay.destroy(),this.gridOverlay=void 0),this.containerDiv.parentElement&&this.containerDiv.parentElement.removeChild(this.containerDiv)}};f(G,"Terminal2D");var A=G;var I=["#000000","#800000","#008000","#808000","#000080","#800080","#008080","#c0c0c0","#808080","#ff0000","#00ff00","#ffff00","#0000ff","#ff00ff","#00ffff","#ffffff","#080808","#121212","#1c1c1c","#262626","#303030","#3a3a3a","#444444","#4e4e4e","#585858","#626262","#6c6c6c","#767676","#808080","#8a8a8a","#949494","#9e9e9e","#a80000","#00a800","#a8a800","#0000a8","#a800a8","#00a8a8","#a8a8a8","#545454","#fc5454","#54fc54","#fcfc54","#5454fc","#fc54fc","#54fcfc","#fcfcfc","#000000",...Array(192).fill("#808080")];function z(d,t=I){return d<0||d>=t.length?"#ff00ff":t[d]}f(z,"paletteIndexToColor");function L(d,t=I){let e=t.indexOf(d.toLowerCase());return e>=0?e:0}f(L,"colorToPaletteIndex");var O=require("@utsp/types");