@feelgxxd/textel 0.0.0-stage → 0.2.0

package/dist/style.js

@@ -0,0 +1,130 @@
+// Paul Bourke's 70-level ramp, flipped so it runs dark to bright like the others
+const DETAILED = [...'$@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/\\|()1{}[]?-_+~<>i!lI;:,"^`\'. '].reverse().join('');
+/**
+ * Character ramps, darkest first. A ramp that starts with a space lets shadows go empty
+ * (crisp on flat faces); one that does not keeps the whole silhouette visible.
+ */
+export const CHARSETS = {
+    classic: '.,-~:;=!*#$@',
+    hard: ' .:-=+*#%@',
+    detailed: DETAILED,
+    blocks: ' ░▒▓█',
+    dots: ' ·•●',
+    minimal: ' .:-=',
+};
+export const DEFAULTS = {
+    width: 80,
+    height: 40,
+    aspect: 2,
+    charset: 'classic',
+    pitch: 0.3,
+    spin: 0.66,
+    distance: 5,
+    zoom: 1,
+    light: [-0.45, 0.6, 0.65],
+    ambient: 0,
+    shading: 'auto',
+    supersample: 2,
+    coverage: 0.5,
+    edgeChars: '-/|\\',
+    edgeThreshold: 0.03,
+};
+/** Later inputs win; materials are merged by name. */
+export function mergeStyles(...inputs) {
+    const out = {};
+    for (const s of inputs) {
+        if (!s)
+            continue;
+        const { materials, ...rest } = s;
+        for (const [k, v] of Object.entries(rest))
+            if (v !== undefined)
+                out[k] = v;
+        if (materials)
+            out.materials = { ...out.materials, ...materials };
+    }
+    return out;
+}
+export function resolveRamp(chars, charset) {
+    if (chars !== undefined && chars.length)
+        return [...chars];
+    const name = charset ?? DEFAULTS.charset;
+    const r = CHARSETS[name];
+    if (!r)
+        throw new Error(`unknown charset "${name}" (have: ${Object.keys(CHARSETS).join(', ')})`);
+    return [...r];
+}
+export function resolveStyle(input = {}) {
+    const num = (v, d, min = -Infinity, max = Infinity) => {
+        const n = v ?? d;
+        if (!Number.isFinite(n))
+            throw new Error(`not a number: ${v}`);
+        return Math.min(max, Math.max(min, n));
+    };
+    const l = input.light ?? DEFAULTS.light;
+    const ll = Math.hypot(l[0], l[1], l[2]) || 1;
+    const edgeChars = [...(input.edgeChars ?? DEFAULTS.edgeChars)];
+    if (edgeChars.length !== 4)
+        throw new Error('edgeChars needs exactly 4 glyphs: horizontal, rising, vertical, falling');
+    return {
+        width: Math.round(num(input.width, DEFAULTS.width, 1, 2000)),
+        height: Math.round(num(input.height, DEFAULTS.height, 1, 2000)),
+        aspect: num(input.aspect, DEFAULTS.aspect, 0.25, 8),
+        chars: resolveRamp(input.chars, input.charset),
+        pitch: num(input.pitch, DEFAULTS.pitch),
+        spin: num(input.spin, DEFAULTS.spin),
+        distance: num(input.distance, DEFAULTS.distance, 1.5, 1000),
+        zoom: num(input.zoom, DEFAULTS.zoom, 0.01, 100),
+        light: [l[0] / ll, l[1] / ll, l[2] / ll],
+        ambient: num(input.ambient, DEFAULTS.ambient, 0, 1),
+        shading: input.shading ?? DEFAULTS.shading,
+        supersample: Math.round(num(input.supersample, DEFAULTS.supersample, 1, 4)),
+        coverage: num(input.coverage, DEFAULTS.coverage, 0, 1),
+        edges: input.edges === true ? 'outline' : input.edges || false,
+        edgeChars,
+        edgeThreshold: num(input.edgeThreshold, DEFAULTS.edgeThreshold, 0),
+        color: resolveColor(input.color),
+        materials: input.materials ?? {},
+    };
+}
+export function parseHex(hex) {
+    const m = /^#?([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(hex.trim());
+    if (!m)
+        throw new Error(`not a hex color: ${hex}`);
+    let h = m[1];
+    if (h.length === 3)
+        h = h.replace(/./g, (c) => c + c);
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+export function resolveColor(c) {
+    const white = [255, 255, 255];
+    if (c === undefined || c === 'none')
+        return { mode: 'none', fg: white, stops: [], bg: null };
+    if (typeof c === 'string')
+        return { mode: 'mono', fg: parseHex(c), stops: [], bg: null };
+    if (Array.isArray(c)) {
+        if (c.length === 1)
+            return { mode: 'mono', fg: parseHex(c[0]), stops: [], bg: null };
+        const stops = c.map(parseHex);
+        return { mode: 'gradient', fg: stops[stops.length - 1], stops, bg: null };
+    }
+    const stops = (c.stops ?? []).map(parseHex);
+    const mode = c.mode ?? (stops.length > 1 ? 'gradient' : c.fg ? 'mono' : 'none');
+    return { mode, fg: c.fg ? parseHex(c.fg) : stops[stops.length - 1] ?? white, stops, bg: c.bg ? parseHex(c.bg) : null };
+}
+export function resolveMaterial(name, input) {
+    const m = { name, chars: null, color: null, opacity: 1, carved: false };
+    if (input === undefined || input === 'solid')
+        return m;
+    if (input === 'carved')
+        return { ...m, carved: true };
+    if (input === 'dim')
+        return { ...m, opacity: 0.6 };
+    if (input.chars !== undefined || input.charset !== undefined)
+        m.chars = resolveRamp(input.chars, input.charset);
+    if (input.color)
+        m.color = parseHex(input.color);
+    if (input.opacity !== undefined)
+        m.opacity = Math.min(1, Math.max(0, input.opacity));
+    m.carved = !!input.carved;
+    return m;
+}

package/dist/terminal.d.ts

@@ -0,0 +1,89 @@
+import { type ColorDepth } from './ansi.ts';
+import { type Recording } from './frames.ts';
+/** What the players need from an output stream; `process.stdout` is one. */
+export interface TerminalOutput {
+    write(s: string): unknown;
+    on(event: 'resize', listener: () => void): unknown;
+    off(event: 'resize', listener: () => void): unknown;
+    isTTY?: boolean;
+    columns?: number;
+    rows?: number;
+}
+/** What the players need from an input stream; `process.stdin` is one. */
+export interface TerminalInput {
+    on(event: 'data', listener: (key: string) => void): unknown;
+    off(event: 'data', listener: (key: string) => void): unknown;
+    resume(): unknown;
+    pause(): unknown;
+    setEncoding(encoding: 'utf8'): unknown;
+    isTTY?: boolean;
+    setRawMode?(on: boolean): unknown;
+}
+type Out = TerminalOutput;
+type In = TerminalInput;
+/** What a stream can show, honoring NO_COLOR, FORCE_COLOR and COLORTERM. */
+export declare function detectColorDepth(stream?: Out, env?: NodeJS.ProcessEnv): ColorDepth;
+export interface ScreenOptions {
+    output?: Out;
+    /** keys arrive here when given; the input is put in raw mode */
+    input?: In | null;
+    onKey?: (key: string) => void;
+    onResize?: () => void;
+}
+/**
+ * A full-screen session: alternate screen, hidden cursor, raw keys. `close()` puts everything back,
+ * and so does process exit, so a crash never leaves the terminal broken.
+ */
+export declare class Screen {
+    readonly output: Out;
+    private input;
+    private closed;
+    private keyHandler?;
+    private resizeHandler?;
+    private exitHandler;
+    constructor(opts?: ScreenOptions);
+    get columns(): number;
+    get rows(): number;
+    /** draws lines from the top left; `status` goes on the last row, dimmed */
+    draw(lines: string[], status?: string): void;
+    private restore;
+    close(): void;
+}
+export type PlayResult = 'end' | 'quit' | 'interrupt' | 'abort';
+export interface PlayOptions {
+    output?: Out;
+    input?: In | null;
+    /** keys: space pause, ←/→ step a frame, +/- speed, q quit (default false) */
+    interactive?: boolean;
+    /** keep looping until stopped (default true) */
+    loop?: boolean;
+    /** stop after this long */
+    seconds?: number;
+    signal?: AbortSignal;
+    /** default: detected from the output */
+    depth?: ColorDepth;
+    /** playback rate; default the file's */
+    fps?: number;
+    /** a status line at the bottom (default: on when interactive) */
+    status?: boolean;
+    /** shown in the status line */
+    title?: string;
+}
+/**
+ * Plays a recording full screen. Resolves when it ends, the user quits, Ctrl+C is pressed or the
+ * signal aborts; the terminal is restored in every case. On output that is not a terminal it prints
+ * the first frame and returns.
+ */
+export declare function play(rec: Recording, opts?: PlayOptions): Promise<PlayResult>;
+/** Reads a `.textel.json` file. */
+export declare function loadFrames(file: string): Recording;
+/**
+ * A spinning logo for a few seconds, then back to the normal screen: for the start of another CLI.
+ * Any key skips it. Does nothing visible when output is not a terminal.
+ */
+export declare function playSplash(source: string | Recording, opts?: {
+    seconds?: number;
+    output?: Out;
+    input?: In | null;
+}): Promise<PlayResult>;
+export {};

package/dist/terminal.js

@@ -0,0 +1,197 @@
+// Terminal playback for Node: a full-screen session with clean restore, and players for frames files.
+// `@feelgxxd/textel/terminal` in the package.
+import { readFileSync } from 'node:fs';
+import { RESET } from "./ansi.js";
+import { parseFrames, recordingANSI, recordingText } from "./frames.js";
+const CSI = '\x1b[';
+/** What a stream can show, honoring NO_COLOR, FORCE_COLOR and COLORTERM. */
+export function detectColorDepth(stream = process.stdout, env = process.env) {
+    if (env.NO_COLOR)
+        return 'none';
+    if (!stream.isTTY && !env.FORCE_COLOR)
+        return 'none';
+    if (env.COLORTERM === 'truecolor' || env.COLORTERM === '24bit' || env.WT_SESSION || env.TERM_PROGRAM === 'vscode' || env.TERM_PROGRAM === 'iTerm.app')
+        return 'truecolor';
+    return '256';
+}
+/**
+ * A full-screen session: alternate screen, hidden cursor, raw keys. `close()` puts everything back,
+ * and so does process exit, so a crash never leaves the terminal broken.
+ */
+export class Screen {
+    output;
+    input;
+    closed = false;
+    keyHandler;
+    resizeHandler;
+    exitHandler = () => this.restore();
+    constructor(opts = {}) {
+        this.output = opts.output ?? process.stdout;
+        this.input = opts.onKey ? opts.input ?? process.stdin : null;
+        this.output.write(`${CSI}?1049h${CSI}?25l${CSI}2J`);
+        process.on('exit', this.exitHandler);
+        if (opts.onResize) {
+            this.resizeHandler = () => { this.output.write(`${CSI}2J`); opts.onResize(); };
+            this.output.on('resize', this.resizeHandler);
+        }
+        if (this.input && opts.onKey) {
+            this.keyHandler = opts.onKey;
+            this.input.setRawMode?.(true);
+            this.input.setEncoding('utf8');
+            this.input.on('data', this.keyHandler);
+            this.input.resume();
+        }
+    }
+    get columns() { return this.output.columns ?? 80; }
+    get rows() { return this.output.rows ?? 24; }
+    /** draws lines from the top left; `status` goes on the last row, dimmed */
+    draw(lines, status) {
+        let s = `${CSI}H${lines.join(`${CSI}K\n`)}${CSI}K`;
+        if (status !== undefined) {
+            const w = this.columns;
+            s += `${CSI}${this.rows};1H${CSI}2m${status.slice(0, w).padEnd(w)}${RESET}`;
+        }
+        this.output.write(s);
+    }
+    restore() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.output.write(`${RESET}${CSI}?25h${CSI}?1049l`);
+        if (this.input) {
+            if (this.keyHandler)
+                this.input.off('data', this.keyHandler);
+            this.input.setRawMode?.(false);
+            this.input.pause();
+        }
+        if (this.resizeHandler)
+            this.output.off('resize', this.resizeHandler);
+    }
+    close() {
+        this.restore();
+        process.off('exit', this.exitHandler);
+    }
+}
+/**
+ * Plays a recording full screen. Resolves when it ends, the user quits, Ctrl+C is pressed or the
+ * signal aborts; the terminal is restored in every case. On output that is not a terminal it prints
+ * the first frame and returns.
+ */
+export function play(rec, opts = {}) {
+    const output = opts.output ?? process.stdout;
+    const depth = opts.depth ?? detectColorDepth(output);
+    if (!output.isTTY) {
+        output.write((depth === 'none' ? recordingText(rec, 0) : recordingANSI(rec, 0, depth).join('\n')) + '\n');
+        return Promise.resolve('end');
+    }
+    const n = rec.frames.length, baseFps = opts.fps ?? rec.fps, loop = opts.loop ?? true;
+    const interactive = !!opts.interactive, showStatus = opts.status ?? interactive;
+    return new Promise((resolvePlay) => {
+        let pos = 0, speed = 1, paused = false, last = performance.now(), elapsed = 0, done = false;
+        let timer;
+        const finish = (r) => {
+            if (done)
+                return;
+            done = true;
+            clearInterval(timer);
+            opts.signal?.removeEventListener('abort', onAbort);
+            process.off('SIGINT', onSigint);
+            screen.close();
+            resolvePlay(r);
+        };
+        const onAbort = () => finish('abort');
+        const onSigint = () => finish('interrupt');
+        const screen = new Screen({
+            output,
+            input: opts.input,
+            onResize: () => draw(),
+            onKey: interactive || opts.input ? (key) => {
+                // without controls, any key ends playback (a splash screen can be skipped)
+                if (!interactive)
+                    return finish(key === '\x03' ? 'interrupt' : 'quit');
+                switch (key) {
+                    case '\x03':
+                        finish('interrupt');
+                        break;
+                    case 'q':
+                    case 'Q':
+                    case '\x1b':
+                        finish('quit');
+                        break;
+                    case ' ':
+                        paused = !paused;
+                        break;
+                    case '\x1b[C':
+                        paused = true;
+                        pos = Math.floor(pos) + 1;
+                        draw();
+                        break;
+                    case '\x1b[D':
+                        paused = true;
+                        pos = Math.floor(pos) - 1 + n;
+                        draw();
+                        break;
+                    case '+':
+                    case '=':
+                        speed = Math.min(8, speed * 1.25);
+                        break;
+                    case '-':
+                    case '_':
+                        speed = Math.max(0.125, speed / 1.25);
+                        break;
+                }
+            } : undefined,
+        });
+        if (opts.signal?.aborted)
+            return finish('abort');
+        opts.signal?.addEventListener('abort', onAbort);
+        process.on('SIGINT', onSigint);
+        function draw() {
+            const i = Math.floor(pos) % n;
+            const lines = depth === 'none' ? recordingText(rec, i).split('\n') : recordingANSI(rec, i, depth);
+            // center the grid; crop when the terminal is smaller
+            const rows = screen.rows - (showStatus ? 1 : 0), cols = screen.columns;
+            const top = Math.max(0, Math.floor((rows - rec.height) / 2)), left = Math.max(0, Math.floor((cols - rec.width) / 2));
+            const pad = ' '.repeat(left);
+            const shown = lines.slice(0, Math.max(0, rows - top)).map((l) => pad + l);
+            const out = [...new Array(top).fill(''), ...shown];
+            let status;
+            if (showStatus) {
+                const small = rec.width > cols || rec.height > rows ? ' · terminal too small, cropped' : '';
+                status = ` ${opts.title ?? 'textel'} · frame ${i + 1}/${n} · ${(speed * baseFps).toFixed(0)}fps${paused ? ' · paused' : ''}${small}   space pause  ←→ step  +/- speed  q quit`;
+            }
+            screen.draw(out, status);
+        }
+        const tick = () => {
+            const now = performance.now(), dt = Math.min(now - last, 100) / 1000;
+            last = now;
+            elapsed += dt;
+            if (opts.seconds !== undefined && elapsed >= opts.seconds)
+                return finish('end');
+            if (!paused) {
+                pos += dt * baseFps * speed;
+                if (!loop && pos >= n)
+                    return finish('end');
+            }
+            draw();
+        };
+        draw();
+        timer = setInterval(tick, 1000 / Math.max(1, Math.min(120, baseFps)));
+    });
+}
+/** Reads a `.textel.json` file. */
+export function loadFrames(file) {
+    return parseFrames(readFileSync(file, 'utf8'));
+}
+/**
+ * A spinning logo for a few seconds, then back to the normal screen: for the start of another CLI.
+ * Any key skips it. Does nothing visible when output is not a terminal.
+ */
+export async function playSplash(source, opts = {}) {
+    const output = opts.output ?? process.stdout;
+    if (!output.isTTY)
+        return 'end';
+    const rec = typeof source === 'string' ? loadFrames(source) : source;
+    const input = opts.input === undefined ? (process.stdin.isTTY ? process.stdin : null) : opts.input;
+    return play(rec, { output, input, seconds: opts.seconds ?? 2, interactive: false, status: false });
+}

package/dist/textel-player.js

@@ -0,0 +1,7 @@
+var L="rle-delta-1";var y=class{pos=0;buf;constructor(t){this.buf=t}byte(){if(this.pos>=this.buf.length)throw new Error("frames data ends early");return this.buf[this.pos++]}varint(){let t=0,e=0,r;do if(r=this.byte(),t+=(r&127)*2**e,e+=7,e>35)throw new Error("bad varint in frames data");while(r&128);return t}get done(){return this.pos>=this.buf.length}},U=0,I=1;function C(n,t,e,r,h){let s=r,u=r+h;if(u>t.length)throw new Error("frames data runs past the grid");for(;s<u;){let a=n.varint(),o=n.varint(),i=e?n.varint():0;if(a===0||s+a>u)throw new Error("bad run in frames data");t.fill(o,s,s+a),e&&e.fill(i,s,s+a),s+=a}}function T(n,t,e,r,h,s=65536,u=65536){let a=s<=256?Uint8Array:Uint16Array,o=u<=256?Uint8Array:Uint16Array,i=t*e,l=new y(n),c=[];for(let m=0;m<r;m++){let p=l.byte(),f=c[m-1],g=new a(i),d=h?new o(i):null;if(p===U)C(l,g,d,0,i);else if(p===I){if(!f)throw new Error("first frame cannot be a delta");g.set(f.glyph),d&&d.set(f.style);let O=l.varint(),A=0;for(let v=0;v<O;v++){let E=l.varint(),b=l.varint();if(b===0)throw new Error("empty span in frames data");C(l,g,d,A+E,b),A+=E+b}}else throw new Error(`unknown frame type ${p}`);c.push({glyph:g,style:d})}if(!l.done)throw new Error("extra bytes after the last frame");return c}function w(n){if(!n||typeof n!="object")throw new Error("not a textel frames file");if(n.textel!==1)throw new Error(`frames format ${n.textel} is not supported (this version reads 1)`);if(n.encoding!==L)throw new Error(`unknown frames encoding "${n.encoding}"`);let{width:t,height:e,frameCount:r}=n;if(!(t>0&&e>0&&r>0))throw new Error("bad frames header");if(!Array.isArray(n.glyphs)||!n.glyphs.length)throw new Error("bad frames header");let h=n.glyphs.length,s=n.styles?.length??1,u=T(N(n.data),t,e,r,!!n.styles,h,s);for(let a of u)for(let o=0;o<a.glyph.length;o++)if(a.glyph[o]>=h||a.style&&a.style[o]>=s)throw new Error("frames data points outside its palette");return{width:t,height:e,aspect:n.aspect,fps:n.fps,glyphs:n.glyphs,styles:n.styles??null,bg:n.bg??null,frames:u,meta:n.meta??{}}}function N(n){let t=atob(n),e=new Uint8Array(t.length);for(let r=0;r<t.length;r++)e[r]=t.charCodeAt(r);return e}var $=n=>n==="<"?"&lt;":n===">"?"&gt;":n==="&"?"&amp;":n;function R(n,t){let{width:e,height:r,glyphs:h,styles:s}=n,u=n.frames[t];if(!s||!u.style){let i="";for(let l=0;l<r;l++){for(let c=0;c<e;c++)i+=h[u.glyph[l*e+c]];l<r-1&&(i+=`
+`)}return{html:!1,content:i}}let a=s.map(i=>i===""?"":i==="~"?'<span class="d">':`<span style="color:${i}">`),o="";for(let i=0;i<r;i++){let l=0;for(let c=0;c<e;c++){let m=i*e+c,p=h[u.glyph[m]];if(p!==" "){let f=u.style[m];f!==l&&(l&&(o+="</span>"),o+=a[f],l=f)}o+=$(p)}l&&(o+="</span>"),i<r-1&&(o+=`
+`)}return{html:!0,content:o}}function F(n,t){if(t)return t;let e=n?.meta.title;return typeof e=="string"&&e?`${e}, ASCII animation`:"ASCII animation"}function M(n,t,e,r){return(n+Math.min(Math.max(t,0),.1)*e)%r}function k(n,t,e,r){return e>0?((n+t/e*r)%r+r)%r:n}function S(n,t,e,r,h,s,u){let a=r>0&&h>0?e*r/h:1,o=n*r,i=t*h*a;return o>0&&i>0?{scale:u>0?Math.min(s/o,u/i):s/o,stretchY:a,ratio:o/i}:{scale:1,stretchY:a,ratio:1}}var j=`:host{display:block;position:relative;overflow:hidden;aspect-ratio:var(--textel-ratio,auto);min-height:1px;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
+:host(:not([nodrag])){cursor:grab;touch-action:pan-y}
+:host(:not([nodrag]):active){cursor:grabbing}
+pre{position:absolute;left:50%;top:50%;margin:0;transform-origin:50% 50%;font:inherit;font-size:16px;line-height:1;letter-spacing:0;white-space:pre;color:inherit;text-shadow:var(--textel-glow,none);-webkit-text-size-adjust:none;text-size-adjust:none;user-select:none;pointer-events:none}
+.d{opacity:var(--textel-dim-opacity,.6)}`,H=typeof HTMLElement>"u"?class{}:HTMLElement,x=class extends H{static observedAttributes=["src","fps","paused","color","label"];#t=null;#p=[];#s;#r=0;#h=-1;#o=!0;#d=!0;#n=0;#a=0;#i=null;#g=null;#u;#c;#w=typeof matchMedia=="function"&&matchMedia("(prefers-reduced-motion: reduce)").matches;constructor(){super();let t=this.attachShadow({mode:"open"}),e=document.createElement("style");e.textContent=j,this.#s=document.createElement("pre"),this.#s.setAttribute("part","screen"),t.append(e,this.#s),this.addEventListener("pointerdown",this.#v),this.addEventListener("pointermove",this.#E),this.addEventListener("pointerup",this.#y),this.addEventListener("pointercancel",this.#y)}connectedCallback(){this.setAttribute("role","img"),this.#f(),this.#o=!this.hasAttribute("paused")&&!this.#w,typeof IntersectionObserver=="function"&&(this.#u=new IntersectionObserver(([t])=>{this.#d=t.isIntersecting,this.#e()}),this.#u.observe(this)),typeof ResizeObserver=="function"&&(this.#c=new ResizeObserver(()=>this.#m()),this.#c.observe(this)),document.addEventListener("visibilitychange",this.#e),document.fonts?.ready.then(()=>this.#m()),this.#e()}disconnectedCallback(){this.#u?.disconnect(),this.#c?.disconnect(),document.removeEventListener("visibilitychange",this.#e),cancelAnimationFrame(this.#n),this.#n=0}attributeChangedCallback(t,e,r){e!==r&&(t==="src"?r&&this.#x(r):t==="paused"?r===null?this.play():this.pause():t==="color"?this.#s.style.color=r??"":t==="label"&&this.#f())}get recording(){return this.#t}set recording(t){this.#t=t&&"data"in t?w(t):t,this.#p=[],this.#r=0,this.#h=-1,this.#f(),this.#l(),this.#m(),this.#e()}get frame(){return Math.floor(this.#r)}set frame(t){let e=this.#t?.frames.length??1;this.#r=(Math.floor(t)%e+e)%e,this.#l()}get paused(){return!this.#o}play(){this.#o=!0,this.#e()}pause(){this.#o=!1,this.#e()}async#x(t){this.#g?.abort();let e=this.#g=new AbortController;try{let r=await fetch(t,{signal:e.signal});if(!r.ok)throw new Error(`${r.status} ${r.statusText} for ${t}`);let h=await r.json();if(e.signal.aborted)return;this.recording=w(h),this.dispatchEvent(new CustomEvent("load",{detail:{frames:this.#t.frames.length}}))}catch(r){if(e.signal.aborted)return;this.dispatchEvent(new CustomEvent("error",{detail:{error:r}}))}}#f(){this.isConnected&&this.setAttribute("aria-label",F(this.#t,this.getAttribute("label")))}#A(){let t=Number(this.getAttribute("fps"));return t>0?t:this.#t?.fps??30}#l(){let t=this.#t;if(!t)return;let e=Math.floor(this.#r)%t.frames.length;if(e===this.#h)return;this.#h=e;let r=this.#p[e]??=R(t,e);r.html?this.#s.innerHTML=r.content:this.#s.textContent=r.content}#m(){let t=this.#t;if(!t)return;let e=this.#s,r=e.offsetWidth/t.width,h=e.offsetHeight/t.height,s=S(t.width,t.height,t.aspect,r,h,this.clientWidth,this.clientHeight);this.style.setProperty("--textel-ratio",String(s.ratio)),e.style.transform=`translate(-50%,-50%) scale(${s.scale},${s.scale*s.stretchY})`}#e=()=>{let t=this.#o&&this.#d&&!document.hidden&&!!this.#t&&!this.#i&&this.isConnected;t&&!this.#n?(this.#a=-1,this.#n=requestAnimationFrame(this.#b)):!t&&this.#n&&(cancelAnimationFrame(this.#n),this.#n=0)};#b=t=>{let e=this.#t;this.#a>=0&&(this.#r=M(this.#r,(t-this.#a)/1e3,this.#A(),e.frames.length)),this.#a=t,this.#l(),this.#n=requestAnimationFrame(this.#b)};#v=t=>{this.hasAttribute("nodrag")||!this.#t||t.button!==0||(this.#i={x:t.clientX,pos:this.#r},this.setPointerCapture(t.pointerId),this.#e())};#E=t=>{!this.#i||!this.#t||(this.#r=k(this.#i.pos,t.clientX-this.#i.x,this.clientWidth,this.#t.frames.length),this.#l())};#y=()=>{this.#i&&(this.#i=null,this.#e())}};typeof customElements<"u"&&!customElements.get("textel-player")&&customElements.define("textel-player",x);export{x as TextelPlayer};

package/package.json

@@ -1,6 +1,86 @@
 {
   "name": "@feelgxxd/textel",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Turn 3D models into animated ASCII art for the terminal and the web.",
+  "keywords": [
+    "ascii",
+    "ascii-art",
+    "3d",
+    "terminal",
+    "renderer",
+    "gltf",
+    "obj",
+    "stl",
+    "sdf"
+  ],
+  "homepage": "https://github.com/feelgxxd/textel#readme",
+  "bugs": {
+    "url": "https://github.com/feelgxxd/textel/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/feelgxxd/textel.git"
+  },
+  "license": "MIT",
+  "author": "Berk Beken",
+  "type": "module",
+  "bin": {
+    "textel": "dist/cli/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./sdf": {
+      "types": "./dist/sdf.d.ts",
+      "default": "./dist/sdf.js"
+    },
+    "./examples": {
+      "types": "./dist/examples.d.ts",
+      "default": "./dist/examples.js"
+    },
+    "./terminal": {
+      "types": "./dist/terminal.d.ts",
+      "default": "./dist/terminal.js"
+    },
+    "./frames": {
+      "types": "./dist/frames.d.ts",
+      "default": "./dist/frames.js"
+    },
+    "./player": {
+      "types": "./dist/browser/player.d.ts",
+      "default": "./dist/textel-player.js"
+    }
+  },
+  "sideEffects": [
+    "./dist/browser/player.js",
+    "./dist/textel-player.js"
+  ],
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "dev": "node src/cli/main.ts",
+    "build": "tsc -p tsconfig.build.json && node scripts/build-browser.ts",
+    "typecheck": "tsc",
+    "test": "node --test \"test/*.test.ts\"",
+    "snapshots": "node test/update-snapshots.ts",
+    "size": "node scripts/build-browser.ts --check",
+    "demo": "node scripts/build-browser.ts && node scripts/demo.ts",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^21.0.4",
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.28.2",
+    "happy-dom": "^21.0.4",
+    "typescript": "^5.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}