@kws3/ui 1.7.3 → 1.8.1

package/forms/select/SearchableSelect.svelte

@@ -16,9 +16,16 @@ this property of each object will be returned as the value, Default: `"id"`
   @param {''|'primary'|'success'|'warning'|'info'|'danger'|'dark'|'light'} [color=""] - Color of the input, Default: `""`
   @param {string} [style=""] - Inline CSS for input container, Default: `""`
   @param {boolean} [readonly=false] - Marks component as read-only, Default: `false`
+  @param {function|null} [search=null] - Async function to fetch options
+
+Only send this prop if you want to fetch `options` asynchronously.
+`options` prop will be ignored if this prop is set., Default: `null`
+  @param {'fuzzy'|'strict'} [search_strategy="fuzzy"] - Filtered options to be displayed strictly based on search text or perform a fuzzy match.
+Fuzzy match will not work if `search` function is set, as the backend service is meant to do the matching., Default: `"fuzzy"`
   @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 {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 {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.
@@ -44,13 +51,16 @@ Default value: `<span>{option[search_key] || option}</span>`
   {options}
   {search_key}
   {value_key}
+  {search_strategy}
   {size}
   {color}
   {style}
   {readonly}
   {disabled}
+  {search}
   {selected_icon}
   {remove_all_tip}
+  async_search_prompt={value ? "Backspace to clear" : async_search_prompt}
   {no_options_msg}
   {dropdown_portal}
   on:change={change}
@@ -118,6 +128,21 @@ Default value: `<span>{option[search_key] || option}</span>`
    * Marks component as read-only
    */
   export let readonly = false;
+  /**
+   * Async function to fetch options
+   *
+   * Only send this prop if you want to fetch `options` asynchronously.
+   * `options` prop will be ignored if this prop is set.
+   *
+   * @type {function|null}
+   */
+  export let search = null;
+  /**
+   * Filtered options to be displayed strictly based on search text or perform a fuzzy match.
+   * Fuzzy match will not work if `search` function is set, as the backend service is meant to do the matching.
+   * @type {'fuzzy'|'strict'}
+   */
+  export let search_strategy = "fuzzy";
   /**
    * Disables the component
    */
@@ -130,6 +155,10 @@ Default value: `<span>{option[search_key] || option}</span>`
    * Message to display when no matching options are found
    */
   export let no_options_msg = "No matching options";
+  /**
+   * Message to display in dropdown when async search can be performed
+   */
+  export let async_search_prompt = "Start typing to search...";
   /**
    * Tooltip text for the Clear selection button
    */

package/helpers/ActionSheet.svelte

@@ -19,7 +19,9 @@ If `false` , the component won't have a close button, and will not close on clic
 
 -->
 
-<div class="modal {klass} {is_active ? 'is-active' : ''}" {style}>
+<div
+  class="modal kws-action-sheet-outer {klass} {is_active ? 'is-active' : ''}"
+  {style}>
   {#if is_active}<div
       transition:fade={{ duration: transitionDuration }}
       class="modal-background"

package/helpers/CardModal.svelte

@@ -34,7 +34,6 @@ Only visible when the
       transition:fade={{ duration: transitionDuration }}
       class="modal-background"
       on:click={clickOutside} />
-
     <div
       transition:scale={{
         duration: transitionDuration,
@@ -83,6 +82,17 @@ Only visible when the
 </div>
 
 <style lang="scss">
+  .modal {
+    display: flex;
+    visibility: hidden;
+    &.is-active {
+      visibility: visible;
+    }
+    .modal-card,
+    .modal-background {
+      transition: all 0.3s;
+    }
+  }
   @media screen and (min-width: 769px), print {
     .modal-card {
       min-width: 640px;

package/helpers/Dialog/index.js

@@ -12,6 +12,8 @@ function createDialog(msg, props) {
 
     dialog.$on("_done", ({ detail }) => {
       fulfil(detail);
+      //Does not outro out because of
+      //https://github.com/sveltejs/svelte/issues/4056
       dialog.$destroy();
     });
   });

package/helpers/Modal.svelte

@@ -26,7 +26,6 @@ Only programmatic closing is possible, Default: `true`
       transition:fade={{ duration: transitionDuration }}
       class="modal-background"
       on:click={clickOutside} />
-
     <div
       transition:scale={{
         duration: transitionDuration,
@@ -47,9 +46,19 @@ Only programmatic closing is possible, Default: `true`
 </div>
 
 <style lang="scss">
-  @media screen and (min-width: 769px), print {
+  .modal {
+    display: flex;
+    visibility: hidden;
+    &.is-active {
+      visibility: visible;
+    }
     .modal-content,
-    .modal-card {
+    .modal-background {
+      transition: all 0.3s;
+    }
+  }
+  @media screen and (min-width: 769px), print {
+    .modal-content {
       min-width: 640px;
       &.is-medium {
         width: 70%;

package/helpers/ScrollableList.svelte

@@ -0,0 +1,231 @@
+<!--
+  @component
+
+
+  @param {array} [items=[]] - Array of items, Default: `[]`
+  @param {string} [height="100%"] - Height of the wrapper, CSS String, Default: `"100%"`
+  @param {number | null} [item_height=null] - Height of each list item. If not set, height will be calculated automatically based on each item's offsetHeight, Default: `null`
+  @param {number} [start=0] - First item index rendered inside viewport - readonly, Default: `0`
+  @param {number} [end=0] - Last item index rendered inside viewport - readonly, Default: `0`
+  @param {number} [end_threshold=10] - `end` event will be fired when the list reaches this many items before the end of the list., Default: `10`
+  @param {string} [style=""] - Inline CSS for scroller container, Default: `""`
+  @param {string} [class=""] - CSS classes for scroller container, Default: `""`
+
+  ### Events
+  - `end` - Fired when the list reaches `end_threshold` items before the end of the list.
+
+  ### Slots
+  - `<slot name="default" {item} {index} />` - Default slot for list view items
+  - `<slot name="loader"  />` - Optional slot to display a loading graphic at the bottom of the list
+while more items are loading
+
+-->
+{#if hasResizeObserver}
+  <div
+    bind:this={viewport}
+    class="kws-scrollable-list with-resize-observer {klass}"
+    on:scroll={handle_scroll}
+    style="height:{height};{style}"
+    use:resizeObserver
+    on:resize={resize}>
+    <div
+      bind:this={contents}
+      style="padding-top: {top}px; padding-bottom: {bottom}px;">
+      {#each visible as item (item.index)}
+        <div class="row">
+          <!--Default slot for list view items-->
+          <slot item={item.data} index={item.index} />
+        </div>
+      {/each}
+      <!--Optional slot to display a loading graphic at the bottom of the list
+        while more items are loading-->
+      <slot name="loader" />
+    </div>
+  </div>
+{:else}
+  <div
+    bind:this={viewport}
+    class="kws-scrollable-list {klass}"
+    on:scroll={handle_scroll}
+    style="height:{height};{style}"
+    bind:offsetHeight={viewport_height}>
+    <div
+      bind:this={contents}
+      style="padding-top: {top}px; padding-bottom: {bottom}px;">
+      {#each visible as item (item.index)}
+        <div class="row">
+          <!--Default slot for list view items-->
+          <slot item={item.data} index={item.index} />
+        </div>
+      {/each}
+      <!--Optional slot to display a loading graphic at the bottom of the list
+        while more items are loading-->
+      <slot name="loader" />
+    </div>
+  </div>
+{/if}
+
+<style>
+  .kws-scrollable-list {
+    overflow: auto;
+    -webkit-overflow-scrolling: touch;
+    position: relative;
+    height: 100%;
+  }
+</style>
+
+<script>
+  import { onMount, tick } from "svelte";
+  import { createEventDispatcher } from "svelte";
+  import {
+    resizeObserver,
+    hasResizeObserver,
+  } from "@kws3/ui/utils/resizeObserver";
+
+  const fire = createEventDispatcher();
+  /**
+   * Array of items
+   */
+  export let items = [],
+    /**
+     * Height of the wrapper, CSS String
+     */
+    height = "100%",
+    /**
+     * Height of each list item. If not set, height will be calculated automatically based on each item's offsetHeight
+     * @type {number | null}
+     */
+    item_height = null,
+    /**
+     * First item index rendered inside viewport - readonly
+     */
+    start = 0,
+    /**
+     * Last item index rendered inside viewport - readonly
+     */
+    end = 0,
+    /**
+     *  `end` event will be fired when the list reaches this many items before the end of the list.
+     */
+    end_threshold = 10,
+    /**
+     * Inline CSS for scroller container
+     */
+    style = "";
+
+  /**
+   * CSS classes for scroller container
+   */
+  let klass = "";
+  export { klass as class };
+
+  // local state
+  let height_map = [],
+    rows,
+    viewport,
+    contents,
+    viewport_height = 0,
+    visible,
+    mounted,
+    top = 0,
+    bottom = 0,
+    average_height,
+    items_count = 0;
+
+  $: visible = items.slice(start, end).map((data, i) => {
+    return { index: i + start, data };
+  });
+
+  // whenever `items` changes, invalidate the current heightmap
+  $: items, viewport_height, item_height, mounted, refresh();
+
+  async function refresh() {
+    if (!mounted) return;
+    const scrollTop = viewport.scrollTop;
+    await tick(); // wait until the DOM is up to date
+    let content_height = top - scrollTop;
+    let i = start;
+    while (content_height < viewport_height && i < items.length) {
+      let row = rows[i - start];
+      if (!row) {
+        end = i + 1;
+        await tick(); // render the newly visible row
+        row = rows[i - start];
+      }
+      const row_height = (height_map[i] =
+        item_height || (row ? row.offsetHeight : 0));
+      content_height += row_height;
+      i += 1;
+    }
+    end = i;
+    const remaining = items.length - end;
+    average_height = (top + content_height) / end;
+    bottom = remaining * average_height;
+    height_map.length = items.length;
+  }
+
+  async function handle_scroll() {
+    const scrollTop = viewport.scrollTop;
+    const old_start = start;
+    for (let v = 0; v < rows.length; v += 1) {
+      height_map[start + v] = item_height || rows[v].offsetHeight;
+    }
+    let i = 0;
+    let y = 0;
+    while (i < items.length) {
+      const row_height = height_map[i] || average_height;
+      if (y + row_height > scrollTop) {
+        start = i;
+        top = y;
+        break;
+      }
+      y += row_height;
+      i += 1;
+    }
+    while (i < items.length) {
+      y += height_map[i] || average_height;
+      i += 1;
+      if (y > scrollTop + viewport_height) break;
+    }
+    end = i;
+    const remaining = items.length - end;
+    average_height = y / end;
+    while (i < items.length) height_map[i++] = average_height;
+    bottom = remaining * average_height;
+    // prevent jumping if we scrolled up into unknown territory
+    if (start < old_start) {
+      await tick();
+      let expected_height = 0;
+      let actual_height = 0;
+      for (let i = start; i < old_start; i += 1) {
+        if (rows[i - start]) {
+          expected_height += height_map[i];
+          actual_height += item_height || rows[i - start].offsetHeight;
+        }
+      }
+      const d = actual_height - expected_height;
+      viewport.scrollTo(0, scrollTop + d);
+    }
+    // fire on:end event if we scrolled past the end of the list
+    if (end > items.length - end_threshold) {
+      if (items_count !== items.length) {
+        items_count = items.length;
+        await tick();
+        /**
+         * Fired when the list reaches `end_threshold` items before the end of the list.
+         */
+        fire("end", { start, end });
+      }
+    }
+  }
+
+  const resize = () => {
+    viewport_height = viewport.offsetHeight;
+  };
+
+  // trigger initial refresh
+  onMount(() => {
+    rows = contents.getElementsByClassName("row");
+    mounted = true;
+  });
+</script>

package/index.js

@@ -17,6 +17,7 @@ export { default as TimelineItem } from "./helpers/Timeline/TimelineItem.svelte"
 export { default as TimelineHeader } from "./helpers/Timeline/TimelineHeader.svelte";
 export { default as Nl2br } from "./helpers/Nl2br.svelte";
 export { default as ClipboardCopier } from "./helpers/ClipboardCopier.svelte";
+export { default as ScrollableList } from "./helpers/ScrollableList.svelte";
 export { alert, confirm, prompt, default as Dialog } from "./helpers/Dialog";
 export {
   Notifications,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kws3/ui",
-  "version": "1.7.3",
+  "version": "1.8.1",
   "description": "UI components for use with Svelte v3 applications.",
   "main": "index.js",
   "scripts": {
@@ -23,11 +23,12 @@
     "access": "public"
   },
   "dependencies": {
-    "apexcharts": "^3.32.0",
+    "apexcharts": "3.33.2",
     "flatpickr": "^4.5.2",
+    "fuzzysearch": "^1.0.3",
     "svelte-portal": "^2.1.2",
     "text-mask-core": "^5.1.2",
     "tippy.js": "^6.3.1"
   },
-  "gitHead": "f76e8d0f5bb9859092c7e4e6b38f8fbd3252dc5d"
+  "gitHead": "2fdaba3e13397494f06b5881bf92f68b1c7c695d"
 }

package/sliding-panes/SlidingPane.svelte

@@ -25,6 +25,8 @@ This will work only when `track_height` is set to `true`
       : ''} {h_center ? 'h-centered' : ''} {active ? 'is-active' : ''} {klass}"
     {style}>
     <div
+      use:resizeObserver
+      on:resize={debouncedFireSizeChange}
       bind:this={slideInner}
       class="sliding-pane-inner {v_center ? 'v-centered' : ''} {h_center
         ? 'h-centered'
@@ -52,6 +54,10 @@ This will work only when `track_height` is set to `true`
 <script>
   import { onMount, createEventDispatcher } from "svelte";
   import { debounce } from "@kws3/ui/utils";
+  import {
+    resizeObserver,
+    hasResizeObserver,
+  } from "@kws3/ui/utils/resizeObserver";
 
   const fire = createEventDispatcher();
 
@@ -76,8 +82,7 @@ This will work only when `track_height` is set to `true`
      */
     track_height = true;
 
-  const hasResizeObserver = typeof window.ResizeObserver != "undefined";
-  let _height, slideInner, Observer;
+  let _height, slideInner;
 
   /**
    * CSS classes for the panel
@@ -91,18 +96,22 @@ This will work only when `track_height` is set to `true`
     }
   }
 
+  const max_retries_for_render = 10;
+  let try_count = 0;
   function pollForRender() {
     if (slideInner && typeof slideInner != "undefined") {
       init();
     } else {
       setTimeout(() => {
-        pollForRender();
+        try_count++;
+        if (try_count < max_retries_for_render) {
+          pollForRender();
+        }
       }, 50);
     }
   }
 
   function init() {
-    setupResizeObserver();
     fireSizeChange();
   }
 
@@ -129,23 +138,7 @@ This will work only when `track_height` is set to `true`
 
   const debouncedFireSizeChange = debounce(fireSizeChange, 150, false);
 
-  const setupResizeObserver = () => {
-    if (hasResizeObserver) {
-      if (!slideInner || typeof slideInner == "undefined") {
-        pollForRender();
-      } else {
-        Observer = new ResizeObserver(() => {
-          debouncedFireSizeChange();
-        });
-        Observer.observe(slideInner);
-      }
-    }
-  };
-
   onMount(() => {
     pollForRender();
-    return () => {
-      Observer && Observer.disconnect();
-    };
   });
 </script>

package/styles/ActionSheet.scss

@@ -2,6 +2,16 @@ $kws-actionsheet-background: $background !default;
 $kws-actionsheet-box-shadow: $card-shadow !default;
 $kws-actionsheet-box-radius: $radius !default;
 
+.kws-action-sheet-outer {
+  display: flex;
+  visibility: hidden;
+  &.is-active {
+    visibility: visible;
+  }
+  .modal-background {
+    transition: all 0.3s;
+  }
+}
 .kws-action-sheet {
   border-radius: $kws-actionsheet-box-radius $kws-actionsheet-box-radius 0 0;
   box-shadow: $kws-actionsheet-box-shadow;

package/utils/resizeObserver.js

@@ -0,0 +1,24 @@
+export const hasResizeObserver = typeof window.ResizeObserver != "undefined";
+
+/**
+ * Usage: `<div use:resizeObserver on:resize={resizeHandler}>`
+ * @param {HTMLElement} node
+ * @returns {Object}
+ */
+export function resizeObserver(node) {
+  let ro;
+  if (hasResizeObserver) {
+    ro = new ResizeObserver(() => {
+      const e = new CustomEvent("resize", { bubbles: false });
+      node.dispatchEvent(e);
+    });
+
+    ro.observe(node);
+  }
+
+  return {
+    destroy() {
+      hasResizeObserver && ro.disconnect();
+    },
+  };
+}