webssh2_client 2.0.0-alpha.6 → 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Bill Church
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -11,17 +11,13 @@ WebSSH2 Client is an HTML5 web-based terminal emulator and SSH client component.
 
 # Important Notice
 
-This package contains only the browser-side client component of WebSSH2. It requires a compatible WebSSH2 server to function. The server component is available at [webssh2 server](https://github.com/billchurch/webssh2/tree/bigip-server). This package is intended for advanced users who want to customize or integrate the client component independently.
-
-# Status
-
-This is an experimental refactor of the WebSSH2 v0.2.x client to function as a standalone component. It has been separated from the server-side code to facilitate customization and integration with different frameworks.
+This package contains only the browser-side client component of WebSSH2. It requires a compatible WebSSH2 server to function. The server component is available at [webssh2 server](https://github.com/billchurch/webssh2). This package is intended for advanced users who want to customize or integrate the client component independently.
 
 ## Requirements
 
 - Modern web browser with JavaScript enabled
-- Compatible WebSSH2 server instance (v0.2.x or compatible)
-- Socket.IO v2.2.0 compatibility (due to server requirements)
+- Compatible WebSSH2 server instance (v2.0.0 or compatible)
+- Socket.IO v4.8.1 compatibility
 
 ## Installation
 
@@ -68,11 +64,19 @@ For server setup instructions, refer to the [WebSSH2 server documentation](https
   - OS-aware keyboard shortcuts (Ctrl+F on Windows/Linux, ⌘F on macOS)
   - Navigation with Enter/Shift+Enter or arrow buttons
   - F3/Shift+F3 for quick match navigation
+- **Advanced Clipboard Integration:**
+  - Auto-copy on selection (similar to terminals like tmux or PuTTY, configurable)
+  - Middle-click paste support (configurable)
+  - Keyboard shortcuts: Ctrl+Shift+C/V (Windows/Linux) or Cmd+Shift+C/V (macOS)
+  - Browser compatibility detection with fallback mechanisms
+  - Visual feedback with toast notifications
+  - All features can be toggled in Terminal Settings
 - Customizable terminal settings:
   - Font size and family
   - Color schemes
   - Cursor behavior
   - Scrollback buffer size
+  - Clipboard behavior controls
 - Session logging with download capability
 - Copy and paste functionality
 - Terminal mouse support
@@ -367,6 +371,53 @@ The system automatically detects whether you're using:
 - Mixed usage supported (header + headerBackground or headerStyle)
 - Graceful fallback to CSS for non-Tailwind values
 
+### Clipboard Settings
+
+The WebSSH2 client includes comprehensive clipboard integration. All clipboard features can be configured through the Terminal Settings modal (accessible from the menu) or via localStorage:
+
+#### Features
+
+1. **Auto-copy on Selection**: Automatically copies selected text to the system clipboard when you select text with your mouse (similar to tmux or PuTTY)
+2. **Middle-click Paste**: Paste clipboard contents by middle-clicking in the terminal
+3. **Keyboard Shortcuts**: Use Ctrl+Shift+C to copy and Ctrl+Shift+V to paste (Cmd+Shift+C/V on macOS)
+
+#### Configuration
+
+Clipboard settings are stored in localStorage under `webssh2.settings.global` and can be toggled via the Terminal Settings modal:
+
+- `clipboardAutoSelectToCopy` (default: `true`) - Enable/disable auto-copy on selection
+- `clipboardEnableMiddleClickPaste` (default: `true`) - Enable/disable middle-click paste
+- `clipboardEnableKeyboardShortcuts` (default: `true`) - Enable/disable keyboard shortcuts
+
+#### Browser Compatibility
+
+The clipboard integration includes:
+
+- Automatic detection of browser clipboard API support
+- Fallback mechanisms for older browsers
+- Security context validation (HTTPS/localhost required)
+- Browser-specific warnings and guidance
+- Visual feedback via toast notifications for clipboard operations
+
+#### Programmatic Configuration
+
+You can also configure clipboard settings programmatically:
+
+```javascript
+// Read current settings
+const settings = JSON.parse(
+  localStorage.getItem('webssh2.settings.global') || '{}'
+)
+
+// Update clipboard settings
+settings.clipboardAutoSelectToCopy = false // Disable auto-copy
+settings.clipboardEnableMiddleClickPaste = true // Enable middle-click
+settings.clipboardEnableKeyboardShortcuts = true // Enable shortcuts
+
+// Save settings
+localStorage.setItem('webssh2.settings.global', JSON.stringify(settings))
+```
+
 ### Configuration Object
 
 You can configure the client by setting `window.webssh2Config`:

package/client/index.d.ts

@@ -0,0 +1,6 @@
+declare const _default: {
+    getPublicPath: () => string;
+    version: string;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/client/index.js

@@ -1,14 +1,12 @@
 // client
 // client/index.ts
-import path from 'path'
-import { readFileSync } from 'fs'
-import { fileURLToPath } from 'url'
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
-const packageJson = JSON.parse(
-  readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8')
-)
+import path from 'path';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageJson = JSON.parse(readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
 export default {
-  getPublicPath: () => path.join(__dirname, 'public'),
-  version: packageJson.version
-}
+    getPublicPath: () => path.join(__dirname, 'public'),
+    version: packageJson.version
+};

package/client/public/client.htm

@@ -1,4 +1,4 @@
-<!-- Version Version 2.0.0-alpha.6 - 2025-09-07T19:18:43.996Z - 758b375 -->
+<!-- Version Version 2.0.0 - 2025-09-14T21:54:12.437Z - 8125560 -->
 <!-- webssh2-client -->
 <!-- /client/src/client.htm -->
 <!DOCTYPE html>