dsh-plugin-admin 0.4.0 → 0.4.1

package/lib/bring-explorer.ps1

@@ -1,6 +1,12 @@
 # dsh-plugin-admin: bring Explorer window to foreground
 # Usage: powershell -File bring-explorer.ps1 -Path <absolute path>
-param([Parameter(Mandatory=$true)][string]$Path)
+# Fail-soft contract: never waits on user input -- an empty/missing -Path
+# must NOT hit a Mandatory prompt (this console is HIDDEN; the process
+# would linger forever), so the parameter is optional and guarded below.
+param([string]$Path = '')
+
+$ErrorActionPreference = 'SilentlyContinue'
+if ([string]::IsNullOrWhiteSpace($Path)) { exit 0 }
 
 Add-Type @"
 using System;
@@ -18,8 +24,24 @@ public class Fr {
 }
 "@
 
-$base = ($Path -replace '\\', '/').Split('/')[-1]
-$script:pattern = [regex]::Escape($base) + '\s*-'
+# The title Explorer displays is the DISPLAY NAME of the revealed FOLDER:
+# the folder itself -- or its PARENT when reveal ran `/select,<file>` on a
+# file. Fall back to the last path segment when the item is gone/unreadable.
+$base = $null
+$item = Get-Item -LiteralPath $Path
+if ($null -ne $item) {
+  if ($item.PSIsContainer) { $base = $item.Name }
+  else { $base = Split-Path -Leaf $item.DirectoryName }
+} else {
+  $segments = ($Path -replace '\\', '/').Split('/') | Where-Object { $_ }
+  if ($segments.Count -gt 0) { $base = $segments[-1] }
+}
+if ([string]::IsNullOrWhiteSpace($base)) { exit 0 }
+
+# Stock Windows 10/11 titles are the bare folder name; some shell addons
+# append " - <suffix>". Anchor at start, make the dash clause optional so
+# both shapes match, and prefix collisions ("Test" vs "Test 2") stay safe.
+$script:pattern = '^' + [regex]::Escape($base) + '(?:\s*-|$)'
 $script:found = [IntPtr]::Zero
 
 function Find-Target {
@@ -45,12 +67,16 @@ for ($i = 0; $i -lt 30; $i++) {
   Start-Sleep -Milliseconds 200
 }
 
-if ($target -ne [IntPtr]::Zero) {
-  # Simulated ALT keypress grants foreground permission
-  [Fr]::keybd_event(0x12, 0, 0, [UIntPtr]::Zero)
-  [Fr]::keybd_event(0x12, 0, 2, [UIntPtr]::Zero)
-  Start-Sleep -Milliseconds 80
-  [Fr]::ShowWindow($target, 9) | Out-Null
-  [Fr]::SetForegroundWindow($target) | Out-Null
-  [Fr]::BringWindowToTop($target) | Out-Null
-}
+if ($target -eq [IntPtr]::Zero) { exit 1 }
+
+# Simulated ALT keypress grants foreground permission
+[Fr]::keybd_event(0x12, 0, 0, [UIntPtr]::Zero)
+[Fr]::keybd_event(0x12, 0, 2, [UIntPtr]::Zero)
+Start-Sleep -Milliseconds 80
+[Fr]::ShowWindow($target, 9) | Out-Null
+[Fr]::SetForegroundWindow($target) | Out-Null
+[Fr]::BringWindowToTop($target) | Out-Null
+
+# One debuggable line on stdout; the host pipe just drains it.
+Write-Output ("raised:{0}" -f $target)
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-admin",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "description": "dsh web UI plugin: unified administration panel — plugin and session management with modern tabbed Web UI (host remote + browser panel)",
   "main": "lib/index.js",