Update docs for latest releases

Author: shalithasuranga

docs/api/filesystem.md

@@ -439,3 +439,50 @@ An instance of the [`Permissions`](#permissions) object.
 ```js
 const permissions = await Neutralino.filesystem.getPermissions(NL_PATH + '/my-directory-1');
 ```
+
+## filesystem.getJoinedPath(...paths)
+Returns a single joined path from multiple input path segments.
+
+### Parameters
+
+- `...paths` String: A sequence of paths.
+
+### Return String (awaited):
+Joined path.
+
+```js
+let path = await Neutralino.filesystem.getJoinedPath('./myFolder', 'audio', 'myFile.mp3');
+console.log(path);             // './myFolder/audio/myFile.mp3'
+```
+
+## filesystem.getNormalizedPAth(path)
+Constructs a Unix-like path from a Windows path for cross-platform usage by replacing `\\` with `/`. This function only works on Windows and returns the same input 
+string on non-Windows platforms.
+
+### Parameters
+
+- `path` String: Windows-specific path.
+
+### Return String (awaited):
+Unix-like path.
+
+```js
+let path = await Neutralino.filesystem.getNormalizedPath('.\\myFolder\\main.js');
+console.log(path);            //  `./myFolder/main.js`
+```
+
+## filesystem.getUnnormalizedPAth(path)
+Reverts a Unix-like path created with `filesystem.getNormalizedPath(path)` to a Windows-specific path by replacing `/` with `\\`. This function only works on Windows 
+and returns the same input string on non-Windows platforms.
+
+### Parameters
+
+- `path` String: Unix-like path.
+
+### Return String (awaited):
+Windows-specific path.
+
+```js
+let path = await Neutralino.filesystem.getUnnormalizedPath('./myFolder/main.js');
+console.log(path);            //  `.\myFolder\main.js`
+```

docs/api/window.md

@@ -184,16 +184,31 @@ Converts a given DOM element to a draggable region. The user will be able to dra
 
 ### DraggableRegionOptions
 
-- `alwaysCapture` Boolean (optional): If set to `true`, the region will always capture the pointer, ensuring that dragging is not interrupted when moving the pointer quickly. Note that it prevents child elements from receiving any pointer events. Defaults to `false`.
-- `dragMinDistance` Number (optional): The minimum distance between cursor's starting and current position after which dragging is started. This helps prevent accidental dragging while interacting with child elements. Defaults to `10` and is measured in CSS pixels.
+- `exclusions` String[] | HTMLElement[] (optional): DOM element identifiers that should be excluded from the draggable region surface, i.e., window control buttons 
+
+
+### Return Object (awaited):
+- `exclusions` DraggableRegionExclusions: Add or remove draggable region exclusions.
+
+### DraggableRegionExclusions
+
+- `add(...domIds: String | HTMLElement)`: Add new elements to exclusions. 
+- `remove(...domIds: String | HTMLElement)`: Remove elements from exclusions. 
+- `removeAll()`: Clear exclusions. 
 
 ```js
 await Neutralino.window.setDraggableRegion('myCustomTitleBar');
 
 await Neutralino.window.setDraggableRegion('myCustomTitleBar', {
-    alwaysCapture: true,
-    dragMinDistance: 15
+    exclusions: ['closeButton', 'helpButton']
+});
+
+const d = await Neutralino.window.setDraggableRegion('myCustomTitleBar', {
+    exclusions: ['windowControls', 'tags']
 });
+
+d.exclusions.add('notifications');
+d.exclusions.remove('tags');
 ```
 
 ## window.unsetDraggableRegion(domId)
@@ -375,3 +390,19 @@ await Neutralino.on('mainMenuItemClicked', (evt) => {
     console.log('Menu item:', evt.detail);
 }); 
 ```
+
+## window.print()
+Displays the native print dialog for the current page. Developers can use this function instead of the built-in web `window.print()` function as a cross-platform solution
+since macOS webview doesn't pre-implement `window.print()`.
+
+```js
+await Neutralino.window.print();
+```
+
+## window.beginDrag()
+Starts dragging the native window if the left mouse button is pressed. The draggable region API in the Neutralinojs client library uses this function internally to move
+the window with the pointer events web API. 
+
+```js
+await Neutralino.window.beginDrag();
+```

docs/cli/neu-cli.md

@@ -23,9 +23,14 @@ npx @neutralinojs/neu <command>
 
 ## Commands
 
-### `neu create <binaryName>`
+### `neu create <path>`
 
-Creates a new Neutralinojs app based on a template.
+Creates a new Neutralinojs app based on a template. Basename of `<path>` will be used as the app binary name.
+
+```bash
+neu create myapp    # Creates in ./myapp
+neu create .        # Creates in the current directory
+```
 
 #### Parameters
 

docs/configuration/neutralino.config.json.md

@@ -316,6 +316,10 @@ the client library manually via the `neutralino.js` file or from the `@neutralin
 Injects a preload JavaScript file to the webview instance from the app bundle. This script file will be executed before webapp resources and after `window.injectGlobals`
 and `window.injectClientLibrary` scripts, so you can write initialization scripts using Neutralinojs API within this source file.
 
+### `modes.window.webviewArgs: string`
+Additional browser arguments (i.e., `--user-agent=<string>`) for the WebView2 instance on Windows. See all supported arguments from the official 
+[WebView2 developer documentation](https://learn.microsoft.com/en-us/microsoft-edge/webview2/concepts/webview-features-flags?tabs=dotnetcsharp#available-webview2-browser-flags).
+
 ## Chrome mode
 The following configuration values are used when the application starts with the chrome mode.
 

docs/release-notes/cli.md

@@ -5,6 +5,8 @@ toc_max_heading_level: 2
 
 ## Unreleased
 
+## v11.5.0
+
 ### Core: Creator
 - Support using a specific directory with the `neu create` command, e.g., `neu create .`, `neu create myapps/myapp`, `neu create ../myapp`, etc. 
 

docs/release-notes/client-library.md

@@ -5,6 +5,39 @@ toc_max_heading_level: 2
 
 ## Unreleased
 
+## v6.2.0
+
+### API: draggable region API
+The new draggable region API implementation uses native, platform-specific window dragging event via the `window.beginDrag()` function, so now draggable regions behave the same as native window dragging with features such as window snapping, unlike the previous draggable region implementation.
+
+The new draggable region API lets developers exclude specific elements (i.e., window control buttons) from the registered draggable region DOM element:
+
+```js
+const d = await setDraggableRegion('title-bar', { 
+  exclude: ['close-btn'],
+})
+
+// Exclude elements using DOM references or IDs
+d.exclusions.add('help-btn') 
+d.exclusions.add(document.getElementById('info-btn')) 
+d.exclusions.add('tag1', 'tag2') 
+
+// Remove excluded elements
+d.exclusions.remove('help-btn') 
+d.exclusions.remove(document.getElementById('info-btn')) 
+d.exclusions.remove('tag1', 'tag2')
+
+// Remove all exclusions
+d.exclusions.removeAll() 
+```
+
+### API: window
+- Export the `Neutralino.window.print()` function.
+- Export the `window.beginDrag()` function.
+
+### API: filesystem
+- Export `filesystem.getJoinedPath(...paths)`, `filesystem.getNormalizedPath(path)`, and `filesystem.getUnnormalizedPath(path)` functions.
+
 ## v6.1.0
 
 ### API: window

docs/release-notes/framework.md

@@ -5,6 +5,30 @@ toc_max_heading_level: 2
 
 ## Unreleased
 
+## v6.2.0
+
+### API: window
+- Add `Neutralino.window.print()` to display the native print dialog on all platforms. This was especially added since the macOS webview doesn't implement the `window.print()` function.
+- Introduce the `window.beginDrag()` function to trigger native window dragging. The new draggable region API implementation uses this function internally. 
+
+### API: filesystem
+- Add `filesystem.getJoinedPath(...paths: string[])` to create a single path by joining multiple path strings.
+- Add `filesystem.getNormalizedPath()` and `filesystem.getUnnormalizedPath()` functions, which make Windows paths look like Unix paths by replacing `\\` with `/` and revert normalized paths into Windows-specific paths respectively on the Windows platform. On non-Windows platforms, these functions return the same input strings.
+
+### Configuration
+- Implement the `window.webviewArgs` configuration option to pass additional browser arguments to the WebView2 instance on Windows:
+```js
+"modes": {
+  "window": {
+     // ....
+     "webviewArgs": "--user-agent=\"Custom user agent\""
+  }
+}
+```
+
+### Improvements/bugfixes
+- Display GUI error messages for webview initialization failures. i.e., if the WebView2 runtime is not installed on Windows and if the WebKitGTK library is not installed on GNU/Linux platforms.
+
 ## v6.1.0
 
 ### API: Native window main menu