@kofany/beamterm-terx 0.12.1 → 0.12.2

package/beamterm_renderer.d.ts

@@ -52,15 +52,9 @@ export class BeamtermRenderer {
    */
   clearSelection(): void;
   /**
-   * Enable default mouse selection behavior with built-in copy to clipboard.
-   *
-   * # Arguments
-   * * `mode` - Selection mode (Linear or Block)
-   * * `trim_whitespace` - Whether to trim trailing whitespace from selections
-   * * `drag_threshold_ms` - Optional minimum time (ms) before drag activates selection.
-   *   Defaults to 200ms. Higher values prevent accidental selections during fast gestures.
+   * Enable default mouse selection behavior with built-in copy to clipboard
    */
-  enableSelection(mode: SelectionMode, trim_whitespace: boolean, drag_threshold_ms?: number | null): void;
+  enableSelection(mode: SelectionMode, trim_whitespace: boolean): void;
   /**
    * Create a new render batch
    */
@@ -102,6 +96,68 @@ export class BeamtermRenderer {
    * ```
    */
   static withDynamicAtlas(canvas_id: string, font_family: Array<any>, font_size: number): BeamtermRenderer;
+  /**
+   * Replace the current font atlas with a new static atlas.
+   *
+   * This method enables runtime font switching by loading a new `.atlas` file.
+   * All existing cell content is preserved and translated to the new atlas.
+   *
+   * # Arguments
+   * * `atlas_data` - Binary atlas data (from .atlas file), or null for default
+   *
+   * # Example
+   * ```javascript
+   * const atlasData = await fetch('new-font.atlas').then(r => r.arrayBuffer());
+   * renderer.replaceWithStaticAtlas(new Uint8Array(atlasData));
+   * ```
+   */
+  replaceWithStaticAtlas(atlas_data?: Uint8Array | null): void;
+  /**
+   * Replace the current font atlas with a new dynamic atlas.
+   *
+   * This method enables runtime font switching by creating a new dynamic atlas
+   * with the specified font family and size. All existing cell content is
+   * preserved and translated to the new atlas.
+   *
+   * # Arguments
+   * * `font_family` - Array of font family names (e.g., `["Hack", "JetBrains Mono"]`)
+   * * `font_size` - Font size in pixels
+   *
+   * # Example
+   * ```javascript
+   * renderer.replaceWithDynamicAtlas(["Fira Code", "monospace"], 18.0);
+   * ```
+   */
+  replaceWithDynamicAtlas(font_family: Array<any>, font_size: number): void;
+  /**
+   * Enable mouse selection with full configuration options.
+   *
+   * This method allows specifying modifier keys that must be held for selection
+   * to activate, in addition to the selection mode and whitespace trimming.
+   *
+   * # Arguments
+   * * `mode` - Selection mode (Block or Linear)
+   * * `trim_whitespace` - Whether to trim trailing whitespace from selected text
+   * * `require_modifiers` - Modifier keys that must be held to start selection
+   *
+   * # Example
+   * ```javascript
+   * // Require Shift+Click to start selection
+   * renderer.enableSelectionWithOptions(
+   *     SelectionMode.Linear,
+   *     true,
+   *     ModifierKeys.SHIFT
+   * );
+   *
+   * // Require Ctrl+Shift+Click
+   * renderer.enableSelectionWithOptions(
+   *     SelectionMode.Block,
+   *     false,
+   *     ModifierKeys.CONTROL.or(ModifierKeys.SHIFT)
+   * );
+   * ```
+   */
+  enableSelectionWithOptions(mode: SelectionMode, trim_whitespace: boolean, require_modifiers: ModifierKeys): void;
   /**
    * Create a new terminal renderer with the default embedded font atlas.
    */
@@ -196,6 +252,36 @@ export class CellStyle {
   readonly bits: number;
 }
 
+export class ModifierKeys {
+  private constructor();
+  free(): void;
+  [Symbol.dispose](): void;
+  /**
+   * Combines two modifier key sets using bitwise OR
+   */
+  or(other: ModifierKeys): ModifierKeys;
+  /**
+   * Alt key (Option on macOS)
+   */
+  static readonly ALT: ModifierKeys;
+  /**
+   * Meta key (Command on macOS, Windows key on Windows)
+   */
+  static readonly META: ModifierKeys;
+  /**
+   * No modifier keys required
+   */
+  static readonly NONE: ModifierKeys;
+  /**
+   * Shift key
+   */
+  static readonly SHIFT: ModifierKeys;
+  /**
+   * Control key (Ctrl)
+   */
+  static readonly CONTROL: ModifierKeys;
+}
+
 export class MouseEvent {
   private constructor();
   free(): void;
@@ -228,6 +314,10 @@ export class MouseEvent {
    * Whether Alt key was pressed
    */
   alt_key: boolean;
+  /**
+   * Whether Meta key was pressed (Command on macOS, Windows key on Windows)
+   */
+  meta_key: boolean;
 }
 
 /**

package/beamterm_renderer_bg.js

@@ -247,8 +247,8 @@ function wasm_bindgen__convert__closures_____invoke__hbee1b5e623a87165(arg0, arg
     wasm.wasm_bindgen__convert__closures_____invoke__hbee1b5e623a87165(arg0, arg1, arg2);
 }
 
-function wasm_bindgen__convert__closures_____invoke__h4d1e7414f3e2b484(arg0, arg1, arg2) {
-    wasm.wasm_bindgen__convert__closures_____invoke__h4d1e7414f3e2b484(arg0, arg1, arg2);
+function wasm_bindgen__convert__closures_____invoke__h9fc62350024edcc7(arg0, arg1, arg2) {
+    wasm.wasm_bindgen__convert__closures_____invoke__h9fc62350024edcc7(arg0, arg1, arg2);
 }
 
 const BatchFinalization = (typeof FinalizationRegistry === 'undefined')
@@ -271,6 +271,10 @@ const CellStyleFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_cellstyle_free(ptr >>> 0, 1));
 
+const ModifierKeysFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_modifierkeys_free(ptr >>> 0, 1));
+
 const MouseEventFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_mouseevent_free(ptr >>> 0, 1));
@@ -428,19 +432,12 @@ export class BeamtermRenderer {
         wasm.beamtermrenderer_clearSelection(this.__wbg_ptr);
     }
     /**
-     * Enable default mouse selection behavior with built-in copy to clipboard.
-     *
-     * # Arguments
-     * * `mode` - Selection mode (Linear or Block)
-     * * `trim_whitespace` - Whether to trim trailing whitespace from selections
-     * * `drag_threshold_ms` - Optional minimum time (ms) before drag activates selection.
-     *   Defaults to 200ms. Higher values prevent accidental selections during fast gestures.
+     * Enable default mouse selection behavior with built-in copy to clipboard
      * @param {SelectionMode} mode
      * @param {boolean} trim_whitespace
-     * @param {number | null} [drag_threshold_ms]
      */
-    enableSelection(mode, trim_whitespace, drag_threshold_ms) {
-        const ret = wasm.beamtermrenderer_enableSelection(this.__wbg_ptr, mode, trim_whitespace, !isLikeNone(drag_threshold_ms), isLikeNone(drag_threshold_ms) ? 0 : drag_threshold_ms);
+    enableSelection(mode, trim_whitespace) {
+        const ret = wasm.beamtermrenderer_enableSelection(this.__wbg_ptr, mode, trim_whitespace);
         if (ret[1]) {
             throw takeFromExternrefTable0(ret[0]);
         }
@@ -524,6 +521,90 @@ export class BeamtermRenderer {
         }
         return BeamtermRenderer.__wrap(ret[0]);
     }
+    /**
+     * Replace the current font atlas with a new static atlas.
+     *
+     * This method enables runtime font switching by loading a new `.atlas` file.
+     * All existing cell content is preserved and translated to the new atlas.
+     *
+     * # Arguments
+     * * `atlas_data` - Binary atlas data (from .atlas file), or null for default
+     *
+     * # Example
+     * ```javascript
+     * const atlasData = await fetch('new-font.atlas').then(r => r.arrayBuffer());
+     * renderer.replaceWithStaticAtlas(new Uint8Array(atlasData));
+     * ```
+     * @param {Uint8Array | null} [atlas_data]
+     */
+    replaceWithStaticAtlas(atlas_data) {
+        const ret = wasm.beamtermrenderer_replaceWithStaticAtlas(this.__wbg_ptr, isLikeNone(atlas_data) ? 0 : addToExternrefTable0(atlas_data));
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Replace the current font atlas with a new dynamic atlas.
+     *
+     * This method enables runtime font switching by creating a new dynamic atlas
+     * with the specified font family and size. All existing cell content is
+     * preserved and translated to the new atlas.
+     *
+     * # Arguments
+     * * `font_family` - Array of font family names (e.g., `["Hack", "JetBrains Mono"]`)
+     * * `font_size` - Font size in pixels
+     *
+     * # Example
+     * ```javascript
+     * renderer.replaceWithDynamicAtlas(["Fira Code", "monospace"], 18.0);
+     * ```
+     * @param {Array<any>} font_family
+     * @param {number} font_size
+     */
+    replaceWithDynamicAtlas(font_family, font_size) {
+        const ret = wasm.beamtermrenderer_replaceWithDynamicAtlas(this.__wbg_ptr, font_family, font_size);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
+    /**
+     * Enable mouse selection with full configuration options.
+     *
+     * This method allows specifying modifier keys that must be held for selection
+     * to activate, in addition to the selection mode and whitespace trimming.
+     *
+     * # Arguments
+     * * `mode` - Selection mode (Block or Linear)
+     * * `trim_whitespace` - Whether to trim trailing whitespace from selected text
+     * * `require_modifiers` - Modifier keys that must be held to start selection
+     *
+     * # Example
+     * ```javascript
+     * // Require Shift+Click to start selection
+     * renderer.enableSelectionWithOptions(
+     *     SelectionMode.Linear,
+     *     true,
+     *     ModifierKeys.SHIFT
+     * );
+     *
+     * // Require Ctrl+Shift+Click
+     * renderer.enableSelectionWithOptions(
+     *     SelectionMode.Block,
+     *     false,
+     *     ModifierKeys.CONTROL.or(ModifierKeys.SHIFT)
+     * );
+     * ```
+     * @param {SelectionMode} mode
+     * @param {boolean} trim_whitespace
+     * @param {ModifierKeys} require_modifiers
+     */
+    enableSelectionWithOptions(mode, trim_whitespace, require_modifiers) {
+        _assertClass(require_modifiers, ModifierKeys);
+        const ret = wasm.beamtermrenderer_enableSelectionWithOptions(this.__wbg_ptr, mode, trim_whitespace, require_modifiers.__wbg_ptr);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
     /**
      * Create a new terminal renderer with the default embedded font atlas.
      * @param {string} canvas_id
@@ -852,6 +933,86 @@ export class CellStyle {
 }
 if (Symbol.dispose) CellStyle.prototype[Symbol.dispose] = CellStyle.prototype.free;
 
+/**
+ * Modifier key flags for mouse selection.
+ *
+ * Use bitwise OR to combine multiple modifiers:
+ * ```javascript
+ * const modifiers = ModifierKeys.SHIFT | ModifierKeys.CONTROL;
+ * renderer.enableSelectionWithOptions(SelectionMode.Block, true, modifiers);
+ * ```
+ */
+export class ModifierKeys {
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(ModifierKeys.prototype);
+        obj.__wbg_ptr = ptr;
+        ModifierKeysFinalization.register(obj, obj.__wbg_ptr, obj);
+        return obj;
+    }
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        ModifierKeysFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_modifierkeys_free(ptr, 0);
+    }
+    /**
+     * Combines two modifier key sets using bitwise OR
+     * @param {ModifierKeys} other
+     * @returns {ModifierKeys}
+     */
+    or(other) {
+        _assertClass(other, ModifierKeys);
+        const ret = wasm.modifierkeys_or(this.__wbg_ptr, other.__wbg_ptr);
+        return ModifierKeys.__wrap(ret);
+    }
+    /**
+     * Alt key (Option on macOS)
+     * @returns {ModifierKeys}
+     */
+    static get ALT() {
+        const ret = wasm.modifierkeys_ALT();
+        return ModifierKeys.__wrap(ret);
+    }
+    /**
+     * Meta key (Command on macOS, Windows key on Windows)
+     * @returns {ModifierKeys}
+     */
+    static get META() {
+        const ret = wasm.modifierkeys_META();
+        return ModifierKeys.__wrap(ret);
+    }
+    /**
+     * No modifier keys required
+     * @returns {ModifierKeys}
+     */
+    static get NONE() {
+        const ret = wasm.modifierkeys_NONE();
+        return ModifierKeys.__wrap(ret);
+    }
+    /**
+     * Shift key
+     * @returns {ModifierKeys}
+     */
+    static get SHIFT() {
+        const ret = wasm.modifierkeys_SHIFT();
+        return ModifierKeys.__wrap(ret);
+    }
+    /**
+     * Control key (Ctrl)
+     * @returns {ModifierKeys}
+     */
+    static get CONTROL() {
+        const ret = wasm.modifierkeys_CONTROL();
+        return ModifierKeys.__wrap(ret);
+    }
+}
+if (Symbol.dispose) ModifierKeys.prototype[Symbol.dispose] = ModifierKeys.prototype.free;
+
 /**
  * Mouse event data with terminal coordinates
  */
@@ -978,6 +1139,21 @@ export class MouseEvent {
     set alt_key(arg0) {
         wasm.__wbg_set_mouseevent_alt_key(this.__wbg_ptr, arg0);
     }
+    /**
+     * Whether Meta key was pressed (Command on macOS, Windows key on Windows)
+     * @returns {boolean}
+     */
+    get meta_key() {
+        const ret = wasm.__wbg_get_mouseevent_meta_key(this.__wbg_ptr);
+        return ret !== 0;
+    }
+    /**
+     * Whether Meta key was pressed (Command on macOS, Windows key on Windows)
+     * @param {boolean} arg0
+     */
+    set meta_key(arg0) {
+        wasm.__wbg_set_mouseevent_meta_key(this.__wbg_ptr, arg0);
+    }
 }
 if (Symbol.dispose) MouseEvent.prototype[Symbol.dispose] = MouseEvent.prototype.free;
 
@@ -1312,6 +1488,10 @@ export function __wbg_bufferData_ca0a87aa6811791d(arg0, arg1, arg2, arg3, arg4)
     arg0.bufferData(arg1 >>> 0, getArrayU8FromWasm0(arg2, arg3), arg4 >>> 0);
 };
 
+export function __wbg_bufferSubData_16db9d7d9f1c86bb(arg0, arg1, arg2, arg3) {
+    arg0.bufferSubData(arg1 >>> 0, arg2, arg3);
+};
+
 export function __wbg_button_a54acd25bab5d442(arg0) {
     const ret = arg0.button;
     return ret;
@@ -1611,6 +1791,11 @@ export function __wbg_log_1d990106d99dacb7(arg0) {
     console.log(arg0);
 };
 
+export function __wbg_metaKey_448c751accad2eba(arg0) {
+    const ret = arg0.metaKey;
+    return ret;
+};
+
 export function __wbg_mouseevent_new(arg0) {
     const ret = MouseEvent.__wrap(arg0);
     return ret;
@@ -1661,11 +1846,6 @@ export function __wbg_next_3cfe5c0fe2a4cc53() { return handleError(function (arg
     return ret;
 }, arguments) };
 
-export function __wbg_now_8cf15d6e317793e1(arg0) {
-    const ret = arg0.now();
-    return ret;
-};
-
 export function __wbg_offsetX_cef943cf53ab2b5a(arg0) {
     const ret = arg0.offsetX;
     return ret;
@@ -1676,11 +1856,6 @@ export function __wbg_offsetY_9a093457f71ef493(arg0) {
     return ret;
 };
 
-export function __wbg_performance_c77a440eff2efd9b(arg0) {
-    const ret = arg0.performance;
-    return isLikeNone(ret) ? 0 : addToExternrefTable0(ret);
-};
-
 export function __wbg_prototypesetcall_dfe9b766cdc1f1fd(arg0, arg1, arg2) {
     Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
 };
@@ -1861,24 +2036,18 @@ export function __wbg_writeText_c9776abb6826901c(arg0, arg1, arg2) {
     return ret;
 };
 
-export function __wbindgen_cast_146fd35f906c65cd(arg0, arg1) {
-    // Cast intrinsic for `Closure(Closure { dtor_idx: 111, function: Function { arguments: [Externref], shim_idx: 112, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h128802127193e191, wasm_bindgen__convert__closures_____invoke__hbee1b5e623a87165);
-    return ret;
-};
-
-export function __wbindgen_cast_195a282855cb0b65(arg0, arg1) {
-    // Cast intrinsic for `Closure(Closure { dtor_idx: 61, function: Function { arguments: [NamedExternref("MouseEvent")], shim_idx: 62, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
-    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h63d9d38af9217a8f, wasm_bindgen__convert__closures_____invoke__h4d1e7414f3e2b484);
-    return ret;
-};
-
 export function __wbindgen_cast_2241b6af4c4b2941(arg0, arg1) {
     // Cast intrinsic for `Ref(String) -> Externref`.
     const ret = getStringFromWasm0(arg0, arg1);
     return ret;
 };
 
+export function __wbindgen_cast_5f9a13552260be22(arg0, arg1) {
+    // Cast intrinsic for `Closure(Closure { dtor_idx: 112, function: Function { arguments: [Externref], shim_idx: 113, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h128802127193e191, wasm_bindgen__convert__closures_____invoke__hbee1b5e623a87165);
+    return ret;
+};
+
 export function __wbindgen_cast_cb9088102bce6b30(arg0, arg1) {
     // Cast intrinsic for `Ref(Slice(U8)) -> NamedExternref("Uint8Array")`.
     const ret = getArrayU8FromWasm0(arg0, arg1);
@@ -1897,6 +2066,12 @@ export function __wbindgen_cast_d6cd19b81560fd6e(arg0) {
     return ret;
 };
 
+export function __wbindgen_cast_dac1fd37d8c7b8e4(arg0, arg1) {
+    // Cast intrinsic for `Closure(Closure { dtor_idx: 27, function: Function { arguments: [NamedExternref("MouseEvent")], shim_idx: 28, ret: Unit, inner_ret: Some(Unit) }, mutable: true }) -> Externref`.
+    const ret = makeMutClosure(arg0, arg1, wasm.wasm_bindgen__closure__destroy__h4e834c369ab09e90, wasm_bindgen__convert__closures_____invoke__h9fc62350024edcc7);
+    return ret;
+};
+
 export function __wbindgen_init_externref_table() {
     const table = wasm.__wbindgen_externrefs;
     const offset = table.grow(4);

package/package.json

@@ -5,8 +5,8 @@
     "Adrian Papari <junkdog@angelhill.net>",
     "kofany <j@dabrowski.biz>"
   ],
-  "description": "WebGL2 terminal renderer (terX fork with HiDPI selection fix)",
-  "version": "0.12.1",
+  "description": "High-performance WebGL2 terminal renderer for beamterm, targeting sub-millisecond render times in web browsers",
+  "version": "0.12.2",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -22,7 +22,7 @@
     "beamterm_renderer.d.ts"
   ],
   "main": "beamterm_renderer.js",
-  "homepage": "https://github.com/junkdog/beamterm",
+  "homepage": "https://github.com/kofany/beamterm",
   "types": "beamterm_renderer.d.ts",
   "sideEffects": [
     "./beamterm_renderer.js",
@@ -35,4 +35,4 @@
     "rendering",
     "gpu"
   ]
-}
+}