@freestyle-sh/with-ttyd 0.0.7 → 0.0.8

package/dist/index.d.ts

@@ -24,6 +24,8 @@ type TtydConfig = {
     readOnly?: boolean;
     /** Xterm.js theme settings passed to ttyd client options */
     theme?: Record<string, string | number | boolean>;
+    /** TTYD client options (xterm.js options, ttyd client flags) */
+    clientOptions?: Record<string, unknown>;
 };
 type ResolvedTerminalConfig = {
     port: number;
@@ -37,6 +39,7 @@ type ResolvedTerminalConfig = {
     title: string;
     readOnly: boolean;
     theme?: Record<string, string | number | boolean>;
+    clientOptions?: Record<string, unknown>;
 };
 declare class VmWebTerminal<T extends TtydConfig[] = TtydConfig[]> extends VmWith<VmWebTerminalInstance<T>> {
     private resolvedTerminals;

package/dist/index.js

@@ -24,7 +24,8 @@ class VmWebTerminal extends VmWith {
         credential: config.credential,
         title: config.title ?? `terminal-${port}`,
         readOnly: config.readOnly ?? false,
-        theme: config.theme
+        theme: config.theme,
+        clientOptions: config.clientOptions
       };
     });
   }
@@ -67,9 +68,23 @@ class VmWebTerminal extends VmWith {
       } else {
         args.push(`--writable`);
       }
+      if (t.theme && t.clientOptions && "theme" in t.clientOptions) {
+        throw new Error(
+          `Client option conflict for terminal on port ${t.port}: theme is set in both theme and clientOptions`
+        );
+      }
+      const clientOptions = {
+        ...t.clientOptions ?? {}
+      };
       if (t.theme) {
-        const themeJson = JSON.stringify(t.theme);
-        args.push(`-t 'theme=${themeJson}'`);
+        clientOptions.theme = t.theme;
+      }
+      for (const [key, value] of Object.entries(clientOptions)) {
+        if (value === void 0) {
+          continue;
+        }
+        const serialized = typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
+        args.push(`-t '${key}=${serialized}'`);
       }
       args.push(t.command);
       return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freestyle-sh/with-ttyd",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Web terminal for freestyle sandboxes",
   "type": "module",
   "main": "./dist/index.js",
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "freestyle-sandboxes": "^0.1.28",
-    "@freestyle-sh/with-pty": "^0.0.3"
+    "@freestyle-sh/with-pty": "^0.0.4"
   },
   "scripts": {
     "build": "pkgroll"

package/src/index.ts

@@ -25,6 +25,8 @@ export type TtydConfig = {
   readOnly?: boolean;
   /** Xterm.js theme settings passed to ttyd client options */
   theme?: Record<string, string | number | boolean>;
+  /** TTYD client options (xterm.js options, ttyd client flags) */
+  clientOptions?: Record<string, unknown>;
 };
 
 export type ResolvedTerminalConfig = {
@@ -36,6 +38,7 @@ export type ResolvedTerminalConfig = {
   title: string;
   readOnly: boolean;
   theme?: Record<string, string | number | boolean>;
+  clientOptions?: Record<string, unknown>;
 };
 
 // ============================================================================
@@ -77,6 +80,7 @@ export class VmWebTerminal<
         title: config.title ?? `terminal-${port}`,
         readOnly: config.readOnly ?? false,
         theme: config.theme,
+        clientOptions: config.clientOptions,
       };
     });
   }
@@ -133,9 +137,31 @@ export class VmWebTerminal<
         args.push(`--writable`);
       }
 
+      if (t.theme && t.clientOptions && "theme" in t.clientOptions) {
+        throw new Error(
+          `Client option conflict for terminal on port ${t.port}: theme is set in both theme and clientOptions`,
+        );
+      }
+
+      const clientOptions: Record<string, unknown> = {
+        ...(t.clientOptions ?? {}),
+      };
+
       if (t.theme) {
-        const themeJson = JSON.stringify(t.theme);
-        args.push(`-t 'theme=${themeJson}'`);
+        clientOptions.theme = t.theme;
+      }
+
+      for (const [key, value] of Object.entries(clientOptions)) {
+        if (value === undefined) {
+          continue;
+        }
+        const serialized =
+          typeof value === "string" ||
+          typeof value === "number" ||
+          typeof value === "boolean"
+            ? String(value)
+            : JSON.stringify(value);
+        args.push(`-t '${key}=${serialized}'`);
       }
 
       // Shell command at the end