Updated changelog.

Author: ReFreezed

CHANGELOG.txt

@@ -1,22 +1,38 @@
 Changelog
 InputField
 
+v3.3 (2022-03-15)
+- Added: Event method wheelmoved() (which can do horizontal scrolling).
+- Added: Triple-click-and-drag to select lines.
+- Added: Method setType().
+- Added: Methods getInfoAtCoords(), getInfoAtCursor(), getInfoAtCharacter().
+- Added: Methods getVisibleLine(), getVisibleLineCount().
+- Added: Methods getWheelScrollSpeed(), setWheelScrollSpeed().
+- Changed: Better/proper shortcuts in macOS.
+- Changed: The cursor's original x position is now preserved when navigating vertically multiple lines.
+- Changed: Newlines now count as word boundries.
+- Changed: Navigating up on the first line or down on the last line now does nothing in multi-line fields.
+- Changed: The second argument for setMouseScrollSpeed() is now optional.
+- Fixed "pressing Home on wrapped lines does nothing". It now navigates to before the soft line wrap.
+- Fixed "pressing Escape does not stop the dragging".
+
+
 v3.2 (2022-03-10)
-- Added text alignment (left/right/center).
-- Added methods: canScroll, canScrollHorizontally, canScrollVertically.
-- Added methods: getScrollHandles, getScrollHandleHorizontal, getScrollHandleVertical.
-- PageUp and PageDown work in multi-line fields.
-- Keyboard interactions are now disabled while dragging.
+- Added: Text alignment (left/right/center).
+- Added: PageUp and PageDown work in multi-line fields.
+- Added: Methods getScrollHandles(), getScrollHandleHorizontal(), getScrollHandleVertical().
+- Added: Methods canScroll(), canScrollHorizontally(), canScrollVertically().
+- Changed: Keyboard interactions are now disabled while dragging.
 
 v3.1 (2022-01-15)
-- Added double-click-and-drag to select words.
-- Added shortcut Shift+Delete to cut text.
-- Pressing Escape while dragging stops the dragging.
-- Fixed word navigation/selection not working.
-- Better Unicode support for word navigation/selection.
+- Added: Double-click-and-drag to select words.
+- Added: Shortcut Shift+Delete to cut text.
+- Changed: Pressing Escape while dragging stops the dragging.
+- Changed: Better Unicode support for word navigation/selection.
+- Fixed "word navigation/selection does not work".
 
 v3.0.1 (2022-01-14)
-- Fixed freezing issue when calling some methods on fields that never had any text.
+- Fixed: Freezing issue when calling some methods on fields that never had any text.
 
 v3.0 (2022-01-14)
 - First public release!

InputField.lua

@@ -1,6 +1,6 @@
 --[[============================================================
 --=
---=  InputField v3.2-dev - text input handling library for LÖVE (0.10.2+)
+--=  InputField v3.3 - text input handling library for LÖVE (0.10.2+)
 --=  - Written by Marcus 'ReFreezed' Thunström
 --=  - MIT License (See the bottom of this file)
 --=  - https://github.com/ReFreezed/InputField
@@ -52,6 +52,7 @@
 	getTextDimensions, getTextWidth, getTextHeight
 	getTextLength
 	getTextOffset
+	getVisibleLine, getVisibleLineCount
 	isBusy
 	releaseMouse
 	reset
@@ -133,7 +134,7 @@
 --============================================================]]
 
 local InputField = {
-	_VERSION = "InputField 3.2.0-dev",
+	_VERSION = "InputField 3.3.0",
 }
 
 
@@ -974,9 +975,13 @@ function InputField.getMouseScrollSpeedY(field)
 	return field.mouseScrollSpeedY
 end
 
+--
 -- field:setMouseScrollSpeed( speedX [, speedY=speedX ] )
 -- field:setMouseScrollSpeedX( speedX )
 -- field:setMouseScrollSpeedY( speedY )
+--
+-- Also see setWheelScrollSpeed().
+--
 function InputField.setMouseScrollSpeed(field, speedX, speedY)
 	speedY                  = speedY or speedX
 	field.mouseScrollSpeedX = math.max(speedX, 0)
@@ -1413,14 +1418,14 @@ function InputField.getScrollHandles(field)
 end
 
 -- offset, coverage = field:getScrollHandleHorizontal( )
--- Values are between 0 and 1.
+-- The values (and their sum) are between 0 and 1.
 function InputField.getScrollHandleHorizontal(field)
 	local hOffset, hCoverage, vOffset, vCoverage = field:getScrollHandles()
 	return hOffset, hCoverage
 end
 
 -- offset, coverage = field:getScrollHandleVertical( )
--- Values are between 0 and 1.
+-- The values (and their sum) are between 0 and 1.
 function InputField.getScrollHandleVertical(field)
 	local hOffset, hCoverage, vOffset, vCoverage = field:getScrollHandles()
 	return vOffset, vCoverage
@@ -1520,6 +1525,8 @@ end
 --   lineIndex    -- integer  Visible line index.
 --   linePosition -- integer  Visible line start position.
 --
+-- Note: The coordinates are relative to the field's position.
+--
 function InputField.getInfoAtCursor(field, pos, info)
 	updateWrap(field)
 
@@ -1565,6 +1572,7 @@ end
 --   linePosition -- integer  Visible line start position.
 --
 -- Returns nil if characterPosition is invalid or points at a newline.
+-- Note: The coordinates are relative to the field's position.
 --
 function InputField.getInfoAtCharacter(field, pos, info)
 	updateWrap(field)

tests/main.lua

@@ -186,18 +186,6 @@ do
 	field:update(0)
 end
 
-do
-	local field = InputField("fo\no", "password")
-
-	assertValue(field:getType(),     "password")
-	assertValue(field:isPassword(),  true)
-	assertValue(field:isMultiline(), false)
-
-	-- Text.
-	assertValue(field:getText(),        "foo")
-	assertValue(field:getVisibleText(), "***")
-end
-
 do
 	local field = InputField("fo\no", "multiwrap")
 
@@ -208,6 +196,17 @@ do
 	-- Text.
 	assertValue(field:getText(),        "fo\no")
 	assertValue(field:getVisibleText(), "fo\no")
+
+	-- Type change.
+	field:setType("password")
+
+	assertValue(field:getType(),     "password")
+	assertValue(field:isPassword(),  true)
+	assertValue(field:isMultiline(), false)
+
+	-- Text.
+	assertValue(field:getText(),        "foo")
+	assertValue(field:getVisibleText(), "***")
 end
 
 do
@@ -221,12 +220,16 @@ end
 -- eachVisibleLine, eachSelection
 -- getAlignment, setAlignment
 -- getCursorLayout
+-- getInfoAtCoords, getInfoAtCursor, getInfoAtCharacter.
 -- getScroll, getScrollX, getScrollY, setScroll, setScrollX, setScrollY, scroll, scrollToCursor
 -- getScrollHandles, getScrollHandleHorizontal, getScrollHandleVertical
 -- getScrollLimits
 -- getTextDimensions, getTextWidth, getTextHeight
 -- getTextOffset
+-- getVisibleLine, getVisibleLineCount.
+-- getWheelScrollSpeed, setWheelScrollSpeed.
 -- keypressed
+-- wheelmoved
 
 print("Tests completed successfully!")
 love.event.quit()