@kws3/ui 2.1.4 → 2.2.1

package/CHANGELOG.mdx

@@ -1,5 +1,18 @@
+# 2.2.1
+  - `Icon` fix icon sizes when line-awesome icons are loaded
+  - `Icon` fix material icons when icon family is set globally
+  - `Icon` add support for adding custom icon families
+  - `Chart` fix, ensure ApexCharts is loaded before trying to initialise it
+
+# 2.2.0
+  - Fix bug where `ScrollableList` component puts extra padding on top of list when fast scroll to top
+  - `ScrollableList` - Fix bug to reset internal positioning props when data changes
+  - fix Popperjs position strategy to work better on mobile by default, affects `SearchableSelect`, `MultiSelect` and `AutoComplete` components
+  - `ActionSheet` - Update styling to make it wokr better visually on desktop
+
 # 2.1.4
-  - Fix bug where disabled Checkbox components wrongly appeared as if they were checked
+  - Fix bug where disabled `Checkbox` components wrongly appeared as if they were checked
+  - Allow adding CSS classes to the input field in `NumberInput` component
 
 # 2.1.3
  - `PasswordInput` - add support for field `autocomplete` and `required`

package/canvas/ESignature.svelte

@@ -9,11 +9,14 @@
   @param {string} [background_image=""] - Background image for the canvas, Default: `""`
   @param {boolean} [readonly=false] - Determines whether canvas is readonly or not, Default: `false`
   @param {boolean} [disabled=false] - Determines whether canvas is disabled or not, Default: `false`
-  @param {string} [expand_from="center"] - The direction to which the canvas should expand, Default: `"center"`
-  @param {string} [expand_to="center"] - The direction to which the canvas should expand, Default: `"center"`
-  @param {number} [expand_scale=50] - Transform scale of the canvas on expansion, Default: `50`
-  @param {array} [actions=[]] - `CONST` List of actions toolbar, Default: `[]`
+  @param {string} [expand_from="center"] - The direction from which the canvas should expand.
+'top', 'bottom', 'left', 'right', 'center' and also 'n%', Default: `"center"`
+  @param {string} [expand_to="center"] - The direction to which the canvas should expand.
+'top', 'bottom', 'left', 'right', 'center' and also 'n%', Default: `"center"`
+  @param {number} [expand_scale=50] - Transform scale of the canvas on expansion
+value in percentage %, Default: `50`
   @param {Extract<Positions, 'start'|'center'|'end'>} [control_position=center] - Default position of controls, Default: `center`
+  @param {array} [actions=[]] - List of actions toolbar, Default: `[]`
 
 -->
 <Canvas
@@ -91,11 +94,7 @@
     /**
      * List of actions toolbar
      */
-    actions = [
-    "undo",
-    "redo",
-    "reset",
-    ];
+    actions = ["undo", "redo", "reset"];
 
-    let tools = { Pen };
+  let tools = { Pen };
 </script>

package/charts/Chart.svelte

@@ -116,6 +116,13 @@ This is to prevent unnecessary event subscriptions., Default: `[]`
   };
 
   const init = () => {
+    if (!ApexCharts) {
+      // `init()` was probably called from reactive functions instead of `onMount`.
+      // All those calls can be ignored, because when `onMount` calls it,
+      // it will have the latest data and config
+      return;
+    }
+
     chart && chart.destroy();
 
     if (typeof window !== "undefined") {

package/forms/AutoComplete.svelte

@@ -22,6 +22,7 @@ Fuzzy match will not work if `search` function is set, as the backend service is
   @param {string} [style=""] - Inline CSS for input container, Default: `""`
   @param {boolean} [readonly=false] - Marks component as read-only, Default: `false`
   @param {boolean} [disabled=false] - Disables the component, Default: `false`
+  @param {PopperStrategies} [popper_strategy=absolute] - Placement strategy used by Popperjs, see popperjs docs, Default: `absolute`
   @param {HTMLElement|string} [dropdown_portal=undefined] - Where to render the dropdown list.
 Can be a DOM element or a `string` with the CSS selector of the element.
 
@@ -139,6 +140,7 @@ Default value: `<span>{option.label}</span>`
   /**
    * @typedef {import('@kws3/ui/types').ColorOptions} ColorOptions
    * @typedef {import('@kws3/ui/types').SizeOptions} SizeOptions
+   * @typedef {import('@kws3/ui/types').PopperStrategies} PopperStrategies
    */
 
   /**
@@ -213,6 +215,12 @@ Default value: `<span>{option.label}</span>`
    */
   export let disabled = false;
 
+  /**
+   * Placement strategy used by Popperjs, see popperjs docs
+   * @type {PopperStrategies}
+   */
+  export let popper_strategy = "absolute";
+
   /**
    * Where to render the dropdown list.
    * Can be a DOM element or a `string` with the CSS selector of the element.
@@ -330,7 +338,7 @@ Default value: `<span>{option.label}</span>`
 
   onMount(() => {
     POPPER = createPopper(el, dropdown, {
-      strategy: "fixed",
+      strategy: popper_strategy,
       placement: "bottom-start",
       // @ts-ignore
       modifiers: [sameWidthPopperModifier],

package/forms/select/MultiSelect.svelte

@@ -30,6 +30,7 @@ Fuzzy match will not work if `search` function is set, as the backend service is
   @param {boolean} [readonly=false] - Marks component as read-only, Default: `false`
   @param {boolean} [disabled=false] - Disables the component, Default: `false`
   @param {string} [selected_icon="check"] - Icon used to mark selected items in dropdown list, Default: `"check"`
+  @param {PopperStrategies} [popper_strategy=absolute] - Placement strategy used by Popperjs, see popperjs docs, Default: `absolute`
   @param {boolean} [summary_mode=false] - Shows only the number of items selected, instead of listing all the selected items in the input., Default: `false`
   @param {string} [no_options_msg="No matching options"] - Message to display when no matching options are found, Default: `"No matching options"`
   @param {string} [async_search_prompt="Start typing to search..."] - Message to display in dropdown when async search can be performed, Default: `"Start typing to search..."`
@@ -202,6 +203,7 @@ Default value: `<span>{option[search_key] || option}</span>`
   /**
    * @typedef {import('@kws3/ui/types').ColorOptions} ColorOptions
    * @typedef {import('@kws3/ui/types').SizeOptions} SizeOptions
+   * @typedef {import('@kws3/ui/types').PopperStrategies} PopperStrategies
    */
 
   /**
@@ -292,6 +294,11 @@ Default value: `<span>{option[search_key] || option}</span>`
    * Icon used to mark selected items in dropdown list
    */
   export let selected_icon = "check";
+  /**
+   * Placement strategy used by Popperjs, see popperjs docs
+   * @type {PopperStrategies}
+   */
+  export let popper_strategy = "absolute";
   /**
    * Shows only the number of items selected, instead of listing all the selected items in the input.
    */
@@ -524,7 +531,7 @@ Default value: `<span>{option[search_key] || option}</span>`
 
   onMount(() => {
     POPPER = createPopper(el, dropdown, {
-      strategy: "fixed",
+      strategy: popper_strategy,
       placement: "bottom-start",
       // @ts-ignore
       modifiers: [sameWidthPopperModifier],

package/forms/select/SearchableSelect.svelte

@@ -27,6 +27,7 @@ Fuzzy match will not work if `search` function is set, as the backend service is
   @param {string} [no_options_msg="No matching options"] - Message to display when no matching options are found, Default: `"No matching options"`
   @param {string} [async_search_prompt="Start typing to search..."] - Message to display in dropdown when async search can be performed, Default: `"Start typing to search..."`
   @param {string} [remove_all_tip="Clear Selection"] - Tooltip text for the Clear selection button, Default: `"Clear Selection"`
+  @param {PopperStrategies} [popper_strategy=absolute] - Placement strategy used by Popperjs, see popperjs docs, Default: `absolute`
   @param {HTMLElement|string} [dropdown_portal=undefined] - Where to render the dropdown list.
 Can be a DOM element or a `string` with the CSS selector of the element.
 
@@ -62,6 +63,7 @@ Default value: `<span>{option[search_key] || option}</span>`
   {remove_all_tip}
   async_search_prompt={value ? "Backspace to clear" : async_search_prompt}
   {no_options_msg}
+  {popper_strategy}
   {dropdown_portal}
   on:change={change}
   on:blur={blur}
@@ -87,6 +89,7 @@ Default value: `<span>{option[search_key] || option}</span>`
   /**
    * @typedef {import('@kws3/ui/types').ColorOptions} ColorOptions
    * @typedef {import('@kws3/ui/types').SizeOptions} SizeOptions
+   * @typedef {import('@kws3/ui/types').PopperStrategies} PopperStrategies
    */
 
   /**
@@ -169,6 +172,11 @@ Default value: `<span>{option[search_key] || option}</span>`
    * Tooltip text for the Clear selection button
    */
   export let remove_all_tip = "Clear Selection";
+  /**
+   * Placement strategy used by Popperjs, see popperjs docs
+   * @type {PopperStrategies}
+   */
+  export let popper_strategy = "absolute";
   /**
    * Where to render the dropdown list.
    * Can be a DOM element or a `string` with the CSS selector of the element.

package/helpers/Icon.svelte

@@ -22,6 +22,17 @@ Ultimately defaults to `fa`, if family is not set anywhere, Default: ``
 </span>
 
 <style>
+  .fa-lg {
+    font-size: 1.33333333em;
+    line-height: 0.75em;
+    vertical-align: -15%;
+  }
+  .fa-2x {
+    font-size: 2em;
+  }
+  .fa-3x {
+    font-size: 3em;
+  }
   .icon .gg {
     transform: scale(0.75);
   }
@@ -117,7 +128,7 @@ Ultimately defaults to `fa`, if family is not set anywhere, Default: ``
     internal_size,
     usedFamily;
 
-  $: inner_icon = family === "material" ? icon : "";
+  $: inner_icon = usedFamily === "material" ? icon : "";
   $: {
     usedFamily = family !== "" ? family : globalFamily ? globalFamily : "fa";
 
@@ -140,9 +151,12 @@ Ultimately defaults to `fa`, if family is not set anywhere, Default: ``
       case "material":
         familyClass = "material-icons material-symbols-outlined ";
         break;
-      default:
+      case "fa":
         familyClass = "fa fa-";
         break;
+      default:
+        familyClass = usedFamily + "-";
+        break;
     }
   }
 

package/helpers/ScrollableList.svelte

@@ -31,7 +31,9 @@ while more items are loading
     on:resize={resize}>
     <div
       bind:this={contents}
-      style="padding-top: {top}px; padding-bottom: {bottom}px;">
+      style="padding-top: {start === 0
+        ? 0
+        : top}px; padding-bottom: {bottom}px;">
       {#each visible as item (item.index)}
         <div class="row">
           <!--Default slot for list view items-->
@@ -142,6 +144,7 @@ while more items are loading
 
   // whenever `items` changes, invalidate the current heightmap
   $: items, viewport_height, item_height, mounted, refresh();
+  $: items, reset();
 
   async function refresh() {
     if (!mounted) return;
@@ -232,4 +235,19 @@ while more items are loading
     rows = contents.getElementsByClassName("row");
     mounted = true;
   });
+
+  function reset() {
+    if (!mounted) return;
+    if (!items.length || items.length < items_count) {
+      item_height = null;
+      start = 0;
+      end = 0;
+      items_count = 0;
+      top = 0;
+      bottom = 0;
+      average_height;
+      padStart = 0;
+      padEnd = 0;
+    }
+  }
 </script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kws3/ui",
-  "version": "2.1.4",
+  "version": "2.2.1",
   "description": "UI components for use with Svelte v3 applications.",
   "main": "index.js",
   "svelte": "index.js",
@@ -35,5 +35,5 @@
   "devDependencies": {
     "typescript": "^5.0.4"
   },
-  "gitHead": "801fdf5363f25ccb04d1a6506bb2c51e0a8506cc"
+  "gitHead": "e4e822a3de295420c1f1cdd832a1fca80b94683f"
 }

package/styles/ActionSheet.scss

@@ -17,13 +17,20 @@ $kws-actionsheet-box-radius: $radius !default;
   box-shadow: $kws-actionsheet-box-shadow;
   position: fixed;
   bottom: 0;
-  left: 0;
   width: 100%;
   max-height: 90%;
   min-height: fit-content;
+  max-width: 650px;
+  margin: 0 auto;
   background: $kws-actionsheet-background;
   transition: all 0.3s;
   z-index: 50;
   padding: 1.25em 1.5em;
   overflow-x: auto;
 }
+@include mobile {
+  .kws-action-sheet {
+    left: 0;
+    max-width: 100%;
+  }
+}

package/types/index.d.ts

@@ -7,16 +7,18 @@ import type {
   FontFamilies,
   FloatiePositions,
   TippyPositions,
+  PopperStrategies,
 } from "./type-defs";
 
 export type ColorOptions = (typeof Colors)[number];
 export type SizeOptions = (typeof Sizes)[number];
 export type ExtendedColorOptions = (typeof ExtendedColors)[number];
 export type BGColorOptions = (typeof BGColors)[number];
-export type FontFamilies = (typeof FontFamilies)[number];
+export type FontFamilies = (typeof FontFamilies)[number] | String;
 export type Positions = (typeof Positions)[number];
 export type TippyPositions = (typeof TippyPositions)[number];
 export type FloatiePositions = (typeof FloatiePositions)[number];
+export type PopperStrategies = (typeof PopperStrategies)[number];
 
 export type FloatieType = {
   create: (opts: object) => { props: object; destroy: () => void };

package/types/type-defs/index.d.ts

@@ -62,3 +62,5 @@ export const TippyPositions = [
   "auto-start",
   "auto-end",
 ] as const;
+
+export const PopperStrategies = ["fixed", "absolute"] as const;