Merge lp:~ubuntu-sdk-team/ubuntu-ui-toolkit/jsDocs into lp:ubuntu-ui-toolkit/staging

[Christian Dywan]

Include Javascript libraries in QML documentation

Note: I duplicated all Javascript files because docs don't include older API folders.

[PS Jenkins bot (ps-jenkins)]

FAILED: Continuous integration, rev:1548
http://jenkins.qa.ubuntu.com/job/ubuntu-sdk-team-ubuntu-ui-toolkit-staging-ci/1965/
Executed test runs:
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-sdk-team-ubuntu-ui-toolkit-staging-vivid-amd64-ci/693/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-sdk-team-ubuntu-ui-toolkit-staging-vivid-armhf-ci/695/console
    FAILURE: http://jenkins.qa.ubuntu.com/job/ubuntu-sdk-team-ubuntu-ui-toolkit-staging-vivid-i386-ci/692/console

Click here to trigger a rebuild:
http://s-jenkins.ubuntu-ci:8080/job/ubuntu-sdk-team-ubuntu-ui-toolkit-staging-ci/1965/rebuild

review: Needs Fixing (continuous-integration)

[lp:~ubuntu-sdk-team/ubuntu-ui-toolkit/jsDocs]

1548. By Zoltan Balogh on 2015-07-06

In the initctl test fixture, add the option to unset an environment variable. lp:~canonical-platform-qa/ubuntu-ui-toolkit/fixture_unset_env

1549. By Zoltan Balogh on 2015-07-06

Fix AlamrModel segfault when updating elements. lp:~zsombi/ubuntu-ui-toolkit/alarmmodel-segfault

1550. By Christian Dywan on 2015-07-07

Add a deprecated note to ListItems.ThinDivider. Fixes: https://bugs.launchpad.net/bugs/1470951.

Approved by PS Jenkins bot.

1551. By Christian Dywan on 2015-07-17

Fix annotations and include popupUtils

1552. By Christian Dywan on 2015-07-17

Tweak the wording of popupUtils::open

1553. By Christian Dywan on 2015-07-23

Move Slider-/ Scrollbar-/ ColorUtils into Ambiance for 1.3

These are all internal components.

1554. By Christian Dywan on 2015-07-23

Fix types in qmldir of Ambiance theme

1555. By Christian Dywan on 2015-07-24

Merge lp:~ubuntu-sdk-team/ubuntu-ui-toolkit/staging

1556. By Christian Dywan on 2015-07-24

Add js files to .pro files

1557. By Christian Dywan on 2015-07-24

Merge lp:~ubuntu-sdk-team/ubuntu-ui-toolkit/staging

1558. By Christian Dywan on 2015-07-24

Change excluse dir in ubuntu-ui-toolkit-common.qdocconf

1559. By Christian Dywan on 2015-07-24

qdoc tweaks

Unmerged revisions

=== modified file 'components.api'
--- components.api	2015-06-22 23:24:26 +0000
+++ components.api	2015-07-06 12:20:28 +0000
@@ -203,7 +203,7 @@
     function push(var data)
     function clear()
     function QQuickMimeData* newData()
-Ubuntu.Components.ColorUtils 0.1 1.0
+Ubuntu.Components.ColorUtils 0.1 1.0 1.3
 Ubuntu.Components.ComboButton 1.1: Button
     property double collapsedHeight
     default readonly property QtObject comboList
@@ -265,7 +265,7 @@
     property url source
     property QSizeF sourceSize
     readonly property int status
-Ubuntu.Components.DateUtils 0.1 1.0
+Ubuntu.Components.DateUtils 0.1 1.0 1.3
 Ubuntu.Components.Popups.DefaultSheet 1.0 0.1: SheetBase
     property bool doneButton
     signal closeClicked()
@@ -496,7 +496,7 @@
 Ubuntu.Components.MainView 1.3: MainViewBase
     property bool automaticOrientation
     default readonly property QtObject contentsItem
-Ubuntu.Components.MathUtils 0.1 1.0
+Ubuntu.Components.MathUtils 0.1 1.0 1.3
 Ubuntu.Components.MimeData 1.0 0.1: QtObject
     property color color
     property var data
@@ -793,7 +793,7 @@
 Ubuntu.Components.Scrollbar 1.3: StyledItem
     property int align
     property Flickable flickableItem
-Ubuntu.Components.ScrollbarUtils 0.1 1.0
+Ubuntu.Components.ScrollbarUtils 0.1 1.0 1.3
 Ubuntu.Components.Sections 1.3: StyledItem
     readonly property Action actions
     property var model
@@ -850,7 +850,7 @@
     property double minimumValue
     readonly property bool pressed
     property double value
-Ubuntu.Components.SliderUtils 0.1 1.0
+Ubuntu.Components.SliderUtils 0.1 1.0 1.3
 Ubuntu.Components.SortBehavior 1.1: QtObject
     property Qt.SortOrder order
     property string property

=== modified file 'documentation/ubuntu-ui-toolkit-common.qdocconf'
--- documentation/ubuntu-ui-toolkit-common.qdocconf	2015-05-05 16:23:29 +0000
+++ documentation/ubuntu-ui-toolkit-common.qdocconf	2015-07-06 12:20:28 +0000
@@ -21,8 +21,9 @@
 excludedirs += ../modules/Ubuntu/Components/Popups/1.2
 excludedirs += ../modules/Ubuntu/Components/Themes/Ambiance
 excludedirs += ../modules/Ubuntu/Components/Themes/SuruDark
+excludedirs += ../documentation/autopilot-helpers/_build/html/_static
 imagedirs = images
-sources.fileextensions = "*.qml *.qdoc *.cpp"
+sources.fileextensions = "*.qml *.qdoc *.cpp *.js"
 headers.fileextensions = "*.h"
 # exclude qml files that have the component documented in a separate qdoc file
 excludefiles = $BLD/../modules/Ubuntu/Components/MainView.qml

=== modified file 'modules/Ubuntu/Components/1.2/mathUtils.js'
--- modules/Ubuntu/Components/1.2/mathUtils.js	2015-04-30 08:32:44 +0000
+++ modules/Ubuntu/Components/1.2/mathUtils.js	2015-07-06 12:20:28 +0000
@@ -14,9 +14,19 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
+/*!
+  \qmltype mathUtils
+  \inqmlmodule Ubuntu.Components 1.2
+  \ingroup ubuntu
+  \brief Various mathematical utility functions.
+ */
+
 .pragma library
 
-// Ensure the value x is between min and max
+/*!
+  \qmlmethod clamp(x, min, max)
+  Ensure the value x is between min and max
+ */
 function clamp(x, min, max) {
     if (min <= max) {
         return Math.max(min, Math.min(x, max));
@@ -26,17 +36,26 @@
     }
 }
 
-// Get the linear interpolation
+/*!
+  \qmlmethod lerp(delta, from, to)
+  Get the linear interpolation
+ */
 function lerp(delta, from, to) {
     return ((1.0 - delta) * from) + (delta * to);
 }
 
-// Linearly project a value x from [xmin, xmax] into [ymin, ymax]
+/*!
+  \qmlmethod getFlickableChild(item)
+  Linearly project a value x from [xmin, xmax] into [ymin, ymax]
+ */
 function projectValue(x, xmin, xmax, ymin, ymax) {
     return ((x - xmin) * ymax - (x - xmax) * ymin) / (xmax - xmin)
 }
 
-// Linearly project a value x, but in addition to projectValue it's clamped to xmin/xmax first
+/*!
+  \qmlmethod clampAndProject(x, xmin, xmax, ymin, ymax)
+  Linearly project a value x, but in addition to projectValue it's clamped to xmin/xmax first
+ */
 function clampAndProject(x, xmin, xmax, ymin, ymax) {
     return projectValue(clamp(x, xmin, xmax), xmin, xmax, ymin, ymax)
 }

=== added file 'modules/Ubuntu/Components/1.3/colorUtils.js'
--- modules/Ubuntu/Components/1.3/colorUtils.js	1970-01-01 00:00:00 +0000
+++ modules/Ubuntu/Components/1.3/colorUtils.js	2015-07-06 12:20:28 +0000
@@ -0,0 +1,36 @@
+/*
+ * Copyright (C) 2013-2015 Canonical, Ltd.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; version 3.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/*!
+  \qmltype colorUtils
+  \inqmlmodule Ubuntu.Components 1.3
+  \ingroup ubuntu
+  \brief Various chromatic utility functions.
+ */
+
+.pragma library
+
+/*!
+  \qmlmethod luminance(hexcolor)
+  Get the luminance for a color.
+ */
+function luminance(hexcolor){
+    hexcolor = String(hexcolor)
+    var r = parseInt(hexcolor.substr(1,2),16);
+    var g = parseInt(hexcolor.substr(3,2),16);
+    var b = parseInt(hexcolor.substr(5,2),16);
+    return ((r*212)+(g*715)+(b*73))/1000/255;
+}

=== added file 'modules/Ubuntu/Components/1.3/dateUtils.js'
--- modules/Ubuntu/Components/1.3/dateUtils.js	1970-01-01 00:00:00 +0000
+++ modules/Ubuntu/Components/1.3/dateUtils.js	2015-07-06 12:20:28 +0000
@@ -0,0 +1,145 @@
+/*
+ * Copyright 2013-2015 Canonical Ltd.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; version 3.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/*!
+  \qmltype dateUtils
+  \inqmlmodule Ubuntu.Components 1.3
+  \ingroup ubuntu
+  \brief Various date utility functions.
+ */
+
+.pragma library
+
+/*
+  Extending Date with few prototypes
+  */
+Date.msPerDay = 86400e3
+Date.msPerWeek = Date.msPerDay * 7
+
+/*!
+  \qmlmethod Date::midnight()
+  The function returns a Date object with the current date and hour set to
+  midnight.
+  */
+Date.prototype.midnight = function() {
+    this.setHours(0, 0, 0, 0);
+    return this;
+}
+
+/*!
+  \qmlmethod Date::getInvalidDate()
+  The function returns an invalid date object.
+  Example of use:
+  \code
+  var invalidDate = Date.prototype.getInvalidDate.call();
+  var otherInvalidDate = (new Date()).getInvalidDate();
+  \endcode
+  */
+Date.prototype.getInvalidDate = function() {
+    return new Date(-1, -1);
+}
+
+/*!
+  \qmlmethod Date::isValid()
+  The function checks whether the date object is a valid one, meaning the year,
+  month and date fields are positive numbers
+  */
+Date.prototype.isValid = function() {
+    if (Object.prototype.toString.call(this) !== "[object Date]") {
+        return false;
+    }
+    return (this.getFullYear() > 0) && (this.getMonth() >= 0) && (this.getDate() > 0);
+}
+
+/*!
+  \qmlmethod Date::daysInMonth()
+  The function returns the number of days in the month set in the Date object.
+  */
+Date.prototype.daysInMonth = function() {
+    return [
+        31/*an*/, 28/*Feb*/, 31/*Mar*/, 30/*Apr*/, 31/*May*/, 30/*Jun*/,
+        31/*Jul*/, 31/*Aug*/, 30/*Sep*/, 31/*Oct*/, 30/*Nov*/, 31/*Dec*/
+    ][this.getMonth()] + (this.getMonth() === 1) * this.leapYear();
+}
+
+/*!
+  \qmlmethod Date::leapYear()
+  The function checks whether the year in the Date object is a leap year or not.
+  */
+Date.prototype.leapYear = function() {
+    var year = this.getFullYear();
+    return year % 400 == 0 || (year % 100 !== 0 && year % 4 == 0);
+}
+
+/*!
+  \qmlmethod Date::monthsTo(date)
+  The function returns the distance in months (not calendaristic months) between
+  the Date object and the given one as parameter.
+  */
+Date.prototype.monthsTo = function(target) {
+    return target.getMonth() - this.getMonth() + (12 * (target.getFullYear() - this.getFullYear()));
+}
+
+/*!
+  \qmlmethod Date::daysTo(date)
+  Same as monthsTo, but returns the distance in days.
+  */
+Date.prototype.daysTo = function(target) {
+    return !target.isValid() ? 0 : Math.ceil((target - this) / Date.msPerDay);
+}
+
+/*!
+  \qmlmethod Date::hoursTo(date)
+  Same as monthsTo, but returns the distance in hours.
+  */
+Date.prototype.hoursTo = function(target) {
+    return !target.isValid() ? 0 : Math.ceil((target.getTime() - this.getTime()) / (1000 * 60 * 60));
+}
+
+/*!
+  \qmlmethod Date::minutesTo(date)
+  Same as monthsTo, but returns the distance in minutes.
+  */
+Date.prototype.minutesTo = function(target) {
+    return !target.isValid() ? 0 : Math.ceil((target.getTime() - this.getTime()) / (1000 * 60));
+}
+
+/*!
+  \qmlmethod Date::secondsTo(date)
+  Same as monthsTo, but returns the distance in seconds.
+  */
+Date.prototype.secondsTo = function(target) {
+    return !target.isValid() ? 0 : Math.ceil((target.getTime() - this.getTime()) / 1000);
+}
+
+/*!
+  \qmlmethod Date::getWeek()
+  The function returns the week number of the date stored in the object.
+  */
+Date.prototype.getWeek = function() {
+    // Copy date so don't modify original
+    var date = new Date(this);
+    date.setHours(0, 0, 0, 0);
+    // Set to nearest Thursday: current date + 4 - current day number
+    // Make Sunday's day number 7
+    date.setDate(date.getDate() + 4 - (date.getDay() || 7));
+    // Get first day of year
+    var yearStart = new Date(date.getFullYear(), 0, 1);
+    // Calculate full weeks to nearest Thursday
+    var weekNo = Math.ceil((((date - yearStart) / 86400000) + 1) / 7);
+    // Return array of year and week number
+    return weekNo;
+}

=== added file 'modules/Ubuntu/Components/1.3/mathUtils.js'
--- modules/Ubuntu/Components/1.3/mathUtils.js	1970-01-01 00:00:00 +0000
+++ modules/Ubuntu/Components/1.3/mathUtils.js	2015-07-06 12:20:28 +0000
@@ -0,0 +1,61 @@
+/*
+ * Copyright 2012-2015 Canonical Ltd.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; version 3.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/*!
+  \qmltype mathUtils
+  \inqmlmodule Ubuntu.Components 1.3
+  \ingroup ubuntu
+  \brief Various mathematical utility functions.
+ */
+
+.pragma library
+
+/*!
+  \qmlmethod clamp(x, min, max)
+  Ensure the value x is between min and max
+ */
+function clamp(x, min, max) {
+    if (min <= max) {
+        return Math.max(min, Math.min(x, max));
+    } else {
+        // swap min/max if min > max
+        return clamp(x, max, min);
+    }
+}
+
+/*!
+  \qmlmethod lerp(delta, from, to)
+  Get the linear interpolation
+ */
+function lerp(delta, from, to) {
+    return ((1.0 - delta) * from) + (delta * to);
+}
+
+/*!
+  \qmlmethod getFlickableChild(item)
+  Linearly project a value x from [xmin, xmax] into [ymin, ymax]
+ */
+function projectValue(x, xmin, xmax, ymin, ymax) {
+    return ((x - xmin) * ymax - (x - xmax) * ymin) / (xmax - xmin)
+}
+
+/*!
+  \qmlmethod clampAndProject(x, xmin, xmax, ymin, ymax)
+  Linearly project a value x, but in addition to projectValue it's clamped to xmin/xmax first
+ */
+function clampAndProject(x, xmin, xmax, ymin, ymax) {
+    return projectValue(clamp(x, xmin, xmax), xmin, xmax, ymin, ymax)
+}

=== modified file 'modules/Ubuntu/Components/1.3/pageUtils.js'
--- modules/Ubuntu/Components/1.3/pageUtils.js	2015-04-25 08:54:58 +0000
+++ modules/Ubuntu/Components/1.3/pageUtils.js	2015-07-06 12:20:28 +0000
@@ -15,6 +15,15 @@
  */
 
 /*!
+  \qmltype pageUtils
+  \inqmlmodule Ubuntu.Components 1.3
+  \ingroup ubuntu
+  \internal
+  \brief Page-related utility functions.
+ */
+
+/*!
+  \qmlmethod isVerticalFlickable(object)
   Return true if the object is a Flickable that can be flicked in vertical direction.
  */
 function isVerticalFlickable(object) {
@@ -30,6 +39,7 @@
 }
 
 /*!
+  \qmlmethod getFlickableChild(item)
   Return the first child of the item that is flickable in the vertical direction.
  */
 function getFlickableChild(item) {

=== added file 'modules/Ubuntu/Components/1.3/scrollbarUtils.js'
--- modules/Ubuntu/Components/1.3/scrollbarUtils.js	1970-01-01 00:00:00 +0000
+++ modules/Ubuntu/Components/1.3/scrollbarUtils.js	2015-07-06 12:20:28 +0000
@@ -0,0 +1,141 @@
+/*
+ * Copyright 2012-2015 Canonical Ltd.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; version 3.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/*!
+  \qmltype scrollbarUtils
+  \inqmlmodule Ubuntu.Components 1.3
+  \ingroup ubuntu
+  \brief Various scrolling utility functions.
+ */
+
+.pragma library
+
+Qt.include("mathUtils.js")
+
+/*!
+  \internal
+  Object storing property names used in calculations.
+  */
+var _obj = {
+    scrollbar: null,
+    vertical: false,
+    propOrigin: "",
+    propContent: "",
+    propPosRatio: "",
+    propSizeRatio: "",
+    propCoordinate: "",
+    propSize: "",
+    refresh: function () {
+        _obj.vertical = (_obj.scrollbar.align === Qt.AlignLeading) || (_obj.scrollbar.align === Qt.AlignTrailing)
+        _obj.propOrigin = (_obj.vertical) ? "originY" : "originX";
+        _obj.propContent = (_obj.vertical) ? "contentY" : "contentX";
+        _obj.propPosRatio = (_obj.vertical) ? "yPosition" : "xPosition";
+        _obj.propSizeRatio = (_obj.vertical) ? "heightRatio" : "widthRatio";
+        _obj.propCoordinate = (_obj.vertical) ? "y" : "x";
+        _obj.propSize = (_obj.vertical) ? "height" : "width";
+    }
+}
+
+/*!
+  \internal
+  Checks whether the _obj is valid or not. Must be called in every function
+  as those can be invoked prior to the host (style) component completion.
+  */
+function __check(sb) {
+    if (sb !== null && (_obj.scrollbar !== sb)) {
+        _obj.scrollbar = sb;
+        sb.flickableItemChanged.connect(_obj.refresh);
+        sb.alignChanged.connect(_obj.refresh);
+        _obj.refresh();
+    }
+
+    return _obj.scrollbar;
+}
+
+/*!
+  \qmlmethod isVertical(scrollbar)
+  Returns whether the scrollbar is vertical or horizontal.
+  */
+function isVertical(scrollbar) {
+    if (!__check(scrollbar)) return 0;
+    return _obj.vertical;
+}
+
+/*!
+  \qmlmethod sliderPos(scrollbar, min, max)
+  Calculates the slider position based on the visible area's ratios.
+  */
+function sliderPos(scrollbar, min, max) {
+    if (!__check(scrollbar)) return 0;
+    return clamp(scrollbar.flickableItem.visibleArea[_obj.propPosRatio] * scrollbar.flickableItem[_obj.propSize], min, max);
+}
+
+/*!
+  \qmlmethod sliderSize(scrollbar, min, max)
+  Calculates the slider size for ListViews based on the visible area's position
+  and size ratios, clamping it between min and max.
+
+  The function can be used in Scrollbar styles to calculate the size of the slider.
+  */
+function sliderSize(scrollbar, min, max) {
+    if (!__check(scrollbar)) return 0;
+    var sizeRatio = scrollbar.flickableItem.visibleArea[_obj.propSizeRatio];
+    var posRatio = scrollbar.flickableItem.visibleArea[_obj.propPosRatio];
+    var sizeUnderflow = (sizeRatio * max) < min ? min - (sizeRatio * max) : 0
+    var startPos = posRatio * (max - sizeUnderflow)
+    var endPos = (posRatio + sizeRatio) * (max - sizeUnderflow) + sizeUnderflow
+    var overshootStart = startPos < 0 ? -startPos : 0
+    var overshootEnd = endPos > max ? endPos - max : 0
+
+    // overshoot adjusted start and end
+    var adjustedStartPos = startPos + overshootStart
+    var adjustedEndPos = endPos - overshootStart - overshootEnd
+
+    // final position and size of thumb
+    var position = adjustedStartPos + min > max ? max - min : adjustedStartPos
+    var result = (adjustedEndPos - position) < min ? min : (adjustedEndPos - position)
+
+    return result;
+}
+
+/*!
+  \qmlmethod scrollAndClamp(scrollbar, amount, min, max)
+  The function calculates and clamps the position to be scrolled to the minimum
+  and maximum values.
+
+  The scroll and drag functions require a slider that does not have any minimum
+  size set (meaning the minimum is set to 0.0). Implementations should consider
+  using an invisible cursor to drag the slider and the ListView position.
+  */
+function scrollAndClamp(scrollbar, amount, min, max) {
+    if (!__check(scrollbar)) return 0;
+    return scrollbar.flickableItem[_obj.propOrigin] +
+            clamp(scrollbar.flickableItem[_obj.propContent] - scrollbar.flickableItem[_obj.propOrigin] + amount,
+                  min, max);
+}
+
+/*!
+  \qmlmethod dragAndClamp(scrollbar, cursor, contentSize, pageSize)
+  The function calculates the new position of the dragged slider. The amount is
+  relative to the contentSize, which is either the flickable's contentHeight or
+  contentWidth or other calculated value, depending on its orientation. The pageSize
+  specifies the visibleArea, and it is usually the heigtht/width of the scrolling area.
+  */
+function dragAndClamp(scrollbar, cursor, contentSize, pageSize) {
+    if (!__check(scrollbar)) return 0;
+    scrollbar.flickableItem[_obj.propContent] =
+            scrollbar.flickableItem[_obj.propOrigin] + cursor[_obj.propCoordinate] * contentSize / pageSize;
+}

=== added file 'modules/Ubuntu/Components/1.3/sliderUtils.js'
--- modules/Ubuntu/Components/1.3/sliderUtils.js	1970-01-01 00:00:00 +0000
+++ modules/Ubuntu/Components/1.3/sliderUtils.js	2015-07-06 12:20:28 +0000
@@ -0,0 +1,48 @@
+/*
+ * Copyright 2013-2015 Canonical Ltd.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation; version 3.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+/*!
+  \qmltype sliderUtils
+  \inqmlmodule Ubuntu.Components 1.3
+  \ingroup ubuntu
+  \brief Various sliding utility functions.
+ */
+
+.pragma library
+
+/*!
+  \qmlmethod liveValue(item)
+  The function returns the live value of the slider.
+  */
+function liveValue(item) {
+    return item.__internals.liveValue;
+}
+
+/*!
+  \qmlmethod normalizedValue(item)
+  The function returns the normalized live value of the slider.
+  */
+function normalizedValue(item) {
+    return item.__internals.normalizedValue;
+}
+
+/*!
+  \qmlmethod isPressed(item)
+  The function returns whether the slider is being pressed or not.
+  */
+function isPressed(item) {
+    return item.__internals.isPressed;
+}

=== modified file 'modules/Ubuntu/Components/qmldir'
--- modules/Ubuntu/Components/qmldir	2015-05-24 14:14:36 +0000
+++ modules/Ubuntu/Components/qmldir	2015-07-06 12:20:28 +0000
@@ -141,3 +141,8 @@
 PullToRefresh 1.3 1.3/PullToRefresh.qml
 UbuntuListView 1.3 1.3/UbuntuListView11.qml
 Captions 1.3 1.3/Captions.qml
+MathUtils 1.3 1.3/mathUtils.js
+SliderUtils 1.3 1.3/sliderUtils.js
+ScrollbarUtils 1.3 1.3/scrollbarUtils.js
+ColorUtils 1.3 1.3/colorUtils.js
+DateUtils 1.3 1.3/dateUtils.js