restty 0.1.25 → 0.1.26

package/README.md

@@ -173,10 +173,23 @@ const metricsPlugin: ResttyPlugin = {
     const lifecycle = ctx.addLifecycleHook(({ phase, action }) => {
       console.log("lifecycle", phase, action);
     });
+    const stage = ctx.addRenderStage({
+      id: "metrics/tint",
+      mode: "after-main",
+      uniforms: [0.12],
+      shader: {
+        wgsl: `
+fn resttyStage(color: vec4f, uv: vec2f, time: f32, params0: vec4f, params1: vec4f) -> vec4f {
+  return vec4f(min(vec3f(1.0), color.rgb + vec3f(params0.x, 0.0, 0.0)), color.a);
+}
+`,
+      },
+    });
     return () => {
       paneCreated.dispose();
       outgoing.dispose();
       lifecycle.dispose();
+      stage.dispose();
     };
   },
 };
@@ -199,6 +212,50 @@ await restty.loadPlugins(
 
 See `docs/plugins.md` for full plugin authoring details.
 
+### Shader stages
+
+Shader stages let you extend the final frame pipeline with WGSL/GLSL passes.
+
+Global stages:
+
+```ts
+restty.setShaderStages([
+  {
+    id: "app/crt-lite",
+    mode: "after-main",
+    backend: "both",
+    uniforms: [0.24, 0.12],
+    shader: {
+      wgsl: `
+fn resttyStage(color: vec4f, uv: vec2f, time: f32, params0: vec4f, params1: vec4f) -> vec4f {
+  let v = clamp(params0.x, 0.0, 0.8);
+  let centered = (uv - vec2f(0.5, 0.5)) * 2.0;
+  let vignette = max(0.0, 1.0 - v * dot(centered, centered));
+  return vec4f(color.rgb * vignette, color.a);
+}
+`,
+    },
+  },
+]);
+
+const stage = restty.addShaderStage({
+  id: "app/mono",
+  mode: "after-main",
+  uniforms: [1.0],
+  shader: {
+    wgsl: `
+fn resttyStage(color: vec4f, uv: vec2f, time: f32, params0: vec4f, params1: vec4f) -> vec4f {
+  let l = dot(color.rgb, vec3f(0.2126, 0.7152, 0.0722));
+  return vec4f(l * 0.12, l * 0.95, l * 0.35, color.a);
+}
+`,
+  },
+});
+
+stage.setEnabled(false);
+restty.removeShaderStage("app/mono");
+```
+
 ### xterm compatibility layer
 
 For migration from xterm.js-style app code, use `restty/xterm`:
@@ -260,7 +317,12 @@ Active-pane convenience:
 Plugin host:
 
 - `use(plugin, options?)` / `loadPlugins(manifest, registry)` / `unuse(pluginId)` / `plugins()` / `pluginInfo(pluginId?)`
-- plugin context supports `on(...)`, `addInputInterceptor(...)`, `addOutputInterceptor(...)`, `addLifecycleHook(...)`, `addRenderHook(...)`
+- plugin context supports `on(...)`, `addInputInterceptor(...)`, `addOutputInterceptor(...)`, `addLifecycleHook(...)`, `addRenderHook(...)`, `addRenderStage(...)`
+
+Shader stages:
+
+- `setShaderStages(stages)` / `getShaderStages()`
+- `addShaderStage(stage)` / `removeShaderStage(id)`
 
 ## Advanced / Internal Modules
 
@@ -281,6 +343,13 @@ bun run playground
 
 Open `http://localhost:5173`.
 
+## Code Layout
+
+- `src/surface/`: public API (`Restty`), pane manager orchestration, plugin host, xterm shim.
+- `src/runtime/`: terminal runtime/render loop implementation.
+- `src/renderer/`, `src/input/`, `src/pty/`, `src/fonts/`, `src/theme/`, `src/wasm/`, `src/selection/`: subsystem modules.
+- `src/app/`: compatibility re-export layer while internals are refactored.
+
 ## Repository Commands
 
 ```bash

package/dist/{chunk-pab3ge3d.js → chunk-y290zh3e.js}

@@ -7922,12 +7922,14 @@ function encodeBeforeInputEvent(event) {
   const type = event.inputType;
   if (type === "insertText")
     return event.data || "";
-  if (type === "insertLineBreak")
+  if (type === "insertLineBreak" || type === "insertParagraph")
     return sequences.enter;
-  if (type === "deleteContentBackward")
+  if (type === "deleteContentBackward" || type === "deleteWordBackward" || type === "deleteSoftLineBackward" || type === "deleteHardLineBackward" || type === "deleteEntireSoftLine") {
     return sequences.backspace;
-  if (type === "deleteContentForward")
+  }
+  if (type === "deleteContentForward" || type === "deleteWordForward" || type === "deleteSoftLineForward" || type === "deleteHardLineForward") {
     return sequences.delete;
+  }
   if (type === "insertFromPaste") {
     return event.dataTransfer?.getData("text/plain") || "";
   }
@@ -8303,10 +8305,20 @@ function encodeKittyKeyEvent(event, kittyFlags) {
 }
 
 // src/input/keymap/pty-map.ts
+function parseKittyEventType(body) {
+  const [, modifiersPart = ""] = body.split(";");
+  if (!modifiersPart)
+    return 0;
+  const [, eventTypePart = ""] = modifiersPart.split(":");
+  const parsed = Number(eventTypePart);
+  return Number.isFinite(parsed) ? parsed : 0;
+}
 function mapKeySequenceForPty(seq) {
   const csi = "\x1B[";
   if (seq.startsWith(csi) && seq.endsWith("u")) {
     const body = seq.slice(csi.length, -1);
+    if (parseKittyEventType(body) === 3)
+      return seq;
     const [codeText] = body.split(";");
     if (codeText && /^[0-9]+$/.test(codeText)) {
       const code = Number(codeText);
@@ -8320,6 +8332,8 @@ function mapKeySequenceForPty(seq) {
   }
   if (seq.startsWith(csi) && seq.endsWith("~")) {
     const body = seq.slice(csi.length, -1);
+    if (parseKittyEventType(body) === 3)
+      return seq;
     if (body === "3" || body.startsWith("3;"))
       return "\x1B[3~";
   }
@@ -52765,24 +52779,7 @@ function createDumpGlyphRender(options) {
     });
     const uniforms = new Float32Array([outW, outH, 0, 0, 0, 0, 0, 0]);
     state2.device.queue.writeBuffer(uniformBuffer, 0, uniforms);
-    const instance = new Float32Array([
-      0,
-      0,
-      outW,
-      outH,
-      u02,
-      v02,
-      u12,
-      v12,
-      1,
-      1,
-      1,
-      1,
-      0,
-      0,
-      0,
-      1
-    ]);
+    const instance = new Float32Array([0, 0, outW, outH, u02, v02, u12, v12, 1, 1, 1, 1, 0, 0, 0, 1]);
     const instanceBuffer = state2.device.createBuffer({
       size: instance.byteLength,
       usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
@@ -52889,7 +52886,10 @@ function createSetupDebugExpose(options, diagnoseCodepoint) {
     debugWindow.dumpAtlasRegion = createDumpAtlasRegion(options);
     debugWindow.dumpGlyphRender = createDumpGlyphRender(options);
   };
-  function createDumpGlyphMetrics({ pickFontIndexForText: pickFontIndexForText2, fontState }) {
+  function createDumpGlyphMetrics({
+    pickFontIndexForText: pickFontIndexForText2,
+    fontState
+  }) {
     return (cp) => {
       const text2 = String.fromCodePoint(cp);
       const fontIndex = pickFontIndexForText2(text2, 1);
@@ -52937,9 +52937,7 @@ function createSetupDebugExpose(options, diagnoseCodepoint) {
       return { fontIndex, glyphId };
     };
   }
-  function createDumpAtlasRegion({
-    getActiveState
-  }) {
+  function createDumpAtlasRegion({ getActiveState }) {
     return async (fontIndex, x3, y, width, height) => {
       const state2 = getActiveState();
       if (!state2 || !("device" in state2)) {
@@ -52951,7 +52949,10 @@ function createSetupDebugExpose(options, diagnoseCodepoint) {
         console.warn("atlas not ready");
         return null;
       }
-      const image = await readTextureToImageData(state2.device, atlasState.texture, width, height, { x: x3, y });
+      const image = await readTextureToImageData(state2.device, atlasState.texture, width, height, {
+        x: x3,
+        y
+      });
       const canvas = document.createElement("canvas");
       canvas.width = width;
       canvas.height = height;
@@ -53222,6 +53223,21 @@ function bindImeEvents(options) {
     keydownBeforeinputDedupeMs
   } = bindOptions;
   let suppressNextInput = false;
+  let lastNormalizedKeydownSeq = "";
+  let lastNormalizedKeydownSeqSource = "";
+  const getNormalizedLastKeydownSeq = () => {
+    const source = getLastKeydownSeq();
+    if (!source) {
+      lastNormalizedKeydownSeqSource = "";
+      lastNormalizedKeydownSeq = "";
+      return "";
+    }
+    if (source === lastNormalizedKeydownSeqSource)
+      return lastNormalizedKeydownSeq;
+    lastNormalizedKeydownSeqSource = source;
+    lastNormalizedKeydownSeq = inputHandler.mapKeyForPty(source);
+    return lastNormalizedKeydownSeq;
+  };
   const onCompositionStart = (event) => {
     imeState.composing = true;
     setPreedit2(event.data || imeInput.value || "");
@@ -53263,8 +53279,10 @@ function bindImeEvents(options) {
     }
     const text2 = inputHandler.encodeBeforeInput(event);
     if (text2) {
+      const normalizedText = inputHandler.mapKeyForPty(text2);
+      const normalizedLastKeydownSeq = getNormalizedLastKeydownSeq();
       const now = performance.now();
-      if (getLastKeydownSeq() && text2 === getLastKeydownSeq() && now - getLastKeydownSeqAt() <= keydownBeforeinputDedupeMs) {
+      if (normalizedLastKeydownSeq && normalizedText === normalizedLastKeydownSeq && now - getLastKeydownSeqAt() <= keydownBeforeinputDedupeMs) {
         event.preventDefault();
         suppressNextInput = true;
         imeInput.value = "";
@@ -57883,10 +57901,7 @@ function createFontRuntimeTextHelpers(options) {
       (entry) => hasBoldHint(entry) && hasItalicHint(entry),
       (entry) => hasBoldHint(entry),
       (entry) => hasItalicHint(entry)
-    ] : stylePreference === "bold" ? [
-      (entry) => hasBoldHint(entry) && !hasItalicHint(entry),
-      (entry) => hasBoldHint(entry)
-    ] : stylePreference === "italic" ? [
+    ] : stylePreference === "bold" ? [(entry) => hasBoldHint(entry) && !hasItalicHint(entry), (entry) => hasBoldHint(entry)] : stylePreference === "italic" ? [
       (entry) => hasItalicHint(entry) && !hasBoldHint(entry),
       (entry) => hasItalicHint(entry)
     ] : [];
@@ -59845,7 +59860,19 @@ function createResttyApp(options) {
       lastRenderState = value;
     }
   });
-  const readRuntimeAppApiState = () => ({ wasm, wasmExports, wasmHandle, wasmReady, activeState, needsRender, lastRenderTime, currentContextType, isFocused, lastKeydownSeq, lastKeydownSeqAt });
+  const readRuntimeAppApiState = () => ({
+    wasm,
+    wasmExports,
+    wasmHandle,
+    wasmReady,
+    activeState,
+    needsRender,
+    lastRenderTime,
+    currentContextType,
+    isFocused,
+    lastKeydownSeq,
+    lastKeydownSeqAt
+  });
   const writeRuntimeAppApiState = (patch) => {
     ({
       wasm = wasm,

package/dist/internal.js

@@ -100,7 +100,7 @@ import {
   updateGridState,
   updateImePosition,
   updateSelection
-} from "./chunk-pab3ge3d.js";
+} from "./chunk-y290zh3e.js";
 export {
   updateSelection,
   updateImePosition,

package/dist/restty.js

@@ -8,7 +8,7 @@ import {
   isBuiltinThemeName,
   listBuiltinThemeNames,
   parseGhosttyTheme
-} from "./chunk-pab3ge3d.js";
+} from "./chunk-y290zh3e.js";
 export {
   parseGhosttyTheme,
   listBuiltinThemeNames,

package/dist/runtime/create-runtime.d.ts

@@ -1,6 +1,6 @@
 import type { ResttyApp, ResttyAppOptions } from "./types";
 export { createResttyAppSession, getDefaultResttyAppSession } from "./session";
-export { createResttyPaneManager, } from "../surface/panes/manager";
+export { createResttyPaneManager } from "../surface/panes/manager";
 export { createDefaultResttyPaneContextMenuItems, getResttyShortcutModifierLabel, } from "../surface/panes/default-context-menu-items";
 export type { ResttyAppElements, ResttyAppCallbacks, FontSource, ResttyFontSource, ResttyTouchSelectionMode, ResttyUrlFontSource, ResttyBufferFontSource, ResttyLocalFontSource, ResttyWasmLogListener, ResttyAppSession, ResttyAppInputPayload, ResttyShaderStage, ResttyShaderStageMode, ResttyShaderStageBackend, ResttyShaderStageSource, ResttyAppOptions, ResttyApp, } from "./types";
 export type { ResttyPaneSplitDirection, ResttyPaneContextMenuItem, ResttyPaneDefinition, ResttyPaneStyleOptions, ResttyPaneStylesOptions, ResttyPaneShortcutsOptions, ResttyPaneContextMenuOptions, CreateResttyPaneManagerOptions, ResttyPaneManager, ResttyPaneWithApp, CreateDefaultResttyPaneContextMenuItemsOptions, } from "../surface/panes-types";

package/dist/xterm.js

@@ -1,6 +1,6 @@
 import {
   createRestty
-} from "./chunk-pab3ge3d.js";
+} from "./chunk-y290zh3e.js";
 
 // src/xterm/app-options.ts
 function createCompatAppOptions(userAppOptions, emitData) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restty",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "description": "Browser terminal rendering library powered by WASM, WebGPU/WebGL2, and TypeScript text shaping.",
   "keywords": [
     "terminal",