@termuijs/core 0.1.2 → 0.1.4

package/dist/index.d.cts

@@ -59,6 +59,35 @@ declare function colorToAnsiFg(color: Color, depth: ColorDepth): string;
  * Generate the ANSI escape codes for a background color at the given depth.
  */
 declare function colorToAnsiBg(color: Color, depth: ColorDepth): string;
+/**
+ * Compute relative luminance per WCAG 2.1.
+ * Returns value in [0, 1] where 0 = black, 1 = white.
+ */
+declare function relativeLuminance(color: Color): number;
+/**
+ * Compute WCAG 2.1 contrast ratio between foreground and background colors.
+ * Returns value in [1, 21] where 21 is maximum contrast (black on white).
+ */
+declare function contrastRatio(fg: Color, bg: Color): number;
+/**
+ * Determine WCAG 2.1 conformance level for a contrast ratio.
+ * @param ratio  Result of contrastRatio()
+ * @param large  True if text is large (18pt+ regular or 14pt+ bold). Default: false.
+ */
+declare function wcagLevel(ratio: number, large?: boolean): 'AAA' | 'AA' | 'A' | 'fail';
+interface ContrastFailure {
+    /** Description of the color pair, e.g. 'fg on bg' */
+    pair: string;
+    ratio: number;
+    level: 'A' | 'fail';
+    required: 'AA';
+}
+/**
+ * Validate contrast for key pairs in a theme (hex string map).
+ * Checks: fg/bg, primary/bg, error/bg, success/bg, warning/bg, muted/bg.
+ * Returns failures (pairs below AA = 4.5:1 for normal text).
+ */
+declare function validateThemeContrast(theme: Record<string, string>): ContrastFailure[];
 
 interface TerminalOptions {
     /** Override stdout stream (useful for testing) */
@@ -92,6 +121,8 @@ declare class Terminal {
     private _exitHandler;
     private _sigintHandler;
     private _sigtermHandler;
+    private _uncaughtExceptionHandler;
+    private _unhandledRejectionHandler;
     private _restored;
     constructor(options?: TerminalOptions);
     /** Current terminal width in columns */
@@ -247,11 +278,12 @@ declare class Renderer {
     private _frameTimer;
     private _renderRequested;
     private _colorDepth;
+    private _onTick;
     constructor(terminal: Terminal, screen: Screen, fps?: number);
     /** Change the rendering frame rate cap */
     setFPS(fps: number): void;
     /** Start the render loop */
-    start(): void;
+    start(onTick?: () => void): void;
     /** Stop the render loop */
     stop(): void;
     /** Request a render on the next frame */
@@ -404,6 +436,21 @@ declare class LayerManager {
     private _expandDirty;
 }
 
+declare const caps: {
+    readonly color: boolean;
+    readonly unicode: boolean;
+    readonly motion: boolean;
+    readonly ci: boolean;
+};
+
+declare const BOX: Record<string, string>;
+declare const BRAILLE_SPIN: readonly ["|", "/", "-", "\\"];
+declare const BLOCK: {
+    readonly full: "#";
+    readonly empty: " ";
+    readonly partial: "-";
+};
+
 /**
  * Keyboard event emitted when a key is pressed.
  */
@@ -679,6 +726,8 @@ interface LayoutNode {
     children: LayoutNode[];
     /** Computed position and size — filled in by computeLayout() */
     computed: Rect;
+    /** Dirty flag — true when this node needs to be re-laid-out. Foundation for layout caching. */
+    _dirty: boolean;
 }
 /**
  * Create a LayoutNode with default values.
@@ -1188,6 +1237,9 @@ declare class App {
     private _options;
     private _mounted;
     private _exitResolve;
+    private _unsubKey;
+    private _unsubMouse;
+    private _widgetById;
     constructor(rootWidget: RootWidget, options?: AppOptions);
     /**
      * Start the application.
@@ -1211,6 +1263,7 @@ declare class App {
     removeOverlay(id: string): void;
     /**
      * Request a re-render on the next frame.
+     * Skips layout + render pass when the root widget reports no dirty state.
      */
     requestRender(): void;
     /**
@@ -1224,13 +1277,15 @@ declare class App {
     /**
      * Build the bubble chain for keyboard events.
      * Returns an array: [focused widget, parent, grandparent, ..., root]
+     * Uses the cached _widgetById map for O(1) lookup instead of DFS.
      */
     private _buildBubbleChain;
     /**
-     * Find a widget by ID in the widget tree (DFS).
-     * Uses duck-typing to work with any object that has id/children.
+     * Rebuild the widget ID cache by walking the entire widget tree.
+     * Called after syncLayout() so the map stays current.
      */
-    private _findWidgetById;
+    private _buildWidgetMap;
+    private _walkWidget;
 }
 
 /**
@@ -1327,6 +1382,13 @@ declare const resetStrikethrough = "\u001B[29m";
 declare function setScrollRegion(top: number, bottom: number): string;
 declare const resetScrollRegion = "\u001B[r";
 declare function setTitle(title: string): string;
+/**
+ * Write text to the system clipboard via OSC 52.
+ * Supported by: xterm, iTerm2, Kitty, WezTerm, Alacritty, Windows Terminal.
+ * @param text Plain text to copy to clipboard
+ * @param stdout Target stream (default: process.stdout)
+ */
+declare function writeClipboard(text: string, stdout?: NodeJS.WriteStream): void;
 
 declare const ansi_CSI: typeof CSI;
 declare const ansi_ESC: typeof ESC;
@@ -1372,8 +1434,9 @@ declare const ansi_setTitle: typeof setTitle;
 declare const ansi_showCursor: typeof showCursor;
 declare const ansi_strikethrough: typeof strikethrough;
 declare const ansi_underline: typeof underline;
+declare const ansi_writeClipboard: typeof writeClipboard;
 declare namespace ansi {
-  export { ansi_CSI as CSI, ansi_ESC as ESC, ansi_OSC as OSC, ansi_beginSyncUpdate as beginSyncUpdate, ansi_blink as blink, ansi_bold as bold, ansi_clearDown as clearDown, ansi_clearLine as clearLine, ansi_clearLineToEnd as clearLineToEnd, ansi_clearLineToStart as clearLineToStart, ansi_clearScreen as clearScreen, ansi_clearUp as clearUp, ansi_dim as dim, ansi_disableBracketedPaste as disableBracketedPaste, ansi_disableMouse as disableMouse, ansi_enableBracketedPaste as enableBracketedPaste, ansi_enableMouse as enableMouse, ansi_endSyncUpdate as endSyncUpdate, ansi_enterAltScreen as enterAltScreen, ansi_exitAltScreen as exitAltScreen, ansi_hideCursor as hideCursor, ansi_inverse as inverse, ansi_italic as italic, ansi_moveDown as moveDown, ansi_moveLeft as moveLeft, ansi_moveRight as moveRight, ansi_moveTo as moveTo, ansi_moveUp as moveUp, ansi_reset as reset, ansi_resetBlink as resetBlink, ansi_resetBold as resetBold, ansi_resetDim as resetDim, ansi_resetInverse as resetInverse, ansi_resetItalic as resetItalic, ansi_resetScrollRegion as resetScrollRegion, ansi_resetStrikethrough as resetStrikethrough, ansi_resetUnderline as resetUnderline, ansi_restoreCursorPosition as restoreCursorPosition, ansi_saveCursorPosition as saveCursorPosition, ansi_setScrollRegion as setScrollRegion, ansi_setTitle as setTitle, ansi_showCursor as showCursor, ansi_strikethrough as strikethrough, ansi_underline as underline };
+  export { ansi_CSI as CSI, ansi_ESC as ESC, ansi_OSC as OSC, ansi_beginSyncUpdate as beginSyncUpdate, ansi_blink as blink, ansi_bold as bold, ansi_clearDown as clearDown, ansi_clearLine as clearLine, ansi_clearLineToEnd as clearLineToEnd, ansi_clearLineToStart as clearLineToStart, ansi_clearScreen as clearScreen, ansi_clearUp as clearUp, ansi_dim as dim, ansi_disableBracketedPaste as disableBracketedPaste, ansi_disableMouse as disableMouse, ansi_enableBracketedPaste as enableBracketedPaste, ansi_enableMouse as enableMouse, ansi_endSyncUpdate as endSyncUpdate, ansi_enterAltScreen as enterAltScreen, ansi_exitAltScreen as exitAltScreen, ansi_hideCursor as hideCursor, ansi_inverse as inverse, ansi_italic as italic, ansi_moveDown as moveDown, ansi_moveLeft as moveLeft, ansi_moveRight as moveRight, ansi_moveTo as moveTo, ansi_moveUp as moveUp, ansi_reset as reset, ansi_resetBlink as resetBlink, ansi_resetBold as resetBold, ansi_resetDim as resetDim, ansi_resetInverse as resetInverse, ansi_resetItalic as resetItalic, ansi_resetScrollRegion as resetScrollRegion, ansi_resetStrikethrough as resetStrikethrough, ansi_resetUnderline as resetUnderline, ansi_restoreCursorPosition as restoreCursorPosition, ansi_saveCursorPosition as saveCursorPosition, ansi_setScrollRegion as setScrollRegion, ansi_setTitle as setTitle, ansi_showCursor as showCursor, ansi_strikethrough as strikethrough, ansi_underline as underline, ansi_writeClipboard as writeClipboard };
 }
 
-export { App, type AppOptions, BORDER_CHARS, BRAILLE_DOTS, BRAILLE_OFFSET, type BarSet, BarSets, type BorderChars, type BorderSet, BorderSets, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, type Constraint, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, HORIZONTAL_BAR_SYMBOLS, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type LineSet, LineSets, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type ScrollbarSet, ScrollbarSets, Shade, type Size, type Style, Terminal, type TerminalOptions, type TestScreen, VERTICAL_BAR_SYMBOLS, ansi, borderSize, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, createKeyEvent, createLayoutNode, createTestScreen, defaultStyle, detectColorDepth, emptyCell, emptyRect, fill, getBorderChars, intersectRect, isMouseSequence, length, max, mergeStyles, min, normalizeEdges, parseColor, parseMouseEvent, percentage, ratio, renderFallback, shouldUseFallback, shrinkRect, splitRect, stringWidth, stripAnsi, styleToCellAttrs, testScreenClear, testScreenGetCell, testScreenSetCell, testScreenSetString, testScreenToString, truncate, unionRect, wordWrap };
+export { App, type AppOptions, BLOCK, BORDER_CHARS, BOX, BRAILLE_DOTS, BRAILLE_OFFSET, BRAILLE_SPIN, type BarSet, BarSets, type BorderChars, type BorderSet, BorderSets, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, type Constraint, type ContrastFailure, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, HORIZONTAL_BAR_SYMBOLS, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type LineSet, LineSets, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type ScrollbarSet, ScrollbarSets, Shade, type Size, type Style, Terminal, type TerminalOptions, type TestScreen, VERTICAL_BAR_SYMBOLS, ansi, borderSize, caps, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, contrastRatio, createKeyEvent, createLayoutNode, createTestScreen, defaultStyle, detectColorDepth, emptyCell, emptyRect, fill, getBorderChars, intersectRect, isMouseSequence, length, max, mergeStyles, min, normalizeEdges, parseColor, parseMouseEvent, percentage, ratio, relativeLuminance, renderFallback, shouldUseFallback, shrinkRect, splitRect, stringWidth, stripAnsi, styleToCellAttrs, testScreenClear, testScreenGetCell, testScreenSetCell, testScreenSetString, testScreenToString, truncate, unionRect, validateThemeContrast, wcagLevel, wordWrap, writeClipboard };

package/dist/index.d.ts

@@ -59,6 +59,35 @@ declare function colorToAnsiFg(color: Color, depth: ColorDepth): string;
  * Generate the ANSI escape codes for a background color at the given depth.
  */
 declare function colorToAnsiBg(color: Color, depth: ColorDepth): string;
+/**
+ * Compute relative luminance per WCAG 2.1.
+ * Returns value in [0, 1] where 0 = black, 1 = white.
+ */
+declare function relativeLuminance(color: Color): number;
+/**
+ * Compute WCAG 2.1 contrast ratio between foreground and background colors.
+ * Returns value in [1, 21] where 21 is maximum contrast (black on white).
+ */
+declare function contrastRatio(fg: Color, bg: Color): number;
+/**
+ * Determine WCAG 2.1 conformance level for a contrast ratio.
+ * @param ratio  Result of contrastRatio()
+ * @param large  True if text is large (18pt+ regular or 14pt+ bold). Default: false.
+ */
+declare function wcagLevel(ratio: number, large?: boolean): 'AAA' | 'AA' | 'A' | 'fail';
+interface ContrastFailure {
+    /** Description of the color pair, e.g. 'fg on bg' */
+    pair: string;
+    ratio: number;
+    level: 'A' | 'fail';
+    required: 'AA';
+}
+/**
+ * Validate contrast for key pairs in a theme (hex string map).
+ * Checks: fg/bg, primary/bg, error/bg, success/bg, warning/bg, muted/bg.
+ * Returns failures (pairs below AA = 4.5:1 for normal text).
+ */
+declare function validateThemeContrast(theme: Record<string, string>): ContrastFailure[];
 
 interface TerminalOptions {
     /** Override stdout stream (useful for testing) */
@@ -92,6 +121,8 @@ declare class Terminal {
     private _exitHandler;
     private _sigintHandler;
     private _sigtermHandler;
+    private _uncaughtExceptionHandler;
+    private _unhandledRejectionHandler;
     private _restored;
     constructor(options?: TerminalOptions);
     /** Current terminal width in columns */
@@ -247,11 +278,12 @@ declare class Renderer {
     private _frameTimer;
     private _renderRequested;
     private _colorDepth;
+    private _onTick;
     constructor(terminal: Terminal, screen: Screen, fps?: number);
     /** Change the rendering frame rate cap */
     setFPS(fps: number): void;
     /** Start the render loop */
-    start(): void;
+    start(onTick?: () => void): void;
     /** Stop the render loop */
     stop(): void;
     /** Request a render on the next frame */
@@ -404,6 +436,21 @@ declare class LayerManager {
     private _expandDirty;
 }
 
+declare const caps: {
+    readonly color: boolean;
+    readonly unicode: boolean;
+    readonly motion: boolean;
+    readonly ci: boolean;
+};
+
+declare const BOX: Record<string, string>;
+declare const BRAILLE_SPIN: readonly ["|", "/", "-", "\\"];
+declare const BLOCK: {
+    readonly full: "#";
+    readonly empty: " ";
+    readonly partial: "-";
+};
+
 /**
  * Keyboard event emitted when a key is pressed.
  */
@@ -679,6 +726,8 @@ interface LayoutNode {
     children: LayoutNode[];
     /** Computed position and size — filled in by computeLayout() */
     computed: Rect;
+    /** Dirty flag — true when this node needs to be re-laid-out. Foundation for layout caching. */
+    _dirty: boolean;
 }
 /**
  * Create a LayoutNode with default values.
@@ -1188,6 +1237,9 @@ declare class App {
     private _options;
     private _mounted;
     private _exitResolve;
+    private _unsubKey;
+    private _unsubMouse;
+    private _widgetById;
     constructor(rootWidget: RootWidget, options?: AppOptions);
     /**
      * Start the application.
@@ -1211,6 +1263,7 @@ declare class App {
     removeOverlay(id: string): void;
     /**
      * Request a re-render on the next frame.
+     * Skips layout + render pass when the root widget reports no dirty state.
      */
     requestRender(): void;
     /**
@@ -1224,13 +1277,15 @@ declare class App {
     /**
      * Build the bubble chain for keyboard events.
      * Returns an array: [focused widget, parent, grandparent, ..., root]
+     * Uses the cached _widgetById map for O(1) lookup instead of DFS.
      */
     private _buildBubbleChain;
     /**
-     * Find a widget by ID in the widget tree (DFS).
-     * Uses duck-typing to work with any object that has id/children.
+     * Rebuild the widget ID cache by walking the entire widget tree.
+     * Called after syncLayout() so the map stays current.
      */
-    private _findWidgetById;
+    private _buildWidgetMap;
+    private _walkWidget;
 }
 
 /**
@@ -1327,6 +1382,13 @@ declare const resetStrikethrough = "\u001B[29m";
 declare function setScrollRegion(top: number, bottom: number): string;
 declare const resetScrollRegion = "\u001B[r";
 declare function setTitle(title: string): string;
+/**
+ * Write text to the system clipboard via OSC 52.
+ * Supported by: xterm, iTerm2, Kitty, WezTerm, Alacritty, Windows Terminal.
+ * @param text Plain text to copy to clipboard
+ * @param stdout Target stream (default: process.stdout)
+ */
+declare function writeClipboard(text: string, stdout?: NodeJS.WriteStream): void;
 
 declare const ansi_CSI: typeof CSI;
 declare const ansi_ESC: typeof ESC;
@@ -1372,8 +1434,9 @@ declare const ansi_setTitle: typeof setTitle;
 declare const ansi_showCursor: typeof showCursor;
 declare const ansi_strikethrough: typeof strikethrough;
 declare const ansi_underline: typeof underline;
+declare const ansi_writeClipboard: typeof writeClipboard;
 declare namespace ansi {
-  export { ansi_CSI as CSI, ansi_ESC as ESC, ansi_OSC as OSC, ansi_beginSyncUpdate as beginSyncUpdate, ansi_blink as blink, ansi_bold as bold, ansi_clearDown as clearDown, ansi_clearLine as clearLine, ansi_clearLineToEnd as clearLineToEnd, ansi_clearLineToStart as clearLineToStart, ansi_clearScreen as clearScreen, ansi_clearUp as clearUp, ansi_dim as dim, ansi_disableBracketedPaste as disableBracketedPaste, ansi_disableMouse as disableMouse, ansi_enableBracketedPaste as enableBracketedPaste, ansi_enableMouse as enableMouse, ansi_endSyncUpdate as endSyncUpdate, ansi_enterAltScreen as enterAltScreen, ansi_exitAltScreen as exitAltScreen, ansi_hideCursor as hideCursor, ansi_inverse as inverse, ansi_italic as italic, ansi_moveDown as moveDown, ansi_moveLeft as moveLeft, ansi_moveRight as moveRight, ansi_moveTo as moveTo, ansi_moveUp as moveUp, ansi_reset as reset, ansi_resetBlink as resetBlink, ansi_resetBold as resetBold, ansi_resetDim as resetDim, ansi_resetInverse as resetInverse, ansi_resetItalic as resetItalic, ansi_resetScrollRegion as resetScrollRegion, ansi_resetStrikethrough as resetStrikethrough, ansi_resetUnderline as resetUnderline, ansi_restoreCursorPosition as restoreCursorPosition, ansi_saveCursorPosition as saveCursorPosition, ansi_setScrollRegion as setScrollRegion, ansi_setTitle as setTitle, ansi_showCursor as showCursor, ansi_strikethrough as strikethrough, ansi_underline as underline };
+  export { ansi_CSI as CSI, ansi_ESC as ESC, ansi_OSC as OSC, ansi_beginSyncUpdate as beginSyncUpdate, ansi_blink as blink, ansi_bold as bold, ansi_clearDown as clearDown, ansi_clearLine as clearLine, ansi_clearLineToEnd as clearLineToEnd, ansi_clearLineToStart as clearLineToStart, ansi_clearScreen as clearScreen, ansi_clearUp as clearUp, ansi_dim as dim, ansi_disableBracketedPaste as disableBracketedPaste, ansi_disableMouse as disableMouse, ansi_enableBracketedPaste as enableBracketedPaste, ansi_enableMouse as enableMouse, ansi_endSyncUpdate as endSyncUpdate, ansi_enterAltScreen as enterAltScreen, ansi_exitAltScreen as exitAltScreen, ansi_hideCursor as hideCursor, ansi_inverse as inverse, ansi_italic as italic, ansi_moveDown as moveDown, ansi_moveLeft as moveLeft, ansi_moveRight as moveRight, ansi_moveTo as moveTo, ansi_moveUp as moveUp, ansi_reset as reset, ansi_resetBlink as resetBlink, ansi_resetBold as resetBold, ansi_resetDim as resetDim, ansi_resetInverse as resetInverse, ansi_resetItalic as resetItalic, ansi_resetScrollRegion as resetScrollRegion, ansi_resetStrikethrough as resetStrikethrough, ansi_resetUnderline as resetUnderline, ansi_restoreCursorPosition as restoreCursorPosition, ansi_saveCursorPosition as saveCursorPosition, ansi_setScrollRegion as setScrollRegion, ansi_setTitle as setTitle, ansi_showCursor as showCursor, ansi_strikethrough as strikethrough, ansi_underline as underline, ansi_writeClipboard as writeClipboard };
 }
 
-export { App, type AppOptions, BORDER_CHARS, BRAILLE_DOTS, BRAILLE_OFFSET, type BarSet, BarSets, type BorderChars, type BorderSet, BorderSets, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, type Constraint, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, HORIZONTAL_BAR_SYMBOLS, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type LineSet, LineSets, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type ScrollbarSet, ScrollbarSets, Shade, type Size, type Style, Terminal, type TerminalOptions, type TestScreen, VERTICAL_BAR_SYMBOLS, ansi, borderSize, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, createKeyEvent, createLayoutNode, createTestScreen, defaultStyle, detectColorDepth, emptyCell, emptyRect, fill, getBorderChars, intersectRect, isMouseSequence, length, max, mergeStyles, min, normalizeEdges, parseColor, parseMouseEvent, percentage, ratio, renderFallback, shouldUseFallback, shrinkRect, splitRect, stringWidth, stripAnsi, styleToCellAttrs, testScreenClear, testScreenGetCell, testScreenSetCell, testScreenSetString, testScreenToString, truncate, unionRect, wordWrap };
+export { App, type AppOptions, BLOCK, BORDER_CHARS, BOX, BRAILLE_DOTS, BRAILLE_OFFSET, BRAILLE_SPIN, type BarSet, BarSets, type BorderChars, type BorderSet, BorderSets, type BorderStyle, CTRL_KEYS, type Cell, type Color, ColorDepth, type Constraint, type ContrastFailure, ESCAPE_SEQUENCES, type Edges, EventEmitter, type EventMap, type FocusEvent, FocusManager, type Focusable, HORIZONTAL_BAR_SYMBOLS, InputParser, type KeyEvent, type Layer, LayerManager, type LayoutNode, type LineSet, LineSets, type MouseEvent, type NamedColor, type Rect, Renderer, type ResizeEvent, type RootWidget, SPECIAL_KEYS, Screen, type ScrollbarSet, ScrollbarSets, Shade, type Size, type Style, Terminal, type TerminalOptions, type TestScreen, VERTICAL_BAR_SYMBOLS, ansi, borderSize, caps, cellsEqual, colorToAnsiBg, colorToAnsiFg, colorToRgb, computeLayout, containsPoint, contrastRatio, createKeyEvent, createLayoutNode, createTestScreen, defaultStyle, detectColorDepth, emptyCell, emptyRect, fill, getBorderChars, intersectRect, isMouseSequence, length, max, mergeStyles, min, normalizeEdges, parseColor, parseMouseEvent, percentage, ratio, relativeLuminance, renderFallback, shouldUseFallback, shrinkRect, splitRect, stringWidth, stripAnsi, styleToCellAttrs, testScreenClear, testScreenGetCell, testScreenSetCell, testScreenSetString, testScreenToString, truncate, unionRect, validateThemeContrast, wcagLevel, wordWrap, writeClipboard };