chore: make spec compliant

apis/locale/src/translator.js

@@ -10,7 +10,6 @@ export default function translator({ initial = 'en-US', fallback = 'en-US' } = {
 
   /**
    * @class Translator
-   * @hideconstructor
    */
   const api = /** @lends Translator# */ {
     language: (lang) => {

apis/nucleus/src/hooks/useAppSelections.js

@@ -59,7 +59,6 @@ function createAppSelections({ app, currentSelectionsLayout, navState }) {
 
   /**
    * @class
-   * @hideconstructor
    * @alias AppSelections
    */
   const appSelections = {

apis/nucleus/src/hooks/useObjectSelections.js

@@ -23,7 +23,6 @@ function createObjectSelections({ appSelections, appModal, model }) {
   /**
    * @class
    * @alias ObjectSelections
-   * @hideconstructor
    */
   const api = /** @lends ObjectSelections# */ {
     // model,

apis/nucleus/src/index.js

@@ -193,7 +193,6 @@ function nuked(configuration = {}) {
     /**
      * @class
      * @alias Embed
-     * @hideconstructor
      */
     const api = /** @lends Embed# */ {
       /**
@@ -329,7 +328,6 @@ function nuked(configuration = {}) {
 
         /**
          * @class
-         * @hideconstructor
          * @alias FieldInstance
          * @experimental
          * @since 1.1.0

apis/nucleus/src/viz.js

@@ -37,7 +37,6 @@ export default function viz({ model, halo, initialError, onDestroy = async () =>
   /**
    * @class
    * @alias Viz
-   * @hideconstructor
    * @classdesc A controller to further modify a visualization after it has been rendered.
    * @example
    * const viz = await embed(app).render({

apis/stardust/api-spec/spec.json

@@ -95,7 +95,7 @@
       ]
     },
     "useEffect": {
-      "description": "Triggers a callback function when a dependant value changes.",
+      "description": "Triggers a callback function when a dependent value changes.",
       "kind": "function",
       "params": [
         {
@@ -105,7 +105,7 @@
         },
         {
           "name": "deps",
-          "description": "The dependencies which should trigger the callback.",
+          "description": "The dependencies that should trigger the callback.",
           "optional": true,
           "kind": "array",
           "items": {
@@ -118,7 +118,7 @@
       ]
     },
     "useMemo": {
-      "description": "Creates a stateful value when a dependant changes.",
+      "description": "Creates a stateful value when a dependent changes.",
       "templates": [
         {
           "name": "T"
@@ -153,7 +153,7 @@
       ]
     },
     "usePromise": {
-      "description": "Runs a callback function when a dependant changes.",
+      "description": "Runs a callback function when a dependent changes.",
       "templates": [
         {
           "name": "P"
@@ -353,6 +353,18 @@
         "import { useTranslator } from '@nebula.js/stardust';\n// ...\nconst translator = useTranslator();\nconsole.log(translator.get('SomeString'));"
       ]
     },
+    "useDeviceType": {
+      "description": "Gets the device type. ('touch' or 'desktop')",
+      "kind": "function",
+      "params": [],
+      "returns": {
+        "description": "device type.",
+        "type": "string"
+      },
+      "examples": [
+        "import { useDeviceType } from '@nebula.js/stardust';\n// ...\nconst deviceType = useDeviceType();\nif (deviceType === 'touch') { ... };"
+      ]
+    },
     "useAction": {
       "description": "Registers a custom action.",
       "templates": [
@@ -450,15 +462,15 @@
           "optional": true,
           "kind": "object",
           "entries": {
-            "select": {
+            "active": {
               "optional": true,
               "type": "boolean"
             },
-            "active": {
+            "passive": {
               "optional": true,
               "type": "boolean"
             },
-            "passive": {
+            "select": {
               "optional": true,
               "type": "boolean"
             }
@@ -473,6 +485,11 @@
           "optional": true,
           "defaultValue": "en-US",
           "type": "string"
+        },
+        "deviceType": {
+          "optional": true,
+          "defaultValue": "auto",
+          "type": "string"
         }
       }
     },
@@ -512,13 +529,20 @@
         "flags": {
           "type": "#/definitions/Flags"
         },
+        "deviceType": {
+          "type": "string"
+        },
         "anything": {
           "type": "object"
         }
       }
     },
     "Embed": {
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {
         "render": {
           "description": "Renders a visualization into an HTMLElement.",
@@ -631,6 +655,10 @@
         "since": "1.1.0"
       },
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {},
       "staticEntries": {
         "mount": {
@@ -705,7 +733,7 @@
           "type": "string"
         },
         "load": {
-          "description": "A function that should return a Promise that resolve to a raw JSON theme",
+          "description": "A function that should return a Promise that resolves to a raw JSON theme.",
           "kind": "function",
           "params": [],
           "returns": {
@@ -722,19 +750,23 @@
     "Viz": {
       "description": "A controller to further modify a visualization after it has been rendered.",
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {
         "id": {
           "description": "The id of this visualization's generic object.",
           "type": "string"
         },
         "destroy": {
-          "description": "Destroys the visualization and removes if from the the DOM.",
+          "description": "Destroys the visualization and removes it from the the DOM.",
           "kind": "function",
           "params": [],
           "examples": ["const viz = await embed(app).render({\n  element,\n  id: 'abc'\n});\nviz.destroy();"]
         },
         "convertTo": {
-          "description": "Converts the visualization to a different registred type",
+          "description": "Converts the visualization to a different registered type",
           "stability": "experimental",
           "availability": {
             "since": "1.1.0"
@@ -743,7 +775,7 @@
           "params": [
             {
               "name": "newType",
-              "description": "Which registered type to convert to",
+              "description": "Which registered type to convert to.",
               "type": "string"
             },
             {
@@ -754,7 +786,7 @@
             }
           ],
           "returns": {
-            "description": "Promise object that resolves to the full property tree of the converted visualizatiom",
+            "description": "Promise object that resolves to the full property tree of the converted visualization.",
             "type": "Promise",
             "generics": [
               {
@@ -791,6 +823,10 @@
     },
     "AppSelections": {
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {
         "mount": {
           "description": "Mounts the app selection UI into the provided HTMLElement.",
@@ -813,6 +849,10 @@
     },
     "ObjectSelections": {
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {
         "begin": {
           "kind": "function",
@@ -1501,6 +1541,10 @@
     },
     "Translator": {
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {
         "add": {
           "description": "Registers a string in multiple locales",
@@ -1532,17 +1576,17 @@
           ]
         },
         "get": {
-          "description": "Translates a string for current locale",
+          "description": "Translates a string for current locale.",
           "kind": "function",
           "params": [
             {
               "name": "str",
-              "description": "Id of the registered string",
+              "description": "ID of the registered string.",
               "type": "string"
             },
             {
               "name": "args",
-              "description": "Values passed down for string interpolation",
+              "description": "Values passed down for string interpolation.",
               "optional": true,
               "kind": "array",
               "items": {
@@ -1551,14 +1595,18 @@
             }
           ],
           "returns": {
-            "description": "The translated string",
+            "description": "The translated string.",
             "type": "string"
           }
         }
       }
     },
     "Theme": {
       "kind": "class",
+      "constructor": {
+        "kind": "function",
+        "params": []
+      },
       "entries": {
         "getDataColorScales": {
           "kind": "function",
@@ -1639,22 +1687,22 @@
           "examples": ["theme.getContrastingColorTo('#400');"]
         },
         "getStyle": {
-          "description": "Get the value of a style attribute in the theme by searching in the theme's json structure.\nThe search starts at the specified base path and continue upwards until the value is found.\nIf possible it will get the attribute's value using the given path.",
+          "description": "Get the value of a style attribute in the theme by searching in the theme's JSON structure.\nThe search starts at the specified base path and continues upwards until the value is found.\nIf possible it will get the attribute's value using the given path.",
           "kind": "function",
           "params": [
             {
               "name": "basePath",
-              "description": "Base path in the theme's json structure to start the search in (specified as a name path separated by dots)",
+              "description": "Base path in the theme's JSON structure to start the search in (specified as a name path separated by dots).",
               "type": "string"
             },
             {
               "name": "path",
-              "description": "Expected path for the attribute (specified as a name path separated by dots)",
+              "description": "Expected path for the attribute (specified as a name path separated by dots).",
               "type": "string"
             },
             {
               "name": "attribute",
-              "description": "Name of the style attribute",
+              "description": "Name of the style attribute.",
               "type": "string"
             }
           ],
@@ -1779,7 +1827,7 @@
       }
     },
     "ExportFormat": {
-      "description": "Used for exporting and importing properties between backend models. An object that exports to\nExportFormat should put dimensions and measures inside one data group. If an object has two hypercubes\neach of the cubes should export dimensions and measures in two separate data groups.\nAn object that imports from this structure is responsible for putting the existing properties where they should be\nin the new model.",
+      "description": "Used for exporting and importing properties between backend models. An object that exports to\nExportFormat should put dimensions and measures inside one data group. If an object has two hypercubes,\neach of the cubes should export dimensions and measures in two separate data groups.\nAn object that imports from this structure is responsible for putting the existing properties where they should be\nin the new model.",
       "stability": "experimental",
       "availability": {
         "since": "1.1.0"
@@ -1859,15 +1907,15 @@
       }
     },
     "Conversion": {
-      "description": "Provides conversion functionality to extensions",
+      "description": "Provides conversion functionality to extensions.",
       "stability": "experimental",
       "availability": {
         "since": "1.1.0"
       },
       "kind": "interface",
       "entries": {
         "hypercube": {
-          "description": "Provides conversion functionality for extensions with hyperCubes",
+          "description": "Provides conversion functionality to extensions with hyperCubes.",
           "stability": "experimental",
           "availability": {
             "since": "1.1.0"

apis/theme/src/index.js

@@ -17,7 +17,6 @@ export default function theme() {
   /**
    * @class
    * @alias Theme
-   * @hideconstructor
    */
   const externalAPI = /** @lends Theme# */ {
     /**