@code-yeongyu/senpi-tui 2026.10.31-1 → 2026.10.31-2

package/dist/components/input.d.ts

@@ -1,5 +1,8 @@
 import { type Component, type Focusable, type TuiMouseEvent, type TuiMouseEventResult } from "../tui.ts";
 export interface InputOptions {
+    /** Render only masks; editing state belongs to this instance and must be disposed at settlement. */
+    secret?: boolean;
+    onInvalidInput?: () => void;
     prompt?: string;
     placeholder?: string;
     placeholderStyle?: (text: string) => string;
@@ -11,6 +14,8 @@ export declare class Input implements Component, Focusable {
     private value;
     private cursor;
     private readonly prompt;
+    private readonly secret;
+    private readonly onInvalidInput;
     private readonly placeholder;
     private readonly placeholderStyle;
     private renderedStartColumn;
@@ -43,6 +48,8 @@ export declare class Input implements Component, Focusable {
     private moveWordForwards;
     private handlePaste;
     invalidate(): void;
+    /** Drop every private editing reference; this cannot promise erasure of immutable JS strings. */
+    dispose(): void;
     render(width: number): string[];
 }
 //# sourceMappingURL=input.d.ts.map

package/dist/components/input.js

@@ -24,6 +24,8 @@ export class Input {
         this.lastAction = null;
         // Undo support
         this.undoStack = new UndoStack();
+        this.secret = options.secret === true;
+        this.onInvalidInput = options.onInvalidInput;
         this.prompt = options.prompt ?? "> ";
         this.placeholder = options.placeholder ?? "";
         this.placeholderStyle = options.placeholderStyle ?? ((text) => text);
@@ -32,6 +34,10 @@ export class Input {
         return this.value;
     }
     setValue(value) {
+        if (this.secret && /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/u.test(value)) {
+            this.onInvalidInput?.();
+            return;
+        }
         this.value = value;
         this.cursor = Math.min(this.cursor, value.length);
     }
@@ -175,6 +181,9 @@ export class Input {
         if (!hasControlChars) {
             this.insertCharacter(data);
         }
+        else if (this.secret && !data.startsWith("\x1b")) {
+            this.onInvalidInput?.();
+        }
     }
     handleMouse(event) {
         if (event.type !== "press" || event.button !== "left" || event.y !== 0)
@@ -184,7 +193,7 @@ export class Input {
         let currentColumn = 0;
         this.cursor = this.value.length;
         for (const grapheme of segmenter.segment(this.value)) {
-            const nextColumn = currentColumn + visibleWidth(grapheme.segment);
+            const nextColumn = currentColumn + (this.secret ? 1 : visibleWidth(grapheme.segment));
             if (targetColumn < nextColumn) {
                 this.cursor = grapheme.index;
                 break;
@@ -195,6 +204,10 @@ export class Input {
         return { handled: true, focus: true };
     }
     insertCharacter(char) {
+        if (this.secret && /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/u.test(char)) {
+            this.onInvalidInput?.();
+            return;
+        }
         // Undo coalescing: consecutive word chars coalesce into one undo unit
         if (isWhitespaceChar(char) || this.lastAction !== "type-word") {
             this.pushUndo();
@@ -324,6 +337,10 @@ export class Input {
         this.cursor = findWordForward(this.value, this.cursor);
     }
     handlePaste(pastedText) {
+        if (this.secret) {
+            this.insertCharacter(pastedText);
+            return;
+        }
         this.lastAction = null;
         this.pushUndo();
         // Clean the pasted text - remove newlines and carriage returns
@@ -335,12 +352,37 @@ export class Input {
     invalidate() {
         // No cached state to invalidate currently
     }
+    /** Drop every private editing reference; this cannot promise erasure of immutable JS strings. */
+    dispose() {
+        if (!this.secret)
+            return;
+        this.value = "";
+        this.cursor = 0;
+        this.pasteBuffer = "";
+        this.isInPaste = false;
+        this.killRing = new KillRing();
+        this.undoStack.clear();
+        this.lastAction = null;
+        this.onSubmit = undefined;
+        this.onEscape = undefined;
+    }
     render(width) {
         // Calculate visible window
         const availableWidth = width - visibleWidth(this.prompt);
         if (availableWidth <= 0) {
             return [truncateToWidth(this.prompt, width, "")];
         }
+        if (this.secret) {
+            const length = [...segmenter.segment(this.value)].length;
+            const cursor = [...segmenter.segment(this.value.slice(0, this.cursor))].length;
+            const start = Math.max(0, cursor - availableWidth + 1);
+            this.renderedStartColumn = start;
+            const shown = "*".repeat(Math.min(length - start, availableWidth));
+            const offset = cursor - start;
+            const marker = this.focused ? CURSOR_MARKER : "";
+            const rendered = shown.slice(0, offset) + marker + "\x1b[7m" + (shown[offset] ?? " ") + "\x1b[27m" + shown.slice(offset + 1);
+            return [this.prompt + rendered + " ".repeat(Math.max(0, availableWidth - visibleWidth(rendered)))];
+        }
         if (this.value.length === 0 && this.placeholder) {
             const placeholder = truncateToWidth(this.placeholder, availableWidth, "");
             const graphemes = [...segmenter.segment(placeholder)];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-tui",
-	"version": "2026.10.31-1",
+	"version": "2026.10.31-2",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "dist/index.js",