ascii-shape-renderer 1.0.0

package/dist/browser.js

@@ -0,0 +1,499 @@
+"use strict";
+/**
+ * ASCII Shape Renderer - Browser Bundle
+ * Simple drop-in library for rendering images/video as ASCII art
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.image = image;
+exports.video = video;
+exports.webcam = webcam;
+// Core algorithm (inlined for single-file distribution)
+const BASE_CW = 8, BASE_CH = 14, CIRCLE_R = 0.18;
+const CHARS = ' !"#$%&\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_`abcdefghijklmnopqrstuvwxyz{|}~';
+const INT_POS = [{ x: .25, y: .20 }, { x: .75, y: .13 }, { x: .25, y: .50 }, { x: .75, y: .50 }, { x: .25, y: .80 }, { x: .75, y: .87 }];
+const EXT_POS = [{ x: .25, y: -.15 }, { x: .75, y: -.15 }, { x: -.15, y: .20 }, { x: 1.15, y: .13 }, { x: -.15, y: .50 }, { x: 1.15, y: .50 }, { x: -.15, y: .80 }, { x: 1.15, y: .87 }, { x: .25, y: 1.15 }, { x: .75, y: 1.15 }];
+const AFFECT = [[0, 1, 2, 4], [0, 1, 3, 5], [2, 4, 6], [3, 5, 7], [4, 6, 8, 9], [5, 7, 8, 9]];
+let shapeVecs = [];
+let kdTree = null;
+let initialized = false;
+// Worker pool for offloading rendering
+let workerPool = [];
+let workerIndex = 0;
+let pendingCallbacks = new Map();
+let messageId = 0;
+function getWorker() {
+    if (typeof Worker === 'undefined')
+        return null;
+    if (workerPool.length === 0) {
+        // Create inline worker from blob
+        const workerCode = `${WORKER_CODE}`;
+        try {
+            const blob = new Blob([workerCode], { type: 'application/javascript' });
+            const url = URL.createObjectURL(blob);
+            const numWorkers = Math.min(navigator.hardwareConcurrency || 4, 4);
+            for (let i = 0; i < numWorkers; i++) {
+                const w = new Worker(url);
+                w.onmessage = (e) => {
+                    const cb = pendingCallbacks.get(e.data.id);
+                    if (cb) {
+                        pendingCallbacks.delete(e.data.id);
+                        cb(e.data);
+                    }
+                };
+                workerPool.push(w);
+            }
+            console.log(`[AsciiRenderer] Using ${numWorkers} Web Workers for rendering`);
+        }
+        catch (e) {
+            console.log('[AsciiRenderer] Web Workers unavailable, using main thread');
+            return null;
+        }
+    }
+    const worker = workerPool[workerIndex];
+    workerIndex = (workerIndex + 1) % workerPool.length;
+    return worker;
+}
+function renderInWorker(data, width, height, options) {
+    return new Promise((resolve) => {
+        const worker = getWorker();
+        if (!worker) {
+            // Fallback to main thread
+            init();
+            resolve(renderFrame({ data, width, height }, options));
+            return;
+        }
+        const id = messageId++;
+        pendingCallbacks.set(id, resolve);
+        worker.postMessage({ type: 'render', id, data, width, height, options }, [data.buffer]);
+    });
+}
+// Inline worker code as string
+const WORKER_CODE = `
+const BASE_CW=8,BASE_CH=14,CIRCLE_R=.18,CHARS=' !"#$%&\\'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\\\]^` + "`" + `_abcdefghijklmnopqrstuvwxyz{|}~',INT_POS=[{x:.25,y:.2},{x:.75,y:.13},{x:.25,y:.5},{x:.75,y:.5},{x:.25,y:.8},{x:.75,y:.87}],EXT_POS=[{x:.25,y:-.15},{x:.75,y:-.15},{x:-.15,y:.2},{x:1.15,y:.13},{x:-.15,y:.5},{x:1.15,y:.5},{x:-.15,y:.8},{x:1.15,y:.87},{x:.25,y:1.15},{x:.75,y:1.15}],AFFECT=[[0,1,2,4],[0,1,3,5],[2,4,6],[3,5,7],[4,6,8,9],[5,7,8,9]];let shapeVecs=[],kdTree=null;const cache=new Map;function init(){if(kdTree)return;const c=new OffscreenCanvas(BASE_CW,BASE_CH),ctx=c.getContext("2d",{willReadFrequently:true});for(const ch of CHARS){ctx.fillStyle="#000",ctx.fillRect(0,0,BASE_CW,BASE_CH),ctx.fillStyle="#fff",ctx.font=BASE_CH+"px monospace",ctx.textBaseline="top",ctx.textAlign="center",ctx.fillText(ch,BASE_CW/2,0);const d=ctx.getImageData(0,0,BASE_CW,BASE_CH),v=INT_POS.map(p=>sampleC(d,p.x*BASE_CW,p.y*BASE_CH,CIRCLE_R*BASE_CH));shapeVecs.push({ch,v})}const max=[0,0,0,0,0,0];shapeVecs.forEach(({v})=>v.forEach((x,i)=>max[i]=Math.max(max[i],x))),shapeVecs=shapeVecs.map(({ch,v})=>({ch,v:v.map((x,i)=>max[i]?x/max[i]:0)})),kdTree=buildKd(shapeVecs)}function sampleC(d,cx,cy,r){let t=0,c=0;for(let dy=-r;dy<=r;dy++)for(let dx=-r;dx<=r;dx++)dx*dx+dy*dy<=r*r&&(x=~~(cx+dx),y=~~(cy+dy),x>=0&&x<d.width&&y>=0&&y<d.height&&(t+=d.data[(y*d.width+x)*4]/255,c++));return c?t/c:0}function buildKd(items,depth=0){if(!items.length)return null;const a=depth%6;items.sort((x,y)=>x.v[a]-y.v[a]);const m=items.length>>1;return{item:items[m],left:buildKd(items.slice(0,m),depth+1),right:buildKd(items.slice(m+1),depth+1),axis:a}}function findNear(n,t,best={dist:1/0,ch:" "}){if(!n)return best;const d=n.item.v.reduce((s,x,i)=>s+(x-t[i])**2,0);d<best.dist&&(best={dist:d,ch:n.item.ch});const diff=t[n.axis]-n.item.v[n.axis];return best=findNear(diff<0?n.left:n.right,t,best),diff*diff<best.dist&&(best=findNear(diff<0?n.right:n.left,t,best)),best}function contrast(int,ext,gE,dE){let v=int.map((val,i)=>{if(dE<=1)return val;let m=val;for(const e of AFFECT[i])m=Math.max(m,ext[e]);return m?Math.pow(val/m,dE)*m:val});if(gE>1){const m=Math.max(...v);m&&(v=v.map(x=>Math.pow(x/m,gE)*m))}return v}function sampleImg(data,w,h,cx,cy,r){let t=0,c=0;for(let dy=-r;dy<=r;dy+=2)for(let dx=-r;dx<=r;dx+=2)dx*dx+dy*dy<=r*r&&(x=~~(cx+dx),y=~~(cy+dy),x>=0&&x<w&&y>=0&&y<h&&(i=(y*w+x)*4,t+=.2126*data[i]/255+.7152*data[i+1]/255+.0722*data[i+2]/255,c++));return c?t/c:0}function sampleClr(data,w,h,cx,cy,cw,ch){let r=0,g=0,b=0,c=0;for(let dy=ch*.25;dy<ch*.75;dy+=2)for(let dx=cw*.25;dx<cw*.75;dx+=2){const x=~~(cx+dx),y=~~(cy+dy);x>=0&&x<w&&y>=0&&y<h&&(i=(y*w+x)*4,r+=data[i],g+=data[i+1],b+=data[i+2],c++)}return c?"#"+[r,g,b].map(v=>(~~(v/c)).toString(16).padStart(2,"0")).join(""):"#000"}function darken(h,a){return"#"+[1,3,5].map(i=>(~~(parseInt(h.slice(i,i+2),16)*(1-a))).toString(16).padStart(2,"0")).join("")}function renderFrame(data,w,h,opts){const gE=opts.globalContrast??2,dE=opts.directionalContrast??3,colorMode=opts.colorMode??"none",cols=Math.round(w/BASE_CW),rows=Math.round(h/BASE_CH),cW=w/cols,cH=h/rows,r=CIRCLE_R*cH;cache.clear();let html="";for(let row=0;row<rows;row++){for(let col=0;col<cols;col++){const cx=col*cW,cy=row*cH,int=INT_POS.map(p=>sampleImg(data,w,h,cx+p.x*cW,cy+p.y*cH,r)),ext=EXT_POS.map(p=>sampleImg(data,w,h,cx+p.x*cW,cy+p.y*cH,r)),enh=contrast(int,ext,gE,dE),key=enh.map(v=>~~(31*v)).join(",");cache.has(key)||cache.set(key,findNear(kdTree,enh).ch);let ch=cache.get(key);"<"===ch?ch="&lt;":">"===ch?ch="&gt;":"&"===ch&&(ch="&amp;"),"none"===colorMode?html+=ch:(clr=sampleClr(data,w,h,cx,cy,cW,cH),st=[],"fg"!==colorMode&&"both"!==colorMode||st.push("color:"+clr),"bg"!==colorMode&&"both"!==colorMode||st.push("background:"+darken(clr,.5)),html+='<span style="'+st.join(";")+'">'+ch+"</span>")}html+="\\n"}return{html,cols,rows}}self.onmessage=e=>{if("render"===e.data.type){init();const{id,data,width,height,options}=e.data,result=renderFrame(data,width,height,options);self.postMessage({id,...result})}};
+`;
+function init() {
+    if (initialized)
+        return;
+    const c = document.createElement('canvas');
+    c.width = BASE_CW;
+    c.height = BASE_CH;
+    const ctx = c.getContext('2d', { willReadFrequently: true });
+    for (const ch of CHARS) {
+        ctx.fillStyle = '#000';
+        ctx.fillRect(0, 0, BASE_CW, BASE_CH);
+        ctx.fillStyle = '#fff';
+        ctx.font = `${BASE_CH}px monospace`;
+        ctx.textBaseline = 'top';
+        ctx.textAlign = 'center';
+        ctx.fillText(ch, BASE_CW / 2, 0);
+        const d = ctx.getImageData(0, 0, BASE_CW, BASE_CH);
+        const v = INT_POS.map(p => sampleCircle(d, p.x * BASE_CW, p.y * BASE_CH, CIRCLE_R * BASE_CH));
+        shapeVecs.push({ ch, v });
+    }
+    const max = [0, 0, 0, 0, 0, 0];
+    shapeVecs.forEach(({ v }) => v.forEach((x, i) => max[i] = Math.max(max[i], x)));
+    shapeVecs = shapeVecs.map(({ ch, v }) => ({ ch, v: v.map((x, i) => max[i] ? x / max[i] : 0) }));
+    kdTree = buildKd(shapeVecs);
+    initialized = true;
+}
+function sampleCircle(d, cx, cy, r) {
+    let t = 0, c = 0;
+    for (let dy = -r; dy <= r; dy++)
+        for (let dx = -r; dx <= r; dx++)
+            if (dx * dx + dy * dy <= r * r) {
+                const x = ~~(cx + dx), y = ~~(cy + dy);
+                if (x >= 0 && x < d.width && y >= 0 && y < d.height) {
+                    t += d.data[(y * d.width + x) * 4] / 255;
+                    c++;
+                }
+            }
+    return c ? t / c : 0;
+}
+function buildKd(items, depth = 0) {
+    if (!items.length)
+        return null;
+    const a = depth % 6;
+    items.sort((x, y) => x.v[a] - y.v[a]);
+    const m = items.length >> 1;
+    return { item: items[m], left: buildKd(items.slice(0, m), depth + 1), right: buildKd(items.slice(m + 1), depth + 1), axis: a };
+}
+function findNear(n, t, best = { dist: Infinity, ch: ' ' }) {
+    if (!n)
+        return best;
+    const d = n.item.v.reduce((s, x, i) => s + (x - t[i]) ** 2, 0);
+    if (d < best.dist)
+        best = { dist: d, ch: n.item.ch };
+    const diff = t[n.axis] - n.item.v[n.axis];
+    best = findNear(diff < 0 ? n.left : n.right, t, best);
+    if (diff * diff < best.dist)
+        best = findNear(diff < 0 ? n.right : n.left, t, best);
+    return best;
+}
+function contrast(int, ext, gE, dE) {
+    let v = int.map((val, i) => {
+        if (dE <= 1)
+            return val;
+        let m = val;
+        for (const e of AFFECT[i])
+            m = Math.max(m, ext[e]);
+        return m ? Math.pow(val / m, dE) * m : val;
+    });
+    if (gE > 1) {
+        const m = Math.max(...v);
+        if (m)
+            v = v.map(x => Math.pow(x / m, gE) * m);
+    }
+    return v;
+}
+function sampleImg(d, cx, cy, r) {
+    let t = 0, c = 0;
+    for (let dy = -r; dy <= r; dy += 2)
+        for (let dx = -r; dx <= r; dx += 2)
+            if (dx * dx + dy * dy <= r * r) {
+                const x = ~~(cx + dx), y = ~~(cy + dy);
+                if (x >= 0 && x < d.width && y >= 0 && y < d.height) {
+                    const i = (y * d.width + x) * 4;
+                    t += .2126 * d.data[i] / 255 + .7152 * d.data[i + 1] / 255 + .0722 * d.data[i + 2] / 255;
+                    c++;
+                }
+            }
+    return c ? t / c : 0;
+}
+function sampleClr(d, cx, cy, cw, ch) {
+    let r = 0, g = 0, b = 0, c = 0;
+    for (let dy = ch * .25; dy < ch * .75; dy += 2)
+        for (let dx = cw * .25; dx < cw * .75; dx += 2) {
+            const x = ~~(cx + dx), y = ~~(cy + dy);
+            if (x >= 0 && x < d.width && y >= 0 && y < d.height) {
+                const i = (y * d.width + x) * 4;
+                r += d.data[i];
+                g += d.data[i + 1];
+                b += d.data[i + 2];
+                c++;
+            }
+        }
+    return c ? '#' + [r, g, b].map(v => (~~(v / c)).toString(16).padStart(2, '0')).join('') : '#000';
+}
+function darken(h, a) {
+    return '#' + [1, 3, 5].map(i => (~~(parseInt(h.slice(i, i + 2), 16) * (1 - a))).toString(16).padStart(2, '0')).join('');
+}
+const cache = new Map();
+function renderFrame(imgData, opts) {
+    const gE = opts.globalContrast ?? 2;
+    const dE = opts.directionalContrast ?? 3;
+    const colorMode = opts.colorMode ?? 'none';
+    const cols = Math.round(imgData.width / BASE_CW);
+    const rows = Math.round(imgData.height / BASE_CH);
+    const cW = imgData.width / cols, cH = imgData.height / rows;
+    const r = CIRCLE_R * cH;
+    cache.clear();
+    let html = '';
+    for (let row = 0; row < rows; row++) {
+        for (let col = 0; col < cols; col++) {
+            const cx = col * cW, cy = row * cH;
+            const int = INT_POS.map(p => sampleImg(imgData, cx + p.x * cW, cy + p.y * cH, r));
+            const ext = EXT_POS.map(p => sampleImg(imgData, cx + p.x * cW, cy + p.y * cH, r));
+            const enh = contrast(int, ext, gE, dE);
+            const key = enh.map(v => ~~(v * 31)).join(',');
+            if (!cache.has(key))
+                cache.set(key, findNear(kdTree, enh).ch);
+            let ch = cache.get(key);
+            if (ch === '<')
+                ch = '&lt;';
+            else if (ch === '>')
+                ch = '&gt;';
+            else if (ch === '&')
+                ch = '&amp;';
+            if (colorMode === 'none') {
+                html += ch;
+            }
+            else {
+                const clr = sampleClr(imgData, cx, cy, cW, cH);
+                const st = [];
+                if (colorMode === 'fg' || colorMode === 'both')
+                    st.push(`color:${clr}`);
+                if (colorMode === 'bg' || colorMode === 'both')
+                    st.push(`background:${darken(clr, .5)}`);
+                html += `<span style="${st.join(';')}">${ch}</span>`;
+            }
+        }
+        html += '\n';
+    }
+    return html;
+}
+// Get element from selector or element
+function getEl(el) {
+    return typeof el === 'string' ? document.querySelector(el) : el;
+}
+// Create output pre element
+function createOutput(container, colorMode) {
+    const pre = document.createElement('pre');
+    pre.style.cssText = 'margin:0;line-height:1;font-family:monospace;white-space:pre;';
+    if (colorMode === 'none')
+        pre.style.color = '#0f0';
+    pre.style.background = '#000';
+    container.innerHTML = '';
+    container.appendChild(pre);
+    return pre;
+}
+/**
+ * Render an image as ASCII art
+ */
+function image(source, container, options = {}) {
+    init();
+    const containerEl = getEl(container);
+    const output = createOutput(containerEl, options.colorMode ?? 'none');
+    const canvas = document.createElement('canvas');
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    let img;
+    let currentOpts = { ...options };
+    function render() {
+        const maxW = currentOpts.maxWidth ?? 800;
+        const scale = Math.min(1, maxW / img.width);
+        canvas.width = ~~(img.width * scale);
+        canvas.height = ~~(img.height * scale);
+        ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+        const imgData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+        const html = renderFrame(imgData, currentOpts);
+        // Calculate cols for font sizing
+        const cols = Math.round(canvas.width / BASE_CW);
+        const containerWidth = containerEl.clientWidth - 16; // padding
+        const fontSize = containerWidth / (cols * 0.6);
+        output.style.fontSize = fontSize + 'px';
+        output.innerHTML = html;
+        if (currentOpts.colorMode === 'none')
+            output.style.color = '#0f0';
+        else
+            output.style.color = '';
+    }
+    function load(src) {
+        if (typeof src === 'string') {
+            img = new Image();
+            img.crossOrigin = 'anonymous';
+            img.onload = render;
+            img.src = src;
+        }
+        else {
+            img = src;
+            render();
+        }
+    }
+    load(source);
+    return {
+        update(opts) {
+            if (opts)
+                currentOpts = { ...currentOpts, ...opts };
+            if (img)
+                render();
+        },
+        destroy() {
+            containerEl.innerHTML = '';
+        }
+    };
+}
+/**
+ * Render a video as ASCII art
+ */
+function video(source, container, options = {}) {
+    init();
+    const containerEl = getEl(container);
+    const output = createOutput(containerEl, options.colorMode ?? 'none');
+    const canvas = document.createElement('canvas');
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    const vid = document.createElement('video');
+    vid.playsInline = true;
+    vid.muted = true; // Must be muted for autoplay to work
+    vid.loop = true;
+    let currentOpts = { ...options };
+    let playing = false;
+    let animId = null;
+    let lastRender = 0;
+    const minFrameTime = 1000 / (options.fps ?? 30); // Throttle to fps
+    // Pre-calculate canvas size once
+    let canvasReady = false;
+    function setupCanvas() {
+        if (canvasReady || !vid.videoWidth)
+            return;
+        const maxW = currentOpts.maxWidth ?? 640;
+        const scale = Math.min(1, maxW / vid.videoWidth);
+        canvas.width = ~~(vid.videoWidth * scale);
+        canvas.height = ~~(vid.videoHeight * scale);
+        canvasReady = true;
+    }
+    let rendering = false;
+    let cachedFontSize = 0;
+    async function render() {
+        if (!vid.videoWidth || rendering)
+            return;
+        setupCanvas();
+        rendering = true;
+        ctx.drawImage(vid, 0, 0, canvas.width, canvas.height);
+        const imgData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+        // Use worker for heavy lifting
+        const result = await renderInWorker(new Uint8ClampedArray(imgData.data), canvas.width, canvas.height, currentOpts);
+        // Calculate font size once
+        if (!cachedFontSize) {
+            const containerWidth = containerEl.clientWidth - 16;
+            cachedFontSize = containerWidth / (result.cols * 0.6);
+            output.style.fontSize = cachedFontSize + 'px';
+        }
+        output.innerHTML = result.html;
+        if (currentOpts.colorMode === 'none')
+            output.style.color = '#0f0';
+        else
+            output.style.color = '';
+        rendering = false;
+    }
+    function loop() {
+        if (!playing)
+            return;
+        const now = performance.now();
+        if (now - lastRender >= minFrameTime) {
+            lastRender = now;
+            render();
+        }
+        animId = requestAnimationFrame(loop);
+    }
+    // Load video
+    if (source instanceof File) {
+        vid.src = URL.createObjectURL(source);
+    }
+    else if (typeof source === 'string') {
+        vid.src = source;
+    }
+    else {
+        vid.src = source.src;
+    }
+    vid.onloadedmetadata = () => {
+        render();
+        if (options.autoplay) {
+            playing = true;
+            vid.play();
+            loop();
+        }
+    };
+    return {
+        play() {
+            if (playing || !vid.readyState)
+                return;
+            playing = true;
+            vid.play();
+            loop();
+        },
+        pause() {
+            playing = false;
+            vid.pause();
+            if (animId)
+                cancelAnimationFrame(animId);
+        },
+        seek(time) {
+            vid.currentTime = time;
+            if (!playing)
+                render();
+        },
+        update(opts) {
+            if (opts)
+                currentOpts = { ...currentOpts, ...opts };
+            if (!playing)
+                render();
+        },
+        destroy() {
+            playing = false;
+            if (animId)
+                cancelAnimationFrame(animId);
+            if (vid.src.startsWith('blob:'))
+                URL.revokeObjectURL(vid.src);
+            containerEl.innerHTML = '';
+        },
+        get isPlaying() { return playing; },
+        get currentTime() { return vid.currentTime; },
+        get duration() { return vid.duration; }
+    };
+}
+// Default export for ES modules
+exports.default = { image, video, webcam };
+/**
+ * Render webcam as ASCII art
+ */
+function webcam(container, options = {}) {
+    init();
+    const containerEl = getEl(container);
+    const output = createOutput(containerEl, options.colorMode ?? 'none');
+    const canvas = document.createElement('canvas');
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    let currentOpts = { ...options };
+    let animId = null;
+    let stream = null;
+    let lastRender = 0;
+    const minFrameTime = 1000 / (options.fps ?? 30);
+    const vid = document.createElement('video');
+    vid.playsInline = true;
+    vid.muted = true;
+    let canvasReady = false;
+    function setupCanvas() {
+        if (canvasReady || !vid.videoWidth)
+            return;
+        const maxW = currentOpts.maxWidth ?? 640;
+        const scale = Math.min(1, maxW / vid.videoWidth);
+        canvas.width = ~~(vid.videoWidth * scale);
+        canvas.height = ~~(vid.videoHeight * scale);
+        canvasReady = true;
+    }
+    let rendering = false;
+    let cachedFontSize = 0;
+    async function render() {
+        if (!vid.videoWidth || rendering)
+            return;
+        setupCanvas();
+        rendering = true;
+        ctx.drawImage(vid, 0, 0, canvas.width, canvas.height);
+        const imgData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+        const result = await renderInWorker(new Uint8ClampedArray(imgData.data), canvas.width, canvas.height, currentOpts);
+        if (!cachedFontSize) {
+            const containerWidth = containerEl.clientWidth - 16;
+            cachedFontSize = containerWidth / (result.cols * 0.6);
+            output.style.fontSize = cachedFontSize + 'px';
+        }
+        output.innerHTML = result.html;
+        if (currentOpts.colorMode === 'none')
+            output.style.color = '#0f0';
+        else
+            output.style.color = '';
+        rendering = false;
+    }
+    function loop() {
+        const now = performance.now();
+        if (now - lastRender >= minFrameTime) {
+            lastRender = now;
+            render();
+        }
+        animId = requestAnimationFrame(loop);
+    }
+    const videoConstraints = {
+        video: {
+            width: { ideal: 1280 },
+            height: { ideal: 720 }
+        }
+    };
+    return navigator.mediaDevices.getUserMedia(videoConstraints).then(s => {
+        stream = s;
+        vid.srcObject = stream;
+        vid.play();
+        vid.onplaying = () => {
+            setupCanvas();
+            loop();
+        };
+        return {
+            stop() {
+                if (animId)
+                    cancelAnimationFrame(animId);
+                stream?.getTracks().forEach(t => t.stop());
+                containerEl.innerHTML = '';
+            },
+            update(opts) {
+                if (opts)
+                    currentOpts = { ...currentOpts, ...opts };
+            }
+        };
+    });
+}

package/dist/contrast.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Apply global contrast enhancement to a sampling vector.
+ * Normalizes to [0,1], applies exponent, denormalizes.
+ */
+export declare function applyGlobalContrast(vector: number[], exponent: number): number[];
+/**
+ * Apply directional contrast enhancement using external sampling vector.
+ * Each internal component is enhanced using the max of its affecting external values.
+ */
+export declare function applyDirectionalContrast(internal: number[], external: number[], exponent: number): number[];
+/**
+ * Apply both contrast enhancements in sequence
+ */
+export declare function applyContrastEnhancement(internal: number[], external: number[], globalExponent: number, directionalExponent: number): number[];

package/dist/contrast.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyGlobalContrast = applyGlobalContrast;
+exports.applyDirectionalContrast = applyDirectionalContrast;
+exports.applyContrastEnhancement = applyContrastEnhancement;
+const shape_vectors_1 = require("./shape-vectors");
+/**
+ * Apply global contrast enhancement to a sampling vector.
+ * Normalizes to [0,1], applies exponent, denormalizes.
+ */
+function applyGlobalContrast(vector, exponent) {
+    if (exponent <= 1)
+        return vector;
+    const maxValue = Math.max(...vector);
+    if (maxValue === 0)
+        return vector;
+    return vector.map(v => {
+        const normalized = v / maxValue;
+        const enhanced = Math.pow(normalized, exponent);
+        return enhanced * maxValue;
+    });
+}
+/**
+ * Apply directional contrast enhancement using external sampling vector.
+ * Each internal component is enhanced using the max of its affecting external values.
+ */
+function applyDirectionalContrast(internal, external, exponent) {
+    if (exponent <= 1)
+        return internal;
+    return internal.map((value, i) => {
+        // Find max value among affecting external circles
+        let maxValue = value;
+        for (const extIdx of shape_vectors_1.AFFECTING_EXTERNAL_INDICES[i]) {
+            maxValue = Math.max(maxValue, external[extIdx]);
+        }
+        if (maxValue === 0)
+            return value;
+        const normalized = value / maxValue;
+        const enhanced = Math.pow(normalized, exponent);
+        return enhanced * maxValue;
+    });
+}
+/**
+ * Apply both contrast enhancements in sequence
+ */
+function applyContrastEnhancement(internal, external, globalExponent, directionalExponent) {
+    let result = applyDirectionalContrast(internal, external, directionalExponent);
+    result = applyGlobalContrast(result, globalExponent);
+    return result;
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { AsciiRenderer, ColoredChar } from './renderer';
+export { VideoAsciiRenderer } from './video-renderer';
+export { AsciiRendererOptions, ShapeVector } from './types';
+export { VideoAsciiRendererOptions } from './video-types';
+export { generateShapeVectors } from './shape-vectors';
+export { KdTree, LookupCache } from './lookup';
+export { applyGlobalContrast, applyDirectionalContrast, applyContrastEnhancement } from './contrast';

package/dist/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyContrastEnhancement = exports.applyDirectionalContrast = exports.applyGlobalContrast = exports.LookupCache = exports.KdTree = exports.generateShapeVectors = exports.VideoAsciiRenderer = exports.AsciiRenderer = void 0;
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "AsciiRenderer", { enumerable: true, get: function () { return renderer_1.AsciiRenderer; } });
+var video_renderer_1 = require("./video-renderer");
+Object.defineProperty(exports, "VideoAsciiRenderer", { enumerable: true, get: function () { return video_renderer_1.VideoAsciiRenderer; } });
+var shape_vectors_1 = require("./shape-vectors");
+Object.defineProperty(exports, "generateShapeVectors", { enumerable: true, get: function () { return shape_vectors_1.generateShapeVectors; } });
+var lookup_1 = require("./lookup");
+Object.defineProperty(exports, "KdTree", { enumerable: true, get: function () { return lookup_1.KdTree; } });
+Object.defineProperty(exports, "LookupCache", { enumerable: true, get: function () { return lookup_1.LookupCache; } });
+var contrast_1 = require("./contrast");
+Object.defineProperty(exports, "applyGlobalContrast", { enumerable: true, get: function () { return contrast_1.applyGlobalContrast; } });
+Object.defineProperty(exports, "applyDirectionalContrast", { enumerable: true, get: function () { return contrast_1.applyDirectionalContrast; } });
+Object.defineProperty(exports, "applyContrastEnhancement", { enumerable: true, get: function () { return contrast_1.applyContrastEnhancement; } });

package/dist/lookup.d.ts

@@ -0,0 +1,24 @@
+import { ShapeVector } from './types';
+/**
+ * k-d tree for fast nearest-neighbor lookups in 6D space
+ */
+export declare class KdTree {
+    private root;
+    private dimensions;
+    constructor(vectors: ShapeVector[]);
+    private buildTree;
+    findNearest(target: number[]): ShapeVector;
+    private squaredDistance;
+}
+/**
+ * Cache for character lookups using quantized 30-bit keys
+ */
+export declare class LookupCache {
+    private cache;
+    private static BITS;
+    private static RANGE;
+    generateKey(vector: number[]): number;
+    get(key: number): string | undefined;
+    set(key: number, char: string): void;
+    has(key: number): boolean;
+}