Various additions/fixes

Changes.md

@@ -23,6 +23,44 @@ else
   -- Future versions will be 2, 3, etc.
 end
 ```
+
+## v1.3.17
+
+* [`app.apiVersion`](api/app.md#appapiversion) is `39`
+* Fixed security issue where a script could gain already given access from other script
+
+## v1.3.17-beta1
+
+* [`app.apiVersion`](api/app.md#appapiversion) is `38`
+* Added Dialog `onresize` event [#4736](https://github.com/aseprite/aseprite/issues/4736) [#5354](https://github.com/aseprite/aseprite/issues/5354)
+* Fixed `Image:drawSprite()` call when the user is drawing [#3916](https://github.com/aseprite/aseprite/issues/3916)
+
+## v1.3.16
+
+* [`app.apiVersion`](api/app.md#appapiversion) is `38`
+* **New Behavior**: Property changes outside a transaction don't generate undo steps [#4568](https://github.com/aseprite/aseprite/issues/4568)
+* **New Behavior**: Layer flag changes inside a transaction generate undo steps [#2991](https://github.com/aseprite/aseprite/issues/2991)
+* Avoid clicking an invalid button after a new window is displayed [#4757](https://github.com/aseprite/aseprite/issues/4757)
+* Don't reset dialog bounds after `Dialog:show{autoscrollbars}` when `dialog.bounds` were set before [#4758](https://github.com/aseprite/aseprite/issues/4758)
+* Allow mouse wheel scrolling in dialogs with `autoscrollbars` option [#5116](https://github.com/aseprite/aseprite/issues/5116)
+* Fixed widgets interactivity using bounds and `autoscrollbars` in `Dialog:show{}` [#5516](https://github.com/aseprite/aseprite/issues/5516)
+* Fixed dialog with scrollbar wrong size in a particular case [#5396](https://github.com/aseprite/aseprite/issues/5396) [#5481](https://github.com/aseprite/aseprite/issues/5481)
+* Fixed crash using a `label` field in `Dialog:endtags{}` [#5114](https://github.com/aseprite/aseprite/issues/5114)
+* Fixed disabled checkbox style change after `Dialog:combobox()` change [#4988](https://github.com/aseprite/aseprite/issues/4988)
+* Fixed crash setting properties with its same value [#5519](https://github.com/aseprite/aseprite/issues/5519)
+* Added `Sprite.isValid` [#5017](https://github.com/aseprite/aseprite/issues/5017)
+* Fixed console re-centering [#5349](https://github.com/aseprite/aseprite/issues/5349) [#5562](https://github.com/aseprite/aseprite/issues/5562)
+* Fixed calling filters inside the same `app.transaction()` with `ui=true` [#5572](https://github.com/aseprite/aseprite/issues/5572)
+* Don't show progress bar for filters when running with `ui=false` [#5537](https://github.com/aseprite/aseprite/issues/5537)
+
+## v1.3.15.5
+
+* [`app.apiVersion`](api/app.md#appapiversion) is `37`
+* Avoid setting window bounds when the app is closing [#5384](https://github.com/aseprite/aseprite/issues/5384)
+* Fixed centering a dialog with `autoscrollbars` behavior [#5485](https://github.com/aseprite/aseprite/issues/5485)
+* `WebSocket`: Added `error` param to `onreceive` handler
+* Fixed `app.clipboard.content.selection` property
+
 ## v1.3.16-beta1
 
 * [`app.apiVersion`](api/app.md#appapiversion) is `36`

api/app_clipboard.md

@@ -1,4 +1,4 @@
-## app.clipboard
+# app.clipboard
 
 A set of functions to handle the clipboard. 
 

api/color.md

@@ -18,10 +18,13 @@ c = Color{ hue=360.0, saturation=1.0, value=1.0, alpha=255 }
 c = Color{ hue=360.0, saturation=1.0, lightness=1.0, alpha=255 }
 c = Color{ gray=255, alpha=255 }
 c = Color{ index=integer }
+c = Color{ tile=integer }
 c = Color(integer)
 ```
 
 * If `alpha` argument is not specified, it's 255 by default (opacity = 100%).
+* The `Color{ index=integer }` returns the color at the specified index from the palette.
+* The `Color{ tile=integer }` returns a special "tile color" at the specified index from the current tileset. This "tile color" can be used to pass tiles into parameters that require the color object (e.g: `app.useTool{color=Color{tile=integer}}`).
 * The `Color(integer)` constructor receives a [pixel color](pixelcolor.md#apppixelcolor)
   and the integer is interpreted depending on the [active sprite](app.md#appsprite).
 

api/command/SaveFile.md

@@ -32,15 +32,12 @@ little differences by default:
 
 Parameters:
 
-* `ui`: Shows the dialog to select the filename. `SaveFile` doesn't
-  show the UI (`false` by default) if the sprite has an associated
-  file.  `SaveFileAs` and `SaveFileCopyAs` will show the UI by
-  default.
+* `ui`: Shows the dialog to select the filename. Defaults to `true`. When using `SaveFile`, if the sprite already has an associated file, the ui will not show. 
 * `recent`: Only available since v1.3.7, it adds the file to the list
   of recent files. By default it depends if the dialog to select the
   filename is displayed (depends on the value of the `ui` parameter).
 * `filename`: The filename where to save the sprite. The default
-  values is the
+  values is the sprite name (e.g "Sprite-0001"). When using `SaveFile`, this parameter should not be set (as Aseprite will throw an error).
 * `filenameFormat`: Special value similar to [--filename-format](https://www.aseprite.org/docs/cli/#filename-format)
   when we use [--save-as](https://www.aseprite.org/docs/cli/#save-as) from the [CLI](https://www.aseprite.org/docs/cli/)
 * `tag`: A tag name. You can save only the range of frames specified by this tag.

api/sprite.md

@@ -119,9 +119,17 @@ Returns the id of this sprite, as an integer.
 local modified = sprite.isModified
 ```
 
-Returns true if the sprite is modified compared to the latest saved
+Returns `true` if the sprite is modified compared to the latest saved
 state on disk.
 
+## Sprite.isValid
+
+```lua
+local valid = sprite.isValid
+```
+
+Returns `true` if the sprite object is a valid object (the sprite is open).
+
 ## Sprite.colorSpace
 
 ```lua
@@ -147,6 +155,15 @@ local spec = sprite.spec
 
 Returns the [specification](imagespec.md#imagespec) for image in this sprite.
 
+## Sprite.useLayerUuids
+
+```lua
+local layeruuids = sprite.useLayerUuids
+sprite.useLayerUuids = layeruuids
+```
+
+Gets or sets if the sprite should use [layer](layer.md#layer) UUIDs.
+
 ## Sprite.undoHistory.undoSteps
 
 ```lua